IBM Cognos 最佳实践: IBM Cognos Express 9.5 疑难解答

文档性质:疑难解答;产品:IBM Cognos Express 9.5;关注领域:基础架构

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

简介

目的

本文档旨在帮助读者了解 IBM Cognos Express 是什么,如何工作,以及在哪里能够找到疑难解答信息。

适用范围

本文档适用于 IBM Cognos Express 9.5 版本。本文中所有对 IBM Cognos Express 的引用均只代表该版本。


IBM Cognos Express 是什么

IBM Cognos Express 是面向中型市场企业的 BI/PM 解决方案,使业务最终客户能够以自助方式进行报告、计划和分析。该套件易于安装/使用,并且只需要最少量的 IT 支持。

IBM Cognos Express 的主要理念是简单性,让最终用户易于安装,使他们能够立即开始分析。该套件中的一个简单软件包提供了所有必要软件模块,并加快安装和配置过程,从而实现该理念。

IBM Cognos Express 是以模块化方式构建的,能够让企业从任意位置开始,并随着他们的成长将模块添加到其基础架构。IBM Cognos Express 包括以下模块:

  • Express Manager
    一个非常简单、易用的界面,用于安装和配置 IBM Cognos Express 产品。
  • Express Xcelerator
    构建于 IBM Cognos TM1 技术之上,将规划和基于 Excel 的分析功能带给最终用户。
  • Express Reporter
    由 IBM Cognos Framework Manager、Report Studio 和 Query Studio 组成,提供自助报告及临时查询功能。
  • Express Advisor
    构建于 IBM Cognos Executive Viewer 之上,提供直观的建模和实时分析功能。
  • Express Planner
    基于 IBM Cognos TM1 Contributor,该工具提供了集中式规划,并允许用户制定以模板驱动的连续计划贡献。

IBM Cognos Express 架构

IBM Cognos Express 在逻辑上分为 3 层,如下图所示。在左侧是构成表示层 (Presentation Tier) 的客户端组件;可以在最终用户机器上安装或运行并能与 IBM Cognos Express 服务器组件通信的所有应用程序构成了该图中间部分的应用层 (Application Tier);最后,在图的右侧是数据层 (Data Tier),该层存储业务数据和 IBM Cognos 内容库。

下面的图表通过对每个可安装模块分配一种自己的颜色,说明了 IBM Cognos Express 的模块化构成。

表 1:IBM Cognos Express 产品模块及颜色
模块颜色
Express Core
Express Xcelerator绿
Express Advisor
Express Reporter
Express Planner
图 1:IBM Cognos Express 模块的高级图示
图 1: IBM Cognos Express 模块的高级图示

在上面的图表中,每个可安装的 IBM Cognos Express 产品模块以及每个产品模块所提供的相应组件的高层次概述,都各自以一种颜色表示。

在应用层中需要提到的第一个模块是以蓝色表示的 Express Core 模块。此模块包含了 IBM Cognos Express 安装成功后立即可用的所有组件。这些组件包括:

  • Informix Dynamic Server (IDS) 实例
  • IBM Cognos Analytic Server (ICAS)
  • Express Manager
  • 一个调度程序
  • Content Manager

调度程序、Content Manager 和 Express Manager 都是部署在内置 Tomcat Java Application Server 中的 Java servlet。该调度程序是 IBM Cognos Express 默认入口点,它负责根据请求类型将传入的请求派发给相应的服务。另一方面,Content Manager 是负责在 Content Store 中对 IBM Cognos Express 内容进行管理和存储的组件。除了上面的应用层组件外,它还提供 Data Advisor 和 Architect 建模工具,以实现表示层中的下载。

Express Core 正常运行后,就可以通过易用的 Express Manager Console(Express Manager 的图形用户界面)下载并安装表示层中所描述的其他 IBM Cognos Express 模块。

Content Store 是由 Content Manager 使用和管理的数据库,用于存储所有 IBM Cognos Express 内容,除了它以外,还有另一个 IBM Cognos Content Database 也被添加到 Informix 实例中。由 Express Manager 管理的 Express Store,包含受管理的数据源和用户的有关信息。IBM Cognos Content Manager 还使用 Express Store 作为其身份验证数据库,用于内置 Cognos Express 安全名称空间。

以红色为表示的第二个模块是 Express Reporter。添加此模块让您可以使用 Report Studio 和 Query Studio(位于表示层),并使 IBM Cognos Framework Manager 建模工具可供下载。除此以外,它还在 IBM Cognos Express 调度程序中增加了报告服务 (Report Service) 组件,该组件负责访问业务数据。

安装以绿色表示的 Express Xcelerator 模块,使您可以利用 Xcelerator Web 特性并使 Xcelerator Excel 客户端工具可供下载。这些表示层组件利用 ICAS 服务器组件来访问即将被分析和/或输入的数据。

以棕色表示的模块 Express Advisor 将 Advisor Web 客户端添加到表示层中的软件下载页面,并将 Advisor 服务器组件 EVServer 添加到应用层,使 Advisor 可以基于 ICAS 多维数据集创建分析视图。

最重要的是,以灰色表示的新添加的 Express Planner 模块,将 Planner 服务器组件作为一个 servlet 添加和部署到应用层中的 Tomcat Application Server。这也使得位于表示层的 Express Planner Administration 和 Express Planner Contributor 工具可供下载。


初始安装

