Esri Maps for IBM Cognos (v5.0.1 Archive)

In this topic
  1. Install EM4C Server and EM4C Dispatcher
  2. Configure EM4C Server and EM4C Dispatcher
  3. Start EM4C Server
  4. Restart the IBM Cognos Service
  5. Test the configuration

This is an archive related to a previous version of Esri Maps for IBM Cognos. If you need the current version go to http://doc.arcgis.com/en/maps-for-cognos/.

Install and configure EM4C Server and EM4C Dispatcher

Because of the small processing requirements of EM4C Server, many organizations choose to install it along with EM4C Dispatcher (note that EM4C Dispatcher is installed on each IBM Cognos Dispatcher computer running the report service and/or presentation service).

Install EM4C Server and EM4C Dispatcher

A complete installation of Esri Maps for IBM Cognos involves installing components on your server and then configuring them to work in your environment. Before you begin, make sure you are familiar with the installation options.

It is recommended that the following steps be performed as the user who owns the IBM Cognos installation location.

Install Esri Maps for IBM Cognos components in a directory that contains only ASCII characters in the path.

  1. In terminal, browse to the em4c directory on the installation media, grant execute permissions to setPermissions.sh, run setPermissions.sh, then run the installer shell script (.sh), for example:

    [cognosuser@server1]$ chmod +x setPermissions.sh
[cognosuser@server1]$ ./setPermissions.sh
[cognosuser@server1]$ ./launchInstaller.sh

  2. On the Welcome page, click Next.
  3. If you accept the terms of the license agreement, click Next; otherwise, click Quit to exit.
  4. Select the installation path and click Next.
  5. Select the version of IBM Cognos that Esri Maps for IBM Cognos will be installed on and click Next.
  6. Ensure that EM4C Server and EM4C Dispatcher components (only) are selected and click Next.
  7. Specify the IBM Cognos Dispatcher directory and click Next.
  8. Click Next to proceed with the installation.
  9. Wait for files to be copied to the specified location and click Next.
  10. Optionally, click Generate an automatic installation script to save an XML file containing all the parameters you set on the previous pages.
  11. Click Done.
  12. Browse to em4c_location/bin and enter the following:
    [cognosuser@server1]$ chmod +x setPermissions.sh
[cognosuser@server1]$ ./setPermissions.sh

Configure EM4C Server and EM4C Dispatcher

Before you complete the following steps, make sure you are familiar with the available configuration settings.

Run Esri Maps for IBM Cognos Configuration as the user who owns the Esri Maps for IBM Cognos installation location (this user should have READ/WRITE/EXECUTE access to both the em4c_location and the cognos_location).

  1. Browse to the em4c_location/bin directory and run ./configure.sh.
  2. In the Explorer window, click Local Configuration.
  3. Change the local configuration settings to reflect your environment (for example, the host name portion of any URI should be changed from localhost to an IP address or a network host name). The Esri Maps for IBM Cognos Configuration application recognizes which EM4C components are installed and only lists the configuration settings that are required to be set.
  4. Click Apply.
  5. From the File menu, click Exit.

Start EM4C Server

The Esri Maps for IBM Cognos EM4C Server must be started for all locations where the EM4C Server component was installed.

The EM4C Server process is started and stopped with the use of the following shell scripts.

  • Start: start-em4c.sh
  • Stop: stop-em4c.sh

For example:

[cognosuser@server1]$ cd /opt/em4c/bin 
[cognosuser@server1]$ ./start-em4c.sh

or

[cognosuser@server1]$ /opt/em4c/bin/start-em4c.sh

These scripts are located at em4c_location/bin and should be run as the user who owns the Esri Maps for IBM Cognos installation location.

To automatically start the Esri Maps for IBM Cognos process on Linux and UNIX, you must configure the process as a daemon. For more information, see your operating system documentation.

Restart the IBM Cognos Service

Changes applied in Esri Maps for IBM Cognos Configuration require that the IBM Cognos Service be restarted on any IBM Cognos Dispatcher computer running the report service and/or presentation service.

Refer to the IBM Cognos Installation and Configuration Guide for your version of IBM Cognos for details on how to restart the IBM Cognos Service.

At this point, all Esri Maps for IBM Cognos report authors and end users should clear their web browser cache. The instructions for this vary among browsers, but Ctrl+Shift+Delete will work in most browsers.

Test the configuration

After Esri Maps for IBM Cognos has been installed and configured, clear your web browser's cache (Ctrl+Shift+Delete on most browsers) if you haven't done so already. You can then test various aspects of the installation and configuration process.

In the following examples, it is assumed IBM Cognos is exposed by an ibmcognos alias.

  1. For each EM4C Server configured in your environment, test whether EM4C Server is listening on the indicated port as follows. Note that the default port 9896 is assumed (change as required): 
    http://<em4c_server>:9896/em4c/version.txt

    If this test fails, make sure EM4C Server is started in all places where it is installed.

  2. EM4C Dispatcher runs within the IBM Cognos process space and only limited testing can be performed manually. One way to test whether EM4C Dispatcher is installed and configured properly is to start Cognos Connection and verify that Esri Maps Designer appears in the Launch menu.