Troubleshoot the Tomcat plugin
Deploy expects the Tomcat start command to return and leave Tomcat running. The default Tomcat start script will cause Deploy to hang during deployment. You can specify start and stop commands on the
tomcat.Server configuration item (CI).
For example, to start and stop Tomcat 7 when it is installed as a daemon on Unix, use
./bin/startup.sh. On Microsoft Windows, use
Tip: If your start and stop scripts only return when Tomcat is actually started or stopped, set the wait times on the
tomcat.Server CI to 0.
The following commands are used as a reference while setting up the Tomcat Server in Deploy. Run the “Status Command” and its output is compared against the “Expected Status Command Output” to determine if the server is running.
- “Start Command”
systemctl start tomcat9.service
- “Stop Command”
systemctl stop tomcat9.service
- “Status Command”
systemctl status tomcat9.service
- “Expected Status Command Output”
Tip: You can use “Status Command” and “Status Command Expected Output” along with the “Start Command” or “Stop Command” to validate Tomcat status before executing the commands.
If you are running Tomcat on Unix and the Tomcat server does not restart after application deployment, use the
nohup command with the
sleep option. This ensures that the SSH connection is not closed before the restart is processed.
nohup /usr/local/apache-tomcat-7.0.42/bin/catalina.sh start && sleep 2
If the Tomcat plugin deploys additional files that cause conflicts, disable its management of the
context.xml file. For more information, see deployed actions table.
To disable management, locate the following line in the
Change the line to:
For more information about the Tomcat plugin, see: