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,
restart the operating system, and then restart the Apache Tomcat server.
On UNIX systems,
restart the Apache Tomcat server.
Procedure
Starting the server on Windows
To start the server on Windows, complete one of these steps:- From the Windows Start
menu, click 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
To stop the server, complete one of these steps:- From the Windows Start
menu, click
- 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
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.
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.