在主流应用服务器上部署安装Cognos BI 10.2组件

IBM® cognos® Business Intelligence 是一个多层架构的产品，可以分成三层：Web 服务器，业务层 和 数据层。可以通过网络防火墙将这三层隔离开来。Cognos BI User Interface（浏览器 和 胖客户端）位于三层之上。

如图 1 所示：

图 1. IBM® Cognos® Business Intelligence 架构

IBM Cognos BI 网关运行在 Web 服务器层，主要是接收客户端请求并转发给 Dispatcher。Dispatcher，Application Components 和 ContentManager 位于业务层，主要处理业务逻辑，比如存储用户设置，运行报表和工作等。数据层主要负责存储和查询，内容库存放元数据，报表等，查询数据库则可以是包含业务数据的关系型数据库，文件，OLAP 立方体等物理存储源。

在 IBM WebSphere 下部署 Cognos BI 10

1 前提条件

1.1 在安装 Cognos BI 10 之前，可以访问 IBM 官网 http://www-01.ibm.com/support/docview.wss?uid=swg27027080 查看软件支持信息。安装好 Cognos 之后，确保 Cognos 内容库配置正确 :

安装目录：/ibm/softwares/cognos/c10_64

网关软件：Apache Http Server

网关端口：80

主机名 : fpru

JAVA_HOME: /opt/IBM/WebSphere/AppServer/java

如图 2 所示：

图 2. Cognos 内容库配置验证

如果打算用分布式服务器部署，那么需要将 Cognos 不同组件 CM，ACT，GW 安装在不同路径。比如 Content Manager: /ibm/softwares/cognos/c10_64/cm， Application Tier Component: /ibm/softwares/cognos/c10_64/act， Gateway: /ibm/softwares/cognos/c10_64/gw

1.2 安装 IBM WebSphere， 在 Linux 上安装 IBM WebSphere 7.0 以及必要的补丁。

2 在 Cognos Configuration 中修改 URI 配置

2.1 打开 Cognos Configuration，在 Linux 下可以执行 $Cognos_Install/bin64/cogconfig.sh，（注意：需要设置 JAVA_HOME）。打开之后，点击左边导航树中的 Environment， 修改 Dispather 和 Content Manager URI 中的端口，如图 3 所示：

图 3. 修改 URL 配置信息

3 创建 WebSphere 和配置 Profile

3.1 首先进入 $WAS_Installation/AppServer/bin 目录，执行以下命令创建概要文件。概要文件名 COG102，用来部署 p2pd.war。运行命令 ./manageprofiles.sh -create -profileName COG102 -profilePath /opt/IBM/WebSphere/AppServer/profiles/COG102 -templatePath /opt/IBM/WebSphere/AppServer/profileTemplates/default -enableAdminSecurity false – validatePorts 当出现 WAS 概要文件创建成功的信息后，表示概要文件创建成功，如图 4 所示：

图 4. 创建 IBM WebSphere 概要文件

3.2 按照提示信息，可以查看 AboutThisProfile.txt 文件来查看概要文件基本信息。包括节点名，HTTP 端口和管理控制台端口。 Node name：fpruNode02 HTTP port： 9081 Administrative port： 9062 如图 5 所示：

图 5. 查看概要文件基本信息

3.3 启动 WebSphere 概要文件。 进入概要文件 COG102 的 bin 目录，执行 ./startServer.sh server1，启动概要文件， 如图 6 所示：

图 6. 启动概要文件

3.4 进入概要文件控制台，设置 JAVA Maximum heap size， 如图 7 所示：

图 7. 设置 JAVA Maximum heap size

4 创建 p2pd 部署文件

在这里需要创建个名为 p2pd.ear 的部署文件，我们可以通过图形界面方式来创建。

4.1 点击 Actions->Build Application Files …调出 Build Application 向导，进入图形界面，选择 Application 和 Application Server Type，如图 8 所示：

图 8. 选择 Application 和 Application Server Type

4.2 选择下一步，设置 Location（Application 存放路径）和 Context root（p2pd）， 如图 9 所示：

图 9. 设置 Location 和 Context root

4.3 Application file p2pd.ear 创建成功，点击 Finish 按钮关闭 Build Application Wizard 窗口，如图 10 所示：

图 10. 完成 Application file 的创建

5 部署 p2pd 文件

5.1 进入 WAS 管理控制台，在左侧的导航树中选择 Appications->New Application.，然后在右侧的窗口中选择 New Enterprise Application，点击 Browser 选择我们之前生成的 p2pd.ear 文件，如图 11 所示：

图 11. 选择要部署的 EAR 文件

5.2 点击 Next 按钮，选择 Fast Path 后点击 Next 按钮进入 Map modules to servers， 勾上组合框，点击 Next 按钮， 如图 12 所示：