IBM Cognos Express 9.5 安装过程的第一部分将在提供下列必需信息后开始:

  • 安装目标文件夹。
  • IBM Cognos Express Administrator 用户的密码。该用户帐户用于访问 IBM Cognos Express Manager。
  • icognosexpress Windows 用户帐户。该用户帐户用于连接到 IDS 资料库

在这个阶段中,将所有必要的文件复制到安装目标文件夹(在本文档中称之为 <cx_install_root>),并且创建用户帐户。对于 icognosexpress Windows 用户帐户,该过程将尝试确保该帐户的密码永不过期,因为帐户密码过期可能会导致 IBM Cognos Express 启动失败。如果安装程序无法删除密码过期,在名称为 IBM_Cognos_Express_InstallLog.log 的日志文件中将记录一条消息。

此过程创建了多个日志文件,若某项操作无法成功完成,您可以从这些日志文件中获得更详细的信息。这里有几个日志文件的示例,它们位于文件夹 <cx_install_root>\logs\express 中。在本文档中,此文件夹将被称为 "产品特定的日志文件夹"。

  • IBM_Cognos_Express_InstallLog.log
    此日志文件包含了详细的信息,例如,在安装过程和创建 IBM Cognos Express 目录结构过程中所使用的配置参数。
  • ids_install.log 和 ids.log
    这些文件提供了 Informix 安装过程中的成功或失败消息。
  • database_creation.log
    如文件名所示,这个文件包含 Content Store 和 Express Store 的创建中的状态消息。

所有文件都准备就绪并且 IBM Informix 数据库已建立后,最终用户会在 Internet 浏览器中看到提示,以完成安装过程的第二阶段。在这一阶段中,安装和配置 Express Manager、Authentication、Data Access 和 ICAS 模块。此外,Data Advisor 和 Architect 客户端工具也可供下载。

IBM Cognos Express 正常运行后,就可以在同一个文件夹找到该产品特定的日志。在稍后讨论每个 IBM Cognos Express 模块时,我们将更详细地对整个文件夹的内容进行介绍。


IBM Cognos Express Manager

概述

IBM Cognos Express Manager 是一个的简单用的界,用于安装和配置 IBM Cognos Express 模块。该 Java servlet 作为一个配置界面,使配置任务变得更加容易。

安装

可以在 Express Manager 中的 Event Messages 窗格内查看 IBM Cognos Express 模块的安装及其进度。此日志窗口中还包含在受管理数据源及用户的创建过程中所遇到的条目和错误消息。

位于产品特定的日志文件夹中的 ExpressDiagnostic.xml 文件提供了更详细的诊断信息。此文件主要包含,安装模块时发生的错误的完整堆栈跟踪,以及启动时所记录的信息性消息。

虽然这个文件已经包含了详细的信息,但其详细程度仍然可以提高。所捕获的信息量可以由位于 <cx_root_install>\bin 文件夹中的 CX.prop 文件进行控制。只需在这个文件的底部添加一行 LoggingLevel=ALL(如下所示),就可提高详细程度。

图 2:CX.prop 配置文件示例,显示 LoggingLevel 被设置为 ALL
图 2:CX.prop 配置文件示例,显示 LoggingLevel 被设置为 ALL

除了控制日志记录级别,CX.prop 文件也作为一个模块安装的配置文件。如上图所示,Express Manager 使用该文件包含的 DiscoveryPath 变量为某个特定的 Express 模块查找软件组件。

注意:对于 “SDK-ERR-0034: Unable to find Module ID: <Express Module>”“SDK-ERR-0001: Discovery Path <path> not found” 错误,您需要检查该文件的 DiscoveryPath 并验证其位置的有效性。

express\ 文件夹

位于 <cx_install_root> 下面的 express\ 文件夹包含若干个您需要了解的文件和位置,并且该文件夹能够帮助您对排除问题:

  • modules\
    该文件平包含在 IBM Cognos Express 中可用的所有低层模块。每个模块都有自己的文件夹,其中包含状态信息,显示它何时从哪里被安装。
  • models\
    该文件夹包含在 Express Manager 控制台中创建受管理数据源时由脚本播放器生成的 IBM Cognos Framework Manager 模块。
  • track\download\
    该文件夹包含有关哪个用户下载了哪个客户端软件以及是否成功下载的信息。
  • queue\
    该文件夹保存在 IBM Cognos Express 服务重启后将安装的所有模块的队列状态。
  • vers\ce_runtime-inst.ver
    该文件保存当前安装的 IBM Cognos Express 实例的版本号。
  • properties\systemproperties.xml
    该文件包含常规的 Express Manager 和产品模块配置设置。虽然不支持编辑此文件,并且该操作可能会导致意外行为,但它的确使您能够修改 IBM Cognos Express 备份的存储位置。

受管理的数据源

Express Manager 还可以让您轻松地创建关系数据包或 IBM Cognos TM1 多维数据集。

输入所有数据库信息后,Express Manager 将尝试使用程序 ./bin/udaxtest.exe 来验证有效性。这是一个内部驱动程序,它使用与 IBM Express Reporter 类似的逻辑来访问报告数据库。数据被验证并提交后,(1) Express Manager 将请求发送到 IBM Cognos Express 的调度程序,以创建在报告中进一步使用的 IBM Cognos 数据源的连接。此数据源在内容存储中成功保存后,(2) Express Manager 将启动 BMTScriptPlayer 应用程序来执行一个脚本,(3) 通过直接连接到数据源来进行元数据检索。收到元数据后,脚本将 (4) 建立模型/包,并通过调度将其发布到 IBM Cognos Connection,供您制作报告。

图 3:创建受管理数据源的流程图
图 3:创建受管理数据源的流程图

身份验证

IBM Cognos Express 默认启用两个安全名称空间。内置的 Cognos 名称空间以及 CognosExpress Custom Java Authentication Provider。除了这两个默认的名称空间,还可以激活一个可选的 Active Directory 名称空间。

  • Cognos
    这是内置的名称空间,它包含一组预定义的角色,用于将来自任何其他支持的名称空间的用户映射到特定的功能件。不能在此名称空间创建用户,因此它不可用于身份验证。
  • CognosExpress
    此名称空间是利用 IBM Cognos Java SDK 创建的 Custom Java Authentication Provider (CJAP),它是 IBM Cognos Express 中的默认身份验证形式。在 IBM Cognos Express Manager 中对其进行管理,其对象(用户)被存储在快速存储中。每当发生验证事件时,位于内容管理器中负责安全的组件 CAM,将通过 CJAP 查询此快速存储。
    此名称空间不支持单点登录 (SSO)。
  • Active Directory
    此外,还可以启用可选的 Active Directory 名称空间,将 IBM Cognos Express 集成到企业安全基础架构中。IBM Cognos Express 环境中的单点登录 (SSO) 只能使用该名称空间实现,因为只有它支持 Kerberos SSO。

Java 诊断

在 IBM Cognos Express 9.5 版本添加了 "诊断界面 (Diagnostics Interface)",使得在 Tomcat Java 实例上检索低层次的诊断信息更容易。以 IBM Cognos Express Administrator 身份登录后,在您的浏览器窗口输入以下 URI 可以找到该页面:
http://<express_server>:<express_port>/cognos_express/manager/diagnostics.html

图 4:IBM Cognos Express Diagnostics 页面
图 4:IBM Cognos Express Diagnostics 页面

如上图所示,该 Web 页面只是一个按钮的集合,它让您可以将以下信息转储到位于 <cx_install_root>/bin 文件夹中的一个文件。各按钮的标记如下:

  • Java Dump (javacore.<timestamp>.txt)
    包含有关 Java Memory Manager、锁定、线程和堆栈跟踪、类和类加载器的信息
  • Heap Dump (heapdump.<timestamp>.phd)
    这是在由运行中的 Java 所使用的 Java 堆上的所有对象的转储
  • Java System Dump (core.<timestamp>.dmp)
    正在运行的 JVM 的完整过程映像(内存转储)
  • Java Trace Snap (Snap.<timestamp>.trc)
    包含 JVM 的启动信息和一个活动线程列表

这些文件通常需要调查与 Java 组件(如 Express Manager、Planner Service 等)有关的性能和内存问题。

Cognos 配置

虽然可以单独通过 IBM Cognos Express Manager 配置 IBM Cognos Express,但 IBM Cognos Configuration 工具还是随产品一起交付。鉴于 IBM Cognos Express 对不同产品模块的集成方式的性质,IBM Cognos Configuration 工具应该只用于调整 Cognos Application Firewall (CAF) 的设置和 Java 堆大小配置。使用 IBM Cognos Configuration 修改任何其他配置应被视作不支持。


IBM Cognos Analytic Server (ICAS)

服务器组件日志

自 IBM Cognos Express 9.5 起,Xcelerator 模块的一部分已被移动(并重新命名)到 IBM Cognos Express 核心。更具体来说,Xcelerator Server 已被移动和重新命名为 IBM Cognos Analytic Server (ICAS)。

  • IBM Cognos Analytic Server Admin Service
    对在网络上运行的所有 ICAS 服务器保持跟踪
  • IBM Cognos Analytic Server – CXMD
    在启动时将数据库目录中的多维数据集、维度和系统信息加载到内存,处理多维数据集安全并维护一个变更日志

在默认情况下,这些组件的日志信息将在默认产品特定的日志文件夹中保存为下列文件:

  • tm1server.log
    IBM Cognos TM1 Server 消息日志
  • tm1s<timestamp>.log
    IBM Cognos TM1 Server 事务日志
  • TM1Process_xx_xx.log
    IBM Cognos TM1 流程错误日志

这些日志文件也可以通过 Server 菜单项下的 Xcelerator Architect Client 工具查看。

ICAS 启动时,服务器会在指定管理主机上运行的 ICAS Admin Server 上注册自己。ICAS Admin Server 为每个可用 ICAS 实例维护服务器名称、IP 地址、协议端口号。当服务器在 ICAS Admin Server 上注册自己时,此信息由 ICAS 实例提供。

然后,Xcelerator 客户端引用 ICAS Admin Server,以确定哪些 ICAS 服务器在网络上可用。在 IBM Cognos Express 的情况下,将引用 ICAS 实例。

必须先运行 ICAS Admin Server,才能启动 ICAS 服务器。如果您已经在 Tm1s.cfg 文件中指定了一个管理主机,服务器将尝试连接到该主机上的 ICAS Admin Server。如果有任何原因导致无法连接到 ICAS Admin Server,ICAS 服务器将无法启动。如果您没有指定管理主机,ICAS 服务器尝试连接到本地计算机上的 ICAS Admin Server。

