Install and configure on a single computer
In this topic
- Install
Esri Maps for IBM Cognos - Configure
Esri Maps for IBM Cognos - Start EM4C Server
- Configure the web server
- Restart the IBM Cognos service
- Create the
Esri Maps for IBM Cognos capability - Test the configuration
Install Esri Maps for IBM Cognos
A complete installation of Esri Maps for IBM Cognos involves installing components on your server and configuring them to work in your environment. Before you begin, make sure you're familiar with the installation options and that you have the correct installer for the operating system on which you'll be installing.
The following steps should be performed as an administrator:
- In the em4c directory on the installation media, run the installer batch file (.bat). For example:
G:\em4c\launchInstaller.bat
- On the Welcome page, click Next.
- If you accept the terms of the license agreement, click Next; otherwise, click Quit to exit.
- Select the installation path and click Next.
- Select the version of IBM Cognos that Esri Maps for IBM Cognos will be installed on and click Next.
- Ensure EM4C Gateway, EM4C Dispatcher, and EM4C Server are selected and click Next.
- Specify the IBM Cognos Gateway webcontent directory and click Next.
- Specify the IBM Cognos Dispatcher directory and click Next.
- Click Next to proceed with the installation.
- Wait for files to be copied to the specified location and click Next.
- Optionally, click Generate an automatic installation script to save an XML file containing all the parameters you set on the previous pages.
- Click Done.
Configure Esri Maps for IBM Cognos
Before you complete the following steps, make sure you're familiar with the available configuration settings.
Run Esri Maps for IBM Cognos Configuration as a user with administrator privileges.
- Browse to the <em4c_location>\bin directory and run configure.bat.
- In the Configuration tool's Explorer window, click Local Configuration.
- 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.
- Click Apply.
- 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.
EM4C Server runs as a service and is configured to start automatically by default (it can be restarted manually using Microsoft Management Console).
Configure the web server
In order for Esri Maps for IBM Cognos and IBM Cognos to communicate, you must create the virtual directories (aliases) listed in the following table. Note that it is assumed IBM Cognos is exposed on your web server as ibmcognos (modify to reflect your environment).
| Alias | Location |
|---|---|
ibmcognos\em4c | <em4c_location>\webcontent |
ibmcognos\em4c\cgi-bin | <em4c_location>\cgi-bin or <em4c_location>\cgi-bin-64bit, depending on your environment (x86 or x64) |
To learn more about web server configuration, see About web server configuration.
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, presentation service, or both.
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.
Create the Esri Maps for IBM Cognos capability
To enable the use of Esri Maps for IBM Cognos, the Esri Maps capability must first be created. Users who do not have the required permissions for this capability will not be able to use Esri Maps Designer or view Esri Maps in map-enabled reports.
The IBM Cognos system administrator creates this capability by opening Esri Maps Designer from the Launch menu in Cognos Connection. When you create the Esri Maps capability, users and groups are added based on the default settings for Cognos capabilities, and those default users and groups are given traverse and execute permissions for Esri Maps for IBM Cognos. To disable the use of Esri Maps for IBM Cognos, remove the execute permissions for the user or group in question. Permissions can be changed in Cognos Administration.
Note:
The Esri Maps capability should not be renamed.
- To create the Esri Maps capability, follow these steps:
- Log in to IBM Cognos as a system administrator.
- Open Cognos Connection.
- From the Launch menu, choose Esri Maps Designer.
The capability is created.
- To manage the permissions for users and groups, follow these steps:
- Open Cognos Administration.
- Add or remove users and groups or change permissions as required.
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.
- 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.txtIf this test fails, make sure EM4C Server is started in all places where it is installed.
- Perform the following tests to verify whether EM4C Gateway is working as expected:
- Test that the em4c web server virtual directory (alias) is set up correctly (this also verifies Apply was selected in Esri Maps for IBM Cognos Configuration):
http://<cognos_gateway>/ibmcognos/em4c/version.txt - Test whether the EM4C Gateway CGI script is working correctly (connecting to EM4C Server). If it is working, the following URL will result in a message with a time stamp appearing in the browser:
http://<cognos_gateway>/ibmcognos/em4c/cgi-bin/em4c.cgi - Test whether the EM4C Gateway CGI script can access external
resources. For example, each of the following URLs should return a JSON object
that describes the version of the software installed on the server.
ArcGIS Online:
http://ibmcognosserver/ibmcognos/em4c/cgi-bin/em4c.cgi?http://www.arcgis.com/sharing?f=pjsonPortal for ArcGIS instance:
http://ibmcognosserver/ibmcognos/em4c/cgi-bin/em4c.cgi?http://myPortal/gis/sharing/?f=pjsonIf the test is successful, the current version will be returned—for example, "currentVersion":"x.x".
Note:
If the above tests fail to produce the expected results, there are two possible reasons: Esri Maps for IBM Cognos Configuration was not used (changes to the configuration were not saved and applied), or the web server is not configured properly.
- Test that the em4c web server virtual directory (alias) is set up correctly (this also verifies Apply was selected in Esri Maps for IBM Cognos Configuration):
- 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.