Troubleshoot the Tomcat plugin

Starting Tomcat

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 service tomcat7 start or /etc/init.d/tomcat7 start. On Microsoft Windows, use net start tomcat7.

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.

Restarting Tomcat after deployment

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. Example:

nohup /usr/local/apache-tomcat-7.0.42/bin/ start && sleep 2

Disabling management of context.xml

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 XL_DEPLOY_SERVER_HOME/conf/ file:


Change the line to:


For more information about the Tomcat plugin, see: