IBM Cognos 最佳实践: 使用 IBM Cognos Upgrade Manager 对 IBM Cognos 8 环境进行基准检验

产品:IBM Cognos Upgrade Manager;关注领域:应用程序生命周期、IBM Cognos 8、IBM Cognos Reportnet

在您的 IBM Cognos 8 应用程序的生命周期中,您可能需要用 Service Pack、Fix Pack、hotsite 或其他 IBM Cognos 更新程序来更新 IBM Cognos 8。本文档可以为此提供指导方法。

Greg McDonald, 产品经理, IBM

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



2011 年 6 月 02 日

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

简介

目的

在您的 IBM Cognos 8 应用程序的生命周期中,您可能需要用 Service Pack、Fix Pack、hotsite 或其他 IBM Cognos 更新程序来更新 IBM Cognos 8。IT 部门也可能通知您要进行数据库升级或者其他基础设施升级,这可能会影响您的报告环境,或者说得更具体点,影响您的报告。在任何这些情况下,都必须进行报告验证。您必须确保,应用于您环境(IBM Cognos 产品或非 IBM Cognos 产品)中的升级不会影响报告的样子或者报告返回的数据。这就是 IBM Cognos Upgrade Manager 可以帮上忙的地方。IBM Cognos Upgrade Manager 可以帮助您快速识别报告中哪里有数据差异,如果数据驱动任何格式更改,IBM Cognos Upgrade Manager 也可以识别出来。如果比较的状态显示为 “No Differences”,那么会建议进行抽查,以确保没有发生格式更改。例如,如果一个图表或图形偏移了中心位置,这不会被 IBM Cognos Upgrade Manager 标记为差异。

适用性

本文档中展示和讨论的技术使用以下软件进行了验证:

  • IBM Cognos Upgrade Manager 8.4 和 IBM Cognos BI 8.4.29.13

但是,可能也会使用 IBM Cognos Upgrade Manager 8.4 验证来自较早版本的报告。

附加说明

有必要指出来,IBM Cognos Upgrade Manager 发送请求到 IBM Cognos 8 应用程序以运行报告,它并不查看保存的内容。所以,针对验证目的而运行基准检验时,必须确保验证期间不会发生数据刷新。如果在您运行源和目标执行的时间之间数据发生更改,那么 IBM Cognos Upgrade Manager 将标记可能并不是您完成验证所真正想要的差异。

例外与除外责任

IBM Cognos Upgrade Manager 目前不支持在由单点登录 (SSO) 确保安全的 IBM Cognos 8 环境内验证报告。


准备环境的步骤

准备 IBM Cognos 8.x 以接收更新程序

在向 IBM Cognos 8.x 环境安装更新之前,应该做以下事情:

  • 使用您已经证实的数据库特定的备份方法进行一次内容存储备份。在继续之前应该测试数据库备份。
  • 确保从 IBM Cognos Administration 中进行了一次完全的内容存储部署。
  • 进行一次文件系统备份。这将确保您在需要时可以还原到以前的状态。
  • 备份任何您可能已经定制在 IBM Cognos 8 目录结构中的文件。

通过确保具有良好的备份,在需要时,您可以轻松还原到以前的配置/环境。

为非 IBM Cognos 更新准备环境

在准备验证环境之前,应该使用供应商最佳实践备份您要升级或更新的应用程序或组件。例如,如果执行报告数据库的数据库升级,那么您应该备份数据库并测试还原。这样,一旦需要还原到初始版本或配置,您就可以快速而轻松地做到。


设置 IBM Cognos Upgrade Manager

本节我们将设置 IBM Cognos Upgrade Manager,以便源和目标环境指向单个 IBM Cognos 8 源。这将允许我们,在 IBM Cognos 8 应用程序或者第三方应用程序应用更新之前,捕捉报告的之前快照。一旦捕捉了之前快照,环境就可以被更新,然后 IBM Cognos Upgrade Manager 将再次用于捕捉之后快照,以便二者被比较和验证为没有差异。

安装和配置 Upgrade Manager

IBM Cognos Upgrade Manager 的安装和配置在 ug_upgr_mngr.pdf 中有很好的记录,该文件可从 Passport Advantage 下载。请参考该文档,更改默认端口、javaheap 和其他可配置设置。

在 Passport Advantage 上搜索 IBM Cognos Upgrade Manager 时,建议使用以下搜索条件:“IBM Cognos 8 Business Intelligence Upgrade Manager v8.4.1 Windows English(C1XC4EN)”。这将帮助您找到正确的版本。一旦下载了它,您就应该将它安装在一台至少有 1 GB 空闲 RAM 的服务器上。IBM Cognos Upgrade Manager 使用它自己的 Tomcat 实例,并被配置为使用 768MB RAM。将 IBM Upgrade Manager 安装到它自己的目录中,不要将它安装到 IBM Cognos 8 目录中。IBM Cognos Upgrade Manager 发送请求到 IBM Cognos 8 实例,然后以 pdf 格式本地存储运行输出。一次报告验证操作需要 2 个 pdf 文件。1000 次报告比较需要 2000 个左右的 pdf 文件。鉴于此,一定要将 IBM Cognos Upgrade Manager 安装到具有足够磁盘空间的 s 服务器上。

  1. 一旦下载了 Upgrade Manager,就将它解压到您选择的目录中。导航到 win32 目录并执行 issetup.exe 文件。
  2. 决定在哪里安装 IBM Cognos Upgrade Manager 应用程序。
    图 1 显示有预计磁盘空间需求和安装目录的 IBM Cognos Upgrade Manager 安装屏幕
    图 1 显示有预计磁盘空间需求和安装目录的 IBM Cognos Upgrade Manager 安装屏幕
  3. 一旦安装完该产品,就导航到 ..\UpgradeManager 位置,看一下项目文件将会位于的地方。在本例中,pdf 和其他支持文件将被存储在 C:\Program Files\cognos\UpgradeManager\data\projects\ 目录。您创建的每个项目将是此目录中一个包含项目文件的文件夹。

为基准项目配置 Upgrade Manager

我们将从设置 IBM Cognos Upgrade Manager 开始,以便消除在真正没有差异时导致被标记为差异的日期和时间戳。为此,我们在已执行的报告中指定一个静态的日期/时间值,以便在比较源和目标输出时,不同的日期/时间值不会出现。

要消除日期和时间戳,请做以下事情:

  1. 停止 IBM Cognos 8 服务。
  2. 在安装 IBM Cognos 8 的服务器上,导航到 install_location\configuration 目录。复制 rsvpproperties.xml.sample 的一份副本。
  3. 使用一个文本编辑器,打开 rsvpproperties.xml.sample 文件。
  4. 找到 StaticDateTimeOutput 属性。
  5. 删除该属性周围的 xml 注释标记。删除完之后,该属性应该是下面这样的:
    <property>StaticDateTimeOutput</property> <value type="long">1060180744</value>
  6. 将文件保存为 rsvpproperties.xml。
  7. 启动 IBM Cognos 8 服务。

现在我们需要在 IBM Cognos Upgrade Manager 中创建项目,并将项目配置为使用 IBM Cognos 8 安装。

  1. 通过在 web 浏览器中使用以下 URI 来启动 IBM Cognos Upgrade Manager。注意,4797 是默认端口。http://localhost:4797/upgradeManager/3.0/index.html。
    如果 Upgrade Manager 安装在远程服务器上,那么用 IP 地址或服务器名取代 “localhost”。
    图 2 初始 IBM Cognos Upgrade Manager 欢迎屏幕
    图 2 初始 IBM Cognos Upgrade Manager 欢迎屏幕
  2. 单击 New Project 链接创建一个新项目,并给项目取一个名字。例如,“Benchmarking Project”。
    图 3 IBM Cognos Upgrade Manager 的 New Project 屏幕
    图 3 IBM Cognos Upgrade Manager 的 New Project 屏幕
  3. 单击 Create,然后单击 Configure 开始配置项目。
    图 4 IBM Cognos Upgrade Manager 的初始 Configuration 屏幕
    图 4 IBM Cognos Upgrade Manager 的初始 Configuration 屏幕
    此时您必须记住的是,IBM Cognos Upgrade Manager 被开发来帮助客户验证 IBM Cognos 产品 2 个不同版本之间的报告。我们将要做的是,配置我们的项目以指向相同的 IBM Cognos 8 环境,然后使用 IBM Cognos Upgrade Managers 功能,针对代码更新之前和之后的 IBM Cognos 8 测试 IBM Cognos 8 安装。这意味着源和目标分派器 URI 将是相同的。
  4. 像下面演示的那样,对目标和源使用相同的分派器 URI。
    图 5 IBM Cognos Upgrade Manager 的基本 Configuration 屏幕,显示源和目标指向相同的 IBM Cognos 8 实例
    图 5 IBM Cognos Upgrade Manager 的基本 Configuration 屏幕,显示源和目标指向相同的 IBM Cognos 8 实例
  5. 现在进入 Security 选项卡。安全设置需要名称空间 ID。如果不知道实际的名称空间 ID,可以从 IBM Cognos 8 服务器上的 IBM Cognos Configuration 获得它。配置完之后,Security 选项卡看起来应该类似于下面的图像。
    图 6 IBM Upgrade Manager 的 Security 选项卡设置,显示了填入的 Namespace_ID
    图 6 IBM Upgrade Manager 的 Security 选项卡设置,显示了填入的 Namespace_ID
    现在,如果看 IBM Cognos Upgrade Manager UI 的左下角,您会看到这 2 个灰色的图标和链接。
    图 7 演示中显示,Source URL 和 Target URL 呈灰色,不可访问
    图 7 演示中显示,Source URL 和 Target URL 呈灰色,不可访问
    这些灰色的图标向您指出,IBM Cognos Upgrade Manager 当前没有连接到源或目标系统。
  6. 要初始化一个连接,可在 Configure 对话框中单击 Save。单击之后,这两个图标就应该变成可用了。
  7. 现在我们从 IBM Cognos Connection 导入内容。单击 Generate Report List 按钮,为您显示的是 IBM Cognos Connection 包和文件夹。
  8. 现在您可以选择您想要在更新/Fix Pack 应用于您的环境之前和之后验证的内容。
    图 8 IBM Cognos Upgrade Manager 屏幕,显示有发布到 IBM Cognos Connection 门户的包
    图 8 IBM Cognos Upgrade Manager 屏幕,显示有发布到 IBM Cognos Connection 门户的包

    在本例中,“content” 选项已经选定,这将导入从 root 一直到 my project 的所有内容。任务完成后,您的项目应该类似于下图。

    图 9 所有 IBM Cognos Connection Content 都导入到项目之后的 IBM Cognos Upgrade Manager 图像
    图 9 所有 IBM Cognos Connection Content 都导入到项目之后的 IBM Cognos Upgrade Manager 图像

左侧是一个 “Upgrade Tasks” 列表。在升级期间,这是您验证报告升级的逻辑顺序。在应用和更新 IBM Cognos 8 环境之后,我们将使用这些同样的任务验证我们的报告。正如我们在配置阶段所讨论的,我们不是具有 2 个,而是只有一个 IBM Cognos 8 环境。我将把 “Source” 任务当作基准,“Target” 任务当作事后更新/Fix Pack。

执行源环境任务

在本例中,将被验证的报告将位于 2 个文件夹中,即 “Branch Information – Prompted” 和 “Misc Branch Reports – Non Prompted”。源验证不是必需的,报告是有效且正在运行的报告。注意,这两个文件夹旁边的复选框都被选中,以确保文件夹中包含的所有报告都被执行。还要注意,Go 按钮旁边的下拉列表被设置为 Execute reports。

图 10 IBM Cognos Upgrade Manager 显示选中的文件夹,并且 Execute reports 选项被选中
图 10 IBM Cognos Upgrade Manager 显示选中的文件夹,并且 Execute reports 选项被选中

按了 Go 按钮之后,IBM Cognos Upgrade Manager 现在就已经发送针对每个文件夹中将以 pdf 格式执行的所有报告的请求,pdf 内容将被返回并存储在 C:\Program Files\cognos\UpgradeManager\data\projects\Benchmarking Project\ 目录中。您可以进入该目录进行验证。打开您为之执行的报告的文件夹,您会发现一个 “SourceExecute” 目录,其中包含您的 pdf 文件。

一旦报告执行了,IBM Cognos Upgrade Manager 就将在这两个文件夹中都显示一个锁,以避免意外的重复执行。

图 11 IBM Cognos Upgrade Manager 屏幕,为包含已执行报告的选定文件夹包含锁图标
图 11 IBM Cognos Upgrade Manager 屏幕,为包含已执行报告的选定文件夹包含锁图标

确保备份项目目录,以保证您保存了此输出。项目目录将位于 Upgrade Manager 安装位置。例如 C:\Program Files\cognos\UpgradeManager\data\projects。

验证和执行目标环境任务

一旦 IBM Cognos 8 或第三方软件已经更新并重新启动,您现在就可以再次启动 IBM Cognos Upgrade Manager 并打开 Benchmark Project 了。在执行之前,必须对报告进行验证。这将确保,在试图执行报告之前,报告中没有错误。

