怎样移植你的POWERPLAY应用程序

COGNOS POWERPLAY 应用的安全认证源被引用为名字空间(Namespace)，因为Upfront在Upfront data store存贮了指向namespace的一个引用，当你改变了名字空间(Namespace)，你也必须随之改变Upfront data store中对namespace的引用。

¨ 发布定制的客户化的解决方案

为了适应客户的需要，你可能对Upfront中的NewsBoxes 、NewsItems等进行了定制，需要将这些定制的内容移植到目标环境中。

2.进行移植需做的工作

当把 COGNOS POWERPLAY 应用程序从源环境移植到目标环境时，需做的工作如下：

¨ 安全认证信息源

把被引用为名字空间的安全认证信息源导出到一个.lae文件中，再将这个.lae文件导入到目标环境中。

¨ PowerPlay PPSRoot 目录

将PPSRoot 目录从源环境拷贝到目标环境。

¨ Mdc文件和PPX报表

将多维立方体文件和PPX报表从源环境拷贝到目标环境。

¨ Upfront data store中的内容

包括Upfront系统信息和NewsIndex。NewsIndex包括NewsBoxes、NewsBox快捷方式、 NewsItems、 NewsItem快捷方式。利用Upfront提供的随机安装的命令行工具将Upfront data store打包和解包。将利用打包工具产生的文件拷贝到目标环境并解包。

¨ 定制的Upfront界面文件

将定制的Upfront界面文件（即theme）从源环境拷贝到目标环境。

当进行移植时，源环境没有软件的迁移，也没有数据的修改。目标环境中，在unpack应用程序之前，相应的Cognos产品必须已经安装和配置好。

图 1列出了从源环境中迁移的PowerPlay应用程序中的对象。

图1

图 2显示了移植到目标环境的文件和目录以及它们怎样重新集成为目标PowerPlay应用程序。

图2

3.移植前的准备工作

怎样移植PowerPlay应用程序将在下面的两章“打包应用程序”和“解包应用程序”中叙述。为了确保能够成功移植，请严格遵守这两章列出的操作步骤。

按照下面的说明可以简化移植过程。

¨ 移植前目标环境中必须已安装、配置好 Cognos产品。目标环境中的Cognos版本必须和源环境保持一致，版本不一致会出问题。

¨ 在源环境中创建一个缓存区

缓存区是一个临时文件夹，在这个文件夹中保存当进行pack操作时产生的文件。如果目标环境联接不到源环境从而无法访问缓存区，你应当在目标环境中创建一个相似的文件夹以便保存从源环境中拷贝的文件。

必须确保为缓存区设置了适当的安全性，因为进行pack操作时产生的文件是文本格式的，能访问该文件夹的任何人都可以看到这些文件。

¨ 确保目标环境可以访问在源环境中使用的数据源

移植PowerPlay应用程序时不移植数据源，目标环境中的数据源的逻辑联接名应和源环境完全一样。

¨ 在 DOS窗口中运行随机安装的pack和unpack命令行实用工具

不要选择在开始菜单中运行pack和unpack命令，这两个命令会在运行时提示你输入用户名和口令以进行安全认证。能成功登录到计算机的用户不会被授权执行这两个命令，只有属于根用户类的用户才能运行这两个命令。尽管你可以将口令写进一个批处理文件中以便可自动进行pack和unpack操作，但推荐你使用运行时将口令掩码的命令行方式。

二、将应用程序打包

按照下面的操作步骤将 PowerPlay应用程序打包：

¨ 导出安全认证信息源

¨ 导出 Upfront data store

¨ 拷贝Upfront显示主题，如果定制了的话

¨ 拷贝PPSRoot目录

¨ 拷贝多维立方体

¨ 拷贝用 PowerPlay客户端应用程序创建并且不在PPSRoot目录下的PPX报表。

¨ 收集执行 pack操作过程中产生的文件并拷贝到目标环境中。

本章将详细介绍这些操作步骤。

1.导出安全认证信息源

