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 目录。
以下步骤应以管理员身份执行。
- 在安装介质上的 em4c 目录中,启动安装程序批处理文件 (.bat)。例如:
G:\em4c\launchInstaller.bat
- 在欢迎页面中单击下一步。
- 如果您接受许可协议条款,单击下一步;否则,单击退出以退出。
- 选择安装路径,然后单击下一步。
- 选择要安装 Esri Maps for IBM Cognos 的 IBM Cognos 版本,然后单击下一步。
- 请确保仅选中 EM4C Gateway 组件,然后单击下一步。
- 指定 IBM Cognos Gateway webcontent 目录并单击下一步。
- 单击下一步继续安装。
- 待文件复制到指定的位置后,单击下一步。
- 或者,单击生成自动安装脚本以保存一个 XML 文件,其中含有您在之前的页面中所设置的所有参数。
- 单击完成。
配置 EM4C Gateway
对 EM4C Gateway 进行配置需要环境中 EM4C Server 计算机上以逗号分隔的有序列表。有关详细信息,请参阅配置。
以具有管理员权限的用户身份运行 Esri Maps for IBM Cognos 配置。
- 浏览至 <em4c_location>\bin 目录,然后运行 configure.bat。
- 在配置工具的浏览器窗口中单击本地配置。
- 更改本地配置设置以反映您的环境(例如,应将任意 URI 的主机名部分从本地主机更改为 IP 地址或网络主机名)。Esri Maps for IBM Cognos 配置应用程序可识别安装了哪些 EM4C 组件,并仅列出需要设置的配置设置。
- 单击应用。
- 在文件菜单中单击退出。
配置 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) |
有关 web 服务器配置的详细信息,请参阅关于 web 服务器配置。
测试配置
在安装和配置 Esri Maps for IBM Cognos 之后,如果尚未清除 web 浏览器缓存,请清除缓存(在大多数浏览器中可使用 Ctrl+Shift+Delete 完成)。然后,可对安装和配置过程的各个方面进行测试。
以下示例假设 IBM Cognos 通过别名 ibmcognos 进行显示。
- 执行以下测试以验证 EM4C Gateway 是否按照预期正常运行:
- 测试 em4c web 服务器虚拟目录(别名)是否正确设置(此测试还可验证 Esri Maps for IBM Cognos 配置中是否选中应用):
http://<cognos_gateway>/ibmcognos/em4c/version.txt
- 测试 EM4C Gateway CGI 脚本是否正常工作(连接至 EM4C Server)。如果正常工作,以下 URL 将在浏览器中生成一条含时间戳的消息:
http://<cognos_gateway>/ibmcognos/em4c/cgi-bin/em4c.cgi
- 测试 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 服务器。
- 测试 em4c web 服务器虚拟目录(别名)是否正确设置(此测试还可验证 Esri Maps for IBM Cognos 配置中是否选中应用):