GitHubContribute in GitHub: Edit online

IBM Manta Data Lineage Tomcat Has Trouble Starting or Shutting Down Because of the PID File on Linux

If you see one of the following error messages on your console, proceed as described below. The PID file is located in <MANTA_BASE>/catalina.pid. The Tomcat process is named Java.

Problem Starting Tomcat

Unable to remove or clear stale PID file. Start aborted.

You (or the user you are using to run Manta Data Lineage) probably do not have sufficient access rights or the file is locked due to another process. Make sure you have the right to write to the PID file and the right to write and execute the parent directory.

Unable to read the PID file. Start aborted.

You (or the user you are using to run Manta Data Lineage) probably do not have sufficient access rights. Make sure you have the right to read the PID file and the right to execute the parent directory.

Unable to remove or write to empty PID file. Start aborted.

You (or the user you are using to run Manta Data Lineage) probably do not have sufficient access rights or the file is locked due to another process. Make sure you have the right to write to the PID file and the right to write and execute the parent directory.

Tomcat still appears to be running with PID <number>. Start aborted.

Manta Data Lineage is probably running. See the details of the message and check if the process shown is Manta Data Lineage. If not, delete the PID file and try to start Manta Data Lineage again.

Existing PID file found during start.

Check the content of the PID file. If it contains a number, look into the running process list to see if the process is there and if it is Manta Data Lineage. If there is no number or the process is not running or the process is not Manta Data Lineage, delete the PID file.

Problem Shutting Down Tomcat

$CATALINA_PID was set but the specified file does not exist. Is Tomcat running? Stop aborted.

Manta Data Lineage is probably not running and there is nothing to stop. If Manta Data Lineage is still running, find its process ID in the process list and send it a SIGTERM signal. kill -15 <PROCESS_ID>.

PID file is empty and has been ignored.

Manta Data Lineage is probably not running and there is nothing to stop. If Manta Data Lineage is still running, find its process ID in the process list and send it a SIGTERM signal. kill -15 <PROCESS_ID>.

PID file found but either no matching process was found or the current user does not have permission to stop the process. Stop aborted.

Manta Data Lineage is probably not running and there is nothing to stop, or you are not the owner of the process or you don't have permission to stop it. If Manta Data Lineage is still running, find its process ID in the process list and send it a SIGTERM signal. kill -15 <PROCESS_ID>.

Sources

https://tomcat.apache.org/tomcat-8.0-doc/RUNNING.txt