IBM Cognos 最佳实践: IBM Cognos Planning Contributor Rich Client 故障排除

文档性质:故障排除;产品:IBM Cognos Planning 8.4+;关注领域:基础架构

本文介绍 Planning Rich Client 安装的故障排除技术。

Sarah MacIntosh, Accelerated Value Leader, IBM

Sarah MacIntosh 在过去 9 年内一直为 IBM Cognos 工作,专门负责客户支持和成功。她担任了 6 年支持分析师,负责支持 Series 7 套件、Finance 和 Enterprise planning 等产品。最近三年,她一直担任 Accelerated Value Leader,致力于建立客户关系和客户端成功案例。 



2011 年 7 月 22 日

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

简介

本文的目的是帮助 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 允许下载。
    Contributor 管理控制台 Web 客户端设置
    选择应用程序后,用户将被提示下载。有两个 .msi 文件安装到用户应用程序数据目录。例如 C:\Documents 和 Settings\MyUser1\application 数据。
  2. Contributor 管理员可以将 IBM Cognos Planning Client Install 放到一个可访问位置,允许个人访问。这是一个可执行文件,允许用户选择喜欢的安装类型(Classic 或 Client)。
    IBM Cognos 8 Planning 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 博客 并加入 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=677126
ArticleTitle=IBM Cognos 最佳实践: IBM Cognos Planning Contributor Rich Client 故障排除
publish-date=07222011