Changing the port numbers for the application server

If you do not want to use the default port numbers for the application servers, you can change them.

Before you begin

You must be able to stop and start the application server.

For Apache Tomcat, you must be able to access and modify the Apache Tomcat configuration files.

For WebSphere® Application Server, you must be an application server administrator and have access to the Integrated Solutions Console.

About this task

This must be done before setting the Public URI (that includes the port number) of your applications; after you have set the Public URI of your applications, you cannot change the Public URI. For more information, see Planning your URIs. If you must change the port number 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, see Reverse proxy servers in topologies.

Procedure

  1. Stop the application server.
  2. Update the application server port numbers.
    • For Tomcat:
      Note: Starting in version 6.0.1, Apache Tomcat is not provided as a default application server. However, Apache Tomcat is supported and you can use it. The following examples show Apache Tomcat installed in this location: JazzInstallDir/server/tomcat. If your version is in another location, change the installation path.
      For IBM i operating systemNote: Tomcat is not supported on IBM i.
      1. In a text editor, open JazzInstallDir/server/tomcat/conf/server.xml.
      2. Search for the <Connector> element for the non-secure port. 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 8080 -->, and has a redirectPort attribute.
      3. Modify the value of the port attribute with the new port number to use for non-secure connections. For example, if you want to use port 13080, type port="13080".
      4. Modify the value of the redirectPort attribute with the new port number to use for secure connections. For example, if you want to use port 13043, type redirectPort="13043".
      5. After you have modified the <Connector> for the non-secure port, search for the <Connector> element for the secure port. 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 new port number to use for secure connections. You must use the same number that you typed for the redirectPort attribute for the non-secure connection in step 2.d.
      7. Save the server.xml file.
      8. Start the application server.
    • For WebSphere Application Server:
      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 the new port number to use for non-secure, HTTP connections. Make sure this value is not the same as another port number in use by the application server.
      5. Modify the value for WC_defaulthost_secure with the new port number to use for secure, HTTPS connections. Make sure this value is not the same as another port number in use by the application server.
      6. Click Environment > Virtual hosts > default_host > Host Aliases and make sure your port number is listed there. If not, click New, leave the "*" symbol for Host Name and enter your new port number in the Port field. Click OK.
      7. Click Apply, then click Save directly to the master configuration.
      8. Stop, and then restart the application server.
    • For WebSphere Liberty server:
      1. In a text editor, open JazzInstallDir/server/liberty/servers/clm/server.xml.
        Note: In a fresh installation the JazzInstallDir/server/liberty/servers/clm/server.xml does not exist. It is created the first time you start the server. It can also be created by running the following command:For Unix operating systems
        cd JazzInstallDir/server
        ./server.startup -create
        For Windows operating system
        cd JazzInstallDir\server
        server.startup.bat -create
      2. Search for the <httpEndpoint> element and change the httpPort or httpsPort accordingly. The default looks like this:
        <httpEndpoint id="defaultHttpEndpoint"
        			host="*"
        			httpPort="9080"
        			httpsPort="9443" />
      3. Save the server.xml file.

What to do next

You can now use the setup wizard to configure the Jazz Team Server with the non-default port numbers. For more information, see Running the setup by using Custom setup in the setup wizard.