Troubleshooting¶

Wrong permission for config/jwt/

# Change owner of config/jwt/*
chown -R www-data:www-data config/jwt

500 Internal Server Error on Labs page¶

Wrong permission in var/cache/prod/

# Change owner of cache/prod/
chown -R www-data:www-data *

Error in prod when update¶

If an error occurred when you update your version, from prod or older version, you can :

delete the *.lock file
check with git status if you have additional file on your filesystem and delete them
delete the var/cache directory

No device templates are displayed on editor¶

If you want to add a device in the editor and no templates are displayed in the dropdown, you have to change the permission of config/templates:

chown www-data:www-data config/templates
chmod 664 config/templates

Error with numpy when installing¶

If the setup fails while processing numpy-2.1.3.tar.gz with this error:

error: Couldn't find a setup script in /tmp/easy_install-cw60uo3_/numpy-2.1.3.tar.gz ERROR: (

Install numpy manually with pip install numpy. and re-run the installation script.

lxc error while creating alpine 3.15 when installing¶

This is due to the script asking to install a version of Alpine that is no longer maintained. To circumvent this, the install script must be modified. Open the install script and change those lines

LXC=`lxc-ls -name "Alpine3.15"`;
if [ "${LXC}" == "" ] ; then
echo "Creation of a container Alpine 3.15"
DOWNLOAD_KEYSERVER="keyserver.ubuntu.com" lxc-create -t download -n Alpine3.15 -- -d alpine -r 3.15 -a amd64
echo "No default login, please use Sandbox to configure a new OS from this" >> "/var/lib/lxc/Alpine3.15/rootfs/etc/issue"
echo "nameserver 1.1.1.3" > "/var/lib/lxc/Alpine3.15/rootfs/etc/resolv.conf"
echo "OK ✔️"
fi;

to

LXC=`lxc-ls -name "Alpine3.17"`;
if [ "${LXC}" == "" ] ; then
echo "Creation of a container Alpine 3.17"
DOWNLOAD_KEYSERVER="keyserver.ubuntu.com" lxc-create -t download -n Alpine3.17 -- -d alpine -r 3.17 -a amd64
echo "No default login, please use Sandbox to configure a new OS from this" >> "/var/lib/lxc/Alpine3.17/rootfs/etc/issue"
echo "nameserver 1.1.1.3" > "/var/lib/lxc/Alpine3.17/rootfs/etc/resolv.conf"
echo "OK ✔️"
fi;

This will force the installer to install a version of Alpine that is still maintained (3.17). Re-run the install script after this.

Lab Export running endlessly¶

Restart the messenger first. If the log mention :

[2024-11-06T15:46:34.781498+01:00] messenger.CRITICAL: Error thrown while handling message Remotelabz\Message\Message\InstanceActionMessage. Removing from transport after 3 retries. Error: "Handling "Remotelabz\Message\Message\InstanceActionMessage" failed: Undefined class constant 'ACTION_EXPORT'" {"message":{"Remotelabz\\Message\\Message\\InstanceActionMessage":[]},"class":"Remotelabz\\Message\\Message\\InstanceActionMessage","retryCount":3,"error":"Handling \"Remotelabz\\Message\\Message\\InstanceActionMessage\" failed: Undefined class constant 'ACTION_EXPORT'","exception":"[object] (Symfony\\Component\\Messenger\\Exception\\HandlerFailedException(code: 0): Handling \"Remotelabz\\Message\\Message\\InstanceActionMessage\" failed: Undefined class constant 'ACTION_EXPORT' at /opt/remotelabz-worker/vendor/symfony/messenger/Middleware/HandleMessageMiddleware.php:80)\n[previous exception] [object] (Error(code: 0): Undefined class constant 'ACTION_EXPORT' at /opt/remotelabz-worker/src/MessageHandler/InstanceActionMessageHandler.php:141)"} []

This issue is caused by a state message EXPORT that is unrecognized by the worker.To solve this modify the file /opt/remotelabz-worker/vendor/remotelabz/remotelabz-message-bundle/Message and add const ACTION_EXPORT = "export"; at the beginning of the file, where all others actions constants are listed.

Then restart the worker.

2 VM with the same address¶

Even if your two VMs have different MAC address on its interface, from Ubuntu 16, the DHCP client send, not your MAC address but an information stores in the /etc/machine-id . So, when you put 2 times the same VM in a same lab, you have to, either change the machine-id value or change your /etc/netplan/ file :

      dhcp4: yes
      dhcp-identifier: mac