客户端组件日志

客户端的安装日志在 <client_install_root>\logs 文件夹中提供。

客户端组件和 IBM Cognos Express 调度程序之间的通信使用 Integration Toolkit API。这个工具包的日志由位于 <client_install_root>\configuration 文件夹的 C8ITK.ini 配置文件控制。通过将 LogInfo、LogTrace、DiagnoseLogHTTP 变量修改为非零值,您可以启用这些特定的日志级别以及日志文件的位置。

除了在 <client_install_root> 中的文件, Xcelerator Client 还在以下目录中安装其 IBM Cognos TM1 Server 配置文件:

  • %USERPROFILE%\Application Data\Applix\TM1\tm1p.ini (Windows 2003)
  • %APPDATA%\Applix\TM1\tm1p.ini (Windows 2008)

如果客户端读取 IBM Cognos TM1 SSL 证书或联系 TM1 Server 时遇到问题,该文件是一个好的起点。


IBM Cognos Express Advisor

服务器组件日志

Express Advisor 的特性和功能利用 2 个主要的服务器组件,dataAdvisorServiceAdvisor Server

Advisor Server 组件 (EVServer.exe) 启动为 "IBM Cognos Express Advisor" Windows 服务,它负责为 Advisor Web Client 提供所有需要的数据,以显示视图。该服务器有两个主要的日志文件,可以帮助找到 Express Advisor 问题的根源,第一个是安装日志,第二个是操作日志。这两个文件都保存在产品特定的日志文件夹 <cx_install_root>\logs\express\。

  • AdvisorInstall.log - 安装日志
  • Advisor.<YYMMDD>.log - 操作日志

操作日志的详细程度和范围由位于 <cx_install_root>\bin 文件夹中的 EVServer.exe.config 文件控制。对于 IBM Cognos Express 的 64 位版本,这个文件可以在 <cx_install_root>\bin64 中找到。有关如何控制日志的级别和范围的更多信息,请参阅附录 A。

第二个服务器组件 dataAdvisorService 是 Express Core 的一部分,在初始安装之后可以使用,它作为 IBM Cognos Express 调度程序的一个插件运行。该服务负责检索业务数据,使用 Xcelerator TI API 创建 Xcelerator 多维数据集,创建包,等等。

用于此组件的日志工具是 IPF,使用附录 B 中列出的指示可以启用它。不必重新启动任何服务,因为变更将在 30 秒内应用。该服务将开始将信息记录到存储在 <cx_install_root>\logs\express 文件夹中的下列文件:

  • daTrace.log
    通用跟踪日志
  • daSVTrace.log
    dataAdvisorService 跟踪日志
  • daCPITrace.log
    DataAdvisorBIBusPlugin 跟踪日志(包括有关多维数据集版本的信息)
  • daCPIControllerTrace.log
    插件状态消息

客户端组件日志

可以在 <client_install_root>\logs 文件夹中验证 Data Advisor 客户端的安装。您可以在该文件夹中找到安装程序留下的日志文件。

疑难解答 "分析"

为了排除任何分析问题,我们首先需要熟悉它的高层次工作流。您在下面可以找到一个概述,显示在在不同的场景中单击 Analyze 按钮后数据将如何流动。

关系模型

自 IBM Cognos Express 9.5 起,Data Advisor 能够基于通过 ODBC 连接从数据库中检索的元数据模拟和发布关系模型。可以在第一次创建 Analysis Definition(一个描述数据源元数据的 XML 文档)时选择以关系方式建模的选项,并可以改变为维度 (Dimensional),也可以随时再改为关系型。

当新创建的 Analysis Definition 被赋予了名称,Data Advisor 会提示建模者选择在已安装 Data Advisor 的计算机上可用的任何一个 ODBC 连接。一旦确认,工具将通过 ODBC 连接导入元数据,并使建模者可以使用它。

当所需的建模步骤已经完成,并且单击 Create Model 按钮,Data Advisor 将根据您刚刚创建的 Analysis Definition 构建一个 Framework Manager 模型,并通过调度程序将它与数据源信息一起转发给 dataAdvisorService。然后,dataAdvisorService 将创建一个数据源连接(前缀为 CXA_)并在 IBM Cognos Connection 中公布该数据包。如果成功完成,调度程序会通知 Data Advisor 该数据包可以在 Query Studio 中打开。请注意,为了 Query Studio 能够成功地打开该数据包,在 IBM Cognos Express 服务器需要拥有一个 ODBC 数据源,此数据源与 Data Advisor 计算机上使用的相同。

图 5:在 Data Advisor 中发布关系模型的流程图
图 5:在 Data Advisor 中发布关系模型的流程图

维度模型(基于服务器)

为新创建的 Analysis Definition 赋予名称后,Data Advisor 会提示建模者选择在安装 Data Advisor 计算机上可用的任何一个 ODBC 连接。一旦确认,工具将通过 ODBC 连接导入元数据,并使建模者可以使用它。

简单来说,当单击 Create Cube 按钮时,Data Advisor 将其 Analysis Definition 和数据源连接信息发送到 dataAdvisorService,然后通过平面文件的现有 ODBC 连接来检索业务数据。然后,将这些文件中的数据放入处理数据的移动和转换的 ICAS 多维数据集脚本(Turbo Integrator 脚本)。如果该操作成功,数据包和默认的 Analysis(一种 Advisor Web Client 的报告规范类型)会被发布到 IBM Cognos Connection 以供消费。然后,调度程序通知 Data Advisor 该数据包可以在 Advisor 中打开。

图 6:在 Data Advisor 中分析基于服务器的维度模型
图 6:在 Data Advisor 中分析基于服务器的维度模型

维度模型(基于客户端)

通过 Client Based 的选项分析维度模型的过程与 Server Based 选项中所描述的过程非常相似。惟一不同的是,通过在客户端(而不是在服务器端)的 ODBC 连接检索所有业务数据,并通过调度程序将业务数据与 Analysis Definition 一起发送到 dataAdvisorServer。在那里,通过 Turbo Integrator 脚本解压数据,并将数据放入一个 ICAS 多维数据集。

以这种方式进行分析的好处是,不需要在服务器端设置 ODBC 连接,可减少管理工作。

图 7:在 Data Advisor 中分析基于客户端的维度模型
图 7:在 Data Advisor 中分析基于客户端的维度模型

Advisor(维度模型)

数据包被发布之后,通过调度程序和视图布局信息(无论是本地或远程)检索到的包可以被加载到 Advisor Web Client。然后,此客户端与 Advisor Server 通信,从先前创建的 ICAS 多维数据集获得数据(和视图信息)。

注意:这只适用于维度包。在关系包的情况下,使用 Express Reporter 而不是 Express Advisor。

图 8:打开 IBM Cognos Express Advisor Web
图 8:打开 IBM Cognos Express Advisor Web

Advisor 预加载

Advisor Server 服务器组件可配置为在启动时预加载多维数据集,从而改善在 Advisor Web Client 中的数据访问时间,并减少网络流量。然而,这意味着 Express Advisor Windows 服务将需要更长时间才能启动。

通过 Express Manager 可选择多维数据集预加载,在 Advisor 模块选项卡上单击 Configure 按钮即可。选中所需的多维数据集后,变更将被写入到位于 <cx_install_root>\bin 文件夹中的 EVServer.exe.preload.config 文件,Advisor Service 将在启动时读取该文件。

也可以使用以下 URI 确认预加载设置:
http://<cx_server>:<cx_port>/p2pd/servlet/dispatch/EVService?ui.action=getconfiguration


IBM Cognos Express Xcelerator

服务器组件日志

由于在 Express Core 增加了 ICAS 组件,现在的 Express Xcelerator 模块由以下两个组件组成:

  • IBM Cognos Express Web:这是一个 Microsoft .NET Web 应用程序,它使您能够创建 Web 表单,利用自助服务、读写及假设建模功能来分析大量复杂数据。
  • IBM Cognos Express Xcelerator Excel Service:这是一个 Windows 服务,它处理将 Excel 文件转换为 XML 格式的 IBM Cognos Xcelerator Web 请求。

当用户打开一个 Web 表格时,就会触发运行 Xcelerator Web 的 IIS Web 服务器,以调用 Excel Service 并将该 Web 表格的 Excel XLS 文件的名称和位置传递给该服务。这将在批处理模式/后台启动一个 Excel 会话,将 Excel XLS 文件渲染/转换成一个 XML 文件(它将打开 XLS 文件,并将其保存为 XML 文件)。

XLS 文件和 XML 文件的一个时间戳副本将被保存在 Xcelerator Web 目录 <cx_install_root>/Xcelerator/TM1WebEx/Excelsheet,而 Web 表格控制文件将被保存为 <cx_install_root>/Xcelerator/TM1WebEx/Excelsheet/ExcelReport.bin

Web 服务器将选取该 XML 文件,并将其渲染/转换成一个 HTML 页面,然后,该页面将被转发到 Xcelerator Web Client,并由该客户端显示。

提示:如果在此过程中发生了错误,那么,在 Microsoft Excel 中手动模拟此行为,可能有助于确定根源(如文件损坏)。只需在 Excel 中打开 Excel 中的 Web XLS 文件,并将其保存为 "XML 电子表格 2003 (*.xml)",以模拟 "Excel 至 XML" 的过程。

可以通过修改 <cx_install_root>\Xcelerator\bin\TM1ExcelService.exe.config 文件启用/修改 Xcelerator Excel Service 的日志。有关如何启用该日志的更多信息,请参阅附录 C。在附录 C 中为该操作所列出的步骤将启用 DEBUG 级别的日志,并将消息存储在 <cx_install_root>\Xcelerator\bin 中。对于 64 位的版本,这些文件的位置将是 <cx_install_root>\Xcelerator\bin64

附录 D 列出了启用在 <cx_install_root>\Xcelerator\TM1Web\log 文件夹中记录更详细 Xcelerator Web 组件信息所需要的步骤。

客户端组件日志

有关客户端软件日志的更多信息,请参阅标题为 "IBM Cognos Analytics Server" 部分中的 "客户端组件日志"。


IBM Cognos Express Planner

服务器组件日志

通过安装 Planner 模块为 IBM Cognos Express 带来的集中式规划功能,可以依靠以下两个服务器组件实现:

  • IBM Cognos Analytics Server (ICAS)
  • IBM Cognos Planner Service

本文已在前面讨论过 ICAS 组件的日志,所以我们将本章的重点放在 IBM Cognos Planner Service。

