IBM Cognos 最佳实践: 安装 FAP for IBM Cognos Controller 8.5

文档性质:指南;产品:IBM Cognos Controller 8.5 和 TM1 9.4;关注领域:财务管理

安装和配置 Financial Analytics Publisher 的指南。

Wayne Harper, 高级客户支持分析师, IBM

Wayne Harper 是 IBM Cognos Controller 的一名高级顾客支持分析师。Wayne 的专长是 IBM Cognos Controller 的文件导入规范、 结构和数据集市的导入。



2011 年 7 月 22 日

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

简介

目的

本文档是一个包含屏幕截图的指南,介绍如何安装 Financial Analytic Publisher (FAP) 供与 Controller 8.5 一同使用。

本文档假设在安装 Controller 的过程中使用的数据库是 Microsoft SQL Server 2005。

适用性

IBM Cognos Controller 8.5 和 TM1 9.4

例外与除外责任

在创建本文档之时没有例外和除外责任。


FAP 概述

FAP 目的

对 Controller 数据库所做的更改,不管是数据还是结构的,都被传递到临时 FAP 数据库。然后 FAP 服务将该关系型数据转换成一个 TM1 多维数据集。

图 1 显示来自 IBM Cognos Controller => FAP database => TM1 Cube 的数据。
图 1 显示来自 IBM Cognos Controller => FAP database => TM1 Cube 的数据

Controller 和 TM1 集成简介

Controller 和 TM1 集成

假设 Controller 8.5 和 TM1 均已安装。有关安装这些产品的完整细节,请查看以下文档:

安装 & 配置 IBM Cognos Controller 8.5 服务器

注意:Microsoft SQL Server 2000 不受支持且 FAP 不运作。使用 Microsoft SQL Server 2005 或 2008。

可以在这里找到受 Controller 8.5 支持的软件环境的完整细节:

http://www.ibm.com/support/docview.wss?uid=swg27017475


IBM Cognos Controller 安装

IBM Cognos Controller 安装步骤

在 IBM Cognos Controller 安装光盘上,从 win32 目录中选择 ‘issetup.exe’。以下画面出现:

图 2 显示 IBM Cognos Controller 的安装步骤
图 2 显示 IBM Cognos Controller 的安装步骤
  • 单击 Next > Agree > Next
  • 选择所需的安装位置(默认位置是:C:\Program Files\cognos\c8)
  • Component Selection 列表中选择 Financial Analytics Publisher
图 3 显示 Financial Analytics Publisher 的安装
图 3 显示 Financial Analytics Publisher 的安装
  • 单击 Next > Next > Finish

安装 FAP 客户端所在的 Java JRE 1.6

要安装 Java Runtime Environment (JRE) 1.6:

步骤 1:将相关文件复制到 FAP 客户端所在的同一服务器上

  • 作为管理员登录到 Controller 应用程序服务器
  • 找到文件夹 webcontent\ccr(默认位置:C:\Program Files\Cognos\c8\webcontent\ccr)
  • 将文件 jre.zip 复制到您希望安装 FAP 到其上的服务器
  • 创建一个文件夹 C:\Program Files\ibm\java60\
  • 将文件 jre.zip 提取到此文件夹

现在您应当拥有以下文件夹结构:
C:\Program Files\IBM\Java60\jre\bin
C:\Program Files\IBM\Java60\jre\lib

步骤 2:配置 ‘CCR_JAVA_Home’ 系统变量

  • 右键单击 My Computer 并选择 Properties
  • 单击 Advanced 选项卡
  • 单击 Environment Variables 按钮
  • 单击 System Variables 组中的 New 按钮
  • 输入 CCR_JAVA_Home 作为 Variable 名称
  • 输入路径 C:\Program Files\IBM\Java60\jre 作为 Variable 值(见下面的屏幕截图)
图 4 显示 JAVA 应用程序的配置
图 4 显示 JAVA 应用程序的配置

Java Driver 故障排除

如果您在使用 JAVA Driver 时遇到问题,那么可以参考下面的技术说明:

http://www.ibm.com/support/docview.wss?uid=swg21440254

注意:java 驱动不随 IBM Cognos Controller 一起安装,您需要下载驱动程序。

创建 FAP 数据库的步骤:

要让数据从 Controller 数据库传入 TM1 多维数据集,需要一个中间数据库。

步骤 1:创建一个新数据库

步骤 2:运行脚本来创建所需的表

在以下位置可找到所需的脚本 nrtr_createTables.sql(取决于使用的数据库类型)。

SQL Server
C:\Program Files\Cognos\c8\Server\FAP\SQL

or

Oracle
C:\Program Files\Cognos\c8\Server\FAP\Oracle

运行脚本之后,您应当会在数据库中看到以下表。

图 5 显示在 TM1 表中创建的 NRTR 表
图 5 显示在 TM1 表中创建的 NRTR 表

为 TM1 创建一个 ODBC 数据源

为 TM1 创建一个 ODBC 数据源,以便与 FAP 数据库通信。

必须在 TM1 服务器和指定的 FAP 上创建 ODBC 数据源。

创建 ODBC 数据源所需的步骤

注意:关系数据库的客户端软件必须安装在与创建 FAP ODBC 数据源和 TM1 服务器所在的同一台计算机上。

创建一个名为 FAP 的 New System DSN 数据源。

图 6 显示 ODBC 数据源的 DSN 配置
图 6 显示 ODBC 数据源的 DSN 配置

为 ‘步骤 5:创建一个 FAP 数据库’ 中创建的数据库选择登录凭据。

图 7 显示默认数据库更改
图 7 显示默认数据库更改

在 TM1 服务器上创建一个目录

在 TM1 服务器上创建一个目录

创建 TM1 FAP 目录,如同使用 ‘C:\TM1_FAP’ 目录的这个示例,但是可以选择任何目录。

图 8 显示 TM1_FAP 目录
图 8 显示 TM1_FAP 目录

将 tm1s.cfg 和 tm1s.lic 文件放在数据目录中

在 TM1 服务器上找到 tm1s.cfg 和 tm1s.lic 文件,并将它们复制到新创建的数据目录中。

在您最喜欢的文本编辑器中编辑 tm1s.cfg 文件来反映您的环境,例如:

[TM1S]
DataBaseDirectory= {Data Directory}
ServerName={Name of the TM1 server}
PortNumber={Port No must be unique for each TM1 server}
AdminHost={Physical Server}
Language=eng
Protocol=tcp

图 9 显示 tm1s.cfg 文件和需要修改的内容
图 9 显示 tm1s.cfg 文件和需要修改的内容

为了获得最佳效果,将 GroupsCreationLimit 至少设置为 1000(默认值是 20)。GroupsCreationLimit 的最大组数是 65535。

安装 TM1 Server as a Service

在安装 TM1 服务器时,会自动安装一个名为 TM1 Admin Server 的 TM1 服务器服务,这是 TM1 服务器的主 Windows 服务。此外,您必须安装一个独立的服务,以便能够从 TM1 多维数据集读写数据。

为了能够更新 TM1 数据集,两个服务都应当处于 Started 状态。

步骤

  1. 打开命令提示符。
  2. 输入命令 cd C:\Program Files\Cognos\TM1\bin 去往所需的目录(假设这是一个默认的 TM1 安装)。
  3. 输入命令 tm1sd.exe -install -n <tm1servername> -z <”data directory”>。其中 <tm1servername> 与 tm1s.cfg 文件中的 Servername 变量一样,且 <data directory> 是位置。

示例:

tm1sd.exe -install -n TM1_FAP -z ”C:\TM1_FAP”

图 10 显示命令提示符
图 10 显示命令提示符

成功创建服务后会显示 TM1 Server / tm1servername installed 这一消息。

Services 窗口中,启动新创建的 TM1 服务。

图 11 显示启动新 TM1 服务的需求
图 11 显示启动新 TM1 服务的需求

服务将在本地系统账户下运行。

图 12 显示登录设置
图 12 显示登录设置

安装 FAP 服务

