Configuring IBM Rational Change to use the hostname instead of the IP address

Technote (FAQ)


Question

How can you configure IBM Rational Change to use the hostname instead of the IP address?

Cause

User may want to use the IP address or hostname in a URL to access Change.

Answer

IBM Rational Change can be configured to use IP addresses, fully qualified domain names, or relative paths when generating URL's. This feature has been added for situations where using the hostname alone may cause problems with name resolution. For example, if the server name is "matrix ", the standard URL would begin with: http://matrix:8600/servlet

 

WARNING: Switching between hostname and IP address for IBM Rational Change URLs invalidates all existing cookies used by the server. Users must delete cookies after this setting is changed to ensure that transitions and reports will work properly.

 

Details

 

In order to configure IBM Rational Change to use a hostname rather than an IP address, the following lines must be added to the pt.cfg file for all versions of Change.

The pt.cfg file is located at: \cs_app\webapps\synergy\WEB_INF\wsconfig\pt.cfg



    # This setting specifies how CS should generate its links. (absolute or relative)

    #

    [CCM_SYSTEM][GENERATED_LINKS] relative [/GENERATED_LINKS][/CCM_SYSTEM]

    #

    # Should CS use the hostname or ipaddress.

    #

    [CCM_SYSTEM][DEFAULT_HOST_TYPE] hostname [/DEFAULT_HOST_TYPE][/CCM_SYSTEM]


 

If the hostname setting is used for DEFAULT_HOST_TYPE and GENERATED_LINKS is set to absolute, the following changes must also be made:

 

For Change Synergy 4.2, 4.3, or 4.4 specifically:

1. Edit the synergy.xml file at ...\cs_app\etc\synergy.xml

2. Make a backup copy of the synergy.xml file. Open the synergy.xml file and locate the following lines:

    
  <Call name="setInitParameter">

              <Arg>port</Arg>

              <Arg>(YOUR CS PORT NUMBER HERE)</Arg>

        </Call>

3. Directly under this code, make the following entry

     
<Call name="setInitParameter">

             <Arg>hostname</Arg>

             <Arg>(Your Fully Qualified Hostname Name Here)</Arg>

        </Call>

4. Make sure this entry is directly above the line that reads:

   
<Set name="InitOrder">1</Set>

 

For Change 4.5, 4.6, 4.6.1, 4.7, 5.0, or 5.1 specifically:  

1. Edit the web.xml file at ...\cs_app\webapps\synergy\WEB-INF\web.xml

2. Make a backup copy of the web.xml file. Open the web.xml file and locate the following lines:

        
<init-param>
                  <param-name>port</param-name>
                  <param-value><Port number></param-value>
           </init-param>


3. Directly below these lines, make the following entry

       
<init-param>

                  <param-name>hostname</param-name>

                  <param-value>(Your Fully Qualified Hostname Name Here)</param-value>

          </init-param>

4. Make sure this entry is directly above the line that reads:

   
<load-on-startup>1</load-on-startup>

For Rational Change 5.2 specifically:

1. Edit the web.xml file at ...\jetty\webapps\<context-name>\WEB-INF\web.xml

Example: ...\jetty\webapps\change\WEB-INF\web.xml

2. Make a backup copy of the web.xml file. Open the web.xml file and locate the following lines:


<context-param>

                <param-name>port</param-name>

                <param-value>8600</param-value>

        </context-param>


3. Directly below these lines, make the following entry


<context-param>

                <param-name>hostname</param-name>

                <param-value>(Your Fully Qualified Hostname Name Here)</param-value>

        </context-param>


4. Make sure this entry is directly above the line that reads:


<listener>

                <listener-class>

                        com.telelogic.cs.BootstrapContextListener

                </listener-class>


When the above modifications and or additions have been made, save the files and restart the Change server to see these changes have taken effect.

Historical Number

KB5917

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

Rational Change
General Information

Software version:

4.6, 4.6.1, 4.7, 5.0, 5.1, 5.2, 5.2.0.2

Operating system(s):

AIX, Linux, Solaris, Windows

Reference #:

1324472

Modified date:

2012-11-29

Translate my page

Machine Translation

Content navigation