IBM Cognos Planner Service 本身是被部署到内置的 Apache Tomcat 应用服务器实例的另一个应用程序(类似于 IBM Cognos Express reporter 的一部分)。该应用程序本身是 Java Server Pages (JSP) 和 Java servlet 的一个集合,它负责用户界面和应用程序逻辑。这项服务可以通过以下 URL 的 Apache Tomcat 应用服务器来访问:
http://<cx_server>:<cx_port>/pmpsvc/

从 IBM Cognos Express Manager 内安装 Planner 模块不会生成任何其他日志文件。可以在 ExpressDiagnostics.xml 文件中跟踪安装过程所执行的操作(复制应用程序文件),在标题为 "IBM Cognos Express Manager" 一节中已介绍过该内容。

IBM Cognos Planner Service 的错误日志是默认启用的,并且将在 <cx_install_root>/webapps/pmpsvc/WEB-INF/logs/pmpsvc.log 文件中记录错误事件。如下所示,在这个文件中记录的信息量由位于 <cx_install_root>/webapps/pmpsvc/WEB-INF/configurationlog4j.properties 文件控制。请注意,提高日志记录的级别(如附录 E 中所述)将产生大量信息,并且不应该无限期保持该设置。

客户端组件日志

当您首次访问 IBM Cognos Express Planner 时,并不存在任何应用程序,因为还需要安装 IBM Cognos Express Planner Administration 客户端。要完成该操作,您需要单击 Design an Application 按钮,这会提示您安装 IBM Cognos Rich Client Framework (CognosRCP)。该框架安装完成并重新启动浏览器后,再次单击 Design an Application 按钮会启动该框架,以尝试下载并安装 IBM Cognos Express Planner Administration 客户端。

这些客户端组件将根据所使用的操作系统安装到以下文件夹:

  • %USERPROFILE%\Application Data\CognosRCP (Windows 2003)
  • %APPDATA%\CognosRCP (Windows 2008)

附录 F 中描述了从这些客户端组件提取更多信息的步骤。


IBM Cognos Express Repository

概述

IBM Cognos Express 使用一个预配置的、可按比例缩小的 Informix Dynamic Server (IDS) 实例作为其内容仓库 (Content Repository)。IDS 提供出色的可靠性、可扩展性、管理简易性、在线事务处理 (OLTP) 性能以及完整的应用程序开发选项。

这个数据库服务器将包含 Content Store、Express Manager Store,也可以用于部署 Express Samples。但样例应该只在该实例中作为概念证明进行部署,在同一数据库服务器上混合报告和内容存储,可能会导致在高峰期的性能下降。除了可能出现的性能下降之外,同样要注意的是,将业务数据部署到嵌入式 IDS 是违反许可协议的。

配置和日志点

如上所述,IBM Cognos Express 附带的 IDS 实例可按比例缩小并进行了预配置,符合 Express 哲学:简单性。安装程序将所有必需的二进制文件和配置文件复制到 <cx_install_root>/ids<cx_install_root>/ids_cs 文件夹。

IBM Cognos Express 安装完成后,IDS 实例就已注册为 Informix IDS - cm_ids_svr_custom Windows 服务。无需额外的配置更改,就能够使用该数据库服务器。

在服务启动时,IDS 实例会从 %ONCONFIG% 环境变量读取配置文件。此变量值由安装程序设置为 <cx_install_root>/ids/etc/ONCONFIG.cm_ids_svr_custom

可以在 <cx_install_root>/ids 文件夹中找到两个主要的 IDS 日志文件:

  • cm_ids_svr_custom.log
    此消息日志包含与 IDS 实例相关的状态消息和诊断消息。在默认 IDS 安装中,该文件的名称默认为 online.log。也可以使用 onstat 实用程序查看该文件的内容。
  • concm_ids_svr_custom.log
    这个控制台日志包含状态和诊断消息。在默认 IDS 安装中,该文件的名称默认为 console.log。

可以在 <cx_install_root>/ids_cs 文件夹中找到实际的数据库文件。

IDS 工具和命令

如果您需要检索 IDS 问题的疑难解答信息,下面的工具和命令列表可能对您有帮助。

注意:在尝试运行下面列出的任何工具/命令之前,要确保您已经根据您的环境设置了环境变量。为了您的方便,<cx_install_root>/ids/cm_ids_svr_custom.cmd 批处理脚本可以完成该操作。

第一个要介绍的工具位于 <cx_install_root>/ids/bin 文件夹的 dbaccess。此工具对 IDS 实例上的数据库提供命令行访问。只需执行 dbaccess.exe 并遵循控制台 UI 就可以使用这个工具。

图 9:dbaccess 工具的控制台 UI
图 9:dbaccess 工具的控制台 UI

此控制台只支持通过键盘交互,所以可能会觉得它有点麻烦。dbAccess 的另一个功能是可以使用脚本执行。使用竖线 (|) 和重定向符号(< 或 >),您就能够以批处理模式将 SQL 查询馈送给该工具。

下面再举几个示例,说明如何使用竖线和重定向符号提取上述信息:

echo connect to 'express';select * from 'icognosexpress'.expressusers | dbaccess
echo connect to 'express';select * from 
 'icognosexpress'.expressusers | dbaccess > users.txt 
echo connect to 'express' user 'icognosexpress';select * from expressusers | dbaccess
图 10:使用竖线将 SQL 语句从命令提示行馈送到 dbaccess 工具
图 10:使用竖线将 SQL 语句从命令提示行馈送到 dbaccess 工具

