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 Dispatcher

The EM4C Dispatcher component must be installed on each IBM Cognos Dispatcher computer running the report service and/or presentation service.

EM4C Dispatcher can be installed and configured on its own or in combination with EM4C Server and/or EM4C Gateway. For more information, see Installation sequence for server components. For an example of an Esri Maps for IBM Cognos deployment, see Esri Maps for IBM Cognos architecture.

Install EM4C Dispatcher

Before you begin the installation, ensure that there is an IBM Cognos Dispatcher directory on each computer on which you are installing EM4C Dispatcher.

The following steps should be performed as an administrator on every IBM Cognos Dispatcher computer in your environment.

  1. Browse to the em4c directory on the installation media and launch the installer batch file (.bat). For example:

    G:\em4c\launchInstaller.bat

  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 only the EM4C Dispatcher component is 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 in order to save an XML file containing all the parameters you set on the previous pages.
  11. Click Done.

Configure EM4C Dispatcher

Configuration of EM4C Dispatcher requires an ordered, comma-separated list of the EM4C Servers in your environment. For more information, see Configuration.

Run Esri Maps for IBM Cognos Configuration as a user with administrator privileges.

  1. Browse to the em4c_location\bin directory and run configure.bat.
  2. In the Configuration tool's 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.

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 example, it is assumed IBM Cognos is exposed by an ibmcognos alias.

  1. 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.