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 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.


  1. Stop the application server.
  2. Update the application server port numbers.
    • For WebSphere Application Server:
      1. Start WebSphere 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"
        			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.