Installing the Cognos Analytics gateway

You can install the IBM® Cognos® Analytics gateway on one or more computers. If you have a web farm, you can install an IBM Cognos Analytics gateway on each web server.

Before you begin

Go to the IBM Cognos Analytics on Premises 12.0.x Supported Software Environments (https://www.ibm.com/support/pages/node/6966712) to verify that the required patches are installed on your computer.

Ensure that the temporary directory has at least 5 GB of memory.

Tip: The temporary directory is set with the environment variable IATEMPDIR for the UNIX or Linux operating system or with TMP for the Microsoft Windows operating system.

Procedure

  1. Start the installation wizard.
    1. For UNIX or Linux, go to the operating system directory and type: ./ca_srv_platform_build.bin
      Tip: When you use the ca_srv_<platform>_<build>.bin command with XWindows, Japanese characters in messages and log files may be corrupted. When installing in Japanese on UNIX or Linux®, first set environment variables LANG=C and LC_ALL=C (where C is the language code, for example ja_JP.PCK on Solaris), and then start the installation wizard.

      If you do not use XWindows, run an unattended installation. For more information, see Silent installation, uninstallation, and configuration.

    2. For Microsoft Windows, go to the operating system directory, or where the installation files were downloaded, and double-click ca_srv_platform_build.exe.
  2. Select the language to use for the installation.

    The language that you select determines the language of the user interface. All supported languages are installed. You can change the user interface to any of the installed languages after installation.

  3. Select the Custom installation option, and follow the directions in the installation wizard to copy the required files to your computer.
    • When selecting the directory, consider the following:

      Install gateway components in a directory that contains only ASCII characters in the path name. Some UNIX and Linux web servers do not support non-ASCII characters in directory names.

    • When selecting components, clear all components except Gateway.
  4. Click Finish.