IBM Cognos 最佳实践: 安装和配置 IBM Cognos Lifecycle Manager,获得最佳结果

文档性质:指南;产品:IBM Cognos Lifecycle Manager;关注领域:升级/迁移

本文描述如何将 Lifecycle Manager 注册为一个 Windows 服务。

Greg McDonald, 产品经理, IBM

作为 IBM Cognos Platform 团队的产品经理,Greg McDonald 管理着 IBM Cognos 软件组合中以 IT 为焦点的特性、共享服务和基础设施技术。凭借 11 年的工作经验,Greg 现在负责应用程序生命周期和内容管理器以及到 Cognos 平台的一般升级。



Amrita Sasane, 高级软件工程师, IBM

Amrita Sasane 拥有六年半质量保证(软件测试)经验,其中包括三年 LCM 产品测试经验,目前负责领导 QC 工作和自动化。



Niraj Modi, 软件开发人员, IBM

Niraj Modi 拥有 7 年多使用 Java/J2EE 和开源技术进行产品开发的经验,最近三年负责领导 LCM 开发工作。



Amit Nagar, 软件开发人员, IBM

Amit Nagar 拥有 7 年多关于 Java/J2EE 领域的 IT 从业经验,担任了三年左右 LCM 产品开发技术负责人职务,还从事各种开发相关活动。



Mrunal Lohar, 助理软件工程师, IBM

Mrunal Lohar 是一名助理软件工程师,从事 IBM Cognos Lifecycle Manager 的服务器端和 GUI 开发。她在 Cognos Group 工作了两年半。



2011 年 11 月 21 日

免费下载:IBM® Cognos® Express V9.5 或者 Cognos® 8 Business Intelligence Developer Edition V8.4 试用版
下载更多的 IBM 软件试用版,并加入 IBM 软件下载与技术交流群组,参与在线交流。

简介

目的

Lifecycle Manager 是一个 32 位 Windows 应用程序,用于帮助验证单个 Cognos BI 实例中的报告内容,同一个 Cognos BI 版本的不同实例之间的内容,以及两个不同的 Cognos BI 版本之间的内容。它可用于 ReportNet 1.1 MR3+、Cognos 8.1.x(参见附录 A 中的注释 1,了解有关的详细信息)、Cognos 8.2.x、8.3.x、8.4.x、8.4.1 和 Cognos 10.1.x。

本文档讨论 Lifecycle Manager 最佳实践。

适用范围

本文档适用于 Cognos Lifecycle Manager 10.1 GA。


Lifecycle Manager 基本信息

