简介

目的

在您的 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 安装屏幕
   
   
   
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. 单击 New Project 链接创建一个新项目，并给项目取一个名字。例如，“Benchmarking Project”。
   
   图 3 IBM Cognos Upgrade Manager 的 New Project 屏幕
   
   
   
3. 单击 Create，然后单击 Configure 开始配置项目。
   
   图 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. 现在进入 Security 选项卡。安全设置需要名称空间 ID。如果不知道实际的名称空间 ID，可以从 IBM Cognos 8 服务器上的 IBM Cognos Configuration 获得它。配置完之后，Security 选项卡看起来应该类似于下面的图像。
   
   图 6 IBM Upgrade Manager 的 Security 选项卡设置，显示了填入的 Namespace_ID
   
   
   现在，如果看 IBM Cognos Upgrade Manager UI 的左下角，您会看到这 2 个灰色的图标和链接。
   
   图 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 门户的包
   
   
   

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

   
   
   图 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。

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

一旦报告执行了，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”。这表示任务还未完成。

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

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

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

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

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

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

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

查看基准项目的统计信息

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

该视图可以被导出到一个 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 比较工具
   
   
   
3. 现在我们可以单击 “Launch Flash Output Compare Tool” 链接启动该工具。这将把我们带到该工具，并允许我们利用几个选项验证报告格式没有更改。
   
   图 18 IBM Cognos Upgrade Manager 的 Flash 比较屏幕，并排显示了两个 PDF 报告
   
   
   

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

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

参考资料

学习

• 通过 developerWorks Information Management 专区：在这里可以学到更多关于 Information Management 的知识。还可以找到技术文档、how-to 文章、培训、下载、产品信息等。
  
  
• 通过 Information Management 专区 Cognos BI 专题，了解更多有关 Cognos BI 专题的产品和技术资源。
  
  
• 通过 商业智能入门以及 Cognos 产品介绍，了解 商业智能的基本概念和相关技术，并介绍了 Cognos 商业智能相关的产品。
  
  
• 关于 Cognos 的安装，请参照 Cognos 8 BI Server 在 Linux 上的安装及与 IHS、WAS、DB2 的配置，学习 Cognos 详细的安装过程。
  
  
• 通过访问 IBM Cognos 8 Business Intelligence，学习 IBM Cognos 8 Business Intelligence 产品的相关知识。
  
  
• 随时关注 developerWorks 技术活动 和 网络广播。
  
  

获得产品和技术

• 在线试用 IBM Cognos BI 试用版软件，了解 IBM Cognos BI 商业智能解决方案的最新版本新功能。
  
  
• 下载 IBM Cognos Express V9 试用版软件，了解 IBM 专为中型企业定制的集成商业智能和计划解决方案。
  
  
• 下载免费的 IBM Information Management 试用版软件，了解 IBM Information Management 软件的最新版本和特性。
  
  

讨论

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

关于作者

为本文评分

评论

回页首

内容

• 简介
• 准备环境的步骤
• 设置 IBM Cognos Upgrade Manager
• 额外的建议
• 参考资料
• 关于作者
• 评论