Tomcat Troubleshooting Guide

You may need to start and stop your Tomcat services to make sure that everything comes up correctly. Following are the quick steps to start, stop, or restart Tomcat Services:

Start Tomcat

1. Go to Start > Apps > Control Panel > Administrative Tools > Services.
2. Right-click Apache Tomcat 9.0 Tomcat9.
3. Click Start.

Stop Tomcat

1. Go to Start > Apps > Control Panel > Administrative Tools > Services.
2. Right-click Apache Tomcat 9.0 Tomcat9.
3. Click Stop.

Restart Tomcat

1. Go to Start > Apps > Control Panel > Administrative Tools > Services.
2. Right-click Apache Tomcat 9.0 Tomcat9.
3. Click Restart.

Tomcat is installed with default memory as 128 and 256. You may need to set up memory to improve the performance of Adeptia Connect on Tomcat. To change the memory:

1. Go to Start > Apps > Apache Tomcat 9.0 Tomcat9 > Configure Tomcat.
2. On the Java tab, set the value of Initial memory pool and Maximum memory pool.
3. Click Apply.
4. Click OK.

1. Go to Start > Apps > Apache Tomcat 9.0 Tomcat9 > Configure Tomcat.
2. On the Logging tab, copy Log path value displayed here and open it in the Windows Explorer for Tomcat log files. There are several additional log files in the log folder but only following two log files are mainly used.
   
   

     catalina<date>.log : Server global log file

     localhost_access_log.<date>.txt : Server Access Log file

Tomcat's main configuration file is the server.xml located at …/<ApacheInstallFolder>/Tomcat<version_no>/conf.

 Change non-SSL/TLS HTTP/1.1 Connector on port number 8080 to the desired port number.

Configure a connector for the port given in redirectPort. Update the Keystore path, password, and the server name in the file. Save the file.

SSL Configuration

1. Go to …/<ApacheInstallFolder>/Tomcat<version_no>/conf.
2. Open web.xml file.
3. Add the security constraint at the end of the file.
   
   
   
   
4. Go to Start > All Programs > Apache Tomcat 9.0 > Configure Tomcat.
5. On the Java tab, append the below lines in the Java Options box.
   

   -Djavax.net.ssl.trustStore=<Adeptia Connect Truststore location)

   -Djavax.net.ssl.trustStorePassword=<Adeptia Connect Truststore password>

   
   

To check the status of Tomcat, open the browser and type the URL in the below format:

<protocol_name>://<IP_address>:<port_number> 

where,

<protocol_name> is the name of the protocol you are using, for example, HTTP or HTTPS.

<IP_Address> is the IP address of the computer where Apache Tomcat 9 is installed.

<port_no> is the port number of the computer on which Apache Tomcat 9 is installed.

For example, http://192.168.1.1:80

The Tomcat welcome page appears, indicating Tomcat is running.

1. Go to …/<ApacheInstallFolder>/Tomcat<version_no>/logs.
2. Open application_system.log file to view the logs.

1. Go to …/<ApacheInstallFolder>/Tomcat<version_no>/webapps/Working_Directory/resources_config.
2. Open application.properties file in the Text Editor.

3. Set the IP address where Adeptia Suite is running in the app.adeptia.host.url.
   The URL format for app.adeptia.host.url is

   <protocol_name>://<IP_Address>:<port_no>

   where,

   <protocol_name> is the name of the protocol you are using, for example, HTTP or HTTPS.

   <IP_Address> is the IP address of the computer on which Adeptia Suite is running.

   <port_no> is the port number of the computer on which Adeptia Suite is running.

   For example,

   http://10.0.0.125:8080

We don't recommend upgrading to Tomcat version. However, if required contact Adeptia Support as upgrading on your own can cause system failure.