Deploying and starting Apache Tomcat
During the installation process if you chose to use Apache Tomcat™ for your Web Servlet Engine, then it is
now time to start the Apache Tomcat Server and, thereby, start the RLIA Adapter web application.
Installing through Tomcat’s web Manager
Follow these steps when using Tomcat’s web interface for servlet deployment.
- Browse to
- Locate on the form within Tomcat’s Manager administration page for the deployment of an additional Web
Archive from a local file
- Look for "Select WAR file to upload"
- Click the Choose File button and browse to the location of the oslc-windchill.war file on the local
- Click Tomcat’s Deploy button
- depending on the uplink bandwidth, this may take a minute or two to upload
- Refresh the Tomcat Manager page in the browser until the Manager shows that the oslc-windchill WAR is one of
the available web services [*]. One can also check the catalina.log file as well for a message similar
to: Apr 18, 2014 7:41:03 PM org.apache.catalina.startup.HostConfig deployWAR INFO: Deploying web application
- Configure the required context parameters, as described in the Configuring
Context Parameters section
- Restart the Tomcat server
[*] If the Tomcat Manager fails to automatically deploy the oslc-windchill.war web archive, consult the Tomcat
site for guidance on diagnosing war deployment issues. If diagnosis indicates that there is a problem with the
oslc-windchill.war file, please contact your IBM associate for further technical assistance.
Installing through Tomcat’s local file system
Follow these steps when installing directly on the host system for the Apache Tomcat server.
- Secure Shell (Ssh) or Remote Desktop (RDP) into log in the host
- Copy the
oslc-windchill.war file into Tomcat’s webapps folder.
- Restart the Tomcat server.
Editing context parameters
The Windchill Adapter requires some parameters to be configured:
- Secure Shell (Ssh) or Remote Desktop (RDP) into the Apache Tomcat server and change directory to the location
of Tomcat’s configuration files:
- Edit the
context.xml file to add required context parameters, as listed in the Configuring
Context Parameters section.
A parameter is set in Tomcat context using the following declaration:
<Parameter name="myParamName" value="myParamValue" override="1"/>