Powerplay服务器移植文档.docx

1、Powerplay服务器移植文档Powerplay Enterprise Server移植文档需要进行Powerplay Enterprise Server移植的若干种情况 Powerplay Enterprise Server 的移植是指将一台 Powerplay 服务器端的应用（源主机）完整地迁移到另一台服务器（目标主机）上，移植应该达到的结果是：用户访问目标主机和访问源主机完全等价，目标主机能脱离源主机独立工作，目标主机也应具有可移植性。有如下几种情况需要进行 Powerplay Enterprise Server 的移植：1从开发环境向生产环境搬迁，此时源主机是开发环境中的 Power

2、play Enterprise Server 主机，目标主机是生产环境中的 Powerplay Enterprise Server 主机。2Powerplay Enterpise Server 主机需要清空环境重新安装：此时源主机和目标主机是同一台机器，也就是自己向自己迁移。3制作备份环境：源主机是需要做备份的 Powerplay Enterprise Server 主机，而目标主机是承载备份的 Powerplay Enterprise Server 主机。建造可移植的 Powerplay Enterprise Server 应用一个好的 Powerplay Enterprise Server

3、 应用应当具有相当完善的可移植性，在系统移植后，仅须少量修改即可完全适应新的主机，为了达到这个效果，我们在开发 Powerplay Enterprise Server 应用时，应当注意以下几个要点：1完全一致的物理目录结构：Powerplay Enterprise Server 的主机上放置着所有的数据立方体和PPX报表，建议将这些立方体和 PPX 报表按照如下组织形式放入一个树型文件夹中： X:PPES_Application |_ Cubes |_ Reports其中 Cubes 目录中存放所有的数据立方体（*.mdc），而 Reports 目录中存放所有的 PPX 报表（*.ppx），它

4、们同在一个目录 PPES_Application 中。建议将放置它们的硬盘选择在 D: 或者 E:，因为移植过程需要 PPES_Application 目录的物理位置完全不能改变，而一般主机的 C: 盘都是系统盘，可能没有足够的空余空间来存放这些数据，而 D: 盘一般都是一个比较大的分区，所以把 PPES_Application 目录建在 D: 或者 E: 盘下，可以带来更好的适应性。千万不要把数据立方体和报表组织成这种形式： D:Reports存放一部分 PPX 报表 E:Cubes存放一部分数据立方体 D:xxxxxxxxxx.存放另一部分报表 这样混乱的组织在移植时会造成很大不便。 2和

5、Web 相关的内容放在 CognosCer1WebContent 下面：在实现 Powerplay Enterprise Server 应用时，经常会有用户修改Cognos界面、自己制作网页以补充 Powerplay Enterprise Server 的功能等类似的工作，将这些和 Web 相关的内容全部放在 CognosCer1WebContent 目录下面，可以使对这些内容的检索变得方便、统一。因为 CognosCer1WebContent 目录就是 Web Server 逻辑目录中的 http:/hostname/cognos 目录，所以该目录下的所有内容都可以通过 http:/host

6、name/cognos/xxxx.xxxx 的形式来得到。建议采用如下结构： CognosCer1WebContent |_accman | |_html | |_images |_upfront | |_html | |_images |_ppwb |_html |_images 3所有 URL 尽量采用相对路径： 所有网页或网页相关内容中，URL 尽量采用相对路径，如： /cognos/upfront/html/shouruchengben.html /cognos/ppwb/images/firsthit.jpg 等等，而不要写成： http:/hostname1/cognos/upfr

7、ont/aa.html 这样。移植过程（一）源主机准备工作 1创建移植目录：在源主机上创建一个类似 D:Move_020902_mis 的目录，写明移植日期和源主机名称，为移植和今后的追查工作创造便利。 2导出认证信息：认证信息是存储在 Access Manager/Directory Server 中的用户信息，包括用户名、用户ID、用户密码以及其他安全性信息。导出认证信息的方法是在 Access Manager 中用管理员登录，然后选定需要导出的名字空间（即NameSpace，一般是 default），用鼠标右键点击之，菜单中会出现“Export to LAE File”： 点击“Expo

8、rt to .LAE File”后，会弹出如下窗口： 点击“Add”按钮，会看到以下窗口：我们需要在“Name”中填写本次导出操作的命名，随便取一个字符串作为命名就行；“File Path”是指将导出的认证信息放到哪个文件中，我们可以指定像“D:Move_020902_misACC_020902.lae”这样的文件。至于“Ticket Server”页面，我们不用填写。必要信息填写妥当后，点击“确定”按钮，便会回到刚才的界面：选定刚刚定义的导出文件，点击“Export”，即可将认证信息导出。稍候片刻，程序就会弹出如下窗口报告导出结果，导出操作便告成功完成：我们获得的成果，就是被导出的 lae

