在一台计算机上进行安装和配置

安装 Esri Maps for IBM Cognos

Esri Maps for IBM Cognos 的完整安装涉及到将组件安装到您的服务器上，然后对其进行配置以在您的环境中工作。开始前，请确保您熟悉安装选项，且您具有的安装程序适用于要进行安装的操作系统。

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

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

在 Linux 和 UNIX 平台上，通常在 X Window System (X11) 工作站、X 终端或已安装 X 服务器软件的 PC 中执行交互式安装和配置。安装前，请确保正确设置 X11 转发。

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

   [cognosuser@server1]$ ./launchInstaller.sh

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

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

配置Esri Maps for IBM Cognos

在完成以下步骤之前，请确保您熟悉可用的配置设置。

在 Linux 和 UNIX 平台上，通常在 X Window System (X11) 工作站、X 终端或已安装 X 服务器软件的 PC 中执行交互式安装和配置。安装前，请确保正确设置 X11 转发。

以具有管理员权限的用户身份运行 Esri Maps for IBM Cognos 配置。

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

启动 EM4C Server

必须在 EM4C Server 组件的所有安装位置启动 Esri Maps for IBM Cognos EM4C Server。

可使用以下 shell 脚本来启动和停止 EM4C Server 进程：

• 启动：start-em4c.sh
• 停止：stop-em4c.sh

例如：

[cognosuser@server1]$ cd /opt/em4c/bin 
[cognosuser@server1]$ ./start-em4c.sh

或

[cognosuser@server1]$ /opt/em4c/bin/start-em4c.sh

这些脚本位于 <em4c_location>/bin，并应使用拥有 Esri Maps for IBM Cognos 安装位置的用户身份进行运行。

要在 Linux 和 UNIX 上自动启动 Esri Maps for IBM Cognos 进程，必须将该进程配置为后台程序。有关详细信息，请参阅操作系统文档。

配置 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 服务器配置。

重新启动 IBM Cognos 服务

Esri Maps for IBM Cognos 配置中所应用的更改要求在所有运行报表服务和/或演示服务的 IBM Cognos Dispatcher 计算机上重新启动 IBM Cognos 服务。

有关如何重启 IBM Cognos 服务的详细信息，请参阅对应于您的 IBM Cognos 版本的 IBM Cognos 安装和配置指南。

此时，所有的 Esri Maps for IBM Cognos 报表作者和最终用户应清除其 web 浏览器缓存。有关此操作的说明会因浏览器而有所不同，但在大多数浏览器中可以使用 Ctrl+Shift+Delete。

创建 Esri Maps for IBM Cognos 功能

要启用 Esri Maps for IBM Cognos，必须先创建 Esri Maps 功能。不具备此功能所需权限的用户将无法使用 Esri Maps Designer 或在启用了地图功能的报表中查看 Esri Maps。

由 IBM Cognos 系统管理员创建此功能，方法是在“Cognos 连接”中通过启动菜单打开 Esri Maps Designer。创建 Esri Maps 功能时，将根据 Cognos 功能的默认设置来添加用户和组，并为这些默认的用户和组授予 Esri Maps for IBM Cognos 的遍历和执行权限。要禁用 Esri Maps for IBM Cognos 的使用，请删除所涉及的用户或组的执行权限。可在“Cognos 管理”中更改权限。

注:

不应对 Esri Maps 功能进行重命名。

1. 要创建 Esri Maps 功能，请执行以下步骤：
   1. 以系统管理员的身份登录到 IBM Cognos。
   2. 打开“Cognos 连接”。
   3. 从启动菜单中选择 Esri Maps Designer。

   此功能已创建。

2. 要管理用户和组的权限，请执行以下步骤：
   1. 打开“Cognos 管理”。
   2. 根据需要添加或删除用户和组，或者更改权限。

测试配置

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

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

1. 按如下所述测试 EM4C Server 是否正在监听指定的端口。请注意，假设使用默认端口 9896（可根据需要进行更改）：

   http://<em4c_server>:9896/em4c/version.txt

   如果本次测试失败，请确保所有安装位置中的 EM4C Server 均已启动。

2. 执行以下测试以验证 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 服务器。

3. EM4C Dispatcher 在 IBM Cognos 进程空间内运行，所以只能手动执行有限的测试。测试 EM4C Dispatcher 是否正确安装和配置的一个方法是启动 Cognos 连接然后验证 Esri Maps Designer 是否显示在启动菜单中。