Forcing an SSL connection with CM Server

You can force the Change Management Server (CM Server) to process non-SSL requests as SSL requests.
The following variables are used in path names in this topic:
yourServerName
CM Server host name
RATIONAL_COMMON
Directory where the Rational common files are installed

To force CM Server to process non-SSL requests as SSL requests:

  1. Edit the file httpd.conf, which is located in the following directory:
    • On Windows: drive:%RATIONAL_COMMON%\IHS\conf
    • On the UNIX system and Linux: $RATIONAL_COMMON/IHS/conf
    1. Add or modify the VirtualHost settings to include the following commands. Replace yourServerName with the name of your CM Server host, and %RATIONAL_COMMON% or $RATIONAL_COMMON with the path specification where the Rational common files are installed:
      • On Windows®:
        <VirtualHost *:80>
        ServerName yourServerName
        RewriteEngine on
        RewriteCond %{SERVER_PORT} !^443$
        RewriteRule ^(.*)$ https://yourServerName$1 [R]
        RewriteLogLevel 0
        RewriteLog "drive:\%RATIONAL_COMMON%\IHS\logs\rewrite.log"
        </VirtualHost>
      • On the UNIX system and Linux:
        <VirtualHost *:80>
        ServerName yourServerName
        RewriteEngine on
        RewriteCond %{SERVER_PORT} !^443$
        RewriteRule ^(.*)$ https://yourServerName$1 [R]
        RewriteLogLevel 0
        RewriteLog "$RATIONAL_COMMON/IHS/logs/rewrite.log"
        </VirtualHost>
      Attention: Ensure that the commands are placed appropriately in the file so that they run before the WebSphere® Application module and the WebSphere Plug-in module.
    2. Include the file ssl.conf by adding the following command:
      # include ssl information
      Include conf/ssl.conf
    3. Save your changes and close the file.
  2. Edit the file ssl.conf to provide the correct SSL certificate path information. The file ssl.conf is located in the following directory:
    • On Windows: drive:\%RATIONAL_COMMON%\IHS\conf
    • On the UNIX system and Linux: $RATIONAL_COMMON/IHS/conf

    Save your changes and close the file.

  3. Edit the file CqServerConn.properties, which resides in the following directory:
    • On Windows: drive:\%RATIONAL_COMMON%\CM\profiles\profileName\installedApps\nodeNameCMProfileNode01Cell\RationalClearQuestWeb.ear\CQWebModule.war\WEB-INF\classes
    • On the UNIX system and Linux: $RATIONAL_COMMON/CM/profiles/profileName/installedApps/nodeNameCMProfileNode01Cell/RationalClearQuestWeb.ear/CQWebModule.war/WEB-INF/classes
    1. Change the value of the parameter HELP_SERVER_URL from this:
      HELP_SERVER_URL=http://localhost
      to this:
      HELP_SERVER_URL=https://localhost
    2. Save your changes and close the file.
  4. Restart the IBM HTTP Server.

Feedback