(Tip for Jazz Administration) : Hide port numbers from the public server URI

This article provides tips for administrators looking for hiding port numbers from the public server URL when configuring the Jazz server initially. It covers both Tomcat and WebSphere server configurations.

Hide port numbers from the public server URI

For eased user access or for later administration purpose, you may want CLM2011 applications to answer with URLs including no port. For example :

https://clm.example.org/ccm rather than https://clm.example.org:9443/ccm
or
https://ccm.example.org/ccm rather than https://ccm.example.org:9443/ccm
https://qm.example.org/qm rather than https://qm.example.org:9443/qm
https://rm.example.org/rm rather than   https://rm.example.org:9443/rm

Reminder

By default :

  • web servers use port 80 for non secure communications (over HTTP) and port 443 for secure communications (over HTTPS).
  • web browsers could access HTTP(S) servers configured this way without having to include the port number in the URL.

Once you have set the Public URI of your applications, you cannot change it afterwards. For more information, see Planning your URIs.

Procedure for a Tomcat server

Following steps guide you for this :

  1. In a text editor, open JazzInstallDir/server/tomcat/conf/server.xml.
  2. Search for the <Connector>element for the non-secure port.
    Note : by default, this <Connector> element is not commented out, has a comment above it that says
    <!– Define a non-SSL HTTP/1.1 Connector on port 9080 –>, and has a redirectPort attribute.
  3. Modify the value of the port attribute with port number 80 to use for non-secure connections.
  4. Modify the value of the redirectPort attribute with port number 443 to use for secure connections.
  5. After you have modified the <Connector> for the non-secure port, search for the <Connector> element for the secureport.
    Note: by default, this <Connector> element is not commented out and has the attribute secure=”true”.
  6. Modify the value of the port attribute with the port number 443 to use for secure connections.
  7. Save the server.xml file.
  8. Start the application server.

As a result, you should have a server.xml file looking like this :

<!– Define a non-SSL HTTP/1.1 Connector on port 80 –>
<Connector port=”80″

redirectPort=”443″
…./>
<!– Define a SSL HTTP/1.1 Connector on port 443 –>
<Connector port=”443″

scheme=”https”
secure=”true”
…./>
….

Procedure for a WebSphere Application Server

Following steps guide you for this :

    1. Start the application server.
    2. Log in to the Integrated Solutions Console as an application server administrator.
    3. Click Servers > Server Types > WebSphere Application Servers > server_name > Ports.
    4. Modify the value for WC_defaulthost with port number 80 to use for non-secure, HTTP connections. Note : make sure this value is not used already.
    5. Modify the value for WC_defaulthost_secure with port number 443 to use for secure, HTTPS connections. Note : make sure this value is not used already.
    6. Click Apply, then click “Save directly to the master configuration”.
As a result, “Ports” should now appear this way :
  1. Stop, and then restart the application server.

Next step : Configure the Jazz Team Server

You can now use the setup wizard to configure the Jazz Team Server. Make sure you use the public URL with no port ! For more information, see Running the setup wizard.

N.B. (for Linux users): all ports below 1024 are “privileged” ports (only root may open a privileged port).

General notes

Here, assumption is made that ports 80 and 443 are available on the machine. This might not be the case :

  • if another server is using one of these ports, or
  • if your CLM applications (JTS, CCM, QM and/or RM) are running on different servers but are at least partly collocated on the same machines.

As mentioned in the Summary, only an initial configuration of the Jazz server was considered in this article.

If you must change the port number your Jazz server is responding on – while also maintaining URL stability -, consider using a reverse proxy to route requests using the old port number to the appropriate new location.

For more information

  1. Moving Jazz Servers and URI Stability with CLM 2011
  2. Change the default port
  3. WebSphere 7 Information Center
  4. Using virtual host names in your topology
  5. Using a reverse proxy in your topology
  6. Configuring Enterprise CLM Reverse Proxies, Part 1: Understanding Reverse Proxy
  7. Configuring Enterprise CLM Reverse Proxies, Part 2: WebSphere and IHS Plugin method
Advertisements

2 thoughts on “(Tip for Jazz Administration) : Hide port numbers from the public server URI

Add yours

  1. Great article. Simple steps to follow and it allows people to effectively hide the port numbers of their Jazz servers.

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

Create a free website or blog at WordPress.com.

Up ↑

%d bloggers like this: