安装和配置 EM4C Gateway

EM4C Gateway 必须安装到您环境中的所有 IBM Cognos Gateway 计算机上。

EM4C Gateway 可进行自行安装和配置或与 EM4C Server 和 EM4C Dispatcher 结合使用。有关详细信息，请参阅服务器组件的安装顺序。有关 Esri Maps for IBM Cognos 部署的示例，请参阅 Esri Maps for IBM Cognos 架构。

安装 EM4C Gateway

在开始安装之前，请确保每一台要安装 EM4C Gateway 的计算机上都有 IBM Cognos Gateway 目录。

建议使用拥有 IBM Cognos 安装位置的用户身份执行以下步骤。

在路径只包含 ASCII 字符的目录中安装 Esri Maps for IBM Cognos 组件。

1. 在终端中浏览至安装介质上的 em4c 目录，然后运行安装程序 shell 脚本 (.sh)。例如：

   [cognosuser@server1]$ ./launchInstaller.sh

2. 在欢迎页面中单击下一步。
3. 如果您接受许可协议条款，单击下一步；否则，单击退出以退出。
4. 选择安装路径，然后单击下一步。
5. 选择要安装 Esri Maps for IBM Cognos 的 IBM Cognos 版本，然后单击下一步。
6. 请确保仅选中 EM4C Gateway 组件，然后单击下一步。
7. 指定 IBM Cognos Gateway webcontent 目录并单击下一步。
8. 单击下一步继续安装。
9. 待文件复制到指定的位置后，单击下一步。
10. 或者，单击生成自动安装脚本以保存一个 XML 文件，其中含有您在之前的页面中所设置的所有参数。
11. 单击完成。
12. 浏览至 <em4c_location>/bin，并输入以下内容：

    [cognosuser@server1]$ chmod +x setPermissions.sh
    [cognosuser@server1]$ ./setPermissions.sh

配置 EM4C Gateway

对 EM4C Gateway 进行配置需要环境中 EM4C Server 计算机上以逗号分隔的有序列表。有关详细信息，请参阅配置。

以拥有 Esri Maps for IBM Cognos 安装位置的用户身份运行 Esri Maps for IBM Cognos 配置（该用户应同时对 <em4c_location> 和 <ibmcognos_location> 具有读取/写入/执行访问权限）。

1. 浏览至 <em4c_location>/bin 目录，然后运行 ./configure.sh。
2. 在浏览器窗口中单击本地配置。
3. 更改本地配置设置以反映您的环境（例如，应将任意 URI 的主机名部分从本地主机更改为 IP 地址或网络主机名）。Esri Maps for IBM Cognos 配置应用程序可识别安装了哪些 EM4C 组件，并仅列出需要设置的配置设置。
4. 单击应用。
5. 在文件菜单中单击退出。

配置 web 服务器

为使 Esri Maps for IBM Cognos 和 IBM Cognos 可进行通信，您必须创建下表中所列出的虚拟目录（别名）。请注意，假设 IBM Cognos 在您的 web 服务器上显示为 ibmcognos（可根据您的环境进行修改）。

别名	位置
ibmcognos/em4c	<em4c_location>/webcontent
ibmcognos/em4c/cgi-bin	<em4c_location>/cgi-bin 或 <em4c_location>/cgi-bin-64bit，具体取决于您的环境（x86 或 x64）

Esri Maps for IBM Cognos 虚拟目录

有关 web 服务器配置的详细信息，请参阅关于 web 服务器配置。

测试配置

在安装和配置 Esri Maps for IBM Cognos 之后，如果尚未清除 web 浏览器缓存，请清除缓存（在大多数浏览器中可使用 Ctrl+Shift+Delete 完成）。然后，可对安装和配置过程的各个方面进行测试。

以下示例假设 IBM Cognos 通过别名 ibmcognos 进行显示。

1. 执行以下测试以验证 EM4C Gateway 是否按照预期正常运行：
   1. 测试 em4c web 服务器虚拟目录（别名）是否正确设置（此测试还可验证 Esri Maps for IBM Cognos 配置中是否选中应用）：

      http://<cognos_gateway>/ibmcognos/em4c/version.txt

   2. 测试 EM4C Gateway CGI 脚本是否正常工作（连接至 EM4C Server）。如果正常工作，以下 URL 将在浏览器中生成一条含时间戳的消息：

      http://<cognos_gateway>/ibmcognos/em4c/cgi-bin/em4c.cgi

   3. 测试 EM4C Gateway CGI 脚本能否访问外部资源。例如，以下各个 URL 均应返回描述服务器中安装的 软件版本的 JSON 对象。

      ArcGIS Online：

      http://ibmcognosserver/ibmcognos/em4c/cgi-bin/em4c.cgi?http://www.arcgis.com/sharing?f=pjson

      Portal for ArcGIS 实例：

      http://ibmcognosserver/ibmcognos/em4c/cgi-bin/em4c.cgi?http://myPortal/gis/sharing/?f=pjson

      如果测试成功，将返回当前版本 - 例如 "currentVersion":"x.x"。

   注:

   如果上述测试未能生成预期的结果，可能的原因有两个：没有使用 Esri Maps for IBM Cognos 配置（对配置进行的更改没有得到保存/应用），或者没有正确配置 web 服务器。