Access Manager使用一个唯一的ID来识别每个用户类，这些用户类存贮在被引用为名字空间的安全认证信息源中，如果一个cube使用了名字空间被加以安全性，这些ID也就被存贮在cube中。当你移植 PowerPlay应用程序时，存贮在cube中的用户类ID必须和目标环境中的名字空间的用户类ID相匹配。如果不匹配，cube将不可访问，必须重新生成。为了保证这些ID一致，目标环境中的名字空间必须是源环境名字空间的一个完全复制，为了做到这一点，将源环境中的名字空间导出到一个lae文件中，并且覆盖目标环境中的.lae文件。

步骤：

1) 打开 Access Manager管理程序。

注意： Access Manager管理程序仅运行在Windows平台上。

2) 在认证信息控制面板中，展开目录服务器文件夹并且双击目录服务器

3) 单击名字空间，如果需要，请登录。

注意：仅当你拥有一个基本的或操作系统级的 signon，并且属于一个可编辑名字空间内容的用户类时，才能登录名字空间。

4) 单击鼠标右键，从弹出菜单中选择“ Export to .LAE File”菜单项

打开“ Export to .LAE File”对话框

5) 从列表中选择一个本地安全认证文件，如果列表中没有列出任何文件，添加一个新文件。

关于怎样添加一个新的本地安全认证信息文件，请查看 Access Manager管理程序的联机帮助。

6) 单击以选择“ Empty the Target Namespace”单选按钮。

7) 单击“ Export” 按钮。

当导出操作完成后，产生了一个名为“ LDAPtoLAE.log”的日志文件，该日志文件位于和导出的本地安全认证信息文件相同的目录。

8) 如果你在源环境中准备了一个缓存区，请将本地安全认证信息文件移到该目录下。

2. 将Upfront数据打包

用一个名为UpfPack的命令行工具将Upfront data store中的信息打包，如果你定制了Upfront的界面文件，即主题，请拷贝这些文件，因为UpfPack不会将这些文件打包。

建议你不要改变Upfront界面文件中用来识别NewsBoxes、 NewsItems和快捷方式的图标的URL。当你在目标环境中解包 Upfront时，URL中指定的机器名会被自动更新为你正在其上解包的机器名。然而，如果源环境中的URL被修改了，目标环境中的URL不会自动再生，你必须手工的修改每个图标文件的URL。

2.1 将Upfront Data Store打包

用命令行工具 UpfPack将Upfront data store打包，该命令位于安装Upfront服务器程序的机器的bin目录下。在Windows操作系统下，UpfPack工具利用connect.ini文件中的信息去定位Upfront data store，而在UNIX操作系统下，UpfPack工具利用环境变量得到此信息。

执行命令行工具 UpfPack将产生下列文件：

¨ 一个Upfront包，其中包含Upfront data store的信息，缺省的文件名为UpfPackage.pkg。

¨ 一个打包列表，当你移植 PowerPlay应用程序时该文件没有被使用，缺省的文件名为PackingList.txt。

¨ 一个网关映射指导文件，该文件记录在目标环境中解包Upfront前需要被映射的网关，缺省的文件名为UpfPGInstructions.htm。

¨ 一个错误日志文件，记录所发生的错误信息，缺省的文件名为UpfPackError.log。

当你执行 UpfPack命令前必须确保Upfront data store、ticket server、Netscape Directory Server服务已启动，Ticket server、Netscape Directory Server服务保证只有被成功授权的用户才能打包data store。

在执行 UpfPack的过程中你可以阻止用户登录Upfront，这不是运行该命令所必须的，但在执行UpfPack的过程中用户所作的修改不会被打包。

检查服务已启动的步骤：

必须保证 Cognos Upfront Data Store, Cognos Ticket Server和Netscape Directory Server服务已经启动。

¨ 在 Windows平台上，打开控制面板 à管理工具 à服务，然后检查上面的服务是否已启动。

¨ 在UNIX平台上，用ps (process status)命令检查有哪些命令正在运行。

禁止用户登录 Upfront 的步骤：

1) 启动 Upfront Server管理程序

u 在 Windows平台上，打开开始菜单 à程序 à Cognos BI à Administration à Upfront - Server Administration。

u 在 UNIX平台上，进入bin目录下，在命令行模式下输入UpfrontAdmin.sh，然后回车。

连接对话框打开。

2) 输入 Upfront服务器的计算机名，然后点击联接。

3) 如果需要，请登录。

4) 选择是停止单个 Upfront服务器还是所有的Upfront服务器：

u 停止单个 Upfront服务器，单击以选中要停止的Upfront服务器的图标。

u 停止所有的 Upfront服务器，单击以选中Upfront服务器组的图标。

注意：如果Upfront服务器没有被列示，请将其添加在 Upfront服务器组下。关于如何添加一个Upfront服务器，请参考 Upfront服务器管理程序的联机帮助。

5) 从 Action菜单中，选择Stop。

Cognos Upfront Dispatcher服务被停止。

运行Upfront打包工具(UpfPack)

当运行 UpfPack工具时，你可以接受默认的参数也可以指定所需的参数。

选项	描述	缺省值
-un	用户名	提示输入用户名，该用户必须是 Upfront的管理员。
-pw	口令	提示输入用户口令
-d	源环境中保存产生文件的目录。语法格式： -d 盘符:\路径名。在路径名的最后不要包含一个斜杠；必须保证这个目录被正确设置了安全性，输出文件是文本格式的，这意味着能访问该目录的任何人均可以访问这些文件。	bin
-pn	Upfront包文件名和路径。	bin\UpfPackage.pkg
-pln	打包列表文件名和路径。当移植 PowerPlay应用程序时该文件没有被使用。	bin\PackingList.txt
-i	网关映射指导文件名和路径。	bin\UpfPGInstructions.htm
-h	帮助信息。	无

该工具的语法格式为：

UpfPack [-un 用户名] [-pw 口令] [-d 路径] [-pn Upfront包文件] [-pln 打包列表文件] [-i 网关映射指导文件]

如果在路径名或文件名中包含有空格，请使用双引号来包含该参数。

操作步骤：

1) 打开 Windows的命令行窗口或进入UNIX的shell。

2) 进入 Cognos的bin目录。

3) 运行 UpfPack命令行工具。

u 在 Windows平台上，输入UpfPack和参数，然后回车。

u 在 UNIX平台上，输入run-upfpack和参数，然后回车。

4) 当提示输入用户名时，输入一个属于 Upfront安全管理员的用户然后回车。

注意： Upfront安全管理员必须属于一个特殊的用户类，该用户类的成员拥有查看所有用户类的权限，这个权限是通过 Access Manager 来设置的。

5) 当提示输入口令时，输入口令，然后回车。

UpfPack开始运行并产生输出文件。

6) 如果你在源环境中准备了缓存区，将 Upfront包文件和网关映射文件移到缓存区。

查看错误日志文件

如果在打包过程中发生错误，在 bin目录下会产生一个错误日志文件，查看该文件以发现错误并制定可能的解决方案。

操作步骤：

1) 在文本编辑器中，打开 UpfpackError.log文件。

重启Upfront服务器

如果你关闭了 Upfront服务器以阻止用户登录，请重启Upfront服务器。

步骤：

1) 启动 Upfront服务器管理程序。

u 在 Windows平台上，点击开始菜单 à程序 à Cognos BI à Administration à Upfront - Server Administration。

u 在 UNIX平台上，进入bin目录下，在命令行模式下输入UpfrontAdmin.sh，然后回车。

2) 在联接对话框中，输入 Upfront服务器的机器名然后点击联接。

3) 如果需要，请输入登录信息。

4) 在左侧的面板中，点击 Upfront服务器或Upfront服务器组的图标。

5) 从 Actions 菜单中，点击 Enable

这样 Cognos Upfront Dispatcher 服务就被启动了。

2.2 拷贝Upfront显示主题

如果你定制了 Upfront显示主题（theme），请拷贝这些文件：Upfront模板文件 (.utml),Upfront包含文件 (.uinc), HTML文件 (.html)和图片文件 (.gif). UpfPack 实用工具不会将这些文件打包。

步骤：

1) 进入 Upfront显示主题（theme）所在的目录

缺省的位于 \Cognos\cer1\webcontent\upfront 目录。

注意：如果 Upfront的组件分布在多个计算机上，HTML文件 (.html)和图片文件 (.gif)位于Web服务器上，而Upfront模板文件 (.utml)和Upfront包含文件 (.uinc)则位于Upfront dispatcher服务器上。

2) 如果你在源环境上准备了缓存区，请维持目录结构将 Upfront显示主题目录和其子目录拷贝到缓存区。

3.拷贝PowerPlay对象

