Install and configure EM4C Server
In this topic
Depending on your environment, the EM4C Server component can be installed on one or more computers. Also, EM4C Server can be installed on the same computer more than once (in separate target paths and using different ports).
EM4C Server can be installed and configured on its own or in combination with EM4C Dispatcher and 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 Server
Before you begin, make sure you are familiar with the installation options.
The following steps should be performed as an administrator.
- In the em4c directory on the installation media, launch 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 that only the EM4C Server component is selected 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 EM4C Server
The following are required when configuring EM4C Server:
- A single IBM Cognos Gateway URI (same URI for each EM4C Gateway in the distributed environment)
- An ordered, comma-separated list of IBM Cognos Dispatchers (URIs) in the environment
- An ordered, comma-separated list of EM4C Servers (URIs)
- EM4C Server shutdown port
- EM4C Server HTTP port
- EM4C Server log file
For more information, see Configuration.
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.
Note:
When EM4C Server is installed more than once on a given computer, it is important in step 3 to ensure that the EM4C Server Shutdown Port and the EM4C Server HTTP Port (also listed under the EM4C Server URI(s) setting) are different for each instance of EM4C Server.
Note:
If you have multiple IBM Cognos Gateways, enter the URL for one of the gateways in step 3. All EM4C Servers must be configured with the same IBM Cognos Gateway URL.
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).
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.
- 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.txtIf this test fails, make sure EM4C Server is started in all places where it is installed.