Changing WebSphere Application Server Network Deployment HTTP server and transport ports

To change the application HTTP server and transport ports, use the WebSphere® Application Server administrative console, restart WebSphere Application Server, and then edit other configuration files.

About this task

This task applies to stand-alone (non-cluster) environments only.

Procedure

  1. Change the port and virtual port values in the WebSphere Application Server administrative console.
    1. Start the WebSphere Application Server administrative console.
    2. Click Servers > Server Types > WebSphere application servers.
    3. Select the server for which you want to change the port.
    4. Click Ports.
    5. Change the value of the port that you want to change by clicking the port name link, changing the port number, and clicking OK.
      • To change the value of the HTTP server port or HTTP transport port, change the WC_defaulthost value.
      • To change the value of the HTTPS port, change the WC_defaulthost_secure value.
    6. Click Environment > Virtual Hosts.
    7. Select default_host.
    8. Select Host Aliases under Additional Properties.
    9. Change the old values to the new ones that you specified earlier by clicking the asterisk (*) link next to the port number, changing the port number, and clicking OK.
    10. Click Save directly to the master configuration.
  2. Stop and restart WebSphere Application Server.
  3. Update the port value in the Version.xml files.
    These files contain the installation records that are used by the installation program. Keeping these files current avoids problems with future installations. Update the following Version.xml files:
    • The file that is on the server that hosts the engine tier
    • The file that is on the server that hosts the services tier

    On each server, the Version.xml file is located in the IBM® InfoSphere® Information Server installation directory.

    Edit each file as follows:
    1. Use a text editor to open the Version.xml file.
    2. In the file, locate the following XML element:
      <PersistedVariable encrypted="false" name="is.console.port" 
          persistent="true" readonly="true" value="port" />
    3. Change the value attribute to the new HTTPS port if HTTPS is configured. If HTTPS is not configured, specify the new HTTP port.
    4. In the file, locate the following XML element:
      <PersistedVariable encrypted="false" name="isf.http.port" 
          persistent="true" readonly="true" value="port" />
    5. Change the value attribute to the new HTTPS port if HTTPS is configured. If HTTPS is not configured, specify the new HTTP port.
    6. If you changed the WC_defaulthost value in step 1, specify the same value in the following XML element:
      <PersistedVariable encrypted="false" name="was.default.host.port" 
          persistent="true" readonly="true" value="port" />
    7. If you changed the WC_defaulthost_secure value in step 1, specify the same value in the following XML element:
      <PersistedVariable encrypted="false" name="was.secure.default.host.port" 
          persistent="true" readonly="true" value="port" />
  4. Modify the registered-servers.xml file on each computer that hosts the services tier. This file is located in the following location, where IS_install_path is the location of your InfoSphere Information Server installation directory.
    Operating system Installation directory
    AIX® IS_install_path/ASBServer/conf/
    Note: The default installation location is /opt/IBM/InformationServer.
    Linux IS_install_path/ASBServer/conf/
    Note: The default installation location is /opt/IBM/InformationServer.
    Windows IS_install_path\ASBServer\conf\
    Note: The default installation location is C:\IBM\InformationServer.
    Edit the file as follows:
    1. Open the file in a text editor.
    2. In the file, locate the following XML element:
      <asb-server name="host"
                  host-name="host"
                  port="port"
                  is-primary-server="true" />

      There might be multiple <asb-server> elements in the registered-servers.xml file. Modify the <asb-server> elements for the servers whose port numbers are changing.

    3. Update the port value.
    4. Save your changes.
  5. Modify the registered-servers.xml file on each computer that hosts the engine tier. This file is located in the following location, where IS_install_path is the location of your InfoSphere Information Server installation directory.
    Operating system Installation directory
    AIX IS_install_path/ASBNode/eclipse/plugins/com.ibm.iis.client
    Linux IS_install_path/ASBNode/eclipse/plugins/com.ibm.iis.client
    Windows IS_install_path\ASBNode\eclipse\plugins\com.ibm.iis.client
    Edit the file as follows:
    1. Open the file in a text editor.
    2. In the file, locate the following XML element:
      <asb-server name="host"
                  host-name="host"
                  port="port"
                  is-primary-server="true" />

      There might be multiple <asb-server> elements in the registered-servers.xml file. Modify the <asb-server> elements for the servers whose port numbers are changing.

    3. Update the port value.
    4. Save your changes.
  6. Optional: Modify the registered-servers.xml file on each computer that hosts the client tier. The list of servers in these files is used to populate the server lists in the login pages for some client applications. You can update these files if you want to have the updated port values shown on the next login attempt. Alternatively, you can enter the new value in the login page the next time that you log in. However, the old host name and port continue to display in the lists in some client application login pages unless you modify the registered-servers.xml file on the computer.
    Modify the file in one of the following ways:
    • Change the file in the same way that you modified the registered-servers.xml files on the engine tier computers.
      Note: On client-only computers, the is-primary-server="true" attribute does not appear in the <asb-server> element.
    • Run the RegistrationCommand command:
      Operating system Command
      AIX cd /opt/IBM/InformationServer/ASBNode/bin ./RegistrationCommand -remove -hostname host -port port
      Linux cd /opt/IBM/InformationServer/ASBNode/bin ./RegistrationCommand -remove -hostname host -port port
      Windows cd C:\IBM\InformationServer\ASBNode\bin RegistrationCommand.bat -remove -hostname host -port port
      Note: These commands use example installation directories, which might be different from your own setup.
      Tip: To use the RegistrationCommand command to add the new host name and port number for a new server entry, run the command:
      Operating system Command
      AIX ./RegistrationCommand.sh -add -name host -hostname host -port port
      Linux ./RegistrationCommand.sh -add -name host -hostname host -port port
      Windows RegistrationCommand.bat -add -name host -hostname host -port port