.png){kind=logo}
Troubleshooting Guide
The following provides some general troubleshooting tips and subsections with categorized information to help you get back on track.
View Server Log File
To troubleshoot unexpected behavior, the server.log file usually displays errors that can be read. During a startup, the server.log displays a lot of useful information and possible errors such as problems connecting to the database or similar.
A good procedure is to start a fresh log file to only get the information you need. To start a new log file, do the following:
- Stop the application server.
- Remove the old server.log (delete or archive) from standalone/log.
- Start the application server.
- Follow the server.log file in standalone/log/server.log.
Errors shown last in the file may be follow up symptoms of the original error. If you receive an error at the end of the log file, review the beginning of the file to find the first error, which is usually the cause.
For more information, see Logging.
Debug Logging
To troubleshoot unexpected behavior, enable more detailed (debug) logging by running the following command in the JBoss CLI:
/subsystem=logging/logger=org.ejbca:write-attribute(name=level, value=DEBUG)
/subsystem=logging/logger=org.cesecore:write-attribute(name=level, value=DEBUG)Do not get intimidated by long stack-traces but look for the message text and additional clues on lines starting with Caused by:. Reproduce issues in a test environment with full debug logging enabled and to find out under what circumstances the issue occurs, seemingly spontaneous or as a response to a certain set of actions or input? For more information, see Enabling Debug Logging and Logging.
Online Documentation
Ensure that your configuration is correct and performed according to the steps described in the EJBCA Installation section.
Online Community
Discuss with the EJBCA Community on GitHub Discussions.
Keyfactor Support
Customers with a valid support contract can contact Keyfactor Support and search the Keyfactor Support Portal.
Troubleshooting Topics