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.
Restart the operating system, and then restart
the Apache Tomcat server.
Restart the Apache Tomcat server.
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
To start the server on Windows, complete one of these steps: - Click 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
To stop the server, complete one of these steps: - Click
- Change to the HPInstallDir/server directory
and run this command:
server.shutdown.bat
Starting the server on 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
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.