创建一个目录来存储 TM1 Server Data Connection

在 TM1 服务器上,创建一个目录来存储新的 TM1 服务器数据。

步骤:

  1. 将文件复制到所需的位置。确保相关文件和文件夹都在您希望在其上安装 FAP 服务的服务器上。可在应用程序服务器上的 C:\Program Files\Cognos\c8\Server\FAP 目录中找到文件(假设默认安装)。
    图 13 显示 FAP 文件
    图 13 显示 FAP 文件
  2. 打开命令提示符。
  3. 输入以下命令(假设在默认位置安装 FAP)。
    cd C:\Program Files\Cognos\c8\Server\FAP
    另外选择 FAPNTService.exe、FAPService.properties、FAPServiceGlue.dll 文件和 lib 文件夹所在的目录。
  4. 输入以下命令来创建 FAP 服务 \WINDOWS\Microsoft.NET\Framework\v2.0.50727\installUtil.exe FAPNTService.exe。

Set Service Login 对话框中输入管理用户凭据。

图 14 显示登录信息
图 14 显示登录信息

您应当会在服务中看到 IBM Cognos FAP Service

图 15 IBM Cognos FAP 服务
图 15 IBM Cognos FAP 服务

要使用以下命令卸载 FAP 服务:

C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\installUtil.exe /u FAPNTService.exe

此时不要将服务作为 FAPService 启动。需要编辑 properties 文件来确保 FAP 服务可以连接到 FAP 数据库。

更新 FAPService.properties 文件

要确保 FAP 服务可以连接到 FAP 数据库,添加数据库的连接属性到 FAPService.Properties 文件。

db=<database name> (SQL Server) or <oracle sid> (Oracle)
host=<dns_to_the_FAP_database>
dbType=<oracle> or <sqlserver>
user=<username>
passwd=<password>

如果使用了 SQL 实例(例如 Server\Instance),FAPService 会失败。在这种情况下语法应当是 Server:Port Number。为在 “第 5 部分 - 创建一个 FAP 数据库” 中创建的数据库输入相关设置,例如:

db=WH_WHFAP
host=wbraharperw-xd:1738
dbType=sqlserver
user=fastnet
passwd=********

在更新 FAPService.Properties 文件之后,需要启动 IBM Cognos FAP 服务。

如果 FAPService.Properties 文件内包含的连接信息无效,FAPFatalError.log 文件会出现在 FAPNTService.exe 文件所在的目录中。

图 16 显示连接信息出现问题时创建的无效文件
图 16 显示连接信息出现问题时创建的无效文件

如果这个问题出现,您需要纠正 FAPService.Properties 文件。


安装 TM1 客户端

仅当 Financial Analytics Publisher 服务和 TM1 应用程序服务器在不同的服务器上时才需要该步骤。

在 Financial Analytics Publisher 服务器上安装 TM1 客户端的步骤

  • 从 TM1 安装光盘上双击 setup.exe 文件。
  • Choose Setup Language 对话框中选择 English 然后单击 OK
  • Notice to Customers Upgrading to TM1 9.4 对话框中单击 OK。
  • Welcome to the IBM Cognos TM1 Installation Wizard 窗口中单击 Next。
  • License Agreement 对话框中,选择 I accept the terms of the license agreement 并单击 Next。
  • 在 Choose a Product to Install 中,选择 TM1 Server and Client 选项,然后单击 Next。
  • 选择 TM1 Rules Editor requires Microsoft .NET Framework Manager Version 3.0 复选框并单击 OK。
  • 确保将 Install to 设置为 C:\Program Files\Cognos\TM1,将 Installation Type 设置为 Custom - Installation for multi-machine/multi-user configurations by IT or Administrator,然后单击 Next。
  • 确保 Component Selection 是。
  • 单击 Next 接受 TCP/IP 端口配置。
  • 输入用户名、密码,重新输入密码,然后单击 Next
  • 单击 Next 确认安全设置。
  • 单击 Next 确认 TM1 服务器配置。
  • 单击 。
  • 单击 Finish

