Install and configure EM4C Gateway
Viewing: Install on WindowsInstall on Linux and UNIX
In this topic
EM4C Gateway must be installed on each IBM Cognos Gateway computer in your environment.
EM4C Gateway can be installed and configured on its own or in combination with EM4C Server and EM4C Dispatcher. 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 Gateway
Before you begin the installation, ensure that there is an IBM Cognos Gateway directory on each computer on which you are installing EM4C Gateway.
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.
- In Terminal, browse to the em4c directory on the installation media and run the installer shell script (.sh). For example:
[cognosuser@server1]$ ./launchInstaller.sh - 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 that only the EM4C Gateway component is selected and click Next.
- Specify the IBM Cognos Gateway webcontent 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.
- Browse to <em4c_location>/bin and enter the following:
[cognosuser@server1]$ chmod +x setPermissions.sh [cognosuser@server1]$ ./setPermissions.sh
Configure EM4C Gateway
Configuration of EM4C Gateway requires an ordered, comma-separated list of the EM4C Server computers in your environment. For more information, see Configuration.
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 <ibmcognos_location>).
- Browse to the <em4c_location>/bin directory and run ./configure.sh.
- In the 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.
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.
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.
- 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):