Accéder au contenu principal
Version: 20.0

Emergency Mode

If normal operation is not possible, ADOIT will enter emergency mode. Until the problem is resolved, users will see an error message when attempting to log in to ADOIT.

There can be various reasons for ADOIT to enter emergency mode:

  • No connection to the specified ADOIT database could be established.

    • The log entry Application has started in emergency mode because it could not establish a connection to the database! is written to the ADOIT20.0.log file in the configured log directory of the web server container, as well as to the standard container streams.

    • Check whether the environment variables ADOXX_SERVER_DBNAME and ADOXX_SERVER_DBTYPE have been configured correctly in the deployment configuration of the application server container.

    • Contact your database administrator if the problem persists.

  • The library that should be used was not specified correctly (most often the case if there are multiple application libraries in the ADOIT database).

    • The log entry Application has started in emergency mode because of a library misconfiguration! is written to the ADOIT20.0.log file in the configured log directory of the web server container, as well as to the standard container streams.

    • Check whether the environment variable ADOXX_SERVER_LIBNAME has been configured correctly in the deployment configuration of the application server container.

  • There are syntax errors in the application code which cause validation on the web server to fail.

    • The log entry Application has started in emergency mode because of JS syntax in a MFB! is written to the ADOIT20.0.log file in the configured log directory of the web server container, as well as to the standard container streams.

    • Contact our support team to help you solve this issue.

  • No valid licence is available.

    • One of the following log entries will be written to the ADOIT20.0.log file in the configured log directory of the web server container, as well as to the standard container streams: Application has started in emergency mode because of an invalid licence! or Application has started in emergency mode because the database contains data in a language not present in the selected licence!.

    • A login to the ADOIT Administration will be possible, and the Import Licence dialogue will open automatically.

Remarque

Only the default super admin "Admin" can log in to the ADOIT Administration in emergency mode if no valid licence is available.

For troubleshooting purposes, you can still download the support information package (SIP) containing all relevant log files when ADOIT is in emergency mode. For on-premise deployments, you must ensure that the container log directories are mapped to persistent storage for this data to be available. Be aware that the SIP will only include the log files of the web server if no connection to the application server could be established. To download the SIP:

  • Enter the URL where ADOIT is available and add /supportinformation, e.g. https://pp2****.de.boc-cloud.com/supportinformation.
Remarque

If you cannot fix the issue on your own, feel free to contact our support team.