Resolving port conflicts on Jetty

Jetty port conflicts can occur when IBM® Rational® Change installations are using the same port that is in use by another application.

About this task

Look in the jetty.xml file to obtain the port number used by the software.

Port conflicts can also cause related errors, including undefined users and port access failures. These problems might not appear immediately. If the Jetty web server log reports that there are port conflicts or that subsequent use of Rational Change causes errors, check the log files for warnings about port conflicts and related errors.

These steps are the same of Windows and UNIX.

Procedure

To resolve port conflicts on Jetty:

  1. Log on as the IBM Rational Synergy administrator.
  2. Stop the server.
  3. Change the directory to CHANGE_HOME\jetty\etc (CHANGE_HOME is item 1 on the work sheet).
  4. Make a backup copy of the jetty.xml file, and then open the file.
  5. Change the Rational Change port entry.
    1. Find the entry for the Rational Change port. For example:
      <!-- Configure the SocketListner / What port Jetty is running on -->
      <Call name="addListener">
      <Arg>
      <New class="org.mortbay.http.SocketListener">
      <Set name="Port">8600</Set>
      <Set name="MinThreads">5</Set>
      <Set name="MaxThreads">255</Set>
      <Set name="MaxIdleTimeMs">60000</Set>
      </New>
      </Arg>
      </Call>
    2. Change the port setting to an unused port number. For example:
      <Call...>
      <Arg...>
      <Set name="Port">8888</Set>
      ...
      </Arg>
      </Call>
      Note: The Rational Change server service name remains unchanged even if you change the port number.
  6. Save and close the jetty.xml file.
  7. Repeat steps 4 to 6 for the web.xml file in the CHANGE_HOME\jetty\webapps\context\WEB-INF directory.

    The entry in the web.xml file is slightly different. For example:

    <context-param>
    <param-name>port</param-name>
    <param-value>8600</param-value>
    </context-param>
  8. Start the server.

Feedback