现在为目标验证和目标执行阶段选择跟上面相同的 2 个文件夹,即 “Branch Information – Prompted” 和 “Misc Branch Reports – Non Prompted”,并做相同的事情。

执行这些步骤时请注意,任务的状态继续显示为 “New”。这表示任务还未完成。

图 12 目标验证屏幕的 IBM Cognos Upgrade Manager 屏幕截图
目标验证屏幕的 IBM Cognos Upgrade Manager 屏幕截图

目标验证返回一个 “Completed” 状态,表示不存在验证错误。您可以继续前进到目标执行任务。

完成目标执行之后,状态更改为 “Completed”。

图 13 IBM Cognos Upgrade Manager
图 13 IBM Cognos Upgrade Manager

现在我们已经完成了执行比较和确定 IBM Cognos 8 软件更新或第三方供应商软件更新是否影响报告所需的步骤。

比较源和目标执行产生的输出

现在源和目标任务已经完成,pdf 输出可用于 IBM Cognos Upgrade Manager 进行比较。选择 “Output Compare” 任务,然后选中两个文件夹旁边的复选框。确保 “Go” 按钮旁边的下拉列表被设置为 “Compare reports”,并单击 Go 按钮。您应该看到下面的屏幕。

图 14 显示有 PDF 比较进度条的 IBM Cognos Upgrade Manager 屏幕
图 14 显示有 PDF 比较进度条的 IBM Cognos Upgrade Manager 屏幕

您现在可以深入 IBM Cognos Upgrade Manager 中的 Branch Information – Prompted 文件夹查看报告的单个状态了。在本例中,指出没有差异。

图 15 IBM Cognos Upgrade Manager 比较结果显示为 No Differences
图 15 IBM Cognos Upgrade Manager 比较结果显示为 No Differences

您现在有了确定 IBM Cognos 8 更新/Fix Pack 或第三方软件更新是否对报告中的数据造成负面影响所需的信息。

查看基准项目的统计信息

您随时可以转到 “Task Summary” 任务,确切了解项目的进度情况以及目前已经完成到什么阶段。

图 16 IBM Cognos Upgrade Manager 显示比较结果的图形概述
图 16 IBM Cognos Upgrade Manager 显示比较结果的图形概述

该视图可以被导出到一个 flash 文件,后者可以分发。这个 flash 文件是完全交互式的,让您能够看到注解和单个报告状态。


额外的建议

建议您抽查一些报告,验证不存在软件更新创建的格式问题。尽管 IBM Cognos Upgrade Manager 在识别数据问题和一些格式问题上做得很好,但是它并不能识别所有的格式差异。

使用 Upgrade Manager 的比较工具

IBM Cognos Upgrade Manager 有两个内置的、随时可用的比较工具。在本例中,我们来看报告的属性,并使用 Flash Compare Tool 来确保报告在软件更新之前和之后看起来完全相同。

  1. 在 Output Compare 任务中,我们深入到 Branch Information – Prompted 文件夹。
  2. 转到一个报告的属性,此报告在 options 列标题下。单击属性图标将把我们带入下面的页面。
    图 17 IBM Cognos Upgrade Manager 显示 Status 选项卡和一系列可用的 PDF 比较工具
    图 17 IBM Cognos Upgrade Manager 显示 Status 选项卡和一系列可用的 PDF 比较工具
  3. 现在我们可以单击 “Launch Flash Output Compare Tool” 链接启动该工具。这将把我们带到该工具,并允许我们利用几个选项验证报告格式没有更改。
    图 18 IBM Cognos Upgrade Manager 的 Flash 比较屏幕,并排显示了两个 PDF 报告
    图 18 IBM Cognos Upgrade Manager 的 Flash 比较屏幕,并排显示了两个 PDF 报告

顶部的按钮允许执行各种功能,它们允许我们聚焦于报告上,确保报告没有发生更改。下面是这些功能的一部分:

  • 并排视图:叠加(这将一个 pdf 叠加在另一个之上,以允许我们识别更改)。
  • 数据比较:您可以在使用叠加功能的同时滚动、放大图像和设置焦点。

参考资料

学习

获得产品和技术

讨论

  • 参与 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=677870
ArticleTitle=IBM Cognos 最佳实践: 使用 IBM Cognos Upgrade Manager 对 IBM Cognos 8 环境进行基准检验
publish-date=06022011