IBM Planning Analytics バージョン...

IBM Planning Analyticsバージョン 2.0.0

Planning Analytics のインストールおよび設定

��

注記本書および本書で紹介する製品をご使用になる前に、 431ページの『特記事項』に記載されている情報をお読みください。

この資料は IBM Planning Analytics バージョン 2.0.0 を対象として作成されています。また、その後のリリースも対象となる場合があります。

お客様の環境によっては、資料中の円記号がバックスラッシュと表示されたり、バックスラッシュが円記号と表示されたりする場合があります。

　

原典： IBM Planning Analytics

Version 2.0.0

Planning Analytics Installation and Configuration

発行：日本アイ・ビー・エム株式会社

担当：トランスレーション・サービス・センター

Licensed Materials - Property of IBM

© Copyright IBM Corporation 2007, 2017.

目次

概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii

第 1 章新機能 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1Planning Analytics バージョン 2.0.0 のインストールと設定に関する新機能. . . . . . . . . . . . . . . 1デフォルトのアプリケーション・サーバーは WebSphere Liberty Profile . . . . . . . . . . . . . . . 1TM1 サーバーのインストール・ウィザードの選択可能なコンポーネントについての変更 . . . . . . . . . 1

第 2 章 Planning Analytics のインストールの計画 . . . . . . . . . . . . . . . . . 3使用可能なインストール・プログラム . . . . . . . . . . . . . . . . . . . . . . . . . . . 3利用可能なコンポーネント . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

TM1 データ層のインストール・コンポーネント . . . . . . . . . . . . . . . . . . . . . . 6TM1 Web 層のインストール・コンポーネント . . . . . . . . . . . . . . . . . . . . . . . 7TM1 リッチ層のインストール・コンポーネント . . . . . . . . . . . . . . . . . . . . . . 9翻訳されたドキュメントのインストール・コンポーネント . . . . . . . . . . . . . . . . . . . 11リストされないその他のインストール・コンポーネント . . . . . . . . . . . . . . . . . . . 12

TM1 クライアントの区別 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12エンド・ユーザー・クライアント . . . . . . . . . . . . . . . . . . . . . . . . . . . 13管理クライアント . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

ソフトウェア要件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16デフォルト・インストール値 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16構成の概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Cognos Configuration と Cognos TM1 . . . . . . . . . . . . . . . . . . . . . . . . . . 19Cognos TM1 の設定ファイルおよび設定パラメーター . . . . . . . . . . . . . . . . . . . . 20

Windows で Cognos TM1 サービスを実行するためのユーザー・アカウント . . . . . . . . . . . . . . 21ドメインなしのネットワーク上での TM1 のインストール . . . . . . . . . . . . . . . . . . . . 22ローカル・マシン構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

第 3 章アーキテクチャー . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23Cognos TM1 アーキテクチャー . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Cognos TM1 管理サーバーの概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . 24Cognos TM1 サーバーの概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25Cognos TM1 ファイルの概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26データ・ディレクトリーの概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Cognos TM1 Web アーキテクチャー . . . . . . . . . . . . . . . . . . . . . . . . . . . 29Cognos TM1 Web からの複数の Cognos TM1 サーバーへのアクセス . . . . . . . . . . . . . . . 31Cognos TM1 Web からのアクセスを 1 つの Cognos TM1 サーバーに限定する方法 . . . . . . . . . . 31

Cognos TM1 Applications のアーキテクチャー . . . . . . . . . . . . . . . . . . . . . . . . 32Cognos TM1 Applications 層 1: Web クライアント . . . . . . . . . . . . . . . . . . . . . 33Cognos TM1 Applications 層 2: Web サーバー . . . . . . . . . . . . . . . . . . . . . . . 34Cognos TM1 Applications 層 3: データ . . . . . . . . . . . . . . . . . . . . . . . . . 35

第 4 章配布 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371 台の Windows コンピューターへの Cognos TM1 の配布 . . . . . . . . . . . . . . . . . . . 37Cognos TM1 管理サーバーと TM1 サーバーの配布 . . . . . . . . . . . . . . . . . . . . . . 38Cognos TM1 Web の配布 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39Cognos TM1 Applications の配布 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

Cognos TM1 Applications を使用する際のセキュリティーの考慮事項 . . . . . . . . . . . . . . . 401 台のコンピューター上へのすべての Cognos TM1 Applications コンポーネントの配布 . . . . . . . . . 41別個のコンピューター上への各 Cognos TM1 Applications コンポーネントの配布 . . . . . . . . . . . 42

Cognos TM1 クライアント・アプリケーションの配布 . . . . . . . . . . . . . . . . . . . . . 43

© Copyright IBM Corp. 2007, 2017 iii

第 5 章アップグレード . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45アップグレードの計画 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46Planning Analytics バージョン 2.0.0 からのアップグレード . . . . . . . . . . . . . . . . . . . 48Planning Analytics for Microsoft Excel のアップグレード . . . . . . . . . . . . . . . . . . . . 48Cognos TM1 バージョン 10.2.x からのアップグレード . . . . . . . . . . . . . . . . . . . . . 49Cognos TM1 バージョン 10.1.x からのアップグレード . . . . . . . . . . . . . . . . . . . . . 50Cognos TM1 バージョン 9.x からのアップグレード . . . . . . . . . . . . . . . . . . . . . . 51アップグレードの前の Cognos TM1 9.x サービスの停止 . . . . . . . . . . . . . . . . . . . 52以前のバージョンの Cognos TM1 9.x のデータのバックアップ . . . . . . . . . . . . . . . . . 52以前のバージョンの IBM Cognos TM1 9.x のアンインストール . . . . . . . . . . . . . . . . . 54Cognos TM1 の単一コンピューターでのインストールのアップグレード . . . . . . . . . . . . . . 55UNIX または Linux での Cognos TM1 サーバーのアップグレード . . . . . . . . . . . . . . . . 55Windows での Cognos TM1 サーバーのアップグレード. . . . . . . . . . . . . . . . . . . . 56Cognos TM1 Architect クライアントと Cognos TM1 Perspectives クライアントのアップグレード . . . . . . 56Cognos TM1 Web のアップグレード . . . . . . . . . . . . . . . . . . . . . . . . . . 56Cognos TM1 Contributor から Cognos TM1 Applications へのアップグレード . . . . . . . . . . . . 57Cognos TM1 バージョン 9.x のデータと設定ファイルの現行バージョンへの復元 . . . . . . . . . . . 60

Microsoft Excel .xls ワークシート . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62Cognos TM1 Application をインポートまたは復元する際のセキュリティー権限の保存 . . . . . . . . . . 62

第 6 章 Planning Analytics と IBM Cognos ソフトウェアの統合. . . . . . . . . . . 65Planning Analytics と Cognos Analytics のセキュリティー . . . . . . . . . . . . . . . . . . . . 66Cognos TM1 Package Connector を使用して Cognos Analytics データを Cognos TM1 にインポートする . . . . 67

Cognos TM1 Package Connector のインストール . . . . . . . . . . . . . . . . . . . . . . 67Cognos Analytics のデータ・ソースとしての Cognos TM1 . . . . . . . . . . . . . . . . . . . . 72

Cognos TM1 データ・ソースに基づく Cognos Analytics レポート作成を可能にする . . . . . . . . . . 72Cognos TM1 iWidgets and Cognos Workspace . . . . . . . . . . . . . . . . . . . . . . . . 73Cognos TM1 アプリケーションと Cognos Analytics および Cognos Connection ポータルの統合 . . . . . . . 74

第 7 章 Planning Analytics の単一コンピューター・インストール. . . . . . . . . . . 75前提ソフトウェアのインストール . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76基本 Cognos TM1 コンポーネントのインストール . . . . . . . . . . . . . . . . . . . . . . 76Cognos Configuration による Cognos TM1 コンポーネントの開始 . . . . . . . . . . . . . . . . . 77Cognos TM1 Perspectives の実行 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79Cognos TM1 Architect の実行 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79Cognos TM1 Web の実行 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80Cognos TM1 Application Web の実行 . . . . . . . . . . . . . . . . . . . . . . . . . . . 80Cognos TM1 Performance Modeler の実行 . . . . . . . . . . . . . . . . . . . . . . . . . 81Cognos Insight の実行 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81Cognos TM1 Application Web の使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . 82その他の Cognos TM1 コンポーネント . . . . . . . . . . . . . . . . . . . . . . . . . . 83Cognos TM1 のデータを PDF 形式でエクスポートするようにクライアント・コンピューターを設定する . . . . 84

第 8 章 Cognos TM1 サーバーのインストール . . . . . . . . . . . . . . . . . . . 85Windows での Cognos TM1 サーバーのインストール . . . . . . . . . . . . . . . . . . . . . 85

Cognos TM1 サーバーのコンポーネントのインストール (Windows) . . . . . . . . . . . . . . . . 86Cognos Configuration を使用した Windows での Cognos TM1 サーバーの始動 . . . . . . . . . . . . 86Windows で特定のユーザー・アカウントとして Cognos TM1 サービスを実行するための変更 . . . . . . . 87

UNIX または Linux での Cognos TM1 サーバーのインストール . . . . . . . . . . . . . . . . . 89UNIX または Linux オペレーティング・システムでの Cognos TM1 サーバーのコンポーネントのインストール 89IBM AIX での Cognos TM1 の実行 . . . . . . . . . . . . . . . . . . . . . . . . . . 92UNIX および Windows システム上の Cognos TM1 サーバー用の Cognos TM1 オブジェクト名と文字エンコード . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

Cognos TM1 言語設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95Cognos TM1 言語コード . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96Cognos TM1 サーバーの言語の設定 . . . . . . . . . . . . . . . . . . . . . . . . . . 97

iv インストールおよび設定

Windows での Cognos TM1 クライアントの言語の設定. . . . . . . . . . . . . . . . . . . . 98Cognos TM1 Web の Web ブラウザー言語の設定 . . . . . . . . . . . . . . . . . . . . . 98

Cognos Configuration による空の新規 Cognos TM1 サーバーの作成. . . . . . . . . . . . . . . . . 99既存の Cognos TM1 サーバーの Cognos Configuration への追加 . . . . . . . . . . . . . . . . . 100Cognos TM1 管理ホストの場所の指定 . . . . . . . . . . . . . . . . . . . . . . . . . . 101複数の Cognos TM1 管理ホストの指定 . . . . . . . . . . . . . . . . . . . . . . . . . . 102Advanced Cognos TM1 管理サーバーおよび Cognos TM1 サーバーの設定 . . . . . . . . . . . . . . 102

Cognos TM1 管理サーバーのデフォルト・ポート番号の変更. . . . . . . . . . . . . . . . . . 102IPv6 を使用するための Cognos TM1 の設定 . . . . . . . . . . . . . . . . . . . . . . . 103

TM1 サーバー・ライセンスの使用状況のモニター . . . . . . . . . . . . . . . . . . . . . . 105

第 9 章 Cognos TM1 Operations Console のインストール. . . . . . . . . . . . . 107付属の WebSphere Liberty Web サーバー・ソフトウェアを使用する場合の Cognos TM1 Operations Console のインストール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107Cognos Configuration を使用した Cognos TM1 Operations Console の配置 . . . . . . . . . . . . . . 108Cognos TM1 Operations Console の高度なインストール . . . . . . . . . . . . . . . . . . . . 108別マシンへの Cognos TM1 Operations Console のインストール . . . . . . . . . . . . . . . . . 109Apache Tomcat Web アプリケーション・サーバーの独自インストールを使った Cognos TM1 OperationsConsole のインストール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109IBM WebSphere への Cognos TM1 Operations Console のインストール . . . . . . . . . . . . . . 111

Cognos TM1 Operations Console の設定. . . . . . . . . . . . . . . . . . . . . . . . . . 115Cognos TM1 Operations Console の開始およびログイン . . . . . . . . . . . . . . . . . . . . 116

第 10 章 Cognos TM1 Web のインストール . . . . . . . . . . . . . . . . . . . 117付属の WebSphere Liberty アプリケーション・サーバーを使用する場合の TM1 Web のインストール . . . . . 118

Cognos TM1 Web の Microsoft Windows でのインストールおよび設定 . . . . . . . . . . . . . . 118Cognos TM1 Web の UNIX でのインストールおよび設定 . . . . . . . . . . . . . . . . . . 120

IBM WebSphere を使用する TM1 Web のインストール . . . . . . . . . . . . . . . . . . . . 121IBM WebSphere アプリケーション・サーバーへの TM1 Web の配置 . . . . . . . . . . . . . . . 122TM1 Web 用の SSL 証明書のインポート . . . . . . . . . . . . . . . . . . . . . . . . 123

Cognos TM1 Web 構成パラメーターの変更 . . . . . . . . . . . . . . . . . . . . . . . . 124Cognos TM1 Web 構成パラメーター . . . . . . . . . . . . . . . . . . . . . . . . . 125Cognos TM1 Web 設定ファイルの編集 . . . . . . . . . . . . . . . . . . . . . . . . . 131AdminHostName パラメーターおよび TM1ServerName パラメーターを使用した Cognos TM1 Web ログイン・ページの設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132IBM Cognos TM1 Web のカスタム・ホーム・ページの設定 . . . . . . . . . . . . . . . . . . 133IBM Cognos TM1 Web のスタートアップと外観の設定 . . . . . . . . . . . . . . . . . . . 139Cube Viewer のページ・サイズの変更 . . . . . . . . . . . . . . . . . . . . . . . . . 142Cube Viewer からエクスポートする最大シート数の設定 . . . . . . . . . . . . . . . . . . . 142キューブ・ビューにおける文字列値の折り返し . . . . . . . . . . . . . . . . . . . . . . 142

TM1 Web セッションのタイムアウトの設定 . . . . . . . . . . . . . . . . . . . . . . . . 143Cognos TM1 Web の Web ブラウザー設定 . . . . . . . . . . . . . . . . . . . . . . . . 144

Cognos TM1 Web の Web ブラウザー言語の設定 . . . . . . . . . . . . . . . . . . . . . 144地域の設定に基づいた Cognos TM1 Web での数字の表示と入力 . . . . . . . . . . . . . . . . 144Cognos TM1 Web に対する Internet Explorer の設定 . . . . . . . . . . . . . . . . . . . . 145Cognos TM1 Web の WAN サーバーでの実行と Excel ファイルおよび PDF ファイルのエクスポート . . . 145

第 11 章 Cognos TM1 アプリケーション・サーバーのインストール . . . . . . . . . 147付属の WebSphere Liberty Profile を使用する場合の Cognos TM1 アプリケーション・サーバーのインストール 148

Cognos TM1 Web 層のコンポーネントのインストール . . . . . . . . . . . . . . . . . . . 148付属の WebSphere Liberty Profile アプリケーション・サーバーでの Cognos TM1 アプリケーション・サーバーの配布 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149Cognos TM1 Application Web の認証セキュリティーの設定 . . . . . . . . . . . . . . . . . . 150Cognos TM1 Application Web のサーバーおよびクライアント環境の設定 . . . . . . . . . . . . . 151Cognos Configuration における Cognos TM1 アプリケーション・サーバーの設定 . . . . . . . . . . . 153

Cognos TM1 Application Web の URL 起動リンクを判別する . . . . . . . . . . . . . . . . . . 154

目次 v

Cognos TM1 Application Web と協働するための Cognos TM1 サーバーの設定 . . . . . . . . . . . . 155IBM Cognos TM1 Application Web の構成. . . . . . . . . . . . . . . . . . . . . . . . . 156Cognos TM1 アプリケーション・サーバーのログ記録 . . . . . . . . . . . . . . . . . . . . . 157Cognos TM1 アプリケーション・サーバーの拡張インストールと設定. . . . . . . . . . . . . . . . 159

Apache Tomcat Web アプリケーション・サーバーの独自インストールとの Cognos TM1 アプリケーション・サーバーのインストール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159独自の IBM Websphere インストール済み環境を使用する場合の Cognos TM1 アプリケーション・サーバーのインストール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163複数の Cognos TM1 サーバーを使用するように Cognos TM1 Application Web を設定する . . . . . . . 170プロキシーの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171Insight での Cognos TM1 TurboIntegrator 関数のセキュリティーの設定 . . . . . . . . . . . . . . 175

第 12 章 Planning Analytics Workspace installation . . . . . . . . . . . . . . . 179Planning Analytics Workspace architecture . . . . . . . . . . . . . . . . . . . . . . . . . 179Planning Analytics Workspace installation overview . . . . . . . . . . . . . . . . . . . . . . 180

Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180Installing Docker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181Installing Planning Analytics Workspace . . . . . . . . . . . . . . . . . . . . . . . . . 181Connecting Planning Analytics Workspace to Cognos TM1 and authentication servers . . . . . . . . . . 182Checking the status of the services . . . . . . . . . . . . . . . . . . . . . . . . . . 184Planning Analytics Workspace and Cognos TM1 installed on one computer . . . . . . . . . . . . . 184Configuring SSL for Planning Analytics Workspace . . . . . . . . . . . . . . . . . . . . . 184Planning Analytics Workspace と他のサーバーとの間の SSL の設定 . . . . . . . . . . . . . . . 186Configuring a Linux virtual machine to start automatically . . . . . . . . . . . . . . . . . . . 186

第 13 章 Administer Planning Analytics Workspace . . . . . . . . . . . . . . . 187Viewing logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187Accessing the Planning Analytics Workspace Administration Tool remotely . . . . . . . . . . . . . . . 187Users in Planning Analytics Workspace . . . . . . . . . . . . . . . . . . . . . . . . . . 188Backing up or restoring Planning Analytics Workspace . . . . . . . . . . . . . . . . . . . . . 188Upgrading Planning Analytics Workspace. . . . . . . . . . . . . . . . . . . . . . . . . . 189Uninstalling Planning Analytics Workspace . . . . . . . . . . . . . . . . . . . . . . . . . 189

第 14 章 TM1 リッチ層のインストール . . . . . . . . . . . . . . . . . . . . . . 191Cognos TM1 Perspectives のインストール . . . . . . . . . . . . . . . . . . . . . . . . . 191Cognos TM1 Architect のインストール . . . . . . . . . . . . . . . . . . . . . . . . . . 193Cognos TM1 Performance Modeler のインストール . . . . . . . . . . . . . . . . . . . . . . 195インストール・プログラムによる Cognos TM1 Performance Modeler のインストール . . . . . . . . . 196Cognos TM1 Applications ポータルからの Cognos TM1 Performance Modeler のインストール. . . . . . . 196複数コンピューターでの Cognos TM1 Performance Modeler のリモート・インストール. . . . . . . . . 197Cognos TM1 Performance Modeler のログ記録の設定 . . . . . . . . . . . . . . . . . . . . 200

Cognos Insight のインストール . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200インストール・プログラム使用による Cognos Insight のインストール . . . . . . . . . . . . . . 201Cognos TM1 Applications ポータルからの Cognos Insight のインストール . . . . . . . . . . . . . 202複数コンピューターでの Cognos Insight のリモート・インストール . . . . . . . . . . . . . . . 203Cognos Insight のログ記録の設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . 205

Cognos TM1 API のインストール . . . . . . . . . . . . . . . . . . . . . . . . . . . 206Cognos TM1 のデータを PDF 形式でエクスポートするようにクライアント・コンピューターを設定する . . . . 207

第 15 章 IBM Planning Analytics for Microsoft Excel のインストールと設定 . . . . . 209新機能 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209バージョン 2.0.0 の新機能 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209バージョン 10.3.0 の新機能 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209バージョン 10.2.0 の新機能 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210バージョン 10.1.1 の新機能 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210

インストールの概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211

vi インストールおよび設定

Planning Analytics for Microsoft Excel をインストールするための前提条件 . . . . . . . . . . . . . . 212Microsoft .NET Framework のインストール . . . . . . . . . . . . . . . . . . . . . . . 212Microsoft Excel 用 Primary Interop Assemblies (PIA) . . . . . . . . . . . . . . . . . . . . 213旧バージョンの IBM Cognos for Microsoft Excel のアンインストール . . . . . . . . . . . . . . 215IBM Planning Analytics Workspace Local への接続 . . . . . . . . . . . . . . . . . . . . . 215TM1 REST API の接続のセットアップ . . . . . . . . . . . . . . . . . . . . . . . . . 216アンチウィルス・ソフトウェアの設定 . . . . . . . . . . . . . . . . . . . . . . . . . 216IBM ID の使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216

インストール・タスク . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217IBM Planning Analytics for Microsoft Excel のインストール . . . . . . . . . . . . . . . . . . 217IBM Planning Analytics for Microsoft Excel のテスト . . . . . . . . . . . . . . . . . . . . 218IBM Planning Analytics for Microsoft Excel のアンインストール . . . . . . . . . . . . . . . . 218スクリプトの使用による IBM Cognos Office Reporting TM1 Addin の登録 . . . . . . . . . . . . . 219

トラブルシューティング . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220構成の問題 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220処理の問題 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222セキュリティーの問題 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224Cognos Office の番号付きエラー・メッセージ . . . . . . . . . . . . . . . . . . . . . . 225IBM Planning Analytics for Microsoft Excel 番号付きエラー・メッセージ . . . . . . . . . . . . . 227

第 16 章 Cognos TM1 サンプル・データベースのインストール . . . . . . . . . . . 231デフォルトでインストールされているサンプル・データベースの使用 . . . . . . . . . . . . . . . . 232GO_Contributor および Outdoors 社のサンプル・データベースの使用 . . . . . . . . . . . . . . . . 233サンプル・データベースに基づく Great Outdoors 販売サーバーサンプルの使用 . . . . . . . . . . . 234

第 17 章 Cognos TM1 ツールのインストール . . . . . . . . . . . . . . . . . . . 245

第 18 章セキュリティー構成 . . . . . . . . . . . . . . . . . . . . . . . . . . 247認証セキュリティー . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247認証に関する概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248ETLDAP ユーティリティー . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251統合ログオン . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263LDAP 認証 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275Cognos TM1 での Cognos セキュリティーの使用 . . . . . . . . . . . . . . . . . . . . . 282

データ転送セキュリティーのための SSL の使用. . . . . . . . . . . . . . . . . . . . . . . 299データ転送セキュリティーのための SSL の使用の概要 . . . . . . . . . . . . . . . . . . . 299生成される証明書 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300SSL を使用する Cognos TM1 管理サーバーの設定 . . . . . . . . . . . . . . . . . . . . . 301SSL を使用する Cognos TM1 サーバーの設定 . . . . . . . . . . . . . . . . . . . . . . 304SSL を使用する Cognos TM1 クライアントの設定 . . . . . . . . . . . . . . . . . . . . . 308SSL を使用するための Cognos TM1 Web の設定 . . . . . . . . . . . . . . . . . . . . . 309SSL を使用する Cognos TM1 Applications の設定 . . . . . . . . . . . . . . . . . . . . . 311SSL を使用する TM1 C API の設定 . . . . . . . . . . . . . . . . . . . . . . . . . 316SSL を使用する Cognos TM1 Java API の設定 . . . . . . . . . . . . . . . . . . . . . . 316SSL を使用する Cognos TM1 ETLDAP ユーティリティーの設定 . . . . . . . . . . . . . . . . 317Planning Analytics で独自の証明書に基づいて SSL を使用する方法 . . . . . . . . . . . . . . . 318

第 19 章 Cognos TM1 インストールの保守. . . . . . . . . . . . . . . . . . . . 325Cognos TM1 のデータと設定ファイルのバックアップ . . . . . . . . . . . . . . . . . . . . . 325インストールされている Cognos TM1 コンポーネントの変更 . . . . . . . . . . . . . . . . . . 327IBM Planning Analytics のアンインストール . . . . . . . . . . . . . . . . . . . . . . . . 328Cognos TM1 Applications のアンインストールと配布解除 . . . . . . . . . . . . . . . . . . . . 329

Cognos TM1 Applications のデータのバックアップ . . . . . . . . . . . . . . . . . . . . . 330Cognos TM1 Applications からのアプリケーションのエクスポート . . . . . . . . . . . . . . . . 330Cognos TM1 での関連するサービスの停止. . . . . . . . . . . . . . . . . . . . . . . . 331Cognos TM1 Applications のアンインストール . . . . . . . . . . . . . . . . . . . . . . 332

目次 vii

Apache Tomcat における Cognos TM1 Applications のアンデプロイ . . . . . . . . . . . . . . . 333WebSphere における Cognos TM1 Applications のアンデプロイ . . . . . . . . . . . . . . . . . 334

IBM Planning Analytics バージョン 2.0.0 でのデータ・ファイルと設定ファイルの復元 . . . . . . . . . . 334Cognos TM1 Applications でのアプリケーションと設定ファイルの復元 . . . . . . . . . . . . . . . 336Cognos TM1 Applications へのアプリケーション定義のインポート . . . . . . . . . . . . . . . . . 337

第 20 章ユーザー補助機能 . . . . . . . . . . . . . . . . . . . . . . . . . . . 339インストール・ウィザードのキーボード・ショートカット . . . . . . . . . . . . . . . . . . . 339Cognos Configuration のキーボード・ショートカット . . . . . . . . . . . . . . . . . . . . . 340

付録 A. tm1s.cfg サーバー設定ファイル . . . . . . . . . . . . . . . . . . . . . 341tm1s.cfg ファイルの場所 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341サンプル tm1s.cfg ファイル . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342tm1s.cfg ファイルのパラメーター . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342

AdminHost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343AllowReadOnlyChore Reschedule . . . . . . . . . . . . . . . . . . . . . . . . . . . 343AllowSeparateNandCRules. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344AllRuleCalcStargateOptimization . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344ApplyMaximumViewSizeToEntireTransaction . . . . . . . . . . . . . . . . . . . . . . . . 345AuditLogMaxFileSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345AuditLogMaxQueryMemory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346AuditLogOn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346AuditLogUpdateInterval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346AutomaticallyAddCubeDependencies . . . . . . . . . . . . . . . . . . . . . . . . . . 347CacheFriendlyMalloc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347CalculationThresholdForStorage . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347CAMPortalVariableFile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348CAMUseSSL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348CheckFeedersMaximumCells . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348ClientCAMURI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349ClientExportSSLSvrCert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349ClientExportSSLSvrKeyID. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349ClientPingCAMPassport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349ClientMessagePortNumber . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350ClientPropertiesSyncInterval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350ClientVersionMaximum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350ClientVersionMinimum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351ClientVersionPrecision . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352CognosMDX.AggregateByAncestorRef . . . . . . . . . . . . . . . . . . . . . . . . . . 353CognosMDX.CellCacheEnable . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353CognosMDX.PrefilterWithPXJ . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353CognosMDX.SimpleCellsUseOPTSDK . . . . . . . . . . . . . . . . . . . . . . . . . . 354CognosMDX.UseProviderCrossJoinThreshold . . . . . . . . . . . . . . . . . . . . . . . . 354CognosTM1InterfacePath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355CreateNewCAMClients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355DataBaseDirectory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355DefaultMeasuresDimension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356DisableMemoryCache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356DisableSandboxing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356Display_Info_DBType_R8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357DistributedPlanningOutputDir . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357DownTime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358EnableNewHierarchyCreation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359EnableTIDebugging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359ExcelWebPublishEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359FileRetry.Count . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360

viii インストールおよび設定

FileRetry.Delay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360FileRetry.FileSpec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360FIPSOperationMode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361ForceReevaluationOfFeedersForFedCellsOnDataChange . . . . . . . . . . . . . . . . . . . . . 361HTTPPortNumber . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362HTTPSessionTimeoutMinutes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363IdleConnectionTimeOutSeconds . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363IndexStoreDirectory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363IntegratedSecurityMode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363IPAddressV4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365IPAddressV6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366IPVersion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366JavaClassPath. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367JavaJVMArgs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367JavaJVMPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367JobQueuing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368JobQueueMaxWaitTime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368JobQueueThreadPoolSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368JobQueueThreadSleepTime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369keyfile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369keylabel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369keystashfile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370Language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370LDAPHost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371LDAPPasswordFile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371LDAPPasswordKeyFile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371LDAPPort . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371LDAPSearchBase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372LDAPSearchField . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372LDAPSkipSSLCertVerification . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372LDAPSkipSSLCRLVerification . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372LDAPUseServerAccount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373LDAPVerifyCertServerName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373LDAPVerifyServerSSLCert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374LDAPWellKnownUserName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375LoadPrivateSubsetsOnStartup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375LockPagesInMemory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375LoggingDirectory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376LogReleaseLineCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376MagnitudeDifferenceToBeZero . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376MaskUserNameInServerTools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377MaximumCubeLoadThreads . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377MaximumLoginAttempts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378MaximumMemoryForSubsetUndo . . . . . . . . . . . . . . . . . . . . . . . . . . . 378MTFeeders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378MTFeeders.AtStartup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379MTFeeders.AtomicWeight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379MaximumSynchAttempts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379MaximumTILockObjects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380MaximumUserSandboxSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381MaximumViewSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381MDXSelectCalculatedMemberInputs . . . . . . . . . . . . . . . . . . . . . . . . . . . 381MessageCompression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383MTCubeLoad. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383MTCubeLoad.MinFileSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384MTCubeLoad.UseBookmarkFiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384

目次 ix

MTCubeLoad.Weight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385MTQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385MTQ.CTreeRedundancyReducer . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386MTQ.OperationProgressCheckSkipLoopSize . . . . . . . . . . . . . . . . . . . . . . . . 386MTQ.SingleCellConsolidation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386NetRecvBlockingWaitLimitSeconds . . . . . . . . . . . . . . . . . . . . . . . . . . . 386NetRecvMaxClientIOWaitWithinAPIsSeconds . . . . . . . . . . . . . . . . . . . . . . . . 387NIST_SP800_131A_MODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387ODBCLibraryPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387OracleErrorForceRowStatus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388PasswordMinimumLength . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388PasswordSource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388PerfMonIsActive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388PerformanceMonitorOn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389PersistentFeeders. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389PortNumber . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390PreallocatedMemory.BeforeLoad . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390PreallocatedMemory.Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390PreallocatedMemory.ThreadNumber . . . . . . . . . . . . . . . . . . . . . . . . . . . 391PrivilegeGenerationOptimization . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391ProgressMessage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391ProportionSpreadToZeroCells . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392PullInvalidationSubset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393RawStoreDirectory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393ReceiveProgressResponseTimeoutSecs . . . . . . . . . . . . . . . . . . . . . . . . . . 394RulesOverwriteCellsOnLoad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395RunningInBackground . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395SaveTime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395SecurityPackageName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396ServerCAMURI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396ServerCAMURIRetryAttempts . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397ServerLogging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397ServerName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398ServicePrincipalName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398SkipLoadingAliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398SkipSSLCAMHostCheck . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398SpreadingPrecision . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399SpreadErrorInTIDiscardsAllChanges . . . . . . . . . . . . . . . . . . . . . . . . . . . 400SSLCertAuthority . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400SSLCertificate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400SSLCertificateID. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401StartupChores. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401SubsetElementBreatherCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401SupportPreTLSv12Clients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402SvrSSLExportKeyID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402SyncUnitSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402tlsCipherList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403TM1ConnectorforSAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403UnicodeUpperLowerCase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404UseExcelSerialDate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404UseLocalCopiesforPublicDynamicSubsets . . . . . . . . . . . . . . . . . . . . . . . . . 405UseNewConnectorforSAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405UserDefinedCalculations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406UseSQLFetch UseSQLFetchScroll UseSQLExtendedFetch . . . . . . . . . . . . . . . . . . . . 406UseSSL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407UseStargateForRules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407

x インストールおよび設定

ViewConsolidationOptimization . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408ViewConsolidationOptimizationMethod . . . . . . . . . . . . . . . . . . . . . . . . . . 408ZeroWeightOptimization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409

付録 B. Tm1p.ini クライアント設定ファイル . . . . . . . . . . . . . . . . . . . 411Tm1p.ini ファイルの場所 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411Tm1p.ini ファイルのパラメーター . . . . . . . . . . . . . . . . . . . . . . . . . . . 412

AdminHost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412AdminSvrSSLCertAuthority . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412AdminSvrSSLCertID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413AdminSvrSSLCertRevList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413AdminSvrSSLExportKeyID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413AdvancedRulesEditor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413AllowImportCamClients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413BrowseDisplayReadsRightToLeft . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414ClassicSliceMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414CognosGatewayURI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414ConnectLocalAtStartup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414DataBaseDirectory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414DimensionDownloadMaxSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414DisableAdminHostEntry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415DisableWritebackOnDisconnect . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415DisableWritebackOnTM1Formulas . . . . . . . . . . . . . . . . . . . . . . . . . . . 416DisplayApplications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416DisplayChores . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416DisplayControlCubes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416DisplayCubes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416DisplayDimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417DisplayExplorerPropertiesWindow . . . . . . . . . . . . . . . . . . . . . . . . . . . 417DisplayProcesses. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417DisplayReplications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417ExpandRowHeaderWidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417ExportAdminSvrSSLCert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417InSpreadsheetBrowser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418IntegratedLogin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418Language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418LocalServerNetworkProtocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419MainWindowLayoutInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419PreviousAdminHosts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419PreviousDataDirectories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419SecurityAssignmentWindowLayoutInfo . . . . . . . . . . . . . . . . . . . . . . . . . . 419SentMsgsToServerCountWarning . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420ShowAdminHostChangeWarning . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420ShowAliasAttributeWarning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420ShowChoresSchedulingWarning . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420ShowCubeReplicationWarning . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420ShowDimDeleteElementWarning . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420ShowDimensionAccessWarning . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420ShowDynamicSubsetWarning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421ShowPickOperationWarning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421ShowProcessUNASCIIWarning . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421ShowProcessUNODBCWarning . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421SliceNewWorkbook . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421SubsetWindowLayoutInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421TM1RebuildDefault . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422

目次 xi

付録 C. 無人インストールおよび設定のセットアップ . . . . . . . . . . . . . . . . 423無人インストール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423無人インストールのセットアップ . . . . . . . . . . . . . . . . . . . . . . . . . . . 423

無人設定のセットアップ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424無人アンインストールのセットアップ . . . . . . . . . . . . . . . . . . . . . . . . . . 425

付録 D. 問題のトラブルシューティング . . . . . . . . . . . . . . . . . . . . . . 427IBM Knowledge Center . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427Support Portal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428情報の収集 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428サービス・リクエスト . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428Support Assistant Lite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428Fix Central . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428IBM Planning Analytics コミュニティー . . . . . . . . . . . . . . . . . . . . . . . . . 429Software Support RSS feeds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429IBM 製品の検索とナビゲート . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429

特記事項. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431

索引 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435

xii インストールおよび設定

概要

このドキュメントでは、Microsoft Windows と UNIX のオペレーティング・システムで IBM® Planning Analytics Local ソフトウェア・コンポーネントのインストール、アップグレード、設定を行う方法について説明します。

対象読者

IBM Planning Analytics Local を使用して、ビジネス計画、業績評価、運用データを統合すれば、地理や組織構造にかかわらず企業のビジネス効率や顧客との対話を最適化できます。Planning Analytics を使用すれば、データを即座に可視化し、協同プロセス内の責任を明確にして、一貫した情報を表示できるので、経営陣は変動する運用状況を迅速に安定化させ、新しいビジネス・チャンスを活用することができます。

この資料を使用するには、次についての知識が必要です。

v インストールの概念

v セキュリティーの問題

v Windows または UNIX の管理に関する基本的なスキル

v 自社内の既存のサーバー環境とセキュリティー・インフラストラクチャー

v Planning Analytics のシステム要件とネットワーク要件

情報の入手方法

資料は、各国語版の資料も含め、 Web 上にある IBM Knowledge Center

(http://www.ibm.com/support/knowledgecenter) で入手できます。

セキュリティー上の考慮事項

IBM Planning Analytics のセキュリティー上の考慮事項については、 40ページの『Cognos TM1 Applications を使用する際のセキュリティーの考慮事項』を参照してください。ユーザーとグループの認証を管理する方法について詳しくは、「TM1

Operations」の資料で『ユーザーとグループの管理』の章を参照してください。

ユーザー補助機能

ユーザー補助機能は、動作が制限されている方、視力の限られた方など、身体に障害を持つ方々に IT 製品をご使用いただけるように支援する機能です。インストール・ウィザードには、ユーザー補助機能があります。この機能については、このドキュメントのユーザー補助機能に関するセクションを参照してください。

IBM の HTML 資料にはユーザー補助機能が組み込まれています。PDF 文書は補助的なものであるため、追加のユーザー補助機能はありません。

© Copyright IBM Corp. 2007, 2017 xiii

http://www.ibm.com/support/knowledgecenter/

将来の見通しに関する記述

このマニュアルには製品の現在の機能が記載されています。現在利用できない項目への言及が含まれる場合もありますが、将来的に使用可能になることを示唆するものではありません。このような言及は、何らかの資料、規約、または機能を提供するという誓約、保証、または法的義務ではありません。特性や機能の開発、公開、およびその時期に関しては、引き続き IBM が単独裁量権を有します。

サンプルに関する特記事項

Sample Outdoors 社、Great Outdoors 社、GO 販売、Sample Outdoors または Great

Outdoors の名前のすべてのバリエーション、および Planning サンプルでは、IBM

および IBM のお客様向けのサンプル・アプリケーションを開発するために使用されるサンプル・データにより、架空のビジネス・オペレーションが描出されています。これら架空の記録には、販売取引、商品流通、財務、および人事のサンプル・データが含まれます。実在する名称、住所、連絡先電話番号、取引額とは一切関係がありません。また、サンプル・ファイルの中には、手動またはコンピューターで生成された架空のデータ、学術的ソースまたは公共のソースを基に編集された実際のデータ、版権所有者の許可を得て使われているデータなどが、サンプル・アプリケーションを開発するためのサンプル・データとして使用されている場合もあります。参照される製品名は、それぞれの所有者の商標である可能性があります。許可なく複製することは禁止されています。

xiv インストールおよび設定

第 1 章新機能

このセクションでは、このリリースでの新機能、変更された機能、削除された機能についてリストで示します。

現在有効なすべての IBM Planning Analytics 資料を IBM Knowledge Center

(https://www.ibm.com/support/knowledgecenter/SSD29G_2.0.0) で閲覧できます。

Planning Analytics バージョン 2.0.0 のインストールと設定に関する新機能

IBM Planning Analytics バージョン 2.0.0 のインストールと設定に関する新機能と変更点を以下にリストします。

デフォルトのアプリケーション・サーバーは WebSphere LibertyProfile

IBM Planning Analytics では、WebSphere®® Liberty Profile がデフォルトのアプリケーション・サーバーとしてインストールされます。 Apache Tomcat はデフォルトのアプリケーション・サーバーとしてはインストールされなくなりました。IBM

Cognos® TM1® でもかつてはこれが使用されていました。

注: IBM Planning Analytics 2.0.0 では、Performance Manager Hub は、別のWebSphere Liberty Profile サーバーにのみ配置できます。他のバージョンのWebSphere はサポートされません。

WebSphere Liberty Profile では、Apache Tomcat サーバーで使用されていたデフォルトのポート番号が同様に使用されます。例えば、デフォルト・ポート番号 9300

が WebSphere Liberty Profile でも使用されます。

TM1 サーバーのインストール・ウィザードの選択可能なコンポーネントについての変更

TM1 サーバーのインストール・ウィザードの選択可能なコンポーネントが含まれている各層の名前が変更されました。

v 「TM1 アプリケーション層」は「TM1 データ層」に変わりました。

v 「Web アプリケーション層」は「TM1 Web 層」に変わりました。

v 「TM1 クライアント層」と「開発者層」が統合されて「TM1 リッチ層」という新しい名前の層になりました。

v サンプル・コンポーネントが「TM1 データ層」の下に移されました。

© Copyright IBM Corp. 2007, 2017 1

http://www.ibm.com/support/knowledgecenter/SSD29G/welcome

2 インストールおよび設定

第 2 章 Planning Analytics のインストールの計画

インストールの成功は、計画にかかっています。この章では、実装プロセスを順調に進行させるための選択項目について説明します。

IBM Planning Analytics を実装するときには、最高のパフォーマンスが得られるようにインストールと設定の方法を決定してください。インストールと設定の選択内容は、要件、リソース、プリファレンスによって異なります。

使用可能なインストール・プログラムIBM Planning Analytics Local には、Planning Analytics コンポーネントをさまざまな配布シナリオでさまざまなオペレーティング・システムにインストールして設定することができるように、一連のインストール・プログラムが用意されています。

Planning Analytics Local のインストール・プログラムはすべて IBM パスポート・アドバンテージ® からダウンロードできます。ダウンロード手順については、Planning Analytics Local 2.0 (http://www.ibm.com/support/

docview.wss?uid=swg24042732) を参照してください。

インストール・プログラムとコンポーネント・オプションは、オペレーティング・システムとアーキテクチャー層ごとに編成されており、単一コンピューター環境と複数コンピューター環境への配布に対応します。

提供されている Planning Analytics Local 2.0.0 インストール・プログラムを以下に示します。

Windows 32 ビット用の Planning Analytics Local

Microsoft Windows 32 ビット用に提供されている Planning Analytics のすべてのコンポーネントが一式含まれています。

このインストール・プログラムは、すべてのコンポーネントを 1 つの 32

ビット Windows システムにインストールする場合、または Cognos TM1

管理サーバー、Cognos TM1 サーバーなどの個々のコンポーネントをそれぞれ異なる 32 ビット Windows システムに選択的にインストールする場合に使用します。

デフォルトでは、Cognos TM1 管理サーバー、Cognos TM1 サーバー、Cognos TM1 Applications コンポーネントを管理するための IBM Cognos

Configuration ユーティリティーがこのインストール・プログラムによって自動的にインストールされます。

Windows 64 ビット用の Planning Analytics Local

64 ビット Microsoft Windows システムにインストールするための、32 ビット・コンポーネントと 64 ビット・コンポーネントを組み合わせたコレクションが含まれています。

このインストール・プログラムは、64 ビット Windows システムでのみ実行されます。


http://www.ibm.com/software/howtobuy/passportadvantage/paocustomer/sdma/SDMA?PO=DOWNLOAD_FIND_BY_PART_NUMBER

http://www.ibm.com/software/howtobuy/passportadvantage/paocustomer/sdma/SDMA?PO=DOWNLOAD_FIND_BY_PART_NUMBER

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

このインストール・プログラムは、すべてのコンポーネントを 1 つの 64

ビット Windows システムにインストールする場合、または Cognos TM1

管理サーバー、Cognos TM1 サーバーなどの個々のコンポーネントをそれぞれ異なる 64 ビット Windows システムに選択的にインストールする場合に使用します。

デフォルトでは、Cognos TM1 管理サーバー、Cognos TM1 サーバー、Cognos TM1 Applications コンポーネントを管理するための IBM Cognos

Configuration ユーティリティーがこのインストール・プログラムによって自動的にインストールされます。

Planning Analytics Local クライアントのみ

標準の Cognos TM1 クライアント/ユーザー・インターフェースおよび関連する TM1 API サポート・ファイルのみが含まれます。以下のコンポーネントには 32 ビット・バージョンしかありません。

v Cognos TM1 Architect

v Cognos TM1 Perspectives

v Cognos TM1 API

v Cognos TM1 Performance Modeler

v Cognos Insight

このインストール・プログラムを使用して、Cognos TM1 クライアントを環境内の複数のエンド・ユーザー・コンピューターに配布およびインストールします。

注: この TM1 クライアント・インストール・プログラムを使用して、Cognos TM1 データ・ソースに基づく IBM Cognos Analytics によるレポート作成を可能にすることもできます。この目的のために TM1 クライアント・インストール・プログラムを使用して、 Microsoft Windows で Report

サービスを実行している Cognos Analytics サーバーに、必要な Cognos

TM1 API ファイルをインストールします。詳細については、 72ページの『Cognos TM1 データ・ソースに基づく Cognos Analytics レポート作成を可能にする』を参照してください。

Planning Analytics Workspace

このインストール・プログラムは、オンプレミスのインストール環境にIBM Planning Analytics Local の一部として IBM® Planning Analytics

Workspace をインストールする場合に使用してください。Planning Analytics

Workspace は、IBM Planning Analytics に対応した Web ベースのインターフェースです。

IBM Planning Analytics Workspace をインストールする前に、IBM Planning

Analytics Local 2.0.0 以上をインストールしておく必要があります。

Planning Analytics Workspace のインストールについては、 179ページの『第 12 章 Planning Analytics Workspace installation』を参照してください。

Planning Analytics for Microsoft Excel

このインストール・プログラムは、Planning Analytics for Microsoft Excel

を配布してインストールする場合に使用してください。


Planning Analytics には、IBM Planning Analytics for Microsoft Excel で使用できるサンプルが組み込まれています。

UNIX/Linux 用の Planning Analytics

UNIX および Linux 版の以下の Cognos TM1 コンポーネントのみが含まれます。

v Cognos TM1 管理サーバー

v Cognos TM1 サーバー

v Cognos TM1 Web アプリケーション・サーバー (Cognos TM1

Web、Cognos TM1 Applications、Cognos TM1 Operations Console)

Cognos TM1 UNIX インストール・プログラムを使用して、サポートされているいずれかの UNIX または Linux オペレーティング・システムにこれらのコンポーネントをインストールします。サポートされているこれらのオペレーティング・システムのそれぞれに対して別個のインストール・プログラムが用意されています。

デフォルトでは、Cognos TM1 管理サーバーおよび Cognos TM1 サーバーを管理するための IBM Cognos Configuration ユーティリティーがこのインストール・プログラムによって自動的にインストールされます。

Business Intelligence 用の TM1 Package Connector

オプションのインストール・プログラム

IBM Planning Analytics から IBM Cognos Analytics パッケージに接続してSAP Business Warehouse のデータ・ソースや他のリレーショナル・データ・ソースや ODBC データ・ソースを使用するためのコンポーネントをインストールできます。

利用可能なコンポーネントIBM Cognos TM1 には、Cognos TM1 データの管理、モニター、モデル作成、分析、対話用のサーバーとクライアントのコンポーネントのコレクションが含まれています。

インストール・プログラムによって、種々の Cognos TM1 コンポーネントがアーキテクチャー層に基づいてグループに編成されます。特定の要件、オペレーティング・システム、および環境に基づいて、種々のコンポーネントの組み合わせを 1 つのコンピューターにインストールしたり、複数のコンピューターにインストールしたりできます。それぞれのコンポーネントには、固有のオペレーティング・システムとソフトウェアの環境が必要となります。インストール・コンポーネントの詳細については、以下のセクションを参照してください。

IBM Planning Analytics は、デフォルトのアプリケーション・サーバーとしてWebSphere Application Server Liberty Profile を使用します。現在の環境で使用しているサポート対象の他のアプリケーション・サーバーで実行するように Planning

Analytics を構成することもできます。

第 2 章 Planning Analytics のインストールの計画 5

TM1 データ層のインストール・コンポーネントIBM Cognos TM1 のインストール・プログラムのデータ層には、Cognos TM1 管理サーバー・コンポーネントや Cognos TM1 サーバー・コンポーネントなどの基本的なコンポーネントが含まれています。

データ層に含まれている各 Cognos TM1 コンポーネントの説明とオペレーティング・システムを以下の表にまとめます。

表 1. Cognos TM1 のデータ層コンポーネントのシステム要件

コンポーネントオペレーティング・システム説明

TM1 サーバー 32 ビット Windows

64 ビット Windows

64 ビット UNIX

Cognos TM1 サーバーは、Cognos TM1 クライアントからの要求を管理します。これは、キューブやディメンションなど、使用可能なすべての永続オブジェクトの名前をメモリーにロードします。また、必要に応じて、計算、集約、および更新を行うことでクライアントの要求に応答します。

Cognos TM1 サーバーは、サーバー・オブジェクトへのアクセスを許可または拒否し、データベースに対する変更のログを保守して、セキュリティーも管理します。

85ページの『第 8 章 Cognos TM1 サーバーのインストール』を参照してください。

TM1 管理サーバー 32 ビット Windows


64 ビット UNIX

ネットワーク上で実行されるすべてのCognos TM1 サーバーを追跡するプロセス。Admin Server は、管理ホスト・サーバー上で実行します。

Cognos TM1 サーバーは、開始時に、指定された管理ホスト上で実行されている管理サーバーに自身を登録します。

Cognos TM1 クライアントは管理サーバーを参照して、ネットワーク上で使用可能なCognos TM1 サーバーを確認します。

85ページの『第 8 章 Cognos TM1 サーバーのインストール』を参照してください。

TM1 ツールサポートされるオペレーティング・システムはツールによって異なります。

Cognos TM1 管理者、開発者、モデル作成者用の以下のツールとユーティリティーのコレクションが含まれています。

TIRunTI

TM1xfer

245ページの『第 17 章 Cognos TM1 ツールのインストール』を参照してください。


表 1. Cognos TM1 のデータ層コンポーネントのシステム要件 (続き)


サンプル 32 ビット Windows


64 ビット UNIX

Cognos TM1 のサンプル・データベースをインストールします。

231ページの『第 16 章 Cognos TM1 サンプル・データベースのインストール』.

TM1 Web 層のインストール・コンポーネントTM1 Web 層のインストール・コンポーネントには、コンポーネントを実行するための Web アプリケーション・サーバーが必要です。デフォルトでは、これらは付属の Java Web アプリケーション・サーバーで機能するように設定されます。

TM1 Web 層に含まれている各 Cognos TM1 コンポーネントの説明とオペレーティング・システムを以下の表にまとめます。

表 2. TM1 Web 層コンポーネント


Cognos TM1

Application Gateway



リモート・ユーザーに対して Cognos TM1

Performance Modeler コンポーネントとCognos Insight コンポーネントのプロビジョニングを行う Java Web コンポーネント。

このコンポーネントは、Cognos TM1 アプリケーション・サーバーコンポーネントと一緒にインストールされます。

147ページの『第 11 章 Cognos TM1 アプリケーション・サーバーのインストール』を参照してください。


表 2. TM1 Web 層コンポーネント (続き)


TM1 アプリケーション・サーバー



IBM Cognos TM1 Applications の基本的なサポートを提供する Java Web アプリケーション。

Cognos TM1 Applications コンポーネントを使用して、プランニングとコントリビューションをベースとする管理されたアプリケーションを設計して配布し、Cognos TM1 データに対して実行することができます。このコンポーネントは、Cognos TM1 Performance

Modeler コンポーネントおよび Cognos

Insight コンポーネントとも対話します。

このコンポーネントには、Java Web アプリケーション・サーバーと Java™ Runtime

Environment (JRE) が必要です。

デフォルトでインストールされるWebSphere® Liberty アプリケーション・サーバーを使用することも、独自のアプリケーション・サーバー・インスタンス (IBM

WebSphere Application Server など) を使用することもできます。

IBM JRE は、Cognos TM1 Applications と一緒に自動的にインストールされます。アプリケーション・サーバーを使用している場合は、それにインストールされている JRE を使用します。

147ページの『第 11 章 Cognos TM1 アプリケーション・サーバーのインストール』を参照してください。

TM1 Web 32 ビット Windows


付属の Java Web アプリケーション・サーバー上で実行する Web サーバーとクライアント・コンポーネント。

Cognos TM1 Web を使用すると、ユーザーは、サポートされている Web ブラウザーでCognos TM1 サーバーに接続してデータと対話することができます。

117ページの『第 10 章 Cognos TM1 Web

のインストール』を参照してください。


表 2. TM1 Web 層コンポーネント (続き)


TM1 Operation

Console



Cognos TM1 管理者が TM1 サーバーのアクティビティーをモニターして対処するために使用できる Web ベースのモニター・ツールを備えた Java Web アプリケーション。

IBM Cognos TM1 Operations Console を使用すると、単純で効果的な方法で Cognos TM1

サーバーとユーザー・ロードの処理状態を理解できます。

このコンポーネントは、デフォルトでインストールされる WebSphere® Liberty アプリケーション・サーバーでも、サポート対象のアプリケーション・サーバーをインストールした独自の環境でも使用できます。

Windows には、IBM JRE が Cognos TM1

のインストール時に自動的にインストールされます。アプリケーション・サーバーを使用している場合は、それにインストールされている JRE を使用します。

107ページの『付属の WebSphere® Liberty

Web サーバー・ソフトウェアを使用する場合の Cognos TM1 Operations Console のインストール』を参照してください。

TM1 リッチ層のインストール・コンポーネントIBM Cognos TM1 のインストール・プログラムのリッチ層には、エンド・ユーザー用のツールと Cognos TM1 API が一式含まれています。

リッチ層に含まれている各 Cognos TM1 コンポーネントの説明とオペレーティング・システムを以下の表にまとめます。

表 3. リッチ層コンポーネント


TM1 Architect 32 ビット Windows ローカルとリモートの両方の Cognos TM1

サーバーのデータおよびメタデータを管理、作成、保守するための Windows デスクトップ・アプリケーション。

193ページの『Cognos TM1 Architect のインストール』を参照してください。


表 3. リッチ層コンポーネント (続き)


TM1 Performance

Modeler

32 ビット Windows Java による、Eclipse ベースのリッチ・クライアント・インターフェース。Cognos TM1

Applications ポータル・ページから開始します。

開発者が、Cognos TM1 環境でプランニング・モデルと分析モデルを作成できるようにします。

32 ビットと 64 ビットの Windows 用のクライアント専用インストール・プログラムで選択できるコンポーネントとして提供されています。

32 ビットと 64 ビットのどちらの Windows

インストール・プログラムでも、デフォルトでは、このコンポーネントは使用可能ですが選択されていません。

195ページの『Cognos TM1 Performance

Modeler のインストール』を参照してください。

TM1 Perspectives 32 ビット Windows Microsoft Excel 用の Cognos TM1 アドイン・クライアント。

Excel の機能を使用して、Cognos TM1 サーバーに格納されたデータに対して複雑な分析を行うことができます。また、ローカルとリモートの Cognos TM1 サーバーの両方で、オブジェクトとデータの作成および保守を行うことができます。

191ページの『Cognos TM1 Perspectives のインストール』を参照してください。


表 3. リッチ層コンポーネント (続き)


Cognos Insight 32 ビット Windows Java による、Eclipse ベースのリッチ・クライアント・インターフェース。単独で開始することも、Cognos TM1 Applications ポータル・ページから開始することもできます。

32 ビットと 64 ビットの Windows 用のクライアント専用インストール・プログラムで選択できるコンポーネントとして提供されています。

32 ビットと 64 ビットのどちらの Windows

インストール・プログラムでも、デフォルトでは、このコンポーネントは使用可能ですが選択されていません。

200ページの『Cognos Insight のインストール』を参照してください。

TM1 API API によって異なる開発者が以下の Cognos TM1 アプリケーション・プログラミング・インターフェース(API) を使用できるようにするために必要なファイルをインストールします。

TM1 API - 開発者が TM1 と対話するC、C++ および VB のカスタム・アプリケーションを作成できるようにします。

TM1 Java API - これを使用して、開発者はTM1 と対話するカスタム Java アプリケーションを作成できます。

TM1 .NET API - 開発者が TM1 と対話するカスタム Microsoft .NET アプリケーションを作成できるようにします。

206ページの『Cognos TM1 API のインストール』を参照してください。

翻訳されたドキュメントのインストール・コンポーネントこのコンポーネントにより、英語以外の IBM Cognos TM1 でサポートされる言語に翻訳されたドキュメントを選択してインストールできます。

英語のドキュメントは、デフォルトで必ずインストールされます。この選択を解除することはできません。特定の言語を選択したり選択を解除したりできますが、選択した言語数に応じてインストール時間は長くなります。

サポートされる言語について詳しくは、 96ページの『Cognos TM1 言語コード』を参照してください。


メッセージやユーザー・インターフェースの言語は、翻訳されたドキュメントに関するこのオプションの影響を受けません。

v ソフトウェアから発行されるメッセージは、サポートされるすべての言語のものが必ずインストールされるため、このオプションの影響を受けません。

v Cognos TM1 ユーザー・インターフェースで使用される言語は、現行ユーザーのオペレーティング・システムの設定によって決まるため、このオプションの影響は受けません。言語の設定方法について詳しくは、 95ページの『Cognos TM1 言語設定』を参照してください。

リストされないその他のインストール・コンポーネントインストール・プログラムではリストされない、あるいは選択できないコンポーネントがいくつかあります。

インストール・プログラムではリストされない、あるいは選択できないコンポーネントで、他の選択可能コンポーネントをインストールするとデフォルトでインストールされる必須のコンポーネントについて、説明とオペレーティング・システムを以下の表に示します。

表 4. インストール・ウィザードでリストされないその他の Cognos TM1 コンポーネント


TM1 OLE DB

Provider アプリケーション



サード・パーティーのソフトウェアが、MDX クエリーを使用して Cognos TM1 サーバーからキューブ・データを取得できるようにします。

TM1 クライアントの区別IBM Cognos TM1 では、開発者、管理者、およびユーザー用に複数のクライアントを提供しています。これらの各クライアント、およびそれぞれの違いを理解することは、最もニーズに適したクライアントを判断するのに役立ちます。

すべてのクライアントについて、IBM Cognos TM1 の資料で詳しく説明しています。

v Planning Analytics for Microsoft Excel の資料では、IBM Cognos TM1 またはIBM Cognos Analytics のデータ・ソースを使用するレポートの作成方法について説明しています。

v 「TM1 Performance Modeler」の資料では、Cognos TM1 Performance Modeler の開発機能および管理機能について説明しています。

v 「TM1 Developer」の資料では、Cognos TM1 Architect および Cognos TM1

Perspectives の開発機能および管理機能について説明しています。

v 「TM1 Operation」の資料では、TM1 Server の操作、および TM1 Operations

Console を使用してサーバーをモニターする方法を説明しています。

v 「TM1 Perspectives, TM1 Architect, and TM1 Web」の資料では、Cognos TM1

Architect、 Cognos TM1 Perspectives、および Cognos TM1 Web のユーザー分析機能について説明しています。


v 「TM1 Applications」の資料では、Cognos TM1 Application Web のユーザー分析機能について説明しています。

v 「Cognos Insight」の資料では、Cognos Insight のユーザー分析機能について説明しています。

エンド・ユーザー・クライアント各種ユーザー・クライアントを使用して、IBM Cognos TM1 データと相互作用することができます。

IBM Planning Analytics Workspace

IBM Planning Analytics Workspace は、IBM Planning Analytics に対する Web ベースのインターフェースです。このインターフェースを使用すると、TM1 データに接続し、エキサイティングな方法でコンテンツを計画、作成、分析できます。

Planning Analytics Workspace のインストールについては、 179ページの『第 12 章Planning Analytics Workspace installation』を参照してください。

IBM Planning Analytics for Microsoft Excel

IBM Planning Analytics for Microsoft Excel は、グローバルなネットワーク環境で作業するユーザーを対象にしています。これは、TM1 の情報を主に Microsoft Excel

で分析していて、Microsoft Excel の機能を使用して独自のカスタム・レイアウトを作成しているユーザーに最適なクライアントです。 Planning Analytics for Microsoft

Excel は、Cognos TM1 と Cognos Analytics の両方のデータに、同じ Excel クライアント・インターフェースからアクセスする必要のあるユーザーにも便利です。

Planning Analytics for Microsoft Excel には、以下のような利点があります。

v 広域ネットワーク用に最適化されている

v 使い慣れたスプレッドシート環境で、パワー・ユーザー・レベルの Excel の知識がなくても Cognos TM1 データを分析したり操作したりできる

v Microsoft Excel の機能と、ドラッグ・アンド・ドロップ方式の Cognos TM1 キューブの分析機能を組み合わせることができる

v 柔軟な範囲ベースのモードを提供することにより、スプレッドシート内でフォーマットやユーザー計算を直接追加できる

v キューブ、ビュー、ディメンション・サブセット、別名、サンドボックスなどのTM1 データ・オブジェクトにアクセスできる

v 同じスプレッドシート・インターフェースで、Microsoft Excel ベースの TM1

Planning の読み取り/書き込み機能と、 Cognos Analytics データ・ソースの読み取り専用の分析機能を組み合わせることができる

詳しくは、「Planning Analytics for Microsoft Excel」の資料を参照してください。

IBM Cognos TM1 Application Web

IBM Cognos TM1 Application Web は、サポートされる任意の Web ブラウザーでCognos TM1 Applications を開くために使用できるゼロ・フットプリント Web クライアントです。Cognos TM1 Application Web のワークフロー・ページから、ノードのオープン、所有権の取得、データの入力を行うことができ、また計画に関与する


ことができます。Cognos TM1 Application Web は、会社のポリシーによりローカル・クライアントをインストールできない場合、または Microsoft Windows 以外のオペレーティング・システムを使用している場合に最も役立ちます。

IBM Cognos TM1 Web

IBM Cognos TM1 Web は、サポートされる任意の Web ブラウザーで Cognos TM1

データを分析および変更するために使用できるゼロ・フットプリントの Web クライアントです。Cognos TM1 Web を使用して、Cognos TM1 Application Web ワークフロー・ページにアクセスすることはできません。このため、TM1 Web を使用して Cognos TM1 アプリケーションに参加することはできません。

IBM Cognos Insight

IBM Cognos Insight は、TM1 Application Web のクライアントであり、ほぼすべてのデータ・セットの分析に使用できる個人用分析ツールでもあります。Cognos TM1

Application Web のコンテキストでは、Cognos Insight は、ローカルで、またはリモート・ダウンロードとしてプロビジョンされる完全なクライアント・アプリケーションです。Cognos TM1 Application Web のクライアントとして使用する場合、Cognos Insight の接続モードおよび切断モードを使用できます。

接続モード

接続モードは、Cognos TM1 サーバーへの同時双方向接続を確立します。TM1 サーバーで更新されたデータがある場合、Insight で再計算を実行するときにそれらのデータは Insight クライアントですべて更新されます。この方式により、Insight クライアント上のデータは、分析を実行するとき、または計画に寄与するときに、常に最新に保たれます。TM1 サーバーに対するライブ接続のトレードオフは、切断モードと比べてより多くのトラフィックが LAN で生成され、より重い負荷が TM1 サーバーにかかるということです。

接続モードは、TM1 サーバーへの高速接続が確保され、ネットワークの待ち時間に関する問題を抱えていないユーザーが使用することをお勧めします。

切断モード

切断モードは、子レベルのノードでのみ使用できます。切断モードでは、作業している Cognos TM1 サーバー・スライス (TM1 モデルとデータ部分 )

のローカル・コピーがダウンロードおよび作成されます。この方式にでは、TM1 サーバーが他の接続モードで維持する必要があるワークロードが分散されます。このモードでは、処理はクライアントと TM1 サーバーとの間で分散されます。

切断モードは、LAN の待ち時間の長いユーザー、または TM1 サーバーから地理的に離れたユーザーにとって有益です。ユーザーが Cognos Insight

を接続モードで開くと、TM1 モデル・スライスがダウンロードされてキャッシュされます。データとの対話はすべてローカル・キャッシュに対して行われるため、応答のスピードが上がります。


管理クライアントIBM Cognos TM1 管理クライアントを使用して、Cognos TM1 のデータおよびモデルを管理できます。

IBM Cognos TM1 Performance Modeler

IBM Cognos TM1 Performance Modeler は、ディメンション、キューブ、規則、プロセス、およびその他のオブジェクトを作成または生成するために使用できる最新の Cognos TM1 モデル作成ツールです。Performance Modeler は、アプリケーションに必要な規則およびフィーダーを自動生成することによって、モデル作成プロセスを単純化します。また、Performance Modeler では、データおよびメタデータをTM1 サーバーにインポートする簡潔なプロセスである、ガイド付きインポートを導入しています。 Performance Modeler は、新規および既存の Cognos TM1 モデルすべてに対して開発および保守の主要なツールとして使用されます。

IBM Cognos TM1 Architect

IBM Cognos TM1 Architect は、古い Cognos TM1 モデル作成ツールであり、すべての TM1 オブジェクトの作成および保守をサポートします。 TM1 Architect は、フィーダーおよび規則の自動生成をサポートしておらず、ガイド付きインポート機能も提供していません。 Architect ユーザーは、すべての TM1 モデルの主要な開発環境として Cognos TM1 Performance Modeler を使用することが推奨されています。

IBM Cognos TM1 Perspectives

IBM Cognos TM1 Perspectives は、TM1 Excel のアドインです。 Cognos TM1

Perspectives は、Cognos TM1 モデルの開発、および Microsoft Excel の機能を使用したデータ分析に使用できます。Perspectives は、Cognos TM1 Architect と同様、すべての TM1 オブジェクトの作成および保守をサポートしますが、Performance

Modeler の拡張機能は提供しません。Excel アドイン・インターフェースや、Microsoft Excel の機能 (TM1 データのグラフ作成など) を使用できる必要があるユーザーは、Perspectives を使用できます。それ以外の場合、管理者は、すべてのTM1 モデルの主要な開発環境として Performance Modeler を使用することが勧められています。

IBM Cognos TM1 Operations Console

IBM Cognos TM1 Operations Console は、Cognos TM1 サーバーのモニター、サポート、および管理を容易にするために設計された Web ベースのツールであり、日常のサーバー操作に対するより優れた洞察を与えます。Cognos TM1 Operations

Console を使用することで、複数の TM1 サーバーで実行されているスレッドを同時かつ動的にモニターできます。スレッド・アクティビティーをソートおよびフィルターしたり、サーバー・アクティビティーのログ記録をスケジュールしたりすることができます。Operations Console は、モニター対象の各 TM1 サーバーの現在の状態を判別するヘルス・チェック機能も提供します。Operations Console は、エンタープライズ・スケールの TM1 環境を管理する Cognos TM1 管理者にとって最適なインターフェースです。


ソフトウェア要件IBM Cognos TM1 サーバーまたはクライアントのコンポーネントをインストールする前に、システム要件を確認し、コンポーネントが正しく動作するように、環境でリソースを設定してください。

Software Environments for IBM Planning Analytics 2.0 (http://www.ibm.com/support/

docview.wss?uid=swg27049052) にアクセスして、Planning Analytics でサポートされる環境の最新リスト (オペレーティング・システム、パッチ、Web サーバー、Web

ブラウザーなどの情報) を確認してください。

前提条件ソフトウェア

Cognos TM1 をインストールして使用するには、事前に特定のソフトウェア・コンポーネントをインストールしておく必要があります。

表 5. 必須のサード・パーティー・コンポーネント

前提条件コンポーネント説明

Microsoft Excel Cognos TM1 Perspectives で必要です。

Microsoft Visual C++ 2010 再領布可能パッケージ

Microsoft Windows での Cognos TM1 のインストール済み環境に必要です。

Microsoft .NET Framework Cognos TM1 Perspectives と Cognos TM1 Architect で必要です。

関連する Cognos TM1 コンポーネントをインストールする前に、これらのコンポーネントをダウンロードしてターゲット・システム上にインストールしてください。

デフォルト・インストール値このトピックでは、IBM Cognos TM1 インストールによって使用されるデフォルト値のセットについて説明します。

Cognos TM1 インストールは、以下のデフォルト設定値を使用します。

表 6. Cognos TM1 インストールのデフォルト設定値

項目説明とデフォルト値

デフォルトのインストール先

32 ビット Microsoft Windows システムの場合:

C:¥Program Files¥IBM¥Cognos¥TM1

64 ビット Microsoft Windows システムの場合:

C:¥Program Files¥IBM¥cognos¥tm1_64

管理サーバー・ポート番号

管理サーバーがクライアント要求を listen する TCP/IP ポート番号。

デフォルト値は 5495 です (保護なし)。

この値は IBM Cognos Configuration で設定されます。



表 6. Cognos TM1 インストールのデフォルト設定値 (続き)


管理サーバー SSL ポート番号

すべての Cognos TM1 コンポーネントが Secure Socket Layer

(SSL) を使って Cognos TM1 管理サーバーと通信する TCP/IP

ポート番号。

デフォルト値は 5498 です (セキュリティー保護)。

この値は IBM Cognos Configuration で設定されます。

Cognos TM1 サーバー・ポート番号

Cognos TM1 サーバーが実行するポート。このパラメーターは、同じコンピューター上で実行中の複数の Cognos TM1 サーバーを区別するために使用されます。有効なポート番号は 5000 から49151 までです。

デフォルトは 12345 です。

この値は Tm1s.cfg サーバー設定ファイルの PortNumber パラメーターで設定されます。

Cognos TM1 クライアント・メッセージ・ポート番号

このポート番号は、長時間の操作がキャンセルされるのを待機しているときに使用するクライアント進行状況メッセージのセカンダリー・ポートを確立します。

この値は Tm1s.cfg サーバー設定ファイルのClientMessagePortNumber パラメーターで設定されます。

デフォルト値はブランクです。

このポート番号は、Cognos TM1 サーバーの起動時にデフォルトで自動的および動的に割り当てられます。ファイアウォールなどのネットワーク上の問題が原因でリスナーポートをウェルノウン番号にしなければならない場合を除き、ClientMessagePortNumber を特定の値に設定する必要はありません。

注意:

ClientMessagePortNumber パラメーターに特定の値を設定する場合、動的に割り当てるのではなく、使用しているすべてのCognos TM1 サーバーおよびクライアントのメッセージ・ポートに固有のポート番号を割り当ててください。2 台のサーバーが 1

台のマシン上で実行され、それらが同じポート番号を使用している場合、メッセージ処理が発生したときにシステムで競合またはハングが発生する可能性があります。

管理サーバー・ホスト名 Cognos TM1 管理サーバーが実行されている管理ホストのコンピューター名または IP アドレスを指定します。

デフォルト値はブランクで、この場合、インストールが実行されるコンピューターを表すのに localhost が使用されます。

この値は Tm1s.cfg と Tm1p.cfg の設定ファイルの AdminHost

パラメーターで設定されます。




サンプル Cognos TM1

サーバー名Planning Analytics のサンプル

PlanSamp

SData

GO_New_Stores

PData

Proven_Techniques

GO_scorecards

24Retail

ログオン資格情報:

ユーザー名: admin

パスワード: apple

サンプル・サーバーのデフォルトのポート番号

PlanSamp - ポート 12354

SData - ポート 8010

GO_New_Stores - ポート 5010

PData - ポート 8011

Proven_Techniques - ポート 5011

GO_scorecards - ポート 44312

24Retail - ポート 8004

tm1s.cfg ファイルの HTTPPortNumber 値を編集して、サーバーのポート番号を変更できます。詳細については、 362ページの『HTTPPortNumber』を参照してください。

サンプル Cognos TM1

サーバーのデフォルト・データ・ディレクトリー

C:¥Program Files¥IBM¥cognos¥tm1¥samples¥tm1¥PlanSamp

C:¥Program Files¥IBM¥cognos¥tm1¥samples¥tm1¥SData

C:¥Program Files¥IBM¥cognos¥tm1¥samples¥tm1¥GO_New_Stores

C:¥Program Files¥IBM¥cognos¥tm1¥samples¥tm1¥PData

C:¥Program

Files¥IBM¥cognos¥tm1¥samples¥tm1¥Proven_Techniques

C:¥Program Files¥IBM¥cognos¥tm1¥samples¥tm1¥GO_scorecards

C:¥Program Files¥IBM¥cognos¥tm1¥samples¥tm1¥24Retail




セキュリティー・モード標準インストールでは、Cognos TM1 認証を使用します。このモードでは、ユーザーが Cognos TM1 コンポーネントにログオンするときに、ユーザー名とパスワードを求めるプロンプトがCognos TM1 サーバーによって出されます。

構成の概要IBM Cognos TM1 のインストール後、Cognos Configuration ツールと Cognos TM1

設定ファイル・パラメーターを使用して、プログラムのパフォーマンスが最適になるように設定します。

Cognos Configuration と Cognos TM1IBM Cognos Configuration ツールを使用して、各 IBM Cognos TM1 サーバーの開始、停止、設定の保存を行うことができます。

Cognos Configuration を使用して、以下のコンポーネントおよびタスクを管理できます。

表 7. Cognos Configuration タスク

コンポーネント/タスク操作

Cognos TM1 管理サーバーサーバーの開始および停止。

Cognos TM1 サーバー Cognos TM1 サーバーの開始、停止、および追加。

Cognos TM1 アプリケーション・サーバー

以下のコンポーネントをサポートする付属の WebSphere®

Liberty Web アプリケーション・サーバーの開始と停止。

v IBM Cognos TM1 Web

v IBM Cognos TM1 Applications

v IBM Cognos TM1 Operations Console

独自の Tomcat インストール済み環境または別の Web アプリケーション・サーバーを使用する場合、Cognos TM1 アプリケーション・サーバーの設定および実行は Cognos

Configuration の外部で行ってください。

構成情報の保存 Cognos Configuration ツールで構成設定を保存する場合、このツールは以下のタスクを行います。

v 設定の確認

v 暗号情報の生成

v 暗号化データの保全性の検査

v Cognos TM1 サーバーの構成の保存

v 設定ファイルのバックアップ

v 設定パラメーターの保存

v Tomcat 設定ファイルの更新


表 7. Cognos Configuration タスク (続き)

コンポーネント/タスク操作

配布用の war ファイルの作成

独自の Web アプリケーション・サーバーで Cognos TM1 アプリケーション・サーバーを配布する場合は、Cognos

Configuration を使用して、必要な Web アプリケーション(war) ファイルを作成します。

Cognos Configuration で、「操作」>「アプリケーション・ファイルを構築」をクリックします。

Cognos TM1 の設定ファイルおよび設定パラメーターIBM Cognos TM1 は、一連の設定ファイルおよび設定パラメーターを使用して、クライアント・コンポーネントおよびサーバー・コンポーネントの動作を制御します。

表 8. さまざまな Cognos TM1 コンポーネント用の設定オプションの要約

設定説明

Tm1s.cfg ファイル Cognos TM1 サーバーの設定

341ページの『付録 A. tm1s.cfg サーバー設定ファイル』を参照してください。

Tm1p.ini ファイル Cognos TM1 Architect および Cognos TM1 Perspectives に関するクライアント設定

411ページの『付録 B. Tm1p.ini クライアント設定ファイル』を参照してください。

Cognos TM1 Web

tm1web_config.xml ファイル

Cognos TM1 Web の構成および設定

124ページの『Cognos TM1 Web 構成パラメーターの変更』を参照してください。

Cognos TM1 Applications

pmpsvc_config.xml

fpmsvc_config.xml

Cognos TM1 Applications の設定ファイル

クライアント設定は、pmpsvc_config.xml ファイルに保管されます。

サーバー設定は、fpmsvc_config.xml ファイルに保管されます。

147ページの『第 11 章 Cognos TM1 アプリケーション・サーバーのインストール』および 330ページの『Cognos TM1

Applications のデータのバックアップ』を参照してください。

Cognos TM1 Operations

Console

Cognos TM1 Operations Console の設定

107ページの『付属の WebSphere® Liberty Web サーバー・ソフトウェアを使用する場合の Cognos TM1 Operations Console



Windows で Cognos TM1 サービスを実行するためのユーザー・アカウント

IBM Cognos Configuration を使用して Cognos TM1 管理サーバーおよび Cognos

TM1 サーバーを始動する際、これらは事前定義された Microsoft Windows ローカル・システム・アカウントを使用して Windows サービスとして実行されるように登録されます。特定のユーザー・アカウント下で実行されるようにこれらのサービスを手動で変更する必要があります。

注: Cognos TM1 サーバーで ODBC または ODBO による外部データ・ソースへのアクセスが必要な場合には、それらのデータ・ソースへのアクセス権を付与された特定のユーザー・アカウントの下で実行するように、手動で変更する必要があります。

特定の Windows ユーザー・アカウント下での Cognos TM1 サービスの実行

デフォルトで、Cognos Configuration は、Microsoft Windows ローカル・システム・アカウント下で実行されるように以下の Cognos TM1 サービスを登録します。



重要: Microsoft Windows 上の特定のユーザー・アカウント下で実行されるようにこれらの Cognos TM1 サービスを変更します。

Windows サービスとして実行される Cognos TM1 コンポーネントのアカウントを変更する方法について詳しくは、 87ページの『Windows で特定のユーザー・アカウントとして Cognos TM1 サービスを実行するための変更』を参照してください。

これらの変更を加えた後でも引き続き、Cognos Configuration を使用してこれらのサービスを開始および停止することができます。

特定の Windows ユーザー・アカウントに必要な権限

SQL テーブルおよびビューにアクセスするためには、Windows で Cognos TM1 サービスを実行するためのユーザー・アカウントがデータベース所有者グループに含まれている必要があります。

また、アカウントはローカル・マシンに対して次の権限を持っている必要があります。

注: Windows のバージョンによっては、これらのプロパティーの一部を使用できないものもあります (Windows Server 2008 R2 以降など)。現在使用可能なプロパティーについては、Microsoft Windows の資料を参照してください。

v オペレーティング・システムの一部として機能

v トラバース・チェックのバイパス

v 割り当て量の拡大 (プロセスのメモリー割り当て量の調整)

v プロセス・レベル・トークンの置換

v サービスとしてログオン


v Windows レジストリー項目に対する読み取りおよび書き込み権限の保持

Microsoft Windows のセキュリティー設定機能およびグループ・ポリシー機能を使用して、セキュリティー権限を設定します。例えば、Microsoft Windows 7 では、「管理ツール」>「ローカルセキュリティポリシー」をクリックしてから、「セキュリティの設定」>「ローカルポリシー」>「ユーザー権利の割り当て」をクリックして展開します。

Windows レジストリーの読み取り権限と書き込み権限を設定するには、Windows レジストリー・エディターを使用します。

ドメインなしのネットワーク上での TM1 のインストールドメイン・コントローラーを使用しないネットワークに IBM Cognos TM1 をインストールする場合、ローカル・アカウントを使用するように Cognos TM1 サービスを設定できます。

Cognos TM1 サービスの設定について詳しくは、 87ページの『Windows で特定のユーザー・アカウントとして Cognos TM1 サービスを実行するための変更』を参照してください。

Cognos TM1 サービスで 1 つまたは複数のローカル・アカウントを使用する場合、当該ローカル・マシン上で当該アカウントに次の権限があることを確認する必要があります。

v オペレーティング・システムの一部として機能

v トラバース・チェックのバイパス

v 割り当て量の増加

v プロセス・レベル・トークンの置き換え

v サービスとしてログオン

Cognos TM1 コンポーネントで使用するために Windows ネットワークでファイルの共有を設定する場合、Cognos TM1 サービスの実行のために設定する各ローカル・アカウントに共有へのアクセス権があることを確認してください。

注: Microsoft Windows ドメインに加わらないマシン上でインストールする場合、統合ログオンを使用することはできません。

ローカル・マシン構文ログオン情報を指定する際、ローカル・マシン・ドメインの省略形としてドット (.)

を使用しないでください。

マシン名は明示的に入力する必要があります。設定によっては ".¥username" という構文を使用すると重大な問題の原因となることがあります。


第 3 章アーキテクチャー

主要な IBM Cognos TM1 コンポーネントのアーキテクチャーを理解するには、ご使用の情報技術インフラストラクチャー、および IBM Cognos TM1 を使用する組織内のユーザーのビジネス・ニーズをよく理解している必要があります。

Cognos TM1 ログオン認証と通信セキュリティーについて詳しくは、 247ページの『認証セキュリティー』を参照してください。

Cognos TM1 アーキテクチャーIBM Cognos TM1 では、分散型クライアント/サーバー・アーキテクチャーを採用しており、さまざまなクライアントを組み合わせて接続することができる IBM

Cognos TM1 サーバーから構成されています。

Cognos TM1 は、以下のクライアントとユーザー・インターフェースを提供します。



v Cognos TM1 Web クライアント

v Cognos TM1 アプリケーションのポータルとワークフロー (Cognos TM1 アプリケーション・サーバーを使用)


v Cognos Insight

図 1. Cognos TM1 クライアント/サーバー・アーキテクチャーの概要


この環境では、企業データはリモート・サーバーに格納され、許可されたクライアントがそのサーバーにアクセスできます。システムのセットアップの内容によっては、クライアントは 1 つまたは複数のリモート TM1 サーバーにアクセスして、さまざまな種類のデータを取得することもできます。Cognos TM1 クライアントの詳細については、「IBM Cognos TM1 Perspectives, TM1 Architect, and TM1 Web」で説明されています。

Windows デスクトップ・クライアント

TM1 Perspectives と TM1 Architect は、ローカルの IBM Cognos TM1 サーバーに接続できます。このサーバーは、プライベートな TM1 データのリポジトリーとして作動します。適切な権限があれば、リモート・サーバーのデータを複製してローカル・サーバーにコピーし、そこで更新した結果をリモート・サーバーに戻す(同期させる)ことができます。

TM1 Perspectives、TM1 Architect、TM1 クライアントは、標準の TM1 クライアントです。通常の LAN または WAN 環境では、これらのクライアントはすべてTCP/IP ネットワーク・プロトコルを使用してリモート・サーバーと通信します。

Cognos TM1 管理サーバーの概要IBM Cognos TM1 管理サーバーは、ネットワーク上で実行されているすべてのCognos TM1 サーバーを追跡するプロセスです。管理サーバーは、管理ホストと呼ばれるコンピューター上で実行されます。

Cognos TM1 サーバーが開始すると、サーバーは指定された管理ホスト上で実行している管理サーバーにサーバー自体を登録します。TM1 クライアントは管理サーバーを参照して、ネットワーク上で使用可能な Cognos TM1 サーバーを確認します。

管理サーバーは、使用可能な各 Cognos TM1 サーバーについて次の情報を保持しています。

v サーバー名

v IP アドレス

v プロトコル

v ポート番号

これらはすべて、管理サーバーへの登録時に Cognos TM1 サーバーが提示する情報です。

管理サーバーが実行されていないと、Cognos TM1 サーバーは開始されません。Tm1s.cfg ファイルまたはサーバー・コマンド行で管理ホストが指定されている場合、Cognos TM1 サーバーはそのホスト上の管理サーバーへの接続を試みます。何らかの理由で管理サーバーに接続できない場合、Cognos TM1 サーバーは起動できません。

管理ホストが指定されていない場合、Cognos TM1 サーバーはローカル・マシン上の管理サーバーへの接続を試みます。管理サーバーが現在ローカル・マシン上で実行されていなければ、Cognos TM1 サーバーは新しい管理サーバーを起動し、そのサーバーに接続します。


管理サーバーは、Cognos TM1 サーバーからの通知を listen することで、このサーバーがネットワーク上にあることを認識します。通常は、Cognos TM1 サーバーは存在通知を「ハートビート間隔」と呼ばれる一定間隔 (デフォルトは 60 秒) で送信します。管理サーバーによって検出された Cognos TM1 サーバーは登録され、ネットワーク上のクライアントから使用できるようになります。しかし、登録されたCognos TM1 サーバーであっても、その存在をハートビート間隔の 3 倍の時間にわたって管理サーバーが検出しない場合、その Cognos TM1 サーバーはネットワーク上の使用可能なサーバー・リストから削除されます。その結果、その Cognos TM1

サーバーは、ネットワーク上のクライアントから使用できなくなります。

管理サーバーは、ポート 5495 をデフォルトで使用します。ポート 5495 が既に使用されている場合は、Tm1admsrv という新しいサービスを作成して、新しいポート番号を割り当てることができます。すべての Cognos TM1 アプリケーションはTm1admsrv という名前付きサービスを検索し、そのサービスが存在している場合は、そのサービスに割り当てられているポート番号を使用します。そのサービスが存在しない場合は、ポート 5495 が Cognos TM1 アプリケーションで使用されます。

Cognos TM1 サーバーの概要IBM Cognos TM1 サーバーは、Cognos TM1 クライアントのために Cognos TM1

データ・ディレクトリーへのアクセスを管理します。

次の図に、リモート Cognos TM1 サーバーの動作を示します。それぞれの動作については、図に続く本文で説明します。

v リモート・サーバーが、始動時に、データ・ディレクトリーにあるディメンションとキューブをサーバー・マシンの RAM にロードします。同時に、「Tm1s.log」という新しいトランザクション・ログ・ファイルをデータ・ディレクトリー内に開きます。キューブのロード処理が終了したら、リモートサーバーが使用可能になります。

図 2. リモート・サーバーの動作

第 3 章アーキテクチャー 25

v クライアントがリモート Cognos TM1 サーバーに接続できるように、リモートCognos TM1 サーバーが自らを 1 つまたは複数の管理サーバーに登録します。

v クライアント・アプリケーションが管理サーバーと交信して、使用可能な Cognos

TM1 サーバーを探します。クライアントは、アクセスするデータがある Cognos

TM1 サーバーにログインします。

v クライアントがキューブ・データを編集し、値を Cognos TM1 サーバーに送り返します。

v 新しい値をクライアントから受信した Cognos TM1 サーバーは、そのレコードを「Tm1s.log」ファイルに書き込み、すべてのデータ変更を追跡します。記録される内容には、編集が行われた日時および編集を行ったクライアントの ID も含まれます。

v クライアントからの要求に応えて新しい値を計算したサーバーが、その結果をメモリー内に格納します (これにより、サーバーで使用されているメモリー量が増加します)。

v サーバーがシャットダウンすると、「Tm1s.log」ファイルのすべてのレコードがディスクに保存され、トランザクション・ログ・ファイルの名前が変更されます(名前の末尾に日時スタンプが追加されます)。「Tm1s.log」ファイルは、データ・トランザクションをバックアウトできるように、サーバーのデータ・ディレクトリーに保存されます。詳細については、「IBM Cognos TM1 Operations」の『トランザクション・ログからのレコードのバックアウト』のトピックを参照してください。

変更点を保存せずに、サーバーを意図的にシャットダウンすると、ログ・ファイルは、時刻/日付のタイムスタンプが付けられ、拡張子が rej に変更されて保存されます。トランザクションは、TurboIntegrator で「syyyymmddhhmmss.rej」ファイルを処理して回復できます。

v Cognos TM1 サーバー上のすべてのデータ変更を、サーバーを停止せずに任意のタイミングで保存するには、サーバー・エクスプローラーでそのサーバーを右クリックし、「データの保存」をクリックします。「Tm1s.log」ファイル内のすべてのレコードがただちにディスクに書き込まれ、トランザクション・ログ・ファイルの名前が変更 (末尾に日付/時刻タイム・スタンプが追加) されます。また、それ以降のキューブ値への編集内容を記録するために新しい「Tm1s.log」ログ・ファイルが作成されます。

メタデータ (ディメンション定義、キューブ定義など) への変更は、その場でディスクに保存されます。メタデータの変更内容は、トランザクション・ログ・ファイルに書き込まれません。

Cognos TM1 ファイルの概要IBM Cognos TM1 には、多数のオブジェクト・ファイルとシステム・ファイルが必要です。それらのファイルの多くは、Cognos TM1 サーバーのデータ・ディレクトリーに格納されています。

製品と一緒にインストールされるものと、ディメンションやキューブを作成するたびに生成されるものがあります。また、セキュリティー情報などのメタデータを格納する目的で、Cognos TM1 によって生成されるファイルもあります。


次の表に、キューブ、ディメンションなどの Cognos TM1 オブジェクトを定義するファイルを示します。これらのファイルは、データ・ディレクトリーにあります(データ・ディレクトリーについては、このセクションで後述します)。

表 9. キューブ、ディメンション、およびその他のオブジェクトを定義するファイル

ファイル拡張子説明

.blb キューブのフォーマット・ファイル

.cho 日課の定義ファイル

.cub キューブのデータベース・ファイル

.dim コンパイルされたディメンション

.dit ディメンションの ASCII ソース・ファイル

.pro TurboIntegrator プロセスの定義ファイル

.rux コンパイルされた規則

.sub ディメンション・サブセット

.tbu ビュー・ファイルの ASCII ソース

.tqu 保存されたクエリー

.tru 規則ファイルの ASCII ソース

.vue 保存されたビュー

.xdi Excel のディメンション・ワークシート

.xru Excel の規則ワークシート

データ・ディレクトリーの概要データ・ディレクトリーには、Cognos TM1 サーバーの始動時にメモリーにロードされるキューブ、ディメンション、およびシステム情報が格納されています。Cognos TM1 クライアントからサーバーにアクセスすると、Cognos TM1 はそのサーバーのデータ・ディレクトリーからデータを読み込みます。

Cognos TM1 を実行しているときにキューブの値を変更すると、その内容がメモリーとトランザクション・ログ (Tm1s.log) にただちに格納されます。その後、次のような状況が発生すると、Cognos TM1 は、データを元のデータ・ディレクトリーに保存します。

v Cognos TM1 サーバーがシャットダウンする場合。


v 管理者がサーバー・エクスプローラーでサーバー・アイコンを右クリックし、ポップアップ・メニューから「データの保存」を選択した場合。この操作により、選択されているサーバーに変更点を保存するよう Cognos TM1 に指示が送られます。

v 管理者がサーバー・エクスプローラーで「ファイル」→「全データの保存」を選択した場合。この操作により、適切な権限を持っている場合にはすべての接続済みサーバーに変更点を保存するよう Cognos TM1 に指示が送られます。

v ユーザーがバッチ更新を保存した場合。

データ・ディレクトリーのパスは、Cognos TM1 のインストール時に選択します。

表 10. データ・ディレクトリーのデフォルトのパス

データ・ディレクトリーデフォルト・パス

Cognos TM1 ローカル・サーバー <インストール場所>¥custom¥tm1data¥pdata

Windows Cognos TM1 リモート・サーバー(サンプル・データ用)

<インストール場所>¥custom¥tm1data¥sdata

UNIX Cognos TM1 サーバー <インストール場所>/custom/tm1data/sdata

必要なネットワーク・アクセス権限クライアントがデータを保存できるかどうかは、IBM Cognos TM1 セキュリティー・スキームによって決まります。

詳しくは、「IBM Cognos TM1 Developer」を参照してください。

重要: このディレクトリーは、管理者、およびサーバーで使用されたログオンに対してのみ表示するようにしてください。

複数のデータ・ディレクトリーIBM Cognos TM1 で複数のデータ・ディレクトリーを使用するよう指定するには、ディレクトリー名をセミコロンで区切ります。複数のデータ・ディレクトリーを指定すると、Cognos TM1 は次の処理を実行します。

v 指定された各ディレクトリーのキューブとディメンションにアクセスします。オブジェクトが重複している場合は、Cognos TM1 は、指定された最初のディレクトリーのオブジェクトにアクセスします。

v 変更内容は、該当するオブジェクトがあるディレクトリーに書き込みます。新しいオブジェクトが作成された場合は、Cognos TM1 は、指定されていた最初のディレクトリーに書き込みます。

例えば、ディメンションは tm1dims というディレクトリーに格納し、キューブはtm1cubes というディレクトリーに格納するとします。その場合は、Tm1s.cfg ファイルで次のように指定します。

DatabaseDirectory="c:\tm1dims;c:\tm1cubes"

2 つのディレクトリーを連結すると、場所が 1 つのときと同じように、サーバー・エクスプローラーからこれらのオブジェクトにアクセスできます。


注: キューブ (.cub) ファイルと規則 (.rux) ファイルを別個のデータ・ディレクトリーに保存することはできません。 .rux ファイルは、関連付けられている .cub ファイルと同じディレクトリーになければなりません。 .rux ファイルが、関連付けられている .cub ファイルと同じディレクトリーにない場合、規則は正しくロードできません。

データ・ディレクトリーの場所データ・ディレクトリーの場所を指定する方法は、ローカル・サーバーとリモート・サーバーで異なります。

v ローカル・サーバーの場合は、Tm1p.ini ファイルの DataBaseDirectory パラメーターでディレクトリーの名前を指定して、データ・ディレクトリーの場所を設定します。

.ini ファイルは、サーバー・エクスプローラーの IBM Cognos TM1 のオプションメニューで変更できます。

詳細については、 411ページの『付録 B. Tm1p.ini クライアント設定ファイル』を参照してください。

v リモート・サーバーの場合は、Tm1s.cfg ファイルの DatabaseDirectory パラメーター、またはサーバーを起動するときの -d コマンド・ライン・パラメーターのいずれかで、データ・ディレクトリーの場所を指定します。

サーバー・パラメーターの詳細については、 341ページの『付録 A. tm1s.cfg サーバー設定ファイル』を参照してください。

リモート・サーバーは、データ・ディレクトリーが存在するドライブを認識できる必要があります。ディレクトリーがリモート・ドライブ上にある場合は、そのドライブにローカルのドライブ文字を割り当てる必要があります。

ヒント: リモート・サーバーへのアクセスは、サーバー・データ・ディレクトリーがあるドライブにマッピングしていなくても実行できます。

データ・ディレクトリーの場所を指定しなかった場合は、次のエラー・メッセージが表示され、Cognos TM1 サーバーは起動できません。

Data Directory not specified. Aborting server startup.

Cognos TM1 Web アーキテクチャーIBM Cognos TM1 Web は、サポートされているいずれかの Web ブラウザーを使ってユーザーが Cognos TM1 データにアクセスして対話できる多階層アーキテクチャーを使用します。

IBM Cognos TM1 Web 多階層アーキテクチャーには、Web クライアント層、Web

アプリケーション・サーバー層、およびデータ・コンポーネント層が含まれます。


層 1: Web クライアント

Web クライアント層では、サポートされているいずれかの Web ブラウザーを使ってユーザーが Cognos TM1 データにアクセスして対話することができます。ユーザーは Cognos TM1 キューブおよび Cognos TM1 Web シートを処理することができます。

現在サポートされている Web ブラウザーについては、Software Environments for

IBM Planning Analytics 2.0 (http://www.ibm.com/support/


層 2: Web アプリケーション・サーバー

Cognos TM1 Web は、Java ベースの Web アプリケーション・サーバー上で実行します。

この層は、Microsoft Excel ワークシートを変換して Cognos TM1 Web シートとして表示するためのサポートを提供しています。このサービスは、Web シートからMicrosoft Excel 形式および PDF 形式へのエクスポートも実行します。

層 3: データ

この層には、Cognos TM1 管理サーバー、および少なくとも 1 台の Cognos TM1

サーバーが含まれます。

IBM Cognos TM1 管理サーバー

Cognos TM1 管理サーバーは LAN上の任意のコンピューターにインストールできますが、Cognos TM1 サーバーと同じ LAN セグメントに存在することが必要です。一般的に、Cognos TM1 サーバーと Cognos TM1 管理サーバーは同じコンピューター上にインストールされます。

IBM Cognos TM1 サーバー

図 3. Cognos TM1 Web アーキテクチャー概要図




Cognos TM1 サーバーは、Web サーバーをホストするものと同じコンピューターにインストールすることもできますが、別のコンピューターにインストールした方がより効率的です。

Cognos TM1 Web 環境で使用される Cognos TM1 サーバーのバージョンは、実行している Cognos TM1 Web のバージョンと同じか、それより新しくなければなりません。実行する Cognos TM1 Web のバージョンがCognos TM1 サーバーのバージョンより新しい場合は、Cognos TM1 Web

にログオンしようとするとエラーになります。

Cognos TM1 Web からの複数の Cognos TM1 サーバーへのアクセス

IBM Cognos TM1 Web では複数データベースをサポートしているため、同じCognos TM1 管理サーバーに登録され、ユーザー名とパスワードの組み合わせが同じであれば、ユーザーは複数の Cognos TM1 サーバーにアクセスできます。

Cognos TM1 Web にログインすると、ログイン画面で選択したプライマリー・サーバーのナビゲーション・ウィンドウが表示されます。ただし、入力したユーザー名とパスワードの組み合わせが、同じ Cognos TM1 管理サーバーに登録されている他の Cognos TM1 サーバーに一致する場合は、IBM Cognos TM1 Web では、必要に応じて、それらの他のサーバーにも自動的にログインされます。この動作は、他のCognos TM1 サーバーにログインする際に手動による手順を別途実行する必要がある Cognos TM1 Architect や Cognos TM1 Perspectives とは異なります。

複数データベースのサポートは主として Web シートに適用されますが、それは、Web シートには、他の Cognos TM1 サーバーを指す Cognos TM1 式や参照を含めることが可能なためです。例えば、同じ管理サーバーに登録されている別のサーバーへの Cognos TM1 参照を含んだ Web シートを開くと、Cognos TM1 Web は、現在のユーザー名とパスワードを使用して、そのサーバーにユーザーをログインさせようとします。

Cognos TM1 Web からのアクセスを 1 つの Cognos TM1 サーバーに限定する方法

IBM Cognos TM1 Web ユーザーが複数データベース・サポートを使用して、同じ管理サーバーに登録されている他の Cognos TM1 サーバーにアクセスできないようにするには、各 Cognos TM1 サーバーを別々の管理サーバーに登録します。

例えば、その構成で Cognos TM1 Web にログインし、別の管理サーバーに登録されている別の Cognos TM1 サーバーを参照する Web シートを開こうとした場合は、参照先のサーバーのユーザー名とパスワードが同じでもデータは表示されません。

ヒント: Cognos TM1 サーバーを別の管理サーバーの下で実行するように構成した際、そのサーバーに Cognos TM1 Web、Cognos TM1 Architect、または Cognos

TM1 Perspectives からアクセスすることが必要な場合は、 AdminHost パラメーターを使用することができます。このパラメーターでは、複数の管理ホストを指定できるため、その指定ホスト上の管理サーバーに登録されている任意の Cognos TM1 サーバーにユーザーがアクセスできます。


v IBM Cognos TM1 Web を設定して複数の管理サーバーにアクセスする方法の詳細については、「IBM Cognos TM1 Operation」の『AdminHostName およびTM1ServerName を使用したログイン・ページの設定』を参照してください。

v 複数の管理サーバーにアクセスするように Cognos TM1 Architect と Cognos

TM1 Perspectives を設定する方法について詳しくは、 102ページの『複数のCognos TM1 管理ホストの指定』を参照してください。

Cognos TM1 Applications のアーキテクチャーIBM Cognos TM1 Applications には、Web クライアント、Web アプリケーション・サーバー、およびデータの 3 つの層から成る多層アーキテクチャーがあります。

以下の図は、すべての Cognos TM1 Applications コンポーネントの多層アーキテクチャーと基本的な通信パスを示しています。

Cognos TM1 Applications のアーキテクチャーの図に示されている線は、Cognos

TM1 アプリケーション・サーバーが管理するタスク (ワークフロー状態の追跡など)

で必要な一般的な通信パスを主に示しています。

こうした通信回線に加えて、Cognos TM1 Performance Modeler および Cognos

Insight は、基礎となる Cognos TM1 サーバーに常時直接接続する必要があります。例外として、Cognos Insight を分散モードで使用する場合、Cognos TM1 サーバーへの常時接続は不要です。

図 4. Cognos TM1 Applications のアーキテクチャー概要図


Cognos TM1 Applications 層 1: Web クライアントWeb クライアント層には、IBM Cognos TM1 Applications のすべてのユーザー・インターフェースが含まれています。これらのユーザー・インターフェースは、エンド・ユーザー、管理者、プランニング・アプリケーション開発者によって使用されます。


Cognos TM1 Applications のメイン・クライアントは、Java ベースの Web アプリケーション・サーバー (インストールに含まれている WebSphere Liberty など) でサポートされている Web ブラウザー・ベースのユーザー・インターフェースです。Cognos TM1 Applications のユーザー・インターフェースは、2 つの主なサブページと 3 つの異なるデータ・コントリビューション・クライアントで構成されています。

Cognos TM1 Applications ページ

Cognos TM1 Applications のページ (ポータル・ページ) は、管理者と非管理者の両方のユーザーにとっての主要な開始点です。このページは、現在のユーザー用にフィルタリングされた使用可能なアプリケーションの一覧を提供します。このページ内のアプリケーションをクリックしてワークフロー・ページを開きます。

管理者とアプリケーション開発者は、Cognos TM1 Applications のツールバーから Cognos TM1 Performance Modeler および Cognos Insight を開くこともできます。

Cognos TM1 Application ページ

Cognos TM1 Application のページ (ワークフロー・ページ) を使用すると、1 つのアプリケーション内で複数のタスクを管理できます。このクライアントは、ユーザーが特定の計画で関与や検査を行う責任がある各ノードを表示します。アプリケーションの設定方法によっては、ユーザーはこのクライアント内のアクセス可能なノードに関して、Cognos Insight クライアントまたは Cognos TM1 Application Web クライアントを開くことができます。

データ・コントリビューション・クライアント

ユーザーがグリッドおよびグラフの形式でデータを扱えるようにするCognos TM1 Applications のデータ・コントリビューション・クライアントについて、以下の表にまとめます。

表 11. Cognos TM1 Applications - データ・コントリビューション・クライアント

クライアント説明

IBM Cognos TM1

Application Web

デフォルトのクライアント。サーバーとの処理がリアルタイムで行われます。ユーザーは、Cognos TM1 Web のインフラストラクチャーに基づく Cognos TM1 キューブ・ビューまたは TM1

Websheet を使用して、アプリケーション・データをグリッド形式で表示/編集できます。


表 11. Cognos TM1 Applications - データ・コントリビューション・クライアント (続き)

クライアント説明

IBM Cognos Insight - 接続

IBM Cognos Insight クライアント。サーバーとの処理がリアルタイムで行われます。ユーザーは、アプリケーション・データをダッシュボード形式またはワークスペース形式で表示/編集できます。

このクライアントは、Cognos TM1 Application Gateway からプロビジョンしてインストールすることも、システム管理者がWindows Installer コマンド行ツールおよび他のソフトウェア管理ツールを使用してリモートでインストールすることもできます。

IBM Cognos Insight - 分散

データをローカルで処理する IBM Cognos Insight クライアント。データのコミット操作を実行した場合にのみ、サーバーに対してデータの更新が行われます。

プロビジョニングとインストールのオプションは、「Cognos

Insight - 接続」のクライアントと同じです。

Cognos TM1 Performance Modeler

Cognos TM1 Performance Modeler クライアントは、管理者および開発者がアプリケーションを設計および配布するためのユーザー・インターフェースを提供します。

このユーザー・インターフェースは、ユーザーのコンピューター上にローカルにインストールする必要があります。ユーザーは、このクライアントを初めて開くときに Cognos TM1 アプリケーション・ゲートウェイからクライアントをプロビジョンしてインストールできます。システム管理者が Windows Installer および他のソフトウェア管理ツールを使用してリモートでこのプログラムを配布およびインストールすることもできます。詳しくは、 195ページの『Cognos TM1 Performance Modeler


Cognos Insight

Cognos Insight を Cognos TM1 Applications とは別に実行して、アプリケーション内で使用するワークスペースをユーザーが作成できるようにすることができます。

このユーザー・インターフェースは、ユーザーのコンピューター上にローカルにインストールする必要があります。このクライアントを初めて開くときに、ユーザーがこれを Cognos TM1 アプリケーション・ゲートウェイからプロビジョンしてインストールすることができます。システム管理者が Windows Installer コマンド行ツールおよび他のソフトウェア管理ツールを使用してリモートでこのプログラムを配布およびインストールすることもできます。詳しくは、 200ページの『Cognos

Insight のインストール』を参照してください。

Cognos TM1 Applications 層 2: Web サーバーWeb サーバー層には、必須の Java ベースの Web アプリケーション・サーバーが含まれています。


Java Web アプリケーション・サーバー

以下のコンポーネントが、Java ベースの Web アプリケーション・サーバーを必要とします。インストールに含まれているバージョンの WebSphere Liberty を使用することも、Java ベースのサポート対象の Web アプリケーション・サーバーのいずれかを独自にインストールして使用することもできます。

Cognos TM1 アプリケーション・サーバーIBM Cognos TM1 Applications の基本的なサポートを提供する Java ベースの Web アプリケーション。

Cognos TM1 アプリケーション・ゲートウェイリモート・エンド・ユーザーに対して Cognos TM1 Performance Modeler コンポーネントおよび Cognos Insight コンポーネントのプロビジョニングを提供する Java ベースの Web コンポーネント。

Cognos TM1 Application Web クライアントアプリケーション・データを表示および編集するための、Cognos TM1 Web

テクノロジーに基づくオプションのユーザー・インターフェース。このオプションを使用している場合は、それに対するサポート・ファイルが同じWeb アプリケーション・サーバー上で実行されます。

Cognos Analytics が提供するセキュリティーおよび Web サーバーの使用

IBM Cognos セキュリティーを使用する Cognos TM1 Server と一緒に Cognos TM1

Applications を使用する場合は、IBM Cognos に用意されている WebSphere Liberty

Web サーバーで Cognos TM1 Application Server を配布できます。詳しくは、 292

ページの『Cognos TM1 Applications での Cognos セキュリティーの使用』を参照してください。

Cognos TM1 Applications 層 3: データIBM Cognos TM1 Applications のデータ層には、IBM Cognos TM1 管理サーバーと、Microsoft Windows または UNIX ベース・システムのいずれかで実行されている 1 つ以上の IBM Cognos TM1 サーバーが含まれます。 Cognos TM1 アプリケーション・サーバーおよび関連するクライアント・インターフェースは、データ層のコンポーネントと通信して Cognos TM1 データにアクセスします。

Cognos TM1 管理サーバー

Cognos TM1 管理サーバーは、ネットワーク上で実行されるすべての Cognos TM1

サーバーを追跡するプロセスです。Cognos TM1 アプリケーション・サーバーはCognos TM1 管理サーバーに連絡して、ネットワーク上で使用可能な Cognos TM1

サーバーを決定します。

Cognos TM1 サーバー

Cognos TM1 サーバーには、Cognos TM1 Applications を使用して構築および配布するアプリケーションのデータが含まれています。


第 4 章配布

このセクションでは、使用可能な IBM Cognos TM1 コンポーネントの一般的なインストールと配布のシナリオのいくつかを説明します。このセクションは、異なるコンピューター環境での Cognos TM1 のインストールと設定を計画する上で、また最大限のパフォーマンスを得る上で役に立ちます。

コンポーネントのインストールと配布は、1 台のコンピューターに対して、またネットワーク環境の複数のコンピューターに対して行えます。

各コンポーネントを別々のコンピューターにインストールする場合、それぞれのコンピューターで Cognos TM1 インストール・ウィザードを実行します。

サーバー・コンポーネント

以下のサーバー・コンポーネントを個別の専用コンピューターにインストールすることができます。

v Cognos TM1 管理サーバーと Cognos TM1 サーバー

v Cognos TM1 Web

v Cognos TM1 アプリケーション・サーバー

クライアント・コンポーネント

以下のクライアント・コンポーネントを複数のコンピューターにインストールすることができます。




v Cognos Insight

1 台の Windows コンピューターへの Cognos TM1 の配布Microsoft Windows を実行する 1 台のコンピューターへの IBM Cognos TM1 コンポーネントのインストールは、PoC (概念検証)、テスト、デモンストレーション、開発、研修環境にとって実用的なアプローチです。

Windows では、Cognos TM1 32 ビットまたは 64 ビットのインストール・プログラムを使用できます。

1 台の Windows コンピューターへのインストールは主に、サポートされている 32

ビットまたは 64 ビットの Windows オペレーティング・システムのいずれかの単一ユーザー向けです。例えば、Microsoft Windows XP、Windows Vista、またはWindows 7 です。しかしながら、これらはサーバー・クラスの実動レベルのオペレーティング・システムではなく、このタイプの配布は複数ユーザーがいる実稼働環境では使用せず、個人使用の場合に限る必要があります。


一般的な 1 台のコンピューター上のインストール

1 台の Windows コンピューター上の一般的な Cognos TM1 インストールには、以下のコンポーネントが含まれます。

TM1 データ層



v Cognos TM1 ツール

v TM1 サンプル

TM1 Web 層

v TM1 アプリケーション・ゲートウェイ

v TM1 アプリケーション・サーバー

v TM1 Web

v Cognos Access Manager

TM1 リッチ層

v TM1 Architect

v Performance Modeler

v TM1 Perspectives

v Cognos Insight

v TM1 API

どのコンポーネントをインストールするかは、特定の必要に応じて調整できます。

64 ビット・インストールの配布と 32 ビット・インストールの配布の違い

64 ビット・システムですべての TM1 コンポーネントを使用できるわけではありません。コンポーネントを 64 ビット・インストールとして使用できる場合、デフォルトのインストール・ディレクトリーは、32 ビット・インストールで使用されるデフォルトのインストール・ディレクトリーと異なります。

Cognos TM1 管理サーバーと TM1 サーバーの配布IBM Cognos TM1 管理サーバー・コンポーネントと Cognos TM1 サーバー・コンポーネントを、ご使用のハードウェア環境にある Microsoft Windows と UNIX のコンピューターに別々にインストールできます。

各コンポーネントを別々のコンピューターにインストールする場合、それぞれのコンピューターで Cognos TM1 インストール・ウィザードを実行します。

Cognos TM1 サーバーがインストールされたのと同じコンピューター上に Cognos

TM1 管理サーバーをインストールすることも、ネットワーク上の別のコンピューターにインストールすることも可能です。


Cognos TM1 サーバーが実行中の場合、これは指定された管理サーバーに自らを登録します。 Cognos TM1 クライアントがその後にこの同じ管理サーバーに接続して、ネットワーク上で使用可能な Cognos TM1 サーバーに関する情報を取得します。

ネットワーク全体でサーバー・コンポーネントを配布する場合、コンポーネントがインストールされる場所、およびそれらのコンポーネントの構成についての特定の情報を把握している必要があります。各コンポーネントをインストールするのに必要な情報は、次のとおりです。

表 12. Cognos TM1 サーバー・コンポーネントのインストール

コンポーネント説明

Cognos TM1 サーバー Cognos TM1 サーバーをインストールして設定するには、Cognos

TM1 管理サーバーが実行されているコンピューターの名前を把握しなければなりません。

Cognos TM1 管理サーバー

これは、お使いのネットワークトポロジーの知識がなくてもインストールできます。

分散インストールの重要な注意事項

Cognos TM1 サービスは、同じロケールに設定されたコンピューター上で実行する必要があります。例えば、一部のサービスを英語 (米国) ロケールで実行するコンピューター上にインストールし、その他のサービスをドイツ語ロケールで実行するコンピューター上にインストールすることはできません。Microsoft Windows の「スタート」メニューから「地域と言語のオプション」にアクセスし、「標準と形式」オプションを使用してロケールを設定します。

Cognos TM1 Web の配布要件に応じて、IBM Cognos TM1 Web をいくつかの方法で配布できます。

Cognos TM1 Web の配布方法は、コンポーネントの使用計画によって異なります。一般的な配布シナリオは次のとおりです。

v ユーザーが Web ブラウザーを使って Cognos TM1 データにアクセスするための1 次 Web ベース・インターフェースとして使用する。

詳しくは、 117ページの『第 10 章 Cognos TM1 Web のインストール』を参照してください。

v IBM Cognos TM1 Applications で IBM Cognos TM1 Application Web クライアントをサポートするために使用する。

Cognos TM1 Application Web クライアントは、Cognos TM1 Web のインフラストラクチャーを使用します。詳細については、 32ページの『Cognos TM1

Applications のアーキテクチャー』および 147ページの『第 11 章 Cognos TM1

アプリケーション・サーバーのインストール』を参照してください。

v IBM Cognos Analytics コンポーネントとの統合 (Cognos TM1 Viewer Portlets やiWidgets の使用など) をサポートするために使用する。

第 4 章配布 39

詳しくは、 73ページの『Cognos TM1 iWidgets and Cognos Workspace』を参照してください。

Cognos TM1 Applications の配布固有のネットワーク環境とビジネス要件に応じて、IBM Cognos TM1 Applications

を 1 つのコンピューター上にインストールすることも、ネットワーク内の複数のコンピューター上に別々にこれらのコンポーネントを分散させることもできます。

Cognos TM1 Applications を使用する際のセキュリティーの考慮事項

Cognos TM1 Applications で使用する Cognos TM1 サーバーには、IBM Cognos

TM1 標準セキュリティー認証、または IBM Cognos セキュリティーのいずれかを使用できます。

同一の Cognos TM1 Applications のインストールに対して、異なるセキュリティー認証モードを組み合わせて使用しないでください。

Cognos TM1 Applications で Cognos TM1 サーバーを使用するように設定する前にセキュリティー・モードを決定して、追加するその他のサーバーでもその同じセキュリティー・モードを使用します。

Cognos セキュリティーの使用方法については、 292ページの『Cognos TM1

Applications での Cognos セキュリティーの使用』を参照してください。

Cognos TM1 Applications で IntegratedSecurityMode パラメーターを使用する

使用する各 Cognos TM1 サーバーの Tm1s.cfg ファイルで IntegratedSecurityMode

パラメーターを使用して Cognos TM1 セキュリティー認証モードを設定します。

重要: Cognos TM1 Applications コンポーネントは、Cognos TM1 セキュリティー認証モード 1 および 5 にのみ対応しています。

例えば、Cognos TM1 標準セキュリティー認証を使用するには、各サーバーでIntegratedSecurityMode パラメーターに 1 を設定します。

IntegratedSecurityMode=1

IBM Cognos セキュリティーを使用する場合は、IntegratedSecurityMode パラメーターに 5 を設定します。


IntegratedSecurityMode パラメーターの詳細については、「IBM Cognos TM1

Operations」の『TM1 システムの設定』のセクションを参照してください。

IBM Cognos TM1 サーバーおよび IBM Cognos TM1 Applications でIntegratedSecurityMode=5 が使用される場合、「権限の管理」ダイアログでネイティブ TM1 グループに権限を割り当てることはできません。 TM1 サーバーにインポートされている Cognos グループのみが使用可能になります。これは、使用でき


るグループが SecMode によって制限されるため、ネイティブ TM1 グループとCognos グループを同時に使用できないことを意味しています。

複数の Cognos TM1 サーバーに対する Cognos TM1 Applicationsセキュリティーの設定

複数の Cognos TM1 サーバーを Cognos TM1 Applications で使用する場合には、すべて同じセキュリティー認証 (Cognos TM1 標準認証か Cognos セキュリティーのどちらか) を使用するように設定し、同じ管理者のユーザー名とパスワードを入力する必要があります。

詳細については、 170ページの『複数の Cognos TM1 サーバーを使用するようにCognos TM1 Application Web を設定する』を参照してください。

1 台のコンピューター上へのすべての Cognos TM1Applications コンポーネントの配布

開発、テスト、またはデモの目的で、Microsoft Windows を実行している 1 台のコンピューター上に、IBM Cognos TM1 Applications で必要なすべてのコンポーネントをインストールすることができます。

インストール・プログラム

1 台のコンピューター上に Cognos TM1 Applications を配布するのは、プログラムを稼働するための最も時間のかからない方法です。

Windows 用の 32 ビットまたは 64 ビットの Cognos TM1 インストール・プログラムを使用して、Cognos TM1 Applications を Windows ベースの 1 台のコンピューター上にインストールします。

必須の Cognos TM1 コンポーネント

Cognos TM1 Applications を Windows ベースの 1 台のコンピューター上に配布して実行するには、以下のコンポーネントが必要です。




v Cognos TM1 アプリケーション・ゲートウェイ

v Cognos TM1 Web

v Cognos TM1 サンプル・データベース (オプション) - テストのためにサンプルのCognos TM1 サーバーを簡単に実行できます。

デフォルトでは Cognos Configuration ツールが必要であり、この設定の場合は自動的にインストールされます。インストールの完了後、Cognos Configuration を使用して、 Cognos TM1 アプリケーション・サーバーを配布して開始し、Cognos TM1 サーバーを管理します。

Cognos TM1 Applications で使用するバージョンの WebSphere Liberty Web アプリケーション・サーバーも自動的にインストールされます。

第 4 章配布 41

Cognos TM1 Web が必要となるのは、Cognos TM1 Applications Web クライアントを使用する予定の場合のみです。

必要な Web アプリケーション・サーバー

Cognos TM1 Applications は、Java ベースの Web アプリケーション・サーバーを必要とします。

Cognos TM1 Applications を、以下のいずれかの Java ベースの Web アプリケーション・サーバーに配布できます。

v インストールに含まれているバージョンの IBM WebSphere Liberty

v 独自の Apache Tomcat インスタンス

v 独自の IBM Websphere Liberty インスタンス

別個のコンピューター上への各 Cognos TM1 Applications コンポーネントの配布

個別の専用コンピューター上に IBM Cognos TM1 Applications コンポーネントの一部またはすべてを配布することで、性能、可用性、容量を向上させることができます。

ネットワーク環境やビジネス要件に応じて、さまざまな方法で TM1 Web 層とTM1 データ層を複数のコンピューターに分散させることができます。

TM1 Web 層と TM1 データ層を別々のコンピューターに配布

この設定では、Cognos TM1 Applications 用と IBM Cognos TM1 Web 用の Java

Web アプリケーション・サーバーを同じコンピューター上にまとめて配置しますが、TM1 データ層 (Cognos TM1 サーバー) は別のコンピューターに配置します。

各 Web アプリケーション・サーバーを別個のコンピューターに配布

この設定では、Cognos TM1 Applications 用および Cognos TM1 Web 用の Java

Web アプリケーション・サーバーをそれぞれ独自のコンピューターに配置します。TM1 データ層は、これらのいずれかのコンピューターにインストールすることも、専用のコンピューターにインストールすることもできます。

すべてのコンポーネントをそれぞれ別個のコンピューターに配布

この設定では、Cognos TM1 Applications 用および Cognos TM1 Web 用の Java

Web アプリケーション・サーバー、Cognos TM1 管理サーバー、および Cognos

TM1 サーバーを、すべて別個のコンピューター上に配置します。

Cognos TM1 Applications の配布に関するチェックリスト

IBM Cognos TM1 アプリケーション・サーバーおよび関連コンポーネントを別個のコンピューターにインストールするには、以下のチェックリストを使用します。


表 13. IBM Cognos TM1 Applications を配布するためのインストール・シナリオ

インストール・シナリオインストール・ステップ

すべての Java Web アプリケーションを一緒に別個のコンピューター上で実行する

Cognos TM1 インストール・プログラムを使用して、Cognos TM1 アプリケーション・サーバー、Cognos TM1

アプリケーション・ゲートウェイ、および Cognos TM1

Web を、Java Web アプリケーション・サーバーを実行しているコンピューター上にインストールします。

Cognos TM1 Web を別個のコンピューター上で実行する

Cognos TM1 インストール・プログラムを使用して、Cognos TM1 Web を別個のコンピューター上にインストールします。

インストール・ウィザードによって、Cognos TM1

Application Web クライアント (アプリケーション・データを表示/編集するためのクライアント・インターフェースの 1 つ) に必要なファイルがインストールされます。

TM1 データ層を別のコンピューターで実行する

TM1 インストール・プログラムを使用して、そのコンピューターに TM1 管理サーバーと TM1 サーバーのコンポーネントをインストールします。

詳細については、 38ページの『Cognos TM1 管理サーバーと TM1 サーバーの配布』を参照してください。

Cognos TM1 クライアント・アプリケーションの配布このセクションでは、ネットワーク環境に別の IBM Cognos TM1 クライアント (ユーザー・インターフェース) を配布する方法について説明します。

別の Cognos TM1 クライアントには、以下が含まれます。




v Cognos TM1 Web (URL または Web リンクを使用)

v Cognos TM1 Applications (URL または Web リンクを使用)

v Cognos Insight

第 4 章配布 43

第 5 章アップグレード

IBM Cognos TM1 の以前のバージョンから最新バージョンへのアップグレードは、段階を追って実行するプロセスと捉える必要があります。

アップグレードは、1 つの IT プロジェクトであり、綿密な計画、十分な時間、人員を要するものと考えてください。

Planning Analytics バージョン 2.0.0 からのアップグレード

Planning Analytics バージョン 2.0.0 からバージョン 2.0.x にアップグレードする場合、アンインストールは必要ありません。バージョン 2.0.0 の上に直接バージョン2.0.x をインストールできます。

詳細については、 48ページの『Planning Analytics バージョン 2.0.0 からのアップグレード』を参照してください。

Planning Analytics for Microsoft Excel のアップグレード

IBM Planning Analytics for Microsoft Excel をアップグレードする場合は、手動でフルアンインストールしてから新しいバージョンをフルインストールする必要があります。

詳細については、 48ページの『Planning Analytics for Microsoft Excel のアップグレード』を参照してください。

TM1 10.2.x からのアップグレード

Cognos TM1 バージョン 10.2.x からアップグレードする場合は、手動でフルアンインストールしてから新しいバージョンをフルインストールする必要があります。

詳細については、 49ページの『Cognos TM1 バージョン 10.2.x からのアップグレード』を参照してください。

TM1 10.1.x からのアップグレード

Cognos TM1 バージョン 10.1 または 10.1.1 からアップグレードする場合は、手動でフルアンインストールしてから新しいバージョンをフルインストールする必要があります。

バージョン 10.1.x と 10.2.x の主な違いの 1 つは、Cognos TM1 Web で必要なWeb アプリケーション・サーバーです。バージョン 10.2.0 以降、Cognos TM1

Web は、Microsoft Internet Information Services (IIS) を使用しなくなり、代わりにJava Web アプリケーション・サーバー (付属バージョンの WebSphere® Liberty など) を使用するようになりました。

詳細については、 50ページの『Cognos TM1 バージョン 10.1.x からのアップグレード』を参照してください。


TM1 9.x からのアップグレード

Cognos TM1 バージョン 9.0.x、9.1.x、または 9.5.x からアップグレードする場合は、手動でフルアンインストールしてから新しいバージョンをフルインストールする必要があります。

注: TM1 9.0.x および 9.1.x データベースは、TM1 Server バージョン 9.4 以降で開かれる (開始される) と自動的に Unicode に変換されます。一度 Unicode に変換された古い TM1 データベースは、以前のバージョンの TM1 では開けなくなります。

詳細については、 51ページの『Cognos TM1 バージョン 9.x からのアップグレード』を参照してください。

アップグレード処理

アップグレードでは、次のいくつかの個別の処理を実行します。

1. 関連するすべてのサービスを停止する

2. 既存のデータとアプリケーションをバックアップする

3. 以前のバージョンの製品を削除する

4. 新しいバージョンの製品をインストールする

5. データ、設定、アプリケーションを新しいバージョンの製品で復元する

アップグレードの計画IBM Planning Analytics の既存のインストール環境をアップグレードする手順は、現在使用している配布済みの Cognos TM1 コンポーネントによって異なります。

以前のバージョンの Cognos TM1 Contributor から Cognos TM1 Applications へのアップグレードも行う場合は、さらに別の手順が必要になります。

アップグレードする前に

アップグレードを行う前に、次の考慮事項を確認してください。

Cognos TM1 管理サーバーIBM Cognos TM1 バージョン 10.1.0 から、TM1 管理サーバーの設定ファイル Tm1admsrv.ini は Cognos TM1 で使用されなくなり、サポートされなくなりました。 Cognos TM1 管理サーバーの設定には、Cognos

Configuration を使用する必要があります。

Cognos TM1 サーバー

v TM1 9.0.x および 9.1.x データベースを Cognos TM1 サーバーバージョン 9.4 以降で開く (開始する) と、それらのデータベースは自動的にUnicode に変換されます。一度 Unicode に変換された古い TM1 データベースは、以前のバージョンの TM1 では開けなくなります。

v IBM Cognos TM1 バージョン 10.1.0 では、Cognos Configuration を使用して Cognos TM1 サーバーを開始、停止、および管理できます。

Cognos TM1 WebIBM Cognos TM1 バージョン 10.2.0 以降、Cognos TM1 Web は、Java


Web アプリケーション・サーバー (付属バージョンの WebSphere® Liberty

など) で稼働するようになりました。Cognos TM1 Web バージョン 10.2.0

以降に Microsoft .NET Framework は不要であり、使用することはありません。

v Cognos TM1 Web バージョン 10.2.0 から、Cognos TM1 Web のデフォルト・インストール・ディレクトリーが C:¥inetpub¥wwwroot¥TM1Web から <TM1_Install>¥tm1web に変更されました。

v Cognos TM1 Web バージョン 10.2.0 以降では、tm1web_config.xml という名前の新しい設定ファイルを使用します。このファイルは、Cognos

TM1 Web の以前のバージョンの web.config ファイルと置き換わるものです。この新しいファイルには、以前のパラメーターの一部のみが含まれています (Microsoft .NET Framework 関連のパラメーターが除去されたため)。

新しい設定ファイルの場所は、次のとおりです。

<TM1_install>¥webapps¥tm1web¥web-inf¥configuration

以前の Cognos TM1 Web 設定ファイルの設定を使用する必要がある場合は、以前の Web.config ファイルのパラメーター設定を新しいtm1web_config.xml ファイルに選択的にマージすることができます。

v TM1 Web のさまざまなタイプの認証とデータ伝送セキュリティーを設定するための手順がいくつか変更されています。


v 重要: 以下の機能を使用する場合は、Cognos TM1 Performance Modeler

で以前のアプリケーションを編集する必要があります。

– 動的サブセットを Cognos TM1 Applications の承認階層として使用することはできません。

– 複数のアプリケーションが Cognos TM1 Applications で同じ承認キューブを共有することはできません。

v あるバージョンの WebSphere® Liberty の Web アプリケーション・サーバーが、新しいバージョンの Cognos TM1 と一緒にインストールされます。その WebSphere® Liberty インスタンスを使用して、Cognos TM1

Applications を実行したり、Cognos Configuration で TM1 Applications を管理したりできます。

v Cognos TM1 Web を実行する Web サーバーに Microsoft Excel をインストールせずに Cognos TM1 Applications を使用する場合は、Cognos TM1

サーバーの tm1s.cfg 設定ファイルで ExcelWebPublishEnabled パラメーターを明示的に True (T) に設定する必要があります。以前のバージョンの Cognos TM1 Contributor では、このパラメーターの設定は必要ありませんでした。

既存のデータのバックアップ

アップグレードを行う前に、既存のデータ、アプリケーション、および設定ファイルを安全な場所にバックアップしておいてください。 Cognos TM1 のネットワーク

第 5 章アップグレード 47

体系や配布によっては、Cognos TM1 データが複数のコンピューターに置かれている場合があります。このデータが置かれている場所のリストを作成し、データのバックアップ計画を作成してください。

バックアップを行う必要があるファイルは、以下のとおりです。

v Cognos TM1 管理サーバーの設定ファイル

v Cognos TM1 サーバーの設定ファイルおよびデータベース・ファイル

v Cognos TM1 Web サーバーの設定ファイルおよびカスタム・ファイル

v Cognos TM1 Architect クライアントの設定ファイル

v Cognos TM1 Perspectives クライアントの設定ファイル

v Cognos TM1 Contributor のアプリケーションおよび設定ファイル

Planning Analytics バージョン 2.0.0 からのアップグレードPlanning Analytics Local バージョン 2.0.0 を IBM Planning Analytics Local バージョン 2.0.x にアップグレードする場合、旧バージョンのアンインストールは不要です。 IBM Planning Analytics バージョン 2.0.x は、バージョン 2.0.0 の上に直接インストールできます。

現行バージョンのインストールについては、使用するコンピューター環境とインストールする Cognos TM1 コンポーネントに応じて、以下のトピックを参照してください。

v 75ページの『第 7 章 Planning Analytics の単一コンピューター・インストール』

v 85ページの『第 8 章 Cognos TM1 サーバーのインストール』

v 117ページの『第 10 章 Cognos TM1 Web のインストール』

v 147ページの『第 11 章 Cognos TM1 アプリケーション・サーバーのインストール』

v 191ページの『第 14 章 TM1 リッチ層のインストール』

v 107ページの『付属の WebSphere® Liberty Web サーバー・ソフトウェアを使用する場合の Cognos TM1 Operations Console のインストール』

Planning Analytics for Microsoft Excel のアップグレードIBM Planning Analytics for Microsoft Excel をアップグレードする場合、以前のバージョンをアンインストールしてから、現在のバージョンをインストールする必要があります。以前のバージョンの上に Planning Analytics for Microsoft Excel を直接インストールすることはできません。

始める前に

以前のバージョンをアンインストールする前に、既存のデータと設定ファイルをバックアップする必要があります。

手順1. すべての Microsoft Excel ウィンドウを閉じます。

2. 既存のデータと設定ファイルをバックアップします。


3. 前バージョンの Planning Analytics for Microsoft Excel をアンインストールします。詳しくは、トピック 218ページの『IBM Planning Analytics for Microsoft

Excel のアンインストール』を参照してください。

4. インストール・プログラムをダウンロードして解凍します。

5. 新規バージョンの Planning Analytics for Microsoft Excel をインストールします。詳しくは、トピック 217ページの『IBM Planning Analytics for Microsoft

Excel のインストール』を参照してください。

Cognos TM1 バージョン 10.2.x からのアップグレードIBM Cognos TM1 バージョン 10.2.x を IBM Planning Analytics バージョン 2.0.0

にアップグレードする場合は、旧バージョンをアンインストールしてから現行バージョンをインストールする必要があります。IBM Planning Analytics バージョン2.0.0 をバージョン 10.2.x の上に直接インストールすることはできません。また、以前のバージョンをアンインストールする前に、既存のデータと設定ファイルのバックアップを計画する必要があります。

このタスクについて

以下の手順では、Cognos TM1 バージョン 10.2.x から現行バージョンにアップグレードするためのガイドラインを示しています。

手順1. 以下のようにして、既存のデータと設定ファイルをバックアップします。

Cognos TM1 コンポーネントがインストールされているすべてのコンピューターに関して、既存のデータと設定ファイルを安全な場所にバックアップするように計画する必要があります。詳細については、以下のトピックを参照してください。

v 325ページの『Cognos TM1 のデータと設定ファイルのバックアップ』

v 330ページの『Cognos TM1 Applications のデータのバックアップ』

2. 以下のようにして、Cognos TM1 コンポーネントすべてをアンインストールします。

以前のバージョンの Cognos TM1 を分散インストール環境にインストールした場合には、それぞれのコンピューターから TM1 コンポーネントをアンインストールする必要があります。

v 328ページの『IBM Planning Analytics のアンインストール』

v 329ページの『Cognos TM1 Applications のアンインストールと配布解除』

3. 以下のようにして、現行バージョンの IBM Cognos TM1 をインストールします。

ご使用のコンピューター環境、およびインストールする Cognos TM1 コンポーネントに応じて、以下のトピックを参照してください。








4. Cognos TM1 Applications の新しいバージョンをインストールした後、Web ブラウザーのキャッシュを削除してください。キャッシュを削除しない場合、ブラウザーでは、古い Cognos TM1 Applications と新しい Cognos TM1 Applications

のファイルが混在することがあります。

5. 以下のようにして、以前の Cognos TM1 データと設定ファイルを復元します。

インストールされているコンポーネントに応じて、それぞれのコンピューターを、以前のデータと設定ファイルで更新します。

v 334ページの『IBM Planning Analytics バージョン 2.0.0 でのデータ・ファイルと設定ファイルの復元』

v 336ページの『Cognos TM1 Applications でのアプリケーションと設定ファイルの復元』

Cognos TM1 バージョン 10.1.x からのアップグレードIBM Cognos TM1 バージョン 10.1.x を IBM Planning Analytics バージョン 2.0.0

にアップグレードする場合は、旧バージョンをアンインストールしてから現行バージョンをインストールする必要があります。IBM Planning Analytics バージョン2.0.0 を Cognos TM1 バージョン 10.1.x の上に直接インストールすることはできません。また、以前のバージョンをアンインストールする前に、既存のデータと設定ファイルのバックアップを計画する必要があります。

始める前に

46ページの『アップグレードの計画』に記載されている情報を確認します。

バージョン 10.1.x と 10.2.x の主な違いの 1 つは、Cognos TM1 Web で必要なWeb アプリケーション・サーバーです。 Cognos TM1 Web バージョン 10.2.x

は、Microsoft インターネット・インフォメーション・サービス (IIS) を使用する代わりに Java Web アプリケーション・サーバー (付属のバージョンの Apache

Tomcat など) を使用します。


以下の手順では、Cognos TM1 バージョン 10.1.x から最新のバージョンにアップグレードするためのガイドラインを示しています。

手順1. 以下のようにして、既存のデータと設定ファイルをバックアップします。


Cognos TM1 コンポーネントがインストールされているすべてのコンピューターに関して、既存のデータと設定ファイルを安全な場所にバックアップするように計画する必要があります。詳細については、以下のトピックを参照してください。

v 325ページの『Cognos TM1 のデータと設定ファイルのバックアップ』


2. 以下のようにして、Cognos TM1 コンポーネントすべてをアンインストールします。

以前のバージョンの Cognos TM1 を分散インストール環境にインストールした場合には、それぞれのコンピューターから TM1 コンポーネントをアンインストールする必要があります。

v 328ページの『IBM Planning Analytics のアンインストール』

v 329ページの『Cognos TM1 Applications のアンインストールと配布解除』

3. 以下のようにして、現行バージョンの IBM Cognos TM1 をインストールします。

ご使用のコンピューター環境、およびインストールする Cognos TM1 コンポーネントに応じて、以下のトピックを参照してください。







4. Cognos TM1 Applications の新しいバージョンをインストールした後、Web ブラウザーのキャッシュを削除してください。キャッシュを削除しない場合、ブラウザーでは、古い Cognos TM1 Applications と新しい Cognos TM1 Applications

のファイルが混在することがあります。

5. 以下のようにして、以前の Cognos TM1 データと設定ファイルを復元します。

インストールされているコンポーネントに応じて、それぞれのコンピューターを、以前のデータと設定ファイルで更新します。

v 334ページの『IBM Planning Analytics バージョン 2.0.0 でのデータ・ファイルと設定ファイルの復元』

v 336ページの『Cognos TM1 Applications でのアプリケーションと設定ファイルの復元』

Cognos TM1 バージョン 9.x からのアップグレードIBM Cognos TM1 バージョン 9.x から IBM Planning Analytics バージョン 2.0.0

にアップグレードするには、まず完全にアンインストールしてからインストール手順を実行する必要があります。


始める前に

Cognos TM1 バージョン 9.x と現行バージョンとの違いを確認してください。バージョン 9.x と 10.x では、多くの設定手順とインストール・ディレクトリーに違いがあります。詳しくは、 46ページの『アップグレードの計画』を参照してください。


以下の手順では、Cognos TM1 バージョン 9.x から最新のバージョンにアップグレードするためのガイドラインを示しています。

手順1. Cognos TM1 9.x コンポーネントのサービスを停止します。

2. データと設定ファイルをバックアップします。

3. Cognos TM1 バージョン 9.x をアンインストールします。

4. 現行バージョンをインストールします。

5. データと設定ファイルを復元します。

アップグレードの前の Cognos TM1 9.x サービスの停止IBM Cognos TM1 バージョン 9.x のすべてのサービスは、新しいバージョンにアップグレードする前に停止しなければなりません。

手順1. Windows サービスを使用してすべての Cognos TM1 9.x サービスを停止します。これには以下が含まれます。


v Cognos TM1 Excel サービス

v Cognos TM1 サーバー・サービス

2. Cognos TM1 Contributor を使用していた場合、Cognos TM1 Contributor pmpsvcアプリケーションを停止します。

これを行うには、Cognos TM1 Contributor を実行している Web アプリケーション・サーバーの管理ツールを使用します。

3. IBM Cognos Analytics セキュリティーを Cognos TM1 Applications で使用している場合は、 IBM Cognos Analytics サービスを停止します。

次のタスク

既存のデータおよびアプリケーションをバックアップします。詳細については、『以前のバージョンの Cognos TM1 9.x のデータのバックアップ』を参照してください。

以前のバージョンの Cognos TM1 9.x のデータのバックアップこのトピックでは、すべての IBM Cognos TM1 9.x コンポーネントのデータおよび設定ファイルのバックアップに関するガイドラインを示します。


始める前に

関連するすべてのサービスを停止します。詳細については、 52ページの『アップグレードの前の Cognos TM1 9.x サービスの停止』を参照してください。


以前のバージョンの Cognos TM1 9.x を現在使用している場合、新しい Cognos

TM1 10.x バージョンをインストールする前に、Cognos TM1 のデータ・ディレクトリーおよび設定ファイルをバックアップする必要があります。

Cognos TM1 Web 9.x または Cognos TM1 Contributor 9.5.x を使用している場合は、それらのコンポーネントの関連データおよび設定ファイルもバックアップしてください。

手順1. <TM1 インストール>¥bin¥ ディレクトリーにある tm1admsrv.ini ファイルなど、保持する Cognos TM1 管理サーバーの設定ファイルをバックアップします。

2. Cognos TM1 サーバーのデータ・ファイルおよび設定ファイルの<TM1_Install>¥Custom¥TM1Data データ・ディレクトリーおよびサブディレクトリーを安全な場所にバックアップします。

ヒント: Cognos TM1 9.5 のデフォルトのデータ・ロケーションは C:¥Program

Files¥Cognos¥TM1¥Custom¥TM1Data でした。

3. Cognos TM1 Architect および Cognos TM1 Perspectives の設定ファイルをバックアップします。

a. 以下の場所にあるシステム・デフォルト・ファイル Tm1p.ini をバックアップします。

%ALLUSERSPROFILE%¥Application Data¥Applix¥TM1¥Tm1p.ini

例: C:¥Documents and Settings¥All Users¥Application

Data¥Applix¥TM1¥Tm1p.ini

b. 以下の場所にあるユーザー固有のファイル Tm1p.ini をバックアップします。

%APPDATA%¥Applix¥TM1¥Tm1p.ini

例: C:¥Documents and Settings¥ユーザー名¥ApplicationData¥Applix¥TM1¥Tm1p.ini

4. Cognos TM1 Web の設定ファイルおよびカスタム・ファイルを安全な場所にバックアップします。 Cognos TM1 Web 9.x のデフォルトの場所はC:¥inetpub¥wwwroot¥TM1Web でした。

a. web.config ファイルのコピーをバックアップします。

ヒント: Cognos TM1 Web の新規インストールを設定する際にこのファイル内の設定の一部を使用することもできます。


b. カスタム Web サーバー・ページを作成した場合は、それをバックアップします。

5. Cognos TM1 Contributor 9.5.x の applications フォルダーおよびpmpsvc_config.xml 設定ファイルを安全な場所にバックアップします。

a. フォルダー ¥webapps¥pmpsvc¥WEB-INF¥applications をバックアップします。

b. 設定ファイル ¥webapps¥pmpsvc¥WEB-INF¥configuration¥pmpsvc_config.xml

をバックアップします。

Apache Tomcat の独自のインストールとともに配布した場合、 Program

Files¥Apache Software Foundation¥Tomcat 6.0 を確認してください。

IBM Cognos Analytics に用意されている WebSphere® Liberty サーバーで配布していた場合は、Program Files¥cognos¥c8 を確認してください。

次のタスク

以前のバージョンの製品を除去します。詳細については、『以前のバージョンのIBM Cognos TM1 9.x のアンインストール』を参照してください。

以前のバージョンの IBM Cognos TM1 9.x のアンインストール以前のバージョンの IBM Cognos TM1 のすべてのコンポーネントを削除して、アンインストールする必要があります。

始める前に

すべてのデータおよび設定ファイルをバックアップしたことを確認します。詳細については、 52ページの『以前のバージョンの Cognos TM1 9.x のデータのバックアップ』を参照してください。


以下のステップを、アップグレードするコンピューターごとに実行します。

手順1. 以前のバージョンの Cognos TM1 サーバー、Cognos TM1 Architect、Cognos

TM1 Perspectives、Cognos TM1 Web をアンインストールするには、次のようにします。

a. Windows のコントロールパネルから、「プログラムの追加と削除」をクリックします。

b. 現在インストールされているプログラムのリストで、「IBM Cognos TM1」を選択します。

c. 「削除」をクリックして、説明に従って処理を完了します。

2. Cognos TM1 Contributor をアンインストールするには、以下のようにします。

v 使用している Web アプリケーション・サーバーから Cognos TM1 Contributor

をデプロイ解除します。

v 以下の手順で、Cognos TM1 Contributor 9.5.x Administration ツール、およびIBM Cognos Rich Client Framework をアンインストールします。


詳しくは、 57ページの『Cognos TM1 Contributor から Cognos TM1

Applications へのアップグレード』を参照してください。

次のタスク

新しいバージョンの製品をインストールします。

Cognos TM1 の単一コンピューターでのインストールのアップグレード

このトピックでは、Microsoft Windows オペレーティング・システム上で実行されている単一コンピューターで IBM Cognos TM1 をアップグレードする方法について説明します。

以前のバージョンの製品を削除したら、インストールの準備が整ったことになります。

これを行った後、データ、設定、アプリケーションを復元することにより、アップグレードを実行します。

関連概念:

75ページの『第 7 章 Planning Analytics の単一コンピューター・インストール』このタイプのインストールでは、Microsoft Windows オペレーティング・システムを実行するコンピューター 1 台に、デフォルトの設定を使用して Planning Analytics

を配置します。このタイプのインストールは、Planning Analytics を迅速に立ち上げたり、テスト環境や評価環境をインストールしたりする場合に使用してください。

UNIX または Linux での Cognos TM1 サーバーのアップグレード

UNIX または Linux オペレーティング・システムのいずれかを実行している 64 ビット・コンピューターに Cognos TM1 サーバー・コンポーネントをアップグレードすることができます。



関連概念:

89ページの『UNIX または Linux での Cognos TM1 サーバーのインストール』UNIX または Linux オペレーティング・システムを実行している 64 ビット・コンピューターに Cognos TM1 サーバー・コンポーネントをインストールすることができます。このタイプのインストールを使って、リモート・ユーザーがアクセスできる専用コンピューター上に Cognos TM1 サーバーをインストールして稼働することができます。


Windows での Cognos TM1 サーバーのアップグレードMicrosoft Windows オペレーティング・システムを実行している 32 ビットまたは64 ビットのコンピューターのいずれかに Cognos TM1 サーバー・コンポーネントをアップグレードすることができます。



関連概念:

85ページの『Windows での Cognos TM1 サーバーのインストール』Microsoft Windows オペレーティング・システムを実行している 32 ビットまたは64 ビットのコンピューターのいずれかに Cognos TM1 サーバー・コンポーネントをインストールすることができます。このタイプのインストールを使って、リモート・ユーザーがアクセスできる専用コンピューター上に Cognos TM1 サーバーをインストールして稼働することができます。

Cognos TM1 Architect クライアントと Cognos TM1Perspectives クライアントのアップグレード

Cognos TM1 サーバーのインストール・プログラムまたは Cognos TM1 クライアントのインストール・プログラムを使って、IBM Cognos TM1 クライアント・コンポーネントをアップグレードすることができます。



関連概念:

191ページの『第 14 章 TM1 リッチ層のインストール』TM1 サーバー・インストール・プログラムまたは TM1 クライアント・インストール・プログラムを使用して、TM1 リッチ層コンポーネントをインストールできます。

Cognos TM1 Web のアップグレードCognos TM1 サーバーをインストールしたコンピューターとは別のコンピューターに IBM Cognos TM1 Web がある場合、次の手順に従って Web サーバーをアップグレードします。



関連概念:


117ページの『第 10 章 Cognos TM1 Web のインストール』Cognos TM1 サーバーやその他の Cognos TM1 コンポーネントをインストールしたコンピューターとは別のコンピューターに、IBM Cognos TM1 Web をインストールできます。

Cognos TM1 Contributor から Cognos TM1 Applications へのアップグレード

Cognos TM1 Contributor から Cognos TM1 Applications にアップグレードするには、一連の手順を実行する必要があります。これらの手順には、従来のアプリケーション・ファイルを Cognos TM1 Applications に移動する処理も含まれます。

始める前に

アプリケーション・ファイルを Cognos TM1 Contributor から Cognos TM1

Applications にアップグレードする前に、以下の考慮事項を確認してください。

重要: 従来のアプリケーションを編集して、新しいバージョンとの互換性を持たせなければならないことがあります。

v 動的サブセットを Cognos TM1 Applications の承認階層として使用することはできません。

v 複数のアプリケーションが Cognos TM1 Applications で同じ承認キューブを共有することはできません。

アプリケーションをアップグレードできない場合、アップグレード処理の際にメッセージが表示されて、そのアプリケーションは配布解除された状態になります。配布解除されたアプリケーションは Cognos TM1 Applications ポータルには表示されませんが、代わりに Cognos TM1 Performance Modeler アプリケーション設計タブに表示されます。 Cognos TM1 Performance Modeler を使用してアプリケーションを編集および修正してから、それを検証して配布できます。

手順1. 関連するサービスを停止します。

52ページの『アップグレードの前の Cognos TM1 9.x サービスの停止』を参照してください。

2. Cognos TM1 Contributor 9.5.x の applications フォルダーおよびpmpsvc_config.xml 設定ファイルを安全な場所にバックアップします。

a. フォルダー ¥webapps¥pmpsvc¥WEB-INF¥applications をバックアップします。

b. 設定ファイル ¥webapps¥pmpsvc¥WEB-INF¥configuration¥pmpsvc_config.xml

をバックアップします。

Apache Tomcat の独自のインストールとともに配布した場合、 Program

Files¥Apache Software Foundation¥Tomcat 6.0 を確認してください。

IBM Cognos Analytics に用意されている WebSphere® Liberty サーバーで配布していた場合は、Program Files¥cognos¥c8 を確認してください。

3. IBM Cognos TM1 9.5.x をアンインストールします。


54ページの『以前のバージョンの IBM Cognos TM1 9.x のアンインストール』を参照してください。

4. 以下の手順で、Cognos TM1 Contributor 9.5.x Administration ツール、およびIBM Cognos Rich Client Framework をアンインストールします。

ヒント: Cognos TM1 Contributor 9.5.x Administration ツールがインストールされたコンピューターごとに、これらのステップを繰り返す必要があります。

a. Microsoft Windows で、「プログラムの追加と削除」を開きます。

重要: Administration ツールがインストールされた仕方によっては、1 つの項目だけが表示されることがあります。

b. 項目が存在する場合、まず「IBM Cognos TM1 ContributorAdministration」を削除します。

c. 「IBM Cognos Rich Client Framework」を削除します。

5. 以下の手順で、Cognos TM1 Contributor pmpsvc Web アプリケーションを配布解除します。

v 独自にインストールした Apache Tomcat または IBM Websphere とともに配布した場合、該当する管理ツールを使用して pmpsvc Web アプリケーションを配布解除してください。

v IBM Cognos Analytics と共に配布した場合、プログラム・ファイルは次の場所にあります。

– C:¥Program Files¥cognos¥c8¥webapps¥pmpsvc

– C:¥Program

Files¥cognos¥c8¥tomcat4.1.27¥work¥Standalone¥localhost¥pmpsvc

6. Cognos TM1 Applications をインストールします。

詳しくは、 147ページの『第 11 章 Cognos TM1 アプリケーション・サーバーのインストール』を参照してください。

7. Cognos TM1 Applications とともに使用する予定の Cognos TM1 サーバーごとに、データ・ファイルを復元します。

詳しくは、 60ページの『Cognos TM1 バージョン 9.x のデータと設定ファイルの現行バージョンへの復元』を参照してください。

8. Cognos TM1 Applications とともに使用する予定の Cognos TM1 サーバーごとに、tm1s.cfg 設定ファイルを編集します。

a. ExcelWebPublishEnabled パラメーターを設定します。

重要: 初期のバージョンの Cognos TM1 Contributor では、このパラメーターが常に真に設定されているものとして扱われ、 Cognos TM1 サーバーのtm1s.cfg ファイルにある実際の設定値は使用されませんでした。 Cognos

TM1 10.1 から Cognos TM1 Applications ではこのパラメーターが使用されるようになり、 tm1s.cfg ファイルにパラメーターを明示的に設定することが必要になりました。

詳細については、 359ページの『ExcelWebPublishEnabled』を参照してください。


b. AllowSeparateNandCRules パラメーターおよびDistributedPlanningOutputDir パラメーターを設定します。

詳細については、 155ページの『Cognos TM1 Application Web と協働するための Cognos TM1 サーバーの設定』を参照してください。

9. 以前の構成設定を使用する必要がある場合には、それらの設定を以前のファイルから Cognos TM1 Applications 用の新しい設定ファイルに手動でコピーします。

重要: Cognos TM1 Applications では、以前の pmpsvc_config.xml 設定ファイルの内容が pmpsvc_config.xml および fpmsvc_config.xml の 2 つの異なるファイルに再編成されています。

a. クライアント設定を以前の pmpsvc_config.xml ファイルから新しいpmpsvc_config.xml ファイルにコピーします。

b. サーバー関連の設定を以前の pmpsvc_config.xml ファイルから新しいfpmsvc_config.xml ファイルにコピーします。

10. 以前の Cognos TM1 Contributor 9.5.x applications フォルダーを、 Cognos

TM1 Applications 用の新しい場所にコピーします。

例: C:¥Program Files¥IBM¥cognos¥tm1¥webapps¥pmpsvc¥WEB-INF¥applications

11. IBM Cognos Configuration を使用して、関連した Cognos TM1 サービスを開始します。

a. TM1 管理サーバー

b. TM1 アプリケーション・サーバー

c. Cognos TM1 Applications とともに使用している Cognos TM1 サーバーを開始します。

12. アプリケーションをアップグレードするために、Cognos TM1 Applications ポータルに管理者としてログオンします。

ログオン・プロセスの際に、webapps/pmpsvc/WEB-INF/application フォルダー内のアプリケーション・ファイルは Cognos TM1 Contributor 9.5.2 から Cognos

TM1 Applications にアップグレードされます。

注: アプリケーションに適用する必要のある権限の量に応じて、アップグレード処理に時間がかかることがあります。詳細については、 62ページの『Cognos

TM1 Application をインポートまたは復元する際のセキュリティー権限の保存』を参照してください。

13. アップグレード処理の際に動的サブセットに関するプロンプトが出た場合、アプリケーションを編集して互換性のあるものにしてください。

a. Cognos TM1 Performance Modeler を開きます。

b. サブセットを動的から静的に変更するか、または使用する新しい静的サブセットを選択します。

c. アプリケーションを再配布して、アプリケーションのセキュリティーを確認します。一部のセキュリティーが変更されていて、「権限の管理」オプションを使用してセキュリティー割り当てを再作成する必要が生じている場合があります。


詳しくは、「TM1 Performance Modeler」の資料を参照してください。

14. アップグレード処理の際に共有ビューに関するプロンプトが出た場合、アプリケーションを編集して互換性のあるものにしてください。

a. Cognos TM1 Performance Modeler を開きます。

b. この問題を修正するには、TM1 データを再編成して、承認キューブが複数のアプリケーションに共有されないようにする必要があります。

c. アプリケーションを保存して配布します。


Cognos TM1 バージョン 9.x のデータと設定ファイルの現行バージョンへの復元

IBM Cognos TM1 の新しいバージョンのインストールが終わったら、以下の手順を実行して、以前の Cognos TM1 9.x 設定ファイルおよびデータベース・ファイルを復元します。

始める前に

新しいバージョンの製品をインストールします。

手順1. 以下の手順で、Cognos TM1 管理サーバーの設定ファイルを復元します。

重要: IBM Cognos TM1 バージョン 10.1.0 から、TM1 管理サーバーの設定ファイル Tm1admsrv.ini は Cognos TM1 で使用されなくなり、サポートされなくなりました。 Cognos TM1 管理サーバーの設定とその保管は、IBM Cognos

Configuration ツールでのみ行われるようになりました。Cognos TM1 管理サーバーの設定には、Cognos Configuration を使用する必要があります。

a. IBM Cognos Configuration を開きます。

b. Cognos Configuration の「エクスプローラー」ウィンドウで、「ローカル設定」 > 「環境」を展開して、「TM1 管理サーバー」をクリックします。管理サーバーのパラメーターが、「プロパティー」ウィンドウに表示されます。

c. 以前の Tm1admsrv.ini ファイルを開きます。

d. 新しいインストール環境で使用するパラメーターごとに、パラメーターの値を Tm1admsrv.ini ファイルから Cognos Configuration 内の対応するパラメーターにコピーします。例えば、以前のインストール環境でカスタム SSL 設定を使用していた場合、それらのパラメーターの値を Cognos Configuration

にコピーします。

e. Cognos Configuration で、「ファイル」>「保存」をクリックします。

2. 以下の手順で、Cognos TM1 サーバーのデータと設定ファイルを復元します。

ヒント: IBM Cognos TM1 バージョン 10.1.0 以降、Cognos Configuration を使用して CognosTM1 サーバーを開始、停止、および管理できるようになりました。


a. 復元する Cognos TM1 サーバーごとに、そのデータ・ディレクトリーおよびサブディレクトリーをデータ用の新しい場所 (<TM1_Install>¥samples¥tm1)

にコピーします。

b. 各 CognosTM1 サーバーを Cognos Configuration に追加します。ここでそのサーバーを開始、停止、および管理することができます。詳しくは、 100ページの『既存の Cognos TM1 サーバーの Cognos Configuration への追加』を参照してください。

3. 以下の手順で、Cognos TM1 Architect および Cognos TM1 Perspectives 設定ファイルを復元します。

Cognos TM1 Architect または Cognos TM1 Perspectives の以前のインストール環境の設定を復元する場合は、以前の Tm1p.ini ファイルの値を新しいTm1p.ini ファイルにコピーします。

重要: 以前の Tm1p.ini ファイルをそのまま適用する場合は、そのファイル内の AdminSvrSSLCertAuthority パラメーターのディレクトリー・パスを更新する必要があります。例えば、デフォルトの Cognos TM1 SSL 証明書を使用する場合は、このパラメーターの値を新しいインストール・パス C:¥Program

Files¥IBM¥cognos¥tm1¥bin¥ssl¥applixca.pem に手動で変更します。

a. 次の場所にある新しいシステム・デフォルト Tm1p.ini ファイルを更新します。




b. 次の場所にある、ユーザー固有の新しい Tm1p.ini ファイルを更新します。


例: C:¥Documents and Settings¥user

name¥ApplicationData¥Applix¥TM1¥Tm1p.ini

4. Cognos TM1 Web ファイルを、以下のようにして復元します。

新しいバージョンの Cognos TM1 Web を使用している場合、使用するいくつかの構成設定を復元できます。

以前の Web.config ファイルを開いて、使用する行およびパラメーターを、<TM1_install>¥webapps¥tm1web¥web-inf¥configuration にある新しいtm1web_config.xml ファイルに選択的にマージします。

注: Cognos TM1 Web バージョン 10.2.0 では、 tm1web_config.xml という名前の新しい設定ファイルを使用します。このファイルは、Cognos TM1 Web の以前のバージョンの web.config ファイルと置き換わるものです。詳細については、 124ページの『Cognos TM1 Web 構成パラメーターの変更』を参照してください。

5. アプリケーションおよび設定ファイルを、以下のようにして Cognos TM1

Applications に復元します。


Cognos TM1 Contributor 9.5.x のアプリケーションと設定ファイルを現行バージョンの Cognos TM1 Applications に復元する場合には、 57ページの『Cognos

TM1 Contributor から Cognos TM1 Applications へのアップグレード』を参照してください。

Microsoft Excel .xls ワークシートIBM Cognos TM1 Web バージョン 10.2.0 以降では、Excel 2007 以降で作成されたMicrosoft Excel ワークシートには Open XML のファイル形式が使用されます。

古い .xls 形式の既存の Microsoft Excel ファイルを使用する場合は、Cognos TM1

変換ツールを使用してそれらのファイルを変換してください。元のファイルにマクロが含まれている場合、Cognos TM1 変換ツールは元のファイルをマクロが使用可能な .xlsm ファイルに変換します。含まれていない場合は、通常の .xslx ファイルに変換します。

Cognos TM1 Architect Server Explorer の「Excel ファイルの OpenXML Excel 形式への変換」オプションを使用して、単一の .xls ワークシート、あるいはフォルダー内のすべてのワークシートを変換できます。このオプションは、管理ユーザーのみが使用できます。変換すると、可能な限り多くのリンクを変換後も保持するためにファイル名が変更されます。バージョン 10.2.0 でセル・ベースのセキュリティーに移行したために変更された可能性がある許可に応じて、一部のリンクやアクション・ボタンを更新する必要があります。

場合によっては、元のファイルの「名前付き範囲」の名前が、変換処理中に変更される場合があります。

デフォルトで、変換前のワークシートのバックアップが保存されます。デフォルトでは、ログ・ファイルも生成されます。

Cognos TM1 Application をインポートまたは復元する際のセキュリティー権限の保存

IBM Cognos TM1 Applications 10.2 では、初めてセキュリティー権限を Cognos

TM1 Application に保存する操作が、以前のリリースと比較して大幅に遅くなることがあります。アップグレードを実行して、アプリケーション・ファイルを手動で復元する際、またはアプリケーションと関連セキュリティー権限をインポートする際に、この遅延が生じることがあります。

これは、アプリケーション設計の柔軟性が強化された TM1 Applications の新しいセキュリティー設計のために生じる、既知の現象です。特に、複数のアプリケーションで承認階層ディメンションを共有する機能が Cognos TM1 Applications 10.2 に追加されています。Cognos TM1 Applications では、ビジネス・プロセスのさまざまなサイクル用に、個別に保護された複数のアプリケーションを配布できるようになりました。例えば、基礎となる同じキューブに基づいて、予算管理アプリケーションと予測アプリケーションを同時に操作して、リアルタイムで予算と予測の差異を算出することができます。

大切な点として、パフォーマンスの大幅な遅延が生じるのは、アプリケーションで権限が初めて保存されるときだけです。権限の保存操作は、アプリケーション・フ


ァイルを手動で復元するとき、またはアプリケーションが Cognos TM1 Applications

ポータルにインポートされ、インポート・プロセス中にセキュリティー権限を組み込むオプションが選択されたときにも実行されます。

その後に権限を保存するときは、差分解析が実行されて、権限の処理に要する時間は行われる変更の程度によって決まります。例えば、権限の変更が小さい場合、処理は短時間で行われます。これは、ビジネスでの増し加わる変更内容を反映するように権限が定期的に更新されるような環境で、TM1 Application を日常的に操作する際の重要な要素となります。アプリケーションが実動状態になった後に大規模な変更が生じることは稀なので、権限に対する定期的な変更は短時間で処理されます。

注: 以前は、これらの権限を、Cognos TM1 Performance Modeler または Cognos

TM1 Applications ポータル・ユーザー・インターフェースから手動で変更する必要がありました。しかし、Cognos TM1 10.2 リリースにより、コマンド行からこれらの変更を自動化することが初めて可能になりました。


第 6 章 Planning Analytics と IBM Cognos ソフトウェアの統合

IBM Planning Analytics を IBM Cognos Analytics や IBM Cognos のアプリケーションとさまざまな方法で統合できます。このトピックでは、最も一般的な統合方法をいくつか概説し、関連資料へのリンクを記載します。

Planning Analytics と Cognos ソフトウェアと統合する場合の主な選択肢として、認証セキュリティー、データ・レポート作成、データ/オブジェクトとの対話などがあります。 Planning Analytics と Cognos Analytics の統合を設定するためには、サーバーと Web サーバーのコンポーネントをホストしているコンピューターに対するさまざまなインストール・タスクと設定タスクが必要になります。場合によっては、インストールと設定を個々のエンド・ユーザーのコンピューターに対して実行する必要があります。

認証セキュリティー

Cognos Analytics セキュリティーを使用してユーザーを認証するようにCognos TM1 サーバーを設定することができます。この設定では、Cognos

図 5. Planning Analytics と IBM Cognos アプリケーションの統合の概要


TM1 ユーザー・インターフェースもその他のカスタム・アプリケーションもすべて、 Cognos TM1 データにアクセスするときに、Cognos Analytics

サーバーの有効なユーザー名とパスワードを使用する必要があります。

Cognos Analytics のデータを Planning Analytics にインポートする

現在、IBM Cognos Business Intelligence パッケージで SAP Business

Warehouse や他のリレーショナル・データ・ソース、ODBC データ・ソースに対して、IBM Cognos TM1 Package Connector を使用することがサポートされています。 Cognos TM1 Package Connector では、Cognos TM1

TurboIntegrator プロセスを使用してそれらのソースからデータを Planning

Analytics にインポートできます。

Cognos ソフトウェアでデータ・ソースとして Cognos TM1 を使用する

Cognos Report Authoring や Cognos Query Studio などの Cognos Analytics

アプリケーションから Cognos TM1 のサーバーおよびキューブにアクセスするように、 IBM Cognos Analytics を設定することができます。

IBM Planning Analytics for Microsoft Excel の内部で TM1 データにアクセスすることもできます。

Cognos TM1 データ・オブジェクトの表示および対話

IBM Cognos Workspace および IBM Cognos Insight で以下の Cognos TM1

データ・オブジェクトにアクセスし、それらのオブジェクトを表示して対話することができます。

v TM1 キューブ・ビューおよびグラフ

v TM1 Web シート

v TM1 スコアカード・キューブおよび図

Planning Analytics と Cognos Analytics のセキュリティー

Cognos Analytics セキュリティーを使用してユーザーを認証するように Cognos

TM1 サーバーを設定することができます。この設定では、Cognos TM1 ユーザー・インターフェースもその他のカスタム・アプリケーションもすべて、 Cognos TM1

データにアクセスするときに、Cognos Analytics サーバーの有効なユーザー名とパスワードを使用する必要があります。 Cognos Analytics セキュリティーを使用するように IBM Cognos TM1 Applications を設定することもできます。

詳しくは、以下のトピックを参照してください。

v 282ページの『Cognos TM1 での Cognos セキュリティーの使用』

v 292ページの『Cognos TM1 Applications での Cognos セキュリティーの使用』


Cognos TM1 Package Connector を使用して Cognos Analytics データを Cognos TM1 にインポートする

現在、IBM Cognos TM1 Package Connector は、SAP Business Warehouse と他のリレーショナルおよび ODBC データ・ソースに対し、 IBM Cognos Analytics のパッケージと共に使用するものとしてサポートされています。 Cognos TM1 Package

Connector を使用して、Cognos TM1 TurboIntegrator プロセスを使ってデータをこれらのソースから Cognos TM1 にインポートすることができます。

IBM Cognos TM1 Package Connector はメインの TM1 インストールとは別個のオプション・コンポーネントであり、独自の CD またはダウンロードで入手することができます。このコンポーネントは、TurboIntegrator プロセスが BW パッケージに対して作成される TM1 サーバーと管理クライアント・マシンの両方にインストールする必要があります。

詳しくは、次の資料を参照してください。

v インストール手順については、『Cognos TM1 Package Connector のインストール』を参照してください。

v TM1 Package Connector の使用方法の詳細については、「IBM Cognos TM1

TurboIntegrator」の『IBM Cognos TM1 Package Connector を使用してデータをインポートする』の章を参照してください。

v 「Cognos Analytics」(http://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/

com.ibm.swg.ba.cognos.cbi.doc/welcome.html) を参照してください。

v サポートされているソフトウェアについて詳しくは、「Software Environments for

IBM Planning Analytics 2.0」(http://www.ibm.com/support/


v パッケージの作成方法について詳しくは、「IBM Cognos Framework Manager」を参照してください。

v SAP 関連トピックについては、SAP の資料を参照してください。

Cognos TM1 Package Connector のインストールIBM Cognos TM1 は、特定のデータ・ソースに対する IBM Cognos Analytics パッケージの接続をサポートしています。

Cognos TM1 Package Connector は、メインの Planning Analytics インストールとは別個の CD またはダウンロードとして入手できるオプションの 32 ビット・コンポーネントです。このコンポーネントは、専用のディレクトリーにインストールする必要があります。

サポート対象のデータ・ソースについては、Software Environments for IBM

Planning Analytics 2.0 (http://www.ibm.com/support/docview.wss?uid=swg27049052) を参照してください。

Cognos TM1 Package Connector の使用方法については、「IBM Cognos TM1

TurboIntegrator」の『IBM Cognos TM1 Package Connector を使用してデータをインポートする』のセクションを参照してください。

第 6 章 Planning Analytics と IBM Cognos ソフトウェアの統合 67

http://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.cbi.doc/welcome.html





Cognos TM1 Package Connector の要件サポート対象プラットフォーム、バージョン、要件の詳細については、IBM Cognos

Analytics と IBM Planning Analytics の Knowledge Center を参照してください。

Cognos TM1 Package Connector には、以下のコンポーネントが必要です。

v Cognos TM1 9.5.1 以降。

Cognos TM1 Package Connector は、使用するデータ・ソース用の TurboIntegrator

プロセスを作成する Cognos TM1 サーバーと管理クライアント・マシンの両方にインストールする必要があります。

詳細については、Software Environments for IBM Planning Analytics 2.0

(http://www.ibm.com/support/docview.wss?uid=swg27049052) を参照してください。

v IBM Cognos Analytics Server。

サポート対象バージョンの詳細については、IBM Knowledge Center にある IBM

Cognos Analytics 11.0 の資料 (http://www.ibm.com/support/knowledgecenter/

SSEP7J_11.0.0) を参照してください。

v パッケージ作成のための IBM Cognos Framework Manager。

v データ・ソースが SAP の場合は、SAP Business Warehouse が必要です。サポートされるバージョンの詳細については、Knowledge Center を参照してください。

v 使用する特定のデータ・ソース用に Cognos TM1 Package Connector をインストールするすべてのプラットフォームに、32 ビットのデータベース・クライアント・ソフトウェアが必要です。 SAP BW の場合、SAP GUI または SAP

RFCSDK ライブラリー・ファイルおよび DLL が必要です。 69ページの『Planning Analytics から SAP への接続の有効化』を参照してください。

Cognos TM1 Package Connector のインストールIBM Cognos TM1 Package Connector をインストールするには、次の手順を実行します。

手順1. Cognos TM1 Package Connector ディスクを Cognos TM1 サーバー・マシンに挿入します。

2. オペレーティング・システムのシステム・フォルダー (例えば win32) にあるissetup.exe を実行します。

これによって Cognos インストーラーが起動します。

3. ご使用のインストール環境に合わせてインストール・プロンプトを完了します。

Cognos TM1 Package Connector を専用のディレクトリーにインストールします。既存の Cognos Analytics フォルダーにはインストールしないでください。

4. 設定ウィンドウを自動的に起動する場合は、「完了」画面で「IBM CognosConfiguration の起動」チェック・ボックスを選択します。望むなら、このボックスのチェック・マークを外したままにし、インストールした後に手動でCognos Configuration を起動することもできます。



http://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0

Windows 7 または Vista への Cognos TM1 Package Connector のインストール:

デフォルトで、Cognos Configuration の IBM Cognos TM1 Package Connector のtemp ディレクトリーは、Program Files 内にあります。

Microsoft Vista または Windows 7 アプリケーションは、Program Files の場所への書き込みを許可されていません。そのため、Windows 7 および Vista の Cognos

TM1 Perspectives から Cognos TM1 Package Connector を選択すると、エラーが発生する可能性があります。

この問題を回避する方法として、Microsoft Excel を実行する際に「管理者として実行」を選択します。あるいは、Cognos TM1 Package Connector のために Cognos

Configuration で Temporary files location の設定を、ユーザーによる書き込みが可能なディレクトリーに変更することができます。

Planning Analytics から SAP への接続の有効化SAP サーバーに接続する場合は、32 ビット SAP RFCSDK ライブラリー・ファイルと DLL が IBM Cognos TM1 Admin クライアントと IBM Cognos TM1 サーバーの両方に必要です。

Microsoft Windows でこれらのファイルを取得するには、SAP GUI をインストールします。 UNIX については、 71ページの『UNIX への Cognos TM1 Package

Connector のインストール』を参照してください。

Cognos TM1 Package Connector の設定IBM Cognos Analytics TM1 Package Connector をインストールすると、 IBM

Configuration ツールを利用できるようになります。

Cognos Configuration ツールが自動的に起動しない場合は、「スタート」メニュー>「IBM Cognos」>「IBM Cognos Configuration」オプションを使用して起動できます。

手順1. Cognos Configuration を起動するか、開きます。

2. 「Local Configuration Explorer」ウィンドウで「Environment」ノードを選択します。 URI の現在の設定が表示されます。

3. パッケージがデプロイされる Cognos Analytics サーバーを指すようにゲートウェイ URI を設定します。

ゲートウェイ URI は次の形式です。

http[s]://<host IP address>:<port>/<BI_SERVER_virtual_dir>/cgi-bin/cognos.cgi.

URI について詳しくは、「TM1 Operations」の資料または「Cognos Analytics」の資料を参照してください。

4. Other URI settings ノードの値の列に URI を入力します。

ディスパッチ URI は次の形式です。

http[s]://<host IP address>:<port>/p2pd/servlet/dispatch.

5. URI を設定したら、設定を保存します。


設定の進行状況ウィンドウでエントリーの状況を確認できます。完了したら、「閉じる」をクリックします。エラーが発生したら、設定を確認して値を再入力します。

6. Cognos Configuration ウィンドウを閉じます。

環境変数の設定:

Microsoft Windows で、IBM Cognos TM1 Package Connector をインストールすると、 TM1_PACKAGE_CONNECTOR システム環境変数はインストール時に指定されるインストール・ディレクトリーに設定されます (例えば C:¥Program

Files¥ibm¥Cognos¥c10¥bin)。

必要に応じて変数を編集したりシステム環境変数を作成して、場所を変更することができます。

システム変数は、Cognos TM1 Package Connector の最新のインストール環境により作成されます。

Microsoft Windows における Cognos TM1 Package Connector10 のデフォルトのインストール場所は C:¥program Files¥ibm¥cognos¥c10 です。

Cognos TM1 サーバー設定パラメーターの設定 (オプション):

IBM Cognos TM1 TurboIntegrator プロセスを Cognos TM1 Server 上で実行するには、 Cognos Analytics パッケージからのインポート後、データの存在場所となるCognos TM1 Server の CognosTM1InterfacePath パラメーターを TM1 Server 設定ファイル (tm1s.cfg) に追加します。

重要: 以下の情報は、Microsoft Windows オペレーティング・システムを使用する場合にのみ適用されます。

CognosTM1InterfacePath の値は、Cognos TM1 サーバーに対して、Cognos TM1

Package Connector がある場所を通知するものとなります。TM1_PACKAGE_CONNECTOR 環境変数が定義されている場合、これは必要ありません。このパラメーターが定義されている場合は、TM1_PACKAGE_CONNECTOR

環境変数をオーバーライドします。

Cognos TM1 サーバーの tm1s.cfg ファイルに Cognos TM1 Package Connector の場所 (Cognos TM1 Package Connector のインストール先) を入力します。例えば、

CognosTM1InterfacePath=C:\Program Files\ibm\cognos\c10\bin

要確認:

CognosTM1InterfacePath 変数は、Cognos TM1 Package Connector を UNIX

(AIX®、 Solaris、Linux) 上で使用している場合のみ必須です。

TM1_Package_CONNECTOR は、Windows オペレーティング・システム上でCognos TM1 Package Connector のインストール先を識別するためのシステム環境変数です。

UNIX の場合、Cognos TM1 サーバーの tm1s.cfg に含まれるcognosTM1InterfacePath が使用されます。しかし、Windows 上でそれを TM1server


の tm1s.cfg ファイルに追加した場合、それにより、TM1_Package_Connector に設定されている値の上書きが可能になります。

クライアント・コンピューター上の Cognos TM1 Package Connector:

IBM Cognos TM1 Package Connector を Cognos TM1 サーバーにインストールして設定したら、管理クライアント・コンピューターに別のコピーをインストールして設定します。同じ構成をその両方のインストールで使用します。

TM1 Package Connector の実行Cognos TM1 Package Connector を実行する方法について詳しくは、「TM1

TurboIntegrator」の『IBM Cognos TM1 Package Connector を使用してデータをインポートする』の章を参照してください。

UNIX への Cognos TM1 Package Connector のインストールMicrosoft Windows のインストールと同じ手順で UNIX に IBM Cognos TM1

Package Connector をインストールします。ただし、以下の調整が必要です。

手順1. 32 ビット Java Standard Edition 6 (32 ビット Java SE 6) を使用します。

2. 環境変数 JAVA_HOME=<java_location> を設定します (<java_location> は 32 ビット Java のインストール先)。

3. <Package_Connector_install_location>/bin/jre/6.0/lib/ext*のファイルをJAVA_HOME/jre/lib/ext にコピーします。

4. cogconfig.sh を <Package_Connector_install_location>/bin から起動します。

5. 32 ビット SAP RFCSDK ライブラリー・ファイルと DLL を UNIX マシンへ配置します。

6. Unicode データを扱うため UTF-8 コード・ページを使用するロケールを設定します。これはオプションです。

7. パラメーターを tm1s.cfg ファイルに追加して Cognos TM1 サーバーを設定します。

CognosTM1InterfacePath=/<Package_Connector_install_location>/bin

8. SAP DLL と Cognos TM1 Package Connector を使用するように環境を構成します。

a. 検索パス $LD_LIBRARY_PATH または $LIBPATH に RFCSDK の lib ディレクトリーを含めます。

b. 変数 $LIBPATH および $LD_LIBRARY_PATH をエクスポート (共有に) します。

v UNIX プラットフォームに応じて、以下のようにライブラリーの場所が異なります。

Solaris および Linux: LD_LIBRARY_PATH

HPUX: SHLIB_PATH

AIX: LIBPATH


Cognos Analytics のデータ・ソースとしての Cognos TM1Cognos Report Authoring および Cognos Query Studio から Cognos TM1 サーバーおよびキューブにアクセスするように IBM Cognos Analytics を設定することができます。

Cognos TM1 データ・ソースに基づく Cognos Analytics によるレポート作成を可能にするには、 Microsoft Windows 上で Query サービスおよび Report サービスを実行するすべての Cognos Analytics サーバー上に、必要な Cognos TM1 API ファイルをインストールします。『Cognos TM1 データ・ソースに基づく Cognos

Analytics レポート作成を可能にする』を参照してください。

Cognos Analytics の詳細については、以下のリソースを参照してください。

v IBM Knowledge Center にある IBM Cognos Analytics 11.0 の資料(https://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0)。

v 「管理ガイド」>『データ・ソースと接続』>『TM1 データ・ソース』

Cognos TM1 データ・ソースに基づく Cognos Analytics レポート作成を可能にする

Cognos TM1 データ・ソースに基づく Cognos Analytics によるレポート作成を可能にするには、 Cognos TM1 クライアントのインストール・プログラムを使用して、Microsoft Windows で Query サービスや Report サービスを実行するすべてのCognos Analytics サーバー上に、必要な Cognos TM1 API ファイルをインストールします。


この手順は、IBM Planning Analytics 2.0.0 を新しくインストールする場合にも、IBM Planning Analytics 2.0.0 の既存のインストール済み環境で、Microsoft Windows

を実行しているシステムに後から Cognos Analytics をセットアップする場合にも当てはまります。

手順1. 次の方法で、IBM Cognos TM1 クライアントのインストール・プログラムを実行します。

v Microsoft Windows Vista、Windows 7、または Windows Server 2008 オペレーティング・システム・ソフトウェアでは、issetup.exe ファイルを右クリックし、「管理者として実行」をクリックします。

v その他の Windows オペレーティング・システムでは、issetup.exe ファイルをダブルクリックします。

2. 「インストール先」ページで、 Microsoft Windows で Query サービスおよびReport サービスを実行している Cognos Analytics サーバーの隣接ディレクトリーを選択します。

3. 「コンポーネントの選択」ページで「TM1 リッチ層」を展開して、以下のオプションを選択します。

TM1 API


https://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0

その他のチェック・ボックスは、すべて選択解除します。

4. プロンプトに従い、「完了」をクリックしてインストールを完了します。

Cognos TM1 iWidgets and Cognos WorkspaceIBM Cognos TM1 Web のデータ・オブジェクト (キューブ・ビュー、チャート、Web シートなど) は、IBM Cognos Workspace に表示できます。

Cognos TM1 Web をインストールして正常に稼働するようにした後、IBM Cognos

Business Intelligence および Cognos Workspace 環境内で Cognos TM1 iWidgets を設定して操作します。

Cognos TM1 iWidgets を使用するように Cognos Workspace を設定する

IBM Cognos TM1 データを IBM Cognos Workspace で使用するには、 IBM

Cognos Analytics のインストール済み環境にある以下の設定ファイルを変更する必要があります。

v tm1_contribution.atom

v tm1_en.properties

詳しくは、 IBM Knowledge Center にある IBM Cognos Analytics 11.0 の資料(https://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0) で、『IBM Cognos

TM1 データを使用するための IBM Cognos Workspace の設定』というトピック(https://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/

com.ibm.swg.ba.cognos.inst_cr_winux.doc/c_cnfgbux4tm1.html) を参照してください。

Cognos Workspace 内での Cognos TM1 データの処理

Cognos TM1 で開発したデータ・オブジェクトを、Cognos Workspace からリアルタイムにアクセスできます。 Cognos Workspace では、以下の条件を満たす場合に、「コンテンツ」タブで TM1 コンテンツをナビゲートし、TM1 レポートをワークスペースに追加できます。

v Cognos TM1 がインストールされていて、IBM Cognos Analytics 環境の一部として設定されている。 SSL を使用するように Cognos Analytics 環境を変更する場合には、TM1 Web も SSL を使用するように変更する必要があります。

v Cognos TM1 のコンテンツを表示して対話的に操作する権限と機能がある。

TM1 データを Cognos Workspace で使用する方法について詳しくは、 IBM

Knowledge Center にある IBM Cognos Analytics 11.0 の資料 (https://www.ibm.com/

support/knowledgecenter/SSEP7J_11.0.0) で IBM Cognos Workspace の以下のトピックを参照してください。

v Cognos TM1 コンテンツ (https://www.ibm.com/support/knowledgecenter/

SSEP7J_11.0.0/com.ibm.swg.ba.cognos.ug_buxc.doc/c_ug_buxc_tm1_content.html)

v Cognos Workspace のCognos TM1 コンテンツの追加 (https://www.ibm.com/support/

knowledgecenter/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.ug_buxc.doc/

c_ug_buxc_tm1_content_adding.html)



https://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.inst_cr_winux.doc/c_cnfgbux4tm1.html

https://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.inst_cr_winux.doc/c_cnfgbux4tm1.html



https://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.ug_buxc.doc/c_ug_buxc_tm1_content.html

https://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.ug_buxc.doc/c_ug_buxc_tm1_content_adding.html

Cognos TM1 アプリケーションと Cognos Analytics および CognosConnection ポータルの統合

TM1 インストール済み環境で認証に Cognos セキュリティーを使用している場合、Cognos Analytics ユーザーは、 TM1 Applications ポータルの代わりに Cognos

Connection ポータルを使用して TM1 アプリケーションを開くことができます。しかし、アプリケーションの設定と管理を行うには、管理者は引き続き TM1

Applications を使用する必要があります。

Cognos セキュリティーを使用するように TM1 Applications を設定する場合、Cognos Connection ポータルも有効にして、使用可能な TM1 Applications へのリンクが含まれるフォルダーが表示されるようにします。表示されるアプリケーションの正確なリストは、現行ユーザーの権限によって異なります。

planning.html ファイルは、TM1 アプリケーションへのリンクを表示するための情報を Cognos Analytics および Cognos Connection ポータルに提供します。詳細については、 292ページの『Cognos TM1 Applications での Cognos セキュリティーの使用』を参照してください。

注: UNIX 環境で Cognos TM1 に接続するには、その前に TM1_PATH 環境変数を指定しておく必要があります。


第 7 章 Planning Analytics の単一コンピューター・インストール

このタイプのインストールでは、Microsoft Windows オペレーティング・システムを実行するコンピューター 1 台に、デフォルトの設定を使用して Planning Analytics

を配置します。このタイプのインストールは、Planning Analytics を迅速に立ち上げたり、テスト環境や評価環境をインストールしたりする場合に使用してください。

1 台のコンピューターのインストールでは、以下のコンポーネントのインストールと実行の方法が説明されています。





v Cognos TM1 Web


v Cognos TM1 アプリケーション Web

v Cognos Insight


取り上げるインストール・シナリオの想定は、以下のとおりです。

v Microsoft Windows オペレーティング・システムを実行している 32 ビットまたは 64 ビットの 1 台のコンピューターを使用しています。

v Planning Analytics のインストールに含まれている WebSphere® Liberty Web サーバー・ソフトウェアを使用します。

v デフォルトの標準 Cognos TM1 認証を使用します。

v デフォルトの設定 (言語は英語) を受け入れています。

64 ビット・システムでは、Cognos TM1 コンポーネントのすべてが必ずしも使用可能になるわけではありません。64 ビットのインストールで使用可能なコンポーネントは、デフォルトの 32 ビットのインストール・ディレクトリーの場所ではなく、64 ビットの場所のディレクトリーにインストールされます。例えば、bin ではなくbin64 などです。

要確認: この資料で取り上げる手順で使用されているブラウザーは、ご使用のブラウザーのインターフェースとは若干異なる場合があります。

関連概念:

55ページの『Cognos TM1 の単一コンピューターでのインストールのアップグレード』このトピックでは、Microsoft Windows オペレーティング・システム上で実行されている単一コンピューターで IBM Cognos TM1 をアップグレードする方法について説明します。


前提ソフトウェアのインストールIBM Cognos TM1 をインストールするには、前提ソフトウェアが必要です。


これらの前提条件ソフトウェアが配置されていない場合、それらに関するメッセージが Cognos TM1 インストール・ウィザードで表示されます。いずれかの前提条件が欠落している場合は、次に進む前に、それをインストールする必要があります。対象のソフトウェアが既にインストールされている場合もあります。

手順

Cognos TM1 Perspectives またはCognos TM1 Architect 用に、以下のものをインストールするか、インストールされていることを確認してください。

v Microsoft .NET Framework

v Microsoft Visual C++ 2010 再領布可能パッケージ

v Microsoft Excel

Software Environments for IBM Planning Analytics 2.0 (http://www.ibm.com/support/

docview.wss?uid=swg27049052) にアクセスして、Planning Analytics でサポートされる環境の最新リスト (オペレーティング・システム、パッチ、Web サーバー、Web

ブラウザーなどの情報) を確認してください。

基本 Cognos TM1 コンポーネントのインストールインストール・プログラムを使用して、インストールするコンポーネントと、それをインストールするコンピューター上の場所を選択します。

始める前にv ソフトウェアをインストールするコンピューターの管理者権限を持っていることを確認します。

v 一時ファイルを保管するディレクトリーを指す TEMP システム変数が、コンピューターに設定されていることを確かめます。インストール時に、このディレクトリーに一時的にファイルがコピーされます。

v 一部の Microsoft Windows Web サーバー・ソフトウェアでは、ディレクトリー名に非 ASCII 文字は使用できません。IBM Cognos TM1 コンポーネントをインストールするディレクトリーのパス名に ASCII 文字しか含まれていないことを確認してください。

v すべての前提ソフトウェアがインストールされていることを確かめます。

v 使用できるインストール・プログラムがいくつかあります。使用しているオペレーティング・システムに応じて、インストールするプログラムが保管されているディレクトリーに移動します。

– TM1 for 32-bit Windows

– TM1 for 64-bit Windows

手順1. インストールを開始するには、次のようにします。



v 使用する Cognos TM1 インストール・プログラムのダウンロード場所に移動します。

v または、IBM Cognos TM1 製品ディスクを挿入します。

インストール・ウィザードが自動的に開かない場合は、オペレーティング・システムのディレクトリーに移動して、issetup.exe コマンドを見つけてください。

2. オペレーティング・システム・ソフトウェアに応じて、issetup.exe ファイルを右クリックまたはダブルクリックします。


v 他のすべての Windows オペレーティング・システム・ソフトウェアでは、issetup.exe をダブルクリックします。

3. インストール・ウィザードの指示に従って、すべてのコンポーネントを選択します。

ソフトウェアを実行するために必要なコンポーネントは、デフォルトで選択されています。

Cognos Insight または Cognos TM1 Performance Modeler をインストールしない場合、ステップ 5 にスキップします。

4. インストールに Cognos Insight を含める場合は、「TM1 リッチ層」を展開して、「Cognos Insight」を選択します。

5. インストールに Cognos TM1 Performance Modeler を含める場合は、「TM1Performance Modeler」を選択します。

6. インストールが開始されるまで、「次へ」をクリックします。

すべてのコンポーネントがインストールされるまで、インストールが実行されます。これには、かなりの時間が必要となる場合があります。

ヒント: 古いバージョンの Windows オペレーティング・システムの場合、インストールの最後の画面で「Cognos Configuration の開始 (Start CognosConfiguration)」にチェック・マークを付けると、設定ツールをすぐに実行できます。 Microsoft Windows Vista、Windows 7、または Windows Server 2008 オペレーティング・システム・ソフトウェアの場合、このボックスにチェック・マークを付けず、代わりに「スタート」メニューを使用して、Cognos Configuration

ツールを起動する際に「管理者として実行」を選択できるようにします。

7. 「終了」をクリックします。

Cognos Configuration による Cognos TM1 コンポーネントの開始Cognos TM1 を使用する前に、IBM Cognos TM1 管理サーバー、TM1 Application

Server、および少なくとも 1 つの IBM Cognos TM1 サンプル・データベース・サーバーを開始する必要があります。この操作により、サーバーが Windows サービス・レジストリーに登録されます。それから、これらのサービスを特定のユーザーで実行するように設定することが必要です。 Microsoft Windows 環境で実行されるサーバーは、「サービス」と呼ばれます。

第 7 章 Planning Analytics の単一コンピューター・インストール 77

手順1. 設定ツールをまだ実行していない場合には、「スタート」 > 「すべてのプログラム」 > 「IBM Cognos TM1」 > 「IBM Cognos Configuration」をクリックして設定ツールを開始します。

要確認: Windows Vista、Windows 7、および Windows Server 2008 オペレーティング・システム・ソフトウェアでは、右クリックして「管理者として実行」を使用します。

2. Cognos Configuration の「エクスプローラー」ウィンドウで、「ローカル設定」> 「環境」と展開します。

3. 以下に示す開始するコンポーネントごとに右クリックして、「開始」を選択します。

a. TM1 管理サーバー TM1 管理サーバーはどのサンプル・データベースよりも前に実行している必要があるので、これを最初に開始します。

Cognos Configuration ツールが、構成設定に対して行った編集を保存するようにプロンプトを出します。初めて設定を保存するときには、暗号設定とその他のアクションが初めて実行されるため、この処理にかかる時間が長くなります。設定を保存するようにというメッセージに対して、「はい」をクリックします。この種類のメッセージは、Cognos Configuration を閉じるときにも表示されます。

b. TM1 アプリケーション・サーバー

4. 「データ・アクセス」>「TM1 サーバー」ノードを展開し、開始するそれぞれのCognos TM1 サンプル・データベース・サーバーを右クリックしてから「開始」を選択します。例えば、提供されている以下のサンプル・データベースを開始します。

a. SData

b. 計画のサンプル

c. GO_New_Stores

5. 「ファイル」 > 「保存」とクリックします。

6. これで、サービスはすべて Windows サービス・レジストリーに登録されたので、特定のユーザー・アカウントを使用するようにサービスを設定し直すことができます。

a. Cognos Configuration で、変更する各サービスを右クリックし、「停止」を選択します。

b. Windows の「サービス」を開きます。

c. 各サービスを右クリックし、「プロパティー」を選択します。

d. システムで有効で、サービスに適切な権限があるユーザー名とパスワードを入力します。 21ページの『Windows で Cognos TM1 サービスを実行するためのユーザー・アカウント』を参照してください。

e. Windows の「サービス」を閉じます。

7. Cognos Configuration で、各サービスを右クリックし、「開始」を選択します。

8. Cognos Configuration を閉じます。


Cognos TM1 Perspectives の実行インストール後、IBM Cognos TM1 Perspectives を実行できます。

手順1. Windows の「スタート」メニューから、「IBM Cognos TM1」 >

「Perspectives」をクリックします。このコンポーネントが開始されない場合、Cognos Configuration で始動したサーバーが依然として実行中であることを確認してください。

2. セキュリティー警告が表示される場合、「マクロを有効にする」をクリックします。

3. 「TM1」 > 「サーバー・エクスプローラー」とクリックしてから、「TM1」を展開して、使用可能なサーバーを表示します。

4. Cognos TM1 サーバーをダブルクリックして、ログオンします。

SData、Planning サンプル、または GO_New_Stores の場合、以下のログイン資格情報を使用します。

v ユーザー名: admin

v パスワード: apple

ヒント: Microsoft Excel を開始する場合に必ず Cognos TM1 Perspectives を自動的にロードするには、TM1_location/Tm1p.xla を Microsoft Excel のアドイン・ツール・リストに追加します。TM1_location は、Cognos TM1 がインストールされているファイル・ディレクトリーです。この手順を完了すると、「TM1」がMicrosoft Excel のメニュー・バーに表示されます。

Cognos TM1 Architect の実行インストール後、IBM Cognos TM1 Architect という Microsoft Excel バージョンではない IBM Cognos TM1 を実行できます。

手順1. Windows の「スタート」から、「すべてのプログラム」 > 「IBM Cognos

TM1」 > 「Architect」とクリックします。 Cognos TM1 Architect が開始されない場合、Cognos Configuration で始動したサーバーが依然として実行中であることを確認してください。

2. 「TM1」を展開して、使用可能なサーバーを表示します。


4. SData、Planning サンプル、または GO_New_Stores サンプル・データベースにログオンするには、以下の資格情報を使用します。




Cognos TM1 Web の実行IBM Cognos TM1 のインストールでは、IBM Cognos TM1 Web は、付属するバージョンの WebSphere® Liberty Web アプリケーション・サーバーで稼働するように設定されます。

手順1. Web ブラウザーで URL http://localhost:9510/tm1web/ を入力します

「localhost」という語は、デフォルトのコンピューターの場所として現在使用しているコンピューターを指す場合に用いることができます。または、Cognos

TM1 がインストールされているコンピューターの IP アドレスまたは名前を明示的に入力することもできます。

2. 他のどのコンポーネントを起動したかに応じて、通常「ログオン」ボックスの値は自動的に入力されます。入力されない場合、自分で入力するか、必要に応じて値を変更できます。

3. 「ログオン」をクリックします。

Cognos TM1 Application Web の実行IBM Cognos TM1 Application Web は、 IBM Cognos TM1 のデータを使用して作成されたプランニング・アプリケーションを実行するために使用される Web ベースのクライアントおよびポータルです。


Cognos TM1 Application Web は、IBM Cognos TM1 Performance Modeler の起動にも使用され、IBM Cognos Insight の起動にも使用できます。

手順1. Web ブラウザーで、URL http://localhost:9510/pmpsvc を入力します。 9510

は、Cognos TM1 アプリケーション・サーバーで使用される通常のポートです。インストール時に別のポートを使用した場合には、その値をここに入力してください。

2. Cognos TM1 Application Web の管理ホスト、サーバー、クライアントのタイプ、および URL の構成設定を指定します。

3. 「OK」をクリックします。

4. サンプル TM1 サーバーの「ユーザー名」および「パスワード」に、「admin」および「apple」と入力します。

5. tm1s.cfg ファイル内の以下のパラメーターの編集に関するメッセージをそのまま閉じて、インストールを完了します。

v AllowSeparateNandCRules

v ForceReevaluationOfFeedersForFedCellsOnDataChange

v DistributedPlanningOutputDir

クライアントの操作を開始する時点まで、これらのパラメーターを編集する必要はありません。


ポータルは、Cognos TM1 Performance Modeler を使用してアプリケーションを構築したり、既存のアプリケーションをインポートしたりするまでは空のままになります。

Cognos TM1 Performance Modeler の実行IBM Cognos TM1 Performance Modeler は、IBM Cognos TM1 インストールの選択されていないコンポーネントとして使用可能です。 Cognos TM1 Performance

Modeler は、IBM Cognos TM1 Applications ポータルから起動します。


Cognos TM1 Performance Modeler がインストールされた後、インストール済みのデスクトップ・アイコンから、または Microsoft Windows の「スタート」メニューからプログラムを開始することもできます。「スタート」 > 「すべてのプログラム」> 「IBM Cognos TM1 Performance Modeler」 > 「IBM Cognos TM1Performance Modeler」をクリックします。

手順

1. Cognos TM1 Applications ポータルで、「Performance Modeler を開く」アイコンをクリックします。

要確認: ブラウザーによって、Cognos TM1 Performance Modeler のようなダウンロードされるコンポーネントをインストールするために使用する手順が少し異なる場合があります。

2. provagent.cogrcp_modeler ダイアログ・ボックスで「IBM Cognos RCPApplication Updater で開く (Open with IBM Cognos RCP ApplicationUpdater)」を選択して「OK」をクリックします。

3. 「OK」をクリックし、設定メッセージを閉じると、インストールが完了します。

これらのパラメーターは、クライアントを扱うまでは編集する必要がありません。

4. 「モデル設計」タブをクリックして、GO_New_Stores データ・キューブと構造を表示します。

5. 「アプリケーション設計」タブをクリックして、GO_New_Stores を使用して新しいアプリケーションを構築します。

「TM1 Performance Modeler」の資料に、モデルの構築方法が詳しく記載されています。

Cognos Insight の実行IBM Cognos Insight は、 IBM Cognos TM1 インストールの選択されていないコンポーネントとして使用可能です。 Cognos Insight は、アプリケーションに参加するクライアントとして使用したり、役立つ対話的なユーザー・エクスペリエンスを作り出すための動的なワークスペース・ビルダーとして使用したりできます。


手順1. Cognos Insight を実行するには、次のいずれかの操作を実行します。

v Cognos TM1 Applications ポータルから、Cognos Insight アイコンをクリックします。

または、次のようにもできます。

v Cognos Insight を使用するように設定されたアプリケーションのノードを右クリックします。

v インストールされる Cognos Insight デスクトップ・アイコンをクリックすることもできます。

v Microsoft Windows の「スタート」メニューを使用します。「スタート」 >

「すべてのプログラム」 > 「IBM Cognos Insight」 > 「IBM CognosInsight」をクリックします。

v また、Cognos Insight を独立型コンポーネントとしてインストールすることもできます。

要確認: ブラウザーによっては、Cognos Insight などのダウンロード済みコンポーネントのインストール方法として、少し異なる手順が示される場合があります。

2. provagent.cogrcp_insight ダイアログ・ボックスで「IBM Cognos RCPApplication Updater で開く (Open With IBM Cognos RCP ApplicationUpdater)」を選択して「OK」をクリックします。

3. 実行可能ファイルに関する警告が表示される場合、「OK」をクリックしてインストールを続行します。

次のタスク

Cognos Insight ワークスペースを作成する方法、およびアプリケーションに参加するクライアントとして Cognos Insight を使用する方法について詳しくは、「Cognos

Insight」の資料を参照してください。

Cognos TM1 Application Web の使用IBM Cognos TM1 Application Web は、プランニング・アプリケーションに参加したり、IBM Cognos TM1 Websheets を扱ったりするための Web ベースのクライアントです。

始める前に

Cognos TM1 Application Web を使用するには、その前にプランニング・アプリケーションが必要です。アプリケーション設計者は、特定のアプリケーションと一緒に使用できるクライアントを指定します。

ヒント: 設計者によりどのクライアントがアプリケーションで使用可能になっているかは、IBM Cognos TM1 Application Web にアプリケーションのノードが表示される際に、そのノードを右クリックすることによって確認できます。


手順1. Cognos TM1 Application Web で、プランニング・アプリケーションをクリックします。

2. 「Cognos TM1 Application を開く (Open Cognos TM1 Application)」をクリックして、Cognos TM1 Application Web クライアントを起動します。

Cognos TM1 Application Web を使用してアプリケーションを操作する方法の詳細については、「TM1 Architect, Perspectives, and TM1 Web」および「TM1

Applications」の資料を参照してください。

その他の Cognos TM1 コンポーネントIBM Cognos TM1 インストールによって他の多くのコンポーネントが使用できるようになります。このインストールをカスタマイズする方法は他にも多数あります。

Cognos TM1 をインストール、配布、設定する他の方法について詳しくは、以下の資料とコンポーネントを参照してください。

その他の Cognos TM1 コンポーネント

Cognos TM1 のこれらの追加コンポーネントについて詳しくは、関連資料を参照してください。

IBM Cognos TM1 Operations Console

IBM Cognos TM1 Operation Console は、ネットワーク上にある TM1 サーバーのアクティビティーをモニターするために管理者が使用するツールです。詳細については、「IBM Cognos TM1 Operations Console」を参照してください。

IBM Cognos TM1 ScorecardingIBM Cognos TM1 Scorecarding は、スコアカードと戦略管理の機能をCognos TM1 に統合し、パフォーマンス管理と計画との統合を改善します。重要業績評価指標 (KPI) をモニターする対話式影響ダイアグラム、戦略マップ、およびカスタム・ダイアグラムを含むスコアカード・ソリューションを作成することができます。詳しくは、「IBM Cognos TM1 Performance

Modeler」を参照してください。

Cognos TM1 と他の IBM Cognos ソフトウェアの統合

Cognos TM1 と他の IBM Cognos ソフトウェアを統合するための以下の方法について詳しくは、『Cognos TM1 と他の IBM Cognos ソフトウェアとの統合』の章を参照してください。

IBM Cognos Analytics のセキュリティー

IBM Cognos Analytics セキュリティーを使用してユーザーを認証するように Cognos TM1 サーバーを設定することができます。

IBM Cognos Analytics レポート作成

Cognos Report Authoring や Cognos Query Studio などの Cognos Analytics

アプリケーションから Cognos TM1 のサーバーおよびキューブにアクセスするように、 IBM Cognos Analytics を設定することができます。


IBM Cognos Workspace での iWidget

キューブ・ビュー、グラフ、Web シートなどの IBM Cognos TM1 Web データ・オブジェクトを IBM Cognos Workspace での iWidget として表示できます。


IBM Planning Analytics for Microsoft Excel で IBM Cognos TM1 のデータ・ソースを使用して、入力した値を TM1 キューブに書き戻すことができます。

IBM Cognos TM1 Package Connector

IBM Cognos TM1 Package Connector は、IBM Cognos Framework Manager

のパッケージをインポートするために使用します。詳しくは、「IBM

Cognos TM1 TurboIntegrator」を参照してください。

Cognos TM1 のデータを PDF 形式でエクスポートするようにクライアント・コンピューターを設定する

Microsoft Windows で実行中の IBM Cognos TM1 クライアント・アプリケーションから IBM Cognos TM1 データを Adobe PDF 形式でエクスポートするには、デフォルト・プリンターに PDFCamp を設定します。以下の手順は、IBM Cognos TM1

Perspectives、 IBM Cognos TM1 Architect、および IBM Cognos TM1 Web に適用されます。

始める前に

Windows の「プリンターと FAX」設定の中に「PDFCamp Printer Driver」が存在することを確認することにより、PDFCamp が正しくインストールされていることを検証します。

手順1. Windows で、「プリンターと FAX」設定ウィンドウを開きます。

2. 「PDFCamp Printer Driver」を右クリックし、「通常使うプリンターに設定」を選択します。


第 8 章 Cognos TM1 サーバーのインストール

このセクションの説明を使用して、Microsoft Windows、UNIX、Linux のいずれかのオペレーティング・システムが実行されている専用コンピューター上に、IBM

Cognos TM1 管理サーバーおよび IBM Cognos TM1 サーバーをインストールして設定します。

Cognos TM1 管理サーバーは、Cognos TM1 サーバーと同じコンピューター上に、またはネットワーク上の別のコンピューター上に配置できます。

このサーバー・コンポーネントは、Microsoft Windows オペレーティング・システムが実行されている 32 ビットまたは 64 ビットのコンピューター上にインストールできます。 UNIX または Linux オペレーティング・システムの場合、サポートされているのは 64 ビットのコンピューターだけです。

配布のシナリオとオプションの詳細については、 38ページの『Cognos TM1 管理サーバーと TM1 サーバーの配布』を参照してください。

サーバー・コンポーネント

Cognos TM1 サーバー・コンポーネントには、次のものがあります。

v Cognos TM1 管理サーバー - 必須

v Cognos TM1 サーバー - 必須

v Cognos TM1 ツール - オプション

これらのコンポーネントは、インストール・プログラムの TM1 データ層の下にグループ化されています。

IBM Cognos Configuration

デフォルトでは、IBM Cognos Configuration も、Cognos TM1 管理サーバーおよびCognos TM1 サーバーを管理するための主要ツールとして、必須コンポーネントと一緒に Windows、UNIX、および Linux 上にインストールされます。このツールには、サーバー・コンポーネントを停止および始動するためのユーザー・インターフェースが備わっています。

Windows での Cognos TM1 サーバーのインストールMicrosoft Windows オペレーティング・システムを実行している 32 ビットまたは64 ビットのコンピューターのいずれかに Cognos TM1 サーバー・コンポーネントをインストールすることができます。このタイプのインストールを使って、リモート・ユーザーがアクセスできる専用コンピューター上に Cognos TM1 サーバーをインストールして稼働することができます。

関連概念:


56ページの『Windows での Cognos TM1 サーバーのアップグレード』Microsoft Windows オペレーティング・システムを実行している 32 ビットまたは64 ビットのコンピューターのいずれかに Cognos TM1 サーバー・コンポーネントをアップグレードすることができます。

Cognos TM1 サーバーのコンポーネントのインストール(Windows)

IBM Cognos TM1 サーバーのコンポーネントを、 Microsoft Windows を使用するコンピューターにインストールします。

手順1. Cognos TM1 サーバーのために使用しているコンピューターのタイプに一致するインストール・プログラムを選択します。

v Cognos TM1 32 ビット (Windows)

v Cognos TM1 64 ビット (Windows)

2. Microsoft Windows Vista、Windows 7、または Windows Server 2008 オペレーティング・システム・ソフトウェアでは、issetup.exe ファイルを右クリックし、「管理者として実行」をクリックします。その他のオペレーティング・システムでは、 issetup.exe ファイルをダブルクリックしてインストール・ウィザードを開始します。

3. インストール・ウィザードの指示に従って、「コンポーネントの選択」ページに進みます。

4. すべてのコンポーネントを選択解除します。デフォルトでは、当初、コンポーネントがすべて選択された状態になっています。

5. 「TM1 データ層」を展開して、以下のコンポーネントを選択します。

v TM1 サーバー

v TM1 管理サーバー

v TM1 ツール - オプション

v TM1 サンプル - オプション

6. インストール・ウィザードの指示に従って、インストールを完了します。

7. インストール・ウィザードの「終了」ページで「終了」をクリックします。

Cognos Configuration を使用した Windows での CognosTM1 サーバーの始動

Cognos TM1 サーバーを使用する前に、 IBM Cognos TM1 管理サーバーを IBM

Cognos Configuration で開始する必要があります。 Microsoft Windows 環境で実行されるサーバーは、「サービス」と呼ばれます。


デフォルトでは、Cognos Configuration は事前定義されたローカル・システム・アカウントを使用して、 Windows サービスとして実行されるように TM1 サーバーコンポーネントを登録します。ただし、TM1 コンポーネントは特定のユーザーとして実行される必要があります。


重要: Cognos Configuration によって作成された以下の Cognos TM1 サービスを変更して、これらのサービスが Microsoft Windows で特定のユーザー・アカウントの下で実行されるようにします。



詳細については、 21ページの『Windows で Cognos TM1 サービスを実行するためのユーザー・アカウント』を参照してください。

手順1. 設定ツールをまだ実行していない場合には、「スタート」 > 「すべてのプログラム」 > 「IBM Cognos TM1」 > 「IBM Cognos Configuration」をクリックして設定ツールを開始します。

要確認: Windows Vista、Windows 7、および Windows Server 2008 オペレーティング・システム・ソフトウェアでは、右クリックして「管理者として実行」を使用します。

2. Cognos Configuration の「エクスプローラー」ウィンドウで、「ローカル設定」> 「環境」と展開します。

3. 以下の開始するサーバーごとに右クリックして、「開始」を選択します。

a. TM1 管理サーバー

ヒント: Cognos Configuration ツールが、構成設定に対して行った編集を保存するようにプロンプトを出します。このプロセスは、設定を暗号設定として最初に保存し、他のアクションが最初に行われるときは、長くかかります。設定を保存するようにというメッセージに対して、「はい」をクリックします。この種類のメッセージは、Cognos Configuration を閉じるときにも表示されます。

4. 「データ・アクセス」>「TM1 サーバー」ノードを展開し、開始するそれぞれのCognos TM1 サンプル・データベース・サーバーを右クリックしてから「開始」を選択します。例えば、提供されている以下のサンプル・データベースを開始します。

a. SData

b. 計画のサンプル

c. GO_New_Stores


6. Windows の「サービス」で、Cognos TM1 のコンポーネントの項目を編集して、それらが特定のユーザー・アカウントの下で実行されるようにします。

詳細については、『Windows で特定のユーザー・アカウントとして Cognos

TM1 サービスを実行するための変更』を参照してください。

Windows で特定のユーザー・アカウントとして Cognos TM1 サービスを実行するための変更

IBM Cognos Configuration を使って Cognos TM1 サービスを管理する場合、Cognos TM1 管理サーバーと、Cognos Configuration によって開始したすべての

第 8 章 Cognos TM1 サーバーのインストール 87

Cognos TM1 サーバーの Microsoft Windows サービスを実行するデフォルトのユーザー・アカウントを変更する必要があります。デフォルトで、Cognos Configuration

は、これらのサービスを事前に定義された Microsoft Windows ローカル・システム・アカウントの下で登録します。ただし、これらのサービスは特定のユーザー・アカウントとして実行されるように変更する必要があります。

始める前に

ローカル・システム・アカウント以外のユーザー・アカウントを使用するために必要なアカウント権限を確認してください。詳しくは、 21ページの『Windows でCognos TM1 サービスを実行するためのユーザー・アカウント』を参照してください。


サービスとして実行されるように設定されている Cognos TM1 コンポーネントのユーザー・アカウントを変更するには、Windows の「サービス」を使用します。

手順1. IBM Cognos Configuration を開きます。

2. 「エクスプローラー」>「ローカル設定」ツリーを展開します。

a. 「ローカル設定」>「環境」ノードを展開します。

b. 「データ・アクセス」>「TM1 サーバー」ノードを展開します。

3. 変更する各 Cognos TM1 コンポーネントを右クリックし、「停止」を選択します。


v Cognos TM1 サーバー名 - Cognos Configuration にある各サーバーの名前。

ヒント: TM1 アプリケーション・サーバー・コンポーネントを停止する必要はありません。

4. Windows の「サービス」を開きます。

5. 更新する Cognos TM1 コンポーネントを見つけ、それを実行する Windows サービスのユーザー・アカウントを変更します。

a. サービスを右クリックし、「プロパティー」を選択し、「ログオン」タブをクリックします。

b. サービスの新規ユーザー名とパスワードを入力します。

c. Windows サービスとして実行されている他の Cognos TM1 コンポーネントで、変更するものがあれば、これらの手順を繰り返します。

6. Windows の「サービス」を閉じます。

7. Cognos Configuration で、変更した各サービスを再始動します。

項目を右クリックして、「開始」を選択します。.

8. Cognos Configuration を閉じます。


UNIX または Linux での Cognos TM1 サーバーのインストールUNIX または Linux オペレーティング・システムを実行している 64 ビット・コンピューターに Cognos TM1 サーバー・コンポーネントをインストールすることができます。このタイプのインストールを使って、リモート・ユーザーがアクセスできる専用コンピューター上に Cognos TM1 サーバーをインストールして稼働することができます。

インストール後のコンポーネントの管理

インストールが完了した後、IBM Cognos Configuration を使用して、実行するサーバーを管理できます。インストールに付属の開始スクリプトと停止スクリプトを使用することもできます。

データへのアクセスとその表示

UNIX システムで稼働する Cognos TM1 サーバーに保管されているデータを表示して対話するには、Microsoft Windows を実行するコンピューター上の Cognos TM1

クライアントのいずれかを使用します。

ヒント: Microsoft Windows を実行するコンピューター上の Cognos TM1 Architect

を使用して、UNIX システムで稼働するサーバーにリモート・ログオンできます。

関連概念:

55ページの『UNIX または Linux での Cognos TM1 サーバーのアップグレード』UNIX または Linux オペレーティング・システムのいずれかを実行している 64 ビット・コンピューターに Cognos TM1 サーバー・コンポーネントをアップグレードすることができます。

UNIX または Linux オペレーティング・システムでの CognosTM1 サーバーのコンポーネントのインストール

インストール・ウィザードを使用して、インストールするサーバー・コンポーネントと、使用するコンピューターでのインストール先を指定します。

UNIX と Linux のサポート対象オペレーティング・システムの完全なリストについては、IBM Cognos TM1 をクリックして、Software Environments for IBM Planning

Analytics 2.0 Local (http://www.ibm.com/support/docview.wss?uid=swg27049052) を参照してください。

始める前に

Cognos TM1 を UNIX または Linux のオペレーティング・システムにインストールする際は、Cognos TM1 バイナリーおよび TM1 データベースに対して適切な権限を持つユーザーとして実行されるようにコンポーネントを設定する必要があります。

Cognos TM1 のインストールを準備するには、このチェックリストに記載されているタスクを完了する必要があります。

v Cognos TM1 の用語と概念を理解します。


http://www-01.ibm.com/support/docview.wss?uid=swg27049052


「TM1 Architect, Perspectives, and TM1 Web」の資料、および「TM1 for

Developers」の資料を参照してください。

v インストールするコンポーネントおよびハードウェア環境での配布方法を決定します。

要確認: UNIX と Linux では、Cognos TM1 サーバー・コンポーネントのみ実行できます。 UNIX で Cognos TM1 クライアントを実行することはできません。

最適な TM1 環境を設計する方法について詳しくは、 23ページの『第 3 章アーキテクチャー』および 37ページの『第 4 章配布』を参照してください。

v ハードウェア要件とソフトウェア要件を確認します。

Software Environments for IBM Planning Analytics 2.0 Local (http://www.ibm.com/

support/docview.wss?uid=swg27049052) にアクセスして、Cognos TM1 でサポートされる環境の最新リスト (オペレーティング・システム、パッチ、Web サーバー、Web ブラウザーなどの情報) を確認してください。

別のリレーショナル・データベースからのデータのインポートを計画している場合には、最初にデータベース・ソフトウェアをインストールします。

UNIX 上で Oracle を実行している場合、UNIX マシン上の Oracle データベースで使用する適切な UNIX クライアント・ソフトウェアをインストールします。Oracle Network Configuration Assistant を使用して、ローカル・ネット・サービス名を指定します。

v Java Runtime Environment (JRE) の独自のコピーをインストールします。 Cognos

TM1 のインストールでは、UNIX インストール環境のための JRE が提供されません。

v UNIX マシン上の X サーバー・ソフトウェアを確認します。

グラフィカル・ユーザー・インターフェースの UNIX インストールウィザードを実行するには、TM1 コンポーネントをホストするマシン上に、X サーバー・ソフトウェアがインストールされている必要があります。 TM1 インストール・ウィザードを実行するマシン上に X サーバークライアント・ソフトウェアがインストールされていなければなりません。UNIX マシン上に X サーバー・ソフトウェアがインストールされていない場合には、コンソール・インストールを実行してください。

X-server ソフトウェアを使用しない場合は、無人インストールを使用する必要があります。詳細については、 423ページの『付録 C. 無人インストールおよび設定のセットアップ』を参照してください。

v Cognos TM1 コンポーネントをインストールして、Cognos TM1 バイナリーおよび TM1 データベースのための適切な許可を付与されたユーザーとして実行するよう、それらを設定します。

手順1. インストール・ファイルをダウンロードして解凍した場所に移動するか、または製品ディスクを挿入します。

2. オペレーティング・システムのディレクトリーに移動して、次のように入力します。



./issetup

3. インストール・ウィザードの指示に従って、必要なファイルをコンピューターにコピーします。

4. インストールするコンポーネントを選択します。デフォルトでは、すべてのコンポーネントがインストールされます。

5. インストール・ウィザードの「終了」ページで、「終了」をクリックします。

6. IBM Cognos TM1 アプリケーション・サーバーを、Sun Java ランタイム環境を持つ Linux にインストールする場合、追加の必須 Xerces ファイルをインストールする次の手順を実行する必要があります。

a. Xerces の Web サイト (http://xerces.apache.org/mirrors.cgi) のダウンロード・ページに移動します。

b. Java: Xerces-J-bin.2.11.0.zip のバイナリー配布をダウンロードします。

c. xercesImpl.jar および xml-apis.jar を抽出して、それらをtm1_install_dir/webapps/pmpsvc/WEB-INF/lib ディレクトリーにコピーします。

d. TM1 アプリケーション・サービスを再始動します。

Java 環境の更新UNIX および Linux オペレーティング・システムで IBM Cognos Configuration を開始できるようにするには、JAVA_HOME 環境変数を設定する必要があります。

手順

JAVA_HOME 環境変数が有効な JRE の場所に設定されていることを確認します。

UNIX または Linux オペレーティング・システムでの CognosConfiguration の開始Cognos TM1 のさまざまなコンポーネントを設定したり、サービスを開始および停止したりするには、IBM Cognos Configuration を使用します。

始める前に

IBM Cognos Configuration を開始するには、その前に、JAVA_HOME 環境変数を設定しておく必要があります。

手順

install_location/bin64 ディレクトリーに移動して、以下のように入力します。./cogconfig.sh

UNIX での Cognos TM1 サーバーの開始IBM Cognos Configuration を使用して、UNIX または Linux 上で Cognos TM1 サーバーを開始および停止することができます。インストールに付属の開始スクリプトおよび停止スクリプトを使用することもできます。


http://xerces.apache.org/mirrors.cgi


UNIX では、以下のコマンドおよびスクリプトを使って Cognos TM1 サーバーコンポーネントを開始および停止することもできます。詳しくは、「TM1 Operations」の資料の『UNIX TM1 サーバーの開始』および『UNIX TM1 サーバーの停止』を参照してください。

v startup_tm1admsrv.sh - Cognos TM1 管理サーバーを開始します。

v shutdown_tm1admsrv.sh- Cognos TM1 管理サーバーをシャットダウンします。

v startup_tm1s.sh- Cognos TM1 サーバーを開始します。

v tm1srvstop.exe - Cognos TM1 サーバーを停止するためのユーティリティー。

v shutdown_tm1s.sh - Cognos TM1 サーバーをシャットダウンするための代替方式。

v startup_pmpsvc.sh- Cognos TM1 アプリケーション・サーバーを開始します。

v shutdown_pmpsvc.sh- Cognos TM1 アプリケーション・サーバーをシャットダウンします。

手順1. IBM Cognos Configuration を開始します。

2. 「エクスプローラー」ウィンドウで、「ローカル設定」>「環境」をクリックします。

3. 「Cognos TM1 管理サーバー」を右クリックし、「開始」をクリックします。

4. 「データ・アクセス」>「Cognos TM1 サーバー」の下のサーバーを右クリックし、「開始」をクリックします。

IBM AIX での Cognos TM1 の実行このセクションでは、IBM AIX オペレーティング・システムで Cognos TM1 を実行する場合に考慮する必要がある技術的な事項について説明します。

Cognos TM1 に対する IBM AIX メモリー・リソース制限の設定IBM AIX で IBM Cognos TM1 を実行する場合は、AIX メモリー・リソース制限を調べて、Cognos TM1 に使用できるメモリー容量を確認してください。

Cognos TM1 は、AIX のハード・リミットのメモリー・リソース設定で許可されている IBM AIX オペレーティング・システムのメモリーの最大量を使用するように設定されます。現在の AIX のハード・リミットを確認するには、以下のようにAIX ulimit コマンドを使用します。

ulimit -d -H

root ユーザーの権限がある場合は、このコマンドを使用してハード・リミットを変更できます。 ulimit コマンドの使用方法について詳しくは、AIX の資料を参照してください。

IBM AIX での Cognos TM1 のパフォーマンス・チューニングIBM AIX で IBM Cognos TM1 を実行する場合は、環境をチューニングしてパフォーマンスを向上させてください。


このトピックで説明する変更を行うと、アプリケーションや使用方法によっては、これまでのバージョンの TM1 よりもパフォーマンスが 5% から 25% 向上することがテストで示されています。

環境設定

以下の環境設定は、2014 年 9 月時点の AIX 用のすべての TM1 リリースに適しています。

export AIXTHREAD_SCOPE=Sexport AIXTHREAD_MNRATIO=1:1export MALLOCOPTIONS=multiheap:32,pool:0x20000000export SPINLOOPTIME=300export AIXTHREAD_MUTEX_FAST=ONexport LDR_CNTRL=DATAPSIZE=16M@TEXTPSIZE=16M@STACKPSIZE=16Mexport AIXTHREAD_AFFINITY=first-touchexport MEMORY_AFFINITY=MCMexport OBJECT_MODE=64 export YIELDLOOPTIME=0

仮想メモリー・マネージャー (VMM)

仮想メモリー・マネージャー (VMM) は、予約するラージ・ページのサイズと数に合わせてチューニングする必要があります。VMM を調整できるのは、root ユーザーまたは必要な特権を持つユーザーのみです。VMM パラメーターのチューニングに使用できる vmo オプションをすべて確認するには、AIX の資料を参照してください。

注: ラージ・ページを有効にすると、TM1 サーバーのメモリーが 10% から 15%

増加します。

次のコマンドは、TM1 サーバーの推奨設定を使用してラージ・ページを有効にします。

vmo -o lgpg_regions=2000 -o lgpg_size=16777216

非 root ユーザーに特権を付与するには、次のコマンドを使用します。

chuser capabilities=CAP_BYPASS.RAC_VMM,CAP_PROPAGATE userid

TM1 サーバーがラージ・ページを有効にして稼働していることを確認するには、次のコマンドを実行します。

ps -Zdef | grep tm1

IBM Power® プラットフォーム用のオブジェクト調整の有効化

tm1s.cfg ファイルの CacheFriendlyMalloc パラメーターは、Power プラットフォームに固有のメモリー調整を可能にします。このオプションを有効にすると、ユーザー数が多い使用シナリオの場合に最もメリットが大きくなることがテストで示されています。ユーザーが 1 人または少数しかいない使用シナリオでは、メリットはあまりないか、まったくない可能性があります。デフォルトでは、このオプションは無効です。このオプションを有効にするには、次の行を tm1s.cfg ファイルに追加します。

CacheFriendlyMalloc=T


Cognos TM1 コントロール・オブジェクトのファイル名をサポートしない IBM AIX コマンドの使用IBM AIX オペレーティング・システムのいくつかのコマンド (例えば sysck) では、右中括弧 } 文字で始まる IBM Cognos TM1 コントロール・オブジェクト・ファイル名を使用できません。

Cognos TM1 コントロール・オブジェクトの標準的なファイル名は、例えば}Clients.dim、}Groups.dim、}ClientsGroups.cub のようなものです。

この問題は、データをバックアップする IBM AIX のコマンドやツールを含め、stdin からファイル名を読み取る標準的な AIX コマンドのすべてに当てはまります。これらの AIX コマンドが Cognos TM1 ファイルに対して使用されると、失敗してエラーになります。

UNIX および Windows システム上の Cognos TM1 サーバー用の Cognos TM1 オブジェクト名と文字エンコード

キューブ、ビュー、ディメンション、サブセットなどのオブジェクトの Cognos

TM1 オブジェクト名の文字エンコードを、適正で一貫性のあるものとすることに関係するガイドラインを以下に挙げます。

Windows システムと UNIX システム間における Cognos TM1 データベースの移動Cognos TM1 オブジェクト名に非 ASCII 文字 (当初の 128 ASCII 文字セット以外の文字) が含まれている場合には、Cognos TM1 データベース・ファイルをMicrosoft Windows システムから UNIX システム (または UNIX から Windows) に手動で移動して使用しないでください。

異なるプラットフォーム間で TM1 データを移動するには、ファイルを手動で移動するのではなく、tm1xfer ユーティリティーを使用してください。

tm1xfer ユーティリティー

tm1xfer ユーティリティーは、TM1 サーバー・オブジェクトを圧縮して、1 つのプラットフォームから別のプラットフォームに移動します。その際、Microsoft

Windows プラットフォームと UNIX プラットフォームの両方で、オブジェクトの大/小文字混合の名前を保持します。詳しくは、「TM1 Operations」の『tm1xfer』のトピックを参照してください。

手動でのファイルの移動

これら 2 つのプラットフォーム間でファイルを手動で移動すると、文字のエンコードやマッピングに互換性がない可能性があるため、問題になります。 Windows オペレーティング・システムはディレクトリーとファイル名を UTF-16 文字エンコードで保存しますが、UNIX オペレーティング・システムでは現在使用されているロケールに従って異なる文字エンコードを使用して名前を保存します。

例えば、Cognos TM1 データベース・ファイルをあるプラットフォームからコピーし、別の文字エンコードが使用されている別のプラットフォームで実行すると、非ASCII 文字を含むキューブとディメンションの Cognos TM1 オブジェクト名は


Cognos TM1 クライアント・アプリケーションで正しく表示されません。

名前に非 ASCII 文字が含まれている場合は Cognos TM1 サーバーを始動するとき UNIX システムと同じロケールを使用するキューブ、ビュー、ディメンション、サブセットなどの Cognos TM1 オブジェクト名に非 ASCII 文字が含まれている場合は、UNIX システムで Cognos TM1 サーバーを始動するときに同じロケールを使用します。

これによって、Cognos TM1 オブジェクト名、関連する Cognos TM1 ディレクトリー、および UNIX システムのファイル名は、常に同じ文字エンコードを使用することになります。以前に使用したロケールとは別のロケールで Cognos TM1 サーバーを起動すると、当初別のロケールで作成されて保存された Cognos TM1 オブジェクト名が正しく表示されないことがあります。

例えば、en_US ロケールでサーバーを実行しているときに保存されたキューブとディメンションの Cognos TM1 オブジェクト名は、ja_JP ロケールを使用してサーバーが再起動された場合に正しく表示されないことがあります。

Cognos TM1 言語設定IBM Cognos TM1 は、実行されているオペレーティング・システム・ユーザー・アカウントまたは Web ブラウザーの現在の言語を検出して、Cognos TM1 サーバー、クライアント・ユーザー・インターフェース、メッセージの言語を自動的に設定します。この自動設定はオーバーライド可能であり、サポートされている言語のうちいずれかの特定の言語を使用するように Cognos TM1 を設定することができます。

サポートされている言語について詳しくは、 96ページの『Cognos TM1 言語コード』を参照してください。

言語の自動検出

Cognos TM1 は、以下のプロセスを使用して、実行時に自動的に言語を検出して設定します。

1. Microsoft Windows で実行される Cognos TM1 サーバーおよびクライアントは、現行ユーザーのオペレーティング・システムのロケールで設定されている言語の検出と使用を試みます。Windows の場合、これは「地域と言語のオプション」で設定されます。検出された言語とサポートされている言語の 1 つが一致する場合、その言語が使用されます。

重要: デフォルトで、IBM Cognos Configuration を使って開始する Cognos TM1

サーバーはすべて、Windows ローカル・システムによって予約されているユーザー・アカウントを使用して Windows サービスとして実行されるように初期設定されます。特定のユーザー・アカウントに基づいて Cognos TM1 サーバーが言語を使用するようにする場合、そのユーザーとして実行するようにサービスを変更し、ユーザーの言語を Windows の「地域と言語のオプション」で設定します。詳しくは、 87ページの『Windows で特定のユーザー・アカウントとしてCognos TM1 サービスを実行するための変更』を参照してください。


2. サーバー・コンポーネントとクライアント・コンポーネントは、Cognos TM1

Language 設定パラメーターに基づいて、オーバーライドの有無の検査も行います。

v サーバーは、Tm1s.cfg 設定ファイルの Language パラメーターを検査します。有効な言語コードが設定されている場合、サーバー・メッセージでその言語が使用されます。

v クライアント・コンポーネントは、Tm1p.ini 設定ファイルの Language パラメーターを検査します。有効な言語コードが設定されている場合、ユーザー・インターフェースでその言語が使用されます。

3. 上記のいずれかで設定されている言語が、サポートされている有効な言語と一致しない場合は、英語が使用されます。

Cognos TM1 コンポーネントの言語設定

以下の Cognos TM1 コンポーネントに対して言語が個別に設定されます。

表 14. Cognos TM1 コンポーネントの言語設定の要約

コンポーネント言語設定

Cognos TM1 サーバー Tm1s.cfg ファイルの Language パラメーターを使用して、Cognos TM1 サーバーの特定の言語を設定します。

詳しくは、 97ページの『Cognos TM1 サーバーの言語の設定』を参照してください。

TM1 Cognos Architect、

Cognos TM1 Perspectives

Tm1p.ini ファイルの Language パラメーターを使用して、Microsoft Windows で実行される Cognos TM1 クライアントに特定の言語を設定します。

詳しくは、 98ページの『Windows での Cognos TM1 クライアントの言語の設定』を参照してください。

Cognos TM1 Web Web ブラウザーの言語設定を使用して、Cognos TM1 Web

に特定の言語を選択します。

詳しくは、 98ページの『Cognos TM1 Web の Web ブラウザー言語の設定』を参照してください。

Cognos TM1 言語コードIBM Cognos TM1 でサポートされている言語の言語コードについて以下の表に要約します。

言語コード

ブラジル・ポルトガル語 bra

クロアチア語 hrv

チェコ語 csy

中国語 (簡体字) sch

中国語 (繁体字) tch

デンマーク語 dan

オランダ語 nld


言語コード

ドイツ語 deu

フィンランド語 fin

フランス語 fra

ハンガリー語 hun

イタリア語 ita

日本語 jpn

カザフ語 kaz

韓国語 kor

ノルウェー語 nor

ポーランド語 pol

ルーマニア語 rom

ロシア語 rus

スペイン語 esp

スロベニア語 slv

スウェーデン語 sve

タイ語 tha

トルコ語 trk

Cognos TM1 サーバーの言語の設定Tm1s.cfg ファイルの Language パラメーターを使用して、IBM Cognos TM1 サーバーの特定の言語を設定します。


Cognos TM1 サーバーの Language 設定パラメーターは、サーバーで生成されるメッセージの言語を制御します。 Windows サービスの代わりにアプリケーションとしてサーバーを稼働する際に、パラメーターは、ダイアログ・ボックスのユーザー・インターフェースにも適用されます。

Cognos TM1 サーバーの Language パラメーターについて詳しくは、Tm1s.cfg ファイルの Language パラメーターを参照してください。

注: Language パラメーターの代わりにユーザー・アカウントに基づいて Cognos

TM1 サーバーが言語を使用するようにする場合、Cognos TM1 サーバーを実行するMicrosoft Windows サービスが特定のユーザーとして実行されるように変更します。詳しくは、 87ページの『Windows で特定のユーザー・アカウントとして Cognos

TM1 サービスを実行するための変更』を参照してください。

手順1. テキスト・エディターを使用して、Cognos TM1 サーバー設定ファイル

Tm1s.cfg を開きます。

場所について詳しくは、 341ページの『tm1s.cfg ファイルの場所』を参照してください。


2. Language パラメーターを編集または追加し、使用する言語コードを指定します。

例:

Language=deu

サポートされている言語コードのリストについては、 96ページの『Cognos TM1

言語コード』を参照してください。

3. Tm1s.cfg ファイルを保存して閉じます。

4. Cognos TM1 サーバーを再起動します。

Windows での Cognos TM1 クライアントの言語の設定Tm1p.ini ファイルの Language パラメーターを使用して、Microsoft Windows で実行される IBM Cognos TM1 クライアント (Cognos TM1 Architect や Cognos TM1

Perspectives など) に対して特定の言語を設定します。


このパラメーターについて詳しくは、Tm1p.ini ファイルの Language パラメーターを参照してください。

注: Cognos TM1 クライアントの Language パラメーターは、Cognos TM1 サーバーの同じ名前のパラメーターとは別です。

手順1. テキスト・エディターを使用して、Cognos TM1 クライアント設定ファイル

Tm1p.ini を開きます。

場所について詳しくは、 411ページの『Tm1p.ini ファイルの場所』を参照してください。

2. Language パラメーターを編集または追加し、使用する言語コードを指定します。

例:

Language=sch

サポートされている言語コードのリストについては、 96ページの『Cognos TM1

言語コード』を参照してください。

3. Tm1p.ini ファイルを保存して閉じます。

4. Cognos TM1 クライアントを再起動します。

Cognos TM1 Web の Web ブラウザー言語の設定IBM Cognos TM1 Web インターフェースで使用される言語は、Web ブラウザーの言語設定によって決まります。



1 次言語で IBM Cognos TM1 Web を表示するように Microsoft Internet Explorer

および Mozilla Firefox を設定するには、以下の一般的な手順に従います。詳しくは、ご使用の Web ブラウザーの資料を参照してください。

手順1. 使用する Web ブラウザーに応じて、使用可能な言語オプションで 1 次言語を選択および設定します。

v Internet Explorer の場合、言語オプションは通常、「ツール」メニュー>「インターネットオプション」>「全般」>「言語」の下にあります。

v Firefox の場合、言語オプションは通常、「ツール」メニュー>「オプション」>「コンテンツ」>「言語」の下にあります。

2. 使用する言語を言語リストに追加します。

3. 優先する言語がリストの上部になるようにリストを編成します。

Cognos Configuration による空の新規 Cognos TM1 サーバーの作成IBM Cognos Configuration を使用して、空の新規 Cognos TM1 サーバーを作成することができます。


以下の手順により、空の新規 Cognos TM1 サーバーの tms.cfg 設定ファイルおよび必要なその他のファイルが作成されます。以下の手順は、その他のファイルが含まれていない空のディレクトリーに対してのみ実行します。

ヒント: 既存の TM1 サーバーを Cognos Configuration に追加する場合は、 100ページの『既存の Cognos TM1 サーバーの Cognos Configuration への追加』を参照してください。

手順1. オペレーティング・システムを使用して、新規 Cognos TM1 サーバーファイル用の空フォルダーを作成します。

2. IBM Cognos Configuration を開きます。

3. 「エクスプローラー」パネルで、「データ・アクセス」の下の「TM1 サーバー」を右クリックし、「リソースの新規作成」>「TM1 サーバー・インスタンス」をクリックします。

4. 「名前」ボックスにサーバーの名前を入力します。

5. 「タイプ」ボックスから「TM1 サーバー・インスタンス」を選択して、「OK」をクリックします。

新規サーバーが「TM1 サーバー」ノードの下に追加され、「TM1 サーバー・インスタンス」-「リソース・プロパティー」リストにそのプロパティーが表示されます。

6. 「リソース・プロパティー」リストで、エントリー・ボックスをクリックし、編集アイコンをクリックします。


7. 新規 Cognos TM1 サーバーを作成する空フォルダーのパスを入力するか、参照します。

ヒント: このパスにはファイル名を含めないでください。フォルダーだけを選択する必要があります。

8. 「選択」をクリックします。


新規 tms.cfg ファイルがフォルダーに自動的に作成されます。以下の設定パラメーターの値がファイルに自動的に追加されます。

v ServerName パラメーターは、指定したサーバー名に設定されます。

v DataBaseDirectory パラメーターは、指定したデータ・ディレクトリーに設定されます。

v PortNumber パラメーターは、ランダムに自動生成されたポート番号に設定されます。

10. このデータベースを Cognos TM1 Applications と一緒に使用している場合、必要なパラメーター値で tms.cfg ファイルを編集します。詳しくは、 155ページの『Cognos TM1 Application Web と協働するための Cognos TM1 サーバーの設定』を参照してください。

11. Cognos Configuration の「エクスプローラー」パネルで、新規サーバーを右クリックし、「開始」をクリックします。

新規 Cognos TM1 サーバーの基本ファイルがフォルダーに作成されます。

12. 新規 Cognos TM1 サーバーをテストするには、Cognos TM1 Architect を開始し、ユーザー名 admin を使って、パスワードは指定せずにデータベースにログオンします。

既存の Cognos TM1 サーバーの Cognos Configuration への追加既存の Cognos TM1 サーバーを、 IBM Cognos Configuration に追加して管理することができます。

始める前に

この手順を実施するためには、有効な tm1s.cfg ファイルを持つ既存の Cognos

TM1 データ・ディレクトリーがなければなりません。



3. 「名前」ボックスに、tm1s.cfg ファイルの ServerName パラメーターに設定されたものと同じ名前を入力します。

4. 「タイプ」ボックスから「TM1 サーバー・インスタンス」を選択して、「OK」をクリックします。


新規サーバーが「TM1 サーバー」ノードの下に追加され、「TM1 サーバー・インスタンス」-「リソース・プロパティー」リストにそのプロパティーが表示されます。

5. 「リソース・プロパティー」リストの「TM1 サーバーの構成パス」の右にあるボックスをクリックし、編集アイコンをクリックします。

6. 既存の Cognos TM1 データ・ディレクトリーのパスを入力するか、参照します。

ヒント: このパスにはファイル名を含めないでください。フォルダーだけを選択する必要があります。

7. 「選択」をクリックします。


9. Cognos Configuration の「エクスプローラー」パネルで、新規サーバーを右クリックし、「開始」をクリックします。

10. この Cognos TM1 サーバーをテストするには、Cognos TM1 Architect を開始して、データベースにログオンします。

Cognos TM1 管理ホストの場所の指定IBM Cognos TM1 管理ホストの場所を指定する方法は、クライアント (ユーザー・インターフェース) とリモート・サーバーで異なります。


管理ホストは、Cognos TM1 管理サーバーが実行されているコンピューターです。

手順1. Cognos TM1 Architect や Cognos TM1 Perspectives などのクライアントから参照する管理ホストを指定するには、以下のようにします。

v サーバー・エクスプローラーで Cognos TM1 の「オプション」メニューを使用して、Tm1p.ini ファイルを変更します。

v Tm1p.ini クライアント設定ファイルの AdminHost パラメーターを手動で編集することもできます。


2. リモート・サーバーの登録先となる管理ホストを指定するには、以下のいずれかの方法を使用します。

v Tm1s.cfg ファイルの AdminHost パラメーターを編集します。

v Cognos TM1 サーバーの Windows バージョンを立ち上げるときに -v コマンド行パラメーターを使用します。

詳細については、 341ページの『付録 A. tm1s.cfg サーバー設定ファイル』を参照してください。


複数の Cognos TM1 管理ホストの指定ホスト名をセミコロンで区切ると、複数の管理ホストを参照するように IBM

Cognos TM1 クライアントを設定できます。


クライアントで複数の管理ホストが指定されている場合は、それらのホスト上のCognos TM1 管理サーバーに登録されているすべての Cognos TM1 サーバーにクライアントからアクセスできます。

手順

Cognos TM1 Architect や Cognos TM1 Perspectives など、クライアントから参照される複数の管理ホストを指定するには、ホスト名をセミコロンで区切ります。

v サーバー・エクスプローラーで Cognos TM1 の「オプション」メニューを使用して、Tm1p.ini ファイルを変更します。

v Tm1p.ini クライアント設定ファイルの AdminHost パラメーターを手動で編集することもできます。


Advanced Cognos TM1 管理サーバーおよび Cognos TM1 サーバーの設定

このセクションでは、初期インストール手順の完了後に、特定のビジネス要件と環境に応じて IBM Cognos TM1 をカスタマイズするための詳細設定について説明します。

Cognos TM1 管理サーバーのデフォルト・ポート番号の変更IBM Cognos Configuration で「TM1 管理サーバーのホストのポート番号」または「TM1 管理サーバーの SSL ポート番号」のデフォルト値を変更した場合、環境内の影響を受けるすべてのコンピューターで UNIX および Microsoft Windows のサービス・ファイルを新しい値に手動で更新することが必要になります。このオペレーティング・システム・ファイルが Cognos TM1 によって更新されることはありません。


Cognos TM1 管理サーバーと通信することが必要な Cognos TM1 のコンポーネントが実行されているすべてのコンピューターにあるオペレーティング・システム・サービス・ファイルを更新します。例:


v Cognos TM1 デスクトップ・クライアント (Cognos TM1 Architect や Cognos

TM1 Perspectives など)

v Cognos TM1 API で作成された Cognos TM1 のカスタム・アプリケーション

v Cognos TM1 Web (Web サーバーのみ)


手順1. 特定のオペレーティング・システムのサービス・ファイルを見つけて、それを開きます。

v UNIX の場合、サービス・ファイルの標準的な場所は以下のとおりです。

/etc/services

v Windows の場合、サービス・ファイルの標準的な場所は以下のとおりです。

C:¥WINDOWS¥system32¥drivers¥etc¥services

2. サービス・ファイルの中で以下の項目を追加または編集し、新しいポート番号を指定します。例:

tm1adminsvr 5400/tcp # Added by IBM Cognos TM1

tm1admsrv_ssl 5403/tcp # Added by IBM Cognos TM1

3. ファイルを保存して閉じます。

4. Cognos TM1 管理サーバーと通信する Cognos TM1 コンポーネントが実行されているコンピューターごとに、これらの手順を繰り返します。

5. tm1web_config.xml ファイルを編集して、管理サーバーのポート番号を指定します。

v SSL を使用している場合は、AdminHostSSLPort パラメーターを編集します。

v SSL を使用していない場合は、AdminHostPort パラメーターを編集します。

tm1web_config.xml ファイルは <TM1 のインストール場所>¥webapps¥tm1web¥WEB-INF¥configuration¥ にあります。

tm1web_config.xml ファイルについて詳しくは、 131ページの『Cognos TM1

Web 設定ファイルの編集』および 125ページの『Cognos TM1 Web 構成パラメーター』を参照してください。

IPv6 を使用するための Cognos TM1 の設定IBM Cognos TM1 をインターネット・プロトコル・バージョン 6 (IPv6) と共に使用するには、 Cognos TM1 パラメーターの組み合わせ、およびオペレーティング・システムの環境変数を設定します。


デフォルトで、Cognos TM1 は IPv4 を使用します。

Cognos TM1 が使用するモードを以下のいずれかに設定して、Cognos TM1 がネットワークで使用するインターネット・プロトコルを指定できます。

ipv4 デフォルトの設定。IPv4 ネットワークに使用します。

dual IPv4 から IPv6 に移行する場合に使用します。両方のプロトコルがサポートされます。

ipv6 IPv6 ネットワークに使用します。

手順1. 次の手順で、Cognos TM1 管理サーバーを設定します。


a. Cognos TM1 管理サーバーが稼働しているコンピューターで、「Cognos

Configuration」を開きます。

b. 「ローカル設定」>「環境」ノードを展開して、「TM1 管理サーバー」をクリックします。

c. 「コンポーネント・プロパティー」ウィンドウで、「TM1 管理サーバーのIP サポート」オプションを、「デュアル (IPv4 および IPv6)」、「IPv4」、または「IPv6」に設定します。

d. 必要であれば、UNIX および Microsoft Windows で、IPv6 アドレスを/etc/hosts オペレーティング・システム・ファイルに追加します。使用するネットワーク環境および DNS 設定によっては、 Cognos TM1 管理サーバーおよび Cognos TM1 サーバーを IPv6 モードで正常に実行するために、この追加ステップを実行しなければならないことがあります。

e. ステップ 3 で説明されているように、TM1_IPVersion 環境変数を追加します。

2. 次の手順で、Cognos TM1 サーバーを設定します。

a. Cognos TM1 サーバーが稼働しているコンピューターで、tm1s.cfg ファイルを開きます。

b. IPversion パラメーターを、使用する IP モードに設定します。

例えば、ネットワークが IPv6 プロトコルを使用するように指定するには、パラメーターを以下のように追加します。

IPVersion=ipv6

詳細については、 366ページの『IPVersion』を参照してください。

c. 必要であれば、UNIX および Microsoft Windows で、IPv6 アドレスを/etc/hosts オペレーティング・システム・ファイルに追加します。

d. ステップ 3 で説明されているように、TM1_IPVersion 環境変数を追加します。

3. TM1_IPVersion 環境変数を、 Cognos TM1 管理サーバーまたは TM1 サーバー(もしくはその両方) と直接通信する各コンピューターのオペレーティング・システムに追加します。

次の変数名と値の書式を使用します。

TM1_IPVersion=ip_mode

ここで、ip_mode には、次のいずれかの値を指定できます。

v Dual

v IPv6

v IPv4

TM1_IPVersion 環境変数は、以下のいずれかの Cognos TM1 コンポーネントを実行しているコンピューターで必要となります。




v Cognos TM1 管理者ツール (TM1 Top、ETLDAP、tm1srvstop.exe ユーティリティーなど)。

v Cognos TM1 Web (Web サーバーのみ)


v Cognos TM1 クライアント:

– Cognos TM1 Architect

– Cognos TM1 Perspectives

– Cognos Insight

– Cognos TM1 Performance Modeler

v Cognos TM1 API を使用するカスタム・アプリケーション。

注: Web ブラウザーだけを使用して Cognos TM1 Web にアクセスするコンピューターには、この環境変数を設定する必要がありません。

4. 変更した Cognos TM1 サーバーを再始動します。

5. Cognos TM1 サーバーとクライアント・アプリケーションとの間の接続をテストします。

TM1 サーバー・ライセンスの使用状況のモニターIBM Cognos TM1 Server は、IBM Software License Metric Tag (SLMT) ファイルを生成します。 SLMT ファイルをサポートするバージョンの IBM License Metric

Tool は、 TM1 Server のライセンス使用に関する情報を提供する License

Consumption Report を生成できます。

IBM License Metric Tool をインストールして使用する方法について詳しくは、IBM Knowledge Center の IBM License Metric Tool を参照してください。

SLMT ファイルの最初の生成は、LicenseMetricTime Tm1s.cfg パラメーターによって決まります。一度 LicenseMetricTime によって SLMT ファイルの生成が有効になると、新しい SLMT ファイルが 24 時間ごとに作成されます。

AUTHORIZED_USER メトリックについて

AUTHORIZED_USER メトリックは、以下のサブタイプを含む場合があります。

v IBM Cognos Enterprise Planning TM1 Modeler - TM1 Server 上でAdmin、DataAdmin、または SecurityAdmin のユーザー・グループのメンバーになっているユーザー。

v IBM Cognos Enterprise Planning TM1 Contributor - Modeler ではないが、TM1

Server の 1 つ以上のキューブに対して書き込み権限を持つグループに割り当てられているユーザー。キューブに対して書き込み権限を持つグループとは、キューブに対する「書き込み」、「ロック」、「予約」、「管理」のいずれかのセキュリティー権限を割り当てられたグループのことです。

v IBM Cognos Enterprise Planning TM1 Explorer - Modeler でも Contributor でもないユーザー。

これらの各サブタイプについて、AUTHORIZED_USER メトリックは、SLMT ファイルで指定された期間に TM1 Server にログオンしたユーザーの数を記録します。


http://www.ibm.com/support/knowledgecenter/SS8JFY/lmt_welcome.html

Software License Metric Tag ファイルの場所

すべてのオペレーティング・システムで、SLMT ファイルは TM1 のインストール場所の slmtag ディレクトリー (bin や bin64 ディレクトリーと同じレベル) に作成されます。例えば、C:¥Program Files¥IBM¥cognos¥tm1_64¥slmtag です。すべての SLMT ファイルには .slmtag ファイル拡張子が使用されます。

トラブルシューティング

TM1 Server は、Modeler、Contributor、および Explorer の数の計算方法を示すために、 SLMT ファイルを生成するときに、同じファイル名で .slmtagraw というファイル拡張子のファイルも生成します。この .slmtagraw ファイルは、slmtag フォルダーと同じレベルに存在する slmtagraw というフォルダーに作成されます。

この .slmtagraw ファイルは、IBM License Metric Tool が使用するものではありません。メトリックの計算に関して洞察を提供する目的のみで存在します。例えば、以下の .slmtagraw ファイルからの抜粋では、Planner というユーザーが Contributor

であることがわかります。そのユーザーは BUDGET PLANNER グループに属していて、そのグループには plan_BudgetPlan キューブに対する WRITE 権限があります。

<Metric LogTime="2016-10-18T14:45:20Z"><Type>GROUP_INFO</Type><SubType>GROUP_DETAIL</SubType><Value><![CDATA[Group BUDGET PLANNER is a contributor group: Group BUDGET PLANNERhas WRITE permission on cube plan_BudgetPlan.]]></Value><Period><StartTime>2016-10-18T14:44:50Z</StartTime><EndTime>2016-10-18T14:45:20Z</EndTime></Period></Metric>

<Metric LogTime="2016-10-18T14:45:20Z"><Type>USER_INFO</Type><SubType>MODELER</SubType><Value><![CDATA[User Planner is a Contributor. Belongs to group BUDGET PLANNER.Group BUDGET PLANNER has WRITE permission on cube plan_BudgetPlan.]]></Value><Period><StartTime>2016-10-18T14:44:50Z</StartTime><EndTime>2016-10-18T14:45:20Z</EndTime></Period></Metric>


第 9 章 Cognos TM1 Operations Console のインストール

IBM Cognos TM1 インストール・プログラムは、IBM Cognos TM1 Operations

Console を、付属の Web アプリケーション・サーバーを使用してインストールします。TM1 Operations Console を独自の Web アプリケーション・サーバーを使用してインストールすることもできます。TM1 Operations Console は、Cognos TM1 サーバーのアクティビティーをモニターするために使用される Java ベースのオプション・コンポーネントです。

付属の WebSphere® Liberty Web サーバー・ソフトウェアを使用する場合の Cognos TM1 Operations Console のインストール

IBM Cognos TM1 Operations Console は、Cognos TM1 サーバーのアクティビティーをモニターするために使用される Java ベースのオプション・コンポーネントです。

始める前に

Cognos TM1 Operations Console は、Cognos TM1 をインストールするとデフォルトでインストールされます。また、これは付属の WebSphere® Liberty Web サーバー・ソフトウェアを使用します。

Cognos TM1 Operations Console をインストールする前に、以下を行います。

v Cognos TM1 の前提ソフトウェアがインストールされていることを確認します。

v Cognos TM1 管理サーバー、TM1 アプリケーション・サーバー、モニター対象のCognos TM1 サーバー、および TM1 Sdata サーバーがインストールされていて稼働していることを確認します。

v Cognos TM1 Architect を開始でき、モニター対象の Cognos TM1 サーバーに管理者としてログオンできることを確認します。

v すべてのサービスは、単一のドメイン・アカウントの下で実行する必要があります。 Cognos TM1 インストール・ウィザードではドメイン・アカウントのパラメーターが自動的に設定されますが、インストールを実行する前に、サービスが実行されるアカウントを作成しておく必要があります。各サービスがそれぞれ異なるアカウントで実行されている場合、それらのサービス間では相互に通信できません。

v Cognos TM1 Operations Console を使用して、 Cognos TM1 バージョン 9.5.2 サーバーをモニターすることができます。ただし、9.5.2 システム内では機能をすべて使用できるわけではないため、基本的なモニタリングを実行して実行中またはオフラインの 9.5.2 サーバーのハートビート状況を表示することしかできません。

v アップグレード: 設定の変更、特に共有ログ・スケジュール・ファイルの変更のため、9.x バージョンの Cognos TM1 Operations Console 設定ファイルを使用することはできません。サーバー・データ、ユーザー設定、およびスケジュール情報を再入力する必要があります。


手順1. Microsoft Windows Vista、Windows 7、または Windows Server 2008 オペレーティング・システム・ソフトウェアでは、issetup.exe コマンドを右クリックし、「管理者として実行」をクリックします。その他のオペレーティング・システムでは、IBMCognosTM1 インストール・ディスク上、または CognosTM1 インストール・ファイルをダウンロードして解凍した場所にある issetup.exe ファイルをダブルクリックします。

2. 「Web アプリケーション層」>「Cognos TM1 Operations Console」コンポーネントを選択しておきます。

要確認: ASCII 文字だけで構成されるパス名を持つディレクトリーに IBM

Cognos TM1 コンポーネントをインストールします。一部の Windows Web サーバーでは、ディレクトリー名に ASCII 以外の文字を使用することができません。

Cognos Configuration を使用した Cognos TM1 Operations Consoleの配置

Cognos Configuration で TM1 アプリケーション・サーバーを開始して、TM1

Operations Console の実行に必要な WebSphere® Liberty サーバーを配布します。

始める前に

Microsoft Windows Vista、Windows 7、または Windows 2008 オペレーティング・システム・ソフトウェアを実行するコンピューターで、Program Files (x86) ディレクトリーから製品をインストールする場合は、IBM Cognos Configuration を管理者として開始します。

手順1. 「スタート」>「すべてのプログラム」>「IBM Cognos TM1 」>「IBM Cognos

Configuration」をクリックします。

2. 「TM1 アプリケーション・サーバー」を右クリックして、「開始」をクリックします。

この手順では、Cognos TM1 に用意されているバージョンの WebSphere® Liberty

を開始し、Cognos TM1 Operations Console を自動的に配布します。

3. 「ファイル」>「保存」とクリックして構成データを保存します。

4. 「ファイル」>「終了」とクリックして、Cognos Configuration を閉じます。

Cognos TM1 Operations Console の高度なインストール以下のトピックでは、Cognos TM1 Operations Console をインストールする別の方法について詳しく説明します。


別マシンへの Cognos TM1 Operations Console のインストール

モニター対象のサーバーとは別のマシンに Cognos TM1 Operations Console のみをインストールできます。

手順1. 通常のプロセスに従って Cognos TM1 をインストールします。ただし、Web コンポーネント・リストから TM1 Operations Console のみを選択します。デフォルトでは、Cognos TM1 アプリケーション・サーバーなどのサービスもインストールされます。

2. インストール後、別マシンで TM1 アプリケーション・サービスを停止します。

3. installation_location/webapps/pmpsvc ディレクトリーとinstallation_location/webapps/p2pd ディレクトリーを削除します。

4. TM1 アプリケーション・サービスを再始動します。

Apache Tomcat Web アプリケーション・サーバーの独自インストールを使った Cognos TM1 Operations Console のインストール

このセクションでは、Cognos TM1 Applications を別のコンピューターにインストールし、Apache Tomcat の独自インストールを使用して配布する方法について説明します。

Cognos TM1 Operations Console を配布する際に、Performance Management Hub も配布されます。

このインストールは、TM1 管理サーバーと TM1 サーバーが別のコンピューターで稼働している環境を対象としています。独自の Web サーバー・ソフトウェアを使用する場合、証明書をインストールして WAR ファイルを配布する必要があります。

証明書のインストールについて詳しくは、「Cognos TM1 Operations Console」の『TM1 アプリケーション・サーバーのモニター時の SSL の使用』を参照してください。

JRE ユーザー環境変数の確認Cognos TM1 Operations Console には、classpath ユーザー環境変数の設定が必要です。

Apache Tomcat の独自のインストール環境を使用する場合、JRE パスのための次のMicrosoft Windows ユーザー環境変数があることを確認してください。

v 変数名: classpath

v 変数値: .;C:\Program Files\Java\jre7\bin

Cognos TM1 インストール環境に付属している Tomcat を使用する場合、この変数は自動的に設定されます。

第 9 章 Cognos TM1 Operations Console のインストール 109

JRE 鍵ストアへの証明書の追加IBM Cognos TM1 Operations Console では、Java ランタイム環境 (JRE) 鍵ストアに証明書が必要です。

手順1. Java keytool コマンドを実行して、証明書を鍵ストアにインポートします。

a. コマンド・プロンプトを開き、次のディレクトリーに移動します。

location \bin\jre\7.0\bin

location は、Cognos TM1 がインストールされているファイル・ディレクトリーです。

注意:64 ビット・コンピューターの場合、必ず bin64 フォルダーに証明書を追加してください。

b. 次のコマンド行を実行します。ここではコマンドは書式上改行されていますが、コマンド全体を 1 行で入力する必要があります。

keytool -import -file "C:\location\bin\ssl\applixca.pem"-keystore "C:\location\bin\jre\7.0\lib\security\cacerts"-storepass "changeit"

64 ビット・インストール環境の場合、証明書を扱う際には 64 ビットのフォルダーがターゲットになります。例えば、このサンプル・コマンドは 64 ビット JRE をターゲットとするものです。

cd C:\Program Files\ibm\cognos\TM1_64\bin64\jre\7.0\bin

次のコマンドは 64 ビット・システムで使用される例です。このコマンドは書式上改行されていますが、コマンド全体を 1 行で入力する必要があります。

keytool -import -file "C:\Program Files\ibm\cognos\TM1_64\bin64\ssl\tm1ca_v2.pem" -keystore "C:\Program Files\ibm\cognos\TM1_64\bin64\jre\7.0\lib\security\cacerts" -storepass "changeit"

64 ビット・インストール環境を実行する際に、証明書用の 64 ビットの場所が正しくターゲットとして指定されていない場合、サーバーに接続できないという警告メッセージを受け取ることになります。

c. 証明書を信頼または追加するかどうかを尋ねるプロンプトが出されたら、yes

と入力します。

「証明書は鍵ストアに追加されました」というメッセージが表示されます。

2. 変更を有効にするためにアプリケーション・サーバーを再始動しなければならない場合もあります。

要確認: Cognos TM1 を再インストールする場合は、そのたびに証明書を再び追加してください。

Apache Tomcat への Cognos TM1 Operations Console の配置Apache Tomcat の独自のインストール環境を使用する場合、IBM Cognos TM1

Operations Console を Tomcat に配置する必要があります。


始める前にv Cognos TM1 Operations Console を配備するコンピューターで Apache Tomcat のインスタンスを開始します。

v Apache Tomcat Manager コンソールにアクセスできることを確認します。

v 前に Tomcat Manager を使用したことがなければ、ログインする前にtomcat-users.xml ファイルにユーザーとロールを追加します。詳しくは、Apache Tomcat の資料を参照してください。

v IBM Cognos Configuration を使用して、アプリケーション・ファイルを作成します。 159ページの『Apache Tomcat サーバーまたは WebSphere® Liberty サーバーのためのアプリケーション・ファイルの作成』を参照してください。

手順1. Apache Tomcat が実行されている状態で、「スタート」>「プログラム」

>「Tomcat Manager」とクリックします。 Apache Tomcat インスタンスでユーザー名とパスワードが必要とされる場合は、それらを入力します。

2. Tomcat Manager で、「配備」セクションまで下にスクロールし、「WAR ファイルの配備」サブセクションを見つけます。

要確認: Cognos TM1 Operations Console の以前のバージョンが既に配備されている場合、Tomcat Manager で「配備解除」オプションを使用して、以前のバージョンの配備を解除します。

3. 「参照」をクリックして、IBM Cognos Configuration を使用して作成したCognos TM1 Operations Console Web アプリケーションのアーカイブ・ファイルを見つけます。


5. Tomcat Manager で「配備」をクリックします。

配備が完了したら、Cognos TM1 Operations Console は、Tomcat Manager の「アプリケーション」セクションに /tm1operationsconsole として表示されます。

IBM WebSphere への Cognos TM1 Operations Console のインストール

IBM WebSphere アプリケーション・サーバーに Cognos TM1 Operations Console を配布できます。

Cognos TM1 Operations Console を配布する際に、Performance Management Hub も配布されます。

このインストールは、TM1 管理サーバーと TM1 サーバーが別のコンピューターで稼働している環境を対象としています。

WebSphere に Operations Console を配布するには、以下のタスクを実行します。

v Cognos Configuration を使用して、アプリケーション・ファイルを作成します。163ページの『IBM WebSphere サーバー用のアプリケーション・ファイルの作成』を参照してください。tm1web.war ファイルや pmpsvc.war ファイルと同じ場


所に pmhub.war ファイルが作成されます。デフォルトの場所は <インストールの場所>¥ibm¥cognos¥TM1¥pmhub.war です。

注: WAR の代わりに EAR ファイル形式を使用できます。

v WebSphere アプリケーション・サーバーへ pmhub.war ファイルを配布します

v TM1 管理サーバーと TM1 サーバーから証明書を取得します

v Websphere から TM1 管理サーバーへの発信通信を設定します

IBM WebSphere アプリケーション・サーバーへの Cognos TM1Operations Console の配置IBM WebSphere 管理コンソールを使用して、WebSphere アプリケーション・サーバーに TM1 Operations Console を配置して実行します。

始める前にv IBM WebSphere アプリケーション・サーバーをインストールします。

v プロファイル管理ツールを使用してプロファイルを作成します。

v 作成したプロファイルを使用して、WebSphere アプリケーション・サーバーを始動します。

Microsoft Windows で、「スタート」 > 「すべてのプログラム」 > 「IBMWebSphere Application Server」 > 「プロファイル」 > [プロファイル名] >

「サーバーの始動」の順にクリックします。

コマンド・ウィンドウが開き、始動の進行状況が表示されます。始動プロセスが完了した後に、コマンド・ウィンドウに「Server started.」というメッセージが表示されます。このコマンド・ウィンドウを最小化することはできますが、閉じないでください。このウィンドウは、WebSphere が実行している間は開いたままにしておく必要があります。

v Cognos Configuration を使用して、アプリケーション・ファイルを作成します。163ページの『IBM WebSphere サーバー用のアプリケーション・ファイルの作成』を参照してください。 Operations Console および Performance Management

Hub は、pmhub.war ファイルに入っています。

WebSphere のインストール方法とプロファイルの作成方法について詳しくは、WebSphere の資料を参照してください。


これらの手順は、IBM WebSphere アプリケーション・サーバー8.5.5 に基づいています。バージョン 8.5 の場合の手順も類似しています。

注: WebSphere アプリケーション・インストール・ウィザードのステップの実行を開始した後に、アプリケーションのインストールを中止する場合は、「キャンセル」をクリックして終了します。別の管理コンソール・ページに単に移動するのではなく、その前にまずアプリケーション・インストール・ページで「キャンセル」をクリックしてください。

手順1. WebSphere 管理コンソールを開きます。


v Windows では、「スタート」 > 「すべてのプログラム」 > 「IBMWebSphere Application Server」 > 「プロファイル」 > [プロファイル名] >

「管理コンソール」の順にクリックします。または、https://localhost:9043/

ibm/console/ にアクセスします。

v UNIX では、「アプリケーション」 > 「IBM Websphere」 > 「IBMWebsphere Application Server」 > 「プロファイル」 > [プロファイル名] >



2. 作成した WebSphere プロファイルを使用してログオンします。管理コンソールが開きます。

3. JVM スタック・メモリーのサイズを設定します。

a. 「サーバー」 > 「サーバー・タイプ」 > 「WebSphere ApplicationServer」をクリックします。

b. Operations Console を配置するサーバーをクリックします。

c. 「サーバー・インフラストラクチャー」の下で、「Java およびプロセス管理」 > 「プロセス定義」をクリックします。

d. 「追加プロパティー」の下で、「Java 仮想マシン」をクリックします。

e. 「汎用 JVM 引数」フィールドに、-Xmso512k を追加します。

注: スタック・メモリーを設定するまで、Operations Console を配置しないでください。そのようにすると、Operations Console は配置されますが、WebSphere アプリケーション・サーバーが始動しません。

startServer.sh ファイルを使用してスタックのメモリー・サイズを設定しないでください。サーバーが始動すると、WebSphere はそのファイルから-Xmso 設定を削除してデフォルト値でオーバーライドしますが、その値は小さすぎます。

f. 「適用」をクリックし、「OK」をクリックします。「保存」をクリックします。

4. 「アプリケーション」 > 「新規アプリケーション」の順にクリックして、「新規エンタープライズ・アプリケーション」をクリックします。

5. 「参照」をクリックし、Cognos Configuration の「アプリケーション・ファイルを構築」コマンドを使用して生成した pmhub.war ファイルを見つけて選択します。「開く」をクリックします。

6. 「次へ」をクリックします。

7. 「ファスト・パス」をクリックして「次へ」をクリックします。

8. 「ステップ 4: Web モジュールのコンテキスト・ルートをマップ」をクリックします。

9. コンテキスト・ルート・ボックスで、/pmhub と入力します。「次へ」をクリックします。

10. 「終了」をクリックします。 WebSphere はアプリケーションをインストールします。このプロセスは完了するまで数分かかることがあります。

インストールが完了すると、WebSphere には「アプリケーション pmhub_war

は正常にインストールされました」と表示されます。


11. 「保存」をクリックします。

12. 「アプリケーション」 > 「アプリケーション・タイプ」 > 「Websphere エンタープライズ・アプリケーション」をクリックします。

13. pmhub_war の横のチェック・ボックスを選択し、「開始」をクリックします。WebSphere に、「アプリケーション pmhub_war がサーバー server_name およびノード node で正常に始動されました。場合によっては、コレクションを最新表示して現行の状況を表示する必要があります。」と表示されます。

次のタスク

次のステップでは、TM1 管理サーバーと TM1 サーバーから SSL 証明書を取得します。

TM1 管理サーバーおよび TM1 サーバーからの SSL 証明書の取得アプリケーション・ファイル pmhub.war を IBM WebSphere アプリケーション・サーバーにデプロイしたら、次の手順は、TM1 管理サーバーおよび TM1 サーバーから SSL 証明書を取得することです。

手順1. IBM WebSphere 管理コンソールで、「セキュリティー」を展開して「SSL 証明書および鍵管理」をクリックします。

2. 「関連項目」の下の「鍵ストアと証明書」をクリックします。

3. 「NodeDefaultTrustStore」鍵ストアをクリックします。

4. 「追加プロパティー」の下で、「署名者証明書」をクリックします。

5. 「ポートから取得 (Retrieve from port)」をクリックします。次の情報を入力します。

v 「ホスト」フィールドに、TM1 管理サーバーのホスト名を入力します。

v 「ポート」フィールドに、TM1 管理サーバーのポート番号である 5498 を入力します。

v 「別名」フィールドに TM1AdminServer_cert と入力します。

6. 「署名者情報の取得 (Retrieve signer information)」をクリックします。Websphere は、TM1 管理サーバーから SSL 証明書を取得します。

7. その証明書情報が、信頼できる証明書のものであることを確認します。

8. 「適用」をクリックしてから、「保存」をクリックします。

9. Operations Console でモニターする TM1 サーバーごとにこの手順を繰り返します。例:

v 「ホスト」フィールドに、TM1 サーバーのホスト名を入力します。

v 「ポート」フィールドに、TM1 サーバーのポート番号を入力します。

v 「別名」フィールドに TM1ServerName_cert と入力します。

ヒント: TM1 サーバーのポート番号は、tm1s.cfg ファイルの PortNumber パラメーターで構成されます。

10. 変更内容を保存します。


次のタスク

次の手順では、Websphere から TM1 管理サーバーへの発信通信を設定します。

TM1 管理サーバーへの発信通信の構成アプリケーション・ファイル pmhub.war を IBM WebSphere アプリケーション・サーバーに配置して SSL 証明書を取得した後の次の手順は WebSphere から TM1 管理サーバーへの発信通信をセットアップする作業です。

手順1. WebSphere 管理コンソールで「セキュリティー」を展開して、「SSL 証明書および鍵管理」をクリックします。

2. 「構成設定」の下の「エンドポイント・セキュリティー構成の管理」をクリックします。

3. 「アウトバウンド」 > 「[node]Node01Cell」 > 「ノード」と展開します。

4. 「[node]Node01Cell」をクリックします。node は Operations Console を配置するサーバーの名前です。

5. 「関連項目」の下の「動的アウトバウンド・エンドポイント SSL 構成」をクリックします。


7. 「新規」をクリックします。

8. 「名前」フィールドに tm1admin と入力します。

9. 「説明」フィールドに、ssl connection と入力します。

10. 「接続情報」の下に *,*,5498 と入力して、「追加」をクリックします。

注: 値の 5498 は、Cognos Configuration で指定されている TM1 管理サーバーの SSL ポート番号です。

11. 「適用」をクリックし、「OK」をクリックします。

12. 変更内容を保存します。

13. WebSphere アプリケーション・サーバーを再始動します。

14. Web ブラウザーで、Operations Console を実行するためのhttp://localhost:port/pmhub/pm/opsconsole/. という URL を入力します。port は、pmhub.war を配置した仮想ホストのポート番号に置き換えてください。例: http://localhost:9080/pmhub/pm/opsconsole/。 Operations Console

のログオン・ページが表示されます。

Cognos TM1 Operations Console の設定デフォルトでは、Cognos TM1 Operations Console はサンプル管理ホストとしてlocalhost、サーバーとして sdata、および admin というグループを認証に使用するように設定されていて、すぐに稼働できるようになっています。必要に応じて、これらの設定を編集して認証サーバーをカスタマイズすることができます。

手順1. http://servername:port number/pmhub/pm/admin を入力して設定画面を開きます。


2. モニター用のデフォルトの管理ホスト、サーバー、およびグループを変更するには、「com.ibm.ba.pm.opsconsole.monitor.tm1.TM1OpsConsoleMonitor」ノードを展開し、「com.ibm.ba.pm.opsconsole.monitor.tm1.TM1OpsConsoleMonitor.dictionary」オプションを選択します。各設定をクリックして、それを変更します。 Cognos

TM1 Operations Console を Microsoft Internet Explorer 8 で使用する場合は、Microsoft Internet Explorer の文書を参照して、次のように設定にしておいてください。

v Web ページにアクセスするごとに最新表示をするオプションを有効にします。

v スクリプト・デバッグのためのオプションは無効にします。

Cognos TM1 Operations Console の開始およびログインIBM Cognos TM1 Operations Console を開くには、このコンポーネントのポートとサーバー名を識別する URL を入力します。

手順1. Web ブラウザーで、Web アドレス http://servername:port

number/pmhub/pm/opsconsole を入力します。

ここで、

v server_name は、Cognos TM1 Operations Console および Web アプリケーション・サーバーがインストールされているコンピューターです。Cognos TM1

Application Web を実行している Web サーバーに現在ログオンしている場合、キーワード localhost を使用できます。そうでない場合は、アプリケーションをホスティングする Web サーバーのマシン名、ドメイン名、またはIP アドレスを使用できます。

v port_number は、Web アプリケーション・サーバーが稼働しているポート番号です。Cognos TM1 のインストールに含まれているバージョンの WebSphere®

Liberty の場合、デフォルトのポート番号は 9510 です。Apache Tomcat の場合は、C:\Program Files\Apache Software Foundation\Tomcat 6.0\conf\ の場所にある Apache Tomcat の server.xml ファイルを開き、使用しているバージョンの Tomcat のポート設定を確認してください。

2. ログオン・ページで、以下のフィールドに値を入力してから、「ログオン」をクリックします。デフォルトのモニター・グループを使用するには、以下を入力します。

v ネームスペース: プルダウンを使用して、使用可能なネームスペースを選択します。システムが CAM で保護されたシステムである場合、ネームスペースは、TM1 システムが保護されている Cognos Analytics ネームスペースです。システムが CAM で保護されていない場合、ネームスペースは adminhost/tm1

server (例えば、localhost/SData など) です。



作業を始める前に、Cognos TM1 Operations Console のセットアップを参照してください。


https://www.ibm.com/support/knowledgecenter/SSD29G_2.0.0/com.ibm.swg.ba.cognos.tm1_op.2.0.0.doc/c_tm1_ops_console_configuration_tasks.html

第 10 章 Cognos TM1 Web のインストール

Cognos TM1 サーバーやその他の Cognos TM1 コンポーネントをインストールしたコンピューターとは別のコンピューターに、IBM Cognos TM1 Web をインストールできます。

Apache Tomcat アプリケーション・サーバー上または IBM WebSphere アプリケーション・サーバー上に TM1 Web を配布できます。以下を参照してください。

v 118ページの『付属の WebSphere® Liberty アプリケーション・サーバーを使用する場合の TM1 Web のインストール』

v 121ページの『IBM WebSphere を使用する TM1 Web のインストール』

TM1 Web をインストールする際に、TM1 Applications Web もインストールされます。

Cognos TM1 Web アーキテクチャーの詳細については、 29ページの『Cognos TM1

Web アーキテクチャー』を参照してください。

Cognos TM1 Web のインストールのためのチェックリスト

Cognos TM1 Web をインストールする際のチェックリスト全体は、以下の項目で構成されます。

v Cognos TM1 Web をインストールします。

v Tomcat を使用している場合、IBM Cognos Configuration を使用して、Cognos

TM1 Web 用の Web アプリケーション・サーバーを開始します。

WebSphere アプリケーション・サーバーを使用している場合、WebSphere 管理コンソールを使用して、アプリケーション・サーバーを開始します。

v ネットワーク環境から Cognos TM1 Web を実行してテストします。

v Cognos TM1 Web 設定ファイルを編集して、複数コンピューターの環境をサポートするようにします。 132ページの『AdminHostName パラメーターおよびTM1ServerName パラメーターを使用した Cognos TM1 Web ログイン・ページの設定』を参照してください。

v 認証とデータ転送のセキュリティーを設定します。 247ページの『第 18 章セキュリティー構成』を参照してください。

v Cognos TM1 Web 設定ファイルに追加のオプションを設定します。 124ページの『Cognos TM1 Web 構成パラメーターの変更』を参照してください。

v 使用している環境で Web ブラウザーを設定します。 144ページの『Cognos TM1

Web の Web ブラウザー設定』を参照してください。

関連概念:

56ページの『Cognos TM1 Web のアップグレード』Cognos TM1 サーバーをインストールしたコンピューターとは別のコンピューターに IBM Cognos TM1 Web がある場合、次の手順に従って Web サーバーをアップグレードします。


付属の WebSphere® Liberty アプリケーション・サーバーを使用する場合の TM1 Web のインストール

Cognos TM1 Web を別のコンピューターにインストールし、インストールに付属する WebSphere® Liberty のインスタンスを使用して配布することできます。

IBM Cognos TM1 をインストールすると、Cognos TM1 Web が、付属するバージョンの WebSphere® Liberty Web アプリケーション・サーバーで実行するように設定されます。

Cognos TM1 Web を別個のコンピューターにインストールした後、Cognos TM1

Web 設定ファイルを編集して、Cognos TM1 管理サーバーが実行されているリモート・コンピューターを識別します。

Cognos TM1 Web の Microsoft Windows でのインストールおよび設定

以下のステップでは、IBM Cognos TM1 Web を、Microsoft Windows を実行している別のコンピューターにインストールする方法について説明します。この手順は、付属の WebSphere® Liberty アプリケーション・サーバーを使用する場合に当てはまります。


この手順では、IBM Cognos Configuration ユーティリティーもインストールします。Cognos Configuration を使用して、アプリケーション・サーバーを開始および停止します。

IBM Cognos TM1 Web が別のコンピューター上にインストールされている場合、設定ファイルを編集して、Cognos TM1 Web と共に使用する、ネットワーク内のIBM Cognos TM1 管理サーバーと IBM Cognos TM1 サーバーを指定します。

手順1. Cognos TM1 Web のために使用するコンピューターのタイプに一致するインストール・プログラムを実行します。

v 32 ビット (Windows)

v 64 ビット (Windows)

2. Microsoft Windows Vista、Windows 7、または Windows Server 2008 オペレーティング・システム・ソフトウェアでは、issetup.exe ファイルを右クリックし、「管理者として実行」をクリックします。その他のオペレーティング・システムでは、issetup.exe ファイルをダブルクリックします。

3. 「TM1 Web 層」コンポーネントとして、「TM1 Web」、「TM1 アプリケーション・サーバー」、および「Cognos Access Manager」のみを選択します。その他のすべてのコンポーネントの選択を解除します。

4. インストール・ウィザードのプロンプトに従って、インストールを完了します。

5. IBM Cognos Configuration を開始します。


重要: Windows Vista、Windows 7、または Windows Server 2008 オペレーティング・システム・ソフトウェアを実行するコンピューターで、Program Files

(x86) ディレクトリーから製品をインストールする場合は、IBM Cognos

Configuration を管理者として開始します。

6. Cognos Configuration の「エクスプローラー」パネルで、「ローカル設定」>

「環境」ノードを展開し、「TM1 アプリケーション・サーバー」を右クリックしてから「開始」を選択します。

これにより、Cognos TM1 Web 用の付属の Web アプリケーション・サーバーが開始されます。

7. Web ブラウザーに Cognos TM1 Web の URL を入力することにより、Cognos

TM1 Web が実行されていることを確認します。例:

http://localhost:9510/tm1web/

リモート・コンピューターでは、localhost を、Cognos TM1 Web が実行されているコンピューターの名前または IP アドレスに置換します。

8. Cognos TM1 Web を設定して、ネットワーク上のリモート Cognos TM1 サーバーに接続します。

Cognos TM1 Web がネットワーク上の特定の Cognos TM1 管理サーバーまたは Cognos TM1 サーバーに接続するようにするには、 Cognos TM1 Web 設定ファイル tm1web_config.xml 内の AdminHostName および TM1ServerName パラメーターを設定します。

132ページの『AdminHostName パラメーターおよび TM1ServerName パラメーターを使用した Cognos TM1 Web ログイン・ページの設定』を参照してください。

9. Cognos TM1 Web のセキュリティー・オプションを設定します。

使用するシステムおよびネットワーク環境に応じて、統合ログオンや IBM

Cognos Security などの認証セキュリティー、および SSL などのデータ伝送セキュリティーを設定できます。

247ページの『第 18 章セキュリティー構成』を参照してください。

10. CognosTM1 Web 設定ファイルに追加のオプションを設定します。


11. Web ブラウザー設定の手順を確認します。

ユーザーのための言語や地域の設定など、Web ブラウザー・オプションを設定できます。

144ページの『Cognos TM1 Web の Web ブラウザー設定』を参照してください。

第 10 章 Cognos TM1 Web のインストール 119

Cognos TM1 Web の UNIX でのインストールおよび設定IBM Cognos TM1 Web を UNIX システムにインストールするには、 UNIX 上のJava 鍵ストアに証明書をインポートする必要があります。この手順は、付属のWebSphere® Liberty アプリケーション・サーバーを使用している場合に当てはまります。

始める前に

IBM Cognos Configuration を開始するには、その前に、JAVA_HOME 環境変数を設定する必要があります。 Cognos TM1 Web の Web アプリケーション・サーバーを開始するために、 Cognos Configuration が使用されます。


Cognos TM1 Web が使用可能な Cognos TM1 サーバーのリストを表示できるようにするには、 UNIX 上の Java 鍵ストアに証明書をインポートする必要があります。

手順1. インストール・プログラムを実行します。

a. インストール・ファイルをダウンロードして解凍した場所に移動するか、または製品ディスクを挿入します。

b. オペレーティング・システムのディレクトリーに移動して、次のように入力します。

./issetup

c. 「コンポーネントの選択」画面に進みます。

d. 「TM1 Web 層」コンポーネントとして、「TM1 Web」と「TM1 アプリケーション・サーバー」のみを選択します。

その他のすべてのコンポーネントの選択を解除します。

e. インストール・ウィザードのプロンプトに従って、インストールを完了します。

2. UNIX 上の Java 鍵ストアに証明書をインポートします。

a. JAVA_HOME に関連付けられた bin の場所にディレクトリーを変更します。

b. 次のコマンドを実行してください。

keytool -import -file “/bin64/ssl/applixca.pem” -keystore

“/usr/java7/jre/lib/security/cacerts” -storepass “changeit”

3. IBM Cognos Configuration を開始します。

install_location/bin64 ディレクトリーに移動して、以下のコマンドを入力します。

./cogconfig.sh

4. 以下のようにして、Cognos TM1 Web 用の Web アプリケーション・サーバーを開始します


Cognos Configuration の「エクスプローラー」パネルで、「ローカル設定」>「環境」ノードを展開し、「TM1 アプリケーション・サーバー」を右クリックしてから「開始」を選択します。

5. リモート・コンピューター上の Web ブラウザーに Cognos TM1 Web の URL

を入力することにより、 Cognos TM1 Web が実行されていることを確認します。例:

http://<unix_web_server>:9510/tm1web/

<unix_web_server> を、Cognos TM1 Web が実行されているコンピューターの名前または IP アドレスに置換します。

次のタスク

使用するシステムやネットワーク環境に応じて、以下に示す追加の設定手順を実行します。

v Cognos TM1 Web を設定して、ネットワーク上の特定の Cognos TM1 管理サーバーまたは Cognos TM1 サーバーに接続するようにします。


v Cognos TM1 Web のセキュリティー・オプションを設定します。

247ページの『第 18 章セキュリティー構成』を参照してください。

v CognosTM1 Web 設定ファイルに追加のオプションを設定します。


v Web ブラウザー設定の手順を確認します。

144ページの『Cognos TM1 Web の Web ブラウザー設定』を参照してください。

IBM WebSphere を使用する TM1 Web のインストールIBM WebSphere アプリケーション・サーバーに Cognos TM1 Web を配布できます。TM1 Web をインストールする際に、TM1 Applications Web もインストールされます。

TM1 Web と TM1 Applications Web を WebSphere アプリケーション・サーバーにインストールするには、以下のタスクを実行します。

v Cognos Configuration を使用して、アプリケーション・ファイルを作成します。163ページの『IBM WebSphere サーバー用のアプリケーション・ファイルの作成』を参照してください。tm1web.war ファイルが作成されます。デフォルトの場所は <インストール場所>¥ibm¥cognos¥TM1¥tm1web.war です。


v WebSphere アプリケーション・サーバーへ tm1web.war ファイルを配布します


v WebSphere へ TM1 SSL 証明書をインポートします

IBM WebSphere アプリケーション・サーバーへの TM1 Web の配置

IBM WebSphere 管理コンソールを使用して、WebSphere アプリケーション・サーバーに TM1 Web および TM1 Applications Web を配置して実行します。






コマンド・ウィンドウが開き、始動の進行状況が表示されます。始動プロセスが完了した後に、コマンド・ウィンドウに「Server started.」というメッセージが表示されます。このコマンド・ウィンドウを最小化することはできますが、閉じないでください。このウィンドウは、WebSphere が実行している間は開いたままにしておく必要があります。

v Cognos Configuration を使用して、アプリケーション・ファイルを作成します。163ページの『IBM WebSphere サーバー用のアプリケーション・ファイルの作成』を参照してください。















4. 「参照」をクリックし、Cognos Configuration で「アプリケーション・ファイルを構築」コマンドを使用して生成した tm1web.war ファイルを見つけて選択します。「開く」をクリックします。




8. コンテキスト・ルート・ボックスで、/tm1web と入力します。「次へ」をクリックします。


インストールが完了すると、WebSphere には「アプリケーション tm1web_war



11. 「アプリケーション」 > 「アプリケーション・タイプ」 > 「Websphere エンタープライズ・アプリケーション」をクリックします。

12. tm1web_war の横のチェック・ボックスを選択し、「開始」をクリックします。WebSphere に、「アプリケーション tm1web_war がサーバー server_name およびノード node で正常に始動されました。場合によっては、コレクションを最新表示して現行の状況を表示する必要があります。」と表示されます。

次のタスク

次のステップでは、TM1 証明書を鍵ストアにインポートします。

TM1 Web 用の SSL 証明書のインポートアプリケーション・ファイル tm1web.war を IBM WebSphere アプリケーション・サーバーに配置した後の次の手順は、鍵ストアへの TM1 SSL 証明書のインポートです。


TM1 Web の場合、すべてのルート証明書を、TM1 Web を実行しているコンピューターにある証明書ストアにインストールする必要があります。

手順1. IBM WebSphere 管理コンソールで、「セキュリティー」を展開して「SSL 証明書および鍵管理」をクリックします。


2. 「関連項目」の下の「鍵ストアと証明書」をクリックします。


4. 「追加プロパティー」の下で、「署名者証明書」をクリックします。

5. 「追加」をクリックします。

6. 次の情報を入力します。

v 「別名」フィールドに applixca.pem と入力します。

v 「ファイル名」フィールドに、TM1 の SSL 証明書の絶対パスとファイル名を入力します。例えば TM1_install_dir¥bin¥SSL¥applixca.pem などです。

注: 独自の SSL 証明書を使用する場合、ルート証明書のパスとファイル名を入力します。

v 「データ・タイプ」フィールドでは、デフォルト値を保持します。

7. 「適用」をクリックし、「OK」をクリックします。

8. Web ブラウザーに Cognos TM1 Web の URL を入力することにより、Cognos

TM1 Web が実行されていることを確認します。例:

http://host:port/tm1web/

リモート・コンピューターでは、host を、Cognos TM1 Web が実行されているコンピューターの名前または IP アドレスに置換します。port は、tm1web.war

を配置した仮想ホストのポート番号に置き換えてください。例:

http://server1:9080/tm1web。

次のタスク

次のステップでは、TM1 Web を構成します。『Cognos TM1 Web 構成パラメーターの変更』および 144ページの『Cognos TM1 Web の Web ブラウザー設定』を参照してください。

Cognos TM1 Web 構成パラメーターの変更tm1web_config.xml ファイルは、IBM Cognos TM1 Web の構成パラメーターが入っている XML ファイルです。

Cognos TM1 Web バージョン 10.2 より、以前のバージョンの Cognos TM1 Web

の web.configファイルに代わって新しい tm1web_config.xml ファイルが使用されます。

このファイルのパラメーターによって、次の IBM Cognos TM1 Web 機能が制御されます。

v ビュー・ノード

v Cube Viewer のページ・サイズ

v Cube Viewer からエクスポートするシートの数

v IBM Cognos TM1 Web のスタートアップと外観の設定


Cognos TM1 Web 構成パラメーターIBM Cognos TM1 Web の構成パラメーターは、tm1web_config.xml ファイルに保存されています。

tm1web_config.xml ファイルは、以下の場所にあります。

<TM1 のインストール場所>¥webapps¥tm1web¥WEB-INF¥configuration¥

次のパラメーターが使用可能です。

ActionButtonFullRecalculationEnabled

操作ボタンの実行の一部として行われる再計算のレベルを指定します。このパラメーターは、「計算」のタイプとして「シートを自動的に再計算」が選択されている操作ボタンにのみ適用されます。

true に設定すると、ターゲットのブックで完全な再計算が実行されます。

false に設定すると、ターゲットのブックで部分的な再計算が実行されます。ターゲットのブックの表示されている部分のみが再計算されます。この再計算には、表示されている領域のセルのアクティブ・フォーム、DBS/DBSW/DBR/DBRW/DBRA/DBSA 式、および依存関係が含まれます。ターゲットのブックのスクロールできる領域を超えた部分は再計算されません。デフォルト値 False は、特にワークブックが大きい場合にパフォーマンスを向上させることができます。

AdminHostName設定した場合、ユーザーはログオン時に管理ホストの値の入力を求められません。


AdminHostPort設定した場合、クライアントは管理ホストのデフォルト・ポートの代わりにこのポートの使用を試みます。

AdminHostSSLPort設定した場合、クライアントは管理 SSL ホストのデフォルト・ポートの代わりにこのポートの使用を試みます。

CamLoginApiRedirectEnabled

デフォルト値は false です。

有効にした場合、TM1 Web API (URL API かまたは JavaScript ライブラリー) からの CAM 認証では、Cognos Analytics の CAM ログオン・ページへのリダイレクトが行われます。この動作は、ダイアログ・ボックスにCognos Analytics の CAM ログオン・ページが表示されるというデフォルトの動作とは異なります。 Cognos Analytics に X-Frame-Options ヘッダーが含まれていて、その値が SAMEORIGIN または DENY (クリックジャッキング攻撃からの保護を強化するために使用される値) である場合は、このパラメーターを有効にする必要があります。

CleanDimensionMetaDataCache


CleanDimensionMetaDataCache パラメーターは、Web シートの計算時にディメンション要素を TM1 サーバーから取得するか、TM1 Web のキャッシュされた要素を使用して取得するかを指定します。

デフォルト値: false

v CleanDimensionMetaDataCache を false に設定すると、tm1web キャッシュの要素が使用されます。

v CleanDimensionMetaDataCache を true に設定すると、キャッシュからtm1web ディメンション要素が除去され、TM1 サーバーから直接要素が取得されます。

CrossDomainAccessList

TM1 Web へのアクセスを許可するクロスドメイン URL のリストを指定します。

IBM Cognos Workspace を実行しているドメインが TM1 Web とは別のドメインである場合に、このパラメーターを使用してそのドメインを指定します。

すべてのドメインに TM1 Web へのアクセスを許可するには、アスタリスク (*) を使用します。

複数の URL を指定する場合、コンマを使ってそれらを区切ります。

このパラメーターが設定されていない場合、またはパラメーター値が空の場合は、TM1 Web へのクロスドメイン・アクセスは許可されません。

CubeViewerColumnPageSizeCubeviewer の 1 ページ当たりに取り込む列数を指定します。

142ページの『Cube Viewer のページ・サイズの変更』を参照してください。

CubeViewerRowPageSizeCubeviewer の 1 ページ当たりに取り込む行数を指定します。

142ページの『Cube Viewer のページ・サイズの変更』を参照してください。

CubeviewerStringWrapCubeviewer での文字列セルの折り返しの設定。

142ページの『キューブ・ビューにおける文字列値の折り返し』を参照してください。

CustomCAMLogoutUrl

TM1 が CAM セキュリティー (モード 4 または 5) を使用するように構成されている場合に、CA SiteMinder の専用ログアウト・ページの URL を指定します。ログアウトの際には、SiteMinder セッション Cookie を無効にできるように、このログアウト・ページにアクセスする必要があります。

ユーザーが TM1 Web で「ログオフ」をクリックすると、最初に CAM ログアウトが実行されます。次に、SiteMinder ログアウト・ページが呼び出されます。

EvaluationServiceURL評価サービスのロケーションを指定します。有効な値は


hostname:port_number です。値を割り当てなければ、ロケーションはhttp://localhost:9510 であると見なされます。

ExternalUrl

TM1 Web の元の始動 URL を変更する外部ロード・バランサーで TM1®

Web および Cognos セキュリティー (CAM) 認証を使用する場合に、このExternalUrl パラメーターを設定します。 Cognos セキュリティーが正常にリダイレクトして TM1 Web に戻れるように、ExternalUrl パラメーターによって正しい URL を提供します。

TM1 Web を開始するために使用する URL と同じ URL を値に設定します。次に例を示します。

<add key="ExternalUrl" value="http://mycomputer/TM1Web" />

GzipCompressionEnabledWeb サーバーの応答を圧縮するかどうかを決定します。有効な値はtrue/false です。

HideCubeviewerToolBartrue に設定すると、すべての Cubeviewer ツールバーが非表示になります。

141ページの『HideCubeviewerToolBar パラメーター』を参照してください。

HideTabBartrue に設定すると、複数のタブが非表示になります。

140ページの『HideTabBar パラメーター』を参照してください。

HideWebsheetToolBartrue に設定すると、すべての Web シート・ツールバーが非表示になります。

141ページの『HideWebsheetToolBar パラメーター』を参照してください。

HomePageObject設定すると、タイプが Websheet、Cubeviewer、または URL であるオブジェクトが、ユーザーのログオン後に表示されます。

135ページの『全ユーザー向けのグローバル・ホーム・ページの設定』を参照してください。

LegacyUrlApiSessionDiscoveryEnabledLegacyUrlApiSessionDiscoveryEnabled 設定パラメーターを使用して、TM1

Web URL API がログオン・セッションを処理する方法を制御します。このパラメーターを設定して、固有のログオン・セッションを URL API で個々に追跡するかどうかを指定します。

このパラメーターを使用すると、指定された管理ホスト、TM1 サーバー、およびユーザー名 (オプション) に基づいて URL API セッションを再利用することができます。

セッション・トークン・ログオン方式を URL API と併用している場合は、tm1web_config.xml ファイル内の LegacyUrlApiSessionDiscoveryEnabled設定パラメーターを False に設定しなければなりません。セッション・トークンを使用したログオンについて詳しくは、TM1 Web API セッション・ログオンを参照してください。


https://www.ibm.com/support/knowledgecenter/SSD29G_2.0.0/com.ibm.swg.ba.cognos.tm1_dg_dvlpr.2.0.0.doc/c_tm1webjv_api_sessiontoken_login.html

https://www.ibm.com/support/knowledgecenter/SSD29G_2.0.0/com.ibm.swg.ba.cognos.tm1_dg_dvlpr.2.0.0.doc/c_tm1webjv_api_sessiontoken_login.html

次の形式を使用します。

<add key="LegacyUrlApiSessionDiscoveryEnabled" value=True or False/>

例:

<add key="LegacyUrlApiSessionDiscoveryEnabled" value="False"/>

デフォルト値は True です。

v True

TM1 Web は、指定された情報 (TM1 管理ホスト、TM1 サーバー、ユーザー名) に基づいて、新しいログオン要求と既存のログオン・セッションのマッチングを試行します。

TM1 管理ホスト、TM1 Server、ユーザー名の固有の組み合わせでシングル・ログオンを行う場合は、このパラメーターを必ず True に設定してください。

v False

TM1 Web URL API を使用して TM1 Web オブジェクトを開くたびにセッション・トークンを提供しなければならないということを指定します。提供しないと、ユーザーに対してプロンプトが出されます。

TM1 Web URL API で複数のログオン・セッションを使用する計画がある場合は、このパラメーターを False に設定してください。URL API および TM1 Web や TM1 Application Web などの他の TM1 Web クライアントで複数のログオン・セッションを使用する場合も、この設定を使用してください。この設定では、ユーザー・セッションを個々に区別するためにセッション・トークンが使用されます。

MaximumConcurrentExportsTM1 Web から同時実行できるエクスポートの最大数を指定します。デフォルト値は 5 です。

MaximumConcurrentExports を 0 に設定すると、同時エクスポート数を無制限にすることができます。この設定は、バージョン 10.3 より前の TM1

Web のエクスポート動作と類似しています。

同時エクスポートの最大数に達した場合に、さらに追加のエクスポートが開始されると、それら追加のエクスポートは、エクスポート・スロットが利用できるようになるまでキューに入れられます。キューに入れられたエクスポートを開始した者は、キューに入れられたことを示す通知を受け取りません。

最適なパラメーター設定は、RAM の容量とユーザーの要件に応じて異なります。一般的に、TM1 Web で利用できる RAM の容量が多いほど、設定できるパラメーターの値は高くなります。値を増やすとメモリーの消費量は増えますが、エクスポートのキューイングは減少します。 (パラメーターを 0

に設定すると、エクスポートのキューイングはなくなります。) 逆に、パラメーター値を減らすと、エクスポートによるメモリーの消費量は減りますが、エクスポートのキューイングの発生頻度は高くなります。

MaximumSheetsForExportエクスポートできるシートの最大数を指定します。


142ページの『Cube Viewer からエクスポートする最大シート数の設定』を参照してください。

MixedCellPaste

MixedCellPaste パラメーターを true に設定すると、Web シートのリーフと集約値の混合範囲に値をコピーした場合に、貼り付けられた値が厳密にマッチングするようになります。

注: このパラメーターは Web シートにのみ適用されます。CubeViewer には適用されません。デフォルト値は false です。

NavTreeCollapsedOnStartユーザーのログオン後にナビゲーション・パネルを省略表示するか展開表示するかどうかを決定します。

139ページの『NavTreeCollapsedOnStart パラメーター』を参照してください。

NavTreeDisplayServerViewナビゲーション・ツリー内にサーバー・ビュー・ノードを表示するかどうかを指定します。有効な値は Y と N です。

141ページの『ナビゲーション・ウィンドウの「ビュー」ノードの表示と非表示』を参照してください。

NavTreeHiddenユーザーのログオン後にナビゲーション・パネルを表示するかどうかを決定します。

139ページの『NavTreeHidden パラメーター』を参照してください。

RecalcOnActivate

RecalcOnActivate を true に設定した場合、TM1 Web で Web シートまたはキューブ・ビューがアクティブになるたびに (タブを切り替えたときなど)、再計算が行われます。有効な値は、true または false です。

RecalcOnDataValidationChange

データ検証リストの値を変更した場合に、デフォルトの再計算動作がオーバーライドされるかどうかを指定します。

true に設定した場合、データ検証リストの値が変更されると再計算がトリガーされます。

false に設定した場合、データ検証リストの値が変更されても再計算はトリガーされません。

RecalcOnPicklistChange

選択リストの値を変更した場合に、デフォルトの再計算動作がオーバーライドされるかどうかを指定します。

true に設定した場合、選択リストの値が変更されると再計算がトリガーされます。

false に設定した場合、選択リストの値が変更されても再計算はトリガーされません。


RelationalResultMaxRows-1 より大きい値を指定すると、リレーショナル・クエリー ResultSet から返される行数が指定した行数に制限されます。

TM1ServerName設定すると、ユーザーはログオン時に、接続する TM1 サーバーの選択を求められません。


UseBookRecalcSetting

UseBookRecalcSetting パラメーターは tm1web_config.xml ファイルに含まれています。 true に設定する場合、Web サーバーは、Excel シートが発行された際のモードを適用します。 Excel シートが手動の再計算モードで発行された場合、再計算が実行されるまで Web シート・データはクライアントに再送されません。

UseBookRecalcSetting パラメーターは、次の形式で tm1web_config.xml ファイルに記述します。

<add key="UseBookRecalcSetting" value="false" />

値は「false」または「true」です

UseBookRecalcSetting を true に設定すると、TM1 Web は Excel ワークシートに再計算の設定を適用します。

計算オプションを自動に設定すると、以下のようになります。

v UseBookRecalcSetting = "true" を設定した場合、SUBNM 関数を変更すると Web シートは自動的に再計算されます。

v UseBookRecalcSetting = "false" を設定した場合、SUBNM 関数を変更すると Web シートは自動的に再計算されます。

計算オプションを手動に設定すると、以下のようになります。

v UseBookRecalcSetting = "true" を設定すると、Web シートは自動的には再計算されません。再計算するには、再計算ボタンを手動でクリックする必要があります。

v UseBookRecalcSetting = "false" を設定した場合、SUBNM 関数を変更すると Web シートは自動的に再計算されます。

WebsheetBackgroundRecalculationMode

Web シートで実行されるバックグラウンド再計算のレベルを指定します。

WebSheetService.scrollWebSheet の呼び出しには、データをすぐに使用できないために数秒かかることがあります。 WebsheetBackgroundRecalculationMode

パラメーターを使用してバックグラウンドでブックを再計算し、要求時に必要なデータを入手できるようにします。

0 (デフォルト値) に設定すると、シートを最新表示する際にはバッファーに入れられた (可視の) 領域だけが計算されます。


1 に設定すると、バッファーに入れられた領域に加えて、バッファーに入れられた領域に隣接する領域が計算されます。これにより、ユーザーが最初の表示領域から少しスクロールした場合の待ち時間が短縮されます。

2 に設定すると、現行のワークシート全体が計算されます。これにより、ユーザーが現在のシートのどの領域にスクロールした場合でも、待ち時間が短縮されます。

3 に設定した場合、現在のブック全体が計算されます。これにより、ユーザーが現行のシートのいずれの領域または別のワークシートに移動する場合の待ち時間も短縮されます。

注: 設定する数値が大きいほど、より多くのセルが計算されるので、Web

サーバーの負荷が大きくなります。

X-Frame-Options

X-Frame-Options パラメーターは、X-Frame-Options 応答ヘッダーの値を設定します。このパラメーター (および応答ヘッダーの値) は、ブラウザーに<frame>、<iframe>、または <object> の TM1 Web ページのレンダリングを許可するかどうかを指定します。このパラメーターは、クリックジャッキング攻撃を防止し、TM1 Web のコンテンツが他のサイトに埋め込まれないようにするために使用します。指定可能なパラメーター値は 3 つあります。

v 0 は応答ヘッダー値 DENY に該当し、すべてのドメインで TM1 Web

コンテンツのフレーム内表示を禁止します。

v 1 は応答ヘッダー値 SAMEORIGIN に該当し、現在のドメインのみにTM1 Web コンテンツのフレーム内表示を許可します。

v 2 は応答ヘッダー値 ALLOW-FROM に該当します。この場合は、TM1

Web は tm1web_config.xml の CrossDomainAccessList パラメーターで、TM1 Web コンテンツにアクセスしてフレーム内に表示することを許可されたクロスドメイン URL のリストを確認します。

ALLOW-FROM 応答ヘッダーは、ユニバーサル・ブラウザーをサポートしていません。 TM1 Web は CrossDomainAccessList の値を使用して、ドメインが許可されているかどうかを判断します。許可されていない場合は、TM1 Web に応答ヘッダー値 DENY が含まれ、フレーム内に表示できなくなります。状況によっては、TM1 Web が要求元ドメインを判別できないことがあります。その場合は、応答ヘッダー値 SAMEORIGIN が含まれます。

X-Frame-Options パラメーターが欠落している、または空である場合、2 がデフォルト値です。

TM1 Web の .jsp ファイルには、DENY と SAMEORIGIN の値のための応答ヘッダー X-Frame-Optionsのみが含まれます。ドメインが許可されていることが確認された場合、X-Frame-Options ヘッダーは含まれません。

Cognos TM1 Web 設定ファイルの編集IBM Cognos TM1 Web 設定ファイルを編集して、さまざまなパラメーターを設定することができます。


Cognos TM1 Web 設定ファイルは XML ファイルであり、XML タイプのエディターによってのみ開くことができます。 Microsoft ワードパッドなどの通常のテキスト・エディターを使って開くと、ファイル破損の原因となり得る無効な文字が追加される可能性があります。

Cognos TM1 Web バージョン 10.2 より、以前のバージョンの Cognos TM1 Web

の web.configファイルに代わって新しい tm1web_config.xml ファイルが使用されます。

手順1. 以下の場所で tm1web_config.xml ファイルを見つけて開きます。

<TM1 のインストール場所>¥webapps¥tm1web¥WEB-INF¥configuration¥

注: tm1web_config.xml ファイルは xml ファイルであり、XML タイプのエディターでのみ開けます。 Microsoft ワードパッドなどの通常のテキスト・エディターを使って開くと、ファイル破損の原因となり得る無効な文字が追加される可能性があります。

2. パラメーターを編集して、変更を保存します。

3. IBM Cognos TM1 Web にログオンして、編集結果を確認します。

AdminHostName パラメーターおよび TM1ServerName パラメーターを使用した Cognos TM1 Web ログイン・ページの設定

パラメーターの AdminHostName と TM1ServerName は、IBM Cognos TM1 Web のログオン・ページで TM1 管理ホストと TM1 サーバーに対応する値を入力するようにユーザーに求めるかどうかを制御します。

このいずれかのパラメーターの値を tm1web_config.xml ファイルで設定すると、その指定値がログオン・プロセスで使用され、ユーザーにその情報の入力を求めることはありません。

AdminHostName パラメーター

このパラメーターは、TM1 管理サーバーが実行されている管理ホストの名前を指定します。AdminHostName パラメーターは、tm1web_config.xml ファイルで次の形式に従って編集します。

<add key="AdminHostName" value="HostName"/>

ここで、HostName には、次のいずれかの値を指定できます。

v HostName が空白 (デフォルト値) の場合は、ログオン・ページに「管理ホスト」プロンプトが表示されます。

v HostName が、有効な TM1 管理ホストの名前に設定されている場合、IBM

Cognos TM1 Web のログオン・プロセスではその管理ホストが使用され、ユーザー入力のプロンプトは表示されません。

TM1ServerName パラメーター

このパラメーターは、TM1 サーバーの名前を設定します。TM1ServerName パラメーターは、tm1web_config.xml ファイルで次の形式に従って編集します。


<add key="TM1ServerName" value="ServerName"/>

ここで、ServerName には、次のいずれかの値を指定できます。

v ServerName が空白 (デフォルト値) の場合は、IBM Cognos TM1 Web のログオン・ページに「TM1 サーバー」プロンプトが表示されます。

v ServerName に有効な TM1 サーバー名が設定されている場合は、ログオン・ページには管理ホストと TM1 サーバーのどちらのプロンプトも表示されません。

v AdminSvrSSLCertID パラメーターの設定が正しくない場合は、空白のサーバー名プルダウン・メニューが表示され、Cognos TM1 Web のログ・ファイルにエラーが記録されます。詳細については、「TM1 Operation」の『SSL を使用してセキュア・モードで TM1 を実行』を参照してください。

ユーザーが入力した「ユーザー名」と「パスワード」が有効な場合、IBM Cognos

TM1 Web は、tm1web_config.xml ファイルの TM1ServerName パラメーターで指定された TM1 サーバーにログオンします。

例えば、TM1ServerName パラメーターを planning sample に設定する場合は、次のコードのようになります。

<add key="TM1ServerName" value="planning sample" />

IBM Cognos TM1 Web のカスタム・ホーム・ページの設定ユーザーが IBM Cognos TM1 Web に正しくログオンしたときに Web シート、キューブ・ビュー、または URL を表示するように、IBM Cognos TM1 Web のカスタム・ホーム・ページを設定することができます。このホーム・ページは、ユーザーが TM1 データにアクセスして作業するための出発点にすることができます。

ホーム・ページは、IBM Cognos TM1 Web のすべてのユーザーに対してグローバルに設定することも、さまざまなユーザーやユーザー・セットに個別に割り当てることもできます。例えば、HTML ファイルまたはその他のタイプの Web ページを表示するようにホーム・ページ・オプションを設定すると、Web ページに表示可能なあらゆる内容 (手順、タスク、リンクなど) をユーザーに提示することができます。

設定したホーム・ページは IBM Cognos TM1 Web の最初のタブに表示され、ユーザーが閉じることはできません。「ホーム」リンクが設定されていると、そのリンクが IBM Cognos TM1 Web のヘッダー領域に表示されるので、ユーザーはホーム・ページに簡単に戻ることができます。

IBM Cognos TM1 Web ホーム・ページは、次の 2 つのいずれかの方法で設定できます。

それぞれの IBM Cognos TM1 Web ユーザーごとに異なるホーム・ページTM1 Architect およびサーバー・エクスプローラーの「クライアント設定」ダイアログを使用して、IBM Cognos TM1 Web のさまざまなクライアント(ユーザー) 向けにスタートアップ・ホーム・ページを設定します。

すべての IBM Cognos TM1 Web ユーザーに対してグローバルなホーム・ページtm1web_config.xml ファイルの HomePageObject パラメーターを使用して、すべての IBM Cognos TM1 Web ユーザーにグローバルに適用するホーム・ページを設定します。


注: tm1web_config.xml ファイルの HomePageObject パラメーターをAllowOverwrite=true に設定した場合は、tm1web_config.xml ファイルのグローバル設定よりも「クライアント設定」ダイアログで行うホーム・ページ割り当てが優先されます。

個々のユーザー向けの異なるホーム・ページの設定Architect とサーバー・エクスプローラーの「クライアント設定」ダイアログ・ボックスでは、さまざまな IBM Cognos TM1 Web クライアント (ユーザー) 向けにスタートアップ・ホーム・ページを設定します。

例えば、あるホーム・ページは営業部門の IBM Cognos TM1 Web ユーザーに割り当て、別のホーム・ページは経理部門のユーザーに割り当てることができます。

注: 「クライアント設定」ダイアログ・ボックスを使用すると、特定のユーザーにホーム・ページを割り当てることができます。その場合、tm1web_config.xml ファイルの「HomePageObject」パラメーターに対するグローバル・ホーム・ページの設定は無視されます。

手順1. Architect またはサーバー・エクスプローラーで、サーバーを右クリックし、「セキュリティー」→「クライアント/グループ」を選択します。

「クライアント/グループ」ダイアログ・ボックスが開きます。

2. 「設定」をクリックします。

「クライアント設定」ダイアログ・ボックスが開きます。

3. ホーム・ページ設定を適用するクライアントを「現在のクライアント」のリストから選択します。

4. 次の手順で、ホーム・ページの Web シート、キューブ・ビュー、または URL

を入力します。

v URL を表示するには、プロトコルの http:// を含む URL アドレスを「ホーム・ページ」ボックスに入力します。 Web サイトまたは個々のファイルのいずれかの URL を入力できます。

v ホーム・ページとして Web シートまたはキューブ・ビューを選択するには、「参照」をクリックします。「IBM Cognos TM1 Web ホーム・ページを選択」ダイアログ・ボックスが開き、Web シートまたはキューブ・ビューへの参照を「アプリケーション」ツリーから選択できます。

Web シートまたはキューブ・ビューの参照を選択したら、「OK」をクリックして、「クライアント設定」ダイアログ・ボックスに戻ります。

5. ナビゲーション・ウィンドウの外観を制御する設定を選択します。

注: ここで設定するナビゲーション・ウィンドウの設定は、tm1web_config.xml

ファイル内で対応するパラメーターが AllowOverwrite=true に設定されている場合にのみ適用されます。詳しくは、 139ページの『IBM Cognos TM1 Web のスタートアップと外観の設定』を参照してください。

ナビゲーション・ウィンドウの外観は、次の設定値で制御できます。


v ナビゲーション・ウィンドウを含める - 選択したクライアントが IBM

Cognos TM1 Web にログオンした時点で、ナビゲーション・ウィンドウを表示するかまたは非表示にするかどうかを指定します。

v ログオン時にウィンドウを開く - 選択したクライアントが IBM Cognos TM1

Web にログオンした時点で、ナビゲーション・ウィンドウを展開モードで表示するように設定します。

v ログオン時にウィンドウを閉じる - 選択したクライアントが IBM Cognos

TM1 Web にログオンした時点で、ナビゲーション・ウィンドウを最小モードで表示するように設定します。

v クライアントのナビゲーション・ウィンドウ設定を保存 - クライアントがIBM Cognos TM1 Web からログアウトする時点で、ナビゲーション・ウィンドウの個人用設定を保存するかどうかを指定します。

6. 「適用対象」のリストからいずれかのオプションを選択して、このホーム・ページをどのクライアント (複数の場合もあり) に対して表示するか設定します。

v 現在のクライアント -「現在のクライアント」の一覧で選択したクライアントのみに対してホーム・ページの設定を適用します。

v 選択したクライアント -「選択」ボタンが使用可能になるので、サブセット・エディターを開いて、同じホーム・ページ設定を使用するクライアントの集合を選択できます。

v すべてのクライアント - 同じホーム・ページ設定をすべての TM1 クライアントに適用します。

「選択したクライアント」を選択してから「選択」をクリックすると、サブセット・エディターが開きます。そこから、このホーム・ページを使用可能な TM1

クライアントのサブセットを選択できます。

サブセット・エディターを使用してクライアントのサブセットを選択してから「OK」をクリックすると、「クライアント設定」ダイアログ・ボックスに戻ります。「クライアント設定」ダイアログ・ボックスには、サブセット・エディターで選択したクライアントの合計数が表示されます。

7. 「設定を適用」をクリックして、「適用対象」のリストで選択したクライアントのホーム・ページを設定します。

8. 手順 4、5、6、7 を繰り返して、別の TM1 クライアントの集合向けにホーム・ページを設定します。

9. 「OK」をクリックして、「クライアント設定」ダイアログ・ボックスを閉じます。

これで、IBM Cognos TM1 Web のホーム・ページが設定されました。選択したIBM Cognos TM1 Web クライアントが次回 IBM Cognos TM1 Web に正しくログオンした時点で、割り当てられたホーム・ページが表示されます。

全ユーザー向けのグローバル・ホーム・ページの設定tm1web_config.xml ファイルの HomePageObject パラメーターを使用すると、すべての IBM Cognos TM1 Web ユーザーに対して表示するグローバル・ホーム・ページを有効にすることができます。


注: 「クライアント設定」ダイアログを使用して個々の Cognos TM1 ユーザーに異なるホーム・ページを割り当てることで、グローバルな HomePageObject パラメーターを無効にすることができます。詳しくは、 134ページの『個々のユーザー向けの異なるホーム・ページの設定』を参照してください。

HomePageObject パラメーターは、次の 3 種類のオブジェクトで有効です。

v CubeViewer

v Web シート

v URL

ホーム・ページ・オブジェクトは、ユーザーが IBM Cognos TM1 Web に正しくログオンしたときに表示されます。

HomePageObject パラメーターの使用:

HomePageObject パラメーターの使用方法。

HomePageObject パラメーターの書式は次のとおりです。

<add key="HomePageObject" value="ObjectPath ;Type= ObjectType ;Description=

ObjectTitle ; AllowOverwrite =true" />

ここで、

v ObjectPath は、開く Web シート、キューブ・ビュー、または URL オブジェクトのパスです。パスの具体的な書式は、オブジェクトのタイプに応じて異なります。

v ObjectType は、開くオブジェクトのキーワード (websheet、cubeviewer、またはURL) です。

v ObjectTitle はオブジェクトに割り当てる簡単なタイトルであり、Web ブラウザーのタイトル・バーと IBM Cognos TM1 Web のホーム・ページ・タブに表示されます。

v AllowOverwrite には次のように true または false の値を設定できます。

AllowOverwrite=true に設定した場合は、Architect およびサーバー・エクスプローラーの「クライアント設定」ダイアログを使用して個々のクライアントに別のホーム・ページを設定することで、HomePageObject パラメーターを無効にすることができます。

AllowOverwrite=false に設定した場合は、HomePageObject パラメーターがすべてのTM1 ユーザーにグローバルに適用され、Architect およびサーバー・エクスプローラーの「クライアント設定」ダイアログで個別に設定することはできません。

ここからのセクションでは、Web シート、キューブ・ビュー、および URL に対して HomePageObject パラメーターを使用する方法について説明します。

キューブ・ビューをグローバルな IBM Cognos TM1 Web ホーム・ページに設定:

キューブ・ビューを IBM Cognos TM1 Web のホーム・ページとして設定するには、次の書式を使用します。

value=CubeName$$ViewName$$Status


ここで、以下の引数が $$ 文字で区切られています。

v CubeName は、ビューが属するキューブの名前です。

v ViewName は、表示するキューブ・ビューの名前です。

v Status は、キューブ・ビューの共用または個人用ステータスです。

注：開く特定のキューブ・ビューを正しく指定するには、“PUBLIC”または“PRIVATE”のいずれかの値を指定する必要があります。

例えば、“SalesCube”の“Price”という共有ビューを開く場合は、次のように指定します。

&ltadd key="HomePageObject" value="SalesCube$$Price$$Public;Type=cubeviewer;Description=MyStartCube;AllowOverwrite=true"/>

Web シートをグローバルな IBM Cognos TM1 Web ホーム・ページに設定:

Web シートを IBM Cognos TM1 Web ホーム・ページとして割り当てることができますが、その方法は Excel ファイルが TM1 にどのように追加されたかによって異なります。

TM1 の外部にある Excel ファイルを参照する Web シートを開く:

Excel ファイルを参照する Web シートを開くことができます。

手順

次の書式を使用します。

value="WebsheetPath

ここで、WebsheetPath は Excel ファイルの場所と名前です。これには、ローカル・ファイルのパス、またはネットワーク上に置かれているファイルの UNC パスを指定できます。例えば、Web シートの UNC ネットワーク・パスは次のように設定します。

value=//MySystem/Samples/classic_slice.xls

タスクの結果

HomePageObject パラメーター全体は、次のようになります。

<add key="HomePageObject" value="//MySystem/Samples/classic_slice.xls;Type=websheet;

Description=MyWebsheet;AllowOverwrite=true"/>

TM1 サーバーにアップロードされている Web シート・オブジェクトを開く:

アップロードされた Web シート・オブジェクトを開くことができます。

手順

1. サーバー・エクスプローラーの「プロパティー」ウィンドウを使用して、アップロードされた Excel ファイルの TM1 割り当て名を検索します。


2. 次の書式で、値パラメーターを設定します。

value="TM1://ServerName/blob/PUBLIC/.\}Externals\TM1_Filename

各部の説明:

v ServerName は、Excel ファイルが配置されている TM1 サーバーの名前です。

v TM1_location は、アップロード済みの Excel ファイルに TM1 が割り当てた名前です。

例:

value="TM1://sdata/blob/PUBLIC/.\}Externals\Report_2006.xls_20070123212746.xls

HomePageObject パラメーター行全体は、次のようになります。

<add key="HomePageObject" value="TM1://sdata/blob/PUBLIC/.\}Externals\Report_2006.xls_20070123212746.xls;Type=websheet;Description=MyUploaded Websheet;AllowOverwrite=true" />

URL をグローバルな IBM Cognos TM1 Web ホーム・ページに設定:

HomePageObject パラメーターに URL を設定することができます。

次の形式を使用します。

value="URL_Path

ここで、URL_Path は、Web サイトまたは個々の Web ページ・ファイルを指すように指定できます。

例:

v ファイルを指す URL をホーム・ページに設定するには、

<addkey="HomePageObject" value="homepage.html;Type=URL;

Description=MyStart Page;AllowOverwrite=true"/>

v Web サイトを指す URL をホーム・ページに設定するには、

<addkey="HomePageObject" value="http://www.ibm.com;Type=URL;

図 6. サーバー・エクスプローラーでのアップロードされた Excel ファイルの割り当て名の例


Description=IBM;AllowOverwrite=true"/>

IBM Cognos TM1 Web のスタートアップと外観の設定ユーザーが IBM Cognos TM1 Web にログオンしたときの、ナビゲーション・ウィンドウ、タブ・バー、Web シート・ツールバー、および Cube Viewer ツールバーの外観を制御できます。

これらのパラメーターは tm1web_config.xml ファイルにあり、IBM Cognos TM1

Web のすべてのユーザーにグローバルに適用されます。

注: HomePageObject パラメーターを使用してカスタム・ホーム・ページを設定する方法の詳細については、 133ページの『IBM Cognos TM1 Web のカスタム・ホーム・ページの設定』を参照してください。

NavTreeHidden パラメーターNavTreeHidden パラメーターは、ユーザーが IBM Cognos TM1 Web にログオンした時点でナビゲーション・ウィンドウを表示するかどうかを決定します。

これが役立つのは、カスタム・ホーム・ページをユーザーに表示し、ナビゲーション・ウィンドウをまったく表示しないような場合です。

NavTreeHidden パラメーターは、次の形式で tm1web_config.xml ファイルに記述します。

<add key="NavTreeHidden" value="false;AllowOverwrite=true"/>

ここで、

value は true または false のいずれかです。

v false に設定すると、ユーザーが IBM Cognos TM1 Web にログオンした時点でナビゲーション・ウィンドウが表示されます。

v true に設定すると、ユーザーが IBM Cognos TM1 Web にログオンした時点でナビゲーション・ウィンドウは表示されません。

AllowOverwrite には次のように true または false を設定できます。

v AllowOverwrite=true に設定すると、NavTreeHidden パラメーターがすべてのユーザーに対してグローバルに割り当てられますが、Architect およびサーバー・エクスプローラーの「クライアント設定」ダイアログを使用すると、個々のクライアントに対して、そのダイアログでの設定を優先させることができます。

v AllowOverwrite=false を設定すると、NavTreeHidden パラメーターがすべてのTM1 ユーザーに対してグローバルに適用され、Architect およびサーバー・エクスプローラーの「クライアント設定」ダイアログを使用して設定をクライアントごとに個別に指定変更することはできません。

NavTreeCollapsedOnStart パラメーターNavTreeCollapsedOnStart パラメーターは、ユーザーがログオンした時点でナビゲーション・ウィンドウを最小化するか、展開表示するかを指定します。縮小表示の場合、ユーザーがウィンドウを復元する手段となる小さい縦線が表示されます。


NavTreeCollapsedOnStart パラメーターは、次の形式で tm1web_config.xml ファイルに記述します。

<add key="NavTreeCollapsedOnStart" value="false;AllowOverwrite=true"/>

ここで、


v value を false に設定すると、ユーザーが IBM Cognos TM1 Web にログオンした時点で、ナビゲーション・ウィンドウは展開され、デフォルト・モードで表示されます。

v value を true に設定すると、ユーザーが IBM Cognos TM1 Web にログオンした時点で、ナビゲーション・ウィンドウは折りたたまれた状態で表示されます。

AllowOverwrite には次のように true または false を設定できます。

v AllowOverwrite=true を設定すると、NavTreeCollapsedOnStart パラメーターがすべてのユーザーに対してグローバルに割り当てられますが、TM1 Architect およびサーバー・エクスプローラーの「クライアント設定」ダイアログを使用すると、設定をクライアントごとに個別に指定変更できます。

v AllowOverwrite=false を設定すると、NavTreeCollapsedOnStart パラメーターがすべての TM1 ユーザーに対してグローバルに適用され、TM1 Architect およびサーバー・エクスプローラーの「クライアント設定」ダイアログを使用して設定をクライアントごとに個別に指定変更することはできません。

HideTabBar パラメーターHideTabBar パラメーターは、ユーザーが複数の IBM Cognos TM1 Web オブジェクトを開く場合に IBM Cognos TM1 Web が複数のタブを表示できるようにするか、1 つのビューのみを表示するかを指定します。

これが役立つのは、ユーザーに対して表示可能なビューを一度に 1 つに制限するような場合です。

HideTabBar パラメーターは、次の形式で tm1web_config.xml ファイルに記述します。

<add key="HideTabBar" value="false;AllowOverwrite=true"/>

value は、true または false のいずれかです。

v value を false に設定すると、複数のタブを表示できます。これは、IBM Cognos

TM1 Web のデフォルトの動作です。

v value を true に設定すると、複数のタブは表示されません。一度に開くことができるのは 1 つのオブジェクトのみです。

図 7. HideTabBar パラメーターの例


AllowOverwrite オプションは、このパラメーターには現在使用されません。

HideWebsheetToolBar パラメーターHideWebsheetToolBar パラメーターは、ユーザーが Web シートを開いた際に Web

シート・ツールバーを表示するかどうかを指定します。

HideWebsheetToolBar パラメーターは、次の形式で tm1web_config.xml ファイルに記述します。

<add key="HideWebsheetToolBar" value="false;AllowOverwrite=true"/>


v value を false に設定すると、Web シート・ツールバーが IBM Cognos TM1

Web に表示されます。

v value を true に設定すると、Web シート・ツールバーは IBM Cognos TM1 Web

に表示されません。


HideCubeviewerToolBar パラメーターHideCubeviewerToolBar パラメーターは、ユーザーがキューブ・ビューを開いたときに Cubeviewer ツールバーを表示するかどうかを指定します。

HideCubeviewerToolBar パラメーターは、tm1web_config.xml ファイルで次の書式を使用します。

<add key="HideCubeviewerToolBar" value="false;AllowOverwrite=true"/>

value は、true または false のいずれかです。

v value を false に設定すると、Web シート・ツールバーが IBM Cognos TM1

Web に表示されます。

v value を true に設定すると、Web シート・ツールバーは IBM Cognos TM1 Web

に表示されません。


ナビゲーション・ウィンドウの「ビュー」ノードの表示と非表示ナビゲーション・ウィンドウの「ビュー」ノードを表示または非表示にすることができます。

手順1. IBM Cognos TM1 Web 仮想ディレクトリーにある tm1web_config.xml を編集します。

2. 「サーバー・ビュー」ノードの表示を制御する NavTreeDisplayServerView を探します。デフォルト値の Y の場合、ナビゲーション・ウィンドウに「ビュー」ノードが表示されます。



<add key="NavTreeDisplayServerView" value="Y" />

3. 「ビュー」ノードを非表示にするには、NavTreeDisplayServerView の値を N に変更します。

4. tm1web_config.xml を保存します。

5. IBM Cognos TM1 Web にログオンします。

これにより、ナビゲーション・ウィンドウで「ビュー」ノードが非表示になります。

Cube Viewer のページ・サイズの変更IBM Cognos TM1 Web の Cube Viewer に表示される行数および列数は変更できます。

デフォルトでは、Web Cube Viewer は、20 列 100 行のページに TM1 データを表示します (100 行の中にはディメンション・リストも含まれます)。

手順1. tm1web_config.xml を編集します。

2. 次のコードを見つけます。

CubeViewerRowPageSize

CubeViewerColumnPageSize

3. 行および列、またはそのいずれかのページ・サイズの値を変更します。



例えば、行のページ・サイズを 10 に設定すると、データ行が 9 行とディメンションの行が Cube Viewer に表示されます。

Cube Viewer からエクスポートする最大シート数の設定Cube Viewer からプリンターにエクスポート可能なシート数の最大値は、デフォルトでは 100 です。より多くのシートをエクスポートするように、IBM Cognos TM1

Web を設定することができます。

手順1. tm1web_config.xml を編集します。

2. 次のコードを見つけます。

MaximumSheetsForExport

3. エクスポートするシート数の最大値を変更します。



キューブ・ビューにおける文字列値の折り返しWeb キューブ・ビューで文字列要素セルを表示する際に使用するパラメーターを設定するには、CubeviewerStringWrap を使用します。


ビューの表示と折り返しの方法を制御するには、CubeviewerStringWrap パラメーターを使用して値を設定し、Web 設定ファイルに保存します。表示されていないセルも、折り返し領域をクリックすると、スクロール可能域で編集が可能です。

Enabledこのビューの文字列セルの折り返しをオンまたはオフにします。「False」に設定すると、列幅は、現在のビューのすべての行における最大文字列長と同じ幅になります。デフォルトの「True」に設定すると、これらのデフォルト・パラメーターを使用する折り返しが有効になります。

MinCharactersToWrap折り返すために必要な最小文字数を設定します。例えば、セルで、50 文字に満たない文字列値は折り返さないなどと設定します。デフォルトでは、50

に設定されます。

MaxDisplayCharacters文字列セルで表示する最大文字数を設定します。セルにはこの文字数を超える文字を含めることができますが、それらの文字が表示されるのは、セルをダブルクリックした場合だけです。 MinCharactersToWrap が 50 でMaxDisplayCharacters が 200 の場合には、200 文字以上が含まれる文字列セルは、約 4 行が必要となります。デフォルトでは、200 に設定されます。

WidthOfWrapCell表示画面の折り返し部分の文字数を設定します。デフォルトでは、240 に設定されます。

tm1web_config.xml ファイルで以下の形式を使用します (以下のリストでは、分かりやすくするために改行されていますが、実際には改行しないでください)。

<add key="CubeviewerStringWrap" value="Enabled=true;MinCharactersToWrap=50;MaxDisplayCharacters=200;WidthOfWrapCell=240" />

要確認: CubeviewerStringWrap は Web シートには適用されません。

TM1 Web セッションのタイムアウトの設定TM1 Web セッションのタイムアウトのデフォルトは 20 分です。この設定は、使用環境の要件に応じて変更できます。


TM1 Web セッションのタイムアウトは、web.xml の <session-timeout> 設定で指定します。

<session-config><session-timeout>20</session-timeout></session-config>

web.xml ファイルは、<installation_directory>¥webapps¥tm1web¥WEB-INF ディレクトリーにあります。例えば、C:¥Program

Files¥IBM¥cognos¥tm1_64¥webapps¥tm1web¥WEB-INF です。

TM1 Web を IBM Planning Analytics Workspace に配布する場合は、セッション・タイムアウトを 60 分にすることをお勧めします。セッション・タイムアウトを大


きくすると、システムのメモリー使用率が高くなる可能性があります。

手順1. web.xml をテキスト・エディターで開きます。

2. <session-timeout> の値を変更します。

3. web.xml を保存して閉じます。

4. IBM TM1 アプリケーション・サーバー・サービスを再始動します。

Cognos TM1 Web の Web ブラウザー設定このセクションでは、初期インストールが完了した後にご使用の環境で必要になる可能性がある IBM Cognos TM1 Web の Web ブラウザー設定の手順を説明します。

ユーザーは、自分のコンピューターで実行している、サポートされているいずれかの Web ブラウザーを使って Cognos TM1 Web に接続します。追加設定が必要になる場合もあります。

Cognos TM1 Web の Web ブラウザー言語の設定IBM Cognos TM1 Web インターフェースで使用される言語は、Web ブラウザーの言語設定によって決まります。


1 次言語で IBM Cognos TM1 Web を表示するように Microsoft Internet Explorer

および Mozilla Firefox を設定するには、以下の一般的な手順に従います。詳しくは、ご使用の Web ブラウザーの資料を参照してください。

手順1. 使用する Web ブラウザーに応じて、使用可能な言語オプションで 1 次言語を選択および設定します。

v Internet Explorer の場合、言語オプションは通常、「ツール」メニュー>「インターネットオプション」>「全般」>「言語」の下にあります。

v Firefox の場合、言語オプションは通常、「ツール」メニュー>「オプション」>「コンテンツ」>「言語」の下にあります。

2. 使用する言語を言語リストに追加します。

3. 優先する言語がリストの上部になるようにリストを編成します。

地域の設定に基づいた Cognos TM1 Web での数字の表示と入力IBM Cognos TM1 Web クライアントを、オペレーティング・システムの言語以外の言語で実行する場合は、Web ブラウザーの言語と Microsoft Windows の地域設定が同じ値になっていることを確認する必要があります。

それにより、特定の地域設定に基づいて、Cognos TM1 Web に数字を表示し入力することができます。


例えば、英語版の OS の場合に Cognos TM1 Web をフランス語で実行するときは、ブラウザー言語をフランス語に設定し、コンピューターの地域設定言語もフランス語に設定する必要があります。

Windows の地域と言語の設定

Windows の地域設定は、Windows の「コントロールパネル」で「地域と言語のオプション」機能を開いてアクセスします。

Web ブラウザーの言語設定

Web ブラウザーの言語設定は、セクション 98ページの『Cognos TM1 Web のWeb ブラウザー言語の設定』の説明に従ってアクセスしてください。

Cognos TM1 Web に対する Internet Explorer の設定IBM Cognos TM1 Web を Microsoft Internet Explorer とともに使用している場合、以下のセキュリティー設定を有効にして、Cognos TM1 Web ダイアログ・ウィンドウが正しく表示されるようにしてください。

次のようにセキュリティー設定を変更します。

v Web サイトがアドレス・バーやステータス・バーのないウィンドウを開くことを許可します。

v サイズや位置の制約なしにスクリプトでウィンドウを開くことを許可します。

Internet Explorer が正しく設定されていない場合は、一部の Cognos TM1 Web ダイアログで表示が切り捨てられることがあります。

Cognos TM1 Web の WAN サーバーでの実行と Excel ファイルおよび PDF ファイルのエクスポート

IBM Cognos TM1 Web を WAN (広域ネットワーク) サーバー上で実行し、ユーザーが Microsoft Excel ファイルと PDF ファイルを Cognos TM1 Web からエクスポートできるようにするには、Microsoft Internet Explorer で特定のセキュリティー設定を行う必要があります。

WAN サーバーは、インターネット・ゾーンにあるため、Internet Explorer で適用するセキュリティー・プロファイルは、ローカルのイントラネット・ゾーン内にあるサーバーの場合とは異なります。 WAN 環境で Cognos TM1 Web からファイルを正しくエクスポートするには、Internet Explorer のセキュリティー設定で、Cognos

TM1 Web サーバーを信頼済みサイトとして追加する必要があります。

Internet Explorer で Cognos TM1 Web を信頼済みサイトとして追加するMicrosoft Internet Explorer を使用し、IBM Cognos TM1 Web を WAN サーバーで実行する場合は、Cognos TM1 Web サーバーを信頼済みサイトとして追加してから、信頼済みサイトのセキュリティー設定をカスタマイズする必要があります。


手順1. Microsoft Internet Explorer を開きます。

2. 「ツール」>「インターネットオプション」をクリックします。

「インターネットオプション」ダイアログが開きます。

3. 「セキュリティ」タブをクリックします。

4. 「信頼済みサイト」をクリックしてから、「サイト」ボタンをクリックします。

5. Cognos TM1 Web サーバーの URL を「次の Web サイトをゾーンに追加する」ボックスに入力します。


7. 「信頼済みサイト」ダイアログ・ボックスを閉じます。

8. 「インターネットオプション」ダイアログの「セキュリティ」タブで、「信頼済みサイト」をクリックしてから、「レベルのカスタマイズ」ボタンをクリックします。

「セキュリティ設定 - 信頼されたゾーン」ダイアログが開きます。

9. 「ダウンロード」の設定を探して、「ファイルのダウンロード時に自動的にダイアログを表示」オプションの「有効にする」をクリックします。



第 11 章 Cognos TM1 アプリケーション・サーバーのインストール

ネットワーク環境のユーザーがプログラムにアクセスできるように、IBM Cognos

TM1 の Web アプリケーション・サーバー・コンポーネントを個別の専用コンピューターにインストールすることができます。このコンポーネントとしては、Cognos

TM1 アプリケーション・サーバーや Cognos TM1 アプリケーション・ゲートウェイがあります。

Cognos TM1 アプリケーション・サーバーは、Java ベースの Web アプリケーション・サーバー上に配布する必要があります。Cognos TM1 アプリケーション・サーバーをインストールする際にはまず、以下のうちどの Web アプリケーション・サーバーを使用するかを決定します。

v 付属の WebSphere Liberty Profile アプリケーション・サーバー

v ユーザーが独自にインストールした Apache Tomcat

v IBM WebSphere アプリケーション・サーバーの独自のインストール

Cognos TM1 アプリケーション・サーバーのアーキテクチャーと配布について詳しくは、以下を参照してください。

v 32ページの『Cognos TM1 Applications のアーキテクチャー』

v 40ページの『Cognos TM1 Applications の配布』

付属バージョンの WebSphere Liberty Profile サーバーでの配布

Cognos TM1 アプリケーション・サーバーをインストールして配布する最も早くて簡単な方法は、IBM Cognos TM1 インストール・プログラムで一緒にインストールされるバージョンの WebSphere Liberty Profile サーバーを使用することです。この方法では、Cognos Configuration を使用して Cognos TM1 アプリケーション・サーバーを開始および停止します。

詳しくは、 148ページの『付属の WebSphere Liberty Profile を使用する場合のCognos TM1 アプリケーション・サーバーのインストール』を参照してください。

独自の Web アプリケーション・サーバーへの展開

Cognos TM1 アプリケーション・サーバーを Java ベースの Web アプリケーション・サーバーの独自のインスタンスで配布するには、 IBM Cognos Configuration を使用して pmpsvc.war Web アプリケーション・アーカイブ・ファイルを作成してから、そのファイルを手動で配布します。

詳しくは、以下のトピックを参照してください。

v 159ページの『Apache Tomcat Web アプリケーション・サーバーの独自インストールとの Cognos TM1 アプリケーション・サーバーのインストール』

v 163ページの『独自の IBM Websphere インストール済み環境を使用する場合のCognos TM1 アプリケーション・サーバーのインストール』


x64 Windows での Cognos TM1 アプリケーション・サーバー

x64 Microsoft Windows システムの WebSphere Liberty Profile サーバーで Cognos

TM1 アプリケーション・サーバーを実行する場合は、同じバージョン (32 ビットまたは 64 ビット) の Java Runtime Environment (JRE) と WebSphere Liberty

Profile Web サーバーを使用してください。プラットフォームのバージョンを混在させないでください。例えば、64 ビット・バージョンの JRE を使用する場合は、64

ビット・バージョンの WebSphere Liberty Profile を使用する必要があります。

Cognos TM1 アプリケーション・サーバーと Cognos Analytics および Cognos Connection ポータルの統合

TM1 インストール済み環境で認証に Cognos セキュリティーを使用している場合、Cognos Analytics ユーザーは、 TM1 Applications Web ポータルの代わりに Cognos

Connection ポータルを使用して TM1 アプリケーションを開くことができます。しかし、アプリケーションの設定と管理を行うには、管理者は TM1 Applications Web

を使用する必要があります。

Cognos セキュリティーを使用するように TM1 アプリケーション・サーバーを設定する場合、Cognos Connection ポータルも有効にして、使用可能な TM1 Applications

へのリンクが含まれるフォルダーが表示されるようにします。表示されるアプリケーションの正確なリストは、現行ユーザーの権限によって異なります。

planning.html ファイルは、TM1 アプリケーションへのリンクを表示するための情報を Cognos Analytics および Cognos Connection ポータルに提供します。詳細については、 292ページの『Cognos TM1 Applications での Cognos セキュリティーの使用』を参照してください。

付属の WebSphere Liberty Profile を使用する場合の Cognos TM1 アプリケーション・サーバーのインストール

Cognos TM1 アプリケーション・サーバーを別のコンピューターにインストールし、インストールに付属する WebSphere Liberty Profile のインスタンスを使用して配布することができます。

このインストールは、Cognos TM1 管理サーバーと Cognos TM1 サーバーが別のコンピューターで稼働している環境を対象としています。

Cognos TM1 Web 層のコンポーネントのインストールこのトピックでは、IBM Cognos TM1 アプリケーション・サーバーに必要なファイルとそのコンポーネントを別個のコンピューター上にインストールするための手順について説明します。


以下のいずれかのインストール・プログラムを使用して、Cognos TM1 Web 層のコンポーネントをインストールします。

v IBM Cognos TM1 32 ビット (Windows)

v IBM Cognos TM1 64 ビット (Windows)


要確認: Cognos TM1 Web クライアントを使用する予定の場合、同じコンピューターまたはネットワーク内の異なるコンピューターのいずれかに Cognos TM1 Web

がインストールされていることが必要です。 Cognos TM1 Web を異なるコンピューター上にインストールする方法については、 117ページの『第 10 章 Cognos

TM1 Web のインストール』を参照してください。

手順1. Microsoft Windows Vista、Windows 7、または Windows Server 2008 オペレーティング・システム・ソフトウェアでは、issetup.exe ファイルを右クリックし、「管理者として実行」をクリックします。その他のオペレーティング・システムでは、issetup.exe ファイルをダブルクリックします。

2. インストール・プログラムで、以下のコンポーネントだけを選択します。

v TM1 Application Gateway


v TM1 Web - このコンポーネントはオプションです。 Cognos TM1 Web をCognos TM1 アプリケーション・サーバーと同じコンピューター上にインストールする場合は、これを選択します。

3. プロンプトに従ってインストールを完了します。

付属の WebSphere Liberty Profile アプリケーション・サーバーでの Cognos TM1 アプリケーション・サーバーの配布

IBM Cognos TM1 アプリケーション・サーバーは、インストールに含まれているWebSphere Liberty Profile アプリケーション・サーバーで稼働します。Cognos

Configuration を使用して、WebSphere Liberty と Cognos TM1 アプリケーション・サーバーを配布して開始します。

手順1. 「スタート」>「すべてのプログラム」>「IBM Cognos TM1」>「IBM Cognos

Configuration」をクリックします。

Windows Vista、Windows 7、または Windows 2008 オペレーティング・システム・ソフトウェアを実行するコンピューターで、Program Files (x86) ディレクトリーから製品をインストールする場合は、IBM Cognos Configuration を管理者として開始します。

2. Cognos Configuration の「エクスプローラー」パネルで、「ローカル設定」>「環境」ノードを展開し、「TM1 アプリケーション・サーバー」を右クリックしてから「開始」を選択します。

付属バージョンの WebSphere Liberty Profile サーバーが起動し、Cognos TM1

アプリケーション・サーバーが配布され、起動します。

3. 「ファイル」>「保存」をクリックして IBM Cognos Configuration を閉じます。

第 11 章 Cognos TM1 アプリケーション・サーバーのインストール 149

Cognos TM1 Application Web の認証セキュリティーの設定Cognos TM1 Application Web とともに使用される IBM Cognos TM1 サーバーの場合、TM1 標準セキュリティー認証または IBM Cognos セキュリティーのいずれかを使用します。


使用する各 Cognos TM1 サーバーの Tm1s.cfg ファイルのIntegratedSecurityMode パラメーターを使って認証ログオン・モードを設定します。

Cognos TM1 Application Web は、次の TM1 セキュリティー認証モードとのみ互換性があります。

v 認証モード 1 - TM1 標準セキュリティー認証

v 認証モード 5 - IBM Cognos セキュリティー

重要: 同一の Cognos TM1 Application Web のインストールに対して、異なるセキュリティー認証モードを組み合わせて使用しないでください。

ベスト・プラクティスは、Cognos TM1 Application Web に Cognos TM1 サーバーを使用するように設定する前にセキュリティー・モードを決定して、追加するその他のサーバーで同じセキュリティー・モードを使用するようにすることです。

セキュリティー認証および IntegratedSecurityMode パラメーターについて詳しくは、以下を参照してください。

v 247ページの『認証セキュリティー』

v 363ページの『IntegratedSecurityMode』

手順1. ファイル TM1 server data directory/Tm1s.cfg を開きます。

2. Cognos TM1 サーバーの IntegratedSecurityMode パラメーターを設定します。

v Cognos TM1 標準セキュリティー認証を使用するには、IntegratedSecurityMode=1 を設定します。

v IBM Cognos セキュリティーを使用するには、IntegratedSecurityMode=5 を設定します。

IBM Cognos セキュリティーの使用方法について詳しくは、以下を参照してください。





5. Cognos TM1 Application Web で使用する他のすべての Cognos TM1 サーバーでこれらの手順を繰り返します。


Cognos TM1 Application Web のサーバーおよびクライアント環境の設定

IBM Cognos TM1 Application Web を使用する前に、使用する TM1 管理ホスト、TM1 サーバー、およびクライアント・ユーザー・インターフェースを指定しておく必要があります。Cognos TM1 Application Web を初めて開始するときに、これらのオプションの設定を要求するプロンプトがプログラムから出されます。

始める前に

アクセス可能なローカル・コンピューターまたはリモート・コンピューターで TM1

管理サーバーと 1 つ以上の TM1 サーバーが稼働していることを確認します。

使用する各 TM1 サーバーに必須パラメーター値が設定されていることを確認します。詳しくは、 155ページの『Cognos TM1 Application Web と協働するためのCognos TM1 サーバーの設定』を参照してください。

Cognos TM1 Application Web の使用を計画している場合は、 Cognos TM1 Web が稼働する Web サーバーの名前とポート番号を確認しておいてください。

手順1. Cognos TM1 Application Web を開始してログオンします。

a. Web ブラウザーで、Cognos TM1 Application Web の URL を入力します。

http://localhost:9510/pmpsvc

b. localhost を、Cognos TM1 アプリケーション・サーバーがインストールされているコンピューターの名前に置き換えます。

2. Cognos TM1 Application の設定ページを開きます。

v インストール以降、Cognos TM1 Application Web を開始するのが今回初めての場合、設定ページが開きます。

v 既に Cognos TM1 Application Web を設定している場合は、ユーザー名とパスワードを要求するプロンプトが出され、 Cognos TM1 Application Web のメインページのツールバーから「IBM Cognos TM1 Applications の管理

(Administer IBM Cognos TM1 Applications)」ボタンをクリックして、設定ページを開くことができます。

3. 「管理ホスト」フィールドに、Cognos TM1 管理サーバーが稼働するコンピューターの名前または IP アドレスを入力します。

注: Cognos TM1 管理サーバーと 1 つ以上の Cognos TM1 サーバーがまだ始動していない場合、「管理ホスト」フィールドと「サーバー名」フィールドは空白として表示されます。

4. 「サーバー名」フィールドに、Cognos TM1 Application Web で使用する TM1

サーバーの名前を入力します。

例えば、サンプル TM1 サーバーGO_New_Stores を指定できます。

「更新」ボタンをクリックして、使用可能なサーバーのリストを更新します。

5. Cognos TM1 Application Web で使用するデータ・コントリビューション・クライアントを選択します。


IBM Cognos TM1 Performance Modeler でアプリケーションを作成する際、以下のクライアントを使用できます。

v 「Cognos Insight - 接続の組み込み (Include Cognos Insight - Connected)」- TM1 サーバーとのリアルタイム処理機能を使用する IBM Cognos Insight クライアント。

v 「Cognos Insight - 分散の組み込み (Include Cognos Insight - Distributed)」- データのローカル処理機能を持つ IBM Cognos Insight クライアント。データのコミット操作が実行された場合のみ、TM1 サーバーのデータが更新されます。

v 「TM1 Application Web の組み込み」 - デフォルトのクライアント。サーバーとの処理がリアルタイムで行われます。このオプションでは、Cognos TM1

Web のデータ・グリッドおよびグラフ作成クライアント・インフラストラクチャーが使用され、「TM1 Application Web URL」オプションの値の入力が必要になります。

6. 「TM1 Application Web の組み込み」オプションを選択した場合、「TM1Application Web URL」オプションの値を入力します。

この URL は、Cognos TM1 Web をホスティングしている Web サーバー上のContributor.jsp ファイルを指します。

例:

http://WebServer:9510/tm1web/Contributor.jsp

WebServer は、Cognos TM1 Web がインストールされているコンピューターの名前です。


8. プロンプトで要求された場合、サーバーの「ユーザー名」と「パスワード」を入力し、「ログオン」をクリックします。

ヒント: インストール済みのサンプル・データベースのいずれかを使用している場合は、ユーザー名とパスワードに admin と apple を使用します。

Cognos TM1 Application Web のメインページが表示されます。このページは、Cognos TM1 Application Web 内でアプリケーションを作成して配布するまで空白のままです。詳しくは、IBM Cognos Performance Modeler および IBM

Cognos Insight のドキュメントを参照してください。

タスクの結果

以下のメッセージは、使用している Cognos TM1 サーバーが Cognos TM1

Application Web で使用されるように正しく設定されていないことを示します。

The new server can be added but it may not be configured with all the

options required by IBM Cognos TM1 Applications.

このサーバーの設定方法については、 155ページの『Cognos TM1 Application Web

と協働するための Cognos TM1 サーバーの設定』を参照してください。


Cognos Configuration における Cognos TM1 アプリケーション・サーバーの設定

Cognos Configuration で Cognos TM1 アプリケーション・サーバーの設定を構成できます。

Cognos Configuration で、「環境」 > 「TM1 アプリケーション・サーバー」をクリックします。

セッション・タイムアウト (分)アクティビティーのない状態がこの時間続くと、TM1 サーバーは切断されます。デフォルトは 60 分です。

修飾パスの強制True に設定すると、管理ホストとして指定されたマシン名が完全修飾ドメイン名に解決されます。 False に設定すると、マシン名だけが使用されます。

通知プロバイダー

v DLS (Delivery サービス): メール・サーバーが構成されている場合、E メールは送信されますが、Cognos の受信トレイに通知は表示されません。

v HTS (Human Task サービス): 通知は Cognos の受信トレイに送信され、メール・サーバーが構成されている場合は E メールも送信されます。

デフォルトでは、非通知のために空白にします。

Business Viewpoint の有効化True の場合は Business Viewpoint がこのインストール環境と対話できます。 False の場合は Business Viewpoint は対話しません。

Cognos Connection フォルダー名配布済み TM1 アプリケーションへのハイパーリンクが含まれているCognos Connection のフォルダーの名前を指定します。デフォルトは「IBM

Cognos TM1 Application - My Applications」です。

TM1 アプリケーション・サービス・ディスパッチャーの URIディスパッチャー・サーブレットに使用する URI (http://localhost:9510/

pmpsvc/dispatcher/servlet など)。

ユーザー ID およびパスワード認証に使用するユーザー ID とパスワード。

「TM1 アプリケーション・サーバー」の下で、「TM1 クライアント」をクリックします。

プロビジョニング URIMSI のロケーションを手動で設定するために使用する URI を指定します。

プロビジョニング済みインストールを許可True の場合、インストール済みクライアントを持たないユーザーは、TM1

アプリケーション・サーバーからのクライアントをプロビジョニングしてインストールできます。False の場合、ユーザーがクライアント・ソフトウェアをプロビジョニングしてインストールすることはできません。

プロビジョニング済み更新を許可True の場合、TM1 アプリケーション・サーバーにインストールされたアッ


プデート (フィックスパック・バージョンなど) をユーザーの次の接続時にクライアントにプロビジョニングすることができます。 False の場合、アップデートをプロビジョニングできません。

Cognos Insight からの発行を有効化True の場合、管理権限を持つユーザーが Cognos Insight から発行操作を行うことができます。False の場合、すべてのユーザーが発行操作を行えません。

Cognos Insight ping 頻度 (秒)Cognos Insight が TM1 アプリケーション・サーバーへの接続を確認する頻度を決定します。分散モードの間に Cognos Insight が何も応答を受信しない場合は、暗黙的にオフライン・モードになります。デフォルトは 30 秒です。

Cognos TM1 Application Web の URL 起動リンクを判別するCognos TM1 Application Web を起動してログオンするための正確なリンクは、実行している Web サーバーとその設定内容によって異なります。

Cognos TM1 Application Web のデフォルトの始動 URL は、IBM Cognos

Configuration で確認できます。

1. Cognos Configuration を開きます。

2. 「ローカル設定」 > 「環境」をクリックして展開し、「TM1 アプリケーション・サーバー」を選択します。

3. URL は、「TM1 アプリケーション・サーバー・ゲートウェイ URI」フィールドの値の欄にリストされています。

たとえば、次のようになります。 http://localhost:9510/pmpsvc

リンク・パラメーター

次の形式の URL を使って、Cognos TM1 Application Web にログオンします。

https://WebServer:PortNumber/pmpsvc

表 15. Cognos TM1 Application Web - URL パラメーター

パラメーター説明

WebServer 以下のいずれかにすることができます。

Cognos TM1 アプリケーション・サーバーを実行している Web サーバーに現在ログオンしている場合、キーワード localhost。

Cognos TM1 アプリケーション・サーバーをホストしている Web

サーバーのマシン名またはドメイン名。

Cognos TM1 アプリケーション・サーバーをホストしている Web

サーバーの IP アドレス。


表 15. Cognos TM1 Application Web - URL パラメーター (続き)


PortNumber Web アプリケーション・サーバーで設定したポート番号。

IBM WebSphere - WebSphere 管理コンソールの「Web サーバー」リンクをクリックして、ポート設定を表示して編集します。

Apache Tomcat - 以下の場所にある Apache Tomcat の server.xml

ファイルを開いて、ポート設定を表示して編集します。

C:\Program Files\Apache Software Foundation\Tomcat

6.0\conf\server.xml.

リンクの例

表 16. Cognos TM1 Application Web - リンクの例

Web アプリケーション・サーバー見出し

インストールに含まれている WebSphere

Liberty Profile

付属バージョンの WebSphere Liberty Profile を使用する場合のデフォルトのリンクは以下のとおりです。


Apache Tomcat Apache Tomcat での Cognos TM1 Application Web の通常のリンクは以下のとおりです。


IBM WebSphere

Application Server

IBM WebSphere アプリケーション・サーバーで実行しているCognos TM1 Application Web の通常のリンクは以下のとおりです。

https://localhost:8443/pmpsvc

Cognos TM1 Application Web と協働するための Cognos TM1 サーバーの設定

IBM Cognos TM1 サーバーを IBM Cognos TM1 Application Web とともに使用する前に、TM1 サーバーの設定ファイルを編集して必須のパラメーターと値を組み込みます。


Cognos TM1 サーバーの Tm1s.cfg ファイルの以下の設定パラメーターは、Cognos

TM1 Application Web のさまざまなサブコンポーネントをサポートしています。

v AllowSeparateNandCRules パラメーター - Cognos TM1 Performance Modeler とCognos TM1 Application Web をサポートしています。

344ページの『AllowSeparateNandCRules』を参照してください。

v DistributedPlanningOutputDir パラメーター - Cognos Insight - 分散クライアントと Cognos TM1 Application Web をサポートしています。

357ページの『DistributedPlanningOutputDir』を参照してください。


v ForceReevaluationOfFeedersForFedCellsOnDataChange パラメーター - Cognos

TM1 Performance Modeler と Cognos TM1 Application Web をサポートしています。このパラメーターが設定されると、データが変更されたときにフィーダー・ステートメントの再評価が強制的に行われます。

361ページの『ForceReevaluationOfFeedersForFedCellsOnDataChange』を参照してください。

手順1. Cognos TM1 サーバー設定ファイル Tm1s.cfg を開きます。

2. Cognos TM1 Performance Modeler をサポートするには、以下の行を編集または追加します。

AllowSeparateNandCRules=T

3. Cognos Insight – 分散クライアントをサポートするには、以下の行を編集または追加します。

DistributedPlanningOutputDir=.\tunit

4. ForceReevaluationOfFeedersForFedCellsOnDataChange パラメーターを編集または追加します。

5. Tm1s.cfg ファイルを保存します。



IBM Cognos TM1 Application Web の構成IBM Cognos TM1 は、IBM Cognos TM1 Web を使用して、Cognos TM1

Application Web クライアントをサポートします。Cognos TM1 Application Web を使用することにより、ユーザーはグリッド形式のプランニング・アプリケーション・データを表示および編集できます。ユーザーが Cognos TM1 Application Web

を使用できるようにするには、このオプションを設定する必要があります。


Cognos TM1 Web をインストールする際、Cognos TM1 Application Web で必要なファイルが Cognos TM1 Web のインストール場所にコピーされます。

Cognos TM1 Application Web のメインファイルは、次のとおりです。

Contributor.jsp

デフォルトのインストールの場所は次のとおりです。

TM1_install_location¥webapps¥tm1web

この場所の Contributor.jsp ファイルを示すには、Cognos TM1 Application Web

に Cognos TM1 Application Web URL パラメーターを設定する必要があります。


手順1. Cognos TM1 Application Web の構成ページを開きます。

v 初めて Cognos TM1 Application Web を実行する場合は、プログラムを起動する際に開く設定ページを使用します。

詳細については、 151ページの『Cognos TM1 Application Web のサーバーおよびクライアント環境の設定』を参照してください。

v 既に Cognos TM1 Application Web を使用している場合は、 Cognos TM1

Application Web のツールバーから「IBM Cognos TM1 Applications の管理

(Administer IBM Cognos TM1 Applications)」ボタンをクリックして、設定ページを再度開くことができます。

2. 「TM1 Application Web URL」フィールドに、Contributor.jsp ファイルのURL ロケーションを入力します。

次の書式を使用します。

http://WebServer:port_number/tm1web/Contributor.jsp

例:

http://webserver.example.com:9510/tm1web/Contributor.jsp

3. 「OK」をクリックします。 Cognos TM1 Application Web のログオン・ページが表示されます。

Cognos TM1 アプリケーション・サーバーのログ記録TM1 アプリケーション・サーバーのログ・ファイルを設定して表示することにより、IBM Cognos TM1 アプリケーション・サーバーのアクティビティーとパフォーマンスをモニターできます。

Cognos TM1 アプリケーション・サーバーは、log4j フレームワークを使用してPlanning サービス (pmpsvc) ログ記録を制御します。ログ記録の設定は動的です。つまり、ログ記録プロパティー・ファイルに何らかの変更を加えると、サービスの実行中にそれが検出されます。

ログ記録プロパティー・ファイル

ログ記録は次のファイルで設定されています。

<tm1_installation_location>¥webapps¥pmpsvc¥WEB-

INF¥configuration¥log4j.properties

例えば、32 ビット Microsoft Windows システムのデフォルトのインストール場所は、次のとおりです。

C:¥Program Files¥IBM¥cognos¥tm1¥webapps¥pmpsvc¥WEB-INF¥configuration¥

64 ビット Windows システムの場合:

C:¥Program Files¥IBM¥cognos¥tm1_64¥webapps¥pmpsvc¥WEB-INF¥configuration¥


ログ・ファイルの出力

デフォルトでは、24 時間のすべてのログ・エントリーを格納するテキスト・ファイルに、ERROR メッセージのみがログ記録されるようにサービスが設定されます。ログ・ファイルとそのディレクトリーは次の場所にあります。

<tm1_installation_location>¥webapps¥pmpsvc¥WEB-INF¥logs¥pmpsvc.log

前日までの古いログ・ファイルには、次の形式で名前が付けられます。

pmpsvc.log.YYYY-MM-DD

ログ・ファイルのメッセージ・レベル

ログに記録できる詳細度には 4 つのレベルがあります。各レベルでは、そのレベルに含まれるすべてのログ・エントリーと、それより高い各レベルのログ・エントリーが記録されます。

表 17. レベルの説明

レベル説明

ERROR 現在の操作をサービスが完了できなくなる例外的なイベントを出力します。

WARNING サービスを続行できるものの、管理者に注意を喚起する必要のある状態を出力します。

INFO それぞれのサービス操作について情報を出力します。

DEBUG サービス操作について詳細なトレース情報を出力します。

ログ記録を有効に設定する例

情報のログ記録レベルを制御するには、サービスの以下の 2 つのルートの下のレベルを変更します。

v log4j.logger.com.ibm.cognos

v log4j.logger.com.cognos

サービスのすべてのコンポーネントはこれらのツリーの下位に置かれているため、これらに対するログ記録レベルを変更すると、そのレベルのすべてのイベントがログに記録されます。

例えば、サービスが INFO レベルでログ記録するように変更するには、これらのエントリーを以下のように変更します。

#System logging settingslog4j.rootLogger=ERROR, TextFilelog4j.logger.com.ibm.cognos=INFOlog4j.logger.com.cognos=INFO

もう少し細かくログ記録レベルを設定するには、これらの最上位レベルより下位にあるクラスのログ記録レベルを変更します。例えば、全体のログ記録を WARNING で行い、TurboIntegrator プロセスの呼び出しのみ DEBUG レベルでログに記録することができます。


#System logging settingslog4j.rootLogger=ERROR, TextFilelog4j.logger.com.ibm.cognos=WARNINGlog4j.logger.com.cognos=WARNINGlog4j.logger.com.ibm.cognos.pmpsvc.handler.util.PmtaProcessUtil=DEBUG

サービスのパフォーマンス・ログ記録を有効にするには、プロパティー・ファイルで標準のログ記録をコメント化し、以下のパフォーマンス・エントリーを組み込みます。

# System logging settings#log4j.rootLogger=ERROR, Console, TextFile#log4j.logger.com.ibm.cognos=DEBUG#log4j.logger.com.cognos=DEBUG#log4j.logger.com.cognos.org=ERROR#log4j.logger.com.ibm.cognos.perf=ERROR

# Performance logging settingslog4j.rootLogger=ERROR, perfConsole, perfTextlog4j.logger.com.ibm.cognos.perf=DEBUG

注: TM1 Operations Console を使用して TM1 アプリケーション・サーバーをモニターすることもできます。「IBM Cognos TM1 Operations Console」を参照してください。

Cognos TM1 アプリケーション・サーバーの拡張インストールと設定拡張インストールと詳細設定タスクを実行することにより、IBM Cognos TM アプリケーション・サーバーのさまざまなコンポーネントのインストール環境をカスタマイズできます。

Apache Tomcat Web アプリケーション・サーバーの独自インストールとの Cognos TM1 アプリケーション・サーバーのインストール

このセクションでは、Cognos TM1 アプリケーション・サーバーを別のコンピューターにインストールし、Apache Tomcat の独自インストールを使用して配布する方法について説明します。


Apache Tomcat サーバーまたは WebSphere® Liberty サーバーのためのアプリケーション・ファイルの作成WebSphere® Liberty サーバーまたは Apache Tomcat サーバーに配布するアプリケーション・ファイルを作成するには、IBM Cognos Configuration を使用します。


Web アーカイブ (WAR) ファイルまたはエンタープライズ・アーカイブ (EAR) ファイルを作成することができます。アプリケーション・サーバーでサポートされるWAR ファイルおよび EAR ファイルについて詳しくは、各アプリケーション・サーバーの資料を参照してください。


手順1. 「スタート」 > 「すべてのプログラム」 > 「IBM Cognos TM1」 > 「IBM

Cognos Configuration」をクリックします。

2. 「操作」>「アプリケーション・ファイルを構築」をクリックします。

3. 「アプリケーション」で、「TM1 アプリケーション・サーバー」を選択します。

4. アプリケーション・サーバーのタイプとして「Apache Tomcat」にチェック・マークを付けます。「次へ」をクリックします。

5. ファイルを保存するファイル・タイプおよび場所を選択します。デフォルトの場所は <your installation location>¥ibm¥cognos¥TM1¥ です。「次へ」をクリックします。

6. 「アプリケーション構築ウィザード」の処理が完了するまでお待ちください。「終了」をクリックします。

次のタスク

これでアプリケーション・ファイルをアプリケーション・サーバーに配布できます。























Cognos TM1 Application Web のサーバーおよびクライアント環境の設定IBM Cognos TM1 Application Web を使用する前に、使用する TM1 管理ホスト、TM1 サーバー、およびクライアント・ユーザー・インターフェースを指定しておく必要があります。Cognos TM1 Application Web を初めて開始するときに、これらのオプションの設定を要求するプロンプトがプログラムから出されます。

始める前に




























例:









タスクの結果







独自の IBM Websphere インストール済み環境を使用する場合のCognos TM1 アプリケーション・サーバーのインストール

このセクションでは、Cognos TM1 アプリケーション・サーバーを別個のコンピューターにインストールし、独自の IBM WebSphere インストール済み環境を使用して配布する方法について説明します。


WebSphere に TM1 アプリケーション・サーバーを配布するには、以下のタスクを実行します。

v Cognos Configuration を使用して、アプリケーション・ファイルを作成します。『IBM WebSphere サーバー用のアプリケーション・ファイルの作成』を参照してください。pmpsvc.war ファイルが作成されます。デフォルトの場所は <your

installation location>¥ibm¥cognos¥TM1¥ です。


v pmsvc.war ファイルを WebSphere アプリケーション・サーバーに配布します

IBM WebSphere サーバー用のアプリケーション・ファイルの作成IBM Cognos Configuration を使用して、IBM WebSphere サーバーに配置するアプリケーション・ファイルを作成します。


次の TM1 アプリケーション用に Web アーカイブ (WAR) ファイルまたはエンタープライズ・アーカイブ (EAR) ファイルを作成することができます。

v TM1 Planning Services: pmpsvc.war/ear


v TM1 Web および TM1 Applications Web: tm1web.war/ear

v IBM Performance Management Hub および TM1 Operations Console:

pmhub.war/ear

WAR ファイルまたは EAR ファイルを WebSphere に配置できます。

手順1. 「スタート」 > 「すべてのプログラム」 > 「IBM Cognos TM1」 > 「IBM

Cognos Configuration」をクリックします。

2. 「操作」 > 「アプリケーション・ファイルを構築」をクリックします。

3. 「アプリケーション」で、「TM1 アプリケーション・サーバー」を選択します。

4. 「アプリケーション・サーバーのタイプ」で、「IBM Websphere」を選択します。「次へ」をクリックします。

5. ファイル・タイプを選択します。

6. アプリケーション・ファイルを保存する場所を指定します。デフォルトの場所は <your installation location>¥ibm¥cognos¥TM1¥ です。「次へ」をクリックします。

7. 「アプリケーション構築ウィザード」の処理が完了するまでお待ちください。「終了」をクリックします。

次のタスク

アプリケーション・ファイルを WebSphere アプリケーション・サーバーに配置できます。『IBM WebSphere アプリケーション・サーバーへの TM1 アプリケーション・サーバーの配置』、 121ページの『IBM WebSphere を使用する TM1 Web のインストール』、 111ページの『IBM WebSphere への Cognos TM1 Operations

Console のインストール』を参照してください。

IBM WebSphere アプリケーション・サーバーへの TM1 アプリケーション・サーバーの配置IBM Cognos TM1 アプリケーション・サーバーを IBM WebSphere アプリケーション・サーバーに配置して、実行することができます。






コマンド・ウィンドウが開き、始動の進行状況が表示されます。始動プロセスが完了した後に、コマンド・ウィンドウに「Server started.」というメッセージが表


示されます。このコマンド・ウィンドウを最小化することはできますが、閉じないでください。このウィンドウは、WebSphere が実行している間は開いたままにしておく必要があります。

v Cognos Configuration を使用して、アプリケーション・ファイルを作成します。163ページの『IBM WebSphere サーバー用のアプリケーション・ファイルの作成』を参照してください。





手順1. WebSphere がインストールされているコンピューター上に最低 6 GB のフリー・ディスク・スペースがあることを確認してください。

UNIX では、/tmp にマウントされたディスクで 6 GB 以上が使用可能であることを確認します。 df を使用して、tmpfs に使用される合計スペースと %

の両方を調べます。

注: 十分なディスク・スペースが使用可能であることを確認するまで、TM1 アプリケーション・サーバーを配置しないでください。

2. WebSphere 管理コンソールを開きます。








4. JVM スタック・メモリーのサイズを設定します。

a. 「サーバー」 > 「サーバー・タイプ」 > 「WebSphere ApplicationServer」をクリックします。

b. TM1 アプリケーション・サーバーを配置するサーバーをクリックします。

c. 「サーバー・インフラストラクチャー」の下で、「Java およびプロセス管理」 > 「プロセス定義」をクリックします。


d. 「追加プロパティー」の下で、「Java 仮想マシン」をクリックします。

e. 「汎用 JVM 引数」フィールドに、-Xmso512k を追加します。

危険

スタック・メモリーを設定するまで、TM1 アプリケーション・サーバーを配置しないでください。

startServer.sh ファイルを使用してスタックのメモリー・サイズを設定しないでください。サーバーが始動すると、WebSphere はそのファイルから-Xmso 設定を削除してデフォルト値でオーバーライドしますが、その値は小さすぎます。

f. 「適用」をクリックし、「OK」をクリックします。「保存」をクリックします。


6. 「参照」をクリックし、Cognos Configuration の「アプリケーション・ファイルを構築」コマンドを使用して生成した pmpsvc.war ファイルを見つけて選択します。「開く」をクリックします。




10. コンテキスト・ルート・ボックスで、/pmpsvc と入力します。「次へ」をクリックします。


インストールが完了すると、WebSphere には「アプリケーション pmpsvc_war



13. 「アプリケーション」 > 「アプリケーション・タイプ」 > 「WebSphere エンタープライズ・アプリケーション」をクリックします。

14. pmpsvc_war の横のチェック・ボックスを選択し、「開始」をクリックします。WebSphere に、「アプリケーション pmpsvc_war がサーバー server_name およびノード node で正常に始動されました。場合によっては、コレクションを最新表示して現行の状況を表示する必要があります。」と表示されます。

IBM WebSphere への TM1 アプリケーション・サーバー配置のトラブルシューティング:

TM1 アプリケーション・サーバー (pmpsvc.war) の配置が失敗して Java ヒープ・スペースのエラー・メッセージが出る場合は、WebSphere 管理コンソールで Java

パラメーターを調整してください。

注: WebSphere のインストール済み環境を後でアップグレードまたは変更する場合は、この変更をもう一度適用しなければならなくなる場合があります。


手順

1. WebSphere 管理コンソールを開きます。







2. TM1 アプリケーション・サーバーを配置する際に使用した WebSphere プロファイルでログオンします。管理コンソールが開きます。

3. 「サーバー」 > 「サーバー・タイプ」 > 「WebSphere Application Server」をクリックします。

4. TM1 アプリケーション・サーバーを配置したサーバーをクリックします。

5. 「サーバー・インフラストラクチャー」の下で、「Java およびプロセス管理」> 「プロセス定義」をクリックします。

6. 「追加プロパティー」の下で、「Java 仮想マシン」をクリックします。

7. 「初期ヒープ・サイズ」フィールドに、1024 と入力します。

8. 「最大ヒープ・サイズ」フィールドに、2048 と入力します。

9. 「適用」をクリックし、「OK」をクリックします。「保存」をクリックします。

10. WebSphere を再始動します。























Cognos TM1 Application Web のサーバーおよびクライアント環境の設定IBM Cognos TM1 Application Web を使用する前に、使用する TM1 管理ホスト、TM1 サーバー、およびクライアント・ユーザー・インターフェースを指定しておく必要があります。Cognos TM1 Application Web を初めて開始するときに、これらのオプションの設定を要求するプロンプトがプログラムから出されます。

始める前に




























例:









タスクの結果







複数の Cognos TM1 サーバーを使用するように Cognos TM1Application Web を設定する

IBM Cognos TM1 Application Web を初めて開始した場合、作業対象の Cognos

TM1 サーバーを 1 つのみ入力できます。

追加のサーバーを入力するには、Cognos TM1 Application Web の設定ページを使用します。

重要: Cognos TM1 Application Web で複数の Cognos TM1 サーバーを使用するには、それらのすべてのサーバーで同じセキュリティー認証 (Cognos TM1 標準認証または Cognos Analytics セキュリティーのいずれか) を使用する必要があります。また、管理者のユーザー名およびパスワードも同じでなければなりません。詳しくは、 40ページの『Cognos TM1 Applications を使用する際のセキュリティーの考慮事項』を参照してください。

複数の Cognos TM1 サーバーを追加したら、IBM Cognos TM1 Performance

Modeler を使用してプランニング・アプリケーションを設計する際にそれらのサーバーを使用できます。


手順1. Cognos TM1 Application Web にログオンします。


2. ツールバーで、「Cognos TM1 Applications の管理」ボタンをクリックします。

「IBM Cognos TM1 Applications の設定」ページが表示されます。

3. 「サーバー名」セクションで「追加」をクリックします。

「サーバーの追加」ダイアログ・ボックスが表示されます。

4. 次の値を入力します。

v 管理ホスト - Cognos TM1 管理サーバーが実行されている管理ホストのコンピューター名または IP アドレスを指定します。

「更新」ボタンをクリックして、入力した管理ホストで使用できるサーバーの「サーバー名」リストを更新します。

v サーバー名 - Cognos TM1 Application Web で使用する Cognos TM1 サーバーを選択します。例: Planning Sample。


TM1 サーバーの構成に関する警告メッセージが表示された場合は、警告内容を記録してから、「閉じる」をクリックして続行します。必要な設定について詳しくは、 155ページの『Cognos TM1 Application Web と協働するための Cognos

TM1 サーバーの設定』を参照してください。入力した管理ホストと Cognos

TM1 サーバー名が「サーバー名」セクションに追加されます。

6. さらにサーバーを追加する場合は、「追加」をクリックして手順を繰り返します。

7. TM1 サーバーの追加が終了したら、「IBM Cognos TM1 Applications の設定」ページで「OK」をクリックします。

タスクの結果

追加した Cognos TM1 サーバーは、プランニング・アプリケーションのデザインに使用できるようになりました。

プロキシーの使用IBM Cognos TM1 クライアント・アプリケーションから TM1 アプリケーション・サーバーに要求を転送するプロキシー・サーバーをセットアップできます。

プロキシー・サーバー (リバース・プロキシーと呼ぶこともある) には、次のような利点があります。

v アプリケーション・サーバーの存在や特性を隠蔽する

v 要求処理を最適化する

v 負荷を分散する

v フロントエンドで監査を実行する

v 追加のセキュリティーを実施する

また、TM1 クライアント・アプリケーションを使用するインターネットから TM1

アプリケーション・サーバーの内部ドメインとポートに直接アクセスすることができない場合にも、プロキシーが必要です。


プロキシー環境は、以下のコンポーネントで構成されます。

v インターネット上の TM1 クライアント・アプリケーション (IBM Planning

Analytics for Microsoft Excel など)

v 内部ネットワーク内のプロキシー・サーバー、TM1 アプリケーション・サーバー、および TM1 サーバー

v TM1 で Cognos セキュリティーを使用する場合は、内部ネットワーク内のCognos Business Analytics

プロキシーを使用して動作するように IBM Cognos TM1 を設定するプロキシーを使用して動作するように IBM Cognos TM1 をセットアップすることができます。

手順1. TM1 アプリケーション・サーバー、TM1 管理サーバー、および TM1 サーバーをインストールして構成します。IBM Cognos TM1 の資料にあるインストールと構成の手順に従ってください。

2. Cognos セキュリティーを TM1 と一緒に使用するには、プロキシーを導入する前に、Cognos セキュリティーをセットアップし、環境をテストします。Cognos

セキュリティーの詳細については、 282ページの『Cognos セキュリティーに関する概要』を参照してください。

3. TM1 アプリケーション・サーバーと相互運用するプロキシーをインストールして構成します。このステップの詳細は、ご使用のプロキシー・ソフトウェアのタイプに大きく依存しているため、この TM1 資料の範囲を超えています。一般に、プロキシーでは、内部ネットワーク・ドメインへのアクセスと、TM1 アプリケーション・サーバーを実行しているポートへのアクセスを許可する必要があります。特に、次に挙げるコンテキストおよびそのサブコンテキストに対するアクセスが必要です: pmhub。

4. 内部ネットワーク内に TM1 クライアント・アプリケーション (Planning

Analytics for Microsoft Excel など) をインストールして実行します。このステップでは、プロキシーを組み込むようにセットアップを拡張する前に、TM1 とクライアント・アプリケーションを構成してあることを確認してください。

5. プロキシーと相互運用するように TM1 アプリケーション・サーバーを構成します。詳細については、 173ページの『プロキシーと相互運用するための IBM

Cognos TM1 アプリケーション・サーバーの構成』を参照してください。


プロキシーと相互運用するための IBM Cognos TM1 アプリケーション・サーバーの構成TM1 およびプロキシー・サーバーをセットアップしたら、次のステップとしてTM1 アプリケーション・サーバーをプロキシーとの相互運用のために構成します。


IBM Cognos Configuration を使用することで、TM1 アプリケーション・サーバーをプロキシーとの相互運用のために構成します。

注: このトピックの対象は、IBM Planning Analytics for Microsoft Excel、IBM

Cognos Performance Management Hub、IBM Cognos Operations Console です。


2. TM1 アプリケーション・サーバーを停止します。

3. 「外部サーバー URI」プロパティーを変更します。 http://localhost:9510 のデフォルト値を、プロキシーのプロトコル、ドメイン、およびポートに変更します。それは、インターネットで実行中の TM1 クライアント・アプリケーション・インスタンスからアドレス指定する必要があるためです。完全修飾ホスト・ドメインを使用してください。例: http://myproxy.mycompany.com:1234

重要: 「外部サーバー URI」プロパティーを設定するときには、完全修飾ドメイン名 (例えば、myproxy ではなく myproxy.mycompany.com) を使用します。Planning Analytics for Microsoft Excel などの内部の接続定義とブラウザーの内部のユーザー・ナビゲーションでは、一致する完全修飾名を参照する必要があります。短縮名 (myproxy) と長い名前 (myproxy.mycompany.com) の混用は推奨されていません。

4. TM1 アプリケーション・サーバーを再始動します。

5. Cognos セキュリティー (Cognos Access Manager) を TM1 と共に使用している場合は、『プロキシーの使用時に IBM Cognos セキュリティーのために必要なIBM Cognos TM1 アプリケーション・サーバーの構成』を参照してください。

6. 構成の変更をテストします。

a. デフォルトのアドレスではなくプロキシーのアドレスを使用して、クライアント・アプリケーション (Planning Analytics for Microsoft Excel など) の実行中のインスタンスを接続します。

b. 次の URL を使用して IBM Cognos Performance Management Hub にログオンします。 http://myproxy.mycompany.com:1234/pmhub/pm/security/login

プロキシーの使用時に IBM Cognos セキュリティーのために必要なIBM Cognos TM1 アプリケーション・サーバーの構成IBM Cognos セキュリティー (CAM) を使用する TM1 インストール済み環境では、プロキシーをサポートするための追加ステップを実行する必要があります。

始める前にv Cognos セキュリティーと共に TM1 が構成されている。


v IBM Cognos Analytics ソフトウェアが既にインストールされ、ネームスペースを使用して構成されている。

手順1. 匿名アクセスを無効にします。

a. TM1 のインストール場所ではなく、Analytics のインストール場所で IBM

Cognos Configuration を開きます。

b. 「セキュリティー」 > 「認証」と展開し、「Cognos」をクリックします。

c. 「匿名アクセスを許可」が「無効 (False)」に設定されていることを確認します。

2. IBM Cognos Performance Management Hub (PM Hub) で Cognos セキュリティー URL を設定します。

a. プロキシー・ベースの URL (http://myproxy.mycompany.com:1234/pmhub/pm/

security/login など) を使用して、PM Hub ポータルのログオン・ページに移動します。

b. 「ネームスペース」リストをクリックし、いずれかの TM1 サーバー・インスタンスを選択します。 Cognos ユーザー名とパスワードを入力し、ログオンします。

c. 「管理および構成」リンクをクリックします。

d. com.ibm.ba.pm.resource.security を展開し、com.ibm.ba.pm.resource.security.dictionary をクリックします。

e. CAMBIURL プロパティーを編集します。

TM1 アプリケーション・サーバーがネットワーク内で Analytics ディスパッチャーに直接アクセスできる場合は、次のようにダイレクト URL を使用できます。http://internal.bi.server:9300/p2pd/dispatch

プロキシーによって内部 URI が、セキュアなファイアウォールの背後で保護されている場合は、次のようにプロキシーを URL で指定します。http://myproxy.mycompany.com:1234/p2pd/dispatch

注: URL コンテキスト p2pd のために要求を Cognos Analytics ディスパッチャーにリダイレクトするように、プロキシー・サーバーを構成します。この構成は、他の TM1 ベースのコンテキスト (pmhub、tm1web、および pmpsvc

など) の場合と同様に行います。

シングル・サインオンと Analytics ゲートウェイを使用している場合は、CAMGatewayURL プロパティーを設定する必要がある場合があります。CAMBIURL を設定するために使用したのと同じ手順に従って、CAMGatewayURL を設定します。

3. 設定をテストします。

a. PM Hub からログアウトします。

b. PM Hub ポータルのログオン・ページに戻ります。

c. 「ネームスペース」リストをクリックします。リストには、これまでのように TM1 サーバーが表示され、さらに IBM Cognos Analytics ネームスペースも表示されます。


注: Analytics ネームスペースを「ネームスペース」リストに表示するには、そのネームスペースを Cognos Analytics インストール構成で定義しておく必要があります。

TM1 のプロキシー設定のトラブルシューティングプロキシーが含まれている TM1 環境で接続の問題をトラブルシューティングするには、以下の手順に従います。

1. 以下のように、問題が起きている場所を判別します。

v TM1 クライアント・アプリケーションで、プロキシー URI を使用せずに直接 TM1 サーバーにアクセスします。例えば、Cognos TM1 Performance

Modeler を開始して「直接接続する」をクリックします。

v Cognos セキュリティーを使用している場合は、TM1 Web などの TM1 Web

アプリケーションを使用して、プロキシー URI を使用せずに Cognos

Analytics サーバーにアクセスします。プロキシー URI を使用して再試行します。

v TM1 Web などの TM1 Web アプリケーションで、プロキシー URI を使用せずに、TM1 アプリケーション・サーバー経由で TM1 サーバーにアクセスします。プロキシー URI を使用して再試行します。

v Planning Analytics for Microsoft Excel などの TM1 クライアント・アプリケーションで、プロキシー URI を使用せずに、TM1 アプリケーション・サーバー経由で TM1 サーバーにアクセスします。プロキシー URI を使用して再試行します。

注: プロキシーがファイアウォールである場合は、サーバーへのアクセスが難しいことがあります。この場合、ファイアウォール内で TM1 クライアントまたはWeb アプリケーションを実行して、プロキシーを使用しない接続をテストします。

2. ステップ 1 のテストのいずれかが失敗した場合は、設定内で接続を確認し、再試行してから、次のテストに進みます。

Insight での Cognos TM1 TurboIntegrator 関数のセキュリティーの設定

IBM Cognos Connection によって共有されている IBM Cognos Insight ワークスペースを開く際に、いくつかの TurboIntegrator 関数 (特に、データ・ファイルを破棄または変更する可能性のある関数) の実行を制限することもできます。

TurboIntegrator 関数の中には、ファイルを作成および削除したり、コマンドを実行したりするものが存在します。共有 Insight ワークスペースを受け取る際に、望ましくないアクションを実行する関数がワークスペース内の TurboIntegrator プロセスに含まれている可能性があります。害となる可能性のあるアクションがプロセスによって実行されないようにするため、Insight インストール済み環境にはTMIFunctions.cfg という名前の設定ファイルが置かれています。これを使用して、TurboIntegrator 関数の実行を回避または制限することができます。

いずれの TurboIntegrator 関数も、完全に実行されないようにすることができます。ASCIIOutput 関数、TextOutput 関数、および ASCIIDelete 関数を制限モードで実行


するように設定することもできます。関数を制限モードで実行すると、その実行の対象が TM1 サーバー・データ・ディレクトリーおよびそのサブディレクトリー内のファイルだけに限定されます。

IBM Cognos Insight をインストールすると、デフォルト・バージョンのTM1Functions.cfg が C:¥Documents and Settings¥<user>¥Application

Data¥IBM¥Cognos Insight¥bins¥bin_xxxx に作成されます。 <user> は、Insight をインストールしたときに使用したユーザー名で、xxxx はインストールのバージョンです。

TM1Functions.cfg のデフォルト・バージョンは次のとおりです。

ExecuteCommand=0AsciiOutput=1TextOutput=1AsciiDelete=1

TM1Functions.cfg で関数を 0 に設定すると、関数が実行できなくなります。その関数の実行を試みると、そのたびに TurboIntegrator によってセキュリティー例外がスローされます。

TM1Functions.cfg で関数を 1 に設定すると、関数は制限モードで実行されます。制限モードで実行するように設定できるのは、ASCIIOutput 関数、TextOutput 関数、および ASCIIDelete 関数だけです。

関数が TM1Functions.cfg に存在しない場合は、完全に無制限で実行されます。

制限モードで実行される関数の例

制限モードで実行するように関数が設定されると、引数として関数に渡される相対パスはすべて、TM1 サーバー・データ・ディレクトリーにルートがあり、許可されていると見なされます。 TM1 サーバー・データ・ディレクトリーより上のディレクトリーへの絶対パスの場合には関数は実行されず、実行時にセキュリティー例外がスローされます。

例えば、TM1Functions.cfg に AsciiDelete=1 があるとします。この場合、以下の関数は許可されます。

ASCIIDelete('logs\sample.log’);

この関数は、ファイル sample.log を TM1 サーバー・データ・ディレクトリーのlogs サブディレクトリーから削除します。

しかし、以下の関数は実行されません。

ASCIIDelete('c:\autoexec.bat’);

この関数はセキュリティー例外の原因となります。この関数は、ドライブのルート・レベル、つまり TM1 サーバー・データ・ディレクトリーより上でファイルを指定しているからです。

同じように、TM1Functions.cfg に TextOutput=1 があるとします。この場合、以下の関数は許可されます。


TextOutput('logs\sample.txt’, 'this is sample text’);

この関数は、TM1 サーバー・データ・ディレクトリーの logs サブディレクトリーの sample.txt ファイルにストリングを書き込みます。

逆に、以下の関数は許可されません。

TextOutput('c:\autoexec.bat’, 'del *.* -r –f’);

パスがドライブのルート・レベルで指定されているからです。この関数では、セキュリティー例外が実行時にスローされます。

TM1Functions.cfg ファイルの編集TM1Functions.cfg ファイルを使用して、共有 IBM Cognos Insight ワークスペース内に含まれる潜在的に害のある TurboIntegrator 関数の実行を回避または制限することができます。


IBM Cognos Insight をインストールすると、デフォルト・バージョンのTM1Functions.cfg が C:¥Documents and Settings¥<user>¥Application

Data¥IBM¥Cognos Insight¥bins¥bin_xxxx に作成されます。 <user> は、Insight をインストールしたときに使用したユーザー名で、xxxx はインストールのバージョンです。この設定ファイルを変更して関数の実行をさらに制限したり、許可したりすることができます。

手順1. TM1Functions.cfg をテキスト・エディターで開きます。

2. 関数が完全に実行されないようにするには、関数名 = 0 を設定します。例えば、ExecuteCommand=0 または ServerShutdown=0 のようにします。

3. 関数を制限モードで実行できるようにするには、関数名 = 1 を設定します。例えば、AsciiDelete=1 のようにします。制限モードで実行するように設定できるのは、ASCIIOutput 関数、TextOutput 関数、および ASCIIDelete 関数だけです。

4. 関数を無制限に実行できるようにするには、関数名を TM1Functions.cfg から削除します。

5. TM1Functions.cfg を保存して閉じます。


第 12 章 Planning Analytics Workspace installation

IBM Planning Analytics Workspace is a web-based interface for IBM Planning

Analytics. It provides an interface to TM1 data, with exciting ways to plan, create,

and analyze your content.

Planning Analytics Workspace architectureIBM Planning Analytics Workspace can be colocated with IBM Planning Analytics

Local or it can reside on its own. In either case, it must connect to the TM1 servers

in your Planning Analytics Local system and to an authentication system.

The following diagram shows where Planning Analytics Workspace fits into your IBM

Planning Analytics Local architecture:

Authentication modes

You can use standard TM1 security (mode 1) or Cognos Analytics security (IBM

Cognos セキュリティー mode 5) to authenticate Planning Analytics Workspace users.


Planning Analytics Workspace installation overviewThe following diagram shows the workflow for installation. If you are viewing this

diagram from IBM Knowledge Center, you can click on a task to go to the procedure

for that task.

PrerequisitesBefore you install IBM Planning Analytics Workspace, you must have IBM Planning

Analytics Local 2.0.0 or greater installed.

For information about late-breaking installation and configuration issues for Planning

Analytics Workspace, see Critical usage notes for IBM Planning Analytics.

Extract paw_<version>_ml.tar.gz. Use a directory structure that groups the Planning

Analytics Workspace installation kits into one directory and clearly indicates the

version number of each kit. For example,

paw_install_kits/ paw_2.0_ml.tar.gz



注: Planning Analytics Workspace is included as part of IBM Planning Analytics

Local. If you haven't downloaded the Planning Analytics Workspace installation kit,

refer to the IBM Planning Analytics Local download document for information about

how to do so.

If you are using IBM Cognos Analytics (IBM Cognos Business Intelligence) as your

authentication provider, then you must have IBM Cognos Analytics 10.2.2 (IBM

Cognos Business Intelligence 10.2.2) or greater installed.

Planning Analytics Workspace communicates with TM1 servers using the TM1 REST

API. In the Tm1s.cfg file for all TM1 Servers, set the HTTPPortNumber property to a

free port on the server.

Installing DockerDocker is the environment in which Planning Analytics Workspace runs.

Before you begin

You must install a minimum of Docker version 1.11.0.

Important: If you're installing Docker on a Microsoft Windows OS, your system

must support hardware virtualization and you must enable it. If you are installing on

a Linux OS, then you don't need to enable hardware virtualization.

About this task

If you're not familiar with Docker and want information about it, see What is

Docker? (https://www.docker.com/what-docker).

Procedure1. If you're installing on a Microsoft Windows OS, install the Docker Toolbox. For

information about installing Docker Toolbox, see Docker Toolbox

(https://www.docker.com/products/docker-toolbox). If you are prompted to allow

VirtualBox Interface to make changes to your computer, reply 『Yes』. You don't

need to start the Docker Quickstart Terminal.

2. If you're installing on a Linux OS, do the following steps:

a. Install the Docker engine. For information, see Install Docker Engine on Linux

(https://docs.docker.com/engine/installation/linux/).

b. Install Docker Compose (minimum version 1.8.1). For information, see Install

Docker Compose (https://docs.docker.com/compose/install/).

Installing Planning Analytics WorkspaceYou install IBM Planning Analytics Workspace on a Microsoft Windows OS that is

running a Linux VM or directly on a Linux OS.

About this task

The start script does the following things:

v Checks that the required ports are available

第 12 章 Planning Analytics Workspace installation 181

https://www.docker.com/what-docker

https://www.docker.com/what-docker

http://www.docker.com/products/docker-toolbox

https://docs.docker.com/engine/installation/linux/

https://docs.docker.com/compose/install/

https://docs.docker.com/compose/install/

v If you are installing on a Microsoft Windows OS, it creates a Linux virtual

machine (VM) called 『paw』 on which Planning Analytics Workspace runs. You

can change the following default values for the VM settings:

– 8192 MB of memory

– 4 CPUs

– 20,000 MB of storage

v Installs the Planning Analytics Workspace Docker images

v Opens the IBM Planning Analytics Workspace Administration Tool

Here's a short video that shows the installation of Planning Analytics Workspace on a

Microsoft Windows OS:

https://youtu.be/8jOfrXapczM

Procedure1. Run the start script:

a. If you are installing on a Microsoft Windows OS, go to the directory where

you extracted the installation kit and double-click Start.bat.

b. If you are installing on a Linux OS, open a terminal window, go to the

directory where you extracted the installation kit, and type the following

command:

./Start.sh

注: The first time you run the start script, it automatically installs the Docker

images. The next time you run the start script, you can skip installing or updating

the Docker images and go straight into the administration tool.

2. Reply 『y』 when you are asked if you want to start the administration tool.

注: Keep the command or terminal window open. Closing the window stops the

administration tool.

Results

The IBM Planning Analytics Workspace Administration Tool opens in your browser.

If the administration tool doesn't open, copy and paste the address shown in the

command or terminal window into a browser window.

Connecting Planning Analytics Workspace to Cognos TM1and authentication servers

Use the IBM Planning Analytics Workspace Administration Tool to configure the

Cognos TM1 URIs that point to the Cognos TM1 servers and the servers that do

authentication.

About this task

Use fully qualified host names or IP addresses for the URIs. Do not use localhost.


https://youtu.be/8jOfrXapczM

If you are installing on a Microsoft Windows OS and Planning Analytics Workspace

is installed on the same computer as Cognos TM1, then you can use the IP address

192.168.40.1 in the URIs. For more information, see 184ページの『Planning

Analytics Workspace and Cognos TM1 installed on one computer』.

Here's a short video that shows how to do the configuration:

https://youtu.be/CipjgA4nc7I

Procedure1. In the IBM Planning Analytics Workspace Administration Tool on the

Configuration tab, enter the URIs for the following servers:

v TM1 Admin Server URI (the default value is 5898 for the HTTPS REST API

port, and 5895 for the HTTP REST API port)

v TM1 Application Server Gateway URI

2. Under Authentication Mode, select TM1 or CAM. Choose TM1 if you're using

standard TM1 authentication. Choose CAM if you're using IBM Cognos セキュリティー for authentication.

a. If you selected TM1, enter the value for the TM1 Login Server URI.

Planning Analytics Workspace users authenticate to the system by logging into

the TM1 Login Server. Users must have the same credentials on any other

TM1 server they access.

b. If you selected CAM, enter the following values:

v IBM Cognos BI Gateway URI

v IBM Cognos BI Dispatcher URI

v IBM Cognos BI Authentication Namespace ID

3. Click Validate. Planning Analytics Workspace verifies that it can communicate

with the servers and that they are configured for use with it. If a server is not

successfully validated, an error message is displayed.

4. Click OK.

5. Click Update and OK to save your configuration settings.

What to do next

Verify that the Planning Analytics Workspace services started. For more information

about the services, see 184ページの『Checking the status of the services』.

Access Planning Analytics Workspace by entering http://<host-name>/ where

<host-name> is the host name or IP address of your computer, in the address field

of your browser. For information on how to use Planning Analytics Workspace, see

the Planning Analytics Workspace guide.

Read 184ページの『Planning Analytics Workspace and Cognos TM1 installed on one

computer』 for special considerations if you have Planning Analytics Workspace and

Cognos TM1 installed on one computer.


https://youtu.be/CipjgA4nc7I

Checking the status of the servicesThe Status tab in the IBM Planning Analytics Workspace Administration Tool

displays the status, up time, CPU usage, memory usage, and percentage of memory

used for each service.

About this task

Here's a short video overview of the Status tab:

https://youtu.be/AlsSZ4m52u0

Procedure1. Run the Start.bat or Start.sh script.

2. Reply 『n』 when you are prompted to install the Docker images.

3. Reply 『y』 when you are prompted to start the administration tool. If the

administration tool doesn't open, copy and paste the address shown in the


4. In the IBM Planning Analytics Workspace Administration Tool, click the Statustab.

5. Click Refresh and then verify that all services in the list have a status of

『running』. When you are installing, wait until all services have started (the CPU

% for services drops) before accessing Planning Analytics Workspace.

6. To stop, start, or restart one service, select (highlight) it in the list, and then click

Stop, Start, or Restart.

7. To stop, start, or restart all services, make sure that no services are selected in the

list, and then click Stop, Start, or Restart.

Planning Analytics Workspace and Cognos TM1 installedon one computer

There are some things to be aware of when IBM Planning Analytics Workspace and

Cognos TM1 are installed together on a Microsoft Windows OS.

The VM that contains Planning Analytics Workspace has an IP address of

192.168.40.100 and it uses 192.168.40.1 to access Cognos TM1. 192.168.40.1 is the

address of the VirtualBox Host-Only Network adapter on the Microsoft Windows OS

and provides a reliable connection in a standalone or demonstration environment.

If you are physically logged in to the computer that has Planning Analytics

Workspace installed, you can access Planning Analytics Workspace by using

http://192.168.40.100/.

When you configure the TM1 URIs that Planning Analytics Workspace connects to,

you can use the IP address 192.168.40.1 in the URI.

Configuring SSL for Planning Analytics WorkspaceTo configure Secure Sockets Layer (SSL) for IBM Planning Analytics Workspace, you

create a privacy enhanced mail (pem) file that contains your security certificates.


https://youtu.be/AlsSZ4m52u0

Before you begin

You must have the private key, primary, intermediate, and root certificates from your

certificate authority provider.

Procedure1. Open a text editor and paste the body of each certificate into the file in the

following order. Make sure you include the beginning and end tags on each

certificate:

private key<your_domain_name>.key

primary certificate<your_domain_name>.crt

intermediate certificateIntermediateCA.crt

root certificateTrustedRoot.crt

Here is an example:

-----BEGIN RSA PRIVATE KEY-----(Your Private Key: your_domain_name.key)-----END RSA PRIVATE KEY----------BEGIN CERTIFICATE-----(Your Server certificate: your_domain_name.crt)-----END CERTIFICATE----------BEGIN CERTIFICATE-----(Your Intermediate certificate: IntermediateCA.crt)-----END CERTIFICATE----------BEGIN CERTIFICATE-----(Your Root certificate: TrustedRoot.crt)-----END CERTIFICATE-----

2. Save the file as pa-workspace.pem and then copy or move it to the

<paw_install_location>/config directory. If the pa-workspace.pem already

exists in the directory, overwrite it.

3. Open the <paw_install_location>/config/paw.env file and add the following

lines at the end:

export EnableSSL=trueexport ServerName=<paw-server-name>

where <paw-server-name> is the name of the server on which Planning Analytics

Workspace is installed.

4. Save the <paw_install_location>/config/paw.env file.

5. Open the IBM Planning Analytics Workspace Administration Tool and restart all

services. For information about how to open the administration tool, see 184ページの『Checking the status of the services』.


Planning Analytics Workspace と他のサーバーとの間の SSLの設定

TM1 サーバーまたは IBM Cognos Analytics の自己署名 SSL 証明書を使用している場合、その認証局証明書を、IBM Planning Analytics Workspace によって使用される CA 証明書のリストに追加する必要が生じる可能性があります。


このタスクでは、CA 証明書が含まれる cacerts という名前のファイルを作成します。 cacerts ファイルは、Planning Analytics Workspace の Java サービスで使用されます。

Cognos Analytics へのログイン時に Java 証明書チェーン・エラーを受け取る場合、次のステップを実行することによって解決します。

手順1. 認証局 (CA) 証明書ファイルを <paw_install_location>/config/certs ディレクトリーに入れます。

2. <paw_install_location>/scripts/process_certs.ps1 (Microsoft Windows OS)

または process_certs.sh (Linux OS) スクリプトを実行します。

3. IBM Planning Analytics Workspace Administration Tool を開き、すべてのサービスを再開します。管理ツールを開く方法について詳しくは、 184ページの『Checking the status of the services』を参照してください。

タスクの結果

cacerts ファイルが <paw_install_location>/config ディレクトリーに作成されます。

注: CA 証明書のセットを変更する必要がある場合、CA 証明書を<paw_install_location>/config/certs ディレクトリーに入れ、process_certs スクリプトを再び実行します。

Configuring a Linux virtual machine to start automaticallyIBM Planning Analytics Workspace that is installed on a Microsoft Windows OS

requires a Linux virtual machine (VM). You can configure the VM to start

automatically when you log in to the Microsoft Windows OS.

Procedure1. Open Oracle VM VirtualBox Manager, right-click the VM, and select Create

Shortcut on Desktop.

2. Click Win-R, type shell:startup, and press Enter.

3. Drag the shortcut icon into the Startup folder.


第 13 章 Administer Planning Analytics Workspace

This section explains how to perform administration tasks such as backup and restore.

Viewing logsYou can use the Status tab of the IBM Planning Analytics Workspace Administration

Tool to view logs.

About this task

The log directory in the installation directory contains a subdirectory for each service.

Procedure1. Run one of the following scripts from the <paw_install_location> folder:

Operating system Script to run

Microsoft Windows Start.bat

Linux Start.sh

2. Reply 『n』 when you are prompted to install the Docker images.

3. Reply 『y』 when you are prompted to start the administration tool. If the

administration tool doesn't open, copy and paste the address shown in the


4. In the IBM Planning Analytics Workspace Administration Tool, click the Statustab.

5. To see the logs of one service, select (highlight) a service in the list by clicking

it, and then clicking Logs. The last 1000 lines in the log file for the service are

displayed. If you want to see more content, you can open the file from the log

directory in a text editor.

Accessing the Planning Analytics Workspace Administration Toolremotely

By default you access the IBM Planning Analytics Workspace Administration Tool

from the computer on which it is installed. To access the administration tool from

another computer, you can set an environment variable.

About this task

This task applies to IBM Planning Analytics Workspace installed on a Linux OS only.

Important: Running the Planning Analytics Workspace Administration Tool this way

is not secure so you may want to restrict access to specific remote IP addresses using

the OS firewall.


Procedure1. In a terminal window, enter the following command:

export ADMINTOOL_IP=<ip address>

where <ip address> is the IP address of the computer from which you want to

access the administration tool.

2. Run the Start.sh script.

3. Access the administration tool from the remote computer by copying and pasting

the address shown in the command or terminal window into a browser window on

the remote computer.

Users in Planning Analytics WorkspaceThe first user that logs in to IBM Planning Analytics Workspace is given the

administrator role. Users that log in after the first user are given the analyst role.

For more information about managing users, see the Planning Analytics Workspace

guide.

Backing up or restoring Planning Analytics WorkspaceWhen you back up IBM Planning Analytics Workspace, you are saving user

information such as preferences, book assets, chat history, recently visited sites, and

book marks.

Before you begin

You must perform this task during a system maintenance window because services are

stopped and started.

About this task

All data is backed up or restored. You can't selectively back up or restore.

Procedure

To back up:

1. Run one of the following scripts from the <paw_install_location> folder:

Operating system Script to run

Microsoft Windows Start.bat

Linux Start.sh

2. Answer n to the questions about installing Docker images and starting the

administration tool.

3. Enter the following command: ./backup.sh <folder-name> where <folder-name>

is the file path and name of the folder to back up to. If you omit <folder-name>,

a folder with the current time is created in the backup directory.

To restore:


4. Open a command or terminal window and enter the following command:

scripts/restore.sh <folder-name> where <folder-name> is the path and name

of the folder that contains the data to restore.

Upgrading Planning Analytics WorkspaceTo upgrade IBM Planning Analytics Workspace, you install a new version of Planning

Analytics Workspace.

Before you begin

Go to Fix Central (https://www.ibm.com/support/fixcentral/) and download the version

of Planning Analytics Workspace software that you want to upgrade to. Put the

ipa_workspace_local_<version>.zip file in a directory that is separate from your current

installation and extract it.

Important: You must perform this task during a system maintenance window because

services are stopped and started.

Procedure1. Copy the <paw_install_location>/config/paw.env file from your current

installation to the new installation location.

2. Perform 181ページの『Installing Planning Analytics Workspace』. Reply 『y』when you are prompted to install the Docker images. Reply 『y』 when you are

prompted to open the administration tool.

3. In the IBM Planning Analytics Workspace Administration Tool, restart all the

services.

Uninstalling Planning Analytics WorkspaceWhen you uninstall IBM Planning Analytics Workspace, you delete all Docker

containers, Planning Analytics Workspace databases, and all Docker images.

Procedure1. If you are uninstalling from a Microsoft Windows OS, in Oracle VM VirtualBox,

stop the 『paw』 VM and then delete it.

2. If you are uninstalling from a Linux OS, open a terminal window, go to the

directory where you extracted the installation kit, and enter the following

commands:

scripts/paw.sh stopscripts/paw.sh rm -vdocker rm $(docker ps -a -q)docker rmi $(docker images -q)

3. Delete the files in the directory where you extracted the installation kit.

第 13 章 Administer Planning Analytics Workspace 189

https://www.ibm.com/support/fixcentral/

第 14 章 TM1 リッチ層のインストール

TM1 サーバー・インストール・プログラムまたは TM1 クライアント・インストール・プログラムを使用して、TM1 リッチ層コンポーネントをインストールできます。

以下のリッチ層コンポーネントをインストールできます。

v TM1 Architect

v Performance Modeler

v TM1 Perspectives

v Cognos Insight

v Cognos TM1 API

TM1 API を使用して Cognos TM1 データ・ソースに基づく Cognos Analytics によるレポート作成を可能にする方法については、 72ページの『Cognos Analytics のデータ・ソースとしての Cognos TM1』および 72ページの『Cognos TM1 データ・ソースに基づく Cognos Analytics レポート作成を可能にする』を参照してください。

関連概念:

56ページの『Cognos TM1 Architect クライアントと Cognos TM1 Perspectives クライアントのアップグレード』Cognos TM1 サーバーのインストール・プログラムまたは Cognos TM1 クライアントのインストール・プログラムを使って、IBM Cognos TM1 クライアント・コンポーネントをアップグレードすることができます。

Cognos TM1 Perspectives のインストールMicrosoft Excel のアドインである IBM Cognos TM1 Perspectives をインストールできます。

始める前に

IBM Cognos TM1 Perspectives をインストールするには、その前に以下のタスクを完了してください。

1. Cognos TM1 Perspectives 実行のために必要なソフトウェアをインストールします。詳細については、 76ページの『前提ソフトウェアのインストール』を参照してください。

2. 接続先となる Cognos TM1 管理サーバーおよび Cognos TM1 サーバーが、ネットワーク上でアクセス可能なコンピューターで実行されていることを確認します。詳しくは、 85ページの『第 8 章 Cognos TM1 サーバーのインストール』を参照してください。

3. その Cognos TM1 管理サーバーの下での実行で使用する必要がある Cognos

TM1 サーバーへのアクセス権がユーザーに付与されていることを確認します。ユーザーがそのサーバーにアクセスするためには、Cognos TM1 の管理者が各ユーザーのユーザー名とパスワードをセットアップすることが必要です。



以下の手順では、Cognos TM1 Perspectives を単一のコンピューター上にインストールし、ネットワーク上で Cognos TM1 Administration Server を検索するようにそれを設定した後、サーバーに接続します。無人インストールを作成することもできます。

TM1 Perspectives と Microsoft Excel のバージョンは、32 ビットか 64 ビットの一方に統一してください。プラットフォームのバージョンを混在させないでください。例えば、64 ビット・バージョンの Microsoft Excel を使用する場合は、64 ビット・バージョンの TM1 Perspectives を使用してください。

重要: アップグレードする際に、以前の Tm1p.ini クライアント設定ファイルを同じ場所に残す場合、ファイル内の AdminSvrSSLCertAuthority パラメーターのディレクトリー・パスを更新する必要があります。例えば、デフォルトの Cognos TM1

SSL 証明書を使用する場合、このパラメーターの値を新しいインストール・パスC:¥Program Files¥IBM¥cognos¥tm1¥bin¥ssl¥applixca.pem に手動で変更します。

手順1. Cognos TM1 Perspectives をインストールします。

a. Microsoft Windows Vista、Windows 7、または Windows Server 2008 オペレーティング・システム・ソフトウェアでは、issetup.exe ファイルを右クリックし、「管理者として実行」をクリックします。その他のオペレーティング・システムでは、 IBM Cognos TM1 クライアントのインストール・ディスクまたは Cognos TM1 クライアントのインストール・ファイルをダウンロードして解凍した場所にある、 issetup.exe ファイルをダブルクリックします。

b. 「コンポーネントの選択」ページで「TM1 リッチ層」を展開して、「TM1Perspectives」チェック・ボックスを選択します。

その他のチェック・ボックスは、すべて選択解除します。

c. プロンプトに従い、「完了」をクリックしてインストールを完了します。

2. Cognos TM1 Perspectives を実行します。

a. 「スタート」>「IBM Cognos TM1」>「MS Excel 用 Perspectives」をクリックします。このコンポーネントが開始されない場合、Cognos Configuration

で始動したサーバーが依然として実行中であることを確認してください。

b. セキュリティー警告が表示される場合、「マクロを有効にする」をクリックします。

3. Cognos TM1 管理サーバーを検索するよう、Cognos TM1 Perspectives を設定します。

a. Microsoft Excel で「TM1」>「オプション」をクリックします。「TM1 のオプション」ダイアログ・ボックスが開きます。

b. 「管理ホスト」フィールドで、Cognos TM1 管理サーバーが実行されているコンピューターの名前を指定します。異なる管理サーバーに登録された複数のサーバーにアクセスするには、各管理ホストの名前をセミコロンで区切ります。「管理ホスト」フィールドには、IP アドレスではなく名前を入力する必要があります。


c. 「OK」をクリックします。

d. 現在アクセスしているサーバーから切断するかどうかを確認するためのプロンプトが表示された場合、サーバーの新しいリストにアクセスするのであれば「はい」をクリックします。指定された管理ホスト上で管理サーバーにより使用可能なサーバーが表示されます。このセッション中、リモート・サーバーの現在のリストを表示し続ける場合は、「いいえ」をクリックします。

4. サーバー・エクスプローラーを起動します。


Planning Sample または SData では、以下のログオン資格情報を使用します。



ヒント: Microsoft Excel を開始する場合に必ず Cognos TM1 Perspectives を自動的にロードするには、TM1_location/Tm1p.xla を Microsoft Excel のアドイン・ツール・リストに追加します。 32 ビットの Microsoft Excel を使用している場合、デフォルトの位置は C:¥Program Files¥ibm¥cognos¥tm1_64¥bin¥ です。 64

ビットの Microsoft Excel を使用している場合、デフォルトの位置は C:¥Program

Files¥ibm¥cognos¥tm1_64¥bin64¥ です。この手順を完了すると、「TM1」がMicrosoft Excel のメニュー・バーに表示されます。

6. Cognos TM1 Perspectives を複数のコンピューターにインストールするには、前述の手順を使用して無人インストールを作成します。詳しくは、 423ページの『付録 C. 無人インストールおよび設定のセットアップ』を参照してください。

Cognos TM1 Architect のインストールIBM Cognos TM1 Architect は、以下の手順を実行することによりインストールできます。

始める前に

Cognos TM1 Architect をインストールする前に、以下のタスクを完了してください。

v Cognos TM1 Architect 実行のために必要なソフトウェアをインストールします。詳細については、 76ページの『前提ソフトウェアのインストール』を参照してください。

v 接続先となる Cognos TM1 管理サーバーおよび Cognos TM1 サーバーが、ネットワーク上でアクセス可能なコンピューターで実行されていることを確認します。詳しくは、 85ページの『第 8 章 Cognos TM1 サーバーのインストール』を参照してください。

v その Cognos TM1 管理サーバーの下での実行で使用する必要がある Cognos TM1

サーバーへのアクセス権がユーザーに付与されていることを確認します。ユーザーがそのサーバーにアクセスするためには、Cognos TM1 の管理者が各ユーザーのユーザー名とパスワードをセットアップすることが必要です。

第 14 章 TM1 リッチ層のインストール 193


IBM Cognos TM1 Architect を、ネットワーク上の Cognos TM1 Administration

Server を見つけてサーバーに接続するように設定できます。無人インストールを作成することもできます。

重要: アップグレードする際に、以前の Tm1p.ini クライアント設定ファイルを同じ場所に残す場合、ファイル内の AdminSvrSSLCertAuthority パラメーターのディレクトリー・パスを更新する必要があります。例えば、デフォルトの Cognos TM1

SSL 証明書を使用する場合、このパラメーターの値を新しいインストール・パスC:¥Program Files¥IBM¥cognos¥tm1¥bin¥ssl¥applixca.pem に手動で変更します。

手順1. Cognos TM1 Architect をインストールします。

a. Microsoft Windows Vista、Windows 7、または Windows Server 2008 オペレーティング・システム・ソフトウェアでは、issetup.exe ファイルを右クリックし、「管理者として実行」をクリックします。その他のオペレーティング・システムでは、 IBM Cognos TM1 クライアントのインストール・ディスクまたは IBM Cognos TM1 クライアントのインストール・ファイルをダウンロードして解凍した場所にある、issetup.exe ファイルをダブルクリックします。

b. 「コンポーネントの選択」ページで「TM1 リッチ層」を展開して、「TM1Architect」チェック・ボックスを選択します。その他のチェック・ボックスは、すべて選択解除します。

c. プロンプトに従い、「完了」をクリックしてインストールを完了します。

2. Cognos TM1 Architect を実行します。

a. 「スタート」>「IBM Cognos TM1」>「Architect」をクリックします。このコンポーネントが開始されない場合、Cognos Configuration で始動したサーバーが依然として実行中であることを確認してください。

3. Cognos TM1 管理サーバーを検索するよう、Cognos TM1 Architect を設定します。

a. サーバー・エクスプローラーを開きます。

b. 「TM1」を選択します。

c. 「ファイル」>「TM1 のオプション」をクリックします。

d. 「管理ホスト」フィールドで、TM1 管理サーバーが実行されているコンピューターの名前を指定します。「管理ホスト」フィールドには、IP アドレスではなく名前を入力する必要があります。

ヒント: 異なる管理サーバーに登録された複数のサーバーにアクセスするには、各管理ホストの名前をセミコロンで区切ります。

e. 「OK」をクリックします。

f. 現在アクセスしているサーバーから切断するかどうかを確認するためのプロンプトが表示された場合、サーバーの新しいリストにアクセスするのであれば「はい」をクリックします。指定された管理ホスト上で管理サーバーに


より使用可能なサーバーが表示されます。このセッション中、リモート・サーバーの現在のリストを表示し続ける場合は、「いいえ」をクリックします。


Planning Sample または SData では、以下のログオン資格情報を使用します。



5. Cognos TM1 Architect を複数のコンピューターにインストールするには、前述の手順を使用して無人インストールを作成します。詳しくは、 423ページの『付録 C. 無人インストールおよび設定のセットアップ』を参照してください。

Cognos TM1 Performance Modeler のインストール複数のコンピューター間で IBM Cognos TM1 Performance Modeler を分散してインストールするためのいくつかの方法があります。

次の表に、Cognos TM1 Performance Modeler を複数のコンピューターに分散してインストールするためのいくつかの方法を要約します。

表 18. Cognos TM1 Performance Modeler を複数のコンピューターにインストールする場合のオプション

インストール・オプション説明

196ページの『インストール・プログラムによる Cognos TM1

Performance Modeler のインストール』

管理者またはエンド・ユーザーは、IBM Cognos TM1

Client のみのインストール・プログラムを使って、1 台のコンピューターに Cognos TM1 Performance Modeler をインストールできます。

オプションで、このステップを使って無人インストールを作成して、Cognos TM1 Performance Modeler を複数のコンピューターにインストールすることもできます。

196ページの『Cognos TM1

Applications ポータルからのCognos TM1 Performance

Modeler のインストール』

前提条件として、管理者が Planning Analytics Applications

をインストールしておく必要があります。

そのようにしておけば、Planning Analytics ユーザーは、IBM Cognos Applications Portal から Cognos TM1

Performance Modeler を初めて起動するときにこれをコンピューターにインストールすることができます。これをプロビジョン・インストールといいます。

ワークスペースの発行について詳しくは、「IBM Cognos

TM1 Performance Modeler」を参照してください。

197ページの『複数コンピューターでの Cognos TM1

Performance Modeler のリモート・インストール』

管理者は、サード・パーティーのネットワーク・インストール・ツールを使用して、複数のリモート・クライアント・システムに対して Cognos TM1 Performance Modeler

のプッシュ・インストールを実行することができます。


インストール・プログラムによる Cognos TM1 PerformanceModeler のインストール

スタンドアロン・バージョンの IBM Cognos TM1 Performance Modeler を 1 つ以上のコンピューター上に対話式にインストールできます。

手順1. インストール・プログラムを実行します。


v その他のオペレーティング・システムでは、 IBM Cognos TM1 クライアントのインストール・ディスクまたは IBM Cognos TM1 クライアントのインストール・ファイルをダウンロードして解凍した場所にある、issetup.exe ファイルをダブルクリックします。

2. 「コンポーネントの選択」ページで「TM1 リッチ層」を展開して、「Performance Modeler」チェック・ボックスを選択します。その他のチェック・ボックスは、すべて選択解除します。


4. インストールをテストするには、Cognos TM1 Applications ポータル・ページのツールバーから Cognos TM1 Performance Modeler を開きます。

a. Web ブラウザーに、Cognos TM1 Applications の URI を入力します。

例: http://localhost:9510/pmpsvc

v localhost を、Cognos TM1 アプリケーション・サーバーがインストールされているコンピューターの名前に置き換えます。

v IBM Cognos Configuration において、「TM1 アプリケーション・サーバー・ゲートウェイ URI」プロパティーに異なる値を使用した場合、必要に応じてポート番号を変更します。

b. Cognos TM1 Applications ポータルで、「Performance Modeler を開く」アイコンをクリックします。

5. プログラムを複数のコンピューターにインストールするには、前述の手順を使用して無人インストールを作成します。詳しくは、 423ページの『付録 C. 無人インストールおよび設定のセットアップ』を参照してください。

Cognos TM1 Applications ポータルからの Cognos TM1Performance Modeler のインストール

IBM Cognos TM1 Performance Modeler は、 IBM Cognos TM1 Applications ポータルからこのコンポーネントを初めて実行する時点でインストールすることが可能です。

始める前に

Cognos TM1 Applications ポータルから Cognos TM1 Performance Modeler をインストールするには、その前に、管理者が Cognos TM1 Applications をインストールする必要があります。


手順1. Web ブラウザーで、以下の Cognos TM1 Applications ポータルの URI を入力します。


a. localhost を、Cognos TM1 アプリケーション・サーバーがインストールされているコンピューターの名前に置き換えます。

b. IBM Cognos Configuration において、「TM1 アプリケーション・サーバー・ゲートウェイ URI」プロパティーに異なる値を使用した場合、必要に応じてポート番号を変更します。

2. Cognos TM1 Applications ポータルで、「Performance Modeler を開く」アイコンをクリックします。

Cognos TM1 Performance Modeler を初めて使用する場合、「今すぐインストール」アイコンが表示され、Cognos TM1 Performance Modeler クライアントがコンピューターにインストールされることが示されます。

3. 「今すぐインストール」をクリックします。

4. 「完了」をクリックして、インストールを完了します。

次のタスク

IBM Cognos TM1 Performance Modeler の使用について詳しくは、「TM1

Performance Modeler」の資料を参照してください。

複数コンピューターでの Cognos TM1 Performance Modeler のリモート・インストール

管理者は、IBM Cognos TM1 Performance Modeler インストールを自動的にユーザーにプッシュすることができます。まず、Cognos TM1 Performance Modeler インストーラー・ファイルを、ネットワーク上の共有フォルダーに入れて使用可能な状態にします。そのようにすると、Microsoft Active Directory などのアプリケーションを使用して、認証済みユーザーに対してクライアント・アプリケーションを自動的にインストールすることができます。


Cognos TM1 Performance Modeler は、共有フォルダーに入れたインストーラー・ファイルを使用することによりインストールされます。 Active Directory を使用することにより、Cognos TM1 Performance Modeler を直接ユーザーのコンピューターにインストールできます。

PerformanceModeler.msi ファイルを使用して、Cognos TM1 Performance Modeler

をインストールします。このファイルは、Cognos TM1 アプリケーション・ゲートウェイ・コンポーネントのインストール時に、以下の場所にインストールされます。

TM1 の場所¥webapps¥pmpsvc¥rcp_installs


リモート・コンピューターへのプッシュ・インストールを実行するには、Windows

Installer のコマンド行オプションで PerformanceModeler.msi ファイルを使用したり、Active Directory やその他のソフトウェア管理ツールを使用したりすることができます。

PerformanceModeler.msi ファイルは、Microsoft Windows インストーラーの標準的なファイルです。リモート・コンピューターへのプッシュ・インストールを実行するには、Windows Installer のコマンド行オプションで PerformanceModeler.msi ファイルを使用したり、Active Directory やその他のソフトウェア管理ツールを使用したりすることができます。

以下の表に、PerformanceModeler.msi ファイルのインストールにおいて管理者が使用できるプロパティー値の一部を示します。詳細については、Microsoft 開発者用Web サイトで、「Windows Installer Guide」および「Windows Installer Property

Reference」の資料を参照してください。

表 19. Cognos TM1 Performance Modeler のプロパティー値

プロパティープロパティー値説明

ALLUSERS 1 全ユーザーを対象として Cognos TM1

Performance Modeler をインストールします。

このプロパティー値により、Cognos TM1

Performance Modeler のレジストリー項目がHKEY_LOCAL_MACHINE に配置されることになります。注: このプロパティーは、TARGETDIR プロパティーと共に使用する必要があります。

ALLUSERS "" (デフォルト値) インストールを実行しているユーザーのみを対象として Cognos TM1 Performance

Modeler をインストールします。そのユーザーのみ、アプリケーションにアクセスできます。

TARGETDIR "Performance

Modeler_install

location"

Cognos TM1 Performance Modeler のインストールの場所を指定します。

例: TARGETDIR="C:\Program Files"


表 19. Cognos TM1 Performance Modeler のプロパティー値 (続き)


TARGETDIR "" (デフォルト値) TARGETDIR を指定せずに ALLUSERS を指定した場合、Cognos TM1 Performance Modeler

のインストール場所は次のように設定されます。

ALLUSERS="" と共に使用した場合:

v Windows XP では、インストール場所はC:¥Documents and

Settings¥username¥Application

Data¥IBM¥Cognos TM1 Performance

Modeler になります。

v Windows 7 では、インストール場所はC:¥Users¥username¥AppData¥Roaming¥

IBM¥Cognos TM1 Performance Modeler になります。

ALLUSERS=1 と共に使用した場合:

v Windows XP では、インストール場所はC:¥Documents and Settings¥All

Users¥Application Data¥IBM¥Cognos TM1

Performance Modeler になります。

v Windows 7 では、インストール場所はC:¥Program Data¥IBM¥Cognos TM1

Performance Modeler になります。

NOUPDATE あり Cognos TM1 Performance Modeler のユーザーが自動更新を受け取らないようにします。

アプリケーションのインストール先への書き込みアクセス権がエンド・ユーザーに付与されていない場合、この値が推奨されます。自動更新が実行されるためには、Cognos TM1

Performance Modeler のユーザーが、TARGETDIR プロパティーによって指定される場所、またはデフォルトの場所に書き込むことが可能であることが必要です。

NOUPDATE No (デフォルト値) Cognos TM1 Performance Modeler のユーザーが自動更新を受け取ることができるようにします。

以下の手順に例を示します。

手順1. コマンド・プロンプトを開き、PerformanceModeler.msi ファイルのある場所に移動します。

2. すべてのユーザーのために Cognos TM1 Performance Modeler をインストールするには、以下のコマンドを入力します。

PerformanceModeler.msi TARGETDIR="install_location" ALLUSERS=1


Cognos TM1 Performance Modeler のログ記録の設定IBM Cognos TM1 Performance Modeler のログ記録を、 IBM Cognos TM1 内の他のコンポーネントと同じログ記録フレームワークを使用して有効にすることができます。

手順1. provagent_NOT.ini を見つけて、そのファイルを provagent.ini に名前変更します。

このファイルは以下の場所にあります。

C:¥Users¥<user_name>¥AppData¥Roaming¥IBM¥Cognos Performance Modeler

2. provagent.ini を編集して、以下の行のコメントを外します。

#app-debug=true を app-debug=true に変更します。

3. この同じディレクトリーの場所で、defaultLog.properties ファイルを開いて編集し、ログ記録を設定します。

注: ログ記録は、日常用に ERROR レベルのメッセージを記録するようにデフォルトで設定されているので、通常は調整する必要はありません。この設定をWARNING、INFO、または DEBUG レベルのメッセージに変更することで、さまざまなレベルのログ情報を取得できます。さらに具体的なメッセージを記録するようにログ記録の設定を変更する場合は、IBM カスタマー・サポートに連絡してください。

タスクの結果

ログ・ファイルは、通常は以下の場所に書き出されます。

%appdata%/IBM/application_name/logs

Cognos Insight のインストール複数のコンピューター間で IBM Cognos Insight を分散してインストールするいくつかの方法から選択することができます。

コンピューター・ネットワーク環境やビジネスの必要に応じて、アプリケーションをインストールしたり、必要に応じてユーザーがインストールを行えるようにしたり、リモートへのアプリケーションのプッシュ・インストールを実行したりします。

複数のコンピューター間で IBM Cognos Insight を分散してインストールするいくつかの方法が、次の表にまとめられています。


表 20. Cognos Insight の複数コンピューターへのインストールのオプション

インストール・オプション説明

『インストール・プログラム使用による Cognos Insight のインストール』

管理者またはエンド・ユーザーは、IBM Cognos TM1

クライアントのみのインストール・プログラムを使って、1 台のコンピューターに Cognos Insight をインストールすることができます。

オプションで、このステップを使って無人インストールを作成して、Cognos Insight を複数のコンピューターにインストールすることもできます。

202ページの『Cognos TM1

Applications ポータルからのCognos Insight のインストール』

前提条件として、管理者は Cognos TM1 Applications

をインストールしておく必要があります。

これによって Cognos TM1 ユーザーは、IBM Cognos

TM1 Applications ポータルから Cognos Insight を初めて起動するときに、各自のコンピューターに Cognos

Insight をインストールできます。これをプロビジョン・インストールといいます。

203ページの『複数コンピューターでの Cognos Insight のリモート・インストール』

管理者は、サード・パーティーのネットワーク・インストール・ツールを使用して、複数のリモート・クライアント・システムに対して Cognos Insight のプッシュ・インストールを実行することができます。

インストール・プログラム使用による Cognos Insight のインストール

IBM Cognos Insight のスタンドアロン・バージョンは、1 つ以上のコンピューター上に対話式にインストールすることができます。

手順1. Microsoft Windows Vista、Windows 7、または Windows Server 2008 オペレーティング・システム・ソフトウェアでは、issetup.exe ファイルを右クリックし、「管理者として実行」をクリックします。その他のオペレーティング・システムでは、 IBM Cognos TM1 クライアントのインストール・ディスクまたは IBM

Cognos TM1 クライアントのインストール・ファイルをダウンロードして解凍した場所にある、issetup.exe ファイルをダブルクリックします。

2. 「コンポーネントの選択」ページで「TM1 リッチ層」を展開して、「CognosInsight」チェック・ボックスを選択します。その他のチェック・ボックスは、すべて選択解除します。


4. インストール済み環境をテストするには、「スタート」>「すべてのプログラム」>「IBM Cognos Insight」>「IBM Cognos Insight」から Cognos Insight を開きます。

5. プログラムを複数のコンピューターにインストールするには、前述の手順を使用して無人インストールを作成します。詳しくは、 423ページの『付録 C. 無人インストールおよび設定のセットアップ』を参照してください。


Cognos TM1 Applications ポータルからの Cognos Insight のインストール

IBM Cognos Insight は、IBM Cognos TM1 Applications ポータルのツールバーからこのコンポーネントを初めて実行する時点でインストールすることが可能です。

始める前に

Cognos TM1 Applications から Cognos Insight をインストールするには、その前に、管理者が Cognos TM1 Applications をインストールしておく必要があります。

手順1. Web ブラウザーで、以下の Cognos TM1 Applications ポータルの URI を入力します。


a. localhost を、Cognos TM1 Applications ポータルがインストールされているコンピューターの名前に置き換えます。

b. 必要に応じてポート番号を変更します。これは、IBM Cognos Configuration

で「TM1 アプリケーション・ゲートウェイ URI (TM1 Application GatewayURI)」プロパティーに別の値を使用した場合に必要です。

2. Cognos TM1 Applications ポータルから、「IBM Cognos Insight を開く」アイ

コンをクリックします。

Cognos Insight を初めて使用する場合、「今すぐインストール」アイコンが表示され、Cognos Insight クライアントがコンピューターにインストールされることが示されます。

3. 「今すぐインストール」をクリックします。

4. 「完了」をクリックしてインストールを完了します。

次のタスク

Cognos Insight がコンピューターの 1 つのフォルダーにインストールされます。Cognos Insight を実行および使用するには、以下のようにします。

v Cognos Insight を起動するには、Cognos TM1 Applications の「Cognos Insight を

開く」アイコンを使用します。

v Cognos Insight クライアントを起動するには、Cognos Insight を使用するように設定されているアプリケーションのノードを右クリックします。

クライアントとして Cognos Insight をアプリケーションから使用できるのは、Cognos Insight の分散クライアントまたは接続クライアントを使用するよう、Cognos TM1 Applications のクライアント環境を設定した場合のみです。詳細については、 151ページの『Cognos TM1 Application Web のサーバーおよびクライアント環境の設定』を参照してください。

v Cognos Insight は、Windows の「スタート」>「すべてのプログラム」>「IBMCognos Insight」のメニューからスタンドアロン製品として起動できます。


複数コンピューターでの Cognos Insight のリモート・インストール

管理者は、IBM Cognos Insight インストールを自動的にユーザーにプッシュすることができます。まず、Cognos Insight インストーラー・ファイルを、ネットワーク上の共有フォルダーに入れて使用可能な状態にします。そのようにすると、Microsoft Active Directory などのアプリケーションを使用して、認証済みユーザーに対してクライアント・アプリケーションを直接インストールすることができます。


Cognos Insight は、共有フォルダーに置いた CognosInsight.msi ファイルを使用してインストールします。このファイルは、IBM Cognos TM1 アプリケーション・ゲートウェイ・コンポーネントのインストール時に、以下の場所にインストールされます。

TM1 の場所¥webapps¥pmpsvc¥rcp_installs

CognosInsight.msi ファイルは、Microsoft Windows インストーラーの標準的なファイルです。リモート・コンピューターへのプッシュ・インストールを実行するには、Windows Installer のコマンド行オプションで CognosInsight.msi ファイルを使用したり、Active Directory やその他のソフトウェア管理ツールを使用したりすることができます。

コマンドの形式は、Cognos Insight MSI ファイル名の後にプロパティー値が続く形式です。例えば、CognosInsight.msi TARGETDIR="C:\Program Files"

USERDATADIR=%%USERNAME%% のように入力します。

以下のプロパティー値を、単独で、または相互に組み合わせて使用できます。

表 21. Cognos Insight のプロパティー値


ALLUSERS 1 全ユーザーを対象として Cognos Insight をインストールします。

このプロパティー値を設定すると、デフォルトのインストール場所が C:¥Program Files

に設定されます。

ALLUSERS "" (デフォルト値) インストールを実行しているユーザーのみを対象として Cognos Insight をインストールします。そのユーザーのみ、アプリケーションにアクセスできます。

ALLUSERS="" が設定されたとき、またはALLUSERS プロパティーを省略した場合は、ユーザーのコンテキストに Cognos Insight

がインストールされ、TARGETDIR プロパティーは C:¥Users¥username¥AppData¥Local¥

Programs¥IBM¥Cognos Insight に設定されます。


表 21. Cognos Insight のプロパティー値 (続き)


TARGETDIR "Cognos_Insight_install_location"Cognos Insight のインストールの場所を指定します。

例: TARGETDIR="C:\Program Files"

TARGETDIR (デフォルト値) TARGETDIR を指定せずに ALLUSERS を指定した場合、Cognos Insight のインストール場所は次のように設定されます。

ALLUSERS="" と共に使用した場合:

v Microsoft Windows XP オペレーティング・システムでは、インストール場所はC:¥Documents and

Settings¥username¥Local

Settings¥Application Data¥Programs になります。

v Microsoft Windows 7 オペレーティング・システムでは、インストール場所はC:¥Users¥username¥AppData¥

Local¥Programs になります。

ALLUSERS="1" と共に使用した場合:

v 32 ビット Microsoft Windows オペレーティング・システムでは、インストール場所は C:¥Program Files になります。

v 64 ビット Microsoft Windows オペレーティング・システムでは、インストール場所は C:¥Program Files (x86) になります。

NOUPDATE あり Cognos Insight のユーザーが自動更新を受け取らないようにします。

アプリケーションのインストール先への書き込みアクセス権がユーザーに付与されていない場合、この値が推奨されます。自動更新を利用するためには、Cognos Insight ユーザーが、TARGETDIR プロパティーで指定されたインストール場所に対して書き込みを行える必要があります。

NOUPDATE No (デフォルト値) Cognos Insight のユーザーが自動更新を受け取ることができるようにします。

USERDATADIR "location" .CognosInsight フォルダーの場所を指定します。.CognosInsight フォルダーには、Cognos Insight テーマ、Cognos TM1 サーバーから作業するときにコンピューターにコピーされる IBM Cognos TM1 データ、およびCognos Insight の「ご利用の手引き」ページに表示される最近のワークスペースのサムネール画像が格納されます。


表 21. Cognos Insight のプロパティー値 (続き)


USERDATADIR "" (デフォルト値) USERDATADIR を指定しなかった場合、.CognosInsight フォルダーは次のいずれかの場所に配置されます。

v Microsoft Windows XP オペレーティング・システムの場合: C:¥Documents and

Settings¥username¥.CognosInsight。

v Microsoft Windows 7 オペレーティング・システムの場合:

C:¥Users¥username¥.CognosInsight。

ALLUSERS=1 で USERDATADIR を指定する場合は、ユーザーごとに異なる場所に解決される環境変数を USERDATADIR プロパティーに指定する必要があります。

例えば、コマンドを CognosInsight.msi

ALLUSERS=1 USERDATADIR=^%USERPROFILE^%

とした場合、Cognos Insight は C:¥Program

Files にインストールされ、.CognosInsight

フォルダーは各ユーザーのユーザー・プロファイル・フォルダーにインストールされます。

詳細については、Microsoft 開発者用 Web サイトで、「Microsoft Windows Installer

Guide」および「Microsoft Windows Installer Property Reference」の資料を参照してください。

以下の手順に例を示します。

手順1. コマンド・プロンプトを開き、CognosInsight.msi ファイルのある場所に移動します。

2. すべてのユーザーのために Cognos Insight をインストールするには、以下のコマンドを入力します。

CognosInsight.msi TARGETDIR="install_location" ALLUSERS=1

Cognos Insight のログ記録の設定IBM Cognos Insight のログ記録を、IBM Cognos TM1 内の他のコンポーネントと同じログ記録フレームワークを使用して有効にすることができます。

手順1. provagent_NOT.ini を見つけて、そのファイルを provagent.ini に名前変更します。

このファイルは以下の場所にあります。

C:¥Users¥<user_name>¥AppData¥Local¥Programs¥IBM¥Cognos Insight


2. provagent.ini を編集して、以下の行のコメントを外します。

#app-debug=true を app-debug=true に変更します。

3. この同じディレクトリーの場所で、defaultLog.properties ファイルを開いて編集し、ログ記録を設定します。

注: ログ記録は、日常用に ERROR レベルのメッセージを記録するようにデフォルトで設定されているので、通常は調整する必要はありません。この設定をWARNING、INFO、または DEBUG レベルのメッセージに変更することで、さまざまなレベルのログ情報を取得できます。さらに具体的なメッセージを記録するようにログ記録の設定を変更する場合は、IBM カスタマー・サポートに連絡してください。

タスクの結果

ログ・ファイルは、通常は以下の場所に書き出されます。

%appdata%/IBM/application_name/logs

Cognos TM1 API のインストールTM1 API インストール・オプションを使用して、プログラマーが Cognos TM1 アプリケーション・プログラミング・インターフェース (API) を使用して作業できるようにするための必須ファイルをインストールします。このインストール・オプションを Cognos Analytics サーバーにインストールして、Cognos TM1 のデータ・ソースに基づく Cognos Analytics によるレポート作成を可能にすることもできます。


このオプションは、以下の Cognos TM1 API 用のファイルをインストールします。

TM1 API開発者が TM1 と対話する C、C++、および VB のカスタム・アプリケーションを作成できるようにします。

TM1 Java API開発者が TM1 と対話する Java のカスタム・アプリケーションを作成できるようにします。

TM1 .NET API開発者が TM1 と対話する Microsoft .NET のカスタム・アプリケーションを作成できるようにします。

重要: TM1 API を使用して Cognos TM1 データ・ソースに基づく Cognos

Analytics によるレポート作成を可能にする方法については、 72ページの『Cognos

Analytics のデータ・ソースとしての Cognos TM1』を参照してください。

手順1. 以下のようにして、IBM Planning Analytics のフルインストール・プログラムまたはクライアント専用インストール・プログラムを実行します。



v その他の Windows オペレーティング・システムでは、issetup.exe ファイルをダブルクリックします。

2. 「インストール先」ページで、インストールの場所を次のように選択します。

v プログラミング用に TM1 API を使用する計画の場合、デフォルトのインストールを受け入れます。

v TM1 API を使用して、Cognos TM1 データ・ソースに基づく Cognos

Analytics によるレポート作成を可能にする場合は、 Microsoft Windows でReport サービスを実行する Cognos Analytics サーバーの隣接ディレクトリーを選択します。

3. 「コンポーネントの選択」ページで、以下のようにします。

a. 「TM1 クライアント層」を展開して、「TM1 API」オプションを選択します。

b. 他のすべてのコンポーネントのチェック・ボックスをオフにします。


Cognos TM1 のデータを PDF 形式でエクスポートするようにクライアント・コンピューターを設定する

Microsoft Windows で実行中の IBM Cognos TM1 クライアント・アプリケーションから IBM Cognos TM1 データを Adobe PDF 形式でエクスポートするには、デフォルト・プリンターに PDFCamp を設定します。以下の手順は、IBM Cognos TM1

Perspectives、 IBM Cognos TM1 Architect、および IBM Cognos TM1 Web に適用されます。

始める前に

Windows の「プリンターと FAX」設定の中に「PDFCamp Printer Driver」が存在することを確認することにより、PDFCamp が正しくインストールされていることを検証します。

手順1. Windows で、「プリンターと FAX」設定ウィンドウを開きます。

2. 「PDFCamp Printer Driver」を右クリックし、「通常使うプリンターに設定」を選択します。


第 15 章 IBM Planning Analytics for Microsoft Excel のインストールと設定

IBM Planning Analytics for Microsoft Excel は、Microsoft Excel ベースのツールです。プロフェッショナルなレポートの作成者は、このツールを使用して、複数のシートを含み複数のデータベースに対して複数のクエリーを実行する、洗練されたレポートを作成できます。

ユーザーはさまざまな種類のデータ・ソースから Excel で複数シート、複数クエリーの高度なレポートを作成でき、IBM Cognos のディメンションでモデル化されたデータを分析および探索することができます。ユーザーが業務上の問題を解決し、重要な結果を最も効果的な形式で提示できるように、このアプリケーションは数式ベースのデータ・アクセスを提供します。

IBM Cognos TM1 では、このアプリケーションは、ビジネスおよび運用データの計画と測定を行う財務アナリストおよびプランナーによって使用されます。

新機能このセクションでは、このリリースの新機能および変更された機能について説明します。この情報は、アップグレードやアプリケーションのデプロイメント戦略、およびユーザー向けの研修要件の計画を作成する上で役立ちます。

バージョン 2.0.0 の新機能前回のリリース以降の新機能をこのセクションにまとめています。

v IBM Planning Analytics for Microsoft Excel を使用するには、Microsoft .NET

Framework 4.6.1 以降をインストールしておく必要があります。

v IBM Planning Analytics for Microsoft Excel は、セキュリティー認証モード1、2、3、4、5 をサポートします。旧バージョンは、1 と 5 のモードをサポートしていました。

ただし、IBM Planning Analytics Workspace に接続する場合は、1 と 5 のセキュリティー認証モードしか使用できません。

フォーム・ベースの認証は、IBM Planning Analytics for Microsoft Excel の IBM

Planning Analytics サーバーではサポートされなくなりました。

バージョン 10.3.0 の新機能このセクションで後述する情報では、前回のリリース以降の新機能を示しています。

v サーバーがトランスポート層セキュリティー (TLS) を使用する場合は、Microsoft

.NET Framework 4.5 以降とともに IBM Cognos Analysis for Microsoft Excel を使用する必要があります。新しいサーバー、および SSL の POODLE セキュリティー脆弱性に対処するためのパッチを適用済みのサーバーは、TLS を使用します。


バージョン 10.2.0 の新機能このセクションで後述する情報では、前回のリリース以降の新機能を示しています。直接関連するトピックへのリンクが用意されています。

v 今後 IBM Cognos Office 製品、例えば IBM Cognos Analysis for Microsoft Excel

および IBM Cognos BI for Microsoft Office などを使用するには、Microsoft

.NET Framework 4 を使用する必要があります。

この更新された規格適合は、アップグレード済みのシステムに影響します。現在IBM Cognos Office 製品を使用しており、Microsoft .NET Framework 2 のみがインストールされている場合、.NET Framework 4 もインストールする必要があります。IBM Cognos Office 製品をインストールする前に更新 .NET Framework をインストールする必要があります。Microsoft .NET Framework の異なるバージョンは共存可能です。以前のバージョンをアンインストールする必要はありません。

v 追加の言語サポート

IBM Cognos Office 製品で次の追加言語が使用可能です: クロアチア語、デンマーク語、カザフ語、スロベニア語、およびタイ語。

バージョン 10.1.1 の新機能このセクションで後述する情報では、前回のリリース以降の新機能を示しています。直接関連するトピックへのリンクが用意されています。

サポートされている環境およびプラットフォームへの機能拡張機能拡張は、マルチプラットフォームと環境に対するサポートを拡張するために行われました。

64 ビット・インストールのサポート

IBM Planning Analytics for Microsoft Excel は、64 ビットの環境に対応しています。 64 ビット環境では、メモリー管理が改良され、スケーラビリティーとパフォーマンスが向上しました。インストールして実行するバージョンとして、IBM

Planning Analytics for Microsoft Excel の 32 ビット・バージョンと 64 ビット・バージョンのどちらかを選択できるようになりました。IBM Cognos アプリケーションは、64 ビット・オペレーティング・システムでは、Excel の 32 ビットおよび 64

ビット Microsoft Office バージョンで実行することができます。

64 ビットのインストールを実行する場合、インストールに使用されるデフォルトのパスは、32 ビット・インストールで使用されるデフォルトのパスとは異なります。以下に、デフォルトのインストール・ディレクトリーを示します。

v 32 ビット・インストールの場合 - C:¥Program Files¥IBM¥cognos¥Cognos for

Microsoft Office

v 64 ビット OS での 64 ビット・インストールの場合 - C:¥Program

Files¥IBM¥cognos¥Cognos for Microsoft Office

v 64 ビット OS での 32 ビット・インストールの場合 - C:¥Program

Files(X86)¥IBM¥cognos¥Cognos for Microsoft Office


Microsoft Office 2010 のサポート

IBM Planning Analytics for Microsoft Excel は、Microsoft Excel ソフトウェアのバージョン 2010 に対応しています。

新しい Office Open XML 形式が、ECMA インターナショナルでサポートされる業界標準として認識されるようになったため、新しい形式 (Microsoft Office 2010 でサポートされる) を使用すると、マルチプラットフォームでの実装を可能にすることによって、拡張性と相互運用性が高まります。

Mozilla Firefox のサポート

IBM Planning Analytics for Microsoft Excel は、Mozilla Firefox Web ブラウザーのバージョン 4 に対応しています。

Internet Explorer のサポート

IBM Planning Analytics for Microsoft Excel は、Microsoft Internet Explorer Web ブラウザーのバージョン 9 に対応しています。

追加の言語サポートIBM Cognos Analysis for Microsoft Excel でノルウェー語がサポートされるようになりました。

インストールの概要IBM Planning Analytics for Microsoft Excel を使用するには、Microsoft .NET

Framework と IBM Planning Analytics for Microsoft Excel のコンポーネントをインストールしなければなりません。

IBM Cognos TM1 には、IBM Planning Analytics for Microsoft Excel で使用できるサンプルが含まれています。これらのサンプルは、架空のデータを使用して、製品の機能、技術、ビジネスに関するベスト・プラクティスを例示しています。また、これらのサンプルを使用すると、レポートのデザイン方法を試したり共有したりできるほか、トラブルシューティングを行うこともできます。サンプルを使用するには、管理者によるサンプルのセットアップと構成が必要になります。サンプルがインストールされている場所について、管理者にお問い合わせください。

旧バージョンの IBM Planning Analytics for Microsoft Excel をアンインストールしてから、新バージョンをインストールします。

手順1. 前提条件タスクを実行します。

a. Microsoft .NET Framework をインストールします。

詳しくは、Microsoft .NET Framework のインストールを参照してください。

b. Primary Interop Assemblies をインストールします。

詳しくは、Primary Interop Assemblies のインストールを参照してください。

第 15 章 IBM Planning Analytics for Microsoft Excel のインストールと設定 211

c. 旧バージョンの IBM Planning Analytics for Microsoft Excel をアンインストールします。

詳細については、 215ページの『旧バージョンの IBM Cognos for Microsoft

Excel のアンインストール』を参照してください。

d. 215ページの『IBM Planning Analytics Workspace Local への接続』.

e. アンチウィルス・ソフトウェアの設定で Microsoft .NET Runtime とMicrosoft Excel からの接続を許可します。

f. 216ページの『IBM ID の使用』.

2. IBM Planning Analytics for Microsoft Excel コンポーネントをインストールします。

詳しくは、IBM Cognos Analysis for Microsoft Excel コンポーネントのインストールを参照してください。

3. IBM Planning Analytics for Microsoft Excel をテストします。

詳しくは、IBM Cognos Analysis for Microsoft Excel のテストを参照してください。

Planning Analytics for Microsoft Excel をインストールするための前提条件

Planning Analytics for Microsoft Excel をインストールする前に、このセクションのタスクを完了する必要があります。

Microsoft .NET Framework のインストールIBM Planning Analytics for Microsoft Excel を使用するには、すべてのユーザー・コンピューターに Microsoft .NET Framework バージョン 4.6.1 以降をインストールしておく必要があります。

サポートされる Microsoft .NET Framework のバージョンの一覧については、IBM

Software Product Compatibility Reports (http://www.ibm.com/software/reports/

compatibility/clarity/index.jsp) を参照してください。

英語以外のオペレーティング・システムに Microsoft .NET Framework をインストールすると、Microsoft .NET のエラー・メッセージ、ショートカット、およびユーティリティーが英語で表示されます。

英語以外の言語では、Microsoft .NET Framework Language Pack を適用すると、エラー・メッセージ、ショートカット、ユーティリティーがオペレーティング・システムの言語で表示されます。例えばフランス語のオペレーティング・システムにMicrosoft .NET Framework をインストールした場合、Microsoft .NET Language Pack

(フランス語) も適用する必要があります。

手順1. Microsoft ダウンロード Web サイトに移動します。

2. .NET Framework 4.6.1 以降を検索し、再配布可能パッケージを選択して、説明に従ってダウンロードします。


http://www.ibm.com/software/reports/compatibility/clarity/index.jsp

http://www.ibm.com/software/reports/compatibility/clarity/index.jsp

3. この .NET Framework バージョンに関連した他のセキュリティー・アップデートがあるかどうか確認して、ダウンロードします。

Microsoft Excel 用 Primary Interop Assemblies (PIA)IBM Planning Analytics for Microsoft Excel の機能を使用するには、Excel 用のPrimary Interop Assemblies (PIA) をインストールしておく必要があります。通常は、Microsoft Office をコンピューターにインストールするときに PIA も自動的にインストールされます。ただし PIA を別途インストールする必要が生じることもあります。

.NET Framework をターゲットとする Office ソリューションを実行するには、コンピューター・ワークステーションのグローバル・アセンブリー・キャッシュ内にPIA をインストールして登録しておく必要があります。

PIA の完全なセットをグローバル・アセンブリー・キャッシュにインストールするには、次の 2 つの方法があります。

v Microsoft Office のセットアップを変更する。

Office システムをインストールする前に .NET Framework をインストールしなかった場合、Office インストール時に PIA は一緒にインストールされません。Office システムのインストール後に .NET Framework をインストールした場合、Office のセットアップを変更することで PIA をインストールできます。

v 再配布可能な PIA パッケージからインストールする。

Microsoft Office PIA は、グローバル・アセンブリー・キャッシュ内(drive:/WINDOWS/assembly または drive:/WINNT/assembly) にインストールされます。

Excel 用 Primary Interop Assemblies をインストールするようMicrosoft Office セットアップを変更するIBM Planning Analytics for Microsoft Excel の機能を使用するには、Excel 用のPrimary Interop Assemblies (PIA) をインストールしておく必要があります。通常は、Microsoft Office をコンピューターにインストールするときに PIA も自動的にインストールされます。ただし PIA を別途インストールする必要が生じることもあります。

.NET Framework 4.5.1 以降をターゲットとする Office ソリューションを実行するには、コンピューター・ワークステーションのグローバル・アセンブリー・キャッシュ内に PIA をインストールして登録しておく必要があります。

Office システムをインストールする前に .NET Framework をインストールしなかった場合、Office インストール時に PIA は一緒にインストールされません。 Office

システムのインストール後に .NET Framework をインストールした場合、Office のセットアップを変更することで PIA をインストールできます。



始める前に

.NET Framework および Microsoft Office PIA をインストールするには、そのコンピューターの管理者でなければなりません。

手順1. 「スタート」メニューから「コントロールパネル」をクリックし、「プログラムと機能」をクリックします。

2. プログラムの一覧から Microsoft Office バージョンをクリックして、「変更」をクリックします。

3. Microsoft Office セットアップ・ウィザードで「機能の追加/削除」を選択し、「次へ」をクリックします。

4. 「インストールオプション」ページで、「Microsoft Excel」を展開します。

5. 「.Net Programmability Support」機能の横の記号をクリックして、「マイコンピュータから実行」をクリックします。


7. 「閉じる」をクリックします。

Microsoft Excel 用 PIA のインストールIBM Planning Analytics for Microsoft Excel の機能を使用するには、Excel 用のPrimary Interop Assemblies (PIA) をインストールしておく必要があります。通常は、Microsoft Office をコンピューターにインストールするときに PIA も自動的にインストールされます。ただし PIA を別途インストールする必要が生じることもあります。Office システムをインストールする前に .NET Framework をインストールしなかった場合、Office インストール時に PIA は一緒にインストールされません。再頒布可能な PIA パッケージからこれらをインストールすることができます。

.NET Framework 4.5 以降をターゲットとする Office ソリューションを実行するには、コンピューター・ワークステーションのグローバル・アセンブリー・キャッシュ内に PIA をインストールして登録しておく必要があります。


始める前に

.NET Framework および Microsoft Office PIA をインストールするには、そのコンピューターの管理者でなければなりません。

手順1. .NET Framework がインストールされていることを確認してください。詳細については、 212ページの『Microsoft .NET Framework のインストール』を参照してください。

2. Microsoft ダウンロード Web サイトに移動します。

3. ダウンロード・ページの指示に従って Primary Interop Assemblies をインストールします。


旧バージョンの IBM Cognos for Microsoft Excel のアンインストール

旧バージョンの IBM Planning Analytics for Microsoft Excel は、IBM Cognos for

Microsoft Office という名称でした。旧バージョンの IBM Cognos for Microsoft

Office がある場合は、旧バージョンをアンインストールしてから新バージョンのIBM Planning Analytics for Microsoft Excel をインストールする必要があります。

アンインストールを実行する場合、すべてのアプリケーション・ファイルとディレクトリーがアンインストール・プロセスで完全に削除されるとは限りません。このため、その操作を手動で行う必要が生じることがあります。

同じ場所に複数のコンポーネントをインストールした場合、アンインストール・ウィザードを使用して、アンインストール対象のパッケージを選択できます。パッケージ内のすべてのコンポーネントがアンインストールされます。

始める前に

アンインストールする前に、すべての Microsoft Office アプリケーションを閉じます。

手順1. 「スタート」メニューから、「プログラム」、「IBM Cognos for Microsoft

Office」、「IBM Cognos のアンインストール (Uninstall IBM Cognos)」、「IBM Cognos のアンインストール (Uninstall IBM Cognos)」の順にクリックします。

アンインストール・ウィザードが表示されます。

ヒント: 旧バージョンのインストール時に作成されたプログラム・フォルダーのデフォルト名は IBM Cognos for Microsoft Office です。別の名前を選択した場合、そのフォルダーに移動してプログラムを見つけてください。

2. 指示に従ってコンポーネントをアンインストールします。

ファイルのアンインストール時にアンインストール・ウィザードによって実行された処理は、cognos_uninst_log.txt ファイルに記録されます。

ヒント: ログ・ファイルを見つけるには Temp ディレクトリーを調べてください。

IBM Planning Analytics Workspace Local への接続Planning Analytics ユーザーは、Planning Analytics for Microsoft Excel を実行する前に、使用環境にインストールされている Planning Analytics Workspace Local のインスタンスに接続する必要があります。

注: ユーザーが自分のコンピューターに Planning Analytics Workspace Local をインストールする必要はありません。Planning Analytics Workspace Local の 1 つのインストール済み環境に接続さえすれば、セット・エディターやキューブ・ビューアーを使用できます。


詳細については、 179ページの『第 12 章 Planning Analytics Workspace

installation』を参照してください。

TM1 REST API の接続のセットアップIBM Planning Analytics for Microsoft Excel では、TM1 REST API を使用する必要があります。IBM TM1 サーバーにあるそれらの API を使用できるように、管理者が各 IBM TM1 サーバーの TM1 サーバー構成ファイルに HTTP ポート番号を設定しなければならないことがあります。

始める前に

IBM TM1 サーバーの作成時に、HTTP ポート番号がデフォルトで設定されないことがあります。このタスクでは、各 IBM TM1 サーバーの構成ファイルを編集して、HTTP ポート番号を設定する必要があります。構成ファイルにアクセスできない場合は、管理者に連絡してください。

手順1. TM1 サーバーを停止します。

2. tm1s.cfg ファイルを見つけます。ファイルの場所は、使用しているサーバーのタイプによって異なります。

3. エディターで tm1s.cfg ファイルを開きます。

4. HTTPPortNumber = XXXX という内容が含まれている行を見つけます。

5. XXXX を、現在使用されていない有効なポート番号に置き換えます。

6. tm1s.cfg ファイルを保存します。

7. TM1 IBM サーバーを再始動します。

タスクの結果

IBM Planning Analytics for Microsoft Excel が TM1 REST API によって TM1 サーバーのデータにアクセスできるようになります。

アンチウィルス・ソフトウェアの設定Planning Analytics for Microsoft Excel を実行するには、まずアンチウィルス・ソフトウェアの設定で Microsoft .NET Runtime と Microsoft Excel からの接続を両方とも許可する必要があります。

アンチウィルス・ソフトウェアの設定でこの 2 つの接続を許可しないと、 227ページの『COI-ERR-2019 接続が失敗しました』で説明しているエラー・メッセージが表示されることがあります。

IBM ID の使用Planning Analytics for Microsoft Excel を使用するには、IBM ID を入力して認証を受ける必要があります。

ヒント: IBM ID を登録するには、IBM ID の登録ページ (https://ibm.biz/BdHtLT)

にアクセスしてください。


https://ibm.biz/BdHtLT

インストール・タスクこのセクションのタスクを実行して、Planning Analytics for Microsoft Excel をインストールしてください。

IBM Planning Analytics for Microsoft Excel のインストールIBM Planning Analytics for Microsoft Excel をインストールするには、インストール・プログラムをダウンロードして実行する必要があります。

IBM Cognos TM1 には、Planning Analytics for Microsoft Excel で使用できるサンプル・データが含まれています。サンプルを使用するには、IBM Cognos 管理者がIBM Cognos システム上にサンプルをインストールする必要があります。

始める前に

Planning Analytics for Microsoft Excel には、32 ビットのインストールと 64 ビットのインストールがあります。Microsoft Office が 32 ビット版か 64 ビット版かに応じて、対応する製品をインストールしなければなりません。

コンポーネントの更新とインストールを行う前に、以下の要件を満たしていることを確認してください。

v そのコンピューターに対する管理権限を持っている。

v Microsoft .NET Framework 4.6.1 以降がインストールされている。

v 旧バージョンの IBM Planning Analytics for Microsoft Excel がアンインストールされている。

v IBM Cognos for Microsoft Office 製品を使用するための適切なライセンスがある。

v アンチウィルス・ソフトウェアの設定で以下の 2 つのアプリケーションからの接続が許可されている (ブロックされていない)。

– Microsoft .NET Runtime

– Microsoft Excel

手順1. すべての Microsoft Excel ウィンドウを閉じます。

2. インストール・プログラムをダウンロードして解凍します。

3. 32 ビット版の Microsoft Office がインストールされている場合は、win32 フォルダーに移動します。64 ビット版の Microsoft Office がインストールされている場合は、winx64h フォルダーに移動します。

4. issetup.exe ファイルを右クリックし、「管理者として実行」を選択します。新しいウィンドウに「ようこそ」ページが表示されます。

5. インストールで使用する言語を選択します。

ここで選択した言語によって、インストールのユーザー・インターフェースの言語が決まります。製品のユーザー・インターフェースの言語は、Microsoft

Windows の表示言語/1 次言語の設定で決まります。

6. 「コンポーネントの選択」ページで Planning Analytics for Microsoft Excel を選択します。


7. インストール・ウィザードの指示に従って、必要なファイルをコンピューターにコピーします。

IBM Planning Analytics for Microsoft Excel のテストアプリケーションを起動することにより、クライアント・コンポーネントのインストールを検査することができます。

手順1. Microsoft Excel を起動するか、Microsoft Excel スプレッドシートを開きます。

2. リボンに IBM Planning Analytics が表示されることを確認します。

リボンに IBM Planning Analytics タブが表示されない場合は、 220ページの『Microsoft Office で Cognos Office インターフェースを初期化できない』を参照してください。

3. IBM Planning Analytics タブをクリックし、「タスク・ウィンドウ」をクリックします。 IBM ウィンドウが表示されます。

ヒント: 以下のメッセージが表示されることもありますが、無視してかまいません。

カスタム・レポートを使用するために登録を完了するには、Microsoft Excel を再起動する必要があります。

次のタスク

IBM Planning Analytics for Microsoft Excel の使用を開始するために、IBM Planning

Analytics サーバーへの接続を設定する必要があります。「IBM Planning Analytics

for Microsoft Excel User Guide」を参照してください。

IBM Planning Analytics for Microsoft Excel のアンインストール

現行バージョンの IBM Planning Analytics for Microsoft Excel をアンインストールします。

アンインストールを実行する場合、すべてのアプリケーション・ファイルとディレクトリーがアンインストール・プロセスで完全に削除されるとは限りません。このため、その操作を手動で行う必要が生じることがあります。

同じ場所に複数のコンポーネントをインストールした場合、アンインストール・ウィザードを使用して、アンインストール対象のパッケージを選択できます。パッケージ内のすべてのコンポーネントがアンインストールされます。

始める前に

アンインストールする前に、すべての Microsoft Office アプリケーションを閉じます。


手順1. 「スタート」メニューから、「プログラム」、「IBM Planning Analytics for

Microsoft Office」、「IBM Office アドインのアンインストール」、「IBMOffice アドインのアンインストール」をクリックします。

アンインストール・ウィザードが表示されます。

ヒント: インストール時に作成されるプログラム・フォルダーのデフォルト名はIBM Planning Analytics for Microsoft Office です。別の名前を選択した場合、そのフォルダーに移動してプログラムを見つけてください。

2. 指示に従ってコンポーネントをアンインストールします。

アンインストール・プロセスを記録したログ・ファイルが install_location/

ibm/cognos/IBM for Microsoft Office/instlog/ ディレクトリーにあります。

スクリプトの使用による IBM Cognos Office Reporting TM1Addin の登録

スクリプトを使用して、Microsoft Excel に IBM Cognos Office Reporting TM1

Addin (CognosOfficeTM1.xll) を登録することができます。 registry コマンドを使用するか、Register Cognos XLL.vbs スクリプトを変更して使用することができます。

registry コマンドの使用による IBM Cognos Office ReportingTM1 Addin の登録registry コマンドを使用して、Microsoft Excel に IBM Cognos Office Reporting TM1

Addin (CognosOfficeTM1.xll) を登録することができます。

以下のサンプル・スクリプトは、CognosOfficeTM1.xll 参照を Microsoft Excel に追加するための基本 registry コマンドを示しています。

[HKEY_CURRENT_USER\Software\Microsoft\Office\15.0\Excel\Options]"OPEN"="/R \"C:\\Program Files\\IBM\\cognos\\Cognos for MicrosoftOffice\\CognosOfficeTM1.xll\""

注: これは単なるサンプルです。ご使用の環境に適したパスとキーを使用するために、コマンドを変更する必要があります。

Register Cognos XLL.vbs スクリプトの使用による IBM CognosOffice Reporting TM1 Addin の登録Cognos Analysis for Microsoft Excel は、Register Cognos XLL.vbs という VBS スクリプトを提供します。デフォルトで、このスクリプトは、CognosOfficeBI.xll

(Cognos for Microsoft Office のアドイン) を登録するようセットアップされています。 IBM Cognos Office Reporting TM1 Addin を登録するようこのスクリプトを変更することができます。その後、スクリプトを直接実行するか、デプロイメント・スクリプトに組み込むことができます。

手順1. Cognos Analysis for Microsoft Excel がインストールされている場所に移動します。 Windows 7 の場合、デフォルトのインストール場所は C:¥Program Files

(x86)¥IBM¥cognos¥Cognos for Microsoft Office です。


2. Register Cognos XLL.vbs のバックアップ・コピーを作成します。

3. テキスト・エディターでファイル Register Cognos XLL.vbs を開きます。

4. 19 行目のパスを CognosOfficeTM1.xll ファイルの場所に設定します。例:

path = "C:\Program Files (x86)\IBM\cognos\Cognos for Microsoft Office\”

5. 20 行目の CognosOfficeBI.xll を CognosOfficeTM1.xll で置き換えます。例:

file = "CognosOfficeTM1.xll "

6. ファイルを保存します。

トラブルシューティングここでは、トラブルシューティング時に参照情報として役に立つ情報を記載します。IBM Planning Analytics for Microsoft Excel のインストール中やインストール後に問題が発生した場合に参照して問題を解決してください。

構成の問題構成とセットアップに関連する問題を以下に示します。

数式に変換すると値が表示されない閲覧ビューを作成したときにはエラーが出なかったのに、閲覧シートを数式に変換すると、セルに値が正しく表示されなくなります。値が表示されていないセルのいずれかをクリックすると、COGVAL 式が "=COGVAL($C$1, $C$2, $B10, C$8,

$B$8)" のように表示されます。別のワークステーションで同じことをした場合には、値は正しく表示されます。ワークステーションの管理者権限があるユーザーが数式に変換してみると、ワークシートのセルに値が正しく表示されます。

IBM Planning Analytics for Microsoft Excel のインストールの前にユーザーがMicrosoft Excel を使用していなかったので、レジストリーが正しく登録されていません。この問題を解決するには、2 とおりの方法があります。問題のユーザーにワークステーションに対するローカル管理権限を付与する方法と、Register CognosXLL.vbs ファイルを実行する方法です。このファイルを実行すると、新規ユーザーのための適切なレジストリー・エントリーが追加されます。

Register Cognos XLL.vbs ファイル処理が成功するには (ソフトウェアをインストールするとき、および新規ユーザーを追加するために別途実行するときのどちらの場合も)、Microsoft Excel のレジストリー・エントリーが Microsoft Excel によって作成されている必要があります。 IBM Planning Analytics for Microsoft Excel のレジストリー・エントリーを追加する前に、ユーザーがまず Microsoft Excel を実行していなければなりません。スクリプトによって書き込まれた "ntuser.dat" を調べれば、ユーザーが正しく追加されたかどうかを確認することができます。

Microsoft Office で Cognos Office インターフェースを初期化できないMicrosoft .NET Framework がインストールされていないか、バージョンが正しくない場合には、IBM Cognos Office を初期化できないことがあります。 Microsoft

.NET Framework の必須のバージョンは 4.6.1 以降です。この他に、アドインがインストールされていないか、登録されていないことも、原因として考えられます。


実行している Microsoft .NET Framework のバージョンが正しくない場合は、それをアンインストールした後、Microsoft .NET Framework を再インストールしてください。

IBM Cognos アドインをインストールするには、インストール・プログラムを実行します。

Microsoft .NET Programmability Support をインストールするには、その前にMicrosoft .NET Framework をインストールしておく必要があります。

Cognos Office から発行された Microsoft Office ドキュメントをMicrosoft Office で開くことができないMicrosoft Windows エクスプローラーでブック、ドキュメント、またはプレゼンテーションをダブルクリックしたときに、Microsoft Office が発行済みドキュメントを 2

回開こうとする動作が確認された場合は、ファイルの関連付けが壊れているか、または正しくインストールされていません。

この問題を解決するには、2 とおりの方法があります。最初に Microsoft Office アプリケーションを起動してから「ファイル」メニューの「開く」コマンドでドキュメントを開くか、またはファイルの種類を再登録することができます。

ファイル・タイプを Microsoft Office プログラムに再登録する:

Microsoft Office 文書が正しいファイル・タイプに関連付けられているのにそれを開くことができない場合は、該当する Microsoft Office プログラム(Excel、Word、PowerPoint など) にそのファイル・タイプを再登録する必要があります。


これらの手順の中で program.exe というのは、再登録する Microsoft Office プログラムの実行可能ファイルのプレースホルダーです。 Microsoft Office のインストール先が別の場所である場合は、その場所に合わせて正しいパスを使用してください。

注: Microsoft Windows オペレーティング・システムのバージョン 7 のコマンド・ラインを使用している場合、ファイル・タイプの再登録などの特定のタスクを実行するためには、コマンド・ラインの権限を引き上げる必要があります。権限を引き上げたコマンド・プロンプトを開く、つまり、管理者モードでコマンド・プロンプトを開くには、コマンド・プロンプトのショートカットを右クリックして、「管理者として実行」を選択します。

手順

1. 「スタート」メニューの「ファイル名を指定して実行」をクリックします。

2. プログラム・バージョンの関連付けを解除するには、「開く」ボックスで以下のコマンドを入力し、「OK」をクリックします。

program.exe/regserver

3. デフォルトのバージョンを指定するには、「スタート」メニューから「実行」をクリックします。


4. 「名前」ボックスに次のコマンドを入力して、「OK」をクリックします。

program.exe/regserver

インストール済みの .NET Framework の言語で .NET Messagesが表示されない英語以外のバージョンの .NET Framework を英語以外のオペレーティング・システムにインストールすると、エラー・メッセージ、.NET ショートカット、および.NET コンソールが英語で表示されます。

この問題を解決するには、使用している言語の .NET Framework Language Pack を適用する必要があります。

サブキー番号が言語に関連付けられています。例えば、英語、フランス語、ドイツ語、および日本語は、それぞれ 1033=en-en、1036=fr-fr、 1031=de-de、および1041=ja となっています。その他の言語のサブキー番号を入手するには、Microsoft

サポート・サイトを参照してください。

言語パックのサブキーがない場合は、.NET 言語パックをインストールする必要があります (Microsoft サポート Web サイトからこれを入手できます)。

ブックが不意に終了するCOM アドインがインストールされており、かつ Microsoft Excel ブックの名前に大括弧が含まれている場合、そのブックを開いた後に Excel が予期せずに停止または終了します。

この問題を解決するには、ブック名に大括弧が含まれないよう名前を変更します。

処理の問題次の各項目は、レポートの処理および表示に関連した問題です。

Cognos TM1 データの処理パフォーマンスを改善するCognos TM1 データを処理する際のパフォーマンスに問題がある場合は、Cognos

TM1 システムの管理者がキューブまたはシステムの設定を変更することによって、パフォーマンスを改善できる場合があります。

Cognos TM1 の管理者がパフォーマンスの問題を診断できるように、使用しているデータの詳細と、パフォーマンスの問題が生じる操作についての説明を管理者に提供してください。

以下は、パフォーマンスに影響する Cognos TM1 の設定の例です。

VVM (}CubeProperties)それぞれのキューブごとに、このプロパティーは、スターゲート・ビューの保管用にサーバー上に予約される RAM の量を決定します。スターゲート・ビュー用に使用可能なメモリーが多いほど、パフォーマンスは向上します。Cognos TM1 サーバーがすべてのキューブをロードするのに十分なメモリーが使用可能になっていなければなりません。

VMT (}CubeProperties)キューブ・ビューを計算するのに必要な時間が、指定されているしきい値よ


り大きい場合、TM1 はスターゲート・ビューの保管を試みます。スターゲート・ビューを保管するために使用できるメモリーが十分にない場合、TM1

は、現在使用されていないスターゲート・ビューを、最も古いものから順にパージしていくことにより、十分なメモリーが使用可能になるようにします。

CubeProperties や他のチューニング・オプションの詳細については、「IBM Cognos

TM1 操作」の資料を参照してください。

DPR-ERR-2079 メッセージ「セキュリティー・ファイアウォールによる拒否」セッションの期限が切れた後にレポートを実行し、レポートの最初のページから移動しようとすると、次のエラーが発生します。

DPR-ERR-2079 セキュリティー・ファイアウォールによる拒否。要求は、セキュリティー・ファイアウォールによって拒否されました。CAF 拒否の詳細は、ログで確認できます。管理者に連絡してください。

セッションの期限が切れた後に DPR-ERR-2079 のエラーが発生する場合、問題を解決するために再度ログオンする必要があります。

手順1. レポート・リストで、他のアイテムの前に表示されるノード・アイテムを右クリックします。

2. 「ログオン」をクリックします。

3. プロンプトが表示されたら認証資格情報を入力し、「OK」をクリックします。

アイテムを展開できないこのワークシートの行数または列数が Microsoft Excel の最大数に達しました。Microsoft Excel では、行と列の数に制限があります。現在のアイテムを展開すると、行または列がシフトされてこのワークシートの制限を超えるため、アイテムを展開できません。Microsoft Excel は、空白ではないセルをワークシートの外までシフトすることはできません。

制限を超えずに行アイテムまたは列アイテムを展開できるよう手動でアイテムを移動するか、閲覧ビュー、リスト、またはレポートを別のワークシートに移動します。データを新しい位置に移動して再試行するという方法もあります。

結果が Excel の行または列の制限を超えているこのワークシートの行数または列数が Microsoft Excel の最大数に達しました。Microsoft Excel では、行と列の数に制限があります。アイテムは切り捨てられます。

行または列のアイテムを制限に到達せずに表示できるよう、アイテムをフィルターに掛けてください。追加の閲覧ビュー、リスト、またはレポートを作成して、データを複数のワークシートに配分することを検討してください。行と列の制限がより広い Microsoft Excel の新しいバージョンを使用することを検討してください。


エラー: Exception from HRESULT:<ロケーション>パスが 256 文字を超えているデータ・アイテムをインポートしようとすると、Exception from HRESULT というエラーになります。

Microsoft Excel の 256 文字の制限を超えないように名前と固有のデータ ID を作成する必要があります。

以前のバージョンの Microsoft Excel で保存された閲覧ビューの更新時に発生するエラー最大行数または最大列数の設定がある、古いバージョンの Microsoft Excel でブックが作成されている可能性があります。最大限度値を超える行や列は切り捨てられます。

当該バージョンを現在は使用していなくても、アプリケーションは古いバージョンの Excel の制限下で動作します。この問題は、ブックの作成時点よりもサイズが大きくなったアイテムを展開または更新したときに発生する可能性があります。

この問題を修正するには、ブックを .xlsx 拡張子で保存する必要があります。閲覧ビューが入っているブックを新しいバージョンの Excel で開いても、新しい形式には変換されません。ブックを .xlsx 拡張子で保存すると、新しい形式に変換されます。

セキュリティーの問題次の各項目は、セキュリティーのセットアップに関連した問題です。

Cognos Office で信頼関係を生成できないReport Data サービスに対して HTTPS を使用し、関係を信頼できないというエラーを IBM Cognos Office で受け取った場合、Web サーバーによって発行された認証局 (Certificate Authority) 証明書はクライアント・ワークステーションで信頼されません。

この問題を解決するには、Web サーバー証明書を発行した認証局 (CA) がクライアント・ワークステーションでも信頼されるようにする必要があります。証明書が、Verisign など、クライアントで既に信頼済みの認証局から発行されたものでない場合は、クライアントのトラストストアに CA 証明書をインストールする必要があります。

手順1. 発行元の認証局から CA 証明書を取得します。

ファイルには .cer という拡張子が付いています。これは Web サーバーで使用される証明書とは異なり、発行元の認証局自体の証明書です。

2. .cer ファイルをダブルクリックし、「証明書のインストール」、「次へ」の順にクリックします。

3. 「証明書をすべて次のストアに配置する」をクリックします。

4. 「参照」、「信頼されたルート証明機関」、「次へ」の順にクリックします。

5. 「終了」をクリックします。


Cognos Office の番号付きエラー・メッセージ次のエラー・メッセージは IBM Cognos Office のログに記録され、ダイアログ・ボックスに表示されることもあります。

COI-ERR-2002 メッセージ「ブロック・タイプが正しくありません」内部処理エラーが発生しました。ブロック・オブジェクトを処理できませんでした。

IBM Cognos Resource Center に連絡してください。このエラーに関連したすべてのログや詳細を提供する準備をしてください。

COI-ERR-2003 メッセージ「予期しないタイプです: "積み上げられたブロック"」内部処理エラーが発生しました。データ・オブジェクトが予期されたタイプではなかったため、処理できませんでした。


COI-ERR-2005 メッセージ「このバージョンの Microsoft Office はサポートされていません」IBM Cognos Office がサポートするのは、Microsoft Office アプリケーションの特定のバージョンのみです。

レポート・コンテンツは、サポートされているアプリケーションおよび環境にロードしてください。

オペレーティング・システム、パッチ、ブラウザー、Web サーバー、ディレクトリー・サーバー、データベース・サーバー、アプリケーション・サーバーなど、IBM

Cognos Office 製品でサポートされている環境の最新リストを確認するには、IBM

サポート・ポータルの IBM Cognos Analysis for Microsoft Excel、または IBM サポート・ポータルの IBM Cognos for Microsoft Office を参照してください。

COI-ERR-2006 メッセージ「この Microsoft Office 製品はサポートされていません」IBM Cognos Office がサポートするのは、Microsoft Excel、Microsoft

Word、Microsoft PowerPoint など、特定の Microsoft Office アプリケーションのみです。Microsoft Access など、その他の Microsoft Office アプリケーションを同時に使用するためのアドインがある場合でも、IBM Cognos Office のコンテンツをこれらのアプリケーションにロードすることはできません。

レポート・コンテンツは、サポートされているアプリケーションおよび環境にロードしてください。

オペレーティング・システム、パッチ、ブラウザー、Web サーバー、ディレクトリー・サーバー、データベース・サーバー、アプリケーション・サーバーなど、IBM

Cognos Office 製品でサポートされている環境の最新リストを確認するには、IBM

サポート・ポータルの IBM Cognos Analysis for Microsoft Excel、または IBM サポート・ポータルの IBM Cognos for Microsoft Office を参照してください。


https://www.ibm.com/support/entry/portal/product/cognos/cognos_analysis_for_microsoft_excel?productContext=-1540149255


https://www.ibm.com/support/entry/portal/product/cognos/cognos_for_microsoft_office?productContext=582901819






COI-ERR-2008 リソースから取得できません。試行したリソース:'{0}'内部処理エラーが発生しました。


COI-ERR-2009 メッセージ「Microsoft Excel が編集モードのため、この操作を実行できません」ブックのいずれかのセルが編集中の場合、レポート・コンテンツはリフレッシュできません。

アクティブ・セルの外側をクリックして Excel を非編集モードに戻し、再試行してください。

COI-ERR-2010 名前 {0} が正しくありません。名前に引用符 (") とアポストロフィ (') の両方を使用することはできません。フォルダーの作成、フォルダーの名前変更、ドキュメントの発行に際し、名前にアポストロフィや引用符を使用できますが、両方を同時に使用することはできません。

この問題を解決するには、フォルダーやドキュメントの名前を変更します。名前からアポストロフィまたは引用符を除外します。

COI-ERR-2013 メッセージ「メタデータをロードできません」ワークシートのすべてのアイテムに対してセキュリティー権限を持ってはいないか、アイテムがサーバー上で削除または変更されたために、メタデータをロードできない可能性があります。

表示しようとしているすべてのアイテムに対するセキュリティー権限があることを確認してください。これで問題が解決しない場合は、サーバーとパッケージの情報が正しいこと、およびソース・データベースから削除されたアイテムがあればそれがワークシートからも削除されていることを確認してください。

COI-ERR-2015 メッセージ「MIME でエンコードされたサーバー応答の解析中に問題が発生しました。境界 [{0}] の検索を試みましたが、代わりに境界 [{1}] が見つかりました」サーバーから取得したデータを圧縮するオプションの GZip 圧縮を使用している際にエラーが発生しました。データを解凍するコードが欠落しているか、IBM Cognos

Office で認識されていません。

圧縮を無効にします。圧縮はデフォルトで有効になっていますが、CommManagerSettings.xml ファイルで UseGzipCompression プロパティーを false に設定することで無効にできます。デフォルトでは、このファイルは Office

Connection ディレクトリー (C:¥Documents and Settings¥ユーザー名 ¥Local

Settings¥Application Data¥Cognos¥Office Connection または C:¥Users¥user

name¥AppData¥Local¥Cognos¥Office Connection など) にあります。


テストまたはトラブルシューティングを実行する必要がある場合は、圧縮を無効にします。

gzip 圧縮を無効にするには、次の属性を設定します。

<setting name="UseGzipCompression">False</setting>

COI-ERR-2016 メッセージ「ワークシートが保護されています。IBMCognos のスタイルのデータを設定できません。」ワークシートが保護されている場合、IBM Cognos のスタイルは適用できません。

データの更新中にスタイルを適用するには、ワークシートを保護解除する必要があります。

COI-ERR-2019 接続が失敗しましたPlanning Analytics for Microsoft Excel から Planning Analytics サーバーに接続しようとすると、以下のエラー・メッセージが表示されます。

COI-ERR-2019 接続が失敗しました。接続からエラーが返されました。接続文字列(サーバー名とポート番号など) が正しいことを確認してください。

この問題を解決するには、アンチウィルス・ソフトウェアの設定で Microsoft .NET

Runtime と Microsoft Excel からの接続を両方とも許可する必要があります。

IBM Planning Analytics for Microsoft Excel 番号付きエラー・メッセージ

次のエラー・メッセージは IBM Cognos Office のログに記録され、ダイアログ・ボックスに表示されることもあります。

COR-ERR-2004 メッセージ「軸の仕様が正しくありません」異常が発生したため、ブックの仕様を生成できません。

この問題を解決するには、次のいずれかを実行します。

v 「元に戻す」をクリックする。

v 「すべてのデータをクリア」をクリックする。

v ブックを閉じた後、もう一度開く。

これで、ブックにソース・ツリーからデータを取り込めるようになります。

COR-ERR-2007 メッセージ「リソースからの取得中にエラーが発生しました。試行したリソース: '{0}'」閲覧ビュー・シートが不良状態になりました。

IBM Cognos Resource Center に連絡してください。

COR-ERR-2009 メッセージ「名前の数式が正しくありません」COGNAME 式が正しく解析されませんでした。手動で変更されたことによって引数が失われている可能性があります。


アクティブ・セルの COGNAME 式を調べて正しい形式にするか、必要に応じてソース・ツリーからメンバーを挿入します。

COR-ERR-2010 メッセージ「数式が正しくありません」COGNAME または COGVAL 式の引数がセルを参照しているときに、そのセルに予期される文字列式が入っていない場合、このエラーが発生します。

セルとその参照先を確認します。セルが #REF または #VALUE となっていないか確認してください。セルの内容が誤って削除された可能性があります。

COR-ERR-2011 範囲が正しくありません: クロス集計グラフまたはリストの正しい範囲を入力してください範囲が無効であるか、データ型の範囲外です。

この制限を回避するには、データの選択範囲を狭くします。

COR-ERR-2013 メッセージ「コンテキスト・アイテムの中に選択アイテムを含むものがあるため、閲覧ビューを数式ベースに変換できません」「コンテキスト」ドロップ・ゾーンに複数のアイテムがある場合に、ワークシートのセルに複数のアイテムを表示することはできません。

「コンテキスト」ドロップ・ゾーンから 1 つのディメンションを削除します。式に基づいた分析に変換するには、ディメンションあたり 1 つのアイテムにする必要があります。

COR-ERR-2014 メッセージ「Excel ワークシートの制限のため、結果の最後が切り取られることがあります」受け取ったデータが Microsoft Excel の行や列の制限を超えていると、結果が切り捨てられます。このメッセージは切り捨てに注意を促すためのものです。

この制限を回避するには、データの選択範囲を狭くします。

COR-ERR-2015 メッセージ「現在の閲覧ビューをワークシート上のこの場所に表示できません」閲覧ビューで、現在のワークシートの制限を超えた場所にデータを書き込むことはできません。閲覧ビューの大きさが Microsoft Excel の制限を超えているか、制限に近接した開始場所を指定しています。

開始位置を移動してみてください。それでも問題が解決しない場合は、列または行の数を減らして閲覧ビューを作成してみてください。

COR-ERR-2016 メッセージ「パッケージ<名前>を取得できません」「パッケージを開く」ダイアログ・ボックスを使用してパッケージを選択した後、サーバーからパッケージをダウンロードしようとしてエラーが発生しました。

これは内部エラーです。

IBM Cognos Resource Center に連絡してください。


COR-ERR-2017 メッセージ「現在の選択内容ではデータは返されませんでした」ソース・ツリーでの選択内容ではデータが返されませんでした。閲覧ビュー・シートはクリアされるか、前の状態に戻ります。

ワークシートにアイテムを表示するには、データ・ポイントと交差するオブジェクトをソース・ツリーから選択する必要があります。


第 16 章 Cognos TM1 サンプル・データベースのインストール

IBM Cognos TM1 サンプルは、製品の機能と、技術やビジネスに関するベスト・プラクティスについて説明するためのものです。このサンプルを使って、製品について学習したり、テストやトラブルシューティングを行ったりすることもできます。

Cognos TM1 サンプルの概要

Cognos TM1 サンプルにはさまざまな用途があり、さまざまなクライアント用に最適化されています。サンプルの中には、インストールした後すぐに使用できるものや、使用のために追加ステップが必要になるものがあります。デフォルトで、Cognos TM1 サンプルは、異なる 2 つの場所にインストールされます。インストール・ウィザードで選択される場合、製品サンプルは以下の場所にインストールされます。

SData、Planning Sample、GO_New_Stores、GO_Scorecards、Proven_Techniques、24Retail

これらのサンプルは、デフォルトで、TM1 の場所¥samples¥tm1 にインストールされます。

SData と Planning Sample は、Cognos TM1 で使用するために特別に設計されたものです。

これらを使用するには、インストール後に各サンプル・データベースをCognos Configuration で開始します。

GO_New_Stores と Proven_Techniques は、Cognos TM1 Performance

Modeler、TM1 Applications、Cognos Insight の機能を紹介するために用意されたものです。

Proven_Techniques サンプルは、キューブの計算と関数を紹介しています。複数のアプリケーションをポータルにインポートし、Cognos Insight の接続モードを使ってそれらを表示することもできます。

GO_Scorecards サンプルには、Cognos TM1 Performance Modeler にあるIBM Cognos Scorecard 機能と共に使用するために最適化されたデータが含まれています。

24Retail は、スマートフォン、コンピューター、その他のウィジェットを販売する 24Retail という架空の会社に関するサンプルです。Planning

Analytics Workspace、Planning Analytics for Microsoft

Excel、Architect、TM1 Web で、このサンプルのデータを使用できます。

詳細については、 232ページの『デフォルトでインストールされているサンプル・データベースの使用』を参照してください。

PData、Rules_Guide_Data、TI_Data

これらのサンプルも Cognos TM1 のために特別に設計されたものですが、これらを使用するにはまず Cognos Configuration に各サーバーを追加し、その後、個別に開始する必要があります。これらのサンプルは、<TM1 の場所>¥samples¥tm1 にインストールされます。


GO_Contributor.zip、sample_outdoiors.zip、advanced_techniques.zip、greatoutdoors.zip、GreatOutdoorsSales.zip

これらのサンプルは、tm1 の場所¥webcontent¥samples¥datasources¥cubes¥amdtool ディレクトリーにインストールされます。

GreatOutdoorsSales.zip サンプルを使用するには、データベースを復元し、OLAP データ・ソースを使ってデータベースに接続する必要があります。データベース・ファイルは、サンプルとともにインストールされます。IBM DB2®、Microsoft SQL Server、Oracle データベース用のデータベース・ファイルが用意されています。

その他のサンプルは、内容が .csv ファイルに基づいており、データベースの復元は必要ありません。詳細については、 233ページの『GO_Contributor

および Outdoors 社のサンプル・データベースの使用』を参照してください。

HumanResources.cdd、Orders.cdd、Training.cdd。.cdd とデータ・サンプルのセットは、Cognos Insight ワークスペース・ビルダーで使用するために特別に設計されたものです。ローカライズ版が含まれているこのサンプルは <TM1 のインストール場所>¥webcontent¥samples¥datasources¥cubes¥amdtool¥Source_files¥desktop

にあります。

UNIX の場合、./startup_tm1s.sh コマンドを使ってサンプル・データベース・サーバーを開始します。詳しくは、「IBM Cognos TM1 Operations」の『UNIX TM1

サーバーの開始』および『UNIX TM1 サーバーの停止』を参照してください。

デフォルトでインストールされているサンプル・データベースの使用以下のサンプル・データベースは、デフォルトでインストールされており、Cognos

Configuration からすべて開始することができます。


これらのデータベースはサンプル・データベース用の場所にデフォルトでインストールされます。

例: C:¥Program Files¥IBM¥cognos¥tm1¥samples¥tm1¥SData

SData TM1 で使用するために設計されたデータ。

計画のサンプルPlanning クライアントで使用するために設計されたデータ。

GO_New_StoresTM1 Applications、Cognos Insight、および Cognos TM1 Performance

Modeler で使用するために設計されたデータ。

GO_ScorecardsTM1 Performance Modeler で TM1 Scorecarding を使用するために設計されたデータ。


Proven_Techniquesこのサンプル・データベースは、最新のリリースのキューブ計算および機能を使用します。このデータベースは、Cognos TM1 Performance Modeler のTM1 Scorecard 機能で使用するために設計されています。

手順1. Cognos Configuration で、開始するデータベースを右クリックし、「開始」を選択します。

2. データベースを開くには、TM1 Architect または TM1 Performance Modeler でデータベースをダブルクリックし、デフォルトのユーザー名 admin およびパスワード apple を使用します。

GO_Contributor および Outdoors 社のサンプル・データベースの使用以下の GO_Contributor および Outdoors 社のサンプルは .zip ファイルとしてインストールされ、それを使用するには unzip する必要があります。

手順1. TM1 サーバー・コンポーネントをインストールしたコンピューターで、<TM1 の場所>¥webcontent¥samples¥datasources¥cubes¥amdtool フォルダーに移動します。

2. GO_Contributor.zip または Outdoors_Company.zip ファイルの内容を解凍します。解凍は必ずルート・ロケーションの近くで行い (c: など)、ファイル・パスが長くなりすぎないようにしてください。

3. ファイルの解凍先フォルダーで Data Files フォルダーに移動し、tm1s.cfg ファイルをテキスト・エディターで開きます。

a. ロケーション DatabaseDirectory、LoggingDirectory、およびDistributedPlanningOutputDir において、Go_Contributor.zip ファイルおよび Outdoors_Company.zip ファイルの解凍先である Data Files フォルダー・ロケーションの正しいパスが使用されていることを確認します。

b. ファイルを保存して閉じます。



a. 「名前」ボックスに GO Contributor または Outdoor Company と入力します。

b. TM1 サーバーの設定パスの値として、ファイルの解凍先である Data Files

フォルダーのパスを入力します。

例えば、<TM1 の場所>¥samples¥GO_Contributor

c. 「エクスプローラー」パネルで、「GO Contributor」または「Outdoor

Company」を右クリックしてから「開始」をクリックします。

6. 新しいサーバーが Architect から使用可能かどうかをテストします。

a. Architect を開きます。

b. サーバーをダブルクリックします。

第 16 章 Cognos TM1 サンプル・データベースのインストール 233

c. 「サーバー・ログオン」ボックスの「ユーザー名」ボックスに admin、「パスワード」ボックスに apple と入力します。

7. 新しいサーバーが IBM Cognos Applications ポータルで使用可能かどうかをテストするには、次のようにします。

a. http://server_name:9510/pmpsvc と入力してポータルを開きます。

b. 「IBM Cognos TM1 Application の管理」アイコンをクリックします。

c. 「サーバー名」の下の「追加」をクリックします。

d. 「管理ホスト」にサーバー名を入力してから、「更新」ボタンをクリックします。

e. 今追加したサンプルを選択して「OK」をクリックします。

サンプル・データベースに基づく Great Outdoors 販売サーバーサンプルの使用

Great Outdoors 販売サンプルは、データベースのデータを使用します。このサンプルを使用するには、データベースを復元し、データベースへの ODBC 接続を作成した後、サンプル・サーバーをシステムに追加する必要があります。

データベースは IBM DB2、Microsoft SQL Server、Oracle 用です。

サンプル・データベースおよびデータベースを使用する Cognos TM1 サーバーは、Cognos TM1 サーバーとともに <TM1 の場所>/webcontent/samples/datasources フォルダーにインストールされます。

ODBC 接続を作成する際、GOSALESDW をデータ・ソース名として使用します。Microsoft Windows オペレーティング・システムでは、ODBC 接続をシステム DSN

として作成します。

バックアップ・ファイルの復元 (IBM DB2)付属のスクリプトを使用して、IBM DB2 のサンプル・データベースを復元することができます。

サンプル・データベースをセットアップするには、GS_DB tar.gz ファイルを解凍して設定ファイルをカスタマイズし、セットアップ・スクリプトを実行する必要があります。

手順1. tm1_location/webcontent/samples/datasources フォルダーに移動します。

2. GS_DB.tar.gz ファイルを解凍し、元のディレクトリー構造を保持します。

Microsoft Windows オペレーティング・システム上で WinZip を使用してGS_DB.tar.gz ファイルを解凍する場合は、「TAR file smart CR/LFconversion」オプションを選択しないようにしてください。

3. Linux および UNIX オペレーティング・システムでは、次のようにsetupGSDB.sh ファイルに対するアクセス権を変更して実行可能ファイルにします。

例:


chmod u+x setupGSDB.sh

4. サンプルの設定ファイルを変更してデフォルト値以外の設定を使用する場合は、GOSalesConfig ファイルを編集します。

Windows 用の設定ファイルは GOSalesConfig.bat です。 Linux および UNIX

用の設定ファイルは GOSalesConfig.sh です。

GOSalesConfig 設定ファイルには、GOSALES データの作成時に使用されるデフォルトの構成オプションが含まれています。以下の表に、デフォルトの構成設定をリストします。

表 22. GOSALES データのデフォルトの構成設定

構成設定デフォルト説明

GOSALES_INST GS_DB データベースの名前または別名を設定するために使用します。

GOSALES_CREATEDB オプション: 同じ名前の既存のデータベースをドロップします。

GOSALES_DB_TERRITORY US データベースを作成する場合には、これが作成されるUTF-8 データベースのテリトリーになります。

GOSALES_BP

GOSALES_TS

GOSALES_BP

GOSALES_TS

オプション: バッファー・プールと表スペースの名前を入力します (スクリプトで作成する場合)。

GOSALES_GRANTEES GOSALES、DB2ADMIN GOSALES、GOSALESHR、GOSALESMR、およびGOSALESRT スキーマに対する CONTROL 権限を付与するユーザー、グループまたはPUBLIC のリストを入力します。この文字列は、GRANT

コマンドの構文規則に従っている必要があります。

GOSALESDW_GRANTEES GOSALESDW

DB2ADMIN

GOSALESDW スキーマに対する CONTROL 権限を付与するユーザー、グループまたは PUBLIC のリストを入力します。

GOSALES_DPF N データベース・パーティション環境 (DPF) をインストールする場合は 'Y' に変更します。


表 22. GOSALES データのデフォルトの構成設定 (続き)


GOSALES_SCHEMA

GOSALESHR_SCHEMA

GOSALESMR_SCHEMA

GOSALESRT_SCHEMA

GOSALESDW_SCHEMA

GOSALES

GOSALESHR

GOSALESMR

GOSALESRT

GOSALESDW

各スキーマに使用する名前を入力します。

デフォルトでは、GS_DB データベース名が使用され、DB2ADMIN

(Linux、UNIX、Windows) および GOSALES ユーザーに権限が付与されます。

5. setupGSDB スクリプトを対話モードで実行するには、以下のコマンドを実行します。

v Windows コンピューターの場合、IBM DB2 コマンド・ウィンドウで、GS_DB¥win ディレクトリーに移動し、setupGSDB.bat スクリプトを実行します。

v UNIX コンピューターの場合、シェル・プロンプトから source db2profile を実行した後、GS_DB/unix ディレクトリーに移動して、setupGSDB.sh スクリプトを実行します。

環境への変更をコミットする前に、スクリプトによって選択内容の概要が表示されます。選択内容を承認する場合は、Enter を押します。

6. コマンド行から setupGSDB スクリプトを実行するには、以下のコマンドを実行します。

v Windows コンピューターの場合は、setupGSDB.bat スクリプトを実行します。

v UNIX コンピューターの場合は、setupGSDB.sh スクリプトを実行します。

setupGSDB スクリプトを実行するときには、以下のオプションを指定できます。

オプション説明

-createdb データベースを作成します。このオプションを指定した場合、同じ名前の既存のデータベースはドロップされます。必要なバッファー・プールおよび表スペースを作成します。

-database database name データベースの名前を指定します。この値は、GS_DB のデフォルト値をオーバーライドします。

-userid administration_user_ID データベースの作成に使用する DB2 管理者のユーザー ID の名前を指定します。

-password administration_user_ID DB2 管理者のユーザー ID のパスワードを指定します。



-noprompt プロンプトを表示しないように指定します。このオプションを指定すると、スクリプトはサイレント・モードで実行されます。情報が不足していると、スクリプトは失敗します。確認を求めるプロンプトは一切表示されません。

例えば、IBM DB2 管理者がデフォルトの GS_DB データベースをローカル・ノード上に作成する場合、以下のコマンドを使用します。

setupGSDB -createDB -noprompt

管理者ユーザー ID として db2admin を使用して、SAMPLE という名前の既存のデータベース内に表を作成する場合は、以下のコマンドを実行します。

setupGSDB -database SAMPLE -userid db2admin

スクリプトは、データベースへの接続時にパスワードの入力を求めるプロンプトを出します。また、データベースを削除することを選択した場合を除き、データベース内の既存の表はスクリプトによってすべて置換されます。

7. GS_DB サンプル・データベースが環境内のリモート・サーバーにインストールされている場合は、ローカル・コンピューター上でそのリモート・データベースをカタログしてリンクしてから、セットアップ・スクリプトをローカルで実行することができます。

a. リモート・サーバー上にサンプル・データベースがまだ存在していない場合は、CREATE DATABASE コマンドを使用して作成します。

このデータベースには、UTF-8 コード・セットと、ページ・サイズが 16 KB

以上のデフォルト表スペースが必要です。例えば、リモート・サーバー上で、次のコマンドを実行してデータベースを作成します。

CREATEDATABASE GS_DB USING CODESET UTF-8 TERRITORY US PAGESIZE 16k

b. ローカル・コンピューター上で次のコマンドを使用してリモート・データベースをカタログします。

db2catalog tcpip node nodename remote ipaddr server port_numberdb2 catalog database GS_DB as GS_DB at node nodename

c. ローカル・コンピューター上で次のコマンドを実行します。

setupGSDB -database GS_DB -userid administration_user_ID

データベースに接続するために、パスワードを求めるプロンプトが表示されます。

バックアップ・ファイルの復元 (Oracle)TM1 と共にインストールされるスクリプトを使用して、Oracle のサンプル・データベースのバックアップ・ファイルを短時間で手軽に復元することができます。



サンプル・データベースをセットアップするには、GS_DB_ORA.tar.gz ファイルを解凍して設定ファイルをカスタマイズし、セットアップ・スクリプトを実行する必要があります。

手順1. tm1_location/webcontent/samples/datasources に移動します。

2. GS_DB_ORA.tar.gz ファイルを解凍し、元のディレクトリー構造を保持します。

3. Linux および UNIX オペレーティング・システムでは、次のようにsetupGSDB.sh ファイルに対するアクセス権を変更して実行可能ファイルにします。

chmod u+x setupGSDB.sh

4. Oracle データベースのセットアップに使用するユーザー ID に、ユーザーを作成してインポート・ユーティリティーを実行できる権限があることを確認してください。

5. オプション - サンプルの設定ファイルを変更してデフォルト値以外の設定を使用する場合は、GOSalesConfig ファイルを編集します。

Windows 用の設定ファイルは GOSalesConfig.bat です。 UNIX 用の設定ファイルは GOSalesConfig.sh です。

GOSalesConfig 設定ファイルには、GOSALES データの作成時に使用されるデフォルトの構成オプションが含まれています。以下の表に、デフォルトの構成設定をリストします。

表 23. GOSALES データのデフォルトの構成設定


GOSALES_IMP_CMD imp 必要な場合は、変更して適切なバージョンのインポート・ユーティリティーの完全パスを指定できます。

GOSALES_INST Oracle のホスト文字列です。

GOSALES_TS GOSALES_TS スクリプトでユーザーを作成する場合に、ユーザーに割り当てる表スペース名を入力するために使用します。

GOSALES_CREATE_TS オプション: ユーザー用のデフォルト表スペースを作成する場合に使用します。




GOSALES_TEMP_TS スクリプトでユーザーを作成する場合に、ユーザーに割り当てる一時表スペースに名前を付けるために使用します。デフォルトの一時表スペースを使用する場合は、ブランクのままにしてください。

GOSALES_SCHEMA

GOSALES_SCHEMA_PW

GOSALES

GOSALESPW

GOSALES ユーザーのユーザー名とパスワードを入力するために使用します。入力しなかった場合、パスワードの入力を求めるプロンプトが表示されます。

GOSALESHR_SCHEMA

GOSALESHR_SCHEMA_PW

GOSALESHR

GOSALESHRPW

GOSALESHR ユーザーのユーザー名とパスワードを入力するために使用します。入力しなかった場合、パスワードの入力を求めるプロンプトが表示されます。

GOSALESMR_SCHEMA

GOSALESMR_SCHEMA_PW

GOSALESMR

GOSALESMRPW

GOSALESMR ユーザーのユーザー名とパスワードを入力するために使用します。入力しなかった場合、パスワードの入力を求めるプロンプトが表示されます。

GOSALESSRT_SCHEMA

GOSALESRT_SCHEMA_PW

GOSALESRT

GOSALESRTPW

GOSALESRT ユーザーのユーザー名とパスワードを入力するために使用します。入力しなかった場合、パスワードの入力を求めるプロンプトが表示されます。

GOSALESDW_SCHEMA

GOSALESDW_SCHEMA_PW

GOSALESDW

GOSALESDWPW

GOSALESDW ユーザーのユーザー名とパスワードを入力するために使用します。入力しなかった場合、パスワードの入力を求めるプロンプトが表示されます。




GOSALES_GRANTEES GOSALES GOSALES、GOSALESHR、GOSALESMR、およびGOSALESRT スキーマに対するSELECT、INSERT、DELETE、UPDATE、および ALTER 権限を付与するユーザーを入力するために使用します。

注: GOSALES_SCHEMA の所有者には、必ず、すべてのスキーマに対するSELECT、INSERT、DELETE、UPDATE、および ALTER 権限が付与されます。

GOSALESDW_GRANTEES GOSALESDW GOSALESDW スキーマに対するSELECT、INSERT、DELETE、UPDATE、および ALTER 権限を付与するユーザーを入力するために使用します。

6. setupGSDB スクリプトを対話モードで実行するには、以下のコマンドを実行します。

v Windows コンピューターの場合、DOS コマンド・ウィンドウでGS_DB_ORA¥win ディレクトリーに移動し、setupGSDB.bat スクリプトを実行します。

v UNIX コンピューターの場合、シェル・プロンプトから、GS_DB_ORA/unix ディレクトリーに移動し、setupGSDB.sh スクリプトを実行します。

Enter キーを押して続行します。環境への変更をコミットする前に、スクリプトによって選択内容の概要が表示されます。選択内容を承認して Enter キーを押すと、スクリプトによって変更が加えられます。

7. コマンド行から setupGSDB スクリプトを実行するには、以下のコマンドを実行します。

v Windows コンピューターの場合は、setupGSDB.bat スクリプトを実行します。

v UNIX コンピューターの場合は、setupGSDB.sh スクリプトを実行します。

setupGSDB スクリプトを実行するときには、以下のオプションを指定できます。



-createdb データベースを作成します。このオプションを指定した場合、同じ名前の既存のデータベースはドロップされます。必要なバッファー・プールおよび表スペースを作成します。

-database database name データベースの名前を指定します。この値は、GS_DB のデフォルト値をオーバーライドします。

-userid administration_user_ID データベースの作成に使用する DB2 管理者のユーザー ID の名前を指定します。

-password administration_user_ID DB2 管理者のユーザー ID のパスワードを指定します。

-noprompt プロンプトを表示しないように指定します。このオプションを指定すると、スクリプトはサイレント・モードで実行されます。情報が不足していると、スクリプトは失敗します。確認を求めるプロンプトは一切表示されません。

例えば、Oracle 管理者がデフォルトのサンプル・データベース・スキーマを作成する場合は、次のコマンドを実行します。

setupGSDB -createDB -noprompt

設定ファイルで指定した既存のスキーマに表を作成し、管理者ユーザー ID sys

を使用する必要があるとします。次のコマンドを実行してください。

setupGSDB -YourOracleInstance-userid sys -sysdba

スクリプトは、Oracle インスタンスへの接続時にパスワードの入力を求めるプロンプトを出します。スクリプトは、指定されているスキーマに既存の表またはビューがあればそれらを削除して置換します。

Microsoft SQL Server のバックアップ・ファイルの復元サンプル・データベースのバックアップ・ファイルを短時間で手軽に復元するには、Microsoft SQL Server のデータベース管理ツールを使用します。

手順1. TM1 サーバーがインストールされているコンピューターで、以下のディレクトリーに移動します。

<TM1 の場所>/webcontent/samples/datasource/Source files/sqlserver

2. 必要な場合、サンプル・データベースのバックアップ・ファイルをデータベース・バックアップ・ディレクトリーにコピーします。

3. デバイスからデータベースを復元し、.ldf および .mdf のデータベース・ファイルの復元場所が正しいことを確認します。

4. 復元したデータベースのすべてのテーブルに対する Select 権限を付与されたユーザーを少なくとも 1 人作成します。


Great Outdoors 販売サンプルのセットアップGreat Outdoors 販売サンプルでは、復元したデータベースからのデータが使用されます。

手順1. 復元されたデータベースとの ODBC データ・ソース接続を作成します。

データ・ソース名として GOSALESDW を使用します。 Windows オペレーティング・システムでは、ODBC 接続をシステム DSN として作成します。

2. TM1 サーバー・コンポーネントをインストールしたコンピューターで、<TM1 の場所>¥webcontent¥samples¥datasources¥cubes¥amdtool フォルダーに移動します。

3. ファイル GreatOutdoorsSales.zip の内容を解凍します。解凍は必ずルート・ロケーションの近くで行い (c: など)、ファイル・パスが長くなりすぎないようにしてください。

4. GreatOutdoorsSales.zip ファイルの解凍先フォルダーで、DataFiles フォルダーに移動し、tm1s.cfg ファイルをテキスト・エディターで開きます。

a. ロケーション DatabaseDirectory およびロケーション LoggingDirectory において、GreatOutdoorsSales.zip ファイルの解凍先ロケーションの正しいパスが使用されていることを確認します。

b. ファイルを保存して閉じます。



a. 「名前」ボックスに GreatOutdoorsSales と入力します。

b. TM1 サーバーの設定パスの値として、GreatOutdoorsSales.zip ファイルの解凍先であるフォルダー DataFiles のパスを入力します。

例えば、<TM1 の場所>¥webcontent¥samples¥datasources¥cubes¥amdtool¥GreatOutdoorsSales¥DataFiles

c. 「エクスプローラー」パネルで、「GreatOutdoorSales」を右クリックしてから「開始」をクリックします。

7. 新しい GreatOutdoorsSales サーバーが Architect から使用可能かどうかをテストします。

a. Architect を開きます。

b. GreatOutdoorsSales サーバーをダブルクリックします。

c. 「サーバー・ログオン」ボックスの「ユーザー名」ボックスに admin、「パスワード」ボックスに apple と入力します。

8. 新しい GreatOutdoorsSales サーバーが IBM Cognos Applications ポータルから使用可能なかどうかをテストします。

a. http://server_name:9510/pmpsvc と入力してポータルを開きます。

b. 右端にある「IBM Cognos アプリケーションの管理 (Administer IBMCognos Application)」アイコンをクリックします。

c. 「サーバー名」の下の「追加」をクリックします。


d. 「管理ホスト」にサーバー名を入力してから、「更新」ボタンをクリックします。

e. 今追加した GreatOutdoorsSales サンプルを選択して「OK」をクリックします。


第 17 章 Cognos TM1 ツールのインストール

インストール時に「TM1 データ層」>「TM1 ツール」コンポーネントを選択すると、Cognos のツールとユーティリティーが一式インストールされます。

これらのツールはオプションのコンポーネントであるため、インストールの際に「TM1 ツール」コンポーネントのチェック・ボックスをオフにしてインストールしないようにすることもできます。これらのツールは、<TM1 の場所>/bin にインストールされます。

このグループでインストールされるツールには、次のものがあります。

TM1RunTITM1RunTI は、オペレーティング・システム・コマンドの発行に対応しているすべてのアプリケーションの内部から TM1 TurboIntegrator (TI) プロセスを開始することができる、コマンド行インターフェース・ツールです。

場所: <TM1 の場所>/bin

ファイル名: tm1runti.exe

「TM1 TurboIntegrator」の『詳細プロシージャーの編集』の章を参照してください。

tm1xfertm1xfer ユーティリティーは、Microsoft Windows プラットフォームとUNIX プラットフォームの両方でオブジェクトの大/小文字混合の名前を保持しながら、IBM Cognos TM1 サーバー・オブジェクトを圧縮し、1 つのプラットフォームから別のプラットフォームに移動します。

場所: <TM1 の場所>/bin

ファイル名: tm1xfer.cmd と tm1xfer.jar

「TM1 Operations」の『ツールおよびユーティリティー』の章を参照してください。

使用可能な Cognos TM1 ツールとして、次のものもあります。

Cognos TM1 Operations ConsoleCognos TM1 Operation Console は複数の TM1 サーバーをモニターでき、ログ・ファイルの豊富な書式設定機能を備えています。Cognos TM1

Operation Console には、インストールで選択できる独自のコンポーネントがあります。詳しくは、「TM1 Operations」の『IBM Cognos TM1

Operations Console の使用』の章を参照してください。

TM1 TopTM1 Top は、1 台の Cognos TM1 サーバーをモニターします。デフォルトでインストールされています。詳しくは、「TM1 Operations」の『システムおよびパフォーマンスのモニター』の章を参照してください。

odbc_testodbc_test ツールは、UNIX 上で IBM Cognos TM1 ODBC 接続を診断した


りテストしたりするために使用します。詳しくは、「TM1 Operations」の『ツールとユーティリティー』の章を参照してください。


第 18 章セキュリティー構成

IBM Cognos TM1 のインストール後、使用する特定の認証モードとセキュリティー・モードを設定できます。

このセクションでは、インストールおよび設定のプロセス全体の一環と見なされる認証セキュリティーとデータ転送セキュリティーについて説明します。ユーザー、グループ、オブジェクトのセキュリティーのための手順は、初期インストールおよび設定プロセスの後に実行されるのが一般的で、この手順については別の資料で説明しています。

認証セキュリティー

認証設定またはログオン・セキュリティー設定には、ログオン・セキュリティーのタイプの選択が関係します。これにより、種々の Cognos TM1 コンポーネントに対するユーザー・アクセスが制御されます。

データ転送セキュリティー

セキュリティー設定では、データ転送の保護のため、オプションで SSL を使用するよう Cognos TM1 を設定することができます。

ユーザーおよびグループのセキュリティー

Cognos TM1 は、TM1 ユーザーをグループに編成してセキュリティーを管理します。TM1 には、あらかじめ定義された管理グループが 3 つあります。また、独自のカスタム・グループを作成することもできます。ユーザーは、1 つまたは複数のグループに所属できます。

ユーザーおよびグループのセキュリティーの設定の詳細については、「IBM Cognos

TM1 TM1 Operations」を参照してください。

オブジェクト・セキュリティー

別のレベルの Cognos TM1 セキュリティーには、オブジェクト・セキュリティーがあります。このタイプのセキュリティーでは、データ・モデル内の特定の TM1 オブジェクトに対するアクセスを制御できますが、これは初期インストールおよび設定のプロセスでは設定されません。

Cognos TM1 オブジェクトにセキュリティーを設定するために必要な手順について詳しくは、「IBM Cognos TM1 Developer」を参照してください。

認証セキュリティー認証設定またはログオン・セキュリティー設定には、ログオン・セキュリティーのタイプの選択が関係します。これにより、種々の IBM Cognos TM1 コンポーネントに対するユーザー・アクセスが制御されます。


認証に関する概要特定の認証モードを使用してユーザー・ログオンのアクセスを制御するように IBM

Cognos TM1 サーバーを設定できます。

Cognos TM1 サーバーをインストールすると、デフォルトで標準の Cognos TM1 認証を使用するように設定されます。

Cognos TM1 サーバーをインストールした後に、TM1 設定ファイルのパラメーターを変更して、この認証方法を変更できます。

表 24. Cognos TM1 サーバーの認証方法

認証方法説明

TM1 認証 Cognos TM1 サーバーが、ユーザーに対してユーザー名とパスワードの入力を求め、そのログオン情報をセキュリティー・キューブのログオン情報と照合して検証します。

統合ログオン Microsoft Windows が Cognos TM1 認証を実行します。

LDAP 認証 Cognos TM1 サーバーが、ユーザーに対してユーザー名とパスワードの入力を求め、そのログオン情報を外部の LDAP サーバーと照合して検証します。

IBM Cognos セキュリティー

Cognos TM1 サーバーが IBM Cognos セキュリティーを使用してユーザーを認証します。

標準の Cognos TM1 認証の概要IBM Cognos TM1 認証では、Cognos TM1 サーバーが、ユーザー名およびパスワードを Cognos TM1 データベースに保存されているユーザー名およびパスワードと照合して確認します。

図 8. IBM Cognos TM1 サーバーによる認証のプロセス


統合ログオンの概要統合ログオンを使用すると、IBM Cognos TM1 は Microsoft Windows のネットワーク認証を使用して Cognos TM1 データにアクセスします。Microsoft Windows ワークステーションへのログオンが完了すると、ユーザー名とパスワードを再度入力しなくても、Cognos TM1 にアクセスできます。

統合ログオンは、Microsoft Windows のみでサポートされています。統合ログオンを使用して、UNIX オペレーティング・システムで稼働している Cognos TM1 サーバーにアクセスすることはできません。

LDAP 認証の概要LDAP 認証では、IBM Cognos TM1 認証の外部にある LDAP セキュリティー・サービスによってログオンが認証されます (Cognos TM1 バージョン 8.2.2 以降)。ユーザーのセキュリティー情報は、1 カ所 (LDAP サーバーまたは Microsoft Windows

Active Directory) で追加、変更、および削除できます。

図 9. 統合ログオンの使用による認証のプロセス

第 18 章セキュリティー構成 249

Cognos セキュリティーIBM Cognos TM1 サーバーは、IBM Cognos セキュリティーを使用してユーザーを認証できます。

Cognos セキュリティーは、データへのユーザー・アクセスを管理する、IBM

Cognos フレームワークのコンポーネントです。 Cognos セキュリティーは、LDAP、Active Directory などのサード・パーティーのセキュリティー・プロバイダーを通じて承認と認証を管理します。 Cognos セキュリティーを通じて認証されたユーザーには、Cognos セキュリティー「パスポート」が与えられます。そして、Cognos TM1 アプリケーションは、このパスポートを使用してユーザーの権限 (ロールと所属グループ) および ID を確認します。

Cognos TM1 Applications を使用する際のセキュリティーの考慮事項Cognos TM1 Applications で使用する Cognos TM1 サーバーには、IBM Cognos

TM1 標準セキュリティー認証、または IBM Cognos セキュリティーのいずれかを使用できます。

同一の Cognos TM1 Applications のインストールに対して、異なるセキュリティー認証モードを組み合わせて使用しないでください。

Cognos TM1 Applications で Cognos TM1 サーバーを使用するように設定する前にセキュリティー・モードを決定して、追加するその他のサーバーでもその同じセキュリティー・モードを使用します。

図 10. LDAP の使用による認証のプロセス


Cognos セキュリティーの使用方法については、 292ページの『Cognos TM1

Applications での Cognos セキュリティーの使用』を参照してください。

Cognos TM1 Applications で IntegratedSecurityMode パラメーターを使用する

使用する各 Cognos TM1 サーバーの Tm1s.cfg ファイルで IntegratedSecurityMode

パラメーターを使用して Cognos TM1 セキュリティー認証モードを設定します。

重要: Cognos TM1 Applications コンポーネントは、Cognos TM1 セキュリティー認証モード 1 および 5 にのみ対応しています。

例えば、Cognos TM1 標準セキュリティー認証を使用するには、各サーバーでIntegratedSecurityMode パラメーターに 1 を設定します。


IBM Cognos セキュリティーを使用する場合は、IntegratedSecurityMode パラメーターに 5 を設定します。


IntegratedSecurityMode パラメーターの詳細については、「IBM Cognos TM1

Operations」の『TM1 システムの設定』のセクションを参照してください。

IBM Cognos TM1 サーバーおよび IBM Cognos TM1 Applications でIntegratedSecurityMode=5 が使用される場合、「権限の管理」ダイアログでネイティブ TM1 グループに権限を割り当てることはできません。 TM1 サーバーにインポートされている Cognos グループのみが使用可能になります。これは、使用できるグループが SecMode によって制限されるため、ネイティブ TM1 グループとCognos グループを同時に使用できないことを意味しています。

複数の Cognos TM1 サーバーに対する Cognos TM1 Applications セキュリティーの設定

複数の Cognos TM1 サーバーを Cognos TM1 Applications で使用する場合には、すべて同じセキュリティー認証 (Cognos TM1 標準認証か Cognos セキュリティーのどちらか) を使用するように設定し、同じ管理者のユーザー名とパスワードを入力する必要があります。

詳細については、 170ページの『複数の Cognos TM1 サーバーを使用するようにCognos TM1 Application Web を設定する』を参照してください。

ETLDAP ユーティリティーETLDAP ユーティリティーを使用すると、LDAP (Lightweight Directory Access

Protocol) ディレクトリーの情報を IBM Cognos TM1 に移動できます。

ETLDAP は、統合ログオンと LDAP 認証を使用して Cognos TM1 を使用する場合に、LDAP ユーザーを Cognos TM1 に追加するのに使用することができます。


注: 新しい LDAP ユーザーを Cognos TM1 に追加するには、ETLDAP ユーティリティーしか使用できません。ETLDAP は Cognos TM1 の既存のユーザーの変更、更新、または削除は行いません。

ETLDAP (LDAP のロード・ツール) には、以下の機能があります。

v LDAP または Active Directory サーバーからユーザー情報を抽出する。

v 要素 UniqueID を }ClientProperties ディメンション内に作成する。

v ユーザーを }ClientProperties キューブに追加する。

v IBM Cognos TM1 データベースに追加するユーザーのドメイン修飾されたユーザー名を }ClientProperties”キューブの UniqueID フィールドにセットする。例えば、[email protected] という名前を }ClientProperties キューブに書き込みます。

Cognos TM1 管理者は、ETLDAP を使用して次のタスクを実行できます。

v 多数のユーザー名を LDAP サーバーから Cognos TM1 データベースに簡単に追加する。

v 従来の LDAP データベースの情報を Cognos TM1 に移行する。

v Cognos TM1 内に作成するユーザーを 1 つまたは複数のクエリーで特定してから、そのユーザーを Cognos TM1 のセキュリティー・キューブにエクスポートする。

v Cognos TM1 に最初にユーザー・データをロードした後、LDAP サーバーに追加された新しいユーザーで Cognos TM1 を更新する。

注: 次のいずれかの統合セキュリティー・モードを使用するように Cognos TM1 サーバーが構成されている場合は、ETLDAP ユーティリティーを使用できません。

v 統合セキュリティー・モード 3 - 統合ログオン

v 統合セキュリティー・モード 5 - IBM Cognos Analytics 認証

詳細については、 363ページの『IntegratedSecurityMode』を参照してください。

LDAP 属性の変更LDAP ディレクトリーから取り出す属性値が、IBM Cognos TM1 セキュリティー・キューブに書き込もうとするデータと正確に一致しない場合があります。

その場合は、特定の LDAP 属性を変更してから、ETLDAP を実行する必要があります。

例えば、R&D、Quality Assurance、および Documentation という LDAP グループのすべてのユーザーを Engineering という 1 つの Cognos TM1 グループにまとめることも可能です。このような必要性に対応するには、オーバーライドが必要な 1 つのメソッドで Java クラスを拡張します。

stringFilter クラスには、次のシグニチャーを持つメソッドがあります。

String filterString(String attrName, String value)

このメソッドには、実行時に、マッピング・エントリーに一致する各 LDAP 属性の名前とその値が渡されます。 Cognos TM1 データベースには、このメソッドが返す文字列が追加されます。


以下のコードは、stringFilter クラスの実装を説明しています。R&D、Quality

Assurance、および Documentation という LDAP グループのすべてのユーザーをEngineering という 1 つの Cognos TM1 グループにまとめています。

stringFilter クラスは、LDAP の「ou」属性のインスタンス (Cognos TM1 のグループ名フィールド) を探します。値が「R&D」、「Quality Assurance」、または「Documentation」である場合は、「Engineering」を返します。この 3 つの LDAP

グループのいずれかに所属するユーザーは、「Engineering」という 1 つの Cognos

TM1 グループに追加されます。他のグループの値は変更されません。

// The stringFilter class provides the abilityto transformstrings

// which are read from the LDAP database before theyare inserted into // TM1’s datastore.

// To implement this feature, create a class which extendsstringFilter

// and contains a method ’filterString’ with the followingsignature:

//

// String filterString(String attrName, String value)

//

//

public class myStringFilter extends stringFilter

{

public String filterString(String attrName, String value)

{

if (attrName.equals("ou"))

{

if ( (attrName.equals("R&D")) ||

(attrName.equals("Quality Assurance")) ||

(attrName.equals("Documentation")) )

return "Engineering";

else

return value;

}

else

return value;

}

}

Java コードの作成とコンパイルが終了した後、このクラスを Classpath の任意の位置に記述します。その後、「編集」>「オプション」をクリックし、その名前を「クラス名」フィールドに入力します。


ETLDAP の実行ETLDAP は、Microsoft Windows オペレーティング・システムから実行することも、DOS コマンド・ウィンドウからコマンド行パラメーターを指定して実行することもできます。

手順1. Microsoft Windows オペレーティング・システムから ETLDAP を実行する場合、次の操作を実行します。

v 「スタート」>「プログラム」>「IBM Cognos」>「TM1」>「管理」>「ETLDAP」をクリックします。

v 必要な要素を設定します。

表 25. 「LDAP Load Tool (LDAP ロード・ツール)」ダイアログ・ボックスの要素。

フィールドまたはボタン説明

検索 DN検索を開始する LDAP ノードが表示されます。このレベルより上にあるツリー内のエントリーは、ETLDAP で検索されません。

フィルターディレクトリー内のエントリーをフィルターし、一致レコードを生成するクエリー文字列が表示されます。

属性検索で返されたレコードの検証を補助する LDAP エントリーの属性値が表示されます。LDAP 情報を TM1 にエクスポートする際は、有効な TM1 ユーザーを作成するために必要な属性が ETLDAP によって抽出されます。

注：属性は、表示目的のみに使用されます。

検索範囲検索の起点と検索レベルを指定します。「1 レベル」を選択すると、ベース検索 DN の 1 レベル下のすべてのエントリーが指定されます (ベース検索 DN 自体は検索されません)。「サブツリー・レベル」を選択すると、ベース DN も含めて、ベース DN の下のすべてのエントリーが検索されます。

結果テーブル検索結果が表示されます。列見出しをクリックすると、データを並べ替えることができます。行を右クリックし、「エントリーの表示」をクリックすると、そのエントリーのすべての属性を確認できます。

検索ボタン選択したパラメーターに基づいて検索が実行されます。

エクスポート・ボタン表示されているユーザー・セットが、「オプション」ダイアログ・ボックスの設定に基づいて、 TM1 にエクスポートされます。

2. DOS コマンド・ウィンドウから ETLDAP を実行する場合、次の操作を実行します。

v 「スタート」>「プログラム」>「アクセサリ」>「コマンドプロンプト」をクリックします。


v 次のコマンド行を入力します。

java etldap options

v 必要なパラメーターを追加します。

表 26. サポートされるコマンド行パラメーター


-f filename 保存されているセッション・ファイルの名前を渡して、以前のセッションの全設定をロードします。

ETLDAP を無人モード (バッチ・モード) で実行する場合は、セッション保存ファイルの名前を指定する必要があります。そのファイルに、LDAP と Cognos TM1 サーバーへの接続に必要なパスワードが含まれていない場合は、エラー・メッセージがログ・ファイルに出力され、セッションが終了します。

-batch ETLDAP をコマンド行モードで実行し、ユーザー・インターフェースは使用しません。-f オプションが必須です。

-secure ETLDAP をバッチ・モードで実行する場合は、このフラグを渡すことで、-f フラグで参照するセッション・ファイルから、パスワードの読み取り後にすべてのパスワードが削除されます。

このパラメーターは、セッションの最初に保存ファイルを読み出してから、パスワードを削除してファイルを書き直します。これを使用する場合は、ETLDAP を実行し、ユーザー・インターフェースでパスワードを指定します。次に、ETLDAP を終了し、'-secure' オプションを指定して、コマンド行バージョンを実行します。そうすることで、パスワードを使用できるのが、このユーティリティーを初期化するための短時間に限定されることになります。

-help これらのコマンド行パラメーターのオンライン・ヘルプが表示されます。

LDAP ログオン・パラメーターの設定LDAP ログオン・パラメーターは、次のように設定できます。

手順1. 「LDAP ロード・ツール」ダイアログ・ボックスで、「ファイル」>「接続」をクリックします。

2. ホストとユーザーに関する以下の情報を入力します。

パネルフィールド説明

ホスト情報ホストLDAP サーバーを実行しているマシンのホスト名または IP アドレスを入力します。



ポートLDAP サーバーが実行中のポート。ポートが指定されない場合、636 が使用されます。Cognos TM1 は、指定されたセキュア・ポートに LDAP サーバーをバインドしようとします。 LDAPPort 値を入力しなかった場合は、デフォルト値のポート 636 が Cognos TM1

で使用されます。

バージョンバージョン番号は、ほとんどの場合にETLDAP で無視されます。ほとんどの LDAP

サーバーでは、バージョン 2 またはバージョン 3 タイプの接続をサポートしており、ETLDAP はそのバージョンに特有の機能を使用しません。

SSL オプション (SSL

option) LDAP サーバーと ETLDAP との間の通信を、セキュリティーが確保された暗号化チャンネルで実行するかどうかを指定します。機密情報をセキュリティー保護されていないネットワーク経由で表示する場合を除き、このオプションはオフのままにしてください。

匿名オプションほとんどの LDAP サーバーには何らかのセキュリティー構成層があり、アクセスするユーザーが既知のユーザーであることを確認することが必要です。ただし、システムによっては、スキーマの取得はできませんが、ディレクトリーの参照を匿名ユーザーに許可している場合があります。また、基本的にはアクセスが許可されていないものの、匿名ユーザーでも、セキュリティー保護されていない一定領域のディレクトリーへのアクセスが可能なシステムもあります。



ユーザー情報(User Info)

ユーザー DSNほとんどの LDAP ディレクトリーでは、匿名ユーザーによるデータのアクセスやデータの変更が禁止されています。そのような場合にLDAP のセキュリティー情報を抽出するには、識別名 (DN) とパスワードが必要なことがあります。

例えば、Norm Lodin という名前が Blodget,

Inc. に勤務している人を指しているとします。そのユーザーは、ネットワーク内の他のすべてのエンティティーから自分を一意に識別する識別名を LDAP の内部に持っています。

このユーザーは、次の情報を「ユーザー情報」フィールドに入力します。

uid=nlodin, ou=People, o=Blodget.com

パスワードユーザー DN に対応するパスワードを入力します。

3. 接続が正常に確立されているかどうかを確認するには、「テスト」をクリックします。


これで、指定したパラメーターに基づいて LDAP サーバーへの接続が確立されています。

LDAP クエリーの作成LDAP クエリーを使用して、LDAP ユーザーおよびグループを IBM Cognos TM1

に追加します。

始める前に

LDAP クエリーは、以下の主要要素で構成されます。

v 検索 DN - LDAP ディレクトリーは、ルート・ノードおよびルート・ノードから分岐するいくつかのブランチがあるツリー構造に整理されています。検索 DN

は、検索を開始するノードを指定します。そのレベルより上にあるツリー内のエントリーが検索対象になります。必要な結果を得るには、ベース DN を正しく指定する必要があります。

v フィルター - LDAP ディレクトリー内のエントリーをフィルターし、一致するレコードを生成するクエリー文字列。次の記号を組み合わせて使用すると、複雑なフィルターを作成できます。

& (AND)

| (OR)

! (NOT)


* ワイルドカード文字

( ) ネスト用の括弧

LDAP フィルター文字列を作成する手順については、LDAP の関連書籍やオンライン・リソース (LDAP 標準、RFC 2254、『The String Representation of LDAP

Search Filters(LDAP 検索フィルターの文字列表現)』など) を参照してください。

v 範囲 - 検索 DN は検索の起点を指定しますが、範囲属性は検索を実行する深さレベルを示します。範囲レベルには、次の 2 つがあります。

1 レベル - LDAP がベース DN の 1 レベル下にあるすべてのエントリーを検索するように指定します (ベース DN 自体は検索対象外)。

サブツリー・レベル - LDAP がベース DN を含むすべてのレベルのすべてのレコードを検索するように指定します。

次の図で、範囲の設定が検索にどのように影響するかを説明します。

v 属性 - すべての LDAP エントリーとその値を記述します。フィルター文字列に一致するレコードについて返す値のコンマ区切りリストが含まれます。 LDAP 属性には、次の 2 つがあります。

ユーザー属性 - この属性はユーザーが LDAP ディレクトリーに追加します。例えば、cn、mail などです。

操作属性 - この属性は、LDAP サーバーによって作成され管理されます。例えば、numSubordinates などです。

エントリーの属性には、次のものがあります。

存在しても値がないもの

存在していて値が 1 つ以上あるもの

存在しないもの。属性がオプションの場合、その属性がエントリーに存在しないこともあります。

図 11. 範囲の設定が検索に与える影響


注: 必要な属性のみ要求するようにしてください。すべての属性を要求すると、結果セットが大きくなります。また、LDAP サーバーでの処理時間が大幅に長くなり、サーバーとクライアントの両方でメモリーの要件が増加します。

手順1. クエリーの検索 DN、フィルター文字列、属性、および範囲を指定します。

2. 「検索」をクリックします。

構文エラーがない場合、またはフィルター文字列がディレクトリー内のレコードと一致しない場合、エントリーの一覧がテーブルに表示されます。

3. 結果セットの内容を確認します。

v 希望しない名前が含まれていないかどうか。

v 重要なエントリーで足りないものがないか。

v 関心があるレコードの一覧を得るために、クエリーを複数作成する必要があるかどうか。

4. フィルター文字列に変更を加えます。

5. 「検索」をクリックします。

6. 結果セットの内容を確認します。

7. 必要なレコードの一覧が得られるまで、手順 3 から 6 までを繰り返します。

8. 「ファイル」→「名前を付けて保存」をクリックして、LDAP クエリーをテキスト・ファイルとして保存します。

注: 保存した LDAP クエリーは、後で使用することができます。それには、「LDAP Load Tool (LDAP ロード・ツール)」ダイアログ・ボックスで、「ファイル」>「開く」をクリックします。 LDAP クエリーの DN、フィルター文字列、属性、および範囲の設定値が ETLDAP によりセットされます。

Cognos TM1 サーバーへの接続IBM Cognos TM1 サーバーに接続するには、次の手順を実行します。

手順1. 「編集」>「ログオン」>「TM1」をクリックします。

2. 次のサーバー情報を入力します。

フィールド説明

ホストTM1 管理サーバーが稼働しているサーバーのマシン名。

SSL ポート管理サーバーが使用するポート番号構成を入力します。デフォルトは 5498 です。

サーバー接続先の TM1 サーバーの名前。

「サーバー」→「参照」ボタンをクリックし、サーバー一覧からサーバーを選択します。


フィールド説明

ユーザー名ターゲットの TM1 サーバーの管理権限を付与されたユーザーの名前。

パスワード管理ユーザーのパスワード。

3. 接続が正常に確立されているかどうかを確認するには、「テスト」をクリックします。


Cognos TM1 フィールドへの LDAP 属性のマッピングLDAP ディレクトリーには数多くの属性が格納されており、統一する属性もあれば、そのまま追加したり、環境に合わせてカスタマイズしたりする属性もあります。LDAP 属性と必要な IBM Cognos TM1 フィールドとの関係は、手動で指定する必要があります。

始める前に

LDAP スキーマを熟知している必要があります。

手順1. 「編集」>「マッピング」 >「TM1」をクリックします。

2. 必須 (赤色) の Cognos TM1 フィールドごとに、LDAP スキーマ属性を選択します。

Cognos TM1 では、ユーザーごとに名前とグループ名は一意であることが必要です。例えば、LDAP スキーマの name 属性は Cognos TM1 ユーザーにマッピングし、department 属性は Cognos TM1 グループにマッピングできます。


ETLDAP エクスポート・オプションの指定ETLDAP のエクスポート・オプションを指定できます。

手順1. 「編集」>「オプション」をクリックします。

2. 「統合ログオンを有効化」を選択します。

3. 転送するユーザーが含まれる領域名を入力します。

4. 「パスワードを保存」をオフにします。

「パスワードを保存」をオフにすると、ETLDAP は、サーバーへの接続に必要なすべてのパスワードを削除してから、セッション保存ファイルを書き込みます。次回 ETLDAP を実行するときは、パスワードをもう一度入力する必要があります。

5. 「最大検索結果数」および「検索時間制限」を 0 に設定します。



Cognos TM1 への LDAP 情報のエクスポートLDAP 情報は、次のようにして IBM Cognos TM1 にエクスポートできます。

手順1. 「エクスポート」をクリックします。

ETLDAP は、LDAP ディレクトリーから取得したレコードを TM1 に移動し、データのエクスポート処理をログ・ファイルに記録します。

注: レコードをエクスポートする前にログを開いておくことにより、エクスポートの進捗状況を追跡できます。

2. 「表示」→「ログ」の順にクリックして、セッション・ログを開きます。

セッション・ログにより、ETLDAP が Cognos TM1 にエクスポートして作成した LDAP ユーザーの概要が表示されます。ETLDAP は Cognos TM1 ユーザーのパスワードをランダムに生成して、Cognos TM1 データベースに追加します。

注: 統合ログオンを使用する場合、Cognos TM1 ユーザーは Cognos TM1 パスワードを使用しないので、Cognos TM1 と Microsoft Windows の間でパスワードを調整する必要はありません。統合ログオンが使用されていない場合、Cognos

TM1 ユーザーは、セッションに初めてログオンする時点で自分のパスワードを変更する必要があります。詳しくは、 263ページの『統合ログオン』を参照してください。

新しい LDAP ユーザーを追加するため ETLDAP を更新モードで実行するETLDAP を更新モードで実行することにより、IBM Cognos TM1 を更新し、Cognos TM1 中にまだ存在していない新しい LDAP ユーザーを追加できます。これを行うには、LDAP クエリーのフィルター・セクションに日付を指定します。


ETLDAP を初めて実行するときは、自組織に必要な条件を満足するすべてのレコードを LDAP サーバーから取得する必要があります。この条件は、フィルター・パラメーターを使用して定義します。ユーザーとグループのすべてのレコードを取り出した後、それらを IBM Cognos TM1 データベースにロードします。

ETLDAP を使用して最初に LDAP ユーザーを Cognos TM1 にロードした後は、Cognos TM1 に存在しない新しい LDAP ユーザーを取得して追加する際にのみツールを使用できます。ETLDAP ユーティリティーを使用して、LDAP ディレクトリーの変更に基づいて Cognos TM1 の既存のユーザーを更新および削除することはできません。

LDAP サーバーに新しいユーザーが追加されたら、LDAP クエリーのフィルター・セクションで日付を指定して Cognos TM1 に追加することができます。フィルター・セクションの日付を使用して、更新モードで ETLDAP を実行します。ETLDAP

を前回実行したとき以降の元の検索条件を満たす新しいユーザー・レコードのみを選択するように LDAP フィルターを編集することができます。


注: ETLDAP を更新モードで実行すると、Cognos TM1 に存在しない新しい LDAP

ユーザーのみを追加できます。ETLDAP はユーザー属性の更新や既存の Cognos

TM1 ユーザーの削除は行いません。

手順1. LDAP クエリーのフィルター・セクションに日付を指定するため、最後に変更されたレコード属性を判別します。

すべての LDAP サーバーは最後に変更されたレコード属性をサポートしており、これには以下のタイムスタンプが含まれます。

v 標準的な LDAP - modifytimestamp

v Microsoft Active Directory - whenChanged

エクスポート・セッションで ETLDAP がレコードを処理するときには、すべてのレコードが検査され、最も新しく変更されたレコードの日付が次の例のようにセッション・ログ・ファイルに記録されます。

newest record modified: Thu Jan 23 07:00:42 EST 2003(20030123070042.0Z)

2. LDAP セッション・ログで最新レコードの行を探します。

3. 括弧で囲まれた文字列のタイム・スタンプの部分を LDAP セッション・ログから LDAP クエリーのフィルター・セクションにコピーします。

注: LDAP フィルターがサポートする構文を必ず使用してください。詳細については、インターネット標準プロトコル・ドキュメント、RFC 2254 の『The

String Representation of LDAP Search Filters (LDAP 検索フィルターの文字列表現)』を参照してください。

次の表に、変更する前のフィルター文字列と、LDAP および Active Directory サーバー用に変更した後のサンプルを示します。

v 標準 LDAP サーバーでは modifytimestamp 属性を使用します。

v Microsoft Active Directory のある LDAP サーバーは whenChanged 属性を使用します。

フィルター文字列のサンプル変更後のフィルター文字列

初期の文字列(&(objectclass=person)(|(department=R&D)

(department=Documentation)))

標準的な LDAP 用に変更(&(objectclass=person)(modifytimestamp>

=20030515162433Z)(|(department=R&D*)

(department=QA)))

Active Directory 用に変更(&(objectclass=person)(whenChanged>

=20030515162433.0Z)(|(department=R&D*)

(department=QA)))

4. フィルター行に対して必要な変更を行ったら、インクリメンタル更新クエリーであることが明確に識別できる名前を付けて、セッション・データを保存します。

5. 新しいセッション・データを使用して ETLDAP を実行します。


統合ログオン統合ログオンを使用すると、Microsoft Windows のネットワーク認証によって、IBM

Cognos TM1 データへのアクセスを制御できます。

このセキュリティー・モデルでは、ETLDAP ユーティリティー (ETLDAP の実行を参照) を使用するか、他の手順を使用して、ユーザーとグループの Microsoft

Windows ログイン情報を Cognos TM1 データベースに移すことができます。Cognos TM1 クライアントから Cognos TM1 データにアクセスするユーザーは、まず Microsoft Windows にログインする必要があります。Microsoft Windows に正しくログインできたら、Cognos TM1 からログイン情報を求められることはありません。

統合ログオンでは、Microsoft Windows へのログインに使用するドメイン修飾された名前と、}ClientProperties キューブの UniqueID フィールドの名前が照合されます。一致した名前があれば、Cognos TM1 へのログインが許可されます。

例えば、Robert というユーザー名で company.com というドメインにログインするとします。サーバー・エクスプローラーでサーバーをダブルクリックすると、Cognos TM1 によって }ClientProperties キューブがチェックされ、そのキューブのUniqueID フィールドが調べられます。Robert のドメイン修飾した名前はrobert@company です。Robert が Robert という名前で COMPANY ドメインにログインしている限り、そのユーザーに対して統合ログオンは正しく機能します。

統合ログオンで Microsoft Windows へのログインに使用するドメイン修飾された名前と }ClientProperties キューブの UniqueID フィールドの名前が一致しない場合は、Cognos TM1 は、クライアント名がサーバーに存在しないというエラー・メッセージを表示します。

統合ログオンは、Microsoft Windows のみでサポートされています。統合ログオンを使用して、UNIX バージョンの Cognos TM1 サーバーにアクセスすることはできません。

統合ログオンを使用するための Cognos TM1 の設定以下のチェックリストを指針として使用して、すべてのユーザーのログオン認証方式として統合ログオンを使用するように IBM Cognos TM1 コンポーネントを設定します。

1. Cognos TM1 サーバーのインストールを完了し、サーバーの実行とログオンが可能なことを確認してください。

2. ETLDAP ユーティリティーを実行し、ユーザーとグループのログオン・データを LDAP ディレクトリーから抽出して、TM1 セキュリティー・キューブにロードします。ETLDAP を使用すると、指定する LDAP データから Cognos TM1

ユーザーを作成できます。このユーザーは、LDAP ディレクトリーで割り当てられていたグループと同じグループに所属します。

詳しくは、 254ページの『ETLDAP の実行』を参照してください。

3. 統合ログオンを使用するように Cognos TM1 サーバー・コンポーネントおよびクライアント・コンポーネントを設定します。


表 27. Cognos TM1 コンポーネントの統合ログオン設定の要約

コンポーネント必要な設定

Cognos TM1 サーバー統合ログオンで使用する TM1 データベースに関する統合ログオン・パラメーターを Tm1s.cfg ファイルで設定します。

詳しくは、 265ページの『Cognos TM1 サーバーの統合ログオンの設定』を参照してください。

Cognos TM1 クライアント Cognos TM1 Architect および Cognos TM1

Perspectives の「統合ログオンを使用」オプションを有効にします。

詳細については、 274ページの『統合ログオンを使用するための Cognos TM1 Perspectives の設定』および 274ページの『統合ログオンを使用するためのCognos TM1 Architect の設定』を参照してください。

Cognos TM1 Web Cognos TM1 Web の以下の設定を行います。

tm1web_config.xml ファイル: tm1web_config.xml ファイル内のパラメーターを編集して、Cognos TM1

サーバー Web への統合ログオンを有効に設定します。注: さらに、Kerberos セキュリティーの設定を手動で検証または設定する (あるいはその両方を行う) 必要がある場合もあります。

4. Cognos TM1 ユーザーのアクセス権限を設定します。

詳しくは、『Cognos TM1 ユーザーのアクセス権の設定』を参照してください。

Cognos TM1 ユーザーのアクセス権の設定IBM Cognos TM1 ユーザーがデータにアクセスするためには、そのユーザーを他のCognos TM1 グループに割り当てる必要が生じる可能性があります。このトピックでは、ユーザーを Admin グループに追加する方法について説明します。

例えば、あるユーザーが Cognos TM1 Web から共有オブジェクトを Web に発行する場合、そのユーザーは、Cognos TM1 Admin グループのメンバーであることが必要です。

手順1. Cognos TM1 Architect を開始します。

2. 「ファイル」>「オプション」をクリックします。

3. 「統合ログオンを使用」オプションをオフにします。


5. サーバー・エクスプローラーのツリー・ウィンドウで、TM1 をダブルクリックして、サーバーの一覧を開きます。

6. サーバー名をダブルクリックします。

7. 管理者のログイン ID とパスワードを使用してログインします。


v 管理者名 (デフォルト)- admin

v 管理者パスワード (デフォルト)- apple

8. サーバー名を右クリックし、「セキュリティー」>「クライアント/グループ」をクリックします。

9. Admin グループに追加するユーザーを選択します。スクロール・バーを使用して左にスクロールすると、グループの一覧が表示されます。

10. ユーザーを Admin グループに追加するには、そのユーザーの ADMIN 列のチェック・ボックスを選択します。


Cognos TM1 サーバーの統合ログオンの設定Cognos TM1 を再インストールすることなく、統合ログオンを使用するように IBM

Cognos TM1 インストール済み環境を変更できます。そのためには、ETLDAP を実行して、いくつかの Cognos TM1 設定ファイルを変更します。

手順1. ETLDAP を実行し、ユーザーとグループの情報を LDAP サーバーからインポートします ( 254ページの『ETLDAP の実行』を参照)。

2. Cognos TM1 サーバーを停止します。

3. Cognos TM1 サーバーのデータ・ディレクトリーにある Tm1s.cfg ファイルで、以下のパラメーターを編集します。

v IntegratedSecurityMode パラメーターを 2 に設定します。

v SecurityPackageName パラメーターに、統合ログオンで使用する Kerberos (デフォルト) などのセキュリティー・プロトコルを設定します。

次の例では、Kerberos を使用するようにサーバーを設定しています。

[TM1S]

SecurityLogging=F

SecurityPackagename=Kerberos


Servername=myserver

DatabaseDirectory=C:\Program Files\

4. Tm1s.cfg を保存して終了します。


6. 関連付けられたユーザー・インターフェースで「統合ログオンを使用」オプションを設定して、統合ログオンを使用するように個々の Cognos TM1 クライアントを構成します。

v 274ページの『統合ログオンを使用するための Cognos TM1 Architect の設定』.

v 274ページの『統合ログオンを使用するための Cognos TM1 Perspectives の設定』.


タスクの結果

これで、Cognos TM1 Architect または Cognos TM1 Perspectives から統合ログオンを使用して Cognos TM1 サーバーにログオンできます。

Cognos TM1 Web への統合ログオン設定方法については、『Kerberos と JAAS を使用した Cognos TM1 Web の統合ログオンの設定』を参照してください。

Kerberos と JAAS を使用した Cognos TM1 Web の統合ログオンの設定Kerberos セキュリティー・プロトコルによる統合ログオンを使用するように IBM

Cognos TM1 Web をセットアップすることができます。これは、TM1

IntegratedSecurityMode=3 で使用可能な認証のタイプです。


Cognos TM1 Web バージョン 10.2 では、 Microsoft Windows 認証情報を Cognos

TM1 Web ログオン・ダイアログ・ボックスに入力する必要があります。ログオン・ダイアログ・ボックスでは、ネイティブの TM1 ログオンまたは Microsoft

Windows ログオンを選択できます。

Cognos TM1 Web を Kerberos 環境で実行するには、 Kerberos が Cognos TM1

Web サービスを実行している Java Runtime で機能するように、その環境を正しく設定する必要があります。

手順1. Kerberos 設定ファイルを指定します。

Windows システムでは、Kerberos 設定ファイルは krb5.ini です。 Linux では、ファイルは krb5.conf です。

以下に、Windows Kerberos 設定ファイル (krb5.ini) の例を示します。

[libdefaults]default_realm = <REALM_NAME>default_tkt_enctypes = rc4-hmac des-cbc-crcdefault_tgs_enctypes = rc4-hmac des-cbc-crcticket_lifetime = 1200[realms]<REALM_NAME> = {kdc = 9.24.213.202admin_server = <server_name.domain_name>default_domain = <DOMAIN_NAME>}[domain_realm].<domain_realm_name> = <DOMAIN_REALM_NAME>

[appdefaults]autologin=trueforward=trueforwardable=trueencrypt=true

2. java.security ファイルに JAAS ログオン機能を指定します。

以下は、java.security ファイルに JAAS ログオン機能を指定する方法の例を示しています。


# Default login configuration file#login.config.url.1=file:${user.home}/.java.login.configlogin.config.url.1=file:${java.home}/lib/security/login.config

以下は、IBM Java Runtime のログオン設定ファイルの内容の例を示しています。

TM1SignedOnUserLoginContext {com.ibm.security.auth.module.Krb5LoginModule requireduseDefaultCcache=falsecredsType=initiator;

};

以下は、SUN Java Runtime のログオン設定ファイルの内容の例を示しています。

TM1SignedOnUserLoginContext {com.sun.security.auth.module.Krb5LoginModule requireduseTicketCache="true"useKeyTab="true" keyTab="krb5.keytab" ;

};

3. ログオン設定ファイルを指定します。

4. tm1web_config.xml ファイル内の IntegratedSecurityModuleName パラメーターを設定します。

IntegratedSecurityModuleName パラメーターに関連付けられた値が、Kerberos

環境に関連付けられた LoginModule の名前に設定されていることを確認してください。

<add key=“IntegratedSecurityModuleName” value=“name of the

LoginModule”/>

5. Cognos TM1 サーバーのための Windows サービスが、承認されたドメイン・アカウントによって所有されていることを確認してください。

6. ログオンしているユーザーが、kinit 手順によってセットアップされた正しいチケットを所持していることを確認してください。

Kerberos と SPNEGO を使用した Cognos TM1 Web の統合ログオンの設定統合ログオン (Kerberos) およびアプリケーション・サーバーのセキュリティー層を使用して、 IBM Cognos TM1 Web のシングル・サインオンを設定できます。シングル・サインオンを使用すれば、HTTP ベースのクライアントを実行するユーザーは、TM1 Web に 1 回だけログインすればよくなります。

概説

Kerberos を使用してクライアントを認証するように、IBM WebSphere Application

Server を設定する必要があります。 Kerberos を使用するアプリケーション・サーバーでクライアントが認証されると、 TM1 Web は、Kerberos の資格情報を使用して、統合ログオンが設定された TM1 サーバーにそのユーザーをサインインさせます。セットアップ処理には、以下の設定が必要です。

クライアントからアプリケーション・サーバーへのシングル・サインオンWebSphere Liberty Profile では、Simple and Protected GSS-API Negotiation

Mechanism (SPNEGO) Web 認証プロバイダーを使用してシングル・サイン


オンを実装できます。このプロバイダーは、Kerberos 対応のクライアントがWebSphere Liberty Profile へのシングル・サインオンを使用できるようにします。 Windows では、このアプローチによって、ユーザーは一度 Windows

ドメインで認証を受けるだけで WebSphere Liberty にシングル・サインオンすることができます。

アプリケーション・サーバーに配布されている TM1 Web からのシングル・サインオン WebSphere Liberty から、統合ログオンを設定した TM1 サーバーへのシン

グル・サインオンでは、 Java Generic Security Services API (JGSS) と Java

Authentication and Authorization Services (JAAS) を使用して、受け取ったKerberos 資格情報を TM1 Web に委任します。

このセットアップを正常に実施すれば、ユーザーは、セキュリティー・モード 2 または 3 (統合ログオン) で実行されている TM1 サーバーに対して設定された TM1

Web で、Windows のユーザー資格情報を使用して認証を受けることができます。

始める前に

次の前提条件が構成済みであることを確認してください。

v このセットアップに参加するすべてのコンピューターが Microsoft Windows を実行していて、Windows ドメインに参加していること。セットアップに含まれるコンピューターの間にトラステッド・パスが存在すること。

v セットアップに含まれるすべてのコンピューターが、構成内の他のすべてのコンピューターと Windows ドメイン・コントローラーの完全修飾ドメイン名を解決できること。

v TM1 サーバーのインスタンスに、以下の設定で統合ログオンが構成されていること。

– TM1 アプリケーション・サーバー・インスタンスの Windows サービスを実行する Windows アカウントにサービス・プリンシパル名 (SPN) を登録します。

– tm1s.cfg の ServicePrincipalName パラメーターにその SPN を設定します。

– tm1s.cfg ファイル内の IntegratedSecurityMode を 2 または 3 に設定します。

– SecurityPackageName を Kerberos に設定します。

– TM1 サーバーにアクセスするすべてのユーザーについて、}ClientProperties

ディメンションの UniqueID プロパティーに <domain>/<sAMAccountName> という構文の文字列を設定します。

v セットアップに含まれるコンピューターに TM1 アプリケーション・サーバーのインスタンスがインストールされていること。

v ドメイン・ユーザーが、TM1 アプリケーション・サーバー・コンポーネントがインストールされているコンピューターとは別のクライアント・コンピューターにログインできること。そのユーザーが、サポート対象ブラウザーを実行して TM1

Web にアクセスできること。詳細については、 273ページの『統合ログオンのための Web ブラウザーの設定』を参照してください。

表記

このセットアップでは、以下の表記を使用します。


<TM1APP_DOMAIN>Microsoft Windows ドメインの名前 (例: mydomain.sample.com)。

<TM1APP_REALM>大文字の <TM1APP_DOMAIN> (例: MYDOMAIN.SAMPLE.COM)。

<TM1APP_HOST>TM1 Application Server がインストールされているコンピューターの完全修飾ホスト名 (例: appsrv1.mydomain.sample.com)。

<TM1APP_ACCOUNT>TM1 アプリケーション・サーバーを実行するために使用する Windows ドメインのユーザー・アカウント。

TM1 Application Server 用のアカウントのセットアップ1. ドメイン管理者は、TM1 アプリケーション・サーバー・サービスを実行するために使用するドメイン・ユーザー・アカウントを作成するか、既存のドメイン・ユーザー・アカウントを見つけなければなりません。そのユーザー・アカウントを <TM1APP_ACCOUNT> と表します。例えば、mydomain/pa11 です。

2. Microsoft setspn ツールを使用して、その <TM1APP_ACCOUNT> アカウントにHTTP サービス・クラスの SPN を登録します。これにより、WebSphere Liberty

は Kerberos 対応の Web サービスになります。ドメイン管理者としてコマンド・ウィンドウを開き、以下のコマンドを入力します。

setspn -U -F -S HTTP/<TM1APP_HOST> <TM1APP_ACCOUNT>

例:

setspn -U -F -S HTTP/appsrv1.mydomain.sample.com mydomain/pa11

ヒント: setspn -l <TM1APP_ACCOUNT> を使用して、SPN が正常に登録されたことを確認します。

3. 完全修飾名の代わりに appsrv1 などの NetBIOS 名を使用する場合は、サーバーの NetBIOS 名を使用して setspn コマンドを繰り返して、SPN をもう 1 つ登録します。

4. <TM1APP_HOST> で、TM1 アプリケーション・サーバーを実行する Windows

サービスが <TM1APP_ACCOUNT> で開始されることを確認します (1を参照)。

a. Windows サービスのコントロール・ウィンドウで「IBM Cognos TM1」サービスを右クリックし、「プロパティー」をクリックします。

b. 「ログオン」タブで、<TM1APP_ACCOUNT> とパスワードを追加します。


5. <TM1APP_HOST> で、Microsoft ktpass ツールを使用して Kerberos キータブ・ファイルを作成します。

注: WebSphere Liberty で Kerberos 認証をサポートするには、サーバー資格情報が必要です。その資格情報は、キータブ・ファイルで保管します。そのファイルを作成するには、Microsoft ktpass ツールを使用する必要があります。

CMD ウィンドウで、以下のコマンドを入力します。

ktpass -put <keytab_file> -princ <SPN>@<TM1APP_REALM> -mapuser <TM1APP_ACCOUNT>-pass <password> -mapOp set -ptype KRB5_NT_PRINCIPAL


例:

ktpass -out krb5.keytab -princ HTTP/[email protected] mydomain\pa11 -pass pssw0rd -mapOp set -ptype KRB5_NT_PRINCIPAL

このコマンドを実行すると、Kerberos サーバー資格情報の入った krb5.keytab

ファイルが現在のフォルダーに作成されます。

ヒント:

JRE klist ツールを使用すれば、キータブ・ファイルの内容を表示できます。例:

<TM1_ROOT>/bin64/jre/7.0/bin/Klist -kt krb5.keytab

WebSphere Liberty のための SPNEGO/Kerberos Web 認証の設定1. <TM1APP_HOST> で、WebSphere Liberty のための Kerberos 設定ファイルを作成します。

テキスト・エディターを使用して、ファイルを作成し、以下の内容を貼り付けます。

[libdefaults]default_realm = <TM1APP_REALM>default_keytab_name = FILE:<keytab_file>default_tkt_enctypes = aes128-cts-hmac-sha1-96default_tgs_enctypes = aes128-cts-hmac-sha1-96forwardable = truerenewable = truenoaddresses = trueclockskew = 300udp_preference_limit = 1

[realms] <TM1APP_REALM> ={

kdc = <TM1APP_DOMAIN>:88default_domain = <TM1APP_DOMAIN>

}[domain_realm]

.<TM1APP_DOMAIN> = <TM1APP_REALM>

変数を実際の環境の値に置き換え、ファイルを krb5.ini という名前で保存します。

注:

v default_keytab_name = には、5 (269ページ) で作成したキータブ・ファイルを入力する必要があります。

v default_tkt_enctypes = aes128-cts-hmac-sha1-96 と入力しているのは、1

つの例です。実際の環境でサポートされている暗号タイプを使用する必要があります。

v Active Directory フォレストのドメイン・ツリーの構造によっては、Kerberos

設定ファイルの [realms] と [domain_realm] のセクションに追加の入力が必要になります。ドメイン構造について Active Directory の管理者に確認してください。 Kerberos 設定ファイルについて詳しくは、「WebSphere Application

Server Network Deployment」の資料で『Kerberos 構成ファイル』を参照してください。


http://www.ibm.com/support/knowledgecenter/SSAW57_8.5.5/com.ibm.websphere.nd.doc/ae/rsec_SPNEGO_config_krb5.html

2. JRE kinit ツールを使用して、SPN の Kerberos チケットを要求し、Kerberos

構成ファイルを検証します。

<TM1_ROOT>/bin64/jre/7.0/bin/kinit/kinit -kt <keytab_file> HTTP/<TM1APP_HOST>

例:

<TM1_ROOT>/bin64/jre/7.0/bin/kinit -k -t krb5.keytabHTTP/appsrv1.mydomain.sample.com

このツールで、チケットがデフォルトのチケット・キャッシュに格納されていることを確認します。

3. JRE klist ツールを使用して、Kerberos チケットを表示します。

例:

<TM1_ROOT>/bin64/jre/7.0/bin/klist

WebSphere Liberty サーバー設定の変更

以下の手順により、WebSphere Liberty サーバーの設定ファイルを手動で変更できます。 Cognos Configuration でアプリケーション・サーバーの構成ファイルを再生成しなければならない変更を行うと、以下の手動変更は元に戻されます。そのため、手動の構成変更が完了したら、server.xml ファイルをバックアップしてください。

1. TM1 アプリケーション・サーバーを停止します。

2. テキスト・エディターで、<TM1_ROOT>/wlp/usr/server/tm1/server.xml ファイルを開きます。

3. </featureManager> 要素の前に、以下のフィーチャー要素を追加します。

<feature>appSecurity-2.0</feature><feature>ldapRegistry-3.0</feature><feature>spnego-1.0</feature>

4. <application id=”tm1”...> タグの前に、以下の要素を追加します。

<ldapRegistryid="ldap"realm="<TM1APP_DOMAIN>"host="<TM1APP_DOMAIN>"port="389"ignoreCase="true"baseDN="<base_DN>"bindDN="<binduser_accountDN>"bindPassword="<binduser_password>"ldapType="Microsoft Active Directory"

/>

host にドメイン名を使用すると、 Microsoft の DNS ロケーター機能が使用されます。これにより、参照先のドメイン・コントローラーが使用不可になった場合に単一障害点を回避できます。通常、baseDN は、文字列 cn=Users と、ドメイン名の各部分を表す要素をコンマで区切ったリストから構成されます。

例:

Domain: mydomain.sample.comBaseDN: cn=Users,dc=mydomain,dc=sample,dc=com

binduser_accountDN は、参照先のドメインのユーザー・アカウント (そのドメイン内のすべてのユーザー項目に対する参照権限を持つユーザー・アカウント)

の識別名でなければなりません。


例:

cn=admin1,cn=Users,dc=mydomain,dc=sample,dc=com

WebSphere Liberty は、LDAP レジストリー要素に基づいて、Kerberos で認証しようとしているユーザーの情報を検索する場所を決定します。したがって、LDAP レジストリーは、認証しようとしているユーザーが属しているドメインを参照していなければなりません。複数のドメインに属しているユーザーの認証を1 回だけで済ませるには、ドメインごとに 1 つの LDAP レジストリーを定義する必要があります。複数の LDAP レジストリーは自動的に統合されます。

注: 詳細については、Knowledge Center の Configuring Liberty での LDAP ユーザー・レジストリーの構成を参照してください。

5. WebSphere Liberty で SPNEGO/Kerberos Web 認証を有効にするには、<ldapRegistry> 要素の後に以下の要素を追加します。

<spnegoid="mySpnego"krb5Config="<krb5.ini>"krb5Keytab=”<keytab_file>"servicePrincipalNames="HTTP/<TM1APP_HOST>@<TM1APP_REALM>"/>

ヒント: IBM WebSphere securityUtility を使用すれば、server.xml ファイル内のパスワードをエンコードできます。

6. オプションとして、ロギング設定を編集し、SPNEGO/Kerberos Web 認証のトレース出力を指定することもできます。

例:

<loggingconsoleLogLevel="WARNING"traceSpecification="*=warn:com.ibm.ws.security.spnego.*:all"logDirectory="${wlp.user.dir}/../../logs"messageFileName="tm1_messages.log"maxFiles="2"maxFileSize="20"/>

TM1 Web に WebSphere Liberty のセキュリティーを設定する1. server.xml ファイルで、TM1 Web アプリケーションの項目を見つけて、以下の例に示すように変更します。

<application id="tm1web"location="${wlp.user.dir}/../../webapps/tm1web"name="tm1web"type=”war” context-root=”tm1web”><application-bnd>

<security-role name="AllAuthenticated"><special-subject type="ALL_AUTHENTICATED_USERS" />

</security-role></application-bnd>

</application>

2. server.xml ファイルを保存してバックアップします。

SPNEGO によるシングル・サインオンを設定する1. TM1 Web の web.xml ファイルにセキュリティー制約を追加します。


http://www.ibm.com/support/knowledgecenter/SSEQTP_liberty/com.ibm.websphere.wlp.nd.multiplatform.doc/ae/twlp_sec_ldap.html

http://www.ibm.com/support/knowledgecenter/SSEQTP_liberty/com.ibm.websphere.wlp.nd.multiplatform.doc/ae/twlp_sec_ldap.html

<TM1APP_HOST> で、テキスト・エディターを使用して、<TM1_ROOT>/webapps/tm1web/WEB-INF/web.xml ファイルを編集します。最初の<filter> 要素の前に、以下の内容を追加します。

<login-config><auth-method>BASIC</auth-method><realm-name>MYTM1SERVER.EXAMPLE.COM</realm-name>

</login-config><security-role>

<role-name>AllAuthenticated</role-name></security-role><security-constraint>

<web-resource-collection><web-resource-name>tm1web</web-resource-name><url-pattern>/*</url-pattern><url-pattern>/</url-pattern><http-method>POST</http-method><http-method>GET</http-method>

</web-resource-collection><auth-constraint>

<role-name>AllAuthenticated</role-name></auth-constraint>

</security-constraint>

2. ファイルを保存します。

3. TM1 Application Server サービスを開始します。

4. リモート・コンピューター (<TM1APP_HOST> 以外のコンピューター) でKerberos 対応のブラウザーを開き、以下のアドレスにアクセスします。

HTTP://<TM1APP_HOST>:9510/tm1web

TM1 サーバーのインスタンスを選択すると、プロンプトなしで認証が完了します。

トラブルシューティングv ブラウザーに SPNEGO/Kerberos が正しく設定されていることを確認してください。詳細については、『統合ログオンのための Web ブラウザーの設定』およびSPNEGO を使用するためのクライアント・ブラウザーの構成を参照してください。

v テストに使用している Windows ユーザーがドメイン管理者でないことを確認してください。Kerberos ではドメイン管理者は委任できません。

v リモート・コンピューターでテストを実行していることを確認してください。TM1 Web と同じコンピューターでブラウザーが実行されていると、SPNEGO が失敗することがあります。

v <spnego> 構成の disableFailOverToAppAuthType 属性が false に設定されていることを確認します。

統合ログオンのための Web ブラウザーの設定IBM Cognos TM1 Web で統合ログオンを設定した後、Cognos TM1 Web にアクセスするクライアント・システム上の Web ブラウザーを設定する必要があります。

手順1. Microsoft Internet Explorer を使用している場合、Cognos TM1 Web URL が信頼済みサイトであることを指定します。


https://www.ibm.com/support/knowledgecenter/SSEQTP_8.0.0/com.ibm.websphere.base.doc/info/aes/ae/tsec_SPNEGO_configweb_new.html

例えば、Internet Explorer の「現在のユーザー名とパスワードで自動的にログオンする」オプションおよび「統合 Windows 認証を使用する」オプションを有効にします。

詳細は、Microsoft Internet Explorer の資料を参照してください。

2. Mozilla Firefox を使用している場合、以下の設定を見つけて編集し、そこにTM1 Web サーバーの場所の URL 接頭部またはドメインのコンマ区切りリストを含めます。

network.automatic-ntlm-auth.trusted-uris

network.negotiate-auth.delegation-uris

network.negotiate-auth.trusted-uris

例えば、Cognos TM1 Web をローカルで実行する場合は localhost を入力し、専用の Web サーバーで Cognos TM1 Web を実行する場合はサーバー名を入力します。

詳細については、使用している Mozilla Firefox が提供しているドキュメントを参照してください。

統合ログオンを使用するための Cognos TM1 Architect の設定IBM Cognos TM1 サーバーの統合ログオンをセットアップした後、それを使用してCognos TM1 Architect によって Cognos TM1 データにアクセスできるようになります。

手順1. Cognos TM1 Architect を実行します。


3. 「統合ログオンを使用」チェック・ボックスがオンになっていることを確認します。


5. サーバー・エクスプローラーのツリー・ウィンドウで、ダブルクリックして、サーバーの一覧を開きます。

6. LDAP からユーザーおよびグループの情報をエクスポートした先のサーバーをダブルクリックします。

ユーザー名とパスワードの入力を要求するプロンプトが出されずにログオンすることになります。

統合ログオンを使用するための Cognos TM1 Perspectives の設定IBM Cognos TM1 サーバーの統合ログオンをセットアップした後、それを使用してCognos TM1 Perspectives によって Cognos TM1 データにアクセスできるようになります。

手順1. Microsoft Excel を実行します。

2. 「TM1」→「サーバー・エクスプローラー」をクリックします。

TM1 サーバー・エクスプローラーが表示されます。



4. 「統合ログオンを使用」チェック・ボックスがオンになっていることを確認します。


6. サーバー・エクスプローラーのツリー・ウィンドウで、ダブルクリックして、サーバーの一覧を開きます。

7. LDAP からユーザーおよびグループの情報をエクスポートした先のサーバーをダブルクリックします。

TM1 Perspectives によって、Cognos TM1 に自動的にログオンされます。ユーザー名とパスワードは要求されません。

統合ログオンを使った Cognos TM1 Web へのログオン統合ログオンを使用するように IBM Cognos TM1 サーバーおよび Cognos TM1

Web を設定した後、この認証モードを使用してログオンし、Cognos TM1 Web によってデータにアクセスできるようになります。TM1 10.2 の時点では、TM1 Web

がシングル・サインオンをサポートしていないことに注意してください。 TM1

Web にログオンするためには、ユーザー名とパスワードの組み合わせを指定する必要があります。

手順1. Microsoft Internet Explorer を実行します。

2. 次の URL をブラウザーの「アドレス」ボックスに入力します。

http://web_server_name:port_number /tm1web/

例: http://localhost:9510/tm1web/

3. Cognos TM1 サーバー管理サーバーのホスト名を「管理ホスト」フィールドに入力します。

4. 「サーバー」の矢印をクリックします。

5. 「ログイン」をクリックします。

6. ユーザー名とパスワードを入力します。

LDAP 認証LDAP サーバーを使用して IBM Cognos TM1 認証をセットアップできます。

LDAP サーバーによるユーザーの検証LDAP による検証を使用すると、すべてのユーザー・パスワードを外部の LDAP サーバーにまとめることができます。

IBM Cognos TM1 ユーザーがログオンする際、ユーザーが指定するユーザー名とパスワードは、LDAP サーバーに保持されている情報と照合されて検証されます。サーバーがLDAP 認証のために接続する前に、使用するパスワードとキーは指定できます。また、パスワードを使用せずに、サーバーに直接接続することもできます。

LDAP 認証をセットアップする担当者には、前提条件として、LDAP 自体とネットワーク・セキュリティー体系における LDAP の役割に関する高度な知識が必要で


す。自社ネットワークの LDAP 管理者でない場合は、LDAP 管理者と相談しながら、LDAP 認証を使用するように Cognos TM1 を適切にセットアップしてください。

注: Cognos TM1 と正常に通信するためには、LDAP サーバーが SSL を使用するように設定されていなければなりません。

LDAP 認証パラメーターLDAP 認証を設定してサポートするには、tm1s.cfg ファイルで以下のパラメーターを使用します。

PasswordSource:

ユーザーが入力したパスワードと保存されているパスワードを比較します。

パラメーター・タイプ: オプション、静的

Cognos TM1 (デフォルト): ユーザーが入力したパスワードを Cognos TM1 データベース内のパスワードと比較します。

LDAP: ユーザーが入力したパスワードを LDAP サーバーに格納されているパスワードと比較します。

LDAPHost:

LDAP サーバー・ホストのドメイン名、またはその IP アドレスのドット付き文字列表現を指定します。


LDAPHost の値を入力しない場合は、デフォルト値の localhost が IBM Cognos

TM1 で使用されます。

LDAPPasswordFile:

LDAPUseServerAccount が使用されていない場合に使用するパスワードファイルを定義します。これは、IBM Cognos TM1 サーバーの管理サーバーの秘密鍵の暗号化パスワードを含む .dat ファイルの絶対パスです。

パラメーターの型: オプション ( 278ページの『LDAPUseServerAccount』=F の場合は例外)、静的

このパラメーターは、.dat ファイルへの絶対パスを使用します。

LDAPPasswordKeyFile:

LDAPUseServerAccount が使用されていない場合に使用するパスワード・キーを定義します。



このパラメーターは、秘密鍵のパスワードの暗号化/暗号化解除に使用するキーを含む .dat ファイルの絶対パスを使用します。

このファイルは、tm1crypt ユーティリティーを使用して生成する必要があります(説明は、 318ページの『TM1Crypt ユーティリティーの実行』を参照してください)。

LDAPPort:

IBM Cognos TM1 が LDAP サーバーへのバインドに使用するポートを指定します。


636 などのセキュア (SSL) ポートを指定します。

デフォルト値: 389 (無保護ポート)

LDAPSearchBase:

LDAP ツリーの中で、IBM Cognos TM1 が有効なユーザーの検索を開始するノードを指定します。


LDAP ディレクトリー内のベース識別名 (DN)。例:

ou=people,o=company.com

例えば、識別名の形式が次のようになっている場合は、

uid-bjensen, ou-people, o=company.com

検索ベースは、次のようになります。

ou-people, o=company.com

LDAPSearchField:

検証されている IBM Cognos TM1 ユーザー名を含むことが予期される LDAP 属性の名前。


LDAPSearchField 値を入力しなかった場合のデフォルト値は cn です。Microsoft

Active Directory の場合もデフォルト値は同じです。

LDAPSkipSSLCertVerification:

LDAP サーバーに対する認証に使用する SSL 証明書に関する信頼性検証ステップをスキップします。このパラメーターは、LDAPVerifyServerSSLCert=T の場合のみ適用されます。



信頼性検証が作動しない場合は、LDAPSkipSSLCertVerification=T を指定して、信頼性検証ステップをスキップできます。この場合、TM1 はサーバー証明書をまったく検証せず単に受け入れます。

注: このパラメーターを処理する場合は、その前に SSL と LDAP に精通しておく必要があります。

デフォルト値: F

LDAPSkipSSLCRLVerification:

LDAP サーバーに対する認証に使用する SSL 証明書に関する CRL 検査をスキップします。このパラメーターは、LDAPVerifyServerSSLCert=T の場合のみ適用されます。


LDAPVerifyServerSSLCert=F の場合、このパラメーターは必要ありません。Microsoft Windows API は、空の CRL 証明書や存在しない CRL 証明書を許容できます。



LDAPUseServerAccount:

LDAP 認証を使用する場合に、サーバーへの接続にパスワードが必要かどうかを指定します。


v 統合認証を使用して LDAP サーバーに直接接続する場合は、このパラメーターをT に設定します。IBM Cognos TM1 サーバーと LDAP サーバーが同じドメイン上に存在する場合は、このパラメーターを必ず T に設定してください。

v 接続する前にパスワードを使用する場合は、このパラメーターを F に設定します。 LDAPUseServerAccount を F に設定した場合に SSL を使用して LDAP サーバーに正常に接続するには、 276ページの『LDAPPasswordFile』と 276ページの『LDAPPasswordKeyFile』も設定する必要があります。

LDAPVerifyCertServerName:

LDAP サーバー認証における SSL 証明書の検証プロセス中に使用するサーバーを指定します。このパラメーターは、LDAPVerifyServerSSLCert=T の場合のみ適用されます。




このパラメーターを使用して、受信した SSL 証明書の検証に TM1 が使用するサーバーを指定します。

証明書検証に使用するすべてのサーバー名を別々の LDAPVerifyCertServerName エントリーにリストする必要があります。このエントリーは、SSL ハンドシェークで他方のサーバーにより TM1 に提示される証明書の名前 (サブジェクト) と厳密に一致する必要があります。

LDAPVerifyCertServerName は、LDAP を使用している各 TM1 サーバーの tm1s.cfg

ファイルで指定します。

LDAPVerifyCertServerName=<server_cert_subject>

server_cert_subject をサーバー名または IP アドレスに置き換えてください。使用するサーバーごとにエントリーを作成します。以下に例を示します。

LDAPVerifyCertServerName=abc99.mydomain.comLDAPVerifyCertServerName=xyz99.mydomain.com


LDAPVerifyServerSSLCert:

SSL 証明書の検証を TM1 に委任します。このパラメーターは、プロキシー・サーバーを使って LDAP を使用する場合などに便利です。



通常は、TM1 は Microsoft Windows API を利用して SSL 証明書を検証します。このプロセスを正常に実行するには、証明書の名前と LDAP サーバーのホスト名が一致している必要があります。しかし、プロキシーを使用している場合、これらの名前が一致せず、検証が失敗することがあります。この場合は、LDAPVerifyServerSSLCert=T を設定して、TM1 に証明書検証を実行させることができます。

LDAPVerifyServerSSLCert=T の場合、TM1 は、検証の 2 つのステップ (証明書に対する信頼関係の検証と CRL の検査) を実行します。この検証は Windows API が行う検証と似ていますが、方法が多少違います。

1. TM1 は、受け取った証明書を構成済みのホスト名に対して検証する代わりに、LDAPVerifyCertServerName で指定されているサーバー名のリストを参照します。

2. LDAPVerifyCertServerName で指定されているサーバーの 1 つと証明書名が一致する場合、TM1 は Microsoft Windows API を呼び出し、この単一の証明書のみの検証を要求します。

注: 正しいトラステッド・ルート認証局 (CA) を Microsoft Windows の証明書ストアにインポートしておく必要があります。


LDAPSkipSSLCertVerification=T を指定すると、信頼性検証ステップをスキップできます。この場合、TM1 はサーバー証明書をまったく検証せず単に受け入れます。

3. 信頼性検証を確認し終えると (またはスキップすると)、TM1 は Microsoft

Windows API を呼び出して CRL を検査します。

注: トラステッド・ルートの CRL 証明書を Microsoft Windows の証明書ストアにインポートしておく必要があります。

Microsoft Windows 証明書ストア内に CRL 証明書が存在しない場合、プロセスは失敗します。 LDAPSkipSSLCRLVerification=T を指定すると、CRL のステップをスキップできます。

4. 上記のステップがすべて正常に終了した場合、SSL ハンドシェークが完了します。この時点で、TM1 は LDAP サーバーに対して認証を試みます。

トラブルシューティング情報については、 281ページの『LDAP 認証のトラブルシューティング』を参照してください。

LDAPWellKnownUserName:

IBM Cognos TM1 サーバーが LDAP にログインするために使用するユーザー名を指定します。ICAS はこの名前を使用してユーザーから提示された名前を検索します。


このパラメーターの値は任意の LDAP 識別名にすることができます。

例:

uid=bjensen,ou=people,o=company.com

LDAP 検証の設定LDAP 検証を設定するには、TM1s.cfg ファイルのパスワードを変更して、LDAP ディレクトリーから名前をインポートし、新規ユーザーのグループ割り当てを変更できるようにします。その後、パスワードを LDAP 資格情報に再び変更します。

始める前に

LDAP 検証を設定するには、次の情報が必要です。

v LDAP にログオンする際に Cognos TM1 サーバーで使用可能な名前。その名前が有効かどうかは、ETLDAP を使用して確認できます。

v LDAP サーバーが実行中の SSL ポート。デフォルトは 636 です。

v 検証に使用する LDAP サーバーの名前または IP アドレス。

手順1. Cognos TM1 資格情報を使用してログオンするには、以下の操作を実行して、

TM1s.cfg のパスワード・パラメーターを変更します。

a. IBM Cognos TM1 サーバーのデータ・ディレクトリーの TM1s.cfg を編集します。


b. PasswordSource=LDAP を PasswordSource=TM1 に変更します。

c. TM1s.cfg を保存して終了します。

d. Cognos TM1 サーバーをリサイクルします。

2. LDAP ディレクトリーから Cognos TM1 に名前をインポートするには、次の操作を実行します。

a. 251ページの『ETLDAP ユーティリティー』の手順に従ってください。

b. 次の Cognos TM1 ログオン情報を使用します。

v 管理ユーザー (デフォルト)- Admin

v 管理者パスワード (デフォルト)- apple

インストール時に指定したユーザーを使用して、LDAP にログオンします。

3. 新規ユーザーのグループ割り当てを変更するには、次の操作を実行します。

a. Cognos TM1 に管理者としてログオンします。

b. サーバー・エクスプローラーでサーバー名を右クリックし、「セキュリティー」、「クライアント/グループ」をクリックします。

c. 新しいユーザーのグループ割り当てを、必要に応じて変更します。

ETLDAP でデータベースに追加した各 Cognos TM1 ユーザーは、LDAP ディレクトリーでの所属グループと同じグループに割り当てる必要があります。例えば、 NadiaC が LDAP ディレクトリー内でグループ gymnasts のメンバーである場合、ETLDAP は、Cognos TM1 内にユーザー Nadiac を作成し、グループ gymnasts を作成します。「クライアント/グループ」ダイアログ・ボックスで、Nadiac は gymnasts のメンバーとして表示されます。

4. パスワードを LDAP 資格情報に再び変更するために、次の操作を実行します。

a. IBM Cognos TM1 サーバーのデータ・ディレクトリーの TM1s.cfg を編集します。

b. PasswordSource=TM1 を PasswordSource=LDAP に変更します。

c. 接続ステータスを定義します。

v サーバーに直接接続する場合は、次の行を追加します。

LDAPUseServerAccount=T

v パスワードを使用してからサーバーに接続する場合は、次の行を追加します。

LDAPPasswordFile= file

LDAPPasswordKey= key

d. TM1s.cfg ファイルを保存して終了します。

e. Cognos TM1 サーバーをリサイクルします。

これで、LDAP ディレクトリーから追加した名前で Cognos TM1 にログオンできます。

LDAP 認証のトラブルシューティングこのトピックでは、tm1s.cfg ファイルで LDAPVerifyServerSSLCert=T の場合に生じる可能性のあるエラー・ログ・メッセージについて説明します。


以下のメッセージは、証明書が LDAPVerifyCertServerName にリストされている名前のどれとも一致しないことを示します。証明書名を調べて、tm1s.cfg ファイル内に対応する LDAPVerifyCertServerName 項目があることを確認します。

LDAP ERROR: 0x800b0109 - Error verifying server certificate chain validityLDAP ERROR: Error verifying server certificate no match for <server>LDAP ERROR: 0x51 - ldap_connect failed.

次のメッセージは、Microsoft Windows による LDAP サーバー証明書の信頼性に問題があることを示しています。証明書が Microsoft Windows の証明書ストアにインポートされていることを確認してください。

LDAP ERROR: 0x800b010f - Error verifying server certificate chain validityLDAP ERROR: Error verifying server certificate no match for <server>LDAP ERROR: 0x51 - ldap_connect failed.

次のメッセージは、証明書が取り消されたか、または TM1 が CRL 証明書を検索しても、それが Microsoft Windows 証明書ストアで見つからないことを示します。エラーを修正するには、CRL 検査を省略するか (LDAPSkipSSLCRLVerification=T

を設定する)、または CRL 証明書を CA から Microsoft Windows 証明書ストアにインポートします。

LDAP ERROR: 0x80092012 - Error verifying server certificate chain validityLDAP ERROR: Error verifying server certificate no match for <server>LDAP ERROR: 0x51 - ldap_connect failed.

Cognos TM1 での Cognos セキュリティーの使用IBM Cognos TM1 で IBM Cognos セキュリティーを使用することができます。

Cognos セキュリティーの概念、用語、および実装の詳細については、「Cognos

Administration and Security」を参照してください。

Cognos セキュリティーに関する概要IBM Cognos TM1 サーバーは、IBM Cognos セキュリティーを使用してユーザーを認証できます。

Cognos セキュリティーは、データへのユーザー・アクセスを管理する、IBM

Cognos フレームワークのコンポーネントです。 Cognos セキュリティーは、LDAP、Active Directory などのサード・パーティーのセキュリティー・プロバイダーを通じて承認と認証を管理します。 Cognos セキュリティーを通じて認証されたユーザーには、Cognos セキュリティー「パスポート」が与えられます。そして、Cognos TM1 アプリケーションは、このパスポートを使用してユーザーの権限 (ロールと所属グループ) および ID を確認します。

Cognos セキュリティーを使用する場合、Cognos TM1 に接続するためには、Cognos

パスポートが必要です。ユーザーが Cognos TM1 や他の Cognos セキュリティー対応コンポーネントに初めてログオンするときには、ネームスペース、ユーザー名、およびパスワードを入力するログオン画面が表示されます。Cognos セキュリティーによる認証が完了すると、そのユーザーにパスポートが発行されます。ユーザーが他の Cognos セキュリティー対応アプリケーション (Cognos TM1 も含む) にアクセスするときは、このパスポートによってユーザー資格情報が自動的に提示されます。共通ログオンが設定された Cognos サーバーを介して一度 Cognos TM1 サーバーに接続したユーザーは、その同じ Cognos サーバーを参照するように設定された


別の Cognos TM1 サーバー (または Cognos アプリケーション) にアクセスするときに、直接ユーザー入力を行う必要がありません。

ユーザーが Cognos TM1 サーバーにアクセスしようとすると、サーバーはパスポートを検証してユーザーを認証します。これは、Cognos サーバーにパスポートの ID

を問い合わせることで行われます。パスポートが有効な場合は、問い合わせの回答としてユーザーのセキュリティーと認証情報のコレクションが返されます。この情報には、ユーザーが所属しているロールとグループ、およびパスポートに関連付けられているアカウント (ユーザー名) が含まれています。そのユーザー名が Cognos

TM1 内に既に存在する場合は、そのユーザーの既存のメンバーシップが既存のCognos TM1 グループと照合して検証されます。ユーザーが存在しない場合は、ユーザーが追加され、Cognos TM1 サーバー上の適切なユーザー・グループに割り当てられます。

ユーザーがクライアント・プログラムを管理者として実行する場合 (プログラム・ファイル名を右クリックして「管理者として実行」を選択する)、クライアントがCAM に接続した後に新しい 2 つのフォルダーが作成されます。

v installation_location¥configuration

このフォルダーには、C8ITK.ini ファイルが含まれています。

v installation_location¥logs

該当する場合、このフォルダーにはファイル C8ITK.log が含まれています。

デフォルトでは、C8ITK.ini ファイルには、エラーが発生しない限り logs フォルダーにログ・ファイルを作成しないように指定されています。ログ・ファイルが必要な場合は、C8ITK.ini ファイルを編集できます。 LogFilePath セクションを編集して、ログ・ファイルの名前を変更することもできます。変更を有効にするには、その前に Cognos サービスを再始動する必要があります。

Cognos セキュリティーを使用するための TM1 サーバーの設定認証のために、デフォルトの標準 TM1 認証ではなくIBM Cognos セキュリティーを使用するように、 IBM Cognos TM1 サーバーを設定できます。

始める前に

この手順を正しく完了するには、IBM Cognos サーバーで匿名アクセスを許可しないように設定されている必要があります。 IBM Cognos サーバーで匿名アクセスが有効な場合、Cognos グループを TM1 にインポートする際に、TM1 からネームスペースにログオンできません。


IBM Cognos TM1 サーバーで IBM Cognos セキュリティー認証を有効にするには、サーバーの Tm1s.cfg 設定ファイルで複数の設定パラメーターを追加または変更する必要があります。

注: Cognos の異なるインスタンスを使用する Cognos セキュリティーを既に使用している TM1 サーバーを再設定する場合、最初の Cognos インスタンスからインポ


ートされた既存の Cognos ユーザーおよびグループを削除してから、新しい Cognos

インスタンスからユーザーおよびグループをインポートする必要があります。

手順1. Tm1s.cfg 設定ファイルをテキスト・エディターで開きます。

Tm1s.cfg ファイルは、TM1 サーバー・データ・ディレクトリーにあります。詳細については、 341ページの『付録 A. tm1s.cfg サーバー設定ファイル』を参照してください。

2. 以下のパラメーターを編集するか、または設定ファイルに追加します。

表 28. Cognos セキュリティーのための TM1 サーバー設定パラメーター

パラメーター名説明

ServerCAMURI TM1 サーバーが IBM Cognos セキュリティーへの接続に使用する内部ディスパッチャーの URI。 URI は次の書式で指定します。

http[s]://host IP address:port/p2pd/servlet/dispatch

例:

http://10.121.25.121:9300/p2pd/servlet/dispatch

https://10.121.25.121:9300/p2pd/servlet/dispatch

注: URI を見つけるには、 IBM Cognos 管理者に次の手順の実行を依頼してください。

1. IBM Cognos をホスティングしているシステムで、IBM

Cognos Configuration を開きます。

2. 「環境」ノードをクリックして展開します。

3. 「プロパティー」ウィンドウで、「ディスパッチャー設定」セクションを見つけ、「外部ディスパッチャー URI」プロパティーまたは「内部ディスパッチャー URI」プロパティーの値を使用します。

ClientCAMURI TM1 クライアントの認証に使用する IBM Cognos サーバー IBM

Cognos Connection の URI。 URI は次の書式で指定します。

http[s]://host/ibmcognos/cgi-bin/cognos.cgi

注: host、ibmcognos、および cognos.cgi の値は変数であり、使用されている正確な設定値にする必要があります。これらの設定の詳細については、IBM Cognos 管理者に問い合わせてください。

例: http://10.121.25.121/ibmcognos/cgi-bin/cognos.cgi

Cognos システムが Microsoft インターネット・インフォメーション・サービス (IIS) を使用する場合:

http://10.121.25.121/ibmcognos/cgi-bin/cognosisapi.dll


表 28. Cognos セキュリティーのための TM1 サーバー設定パラメーター (続き)


CAMSSLCertificate 内部ディスパッチャーに接続する際に使用する SSL 証明書の絶対パスと名前。

例: C:\AxTM1\Install_Dir\ssl\CognosCert.cer

このパラメーターが必要になるのは、SSL を使用するようにIBM Cognos サーバーが設定されている場合のみです。

SkipSSLCAMHostCheck SSL 証明書 ID の確認プロセスが省略可能かどうかを示します。デフォルトは FALSE です。

重要: このパラメーターを TRUE に設定するのは、デモンストレーション目的で一般的な証明書を使用する場合のみにしてください。

ClientPingCAMPassport パスポートの有効性を保つために、クライアントが IBM Cognos

サーバーに ping を実行する間隔を秒単位で示します。

エラーが発生するか、パスポートが期限切れになると、ユーザーは TM1 サーバーから切断されます。

例: ClientPingCAMPassport=900

CAMPortalVariableFile Cognos インストール環境の variables_TM1.xml ファイルへのパス。ほとんどの場合、このパスは次のようになります。

CAMPortalVariableFile = portal\variables_TM1.xml

variables_TM1.xml ファイルは、TM1 iWidgets のために含まれています。 iWidgets のインストールと設定について詳しくは、73ページの『Cognos TM1 iWidgets and Cognos Workspace』を参照してください。

CAMPortalVariableFile パラメーターが必要なのは、 TM1 Web

を実行する場合のみです。

Tm1s.cfg ファイルには、次のようなパラメーターを記述することになります。

ServerCAMURI=http://10.111.25.121:9300/p2pd/servlet/dispatchClientCAMURI=http://10.111.25.121/cognos_location/cgi-bin/cognos.cgiClientPingCAMPassport=900CAMPortalVariableFile=templates\ps\portal\variables_TM1.xml

3. IntegratedSecurityMode パラメーターをデフォルト・モードの 1 に設定します。


注: IntegratedSecurityMode パラメーターを 1 に設定することにより、標準TM1 セキュリティーを使用する TM1 で、Cognos セキュリティーに切り替える前に追加の設定手順を実行できます。それらの追加手順を完了した後に、このパラメーターを 4 または 5 に変更して、Cognos セキュリティーを使用できます。




6. Cognos Analytics インストールで必要なステップを実行します。

v Planning Analytics 管理者の役割を果たす Cognos ユーザーを定義します。

v Cognos グループを Planning Analytics にインポートします。

詳しくは、 287ページの『Cognos セキュリティー使用時の TM1 ユーザー、グループ、およびオブジェクトの管理』を参照してください。

7. Cognos 認証を使って始動するよう Cognos TM1 サーバーを設定します。

a. Cognos TM1 サーバーを停止します。

b. Tm1s.cfg 設定ファイルをテキスト・エディターで開きます。

c. IntegratedSecurityMode パラメーターを設定し、サーバーで Cognos 認証を使用するように指定します。

正確なパラメーター値は、使用している固有の Cognos TM1 コンポーネントによって次のように異なります。

v Cognos TM1 Applications コンポーネントを使用していない場合は、パラメーターに 4 を設定します。


v Cognos セキュリティーで Cognos TM1 Applications を使用している場合は、Planning Analytics と Cognos の両方のユーザー・グループをサポートするために、このパラメーターを 5 に設定します。


d. Tm1s.cfg ファイルを保存して閉じます。

e. Cognos TM1 サーバーを再起動します。

次のタスク

以下の設定トピックを参照して、設定を完了します。

v 289ページの『Cognos セキュリティーを使用するための Cognos TM1 クライアントの設定』

v 290ページの『Cognos TM1 Web で Cognos セキュリティーを使用するように構成する』


Cognos TM1 サーバーとの匿名アクセスと Cognos セキュリティー:

構成設定と手順を正常に設定して IBM Cognos セキュリティー認証を IBM Cognos

TM1 サーバー上で有効にするには、Cognos サーバーで匿名アクセスを許可しないように設定する必要があります。

Cognos サーバーで匿名アクセスが有効な場合、Cognos グループを Cognos TM1 にインポートする際に、Cognos TM1 からネームスペースにログオンできません。


Cognos セキュリティー使用時の TM1 ユーザー、グループ、およびオブジェクトの管理

Cognos TM1 管理者として機能するよう Cognos ユーザーを定義する:

認証のために IBM Cognos Analytics セキュリティーを使用している場合に、IBM

Cognos TM1 の管理作業を正しく実行するには、既存の Cognos ユーザーを Cognos

TM1 ADMIN グループに追加する必要があります。

Cognos グループを Cognos TM1 にインポートする際は、この Cognos ユーザーが使用されます。

重要: この設定の最初の手順は、 Cognos TM1 IntegratedSecurityMode パラメーターを 1 に設定して行う必要があります。そして、後で、Cognos Analytics セキュリティーを使用するようにこのパラメーターを変更します。

手順

1. Cognos TM1 に管理者としてログオンします。

2. サーバー・エクスプローラーから、「サーバー」>「セキュリティー」>「クライアント/グループ」の順にクリックします。

3. 「クライアント/グループ」ダイアログ・ボックスで「クライアント」>「新規クライアントの追加」をクリックします。

「Cognos のログオン」ダイアログ・ボックスが表示されます。

4. Cognos のユーザー ID とパスワードを入力してから、「OK」をクリックします。

5. 「名前」ボックスで、現在ログインしているネームスペースをクリックします。

注: Cognos TM1 にインポートできるのは、ログインしているネームスペースのユーザーのみです。「名前」ボックスに他のネームスペースが表示されていても、そのネームスペースのユーザーはインポートできません。

「名前」ボックスの内容が更新され、選択したネームスペースで使用可能なディレクトリーが表示されます。

6. 「ユーザーをリストに表示する」オプションをオンにします。

7. Cognos TM1 管理者として定義する Cognos ユーザーが含まれるディレクトリーに移動します。管理タスクを実行するには Cognos ユーザーの ID とパスワードを知っている必要があるため、通常は、独自の Cognos ユーザーを Cognos

TM1 管理者として定義します。

8. ユーザーを選択します。

9. 緑色の矢印アイコンをクリックして、選択されたユーザーを「選択されたエントリー」リストに移動します。

10. 「OK」をクリックして、Cognos ユーザーを Cognos TM1 にインポートします。

ユーザーが、新しいクライアントとして「クライアント/グループ」ウィンドウに表示されますが、Cognos TM1 グループには割り当てられていません。


11. 新しいユーザーを ADMIN グループに割り当てて、「OK」をクリックします。

12. Cognos TM1 サーバーを停止します。

13. Tm1s.cfg 設定ファイルをテキスト・エディターで開きます。

14. IntegratedSecurityMode パラメーターを設定し、サーバーで IBM Cognos 認証を使用するように指定します。正確なパラメーター値は、使用している固有のCognos TM1 コンポーネントによって次のように異なります。

v Cognos TM1 Applications コンポーネントを使用していない場合は、パラメーターに 4 を設定します。


v Cognos TM1 Applications を Cognos セキュリティーと共に使用している場合、Cognos TM1 と Cognos の両方のユーザー・グループをサポートするため、このパラメーターを 5 に設定します。


15. Tm1s.cfg を保存して閉じます。


Cognos グループを Cognos TM1 にインポートする:

IBM Cognos ユーザーを Cognos TM1 管理者として定義したら、そのユーザーはCognos グループを Cognos TM1 にインポートできるようになります。

インポートするのは、Cognos TM1 サーバーへのアクセスを許可する Cognos グループのみにしてください。

手順

1. サーバー・エクスプローラーで、Cognos TM1 サーバーをダブルクリックします。

「Cognos のログオン」ダイアログ・ボックスが表示されます。

2. Cognos TM1 管理者として定義した Cognos ユーザーとしてログオンします。

3. サーバー・エクスプローラーから、「サーバー」>「セキュリティー」>「クライアント/グループ」をクリックします。

4. 「クライアント/グループ」ウィンドウで、「グループ」>「新規グループの追加」をクリックします。

5. 「名前」ボックスで、現在接続されているネームスペースをクリックします。

注: Cognos TM1 にインポートできるのは、接続しているネームスペースのグループのみです。「名前」ボックスに他のネームスペースが表示されていても、そのネームスペースのグループはインポートできません。

6. ディレクトリー構造の中から、Cognos TM1 にインポートする Cognos グループを選択します。

7. 緑色の矢印アイコンをクリックして、選択されたユーザーを「選択されたエントリー」リストに移動します。

8. 「OK」をクリックして、Cognos グループを Cognos TM1 にインポートします。


「クライアント/グループ」ウィンドウの「ユーザー・グループの割り当て」セクションを参照すると、サーバーに追加した Cognos グループを確認できます。

Cognos セキュリティーを使用する場合の TM1 ユーザーの作成:

Cognos 認証を使用するように IBM Cognos TM1 サーバーが設定されている場合は、新しいクライアントを Cognos TM1 サーバー上に直接作成することができません。

クライアント管理は、すべて Cognos セキュリティーで実行します。

Cognos ユーザーが Cognos TM1 にアクセスすると、そのユーザーが検証され、適切な Cognos TM1 グループに自動的に割り当てられます。Cognos TM1 グループに手動でユーザーを割り当てる必要はありません。

Cognos 認証セキュリティーを使用する場合の Cognos TM1 オブジェクト・セキュリティーの管理:

IBM Cognos 認証によって IBM Cognos TM1 サーバー上のユーザーが自動的に管理されますが、Cognos ユーザーに Cognos TM1 オブジェクトの表示および使用を許可するために、やはり Cognos TM1 管理者がオブジェクト・セキュリティーを管理する必要があります。

Cognos TM1 オブジェクトのセキュリティーの管理について詳しくは、「TM1

Developer」資料で Cognos セキュリティーに関するトピックを参照してください。

Cognos セキュリティーを使用するための Cognos TM1 クライアントの設定IBM Cognos のセキュリティー関連の管理用タスクを Cognos TM1 クライアントから実行できるようにするには、Tm1p.ini ファイルに 2 個のパラメーターを追加する必要があります。

手順1. Tm1p.ini 設定ファイルをテキスト・エディターで開きます。

Tm1p.ini ファイルの場所について詳しくは、 411ページの『Tm1p.ini ファイルの場所』を参照してください。

2. 次のパラメーターを Tm1p.ini ファイルに追加します。

表 29. Tm1p.ini ファイルのパラメーター


CognosGatewayURI Cognos Analytics Gateway の URI。 URI は次の書式で指定します。

http[s]://host/Cognos の場所/cgi-bin/cognos.cgi

例: http://10.121.25.121/cognos_location/cgi-bin/

cognos.cgi


表 29. Tm1p.ini ファイルのパラメーター (続き)


AllowImportCAMClients Cognos クライアントが Cognos TM1 にインポートできるかどうかを指定します。Cognos TM1 で Cognos セキュリティーをセットアップする場合は、このパラメーターを T に設定する必要があります。

Tm1p.ini ファイルには、次のようなパラメーターを記述することになります。

AllowImportCAMClients = T

CognosGatewayURI = http://10.111.25.121/cognos_location/cgi-bin/cognos.cgi

3. Tm1p.ini を保存して閉じます。

4. Cognos TM1 クライアントを再起動します。

Cognos TM1 Web で Cognos セキュリティーを使用するように構成するIBM Cognos 認証セキュリティーを使用するように IBM Cognos TM1 Web を設定するには、以下の手順に従います。

始める前に

注: Cognos Analytics アップデーター・キットを Analytics インストール済み環境に適用した場合、 tm1web.html ファイルに特定の更新を行う必要があることがあります。

tm1web.html ファイルは、 Cognos TM1 Web による IBM Cognos 認証セキュリティーの使用をサポートします。ただしこれは、Cognos Analytics アップデーター・キットを適用する際には更新されません。代わりに、tm1web.html.new という名前の更新済みファイルが、元のファイルと同じ Cognos Analytics

...¥webcontent¥tm1¥web ディレクトリーに置かれます。この新しいバージョンのtm1web.html を使用しますが、元の tm1web.html ファイルに何らかの変更を加えていた場合にはそれを反映するように更新します。


これらの手順には、Cognos TM1 Web システムの設定ファイルを編集し、それらをCognos Analytics システムに上書きコピーすることが含まれます。

手順1. 以下の Cognos TM1 Web ゲートウェイ・ファイルを、Cognos TM1 Web インストール・ディレクトリーで見つけて解凍します。

variables_TM1.xmlこのファイルは templates¥ps¥portal にあります。

tm1web.htmlこのファイルは webcontent¥tm1¥web にあります。

これらのファイルは、次の場所に bi_interop.zip ファイルとして圧縮されています。


¥<TM1 のインストール場所>¥bi_interop¥

例:

C:¥Program Files¥IBM¥cognos¥tm1_64¥bi_interop¥

2. ファイルを IBM Cognos Analytics インストール環境にコピーします。

variables_TM1.xmlこのファイルを、IBM Cognos Analytics システムの TM1 Web 層が実行されるすべてのサーバーの <Cognos の場所>¥templates¥ps¥portal にコピーします。

tm1web.htmlこのファイルを、IBM Cognos Analytics システムの Cognos Analytics ゲートウェイが実行されるすべてのサーバーの <Cognos の場所>¥webcontent¥tm1¥web にコピーします。

3. tm1web.html ファイルを編集して、Cognos TM1 Web の実行場所を指定するようにします。

var tm1webServices = ["http://SystemName:PortNumber"];

例:

var tm1webServices = ["http://mysystem:9510"];

Cognos セキュリティーを使用するための Cognos TM1Operations Console の設定IBM Cognos TM1 Operations Console を、IBM Cognos Analytics セキュリティー(Cognos Access Manager (CAM) 認証とも呼ばれる) を使用するように設定できます。

始める前に

少なくとも 1 つの TM1 サーバーは IBM Cognos Analytics セキュリティーを使用するように設定する必要があります。これは、Operations Console のユーザー・グループ情報を保管するために必要です。このトピックのステップを完了するには、この TM1 サーバーの名前を知っている必要があります。詳細と設定手順については、 282ページの『Cognos TM1 での Cognos セキュリティーの使用』および 283

ページの『Cognos セキュリティーを使用するための TM1 サーバーの設定』を参照してください。


IBM Cognos Analytics セキュリティーを使用するように Operations Console を設定するには、これら 2 つのコンポーネントをホストしているコンピューター上にあるファイルに対して作業を行います。

手順1. http://<host>:9510/pmhub/pm/admin に移動して、Performance Management

Hub を開きます。


2. 「設定」 > 「com.ibm.ba.pm.opsconsole.monitor.tm1.TM1OpsConsoleMonitor」の順に展開します。

3. 「com.ibm.ba.pm.opsconsole.monitor.tm1.TM1OpsConsoleMonitor.dictonary」をクリックします。

4. 「DefaultAdminHost」、「DefaultGroup」、および「DefaultServer」フィールドの値を確認します。 115ページの『Cognos TM1 Operations Console の設定』を参照してください。

5. 「com.ibm.ba.pm.resource.security」を展開します。

6. 「com.ibm.ba.pm.resource.security.dictonary」をクリックします。

7. 「CAMGatewayURL」に Cognos Analytics サーバーのゲートウェイを設定します。この値は、Cognos Configuration の「環境」 > 「ゲートウェイ URI」で見つけることができます。 tm1s.cfg ファイルの ClientCAMURI パラメーターの値も、類似しているはずです。例: http://host.domain.com/ibmcognos/cgi-

bin/cognos.cgi

8. 「CAMBIURL」に Cognos Analytics サーバーのディスパッチャー URL を設定します。この値は、Cognos Configuration の「環境」 > 「外部ディスパッチャー URI」で見つけることができます。 tm1s.cfg ファイルの ServerCAMURIパラメーターの値も、類似しているはずです。例: http://

host.domain.com:9300/p2pd/servlet/dispatch

9. ..¥tm1_64¥bi_interop¥bi_interop.zip ファイルを TM1 のインストール場所から Cognos Analytics サーバーのインストール・ディレクトリーのルート(..¥c10_64 ディレクトリー) にコピーします。分散 Cognos Analytics サーバー環境を使用している場合は、TM1 データ層または TM1 Web 層を実行しているコンピューターにこのファイルをコピーします。

10. ディレクトリー構造が維持されるように bi_interop.zip を抽出します。pmhub.html ファイルは ..¥c10_64¥webcontent ディレクトリーにあるはずです。

11. pmhub.html ファイルの 51 行目を編集して、TM1 Operations Console を実行している IBM Cognos TM1 アプリケーション・サービスの完全修飾ドメイン名とポート番号を組み込みます。

v TM1 に用意されている WebSphere Liberty Profile Web サーバーを使用している場合は、それが TM1 アプリケーション・サーバーを実行するサーバーになります。

v 独自の Web サーバーを使用している場合、これが pmhub.war を配置したサーバーです。

例:

var pmhubURLs = ["http://tm1appshost.domain.com:9510"];

TM1 Operations Console を複数のシステムで使用する場合、複数の URL を組み込むこともできます。例:

var pmhubURLs = ["http://tm1appshost1.domain.com:9510","http://tm1appshost2.domain.com:9510"];

Cognos TM1 Applications での Cognos セキュリティーの使用IBM Cognos Analytics セキュリティーを使用するように IBM Cognos TM1

Applications を設定できます。この設定を行うと、ユーザーは Cognos Analytics サ


ーバーに存在する有効なユーザーとして Cognos TM1 Applications にログオンしなければならなくなります。また、この設定により、Cognos TM1 Applications へのリンクが IBM Cognos Connection ポータルに表示されて、 Cognos TM1 Applications

と Cognos Analytics が統合されます。

Cognos TM1 Applications に Cognos Analytics セキュリティーを使用する場合は、次のいずれかの方法で Cognos TM1 Application Server を Web アプリケーション・サーバー上にホストできます。

v Cognos TM1 のインストールに含まれている WebSphere® Liberty サーバーを実行する別のコンピューターで。

v Apache Tomcat または IBM Websphere を独自にインストールした別のコンピューター上で。

いずれの場合も、planning.html ファイルを編集して、そのファイルを Cognos

Analytics サーバーにコピーし、 Cognos Analytics サーバーが Cognos TM1 アプリケーション・サーバーの場所を認識できるようにする必要があります。

注: UNIX 環境で Cognos TM1 に接続するには、その前に TM1_PATH 環境変数を指定しておく必要があります。

Cognos Analytics セキュリティーを使用するための Cognos TM1 Applications の設定:

IBM Cognos Analytics セキュリティーを使用するように IBM Cognos TM1

Applications を設定するには、これら 2 つのコンポーネントのホスティング・コンピューター、および Cognos TM1 サーバーが稼働しているコンピューター上のファイルに対して作業を実行します。また、この設定により、Cognos TM1 Applications

へのリンクを IBM Cognos Connection ポータルに表示できるようにもなります。これにより、ユーザーは権限を保有するアプリケーションを Cognos Connection ポータル内から開くことができます。

始める前に

Cognos Analytics セキュリティーを使用するように Cognos TM1 サーバーを設定する必要があります。

Cognos TM1 Applications で Cognos Analytics セキュリティーを使用するには、Cognos TM1 Tm1s.cfg 設定ファイルの IntegratedSecurityMode パラメーターを 5

に設定して、 Cognos TM1 と Cognos Analytics の両方のユーザー・グループをサポートする必要があります。

設定ステップについて詳しくは、 282ページの『Cognos TM1 での Cognos セキュリティーの使用』および 283ページの『Cognos セキュリティーを使用するためのTM1 サーバーの設定』を参照してください。

注: UNIX 環境で Cognos TM1 に接続するには、その前に TM1_PATH 環境変数を設定しておく必要があります。

手順

1. bi_interop.zip ファイルの内容を既存の Cognos Analytics インストール済み環境に解凍します。


注: Cognos TM1 バージョン 10.2.2 以降、旧バージョンの Cognos TM1 で提供されていた planning_gateway.zip ファイルが bi_interop.zip に置き換えられています。

a. Cognos TM1 インストールで提供される bi_interop.zip ファイルを以下の場所で見つけます。

<Cognos TM1 の場所>¥bi_interop¥

b. bi_interop.zip ファイルの内容を解凍し、既存の Cognos Analytics インストール済み環境のルート・ディレクトリーにマージします。

例: C:¥Program Files¥IBM¥cognos¥c10_64¥

注: bi_interop.zip ファイルには、¥templates サブディレクトリーと¥webcontent サブディレクトリーにファイルをマージするディレクトリー構造が含まれています。

c. ファイルを手動で解凍して Cognos Analytics インストール済み環境にコピーするには、ファイルを次のようにコピーします。

分散 Cognos Analytics サーバー環境を使用している場合は、TM1 データ層または TM1 Web 層を実行しているコンピューターにファイルを次のようにコピーします。

planning.htmlCognos Analytics Gateway がインストールされている <C10 のインストール・ディレクトリー>¥webcontent に planning.html をコピーします。

icon_active_application.gifCognos Analytics Gateway がインストールされている <C10 のインストール・ディレクトリー>¥webcontent¥ps¥portal¥images にicon_active_application.gif をコピーします。

variables_plan.xmlPresentation サービス (アプリケーション層) が Cognos Analytics サーバーで実行されている場合は、必ず、 variables_plan.xml を<C10 のインストール・ディレクトリー>¥templates¥ps¥portal にコピーします。

注: これらのファイルは、より新しい Cognos Analytics インストールでもインストールされます。これらのファイルが Cognos Analytics サーバーに存在する場合は、以下の手順に説明するように編集するだけでかまいません。

2. planning.html ファイルを編集します。

重要: このファイルの planningServices パラメーターの値は、承認された場所だけに Cognos Analytics サーバーがユーザーをリダイレクトするために必要です。ユーザーのログオン元の Cognos TM1 アプリケーション・サーバーの場所は、このファイルに含まれる承認された場所となるように妥当性検査する必要があります。そうでない場合、Cognos Analytics サーバーはユーザーをリダイレクトしません。

a. planning.html ファイルを開き、次の行を見つけます。


// Update the following to point to the location of the planning

service(s)

var planningServices = ["http://machine.company.com:9510"];

b. planningServices パラメーターを Cognos TM1 アプリケーション・サーバーの場所およびポート番号に設定します。

var planningServices = ["http://web_server_address:port_number"];

web_server_address は、Cognos TM1 アプリケーション・サーバーが稼働しているコンピューターの完全修飾ドメイン・ネーム (FQDN) で置き換えます。例：myhost.example.com

v Cognos TM1 のインストールに付属している WebSphere® Liberty サーバーで Cognos TM1 Application Server を実行している場合は、以下のようにします。

var planningServices = ["http://web_server_address:9510"];

v 独自の Web アプリケーション・サーバーと一緒に Cognos TM1 アプリケーション・サーバーを実行している場合、そのシステムの場所とポート番号を使用します。

ヒント: 同じ Cognos Analytics サーバーを使用して、複数のコンピューター上で実行されるさまざまな Cognos TM1 Applications のインスタンスを認証する場合は、各コンピューターの完全修飾ドメイン名 (FQDN) をコンマで区切ったリストを入力します。例:

var planningServices = ["http://

machine1.example.com:port_number","http://

machine2.example.com:port_number"];

ヒント: 複数のドメインに属する Web サーバー上で Cognos TM1 アプリケーション・サーバーが稼働している場合、コンマ区切りリストを使用し、各ドメインの完全修飾ドメイン・ネームを入力します。例:

var planningServices = ["http://

computer_A.domain_1:port_number","http://

computer_A.domain_2:port_number","http://

computer_A.domain_3:port_number"];

c. planning.html ファイルを保存して閉じます。

3. Cognos TM1 Applications および Cognos Analytics セキュリティーのセッション・タイムアウト・パラメーターを設定し、適切にタイムアウトが検出されるようにします。

詳しくは、 296ページの『Cognos TM1 Applications と Cognos Analytics セキュリティーのセッション・タイムアウト値の設定』を参照してください。

4. Cognos Analytics サーバーを再起動します。

5. Cognos TM1 Applications を IBM Cognos Gateway URI および IBM CognosDispatcher URI の値で設定します。

a. 次のリンク形式を使用して Cognos TM1 Applications を開きます。


http://web_server_name:port_number/pmpsvc


b. 以下の手順に従って、Cognos TM1 Applications の設定ページにログオンして開きます。

v 初めて Cognos TM1 Applications を実行する場合は、ログオン後に設定ページが開きます。

v 既に Cognos TM1 Applications を設定している場合は、TM1 Applications

ポータル・ページのツールバーから「IBM Cognos TM1 Applications の管

理」アイコンをクリックして、設定ページを開きます。

c. 「TM1 Applications の設定」ページで、次の Cognos TM1 と Cognos

Analytics パラメーターに値を入力します。

v 「TM1 管理ホスト」フィールドおよび「サーバー名」フィールドに値を入力し、使用するデータ・コントリビューション・クライアントのオプションを設定します。詳しくは、 151ページの『Cognos TM1 Application Web

のサーバーおよびクライアント環境の設定』を参照してください。

v 「IBM Cognos ゲートウェイ URI」パラメーターを設定します。例:

http://CognosServerName/ibmcognos/bi/v1/disp

v 「IBM Cognos のディスパッチャー URI」パラメーターを設定します。例:

http://CognosServerName:9300/p2pd/servlet/dispatch

CognosServerName を Cognos Analytics Web サーバーが稼働しているシステムの名前に置き換えます。

6. 設定をテストするには、リモート・コンピューターで Web ブラウザーを使ってCognos TM1 Applications にログオンします。

以下のエラーが表示される場合は、Cognos Analytics サーバー上のplanning.html ファイルの planningServices パラメーターの設定を確認してください。

Planning サービス・パラメーターが指定されていないか、設定済みの場所になっていません

Cognos TM1 Applications と Cognos Analytics セキュリティーのセッション・タイムアウト値の設定:

IBM Cognos Business Intelligence セキュリティーとともに IBM Cognos TM1

Applications を使用するときには、正しくタイムアウトが検出されるようにするために、pmpsvc セッション・タイムアウトを CAM セッション・タイムアウトより高い値に設定します。 Cognos TM1 Applications (pmpsvc) セッション・タイムアウトを Cognos Analytics セキュリティー (CAM) セッション・タイムアウトより低い値に設定すると、 Cognos TM1 Applications は CAM セッションの終了を正しく検出せず、タイムアウトになりません。



Cognos TM1 Applications が CAM セッションの終了を正しく検出できるようにするには、pmpsvc セッション・タイムアウトを CAM セッション・タイムアウトより高い値に設定します。

v pmpsvc セッション・タイムアウトは、非アクティブ状態がどれだけ経過したらCognos TM1 Applications がユーザー・セッションを終了するかを表す分数です。デフォルト値は 60 分 (1 時間) です。

v CAM セッション・タイムアウトは、非アクティブ状態がどれだけ経過したらCognos セキュリティーがユーザー・セッションを終了するかを表す秒数です。デフォルト値は 3600 秒 (1 時間) です。

手順

1. pmpsvc セッション・タイムアウト・パラメーターを設定します。

a. WEB-INF/configuration ディレクトリーで fpmsvc_config.xml ファイルを見つけます。

v Cognos TM1 のインストールに含まれている WebSphere® Liberty サーバーで Cognos TM1 Applications を配布した場合、fpmsvc_config.xml は以下の場所にあります。

Cognos_TM1_install_location¥webapps¥pmpsvc¥WEB-INF¥configuration

v Apache Tomcat で Cognos TM1 Applications を配布した場合、このファイルは以下の場所にあります。

C:¥Program Files¥Apache Software Foundation¥Tomcat

version_number¥webapps¥pmpsvc¥WEB-INF¥configuration

b. service / session 要素の timeout 属性に値を入力します。

同じディレクトリーにある XML スキーマ定義ファイル fpmsvc_config.xsd

で定義されている service / session / timeout 属性の形式を使用します。

例:

<session timeout=“60”/>

2. Cognos Analytics システムで、IBM Cognos Configuration を使って CAM セッション・タイムアウトを設定します。

Cognos Configuration の「セキュリティー/認証 (Security/Authentication)」セクション内の「アイドル・タイムアウト (秒)」フィールドに値を入力します。

Cognos 認証を使用する場合に管理者が考慮すべき事項IBM Cognos 認証を使用するように Cognos TM1 サーバーを設定する場合に IBM

Cognos TM1 管理者が注意すべき問題がいくつかあります。

これらの問題を次に示します。

v IntegratedSecurityMode パラメーターの Cognos TM1 セキュリティー・モード4 および 5 の説明をもう一度確認してください。 Cognos ユーザーが Cognos

TM1 ユーザー・グループに属すことができるかどうかを、これらのモードによっ


て制御する方法について理解する必要があります。詳しくは、「TM1 操作」のIntegratedSecurityMode パラメーターの説明を参照してください。

v Cognos ユーザーを別の Cognos グループに永久的に割り当てるために Cognos

TM1 を使用することはできません。Cognos TM1 で Cognos グループに対して行うユーザー割り当てはいずれも、Cognos に保存されません。Cognos ユーザーがCognos TM1 にログオンすると、Cognos のグループ割り当てによって、Cognos

TM1 で行われるすべての Cognos グループ割り当てがオーバーライドされます。

v Cognos ユーザーを Cognos TM1 にインポートした後にそのユーザーの名前を変更した場合は、新しいユーザー名で Cognos TM1 を更新するために Cognos TM1

内のそのユーザーを削除する必要があります。Cognos TM1 内のユーザーを削除すると、ユーザーが次回にログオンしたときに新しい名前が表示されます。

Cognos 認証を使用する際のユーザーに関する考慮事項IBM Cognos TM1 ユーザーは、IBM Cognos 認証を使用するように設定されているCognos TM1 サーバーにアクセスするときに生じる可能性のある問題を覚えておく必要があります。

認証の動作:

IBM Cognos 認証を使用する IBM Cognos TM1 サーバーにログオンする場合は、指定の規則に従って認証処理が行われます。

規則は次のとおりです。

v IBM Cognos で共通ログオンが有効な場合に、IBM Cognos アプリケーションにログイン済みで、かつアクティブなセッションが保持された状態にあるときは、Cognos TM1 サーバーにログオンする際に認証情報の入力は求められません。

v IBM Cognos で共通ログオンが有効な場合に、IBM Cognos アプリケーションにログオンしたことがないと、Cognos TM1 サーバーにログオンする際に認証情報の入力を求めるプロンプトが出されます。

v IBM Cognos で共通ログオンが有効になっていない場合、IBM Cognos 認証を使用するようにサーバーが設定されているとしても、Cognos TM1 サーバーにログオンする際に認証情報の入力を求めるプロンプトが出されます。

個人用 Cognos セキュリティー・セッション:

IBM Cognos サーバーが共通ログオンを使用するように設定されている場合、資格情報の入力が求められるのは 1 回だけになります。

それ以降、同じ IBM Cognos サーバーを参照するように設定されている他の IBM

Cognos セキュリティー対応のアプリケーション (Cognos TM1 を含む) に接続する場合、Cognos セキュリティー・パスポートが有効である限り、自動的に接続されます。

例えば、使用可能な Cognos TM1 サーバーが 3 つあり、そのすべてが同じ IBM

Cognos サーバーを使用するように設定されている場合、最初のサーバーにネームスペース Y のユーザー X として接続すると、その他の Cognos TM1 サーバーとのすべての接続は、ネームスペース Y のユーザー X のパスポートを使用して自動的に実行されることになります。


場合によっては、Cognos セキュリティー・パスポートで識別されているユーザーではない別のユーザーとして、Cognos TM1 サーバーにログオンすることが必要なこともあります。このような場合に対応するために、「別のネームスペースにログオン」オプションが用意されています。このオプションを使用すると、パスポートによって通常は自動的に行われる認証を無効にすることができます (ただし、後で使用できるようにパスポートの有効性は保持されます)。「別のネームスペースにログオン」オプションを使用して Cognos TM1 サーバーにログオンすると、プライベート・セッションが確立されます。プライベート・セッションの確立に使用した認証情報は、パスポートに格納されません。また、他のアプリケーションで使用されることもありません。現存するパスポートはそのまま有効で、他の IBM Cognos セキュリティー対応アプリケーションへのアクセスに使用できます。

手順

1. サーバー・エクスプローラーから「サーバー」>「別のネームスペースにログオン」をクリックします。

2. Cognos の「ログオン」ウィンドウで、Cognos TM1 サーバーへのログオンに使用する「ユーザー ID」と「パスワード」を入力します。


Cognos セキュリティーでの複製の確立:

IBM Cognos 認証を使用する IBM Cognos TM1 サーバーへの複製接続を確立する場合は、ネームスペースの IBM Cognos ネームスペース ID を指定する必要があります。

ネームスペースの記述名を指定しないでください。

データ転送セキュリティーのための SSL の使用SSL を使用してセキュアなデータ転送を行うように、IBM Cognos TM1 を設定することができます。

データ転送セキュリティーのための SSL の使用の概要すべての IBM Cognos TM1 コンポーネントは、Cognos TM1 管理サーバーと SSL

を使用して通信します。

管理サーバーは、SSL を使用できない古い Cognos TM1 クライアントをサポートするために、2 つのポート (保護されたポートと保護されていないポート) を listen

します。SSL を使用できる Cognos TM1 クライアントは、保護されたポートを使用して管理サーバーに接続し、SSL を使用できない古いクライアントは、保護されていないポートを使用して管理サーバーに接続します。

Cognos TM1 サーバーは、管理サーバーに自身を登録するときに、その Cognos

TM1 サーバーで SSL を使用するかどうかを指定します。Cognos TM1 クライアントが管理サーバーに接続するときに、管理サーバーへの接続にどちらのポートを使用したかによって、使用可能な Cognos TM1 サーバーのリストが変わります。保護されたポートをクライアントが使用している場合、管理サーバーはネットワーク上の使用可能なすべての Cognos TM1 サーバーのリストを返します。保護されていないポートをクライアントが使用している場合、管理サーバーは SSL を使用しない


Cognos TM1 サーバーのみのリストを返します。

生成される証明書IBM Cognos TM1 をインストールすると、SSL の実装に必要なすべての証明書およびその他のファイルが、TM1_install_dir¥bin¥SSL ディレクトリーに配置されます。

このディレクトリーに含まれる証明書は、OpenSSL を使って生成された Applix,

Inc. Certificate Authority によって発行されました。使用されたパスワードは「applix」です。

Cognos TM1 をインストールすると、管理サーバー、Cognos TM1 サーバー、および Cognos TM1 クライアントはすべて、TM1_install_dir¥bin¥SSL ディレクトリーにインストールされた証明書に基づいて SSL を使用するように設定されます。このCognos TM1 証明書を使用すると、複雑な設定を行わなくても SSL を実装できますが、最高のセキュリティーを得るには、これらの証明書を独自の証明書 (および証明書失効リスト) に置き換える必要があります。Cognos TM1 Web の場合は、すべてのルート証明書を、サーバーが Cognos TM1 Web の実行に使用するマシン上の証明書ストアにインストールしておく必要があります。

図 12. データ転送セキュリティーのための SSL の使用


TM1_install_dir¥bin¥SSL ディレクトリーには、以下の証明書とファイルがあります。拡張子が .pem のファイルは、Privacy Enhanced Mail 形式です。拡張子が .der

のファイルは、識別符号化規則です。

v Applixca.pem - ルート機関公開証明書

v Applixcacrl.pem - 証明書失効リスト

v Applixca.der - Java 証明書ストアで使用される DER 形式のルート機関公開証明書

v tm1admsvrcert.pem - 公開鍵/秘密鍵のペアが含まれる管理サーバー証明書

v tm1svrcert.pem - 公開鍵/秘密鍵のペアが含まれる Cognos TM1 サーバー証明書

v dh512.pem - 事前生成された 512 ビットの Diffie-Hellman 鍵を含むファイル



v tm1store - ルート機関公開証明書を含む Java 証明書ストア

v tm1cipher.dat - サーバーの秘密鍵にアクセスするためのパスワードを含む暗号化ファイル

v tm1key.dat - tm1cipher.dat の暗号化と復号化に使用する鍵

SSL を使用する Cognos TM1 管理サーバーの設定IBM Cognos Configuration を使用して、SSL を使用するように IBM Cognos TM1

管理サーバーを設定します。

Cognos Configuration を開き、SSL 関連のパラメーターを以下の表のように編集します。


非 SSL クライアントのサポートの有無

このパラメーターは、管理サーバーで非 SSL Cognos TM1

Client をサポートするかどうかを指定します。

管理サーバーが非 SSL クライアントをサポートし、セキュリティー保護された (SSL) ポートと保護されていないポートの両方のクライアント接続を listen するように構成するには、このパラメーターを True に設定します。

セキュリティー保護された 1 つのポートで SSL クライアント接続のみをサポートするように管理サーバーを構成するには、このパラメーターを False に設定します。



TLS v1.2 より前のクライアントのサポートの有無

TM1 10.2.2 フィックスパック 6 (10.2.2.6) 以降、TM1 のクライアントとサーバーの間のすべての SSL 保護通信に、Transport Layer Security (TLS) 1.2 が使用されます。このパラメーターは、10.2.2 フィックスパック 6 より前の TM1

クライアントおよび TM1 サーバーが、10.2.2.6 以降の管理サーバーに接続できるかどうかを指定します。

10.2.2.6 より前の TM1 クライアントおよび TM1 サーバーが管理サーバーに接続できるようにするには、このパラメーターを True に設定します。そのようにして接続が確立されると、TLS 1.2 の代わりに TLS 1.0 が使用されます。

10.2.2.6 より前の TM1 クライアントおよび TM1 サーバーが管理サーバーに接続できないようにするには、このパラメーターを False に設定します。

TM1 管理サーバーの認証局ファイルの場所

Cognos TM1 管理サーバーの認証局ファイルの絶対パスと名前。

証明書ファイルの場所 Cognos TM1 管理サーバーの認証ファイル (公開鍵/秘密鍵のペアが入っています) の絶対パス。

Diffie-Hellman 512 ビット鍵ファイルの場所

事前生成された 512 ビットの Diffie-Hellman 鍵を格納するファイルの絶対パス名。

Diffie-Hellman パラメーターの生成には、高い計算コストが発生する可能性があります。リソースの消費を最小限に抑え、Cognos TM1 サーバーのロードに必要な時間を短縮するために、512 ビットの Diffie-Hellman 鍵は事前に生成してファイルに保管し、管理サーバーの始動時にはそのファイルを呼び出すようにしてください。

Diffie-Hellman 1024 ビット鍵ファイルの場所

事前生成された 1024 ビットの Diffie-Hellman 鍵を格納するファイルの絶対パス。

Diffie-Hellman パラメーターの生成には、高い計算コストが発生する可能性があります。リソースの消費を最小限に抑え、Cognos TM1 サーバーのロードに必要な時間を短縮するために、1024 ビットの Diffie-Hellman 鍵は事前に生成してファイルに保管し、管理サーバーの始動時にはそのファイルを呼び出すようにしてください。

TM1 管理サーバーの秘密鍵パスワード・ファイルの場所

Cognos TM1 管理サーバーの秘密鍵の暗号化パスワードを格納するファイルの絶対パス。

TM1 管理サーバーのパスワード鍵ファイルの場所

秘密鍵のパスワードの暗号化/復号に使用するキーを格納するファイルの絶対パス。



TM1 管理サーバーの証明書のエクスポート

Cognos TM1 管理サーバーの証明書を Windows の証明書ストアからエクスポートするかどうかを指定します。

このパラメーターを True に設定すると、管理サーバーから管理サーバーの証明書の要求があったときに、Windows の証明書ストアの証明書がエクスポートされます。

独自のセキュリティー証明書を使用する方法と、Windows

の証明書ストアから証明書をエクスポートする方法の詳細については、 318ページの『Planning Analytics で独自の証明書に基づいて SSL を使用する方法』を参照してください。

TM1 管理サーバーの証明書ID

Cognos TM1 管理サーバーの証明書の発行先となるプリンシパルの名前を指定します。

証明書失効ファイルの場所 Cognos TM1 管理サーバーの証明書失効ファイルの絶対パス。

証明書失効ファイルは、失効した証明書がある場合のみ存在します。

TM1 管理サーバーのエクスポート鍵 ID

Microsoft Windows の証明書ストアから管理サーバーの証明書をエクスポートする際に使用する識別キーを指定します。

このパラメーターが必要になるのは、証明書ストアを使用するように選択した場合のみです。

TM1 管理サーバーの証明書のバージョン

TM1 が生成した SSL 証明書のどのバージョンを使用するかを指定します。

デフォルトでは、TM1 が生成した証明書の 1024 ビット暗号化バージョンが使用されます。

このパラメーターは、デフォルト証明書の新規 2048 ビット暗号化バージョンを使用する場合にのみ変更してください。この新しいバージョンは古い TM1 クライアントと新しいTM1 クライアントの両方で使用できますが、新しい認証局ファイルを使用するようにクライアントを設定する必要があります。

注: 独自の SSL 証明書を使用している場合、このパラメーターは適用されません。

有効な値は以下のとおりです。

v 1 - 1024 ビット暗号化、sha-1 の認証局を有効にします(デフォルト値)

v 2 - 2048 ビット暗号化、sha-256 の認証局を有効にします


SSL を使用する Cognos TM1 サーバーの設定SSL を使用するように IBM Cognos TM1 サーバーを設定するには、Tm1s.cfg

(Cognos TM1 サーバーの設定ファイル) のパラメーターを幾つか設定する必要があります。

次の表で、Tm1s.cfg 設定ファイルで指定可能な、SSL に関連するパラメーターについて説明します。なお、この表に示しているのは、Tm1s.cfg の SSL 関連のパラメーターのみです。Tm1s.cfg の他のパラメーターは、すべて 342ページの『tm1s.cfg

ファイルのパラメーター』で説明しています。


UseSSL Cognos TM1 サーバーの SSL を有効または無効にします。

このパラメーターは、デフォルトで有効です。

UseSSL=F に設定すると、SSL が無効になります。この設定の場合は、クライアントが非セキュア・モードでサーバーと接続できます。

AdminSvrSSLCertID Cognos TM1 管理サーバーの証明書の発行先となるプリンシパルの名前を指定します。

このパラメーターの値は、IBM Cognos

Configuration で設定した「TM1 管理サーバーの証明書 ID」パラメーターと同じでなければなりません。

AdminSvrSSLCertID の設定が正しくない場合、Cognos TM1 Web に空のサーバー・プルダウン・メニューが表示され、TM1web.log

ファイルにエラーがログ記録されます。

AdminSvrSSLCertAuthority Cognos TM1 管理サーバーの証明書を発行した認証局ファイルの絶対パス。

AdminSvrSSLCertRevList Cognos TM1 管理サーバーの証明書を最初に発行した認証局により発行された証明書失効ファイルの絶対パス。証明書失効ファイルは、証明書が失効した場合に限り存在します。



ExportAdminSvrSSLCert Cognos TM1 管理サーバーの証明書をMicrosoft Windows の証明書ストアからエクスポートするかどうかを指定します。

ExportAdminSvrSSLCert=T の場合は、Cognos

TM1 サーバーから管理サーバーの証明書が要求されたときに、Microsoft Windows の証明書ストアの証明書がエクスポートされます。

ExportAdminSvrSSLCert=T の場合は、次のtm1s.cfg パラメーターも設定する必要があります。

v AdminSvrSSLCertID

v AdminSvrSSLExportKey

v SvrSSLExportKeyID

v SSLCertificateID

v SSLPwdKeyFile

v SSLPrivateKeyPwdFile

v SSLCertAuthority

v ClientExportSSLSvrCert

AdminSvrSSLExportKeyID Microsoft Windows の証明書ストアから管理サーバーの証明書をエクスポートする際に使用する識別キーを指定します。

このパラメーターが必要なのは、ExportAdminSvrSSLCert=T に設定して、証明書ストアを使用するようにした場合のみです。

SSLCertificate 公開鍵/秘密鍵のペアを格納する証明書ファイルの絶対パス。

SSLCertAuthority Cognos TM1 サーバーの認証局ファイルの名前。このファイルは、Cognos TM1 サーバーがインストールされているコンピューター上に存在する必要があります。

SSLCertRevocationFile Cognos TM1 サーバーの証明書失効ファイルの名前。証明書失効ファイルは、証明書が失効している場合のみ存在します。このファイルは、Cognos TM1 サーバーがインストールされているコンピューター上に存在する必要があります。

SSLCertificateID Cognos TM1 サーバーの証明書の発行先となるプリンシパルの名前。



CertificateVersion TM1 が生成した SSL 証明書のどのバージョンを使用するかを指定します。

このパラメーターは、デフォルト証明書の新規 2048 ビット暗号化バージョンを使用する場合にのみ変更してください。

この新しいバージョンは古い TM1 クライアントと新しい TM1 クライアントの両方で使用できますが、新しい認証局ファイルを使用するようにクライアントを設定する必要があります。


v 1 - 1024 ビット暗号化、sha-1 の認証局を有効にします (デフォルト値)

v 2 - 2048 ビット暗号化、sha-256 の認証局を有効にします

:

ExportSvrSSLCert Cognos TM1 サーバーの証明書を Microsoft

Windows の証明書ストアからエクスポートするかどうかを指定します。

ExportSvrSSLCert=T の場合は、Cognos TM1

サーバーから Cognos TM1 サーバーの証明書の要求があったときに、Windows の証明書ストアの証明書がエクスポートされます。

ExportSvrSSLCert=T の場合は、次のtm1s.cfg パラメーターも設定する必要があります。

v AdminSvrSSLCertID

v AdminSvrSSLExportKey

v SvrSSLExportKeyID

v SSLCertificateID

v SSLPwdKeyFile

v SSLPrivateKeyPwdFile

v SSLCertAuthority

v ClientExportSSLSvrCert

独自のセキュリティー証明書を使用する方法と、Microsoft Windows の証明書ストアから証明書をエクスポートする方法の詳細については、 318ページの『Planning Analytics で独自の証明書に基づいて SSL を使用する方法』を参照してください。



SvrSSLExportKeyID Cognos TM1 サーバーの証明書を Microsoft

Windows の証明書ストアからエクスポートするための識別キー。

このパラメーターが必要なのは、ExportSvrSSLCert=T を設定して、証明書ストアを使用するようにした場合のみです。

SSLPrivateKeyPwdFile 秘密鍵の暗号化パスワードが入っている .dat

ファイルの絶対パス。

SSLPwdKeyFile 秘密鍵のパスワードの暗号化/復号に使用する鍵が入っている .dat ファイルの絶対パス。

ClientExportSSLSvrCert Cognos TM1 サーバーの証明書を発行するときに最初に使用された認証局証明書を、Cognos TM1 クライアントが Microsoft

Windows の証明書ストアから取得するかどうかを指定します。

ClientExportSSLSvrCert=T の場合は、Cognos TM1 クライアントから認証局証明書が要求されたときに、クライアント・コンピューター上の証明書ストアからエクスポートされます。

ClientExportSSLSvrKeyID Cognos TM1 サーバーの証明書を発行するときに最初に使用された認証局証明書を、TM1

クライアントが Windows の証明書ストアからエクスポートする際に使用する識別キー。

DHFile-512 事前生成された 512 ビットの Diffie-Hellman

鍵を格納するファイルの絶対パス。

Diffie-Hellman パラメーターの生成には、非常に高い計算コストが発生する可能性があります。このコストを最小限に抑えるために、512 ビットの Diffie-Hellman 鍵は事前に生成してファイルに保管し、Cognos TM1 サーバーの始動時にはそのファイルを呼び出すことができます。



DHFile-1024 事前生成された 1024 ビットのDiffie-Hellman 鍵を格納するファイルの絶対パス名。


DHFile-2048 事前生成された 2048 ビットのDiffie-Hellman 鍵を格納するファイルの絶対パス名。


SSL を使用する Cognos TM1 クライアントの設定SSL を使用するように IBM Cognos TM1 Architect または Perspectives クライアントを設定するには、「Cognos TM1 のオプション」ダイアログ・ボックスでいくつかのオプションを設定する必要があります。

1. Cognos TM1 Architect または Cognos TM1 Perspectives でサーバー・エクスプローラーを開きます。

2. サーバー・エクスプローラーで「ファイル」>「オプション」をクリックします。

3. 「管理サーバー Secure Socket Layer (SSL)」セクションにある SSL オプションを編集します。

次の表に、「TM1 のオプション」ダイアログ・ボックスで設定可能なすべての SSL

関連オプションと、そのオプションに対応する Tm1p.ini のパラメーターを示します。

オプション名対応する Tm1p.ini パラメーター説明

認証局 AdminSvrSSLCertAuthority Cognos TM1 管理サーバーの証明書を発行した認証局ファイルの絶対パス。


オプション名対応する Tm1p.ini パラメーター説明

証明書呼び出しリスト

AdminSvrSSLCertRevList Cognos TM1 管理サーバーの証明書を最初に発行した認証局により発行された証明書失効ファイルの絶対パス。証明書失効ファイルは、失効した証明書がある場合にのみ存在します。

証明書 ID AdminSvrSSLCertID注: Cognos TM1 管理サーバーの証明書の発行先となるプリンシパルの名前。

このパラメーターの値は、IBM Cognos

Configuration で設定した IBM Cognos

TM1 管理サーバーの SSLCertificateID

パラメーターと同じでなければなりません。

証明書の格納場所を使用

ExportAdminSvrSSLCert Cognos TM1 管理サーバーの証明書を発行するときに最初に使用した認証局証明書を Microsoft Windows の証明書ストアから実行時にエクスポートする場合には、このオプションを選択します。

「Cognos TM1 のオプション」ダイアログ・ボックスでこのオプションを選択する操作は、Tm1p.ini ファイルでExportAdminSvrSSLCert=T を設定する操作に相当します。

このオプションを選択する場合、「Cognos TM1 のオプション」ダイアログ・ボックスで「証明書 ID のエクスポート」の値も設定する必要があります。

証明書 ID のエクスポート

AdminSvrSSLExportKeyID Cognos TM1 管理サーバーの証明書を発行するときに最初に使用された認証局証明書を証明書ストアからエクスポートする際に使用する識別キー。


SSL を使用するための Cognos TM1 Web の設定IBM Cognos TM1 Web で SSL を有効にするには、 Java Runtime Environment

(JRE) 鍵ストアに証明書を追加する必要があります。


始める前に

デフォルトで、Cognos TM1 Web は Cognos TM1 インストールの一部として含まれている標準のデフォルト SSL 証明書を使用します。独自のカスタム SSL 証明書を使用するには、その証明書を Java Runtime Environment (JRE) 鍵ストアに追加します。

手順1. IBM Cognos Configuration を開いて、以下のパラメーターに対してセキュアな

HTTPS URL を入力します。

v TM1 アプリケーション・サーバーゲートウェイ URI - 例えば、http://system_name:9514/pmpsvc

v 外部サーバー URI - 例えば、http://system_name:9514

特定の設定のためのシステム名とポート番号を入力します。

2. 32 ビット・インストールの場合:

a. コマンド・プロンプトを開いて、ディレクトリーを Cognos TM1 のインストール時に指定した JRE の場所に変更します。

tm1_location¥bin¥jre¥7.0¥bin

例:

C:¥Program Files¥IBM¥cognos¥tm1¥bin¥jre¥7.0¥bin>

b. Java keytool コマンドを実行して、証明書を鍵ストアにインポートします。

注: ここではコマンドは書式上改行されていますが、コマンド全体を 1 行で入力する必要があります。

keytool.exe -import -trustcacerts -file“c:\Program Files\ibm\cognos\tm1\bin\ssl\your_certificate.pem”-alias your_certificate -keystore"c:\Program Files\ibm\cognos\tm1\bin\jre\7.0\lib\security\cacerts"

your_certificate.pem および your_certificate を、独自の証明書のファイル名と名前に置き換えます。




3. 64 ビット・インストールの場合:

重要: 64 ビット・コンピューターの場合、必ず bin64 フォルダーに証明書を追加してください。

a. コマンド・プロンプトを開いて、ディレクトリーを Cognos TM1 のインストール時に指定した JRE の場所に変更します。

C:¥Program Files¥ibm¥cognos¥TM1_64¥bin64¥jre¥7.0¥bin

b. Java keytool コマンドを実行して、証明書を鍵ストアにインポートします。

64 ビット・インストール環境の場合、証明書を扱う際には 64 ビットのフォルダーがターゲットになります。64 ビット・インストール環境を実行する際


に、証明書用の 64 ビットの場所が正しくターゲットとして指定されていない場合、サーバーに接続できないという警告メッセージを受け取ることになります。

注: このコマンドは書式上改行されていますが、コマンド全体を 1 行で入力する必要があります。

keytool.exe -import -trustcacerts -file"c:\Program Files\ibm\cognos\TM1_64\bin64\ssl\your_certificate.pem"-alias your_certificate -keystore"c:\Program Files\ibm\cognos\TM1_64\bin64\jre\7.0\lib\security\cacerts"

your_certificate.pem および your_certificate を、独自の証明書のファイル名と名前に置き換えます。




4. IBM Cognos Configuration を使用して TM1 アプリケーション・サーバーを再始動し、変更内容が有効になるようにします。

a. Cognos Configuration で、「環境」ノードを展開し、「TM1 アプリケーション・サーバー」を右クリックして「停止」を選択します。

b. 「TM1 アプリケーション・サーバー」を右クリックして、「開始」を選択します。

要確認: Cognos TM1 を再インストールするたびに、証明書を再追加してください。

タスクの結果

セキュアな HTTPS URL を使用して Cognos TM1 Web にログオンし、この設定を使用して Cognos TM1 に接続できることを確認します。

この例では、https://system_name:9514/tm1web を使用してログオンします。

SSL を使用する Cognos TM1 Applications の設定SSL を使用するように IBM Cognos TM1 Applications を設定するには、Cognos

TM1 Applications と対話する他の Cognos TM1 コンポーネントに SSL を設定し、Cognos TM1 Applications をサポートする Web サーバーを設定し、Cognos TM1

Applications 設定を編集します。

始める前に

SSL を使用せずに Cognos TM1 Applications をインストールおよび設定し、プログラムを実行でき、プログラムにログオンできることを確認します。


別の認証局からの証明書を使用するタスクの中には、ThirdPartyCertificateTool

というコマンド行ツールを使用するものがあります。このツールは C:¥Program

Files¥ibm¥cognos¥tm1_64¥bin にあります。このツールの詳細については、 323ページの


ージの『ThirdPartyCertificateTool コマンド行のリファレンス』を参照してください。

手順1. SSL を使用するように TM1 管理サーバーを設定します。

301ページの『SSL を使用する Cognos TM1 管理サーバーの設定』を参照してください。

2. SSL を使用するように TM1 サーバーを設定します。

304ページの『SSL を使用する Cognos TM1 サーバーの設定』を参照してください。

3. SSL を使用するように TM1 Web を設定します。

309ページの『SSL を使用するための Cognos TM1 Web の設定』を参照してください。

4. 証明書ファイルを以下の Cognos TM1 Applications SSL フォルダーにコピーします。

<Cognos TM1 のインストール場所>¥webapps¥pmpsvc¥WEB-INF¥bin¥ssl

5. 独自の証明書を使用している場合は、次のようにインポートします。

a. Cognos TM1 管理サーバーが稼働しているコンピューターで、IBM Cognos

Configuration を使用して管理サーバーの SSL パラメーターを更新します。

320ページの『独立した証明書を使用するための Cognos Configuration でのSSL パラメーターの編集』を参照してください。

b. Cognos TM1 サーバーが稼働しているコンピューターで、tm1crypt.exe ツールを実行します。

318ページの『TM1Crypt ユーティリティーの実行』を参照してください。

c. Cognos TM1 Applications については、 314ページの『TM1 アプリケーション・サーバーへのサード・パーティー CA SSL 証明書のインポート』を参照してください。

6. Cognos Configuration ツールで、https 接頭部が使用されるように、「TM1 アプリケーション・サーバーゲートウェイ URI」と「外部サーバー URI」を変更します。

7. 設定を保存して、TM1 アプリケーション・サーバーを再始動します。

8. Cognos TM1 アプリケーション・サーバーが稼働しているコンピューターで、Cognos TM1 Applications 設定ファイル fpmsvc_config.xml を編集します。

a. fpmsvc_config.xml ファイルを開きます。

v 付属の Apache Tomcat とともに Cognos TM1 Applications を配布した場合、次のファイルを探します。

<Cognos TM1 のインストール場所>¥webapps¥pmpsvc¥WEB-

INF¥configuration

v 別の Web アプリケーション・サーバーとともに配布した場合、次のファイルを探します。


<Web アプリケーション・サーバーのプログラム・ファイル>¥webapps¥pmpsvc¥WEB-INF¥configuration

b. </tm1><servers> セクションの下の以下のエントリーを編集または追加します。

<certificate authority="authority_file_name" id="id_name" />

authority_file_name は証明書ファイルの名前で、id_name は証明書の名前です。このファイルは、次のフォルダーにあることが必要です。

<Cognos TM1 のインストール場所>¥webapps¥pmpsvc¥WEB-INF¥bin¥ssl

要確認: このファイルは、手動でこの場所にコピーする必要があります。

c. SSL 証明書失効リストを指定するには、オプションの revocationList 属性を使用します。指定した場合、同じ名前のファイルが ¥pmpsvc¥WEB-

INF¥bin¥ssl フォルダーにあることが必要です。

d. Cognos TM1 管理サーバーの権限および証明書 ID を指定するには、admin_host セクションの下に同じ <certificate authority /> セクションを追加します。証明書が指定されていない場合は、デフォルトの証明書が使用されます。

9. Cognos TM1 Application Web クライアントの URL 設定を更新します。

a. Cognos TM1 Applications にログオンします。

b. Cognos TM1 Applications のメインページのツールバーから「IBM Cognos

TM1 Applications の管理」アイコンをクリックします。

c. 「TM1 Application Web」チェック・ボックスをクリックした後、「編集」をクリックします。

d. 「URL」フィールドの値を、Cognos TM1 Web のインストール済み環境の安全な URL に更新します。例:

https://web server name:9510/tm1web/Contributor.jsp

e. 「OK」をクリックします。

10. TM1 Applications SSL 証明書を Java クライアントの鍵ストアにインポートします。

a. TM1 Applications のルート SSL 証明書をエクスポートします。

改行されていますが、これは単に掲載を目的としたものです。

cd <install>\tm1_64\binThirdPartyCertificateTool.bat -E -T -rc:\tmp\cacert.cer -k"<install>/tm1_64/configuration/signkeypair/jCAKeystore"-p NoPassWordSet

b. SSL 証明書を Java 鍵ストアにインポートします。

cd <install>\tm1_64\bin64\jre\7.0\binkeytool -import -file c:\tmp\cacert.cer -keystore "<install>\tm1_64\bin64\jre\7.0\lib\security\cacerts"-storepass changeit -alias TM1ApplicationsSSL


TM1 アプリケーション・サーバーへのサード・パーティー CA SSL証明書のインポート以下の一般的な指示を例として使用し、サード・パーティー認証局 (CA) の SSL 証明書を TM1 アプリケーション・サーバーにインポートして使用します。


正確なステップは、使用するサード・パーティー・ツールによって異なります。

別の認証局からの証明書を使用するタスクの中には、ThirdPartyCertificateTool

というコマンド行ツールを使用するものがあります。このツールは C:¥Program

Files¥ibm¥cognos¥tm1_64¥bin にあります。このツールの詳細については、 323ページの『ThirdPartyCertificateTool コマンド行のリファレンス』を参照してください。

手順1. 自己署名 CA 証明書を作成します。

例えば、以下のサンプルでは、OpenSSL を使用して app_ca.pem という自己署名 CA 証明書を作成します。

openssl req -new -x509 -extensions v3_ca -keyout app_ca/private/

app_cakey.pem -out app_ca/app_ca.pem -days 3650 -config

./bi_ca_openssl.cnf

2. 署名鍵の証明書署名要求を作成します。

例えば、以下の行をテンプレートとして使用します。

ThirdPartyCertificateTool.bat -java:local -c -s -d

"CN=TM1_Signer,O=IBM_TM1,ST=MA,C=US" -r signRequest.csr -D "c:\Program

Files\ibm\cognos\tm1_64\configuration\signkeypair" -p password

..\bin\jre\7.0\bin\java.exe

com.cognos.accman.jcam.utilities.ThirdPartyCertateTool -c -s -d

"CN=TM1_Signer,O=IBM_TM1,ST=MA,C=US" -r signRequest.csr -D Program

Files\ibm\cognos\tm1_64\configuration\signkeypair" -p password

3. 暗号化鍵の証明書署名要求を作成します。

ThirdPartyCertificateTool.bat -java:l -c -e -d

"CN=aplxprince.swg.usma.ibm.com,O=IBM_TM1,ST=MA,C=US" -r

encryptRet.csr -D "c:\Program Files\ibm\cognos\tm1_64\configuration\

encryptkeypair" -p password

4. signRequest.csr および encryptRequest.csr ファイルを、利用している認証局がアクセスできるディレクトリーにコピーします。

5. signRequest.csr と encryptRequest.csr ファイルを認証局に入力し、証明書を生成します。

例えば、以下のサンプルでは OpenSSL をこのステップで使用します。

C:\openssl.exe ca -out signRequest.pem -config ./bi_ca_openssl.cnf

-infiles signRequest.csr


C:\openssl.exe ca -out encryptRequest.pem -config ./bi_ca_openssl.cnf

-infiles encryptRequest.csr

6. signRequest.pem、encrpytRequest.pem、および app_ca.pem の名前を変更します。

この例では、ファイルは signCertificate.cer、encryptRequest.cer、およびca.cer という名前に変更されます。

7. 3 つの CA 証明書を IBM Cognos 証明書ストアに入力します。

ThirdPartyCertificateTool.bat -java:local -i -s -r signCertificate.cer

-D "c:\Program Files\ibm\cognos\tm1_64\configuration\signkeypair" -p

password -t ca.cer

ThirdPartyCertificateTool.bat -java:local -i -e -r signCertificate.cer

-D "c:\Program Files\ibm\cognos\tm1_64\configuration\encryptkeypair" -p

password -t ca.cer

ThirdPartyCertificateTool.bat -java:local -i -T -r ca.cer -D

"c:\Program Files\ibm\cognos\tm1_64\configuration\signkeypair" -p

password

8. Cognos Configuration を開き、StandaloneCertificateAuthority 詳細プロパティーを true に設定します。

a. 「ローカル設定」を選択し、「クリックして編集」ボタンをクリックしてから、「追加」をクリックします。

b. 「名前」ボックスに StandaloneCertificateAuthority と入力します。

c. 「値」ボックスに True と入力します。

d. 「OK」をクリックします。

重要: StandaloneCertificateAuthority 詳細プロパティーを true に設定しない場合、設定を Cognos Configuration に保存しようとすると、次のメッセージが表示されます。

[Cryptography] [ ERROR ] CAM-CRP-1132 認証局 Service に証明書を要求中にエラーが発生しました。認証局サービスから次のエラーが返されました。CAM-CRP-1039 新しい証明書を生成できません。認証局のシリアル番号を更新する際にエラーが発生しました。理由: java.io.FileNotFoundException

9. Cognos Configuration で、「TM1 アプリケーション・サーバー・ゲートウェイURI」が localhost に設定されていることを確認します。

a. 「環境」>「TM1 アプリケーション・サーバー」ノードを展開します。

b. 「TM1 アプリケーション・サーバー・ゲートウェイ URI」プロパティーの値を確認します。


10. Cognos Configuration で、他のステップで使用したものと同じパスワードを以下の場所に入力します。

v 「セキュリティー」>「暗号化」>「Cognos」>「署名鍵の設定」>「署名鍵ストアのパスワード」


v 「セキュリティー」>「暗号化」>「Cognos」>「暗号化鍵の設定」>「暗号化鍵ストアのパスワード」

11. TM1 アプリケーション・サーバーを再始動します。

a. Cognos Configuration で、「環境」>「TM1 アプリケーション・サーバー」ノードを展開します。

b. 「TM1 アプリケーション・サーバー」を右クリックし、「停止」を選択した後、「始動」を選択します。

SSL を使用する TM1 C API の設定TM1 C API の一部として使用可能な共有ルーチンがいくつかあります。これらのルーチンを使用すると、管理サーバーとの通信を SSL で行うようにクライアントを設定できます。

詳しくは、「IBM Cognos TM1 API」の『SSL を使用する TM1 C API の設定』を参照してください。

SSL を使用する Cognos TM1 Java API の設定Java クライアントでサーバーの検証に使用する証明書は、Java システムの cacerts

トラストストア・ファイル内に存在するか、またはアプリケーションのコマンド行で指定する必要があります。

Java システムの cacerts トラストストアは、Java の ¥lib¥security ディレクトリーにあります。

例:

C:\Program Files\Java\JDK1.5.0_04\lib\security

cacerts のデフォルト・パスワードは、「changeit」です。 Java には、この目的のために「keytool.exe」という実行可能ファイルが用意されています。例:

keytool -keystore ..\lib\security\cacerts -alias Company-import -file Companyca.der

アクセスがシステムの cacerts トラストストアに限定されている場合は、トラストストアを作成できます (オプション)。例:

keytool -keystore tm1store -alias Companyca -import -fileACompanyca.der

Java アプリケーションを開始する際は、この鍵ストアを指定する必要があります。パスワードが必要な場合は、パスワードも指定する必要があります。例:

java -Djavax.net.ssl.trustStore=bin\ssl\tm1store -Djavax.net.ssl.

trustStorePassword=Companycom.mycompany.MyApp

詳細については、Java 2 Platform Standard Edition の API 仕様を参照してください。サポートされている Java の最小バージョンは 1.4.2 です。


SSL を使用する Cognos TM1 ETLDAP ユーティリティーの設定SSL を使用して LDAP サーバーに接続するには、その前に次のコマンドを実行して、<TM1 のインストール・ディレクトリー>¥axajre¥bin ディレクトリーの IBM

Cognos TM1 ストアに証明書を追加しておく必要があります。

例:

C:\Program Files\Cognos\Tm1\axajre\bin >keytool -keystore"C:\Program Files\Cognos\Tm1\bin\ssl\tm1store" -alias Applixldapca-import -file c:\temp\certificate_name.cer

上記のコマンドで、certificate_name.cer の代わりに証明書ファイルの名前を指定してださい。

鍵ストアのパスワードを要求されたら、「applix」と入力します。

証明書が Cognos TM1 鍵ストアに追加されたことを知らせる確認メッセージが表示されます。

LDAP サーバーに接続する場合は、「SSL」オプションをオンにする必要があります。

「SSL」オプションがオンになっていない場合は、LDAP サーバーがユーザー情報を認証できません。

ETLDAP ユーティリティーをコマンド行から実行するときに SSL を有効にするには、次の 2 つのパラメーターを使用する必要があります。


-Djavax.net.sll.truststore このパラメーターは、ルート機関公開証明書が含まれる Java 証明書ストアへの絶対パスを指定するために使用します。

例えば、Cognos TM1 にインストールされている Java 証明書ストアを使用するには、次のパラメーターを使用します。-Djavax.net.sll.truststore= C:¥Program

Files¥Cognos¥TM1¥bin¥ssl¥tm1store

-Djavax.net.ssl.trustStorePassword このパラメーターは、Java 証明書ストアの作成に使用されたパスワードを指定するために使用します。

例えば、Cognos TM1 にインストールされたJava 証明書ストアの作成に使用されたパスワードを指定するには、次のパラメーターを使用します。-Djavax.net.ssl.trustStorePassword=applix


Planning Analytics で独自の証明書に基づいて SSL を使用する方法

IBM Planning Analytics の標準インストールでは、TM1_install_dir¥bin¥SSL ディレクトリーにインストールされる証明書に基づいて SSL を使用するように構成されますが、セキュリティーを最大限に強化するには独自の証明書を使用する必要があります。

これからのセクションでは、独自の証明書を使用して SSL を実装する方法について説明します。

Microsoft Windows 証明書ストアへの証明書の追加独自の証明書を Microsoft Windows の証明書ストアに追加し、そのストア内の証明書を使用するように IBM Cognos TM1 を設定することができます。

手順1. Windows の「スタート」メニューから、「スタート」>「名前を指定して実行」をクリックし、「mmc」と入力して Microsoft 管理コンソールを開きます。

2. Microsoft 管理コンソールで、「ファイル」>「スナップインの追加と削除」をクリックします。


4. 「証明書」を選択し、「追加」をクリックします。

5. 「ユーザー・アカウント」を選択し、「完了」をクリックします。「OK」をクリックします。

6. 「証明書 - 現在のユーザー」の下の「個人」を右クリックし、「すべてのタスク」>「インポート」を選択します。「次へ」をクリックします。

7. 「参照」をクリックし、証明書情報を含む .pfx ファイルを選択します。「次へ」をクリックします。

8. 秘密鍵のパスワードを入力し、「このキーをエクスポート可能にする」オプションをオンにします。「次へ」をクリックします。

9. 必要に応じて画面を設定して、「次へ」をクリックします。

10. 「証明書のインポート・ウィザード」の最終画面で「完了」をクリックします。

TM1Crypt ユーティリティーの実行TM1Crypt ユーティリティー (TM1Crypt.exe) は、IBM Cognos TM1 サーバーが秘密鍵にアクセスする際に必要なパスワードを暗号化します。

パスワードは、Advanced Encryption Standard の 256 ビット暗号ブロック連鎖(AES-256-CBC) を使用して暗号化されます。

場所

TM1Crypt ユーティリティー tm1crypt.exe は、以下のディレクトリーにインストールされます。

<TM1 インストール・ディレクトリー>¥bin


構文

TM1Crypt ユーティリティーは、コマンド・プロンプトから次の構文を使用して実行します。

tm1crypt.exe -pwd password -keyfile filename -outfile filename -fipsmode

[1|2|3]-validate

コマンド・オプション

表 30. TM1Crypt ユーティリティーのオプション


-pwd (必須) 秘密鍵のパスワード。これは、証明書の暗号化に使用したパスワードと同じにしてください。

-keyfile 生成する .dat ファイルの名前。このファイルに、秘密鍵のパスワードの暗号化/復号化に使用するキーが含まれます。

このパラメーターが指定されていない場合は、tm1key.dat というファイルが生成されます。

注: -keyfile オプションのファイル名は、Cognos Configuration のSSLPwdKeyFile パラメーターおよび tm1s.cfg ファイルにおいても使用されます。

-outfile 生成する .dat ファイルの名前。このファイルには、秘密鍵の暗号化パスワードが含まれます。

このパラメーターが指定されていない場合は、tm1cipher.dat というファイルが生成されます。

注: -outfile オプションのファイル名は、Cognos Configuration のSSLPrivateKeyPwdFile パラメーターおよび tm1s.cfg ファイルにおいても使用されます。

-validate -validate パラメーターを指定すると、暗号化されたパスワードが復号化され、その結果が平文で表示されます。

表示されたテキストは、-pwd パラメーターで指定したパスワードと一致するはずです。

このパラメーターは、既存ファイルの検証を許可しません。

例

例えば、コマンド

tm1crypt.exe -pwd abc123 -keyfile btkey.dat -outfile btprk.dat -validate

は次の 2 つのファイルを生成します。

v btkey.dat - 秘密鍵のパスワードの暗号化/復号に使用される鍵が含まれます

v btprk.dat - 秘密鍵の暗号化パスワードが含まれます。


生成されたファイルは、TM1 のインストール・ディレクトリー¥bin ディレクトリーに出力されます。

独立した証明書を使用するための Cognos Configuration での SSLパラメーターの編集証明書を Microsoft Windows の証明書ストアに追加した後、IBM Cognos

Configuration を使用して Cognos TM1 管理サーバーの SSL パラメーターを更新します。

表 31. 独立した証明書をサポートする Cognos Configuration の SSL パラメーター


TM1 管理サーバーの証明書のエクスポート

このパラメーターは True に設定して、管理サーバーが証明書ストアから証明書を取得できるようにする必要があります。

TM1 管理サーバーの認証局ファイルの場所

TM1 管理サーバーの証明書を発行した認証局ファイルの絶対パスと名前。

この値は、Microsoft 管理コンソールを参照して確認できます。「証明書」>「個人」>「証明書」をクリックしてください。機関の名前が、「プロパティー」ウィンドウの「発行者」列に表示されます。

TM1 管理サーバーの証明書 ID

IBM Cognos TM1 管理サーバーの証明書発行先のプリンシパルの名前。

この値は、Microsoft 管理コンソールを参照して確認できます。「証明書」>「個人」>「証明書」をクリックしてください。プリンシパル名が、プロパティー・ウィンドウの「発行先」列に表示されます。

TM1 管理サーバーの秘密鍵パスワード・ファイルの場所

秘密鍵の暗号化パスワードを含む .dat ファイルへの絶対パス。

注: このファイルの名前は、TM1Crypt ユーティリティーを実行するときの -outfile パラメーターで指定されます。

例えば、次のコマンドで TM1Crypt ユーティリティーを実行するとします。

tm1crypt.exe -pwd abc123 -keyfile btkey.dat -outfile

btprk.dat -validate

その場合の正しいパラメーター値は、次のようになります。

C:¥Program Files¥Cognos¥TM1¥bin¥btprk.dat


表 31. 独立した証明書をサポートする Cognos Configuration の SSL パラメーター (続き)


TM1 管理サーバーのパスワード鍵ファイルの場所

秘密鍵のパスワードの暗号化/暗号化解除に使用するキーを含む.dat ファイルへの絶対パス。

注: このファイルの名前は、TM1Crypt ユーティリティーを実行するときの -keyfile パラメーターで指定されます。



btprk.dat -validate

その場合の正しいパラメーター値は、次のようになります。

C:¥Program Files¥Cognos¥TM1¥bin¥btkey.dat

TM1 管理サーバーのエクスポート鍵 ID

Windows の証明書ストアから管理サーバーの証明書をエクスポートする際に使用する識別キーを指定します。

「TM1 管理サーバーのエクスポート鍵 ID」の値は、ほとんどの場合に「TM1 管理サーバーの証明書 ID」の値と同じになります。

独立した証明書を使用するための Tm1s.cfg ファイルでの SSL パラメーターの編集証明書を Microsoft Windows の証明書ストアに追加した後、Tm1s.cfg ファイルに必須の SSL パラメーターを追加します。

表 32. Tm1s.cfg ファイルの SSL パラメーター

パラメーター値

AdminSvrSSLCertID IBM Cognos TM1 管理サーバーの証明書が発行される先のプリンシパルの名前を指定します。

AdminSvrSSLExportKeyID Microsoft Windows の証明書ストアから管理サーバーの証明書をエクスポートする際に使用する識別キーを指定します。

ClientExportSSLSvrCert Cognos TM1 サーバーの証明書を発行するときに最初に使用された認証局証明書を、Cognos TM1 クライアントがMicrosoft Windows の証明書ストアから取得するかどうかを指定します。

ClientExportSSLSvrCert=T の場合、 TM1 Client から認証局証明書が要求されたときに、証明書ストアからエクスポートされます。

ClientExportSSLSvrKeyID Cognos TM1 サーバーの証明書の発行に元々使用された認証局証明書を、Cognos TM1 クライアントが Microsoft

Windows の証明書ストアからエクスポートする際に使用する識別キー。


表 32. Tm1s.cfg ファイルの SSL パラメーター (続き)


ExportAdminSvrSSLCert Cognos TM1 管理サーバーの証明書を Microsoft Windows

の証明書ストアからエクスポートするかどうかを指定します。

ExportAdminSvrSSLCert=T の場合は、Cognos TM1 サーバーから管理サーバーの証明書が要求されたときに、Microsoft

Windows の証明書ストアの証明書がエクスポートされます。

ExportSvrSSLCert このパラメーターは T に設定して、Cognos TM1 サーバーが Microsoft Windows の証明書ストアから証明書を取得できるようにする必要があります。

ExportSvrSSLCert=T

SSLCertAuthority 証明書を発行した機関の名前。

この値は、Microsoft 管理コンソールを参照して確認できます。「証明書」 > 「個人」 > 「証明書」をクリックしてください。機関の名前が、プロパティー・ウィンドウの「発行者」列に表示されます。

SSLCertificateID Cognos TM1 サーバーの証明書の発行先となるプリンシパルの名前。

この値は、Microsoft 管理コンソールを参照して確認できます。「証明書」 > 「個人」 > 「証明書」をクリックしてください。プリンシパル名が、プロパティー・ウィンドウの「発行先」列に表示されます。

SSLPrivateKeyPwdFile 秘密鍵の暗号化パスワードを含む .dat ファイルへの絶対パス。

注: このファイルの名前は、TM1Crypt ユーティリティーを実行するときの -outfile パラメーターで指定されます。



btprk.dat -validate

その場合の正しいパラメーター値は、SSLPrivateKeyPwdFile=C:\Program Files\Cognos\TM1\bin\

btprk.dat です。


表 32. Tm1s.cfg ファイルの SSL パラメーター (続き)


SSLPwdKeyFile 秘密鍵のパスワードの暗号化/暗号化解除に使用するキーを含む .dat ファイルへの絶対パス。

注: このファイルの名前は、TM1Crypt ユーティリティーを実行するときの -keyfile パラメーターで指定されます。



btprk.dat -validate

その場合の正しいパラメーター値は、SSLPwdKeyFile=C:\

Program Files\Cognos\TM1\bin\btkey.dat です。

SvrSSLExportKeyID Cognos TM1 サーバーの証明書を Microsoft Windows の証明書ストアからエクスポートするための識別キーを指定します。

SvrSSLExportKeyID の値は、ほとんどの場合にSSLCertificateID と同じになります。

ファイル・システム上の独自の証明書の使用自分のファイル・システム上に保存した独自の証明書ストアを使用して SSL を実装することができます。

証明書、認証局、パスワードなどのファイルを <TM1 インストール・ディレクトリー>¥bin¥SSL ディレクトリーに追加し、該当する IBM Cognos TM1 構成パラメーターを編集して、独自のファイルを指すように変更します。

ThirdPartyCertificateTool コマンド行のリファレンス別の認証局からの証明書を使用するタスクの中には、ThirdPartyCertificateTool

というコマンド行ツールを使用するものがあります。

このツールは、Cognos TM1 インストールの場所の ¥bin にあります。

例: C:¥Program Files¥IBM¥cognos¥tm1_64¥bin

UNIX または Linux オペレーティング・システムの場合、以下の形式を使用します。

ThirdPartyCertificateTool.sh parameters

Microsoft Windows オペレーティング・システムの場合、以下の形式を使用します。

ThirdPartyCertificateTool.bat parameters

次の表には、このコマンド行ツールのオプションがリストされています。


表 33. 主要な処理モード

コマンド説明

-c 新しい CSR の作成

-i 証明書のインポート

表 34. 処理修飾子

コマンド説明

-s 署名 ID の処理

-e 暗号化 ID の処理

-T トラストストアの処理 (-i の場合のみ)

表 35. 情報フラグ

コマンド説明

-d 証明書に使用する DN

-r CSR または証明書ファイルの場所 (モードに依存)

-t 認証局証明書ファイル (-i の場合のみ)

-p 鍵ストアのパスワード

-a 鍵ペアのアルゴリズム: RSA または DSA のいずれか。デフォルト値は RSA です。

-D ディレクトリーの場所

次の表に示すサンプル値を使用します。

表 36. サンプル値

プロパティー値

署名証明書識別名 (DN) 固有値。次のような形式になります。

CN=SignCert,O=MyCompany,C=CA

暗号化証明書 DN 固有値。次のような形式になります。

CN=EncryptCert,O=MyCompany,C=CA

鍵ストアのパスワードパスワード


第 19 章 Cognos TM1 インストールの保守

IBM Cognos TM1 を正常にインストールした後、追加コンポーネントのインストール、データと設定ファイルのバックアップとリストア、現行バージョンのアンインストールなどの保守タスクを実行できます。

追加コンポーネントのインストールCognos TM1 インストール・ウィザードに戻り、インストールされていない追加コンポーネントをインストールすることができます。

データと設定ファイルのバックアップデータと設定ファイルを定期的にバックアップすることを推奨します。特に、新規バージョンの Cognos TM1 にアップグレードする前には必ずこれを行ってください。

現行バージョンのアンインストールインストールされている Cognos TM1 コンポーネントによっては、それを削除するために個別にステップを実行しなければならない可能性があります。例えば、IBM Cognos Insight と IBM Cognos TM1 Performance Modeler

は、他の IBM Cognos TM1 コンポーネントとは別にアンインストールされます。

Cognos TM1 のデータと設定ファイルのバックアップこのトピックでは、IBM Cognos TM1 バージョン 10.2.x コンポーネントのデータと設定ファイルのバックアップ方法について説明します。


Cognos TM1 コンポーネントには、それぞれ独自の一連の関連データと設定ファイルがあります。使用しているコンポーネントのデータと設定情報をバックアップするには、以下のステップを確認して実行してください。

例:

v 実行している各 IBM Cognos TM1 サーバーにつき、Cognos TM1 データ・ディレクトリーと設定ファイルをバックアップします。

v Cognos TM1 Web を使用している場合、そのコンポーネントの関連データと設定ファイルをバックアップする必要があります。

v Cognos TM1 Applications を使用している場合、アプリケーションはエクスポートし、それ以外の関連ファイルはバックアップしてください。

手順1. IBM Cognos Configuration の構成設定値を、以下のようにしてエクスポートします。


Cognos Configuration ユーティリティーを使用して Cognos TM1 コンポーネント(Cognos TM1 管理サーバー、 Cognos TM1 サーバー、Cognos TM1 アプリケーション・サーバーなど) を実行および管理している場合、設定情報を XML ファイル形式で保存できます。

a. Cognos Configuration を開きます。

b. 「ファイル」>「名前を付けてエクスポート」をクリックします。

c. 場所を選択し、XML ファイルのファイル名を入力します。

d. 「保存」をクリックします。

2. Cognos TM1 サーバー・データベースをバックアップします。

IBM Cognos TM1 データベースのデータ・ディレクトリーとサブディレクトリーの内容のコピーを安全な場所に保存します。これらのディレクトリーには、データと設定ファイルの両方が入っています。例えば、Cognos TM1 サンプル・データベース・ディレクトリーとサブディレクトリーの場所は以下のとおりです。

<TM1_Install>¥samples¥tm1

3. 追加の Cognos TM1 設定ファイルを、以下のようにしてバックアップします。

保持する Cognos TM1 設定ファイル (<TM1_Install>¥bin¥ ディレクトリーにある Cognos TM1 管理サーバー・ロギング・プロパティー・ファイルtm1admsrv-log.properties など) のコピーを保存します。

4. Cognos TM1 Web をバックアップします。

Cognos TM1 Web を使用する場合、 tm1web_config.xml ファイルおよびすべてのカスタム Cognos TM1 Web サーバー・ページを安全な場所にバックアップします。これらのファイルのデフォルトの場所は、次のとおりです。

<TM1_Install>¥webapps¥tm1web¥

<TM1_Install>¥webapps¥tm1web¥web-inf¥configuration¥

5. Cognos TM1 Architect および Cognos TM1 Perspectives をバックアップします。

Cognos TM1 Architect または Cognos TM1 Perspectives を使用している場合は、以下の場所にある Tm1p.ini クライアント設定ファイルを保存します。

v %ALLUSERSPROFILE%¥Application Data¥Applix¥TM1¥

v %USERPROFILE%¥Application Data¥Applix¥TM1¥

ほとんどの場合、これらのファイルへの絶対パスは、次のとおりです。

v C:¥Documents and Settings¥All Users¥Application


v C:¥Documents and Settings¥<username>¥Application


6. Cognos TM1 Applications をバックアップします。

Cognos TM1 Applications を使用する場合、関連データと設定ファイルのバックアップについて次の手順を参照してください。



v 330ページの『Cognos TM1 Applications からのアプリケーションのエクスポート』

インストールされている Cognos TM1 コンポーネントの変更コンポーネントを再インストールするか、まだインストールされていないコンポーネントを追加することによって、現行インストールを変更することができます。


インストール・ウィザードではコンポーネントのインストールのみ行えます。この方法によってコンポーネントを削除することはできません。

注: プログラムの保守には、Cognos TM1 インストール・ディレクトリーの場所の変更は含まれていません。インストール・ディレクトリーの場所を変更するには、すべての Cognos TM1 ファイルを削除して、Cognos TM1 を別の場所に再インストールします。

手順1. インストールを開始するには、次のようにします。

v Cognos TM1 インストール・プログラムをダウンロードした場所に移動します。

v または、IBM Cognos TM1 製品ディスクを挿入します。

インストール・ウィザードが自動的に開かない場合は、オペレーティング・システムのディレクトリーに移動して、issetup.exe ファイルを見つけます。

2. オペレーティング・システム・ソフトウェアに応じて、issetup.exe ファイルを右クリックまたはダブルクリックします。

v Microsoft Windows Vista、Windows 7、または Windows Server 2008 オペレーティング・システム・ソフトウェアでは、issetup.exe コマンドを右クリックし、「管理者として実行」をクリックします。

v 他のすべての Windows オペレーティング・システム・ソフトウェアでは、issetup.exe をダブルクリックします。

3. 「次へ」をクリックして、「コンポーネントの選択」画面に進みます。

プロンプトが出されたら、以下の質問に応答します。

v 前のインストールと同じ場所にインストールしますか?

v 既存のインストールから全ファイルのバックアップを作成しますか?

4. 「コンポーネントの選択」画面で、インストールする Cognos TM1 コンポーネントを選択し、「次へ」をクリックします。

「コンポーネントの選択」画面に Cognos TM1 インストールの現在の状態が示されます。

v 現在インストールされているアイテムは、コンポーネント名の横に赤色の X

アイコンが表示されます。

v 現在インストールされていないアイテムは、名前の横に緑色のチェック・マークが表示されます。これらのアイテムは、インストール対象として自動的に選択されます。

第 19 章 Cognos TM1 インストールの保守 327

5. 「次へ」をクリックして変更を開始します。

6. 変更が完了したら「終了」をクリックします。

IBM Planning Analytics のアンインストールIBM Planning Analytics の全コンポーネントを削除してアンインストールするには、次の手順に従います。

注: Cognos TM1 Applications をアンインストールする場合、必要な追加ステップについては、 329ページの『Cognos TM1 Applications のアンインストールと配布解除』のセクションを参照してください。

始める前に

Planning Analytics のアンインストールを開始する前に、Planning Analytics の全データのバックアップを完了しておく必要があります。

詳しくは、以下を参照してください。

v 325ページの『Cognos TM1 のデータと設定ファイルのバックアップ』.

v 330ページの『Cognos TM1 Applications のデータのバックアップ』.


インストールされているコンポーネントによっては、それを削除するために個別にステップを実行しなければならない可能性があります。例えば、IBM Cognos Insight

と IBM Cognos TM1 Performance Modeler は、他の IBM Cognos TM1 コンポーネントとは別にアンインストールされます。

手順1. Cognos Insight のアンインストール

a. Windows の「コントロールパネル」から、「プログラムの追加と削除」を選択します。

b. 現在インストールされているプログラムのリストで、「IBM Cognos TM1Insight」を選択します。


d. ファイルが残っていないかどうか、プログラム・ファイル・ディレクトリーを調べます。残っている場合は、手動で削除します。

2. Cognos TM1 Performance Modeler のアンインストール

a. Windows の「コントロールパネル」から、「プログラムの追加と削除」を選択します。

b. 現在インストールされているプログラムのリストで、「IBM CognosPerformance Modeler」を選択します。


d. ファイルが残っていないかどうか、プログラム・ファイル・ディレクトリーを調べます。残っている場合は、手動で削除します。

3. コア TM1 コンポーネントのアンインストール


この手順では、1 つの手順で以下のコンポーネントがすべてアンインストールされます。



v Cognos Configuration

v Cognos TM1 Web



v Cognos TM1 Applications

v Cognos TM1 Operations Console

a. Microsoft Windows の「スタート」メニューで、「プログラム」>「IBMPlanning Analytics」>「IBM Planning Analytics のアンインストール(Uninstall IBM Planning Analytics)」>「IBM Planning Analytics のアンインストール (Uninstall IBM Planning Analytics)」をクリックします。

b. アンインストール・ウィザードの言語を選択し、「次へ」をクリックします。

c. 「アンインストールするパッケージを選択してください」画面で、「IBMPlanning Analytics」オプションのチェック・ボックスをクリックし、「次へ」を選択します。

アンインストール・プログラムはコンポーネントを削除します。これには数分かかる場合があります。すべて終了すると、コンピューターを再始動するように要求するプロンプトが出されます。

d. いますぐ再始動するかまたは後で再始動するかを選択し、「終了」をクリックします。

e. ファイルやサブディレクトリーが残っていないかどうか、Cognos TM1 インストール・ディレクトリーを確認します。残っている場合は、手動で削除します。

例えば、C:¥Program Files¥IBM¥cognos¥tm1 を確認してください。

Cognos TM1 Applications のアンインストールと配布解除アプリケーション・データを保持する場合に、IBM Cognos TM1 Applications でデータの完全なバックアップとエクスポートを行うには、いくつかの手順が必要です。

ここで説明するタスクにより、以下を行えるようになります。

v Cognos TM1 Applications データのバックアップ

v Cognos TM1 Applications データのエクスポート

v 関連するすべてのサービスの停止

v Cognos TM1 Applications のアンインストール

v Apache Tomcat からの Cognos TM1 Application の配布解除 (使用されている場合)

v WebSphere からの Cognos TM1 Applications の配布解除 (使用されている場合)


Cognos TM1 Applications のデータのバックアップこのトピックでは、Cognos TM1 Applications のデータおよび設定ファイルを手動でバックアップする方法について説明します。


アプリケーション・ファイルを手動でバックアップすることにより、現在のノード所有者や送信済みステータスなど、アプリケーションに関する状況データを保存できます。

注: アプリケーション構造の定義だけを保存して、状態データを保存しない場合には、エクスポート機能を使用します。『Cognos TM1 Applications からのアプリケーションのエクスポート』を参照してください。

手順1. アプリケーションによって使用される Cognos TM1 サーバーのデータベースをバックアップします。

IBM Cognos TM1 データベースのデータ・ディレクトリーとサブディレクトリーの内容のコピーを安全な場所に保存します。これらのディレクトリーには、データと設定ファイルの両方が入っています。例えば、Cognos TM1 サンプル・データベース・ディレクトリーとサブディレクトリーの場所は以下のとおりです。

<TM1 インストール>¥samples¥tm1

2. Cognos TM1 Applications の applications フォルダーと pmpsvc_config.xml 設定ファイルおよび fpmsvc_config.xml 設定ファイルのバックアップ・コピーを保存します。

これらアイテムは通常以下の場所になります。

v <TM1 インストール>¥webapps¥pmpsvc¥WEB-INF¥applications

v <TM1 インストール>¥webapps¥pmpsvc¥WEB-

INF¥configuration¥pmpsvc_config.xml

v <TM1 インストール>¥webapps¥pmpsvc¥WEB-

INF¥configuration¥fpmsvc_config.xml

IBM Cognos Analytics セキュリティーを Cognos TM1 Applications で使用している場合は、これらのアイテムは以下の場所にあります。 <Program

Files>¥cognos¥cx¥webapps¥pmpsvc

x は、使用している Cognos Analytics のバージョンです。

Cognos TM1 Applications からのアプリケーションのエクスポート

IBM Cognos TM1 Applications 10.x からアプリケーションの基本定義をエクスポートして、バックアップ・コピーを保存することや、アプリケーションを Cognos

TM1 Applications の別のインスタンスに移動することができます。エクスポートにより、現在のユーザー・アクティビティーや状況データは含めずに、アプリケーションのテンプレートを保存できます。アプリケーションの構造定義とセキュリティ


ー定義だけがエクスポートされます。エクスポートすることにより、後日、新規予算の計画期間中などに、そのアプリケーションをインポートして再使用できます。


アーカイブが作成され、アプリケーションの構造およびセキュリティーについて記述された XML ファイルが格納されます。

重要: エクスポート処理では、現在のノード所有者や送信済みステータスなど、アプリケーションに関する状況データは保持されません。エクスポート/インポート処理を使用する場合、この情報は保持されません。

アプリケーションに関する状況データを保持する場合には、 330ページの『Cognos

TM1 Applications のデータのバックアップ』で説明されているように、ファイルを手動でバックアップしてください。

手順1. 「TM1 Cognos Applications」ポータルを開きます。

2. 「操作」列の下にある「アプリケーションのエクスポート」アイコンをクリックします。

3. 「ファイルをダウンロード」ダイアログ・ボックスで、「保存」をクリックします。

4. エクスポート・ファイルの保存先となるディレクトリーにナビゲートします。


Cognos TM1 での関連するサービスの停止このトピックでは、IBM Cognos TM1 バージョン 10.2 で関連サービスを停止する方法について説明します。

手順1. Cognos Configuration を開きます。

2. 以下のすべてのサービスを停止します。


v TM1 サーバーサービスのすべてのインスタンス


注: TM1 アプリケーション・サーバーを停止すると、他の TM1 コンポーネントも、それらが同じコンピューターにインストールされている場合には停止されます。このステップは、関連したすべての Web アプリケーション・コンポーネント (Cognos TM1 Applications、Cognos TM1 Web、Cognos TM1

Operations Console) を停止します。この手順を実行すると、Cognos TM1 がIBM Planning Analytics for Microsoft Excel と通信するためのサポート・サービスも停止します。

3. IBM Cognos Analytics セキュリティーを Cognos TM1 Applications で使用している場合は、 IBM Cognos Analytics サービスを停止します。


4. Cognos Configuration によって初期設定および開始されなかった Cognos TM1 サービスを実行している場合、それらのサービスを Windows サービス・コンソールで停止します。

Cognos TM1 Applications のアンインストールCognos TM1 のインストールに含まれているデフォルトの WebSphere® Liberty サーバーに IBM Cognos TM1 Applications をインストールして配布した場合は、以下の手順で Cognos TM1 Applications をアンインストールします。

始める前に

Cognos TM1 Applications データがバックアップ済みで、IBM Cognos Configuration

の関連サービスを停止してあることを確認してください。


この手順が当てはまるのは、Cognos TM1 のインストールに含まれているデフォルト・バージョンの WebSphere® Liberty Web アプリケーション・サーバーで IBM

Cognos TM1 Applications を使用している場合に限られます。

提供されたデフォルト以外の Web アプリケーション・サーバーに Cognos TM1

Applications をインストールおよび配置した場合、これらのツールを使用して配置解除します。詳しくは、以下のトピックを参照してください。

v 333ページの『Apache Tomcat における Cognos TM1 Applications のアンデプロイ』

v 334ページの『WebSphere における Cognos TM1 Applications のアンデプロイ』

重要: 以下の Cognos TM1 コンポーネントが同じコンピューター上にインストールされている場合には、これらのステップによってこうしたコンポーネントも削除されます。



v Cognos Configuration

v Cognos TM1 Web



v Cognos TM1 Operations Console

手順1. Microsoft Windows の「スタート」メニューで、「プログラム」>「IBM

Planning Analytics」>「IBM Planning Analytics のアンインストール (UninstallIBM Planning Analytics)」>「IBM Planning Analytics のアンインストール(Uninstall IBM Planning Analytics)」をクリックします。

2. アンインストール・ウィザードの言語を選択し、「次へ」をクリックします。

3. 「アンインストールするパッケージを選択してください」画面で、「IBMPlanning Analytics」オプションのチェック・ボックスをクリックし、「次へ」を選択します。


アンインストール・プログラムによってコンポーネントが削除されます。これには多少時間がかかる場合があります。すべて終了すると、コンピューターを再始動するよう要求するプロンプトが出されます。

4. いますぐ再始動するかまたは後で再始動するかを選択し、「終了」をクリックします。

5. ファイルやサブディレクトリーが残っていないかどうか、Cognos TM1 インストール・ディレクトリーを確認します。残っている場合は、手動で削除します。

例えば、C:¥Program Files¥IBM¥cognos¥tm1¥webapps¥pmpsvc を確認してください。

Apache Tomcat における Cognos TM1 Applications のアンデプロイ

Cognos TM1 のインストールに含まれている WebSphere® Liberty サーバーではなくApache Tomcat を使用していた場合は、以下の手順で IBM Cognos TM1

Applications をアンデプロイします。

手順1. Tomcat Manager を開きます。

2. 「アプリケーション」リストの中の /pmpsvc エントリーの「アンデプロイ」をクリックします。

3. 「OK」をクリックして確認します。

アプリケーションがアンデプロイされ、Tomcat Manager の「アプリケーション」リストから削除されます。

ヒント: アンデプロイされた後でも /pmpsvc エントリーが「アプリケーション」リストに表示されている場合は、Tomcat を停止してもう一度開始して「アンデプロイ」を再度クリックしてください。

4. 以下の Cognos TM1 Application Web アプリケーションのフォルダーとファイルが削除されていることを確認してください。まだ存在する場合は、Tomcat を停止してそれらのファイルを削除してください。

フォルダー

v C:\Program Files\Apache Software Foundation\webapps\pmpsvc

v C:\Program Files\Apache Software Foundation\Tomcat

6.0\webapps\pmpsvc


6.0\work\Catalina\localhost\pmpsvc

ファイル


6.0\webapps\pmpsvc.war

IBM Cognos Analytics セキュリティーを Cognos TM1 Applications で使用している場合は、これらのアイテムは以下の場所にあります。

v C:\Program Files\cognos\cx\webapps\pmpsvc


v C:\Program Files\cognos\cx\tomcat4.1.27\work\Standalone\

localhost\pmpsvc

x は、使用している Cognos Analytics のバージョンです。

WebSphere における Cognos TM1 Applications のアンデプロイ

IBM WebSphere を使用し、Cognos TM1 インストールで提供されるデフォルトのApache Tomcat を使用しなかった場合には、以下のステップを使用して、IBM

Cognos TM1 Applications をアンデプロイします。


2. 「コンソール・ナビゲーション (Console Navigation)」ウィンドウの「アプリケーション」セクションにある「Web アプリケーション WAR (Web AppWARs)」をクリックします。

「インストールされた Web アプリケーション (Installed Web Applications)」ページが開きます。

3. 「URL」列の /pmpsvc エントリーで、「アンインストール」をクリックします。

4. 「OK」をクリックして、アンインストールすることを確認します

完了すると、WebSphere は次のメッセージを表示します。

Uninstalled application (アプリケーションをアンインストールしました)

default/pmpsvc

IBM Planning Analytics バージョン 2.0.0 でのデータ・ファイルと設定ファイルの復元

新しいバージョンの IBM Planning Analytics をインストールしたら、以下の手順を実行して、古いバージョンの Cognos TM1 の設定ファイルとデータ・ファイルを復元します。

始める前に

新しいバージョンの製品をインストールする。


この手順は、IBM Cognos TM1 バージョン 10.x.x のデータ・ファイルと設定ファイルを復元する場合にのみ適用されます。

Cognos TM1 バージョン 9.x の情報を Planning Analytics バージョン 2.0.0 で復元する必要がある場合は、 60ページの『Cognos TM1 バージョン 9.x のデータと設定ファイルの現行バージョンへの復元』を参照してください。


手順1. Cognos TM1 サーバーのデータを以下のようにして復元します。

復元する Cognos TM1 サーバーごとに、そのデータ・ディレクトリーおよびサブディレクトリーをデータ用の新しい場所 (<TM1_Install>¥samples¥tm1) にコピーします。

2. IBM Cognos Configuration で設定情報を以下のようにして復元します。

これには、Cognos TM1 管理サーバー、Cognos TM1 アプリケーション・サーバー、および実行する各 Cognos TM1 サーバーの設定情報が含まれます。

a. IBM Cognos Configuration を開きます。

b. Cognos Configuration の「エクスプローラー」ウィンドウで、「ローカル設定」>「環境」と展開します。

c. 「TM1 管理サーバー」をクリックして、「プロパティー」ウィンドウのパラメーターを更新します。

d. 「TM1 アプリケーション・サーバー」をクリックして、「プロパティー」ウィンドウのパラメーターを更新します。

e. 「データ・アクセス」 > 「TM1 サーバー」をクリックし、使用するCognosTM1 サーバーごとにエントリーを追加します。

詳しくは、 100ページの『既存の Cognos TM1 サーバーの Cognos

Configuration への追加』を参照してください。

f. 「ファイル」 > 「保存」とクリックします。

3. Cognos TM1 Architect と Cognos TM1 Perspectives の設定ファイルを以下のようにして復元します。

Cognos TM1 Architect または Cognos TM1 Perspectives の以前のインストール環境の設定を復元する場合は、以前の Tm1p.ini ファイルの値を新しいTm1p.ini ファイルにコピーします。

重要: 以前の Tm1p.ini ファイルをそのまま適用する場合は、そのファイル内の AdminSvrSSLCertAuthority パラメーターのディレクトリー・パスを更新する必要があります。例えば、デフォルトの Cognos TM1 SSL 証明書を使用する場合は、このパラメーターの値を新しいインストール・パス C:¥Program

Files¥IBM¥cognos¥tm1¥bin¥ssl¥applixca.pem に手動で変更します。

a. 次の場所にある新しいシステム・デフォルト Tm1p.ini ファイルを更新します。




b. 次の場所にある、ユーザー固有の新しい Tm1p.ini ファイルを更新します。


例: C:¥Documents and Settings¥user

name¥ApplicationData¥Applix¥TM1¥Tm1p.ini


4. Cognos TM1 Web ファイルを以下のようにして復元します。

注: IBM Cognos TM1 バージョン 10.2.0 以降、 Cognos TM1 Web のデフォルト・インストール・ディレクトリーは <TM1_Install>¥webapps¥tm1web¥ になりました。

v Cognos TM1 Web バージョン 10.2.0 以降からファイルを復元する場合には、以下のようにします。

以前の tm1web_config.xml ファイルを開いて、使用する行およびパラメーターを、 <TM1_Install>¥webapps¥tm1web¥web-inf¥configuration にある新しいtm1web_config.xml ファイルに選択的にマージします。

v 10.2.0 より前のバージョンの Cognos TM1 Web からファイルを復元する場合には、以下のようにします。

注: Cognos TM1 Web バージョン 10.2.0 では、 tm1web_config.xml という名前の新しい設定ファイルを使用します。このファイルは、Cognos TM1 Web

の以前のバージョンの web.config ファイルと置き換わるものです。詳細については、 124ページの『Cognos TM1 Web 構成パラメーターの変更』を参照してください。

以前の Web.config ファイルを開いて、使用する行およびパラメーターを、<TM1_install>¥webapps¥tm1web¥web-inf¥configuration にある新しいtm1web_config.xml ファイルに選択的にマージします。

5. アプリケーションおよび設定ファイルを、以下のようにして Cognos TM1

Applications に復元します。

詳しくは以下を参照してください。

v 『Cognos TM1 Applications でのアプリケーションと設定ファイルの復元』

v 337ページの『Cognos TM1 Applications へのアプリケーション定義のインポート』

Cognos TM1 Applications でのアプリケーションと設定ファイルの復元アプリケーションと設定ファイルのバックアップ・コピーを、 IBM Cognos TM1

Applications の既存のバージョンに手動で復元できます。

始める前に

Cognos TM1 Applications のアプリケーション・ファイルを復元する前に、アプリケーションが依存する Cognos TM1 サーバーして稼働する必要があります。

手順1. 以下のようにして、Cognos TM1 Applications のアプリケーションを復元します。

アプリケーション・ファイルを次の場所にコピーします。

<TM1_Install>¥webapps¥pmpsvc¥WEB-INF¥applications

2. 以下のようにして、Cognos TM1 Applications の設定ファイルを復元します。


pmpsvc_config.xml および fpmsvc_config.xml 設定ファイルのバックアップ・コピーを次の場所にコピーします。

v <TM1_Install>¥webapps¥pmpsvc¥WEB-INF¥configuration¥pmpsvc_config.xml

v <TM1_Install>¥webapps¥pmpsvc¥WEB-INF¥configuration¥fpmsvc_config.xml

3. Cognos Configuration で、以下のようにします。

a. TM1 アプリケーション・サーバーを始動します。

b. アプリケーションに関連した TM1 サーバーを始動します。

4. Cognos TM1 Applications ポータルにログオンします。関連する TM1 サーバーがまだリストされていない場合には、それを設定ページに追加します。

a. Cognos TM1 Applications のメインページのツールバーから「IBM Cognos

TM1 Applications の管理」アイコンをクリックします。

b. 「サーバー名」セクションの下で、「追加」をクリックして、関連した TM1

サーバーの情報を入力します。


webapps/pmpsvc/WEB-INF/application フォルダー内のアプリケーションは、アップグレードされて、Cognos TM1 Applications に追加されます。

注: アプリケーションに適用する必要のある権限の量に応じて、アップグレード処理に時間がかかることがあります。詳細については、 62ページの『Cognos TM1 Application をインポートまたは復元する際のセキュリティー権限の保存』を参照してください。

Cognos TM1 Applications へのアプリケーション定義のインポートIBM Cognos TM1 Applications からエクスポートされたアプリケーション定義を、IBM Cognos TM1 Applications に再びインポートすることができます。

手順1. Cognos TM1 Applications ポータルを開きます。

2. 「アプリケーションのインポート」ボタンをクリックします。

3. アプリケーションのインポート先となる Cognos TM1 サーバーを選択します。

4. 「アプリケーション・ファイル」フィールドの横の「参照」をクリックします。

5. アプリケーション (.zip) ファイルにナビゲートし、「開く」をクリックします。

6. アプリケーションとともにセキュリティー設定をインポートする場合は、「アプリケーション・セキュリティーのインポート」オプションを選択します。

注: セキュリティー設定をインポートする場合、アプリケーションに適用する必要のある権限の量に応じて、権限保存の操作の処理にかかる時間が長くなることがあります。詳細については、 62ページの『Cognos TM1 Application をインポートまたは復元する際のセキュリティー権限の保存』を参照してください。

7. アプリケーションとともにプロパティー設定をインポートする場合は、「アプリケーション・プロパティーのインポート」オプションを選択します。

8. 「インポート」をクリックします。


第 20 章ユーザー補助機能

ユーザー補助機能は、動作が制限されている方、視力の限られた方など、身体に障害を持つ方々に IT 製品をご使用いただけるように支援する機能です。

ユーザー補助機能に対する IBM の取り組みの詳細については、IBM アクセシビリティー・センターを参照してください。

IBM アクセシビリティー・センターは、オンラインで利用できます(http://www.ibm.com/able)。

インストール・ウィザードのキーボード・ショートカットショートカット・キーを使用すると、簡単に素早くソフトウェアにナビゲートして使用できます。

インストール・ウィザードでは、アプリケーション固有のキーに加えて、標準のMicrosoft Windows オペレーティング・システム・ナビゲーション・キーを採用しています。

注: 次のショートカット・キーは、米国の標準的なキーボードに基づいています。

次の表に、Windows オペレーティング・システム上でインストール・ウィザードの主な作業の一部を実行する際に使用できるショートカット・キーを示します。

操作ショートカット・キー

ページの次のフィールドに移動する Tab

ページの前のフィールドに戻る Shift + Tab

インストール・ウィザードを終了する Alt+F4

次の設定手順に移動する Alt + N

前の設定手順に戻る Alt + B

リストの次の選択肢に移動する ↓

リストの前の選択肢に移動する ↑

次の表に、UNIX または Linux オペレーティング・システム上でインストール・ウィザードの主な作業の一部を実行する際に使用できるショートカット・キーを示します。


ページの次のフィールドに移動する Tab

ページの前のフィールドに戻る Shift + Tab

インストール・ウィザードを終了する Alt+F4

リストの次の選択肢に移動する ↓

リストの前の選択肢に移動する ↑


http://www.ibm.com/able

次の表に、インストール・ウィザードの「使用許諾契約」ページで主な作業の一部を実行する際に使用できるショートカット・キーを示します。


使用許諾契約に同意する Alt+A

使用許諾契約に同意しない Alt + D

インストール・ウィザードを終了する Alt + x

Cognos Configuration のキーボード・ショートカットショートカット・キーを使用すると、簡単に素早くソフトウェアにナビゲートして使用できます。

次のショートカット・キーは、米国の標準的なキーボードに基づいています。

次の表に、Windows オペレーティング・システム上で IBM Cognos Configuration

の主な作業の一部を実行する際に使用可能なキーボード・ショートカットを示します。


現行の設定を保存する Crtl+S

Cognos Configuration を閉じる Alt+F4

選択した項目の名前を変更する F2

「ファイル」メニューを表示する Alt+F

「編集」メニューを表示する Alt+E

「表示」メニューを表示する Alt+V

「操作」メニューを表示する Alt+A

「ヘルプ」メニューを表示する Alt+H

次の表に、UNIX または Linux オペレーティング・システム上で Cognos

Configuration の主な作業の一部を実行する際に使用可能なキーボード・ショートカットを示します。


現行の設定を保存する Tab

Cognos Configuration を閉じる Shift + Tab

選択した項目の名前を変更する Alt+F4


付録 A. tm1s.cfg サーバー設定ファイル

tm1s.cfg ファイルは、IBM Cognos TM1 サーバーの環境情報を指定する ASCII ファイルです。

デフォルトの tm1s.cfg ファイルは、Cognos TM1 サーバーのコピーをインストールすると Cognos TM1 サーバーのデータ・ディレクトリーに作成されます。使用可能なパラメーターのほとんどは、設定ファイルに記述されています。パラメーターがデフォルトでインストールされていない場合、そのパラメーターは設定ファイルでコメント化されています。 tm1s.cfg ファイルを編集して、関連するリモート・サーバーの環境を反映できます。そのためには、使用するパラメーターのコメントを解除して、正しい値を設定します。

サーバー設定ファイルの全パラメーターのアルファベット順リストについては、342ページの『tm1s.cfg ファイルのパラメーター』を参照してください。

tm1s.cfg ファイルの場所tm1s.cfg ファイルの場所は、使用するサーバーの種類によって異なります。

v IBM Cognos Configuration ツールを使用して IBM Cognos TM1 サーバーを始動または停止する場合、Cognos Configuration のエクスプローラー・ツリーでサーバー名をクリックすることにより、Cognos TM1 サーバーの構成パスを参照できます。

v リモートの Cognos TM1 サーバーを Microsoft Windows サービス (Tm1sd.exe)

として実行し、Cognos TM1 インストール・プログラムを使用してそのサーバーをインストールした場合には、システムはインストール時に指定したサーバー・データ・ディレクトリーにある tm1s.cfg ファイルを使用します。

v Cognos TM1 リモート・サーバーを Windows アプリケーション (Tm1s.exe) として実行する場合は、ショートカットまたはコマンド・プロンプトからサーバーを起動するときに、-z コマンド行パラメーターで tm1s.cfg ファイルの場所を指定します。

例えば、次に示すコマンドは、Cognos TM1 が c:¥salesdata ディレクトリーにある tm1s.cfg ファイルを使用するように指定しています。

c:\ProgramFiles\Cognos\TM1\bin\tm1s.exe-z c:\salesdata

-z パラメーターが指すディレクトリーに空白文字が含まれる場合は、ディレクトリーを二重引用符で囲む必要があります。例: -z "c:¥sales data"。

v Cognos TM1 インストール・プログラムを使用してインストールした Cognos

TM1 サーバーを、 UNIX で実行している場合、システムはインストール時に指定したサーバーのデータ・ディレクトリーにある tm1s.cfg ファイルを使用します。


サンプル tm1s.cfg ファイル次に、サンプルの tm1s.cfg ファイルを示します。

tm1s.cfg ファイルには、パラメーターについて説明したコメントが含まれる場合もあります。

#Security mode

#(there are typically some information comments here.)

[TM1S]

ServerLogging=F

SecurityPackageName=Kerberos


UseSSL=T

ServerName=Planning Sample

DataBaseDirectory=C:\Program Files\Cognos\TM1\Custom\TM1Data\PlanSamp\

AdminHost=xxxxxxxx

PortNumber=12345

ClientMessagePortNumber= 5433

Language=ENG

Savetime=

Downtime=

ProgressMessage=True

AuditLogOn=F

AuditLogMaxFileSize= 100 MB

AuditLogUpdateInterval=60

#ServerCAMURI=http://L3L0833-6457A26:9300/p2pd/servlet/dispatch

#ClientCAMURI=http://L3L0833-6457A26/ibmcognos/cgi-bin/cognos.cgi

#ClientPingCAMPassport=900

#Optional CAM parameters

#CAMSSLCertificate=

#SkipSSLCAMHostCheck=TRUE

#SkipSSLCAMHostCheck=TRUE

tm1s.cfg ファイルのパラメーターここでは、tm1s.cfg ファイルのパラメーターについて説明します。

動的パラメーター

動的パラメーターの値は、IBM Cognos TM1 サーバーの実行中に編集することができます。

Cognos TM1 サーバーは、動的なパラメーターの値が変更されていないか確認するために tm1s.cfg ファイルを 60 秒間隔でポーリングし続けます。パラメーター値の変更を検出すると、新しい値がただちに適用されます。動的なパラメーターは、このリストで「dynamic」として説明されている文で識別されます。


静的パラメーター

静的パラメーター値は、IBM Cognos TM1 サーバーの始動時にのみ tm1s.cfg ファイルから読み取られます。静的なパラメーターの値を変更する場合は、Cognos TM1

サーバーを停止し、tm1s.cfg ファイル内の値を編集してから、サーバーを再起動する必要があります。

tm1s.cfg ファイルのほとんどのパラメーターは静的です。

値に空白が含まれる場合

パラメーター値に空白が含まれる場合は、二重引用符でパラメーター値を囲んでください。

AdminHost管理サーバーを実行中の管理ホストのコンピューター名または IP アドレスを指定します。

パラメーター・タイプ: 必須、静的

複数の管理ホストを指定するには、Microsoft Windows で実行する場合には各ホスト名をセミコロンで区切り、UNIX で実行する場合にはコロンで区切ります。例:

v Windows Cognos TM1 サーバーでは、AdminHost=hostname1;hostname2 形式を使用します。

v UNIX Cognos TM1 サーバーでは、AdminHost=hostname1:hostname2 形式を使用します。

他の例を以下に示します。

v AdminHost=boston;newyork

v AdminHost=192.168.1.17;192.168.1.22

v AdminHost=boston;192.168.1.17;192.168.1.22;myserver;192.168.1.40

注: 管理ホストは、複数指定する場合も含め、1020 文字 (バイト) 以内の文字列で指定してください。

AllowReadOnlyChore Reschedule日課に対する読み取りアクセス権を与えて、日課の有効化、無効化、およびスケジュールの再設定をユーザーに許可します。


サーバーの Tm1s.cfg ファイルに行 AllowReadOnlyChoreReschedule=T が追加されている場合、日課の読み取りアクセス権を持つユーザーは、サーバー・エクスプローラーで日課を右クリックして、「スケジュールの有効化」オプションを切り替えたり、「日課の編集」オプションを選択したりすることができます。「日課の編集」オプションは、日課が有効になっていない場合にのみ使用できます。

日課の読み取りアクセス権を持つユーザーが「日課の編集」オプションを選択したときに開くのは、「日課設定ウィザード」のスケジュール設定画面のみです。

付録 A. tm1s.cfg サーバー設定ファイル 343

スケジュール設定画面では、ユーザーは日課のスケジュール設定パラメーターを編集できますが、日課を構成するプロセスの一覧は編集できません。

AllowSeparateNandCRulesこのパラメーターを有効にすると、同じ AREA 定義を使用して、別の行で N: および C: レベルの規則の式を指定できるようになります。


例えば、以下のとおりです。

[’Budget’,’Argentina’]=N:Expression;

[’Budget’,’Argentina’]=C:Expression;

AllowSeparateNandCRules パラメーターが Tm1s.cfg ファイルに含まれ、その値が T

に設定されていれば、この 2 つは両方とも有効な規則ステートメントです。

このパラメーターは、数値と文字列規則をセルに適用する方法に影響を与えます。このパラメーターがない場合は、特定の AREA 定義で見つかった最初の規則ステートメントがその定義範囲内のセルに適用されます。AREA 定義内のセルが数値で、規則が文字列規則の場合は、セルに当てはまらない一致があったので、そのセルは規則算出ではないと見なされます。

例えば、次のステートメントを考えます。

[’1 Quarter’]=s:’str_value’;Not following.

[’1 Quarter’]=n:77;

AllowSeparateNandCRules パラメーターが設定されていない (または F に設定されている) 場合、最初の規則ステートメントは、その要素の 1 つとして「1 Quarter」を使用するいずれかのセルに一致します。セルが文字列セルの場合、セルの値は「str_value」に設定されます。セルが数値セルの場合、一致が検出されても (最初の規則) 規則自体が適用されなければ、そのセルは規則算出と見なされません。

AllowSeparateNandCRules パラメーターが T に設定されている場合、「1 Quarter」を使用する文字列セルは「str_value」に設定され、「1 Quarter」を使用する数値セルは 77 に設定されます。

パラメーターを T に設定するには、次の行を Tm1s.cfg に追加します。

AllowSeparateNandCRules=T

AllRuleCalcStargateOptimizationAllRuleCalcStargateOptimization パラメーターは、規則算出値のみを含んだビューを計算する際のパフォーマンスを向上させます。


一般的に、Cognos TM1 は標準集約の計算を実行してから規則ベースの集約の値を計算するので、標準集約の値がオーバーライドされる可能性があります。AllRuleCalcStargateOptimization パラメーターは、最初にビュー各値が規則算出されているかチェックし、次に以下を実行して最適化します。


v ビューの各値が規則算出されている場合、Cognos TM1 は不必要な標準集約の計算を省略し、規則算出集約だけを行います。

v ビューに非規則算出値が 1 つでも含まれている場合、この最適化パラメーターは無効になります。

このパラメーターが True に設定されている場合は、ビューに規則算出値のみが含まれているか最初にチェックするように要求されている各ビューで、いくつかの追加処理が行われます。ほとんどのビューでは、この追加処理は必要最低限しか行われません。ビューの最初の値が規則算出されていないことが検出されると最適化が停止されるためです。

このパラメーターを有効にするには、Cognos TM1 サーバーの設定ファイル(Tm1s.cfg) で、次のようにパラメーターの値を T に設定します。

AllRuleCalcStargateOptimization=T

デフォルトの設定は無効 (F) です。

ApplyMaximumViewSizeToEntireTransactionMaximumViewSize を個々の計算ではなくトランザクション全体に適用します。

パラメーター・タイプ: オプション、動的

デフォルトでは、MaximumViewSize は個々のビューの処理を検査します。例えば、単一トランザクションで 10 個のビューが処理される場合、しきい値を超えるのは、単一のビューの処理がしきい値を超えた場合のみです。 381ページの『MaximumViewSize』を参照してください。

このパラメーターを True に設定すると、単一トランザクションで処理されるすべてのビューの累積メモリー使用量が、しきい値と比較されます。そのため、メモリー・サイズしきい値でキャッチできる、大量のメモリーを消費するトランザクションの数が多くなります。

注: TI プロセス実行は、すべての子 TI プロセスを含めて、単一トランザクションとしてカウントされます。

ApplyMaximumViewSizeToEntireTransaction=T

デフォルト値は F です。

AuditLogMaxFileSize監査ログ・ファイルの最大サイズを示します。このサイズになったファイルは閉じられ、新しいファイルが作成されます。


この値には、KB (キロバイト)、MB (メガバイト)、または GB (ギガバイト) の単位も指定する必要があります。例えば、ログ・ファイルのサイズを 100 MB に制限するには、次のように入力します。

AuditLogMaxFileSize=100 MB


各値の範囲は次のとおりです。

v デフォルト値: 100 MB

v 最小値: 1 KB

v 最大値: 2 GB

AuditLogMaxQueryMemoryIBM Cognos TM1 で監査ログのクエリーを実行し、結果セットを取得する際に使用可能な最大メモリー量を示します。


この値には、KB (キロバイト)、MB (メガバイト)、または GB (ギガバイト) の単位も指定する必要があります。例:

AuditLogMaxQueryMemory=100 MB

各値の範囲は次のとおりです。

v デフォルト値: 100 MB

v 最小値: 1 KB

v 最大値: 2 GB

AuditLogOn監査ログ機能を有効 (T) または無効 (F) にします。


例:

v 監査ログを有効にするには、AuditLogOn=T を設定します。

v 監査ログを無効にするには、AuditLogOn=F を設定します。

デフォルトの設定は F です。

AuditLogUpdateInterval一時的な監査ファイルのイベントを最終的な監査ログに移動するまでに IBM

Cognos TM1 が待機する最大時間を分単位で示します。


例:

AuditLogUpdateInterval=60

デフォルト値は 60 (60 分) です。

最小値は 1 (1 分) です。

注: 監査ログは、最新のイベントに基づいていつでも手動で更新することができます。それには、サーバー・エクスプローラーで「監査ログ・イベントの処理」コマ


ンドを使用します。詳しくは、「IBM Cognos TM1 Operations」の『最新イベントによる監査ログの更新』を参照してください。

AutomaticallyAddCubeDependenciesキューブ依存関係が自動的に設定されるか、それともキューブごとにキューブ依存関係を手動で識別する必要があるかを指定します。


IBM Cognos TM1 サーバーは、依存関係を設定して、キューブ内のデータが変更された場合にキューブ計算キャッシュを適切に無効化できるようにします。詳しくは、「TM1 Operations」の『キューブ依存関係について』を参照してください。

true (デフォルト) に設定すると、サーバー起動時に規則ベースのキューブ間のDB(...) 依存関係が自動的に検出されて設定されます。また、規則の編集、保存、または再コンパイル後に、その規則で表現されている依存関係は、DB()、ATTRS()、ATTRN() のいずれの関数からのものであっても、自動的に再設定されます。

false に設定すると、サーバー起動時に規則ベースのキューブ間の DB(...) 依存関係は検出も設定もされません。依存関係はクエリーの実行時に設定されます。この場合、新しい依存関係のために、クエリーが他のクエリーをブロックすることがあります。

AutomaticallyAddCubeDependencies=F

デフォルト値: T

CacheFriendlyMallocIBM Power プラットフォームに固有のメモリー調整を行えるようにします。


このパラメーターを有効にすると、ユーザー数が多い使用シナリオで最大の利点があることが、テストにより判明しています。 1 人のユーザーやユーザー数が少ない使用シナリオでは、利点があまりないかまったくない場合もあります。デフォルトでは、CacheFriendlyMalloc=F です。

このオプションを有効にするには、次の行を tm1s.cfg ファイルに追加します。

CacheFriendlyMalloc=T

CalculationThresholdForStorage単一セルまたはスターゲート・ビューに必要とされる規則計算の数がここに定義する最小数を超えたら、IBM Cognos TM1 サーバーは計算を保管し、現行サーバー・セッションで利用できるようにします。


例えば、ユーザーが単一のセルまたはスターゲイト・ビューから規則算出値をCognos TM1 サーバーに要求した場合、サーバーは通常、複数の規則計算を実行することによって、要求された規則算出値に到達することが必要です。


CalculationThresholdForStorage は、メモリーの消費量とパフォーマンスに直接的に影響します。パラメーター値を大きくすると、メモリーの消費量は減りますが、計算が遅くなります。パラメーター値を小さくすると、メモリーの消費量は増えますが、計算が高速になります。

Tm1s.cfg に CalculationThresholdForStorage を記述しなかった場合のデフォルトの計算しきい値は 50 です。

CAMPortalVariableFileIBM Cognos インストールの variables_TM1.xml ファイルへのパス。

パラメーター・タイプ: IBM Cognos 相互運用機能で必須、静的。

CAMPortalVariableField パラメーターは、IBM Cognos Analytics と共に Cognos

TM1 Web および Cognos TM1 Server を使用する場合のみ必須です。

このパラメーターは、次のように相対パスで設定します。

CAMPortalVariableFile=portal\variables_TM1.xml

注: IBM Cognos Analytics サーバー上のファイルの正確な場所は、<Cognos の場所>¥templates¥ps¥portal¥variables_TM1.xml です。

CAMUseSSLTM1 と IBM Cognos Analytics サーバー間のすべての通信に SSL を使用するように指定します。


デフォルト値: False

CheckFeedersMaximumCellsCube Viewer の「フィーダーのチェック」オプションでチェックするセルの数を制限します。

CheckFeedersMaximumCells は、Tm1s.cfg に追加可能なオプションのパラメーターです。このパラメーターを Tm1s.cfg に記述しなかった場合は、デフォルトで3,000,000 個のセルが「フィーダーのチェック」によってチェックされます。


Cognos TM1 が高度に集約されたセルのフィーダーをチェックする場合、そのセルに適用される交差をすべてチェックする必要があります。アプリケーションが大きな場合は、Cognos TM1 ですべての交差をチェックするかなりの時間にわたって、Cognos TM1 サーバーが使用できないことになります。

「フィーダーのチェック」の実行時にチェックするセル数を制限することによってCognos TM1 サーバーが使用できなくなる時間を短くするには、Tm1s.cfg にCheckFeedersMaximumCells を追加し、チェックするセルの数をそのパラメーターに設定します。


例えば、「フィーダーのチェック」を実行するセルを 1,000,000 個に制限するには、次の行を入力します。

CheckFeedersMaximumCells=1,000,000

ClientCAMURICognos TM1 クライアントの認証に使用する IBM Cognos サーバーIBM Cognos

Connection の URI。


URI は、次の書式で指定します。http[s]://<ホスト>/<cognos_location>/cgi-bin/

cognos.cgi。

例: http://10.121.25.121/ibmcognos/cgi-bin/cognos.cgi

ClientExportSSLSvrCertTM1 サーバーの証明書を発行するときに最初に使用された認証局証明書を IBM

Cognos TM1 Client が Microsoft Windows の証明書ストアから取得するかどうかを指定します。

パラメーター・タイプ: オプション (SSL の場合は必須)、静的

ClientExportSSLSvrCert=T の場合は、TM1 クライアントから認証局証明書が要求されたときに、クライアント・コンピューター上の証明書ストアの証明書がエクスポートされます。


ClientExportSSLSvrKeyIDTM1 サーバーの証明書を発行するときに最初に使用された認証局証明書をMicrosoft Windows の証明書ストアからエクスポートするために IBM Cognos TM1

クライアントで使用する識別キーを指定します。


ClientPingCAMPassportパスポートの有効性を保つために、クライアントが Cognos Authentication

Management サーバーに ping を実行する間隔を秒単位で示します。


エラーが発生するかパスポートが期限切れになると、ユーザーは Cognos TM1 サーバーから切断されます。

デフォルト値: 900


ClientMessagePortNumber長時間処理の進捗状況と最終的な取り消しに関するクライアント・メッセージを残存スレッドを占有せずに受け入れるセカンダリー・ポートを指定します。

パラメーター・タイプ: オプション、変更に関して静的、動的設定

ポート番号が設定ファイルに指定されていない場合、ポート番号は動的に選択され、サーバーの始動時に設定されます。ただしサーバーの実行中は、変更できません。

この追加ポートによって、ユーザーからの取り消しを待機しながら、他のサーバー要求を継続して処理することが可能になります。

このポート番号は、Cognos TM1 サーバーの始動時にデフォルトで自動的および動的に割り当てられます。ファイアウォールなどのネットワーク上の問題が原因でリスナーポートをウェルノウン番号にしなければならない場合を除き、ClientMessagePortNumber を特定の値に設定する必要はありません。

注意:ClientMessagePortNumber パラメーターに特定の値を設定する場合、動的に割り当てるのではなく、使用しているすべての Cognos TM1 サーバーおよびクライアントのメッセージ・ポートに固有のポート番号を割り当ててください。2 台のサーバーが 1 台のマシン上で実行され、それらが同じポート番号を使用している場合、メッセージ処理が発生したときにシステムで競合またはハングが発生する可能性があります。

390ページの『PortNumber』および 391ページの『ProgressMessage』も参照してください。

ClientPropertiesSyncInterval}ClientProperties コントロール・キューブでクライアント・プロパティーが更新される頻度 (秒単位) を指定します。 30 分ごとにキューブを更新する場合は、1800

秒に設定します。

頻繁に更新すると、CPU 時間を不必要に消費することになり、操作が終了するまでユーザーが接続/接続解除できなくなる場合があります。


ClientVersionMaximumIBM Cognos TM1 サーバーに接続可能なクライアントの最大バージョンを指定します。


ClientVersionMaximum パラメーター値は、以下の形式を使用してバージョン文字列として表されます

m.n.tffhh


m = メジャー・リリース番号

n = マイナー・リリース番号

t = メンテナンス・リリース番号

ff = フィックスパック番号

hh = ホット・フィックス番号

サーバーに接続できる最大クライアント・バージョンを 9.4.1 に指定するには、この形式を使用して、ClientVersionMaximum = 9.4.10305 と設定します。

Tm1s.cfg ファイルに ClientVersionPrecision パラメーター値が追加されていない場合は、メジャー・リリース番号、マイナー・リリース番号、およびメンテナンス・リリース番号のみが使用されて、クライアントとサーバー間の互換性を強化します。上記の例を使用して、

ClientVersionMaximum が明示的に設定されていない場合、デフォルト値は現在インストールされているサーバー・バージョンと同じになります。

パラメーター値の有効範囲は、x00 から現在インストールされているサーバー・バージョンです。x は現在インストールされている TM1 サーバーのメジャー・リリース番号です。例えば、TM1 サーバー9.0 SP3 のパラメーター値として有効なのは、900 から 903 の範囲内の値です。

現在インストールされているサーバー・バージョンより大きな値をClientVersionMaximum に設定することはできません。新しいクライアント・バージョンを古いサーバー・バージョンに接続することはできません。

ClientVersionMinimumIBM Cognos TM1 サーバーに接続可能なクライアントの最小バージョンを指定します。


ClientVersionMinimum パラメーター値は、以下の形式を使用してバージョン文字列として表されます

m.n.tffhh






サーバーに接続できる最小クライアント・バージョンを 9.4.1 に指定するには、この形式を使用して、ClientVersionMinimum = 9.4.10305 と設定します。


Tm1s.cfg ファイルに ClientVersionPrecision パラメーター値が追加されていない場合は、メジャー・リリース番号、マイナー・リリース番号、およびメンテナンス・リリース番号のみが使用されて、クライアントとサーバー間の互換性を強化します。

ClientVersionMinimum パラメーターは明示的に設定されていない場合、デフォルト値は 8.4.00000 になります。これはバージョン 8.4 を表します。

現在インストールされている Cognos TM1 サーバーのメジャー・リリース番号より小さな値を ClientVersionMinimum に設定しないでください。 ClientVersionMinimum

に上限はありません。ただし、ClientVersionMinimum が ClientVersionMaximum より大きい場合は、バージョン番号が ClientVersionMaximum に等しいクライアントのみがサーバーに接続できます。

ClientVersionPrecisionこのパラメーターは、IBM Cognos TM1 サーバーへ接続できるクライアントの最小および最大バージョンをさらに正確に指定することができます。


ClientVersionMinimum と ClientVersionMaximum のパラメーター値は、以下の形式を使用してバージョン文字列として表されます

m.n.tffhh






この形式を使用しているバージョン文字列 9.4.10305 は、メジャー・リリース 9、マイナー・リリース 4、メンテナンス・リリース 1、フィックスパック 3、ホット・フィックス 5 を意味します。

ClientVersionPrecision が Tm1s.cfg に設定されていない場合、または 0 に設定されている場合、メジャー・リリース番号、マイナー・リリース番号、およびメンテナンス・リリース番号のみが使用されて、クライアントとサーバー間の互換性を強化します。この場合、メジャー・リリース 9、マイナー・リリース 4、メンテナンス・リリース 1 以降のクライアントをサーバーに接続することができます。

ClientVersionPrecision を Tm1s.cfg ファイルに追加して、以下の値のいずれかをパラメーターに設定して、さらにサーバーとクライアント・バージョンの互換性の精度を強化することができます。

v 1 - フィックスパック番号は強化されるがホット・フィックス番号はされない。

v 2 - フィックスパック番号とホット・フィックス番号の両方が強化される。


例

ClientVersionMinumum = 9.4.10305、ClientVersionPrecision = 1 と設定した場合、メジャー・リリース 9、マイナー・リリース 4、メンテナンス・パック 1、フィックスパック 3、またはそれ以降のクライアントだけがサーバーに接続できます。この場合、サーバー/クライアントの互換性を決定する場合にホット・フィックス番号は強化されません。

ClientVersionMinumum = 9.4.10305、ClientVersionPrecision = 2 と設定した場合、メジャー・リリース 9、マイナー・リリース 4、メンテナンス・パック 1、フィックスパック 3、ホット・フィックス 5、またはそれ以降のクライアントだけがサーバーに接続できます。この場合、サーバー/クライアントの互換性を決定する場合にフィックスパックとホット・フィックスの両方の番号が強化されます。

CognosMDX.AggregateByAncestorRef集計されるメンバー・セットが子孫の完全なセットで構成され、すべてのメンバーの重みが 1 である場合、可能であれば、メンバー・セットに対する集計を先祖への参照に置き換えます。

例えば、集計 aggregate(children(<Member>)) が <Member> への参照に置き換わる場合があります。


このパラメーターは、TM1 を IBM Cognos Analytics と一緒に使用する場合にのみ適用されます。

CognosMDX.AggregateByAncestorRef を有効にするには、tm1s.cfg ファイルに以下の行を追加します。

CognosMDX.AggregateByAncestorRef=true


CognosMDX.CellCacheEnableIBM Cognos MDX エンジンが TM1 の集約および計算のセル・キャッシュ戦略を変更できるようにします。


このパラメーターは、TM1 を Cognos Analytics と一緒に使用する場合にのみ適用されます。

デフォルト値: true

CognosMDX.PrefilterWithPXJデータ・ソース・プロバイダーの交差結合の方法を、ネストされたフィルター済みセットに拡張します。



このパラメーターは、TM1 を IBM Cognos Analytics と一緒に使用する場合にのみ適用されます。

このパラメーターは、次の場合のみアクティブになります。

v tm1s.cfg ファイル内の CognosMDX.UseProviderCrossJoinThreshold の値が 0 より大きい。

v Cognos Analytics の qfs_config.xml 設定ファイル内のUseProviderCrossJoinThreshold の値が 0 より大きい。

CognosMDX.PrefilterWithPXJ を有効にするには、tm1s.cfg ファイルに以下の行を追加します。

CognosMDX.PrefilterWithPXJ=true


CognosMDX.SimpleCellsUseOPTSDKIBM Cognos MDX エンジンの集約および計算のセル・キャッシュ戦略を、クエリー結果内のすべてのセルに適用します。



CognosMDX.SimpleCellsUseOPTSDK が有効になっていない場合、集約および計算のセル・キャッシュ戦略は、計算されたメンバーに関連付けられたクエリー結果セルのみに適用されます。


CognosMDX.UseProviderCrossJoinThresholdデータ・ソース・プロバイダーの交差結合戦略を、IBM Cognos Analytics で明示的に有効になっていなくても適用します。



CognosMDX.UseProviderCrossJoinThreshold を有効にすると、Cognos Analytics のqfs_config.xml ファイル内の UseProviderCrossJoinThreshold パラメーターを有効にした場合と同じ効果があります。

UseProviderCrossJoinThreshold は、エッジ上の数値データ値のないメンバーの組み合わせが TM1 サーバーから取得されるかどうかを制御します。UseProviderCrossJoinThreshold は、値が 0 より大きいと有効になります。

注: Cognos Analytics の qfs_config.xml 内で UseProviderCrossJoinThreshold が有効になっている場合、 tm1s.cfg ファイル内のCognosMDX.UseProviderCrossJoinThreshold パラメーターより優先されます。


CognosMDX.UseProviderCrossJoinThreshold を有効にするには、これを tm1s.cfg

ファイルに追加して、0 より大きい値を指定します。以下に例を示します。

CognosMDX.UseProviderCrossJoinThreshold=1000


CognosTM1InterfacePathIBM Cognos TM1 Package Connector を使用して Cognos Package から TM1 にデータをインポートする場合に使用する IBM Cognos Business Intelligence サーバーの場所を指定します。

詳しくは、「IBM Cognos TM1 TurboIntegrator」を参照してください。

パラメーター・タイプ: Cognos TM1 Package Connector を使用する場合を除いてオプション、静的。

CreateNewCAMClientsCreateNewCAMClients サーバー構成パラメーターは、対応する TM1 クライアントがない場合に TM1 サーバーが CAM 資格情報によるサーバーへのログオン試行をどのように扱うかを指定します。


有効な CAM 資格情報のセットを指定して CreateNewCAMClients=T およびログオンを試行したときに、対応する TM1 クライアントが存在しない場合、ログオン時にTM1 クライアントが作成されます。これは、Tm1s.cfg ファイルにCreateNewCAMClients が設定されていない場合のデフォルトの動作です。

有効な CAM 資格情報のセットを指定して CreateNewCAMClients=F およびログオンを試行したときに、対応する TM1 クライアントが存在しない場合、TM1 クライアントは作成されず、ログオンは拒否されます。

C API を使用すると、エラー・コードは SystemServerClientNotFound です。 HTTP

エンドポイントを使用すると、認証情報はサーバー構成の設定に依存し、401

Unauthorized エラーが返されます。また、ログオンが拒否されると、ログ・メッセージが WARN レベルで CAMSecurity.ClientCreation ロガーに出力されます (このレベルのロギングが有効な場合)。ログ・メッセージには、「CAM Client not found,

and not created due to CreateNewCAMClients config setting.」というテキストが含まれます。

DataBaseDirectoryキューブ、ディメンションなどのオブジェクトをサーバーがロードするデータ・ディレクトリーを指定します。

データ・ディレクトリーが複数ある場合は、セミコロンで区切って列挙できます。

パラメーター・タイプ: 必須、静的

詳しくは、 27ページの『データ・ディレクトリーの概要』を参照してください。


DefaultMeasuresDimension数値データ・ディメンションを作成するかどうかを指定します。 IBM Cognos TM1

では、キューブの数値データ・ディメンションは定義しなくてもかまいません。数値データ・ディメンションはオプションで定義できますが、その操作はキューブのプロパティーを変更して行います。

詳しくは、「IBM Cognos TM1 Operation」のトピック『}CubeProperties』を参照してください。

パラメーター・タイプ: オプション。ただし、一部の OLAP アプリケーションではこのパラメーターが必須の場合があります (詳細は以下の説明を参照してください)。静的

一部の OLAP アプリケーションでは、すべてのキューブに数値データ・ディメンションが存在している必要があり、そのようなディメンションが存在していない場合はエラーになることがあります。このようなアプリケーションに対応するには、DefaultMeasureDimension=T に設定します。この設定により、Cognos TM1 サーバー上に新しいキューブが作成されたときにキューブの最後のディメンションが数値データ・ディメンションとして自動的に定義されるように Cognos TM1 サーバーに指示されます。

DefaultMeasureDimension が F に設定されているか、Tm1s.cfg に記述されていない場合は、キューブの作成時に数値データ・ディメンションは定義されません。

DisableMemoryCacheIBM Cognos TM1 メモリー・マネージャーで使用するメモリー・キャッシュを無効にします。


このパラメーターは、メモリー・リークをデバッグする場合にのみ有効にしてください。このパラメーターを有効にすると、サーバーのパフォーマンスが低下する場合があります。

例えば、DisableMemoryCache=T が設定されると、IBM Cognos TM1 メモリー・マネージャーで使用するメモリー・キャッシュは無効になります。デフォルト設定はDisableMemoryCache=F です。

DisableSandboxingユーザーがサーバーでサンドボックスを使用できるかどうかを決定します。


デフォルトでは、このパラメーターは設定ファイルに含まれておらず、サンドボックス機能はすべてのユーザーに対して有効です。

DisableSandboxing=F

この方法でサンドボックスが有効になると、管理者は、「機能の割当」を使用してユーザー・グループ別に個人用ワークスペースや複数のサンドボックスの使用を


「拒否」または「付与」することができます。詳しくは、「IBM Cognos TM1

Operations」の『機能の割当』を参照してください。

すべてのユーザー・グループをダイレクト・ライトバック・モードにするには、次の行を Tm1s.cfg に追加します。

DisableSandboxing=T

DisableSandboxing=T の場合、「機能の割当」は無視されます。

重要: TM1 Applications をデプロイおよびサポートする TM1 サーバーが存在する場合、その TM1 サーバー設定ファイルで DisableSandboxing=T を使用しないでください。 TM1 Applications をデプロイおよびサポートする TM1 サーバーでは、その TM1 サーバー設定ファイルでサンドボックス機能を有効にする必要があります。

Display_Info_DBType_R8Display_Info_DBType_R8 は、DISPLAY_INFO 列データを DBTYPE_R8 として保存するように IBM Cognos TM1 サーバーに指示します。


このパラメーターがご使用の Cognos TM1 システムに適用可能かどうかは、カスタマー・サポートに問い合わせてください。

デフォルトでは、Cognos TM1 は DISPLAY_INFO を DBTYPE_UI4 として保存します。 ADO 2.7 から DISPLAY_INFO 列データの要求があった場合、その処理を行う Cognos TM1 OLE DB Provider は、Cognos TM1 の列データを DBTYPE_UI4

から DBTYPE_R8 に変換する必要があります。それから、Cognos TM1 OLE DB

Provider は変換済みの列データを OLE DB クライアント (この場合は ADO) に返します。

ADO 2.7 は、IRowset::GetData が整数を返すと予想し、変換済みの列データの最初の 4 バイトのみを使用します。しかし、返されるデータは 8 バイトの実数なので、後半の 4 バイトの情報はすべて失われます。このため、ADO 2.7 はDISPLAY_INFO 列のすべての項目に対してゼロを返します。

Display_Info_DBType_R8 パラメーターを Tm1s.cfg ファイルに記述し、そのパラメーターを T に設定すると、Cognos TM1 サーバーは DISPLAY_INFO 列のデータをDBTYPE_R8 として格納し、意味がある 4 バイトの情報が最初の 4 バイトに配置されます。 Display_Info_DBType_R8 パラメーターの効果は、ADO がデータを 4

バイトの整数に変換して戻しても情報が失われないことです。また、このパラメーターを使用すると、ADO 2.7 から軸行セット番号の正確なプロパティー値が返されます。さらにこのパラメーターによって、4 バイト値の DISPLAY_INFO プロパティーを要求する OLE DB クライアント (ADO 2.6 など) でも、正しい値を確実に取得できます。

DistributedPlanningOutputDirDistributedPlanningOutputDir は、Cognos Insight 分散アプリケーションが配置されるときに TUnit が作成されるディレクトリーを定義します。



Cognos Insight 分散クライアントでは、「tunit」と呼ばれる情報が必要です。このデータは、アプリケーションを配置するときに作成され、Cognos TM1 サーバーの実行時に更新されます。この目的で使用されるディレクトリーの場所は、このパラメーターを使って設定されます。

Cognos Insight 分散クライアント・アプリケーションをこのデータベースを使用して配置するには、コメントを外すか、このパラメーターをDistributedPlanningOutputDir=<tunit ディレクトリーの場所> として追加します。

指定するパス名は、絶対パスでも、Cognos TM1 サーバーのデータ・ディレクトリーを基準とする相対パスでも構いません。

例:

表 37. DistributedPlanningOutputDir パラメーターに対するディレクトリー・パス名の例

設定のサンプル操作

DistributedPlanningOutputDir=tunit tunit ディレクトリーを Cognos TM1 サーバーのデータ・ディレクトリーの下に作成します。

DistributedPlanningOutputDir=../tunit tunit ディレクトリーを、Cognos TM1 サーバーのデータ・ディレクトリーの兄弟として作成します。

DistributedPlanningOutputDir=C:¥Program

Files¥IBM¥cognos¥tm1¥samples¥tm1¥

GO_New_Stores¥tunit

tunit ディレクトリーを指定の場所に作成します。

DownTimeサーバーが自動的に停止するタイミングを指定します。


DownTime パラメーターの形式は dd:hh:mm で、それぞれの意味は次のとおりです。

v dd は、本日からの日数。(例えば、00 は本日、01 は明日)。

v hh:mm は 24 時間形式の時刻。

例えば、DownTime = 01:03:30 であれば、翌日の午前 3:30 にサーバーを停止することを指定します。

DownTime パラメーターは、Cognos TM1 サーバーを Windows のサービスとして実行している場合には使用できません。

UNIX Cognos TM1 サーバーで DownTime パラメーターを使用する場合は、RunningInBackground パラメーターを T に設定する必要があります。RunningInBackground=F の場合は、シャットダウンする前に確認のプロンプトが表示されるため、管理者による手動の確認がなければシャットダウンできません。


EnableNewHierarchyCreation複数階層の作成を有効にするか無効にするかを指定します。

パラメーター・タイプ: オプション (複数階層の場合は必須)、動的

デフォルトでは、EnableNewHierarchyCreation パラメーターは F (false) に設定されます。複数の階層を使用する場合は、このパラメーターの設定を T (true) に変更してください。「TM1 リファレンス」には、ディメンションを管理するためのTurboIntegrator 関数や、ディメンション内の特定の階層を管理するための同等の関数がリストされています。

EnableTIDebuggingTurboIntegrator デバッグ機能を有効にするか無効にするかを指定します。


デフォルトでは、EnableTIDebugging パラメーターは F (false) に設定されます。

TM1 REST API の TurboIntegrator プロセス・デバッグ機能を使用する場合は、このパラメーターの設定を T (true) に変更する必要があります。同様に、TurboIntegrator デバッガー・ユーティリティーを使用する場合もこのパラメーターを T に設定しなければなりません。現在、このユーティリティーは IBM

developerWorks でプレビュー・リリースとして提供されています。

重要: TurboIntegrator プロセスのデバッグには、かなりの量のシステム・リソースが消費されます。 EnableTIDebugging=T に設定するのは、開発環境でプロセスをデバッグする場合に限定し、実稼働環境ではこのパラメーターを有効にしないことをお勧めします。

ExcelWebPublishEnabledWeb サーバーに Microsoft Excel がインストールされていない場合に、Microsoft

Excel ファイルを IBM Cognos TM1 Web に発行したり、Microsoft Excel ファイルを Cognos TM1 Web からエクスポートしたりする操作を有効にします。TM1

10.2.2 サーバーに接続する TM1 10.1 クライアントがある場合に、ExcelWebPublishEnabled パラメーターを有効にしてください。


ExcelWebPublishEnabled=T の場合は、Web サーバーで Microsoft Excel を使用しなくても、Cognos TM1 アプリケーションの Microsoft Excel ファイルを Cognos

TM1 Web に発行できます。同様に、Web サーバーで Microsoft Excel を使用しなくても、Web シートやキューブ・ビューを Cognos TM1 Web からエクスポートできます。

Web サーバーで Microsoft Excel を使用できない場合は、Cognos TM1 アプリケーションの Microsoft Excel ファイルを Cognos TM1 Web に明示的に発行する必要があります。

Microsoft Excel ファイルを発行するために必要な手順の詳細については、「IBM

Cognos TM1 Developer」を参照してください。


https://www.ibm.com/support/knowledgecenter/SSD29G_2.0.0/com.ibm.swg.ba.cognos.tm1_rest_api.2.0.0.doc/c_preface_tm1_odata.html

https://www.ibm.com/developerworks/

https://www.ibm.com/developerworks/

Web サーバーで Microsoft Excel を使用しないで Cognos TM1 Web からエクスポートする場合の制約事項の詳細については、「IBM Cognos TM1 Perspectives, TM1

Architect, and TM1 Web」を参照してください。

制約事項: Web サーバーで Microsoft Excel を使用できない場合は、Microsoft Excel

2007 .xlsx ファイルを Cognos TM1 Web に発行することはできません。そのファイルを Cognos TM1 Web に発行するには、Microsoft Excel 2003 .xls 形式で保存しなければなりません。


FileRetry.Count再試行の回数を指定します。


デフォルトで、TM1 サーバーは、トランザクション・ログの更新が失敗するとシャットダウンします。 FileRetry.FileSpec を指定すると、サーバーが接続の再確立を試行する間、サーバーのシャットダウンが遅延されます。 FileRetry.Count は、再試行の回数を整数値で定義します。指定された再試行回数後もネットワーク障害が続く場合、TM1 サーバーは自己終了します。


FileRetry.Delay再試行と次回の再試行の間の遅延時間を指定します。


デフォルトで、TM1 サーバーは、トランザクション・ログの更新が失敗するとシャットダウンします。 FileRetry.FileSpec を指定すると、サーバーが接続の再確立を試行する間、サーバーのシャットダウンが遅延されます。 FileRetry.Delay は、再試行と次回の再試行の間の遅延を定義します (ミリ秒単位)。指定された再試行回数後もネットワーク障害が続く場合、TM1 サーバーは自己終了します。


FileRetry.FileSpecネットワークの問題により、トランザクション・ログの更新が失敗する可能性があります。これが発生すると、通常は TM1 サーバーが強制的にシャットダウンされます。この構成パラメーターは、影響を受けるログ・ファイルのディレクトリー・パスを指定します。


デフォルトで、TM1 サーバーは、トランザクション・ログの更新が失敗するとシャットダウンします。 FileRetry.FileSpec を指定すると、サーバーが接続の再確立を試行する間、サーバーのシャットダウンが遅延されます。再試行の回数と各試行


間の遅延はそれぞれ、FileRetry.Count と FileRetry.Delay によって決まります。指定された再試行回数後もネットワーク障害が続く場合、TM1 サーバーは自己終了します。

複数のパスを指定するには、セミコロン区切り文字を使用します。例:

1. FileRetry.FileSpec=c:¥production¥model¥Logs

「c:¥production¥model¥Logs」ディレクトリーおよびその下位ディレクトリー内のファイルにはすべて、書き込み障害時に適用される再試行ロジックがあります。

2. FileRetry.FileSpec=c:¥production¥model¥Logs;¥¥network.ibm.com¥production¥Logs

「c:¥production¥model¥Logs」ディレクトリーと¥¥network.ibm.com¥production¥Logs のネットワーク共有、およびその下位ディレクトリー内のファイルにはすべて、書き込み障害時に適用される再試行ロジックがあります。

注: このロジックが有効になっている場合、メッセージが WARN レベルでサーバー・ログに書き込まれます。

v 書き込み操作に失敗したときに再試行が進行中であった場合、「<FILENAME> への書き込みでエラーが発生しました。再試行が進行中です。(Error writing to

<FILENAME>, retry in progress.)」というメッセージが書き込まれます。

v 再試行に失敗すると、「<FILENAME> への書き込みでエラーが発生しました。再試行に失敗しました。(Error writing to <FILENAME>, retry attempt failed.)」というメッセージが書き込まれます。

FIPSOperationMode連邦情報処理標準 (FIPS) のサポートのレベルを制御します。


指定できる値:

v 1: FIPS 140-2 レベル 1 の承認済みの暗号と操作

v 2: FIPS 140-2 レベル 1 の承認済みの暗号

v 3: 無効


例えば、FIPS のサポートのレベルをレベル 1 の承認済みの暗号に変更するには、tm1s.cfg ファイルに以下の行を追加します。

FIPSOperationMode=2

ForceReevaluationOfFeedersForFedCellsOnDataChangeこのパラメーターが設定されると、データが変更されたときにフィーダー・ステートメントの再評価が強制的に行われます。


IBM Cognos TM1 サーバーがフィーダーを計算する際、プロセスはフィーダーの「チェーン」になります。つまり、セル A はセル B をフィードし、セル B のフィ


ーダー規則が存在するので、その規則によってセル C が実行され、フィードされる、といった具合です。数理セルのフィーダーは、セルが空から何らかの非ゼロ値になった場合にのみ評価されます。セルの値が非ゼロであるということは、既にフィーダーが設定済みであるということになるためです。

セルがある 1 つの非ゼロ値から別の値に変更される際にフィーダーを再評価する必要はありません。

フィーダー規則が評価済みでターゲット・セルが既にフィード済みの場合にフィーダーを評価すると、フィード・プロセスは通常、停止します。

ターゲット・セルにフィーダーが存在するということはターゲット・セルのフィーダー規則が既に実行済みであるということなので、フィーダー規則はそれ以上処理されません。再びそのフィーダー規則を実行する必要はありません。

次のようなフィーダー規則があるとします。

[’A’]=>[’B’];

セル B のフィーダー規則は、何らかのキューブ・データ値に依存します。

[B]=>DB(cube-name,!dim1,DB(cube2-name,...),!dim2);[’C’]=>[’D’];[’X’]=>[’B’];

B のフィーダー規則の初回評価時に、DB(cube2-name,...) が評価され、要素名 (C

など) が生成されます。その結果、B は C をフィードし、C は D をフィードします。そのセル X がゼロから非ゼロになると、この変更により B もフィードされます。しかし、B は既にフィード済みであるため、フィード・プロセスは停止し、B

のフィーダー規則は評価されません。規則の出力に「変更」があったとしても (その変更は DB(...) ステートメントのターゲットとなっている基本データの変更によって発生する場合がある)、その変更は評価されません。パラメーターForceReevaluationOfFeedersForFedCellsOnDataChange が設定される場合、セル B

にフィーダーが存在していても、フィーダーの処理は終了しません。 B のフィーダー規則が実行されます。B のフィーダー規則はデータに依存するため、フィーダーのターゲットが以前の C であったり、他の何らかのセルであったりしたとしても、そのセルはフィードされます。このパラメーターを設定すると強制的に行われるフィーダー評価の数が増えるので、パフォーマンスに影響を与える可能性があります。

このパラメーターをオンにするには、ForceReevaluationOfFeedersForFedCellsOnDataChange=T を設定します。

HTTPPortNumberTM1 サーバーが着信 HTTP(S) 要求を listen するポート番号を設定します。


IBM Planning AnalyticsTM1 Server は、この HTTP(S) チャネルを使用して REST

API にサービスを提供します。サーバーは、UseSSL パラメーターに応じて、標準的な HTTP 接続か SSL で保護された HTTPS 接続のどちらかを受け入れます( 407ページの『UseSSL』を参照)。 UseSSL を T に設定すると、SSL の使用がオンに切り替わるので、サーバーは HTTPS 接続のみを受け入れます。 UseSSL を F

に設定すると、サーバーは非セキュア HTTP 接続を受け入れます。


HTTPPortNumber が tm1s.cfg ファイルで定義されていない場合、ポート番号「5001」が自動的に割り当てられます。

注: ポート番号は、TM1 サーバー間や、TM1 サーバーの HTTP ポート間だけではなく、コンピューター上で実行しているすべてのサービス間で固有でなければなりません。

HTTPSessionTimeoutMinutesIBM Cognos TM1 REST API の認証セッションのタイムアウト値を設定します。


TM1 REST API の使用時には、TM1 サーバーでアプリケーションを認証する必要があります。このパラメーターは、この認証のタイムアウトを分単位で設定します。セッションがタイムアウトになると、古いセッション ID を使用して行われた要求は 401 Unauthorized を返します。

デフォルト値は 20 です。

IdleConnectionTimeOutSecondsクライアント接続がアイドル状態のときのタイムアウト限界を秒単位で指定します。


例えば、次の行を Tm1s.cfg に記述すると、アイドル状態のクライアント接続は900 秒後にサーバーによって切断されます。

IdleConnectionTimeOutSeconds=900

IndexStoreDirectoryブックマーク・ファイルを含め、索引ファイルを格納するためのフォルダーを指定します。


デフォルトでは、このパラメーターは未定義になるので、ブックマーク (*.bm) ファイルは、対応するメインファイルと同じフォルダーに配置されます。

IntegratedSecurityModeこのパラメーターは、IBM Cognos TM1 サーバーで使用するユーザーの認証モードを設定します。


このパラメーター名は、統合セキュリティー・モードに焦点を合わせていますが、2、3、および 4 の設定は、他の種類のセキュリティーを設定するために使用されます。

注: セキュリティー・モードを変更して IBM Cognos TM1 サーバーを再始動しないと、変更内容は新しいクライアント接続のみに適用されます。確実にすべてのクラ


イアントが新しいセキュリティー・モードで認証されるようにするには、管理者がすべてのクライアントをログオフする必要があります。

このパラメーターを設定するには、次の書式を使用します。

IntegratedSecurityMode=x

ここで、x は次のセキュリティー・モードのいずれかの値です。

Cognos Analytics 11 がサポートされています。

セキュリティー・モード説明

1 サーバーはセキュア・モード (標準 Cognos TM1 セキュリティー) を使用します。

この認証では、Cognos TM1 サーバーが、ユーザー名およびパスワードを Cognos TM1 データベースに保存されているユーザー名およびパスワードと照合して確認します。

2 このモードによって、統合ログオンと Cognos TM1 固有のセキュリティーとを切り替えることができます。

3 サーバーは統合ログオンを使用します。

統合ログオンは、Microsoft Windows のネットワーク認証を使用して、Cognos TM1 データへのアクセスを制御します。

このセキュリティー・モードを使用する場合は、 396ページの『SecurityPackageName』パラメーターも設定する必要があります。

詳細については、 263ページの『統合ログオン』を参照してください。

4 サーバーは、IBM Cognos Analytics セキュリティー認証を使用します。

このモードを使用する場合は、以下の点に注意してください。

Cognos TM1 では、 Cognos Analytics ユーザーは Cognos Analytics

グループおよび 3 つの内部 Cognos TM1 管理者グループ(ADMIN、DataAdmin、SecurityAdmin) にのみ属すことができます。Cognos TM1 ユーザー (非管理者) グループのメンバーシップは、Cognos Analytics ユーザーが Cognos TM1 にログオンする場合はサポートされません。

Cognos Analytics ユーザーを別の Cognos Analytics グループに永久的に割り当てるために Cognos TM1 を使用することはできません。Cognos TM1 で Cognos Analytics グループに対して行ったユーザーの割り当てを、 Cognos Analytics に保存することはできません。Cognos Analytics ユーザーが Cognos TM1 にログオンすると、Cognos Analytics のグループ割り当てが、Cognos TM1 で行われたすべての Cognos Analytics グループ割り当てをオーバーライドします。


セキュリティー・モード説明

5 サーバーは、IBM Cognos Analytics セキュリティー認証を使用し、Cognos TM1 と Cognos Analytics の両方のユーザー・グループをサポートします。

IBM Cognos Analytics セキュリティーを使用して IBM Cognos TM1

Applications を実行する場合は、セキュリティー・モード 5 を使用します。

このモードを使用する場合は、以下の点に注意してください。

v Cognos TM1 では、Cognos Analytics ユーザーは、 Cognos

Analytics グループと Cognos TM1 グループの両方に属すことができます。

v Cognos Analytics ユーザーを別の Cognos Analytics グループに永久的に割り当てるために Cognos TM1 を使用することはできません。 Cognos TM1 で Cognos Analytics グループに対して行ったユーザーの割り当てを、 Cognos Analytics に保存することはできません。 Cognos Analytics ユーザーが Cognos TM1 にログオンすると、 Cognos Analytics のグループ割り当てが、Cognos TM1 で行われたすべての Cognos Analytics グループ割り当てをオーバーライドします。

v IBM Cognos TM1 サーバーおよび IBM Cognos TM1 Applications

で IntegratedSecurityMode=5 が使用される場合、「権限の管理」ダイアログ内のネイティブ TM1 グループに権限を割り当てることはできません。使用できるのは、TM1 サーバーにインポートされている Cognos グループだけです。

IPAddressV4このパラメーターでは、個々の IBM Cognos TM1 サーバーの IPv4 アドレスを指定できます。


同じサーバーで、ファイアウォール内のクライアント用として内部の IP アドレスを使用し、ファイアウォール外のクライアント用として外部の IP アドレスを使用することがあります。デフォルトでは、すべての TM1 クライアント要求が外部の(パブリックの) アダプターによってルーティングされるので、ファイアウォール・プロファイルの更新が必要です。内部の IP アドレスを IPAddressV4 パラメーターに割り当てると、トラフィックがプライベートのアダプターによってルーティングされるので、ファイアウォール・プロファイルの更新が不要になります。

例:

IPAddressV4="10.109.241.121"

注: 古い IPAddress パラメーターは廃止されました。その代わりにこのパラメーターを使用してください。


IPAddressV6このパラメーターでは、個々の IBM Cognos TM1 サーバーの IPv6 アドレスを指定できます。


同じサーバーで、ファイアウォール内のクライアント用として内部の IP アドレスを使用し、ファイアウォール外のクライアント用として外部の IP アドレスを使用することがあります。デフォルトでは、すべての TM1 クライアント要求が外部の(パブリックの) アダプターによってルーティングされるので、ファイアウォール・プロファイルの更新が必要です。内部の IP アドレスを IPAddressV6 パラメーターに割り当てると、トラフィックがプライベートのアダプターによってルーティングされるので、ファイアウォール・プロファイルの更新が不要になります。

例:

IPAddressV6="0ff1:aa00:4125:2:a05:f7b1:61c2:a341"

注: 古い IPAddress パラメーターは廃止されました。その代わりにこのパラメーターを使用してください。

IPVersionこのパラメーターは、ネットワークの IP アドレスの指定に IBM Cognos TM1 サーバーで使用するインターネット・プロトコルを示します。

例えば、ネットワークで IPV6 プロトコルが使用されていることを示すには、パラメーター IPVersion=ipv6 を tm1s.cfg ファイルに追加します。


有効な設定は、次のとおりです。

v ipv4

デフォルトの設定。IPv4 ネットワークに使用します。

v dual

IPv4 から IPv6 に移行する場合に使用します。両方のプロトコルがサポートされます。

v ipv6

IPv6 ネットワークに使用します。

設定に関する注意事項

このパラメーターを ipv6 または dual に設定する場合は、この変更を反映するために、Cognos Configuration ツールを使用して、「TM1 管理サーバーの IP サポート」オプションを変更してください。

クライアントにこの変更を認識させるには、オペレーティング・システムにTM1_IPVersion 環境変数を追加して ipv6 または dual に設定します。


該当するネットワークが実行されていないのに、このパラメーターに dual またはIPV6 を設定した場合は、パフォーマンスが低下します。

注: ネットワーク環境や DNS 設定によっては、Cognos TM1 管理サーバーおよびCognos TM1 サーバーを IPv6 モードで正常に実行するために、UNIX およびMicrosoft Windows の /etc/hosts オペレーティング・システム・ファイルに IPv6

アドレスを追加することも必要になる場合があります。

すべての Cognos TM1 コンポーネントを IPv6 を使用するように設定する方法について詳しくは、 103ページの『IPv6 を使用するための Cognos TM1 の設定』を参照してください。

JavaClassPathこのパラメーターは、サード・パーティー製の Java ライブラリーを IBM Cognos

TM1 サーバーで使用できるようにするために使用します。


例えば、Java 拡張で db2cc4.jar ファイル (DB2 JDBC ドライバー) という名前のファイル内のクラスを使用できるようにするには、以下を使用します。

JavaClassPath=C:\Development\Java\DB2JDBC\db2jcc4.jar

セミコロンで区切って、複数の参照を指定できます。

JavaJVMArgsJava 仮想マシン (JVM) に渡す引数のリストを指定します。引数は、スペースとダッシュ文字で区切ります。例えば、JavaJVMArgs=-argument1=xxx -argument2=yyy

です。


プロセスをデバッグする場合には、以下のような引数を指定できます。

JavaJVMArgs=-Xrunjdwp:transport=dt_socket -server=y -suspend=n -address=1044

使用している JVM の種類に応じて、使用できる引数が異なる場合があります。

JavaJVMPathこのパラメーターは、パスを Java 仮想マシンの .dll ファイル (jvm.dll) に設定します。このファイルは、IBM Cognos TM1 TurboIntegrator から Java を実行するために必要です。


デフォルトでは、このパラメーターは tm1s.cfg ファイルに存在していません。

Java と TurboIntegrator の統合を有効にするには、以下の行を tm1s.cfg ファイルに追加します。

JavaJVMPath=<full_path_to_jvm.dll>


注: 64 ビット・バージョンの tm1s.exe を使用している場合は、64 ビット・バージョンの jvm.dll を使用する必要があります。 32 ビット・バージョンの tm1s.exe の場合は、32 ビット・バージョンの jvm.dll が必要です。

JobQueuing個人用ワークスペースやサンドボックスでの送信のキューイングを有効にします。


このパラメーターを JobQueuing=T に設定して、すべてのサンドボックス送信がジョブ・キューを使用して処理されるようにします。このパラメーターが F に設定されているか、設定ファイルにない場合は、サンドボックス送信はキュー内で処理されません。

このパラメーターが有効な場合は、送信アイコンがツールバーに表示されます。

詳細については、「IBM Cognos TM1 Perspectives, TM1 Architect, and TM1 Web」で、『サンドボックスとライトバック』のセクションに記載されているジョブ・キューイングに関する説明を参照してください。

JobQueueMaxWaitTimeキュー・スレッドが実行されると、キューのジョブを処理するのに必要なロックを得られるようにすべての着信要求をブロックします。新しい要求は、JobQueueMaxWaitTime パラメーターに設定されている時間が過ぎるまでブロックされます。


現在実行している要求がこの時間内に終了しない場合は、キュー・スレッドはJobQueueThreadSleepTime の時間スリープに戻って、着信要求の処理が可能になります。

キュー・スレッドに高い優先度を与えるには、JobQueueMaxWaitTime に大きな数字を設定します。

JobQueueMaxWaitTime パラメーターが構成ファイルでゼロ (0) に設定されていて、ジョブ・キューイングが有効になっている場合は、キューは処理可能になるまで要求の実行を試み続け、それが完了するまで他のすべての活動を効率的にロックアウトします。

詳しくは、「IBM Cognos TM1 Perspectives, TM1 Architect, and TM1 Web」の『ジョブ・キューイング』を参照してください。

デフォルト値: 100ms

JobQueueThreadPoolSizeJobQueueThreadPoolSize パラメーターを使用すると、IBM Cognos TM1 で複数のスレッドを使用して Cognos TM1 ジョブ・キューを処理できるようになり、スループットと、サンドボックス要求の処理性能が向上します。



デフォルトでは、このパラメーターが設定されていない場合、 Cognos TM1 は値 1

を使用し、 Cognos TM1 サーバーはジョブ・キューの要求を処理するために単一スレッドのみを使用します。

このパラメーターを tm1s.cfg ファイルで以下の書式で設定します。

JobQueueThreadPoolSize=x

ここで、x は Cognos TM1 ジョブ・キューの要求を処理するために使用するスレッドの数を表します。

例:

JobQueueThreadPoolSize=3


JobQueueThreadSleepTimeキュー・ジョブがある場合にキューを処理するスレッドの実行頻度を指定します。


デフォルト値: 10 秒

keyfile鍵データベース・ファイルへのファイル・パスを指定します。鍵データベース・ファイルには、サーバー証明書と信頼できる認証局が含まれています。サーバー証明書は、TM1 サーバーと TM1 管理サーバーが使用します。


TM1 に用意されている鍵データベース・ファイルは、[installation_location]/

ssl/ibmtm1.kdb です。

別の鍵データベース・ファイルを指定する場合は、tm1s.cfg ファイルに keyfile パラメーターを追加し、.kdb ファイルの相対パスまたは絶対パスを指定してください。

例:

keyfile=./ssl/filename.kdb

keylabel鍵データベース・ファイル内のサーバー証明書のラベルを指定します。


例:

keylabel=TM1_Certificate


keystashfile鍵データベース・パスワード・ファイルへのファイル・パスを指定します。鍵データベース・パスワード・ファイルは、鍵データベース・ファイルのパスワードが含まれている鍵ストアです。


TM1 に用意されている鍵データベース・パスワード・ファイルは、[installation_location]/ssl/ibmtm1.sth です。

別の鍵データベース・パスワード・ファイルを指定する場合は、tm1s.cfg ファイルに keystashfile パラメーターを追加し、.sth ファイルの相対パスまたは絶対パスを指定してください。

例:

keystashfile=./ssl/filename.sth

LanguageIBM Cognos TM1 サーバーで使用される言語を設定します。このパラメーターは、サーバーによって生成されるメッセージに適用されます。また、サーバーをWindows サービスとしてではなくアプリケーションとして実行する場合に、サーバーのダイアログ・ボックスのユーザー・インターフェースでも使用されます。


現在有効な値は、次のとおりです。

言語コード



チェコ語 csy




オランダ語 nld

ドイツ語 deu


フランス語 fra


イタリア語 ita

日本語 jpn

カザフ語 kaz

韓国語 kor





言語コード

ロシア語 rus

スペイン語 esp



タイ語 tha

トルコ語 trk

LDAPHostLDAP サーバー・ホストのドメイン名、またはその IP アドレスのドット付き文字列表現を指定します。


LDAPHost の値を入力しない場合は、デフォルト値の localhost が IBM Cognos

TM1 で使用されます。

LDAPPasswordFileLDAPUseServerAccount が使用されていない場合に使用するパスワードファイルを定義します。これは、IBM Cognos TM1 サーバーの管理サーバーの秘密鍵の暗号化パスワードを含む .dat ファイルの絶対パスです。


このパラメーターは、.dat ファイルへの絶対パスを使用します。

LDAPPasswordKeyFileLDAPUseServerAccount が使用されていない場合に使用するパスワード・キーを定義します。


このパラメーターは、秘密鍵のパスワードの暗号化/暗号化解除に使用するキーを含む .dat ファイルの絶対パスを使用します。

このファイルは、tm1crypt ユーティリティーを使用して生成する必要があります(説明は、 318ページの『TM1Crypt ユーティリティーの実行』を参照してください)。

LDAPPortIBM Cognos TM1 が LDAP サーバーへのバインドに使用するポートを指定します。



636 などのセキュア (SSL) ポートを指定します。

デフォルト値: 389 (無保護ポート)

LDAPSearchBaseLDAP ツリーの中で、IBM Cognos TM1 が有効なユーザーの検索を開始するノードを指定します。


LDAP ディレクトリー内のベース識別名 (DN)。例:

ou=people,o=company.com

例えば、識別名の形式が次のようになっている場合は、

uid-bjensen, ou-people, o=company.com

検索ベースは、次のようになります。

ou-people, o=company.com

LDAPSearchField検証されている IBM Cognos TM1 ユーザー名を含むことが予期される LDAP 属性の名前。


LDAPSearchField 値を入力しなかった場合のデフォルト値は cn です。Microsoft

Active Directory の場合もデフォルト値は同じです。

LDAPSkipSSLCertVerificationLDAP サーバーに対する認証に使用する SSL 証明書に関する信頼性検証ステップをスキップします。このパラメーターは、LDAPVerifyServerSSLCert=T の場合のみ適用されます。


信頼性検証が作動しない場合は、LDAPSkipSSLCertVerification=T を指定して、信頼性検証ステップをスキップできます。この場合、TM1 はサーバー証明書をまったく検証せず単に受け入れます。



LDAPSkipSSLCRLVerificationLDAP サーバーに対する認証に使用する SSL 証明書に関する CRL 検査をスキップします。このパラメーターは、LDAPVerifyServerSSLCert=T の場合のみ適用されます。



LDAPVerifyServerSSLCert=F の場合、このパラメーターは必要ありません。Microsoft Windows API は、空の CRL 証明書や存在しない CRL 証明書を許容できます。



LDAPUseServerAccountLDAP 認証を使用する場合に、サーバーへの接続にパスワードが必要かどうかを指定します。


v 統合認証を使用して LDAP サーバーに直接接続する場合は、このパラメーターをT に設定します。IBM Cognos TM1 サーバーと LDAP サーバーが同じドメイン上に存在する場合は、このパラメーターを必ず T に設定してください。

v 接続する前にパスワードを使用する場合は、このパラメーターを F に設定します。 LDAPUseServerAccount を F に設定した場合に SSL を使用して LDAP サーバーに正常に接続するには、 276ページの『LDAPPasswordFile』と 276ページの『LDAPPasswordKeyFile』も設定する必要があります。

LDAPVerifyCertServerNameLDAP サーバー認証における SSL 証明書の検証プロセス中に使用するサーバーを指定します。このパラメーターは、LDAPVerifyServerSSLCert=T の場合のみ適用されます。



このパラメーターを使用して、受信した SSL 証明書の検証に TM1 が使用するサーバーを指定します。

証明書検証に使用するすべてのサーバー名を別々の LDAPVerifyCertServerName エントリーにリストする必要があります。このエントリーは、SSL ハンドシェークで他方のサーバーにより TM1 に提示される証明書の名前 (サブジェクト) と厳密に一致する必要があります。

LDAPVerifyCertServerName は、LDAP を使用している各 TM1 サーバーの tm1s.cfg

ファイルで指定します。

LDAPVerifyCertServerName=<server_cert_subject>

server_cert_subject をサーバー名または IP アドレスに置き換えてください。使用するサーバーごとにエントリーを作成します。以下に例を示します。

LDAPVerifyCertServerName=abc99.mydomain.comLDAPVerifyCertServerName=xyz99.mydomain.com



LDAPVerifyServerSSLCertSSL 証明書の検証を TM1 に委任します。このパラメーターは、プロキシー・サーバーを使って LDAP を使用する場合などに便利です。



通常は、TM1 は Microsoft Windows API を利用して SSL 証明書を検証します。このプロセスを正常に実行するには、証明書の名前と LDAP サーバーのホスト名が一致している必要があります。しかし、プロキシーを使用している場合、これらの名前が一致せず、検証が失敗することがあります。この場合は、LDAPVerifyServerSSLCert=T を設定して、TM1 に証明書検証を実行させることができます。

LDAPVerifyServerSSLCert=T の場合、TM1 は、検証の 2 つのステップ (証明書に対する信頼関係の検証と CRL の検査) を実行します。この検証は Windows API が行う検証と似ていますが、方法が多少違います。

1. TM1 は、受け取った証明書を構成済みのホスト名に対して検証する代わりに、LDAPVerifyCertServerName で指定されているサーバー名のリストを参照します。

2. LDAPVerifyCertServerName で指定されているサーバーの 1 つと証明書名が一致する場合、TM1 は Microsoft Windows API を呼び出し、この単一の証明書のみの検証を要求します。

注: 正しいトラステッド・ルート認証局 (CA) を Microsoft Windows の証明書ストアにインポートしておく必要があります。

LDAPSkipSSLCertVerification=T を指定すると、信頼性検証ステップをスキップできます。この場合、TM1 はサーバー証明書をまったく検証せず単に受け入れます。

3. 信頼性検証を確認し終えると (またはスキップすると)、TM1 は Microsoft

Windows API を呼び出して CRL を検査します。

注: トラステッド・ルートの CRL 証明書を Microsoft Windows の証明書ストアにインポートしておく必要があります。

Microsoft Windows 証明書ストア内に CRL 証明書が存在しない場合、プロセスは失敗します。 LDAPSkipSSLCRLVerification=T を指定すると、CRL のステップをスキップできます。

4. 上記のステップがすべて正常に終了した場合、SSL ハンドシェークが完了します。この時点で、TM1 は LDAP サーバーに対して認証を試みます。

トラブルシューティング情報については、 281ページの『LDAP 認証のトラブルシューティング』を参照してください。


LDAPWellKnownUserNameIBM Cognos TM1 サーバーが LDAP にログインするために使用するユーザー名を指定します。ICAS はこの名前を使用してユーザーから提示された名前を検索します。


このパラメーターの値は任意の LDAP 識別名にすることができます。

例:

uid=bjensen,ou=people,o=company.com

LoadPrivateSubsetsOnStartupこの構成パラメーターでは、TM1 サーバーの始動時に個人用サブセットをロードするかどうかを指定します。


個人用サブセットをオンデマンドで (ユーザーがサブセットを要求した場合に) ロードすると、ロック競合の問題が発生する可能性があります。サーバーの始動時に、すべてのユーザーのすべての個人用サブセットをメモリーにロードすれば、ロック競合を回避できます。そのためには、以下の行

LoadPrivateSubsetsOnStartup=T

をサーバーの Tm1s.cfg ファイルに追加します。

LoadPrivateSubsetsOnStartup=F の場合や、このパラメーターが Tm1s.cfg に存在しない場合は、個人用サブセットがオンデマンドでロードされます。

LockPagesInMemoryこのパラメーターが有効にされると、Windows は IBM Cognos TM1 の処理スペースからページを削減しますが、これはディスクにページングされません。


Windows 64 ビット・オペレーティング・システムで実行している Cognos TM1 サーバーが長期間アイドルの場合、Cognos TM1 サーバーによって利用される物理メモリーはディスクにページアウトされます。これは Windows 64 ビット・オペレーティング・システムの機能であり、Cognos TM1 の機能ではありません。これは、アイドル期間の後にデータへアクセスしようとする場合、大きな Cognos TM1 データベースのパフォーマンスが低下する原因になります。

64 ビット Windows で大きな Cognos TM1 データベースを実行している場合のパフォーマンスを最大限にするには、LockPagesInMemory=T を Tm1s.cfg ファイルに設定します。

このパラメーターが有効にされると、Windows は Cognos TM1 の処理スペースからページを削減しますが、これはディスクにページングされません。オブジェクト


は仮想メモリーには置かれなくなりますが、その代わりに物理的 RAM に維持されるので Cognos TM1 サーバーのパフォーマンスを向上させることができます。

LoggingDirectoryサーバーのログ・ファイルを保存するディレクトリーを指定します。

このパラメーターを記述しなかった場合は、DataBaseDirectory パラメーターで指定された最初のデータ・ディレクトリーにログ・ファイルが保存されます。

パラメーターの型: オプション、静的

注: パラメーター LoggingDirectory の値に空白文字を使用する場合は、引用符で囲む必要があります。例えば、LoggingDirectory=C:/Data Files/Logfiles。引用符を使用しないと Cognos TM1 サーバーを起動できません。また DataBaseDirectory などの他のパラメーターの場合は、値に空白文字が含まれている場合でも引用符は必要ありません。

LogReleaseLineCount一時的に解放して他のトランザクション・ログ操作が処理できるようにする前にトランザクション・ログの検索がロック状態に累積する行数を設定します。


デフォルト値: 5000 行

MagnitudeDifferenceToBeZero分母に対する相対分子の大きさを設定します。この大きさを超える場合、安全な除算演算子を使用するとき、分母はゼロに等しくなります。


規則および TurboIntegrator には、安全な除算演算子 (バックスラッシュ) があります。これを使用して、ゼロで除算しようとする場合、結果はゼロであり、未定義ではありません。除算に対する分母が、算出された数量である場合、結果は非常に 0

に近いが、正確にはゼロではない (例えば、.0000000000000004) 場合があります。MagnitudeDifferenceToBeZero パラメーターを設定することによって、分子の大きさに対して相対的に数値をどれほどゼロに近づけられるかを指定でき、これは、安全な除算演算子に対してゼロと見なされます。

次の例を検討します。

v ファイル Tm1s.cfg で、MagnitudeDifferenceToBeZero=14 を設定します

v 演算は、A ¥ B です。

注: バックスラッシュ (¥) は TurboIntegrator の安全な除算演算子です。

v A = 1000 B = 1.5e-15

v B は A より 18 桁小さくなっています。

v 18 > 14、したがって、安全な除算演算子は B=0 を戻します


MaskUserNameInServerToolsユーザーが管理者権限を持っていると明示的に検証されるまでサーバー管理ツール(Operations Console) でユーザー名にマスクをかけるかどうかを指定します。


MaskUserNameInServerTools が TRUE に設定されると、ユーザー名は、サーバー管理ツールで作業するそのユーザーが管理者として明示的に検証されるまでは、管理ツール内でマスクがかけられます。 Operations Console に対する管理者権限の検証方法について詳しくは、「IBM Cognos TM1 Operations Console」を参照してください。

MaskUserNameInServerTools を FALSE に設定すると、管理者状況に関係なく、ユーザー名はサーバー管理ツールですべてのユーザーに対して表示されます。


MaximumCubeLoadThreadsサーバー・ロード処理でのキューブ・ロードとフィーダー計算の段階をマルチスレッド化して、複数のプロセッサー・コアを並列に使用できるようにするかどうかを指定します。

これにより、サーバーのロード時間が短縮されます。


マルチスレッド・モードで実行するには、キューブのロード処理とフィーダーの処理の専用に割り当てる、Cognos TM1 サーバー上のプロセッサー・コアの数をMaximumCubeLoadThreads に設定する必要があります。

通常は、このパラメーターを、使用可能なプロセッサー・コアの数から 1 を引いた値に設定すると、パフォーマンスを最大化できます。例えば、4 つのプロセッサー・コアのあるコンピューターで Cognos TM1 サーバーを実行する場合は、MaximumCubeLoadThreads を 3 に設定します。そうすれば、Cognos TM1 サーバーのロード時に、他のアプリケーションを実行するためのプロセッサー・コアを 1 つ確保できます。

MaximumCubeLoadThreads が 0 に設定されている場合は、キューブのロード処理とフィーダー処理がマルチスレッド化されません。これは、Tm1s.cfg ファイルにMaximumCubeLoadThreads が明示的に設定されていない場合のデフォルトの動作です。

注: MaximumCubeLoadThreads が有効になっている場合、Cognos TM1 ではフィーダーの計算順序を制御できません。マルチスレッド環境では、何らかの評価順序の依存性が原因となって、処理の順序がアプリケーションに悪影響を及ぼす可能性もあります。


Cognos TM1 モデルで条件付きフィーダーを使用しており、条件節にフィードされた値が含まれる場合は、MaximumCubeLoadThreads=0 に設定するか、Tm1s.cfg ファイルからこのパラメーターを削除して、ロード時にマルチスレッドを使用しないようにする必要があります。

MaximumLoginAttemptsユーザーによるログイン試行の失敗をサーバーで何回まで許容するか、その最大値を設定します。

MaximumLoginAttempts を Tm1s.cfg に記述しない場合は、デフォルトで 3 回のログイン試行がサーバーによって許容されます。


例えば、行 MaximumLoginAttempts=5 を Tm1s.cfg に追加した場合、サーバーでのログイン試行の失敗の限界は 1 ユーザーあたり 5 回になります。ユーザーが、指定された試行回数以内に Cognos TM1 サーバーに正しくログインできない場合は、エラーが発行されます。

指定された最大回数を超えてユーザーがログインに失敗した場合は、それ以降、そのユーザーによるログインは Cognos TM1 サーバーによって拒否されます。

MaximumLoginAttempts パラメーターは、サーバー・セッションごとに適用されます。最大試行回数を超えたユーザーは、Cognos TM1 管理者がそのユーザーのパスワードを変更しない限り、そのときの Cognos TM1 サーバー・セッションにはログインできません。ただし、Cognos TM1 サーバーのリサイクル後は、自分の既存のパスワードでログインできます。

MaximumMemoryForSubsetUndoサブセット・エディターの「元に戻す/やり直し」スタックを格納するために専用に割り当てるメモリーの最大量をキロバイト単位で設定します。

例えば、行 MaximumMemoryForSubsetUndo=20480 を設定ファイルに追加すると、「元に戻す/やり直し」スタック用に 20480 KB (20 MB) のメモリーを確保するようサーバーに指示することになります。


一般に、大きなサブセットほど、「元に戻す/やり直し」スタックの格納に必要なメモリー量も多くなります。 Cognos TM1 サーバーがサブセット用に十分な数の「元に戻す/やり直し」手順を格納していないことが判明した場合は、MaximumMemoryForSubsetUndo の値を大きくしてください。

このパラメーターが Tm1s.cfg ファイルに明示的に設定されていない場合は、サブセット・エディターの「元に戻す/やり直し」機能に専用に割り当てられるメモリーの最大量は 10240 KB (10 MB) です。

MTFeeders始動時に、CubeProcessFeeders() TI 関数、キューブ規則更新、フィーダー作成のプロセスにマルチスレッド・クエリー並列化手法を適用します。



デフォルトの設定は無効 (F) です。このパラメーターを有効にすると、フィーダーの処理が向上します。 MTFeeders=T を設定した場合、以下のような利点があります。

v CubeProcessFeeders( <cube_name>) TI 関数を使用する場合のプロセスを最適化できます。

v 規則の更新にフィーダー・キューブの更新が伴う場合に、並列実行によってプロセスを最適化できます。規則の更新は、手動で行うか、RuleLoadFromFile (Cube,

TextFile) TI 関数によって行います。

v MTFeeders.AtStartup=T を使用して、始動時にフィーダーを作成できます。あるいは、RuleLoadFromFile(Cube, TextFile) TI 関数を使用して、始動時にフィーダーをロードすることもできます。

MTFeeders.AtStartupMTFeeders 構成オプションが有効になっている状態で MTFeeders.AtStartup を有効にすると、サーバー始動時のフィーダーの作成に影響が及びます。


デフォルトの設定は無効 (F) です。

この構成オプションを有効にすると、MaximumCubeLoadThreads オプションで設定するロード・スレッドが並列的なフィーダー作成をテークオーバーしなくなります。ただし、MTFeeders.AtStartup を有効にしても、他のモデル・ロード・フェーズに対する MaximumCubeLoadThreads の影響が無効になるわけではありません。

あるいは、RuleLoadFromFile(Cube, TextFile) TI 関数を使用して、始動時にフィーダーをロードすることもできます。

MTFeeders.AtomicWeight1 つのセルのフィーダーを処理するために必要なアトミック操作の数を定義します。


「アトミック操作」は、MTQ.OperationProgressCheckSkipLoopSize 構成オプションで使用する単位です。基本的に、MTFeeders.AtomicWeight の値は、試行錯誤法で決めるようにしてください。読み取り操作時にセルにアクセスする場合に比べてフィーダーの作成がどれほど遅くなるかを示す相対的な値です。MTQ.OperationProgressCheckSkipLoopSize/ MTFeeders.AtomicWeight の比率が、フィーダーの更新を処理する時に並列実行を起動するセルの概数になります。


MaximumSynchAttemptsプロセスが失敗する前に、プラネット・サーバーの同期プロセスがネットワークに再接続しようとする最大回数を設定します。



MaximumSynchAttempts パラメーターを使用して、待ち時間が長く、帯域幅が狭く、通信品質が低い長距離広帯域ネットワーク (WAN) などの不安定なネットワーク接続で実行する同期プロセスの安定性を向上させることができます。

同期プロセスがネットワーク接続の確立を試みる最大試行回数を指定する場合は、プラネット・サーバーの Tm1s.cfg に次の行を追加します。

MaximumSynchAttempts=n

ここで、n はプロセスが失敗する前に同期プロセスが行う必要があるネットワーク接続試行の回数を表します。

デフォルト値 1 は、同期プロセスが 1 回のみ接続を試行し、接続が失われても再接続を試行しないことを意味します。このデフォルトの動作は Cognos TM1 のバージョン 9.5.1 より前と同じです。ネットワーク接続が失われた場合、同期プロセスは機能しなくなります。

0 値の場合は、無制限にネットワーク接続を試行します。

このパラメーターは、SyncUnitSize パラメーターと合うように設定することができます。詳細については、 402ページの『SyncUnitSize』を参照してください。

次の例では、MaximumSynchAttempts パラメーターを SyncUnitSize パラメーターと一緒に使用する方法を示しています。

SyncUnitSize=2000

MaximumSynchAttempts=100

MaximumTILockObjectsTurboIntegrator プロセスの最大ロック・オブジェクトを設定するサーバー設定パラメーター。 synchronized() TurboIntegrator 関数によって使用されます。

サーバーは、作成された TurboIntegrator ロック・オブジェクトのリストを保持します。ユーザーがロック・オブジェクトに対して synchronized() 関数を呼び出すたびに、サーバーは、そのロック・オブジェクトが既にリストに存在するかどうかを最初に確認します。存在しない場合、サーバーは新規ロック・オブジェクトを作成し、リストに挿入します。

詳しくは、「IBM Cognos TM1 TurboIntegrator」のトピック『synchronized() を使用する TurboIntegrator プロセスの直列化』を参照してください。

あるロック・オブジェクトを参照していたすべての TurboIntegrator プロセスが終了しても、そのロック・オブジェクトがリストから削除されず、メモリーがただちに解放されないことがあります。これは、少し後に、同じプロセスまたは他のプロセスが同じロック・オブジェクトに対して synchronized() 関数を呼び出す可能性があるからです。

tm1s.cfg のサーバー設定パラメーター MaximumTILockObjects は、作成されたTurboIntegrator ロック・オブジェクトのリストの増大を制御します。リストのロック・オブジェクトの数が MaximumTILockObjects に達すると、サーバーはクリーン


アップ操作を開始します。このときに TurboIntegrator プロセスで使用されていないロック・オブジェクトがあれば、それらがリストから削除されます。

tm1s.cfg で MaximumTILockObjects パラメーターを明示的に設定していない場合は、デフォルト値として 2000 が使用されます。


MaximumUserSandboxSize個人用のワークスペースやサンドボックスとして各ユーザーに割り当てる RAM メモリーの最大量 (MB 単位) を設定します。

MaximumUserSandboxSize パラメーターを設定しない場合のデフォルトの最大サイズは、32 ビットシステムでは 100 MB、64 ビットシステムでは 500 MB です。


個人用のワークスペースやサンドボックスとして割り当てる最大メモリー量を指定するには、次の行を Tm1s.cfg に追加します。

MaximumUserSandboxSize=n

ここで、n は割り当てるメモリー量 (MB 単位) です。

MaximumViewSizeユーザーがビューにアクセスするときに割り当てられる最大メモリー量 (MB 単位)

を設定します。

MaximumViewSize パラメーターを設定しない場合のデフォルトの最大ビュー・サイズは、32 ビット・システムでは 100MB、64 ビット・システムでは 500 MB です。


ビューに割り当てる最大メモリー量を指定するには、次の行を tm1s.cfg に追加します。

MaximumViewSize=n

ここで、n は割り当てるメモリー量 (MB 単位) です。

345ページの『ApplyMaximumViewSizeToEntireTransaction』も参照してください。

MDXSelectCalculatedMemberInputsゼロ消去が有効になっている場合の、MDX の式の算出メンバーの処理方法を変更します。



MDXSelectCalculatedMemberInputs は、ゼロ消去が有効になっている場合の、MDX

式の算出メンバーに関する問題を処理します。ゼロ消去がクエリー軸で有効になっている場合、算出メンバーがクエリーからドロップされたり、ゼロ消去がオフになったりすることがあります。

ゼロ消去がキューブ内の実際のデータに基づいていることから、この問題が発生します。算出メンバーは、キューブ内に実際のメンバーを持ちません。算出メンバーは、他のメンバーから導き出されます。

例えば、あるキューブが、メンバー A と B の合計である算出メンバー C を持っているとします。

C (A+B)A B

メンバー A と B は、キューブ内の実際のメンバーですが、C は導き出されています。それらの列で A、B、および C を使用して {A,B,C} としてクエリーを実行すると、列に A、B、および C が表示され、C が A と B の合計になっていることがわかります。ゼロ消去をオンにすると、想定どおり、A、B、および C の非ヌル行のデータのみが表示されます。

ここで、列を C のみである {C} に制限するとします。ゼロ消去がオフになっている場合、C が列に表示されます。ゼロ消去をオンにすると、C がキューブ内の実際のメンバーを参照していないため、C が列からドロップされます。

MDXSelectCalculatedMemberInputs は、この問題を処理します。ゼロ消去がオンになっているときに MDXSelectCalculatedMemberInputs が有効になっている場合、TM1

は、算出メンバーへの入力にデータ (この例では A と B) がある場合には算出メンバー (C) にもデータが入るので保持しなければならないと想定して処理します。

以下のような処理が発生します。

1. 算出メンバーを素早く検査して、参照している実際の具体的なメンバーを検出します。

2. これらの実際のメンバーを算出メンバーの入力として検討します。

3. これらの入力が、ビューの基になるスターゲイト・データに含まれていることを確認します。

スターゲイト・データに含まれている入力を使用して、消去アルゴリズムは A とB のスターゲイト・データを確認し、A と B が C の入力であることを識別し、ゼロ消去が有効になっているときに C を保持します。

MDXSelectCalculatedMemberInputs は、C=A+B のような単純な数式での処理に適しています。 IIF のような条件式を含んだデータ依存の数式など、複雑な数式を使用する場合、MDXSelectCalculatedMemberInputs を有効にしてもゼロ消去の問題が解決されないことがあります。

注: MDXSelectCalculatedMemberInputs を有効にすると、スターゲイト・ビューのサイズが増加することがあります。これにより、キューブ・データへのアクセス時間が高速になることがありますが、システム・リソースの消費量は増えることがあります。


MDXSelectCalculatedMemberInputs を有効にするには、tm1s.cfg ファイルに以下を追加します。

MDXSelectCalculatedMemberInputs=True

MDXSelectCalculatedMemberInputs を無効にするには、tm1s.cfg ファイルに以下を追加します。

MDXSelectCalculatedMemberInputs=False

デフォルト値: True

MaximumViewSize にデフォルトの 500 MB よりも大きい値を設定することをお勧めします。

MessageCompression大きなメッセージに対してメッセージ圧縮を有効にします (これにより、ネットワーク・トラフィックが大幅に軽減されます)。

このパラメーターは、デフォルトで有効になっています。


メッセージ圧縮を無効にするには、次の行を Tm1s.cfg に追加します。

MessageCompression=F

MTCubeLoad個々のキューブのマルチスレッド・ロードを有効にします。


デフォルト値: F (無効)

MTCubeLoad は、MTQ のマルチスレッド・フレームワークを使用することで、従来の MaximumCubeLoadThreads を使用する方式より処理速度を向上させることができます。 MTCubeLoad.MinFileSize、MTCubeLoad.Weight、MTCubeLoad.UseBookmarkFiles、IndexStoreDirectory の各構成設定を使用して、パフォーマンスを最適化できます。

MTCubeLoad を使用すれば、フィーダー生成順序が変更されるリスクも除去できます。 MTCubeLoad を有効にすると、MaximumCubeLoadThreads 構成オプションは無視されます。MTCubeLoad では MTQ フレームワークを活用するので、やはり MTQ 構成を使用して並行スレッドの数を設定する必要があります。

TM1 サーバー管理者は、PreallocatedMemory.Size、PreallocatedMemory.ThreadNumber、PreallocatedMemory.BeforeLoad の設定を使用して、事前割り振りメモリーを構成したり、スケールアップやパフォーマンスの結果を最適化したりできます。TM1 サーバーのメモリーを割り振っておけば、オペレーティング・システムのメモリー割り振りの違いに関連した競合の影響を回避するのに役立ちます。最高の結果が得られるように、TM1 サーバーが消費する RAM の量をよく検討して事前割り振りメモリーの設定を構成してください。


以下の tm1s.cfg は、マルチスレッドのキューブ・ロードの構成例です。

MTCubeLoad=TMTQ=AllMTCubeLoad.UseBookmarkFiles=TIndexStoreDirectory=c:\Cubes\CubeFolder\indexStore

# 30GB of RAM to preallocatePreallocatedMemory.Size=30000# Run preallocation in parallel to cube cell/feeder loadingPreallocatedMemory.BeforeLoad=F# Window 2008/2012 patches as of Dec 2016 worked most efficiently with a single threadPreallocatedMemory.ThreadNumber=1

# Disable TM1 performance counters to speed up MTQ.PerfMonIsActive=F

MTCubeLoad.MinFileSizeマルチスレッドでロードするキューブ・ファイルの最小サイズを設定します。


KB (キロバイト) 単位で値を指定する必要があります。「0」の値を指定すると、ファイルのサイズにかかわらず、MTCubeLoad が適用されます。

デフォルト値: 10 KB

MTCubeLoad.UseBookmarkFilesディスク上のブックマークの永続設定を有効にします。


ブックマークには、キューブのロード時に、.cub ファイルと .feeder ファイルの途中からセル/フィーダーの読み取りを開始するための情報が格納されます。永続的なブックマークの場合は、ファイルからブックマークを読み取ることができます。ブックマーク・ファイルがない場合や、対応するメインファイルと同期されていない場合は、キューブのロード・ロジックの残りの部分と並行してブックマークが処理中に生成されます。ブックマーク・ファイルを格納するフォルダーは、IndexStoreDirectory 構成オプションで指定します。例:

<IndexStoreDirectory>\<path-to-main-file-relative-to-data-folder>\<main-filename>.bm

ブックマーク・ファイルには、対応するメインファイルのタイム・スタンプが取り込まれます。メインファイルの実際のタイム・スタンプと一致しない場合は、ブックマーク・ファイルが無視され、ブックマークが処理中に再生成されます。ブックマークが同期されたかどうかが不確かな場合は、ブックマーク・フォルダーの内容をクリアしてください。サーバーの再始動後に、その内容が再生成されます。SaveDataAll 呼び出しと CubeSaveData 呼び出しでブックマークに関連するメインファイルを更新するときにも、ブックマーク・ファイルは更新されます。



MTCubeLoad.Weight1 つのセルをロードするために必要なアトミック操作の数を定義します。


「アトミック操作」は、MTQ.OperationProgressCheckSkipLoopSize 構成オプションで使用する単位です。MTCubeLoad.Weight は、読み取り操作時にセルにアクセスする場合に比べてセルのロードがどれほど遅いかを示す、経験則による相対的な値です。


MTQマルチスレッドによる最適化を適用する場合の 1 ユーザー接続あたりの最大スレッド数を設定します。クエリーの処理時や、フィーダーとキューブのバッチ・ロード操作時に使用されます。


マルチスレッドによる最適化を行うための最大スレッド数を指定するには、Tm1s.cfg に以下の行を追加します。

MTQ=n

n は、1 つの操作で使用するスレッドの数です。

デフォルトでは、MTQ=All (大/小文字を区別しない) です。これは、サーバー上で使用できるコアの最大数に値を設定します。この結果は、すべてのコアが使用される動的システム設定になります。

MTQ を負数に設定する (つまり MTQ=-N にする) と、使用されるスレッド数はT=M-N+1 という等式で定義されます。T はシステムで使用されるスレッド数で、M

はサーバー上のスレッド数です。

例えば、サーバーに 64 個のコアがある場合、MTQ=-10 と設定すると、55 個のコアがシステムで使用されます。

T=64-(10)+1

MTQ=1 または MTQ=0 を設定すると、マルチスレッドによる最適化はオフになります。

詳細については、「IBM Cognos TM1 操作」の『マルチスレッド・クエリーによる処理パフォーマンスの向上』を参照してください。

デフォルト値: All

注: マルチスレッドによる最適化を行うと、数値キューブのパフォーマンスを向上させることができます。数値キューブの集約が最適化されるからです。TM1 は文字列値を集約しないので、MTQ パラメーターは文字列キューブのパフォーマンスには影響しません。


MTQ.CTreeRedundancyReducerこのパラメーターは、マルチスレッド・クエリー処理の微調整に使用します。


このパラメーターを True に設定すると、MTQ ワーカー・スレッド内の同じ規則起動型のセルの再計算が必要になる可能性が低くなります。


MTQ.OperationProgressCheckSkipLoopSizeこのパラメーターは、マルチスレッド・クエリー処理の微調整に使用します。


このパラメーターは、マルチスレッド分割が必要かどうか検査する前に処理されるセルの数を指定します。


MTQ.SingleCellConsolidationこのパラメーターは、マルチスレッド・クエリー処理の微調整に使用します。


単一セルの集約に対するマルチスレッド・クエリー処理を許可しない場合は、このパラメーターを FALSE に設定します。例えば、モデルに複雑な規則 (再帰の深さが 2 より深いクロスキューブ参照がある規則) が含まれる場合が該当します。

単一セルの集約は、多くの場合、集約値を引数として参照する規則の計算時に呼び出されます。単一セルの集約は、タイトルのみのビューの計算にも使用されます。

デフォルト値は TRUE です。

NetRecvBlockingWaitLimitSecondsこのパラメーターを使用すると、クライアントから次の要求が送信されるのをサーバーが待機するときの時間を一連の短い待ち時間に分割できます。このパラメーターは、1 回の長い待ち時間を変更して複数の短い待ち時間にするので、必要に応じてスレッドをキャンセルできます。


このパラメーターは、デフォルトで有効になっています。

デフォルトでは、サーバーは入力を長期間待機できます。そのため、スレッドが長期間保持されたり、他の問題が生じたりする可能性があります。

このパラメーターは、Cognos TM1 サーバーが短時間の待機を繰り返すように指示し、サーバーがスレッドをキャンセルしたり、一時停止したりできるようにします。ゼロ (デフォルト) を設定すると、長時間待機する従来の動作が使用されます。



NetRecvMaxClientIOWaitWithinAPIsSeconds処理全体にわたる一連の API に関するデータの最初のパケットの到着から応答が送信されるまでの時間内にクライアントが入出力を行う最大時間を指定します。


このパラメーターは、API 要求を開始した後、適切なタイミングで入出力を処理するようクライアントに要求します。このパラメーターは、非活動になってもソケット・エラーにならない接続や、クライアントのハングなどの可能性を生じる接続に備えて設計されています。

デフォルト値は 0 で、この場合、時間制限はありません。

NIST_SP800_131A_MODESP800-131A 暗号化規格に準拠してサーバーを運用することを指定します。


SP800-131 の暗号化を適用した場合、署名証明書は、米国連邦情報・技術局 (NIST)

Special Publication SP800-131 で定義されている規格に準拠している必要があります。この規格では、最小鍵サイズは 2048 ビット、署名アルゴリズムは SHA-224

以上を使用する RSA でなければなりません。

SP800-131 の準拠性をオフにする場合は、tm1s.cfg ファイルに以下の行を追加してください。

NIST_SP800_131A_MODE=False

デフォルト値: True

ODBCLibraryPathUNIX 上の ODBC インターフェース・ライブラリー (.so ファイル) の名前と場所を指定します。

パラメーターの型: オプション (UNIX で ODBC をサポートする場合は必須)、静的

このパラメーターは、UNIX、Linux、または AIX 上で稼働する TM1 のみに適用されます。

tm1s.cfg ファイルに、以下の行を追加します。

ODBCLibraryPath= location/file

location/file をライブラリーの絶対パスとファイル名に置き換えてください。

例:

ODBCLibraryPath=/usr/local/lib/unixODBC/lib/libodbc.so


OracleErrorForceRowStatusこのパラメーターは、IBM Cognos TM1 TurboIntegrator プロセスと Oracle ODBC

データ・ソースの間の正しい相互作用を確認するために使用します。


このパラメーターのフォーマットを以下に示します。

OracleErrorForceRowStatus=x

x は以下のいずれかの値に置き換えてください。

0 Planning Analytics は接続先の Oracle のバージョンを自動検出します。

1 Planning Analytics は他のドライバーと同じ方法で Oracle に対する接続を処理します。

2 Planning Analytics は Oracle に接続し、SQLUSMALLINT の代わりにSQLULEN を使用します。

デフォルトは 0 です。

PasswordMinimumLengthサーバーにアクセスするクライアントのパスワードの最小長を指定します。


例えば、パスワードの最小長が 8 文字の場合は PasswordMinimumLength=8 と設定します。

注: このパラメーターが適用されるのは、このパラメーターを設定した後に設定または変更されたパスワードのみです。 PasswordMinimumLength で制限する文字長に満たない、変更されていない古いパスワードには影響はありません。

PasswordSourceユーザーが入力したパスワードと保存されているパスワードを比較します。


Cognos TM1 (デフォルト): ユーザーが入力したパスワードを Cognos TM1 データベース内のパスワードと比較します。

LDAP: ユーザーが入力したパスワードを LDAP サーバーに格納されているパスワードと比較します。

PerfMonIsActiveこのパラメーターを使用すると、TM1 のパフォーマンス・カウンターに対する更新のオンとオフを切り替えることができます。



パフォーマンス・カウンターは、TM1 PerfMon ユーティリティーまたは Microsoft

Windows パフォーマンス・モニターを使用して表示できます。詳しくは、「TM1

Operations」の『TM1 パフォーマンス・カウンターの使用』を参照してください。

TM1 でパフォーマンス・カウンターをキャプチャーすると、負荷の高いマルチユーザー・ワークロード (アクティブ・ユーザーが 100 以上のもの) がある場合にパフォーマンスに影響することがあります。パフォーマンスが問題になる場合、このパラメーターを使用して、パフォーマンス・カウンターに対する更新をオフにしてください。

PerfMonIsActive=F

デフォルト値は T です。

PerformanceMonitorOnサーバーが起動したときに、}Stats コントロール・キューブへのデータ記録処理を自動的に開始します。

コントロール・キューブには、システム・パフォーマンスを監視するための統計が含まれます。コントロール・キューブについて詳しくは、「IBM Cognos TM1

Operations」の『コントロール・キューブ』を参照してください。


例えば、パフォーマンス・モニターを有効にするには PerformanceMonitorOn=T と設定します。パフォーマンス・モニターを無効にするには PerformanceMonitorOn=F

と設定します。

PersistentFeedersフィーダー付きキューブの再ロードにかかる時間を短縮するには、PersistentFeeders

設定パラメーターを true (T) に設定して、計算されたフィーダーを .feeders ファイルに格納します。

サーバーのロード時間が 5 分を超えるインストール済み環境では、おそらく、このパラメーターを使用してパフォーマンスを改善できます。


このパラメーターが T に設定されている場合、サーバーは永続フィーダー・ファイルを見つけると、保存されているフィーダーをロードするため、通常、それらのフィーダーの再計算にかかる時間が短縮されます。データを保存したり規則を編集したりすると、フィーダーが保存されます。明示的にフィーダーを保存することはありません。

複雑なフィーダー計算を多数使用しているインストール済み環境では、フィーダーを保存してからサーバー起動時にそれらを再ロードすることでパフォーマンスを改善できます。単純なフィーダーの場合は、ディスクからフィーダーをロードするほうがフィーダーを再計算するよりも時間がかかりますが、ほとんどのインストール済み環境では効果があります。


永続フィーダー機能を使用しても、ディスク上のシステム・サイズが増加するだけです。メモリー・サイズは、このパラメーターを使用しても影響を受けません。

PersistentFeeders=T

詳しくは、「IBM Cognos TM1 Operations」の『永続フィーダーの使用』を参照してください。

PortNumber同じコンピューター上で実行される複数のサーバーを区別するために使用するサーバー・ポート番号を設定します。

1 つのコンピューターに複数の IBM Cognos TM1 サーバーがインストールされている場合は、サーバーごとに一意なポート番号を使用する必要があります。


Cognos TM1 サーバーをインストールするときのデフォルトのポート番号は 12345

です。有効なポート番号は 5001 から 49151 です。

Tm1s.cfg ファイルに PortNumber パラメーターがない場合、 Cognos TM1 サーバーはポート 5000 を使います。ローカルの Cognos TM1 サーバーはポート 5000 を使います。クライアント・メッセージに使用するポートも一意のポート番号でなければなりません。 ClientMessagePortNumber パラメーターを使用する場合、このポートはデフォルトでは 5001 に設定されます。

PreallocatedMemory.BeforeLoadメモリーの事前割り振りをサーバー・ロードの前に実行するか、サーバー・ロードと並行して実行するかを指定します。



PreallocatedMemory.BeforeLoad=T (有効) の場合は、サーバー・ロードの前にメモリーの事前割り振りが実行されます。この設定を無効にすると、サーバー・ロード・プロセスと並行して事前割り振りが実行されます。全体的なサーバー・ロード時間の短縮の程度は、オペレーティング・システムの割り振り速度やサーバー・ロード・ロジックのメモリー消費速度によって異なります。TM1 サーバー管理者は、使用環境にとって最適な結果が得られるように、メモリー事前割り振り設定を変更できます。

PreallocatedMemory.Sizeプールに入れる TM1 サーバー・メモリーの事前割り振りを起動します。



割り振るメモリーの量は、MB (メガバイト) 単位で指定します。


PreallocatedMemory.ThreadNumberマルチスレッド・キューブ・ロードの事前割り振りメモリーで使用するスレッドの数を指定します。



PrivilegeGenerationOptimizationTM1 サーバーがセキュリティー・コントロール・キューブからセキュリティー権限を生成する場合は、そのキューブのすべてのセルが読み出されます。

セキュリティー・コントロール・キューブのデータの密度が低い場合は、不要な処理が実行されるため、ロード時間が長くなります。セキュリティー・キューブのデータの密度が低くなる例として、定義したセキュリティー設定よりもデフォルトのセキュリティー設定の割合が非常に大きい場合などがあります。


このような問題に対処するには、次の PrivilegeGenerationOptimization パラメーターを Tm1s.cfg ファイルに追加します。

PrivilegeGenerationOptimization=T

このパラメーターを T に設定すると、Cognos TM1 サーバーはセキュリティー・キューブからデータを持つセルのみを読み取ります。セキュリティー・キューブのデータの密度が低い場合は、これによって Cognos TM1 サーバーのロード時間が大幅に短縮されます。

注: セキュリティー設定のデータを規則によって読み込む場合にこのパラメーターを使用するには、セキュリティー・キューブにデータを読み込む規則のためのフィーダーを作成する必要があります。セキュリティーの設定は文字列として格納されるため、セキュリティー・キューブにデータを読み込む規則には、FeedStrings 関数が含まれている必要があります。

ProgressMessageこのパラメーターは、ビュー計算が長時間かかる場合に、ユーザーがその計算を中止できるかどうかを指定します。

ユーザーが、長時間の計算が必要なビュー (通常は、高度に集約されたビューかまたは規則が複雑なビュー) を開くと、IBM Cognos TM1 は処理の進捗状況を監視します。 ProgressMessage=T に設定されていると、「ビューの構築を中止」をユーザーが実行できるダイアログ・ボックスが開きます。


ユーザーが「ビューの構築を中止」をクリックすると、クライアント上のビューは破棄されますが、ビューの計算はサーバー上で続行されます。場合によっては、これによりサーバーが占有されることがあります。


v ProgressMessage=F の場合、「ビューの構築を中止」オプションは表示されないため、長時間かかる操作をユーザーは中止できません。このように設定しておくと、バージョン 9.1 SP3 から 9.4 の場合に、サーバーの動作が停滞する可能性を排除できます。

v ProgressMessage=T に設定されているか、または Tm1s.cfg ファイルにパラメーターが存在しない場合は、長時間かかるビュー計算の実行中に「ビューの構築を中止」オプションが表示されるため、ユーザーは必要に応じて処理を中止できます。バージョン 9.4 以降では、ユーザーは ClientMessagePortNumber を使用して一意のポート番号を割り当てることができます。この追加ポートを使用すると、この進捗状況メッセージを 2 次ポートで通信できるため、予備スレッドを占有せずにサーバー処理を継続できます。

注: サーバーの占有を避けるために、Cognos TM1 9.1 SP3 から 9.4 では、サーバーのインストール時に ProgressMessage=F が Tm1s.cfg ファイルに挿入されます。Cognos TM1 9.4 からは、ClientMessagePortNumber で割り当てられた 2 次ポート経由で進捗状況メッセージを通信できるため、Cognos TM1 9.4 以降では、ProgressMessage=T がデフォルトで設定されています。

ProportionSpreadToZeroCellsすべてのリーフ・セルに値ゼロが入っている場合に、エラーを生成することなく、集約からの比例配分を実行できます。

この場合、ProportionSpreadToZeroCells パラメーターが有効になっていると、Cognos

TM1 は空のセルに対して等配分を適用します。この機能は、デフォルトで有効になっています。


ProportionSpreadToZeroCells が有効な場合の動作

デフォルトでこのパラメーターと機能は有効になります。これにより、すべてのリーフ・セルがゼロの場合に集約に対して比例配分を実行するときに、エラーなしで配分操作を行えるようになります。このシナリオでは、Cognos TM1 は型付きエントリーを「P###」から「LS*###」に変換し、等配分として配分を適用します。

このパラメーターが有効で、かついずれかのリーフ・セルにデータが存在する場合、比例配分の実行時の動作は、以前の Cognos TM1 のバージョンと同じです。

このパラメーターは、デフォルトでオンになっており、有効にする必要はありません。ただし、このパラメーターを明示的に設定する場合、Tm1s.cfg 設定ファイルで次のように ProportionSpreadToZeroCells パラメーターを T (true) に設定してください。

ProportionSpreadToZeroCells=T

ProportionSpreadToZeroCells が無効な場合の動作

このパラメーターを F (false) に設定すると、この機能は無効になります。以下の比例配分操作のいずれかを実行しようとするとエラーが表示されます。


v TM1 Contributor において、集約対象となるすべてのリーフ・セルの値がゼロである集約セルに数値を入力する。

v TM1 Contributor および他の TM1 クライアントにおいて、集約対象となるすべてのリーフ・セルの値がゼロのときに、「P###」のような配分コードと数字をセルに入力する、または右クリックで表示されるメニューか TM1 メニュー (TM1

Perspectives のみ) から比例配分にアクセスして比例配分操作を実行する。

これらの操作により TM1 サーバーで比例配分を実行できますが、すべてのリーフ・セルがゼロのために操作は失敗します。

この機能を無効にするには、Tm1s.cfg 設定ファイルで次のようにProportionSpreadToZeroCells パラメーターを F (false) に設定してください。

ProportionSpreadToZeroCells=F

PullInvalidationSubsetサブセットの作成、削除、またはディスクからのロードを行うときにディメンションで R ロック (読み取りロック) を要求しないようにして、メタデータ・ロックを減らします。


デフォルト値: T (有効)

ユーザーがログインすると、システムはユーザーの未登録のサブセットをディスクからロードします。同時に、ディメンションを編集する TurboIntegrator プロセスは、そのプロセス期間中、ディメンションで IX (書き込み意図) ロックを保持します。前のリリースの場合、あるいはこのパラメーターを F (無効) に設定した場合、長時間実行される TurboIntegrator プロセスの全期間中、ログインがブロックされる可能性があります。 TM1 ロック・タイプには、相互の互換性がありません。

RawStoreDirectoryデータ・ディレクトリー以外のディレクトリーでロギングを行う場合に、監査ログ用の一時的な未処理ログ・ファイルの場所を指定します。


このパラメーターが入力されていない場合、デフォルトでは、未処理の監査ログ・ファイルは DataBaseDirectory パラメーターで指定されたディレクトリーに保存されます。

他の監査ログ・パラメーターの詳細については、 345ページの『AuditLogMaxFileSize』、 346ページの『AuditLogMaxQueryMemory』、 346ページの『AuditLogOn』、および 346ページの『AuditLogUpdateInterval』を参照してください。


ReceiveProgressResponseTimeoutSecsReceiveProgressResponseTimeoutSecs パラメーターは、長期待機中にキャンセル操作が行われた場合に、クライアント接続を切断してリソースを解放するようサーバーを設定します。


Cognos TM1 サーバーがクライアントに対して長時間の操作を行っているとき、定期的な「進捗状況」メッセージが Cognos TM1 クライアント・アプリケーションに送られます。このメッセージに対して、クライアントは、ユーザーが「キャンセル」ボタンを押したかどうかを示す情報で応答し、押されていた場合は長時間かかる操作が打ち切られます。この応答は、クライアント・アプリケーション内のネットワーク・コードで自動的に生成されるため、ユーザーの介在はありません。サーバーは、進捗状況メッセージを送信すると、クライアント・アプリケーションからの応答を待機します。サーバーが待機しているときも、クライアントのスレッドはCognos TM1 サーバー上にリソース・ロックを保持し続けることになるため、別のユーザーが、同じリソース・ロックが必要な他のサーバー要求を実行することはできません。

特定の状況 (特に、Cognos TM1 クライアントを Citrix 環境で実行する場合) では、クライアント・アプリケーションからの応答が Cognos TM1 サーバーに戻ることがないため、サーバーは無期限に待機することになります。その結果、システムのロックアップが発生します (クライアントのスレッドが保持するリソース・ロックが解放されません)。

ReceiveProgressResponseTimeoutSecs パラメーターを使用すると、このような状況をサーバーで検出し、クライアント接続を切断してリソースを解放するようにサーバーを設定できます。パラメーターを有効な間隔 (秒単位) に設定すると、その指定間隔の間にサーバーがクライアント・アプリケーションの応答を検出できなければ、サーバー・プロセスは、クライアント接続を終了して、リソース・ロックを解放します。

例えば、ReceiveProgressResponseTimeoutSecs=20 に設定されている場合に、サーバーから送信された進捗状況メッセージに対して 20 秒以内にクライアント・アプリケーションが応答しなければ、クライアント接続は打ち切られます。この場合も、応答を生成するためのユーザー・アクションは必要ありません。応答は、クライアント・アプリケーションによって自動的に生成されるため、応答が 20 秒以内に届かない場合は、クライアントまたは使用するネットワークに重大な問題が生じていることを意味します。

ReceiveProgressResponseTimeoutSecs は、Tm1s.cfg のオプションのパラメーターです。このパラメーターが Tm1s.cfg ファイルに記述されていない場合は、 Cognos

TM1 サーバーからの進捗状況メッセージにクライアントが応答しなくても、プロセスは打ち切られません。

Cognos TM1 (バージョン 9.4 以降) のインストール済み環境によっては、キャンセル・メッセージに使用するスレッドが別途 ClientMessagePortNumber によって定義され、スレッドが占有されません。 ClientMessagePortNumber が使用可能な場合、ReceiveProgressResponseTimeoutSecs は使用されません。


RulesOverwriteCellsOnLoadサーバーのロード時に、規則算出されたデータのセルが上書きされないようにします。


キューブのフィーダー処理の間に、セルの規則がある場合、キューブの値が消去されることがあります。消去されたセルを含むキューブが保存されると、値が失われ、アクションがキューブに作用しなくなります。ただし、規則を編集しても、その後にキューブを変更しないと、キューブはディスクに保存されません。この場合、規則を実行したときに、実際のセルの値が消去される可能性があります。

規則を編集した後にゼロにリセットするアクションが起こらないようにするため、RulesOverwriteCellsOnLoad パラメーターを使用できます。

規則を変更する際に、その規則がさまざまな編集により、データを含むいくつかのセルを規則算出する可能性がある場合、RulesOverwriteCellsOnLoad=F を設定ファイルに追加します。

このパラメーターを true に設定するか、またはパラメーターが存在しない場合、サーバーがロードするたびに、規則算出されたセルはゼロにリセットされます。その後、セルが規則算出されないように規則が変更されたとしても、それらのセルのデータ値は失われます。

デフォルトでは、このパラメーターは設定ファイルに存在しないか、True に設定されています。

RulesOverwriteCellsOnLoad=F

RunningInBackgroundRunningInBackground=T という行を tm1s.cfg に追加すると、UNIX IBM Cognos

TM1 サーバーがバックグラウンド・モードで実行されます。


startup_tm1s.sh スクリプトや shutdown_tm1s.sh スクリプトを使用して TM1 サーバーを開始したり停止したりする場合は、RunningInBackground=T を設定します。

SaveTimeサーバー・データの自動保存を実行する日時を設定し、それ以降、毎日同じ時刻にキューブを保存します。通常のシャットダウンと同様に、SaveTime の処理でも、ログ・ファイルの名前が変更され、新しいログ・ファイルが開かれ、保存後も引き続き実行されます。


SaveTime パラメーターは、Cognos TM1 サーバーを Windows のサービスとして実行している場合には使用できません。

SaveTime パラメーターの書式は dd:hh:mm で、それぞれの意味は次のとおりです。


v dd は、システムがデータの自動保存を開始するまでの本日からの日数。例えば、00 は本日を表し、01 は明日を表します。

v hh:mm は 24 時間形式の時刻。

SecurityPackageName統合ログオンを使用するように IBM Cognos TM1 サーバーを設定する場合は、Microsoft Windows のユーザー名とパスワードを認証するセキュリティー・パッケージを SecurityPackageName パラメーターで定義します。



v Kerberos

v NTLM

v Negotiate

TM1 をローカルで実行する場合を除き、Kerberos を使用してください。ローカルで実行する場合は、Negotiate または NTLM を使用してください。 Negotiate は、認証に関係するいずれかのシステムで Kerberos を使用できない場合を除き、Kerberos を選択します。

統合ログオンを含むすべてのログイン・セキュリティー・モードの詳細については、 263ページの『統合ログオン』を参照してください。

ServerCAMURICognos Authentication Manager (CAM) に接続するために IBM Cognos TM1 サーバーが使用する内部ディスパッチャーの URI を指定します。

URI は次の書式で指定します。

http[s]://fully-qualified host IP address:port/p2pd/servlet/dispatch


例:

https://vottbies005.ent.ad.cognos.com:9443/p2pd/servlet/dispatch

CAM 認証のために、この設定には、Cognos Analytics 証明書を作成した対象のサーバーの完全修飾名を指定する必要があります。

証明書の発行先のサーバーを決めるには、次のようにします。

1. ブラウザーに Cognos Analytics ディスパッチャーへの SSL URI を入力します。

2. tm1s.cfg 内の ServerCAMURI の設定を、そのサーバーの完全修飾名で更新します。

例:

ServerCAMURI=https://vottbies005.ent.ad.cognos.com:9443/p2pd/servlet/dispatch.


CAM SSL を実行できるように Cognos TM1 アプリケーション・サーバーを設定するには、以下のようにします。

1. Cognos Configuration で以下のように設定されていることを確認します。

v 「修飾パスの強制」を False に設定します。

v 「相互認証を使用」を True に設定します。

2. 保存時に証明書を受け入れます。

ServerCAMURIRetryAttemptstm1s.cfg ファイル内の次の ServerCAMURI エントリーに進む前に試行する回数を指定します。


このパラメーターは、IBM Cognos TM1 で Cognos Analytics セキュリティーを使用していて、 tm1s.cfg ファイルに複数のディスパッチャーを定義している場合に適用されます。ディスパッチャーを定義するには、ServerCAMURI パラメーターを使用します。

例えば、tm1s.cfg ファイル内で 3 つの ServerCAMURI パラメーターを指定し、ServerCAMURIRetryAttempts=7 を指定しているとします。

ServerCAMURI=http://server1:9300/p2pd/servlet/dispatchServerCAMURI=http://server2:9300/p2pd/servlet/dispatchServerCAMURI=http://server3:9300/p2pd/servlet/dispatchServerCAMURIRetryAttempts=7

1 つ目のディスパッチャー (http://server1:9300/p2pd/servlet/dispatch) が使用され、7

回試行されます。応答しない場合は、2 つ目が使用され、7 回試行されます。応答しない場合は、3 つ目のディスパッチャーが 7 回試行されます。 3 つ目が応答しない場合、ログインは失敗します。


ServerLogging統合ログオンに関連付けられた IBM Cognos TM1 サーバーのセキュリティー・アクティビティーの詳細ログを生成します。


ログ・ファイルは、Tm1server.log という名前で Cognos TM1 サーバーのデータ・ディレクトリーに保存されます。 ServerLogging パラメーターが役立つのは、統合ログオンを使用するように Cognos TM1 サーバーが設定されている場合のみです。

Tm1s.cfg の ServerLogging を T に設定します。また、ServerLogging=T が設定されている場合は、ロガー設定ファイルの tm1s-log.properties の中の対応するパラメーターを編集して Cognos TM1 サーバー・メッセージ・ログ・ファイルのtm1server.log の名前を変更する必要があります。

注: このパラメーターを動的に (TM1 サーバーを再始動せずに) 変更すると、新しいクライアント・セッションのみログ記録が行われます。


ServerNameIBM Cognos TM1 サーバーの名前を設定します。このパラメーターを指定しない場合、 Cognos TM1 によってサーバーには Local という名前が指定され、ローカル・サーバーとして扱われます。


ServicePrincipalNameTM1 Web で統合ログオンと制約付き委任を使用する場合のサービス・プリンシパル名 (SPN) を指定します。


次の形式を使用して、パラメーターを Tm1s.cfg ファイルに追加します。

ServicePrincipalName=SPN

ここで設定する値は、Microsoft コマンド行ツール setspn.exe を使用して Active

Directory ドメイン・コントローラーのドメイン・アカウントにマップされたサービス名とも一致しなければなりません。

例えば、以下のように setspn.exe を使用して SPN を追加した場合:

setspn -a FPM/TM1 WbSvr_Account

ServicePrincipalName パラメーターを以下のように設定する必要があります:

ServicePrincipalName=FPM/TM1

制約付き委任と SPN 設定について詳しくは、Microsoft の Web サイトで『Kerberos Technical Supplement for Windows』というトピックを検索してください。

SkipLoadingAliasesSkipLoadingAliases は、別名のロードを省略することで、サーバーのロードとビューの更新にかかる時間を短縮します。


このパラメーターがご使用の Cognos TM1 システムに適用可能かどうかは、カスタマー・サポートに問い合わせてください。


v T - 別名をスキップ

v F - 別名をロード

SkipSSLCAMHostCheckSSL 証明書 ID の確認プロセスが省略可能かどうかを示します。

デフォルトは False です。



重要: このパラメーターを True に設定するのは、デモンストレーション目的で一般的な証明書を使用する場合のみにしてください。

SpreadingPrecisionSpreadingPrecision パラメーターを使用すると、配分計算でのエラーの許容誤差範囲を増減することができます。


コンピューター上での浮動小数点の計算は、完全に正確ではありません。コンピューターで非常に小さな数値を計算する場合は、誤差の許容範囲が計算に適用されます。コンピューターで一連の数値を加算したときに、その合計値が目標値に近く、誤差の許容範囲内にある場合、合計値は正確であるとみなされます。

特定の Cognos TM1 計算の許容誤差範囲は、SpreadingPrecision パラメーターで制御されます。デフォルト値は、SpreadingPrecision=1e-8 です。この値は、次のような配分処理のシナリオで使用されます。

v 集約セルからの配分処理。

v 集約値に保持が適用されたリーフ・セルでの配分処理。

集約からの配分処理

集約セルからの比例データ配分を実行すると、Cognos TM1 によって範囲内の各セルに数値が書き込まれ、合計が集計されて集約が再計算されます。次に、集約内のすべてのセルの合計が、配分を行う際に指定した元の値と比較されます。この合計値は、n レベルの要素または集約セル自体に適用される規則が原因で、目標値と異なる場合があります。

規則が原因となって、結果として生じる値が希望する配分値と一致しない場合には、エラーが生成されて、配分操作は行われません。

SpreadingPrecision=1e-8 に設定されている場合、 Cognos TM1 で計算された集約の合計値は、目標値の 0.000001% 以内 (精度は 99.999999%) であることが必要です。そうでない場合は、Cognos TM1 によってエラーが表示されます。US$1,000,000 の集約配分の誤差が US$0.01 より大きな場合は、エラーが発生します。

SpreadingPrecision パラメーターを使用すると、これらの種類の計算での許容誤差範囲を増減できます。

次に示すのは、SpreadingPrecision パラメーターの有効な値の例です。

v SpreadingPrecision=1e-4





配分と集約の保持

SpreadingPrecision パラメーターは以下の条件下でも有効です。

v 値を配分するいくつかのリーフ・セルが 1 つの集約に集計される場合

v 保持が適用された集約の場合

例えば、Q1 に Jan、Feb、および Mar という値を持つ次のような集約があるとします。

Q1- に集約の保持が適用されている場合に、値を Jan と Feb に配分すると、Cognos TM1 は次の処理を実行します。

v Jan と Feb に配分が適用される。

v Mar が調整される。

v 3 つの n レベル要素が合計される。

v n レベル要素の合計値と Q1 の値が比較される。

合計値が正確で、SpreadingPrecision パラメーターで指定された許容誤差範囲内にある場合は、配分が成功します。合計値が、SpreadingPrecision パラメーターで指定された許容誤差範囲外にある場合は、Cognos TM1 はエラーを生成します。

SpreadErrorInTIDiscardsAllChangesSpreadErrorInTIDiscardsAllChanges が有効な場合に、実行中の TurboIntegrator スクリプトの中で配分エラーが発生した場合は、その TurboIntegrator スクリプトによって行われたすべての変更が廃棄されます。


SpreadErrorInTIDiscardsAllChanges を有効にするには、tm1s.cfg ファイルに以下の行を追加します。

SpreadErrorInTIDiscardsAllChanges=T


SSLCertAuthorityIBM Cognos TM1 サーバーの認証局ファイルの名前を指定します。このファイルは、TM1 サーバーがインストールされているコンピューター上に存在する必要があります。


TM1 で独自の SSL 証明書を使用している場合、Microsoft 管理コンソールを参照してこの値を判別できます。「証明書」 > 「個人用」 > 「証明書」をクリックします。プリンシパル名が、プロパティー・ウィンドウの「発行者」列に表示されます。

SSLCertificate公開鍵/秘密鍵ペアが入っている、IBM Cognos TM1 サーバーの証明書ファイルの絶対パスを指定します。



SSLCertificateIDIBM Cognos TM1 サーバーの証明書が発行される先のプリンシパルの名前を指定します。


TM1 で独自の SSL 証明書を使用している場合、Microsoft 管理コンソールを参照してこの値を判別できます。「証明書」 > 「個人用」 > 「証明書」をクリックします。プリンシパル名が、プロパティー・ウィンドウの「発行先」列に表示されます。

StartupChoresStartupChores は、サーバーの始動時に実行される日課のリストを示す設定パラメーターです。


日課をユーザー・ログオンの前の始動時に、またはその他のスケジュールされた日課の実行前に実行するには、このパラメーターを追加し、実行する日課の名前をコロンで区切って指定します。例えば、次のようにします。

StartupChores=ChoreName1:ChoreName2:ChoreName3:ChoreNameN

このパラメーターが指定されていない場合、日課は実行されません。指定した名前が既存の日課と一致しない場合、サーバー・ログにエラーが書き込まれ、実行は次の日課のときに再開されます。

この設定パラメーターの値は、クライアント・アプリケーションから、既存のTM1ObjectPropertyGet 呼び出しを使用して、StartupChores という名前のサーバー・プロパティーとして取得することができます。

これは読み取り専用のプロパティーであるため、設定操作は拒否されます。このプロパティーの値を変更するには、設定ファイルを編集してサーバーを再始動するしかありません。

SubsetElementBreatherCountこのパラメーターは、IBM Cognos TM1 がサブセットのロック動作を処理する方法を管理します。


条件

SubsetElementBreatherCount=-1

サブセットへの他の要求が保留中の場合、Cognos TM1 サーバーはサブセットのロックを解放しません。この設定がデフォルトです。単一ユーザーの表示パフォーマンスを最適化できますが、マルチユーザーの同時実行ができなくなります。


SubsetElementBreatherCount がゼロ (0) より大きい値に設定されている場合、TM1

サーバーは、サブセットへの他の要求が保留中のときにサブセットのロックを解放し、保留中の要求が処理された後にロックを再獲得します。この設定により、複数のユーザーが同じサブセットへのアクセスを試行している場合のパフォーマンス、特にサブセットが 100 を超える要素を含んでいる場合のパフォーマンスが高くなります。

SupportPreTLSv12ClientsTM1 10.2.2 フィックスパック 6 (10.2.2.6) 以降、TM1 のクライアントとサーバーの間のすべての SSL 保護通信に、Transport Layer Security (TLS) 1.2 が使用されます。このパラメーターによって、10.2.2.6 より前のクライアントが 10.2.2.6 以降のTM1 サーバーに接続できるかどうかが決まります。


10.2.2.6 より前のクライアントが 10.2.2.6 (以降の) TM1 サーバーに接続できるようにするには、Tm1s.cfg に次の行を追加します。

SupportPreTLSv12Clients=T

TLS v1.2 より前のクライアントから接続できるように TM1 サーバーを設定した場合、そのようなクライアントとの接続の確立には TLS 1.0 が使用されます。

SupportPreTLSv12Clients が Tm1s.cfg ファイルに存在しない場合、またはSupportPreTLSv12Clients=F である場合、10.2.2.6 より前のクライアントは 10.2.2.6

以降の TM1 サーバーに接続できません。

SvrSSLExportKeyIDCognos IBM TM1 サーバーの証明書を Microsoft Windows の証明書ストアからエクスポートするための識別キーを指定します。


SvrSSLExportKeyID の値は、ほとんどの場合に SSLCertificate の値と同じになります。

SyncUnitSizeネットワーク接続に障害が発生した場合のために、同期処理でチェックポイントを保存する頻度を設定します。


注: SyncUnitSize を使用する場合は、MaximumSynchAttempts パラメーターも設定する必要があります。詳細については、 379ページの『MaximumSynchAttempts』を参照してください。

SyncUnitSize と MaximumSynchAttempts の両方のパラメーターを設定した場合に、同期プロセスがネットワーク接続障害で中断されると、そのプロセスは再接続し、最後のチェックポイント以降の同期を実行しようとします。


このパラメーターを設定するには、プラネット・サーバーの Tm1s.cfg ファイルに次の行を追加します。

SyncUnitSize=n

ここで、n はチェックポイントが保存された後にトランザクション・ログ・ファイル Tm1s.log に書き込まれる同期レコードの数を表します。


最小推奨値は 500 です。

tlsCipherListサポートされる暗号スイートを優先度順に並べたコンマ区切りのリストを指定します。


tlsCipherList を使用して、TM1 システムで許容される暗号スイートを指定します。リストされた暗号スイートは、ネゴシエーションのクライアント側とサーバー側の両方で、リストされた順番に SSL ネゴシエーションに提示されます。クライアントとサーバーのリストされた暗号スイートの少なくとも 1 つが一致している必要があります。

以下の暗号スイートがサポートされています。

v RFC 2246:「The TLS Protocol Version 1.0」 (http://www.ietf.org/rfc/rfc2246.txt)

v RFC 4346:「The Transport Layer Security (TLS) Protocol Version 1.1」(http://www.ietf.org/rfc/rfc4346.txt)

v RFC 5246:「The Transport Layer Security (TLS) Protocol Version 1.2」(http://www.ietf.org/rfc/rfc5246.txt)

v RFC 4492:「Elliptic Curve Cryptography (ECC) Cipher Suites for Transport Layer

Security (TLS)」 (http://www.ietf.org/rfc/rfc4492.txt)

v RFC 5289:「TLS Elliptic Curve Cipher Suites with SHA-256/384 and AES Galois

Counter Mode (GCM)」 (http://www.ietf.org/rfc/rfc5289.txt)

例:

tlsCipherList=TLS_RSA_WITH_AES_128_CBC_SHA,TLS_RSA_WITH_RC4_128_MD5, TLS_RSA_WITH_AES_128_CBC_SHA256

TM1ConnectorforSAPIBM Cognos TM1 Connector for SAP ソフトウェアを使用するには、このパラメーターを T に設定します。


注: この機能は、IBM Cognos TM1 Connector for SAP ソフトウェアを購入したお客様だけが使用できます。このソフトウェアは、以前は、IBM Cognos TM1 ソフトウェアと別個に提供されていました。このソフトウェアの販売は終了しています。


http://www.ietf.org/rfc/rfc2246.txt







前にこの機能を購入していた場合は、tm1s.cfg ファイルに TM1ConnectorforSAP=T

と UseNewConnectorforSAP=T を追加して、ソフトウェアを使用できるようにする必要があります。


UnicodeUpperLowerCaseこの構成パラメーターは、TM1 サーバーが Unicode オブジェクト名を識別および処理するようにして、大文字小文字だけが異なる同一の Unicode オブジェクト名が作成されることを防止します。

パラメーターの型:

v オプション

v 静的

このパラメーター値を変更する場合、TM1 サーバーを再起動して、新しい値を適用してください。

TM1 において、ASCII オブジェクト名はケース・インセンシティブです。要素名の「SALES」は「sales」と同等になります。「SALES」や「sales」に対する参照、さらには「SaLeS」に対する参照も、単一の要素に対する参照と見なされます。同様に、キューブ名の「Projections」は「PROJECTIONS」と同等になります。

しかし、Unicode オブジェクト名はケース・インセンシティブではありません。そのため、1 つのサーバーに、大文字小文字だけが異なる同一の名前の 2 つのオブジェクトが含まれることがあります。例えば、要素の「NEMÈIJA」と「nemèija」が単一のディメンション内に存在して、それぞれが固有の要素と見なされることがあります。

大文字小文字だけが異なる同一の名前の 2 つの Unicode オブジェクト名が作成されないようにするには、パラメーター UnicodeUpperLowerCase=T を TM1s.cfg ファイルに含めます。 UnicodeUpperLowerCase=T の場合、Unicode オブジェクト名はASCII オブジェクト名と同様に扱われ、大/小文字は区別されません。

大文字小文字だけが異なる複数の Unicode オブジェクト名を必要とするアプリケーションを開発した場合、そのような機能を保持するためには、UnicodeUpperLowerCase 構成パラメーターを Tm1s.cfg ファイルに追加しないでください。このパラメーターが Tm1s.cfg 内に存在しない場合 (または F に設定された場合)、TM1 では引き続き Unicode オブジェクト名の大/小文字を区別します。

UseExcelSerialDateTM1 のシリアル日付の代わりに、Microsoft Excel のシリアル日付を使用できるようにします。


UseExcelSerialDate を有効にすると、TM1 規則関数と TurboIntegrator 関数は、シリアル日付の基準の日付として、1960 年 1 月 1 日の代わりに 1900 年 1 月 1 日を使用します。


以前、TM1 規則関数は、1960 年 1 月 1 日から経過した日数を表すシリアル日付を使用していました。これは、1900 年 1 月 1 日から経過した日数を表すMicrosoft Excel のシリアル日付と矛盾します。 TM1 の数字フォーマットの機能は、キューブ・データが TM1 のシリアル日付ではなく、Microsoft Excel のシリアル日付を使用することを想定しています。

日付の変換の必要性を回避するには、UseExcelSerialDate を有効にして、規則関数が従来の TM1 の日付ではなく、Microsoft Excel の日付を使用するようにします。

UseExcelSerialDate=T


例

この例で、シリアル日付の問題を確認できます。

次の規則は、シリアル日付として 2015 年 5 月 26 日を返します。

[]= N:(DAYNO(’2015-05-26’));

フォーマットされていない結果は 20234 で、1960 年 1 月 1 日以降 20234 日が経過したことを示します。規則関数は、従来の TM1 シリアル日付を使用しています。

TM1 の表示形式を mmmm dd, yyyy などの日付形式に設定すると、結果は 1955 年5 月 25 日になります。これは、1955 年 5 月 25 日が、1900 年 1 月 1 日から20234 日経過した日であるからです。値は Microsoft Excel シリアル日付として解釈されています。

UseExcelSerialDate=T を tm1s.cfg ファイルに追加し、TM1 サーバーを再始動すると、予期した結果である 2015 年 5 月 26 日が TM1 で表示されます。規則関数が、1900 年 1 月 1 日をシリアル日付の基準の日付として使用するようになりました。

UseLocalCopiesforPublicDynamicSubsets可能な場合には、公開動的サブセットのローカル・コピーを使用して、パフォーマンスを改善し、ロッキングを減らせるようにします。


デフォルトの場合や、このパラメーターが tm1s.cfg ファイル内にない場合、UseLocalCopiesforPublicDynamicSubsets は有効です。動的サブセットの以前の保存方式を復元するには、このパラメーターを F に設定してください。

UseNewConnectorforSAPIBM Cognos TM1 Connector for SAP ソフトウェアを使用するには、このパラメーターを T に設定します。



注: この機能は、IBM Cognos TM1 Connector for SAP ソフトウェアを購入したお客様だけが使用できます。このソフトウェアは、以前は、IBM Cognos TM1 ソフトウェアと別個に提供されていました。このソフトウェアの販売は終了しています。

以前にこの機能を購入した場合は、tm1s.cfg ファイルに UseNewConnectorforSAP=T

と TM1ConnectorforSAP=T を追加して、ソフトウェアを使用できるようにする必要があります。


UserDefinedCalculationsIBM Cognos TM1(r) Perspectives および Architect のサブセット・エディターでユーザー定義の集約を作成するための「集計」と「サブセットの挿入」オプションを有効にし、TM1(r) Web クライアントの「カスタム集約を作成」ボタンを有効にします。


UserDefinedCalculations はデフォルトで有効です。

TM1 Perspectives、Architect、および TM1 Web クライアントのユーザー定義集約を無効にするには、tm1s.cfg に次の行を追加します。

UserDefinedCalculations=F

注: F に設定すると、ユーザーには以下が表示されます。

v Architect と Perspectives では、ユーザーが「集計」または「サブセットの挿入」オプションをクリックすると、ユーザー定義計算が有効ではないことを示すエラー・メッセージが表示されます。

v TM1 Web では、「カスタム集約を作成」ボタンがグレーアウトされます。

UseSQLFetch UseSQLFetchScroll UseSQLExtendedFetchこれらのパラメーターは、特定のフェッチ・コールを使用するように IBM Cognos

TM1 に指示します。


ODBC データ・ソースの情報を抽出する TurboIntegrator プロセスを実行する場合、Cognos TM1 は、可能な限り最も効率的な SQL フェッチ・コールの使用を試みます。 Cognos TM1 は、次のどの SQL Fetch コールを使用してデータを抽出するかを ODBC ドライバーに問い合わせて決定します。

SQLFetch()、ODBC 1 の関数

SQLExtendedFetch()、ODBC 2 の関数

SQLFetchScroll()、ODBC 3 の関数

これらのパラメーターはすべて動的です。


Cognos TM1 が ODBC ドライバーに問い合わせても応答が得られない場合、Tm1s.cfg ファイルで次のいずれかのパラメーターが T に設定されていなければ、Cognos TM1 プロセスでエラーが発生します。

UseSQLFetch

UseSQLFetchScroll

UseSQLExtendedFetch

これらのパラメーターは、特定のフェッチ・コールを使用するように Cognos TM1

に指示します。 Tm1s.cfg で指定するコールが、アクセスする ODBC ドライバーに対して適切であることを確認してください。また、Tm1s.cfg で指定できるのは、上記のパラメーターのいずれか 1 つのみです。

例えば、SQLExtendedFetch() コールを使用して ODBC ソースのデータを抽出するよう Cognos TM1 サーバーに指示するには、次の行を Tm1s.cfg に追加します。

UseSQLExtendedFetch=T

UseSSLIBM Cognos TM1 サーバーで SSL を有効または無効にします。


このパラメーターは、デフォルトで有効です。

SSL を無効にするには、UseSSL=F を設定します。

UseSSL=T に設定する場合は、SSL の実装を管理する他の tm1s.cfg パラメーターもいくつか設定する必要があります。そのパラメーターの詳細については、 299ページの『データ転送セキュリティーのための SSL の使用』を参照してください。


UseStargateForRules規則がスターゲイト・ビューを使用するかどうかを指定します。


規則が計算値を参照する際に、メモリーに格納されているスターゲイト・ビューにその値があれば、必ずその値を取得します (デフォルトの動作)。規則に対してスターゲイト・ビューを使用すると、ほとんどの場合はパフォーマンスが大幅に向上します。計算値はメモリーから取得する方が、サーバーに計算を要求して取得するより効率的です。

前もって決定することが不可能ではないとしても困難であり、試行錯誤によってのみ決定できるような特殊な場合は、サーバーに値を要求して取得するより、スターゲイト・ビューから計算値を取得する方が、実際には時間がかかることがあります。そのような場合は、次の行を Tm1s.cfg に追加し、Cognos TM1 規則に対して常にサーバーから計算値を取得するよう指示して、パフォーマンスを向上させます。


UseStargateForRules=F

UseStargateForRules パラメーターを追加する場合は、事前にカスタマー・サポートに問い合わせてください。

ViewConsolidationOptimizationIBM Cognos TM1 サーバーでビュー集約の最適化を有効または無効にします。


このパラメーターを使用すると、集約要素の計算のパフォーマンスが向上します。デフォルトでは、Cognos TM1 サーバーで ViewConsolidationOptimization は有効です。

ビューの集約を最適化すると、行軸または列軸のいずれかでリーフ要素コンポーネントを使用する集約値が保存されます。例えば、Jan、Feb、および Mar という値のディメンション構造 Year と 1 Quarter があるとします。

行または列のいずれかのサブセットが Jan 要素を使用する場合、1 Quarter と Year

の両方の集約が計算され、後で参照できるように保存されます。これにより、パフォーマンスは改善されますが、ビューに必要なメモリー量は増加します。

ビュー集約の最適化を無効にするには、次の行を Tm1s.cfg に追加します。

ViewConsolidationOptimization=F

ViewConsolidationOptimizationMethodこのパラメーターは、IBM Cognos TM1 サーバーで ViewConsolidationOptimization

パラメーターが有効な場合に、ビュー集約の最適化を実現するために使用する方法を定義します。


ViewConsolidationOptimization で集約を計算し保存するために使用できる方法には、ARRAY と TREE の 2 種類があります。 ARRAY の方法では、集約が一時的な配列に保存されます。 TREE の方法では、集約がツリーに保存されます。

ほとんどの状況では、ViewConsolidationOptimizationMethod を TREE に設定してください。通常の操作では、この設定で最善のパフォーマンスが得られます。

まれなケースですが、TREE メソッドを使用するとパフォーマンスが低下することがあります。その場合は、パラメーターを ARRAY に設定してみてください。例えば、一般的ではありませんが、多数の集約に集計するリーフ要素が少数のみあるようなディメンションの場合は、ViewConsolidationOptimizationMethod を ARRAY に設定してください。

このパラメーターを設定するには、次のいずれかの該当する行を設定ファイルに追加します。

ViewConsolidationOptimizationMethod=TREE

または


ViewConsolidationOptimizationMethod=ARRAY

ViewConsolidationOptimizationMethod が Tm1s.cfg ファイルに明示的に設定されていない場合、デフォルトでは ARRAY メソッドが使われます。これにより、ViewConsolidationOptimizationMethod パラメーターが導入される前の TM1 の以前のバージョンとの整合性が維持されます。

ZeroWeightOptimization重みが 0 の集約メンバーが集約セル値や集約関数の計算に影響を与えるかどうかを指定します。集約関数には、ConsolidatedCount、ConsolidatedMax、ConsolidatedMin、ConsolidatedAvg、ConsolidatedCount、ConsolidatedCountUnique があります。


true に設定すると、重みがゼロのメンバーは集約リストから除去されるので、集約セルや集約関数の値を計算する際に処理されません。これはデフォルトの動作です。

false に設定すると、重みがゼロのメンバーは集約リストに含まれるので、計算に影響を与えます。



付録 B. Tm1p.ini クライアント設定ファイル

Tm1p.ini ファイルは、IBM Cognos TM1 のクライアント (Cognos TM1

Perspectives、Cognos TM1 Architect、および Cognos TM1 クライアント) の環境情報を指定します。

Tm1p.ini ファイルの場所IBM Cognos TM1 は、Tm1p.ini ファイルのシステム・デフォルトのバージョンをインストールし、このファイルのユーザー固有のバージョンも作成します。

Tm1p.ini ファイルの 2 つのバージョンは別々の場所に格納されます。

システム・デフォルトの Tm1p.ini ファイル

システム・デフォルト・バージョンの Tm1p.ini が存在することにより、特定の 1

つのコンピューター上で複数のユーザーが Cognos TM1 を使用できるようになります。 Tm1p.ini ファイルは、ユーザーがコンピューター上の Cognos TM1 を初めて始動する時点で存在している必要があります。システム・デフォルトのバージョンに含まれるパラメーターによって、各ユーザーに対する Cognos TM1 クライアントの初期始動時の動作が決まるからです。

システム・デフォルト・バージョンの Tm1p.ini ファイルのインストール場所は、使用している Microsoft Windows のバージョンに応じて異なります。

Microsoft Windows XP または Windows Server 2003 の場合:

システム・デフォルト・バージョンの Tm1p.ini ファイルの場所は次のとおりです。

%ALLUSERSPROFILE%¥Application Data¥Applix¥TM1¥

例:

C:¥Documents and Settings¥All Users¥Application


ヒント: %ALLUSERSPROFILE% 環境変数の値を判別するには、コマンド行からecho %ALLUSERSPROFILE% を実行してください。

Microsoft Windows 7 および Windows Server 2008 の場合:

Microsoft Windows の新しいバージョンでは、システム・デフォルトのTm1p.ini ファイルの場所は、%ProgramData% の設定によって決まります。

%ProgramData%¥Applix¥TM1¥

例:

C:¥ProgramData¥Applix¥TM1¥Tm1p.ini

ヒント: 正確な場所を参照するには、コマンド行から echo %ProgramData%

を実行してください。


ユーザー固有の Tm1p.ini ファイル

ユーザーがコンピューター上で Cognos TM1 を始動すると、そのユーザーの%USERPROFILE% の場所に、ユーザー固有の Tm1p.ini ファイルのコピーが作成されます。

ユーザー固有の Tm1p.ini コピーにはそのユーザーに対するすべてのパラメーター設定値と変更点が収容され、このファイルにより Cognos TM1 クライアントのその後のすべてのユーザー・セッションでの Cognos TM1 クライアントの動作が決まります。

こうした設定の多くは、「Cognos TM1 のオプション」ダイアログ・ボックスにも格納されています。これらの設定を変更するには、「TM1 のオプション」ダイアログ・ボックスを使用するか、Tm1p.ini ファイルを編集します。ここでは、Tm1p.ini

のパラメーターと、「TM1 のオプション」について説明します。

%USERPROFILE% の正確な場所は、使用している Microsoft Windows のバージョンに応じて異なります。

ヒント: 正確な場所を参照するには、コマンド行から echo %USERPROFILE% を実行してください。

Microsoft Windows XP または Windows Server 2003 の場合:

ユーザー固有のバージョンの Tm1p.ini ファイルの場所は次のとおりです。

%USERPROFILE%¥user name¥Application Data¥Applix¥TM1¥

例:

C:¥Documents and Settings¥user name¥Application


Microsoft Windows 7 および Windows Server 2008 の場合:

Microsoft Windows の新しいバージョンでは、Tm1p.ini ファイルのユーザー固有のコピーは次の場所にあります。

%USERPROFILE%¥user name¥AppData¥Roaming¥Applix¥TM1¥

例:

C:¥Users¥ADMIN¥AppData¥Roaming¥Applix¥TM1¥Tm1p.ini

Tm1p.ini ファイルのパラメーターTm1p.ini ファイルでは以下のパラメーターを使用できます。

AdminHost管理サーバーが実行されている管理ホスト名を表示します。「IBM Cognos TM1 のオプション」では、「ログオン・パラメーター管理ホスト」を使用します。

AdminSvrSSLCertAuthorityIBM Cognos TM1 管理サーバーの証明書を発行した認証局ファイルの絶対パス。

「Cognos TM1 のオプション」では、「認証局」を使用します。


AdminSvrSSLCertIDIBM Cognos TM1 管理サーバーの証明書発行先のプリンシパルの名前。

注: このパラメーターの値は、IBM Cognos Configuration で設定した Cognos TM1

管理サーバーの SSLCertificateIDparameter と同じでなければなりません。

このパラメーターは「Cognos TM1 のオプション」ウィンドウ>「証明書 ID」フィールドからクライアントに対して設定することもできます。

AdminSvrSSLCertRevListIBM Cognos TM1 管理サーバーの証明書を発行した認証局により発行された証明書失効ファイルの絶対パス。

証明書失効ファイルは、失効した証明書がある場合にのみ存在します。「Cognos

TM1 のオプション」では、「証明書呼び出しリスト」を使用します。

AdminSvrSSLExportKeyIDIBM Cognos TM1 管理サーバーの証明書を発行するときに最初に使用された認証局証明書を証明書ストアからエクスポートする際に使用する識別キー。


「Cognos TM1 のオプション」では、「証明書 ID のエクスポート」を使用します。

AdvancedRulesEditor使用する規則エディターの種類を示します。

高度な規則エディターは、インターフェースが機能強化されています。

v T - 高度な規則エディターを使用します。

v F (デフォルト) - 基本規則エディターを使用します。

AllowImportCamClientsこのパラメーターが必要なのは、CAM 認証を使用するように IBM Cognos TM1 を設定する場合のみです。

CAM から Cognos TM1 に管理ユーザーをインポートする場合は、このパラメーターを T に設定する必要があります。

Cognos TM1 サーバーが CAM 認証を使用するように設定されていない場合には、このパラメーターを F に設定するか、Tm1p.ini ファイルに記述しないでください。

詳しくは、 283ページの『Cognos セキュリティーを使用するための TM1 サーバーの設定』を参照してください。

付録 B. Tm1p.ini クライアント設定ファイル 413

BrowseDisplayReadsRightToLeftCube Viewer でのデータの向きを示します。

データは、右から左または左から右に表示できます。

v T - データの向きを右から左にします。

v F (デフォルト) - データの向きを左から右にします。

ClassicSliceModeCube Viewer の「スライス」オプションで、クラシック・スライスか動的スライスのどちらを生成するかを示します。

v T -「スライス」オプションでクラシック・スライスを生成します。

v F -「スライス」オプションで動的スライスを生成します。

CognosGatewayURIこのパラメーターが必要なのは、IBM Cognos セキュリティー (CAM) 認証を使用するように IBM Cognos TM1 を設定する場合のみです。

このパラメーターには、IBM Cognos ゲートウェイの URI を設定する必要があります。この URI は、http[s]:/<ホスト>/cognosx/cgi-bin/cognos.cgi またはhttp[s]:/<ホスト>/ibmcognos/cgi-bin/cognos.cgi の形式で指定します。

例えば、http://win2003test/ibmcognos/cgi-bin/cognos.cgi のようになります。

CAM 認証を使用するように Cognos TM1 サーバーが設定されていない場合は、このパラメーターを Tm1p.ini ファイルに記述しないでください。

詳しくは、 283ページの『Cognos セキュリティーを使用するための TM1 サーバーの設定』を参照してください。

ConnectLocalAtStartupIBM Cognos TM1 Architect または IBM Cognos TM1 Perspectives を始動時にローカル・サーバーに自動的に接続するかどうかを示します。

v T (デフォルト) - Cognos TM1 は始動時にローカル・サーバーに接続します。

v F - Cognos TM1 は始動時にローカル・サーバーに接続しません。

DataBaseDirectoryローカル・サーバーのデータ・ディレクトリーへの絶対パスを使用します。

データ・ディレクトリーが複数ある場合は、ディレクトリー名をセミコロンで区切って指定できます。

DimensionDownloadMaxSizeディメンション内の要素数のしきい値。この値を超えると、ディメンションはダウンロードされ、IBM Cognos TM1 クライアントにキャッシュされます。

DimensionDownloadMaxSize パラメーターは、古いバージョンの TM1 に適用されます。このパラメーターは、10.2.2 には適用されません。


大きいディメンションを扱う場合にパフォーマンスを改善するには、DimensionDownloadMaxSize を追加して、大きいディメンションがクライアント上にキャッシュされるようにします。

DisableAdminHostEntryTm1p.ini ファイル内で DisableAdminHostEntry パラメーターを有効にすると、「TM1 のオプション」ダイアログ・ボックスの「管理ホスト」設定をユーザーが変更することができなくなります。

DisableAdminHostEntry=T の場合、「TM1 のオプション」ダイアログ・ボックスの「管理ホスト」オプションが無効になります。これにより、ユーザーは「管理ホスト」設定を変更したり、環境内の他の TM1 サーバーを認識したりすることができなくなります。 DisableAdminHostEntry=F の場合、またはこのパラメーターがTm1p.ini ファイルに存在しない場合は、「管理ホスト」設定を編集することができます。

DisableAdminHostEntry は、ユーザー固有のバージョンの Tm1p.ini ファイルに設定する必要があります。 DisableAdminHostEntry パラメーターがシステム・デフォルトの Tm1p.ini ファイルに追加された場合、ユーザーが Architect またはPerspectives を初めて始動したときに、パラメーターおよび設定がユーザー固有のバージョンの Tm1p.ini にコピーされます。

ユーザーが Architect または Perspectives を始動し、システム・デフォルトのバージョンの Tm1p.ini に DisableAdminHostEntry パラメーターが設定されていない場合、ユーザー固有のバージョンの Tm1p.ini に DisableAdminHostEntry=F が追加されます。

DisableWritebackOnDisconnectTm1p.ini ファイル内で DisableWritebackOnDisconnect が有効になっていると、アクティブなサーバー接続を使用できる場合に限り、TM1 サーバーに書き込む TM1

数式が入ったワークシート・セルはアクティブのままでサーバーに書き込まれます。

しかし、このパラメーターが有効になっているときに TM1 Perspectives クライアントが TM1 サーバーに接続されていないと、サーバーに書き込む TM1 数式が入ったセルは保護されなくなります。この場合、TM1 サーバーに書き込む TM1 数式が入ったワークシート・セルに値を入力すると、TM1 数式が上書きされます。

サーバーに書き込む TM1 数式には、DBR、DBRW、DBRA、DBS、DBSA、DBSS、およびDBSW があります。

さらに、アクティブなサーバー接続がない場合に DisableWritebackOnDisconnect=T

を設定すると、TM1 数式が入ったワークシートでの複数レベルの元に戻す/やり直す操作や、複数のコピー・アンド・ペースト操作も復元されます。

DisableWritebackOnDisconnect は DisableWritebackOnTM1Formulas と同じような効果があります。これらの 2 つのパラメーターの重要な違いは、


DisableWritebackOnDisconnect はアクティブなサーバー接続がない場合のみ適用されますが、DisableWritebackOnTM1Formulas はすべての場合に適用されることです。

DisableWritebackOnTM1FormulasTm1p.ini ファイル内で DisableWritebackOnTM1Formula パラメーターを有効にすると、TM1 ワークシート数式が入ったセルに値を入力したときに、TM1 サーバーへの書き戻しを回避することができます。

Tm1p.ini ファイル内で DisableWritebackOnTM1Formula=T と設定した場合でも、TM1 サーバーに書き込む TM1 数式が入ったワークシート・セルに値を入力すると、TM1 数式が上書きされます。

サーバーに書き込む TM1 数式には、DBR、DBRW、DBRA、DBS、DBSA、DBSS、およびDBSW があります。

DisableWritebackOnTM1Formula=T と設定した場合は、TM1 数式が入ったワークシートでの複数レベルの元に戻す/やり直す操作、および複数のコピー・アンド・ペースト操作も復元されます。

DisplayApplications起動時に「アプリケーション」グループをサーバー・エクスプローラーに表示するかどうかを示します。

v T -「アプリケーション」グループがサーバー・エクスプローラーに表示されます。

v F -「アプリケーション」グループはサーバー・エクスプローラーに表示されません。

DisplayChores起動時に「日課」グループをサーバー・エクスプローラーに表示するかどうかを示します。

v T -「日課」グループがサーバー・エクスプローラーに表示されます。

v F -「日課」グループはサーバー・エクスプローラーに表示されません。

DisplayControlCubes起動時に「コントロール・キューブ」グループをサーバー・エクスプローラーに表示するかどうかを示します。

v T -「ControlCube」グループがサーバー・エクスプローラーに表示されます。

v F -「ControlCube」グループはサーバー・エクスプローラーに表示されません。

DisplayCubes起動時に「キューブ」グループをサーバー・エクスプローラーに表示するかどうかを示します。

v T -「キューブ」グループがサーバー・エクスプローラーに表示されます。

v F -「キューブ」グループはサーバー・エクスプローラーに表示されません。


DisplayDimensions起動時に「ディメンション」グループをサーバー・エクスプローラーに表示するかどうかを示します。

v T -「ディメンション」グループがサーバー・エクスプローラーに表示されます。

v F -「ディメンション」グループはサーバー・エクスプローラーに表示されません。

DisplayExplorerPropertiesWindow起動時に「プロパティー」ウィンドウをサーバー・エクスプローラーに表示するかどうかを示します。

v T -「プロパティー」ウィンドウが表示されます。

v F (デフォルト) -「プロパティー」ウィンドウは表示されません。

DisplayProcesses起動時に「プロセス」グループをサーバー・エクスプローラーに表示するかどうかを示します。

v T -「プロセス」グループがサーバー・エクスプローラーに表示されます。

v F -「プロセス」グループはサーバー・エクスプローラーに表示されません。

DisplayReplications起動時に「複製」グループをサーバー・エクスプローラーに表示するかどうかを示します。

v T -「複製」グループがサーバー・エクスプローラーに表示されます。

v F -「複製」グループはサーバー・エクスプローラーに表示されません。

ExpandRowHeaderWidth行ヘッダーを自動的に拡張して、最大長の列エントリーの幅に対応させるかどうかを示します。

v T (デフォルト) - 行ヘッダーが自動的に拡張されます。

v F - 必要に応じて、行ヘッダーを手動で拡張する必要があります。

ExportAdminSvrSSLCertIBM Cognos TM1 管理サーバーの証明書を最初に発行した認証局証明書を、実行時に Microsoft Windows の証明書ストアからエクスポートする場合に、このオプションを選択します。

v T (デフォルト) - 元の証明書が Windows の証明書ストアからエクスポートされます。

v F - 元の証明書はエクスポートされません。

「Cognos TM1 のオプション」では、「証明書ストアを使用」を選択します。

このオプションを選択する場合、「Cognos TM1 のオプション」ダイアログ・ボックスまたは AdminSvrSSLExportKeyID で「証明書 ID のエクスポート」の値も設定する必要があります。


InSpreadsheetBrowserスプレッドシート内ブラウザーまたは Cube Viewer のどちらをデフォルトのブラウザーにするかを示します。

v T - スプレッドシート内ブラウザーがデフォルトのブラウザーです。キューブまたはビューをダブルクリックすると、Excel ドキュメントで開きます。

v F (デフォルト) - Cube Viewer がデフォルトのブラウザーです。キューブまたはビューをダブルクリックすると、Cube Viewer で開きます。

IntegratedLoginIBM Cognos TM1 クライアントが、Cognos TM1 サーバーなどの Cognos TM1 コンポーネントにログオンする際に、統合ログオンまたは標準の Cognos TM1 セキュリティーのどちらを使用するかを示します。

v T - クライアントは統合ログオンを使用します。この場合は、Microsoft Windows

のログオン・ユーザー名とパスワードが、Cognos TM1 サーバーなどのコンポーネントへのアクセスに使用されます。

v F (デフォルト) - クライアントは標準の Cognos TM1 セキュリティーを使用します。この場合は、Cognos TM1 サーバーなどのコンポーネントにログインする際に、ユーザー名とパスワードを明示的に提示する必要があります。

このパラメーターを有効にする前に、Cognos TM1 サーバーに統合ログオンが実装されているかどうかを Cognos TM1 管理者に確認してください。

「Cognos TM1 のオプション」では、「統合ログオン」を使用します。

LanguageIBM Cognos TM1 クライアント・インターフェースで使用する言語を示します。

クライアントはロケールを読み取ろうとし、それに基づいて言語を設定します。サポート対象言語であれば、その言語が使用されます。入力された言語がサポート対象言語と一致しない場合には、英語が使用されます。

デフォルトを指定変更するには、以下のコードを使用して tm1p.ini で Language を明示的に設定します。

言語コード



チェコ語 csy




オランダ語 nld

ドイツ語 deu


フランス語 fra



言語コード

イタリア語 ita

日本語 jpn

カザフ語 kaz

韓国語 kor




ロシア語 rus

スペイン語 esp



タイ語 tha

トルコ語 trk

LocalServerNetworkProtocolローカルの IBM Cognos TM1 サーバーがクライアントとの通信に使用するプロトコルを規定します。有効な設定値は、現在は TCP のみです。

MainWindowLayoutInfoサーバー・エクスプローラー・ウィンドウの寸法と位置座標を生成して、次回のセッションでもサーバー・エクスプローラーの寸法と位置が保持されるようにします。

座標は、サーバー・エクスプローラー・ウィンドウを移動するかそのサイズを変更したときに自動的に生成されます。

PreviousAdminHostsIBM Cognos TM1 オプションの管理ホスト・リストから、最近アクセスした管理ホストを新しいものから 6 つまで表示します。

PreviousDataDirectoriesIBM Cognos TM1 オプション・ウィンドウの「ローカル・サーバーのデータ・ディレクトリー」の一覧に、最近アクセスしたデータ・ディレクトリーを新しいものから 6 つまで表示します。

同じセッションでアクセスされた複数のディレクトリーは、セミコロンで区切られます。アクセスしたセッションが異なるディレクトリーは、コンマで区切られます。

SecurityAssignmentWindowLayoutInfo「クライアント/グループ」ウィンドウの寸法と位置座標を生成して、次回のセッションでも「クライアント/グループ」の寸法と位置が保持されるようにします。


座標は、「クライアント/グループ」ウィンドウを移動するかそのサイズを変更したときに自動的に生成されます。

SentMsgsToServerCountWarningSentMsgsToServerCountWarning パラメーターは、開発目的でのみ使用します。このパラメーターは、デフォルトで F に設定されています。

デフォルトの設定は変更しないでください。

ShowAdminHostChangeWarning管理ホストが変更されたときに警告を表示するかどうかの設定をセッション間で保存。

v T (デフォルト) - 管理ホストが変更されると、警告メッセージが表示されます。

v F - 管理ホストが変更されても、メッセージは表示されません。

ShowAliasAttributeWarning別名属性が変更されたときに警告を表示するかどうかの設定をセッション間で保存。

v T (デフォルト) - 別名属性が変更されると、警告メッセージが表示されます。

v F - 別名属性が変更されても、メッセージは表示されません。

ShowChoresSchedulingWarning日課スケジュールが変更されたときに警告を表示するかどうかの設定をセッション間で保存。

v T (デフォルト) - 日課スケジュールが変更されると、警告メッセージが表示されます。

v F - 日課スケジュールが変更されても、メッセージは表示されません。

ShowCubeReplicationWarningキューブが複製されたときに警告を表示するかどうかの設定をセッション間で保存。

v T (デフォルト) - キューブが複製されると、警告メッセージが表示されます。

v F - キューブが複製されても、メッセージは表示されません。

ShowDimDeleteElementWarningディメンション要素が削除されたときに警告を表示するかどうかの設定をセッション間で保存。

v T (デフォルト) -ディメンション要素が削除されると、警告メッセージが表示されます。

v F -ディメンション要素が削除されても、メッセージは表示されません。

ShowDimensionAccessWarningディメンションがアクセスされたときに警告を表示するかどうかの設定をセッション間で保存。


v T (デフォルト) - ディメンションがアクセスされると、警告メッセージが表示されます。

v F - ディメンションがアクセスされても、メッセージは表示されません。

ShowDynamicSubsetWarning動的サブセットが変更されたときに警告を表示するかどうかの設定をセッション間で保存。

v T (デフォルト) - 動的サブセットが変更されると、警告メッセージが表示されます。

v F - 動的サブセットが変更されても、メッセージは表示されません。

ShowPickOperationWarning「要素の選択」オプションを使用してデータがコピーされたときに警告を表示するかどうかの設定をセッション間で保存。

v T (デフォルト) -「要素の選択」オプションを使用してデータがコピーされると、必ず警告メッセージが表示されます。

v F -「要素の選択」オプションを使用してデータがコピーされても、警告メッセージは表示されません。

ShowProcessUNASCIIWarningASCII データ・ソースが処理されたときに警告を表示するかどうかの設定をセッション間で保存。

v T (デフォルト) - ASCII データ・ソースが処理されると、警告メッセージが表示されます。

v F - ASCII データ・ソースが処理されても、メッセージは表示されません。

ShowProcessUNODBCWarningODBC データ・ソースが処理されたときに警告を表示するかどうかの設定をセッション間で保存。

v T (デフォルト) - ODBC データ・ソースが処理されると、警告メッセージが表示されます。

v F - ODBC データ・ソースが処理されても、メッセージは表示されません。

SliceNewWorkbookCube Viewer からスライスを生成する方法を規定します。

v T - 新しいワークブックにスライスを挿入します。

v F (デフォルト) - 現在のワークブックの新しいシートにスライスを挿入します。

SubsetWindowLayoutInfoサブセット・エディター・ウィンドウの寸法と位置座標を生成して、次回のセッションでもサブセット・エディターの寸法と位置が保持されるようにします。

座標は、サブセット・エディター・ウィンドウを移動するかそのサイズを変更したときに自動的に生成されます。


TM1RebuildDefaultワークシートを開く際にデフォルトで再計算を実行するかどうかを決定します

IBM Cognos TM1 からビューを Microsoft Excel にスライスすると、デフォルトでブック・レベルの名前付き変数 TM1RebuildOption がブックに含められます。これはデフォルトで 1 に設定されます。これにより、ブックのワークシートを開く際に再構築が実行されます (これによってブックの各シートで再計算が強制的に実行されます)。このアクションは、シートにアクティブ・フォームが含まれる場合に必要です。アクティブ・フォームを使って作業をしていない場合、すべてのブックがこのデフォルト動作に従うことは適当でないこともあります。

Cognos TM1 ブックを開くと、すべてのワークシートで再計算が実行されます。このブックは Cognos TM1 Perspectives からスライスした際に作成されたものであり、ブック・レベルの名前付き変数 TM1RebuildOption = 1 が含まれています。

Cognos TM1 9.4.1 以降、デフォルトで、スライスによって作成されるすべての新規ブックにブック・レベルの名前付き変数 TM1RebuildOption=1 が含まれるようになりました。これにより、オープン時にブックが再構築され、すべてのシートで再計算が実行されます。これはアクティブ・フォームでは重要ですが、主に非アクティブ・フォームのワークシートを使って作業をしている場合、この動作は望ましくない場合があります。

スライス時に必ず再構築するというデフォルトがシートで使用されないようにするには、tm1p.ini ファイルの TM1RebuildDefault を T から F に変更します (まだ存在していない場合は TM1RebuildDefault=F を追加します)。 TM1RebuildDefault=F

になっていると、ブックはスライス時にブック・レベルの名前付き変数をTM1RebuildOption=0 に設定します。これは、アクティブ・フォームの導入前のCognos TM1 の動作と同じです。

このオプションを T に設定するか、このオプションが存在しない場合、Cognos

TM1 Perspectives のビューからスライスすると、ブック・レベルの名前付き変数TM1RebuildOption は 1 に設定されます。これにより、オープン時に強制的に再構築が実行されます。このオプションが F の場合、名前付き変数 TM1RebuildOption

は 0 に設定され、再構築は実行されません。レポートによっては (例えばアクティブ・フォーム)、名前付き変数をデフォルトの 0 の代わりに 1 に設定することができます。

新規インストールには、デフォルトで TM1RebuildDefault パラメーターがありません。そのため、TM1RebuildOption=1 でスライスを実行するというデフォルト動作になります。


付録 C. 無人インストールおよび設定のセットアップ

無人インストールおよび設定をセットアップすると、ネットワーク上の複数のコンピューターを通じて同一の設定によるインストールを実行したり、ユーザー用のオプションと設定値を指定することによりインストールと設定のプロセスを自動化したりすることができます。

無人インストールおよび構成をセットアップする前に、システム要件と前提条件がすべて満たされていること、およびサード・パーティー製品がすべてインストールされ、構成されていることを確認してください。

手順1. 転送仕様ファイル (.ats) を設定して、インストール・オプションを指定します。

2. インストール・ツールをサイレント・モードで実行します。

3. 別のコンピューターで設定済みの設定ファイルを使用します。

4. 設定ツールをサイレント・モードで実行します。

無人インストール転送仕様ファイル (.ats) を使用して IBM Cognos コンポーネントをコンピューターにコピーする場合、情報の入力を求めるプロンプトは表示されません。

デフォルトでは、IBM Cognos コンポーネントをインストール・ウィザードでインストールするたびに、選択したオプションが転送仕様ファイルに記録されます。したがって、サンプル・コンピューターにインストール済みの IBM Cognos コンポーネントがある場合は、その際に生成された転送仕様ファイルをテンプレートとして使用して、別のコンピューターに無人インストールを行えます。

コンポーネントのインストールにインストール・ウィザードを使用していない場合は、ディスクにある「response.ats」というデフォルトの転送仕様ファイルを使用できます。response.ats ファイルを使って無人インストールを実行する前に、実際の環境に合わせてファイルの内容を変更する必要があります。

無人インストールが成功したかどうか検査するには、戻り状況を確認することができます。値ゼロ (0) は成功を示し、他のすべての値はエラーの発生を示しています。

無人インストールのセットアップ無人インストールには、次の TM1 製品コードを使用します。

手順

別のコンピューターのインストール環境からの応答ファイルの使用(http://www.ibm.com/support/knowledgecenter/SSEP7J_10.2.2/


http://www.ibm.com/support/knowledgecenter/SSEP7J_10.2.2/com.ibm.swg.ba.cognos.inst_cr_winux.10.2.2.doc/t_c8bi_setupunattendedinstallation.html

com.ibm.swg.ba.cognos.inst_cr_winux.10.2.2.doc/t_c8bi_setupunattendedinstallation.html)

の手順を実行して、TM1 の以下の製品コードを置き換えます。

表 38. 無人インストール用の TM1 製品コード

製品コード製品

TM1APPTIER_APP=1 TM1 データ層

TM1SERVER_APP=1 TM1 サーバー

TM1ADMINSERVER_APP=1 TM1 管理サーバー

TM1TOOLS_APP=1 TM1 ツール

TM1WEBAPPTIER_APP=1 TM1 Web 層

TM1CONTRIBGATEWAY_APP=1 TM1 アプリケーション・ゲートウェイ

TM1CONTRIBSERVICE_APP=1 TM1 アプリケーション・サーバー

TM1WEB_APP=1 TM1 Web

TM1OPERATIONSCONSOLE_APP=1 TM1 Operations Console

TM1CLIENTTIER_APP=1 TM1 リッチ層

TM1PERSPECTIVES_APP=1 TM1 Perspectives

TM1COGNOSINSIGHT_APP=1 Cognos Insight

TM1APIS_APP=1 TM1 API

TM1DEVTIER_APP=1 TM1 リッチ層

TM1ARCHITECT_APP=1 TM1 Architect

TM1PERFMOD_APP=1 TM1 Performance Modeler

TM1SAMPLETIER_APP=1 TM1 サンプル

このファイルの内容は、tm1_location/instlog の場所にある .ats ファイルで見ることができます。

無人設定のセットアップ無人設定を行う準備をする前に、設定するものと同じ IBM Cognos TM1 コンポーネントがすでにインストールされている別のコンピューターから設定をエクスポートする必要があります。次に、IBM Cognos Configuration をサイレント・モードで実行できます。

エクスポートした設定には、ソース・コンピューターにインストールした Cognos

TM1 コンポーネントのプロパティーが含まれています。グローバル設定を変更した場合、ソース・コンピューターのグローバル設定ファイルを、無人設定を実行する予定のコンピューターにもコピーする必要があります。

始める前に

ローカル・コンピューターの構成設定値が、同じコンポーネントがインストールされている別のコンピューターの構成に使用するためにも適切かどうかを確認します。

手順1. IBM Cognos Configuration の「ファイル」メニューから、「名前を付けてエクスポート」をクリックします。


2. 現在の設定を別のフォルダーにエクスポートする場合、「ファイルの場所」ボックスでフォルダーを検索して開きます。

3. 「ファイル名」ボックスに設定ファイルの名前を入力します。


5. エクスポートした設定ファイルを、ソース・コンピューターまたはネットワーク・ロケーションから、無人設定を実行する予定のコンピューターの <TM1 の場所>/configuration ディレクトリーにコピーします。

6. ファイルの名前を cogstartup.xml に変更します。

7. ソース・コンピューターのグローバル設定を変更した場合は、ソース・コンピューターの coglocale.xml ファイルを、無人設定を実行する予定のコンピューターの <TM1 の場所>/configuration ディレクトリーにコピーします。

8. <TM1 の場所>/bin ディレクトリーに移動します。

9. 以下の設定コマンドを入力します。

cogconfig.bat -s

無人設定の実行中に生成されたログ・メッセージを表示するには、<TM1 の場所>/logs ディレクトリーの中の cogconfig_response.csv ファイルを参照してください。

タスクの結果

無人設定が成功したかどうかを確認するには、戻されるステータス値をチェックします。値ゼロ (0) は成功を示し、他のすべての値はエラーの発生を示しています。

Cognos Configuration では、cogstartup.xml ファイルのローカル・コピーで指定されている構成設定値の適用、資格情報の暗号化、デジタル証明書の生成が実行されます。可能な場合は、IBM Cognos のサービスまたはプロセスが開始されます。

無人アンインストールのセットアップ同じコンポーネントがインストールされた複数のコンピューター上のコンポーネントの削除を自動化する場合や、Microsoft X Window がない UNIX 環境またはLinux 環境でコンポーネントを削除する場合は、無人アンインストールを設定します。

手順1. Go to <TM1 の場所>/instlog に移動します。

2. 製品用の転送仕様ファイル (.ats) をテキスト・エディターで開きます。

転送仕様 .ats ファイルのファイル名の形式は ts-<製品コード>-<バージョン>-<yyyymmdd>_<hhmm>.ats です。

TM1 製品コードのリストについては、 423ページの『無人インストールのセットアップ』を参照してください。

1 つの製品について編集が必要な .ats ファイルは 1 個のみです。

3. [Component List] というセクションで、削除するコンポーネントを指定します。

付録 C. 無人インストールおよび設定のセットアップ 425

v コンポーネントを削除する場合は、「1」と入力します。

v インストールしたままにしておくコンポーネントである場合は、0 と入力します。

デフォルトでは、すべてのインストール済みコンポーネントが削除に設定されます。

4. ファイルを保存して閉じます。

5. インストールされている製品ごとにステップ 2 から 4 までを繰り返します。

6. オペレーティング・システムのコマンド行から、<TM1 の場所>/uninstall ディレクトリーに移動します。

7. コマンド・プロンプトで、次のコマンドを入力します。

v Windows の場合

uninst -u -s

v UNIX または Linux の場合

./uninst -u -s

v X Window がない UNIX または Linuxの場合

./uninstnx -u -s


付録 D. 問題のトラブルシューティング

トラブルシューティングは、問題解決のための系統的なアプローチです。トラブルシューティングの目的は、ある部分が予期したとおりに機能しない理由および問題を解決する方法を判別することです。

以下の質問に答えることにより、IBM Cognos 製品で発生している問題の発生源を特定するのに役立てることができます。

1. 設定はサポートされていますか?

2. 問題が発生したときにどんな作業を行っていましたか?

v 計画

v 製品のインストール

v 製品のアップグレードまたはマイグレーション

v システム管理タスクまたは設定タスクの実行

v アプリケーション開発

v 製品の起動または配布

v 製品の実行

v 関連するハードウェアまたはソフトウェア製品のインストールまたは変更

v 製品またはシステムのリカバリーまたは再始動

v 問題の診断、または診断援助機能の実行

3. 発生した問題は IBM Cognos ソフトウェアに関連したものですか? その場合、どんなエラー・メッセージやエラー・コードが出されましたか?

4. 問題を再現して、単純なエラーではないことを確認できますか?

5. ファイルの場所、ディレクトリー、パス、アクセス権限を確認しましたか?

6. リリース・ノート、Technote を含むすべての関連資料を参照しましたか?

7. ご使用のコンピューター環境を最近、何らかの形で変更したことが問題の原因となっている可能性について検討しましたか?

8. これらの質問と答えによって解決策が導き出されない場合、追加情報または診断データの収集が必要になる可能性があります。このデータは、IBM 技術サポート担当者が効率的にトラブルシューティングを行い、問題の解決を支援するために必要とされます。

IBM Knowledge CenterIBM Knowledge Center には、各リリースの資料が用意されています。この資料は、製品のヘルプ・メニューからも利用できます。

資料は、各国語版の資料も含め、 Web 上にある IBM Knowledge Center

(http://www.ibm.com/support/knowledgecenter) で入手できます。

最新の既知の問題や Authorized Program Analysis Report (APAR) へのリンクは、リリース・ノートにあります。


http://www.ibm.com/support/knowledgecenter/

Support PortalIBM Support Portal では、IBM のすべてのシステム、ソフトウェア、およびサービスのすべての技術サポート・ツールおよび情報を一元的にまとめて表示します。

この IBM Support Portal という 1 つの場所からすべての IBM サポート・リソースにアクセスできます。問題の予防とより迅速な問題解決のために必要な情報とリソースに重点を置くようにページを調整することができます。.

IBM サポート・ポータルからご使用の製品を選択して、必要な Cognos コンテンツを見つけてください。

情報の収集IBM サポートに連絡する前に、問題を解決するために必要な診断データ (システム情報、症状、ログ・ファイル、トレースなど) を収集する必要があります。この情報を収集することで、トラブルシューティング・プロセスに精通することができ、時間の節約になります。

どのデータを収集するかに関する情報は、MustGather technotes のかたちで入手できます。

サービス・リクエストサービス・リクエストは、問題管理報告書 (PMR) とも呼ばれます。IBM® ソフトウェア技術サポートに診断情報を送信する方法はいくつかあります。

PMR を開いたり、技術サポートと情報を交換したりする場合は、Enhanced

Customer Data Repository を参照してください。PMR は、サービス・リクエスト(PMR) ツールを使用するか、または情報の交換ページで詳述されている、その他のサポートされている方法によって、直接送信することもできます。

Support Assistant LiteIBM Support Assistant は、問題判別に役立つワークベンチを提供する補足ソフトウェア・オファリングです。

IBM は現在、IBM Support Assistant Lite をサポートしています。このユーティリティーは、製品固有のデータ収集を自動化します。このユーティリティーは、時折発生する IBM 製品の運用上の問題を診断して復旧するために、IBM サポートのアナリストが必要とするデータ・ファイルを特定します。

Fix CentralFix Central は、ソフトウェア、ハードウェア、オペレーティング・システム用のフィックスや更新を提供します。

プルダウン・メニューを使用して、Fix Central の製品フィックスにナビゲートします。Fix Central help を表示することもできます。


http://www.ibm.com/support/entry/portal/

http://www-01.ibm.com/software/data/support/cognos_mustgather.html

http://www-01.ibm.com/software/support/exchangeinfo.html

http://www-01.ibm.com/software/support/exchangeinfo.html

http://www-947.ibm.com/support/entry/portal/Open_service_request/Software/Information_Management/Cognos_Business_Intelligence_and_Financial_Performance_Management

http://www-947.ibm.com/support/entry/portal/Open_service_request/Software/Information_Management/Cognos_Business_Intelligence_and_Financial_Performance_Management


http://www-933.ibm.com/support/fixcentral/

https://www-945.ibm.com/support/fixcentral/help?page=start

IBM Planning Analytics コミュニティーIBM Planning Analytics コミュニティーを利用して、アイデアやソリューションを仲間と共有できます。

IBM Planning Analytics コミュニティー (https://www.ibm.com/communities/analytics/

planning-analytics/) にアクセスしてください。

Software Support RSS feedsIBM Software Support RSS feeds は、Web サイトに追加された新しいコンテンツをモニターするための、高速で使いやすい軽量のフォーマットです。

RSS リーダーまたはブラウザー・プラグインをダウンロードした後、IBM Software

Support RSS feeds から IBM 製品フィードを登録することができます。

IBM 製品の検索とナビゲートIBM 製品情報へのアクセスを IBM Support Portal で構成できるようになりました。これにより、すべてのリンクを 1 つのページで確認できます。

付録 D. 問題のトラブルシューティング 429

https://www.ibm.com/communities/analytics/planning-analytics/

https://www.ibm.com/communities/analytics/planning-analytics/

https://www-01.ibm.com/software/support/rss/

https://www-01.ibm.com/software/support/rss/

特記事項

本書は IBM が世界各国で提供する製品およびサービスについて作成したものです。

この資料の他の言語版を IBM から入手できる場合があります。ただし、これを入手するには、本製品または当該言語版製品を所有している必要がある場合があります。

本書に記載の製品、サービス、または機能が日本においては提供されていない場合があります。日本で利用可能な製品、サービス、および機能については、日本 IBM

の営業担当員にお尋ねください。本書で IBM 製品、プログラム、またはサービスに言及していても、その IBM 製品、プログラム、またはサービスのみが使用可能であることを意味するものではありません。これらに代えて、IBM の知的所有権を侵害することのない、機能的に同等の製品、プログラム、またはサービスを使用することができます。ただし、IBM 以外の製品とプログラムの操作またはサービスの評価および検証は、お客様の責任で行っていただきます。本書には、お客様が購入されたプログラムまたはライセンス資格に含まれない製品、サービス、または機能に関する説明が含まれる場合があります。

IBM は、本書に記載されている内容に関して特許権 (特許出願中のものを含む) を保有している場合があります。本書の提供は、お客様にこれらの特許権について実施権を許諾することを意味するものではありません。実施権についてのお問い合わせは、書面にて下記宛先にお送りください。

〒103-8510

東京都中央区日本橋箱崎町19番21号日本アイ・ビー・エム株式会社法務・知的財産知的財産権ライセンス渉外

以下の保証は、国または地域の法律に沿わない場合は、適用されません。 IBM およびその直接または間接の子会社は、本書を特定物として現存するままの状態で提供し、商品性の保証、特定目的適合性の保証および法律上の瑕疵担保責任を含むすべての明示もしくは黙示の保証責任を負わないものとします。国または地域によっては、法律の強行規定により、保証責任の制限が禁じられる場合、強行規定の制限を受けるものとします。

この情報には、技術的に不適切な記述や誤植を含む場合があります。本書は定期的に見直され、必要な変更は本書の次版に組み込まれます。 IBM は予告なしに、随時、この文書に記載されている製品またはプログラムに対して、改良または変更を行うことがあります。

本書において IBM 以外の Web サイトに言及している場合がありますが、便宜のため記載しただけであり、決してそれらの Web サイトを推奨するものではありません。それらの Web サイトにある資料は、この IBM 製品の資料の一部ではありません。それらの Web サイトは、お客様の責任でご使用ください。


IBM は、お客様が提供するいかなる情報も、お客様に対してなんら義務も負うことのない、自ら適切と信ずる方法で、使用もしくは配布することができるものとします。

本プログラムのライセンス保持者で、(i) 独自に作成したプログラムとその他のプログラム (本プログラムを含む) との間での情報交換、および (ii) 交換された情報の相互利用を可能にすることを目的として、本プログラムに関する情報を必要とする方は、下記に連絡してください。

IBM Software Group

Attention: Licensing

3755 Riverside Dr.

Ottawa, ON

K1V 1B7

Canada

本プログラムに関する上記の情報は、適切な使用条件の下で使用することができますが、有償の場合もあります。

本書で説明されているライセンス・プログラムまたはその他のライセンス資料は、IBM 所定のプログラム契約の契約条項、IBM プログラムのご使用条件、またはそれと同等の条項に基づいて、IBM より提供されます。

この文書に含まれるいかなるパフォーマンス・データも、管理環境下で決定されたものです。そのため、他の操作環境で得られた結果は、異なる可能性があります。一部の測定が、開発レベルのシステムで行われた可能性がありますが、その測定値が、一般に利用可能なシステムのものと同じである保証はありません。さらに、一部の測定値が、推定値である可能性があります。実際の結果は、異なる可能性があります。お客様は、お客様の特定の環境に適したデータを確かめる必要があります。

IBM 以外の製品に関する情報は、その製品の供給者、出版物、もしくはその他の公に利用可能なソースから入手したものです。IBM は、それらの製品のテストは行っておりません。したがって、他社製品に関する実行性、互換性、またはその他の要求については確証できません。 IBM 以外の製品の性能に関する質問は、それらの製品の供給者にお願いします。

IBM の将来の方向または意向に関する記述については、予告なしに変更または撤回される場合があり、単に目標を示しているものです。

本書には、日常の業務処理で用いられるデータや報告書の例が含まれています。より具体性を与えるために、それらの例には、個人、企業、ブランド、あるいは製品などの名前が含まれている場合があります。これらの名称はすべて架空のものであり、名称や住所が類似する企業が実在しているとしても、それは偶然にすぎません。

この情報をソフトコピーでご覧になっている場合は、写真やカラーの図表は表示されない場合があります。

この「ソフトウェア・オファリング」は、Cookie もしくはその他のテクノロジーを使用して個人情報を収集することはありません。


商標

IBM、IBM ロゴおよび ibm.com は、世界の多くの国で登録された International

Business Machines Corporation の商標です。他の製品名およびサービス名等は、それぞれ IBM または各社の商標である場合があります。現時点での IBM の商標リストについては、著作権および商標情報の Web サイト (www.ibm.com/legal/

copytrade.shtml) をご覧ください。

他の会社名、製品名およびサービス名等はそれぞれ各社の商標です。

v Adobe、Adobe ロゴ、PostScript、PostScript ロゴは、Adobe Systems Incorporated

の米国およびその他の国における登録商標または商標です。

v Microsoft、Windows、Windows NT および Windows ロゴは、Microsoft

Corporation の米国およびその他の国における商標です。

v Linux は、Linus Torvalds の米国およびその他の国における登録商標です。

v UNIX は The Open Group の米国およびその他の国における登録商標です。

v Java およびすべての Java 関連の商標およびロゴは Oracle やその関連会社の米国およびその他の国における商標または登録商標です。

Microsoft 製品のスクリーン・ショットは、Microsoft の許可を得て使用しています。

特記事項 433

http://www.ibm.com/legal/copytrade.shtml

索引日本語, 数字, 英字, 特殊文字の順に配列されています。なお, 濁音と半濁音は清音と同等に扱われています。

［ア行］アーキテクチャー 23

アクセス権権限、データ・ディレクトリー 28

Planning Analytics for Microsoft Excel をインストールするための要件 217

Planning Analytics for Microsoft Excel を使用するための要件 218

新しいクライアント 289

アップグレード 107

アップグレード計画 46

アップグレード後のデータの復元 60, 334

アップグレードの概要 45

アドイン、登録 219

アンインストール 328, 329, 425

IBM Cognos Analysis for Microsoft Excel 215

Planning Analytics for Microsoft Excel 218

暗号化 301

暗号スイート 403

以前のバージョンの削除 54

以前のバージョンのバックアップ 53

インストール 16, 245

転送仕様ファイル (.ats) を使用する 423

無人インストール 423

COM アドイン 221

IBM Cognos Analytics 423

IBM Planning Analytics for Microsoft Excel for Microsoft

Excel 211

Microsoft .NET Framework 212

インストールされているサンプル・データベース 232

インストールのタイプ 3

インストールの変更 327

インストールの保守 325

インストール・ウィザード 217

インストール・シナリオ 75

引用符 342

英語以外のオペレーティング・システム.NET Framework のトラブルシューティング 222

エクスポート最大シート数 142

エラー・メッセージエラー: Exception from HRESULT:<ロケーション> 224

結果が Excel の行または列の制限を超えている 223

このアイテムを展開できない 223, 224

数式に変換すると値が表示されない 220

エラー・メッセージ (続き)

COI-ERR-2002 ブロック・タイプが正しくありません 225

COI-ERR-2005 このバージョンの Microsoft Office はサポートされていません 225

COI-ERR-2006 この Microsoft Office 製品はサポートされていません 225

COI-ERR-2008 リソースから取得できません 226

COI-ERR-2009 Microsoft Excel が編集モードのため、この操作を実行できません 226

COI-ERR-2010 名前 {0} が正しくありません。名前に引用符 (") とアポストロフィ (') の両方を使用することはできません。 226

COI-ERR-2016 ワークシートが保護されています。IBM

Cognos のスタイルのデータを設定できません 227

COR-ERR-2004 軸の仕様が正しくありません 227

COR-ERR-2007 リソースからの取得中にエラーが発生しました 227

COR-ERR-2009 名前の数式が正しくありません 228

COR-ERR-2010 数式が正しくありません 228

COR-ERR-2011 範囲が正しくありません: クロス集計グラフまたはリストの正しい範囲を入力してください 228

COR-ERR-2013 閲覧ビューを数式ベースに変換できません228

COR-ERR-2014 Excel ワークシートの制限のため、結果の最後が切り取られることがあります 228

COR-ERR-2015 現在の閲覧ビューをワークシート上のこの場所に表示できません 228

COR-ERR-2016 パッケージを取得できません 228

COR-ERR-2017 現在の選択内容ではデータは返されませんでした 229

Excel ブックが不意に終了する 222

IBM Cognos Office から発行されたブックを Microsoft

Office Excel で開くことができない 221

IBM Cognos Office で信頼関係を生成できない 224

Microsoft Office で IBM Cognos Office を初期化できない221

オプションの Tm1s.cfg パラメーター 276, 371

AllowReadOnlyChore Reschedule 343

AllowSeparateNandCRules 344

AllRuleCalcStargateOptimization 344

ApplyMaximumViewSizeToEntireTransaction 345

AuditLogMaxFileSize 345

AuditLogMaxQueryMemory 346

AuditLogOn 346

AuditLogUpdateInterval 346

AutomaticallyAddCubeDependencies 347

CacheFriendlyMalloc 347

CalculationThresholdForStorage 347

CAMUseSSL 348

CheckFeedersMaximumCells 348

ClientCAMURI 349


オプションの Tm1s.cfg パラメーター (続き)

ClientExportSSLSvrCert 349

ClientExportSSLSvrKeyID 349

ClientMessagePortNumber 350

ClientPingCAMPassport 349

ClientPropertiesSyncInterval 350

ClientVersionMaximum 350

ClientVersionMinimum 351

ClientVersionPrecision 352

CognosMDX.AggregateByAncestorRef 353

CognosMDX.CellCacheEnable 353

CognosMDX.PrefilterWithPXJ 353

CognosMDX.SimpleCellsUseOPTSDK 354

CognosMDX.UseProviderCrossJoinThreshold 354

CognosTM1InterfacePath 355

CreateNewCAMClients 355

DefaultMeasuresDimension (OLAP では必須の場合あり) 356

DisableMemoryCache 356

DisableSandboxing 356

Display_Info_DBType_R8 357

DistributedPlanningOutputDir 358

DownTime 358

ExcelWebPublishEnabled 359

FIPSOperationMode 361

ForceReevaluationOfFeedersForFedCellsOnDataChange 361

HTTPPortNumber 362

HTTPSessionTimeoutMinutes 363

IdleConnectionTimeOutSeconds 363

IndexStoreDirectory 363

IntegratedSecurityMode 363

IPAddressV4 365

IPAddressV6 366

IPV6 366

JavaClassPath 367

JavaJVMArgs 367

JavaJVMPath 367

JobQueueMaxWaitTime 368

JobQueueThreadPoolSize 369

JobQueueThreadSleepTime 369

JobQueuing 368

keyfile 369

keylabel 369

keystashfile 370

Language 370

LDAPHost 276, 371

LDAPPasswordKeyFile 276, 371

LDAPPort 277, 371

LDAPSearchBase 277, 372

LDAPSearchField 277, 372

LDAPSkipSSLCertVerification 277, 372

LDAPSkipSSLCRLVerification 278, 372

LDAPUseServerAccount 278, 373

LDAPVerifyCertServerName 278, 373

LDAPVerifyServerSSLCert 279, 374

LDAPWellKnownUserName 280, 375

LoadPrivateSubsetsOnStartup 375


LockPagesInMemory 375

LoggingDirectory 376

LogReleaseLineCount 376

MagnitudeDifferenceToBeZero 376

MaskUserNameInServerTools 377

MaximumCubeLoadThreads 377

MaximumLoginAttempts 378

MaximumMemoryForSubsetUndo 378

MaximumSynchAttempts 380

MaximumTILockObject 380

MaximumUserSandboxSize 381

MaximumViewSize 381

MDXSelectCalculatedMemberInputs 381

MessageCompression 383

MTCubeLoad 383

MTCubeLoad.MinFileSize 384

MTCubeLoad.UseBookmarkFiles 384

MTCubeLoad.Weight 385

MTFeeders 379

MTFeeders.AtomicWeight 379

MTFeeders.AtStartup 379

MTQ 385

MTQ.CTreeRedundancyReducer 386

MTQ.OperationProgressCheckSkipLoopSize 386

MTQ.SingleCellConsolidation 386

NetRecvBlockingWaitLimitSeconds 386

NetRecvMaxClientIOWaitWithinAPIsSeconds 387

NIST_SP800_131A_MODE 387

ODBCLibraryPath 387

OracleErrorForceRowStatus 388

PasswordMinimumLength 388

PasswordSource 276, 388

PerfMonIsActive 388

PerformanceMonitorOn 389

PersistentFeeders 389

PortNumber 390

PreallocatedMemory.BeforeLoad 390

PreallocatedMemory.Size 390

PreallocatedMemory.ThreadNumber 391

PrivilegeGenerationOptimization 391

ProgressMessage 391

ProportionSpreadToZeroCells 392

PullInvalidationSubset 393

RawStoreDirectory 393

ReceiveProgressResponseTimeoutSecs 394

RulesOverwriteCellsOnLoad 395

RunningInBackground 395

SaveTime 395

SecurityPackageName 396

ServerCAMURI 396

ServerCAMURIRetryAttempts 397

ServerLogging 397

ServerName 398

ServicePrincipalName 398

SkipLoadingAliases 398



SkipSSLCAMHostCheck 398

SpreadErrorInTIDiscardsAllChanges 400

SpreadingPrecision 399

SSLCertAuthority 400

SSLCertificate 401

SSLCertificateID 401

StartupChores 401

SubsetElementBreatherCount 401

SupportPreTLSv12Clients 402

SvrSSLExportKeyID 402

SyncUnitSize 402

tlsCipherList 403

TM1ConnectorforSAP 403

UnicodeUpperLowerCase 404

UseExcelSerialDate 404

UseExtendedFetch 406

UseLocalCopiesforPublicDynamicSubsets 405

UseNewConnectorforSAP 405

UserDefinedCalculations 406

UseSQLFetch 406

UseSQLFetchScroll 406

UseSSL 407

UseStargateForRules 407

ViewConsolidationOptimization 408

ViewConsolidationOptimizationMethod 408

ZeroWeightOptimization 409

［カ行］開始するサービス 78, 86

Cognos TM1 アプリケーション・サーバー 149

概要 xiii

管理tm1web_config.xml 124

管理サーバー 24, 25, 38

管理サーバーサービス 52

管理者権限 76

管理者として実行 76

キーボード・ショートカット 339

Cognos Configuration 340

期限切れのセッション 223

キューイング 368

クエリー要素LDAP 257

クライアント 24, 27

クライアントの Language パラメーター 98

クライアントの言語 418

クライアント・インストール 3, 191

クライアント・コンポーネント 5

クライアント・ソフトウェアアップグレード 48

インストール 217

グループ割り当て 280

ゲートウェイ URI 69

計画 3

計画のサンプル開始する 78, 86

言語 39

パック・サブキーのトラブルシューティング 222

言語コード 95, 96

言語設定 95, 97, 98

検査IBM Cognos Analysis for Microsoft Excel のインストール

218

検証 280

検証の設定 280

構成パラメーターTM1 Web 125

コンポーネント 75

コンポーネントの設定 91

コンポーネントの変更 327

［サ行］サーバー 25, 38

追加 99

複数 31

サーバーの Language パラメーター 97

サーバーの追加 99

サーバーへの接続 259

サーバー・コンポーネント 5

サービス 19

サービスの停止 52, 331

サービス・アカウント TM1 21

サービス・アカウントでの権限 21

財務アナリスト役割 209

サイレント・インストール 423

サンプル 231

サンプル・データ 217

サンプル・データベースの復元 (DB2) 234

識別キー 301

失効 301

集計 406

修飾パスの強制 153

ショートカット・キー 339

IBM Cognos Configuration 340

情報の入手方法 xiii

証明書 300, 317, 318

格納 301

権限 301

失効 301

初期設定ファイル 29, 411

ジョブ・キューイング 368

数式に変換エラー 220, 224

スターゲイト・ビュー 381

制限 31

製品コード 423

セキュリティー 248

索引 437

セキュリティー証明書 186

セキュリティー認証モードTM1 Applications 40, 250

TM1 Applications Web 150, 160, 167

セキュリティーの問題 224

セキュリティー・ファイアウォールによる拒否 223

セッション・タイムアウト (分) 153

接続追加 216

設定 19, 78, 86

設定ファイル 20

セル内で折り返し 143

ゼロ消去 381

前提条件ソフトウェア 76

層 2 35

層 3 35

相互運用機能 348

ソフトウェアおよびハードウェア 16

［タ行］単一コンピューターのアップグレード 55

地域設定 39

ツール 245

追加コンポーネント 325

通知プロバイダー 153

データ層コンポーネント 6

データのバックアップ 53, 325

データの保存 25

データ・ディレクトリーアクセス権 28

セキュリティー 28

定義 27

パス 27

必要なネットワーク・アクセス権限 28

複数 28

リモート・サーバー 29

ローカル・サーバー 29

データ・ディレクトリーのパス 27

データ・モデル作成者役割 209

ディスパッチ URI 69

ディレクトリー名の ASCII 文字 76

デフォルトの設定値 16

デフォルト・プリンター 84, 207

統合ログオン 248, 249, 273, 275

アクセス権 264

概要 263

手動セットアップ 265

セットアップ 263

Architect 274

TM1 Perspectives 274

UniqueID フィールド 263

}ClientProperties キューブ 263

特権Planning Analytics for Microsoft Excel のインストール要件

217

Planning Analytics for Microsoft Excel の使用要件 218

ドメインアカウント 39

ない場合のインストール 22

トラブルシューティング 220, 427

SSL 186

トランザクション・ログ・ファイル 25

［ナ行］ナビゲーション・ツリービュー・ノード 141

認証 248, 250, 282

グループを TM1 にインポートする 288

統合ログオン 248

統合ログオンの図 249

認証、LDAP 248

認証、LDAP の図 250

認証局 (CA)

信頼関係を生成できない 224

［ハ行］ハートビート間隔 24

配布 35

TM1 Applications Web 122

TM1 Operation Console 108, 111, 112, 114, 115

TM1 Web 121, 122

TM1 アプリケーション・サーバー 163

配布のオプション 37

場所 16

パスポート 250, 282

パスワードサンプルのデフォルト 16

バックアップTM1 Applications 325, 330

バックアップ・ファイルの復元 (Oracle) 238

発行済みドキュメントMicrosoft Office で開く 221

パフォーマンスCognos TM1 データ・ソース 222

パフォーマンス・チューニング 93

パラメーター、tm1web_config.xml 124

非 ASCII 名とロケール 95

非 ASCII 文字と移動 94

非 SSL クライアント 301

ビジネス・アナリスト役割 209

必須の Tm1s.cfg パラメーターAdminHost 343

CAMPortalVariableFile 348

DataBaseDirectory 355


秘密鍵 301

ファイル拡張子 27

ファイルの種類再登録 221

登録 221

復号 301

複数コンピューターへの Web のインストール 118

複数コンピューターへのインストール 86

複数の管理ホスト 24

複数のサーバー 31

複製接続 299

プロキシー 171, 172, 173

トラブルシューティング 175

プログラムの追加および除去 54

プロビジョニング URI 153

プロビジョニング済みインストールを許可 153

プロビジョニング済み更新を許可 153

分散インストール 38

並列相互作用JobQueueThreadPoolSize パラメーター 369

別のネームスペースにログオン 299

別マシンへの TM1 Operations Console のインストール 109

変更グループ割り当て 280

ポート番号 16, 216

翻訳されたドキュメント 11

［マ行］マクロを有効にする 79

無人インストール 423, 425

メタデータ 25

文字エンコード 94

［ヤ行］ユーザー

ETLDAP による追加 251

ユーザー ID およびパスワード 153

ユーザー補助機能 339

ユーザー名 22

サンプルのデフォルト 16

要件 16

IBM Cognos Analysis for Microsoft Excel を使うための218

Planning Analytics for Microsoft Excel のアップグレード48

Planning Analytics for Microsoft Excel のインストール215, 217, 218

［ラ行］リッチ層 9

リモート・サーバー 341

データ・ディレクトリー 29

リモート・サーバー (続き)

動作 25

レポートセッションの期限が切れた後に IBM Cognos for Microsoft

Office レポートを実行する 223

連邦情報処理標準 (FIPS) 361

ローカル・サーバー 29

ローカル・ドメインとしてのドット 22

ローカル・マシン構文 22

ログファイル 25

ログオン 116

ログオン、統合 263

ログオン規則 298

ログオン資格情報 79

ログオン・ページの設定 132

ログオン・ページを設定する 132

ロケール設定 39

［数字］32 ビット 37

32 ビット Windows インストール 3

64 ビット 37

64 ビット Windows インストール 3

64 ビット・システム・コマンド 110

9.5.2 サーバーのモニター 107

AAdminHost 343, 412

AdminHost パラメーター 308

SSL 304

AdminSvrSSLCertAuthority 304, 412

AdminSvrSSLCertID 304, 413

AdminSvrSSLCertRevList 304, 413

AdminSvrSSLExportKeyID 304, 413

AdvancedRulesEditor 413

AllowImportCAMClients 289

AllowImportCamClients 413

AllowReadOnlyChore Reschedule 343

AllowSeparateNandCRules 80, 344

AllRuleCalcStargateOptimization 344

Apache Tomcat

アンデプロイ 333

ApplyMaximumViewSizeToEntireTransaction 345

Architect 27

Architect のアップグレード 56

architecture 179

AuditLogMaxFileSize 345

AuditLogMaxQueryMemory 346

AuditLogOn 346

AuditLogUpdateInterval 346

authentication modes 179

AutomaticallyAddCubeDependencies 347

索引 439

BBrowseDisplayReadsRightToLeft 414

Business Viewpoint の有効化 153

CCacheFriendlyMalloc 347

CalculationThresholdFor ストレージ 347

CAM authentication 180

CAMID 250, 282

CAMPortalVariableFile 348

CAMUseSSL 348

CertificateVersion 304

CheckFeedersMaximumCells 348

ClassicSliceMode 414

classpath 109

ClientCAMURI 349

ClientExportSSLSvrCert 304, 349

ClientExportSSLSvrKeyID 304, 349

ClientMessagePortNumber 350

ClientPingCAMPassport 349

ClientPropertiesSyncInterval 350

ClientVersionMaximum 350

ClientVersionMinimum 351

ClientVersionPrecision 352

Cognos Analytics サービス 52

Cognos Analytics セキュリティーおよび TM1 Applications 293

Cognos Configuration 76, 86, 153

Cognos Connection 78

Cognos Connection フォルダー名 153

Cognos Connection ポータル 74

Cognos Insight 76

インストール 82, 202

実行 82

ログ記録 205

Cognos Insight ping 頻度 (秒) 153

Cognos Insight からの発行を有効化 153

Cognos Query Studio 72

Cognos Report Authoring 72


アーキテクチャーの概要 32

Cognos TM1 Applications へのアップグレード 57

Cognos TM1 Operations Console 110

Cognos TM1 Performance Modeler


ログ記録 200

Cognos TM1 アプリケーション・サーバー開始する 149

Cognos TM1 データ・ソースパフォーマンスの改善 222

Cognos Workspace 73

Cognos セキュリティー 175, 282, 291

および TM1 Applications セッション・タイムアウト 297

管理者が考慮すべき事項 297

Cognos セキュリティー (続き)

匿名アクセス 286

プロキシー 173

ユーザーに関する考慮事項 298

Cognos セキュリティーの使用 289

Cognos セキュリティー・パスポート 250, 282

Cognos 認証 250, 282

管理者の定義 287

CognosGatewayURI 289, 414

CognosMDX.AggregateByAncestorRef 353

CognosMDX.CellCacheEnable 353

CognosMDX.PrefilterWithPXJ 353

CognosMDX.SimpleCellsUseOPTSDK 354

CognosMDX.UseProviderCrossJoinThreshold 354

CognosOfficeBI.xll 219

CognosOfficeTM1.xll 219

CognosTM1InterfacePath 355

CognosTM1InterfacePath 設定パラメーター 71

COM アドインExcel ブックが不意に終了する 222

Configuration

TM1 182

ConnectLocalAtStartup 414

Contributor から TM1 Applications へのアップグレード 57

CreateNewCAMClients 355

Cube Viewer

ページ・サイズ 142

Cube Viewer、シートのエクスポート 142

CubeviewerStringWrap 143

DDataBaseDirectory 355, 414

DefaultMeasuresDimension 356

DHFile-1024 304

DHFile-2048 304

DHFile-512 304

Diffie-Hellman 301

DimensionDownloadMaxSize 414

DisableAdminHostEntry パラメーター 415

DisableMemoryCache 356

DisableSandboxing 356

DisableWritebackOnDisconnect パラメーター 415

DisableWritebackOnTM1Formulas パラメーター 416

DisplayApplications 416

DisplayChores 416

DisplayControlCubes 416

DisplayCubes 416

DisplayDimensions 417

DisplayExplorerPropertiesWindow 417

DisplayProcesses 417

DisplayReplications 417

Display_Info_DBType_R8 357

DistributedPlanningOutputDir 80, 358

Docker 181

DOS コマンド・ウィンドウ 254


DownTime 358

DPR-ERR-2079 エラー 223

EEnableNewHierarchyCreation 359

EnableTIDebugging 359

ETLDAP

エクスポート・オプション 260

エクスポート・ボタン 254

結果テーブル 254

検索 DN フィールド 254

検索範囲オプション 254

検索ボタン 254

更新モードでの実行 261

サーバーへの接続 259

属性フィールド 254

フィルター・フィールド 254

DOS からの実行 254

LDAP クエリーの作成 257

LDAP クエリー要素 257

LDAP 属性の変更 252

LDAP の変更されたレコード属性 261

LDAP ログオン・パラメーターの設定 255

TM1 フィールドへの LDAP 属性のマッピング 260

TM1 への LDAP ユーザーのエクスポート 261

TM1 を更新して新しい LDAP ユーザーを追加 261

ETLDAP ユーティリティー 251

ETLDAP、LDAP 認証 280

Excel サービス 52

ExcelWebPublishEnabled 359, 404

ExpandRowHeaderWidth 417

ExportAdminSvrSSLCert 304, 417

ExportSvrSSLCert 304

FFileRetry.Count 360

FileRetry.Delay 360

FileRetry.FileSpec 360

FIPSOperationMode 361

Firefox 273

GGOSALES サンプル・データベース 234

GO_Contributor 233

GO_New_Stores

開始する 78, 86

HHTTPPortNumber 362

HTTPSessionTimeoutMinutes 363

IIBM AIX

パフォーマンス・チューニング 93

メモリー・リソース制限 92

TM1 でサポートされないコマンド 94

TM1 の実行 92

IBM Cognos Configuration の開始 91

IBM Cognos for Microsoft Office

セキュリティー・ファイアウォールによる拒否 223

IBM Cognos Office

サポートされる Microsoft Office アプリケーション 225

セキュリティーの問題 224

発行済みドキュメントを開くときのトラブルシューティング221

番号付きエラー・メッセージ 225

Microsoft Office で初期化に失敗する 221

IBM Cognos Office Reporting TM1 Addin 219


番号付きエラー・メッセージ 227

IdleConnectionTimeOutSeconds 363

IndexStoreDirectory 363

Insight

TurboIntegrator 関数の制限 175

InSpreadsheetBrowser 418

installation

Microsoft windows 184

installation overview 180

installing

Docker 181

Planning Analytics Workspace 181

IntegratedLogin 418

IntegratedSecurityMode 363

Internet Explorer 273

IP アドレス 366

IPAddressV4 365

IPAddressV6 366

iWidget 348

iWidgets 73

JJava 42

SSL 316

Java 証明書チェーン・エラー 186

JavaClassPath 367

JavaJVMArgs 367

JavaJVMPath 367

JobQueueMaxWaitTime 368

JobQueueThreadPoolSize 369

JobQueueThreadSleepTime 369

KKerberos 396

keyfile 369

索引 441

keylabel 369

keystashfile 370

LLanguage 370

LDAP

クエリーの作成 257

更新モードでの ETLDAP の実行 261

属性の変更 252

認証 248, 250

変更されたレコード属性 261

ログオン・パラメーターの設定 255

TM1 フィールドへの属性のマッピング 260

TM1 へのユーザーのエクスポート 261

TM1 を更新して新しいユーザーを追加 261

LDAP 認証 275, 282

グループ割り当ての変更 280

検証の設定 280

パラメーター 276

ユーザーの検証 275

ETLDAP 280

TM1S.cfg 280

LDAP ロード・ツール・ダイアログ・ボックス 254

LDAPHost 276, 371

LDAPPasswordFile 276, 371

LDAPPasswordKeyFile 276, 371

LDAPPort 276, 277, 371

LDAPSearchBase 276, 277, 372

LDAPSearchField 276, 277, 372

LDAPSkipSSLCertVerification 276, 277, 372

LDAPSkipSSLCRLVerification 276, 278, 282, 372

LDAPUseServerAccount 276, 278, 373

LDAPVerifyCertServerName 276, 278, 282, 373

LDAPVerifyServerSSLCert 276, 279, 282, 374

LDAPWellKnownUserName 276, 280, 375

Linux 181, 187


TM1 サーバーのインストール 89

TM1 サーバーの開始 92

Linux インストール済み環境 3

Linux サーバーのアップグレード 55

Linux での TM1 サーバーのインストール 89

LoadPrivateSubsetsOnStartup 375

LocalServerNetworkProtocol 419

LockPagesInMemory 375

log files 187

LoggingDirectory 376

LogReleaseLineCount 376

MMagnitudeDifferenceToBeZero 376

MainWindowLayoutInfo 419

MaskUserNameInServerTools 377

MaximumCubeLoadThreads 377

MaximumLoginAttempts 378

MaximumMemoryForSubsetUndo 378

MaximumSynchAttempts パラメーター 380

MaximumTILockObject 380

MaximumUserSandboxSize 381

MaximumViewSize 381

MDXSelectCalculatedMemberInputs 381

MessageCompression 383

Microsoft Excel

行と列の制限、解決 223, 224

コンテンツのリフレッシュ、トラブルシューティング 226

ブックが不意に終了する 222

Microsoft Internet Explorer 273

Microsoft SQL のバックアップ・サンプル・ファイルの復元241

Microsoft Visual C++ 76

Microsoft Windows 181, 184

Microsoft .NET 76

Microsoft .NET Framework 212


Mozilla 273

MTCubeLoad 383

MTCubeLoad.MinFileSize 384

MTCubeLoad.UseBookmarkFiles 384

MTCubeLoad.Weight 385

MTFeeders 379

MTFeeders.AtomicWeight 379

MTFeeders.AtStartup 379

MTQ 385

MTQ.CTreeRedundancyReducer 386

MTQ.OperationProgressCheckSkipLoopSize 386

MTQ.SingleCellConsolidation 386

NNegotiate 396

NetRecvBlockingWaitLimitSeconds 386

NetRecvMaxClientIOWaitWithinAPIsSeconds 387

NIST_SP800_131A_MODE 387

NTLM 396

OODBCLibraryPath 387

OLE DB 37

Operations Console 112, 114, 115

Cognos セキュリティー 291

OracleErrorForceRowStatus 388

Outdoors 社 233

PPackage Connector Windows 7 69

PasswordMinimumLength 388


PasswordSource 276, 388

pdata 27

PDF データのエクスポート 84, 207

PerfMonIsActive 388

Performance Modeler 76


PerformanceMonitorOn 389

PersistentFeeders 389

Perspectives のアップグレード 56

PIA (Primary Interop Assemblies) 213, 214


サブキーのインストール 221

Planning Analytics


Planning Analytics for Microsoft Excel

アンインストール 218

クライアント・コンポーネントのインストールの検査 218

プロキシー 171, 172, 175

ユーザーの役割と責任 209

Planning Analytics Workspace

accessing 182

installing 181

pmhub.war 112

pmpsvc.war 163, 164

PortNumber 390

PreallocatedMemory.BeforeLoad 390

PreallocatedMemory.Size 390

PreallocatedMemory.ThreadNumber 391

prerequisites 180

PreviousAdminHosts 419

PreviousDataDirectories 419

Primary Interop Assemblies

参照： PIA

Primary Interop Assemblies (PIA) 221


Primary Interop Assemblies (PIA) 再頒布可能パッケージインストール 214

PrivilegeGenerationOptimization 391

ProgressMessage 391

ProportionSpreadToZeroCells 392

PullInvalidationSubset 393

RRawStoreDirectory 393

ReceiveProgressResponseTimeoutSecs 394

Register Cognos XLL.vbs 219

remote access 187

response.ats ファイル 423

RulesOverwriteCellsOnLoad 395


SSAP 403

SAP 接続 69

SaveTime 395

SData

開始する 78, 86

sdata 27

security 179

SecurityAssignmentWindowLayoutInfo 420

SecurityPackageName 396

self-contained installation 184

SentMsgsToServerCountWarning 420

ServerCAMURI 396

ServerCAMURIRetryAttempts 397

ServerLogging 397

ServerName 398

ServicePrincipalName 398

services

restarting 184

starting 184

stopping 184

ShowAdminHostChangeWarning 420

ShowAliasAttributeWarning 420

ShowChoresSchedulingWarning 420

ShowCubeReplicationWarning 420

ShowDimDeleteElementWarning 420

ShowDimensionAccessWarning 421

ShowDynamicSubsetWarning 421

ShowPickOperationWarning 421

ShowProcessUNASCIIWarning 421

ShowProcessUNODBCWarning 421

SkipLoadingAliases 398

SkipSSLCAMHostCheck 398

SliceNewWorkbook 421

Solaris 21

SP800-131A 暗号化規格 387

SpreadErrorInTIDiscardsAllChanges 400

SpreadingPrecision 399

SSL 185, 186, 299, 301, 320

TM1 Web 310

SSL パラメーターClientExportSSLSvrCert 349

ClientExportSSLSvrKeyID 349

SSLCertAuthority 400

SSLCertificate 401

SSLCertificateID 401

SvrSSLExportKeyID 402

UseSSL 407

SSL ポート 16

SSLCertAuthority 304, 400

SSLCertificate 304, 401

SSLCertificateID 304, 401

SSLCertRevocationFile 304

SSLPrivateKeyPwdFile 304

SSLPwdKeyFile 304

索引 443

StartupChores 401

SubsetElementBreatherCount 401

SubsetWindowLayoutInfo 421

SupportPreTLSv12Clients 402

SvrSSLExportKeyID 304, 402

SyncUnitSize パラメーター 402

TTEMP システム変数 76

ThirdPartyCertificateTool 323

tlsCipherList 403

TM1 API


TM1 Applications 329

アプリケーション・ファイルの復元 336

および IBM Cognos セキュリティーのセッション・タイムアウト 297

サード・パーティー SSL 証明書 314

セキュリティー権限の保存 62

セキュリティー認証モード 40, 250

設定ファイルの復元 336


1 台のコンピューター上へのインストール 41

Applications のアンインストール 332

Cognos Analytics セキュリティーによる使用 293

Cognos Connection ポータル 74

data tier 35

IBM Cognos Analytics セキュリティーを使用 293

TM1 Applications Web 121, 122, 156

サーバー構成 151, 161, 168

実行 80, 82

セキュリティー認証モード 150, 160, 167

複数の TM1 サーバーでの使用 170

URL 154

TM1 Applications のインストール 35

TM1 Architect

実行 79

TM1 Contributor の停止 52

TM1 iWidget 348

TM1 OLE DB 12

TM1 Operation Console 83, 116


開始する 108

証明書の追加 110

TM1 Package Connector 67, 83

TM1 Package Connector の要件 68

TM1 Perspectives

実行 79

TM1 TM1 アプリケーション別個のコンピューター上へのインストール 42

TM1 Web 121, 122, 275

構成パラメーター 125

実行 80

始動パラメーター 139

統合ログオン 266

TM1 Web (続き)

ホーム・ページ 134


Kerberos 266

SSL 310

UNIX 120

Web ブラウザー設定 144

TM1 Web 層コンポーネント 7

TM1 アプリケーション・サーバー 41, 42


プロキシー 172

ログ記録 157

IBM WebSphere 上での配置 164

TM1 アプリケーション・サービス・ディスパッチャーのURI 153

TM1 オブジェクト名 94

TM1 管理サーバー開始する 78, 86

TM1 管理サーバーの証明書のバージョン 301

TM1 クライアントのインストール 191

TM1 コンポーネント 5

TM1 サーバー開始する 78, 86

接続 216


Cognos セキュリティーと匿名アクセス 286

Linux での開始 92

REST API 216

UNIX での開始 92

TM1 サーバー・サービス 52

TM1 サービス・アカウント 21

TM1 相互運用機能 65

TM1 統合 65

TM1ConnectorforSAP 403

TM1Crypt 318

TM1Functions.cfg 177

tm1p.ini

場所 411


Tm1p.ini ファイル 29, 411

TM1RebuildDefault 422

TM1S.cfg 280

Tm1s.cfg file 180

Tm1s.cfg ファイル 29, 341

サンプル 342

場所 341


tm1web.html 290

tm1web.war 122

tm1web_config.xml

始動パラメーター 139

定義 124

編集 132

tm1web_config.xml の編集 124

tm1xfer 94

TM1_Package_Connector 環境変数 70


troubleshooting 184, 187

TurboIntegrator

関数の実行の制限 175

TurboIntegrator 関数 175

実行の制限 177

UUnicodeUpperLowerCase 404

uninstall 189

UNIX


サーバー 341

TM1 サーバーのインストール 89

TM1 サーバーの開始 92

UNIX インストール 3

UNIX 関連の Tm1s.cfg パラメーターODBCLibraryPath 387


UNIX サーバーのアップグレード 55

UNIX での TM1 サーバーのインストール 89

upgrade 189

UseNewConnectorforSAP 405

UserDefinedCalculations 406

users 188

UseSQLExtendedFetch 406

UseSQLFetch 406

UseSQLFetchScroll 406

UseSSL 304, 407

UseStargateForRules 407

Vvariables_TM1.xml 290

ViewConsolidationOptimization 408

ViewConsolidationOptimizationMethod 408

virtual machine 186

Vista

Package Connector 69

Visual C++ 2010 再頒布可能パッケージ 16

WWeb アーキテクチャー 29

Web アップグレード 56

Web アプリケーション 35

Web クライアント 33

Web サーバー 31

websheets 82

WebSphere 111, 112, 114, 115, 121, 122, 164

Websphere 163

アンインストール 334

web.config 132

Windows


Windows 7 76

Windows 7 Package Connector 69

Windows Server 2008 76

Windows Vista 76

Windows サーバーのアップグレード 56

Windows での TM1 サーバーのインストール 85

ZZeroWeightOptimization 409

［特殊文字］.blb ファイル拡張子 27

.cfg ファイル 29, 341

.cho ファイル拡張子 27

.cub ファイル拡張子 27

.dim ファイル拡張子 27

.dit ファイル拡張子 27

.ini ファイル 29, 411

.NET Framework 16, 213, 214

トラブルシューティング 222

バージョン 221

.NET Programmability Support 221

.pro ファイル拡張子 27

.rej ファイル 25

.rux ファイル拡張子 27

.sub ファイル拡張子 27

.tbu ファイル拡張子 27

.tqu ファイル拡張子 27

.tru ファイル拡張子 27

.vue ファイル拡張子 27

.xdi ファイル拡張子 27

.xls の変換 62

.xlsx ワークシート 62

.xru ファイル拡張子 27

索引 445

IBM Planning Analytics バージョン...

Documents

Transcript of IBM Planning Analytics バージョン...