拷贝并移动PowerPlay PPSRoot目录、多维立方体文件(.mdc)和任何不在PPSRoot目录下的PPX报表。

PPSRoot目录包含配置信息(.cfx文件)，也可能包含PPX报表，PPX报表是用PowerPlay for Windows、PowerPlay for Excel或PowerPlay Web创建的。

当你迁移 PPX报表时，相应的多维立方体文件也必须被迁移。

步骤：

1) 进入 PPSRoot目录

该目录位于 \Cognos\cer1\ppserver 目录下。

2) 如果你在源环境上准备了缓存区，请拷贝 PPSRoot目录到缓存区。

3) 进入多维立方体文件所在的目录。

4) 将多维立方体文件拷贝到缓存区。

5) 找到不在 PPSRoot 目录下的所有 PPX报表。

6) 拷贝 PPX报表到缓存区。

4.将文件移到目标环境中

必须将打包操作过程中收集到的文件移到目标环境中。

Upfront打包列表文件，默认的文件名为PackingList.txt，当移植 PowerPlay应用程序时该文件没有被使用，因此不需要移到目标环境中。

经过上面的操作，你应该有下面的一些或所有文件：

¨ 本地安全认证文件 (.lae)。

¨ Upfront包文件，默认的文件名为UpfPackage.pkg。

¨ Upfront网关映射指导文件，默认的文件名为UpfPGInstructions.htm。

¨ Upfront显示主题文件(.utml, .uinc, .html, .gif)。

¨ PowerPlay PPSRoot目录。

¨ PowerPlay多维立方体文件(.mdc)。

¨ PowerPlay PPX报表文件(.ppx)。

操作步骤：

1) 如果在源环境中准备了缓存区，请先进入该目录。

2) 利用任何适当的方法将源环境中的这些文件移到目标环境中。例如，可以将这些文件拷贝到一个 CD 上，或者将其放到一个目标环境可利用的网络驱动器上，或者利用 FTP 将其传到目标环境中。

三、将应用程序解包

在目标环境中，Cognos的组件，包括PowerPlay、 Access Manager、Upfront必须已经安装和配置好，并且可以访问应用程序打包过程中所产生的文件。

请按照下面的操作步骤将PowerPlay应用程序解包：

¨ 导入安全认证信息源。

¨ 如果需要，建立到数据源的联接。

¨ 解包 Upfront data store。

¨ 如果进行了定制，请将Upfront显示主题（theme）拷贝到目标环境。

¨ 如果需要，修改指向Web页或文档的NewsItems的URL。

¨ 如果需要，修改网关的 URL。

¨ 将PPSRoot目录、多维立方体文件和PPX报表拷贝到目标环境。

¨ 测试目标环境。

本章将详细介绍上面的每一个操作步骤。

1.导入安全认证信息源

. Access Manager使用一个唯一的ID来识别每一个用户类，如果一个PowerPlay的多维立方体文件被使用了安全认证信息源即名字空间而加了安全性，这些ID也被存贮在多维立方体文件中。当你移植 PowerPlay应用程序时，存贮在cube中的用户类ID必须和目标环境中的名字空间的用户类ID相匹配，如果不匹配，cube将不可访问，必须重新生成。为了保证这些ID一致，目标环境中的名字空间必须是源环境名字空间的一个完全复制，为了做到这一点，将从源环境中得到的lae文件导入、并且覆盖目标环境中的名字空间。

步骤：

1) 打开 Access Manager管理程序。

注意： Access Manager管理程序仅运行在Windows平台上。

2) 在认证信息控制面板中，展开目录服务器文件夹并且双击目录服务器。

3) 单击名字空间，如果需要，请登录。

注意：仅当你拥有一个基本的或操作系统级的 signon，并且属于一个可编辑名字空间内容的用户类时，才能登录名字空间。

4) 单击鼠标右键，从弹出菜单中选择“ Import from .LAE File”菜单项。

打开“ Import from .LAE File”对话框。

5) 在列表中选择从源环境迁移过来的本地安全认证信息文件。

注意：如果本地安全认证信息文件没有被列出，请确认该文件在目标环境中可用。

6) 选择你要导入的本地安全认证信息文件中的名字空间。

7) 单击以选中“ Empty the Target Namespace ”单选按钮。