9、文件，将其拷贝到移植目录中去。 3导出 Access Manager 界面： 将 CognosCer1accman 目录拷贝到移植目录中去。4导出所有 Web 内容： 将 CognosCer1WebContent 目录拷贝到移植目录中去。 5导出 Powerplay Enterprise Server 核心： 将 CognosCer1ppserverPPSRoot 目录拷贝到移植目录中去。 6导出 Cognos Upfront 内容：打开 CognosCer1bin 目录，找到 upfpack.exe 并运行之，会出现一个DOS 窗口，提示输入管理员用户名和密码，输入正确后，稍等片刻程序就会自

10、动结束，此时应当能在 CognosCer1bin 目录中找到一个名叫 UpfPackage.pkg 的文件，仔细核对它的创建日期，如果正确，将其拷贝到移植目录中去。 7检查保存数据立方体和 PPX 报表的目录是否正常： 看看保存立方体和 PPX 报表的目录中是否有异常，删除不必要的杂碎文件（如 Nimda 产生的 readme.eml 等等），准备迁移。移植过程（二）向目标主机迁移源主机经过如上准备工作，其移植目录中应该包含以下项目： 将这个移植目录原封不动地拷贝到目标主机上，至于通过网络邻居拷贝还是通过 ftp 等文件服务来拷贝，完全视当时情况而定。如果使用 ftp 进行拷贝，建议将这个移植

11、目录做成一个大压缩包，然后用二进制方式 ftp 到目标主机上，再解压缩即可。 拷贝完移植目录后，再把源主机上保存数据立方体和 PPX 报表的目录全部迁移到目标主机上，注意保持物理路径的一致性，比如说源主机上的 E:PPES_Application 目录，拷贝到目标主机上时也得是 E:PPES_Application，万一目标主机上的盘符没有到E:，则需打开命令行界面，执行以下目录映射命令（假设源主机上的 E:PPES_Application 目录被拷贝到了目标主机的 C:Another_DrivePPES_Application）： subst E: C:Another_Drive如果不再需要

12、这个虚拟的 E: 盘，则可以执行以下命令解除映射： subst E: /D 如果源主机上还有项目需要移植，比如说 JSP 页面、数据库连接等等，则参照相应的移植手册进行移植。移植过程（三）目标主机设置工作 1首先必须在目标主机上正确安装 Powerplay Enterprise Server，在 Access Manager 中指定好正确的目录服务器，并进行 Runtime Configuration。 2取消目标主机上 Powerplay Enterprise Server 的安全性：用 Powerplay Enterprise Server Administration 管理程序进入目标主

13、机的 Powerplay Enterprise Server，如果出现以下对话框： 则仅需回答“No”并立刻退出管理程序。如果没有出现上述对话框，则需要在菜单中的“Tools”-“Security”中选择“Remove Security”： 管理程序会让用户确认当前操作： 回答“Yes”即可，然后退出管理程序。 3取消目标主机上 Cognos Upfront 的安全性： 打开 Upfront Server Administration，选择连接到目标主机上： 在左侧窗口中，“Upfront”是指管理端，它下面挂着被管理的 Upfront 服务器的名称，即目标主机名称。用鼠标点中“Upfront

14、”，然后执行如下菜单命令：“Tools”-“Security”-“NewsIndex”-“Remove Security”“Tools”-“Security”-“Server Administration”-“Remove Security” 再用鼠标点中挂在“Upfront”下面的目标主机名，然后执行如下菜单命令：“Tools”-“Security”-“NewsIndex”-“Remove Security”“Tools”-“Security”-“Server Administration”-“Remove Security” 不用理会操作过程中弹出的若干对话框。 操作完成后，打开“控制面板

15、”-“管理工具”-“服务”，将所有以 Cognos 开头的服务都重新启动一遍： 4将源主机上的认证信息导入目标主机中： 打开目标主机上的 Access Manager Administration，用管理员登录后，选择目标主机的default名字空间，用鼠标右键点开菜单，选择“Import from .LAE File”： Access Manager会弹出如下窗口：点击“Add”按钮，在对话框中填写从源主机导出的 lae 文件名及其导出名称： 然后切换到“Ticket Server”页上，填写目标主机使用的 Ticket Server的信息： 点击“确定”按钮，即可回到最初页面：先点击一下导

