Troubleshooting

PHP

Most common errors that happens when installing PlexusLAB are related to a faulty PHP installation.

Assuming you already installed Ubuntu, check your PHP version is 7.4 (if you need to perform a PHP 7.4 setup), or 8.2 (if you need to perform a PHP 8.2 setup). On your terminal use the command

php --version

You must get a message similar to the following.

PHP 7.4.3 (cli) (built: Oct  6 2020 15:47:56) ( NTS )
Copyright (c) The PHP Group
Zend Engine v3.4.0, Copyright (c) Zend Technologies
with Zend OPcache v7.4.3, Copyright (c), by Zend Technologies

If you are running an older version of PHP you may need to re-run the installation script, or, in the worst case, please Google how to upgrade it.

Apache

If PHP is loaded correctly, but you still can't access the website at http://localhost/plexus, the error might be related to the Apache Service.

Check your Apache System status with the following command

sudo systemctl status apache2

It should have active running status.

apache2.service - The Apache HTTP Server
    Loaded: loaded (/lib/systemd/system/apache2.service; enabled; vendor prese>
    Active: active (running) since ....

If Active: active (running) is not displayed, then executing again the installation script could be necessary, or, in the worst case, please Google how to enable webbrowser service of Apache.

Find your remote machine's IP

hostname -I

Find PlexusLAB installation ID

By default, PlexusLAB release a unique ID randomly generated on first install.

To retrieve it you must be admin of the machine, and run this command on it.

sudo php /var/www/html/plexus/system/php_scripts/get_installation_id.php

Reset PlexusLAB password for an user

To reset a user's password you must be admin of the machine, and run this command on it.

sudo php /var/www/html/plexus/system/php_scripts/reset_user_password.php A_VALID_USER_EMAIL_HERE NEW_PASSWORD_HERE
Example: sudo php /var/www/html/plexus/system/php_scripts/reset_user_password.php automation@mydomain.com 174hdcda2dAA!