安装 Lifecycle Manager 需要注意以下几点:

  1. Lifecycle Manager 安装自己的 Tomcat 实例,因此 Lifecycle Manager 不应该安装在 Cognos BI 服务器目录结构中,除非您想保留 "Lifecycle Manager" 目录。
  2. Lifecycle Manager 从 Cognos BI 服务器检索内容,将其存储在本地 Lifecycle Manager 目录结构中。不能对此进行配置,这意味着 Lifecycle Manager 需要有足够的空间来存储所有执行的输出,以便完成比较。
  3. 运行 Lifecycle Manager 之前,应该联系客户支持部门,获取最新的临时修复程序。目前,对于 10.1 GA 版本,Lifecycle Manager 有一些用于连通性和提示问题的临时修复程序。建议在开始之前应用最新的临时修复程序。
  4. 在创建用于两个 Cognos BI 实例之间的验证的项目之时,最佳实践是同时提供两个环境。这不是必要条件,但在首次创建项目之时,如果没有两个同时可用的环境,则可能面临失去某些功能的风险。生成 Lifecycle Manager 报告之后,就可以立即关闭其中一个 Cognos BI 实例。
  5. 在将 Tomcat JVM 配置为使用 2G 或 3G RAM 时,Lifecycle Manager 的性能最佳。如果机器上有足够的资源,建议至少配置 2G。这个配置很简单,本文稍后会介绍。确保运行 Lifecycle Manager 的机器拥有足够内存,以便支持选择的 JVM 配置。
  6. 尽量缩小 Lifecycle Manager 项目的规模,150-300 个报告最佳。Lifecycle Manager 项目中的对象和信息被载入内存,可能会影响浏览器的性能。通过使项目保持小规模并可管理,可以使 Lifecycle Manager 顺利执行,大项目可能会导致浏览器无响应,项目中的数据/信息也可能丢失。Lifecycle Manager 没有限制可以创建的项目的数量。
  7. 尽管 Lifecycle Manager 没有可创建的项目数量限制,但让包含单独项目的目录保持在 10-15 个项目效果最好。

    如果将要用到更多的项目,则应该压缩项目,避免在 Lifecycle Manager 用户选择 "New" 项目或 Lifecycle Manager 首次启动时加载项目。当需要项目时,只需停止 Lifecycle Manager,解压项目,然后再次启动 Lifecycle Manager 即可。将压缩项目命名为一个 “日期/时间” 戳是一个良好实践。

    Lifecycle Manager 项目位于 ..\LifecycleManager\data\projects 中。
  8. 每个项目的根目录有两个文件:config.xml 和 project.dat,建议备份这两个文件。这些文件用于存储配置和状态信息。如果这些文件缺失,项目将不再有用,必须重新创建。

    project.dat 文件由 Lifecycle Manager 备份,但备份这些文件和项目仍然是一个良好实践。压缩项目将包含这些文件。
  9. Lifecycle Manager 存储已在 Lifecycle Manager 机器上执行的输出。这些输出可能包含敏感信息,应该根据公司政策对它们进行保护。更改默认端口和保护 Lifecycle Manager URI 是另外两个可以应用的安全性级别。第 5.2 节将讨论如何更改默认端口。浏览器一致性 (conformance) 非常重要。建议使用 Firefox 3.5.x 和 IE 7 或 IE 8。Firefox 3.6 不受支持,如果使用该浏览器,Lifecycle Manager 的功能会减少。需要指出的是,Firefox 支持在同一个机器上安装多个版本。
  10. 一些内容存储拥有大量的报告对象。Lifecycle Manager 中拥有称为 "Package Analysis" 的功能。该功能将搜索内容存储,并计算您已选择导入 Lifecycle Manager 项目中的某个特定包中的所有对象。这可能花费大量时间,并有可能影响您的 Cognos BI 实例的性能。建议关闭此功能,直到 Cognos BI 服务器上运行比较缓慢时。在分阶段升级期间或利用 Cognos 10.1 的一些新功能(比如 Dynamic Query Mode)时,Package Analysis 功能非常有用。

了解上述注意事项后,现在就可以成功安装并使用 Lifecycle Manager 了。


Lifecycle Manager 提示

提示可能非常难以测试,特别是当您不熟悉测试报告所需的提示答案时。Lifecycle Manager 拥有一个内置功能,可以用两种方式帮助测试提示。

第一,提示只需在项目中收集一次。一旦收集到提示,便可在整个项目中将提示变量用于源任务和目标任务。

第二,Lifecycle Manager 也允许自动收集提示值。这有助于加快数百个报告的提示收集过程。Lifecycle Manager 并不猜测提示,因此必须手动输入 "Type in"、"Search and Select" 和 "Calendar" 提示,除非已经为报告指定了默认值。

为 Lifecycle Manager 项目收集提示值时,有一点非常重要:提示生成取决于选择的 Lifecycle Manager Task。如果选择的 Task 是一个 Target Task,那么将使用目标系统收集提示,不管正在使用的提示生成功能是用于手动自动提示值生成,还是用于自动提示值生成。

