Enabling IPv6 on a Sametime Community Mux

Configure settings to establish connectivity between an IBM® Sametime® Community Server and a stand-alone Sametime Community Mux when using IPv6 addressing.

About this task

Each Sametime server contains a local Community Services multiplexer component. The multiplexer handles and maintain Connections from Sametime clients to the Community Services on the Sametime server. If your multiplexer is hosted on the same server as Community Services, it was already enabled for IPv6 support when you configured the Community Services.

If you installed a stand-alone Community Mux (hosted on a separate server), you can enable IPv6 support as described.

Procedure

Stop the multiplexer.
Locate the sametime.ini file in the Sametime Community Mux installation directory, and open the file so you can edit it.
Add (or modify) the following statements to the [Connectivity] section within the file:
Note: The first three settings must match the values used for the Sametime server where Community Services are hosted; these values must use the same IP protocol as well.
```
UCM_RESOLVE_PREFERRED_IP_VER=IPv4_or_IPv6_selection
VPS_HOST=Explicit_IP_address_of_Sametime_server
UCM_LOCAL_IP=Explicit_IP_address_of_Community_Mux
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 both IPv4 and IPv6 addressing, set this to "4" to allow both protocols but attempt to resolve addresses using IPv4 protocol first.
  - If you support only IPv6 addressing, set this to "6" -- this will still allow both protocols, but will attempt to resolve addresses using IPv6 protocol first in case your operating system is enabled for both IP protocols.
- VPS_HOST specifies the explicit IP address of the Sametime server to which this Community Services multiplexer connects. This value must use the format specified in UCM_RESOLVE_PREFERRED_IP_VER; for example if you entered a "4" for that setting, then you must provide an IPv4-format IP address here.
- UCM_LOCAL_IP specifies the explicit IP address of the Community Mux computer (using dot notation for IPv4 protocol or colon notation for IPv6 protocol). This value must use the format specified in UCM_RESOLVE_PREFERRED_IP_VER; for example if you entered a "4" for that setting, then you must provide an IPv4-format IP address here.
- VPHMX_HTTP_SERVER_IP specifies the IP address of the Domino® HTTP server where Sametime is running.
- VPHMX_HTTP_SERVER_PORT specifies the port used by the Domino HTTP server where Sametime is running; normally port 80.

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

If this Sametime 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 this multiplexer serves Sametime client communications.

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 this multiplexer listens for client Connections, normally port 1533.

VPHMX_HOSTNAME specifies the addresses where this multiplexer serves 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 stand-alone Community Mux listens for HTTP client Connections, normally port 8082.

If this Sametime server will support only IPv6 addressing:

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

Save and close the file.
Restart the Community Mux so your changes can take effect.