值得一提的第二个程序是在 <cx_install_root>/ids/bin/onstat.exe 中可以找到的 onstat。onstat 在特定命令执行时读取共享内存结构,并提供有关数据库服务器的统计数据。这个特殊的工具对于调试 IDS 和收集与数据库实例有关的环境信息非常有用。

  • onstat -g dis
    打印数据库服务器及其状态,以及每个数据库服务器的信息的清单。
  • onstat -g sql [<SessionID>]
    按会话 ID 打印 SQL 信息。如果会话 ID 被省略,则为每个会话打印一行摘要。
  • onstat -g all
    打印所有多线程信息。
  • onstat -a or onstat -cuskbtdlp
    收集配置、用户活动、锁定、缓冲区、表空间、数据库空间、日志信息、配置文件统计信息。
  • onstat -m
    显示最后 20 行系统消息日志(即使在脱机模式下也是如此)。

提示:如果要将输出重定向到一个文件,在 onstat 命令后加上 "> 文件名"。例如,onstat -a > onstatinfo.txt。

上面列出的选项只是使用 onstat 收集问题相关信息时可能需要提取的一小部分信息。如需完整的参考,请参阅 onstat 参考指南


附录 A:Advisor Server 日志

通过 <cx_install_root>\bin 文件夹下的 EVServer.exe.config 文件启用和配置 Advisor Server 组件的日志提供程序。对于 IBM Cognos Express 64 位版本,该文件可以在 <cx_install_root>\bin64 文件夹中找到。

如果需要提高日志级别,您可以打开该文件并按以下示例在 <logProviders> 小节中修改 logLevel 属性:

<logProviders>
	…
	<logLevelTable>
		<logLevels>
			<logLevel logLevel="Trace" category="*" component="*"/>
		</logLevels>
	</logLevelTable>
	…
</logProviders>

这会将所有类别/组件的日志级别设置为 Trace 并在 Express 特定的日志文件夹中存储其信息。下表中列出了已知的类别、组件和日志级别。

logLevel类别组件
SevereGeneralSecurityProviders.CAM
ErrorSessionServer
WarningSecurityDefault Command
InfoConfigurationLogProviders.XML
VerboseInternalErrorTM1
TraceUnsupportedTypeMDX
DebugParameterValidationContentStoreAccess
SOAPResponse
SOAPRequest
SOAPFaultResponse

保存更改后,需要重新启动 IBM Cognos Express Advisor 服务使修改生效。


附录 B:DataAdvisorService 日志

在 DataAdvisorService 组件中的日志基础架构使用基于 log4j 框架的 Indication Processing Facility (IPF)。

如果要把更详细的信息记录到文件中,只需在 <cx_install_root>/configuration 文件夹中找到 ipfDAclientconfig.xml.sample 文件,并将它重命名为 ipfclientconfig.xml

变更在 30 秒内就会生效,因此不必重新启动任何服务。该服务将开始把信息记录到存储在 <cx_install_root>\logs\express 文件夹中的下列文件:

  • daTrace.log
    通用跟踪日志
  • daSVTrace.log
    DataAdvisorService 跟踪日志
  • daCPITrace.log
    DataAdvisorBIBusPlugin 跟踪日志(包括有关多维数据集版本的信息)
  • daCPIControllerTrace.log
    插件状态消息

附录 C:Xcelerator Excel Service 日志

默认已配置 Xcelerator Excel Service 的日志,并旨在每天使用。为了提高日志信息的详细程度,打开 <cx_install_root>\Xcelerator\bin 文件夹中的 TM1ExcelService.exe.config 文件,并将其修改为类似于下面的代码段:

...
<root>
	<level value="DEBUG" />
	<appender-ref ref="LogFileAppender" />
</root>
<appender name="LogFileAppender" type="log4net.Appender.RollingFileAppender">
	<file value="tm1excelservice.log" />
	<appendToFile value="true" />
	<datePattern value="yyyyMMdd" />
	<rollingStyle value="Date" />
	<filter type="log4net.Filter.LevelRangeFilter">
		<acceptOnMatch value="true" />
		<levelMin value="DEBUG" />
		<levelMax value="FATAL" />
	</filter>
...
</appender>
...

保存修改后,需要重新启动 IBM Cognos Express Xcelerator Excel 服务,使修改生效。


附录 D:Xcelerator Web 日志

Xcelerator Web 日志的配置存储在 <cx_install_root>\Xcelerator\TM1Web\Web.config 文件中的日志属性部分。您可以编辑此文件中的属性来调整日志消息级别,如下所示:

...
<root>
	<level value="DEBUG" />
	<appender-ref ref="LogFileAppender" />
</root>
<appender name="LogFileAppender" type="log4net.Appender.RollingFileAppender">
	<file value="log\tm1web.log" />
	<appendToFile value="true" />
	<datePattern value="yyyyMMdd" />
	<rollingStyle value="Date" />
	...
</appender>
...

保存修改后,不需要重新启动 IBM Cognos Express Xcelerator Web,修改就可以生效。该修改将在 60 秒内自动生效。


附录 E:Planner Service 日志

