Running two Jazz servers on the same machine

TwoTomcatI got recently this interesting question from a friend and colleague to assist one of our customers.

To be able to handle two instances of Jazz server, we need to change the port number of one of them. Based on this first knowledge, I found this page on the CLM Doc online.

Unfortunately, it is not enough. Actually, I get this weird error when I try launching both servers.

Failed to initialize end point associated with ProtocolHandler [“http-bio-9443”]

Finally, I looked for a page explaining how to launch two Tomcats on the same machine and I found this useful page.

To summarize the result of my investigations, for the second server instance, I had to patch the following lines in the server.xml file located at /server/tomcat/conf.

Replace the Shutdown element

<Server port="9005" shutdown="SHUTDOWN">

by

<Server port="new_shutdown_port_number" shutdown="SHUTDOWN">
  • with new_shutdown_port_number = 13005, for example

Replace the Endpoint element

<Connector port="9080" protocol="HTTP/1.1"
    connectionTimeout="20000"
    redirectPort="9443" />

by

<Connector port="new_non_SSL_port" protocol="HTTP/1.1"
    connectionTimeout="20000"
    redirectPort="new_SSL_port" />
  • with new_non_SSL_port = 13080, for example
  • with new_SSL_port = 13043, for example

Replace the SSL element

<Connector port="9443"
    connectionTimeout="20000"
    maxHttpHeaderSize="8192"
    maxThreads="150"
    minSpareThreads="25"
    enableLookups="false"
    disableUploadTimeout="true"
    acceptCount="100"
    ...>

by

<Connector port="new_SSL_port"
    connectionTimeout="20000"
    maxHttpHeaderSize="8192"
    maxThreads="150"
    minSpareThreads="25"
    enableLookups="false"
    disableUploadTimeout="true"
    acceptCount="100"
    ... >
  • with new_SSL_port = 13043, for example

Replace the AJP element

<Connector port="9009" protocol="AJP/1.3"
     redirectPort="9443" enableLookups="false" />

by

<Connector port="new_AJP_port" protocol="AJP/1.3"
    redirectPort="new_SSL_port" enableLookups="false" />
  • with new_AJP_port = 13009, for example
  • with new_SSL_port = 13043, for example

Save the file and you are done ! You can now launch your two Jazz/Tomcat servers on the same machine.

I hope it will help.

Backing up the Jazz Team Server

Recently I got this question from a customer: “What are the other files in Tomcat we should backup when we backup our JTS databases?”

I was ready to reply the default answer I used to reply with Rational Team Concert 2.x: “Backup tomcat-users.xml, teamserver.propertiesserver.xml files.
Then I realized that the answer might be too short for RTC 3.x and the new associated topology so I decided to bother my L3 support colleague (and friend!), Eric Jodet.

Eric kindly sent me a folder containing the list of the files backed up by IBM Install Manager when it upgrades RTC and I realized that I was very far from the reality with my 3 initial files.

It is for this reason I decided to share this information until we get a page in the CLM help covering this point.
Read More »