简介

本文的目的是帮助 Cognos Contributor 管理员诊断并排除 8.4 Rich Client 安装故障。本文的内容涵盖安装选项，安装过程中可能遇到的问题，以及怎样从 IBM Cognos 支持部门获取帮助。

适用性

本文适用于使用 Enterprise Planning 8.4 或更高版本的 Cognos Contributor 管理员。所有 Planning Client 引用都是指 Rich Client。所有基于 ActiveX 的客户端的引用都是指 Planning Classic Client。

Rich Client 的优点

富客户端（我们的文档中称为 Java Based Client 安装）允许用户更自由地定制他们的 Contributor Web 视图。它更容易使用，同时还能保持以前的发布的功能。它的部署更加简便，因为客户端 PC 不再需要管理权限。

回页首

安装选项

可以通过多种方法下载 Rich Client。

1. 用户可以通过 web 访问 Contributor Planning 应用程序并下载。管理员必须通过以下方式允许下载：验证 Planning Store 的 System Requirements 允许下载。
   
   
   
   选择应用程序后，用户将被提示下载。有两个 .msi 文件安装到用户应用程序数据目录。例如 C:\Documents 和 Settings\MyUser1\application 数据。
2. Contributor 管理员可以将 IBM Cognos Planning Client Install 放到一个可访问位置，允许个人访问。这是一个可执行文件，允许用户选择喜欢的安装类型（Classic 或 Client）。
   
   
   
   
3. Contributor 管理员可以利用第三方安装程序将文件推到客户端 PC。使用第三方安装程序时，管理员需要先后安装 cognosrcp.msi 和 contributor.msi 文件。这些文件位于以下位置：<install location>:\cognos\c8\webcontent\rcp_installs 。

回页首

一般潜在问题

1. 要自行处理生成的错误消息，最好的资源是知识库（www.ibm.com/cognos/support）。
2. 使用受支持的浏览器很重要。要查看针对您产品的受支持浏览器列表，请访问： http://www.ibm.com/support/docview.wss?uid=swg27014782
3. IBM 不建议使用可信站点（本地内联网推荐）。下面这篇 “最佳实践” 文章引用了 Planning 8.4 Rich Client 的 SSL 设置：http://www.ibm.com//developerworks/data/library/cognos/security/financial_performance_management/page513.html
4. 要减少终端用户性能问题，以下文件需要从终端用户机器上的实时病毒扫描中排除：
   *.cogrcp
   cognosrcp.exe
   contributor.exe

常见错误

本节将强调安装过程中的常见错误并提供那些问题的解决方法。

首次访问应用程序时的错误

问题：用户在首次尝试下载 Rich Client 收到以下错误：[CCLMsg: system test="Failed to get remote model node. Check connection params, server state and user permissions"]

原因：在 Planning Store 的 System Requirements 中没有选中 Allow automatic downloads and installations。

用户不能保存

问题：试图保存时出现的错误。

  
‘|assertion failure
|	13!:8 errorlog coname$0
WHILE [CCLMsg: system test=’Invoking node action:  NODEACTION.SAVE’]
[checkReturnCode(JSession.java139) <- executeExpression(JSession.java68)]

原因：Persist setting 设置为 Server。尝试关闭它或将其设置为 Client。修改 Persist settings 的影响将反映用户 web 网格布局丢失方面的结果。最大的影响是客户端设置需要每位用户维护。更改发生在 Development/Application Maintenance/Admin Options 区域中的 Contributor Administration Console 中。

使用应用程序时生成的错误

问题：不一致的行为生成以下错误

	i.  A Java Runtime Environment (JRE) or Java Development Kit (JDK) must be 
available in order to run Contributor. No Java virtual machine was found after 
searching the following locations.
	X:\...\Application Data\CognosRCP\bin\jre\1.6.0\bin\Default.ee
	X:\...\Application Data\CognosRCP\bin\jre\1.6.0\bin\javaw.exe
	X:\...\Application Data\CognosRCP\bin\jre\1.6.0\bin\jvm.dll
	ii.  X:\...\features.xml (The system cannot fine the file specified)
	See log file for details:  
X:\...\CongosRCP\provagent_8.4\preovagent_8.4_<date>.log

原因：可能出现的错误是 Contributor Java 组件安装不正确。尝试将安装文件（cognosrcp.msi 和 contributor.msi）复制到用户的机器，然后运行 Cognos.MSI。查看 RCP 文件是否在用户的本地目录 /application data/cognosRCP 中。

防火墙/代理

可能出现这种情况：如果使用一个客户端防火墙，则 Cognosrcp 应用程序启动器可能会被封锁。确保 Permit all 设置被应用到 Cognosrcp 应用程序启动器。

为 IBM Cognos Support 创建一个 Testcase：

如果您已耗尽资源，比如技术说明（www.ibm.com/Cognos/support），需要咨询 IBM 技术支持，下面是提交技术支持请求之前需要考虑的项目列表：

不管是什么情况，IBM Cognos 支持都需要以下信息，以便处理最初提出的问题。

1. 清晰简洁的问题描述。问题的历史，问题出现了多长时间？环境中有事物发生改变吗？这个问题对所有用户都出现吗？问题是间歇性的还是总是发生？
2. 终端用户在浏览器中看到的错误消息（最好有屏幕截图）。
3. 根据技术支持请求，提供拓扑中所有服务器的 Program Files\cognos8\cmplst.txt 文件副本。
4. 生成的任何日志。下一节将介绍日志。

回页首

日志

日志消息在许多地方捕获。下面是生成支持请求时需要的典型日志文件及其位置。终端用户在线生成的错误在以下文件中捕获：

Planningerrorlog.csv

Planningerrorlog.csv 是 Planning error 过程中写入的主要日志。这个日志将位于所有 Application Tier 并且可能位于所有客户端 Planning 机器上。

1. web 服务器 — 生成这个文件的位置可能是服务帐户的本地临时目录或服务器临时目录。
2. 客户端的 PC — 用户帐户的临时和本地临时目录。

CognosRCPLogCollector.cogrcp

CognosRCPLogCollector.cogrcp 工具将收集 Rich Client 生成的所有日志并将它们存储为一个 zip 文件。重要的是要注意，CognosRCPLogCollector.cogrcp 不基于日期过滤，因此旧日志也会被收集。

导航到 c:\documents and settings\<user ID>\application data\cognosrcp\rcp 并双击 CognosRCPLogCollector.cogrcp。当收集完成时，没有任何可见进度条或注释告知用户，因此应该查看 Microsoft Windows 临时目录，寻找已完成文件。一个名为 CognosRCPLogCollector-DateTimestamp.zip 的文件将被创建。这是来自用户机器的、关于 Planning Rich Client 的所有日志的集合。确保这个日志文件集合被附加到 PMR。

JCE.tmp

如果您遇到一个 Java 计算问题，那么将有一个 JCE.tmp 文件生成。这个错误在 planningerrorlog.csv 中被引用。这个 JCE 文件的命名惯例遵循 JCE###.tmp 模式。引用的具体数字将在 planningerrorlog.csv 中注明。

参考资料

学习

• 通过 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、群组、联系、共享和协作等社区功能的专业社交网络社区。
  
  

关于作者

为本文评分

评论

回页首

内容

• 简介
• 安装选项
• 一般潜在问题
• 日志
• 参考资料
• 关于作者
• 评论