Configuring TM1 Server to use IPv6

By default, TM1 uses IPv4. To use IBM® TM1® Server with internet protocol version 6 (IPv6), you configure a combination of TM1 parameters and an operating system environment variable.

About this task

You can configure TM1 to use one of the following modes to specify which internet protocol that you want TM1 to use with your network.

ipv4
Default setting. Used for IPv4 networks.
dual
Used to transition from IPv4 to IPv6. Both protocols are supported.
ipv6
Used for IPv6 networks.

Procedure

  1. Configure the TM1 Admin Server:
    1. On the computer where the TM1 Admin Server is running, open Cognos Configuration.
    2. Expand the Local Configuration > Environment node and click TM1 Admin Server.
    3. In the Component Properties pane, set the TM1 Admin Server IP support option to either Dual (IPv4 and IPv6), IPv4, or IPv6.
    4. If needed, add the IPv6 address to the /etc/hosts operating system file on UNIX and Microsoft Windows. In some cases, depending on your network environment and DNS configuration, you may need to perform this additional step to successfully run the TM1 Admin Server and TM1 Server in IPv6 mode.
    5. Add the TM1_IPVersion environment variable as described in step 3.
  2. Configure the TM1 Server:
    1. On the computer where the TM1 Server is running, open the tm1s.cfg file.
    2. Set the IPversion parameter to the IP mode that you want to use.

      For example, to specify that your network uses the IPv6 protocol, add the parameter as follows:

      IPVersion=ipv6

      For more details, see IPVersion.

    3. If needed, add the IPv6 address to the /etc/hosts operating system file on UNIX and Microsoft Windows.
    4. Add the TM1_IPVersion environment variable as described in step 3.
  3. Add the TM1_IPVersion environment variable to the operating system for each computer that communicates directly with the TM1 Admin Server or TM1 Server.

    Use the following variable name and value format:

    TM1_IPVersion=ip_mode

    where ip_mode can be one of the following values:

    • Dual
    • IPv6
    • IPv4

    The TM1_IPVersion environment variable is required on any computer that is running any of the following TM1 components:

    • TM1 Admin Server
    • TM1 Server
    • TM1 administrator tools
    • TM1 Web (web server only)
    • TM1 Application server
    • TM1 clients:
      • Cognos® TM1 Architect
      • Cognos TM1 Perspectives
      • Cognos TM1 Performance Modeler
      • Cognos Insight
    • Custom applications that use the Cognos TM1 API.
    Note: You do not need to set this environment variable on computers that use only a web browser to access TM1 Web.
  4. Restart any TM1 servers that you modified.
  5. Test the connection between your TM1 server and client applications.