Technote (FAQ)

Question

How do you configure IBM Rational Rhapsody Design Manager (RDM) to run simultaneously on the same machine where another instance of Apache Tomcat is already operating to host other Jazz products such as IBM Rational Team Concert?

Cause

By default, Apache Tomcat application (Tomcat) server uses a non-secure port 9080 and secure port 9443, along with ports 9005 and 9009. These default ports will conflict with a Tomcat instance(s) hosting other Jazz products on your system if you don't configure the new installation of RDM properly.

Answer

The following steps explain how to set RDM to utilize non-default ports, allowing you to start it while another Jazz product is already running on the default ports. This allows you to run both servers concurrently.

Note: If you're planning to install a version of RDM on top of any existing Jazz product of the same version (e.g. installing RDM v4.0 on top of RTC v4.0) or run one instance of Jazz product at a time, you don't need to change default ports. If you have a multiple installation that is using Tomcat and have different Jazz products installed in different installations packages, and if you want to run those Jazz products concurrently, then follow this technote. Otherwise, check your configuration using "Interactive Installation Guide" and simply follow the given instruction.

Three Steps: Overview

Step 1 - Know which ports are possibly used by another Jazz product.

Step 2 - Find out which ports are occupied by another Jazz product.

Step 3 - Make changes and validate if port changes were successfully made.

Step 1 - Know which ports are possibly used by another Jazz product.

Default ports used by Tomcat starts with the number "9"(e.g. 9080) and they are defined in Tomcat's server.xml file using the <Connector> XML element. The server.xml file is located at <RDM installation folder>/server/tomcat/conf/server.xml. Below is the definition of connector as defined in Apache Tomcat Architecture page.

A Connector handles communications with the client. There are multiple connectors available with Tomcat. These include the HTTP connector which is used for most HTTP traffic, especially when running Tomcat as a standalone server, and the AJP connector which implements the AJP procotol used when connecting Tomcat to a web server such as Apache HTTPD server. Creating a customized connector is a significant effort.

The table below shows the list of default ports you may need to change to avoid port conflicts.

Default Port table

Default Port

Usage

How to change

Remark

9080

Define a non-SSL Connector on which the connector listens for HTTP requests that will be received via client's browser.

Open server.xml file in your preferred text editor and replace all instances of "9080" with any available port (e.g. 9081).

Change is recommended.

9443

Define a SSL Connector on which the connector listens for HTTPS requests that will be received via client's browser. Incoming requests received on non-SSL port is redirected to this port.

Open server.xml file in your preferred text editor and replace all instances of "9443 " with any available port (e.g. 9444 ).

Change is MUST.

9005

Define a Connector on which this server waits for a shutdown command.

Open server.xml file in your preferred text editor and replace all instances of "9005 " with any available port (e.g. 9006).

Change is recommended.

9009

Define an AJP 1.3 Connector that supports the communication using AJP protocol. This connector is used for integrating Tomcat with Apache Web server. See more information at AJP Connector page in Apache Tomcat site.

Open server.xml file in your preferred text editor and replace all instances of "9009 " with any available port (e.g. 9010).

Change is recommended if this port is used by other Jazz product.

1527

Define a Database Network Server Port for Data Warehouse. Applicable only Derby. On Derby, the JTS will act as the Database Network server for Data Warehouse, and its port must be unique within the hosting server machine.