Changing the host name of an IBM i Sametime Community Server

The command CHGLSTDOM simplifies the process for changing the host name setting of an IBM® i Sametime® Community Server.

About this task

The procedure described in this section can also be used to correct problems with the configuration of your Sametime server. For example, if your TCP/IP host table did not correctly list the fully qualified host name first at the time that you setup your Sametime Community Server, many elements of your server configuration may be incorrect. You can correct this problem by following this procedure to change the host name of your Sametime Community Server.

Procedure

  1. Update your host table so that the new host name is associated with the appropriate IP address. Make sure that the fully qualified host name is listed first among the entries for your Sametime server, before any short names. For more information, see Updating the host table on IBM i.
  2. Likewise, update your DNS entries so that the new host name is associated with the appropriate IP address. Check whether your server is configured to search the Domain Name Server (DNS) before the host table. If it is, you must also make sure that the fully qualified host name of your Sametime Community Server is listed first in the DNS. To check the configured search order, see Updating the Domain Name Server for IBM i.
  3. End the IBM i Sametime Community Server.
  4. Update the host name for the Domino® server using the CHGDOMSVR command. For detailed information on changing the configuration of a Domino server, refer to Updating the configuration of existing IBM i Domino servers.
  5. On any IBM i command line, type the following and press F4: CHGLSTDOM
  6. On the Change Sametime on Domino display, specify the following and then press Enter:
    • The name of the IBM i Sametime Community Server where you want to make this change (for example, stdom1).
    • The new fully qualified host name for the IBM i Sametime Community Server (for example, stdom1.acme.com).
      • Updates the Ports -Notes Network Ports - Net Address field in the Server document.
      • Adds the host name to the Internet Protocols - HTTP - Host name field in the Server document.
      • Updates Sametime files that reference the host name.
    Note: If your server is enabled for both IPv4 and IPv6 addressing, you must manually update the sametime.ini file so that "VPS HOST=" is set to an explicit IP address, rather than the host name, after running the CHGLSTDOM command. See Configuring the Community Services for IPv6 for detailed instructions.
  7. Start the IBM i Sametime Community Server.
  8. Open the Domino directory (names.nsf) on your IBM i Sametime Community Server and edit the Server document. Look at the Internet Protocols - HTTP tab in the Server document and locate the Basics - Host name(s) field.
  9. The Basics - Host name(s) field may contain more than one name. If any of the names are incorrect or not needed, delete them. Make sure that the correct fully qualified host name is listed first in the field.
    Note: If your server is configured for both IPv4 and IPv6 addressing, there are additional considerations when updating the Host name field. See Configuring Domino for IPv6 on IBM i for detailed instructions.
  10. Save and close the Server document.
  11. If you are using HTTP Tunneling with multiple IP addresses, then additional configuration updates are required. See "Updating the host names when using HTTP Tunneling with multiple IP addresses" later in this section.
  12. Stop and restart the IBM i Sametime Community Server for the changes to take effect.

What to do next

Updating the IBM i host names when using HTTP Tunneling with multiple IP addresses

If you are using HTTP Tunneling with multiple IP addresses, then you must update your configuration manually after using the CHGLSTDOM command to change the IBM i server host name. If you are not using HTTP Tunneling with multiple IP addresses then this step is not applicable.

The CHGLSTDOM command placed the new host name in the tunneling host name fields, but did not preserve the required prefixes, such as community-, meeting- and broadcast-, in the Sametime configuration. Use the Sametime Administration tool to update the host names in the following fields in the "Connectivity" section:

  • Community Services Network settings -> Address for client Connections-Host name should have prefix of community-
  • Community Services Network settings -> Address for HTTP tunneled client Connections-Host name should have prefix of community-