Configuring the Sametime Community Server to support IPv6 addressing
Configure settings to establish connectivity and resolve addresses when using IPv6 addressing on the HCL® Sametime®Community Server.
Before you begin
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 inUCM_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 inUCM_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 thesametime.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).
For example, set this toTable 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) ::
::,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.
For example, set this toTable 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) ::
::,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
- If this Sametime Community
Server will support both IPv4 and IPv6 addressing:
- HCL® 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 theUCM_RESOLVE_PREFERRED_IP_VER
setting.For example:
- If the
UCM_RESOLVE_PREFERRED_IP_VER
setting is "6", change every occurrence ofstserver1.example.com
to2001:DB8:1:2:3:4:5:6
(the corresponding IPv6 address). - If the
UCM_RESOLVE_PREFERRED_IP_VER
setting is "4", change every occurrence ofstserver1.example.com
to192.0.2.10
(the corresponding IPv4 address).
- If the
- Save and close the file.
- Start the Community Server.
What to do next
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