8) 单击“ Import ”按钮。

当导入操作完成后，在和本地安全认证信息文件相同的目录下会产生一个名为“ LAEtoLDAP.log”的日志文件。

9) 确认导入的名字空间被设为默认的名字空间并且你的用户有访问权限。

关于默认的名字空间的更多信息，请参考 Access Manager管理程序的联机帮助。

2. 建立到数据源的联接

当迁移应用程序时，数据源不会随之迁移，在目标环境中你必须利用Access Manager重新建立到数据源的联接。目标环境中的到数据源的联接名必须和源环境中的完全一样。关于如何建立到数据源的联接，请参考Access Manager管理程序的联机帮助。

仅仅在Windows NT上，PowerPlay需访问存贮在cognos.ini文件中的数据库联接信息，如果收到一个不能从cognos.ini文件中读联接信息的提示，你必须从Access Manager中将数据源的联接字符串拷贝到cognos.ini文件中。

更新 cognos.ini文件中的联接信息的步骤：

1) 在 Access Manager的安全认证信息面板中，展开数据源的文件夹并且点击PowerPlay提示出错的那个数据源。

2) 从“ Edit”菜单中，选择“Properties”菜单项。

数据库的属性对话框打开。

3) 在“联接”标签页中，选择并拷贝联接字符串文本框中的信息。

4) 在文本编辑器中打开 cognos.ini文件。

cognos.ini文件位于你的系统盘的WinNT目录下。

5) 在 cognos.ini文件的“数据库”节中，选择要修改的数据源。

6) 用从 Access Manager中拷贝的信息替换当前的联接字符串。

[DATABASES]

GOS=;LOCAL;OD;DSN=GOScer1@ASYNC=0@0/0

GOV=;LOCAL;OD;DSN=GOVcer1@ASYNC=0@0/0

GODW=;LOCAL;OD;DSN=GODWcer1@ASYNC=0@0/0

GOMR=;LOCAL;OD;DSN=GOMRcer1@ASYNC=0@0/0

[INFORMATION]

The file "C:\WINNT40\cognos.ini" is only used for database connection

information.=

The file "e:\Program Files\Cognos\cer1\bin\cer1.ini" includes all other

entries used for the cer1 generation of applications.=

[Cognos Locations]

TRANSFORMER=e:\Program Files\Cognos\cer1\bin

7) 保存并关闭该文件。

3. 将Upfront数据解包

当解包Upfront时，你可以合并源Upfront data store到目标data store，合并操作仅更新目标Upfront data store的信息，Upfront用户在目标环境中创建的对象，如个人消息箱和已保存的报表，依然保留。你也可以在解包源Upfront data store前删除目标data store中的内容，例如，在一个测试环境中，你可能会想在目标环境中创建一个干净的Upfront data store，当你删除目标Upfront data store并替代以源Upfront data store后，你需要确保Upfront被正确的设置了安全性，关于建立安全性的更多信息请参考Upfront 服务器管理程序的联机帮助。

在解包 Upfront之前，以预防不测请先备份目标环境的Upfront data store，然后修改规则文件，规则文件名称为UpfUnpackRules.txt，其决定用以解包Upfront data store的命令行实用工具UpfUnpack的行为。

在解包之后，如果需要，请修改 Upfront 显示主题、 Upfront 的 NewsItem 的 URL 和 Upfront 网关的 URL 。

备份Upfront Data Store

为预防不测，在你利用命令行实用工具 UpfUnpack解包源环境的Upfront data store前，请先使用命令行实用工具UpfDbAdm备份目标环境的data store，备份文件以一个二进制文件形式产生，以便以后用同样的命令恢复。

UpfDbAdm命令位于安装Upfront服务器程序的计算机的bin目录下，该备份命令的语法格式如下：

UpfDbAdm -b <文件名> [-q]

恢复命令的语法格式如下：

UpfDbAdm -r <文件名> [-q] [-p <旧口令> <新口令>]

各参数含义见下表：

参数	描述
-b	备份Upfront data store。
-r	恢复Upfront data store。
-q	以安静模式运行。该命令运行时在屏幕上不显示提示和状态信息。
-p	改变 Upfront data store的口令。该口令是Upfront访问Upfront data store时的内部口令。
-h	显示帮助信息。