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