Troubleshooting D1 and Conversion Service errors
This page lists the most common D1 and Conversion Service errors that you might encounter, and provides instructions how to troubleshoot them.
Shutdown aborted - missing CATALINA_PID
You might run into the following error on attempt to shut down D1 or Conversion Service:
./tribefire-console-start.sh
/installation_dir/runtime/host/bin/catalina.pid was set but the specified file does not exist. Is Tomcat running? Stop aborted.
This error is caused by using ./catalina.sh
run instead of ./tribefire-console-start.sh
for starting the service.
To avoid this error, use ./tribefire-console-start.sh
to start D1 or Conversion Service and ./tribefire-console-stop.sh
to shut it down. For details, see Starting and stopping D1 and Conversion Service.
D1 or Conversion Service suddenly shuts down
If D1 or Conversion Service suddenly shuts down, in most of the cases, it is caused by an out-of-memory issue.
Perform the following steps to troubleshoot this problem:
- Check the logs for the
java.lang.OutOfMemoryError
error. Most likely, you will find it in thecatalina.out
.
You can check logs in a text editor, or in the command line. If you review the logs in the command line, you can use grep
filter to search for the problem more easy.
- Check if the Java installation prerequisites are met.
Sessions ending on a host shared between D1 and Conversion Service
Session cookies are domain-bound in D1 and Conversion Service installations. As a result, when Conversion Service and D1 are running on the same host, it is impossible to log in to both nodes at the same time.
This problem is typical for development environments, and it should not normally occur in the production environments (see recommended architecture for production).
Consider the following situation:
- D1 is running on
localhost:8080
- Conversion Service is running on
localhost:9090
The D1 session ends when the Conversion Service session starts (and the other way around).
You can solve the problem by resolving your localhost IP to a different domain. To do this, open the etc/hosts
file and add the following lines (assuming your localhost IP is 127.0.0.1
):
127.0.0.1 adx-alias
127.0.0.1 conversion-alias
You should now be able to access D1 on adx-alias:8080
and Conversion Service on conversion-alias:9080
. Getting logged in one node should no longer cause the session on the other node to end, because from the browser perspective D1 and Conversion Service are now on different hosts.
One or more Tribefire listeners failed to start
If you are not able to access Tribefire services on Conversion Service node or the landing page on the D1 node, check the logs for the following items:
SEVERE StandardContext 'One or more listeners failed to start. Full details will be found in the appropriate container log file' []
SEVERE StandardContext 'Context [/tribefire-services] startup failed due to previous errors' []
To troubleshoot this error, check if the correct database driver is placed in the additional-libraries
folder (which should be in the same location as your installation directory), as described in the System Database configuration in the installation instructions.