如果可能,一开始应该使用 Target 系统收集提示,这种做法也适用于将要测试的 Target 应用程序提示。目标应用程序是即将升级到的应用程序,所以也是将要执行该提示的系统。如果出现复杂情况,目标系统不可用,或者提示无法收集,Lifecycle Manager 允许用户选择一个源任务并针对源任务生成提示,但会假定源中没有执行提示和/或提示页的问题。Lifecycle Manager 支持这个功能,以便在两个系统中都能够收集提示,从而能够验证、执行和比较报告。


安装 Lifecycle Manager

Lifecycle Manager 的默认安装位置是 "<drive>:\Program Files\ibm\cognos\LifecycleManager"。建议将 Lifecycle Manager 安装在拥有足够磁盘空间的驱动器上,以便存储 Lifecycle Manager 将检索的所有输出。如果正在验证两个 Cognos BI 实例,那么将检索被请求的报告输出的两个副本,以便完成比较。如果被请求的语言不止一种,那么要检索的报告数量可能会翻倍。

在 win32 目录(Lifecycle Manager 产品下载已在此处解压)中执行文件 issetup.exe 将开始安装过程。首先,需要选择一种安装语言,如图 1 所示。这是安装屏幕的语言,而不是 Lifecycle Manager 的安装语言。

图 1. IBM Cognos Lifecycle Manager 的 Setup Language Selection 屏幕
图 1. IBM Cognos Lifecycle Manager 的 Setup Language Selection 屏幕

接下来,用户必须统一 IBM 许可协议。最后,必须选择安装路径。图 2 展示安装路径已经更改为一个拥有足够空间、可以处理将被比较的所有输出的驱动器。

图 2. IBM Cognos Lifecycle Manager 的 Setup Installation Location 屏幕
图 2. IBM Cognos Lifecycle Manager 的 Setup Installation Location 屏幕

然后,会询问用户程序文件夹所在位置和快捷方式。要注意,这些是启动和停止启动点所在的位置。

下一个屏幕是安装摘要屏幕,用于检查已选择的设置。选择 Next 后,会将 Lifecycle Manager 安装在请求的位置,然后安装完成。


配置 Lifecycle Manager

Tomcat JVM

要调整 Tomcat jvm 大小,请打开 Windows Explorer 并导航到安装目录。

例如:C:\apps\ibm\cognos\LifecycleManager\bin

备份 startup-um.bat 文件:在 Lifecycle Manager bin 目录中制作一个文件副本。

打开文件名 startup-um.bat。这个文件将拥有 3 个可以配置的 jvm 大小。默认情况下,jvm 被设置为 1G,如下所示。1G jvm 所在的行之前没有 REM 参数,这表示将在启动时使用它。

rem "for machines with 1GB RAM"
set CATALINA_OPTS=-Xmx768m -XX:MaxNewSize=384m -XX:NewSize=192m
  -XX:MaxPermSize=128m %UM_OPTS% %DEBUG_OPTS%

rem "for machines with 2GB RAM"
REM set CATALINA_OPTS=-Xmx1152m -XX:MaxNewSize=576m -XX:NewSize=288m
  -XX:MaxPermSize=128m %UM_OPTS% %DEBUG_OPTS%

rem "for machines with 3GB RAM"
rem set CATALINA_OPTS=-Xmx1536m -XX:MaxNewSize=768m -XX:NewSize=384m
  -XX:MaxPermSize=128m %UM_OPTS% %DEBUG_OPTS%

在本例中,将要使用的机器拥有 4G RAM,因此我们将使用 2G JVM。为此,可以在 1G 条目之前键入 "REM"。

rem set CATALINA_OPTS=-Xmx768m -XX:MaxNewSize=384m -XX:NewSize=192m

然后删除 2G JVM 行之前的 "REM",如下所示。

set CATALINA_OPTS=-Xmx1152m -XX:MaxNewSize=576m -XX:NewSize=288m -XX:MaxPermSize=128m

文件完成后将如下所示。

rem "for machines with 1GB RAM"
rem set CATALINA_OPTS=-Xmx768m -XX:MaxNewSize=384m -XX:NewSize=192m
  -XX:MaxPermSize=128m %UM_OPTS% %DEBUG_OPTS%

