Setting up a virtual host on the Sametime Advanced Server

Configure a virtual host on the Sametime® Advanced Server to avoid conflicts with the Sametime Proxy Server.

Procedure

  1. Log in to the WebSphere® Integrated System Console as the administrator.
  2. In the navigation pane, click Environment > Virtual Hosts, and then click New.
  3. Give the new virtual host a name, such as stadv_host for example, and then click Apply.
  4. Click Save in the "Messages" box that displays at the beginning of the page.
  5. In the Additional Properties section, click Host Aliases.
  6. Click New to create one or more new host alias entries.
  7. For each port you want the Sametime Advanced Server to be available on, enter the hostname and port, and then click OK. When you create the port entries, remember the following information:
    • The default ports are 9080, 80, 443, and 9443, but if you use custom ports instead of 80 and 443, then enter the custom port number instead. You do not typically need to remove or modify ports 9080 and 9443.
    • Do not remove port numbers 9080 and 9443 from the Default_Host, as the Sametime System Console uses these ports by default. If you remove the * for ports 9080 and 9443, ensure that you add the Sametime System Console host name for those ports.
    • Create the port entries for each of the specific node host names as well as for the load balancer address
  8. When you have added all host aliases, click Save in the "Messages" box that displays at the beginning of the page.
  9. Make sure there are no conflicting default_host entries for a port:
    1. In the navigation pane, click Environment > Virtual hosts.
    2. In the list of virtual hosts, click default_host.
    3. In the Additional Properties section, click Host Aliases.
    4. For each port that you assigned in Step 7, remove any wildcard (*) entries.
  10. Remap the virtual host for the Sametime Advanced Server applications. Return to the navigation pane, and click Applications > Application Types > WebSphere Enterprise Applications > Lotus Sametime Advanced Application.
  11. On the Configuration page, click Virtual hosts in the Web Module Properties section.
  12. In the Virtual host column, change each of the available choices from default_host to the name you defined in Step 3 (stadv_host in this example.
  13. Restart the Sametime Advanced Server and Sametime Advanced Server node(s) for the changes to take effect.

Results

After these steps are complete, the WebSphere HTTP proxy server should always direct you to /stadv and should not direct you to /stwebclient/index.jsp, if you are accessing just the host name (root). However, if you access the WebSphere HTTP proxy server and specify /stwebclient/index.jsp, the server will route you there. You can extend this model by creating an additional virtual host that is specific to the Sametime Advanced Server host name to prevent that if desired.