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

Configuration

Esri Maps for IBM Cognos Configuration is installed with Esri Maps for IBM Cognos. You use it immediately after installation to set the initial configuration or at any point in the future to make updates. Esri Maps for IBM Cognos Configuration is used on every computer on which Esri Maps for IBM Cognos is installed.

When you run Esri Maps for IBM Cognos Configuration in interactive mode, there are three buttons on the user interface.

  • Apply
    • Saves the Local Configuration settings to em4c.xml
    • Makes necessary updates to IBM Cognos files
    • Starts the Esri Maps for IBM Cognos service
  • Revert
    • Returns Esri Maps for IBM Cognos to the last saved (that is, applied) settings
  • Disable
    • Removes changes made to IBM Cognos files
    • Stops and removes the Esri Maps for IBM Cognos service

Local Configuration settings

The Local Configuration settings specified on Esri Maps for IBM Cognos Configuration are used by the various Esri Maps for IBM Cognos components and can be modified at any time. The settings available are as follows:

  • IBM Cognos Gateway Base URI—The IBM Cognos gateway URI without /cgi- bin/cognos.cgi. This is used internally by Esri Maps for IBM Cognos.
  • IBM Cognos Dispatcher(s)—A comma-separated list of all Cognos dispatchers in your environment. Esri Maps for IBM Cognos uses a failover algorithm to decide which dispatcher an EM4C Server will contact. The EM4C Server makes requests to the first dispatcher unless it has become disabled and proceeds to the next one in the list, and so on. For example, http://server1:9300, http://server1:9301, and http://server2:9300. (Note: There should be no spaces between server names when specified on Esri Maps for IBM Cognos Configuration. They are included here for readability). The order of this list is not crucial, and it is recommended that you list the IBM Cognos dispatchers on the local computer, followed by IBM Cognos Dispatchers on other computers.
  • EM4C Server URI(s)—An ordered, comma-separated list of Esri Maps for IBM Cognos Servers in the environment. Note: This list must appear in the same order in all Esri Maps for IBM Cognos Configuration instances in your environment. The list denotes the order in which EM4C Servers take the role of primary. If the first server fails, all components must agree that the second server in the list will act as primary until the first server is back online. For example, http://server1:9796/em4c, http://server1:9896/em4c, and http://server2:9796/em4c. (Note: There should be no spaces between server names when specified on Esri Maps for IBM Cognos Configuration. They are included here for readability).
  • EM4C Server Shutdown Port (Advanced)—The shutdown port for the local EM4C Server. This should be left alone unless you have multiple EM4C Servers installed on the same computer or there will be a port conflict.
  • EM4C Server HTTP Port (Advanced)—The HTTP port on which the local EM4C Server will listen. This should be left alone unless you have multiple EM4C Servers installed on the same computer or there will be a port conflict. If you edit this value, be sure to update EM4C Server URIs accordingly.
  • EM4C Server Log File—The location of the log files generated by the EM4C Server.

The local configuration settings required for each EM4C component are as follows:

Local Configuration SettingEM4C ServerEM4C GatewayEM4C Dispatcher

IBM Cognos Gateway Base URI

X

IBM Cognos Dispatcher(s)

X

EM4C Server URI(s)

X

X

X

EM4C Server Shutdown Port (Advanced)

X

EM4C Server HTTP Port (Advanced)

X

EM4C Server Log File

X

Silent configuration

Esri Maps for IBM Cognos Configuration saves its local settings to a file named em4c.xml. This XML file can be used to distribute Esri Maps for IBM Cognos to multiple computers (as long as they have the same settings and paths). To perform an unattended (silent) configuration, a successful configuration on another computer with the exact same setup must first be completed.

The following should be completed as an administrator:

  1. Copy em4c.xml from the em4c_location\bin directory on the source computer to the em4c_location\bin directory on the target computer.
  2. On the target computer, browse to the em4c_location\bin directory.
  3. Run the following command:
    configure.bat –silent