rem "for machines with 2GB RAM"
set CATALINA_OPTS=-Xmx1152m -XX:MaxNewSize=576m -XX:NewSize=288m
  -XX:MaxPermSize=128m %UM_OPTS% %DEBUG_OPTS%

rem "for machines with 3GB RAM"
rem set CATALINA_OPTS=-Xmx1536m -XX:MaxNewSize=768m -XX:NewSize=384m
  -XX:MaxPermSize=128m %UM_OPTS% %DEBUG_OPTS%

现在已经完成更改,请保存文件。

更改端口

对于拥有足够内存的机器,更改端口允许在同一台机器上同时进行多个 Lifecycle Manager 安装。这还能在应用程序中添加另外一层安全性。更改端口后,不该访问 Lifecycle Manager 的用户访问它的难度增加了。

使用 Windows Explorer 导航到 Lifecycle Manager 目录结构中的以下目录 "C:\apps\LIFECYCLE MANAGERPatched\LifecycleManager\webapps\LifecycleManager\WEB-INF"。在这里备份 "server.xml" 文件。然后,使用一个文本编辑器编辑文件。文件打开后,需要编辑的行如下所示。

注意:可以通过在文件中搜索 "4797" 来找到这一行。

<Connector className="org.apache.coyote.tomcat4.CoyoteConnector" port="4797"
  minProcessors="5" maxProcessors="75" enableLookups="true" redirectPort="9443"
  acceptCount="100" debug="0" connectionTimeout="60000" useURIValidationHack="false"
  disableUploadTimeout="true"/>

将该端口更改为机器上打开的任何端口。要查看正在使用的端口列表,可以打开 DOS/Command 提示并键入 "netstat -a"。决定要使用的端口后,可以在上面的行中更改它,然后保存文件。在本例中,端口号已经更改为 "2497"。

<Connector className="org.apache.coyote.tomcat4.CoyoteConnector" port="2497"
  minProcessors="5" maxProcessors="75" enableLookups="true" redirectPort="9443"
  acceptCount="100" debug="0" connectionTimeout="60000" useURIValidationHack="false"
  disableUploadTimeout="true"/>

还应该注意的是,如果需要在机器上运行多个 Lifecycle Manager 实例,那么还需要更改 server.xml 中的 Lifecycle Manager 来关闭端口。关闭端口包含在下面的行中。

<Server port="4799" shutdown="SHUTDOWN" debug="0">

完成更改后,请保存文件。这些步骤完成后,Lifecycle Manager 已经做好了启动的准备。

启动 Lifecycle Manager

有两个选项用于启动 Lifecycle Manager。可以在 bin 目录中执行 startup-um.bat 文件,也可以从 Windows -> Start 菜单启动。用户可以导航到 Lifecycle Manager 条目并选择 "IBM Cognos Lifecycle Manager Startup" 选项。Lifecycle Manager 启动后,一个 DOS 窗口会出现。如果 DOS 窗口中包含以下信息,则表明 Lifecycle Manager 已成功启动。

Using CATALINA_BASE:   ..\tomcat
Using CATALINA_HOME:   ..\tomcat
Using CATALINA_TMPDIR: ..\temp
Using JRE_HOME:        ..\bin\jre\6.0

如果关闭窗口,Lifecycle Manager 随即也会关闭。如果使用远程连接工具在服务器上安装 Lifecycle Manager,了解这一点很重要。如果启动 Lifecycle Manager 的用户退出远程会话,DOS 窗口也将关闭,Lifecycle Manager 将停止并不在可用。有些远程连接工具,比如 Windows Remote Desktop Connection,允许关闭但不停止远程连接。这意味着用户仍然处于登录状态,Lifecycle Manager DOS 窗口继续运行,Lifecycle Manager 允许通过支持的浏览器对其进行远程访问。

可以通过关闭 DOS 窗口或选择 "IBM Cognos Lifecycle Manager Shutdown" option from Windows -> Start 菜单来完成 Lifecycle Manager 的关闭。

