Troubleshooting

This chapter describes possible problems with the OPSI-WebGUI and provides tips for solving them.

Empty Config Server Name

If the login page does not display the name of the OPSI config server, you may have lost access to the config server or the opsiconfd service.

Possible solutions:

  • Open the admin page at https://<opsi-server>:4447/admin in your browser, log in, and verify/accept the SSL certificate if necessary.

  • Restart the opsiconfd service, for example, with this command:

systemctl restart opsiconfd.service
For more information about the opsiconfd service, its command-line interface, and the admin page, see chapter opsiconfd Service.

OPSI-Messagebus Connection Failed

If the OPSI-Messagebus status indicator in the top bar shows a disconnected state and you see a certificate warning banner, the WebSocket connection to the OPSI server could not be established. This typically happens when the SSL certificate is not trusted by the browser.

Possible solutions:

  • Open https://<opsi-server>:4447/ directly in your browser and accept the certificate.

  • Ensure that the opsiconfd service is running and accessible on port 4447.

After resolving the certificate issue, the messagebus will reconnect automatically.

For more information about the OPSI-Messagebus, see OPSI-Messagebus.

Terminal Not Available

If the Terminal page shows a message that the terminal is disabled, the opsiconfd has been configured to disable the messagebus terminal feature.

Check the opsiconfd configuration:

grep disabled-features /etc/opsi/opsiconfd.conf