Configuring the Sametime Community Server to support IPv6 addressing

Configure settings to establish connectivity and resolve addresses when using IPv6 addressing on the IBM® Sametime® Community Server.

Before you begin

Enable support for IPv6 addresses on the IBM Domino® server hosting this Sametime Community Server.

Important: Due to the way the Sametime Community Server functions, you must not disable IPv4 addressing in the server's operating system. Even if you will use IPv6-only addressing with the Sametime Community Server and with your network, internal server components use IPv4 addresses (for example, in loopback addresses) and will fail if the operating system does not support IPv4 addressing.

About this task

Follow these steps to configure IPv6 support on the Sametime Community Server:

Procedure

Stop the Community Server.
Locate the sametime.ini file in the Sametime Community Server's data directory, and open the file so you can edit it.
In the [Connectivity] section, add (or modify) the following statements:
```
UCM_RESOLVE_PREFERRED_IP_VER=IPv4_or_IPv6_selection
VPS_HOST=Explicit_IP_address_of_this_server
UCM_LOCAL_IP=Explicit_IP_address_of_this_server
VPHMX_HTTP_SERVER_IP=IP_address_of_Domino_HTTP_server
VPHMX_HTTP_SERVER_PORT=Domino_HTTP_port
```
where:
- UCM_RESOLVE_PREFERRED_IP_VER specifies which type of addresses should be preferred when a domain name resolves to multiple addresses of both protocols:
  - If you support only IPv6 addressing, set this to "6" to disallow IPv4-formatted addresses.
  - If you support both IPv4 and IPv6 addressing, set this to "4" to allow both protocols but attempt to resolve addresses, using IPv4 protocol first.
- VPS_HOST specifies the explicit IP address of this Sametime Community Server. Use the IP address that matches the setting in UCM_RESOLVE_PREFERRED_IP_VER. For example, if you set that value to "4" then specify an IPv4-format address, but if you set that value to "6" then specify an IPv6-format address.
- UCM_LOCAL_IP specifies the explicit IP address of this Sametime Community Server. Use the IP address that matches the setting in UCM_RESOLVE_PREFERRED_IP_VER. For example, if you set that value to "4" then specify an IPv4-format address, but if you set that value to "6" then specify an IPv6-format address.
- VPHMX_HTTP_SERVER_IP specifies the IP address of the Domino HTTP server running on this computer.
- VPHMX_HTTP_SERVER_PORT specifies the port used by the Domino HTTP server running on this computer; normally this is port 80.

Add (or modify) the following statements in the [Debug] section within the sametime.ini file:

If this Sametime Community Server will support both IPv4 and IPv6 addressing:

VPMX_DISABLE_CONFIGURATION_UPDATE=1 
VPMX_HOSTNAME=::,0.0.0.0
VPMX_PORT=1533  
VPHMX_HOSTNAME=::,0.0.0.0
VPHMX_PORT=8082

Where:

VPMX_DISABLE_CONFIGURATION_UPDATE=1 requires all four of the statements that follow it.

VPMX_HOSTNAME specifies the addresses where the multiplexer residing on this server handles Sametime client communications. (The multiplexer was installed automatically as a part of the Sametime Community Server; if you will additionally install a stand-alone Community Mux, you will need to enable support for IPv6 addressing on that server as well).

Table 1. Accepted values for `VPMX_HOSTNAME`
Type of address	Example
IPv4 explicit address (dot notation)	`192.0.2.10`
IPv6 explicit address using colon notation	`2001:DB8:1:2:3:4:5:6`
IPv6 explicit address using double-colon notation	`3ef0::bee7:994:2e66`
IPv6 explicit address using IPv4-suffix notation	`3ef0::bee7:9.148.46.102`
IPv4 "any" (four zeroes)	`0.0.0.0`
IPv6 "any" (a double colon)	`::`

For example, set this to ::,0.0.0.0 to accept "any" address using either IP protocol.

VPMX_PORT specifies the port on which the multiplexer residing on this server listens for client Connections, normally port 1533.

VPHMX_HOSTNAME specifies the addresses where the multiplexer residing on this server handles HTTP client communications.

Table 2. Accepted values for `VPHMX_HOSTNAME`
Type of address	Example
IPv4 explicit address (dot notation)	`192.0.2.10`
IPv6 explicit address using colon notation	`2001:DB8:1:2:3:4:5:6`
IPv6 explicit address using double-colon notation	`3ef0::bee7:994:2e66`
IPv6 explicit address using IPv4-suffix notation	`3ef0::bee7:9.148.46.102`
IPv4 "any" (four zeroes)	`0.0.0.0`
IPv6 "any" (a double colon)	`::`

For example, set this to ::,0.0.0.0 to accept "any" address using either IP protocol.

VPHMX_PORT specifies the port on which the multiplexer residing on this server listens for HTTP client Connections, normally port 8082.

If this Sametime Community Server will support only IPv6 addressing:

[Debug]
VPMX_DISABLE_CONFIGURATION_UPDATE=1
VPMX_HOSTNAME=::
VPMX_PORT=1533  
VPHMX_HOSTNAME=::
VPHMX_PORT=8082

IBM i only: If you will support both IPv4 and IPv6 addressing, replace all of the remaining Sametime Community Server host names in the sametime.ini file with the correct IPv4 or IPv6 address, based on your address preference as specified with the UCM_RESOLVE_PREFERRED_IP_VER setting.
For example:
- If the UCM_RESOLVE_PREFERRED_IP_VER setting is "6", change every occurrence of stserver1.example.com to 2001:DB8:1:2:3:4:5:6 (the corresponding IPv6 address).
- If the UCM_RESOLVE_PREFERRED_IP_VER setting is "4", change every occurrence of stserver1.example.com to 192.0.2.10 (the corresponding IPv4 address).
Save and close the file.
Start the Community Server.

What to do next

If your Sametime Community Server is hosted on a Linux™ SuSE server, you will additionally need to edit the ststart script to enable support for IPv6 addressing in SuSE as described in the next topic.

Otherwise, proceed to Installing and setting up a stand-alone Sametime Community Mux