Lifecycle Manager UI 的启动方法是:启动一个浏览器会话,将 Lifecycle Manager url 放在其中。也可以通过使用您的默认浏览器访问 Windows Start 菜单来启动它。要找到您的默认浏览器,请访问 Windows Start 菜单。在 Programs 菜单中找到新创建的 Lifecycle Manager 项目,选择 "IBM Cognos Lifecycle Manager URI"。这将在浏览器中启动 Lifecycle Manager UI。但启动之前,您需要访问这个项目的属性,因为默认端口还在那里,因此您将收到错误消息 "Page cannot be displayed"。然后,只需更改 URL 中的端口即可。

示例:

http://localhost:4797/LifecycleManager

更改为:

http://localhost:2497/LifecycleManager

这当然是假定您正从本地机器启动 Lifecycle Manager。如果不是,则需要将 localhost 更改为安装 Lifecycle Manager 的服务器的名称。

通过 Start 按钮访问 "IBM Cognos Lifecycle Manager URI",更改端口号,如有必要,请将 localhost 应用更改为服务器名称,以便将来启动 Lifecycle Manager 时不会出现 "Page cannot be displayed" 错误消息。

Lifecycle Manager 现在已准备好连接到环境中任何 Cognos BI 系统。


Lifecycle Manager 需要的连接信息

要开始创建一个验证项目,Lifecycle Manager 需要从它将连接到的每个 Cognos BI 环境中收集信息。所有必要信息都可以在您想连接到的实例的 Cognos Configuration 中找到。

  • Dispatcher 和 Gateway URI 的信息可以在 "Environment" 叶 (leaf) 中找到。
  • 安全信息可以从 security provider 叶中检索到。

重要的是从安全提供者的属性获取 "Namespace ID",而不是左侧的浏览器面板中的 Authentication 叶下的叶的名称。针对 Cognos 10.1 的相同信息可以从这些位置检索。


在 Lifecycle Manager 中创建一个项目

要开始在 Lifecycle Manager 中创建项目,启动一个浏览器并输入正确的 URL。系统会启动 UI,然后便可以创建一个新项目,如图 3 所示。

图 3. Lifecycle Manager Welcome 屏幕
图 3. Lifecycle Manager Welcome 屏幕

有两种方法可以创建一个项目。

  1. 选择 Welcome 页上的 "new project" 链接。
  2. 从工具栏选择 "Projects" 连接,然后选择 "New Project"。

然后,Lifecycle Manager 将显示 New Project 对话框,要求输入名称和项目类型,如图 4 所示。

图 4. New Project 对话框
图 4. New Project 对话框

在 New Project 对话框中,保留默认选项 "Create blank project"。在 “New Project Name” 中输入新项目的名称,将 "Project Type" 选择为 "Validation Project"。然后,单击 "Create" 按钮。

项目创建好后,将显示一个新屏幕(参见图 5),允许配置项目,然后将报告内容导入将被比较的项目。第一步是选择 Configuration 按钮,完成配置并保存项目。

图 5. Lifecycle Manager Project 屏幕
图 5. Lifecycle Manager Project 屏幕

下面 4 个图像显示了 Lifecycle Manager 项目的 Configure 屏幕上的 4 个选项卡:Basic、Security、Advanced 和 Preferences。

图 6 显示了 Basic 选项卡,这是设置源和目标服务器的项目名称、网关 URI、分发器 URI、版本和最大连接的地方。

图 6. Lifecycle Manager Configure 屏幕 Basic 选项卡
图 6. Lifecycle Manager Configure 屏幕 Basic 选项卡

图 7 显示了 Security 选项卡,这是设置源和目标服务器的用户名、密码和命名空间 ID 的地方。

图 7. Lifecycle Manager Configure 屏幕 Security 选项卡
图 7. Lifecycle Manager Configure 屏幕 Security 选项卡

