Skip To Content

Installation options

Viewing: Install on WindowsInstall on Linux and UNIX

In this topic

You typically run the Esri Maps for IBM Cognos installation and configuration programs interactively with a graphical user interface that allows you to provide the required information. In an interactive installation, you use the installation wizard to select the server components you want to install and the location on your computer where you want to install them. You use the configuration application to configure the various Esri Maps for IBM Cognos components.

On Linux and UNIX platforms, interactive installations and configurations are typically performed from an X Window System (X11) workstation, an X terminal, or a PC with X server software installed.

Note:

It is recommended that the installation of Esri Maps for IBM Cognos be performed by an IBM Cognos administrator.

You can automate the installation of components using installation scripts and configuration files. In this scenario, you run the installation and configuration programs in silent mode.

As long as the installed components are the same, you can automate the configuration of components by exporting or copying the installation and configuration settings from one computer to another. In this scenario, the Esri Maps for IBM Cognos installation and Esri Maps for IBM Cognos Configuration are run in interactive mode on the first computer. On subsequent computers, you run the installation and configuration in silent or unattended mode.

Manual installation

For Linux- and UNIX-based operating system installations, install server components using a graphical user interface (GUI) or by running an unattended installation. To install with a GUI, the console attached to your computer must support a Java-based GUI. To run an unattended installation, you must first run a graphical-mode installation on a separate computer, and save the installation script when prompted.

The IBM Cognos Business Intelligence Installation and Configuration Guide recommends the creation of a group named ibmcognos (or similar). This group must contain the user who owns the IBM Cognos files (that is, the user who installed IBM Cognos). After installation, the ibmcognos group takes ownership of the IBM Cognos files, and the file permissions for all IBM Cognos files are changed to GROUP READ/WRITE/EXECUTE.

For ease of administration and configuration, it is recommended that Esri Maps for IBM Cognos be installed by the user who owns the IBM Cognos installation location. Further, after Esri Maps for IBM Cognos is installed, the ibmcognos group should take ownership of the Esri Maps for IBM Cognos files, and the file permissions for all Esri Maps for IBM Cognos files should be set to GROUP READ/WRITE/EXECUTE.

For instructions on extracting the contents of the TAR archive (.tar.gz), see the administration documentation for your operating system.

For basic instructions on installing Esri Maps for IBM Cognos, see Install and configure on a single computer.

Note:

Esri Maps for IBM Cognos supports installing in multiple languages. For the installer to work in languages other than English, the operating system must have a UTF-8 font supporting the characters in the selected language. If the installer cannot find an appropriate font, some characters will be displayed incorrectly. If you experience this issue, copy a compatible font into <em4c_ installer_location>/java/jre/lib/fonts/fallback.

Silent installation

If the information provided to the Esri Maps for IBM Cognos installer was saved during a previous installation, it can be used to perform an unattended (silent) installation on a similar computer.

You can also perform a silent configuration. For more information, see Configuration.

The following example assumes a file named install.xml was saved to the /tmp folder and that the Esri Maps for IBM Cognos installation media is located at /tmp/em4c. The following should be executed as the user who owns the IBM Cognos installation on the target computer:

  1. In Terminal, browse to the em4c directory on the installation media, grant execute permissions to setPermissions.sh, and run setPermissions.sh, for example:
    [cognosuser@server1]$ chmod +x setPermissions.sh
    [cognosuser@server1]$ ./setPermissions.sh
  2. Run the following command:

    /tmp/em4c/java/jre/bin/java -jar /tmp/em4c/em4c/em4c-installer.jar /tmp/install.xml

    Note:

    Modify the paths as necessary to reflect your operating system.