16、入名称，“Namespace in the file”窗口中就会出现可用的名字空间，点击之，并选择“Options”中的“Empty the Target Namespace”选项，最后点击“Import”按钮，即可实现认证信息的导入。 5覆盖文件夹： 打开“控制面板”-“管理工具”-“服务”，将所有以 Cognos 开头的服务都停止： 然后从移植目录中拷贝以下文件夹覆盖目标主机的相应文件夹：accman - CognosCer1accman WebContent - CognosCer1WebContentPPSRoot - CognosCer1ppserverPPSRoot覆盖完成后，删除

17、 CognosCer1ppserver 目录下的 PPSRoot.cfx文件，打开“控制面板”-“管理工具”-“服务”，重新启动以 Cognos 开头的服务。 6恢复 Cognos Upfront：将移植目录中的 UpfPackage.pkg 文件拷贝（或覆盖）到目标主机的 CognosCer1bin目录中。 打开目标主机的 CognosCer1bin 目录，找到 upfunpack.exe 并运行之，会出现一个DOS 窗口，提示输入管理员用户名和密码，输入正确后，稍等片刻程序就会自动结束，Upfront 恢复工作即告完成。 7扫尾工作替换网关、更改报表指向和检查 Web 相关内容： 打开“控

18、制面板”-“管理工具”-“服务”，将所有以 Cognos 开头的服务都重新启动一遍。 打开 IE，以管理员（Administrator）登录到 Upfront 中，点击打开“Administration”文件夹，如果没有发现这个文件夹，则联系源系统的 Cognos 管理员，询问一下是否将这个文件夹改过名字。 这个文件夹中包含着三个项目，我们仅需要“NewsItem gateway manager”这个项目，将其点击开：在“找到此现有网关”对话框中填写： http:/源主机名称/cognos/cgi-bin/ppdscgi.exe在“替换为新网关”对话框中填写： http:/目标主机名称/cog

19、nos/cgi-bin/ppdscgi.exe 填写完成后，点击“确定”，即可完成网关替换操作。从源主机移植过来的所有 PPX 报表，其立方体指针均指向源主机，所以我们要把这些 PPX 报表文件的指针都改成指向目标主机。用 EditPlus 或类似文本编辑工具批量打开目标主机上的所有移植过来的 PPX 文件，将如下字串：Server=”源主机名称”替换为字串：Server=”目标主机名称” 批量修改完成后，保存文件。 移植过程的最后一步，就是检查 Web 相关内容是否有源主机的遗迹，这时应当把源主机从网络上断开，组织人力集中对目标主机进行测试，看看是否有超连接指向源主机，是否有报表到源主机去寻

20、找数据立方体，如果有，马上进行更正。移植过程中的常见问题及其解决方法 1移植后，目标主机的 Powerplay Enterprise Server Administration 或Upfront Server Administration 程序无法进入，登录后显示如下信息：遇到这种情况，是因为在向目标主机导入 Access Manager 认证信息之前，没有去掉 Powerplay Enterprise Server 和 Upfront 的安全性，造成 Powerplay Enterprise Server - Administration和 Upfront Server Administra

21、tion 认为认证来源已经被非法改变，遂启动保护措施，导致拒绝任何用户登录。解决这个问题需要使用文本编辑器修改cognoscer1ppserverPPSRoot.cfx文件。（1）在服务管理中停止“Cognos Powerplay Enterprise Server”（2）查找字符串“AdministratorsNameSpace” 会发现有：AdministratorsNameSpace=TX,default， 将其修改为：AdministratorsNameSpace=TX,（3）查找字符串“ACL” 会发现有：ACL=TX,914524418,0,-1（你本机的数字信息会与本例不同） 将

22、其修改为ACL=TX,（4）重新启动服务“Cognos Powerplay Enterprise Server”（5）运行Powerplay Enterprise Server Administration，会出现以下画面 选择“Yes”按钮即可重新完成本机的安全性设置。所以在移植过程中，一定要在向目标主机导入 Access Manager 认证信息之前去掉 Powerplay Enterprise Server 和 Upfront 的安全性！ 2移植后，目标主机的 Upfront 中出现了两个“Administration”文件夹，还出现了一些其他多余文件夹或项目：这是由于目标主机在移植前已经在 Upfront 中存储了一些信息，移植时并没有将这些信息删除，解决的办法就是用管理员登录 Upfront，手工将这些没用的东西删除即可。对于两个“Administration”文件夹，保留日期靠后的那一个即可，其余的删除。