图 12. Map modules to servers

5.3 进入 Map virtual hosts for Web modules， 勾上组合框，点击 Next 按钮， 如图 13 所示：

图 13. Map virtual hosts for Web modules

5.4 保存部署设置，点击 Save，完成部署，如图 14 所示：

图 14. 保存设置，完成部署

5.5 启动 Application，在左侧的导航中点击 Applications->Application Types->WebSphere enterprise applications. 在右侧的窗口中选中 IBM Cognos 应用，点击 Start 启动， 如图 15 所示：

图 15. 启动 IBM Cognos application

5.6 当状态由红叉变成绿色箭头时说明应用启动成功。在浏览器中敲入 http://fpru:9081/p2pd/servlet 就会看到 Content Manager Service 已经启动起来， 如图 16 所示：

图 16. 打开 IBM Cognos Cntent Manager

5.7 访问 IBM Cognos dispatch, 在浏览器中输入 http://fpru:9081/p2pd/servlet/dispatch，如图 17 所示：

图 17. 访问 IBM Cognos dispatch

注意：如果发现如下错误消息：DPR-ERR-2109 The dispatcher cannot service the request at this time. The dispatcher is still initializing. Contact your administrator if this problem persists. 这有可能是后台的服务还没有启动完成，请耐心等待几分钟再试。

在 Oracle WebLogic 下安装 Cognos BI 10

对于 Cognos 在 WebLogic 上的安装，包括 WebLogic Domain 的创建，Java 运行参数的修改，p2pd 和 ServletGateway 应用的创建， 然后部署应用，启动 WebLogic Domain。这里就不详细说明了，步骤完全可以参考 Cognos 在 IBM WebSphere 上的安装步骤。需要注意的步骤有如下几个：

1 在 Cognos Configuration 中修改 URI 配置

1.1 在 Cognos Configuration 中修改 URI 配置， 如图 18 所示：

图 18. 修改 URL 配置信息

2 配置 WebLogic Server JDK

2.1 在创建 WebLogic Domain 的时候，需要选择 JDK，在这里我们选择 other JDK， 输入 IBM JDK 路径， 如图 19 所示：

图 19. 选择 IBM JDK

3 部署 p2pd 应用

3.1 通过运行 ANT 脚本来生成部署文件 p2pd.war。然后 . 在 $domain_home 下创建一个 p2pd 目录。进入此目录运行 jar xvf。将会把 war 内容解压到 $domain_home/p2pd 下面。包括 3 部分：META-INF，version.xml 和 WEB-INF。

3.2 启动 WebLogic Domain，进入 Domain COG102 /bin 目录下。运行 ./startWeblogic.sh, 启动成功后，在浏览器中输入 http://ip:port/console 来访问并登陆 WebLogic Administration Console。在左侧的导航树中选择 Deployment， 然后定位到 $domain_home，选择 p2pd。点击 Next，直到部署成功，重启该 Weblogic Domain。如图 20 所示：

图 20. 应用部署成功

3.3 访问 Content Manager 和 Dispatcher， 在浏览器中输入： http://ip:port/p2pd/servlet， 访问 CM， 如图 21 所示：

图 21. 访问 Content Manager

在浏览器中输入 http://ip:port/p2pd/servlet/dispatch， 来访问 Dispatch。如图 22 所示：

图 22. 访问 Dispatch

安装配置 GateWay

1 创建 ServletGateway.war 包

这里我们就不通过图形界面来创建部署文件了，我们通过运行 ANT 脚本来创建 ServletGateWay.war。首先定制化归档文件的内容，在 $Cognos_location/war 目录下，有 p2pd 和 gateway 两个目录进入任意目录您可以看到 build.sh 和 build.xml 文件。 可以通过修改 build.xml 来按需包含打进归档文件里面的内容。运行 build.sh 将会执行 build.xml 里面定义的 ant 任务。参数可以查看 build.mxl 里的注释。

进入 gateway 目录，修改 build.xml 文件，使 war 包不包含一些不需要的内容。对于 Webcontent/samples 目录，其包含了数据库例子数据和例子模型，这些对于运行 gateway 并不需要。另外，您可能只需要英文和中文的文档，删除其他语言文档可以缩小 WAR 文件大小，加快创建和部署时间。

打开 $COGNOS_LOCATION/war/getway/build.xml。定位 Target gen_gateway_war。在其里面排除 war 包不需要的内容，如图 23 所示：

图 23. 更新后的 build.xml

然后运行 ./build.sh -Dcontext_root=ServletGateway -Dwar_name=/ricky/RkyWork/ServletGateway.war gateway_war

2 创建 WAS 概要文件

由于会造成 ClassLoader 冲突问题，所以不能把 gateway 和 p2pd 部署在同一个 WAS 实例上，必须分开部署。这里我们创建的 profile 名字为 COG102GW，创建方法同 COG102 概要文件的创建。

