IBM Support

Customizing IBM Rational DOORS Web Access Tomcat ports

Question & Answer


Question

How can the Tomcat ports used by IBM Rational DOORS Web Access (DWA) be changed from their default values, so that DWA will not conflict with other running Tomcat-based applications installed on the same system?

Cause

The IBM Rational DOORS Web Access (DWA) server.xml file uses ports that are commonly used by other Tomcat-based applications.

Answer

IBM Rational DOORS Web Access (DWA) will not work if its bundled Tomcat is configured to use ports that are already in use. This is most common when you install DWA on a system that already has Tomcat running.

You can use the netstat command to see whether the default Tomcat ports are already in use.

On Microsoft Windows:

netstat -ab | find "<port>"

where <port> is the port number to search for (without the <>'s)
You will have to run the netstat command for each port you want to search for.

On UNIX:

netstat -ap | egrep '<port>|<port>|<port>' (to search for all 3 ports at once)

or

netstat -ap | grep <port> (if you do not have egrep)

where <port> is the port number to search for (without the <>'s)

If any default Tomcat ports are already in use, you will need to reconfigure DWA's Tomcat to use other ports. If you change ports in server.xml, you will have to update your DWA configuration to reflect your server.xml changes. Please refer to the DWA documentation for details on reconfiguring DWA.

To change the Tomcat ports used by DWA:

  1. If DWA is running, stop DWA as instructed in the DWA Install Guide.
  2. Go to the directory where you installed DWA.
  3. From that directory, go into the server/conf directory.
  4. In that directory is a server.xml file.
  5. Edit the server.xml file to change the default values of the ports to values that are not currently in use in your system.
    • For the basic DWA installation with no SSL, you will have to change ports 8005, 8009, and 8080.

    • If you use other services like SSL or the proxy server, you may have to change those ports as well.

  6. Save the server.xml file.
  7. Update your DWA configuration as needed to reflect your server.xml changes. Please refer to the DWA documentation for further details. At a minimum, verify that festival.xml, doorsRedirector.properties, and your DCN configuration are still correct.
  8. If you updated your DCN configuration, restart DOORS.
  9. Restart DWA. Refer to the DWA documentation for the exact steps to start DWA.

[{"Product":{"code":"SSKR2T","label":"IBM Engineering Requirements Management DOORS"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"General Information","Platform":[{"code":"PF033","label":"Windows"}],"Version":"1.2;1.3;1.3.0.1;1.3.0.2;1.4;1.4.0.1;1.4.0.2;1.4.0.3;1.4.0.4;1.4.0.5;1.5;1.5.0.1;9.5;9.5.0.1;9.5.1","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}},{"Product":{"code":"SSKR2T","label":"IBM Engineering Requirements Management DOORS"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":null,"Platform":[{"code":"","label":null}],"Version":"","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]

Document Information

Modified date:
01 May 2020

UID

swg21413308