Starting Apache Tomcat

Start the Apache Tomcat server to deploy the adapter web application.

Before you begin

Apache Tomcat is secure.

About this task

Apache Tomcat is installed in the HPInstallDir/server/tomcat directory. The web application (hpqm.war), is installed in the Apache Tomcat directory webapps. When you start the server, you start the adapter web application.
Tips:
  • Apache Tomcat is configured to use ports 9080 and 9443 in the HPInstallDir/server/tomcat/conf/server.xml file. If necessary, change the port assignments as appropriate for your system. For example, running the adapter on the same server that is used by CLM requires a change to the port assignments. For more information, see Changing the port numbers for the application server.

  • The HPInstallDir/server/logs directory contains the server log files. If you cannot start the server, check the log files.
  • For Windows Restart the operating system, and then restart the Apache Tomcat server.
  • For Linux Restart the Apache Tomcat server.
  • For Linux If you installed the adapter application with administration privileges, you must also start and stop the Apache Tomcat server by running the commands with administration privileges. You can either log in as an administrator or run the commands with sudo, for example, sudo ./server.startup.sh or sudo./server.shutdhown.sh
  • The HPInstallDir/server/tomcat/conf/server.xml file contains SSL settings that specify an algorithm that is only available in the IBM® Java™ Runtime Environment (JRE). To run the server with an Oracle JRE, in the server.xml file, change the settings for Connector port="9443", so that sslProtocol="TLS" instead of "SSL". Also remove the algorithm parameter.

Procedure

Starting the server on Windows

  1. For Windows To start the server on Windows, complete one of these steps:
    • Click Start > All Programs > IBM Rational Adapter for HP ALM > Start the HP ALM Server to start the Apache Tomcat application server.
    • Change to the HPInstallDir/server directory and run the following command:
      server.startup.bat  
      Important:
      • Do not stop the server before the adapter web application is deployed. If you do stop the server, you must delete the hpqm/ directory under webapps/ and start the server again to deploy the adapter web application.
      • If the server is installed in the default Program Files directory, to be able to write to this directory, you must run the startup program as an administrator in Windows Server 2008 R2.
    A separate Apache Tomcat console window opens. If you close this window, the server stops. Depending on your installation options, the server startup might take a few minutes. After the server is started, the startup time in milliseconds is displayed in the Tomcat window. For example, Server startup in 203645 ms

Stopping the server on Windows

  1. For Windows To stop the server, complete one of these steps:
    • Click Start > All Programs > IBM Rational Adapter for HP ALM > Stop the HP ALM Server
    • Change to the HPInstallDir/server directory and run this command:
      server.shutdown.bat

Starting the server on Linux

  1. For Linux To start the server, from the HPInstallDir/server directory, run this command:
    ./server.startup.sh
    Important: Do not stop the server before the adapter web application is deployed. If you do stop the server, you must delete the hpqm/ directory under webapps/ and start the server again to deploy the adapter web application.
    A separate Apache Tomcat console window does not open. You can check the server startup progress by viewing the HPInstallDir/server/logs/jts.log. After you access the server for the first time, the logs directory under HPInstallDir/server is created.

Stopping the server on Linux

  1. For Linux To stop the server, from the HPInstallDir/server directory, run this command:
    ./server.shutdown.sh

What to do next

Set up properties for the adapter, see Setting up adapter properties.

Feedback