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.