图 8 显示了 Advance 选项卡上的所有默认设置。

图 8. Lifecycle Manager Configure 屏幕 Advanced 选项卡
图 8. Lifecycle Manager Configure 屏幕 Advanced 选项卡

图 9 显示了 Preference 选项卡上的默认设置,这是用户设置 Format 选项、Dynamic Query Mode 选项和语言选项的地方。

图 9. Lifecycle Manager Configure 屏幕 Preferences 选项卡
图 9. Lifecycle Manager Configure 屏幕 Preferences 选项卡

完成 Lifecycle Manager 的 Configure 屏幕中的选项卡后,请保存项目。

项目成功保存后,主 Lifecycle Manager UI 现在应该显示两个环境都可用。Lifecycle Manager 屏幕左下角有两个图标:Launch Source Portal 和 Launch Target Portal。这些图标在处于活动状态时位于屏幕底部,如图 10 所示。这表明系统可用。如果需要访问源系统和目标系统,这些链接将启动源门户和目标门户,以便轻松访问它们。

图 10. Lifecycle Manager Project 屏幕显示源和目标门户均已配置
图 10. Lifecycle Manager Project 屏幕显示源和目标门户均已配置

在 Lifecycle Manager 项目的这个阶段,可以选择 Generate Report List 按钮,Lifecycle Manager 将访问 Cognos Connection 中的公共文件夹的内容,并将其显示给 Lifecycle Manager 用户。可以导入文件夹和/或包中的内容进行比较。

要深入了解 Lifecycle Manager 及其提供的特性和功能,请观看 YouTube 上的这个 8 分钟逐步演示:

http://www.youtube.com/watch?v=G6Dd9XOjeyE


附录 A. 故障诊断

比较似乎不起作用

有时,Lifecycle Manager 看起来似乎要对结果进行比较,但比较状态却没有发生变化。这种情况可能在产生比较大的输出时。在这种特殊情况下,Lifecycle Manager 需要更多内存。请按照第 4 节中的描述,编辑 startup-um.bat 文件,增加 Lifecycle Manager 可用的内存量。

内存问题

如果 Lifecycle Manager 有内存或内存不足问题,这些问题可以通过监控 LIFECYCLE MANAGER_install_location\\LifecycleManager\bin 目录来识别。

参考资料

学习

获得产品和技术

讨论

  • 参与 developerWorks 博客 并加入 developerWorks 中文社区,developerWorks 社区是一个面向全球 IT 专业人员,可以提供博客、书签、wiki、群组、联系、共享和协作等社区功能的专业社交网络社区。

条评论

developerWorks: 登录

标有星(*)号的字段是必填字段。


需要一个 IBM ID?
忘记 IBM ID?


忘记密码?
更改您的密码

单击提交则表示您同意developerWorks 的条款和条件。 查看条款和条件

 


在您首次登录 developerWorks 时,会为您创建一份个人概要。您的个人概要中的信息(您的姓名、国家/地区,以及公司名称)是公开显示的,而且会随着您发布的任何内容一起显示,除非您选择隐藏您的公司名称。您可以随时更新您的 IBM 帐户。

所有提交的信息确保安全。

选择您的昵称



当您初次登录到 developerWorks 时,将会为您创建一份概要信息,您需要指定一个昵称。您的昵称将和您在 developerWorks 发布的内容显示在一起。

昵称长度在 3 至 31 个字符之间。 您的昵称在 developerWorks 社区中必须是唯一的,并且出于隐私保护的原因,不能是您的电子邮件地址。

标有星(*)号的字段是必填字段。

(昵称长度在 3 至 31 个字符之间)

单击提交则表示您同意developerWorks 的条款和条件。 查看条款和条件.

 


所有提交的信息确保安全。


static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=10
Zone=Information Management
ArticleID=776131
ArticleTitle=IBM Cognos 最佳实践: 安装和配置 IBM Cognos Lifecycle Manager,获得最佳结果
publish-date=11212011