通过以下操作,可以提高在 <cx_install_root>/webapps/pmpsvc/WEB-INF/logs 文件夹中记录的操作信息和函数调用的数量:

  1. 打开 <cx_install_root>/webapps/pmpsvc/WEB-INF/configuration/log4j.properties 文件。
  2. 做一个备份,使您能够轻松地还原变更。
  3. 找到以下代码行:
       log4j.logger.com.ibm.cognos=ERROR
       log4j.logger.com.cognos=ERROR
       log4j.logger.com.cognos.org=ERROR
  4. 提高日志级别,如下所示:
       log4j.logger.com.ibm.cognos=INFO
       log4j.logger.com.cognos=INFO
       log4j.logger.com.cognos.org=INFO
  5. 保存修改。

如果您对跟踪此服务器组件的性能更感兴趣,您可以删除一些注释标记 (#),如下所示。这将在专用于性能指标的 <cx_install_root>/webapps/pmpsvc/WEB-INF/logs 文件夹中创建另外两个日志文件。

  1. 打开 <cx_install_root>/webapps/pmpsvc/WEB-INF/configuration/log4j.properties 文件。
  2. 做一个备份,使您能够轻松地还原变更。
  3. 找到以下代码行:
       #log4j.rootlogger=ERROR, PerfConsole, perfText, perfXML
       #log4j.logger.com.ibm.cognos.perf=DEBUG
  4. 通过删除注释标记启用性能跟踪,如下所示:
       log4j.rootlogger=ERROR, PerfConsole, perfText, perfXML
       log4j.logger.com.ibm.cognos.perf=DEBUG
  5. 保存修改。不必重新启动 IBM Cognos Express Planner 服务,该修改就可以生效。该修改将在 60 秒内自动生效。

附录 F: Planner Client 日志

要启用 Planner Adminstration 工具的跟踪,请遵循以下所示的步骤。

  1. 打开 %APPDATA%\CognosRCP\rcp\defaultLog.properties 文件并进行备份。
  2. 找到以下代码行:
       #log4j.rootLogger=ERROR, appAppender
       #log4j.logger.com.cognos=ALL
       #log4j.logger.com.ibm.cognos=ALL
  3. 通过删除注释标记启用跟踪,如下所示:
       log4j.rootLogger=ERROR, appAppender
       log4j.logger.com.cognos=ALL
       log4j.logger.com.ibm.cognos=ALL
  4. 保存修改并重新启动 Planner Administration 工具。

详细信息将被记录在 %APPDATA%\CognosRCP\logs\ModellingADT_8.4.1 文件夹中。

在默认情况下,以 XML 格式记录事件,这可能会难于阅读。要以可读性更强的格式记录信息,请作出如下调整:

  1. 打开 %APPDATA%\CognosRCP\rcp\defaultLog.properties 文件。
  2. 在文件末尾找到以下代码行:
      log4j.appender.appAppender.layout=org.apache.log4j.xml.XMLLayout
  3. 修改该代码行,使它类似于下面的代码:
      log4j.appender.appAppender.layout=org.apache.log4j.PatternLayout
      log4j.appender.appAppender.layout.ConversationPattern=%d [%t] %-5p (%x) %c - %m%n
  4. 保存修改并重新启动 Planner Administration 工具。

可以通过编辑 cognosrcp.ini 文件跟踪和记录 IBM Cognos Rich Client Framework 的潜在问题,该文件位于 %APPDATA%\CognosRCP\rcp 文件夹,如下所示:

  1. 打开 cognosrcp.ini 文件并进行备份。
  2. 在文件末尾找到以下两个代码行:
       ;log=log.txt
       log.level=none
  3. 修改日志条目,使其类似于以下代码:
       log=c:\log.txt
       log.level=debug
  4. 保存修改并重新启动 Planner Administration 工具。

附录 G:IBM Cognos Express 9.5 简单说明

在下面的端口号中,"x" 应改为初始安装过程中所选择的范围。例如,19400-19409。

Express Manager
Windows 服务IBM Cognos Express
端口号Express Manager19x00
版本<cx_install_root>/express/vers/ce_runtime-inst.ver
Express Reporter
Windows 服务IBM Cognos Express
端口号Express 调度程序19x00
IPF 日志端口19x02
Tomcat 关闭端口19x03
客户端软件Framework Manager(胖客户端)
Report Studio(瘦客户端)
Query Studio(瘦客户端)
Express Planner
Windows 服务IBM Cognos Express
端口号Planner Service19x00
客户端软件Planner Administration
Planner Contributor(瘦客户端)
Express Xcelerator
Windows 服务IBM Cognos Analytic Server Admin Service
IBM Cognos Analytic Server - CXMD
IBM Cognos Express Xcelerator Excel Service
端口号ICAS Server 端口19x06
ICAS Server Client 消息端口19x07
客户端软件Architect(胖客户端)
Perspectives for MS Excel(胖客户端)
Xcelerator Web (瘦客户端)
Express Advisor
Windows 服务IBM Cognos Express Advisor
端口号Advisor 端口(由客户端使用)19x08
Advisor 内部端口19x09
客户端软件Data Advisor(胖客户端)
Advisor Web Client(瘦客户端)
Express Repository
Windows 服务Informix IDS Message Service
Informix IDS - cm_ids_svr_custom
端口号Informix SQLI 端口19x04
Informix DRDA 端口19x05

附录 H:有用的链接

参考资料

学习

获得产品和技术

讨论

  • 参与 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=810330
ArticleTitle=IBM Cognos 最佳实践: IBM Cognos Express 9.5 疑难解答
publish-date=06042012