3 部署 ServletGateway.war

概要文件创建成功后，启动还要文件，然后进入 WebSphere 概要文件控制台，部署 ServletGateway.war，部署方法和部署 p2pd 类似。

4 配置 library path

部署成功后，需要配置 library path，(Linux: LD_LIBRARY_PATH)。具体的配置方法会在下面的文章里说明。

5 验证部署成功

重启 WAS profile，通过执行命令 ./stopServer.sh server1 和 ./startServer.sh server1，重启成功后，通过浏览器访问 http://ip:port/ServletGateway/servlet/Gateway 如果遇到以下错误则说明网关是配置成功了。 DPR-GTY-5000 Communication failed while attempting to forward the request to the dispatcher. Ensure that IBM Cognos is running。如图 24 所示：

图 24. GateWay 登陆界面

重新启动之前配置好的 p2pd 应用，等待几分钟，刷新登陆界面后，当看到如下界面后，说明配置成功了。如图 25 所示：

图 25. 通过 GateWay 访问 p2pd

需要注意的问题

1 配置 library path

1.1 如果遇到 Error 500: javax.servlet.ServletException: SRVE0207E: Uncaught initialization exception created by servlet 或者 Error 500: javax.servlet.ServletException: Content Manager has not been started. 很可能是由于没有配置 library path 而导致。解决这个问题需要设置 LD_LIBRARY_PATH，COGNOS 需要通过 JNI（java native interface） 调用本地的库文件，需要把 cognos/bin64 指定到操作系统的 library path 环境变量中去。不同的 platform 有不同的设置： Windows : PATH Solaris,LINUX : LD_LIBRARY_PATH AIX: LIBPATH HP-UX: SHLIB_PATH

对于 WebSphere 来说，在启动概要文件的时候，要确保 LD_LIBRARY_PATH 指向 Cognos_location/bin64 目录，可以通过如下命令：

[root@fpru bin]# export LD_LIBRARY_PATH=$COGNOS_LOCATION/bin64 来设置，还可以通过 WebSphere Admin 来设置，登陆 WebSphere admim，在左侧导航树中选择 Servers->Server Types->WebSphere application servers. 右侧选择 server1. 然后点击右下方的 Server Infrastructure->Java and Process Management->Process Defination ，正在进入下一个页面后， 在右侧点击 Environment Entries，然后选择 New 创建环境变量， 如图 26 所示。输入名称和值保存重启便可，如果设置不正确，Content Manager 和 Dispatcher 都将无法启动，如图 27 所示。

图 26. 创建环境变量

图 27. 启动失败

2 启动延迟

由于 COGNOS 后台有很多 Service，WAS 概要文件启动成功，并不代表 IBM Cognos 应用就启动完成，即使管理控制台的绿色箭头表明 Started, 后台的服务也很有可能正在启动。所以，遇到 DPR-ERR-2109 The dispatcher cannot service the request at this time. The dispatcher is still initializing. Contact your administrator if this problem persists. 的错误后，先等待几分钟尝试。若还是有问题，就需要查看 WAS 的日志了。位于 /opt/IBM/WebSphere/AppServer/profiles/COG102/logs/server1 。

3 JAVA 虚拟机必须保持一致

启动 Cognos Configuration 和运行应用服务器的必须一致。不同厂商的 JVM 将会导致 Cryptographic Key 相关问题。在本例中 JAVA_HOME 设置的是 IBM JVM(WebSphere 自带的 )，所以我们也就配置成以这个 JVM 启动 WebLogic， 您也可以使用 SUN 的 JVM 启动 Weblogic，但是必须保证 SUN 的 JVM 能够成功打开 Cognos Configuration。如果要替换启动 Cognos Configuration 的 JVM, 可能会有一些问题，请参考以下解决 http://www-01.ibm.com/support/docview.wss?uid=swg21383421

4 正确设置 URL

需要在 Cognos Configuration 的环境属性里面正确设置 URI，否则将无法访问 Dispatcher。

总结

本文通过图文详细介绍了如何在 IBM WebSphere 和 Oracle WebLogic 中部署 IBM Cognos BI，从 WebSphere profile/Oracle WebLogic Domain 的创建到部署文件的创建再到应用的部署，最后是相关问题解决，可以帮助大家解决解决如何部署 Cognos 到 WebSphere 和 WebLogic 。由于 Cognos 是完全符合 J2EE 标准开发的产品，所以在各个应用服务器上的部署都大同小异，这里就不再详细介绍了。

至于分布式服务器部署，和单机部署很类似，按照本文所讲解的步骤很容易实现。详细请参考 IBM® Cognos® Business Intelligence Installation and Configuration Guide