Basic troubleshooting when encountering issues saving the configuration.
Check if the Nachos service is running
Log in to the Monitor server with SSH, and check if the nachos service is running.
service nachos status
The above command is also run by the UI, and a red warning message should show up if it indicates a problem with the service. If the service is inactive, try to start it again:
service nachos start
If the service fails to start, refer to the status output or logs for clues.
Check if the Nachos virtual environment exists
Check whether this path exists:
If not, reinstall nachos:
# yum reinstall op5-nachos -y
Check the web console when trying to save
When on the save page, open the browsers console (ctrl + shift + c in Chrome), and select the save button. Next switch to the console tab, and click on save. The console log might show clues as to why the save fails. For example this console log indicates that the nachos service might be down.
POST https://127.0.0.1/nachos/api/v1/exports/ 503 (Service Unavailable)
The logs are located in
Change log level (debug logging)
Change default_log_levels in /opt/monitor/nachos/nachos.cfg:
default_log_levels = nachos=DEBUG, eventlet=ERROR
Valid levels are: CRITICAL, ERROR, INFO, WARNING, and DEBUG.
Then restart Nachos:
# systemctl restart nachos
The configuration is located in:
Stuck in "Export already in progress"
This is a Nacoma related issue, and might occur in the new service as well. When an export stats, an object lock entry is inserted into the objlocks table in the Nacoma database. This entry is valid for five minutes, and is removed when the export has finished. In certain circumstances the entry might not be removed, for example when reaching PHP's max_exection_time limit in old Nacoma, which should not be an issue in the new service as it does not use PHP. If a user encounters this problem and want to unlock the database without waiting for the entry to expire, it is possible to truncate the objlocks table:
mysql nacoma -e "truncate objlocks"
Access denied for user 'x'@'x'
If there is a line in the log file looking like this:
sqlalchemy.exc.OperationalError: (pymysql.err.OperationalError) (1045, "Access denied for user 'user'@'localhost' (using password: YES)") (Background on this error at: http://sqlalche.me/e/e3q8)
There can be multiple reasons why this problem is encountered. Most common reason is having "skip-networking" option set in /etc/my.cnf. The workaround is to use the MySQL Unix socket instead of TCP/IP.
Open /opt/monitor/nachos/nachos.cfg, and under [database] and [nacoma] add '?unix_socket=/var/lib/mysql/mysql.sock' to the connection variable, and remove ':3306'.
[database]connection = mysql+pymysql://username:email@example.com/nachos[nacoma]connection = mysql+pymysql://firstname.lastname@example.org:3306/nacoma
[database]connection = mysql+pymysql://username:email@example.com/nachos?unix_socket=/var/lib/mysql/mysql.sock[nacoma]connection = mysql+pymysql://firstname.lastname@example.org/nacoma?unix_socket=/var/lib/mysql/mysql.sockAfter configuration changes restart the service
service nachos restart
Another reason could be wrong user credentials. Make sure they are correct.
connection = mysql+pymysql://user:email@example.com/nachos
connection = mysql+pymysql://correctuser:firstname.lastname@example.org/nachos
Save the file and restart the nachos service:
service nachos restart
Missing exports table
This can happen when having "skip-networking" in /etc/my.cnf during the installation of Nachos. This oneliner will recreate the table.
/opt/monitor/nachos/venv/bin/nachos-manage --config-file /opt/monitor/nachos/nachos.cfg db_sync
Reverting to old functionality
Last resort in case of emergency, this will disable Nachos and should revert the product to using only Nacoma.
rpm -e --nodeps op5-nachos-ui
systemctl restart httpd