为 TM1 客户端系统变量添加一个路径

  • 右键单击 My Computer,并选择 Properties
  • 单击 选项卡。
  • 单击 Environment Variables
  • System Variables 下面,选择 Path,并单击 Edit
  • Variable value 文本框中将 ;C:\Program Files\Cognos\TM1\bin 添加到值的末尾。
    图 17 显示如何为 TM1 客户端系统变量添加一个路径
    图 17 显示如何为 TM1 客户端系统变量添加一个路径
  • 对接下来的所有对话框单击 OK。

FAP 客户端设置

连接 FAP

打开 FAP 客户端。从 Start 菜单中单击 Programs > IBM Cognos 8 > IBM Cognos Controller > IBM Cognos 8 FAP。FAP Connect 对话框出现。

图 18 显示对 MS SQL Server 建立连接
图 18 显示对 MS SQL Server 建立连接

为在步骤 5 中创建的 FAP 数据库输入所需细节。

注意:在设置 FAP 时定义服务器的方式不一致。在 FAP 客户端应将 SQL Server 定义为 Server\Instance,而非 Server:Port,后者是面向 FAP 服务的。

图 19 显示数据库连接以及用户名和密码示例
图 19 显示数据库连接以及用户名和密码示例

单击 Log in

FAP 客户端设置

单击 Service Settings 选项卡。对于 Clock Interval 输入 15 秒,对于 Log file keep items for 输入 3 天,对于 Trickle tables purge every 输入 2 天。

图 20 显示 trickle 发布的时间设置
图 20 显示 trickle 发布的时间设置
  • 单击 Sources 选项卡。单击 New。
  • 为您的 IBM Cognos Controller 数据库添加连接细节,例如 -
    图 21 显示 IBM Cognos Controller 数据库连接的输入细节
    图 21 显示 IBM Cognos Controller 数据库连接的输入细节
  • 单击 Save。
  • 在 Sources 选项卡中会显示以下信息。
  • 单击 Start 激活 IBM Cognos Controller 源。
    图 22 显示启动 IBM Cognos Controller 数据源连接的需求
    图 22 显示启动 IBM Cognos Controller 数据源连接的需求
  • 单击 Data Marts 选项卡。
  • 单击 New 创建一个新的 Data Mart 连接。
    图 23 显示 FAP 数据集市连接
    图 23 显示 FAP 数据集市连接

设置信息:

Source:正如在 Source 选项卡中所定义的。

Log Level:提供的日志详细信息量。

Company Structure:要发布的公司结构的版本(Period 和 Consolidation 类型)。

Start Period/Actuality:您希望发布的 Period 和 Actuality。

Admin Host:TM1 服务器(Physical Box),可以定义为 DNS 名或 IP。

Server:TM1 服务器名(例如,tm1s.cf 文件中提供的服务器名称,参见第 8 部分了解详情)。

Client:TM1 用户名

Password:密码

  • 输入所需的设置之后单击 Save
    图 24 显示数据库设置
    图 24 显示数据库设置
  • 单击 Start 开始发布流程。

如果所有设置都正确,您会看到状态从 Ready 变为 Publish to Initial Publish 然后是 Running。如果发生任何错误,单击 Logs 选项卡获取更多信息。

注意:有可能会有多个数据集市,但是每个数据集市都有一个独特的 TM1 服务器要发布。


发布后的 TM1 数据

如果成功发布,您会在 TM1 服务器中看到以下对象。

图 25 显示 TM1 Architect 文件夹、tm1 连接信息,等等。
图 25 显示 TM1 Architect 文件夹、tm1 连接信息,等等。

其他源

在可靠实践站点上提供有其他文档。

  • Extended FAP for IBM Cognos Controller 8.5
  • Connect BI to Controller Datamart
  • Installing IBM Cognos Controller 8.5.1 with IBM BI 8.4.1

参考资料

学习

获得产品和技术

讨论

  • 参与 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=677174
ArticleTitle=IBM Cognos 最佳实践: 安装 FAP for IBM Cognos Controller 8.5
publish-date=07222011