Configuring Domino to support both IPv4 and IPv6 addressing on IBM i

Before an IBM® Sametime® Community Server can support both IPv4 and IPv6 addressing on IBM i, you must configure support for both addressing protocols on the Domino® server where the Community Server is hosted.

Before you begin

Domino and the Sametime Community server must be installed; the Domino server must be running (it does not matter whether the Community Server is also running at this point).

About this task

In Domino, only IPv4 addressing is enabled by default. Configuring Domino to additionally support IPv6 addressing involves several steps, including adding configuration settings to the notes.ini file for the Domino server.

For information on supporting IPv6 with Domino, see "IPv6 and Domino" in the Domino Administration product documentation.

Procedure

  1. Enable support for both IPv4 and IPv6 addresses in Domino by adding the following settings to the notes.ini file:
    tcp_enableipv6=1
    DONT_USE_REMEMBERED_ADDRESSES=1
  2. If you want to be able to use a Notes® client to access the server with an IPv6 address, add the IPv6 information to the Domino server configuration by running the CHGDOMSVR command as follows:
    1. On any IBM i command line, type CHGDOMSVR and press F4 to display the command prompt.
    2. Specify the Domino server name and press Enter to display additional parameters. Then locate the the TCP/IP port options prompt.
    3. Type a plus sign (+) in the entry field that follows the prompt and press Enter.
      Log client session events  . . .   *SAME        
      TCP/IP port options:             +              
        Communications port  . . . . .   *SAME 

      This displays the current TCP/IP port options.

    4. Then locate the second section, where you can enter information for the additional TCP/IP port. Specify the following settings:
      • Communications port: TCPIPV6
      • Internet address: Specify the explicit IPv6 address (not the host name).
      • Enable port: *YES

      For the remaining parameters, specify the options of your choice, and then press Enter.

    5. Now press Enter to run the command.
    6. Verify that the port options were updated in the notes.ini file to look like this:
      Ports=TCPIP,TCPIPV6
      TCPIP=TCP,0,15,0,,12288
      TCPIPV6=TCP,0,15,0,,12288
      TCPIP_TcpIPaddress=0,Domino_server's_explicit_IPv4_address
      TCPIPV6_TcpIPaddress=0,Domino_server's_explicit_IPv6_address
  3. Verify that the server host table and the Domain Name Server use the server's IPv6 address. Both the IPv4 and IPv6 address should map to the same host name.

    You should have set these values when setting up your IBM i server before installing Domino; for information, see the section Preparing the TCP/IP environment on IBM i.

    The contents of the Domain Name Server should be two DNS entries for the host name of your Sametime server: one entry that maps the host name to the IPv4 address and another that maps it to the IPv6 address.

  4. Restart the Domino server so your changes can take effect.
  5. Determine which IP address must be added to the HTTP hostname field in the server document:

    The choice of IP address depends on how the Domain Name Server resolves the host name. To determine which IP address to add to the server document, attempt to access the Sametime Community Server from a web browser using an IPv4 client:

    http://Community_Server_host_name
    • If you can access the server with the IPv4 client, update the Community Server's "Server" document in Domino by adding the IPv6 address (see next step).
    • If you cannot access the server with the IPv4 client, then update the Community Server's "Server" document in Domino by adding the IPv4 address (see next step).
  6. Update the HTTP hostname field in the Community Server's "Server" document:
    1. On the Sametime Community Server, start the Domino Administrator client.
    2. In the Domino Administrator, navigate to the Server pane and double-click your Community Server's name to open the corresponding "Server" document.
    3. In the "Server" document, navigate to the Internet Protocols > HTTP tab.

      The fully qualified host name of the Community Server should already appear in the HTTP hostname field.

    4. Update the HTTP hostname field by pressing Enter (used as a delimiter) and then adding the appropriate IP address as determined in the previous step.
      • If you were able to access the server with the IPv4 client, add the IPv6 address now.
      • If you were not able to access the server with the IPv4 client, add the IPv4 address now.
      Attention: Do not add both the IPv6 and the IPv4 addresses.
    5. Save and close the "Server" document.
  7. Restart the HTTP service on the Domino server by running the following command in the console:
    tell http restart
  8. Verify that you can access the Community Server using either an IPv4 or an IPv6 client with the following URL:
    http://Community_Server_host_name