Starting Apache Tomcat

To deploy the adapter web application, you must start the Apache Tomcat server.

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.
Tip:
  • 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, if you run the HP adapter web application in the same instance of Apache Tomcat that is used by CLM, you must change the port assignments for the HP adapter. 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 For Windows, restart the operating system, and then restart the Apache Tomcat server.
  • For Linux On UNIX systems, restart the Apache Tomcat server.

Procedure

Starting the server on Windows

  1. For Windows To start the server on Windows, complete one of these steps:
    • From the Windows Start menu, click Start > All Programs > IBM Rational Adapter for HP ALM > Start the HP ALM Server to start the Apache Tomcat application server.
    • To start the server from the command line, 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:
    • From the Windows Start menu, click Start > All Programs > IBM Rational Adapter for HP ALM > Stop the HP ALM Server
    • To stop the server from the command line, change to the HPInstallDir/server directory and run this command:
      server.shutdown.bat

Starting the server on the UNIX systems

  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.
  2. 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 properties for the HP adapter.

Feedback