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.

  1. Browse to https://tomcat.acme.com:8443/manager/html
  2. Locate on the form within Tomcat’s Manager administration page for the deployment of an additional Web Archive from a local file
  3. Click the Choose File button and browse to the location of the oslc-windchill.war file on the local machine
  4. Click Tomcat’s Deploy button
  5. 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 archive /opt/bitnami/apache-tomcat/webapps/oslc-windchill.war
  6. Configure the required context parameters, as described in the Configuring Context Parameters section
  7. 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.

  1. Secure Shell (Ssh) or Remote Desktop (RDP) into log in the host tomcat.acme.com
  2. Copy the oslc-windchill.war file into Tomcat’s webapps folder.
  3. Restart the Tomcat server.

Editing context parameters

The Windchill Adapter requires some parameters to be configured:

  1. Secure Shell (Ssh) or Remote Desktop (RDP) into the Apache Tomcat server and change directory to the location of Tomcat’s configuration files: <apache-tomcat>/conf
  2. 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:

<Context>
  ...
  <Parameter name="myParamName" value="myParamValue" override="1"/>
  ...
</Context>