IBM Cognos Analytics oW 110nCXg...IBM Cognos Transformer の追加の設定タスク . 161 第 7 章設定オプション..... . 167IBM Cognos Analytics コンポーネントで使用する

IBM Cognos Analyticsバージョン 11.0

インストールと設定

IBM

©

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

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

　

原典： IBM Cognos AnalyticsVersion 11.0Installation and Configuration

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

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

著作権

Licensed Materials - Property of IBM

© Copyright IBM Corp. 2015, 2018.

IBM、 IBM ロゴ、およびibm.com は、世界の多くの国で登録された International Business Machines Corp. の商標または登録商標です。他の製品名およびサービス名等は、それぞれ IBM または各社の商標である場合があります。現時点での IBM の商標リストについては、http://www.ibm.com/legal/copytrade.shtml をご覧ください。

以下の会社名、製品名およびサービス名等は、それぞれ各社の商標または登録商標です。

v Adobe、Adobe ロゴ、PostScript、PostScript ロゴは、Adobe Systems Incorporated の米国およびその他の国における登録商標または商標です。

v Microsoft、Windows、Windows NT および Windows ロゴは、Microsoft Corporation の米国およびその他の国における商標です。

v Intel、Intel (ロゴ)、Intel Inside、Intel Inside (ロゴ)、Intel Centrino、Intel Centrino (ロゴ)、Celeron、IntelXeon、Intel SpeedStep、Itanium、Pentium は、Intel Corporation または子会社の米国およびその他の国における商標または登録商標です。

v Linux は、Linus Torvalds の米国およびその他の国における商標です。

v UNIX は The Open Group の米国およびその他の国における登録商標です。

v Java およびすべての Java 関連の商標およびロゴは Oracle やその関連会社の米国およびその他の国における商標または登録商標です。

http://www.ibm.com/legal/copytrade.shtml

目次

第 1 章インストール準備 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1リリース・ノートの確認 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1はじめに行う重要な設定アクション . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1サポートされる環境の確認 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2システム要件を確認する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

メモリー設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4Java の要件. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6デフォルト・ポート設定の確認 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Content Store を作成する際のガイドライン . . . . . . . . . . . . . . . . . . . . . . . . . 8

Linux、Windows、および UNIX オペレーティング・システムの IBM Db2 に Content Store を作成する際の推奨設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9z/OS 上の IBM Db2 で Content Store を作成するための推奨設定 . . . . . . . . . . . . . . . 12Oracle で Content Store を作成するための推奨設定 . . . . . . . . . . . . . . . . . . . . 12Microsoft SQL Server で Content Store を作成するための推奨設定 . . . . . . . . . . . . . . . 14IBM Informix データベース・サーバーで Content Store を作成するための推奨設定 . . . . . . . . . . 15

IBM Cognos Analytics のユーザー・アカウントまたはネットワーク・サービス・アカウントの設定 . . . . . 15Web ブラウザーの設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

第 2 章分散オプション . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21Cognos Analytics コンポーネント. . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

サーバー・コンポーネント . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21モデル作成コンポーネント . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25必要なデータベース・コンポーネント . . . . . . . . . . . . . . . . . . . . . . . . . 26

Cognos Mobile のコンポーネント . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27コンポーネントの分散 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

別のコンピューターへのアプリケーション層コンポーネントと Content Manager のインストール . . . . . 29Linux on System z でのサーバーの統合 . . . . . . . . . . . . . . . . . . . . . . . . 31

オプションのモデル作成コンポーネントのインストール . . . . . . . . . . . . . . . . . . . . 31ファイアウォールに関する考慮事項 . . . . . . . . . . . . . . . . . . . . . . . . . . 32Framework Manager のコンポーネントの分散 . . . . . . . . . . . . . . . . . . . . . . 33Transformer コンポーネントの配布 . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Cognos Mobile の配布オプション . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36単一のコンピューター上にインストールされる Cognos Mobile コンポーネント . . . . . . . . . . . 36複数の異なるコンピューター上にインストールされる Cognos Mobile コンポーネント . . . . . . . . . 37

IBM Cognos Analytics と他の IBM Cognos 製品との共存 . . . . . . . . . . . . . . . . . . . 37IBM Cognos Analytics との相互運用が可能な IBM Cognos 製品 . . . . . . . . . . . . . . . . 38

第 3 章 IBM Cognos Analytics のアップグレード . . . . . . . . . . . . . . . . . 41アップグレード処理 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

ドキュメントの確認 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43アップグレードの前に環境内のアプリケーションを評価する . . . . . . . . . . . . . . . . . . 43Cognos Analytics をアップグレードする際に保持されるファイルとフォルダー. . . . . . . . . . . . 45アップグレード作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

第 4 章サーバー・コンポーネントのインストールと設定 . . . . . . . . . . . . . . . 61サーバー・コンポーネントのインストールの順序 . . . . . . . . . . . . . . . . . . . . . . . 63推奨 - 分散インストール環境における基本インストールでのインストールおよび設定 . . . . . . . . . . 64インストール・モード . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65UNIX または Linux オペレーティング・システムでのサーバー・コンポーネントのインストール . . . . . . 65Windows オペレーティング・システムでのサーバー・コンポーネントのインストール . . . . . . . . . . 67

iii

コンテンツ・リポジトリーへの Content Manager のインストールと設定 . . . . . . . . . . . . . . 68アクティブおよび待機中の Content Manager コンポーネント . . . . . . . . . . . . . . . . . 70UNIX または Linux オペレーティング・システムでの Content Manager のインストール . . . . . . . . 71Windows オペレーティング・システムでの Content Manager のインストール . . . . . . . . . . . 72Content Store データベース用のデータベース接続の設定 . . . . . . . . . . . . . . . . . . . 73はじめに行う重要な設定アクション . . . . . . . . . . . . . . . . . . . . . . . . . . 80IBM Cognos Configuration の起動 . . . . . . . . . . . . . . . . . . . . . . . . . . 81Content Store のデータベース接続プロパティーの設定 . . . . . . . . . . . . . . . . . . . . 82Content Manager コンピューターの環境プロパティーの設定 . . . . . . . . . . . . . . . . . . 86E メール・サーバーへの接続の指定 . . . . . . . . . . . . . . . . . . . . . . . . . . 88セキュリティーの有効化 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90Content Manager の開始 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91Content Manager のインストールのテスト . . . . . . . . . . . . . . . . . . . . . . . . 92

アプリケーション・サービスのインストールと設定 . . . . . . . . . . . . . . . . . . . . . . 92アプリケーション・サービス・コンポーネントのインストール . . . . . . . . . . . . . . . . . 92レポート作成データベース用のデータベース接続の設定 . . . . . . . . . . . . . . . . . . . 94IBM Cognos Configuration の起動 . . . . . . . . . . . . . . . . . . . . . . . . . . 99アプリケーション・サービス・コンポーネントのコンピューターの環境プロパティーの設定 . . . . . . . 10064 ビット・バージョンのレポート・サーバーの使用可能化 . . . . . . . . . . . . . . . . . . 101アプリケーション・サービス・コンポーネントの起動 . . . . . . . . . . . . . . . . . . . . 102アプリケーション・サービス・コンポーネントのテスト . . . . . . . . . . . . . . . . . . . 103

第 5 章ゲートウェイのインストールと設定 . . . . . . . . . . . . . . . . . . . . 105Cognos Analytics ゲートウェイのインストール . . . . . . . . . . . . . . . . . . . . . . . 106Cognos Analytics と Web サーバーの設定 . . . . . . . . . . . . . . . . . . . . . . . . 107

32 ビット Web ゲートウェイの有効化 . . . . . . . . . . . . . . . . . . . . . . . . . 108ディスパッチャー URI の設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . 109

Apache HTTP Server または IBM HTTP Server の設定 . . . . . . . . . . . . . . . . . . . 111Cognos Analytics 11.0.10+ での IBM HTTP Server V9 の設定 . . . . . . . . . . . . . . . . 111IBM HTTP Server または Apache HTTP Server での WebDAV の設定 . . . . . . . . . . . . . 116IBM HTTP Server での SSL の設定 . . . . . . . . . . . . . . . . . . . . . . . . . 116Cognos Analytics 11.0.5+ での Apache HTTP Server または IBM HTTP Server の設定 . . . . . . . 119Cognos Analytics 11.0.4 での Apache HTTP Server または IBM HTTP Server の設定 . . . . . . . . 120Cognos Analytics 11.0.3 での Apache HTTP Server または IBM HTTP Server の設定 . . . . . . . . 123

Microsoft インターネット・インフォメーション・サービスの設定. . . . . . . . . . . . . . . . . 126IIS での WebDAV の設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126IIS での SSL の設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128Cognos Analytics 11.0.4 以降のバージョンでの IIS の設定 . . . . . . . . . . . . . . . . . . 129Cognos Analytics 11.0.3 での IIS の設定 . . . . . . . . . . . . . . . . . . . . . . . . 135IIS バージョン 7 または 8 での CGI ゲートウェイの設定 . . . . . . . . . . . . . . . . . . 140

ゲートウェイのテスト . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143

第 6 章オプションのモデル作成コンポーネントのインストールと設定 . . . . . . . . . 145IBM Cognos Framework Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . 145

IBM Cognos Framework Manager のシステム要件 . . . . . . . . . . . . . . . . . . . . 146IBM Cognos Framework Manager のインストール . . . . . . . . . . . . . . . . . . . . 146IBM Cognos Framework Manager の設定 . . . . . . . . . . . . . . . . . . . . . . . 147Framework Manager のデータ・ソース接続の変数の設定 . . . . . . . . . . . . . . . . . . 150Framework Manager のインストールのテスト . . . . . . . . . . . . . . . . . . . . . . 152

IBM Cognos Transformer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153IBM Cognos Transformer のシステム要件 . . . . . . . . . . . . . . . . . . . . . . . 153IBM Cognos Transformer のインストール . . . . . . . . . . . . . . . . . . . . . . . 154IBM Cognos Transformer の設定 . . . . . . . . . . . . . . . . . . . . . . . . . . 156Transformer と Cognos Analytics の間の通信 . . . . . . . . . . . . . . . . . . . . . . 157データ・ソースと Transformer . . . . . . . . . . . . . . . . . . . . . . . . . . . 158Transformer のインストールのテスト . . . . . . . . . . . . . . . . . . . . . . . . . 160

iv IBM Cognos Analytics バージョン 11.0: インストールと設定

IBM Cognos Transformer の追加の設定タスク . . . . . . . . . . . . . . . . . . . . . . 161

第 7 章設定オプション . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167IBM Cognos Analytics コンポーネントで使用する Java のバージョンの変更 . . . . . . . . . . . . . 167デフォルト設定の変更 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169

ポートと URI の設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169「設定グループ (Configuration Group)」の管理 . . . . . . . . . . . . . . . . . . . . . 173「設定サーバー (Configuration Server)」の管理 . . . . . . . . . . . . . . . . . . . . . 175暗号化の設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176IBM Cognos Application Firewall . . . . . . . . . . . . . . . . . . . . . . . . . . 181一時ファイルのプロパティーの暗号化 . . . . . . . . . . . . . . . . . . . . . . . . . 184ネームスペースを使用するためのゲートウェイの設定 . . . . . . . . . . . . . . . . . . . . 184サービスの有効化と無効化 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185フォントの設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186PDF レポートのデフォルト・フォントの変更 . . . . . . . . . . . . . . . . . . . . . . 189PDF レポートの埋め込みフォントの設定 . . . . . . . . . . . . . . . . . . . . . . . . 190出力レポートの保存 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191一時レポートの出力場所の変更 . . . . . . . . . . . . . . . . . . . . . . . . . . . 193Reporting で使用する既存の Map Manager 地図の場所の変更 . . . . . . . . . . . . . . . . 194

WebSphere Liberty Profile の調整 . . . . . . . . . . . . . . . . . . . . . . . . . . . 195待機中の Content Manager サービス用のセッション複製の有効化 . . . . . . . . . . . . . . . . 195レポート出力およびデータ・セットに外部オブジェクト・ストアを使用する . . . . . . . . . . . . . 196

外部オブジェクト・ストアへのアクセスの検証 . . . . . . . . . . . . . . . . . . . . . . 197UNIX および Linux プラットフォーム用のサーバー側印刷のカスタマイズ. . . . . . . . . . . . . . 197通知データベースの変更 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198

z/OS 上の IBM Db2 で通知データベースを作成するための推奨設定 . . . . . . . . . . . . . . 199IBM Db2 for z/OS 上の通知データベース用の表スペースの作成 . . . . . . . . . . . . . . . . 200通知データベースの接続プロパティーの変更 . . . . . . . . . . . . . . . . . . . . . . . 201

IBM Cognos トラストストアのセキュリティー標準への準拠の変更 . . . . . . . . . . . . . . . . 201IBM Cognos トラストストアへの NIST SP800-131a 非標準証明書の復元 . . . . . . . . . . . . . 202IBM Cognos トラストストアからの NIST SP800-131a 非標準証明書の削除 . . . . . . . . . . . . 202

別の認証局を使用するための IBM Cognos コンポーネントの設定 . . . . . . . . . . . . . . . . 203ThirdPartyCertificateTool コマンドと例 . . . . . . . . . . . . . . . . . . . . . . . . 203証明書署名要求 (CSR) ファイルの作成 . . . . . . . . . . . . . . . . . . . . . . . . . 205IBM Cognos コンポーネントへの CA 証明書のインポート . . . . . . . . . . . . . . . . . . 207CA によって生成された証明書を使用するように IBM Cognos コンポーネントを設定する . . . . . . . 208

IBM Cognos コンポーネントの SSL プロトコルの設定 . . . . . . . . . . . . . . . . . . . . 209IBM Cognos コンポーネント用の SSL の設定 . . . . . . . . . . . . . . . . . . . . . . 209IBM Cognos サーバーと他のサーバー間で共有の信頼関係を確立する (必要な場合)。 . . . . . . . . . 211Secure Socket Layer の暗号スイートの選択と順位付け . . . . . . . . . . . . . . . . . . . 212

IBM Cognos Configuration でのデータベース接続のための Secure Sockets Layer (SSL) プロトコルの使用 . . 213Microsoft SQL Server における IBM Cognos Configuration でのデータベース接続のための SSL の使用 . . 214IBM Db2、Informix データベースにおける IBM Cognos Configuration でのデータベース接続のための SSLの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217Oracle データベースにおける IBM Cognos Configuration でのデータベース接続のための SSL の使用 . . . 219SSL を使用した JDBC データ・ソースの保護 . . . . . . . . . . . . . . . . . . . . . . 221

Kerberos によるシングル・サインオンのための JDBC データ・ソース接続の構成 . . . . . . . . . . . 222Kerberos 初期設定ファイルの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . 223Query サービス用の SPN の作成 . . . . . . . . . . . . . . . . . . . . . . . . . . 223キータブ・ファイルの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224Kerberos ログイン・モジュールの構成 . . . . . . . . . . . . . . . . . . . . . . . . . 224Kerebos 設定の検証 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225JDBC ドライバー機能の検証 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225Kerberos 使用時のデータ・ソース接続の構成 . . . . . . . . . . . . . . . . . . . . . . 226

ログ・メッセージのリポジトリーの設定 . . . . . . . . . . . . . . . . . . . . . . . . . 227ログ記録データベースを作成する際のガイドライン . . . . . . . . . . . . . . . . . . . . . 228

目次 v

ログ記録データベース用のデータベース接続 . . . . . . . . . . . . . . . . . . . . . . . 230ログ・メッセージのリポジトリー . . . . . . . . . . . . . . . . . . . . . . . . . . . 232ユーザー固有のログ記録の有効化 . . . . . . . . . . . . . . . . . . . . . . . . . . . 239

グローバル設定の変更 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240サポートする言語のユーザー・インターフェースでのカスタマイズ . . . . . . . . . . . . . . . 241サポートする通貨のカスタマイズ . . . . . . . . . . . . . . . . . . . . . . . . . . . 241コンテンツ・ロケールのサポートのカスタマイズ . . . . . . . . . . . . . . . . . . . . . 242コンテンツ・ロケール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243ユーザー・インターフェースのロケールのマッピング . . . . . . . . . . . . . . . . . . . . 245サーバー・タイム・ゾーンのカスタマイズ . . . . . . . . . . . . . . . . . . . . . . . . 246E メール・メッセージのエンコード方式 . . . . . . . . . . . . . . . . . . . . . . . . 247Cookie 設定のカスタマイズ . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248

IP アドレスのバージョンの変更 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249IP バージョンの設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250IPv6 オプションを使って開始するように IBM Cognos Configuration を手動で設定する . . . . . . . . 250Windows 上で常に IPv6 オプションを使って開始するように IBM Cognos Configuration を設定する . . . 251

Collaboration ディスカバリー URI の設定 . . . . . . . . . . . . . . . . . . . . . . . . 251IBM Cognos Workspace の設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252

IBM Cognos Workspace やその機能に対するアクセス権の設定 . . . . . . . . . . . . . . . . 252Microsoft インターネットインフォメーションサービスでサポートされる MIME タイプの設定 . . . . . 254z/OS 上の IBM Db2 での Human Task と Annotation データベース用の表スペースの作成 . . . . . . 254ヒューマン・タスクおよび注釈用のデータベースの設定 . . . . . . . . . . . . . . . . . . . 256IBM Cognos TM1 データを使用するための IBM Cognos Workspace の設定. . . . . . . . . . . . 257IBM Cognos TM1 Applications にアクセスするための IBM Cognos Workspace の設定 . . . . . . . . 260IBM Cognos Workspace に表示するレポート・オブジェクトのスタイルの変更 . . . . . . . . . . . 261IBM Cognos Workspace サンプルへのアクセス. . . . . . . . . . . . . . . . . . . . . . 261

ディスパッチャーの可用性をテストするためのルーターの設定 . . . . . . . . . . . . . . . . . . 262別の IBM Cognos 製品とともに使用するための IBM Cognos Analytics の設定 . . . . . . . . . . . . 262

IBM Cognos Planning Contributor データ・ソース用にスケジュールしたレポートとエージェントを有効化する方法 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262

第 8 章認証プロバイダーの設定 . . . . . . . . . . . . . . . . . . . . . . . . 265匿名アクセスの無効化 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266Cognos ネームスペースへのユーザー・アクセスの制限 . . . . . . . . . . . . . . . . . . . . 267Lightweight Third-Party Authentication の設定 . . . . . . . . . . . . . . . . . . . . . . 267

LDAP ネームスペースを使用した LTPA の設定 . . . . . . . . . . . . . . . . . . . . . 268Active Directory ネームスペースを使用した LTPA の設定 . . . . . . . . . . . . . . . . . . 270

OpenID Connect 認証プロバイダー . . . . . . . . . . . . . . . . . . . . . . . . . . . 272OpenID Connect ネームスペースの設定 . . . . . . . . . . . . . . . . . . . . . . . . 274

Active Directory サーバーを使用するための IBM Cognos コンポーネントの設定 . . . . . . . . . . . 276Active Directory ネームスペースの設定 . . . . . . . . . . . . . . . . . . . . . . . . 276Active Directory のカスタム・ユーザー・プロパティーを IBM Cognos コンポーネントで使用可能にする方法 278Active Directory サーバーに対する保護された通信の有効化 . . . . . . . . . . . . . . . . . 279詳細プロパティーを使用してドメインを含める、または除外する方法 . . . . . . . . . . . . . . . 279Active Directory サーバーと IBM Cognos コンポーネント間でのシングル・サインオンの有効化 . . . . . 280

IBM Cognos Series 7 ネームスペースを使用するための IBM Cognos の設定 . . . . . . . . . . . . 285IBM Cognos Series 7 ネームスペースの設定. . . . . . . . . . . . . . . . . . . . . . . 285IBM Cognos Series 7 ネームスペースで使用されるディレクトリー・サーバーへの保護された通信の有効化 287IBM Cognos Series 7 と IBM Cognos 間でのシングル・サインオンの有効化 . . . . . . . . . . . 287IBM Cognos Series 7 ネームスペースと IBM Cognos Series 7 Trusted Signon プラグイン. . . . . . . 288

カスタム認証プロバイダーを使用するための IBM Cognos の設定 . . . . . . . . . . . . . . . . 290カスタム認証ネームスペースの設定 . . . . . . . . . . . . . . . . . . . . . . . . . . 290ユーザーのログオン時におけるネームスペースの非表示 . . . . . . . . . . . . . . . . . . . 291

LDAP を使用するための IBM Cognos コンポーネントの設定 . . . . . . . . . . . . . . . . . . 292LDAP マッピング . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293LDAP ネームスペースの設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293

vi IBM Cognos Analytics バージョン 11.0: インストールと設定

Active Directory サーバーに対する LDAP ネームスペースの設定 . . . . . . . . . . . . . . . 295IBM Directory Server に対する LDAP ネームスペースの設定 . . . . . . . . . . . . . . . . . 297Novell Directory Server に対する LDAP ネームスペースの設定 . . . . . . . . . . . . . . . . 298Oracle Directory Server に対する LDAP ネームスペースの設定 . . . . . . . . . . . . . . . . 299LDAP のカスタム・ユーザー・プロパティーを IBM Cognos コンポーネントで使用可能にする方法 . . . . 301LDAP サーバーへの保護された通信の有効化 . . . . . . . . . . . . . . . . . . . . . . . 301LDAP と IBM Cognos コンポーネント間でのシングル・サインオンの有効化. . . . . . . . . . . . 303置換演算 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304

CA SiteMinder 認証プロバイダー . . . . . . . . . . . . . . . . . . . . . . . . . . . 304SiteMinder ネームスペースの設定 . . . . . . . . . . . . . . . . . . . . . . . . . . 306

SAP を使用するための IBM Cognos の設定 . . . . . . . . . . . . . . . . . . . . . . . . 308SAP ネームスペースの設定. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310SAP と IBM Cognos 間でのシングル・サインオンの有効化 . . . . . . . . . . . . . . . . . 311

認証プロバイダーの削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311

第 9 章パフォーマンスの保守 . . . . . . . . . . . . . . . . . . . . . . . . . 313システム・パフォーマンス評価指標 . . . . . . . . . . . . . . . . . . . . . . . . . . . 313

システム評価指標の外部からの監視 . . . . . . . . . . . . . . . . . . . . . . . . . . 313必要なサービスのみの有効化 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314IBM Db2 Content Store の調整 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318IBM Cognos サービスのメモリー・リソースの調整 . . . . . . . . . . . . . . . . . . . . . 318Cognos Mobile のパフォーマンス . . . . . . . . . . . . . . . . . . . . . . . . . . . 319ネットワークでのレポート配信時間の短縮 . . . . . . . . . . . . . . . . . . . . . . . . . 320ユーザー負荷の大きい環境では非同期タイムアウトに大きな値を設定する . . . . . . . . . . . . . . 320

第 10 章 UNIX および Linux オペレーティング・システムで IBM Cognos Analytics を手作業で構成する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321デフォルトの構成設定を手動で変更する . . . . . . . . . . . . . . . . . . . . . . . . . 321コンポーネントを設定に追加する . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322暗号化設定の手動による変更 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324UNIX および Linux オペレーティング・システムでのグローバル設定 . . . . . . . . . . . . . . . 324

UNIX および Linux オペレーティング・システムのグローバル設定を手動で変更する . . . . . . . . . 326UNIX および Linux オペレーティング・システムでのサイレント・モードによる Cognos Analytics の起動および停止 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327

UNIX および Linux オペレーティング・システムでのサイレント・モードによる Cognos Analytics の起動 327UNIX および Linux オペレーティング・システムでのサイレント・モードによる Cognos Analytics の停止 327

第 11 章無人インストール、無人アンインストール、および無人構成 . . . . . . . . . 329無人インストールの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329応答テンプレート・ファイルを使用したカスタム・インストールまたは簡易インストールの作成 . . . . . . . 331無人設定の使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334無人アンインストールの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335

第 12 章 IBM Cognos Analytics のアンインストール . . . . . . . . . . . . . . . 337UNIX または Linux オペレーティング・システムでの IBM Cognos Analytics のアンインストール . . . . . 337Microsoft Windows オペレーティング・システムでの IBM Cognos Analytics のアンインストール . . . . . 338失敗したアンインストールからのリカバリー . . . . . . . . . . . . . . . . . . . . . . . . 339

第 13 章 IBM Cognos Content Archival . . . . . . . . . . . . . . . . . . . . 341コンテンツ・アーカイブの設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343

ファイル・システム・リポジトリーのファイル場所の作成 . . . . . . . . . . . . . . . . . . 343IBM FileNet Content Manager へのカスタム・クラス定義とプロパティーのインポート . . . . . . . . 344IBM Content Manager 8 へのカスタム・クラス定義とプロパティーのインポート . . . . . . . . . . 345アーカイブ処理を実行できる時刻の指定 . . . . . . . . . . . . . . . . . . . . . . . . 346スレッド実行時間の指定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347レポート出力に関する選択済み形式のアーカイブ . . . . . . . . . . . . . . . . . . . . . 348

目次 vii

アーカイブしないレポート仕様の指定方法 . . . . . . . . . . . . . . . . . . . . . . . . 349

付録 A. IBM Cognos Configuration のコマンド行オプション . . . . . . . . . . . . 351

付録 B. トラブルシューティング. . . . . . . . . . . . . . . . . . . . . . . . . 355問題のトラブルシューティング . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355

知識ベースの検索 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357フィックスの入手 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358IBM サポートと連絡を取る. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358IBM との情報交換. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359サポート更新情報のサブスクライブ . . . . . . . . . . . . . . . . . . . . . . . . . . 361

ログ・ファイル . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362

付録 C. サポート対象外についての情報 . . . . . . . . . . . . . . . . . . . . . . 367

付録 D. ガイドについて . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369

索引 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371

viii IBM Cognos Analytics バージョン 11.0: インストールと設定

第 1 章インストール準備

IBM® Cognos® Analytics をインストールする前に、IBM Cognos Analytics コンポーネントが正しく動作するように、環境でリソースを設定する必要があります。例えば、Cognos Analytics Content Store として使用するデータベースの作成と、Cognos Analytics のユーザー・アカウントの作成が必要になります。

「簡易インストール (Easy install)」(以前の「すぐに実行可能 (Ready to Run!)」)オプションを使用して Cognos Analytics をインストールする場合は (Windows のみ)、Content Store データベースを作成したり設定したりする必要はありません。Informix データベースが Content Store として既に設定されているので、CognosAnalytics で即時に使用できます。

これらの作業が完了したら、 61 ページの『第 4 章サーバー・コンポーネントのインストールと設定』に進みます。

リリース・ノートの確認製品をインストールする前にリリース・ノートを確認してください。リリース・ノートには、最新情報、既知の問題、ドキュメントの更新、サポート対象外についての情報などが記載されています。

リリース・ノートは、IBM Cognos Analytics の Knowledge Center(www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.cbi.doc/welcome.html) から入手可能です。

はじめに行う重要な設定アクションこれらの設定アクションは、正常にインストールを行うために重要です。これらのアクションは、コンポーネントをインストールした後に実行してください。

JDBC ドライバーが正しい場所にあることの確認

IBM Cognos Analytics 11.0.x リリースでは、JDBC ドライバーはinstall_location¥drivers ディレクトリーにコピーする必要があります。

install_location¥webapps¥p2pd¥WEB-INF¥lib を JDBC ドライバー用に使用することはサポートされていません。

Microsoft SQL Server 用 JSQL ドライバーの Microsoft JDBC ドライバーとの置き換え

IBM Cognos Analytics バージョン 11.0.5 以降、Microsoft SQL Server 用 JSQLドライバーは Microsoft JDBC ドライバーに置き換えられています。必要な JARファイルをダウンロードし、install_location¥drivers ディレクトリーに配置してください。詳細については、Microsoft SQL Server Content Store のセットアップを参照してください。

1

http://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.cbi.doc/welcome.html

http://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.inst_cr_winux.doc/t_MSdriver_SSLconfig.html

「設定グループ (Configuration Group)」プロパティーの指定

「カスタム」インストールを使用して IBM Cognos Analytics をインストールした場合は、IBM Cognos Configuration を開き、「設定グループ (ConfigurationGroup)」プロパティーを設定します。詳細については、「設定グループ(Configuration Group)」の管理を参照してください。

Web ベースのモデル作成の有効化または無効化

デフォルトでは、IBM Cognos Administration で作成した JDBC データ・ソース接続が、データ・モジュールで使用するために「管理」 > 「データ・サーバー」管理インターフェースに公開されることはありません。データ・モジュールを作成するために既存の (アップグレードされた) データ・ソース接続を使用する場合は、これらの接続で Web ベースのモデル作成を有効にする必要があります。

一部のデータ・ソースは、データ・モジュールを作成するためのソースとして使用するには不適切です。この場合、データ・ソース接続での Web ベースのモデル作成の使用を禁止することができます。

データ・ソース接続に対して Web ベースのモデル作成を有効または無効にするには、以下の手順を実行します。

1. IBM Cognos Analytics で、「管理」 > 「管理コンソール」に移動します。

2. IBM Cognos Administration の「設定」タブで、「データ・ソース接続」を選択します。

3. データ・ソースを見つけ、その「プロパティーを設定」操作をクリックします。

4. 「接続」タブで、「Web ベースのモデル作成を可能にする (Allow web-basedmodeling)」チェック・ボックスを選択またはクリアします。

サポートされる環境の確認製品が正常に動作するように、最低限必要なオペレーティング・システムのパッチをすべて適用し、サード・パーティー・ソフトウェアについては必ずサポートされるバージョンのみを使用してください。

オペレーティング・システム、パッチ、ブラウザー、Web サーバー、ディレクトリー・サーバー、データベース・サーバー、アプリケーション・サーバーなど、IBMCognos Analytics 製品でサポートされる環境の最新のリストを確認するには、IBMソフトウェア互換性レポート (www.ibm.com/support/docview.wss?uid=swg27047186) のページを参照してください。

システム要件を確認する次の表を使用して、1 台のコンピューターで IBM Cognos Analytics コンポーネントをインストールして実行するために必要な最小限のハードウェアおよびソフトウェア要件をチェックします。分散環境または実働環境では、さらにリソースが必要になる場合もあります。

次の表に、1 台のコンピューターへのインストールに必要なハードウェアの要件と仕様を示します。

2 IBM Cognos Analytics バージョン 11.0: インストールと設定

http://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.inst_cr_winux.doc/t_ig_config_group.html


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


ハードウェア要件

表 1. 単一のコンピューターにインストールする際のハードウェア要件

要件仕様

オペレーティング・システム Microsoft Windows

UNIX

Linux

RAM 10 GB 以上。詳細については、 4 ページの『メモリー設定』を参照してください。

オペレーティング・システムの仕様

UNIX および Linux では、ファイル記述子の制限を8192 に設定します。

ディスク容量最小必要容量: ソフトウェアのインストールに空き容量3.5 GB、および IBM Cognos コンポーネントで使用する一時ディレクトリー用のドライブに空き容量 5 GB。

環境変数は、一時ディレクトリーを指定します。Windows で、この変数は TMP です。UNIX およびLinux で、この変数は IATEMPDIR です

すべてのデータベースで、サイズが時間の経過とともに増加します。将来の要件に対しても十分なディスク容量があることを確認してください。

プリンター Windows 上でレポートを正しく印刷するためには、アプリケーション層コンポーネントがインストールされているコンピューターで少なくとも 1 台のプリンターを設定しておくことが Adobe Reader で要件となる。選択した印刷形式に関係なく、すべてのレポートが一時PDF ファイルとして印刷用に Adobe Reader に送信されます。

E メール・サーバーレポートを E メールで送信するためには、E メール・サーバーにアクセスして使用できることがシステムで要件となる。

ソフトウェア要件

次の表に、1 台のコンピューターへのインストールに必要なソフトウェアの要件と仕様を示します。

表 2. 単一のコンピューターにインストールする際のソフトウェア要件

要件仕様

Java™ Runtime Environment(JRE)

すべてのオペレーティング・システムで、IBM JREは、インストールの一部として IBM Cognos Analyticsと共に提供されます。

第 1 章インストール準備 3

表 2. 単一のコンピューターにインストールする際のソフトウェア要件 (続き)

要件仕様

データベース IBM Cognos データを格納するために、以下のいずれかのデータベースが必要です。

v Oracle

v IBM Db2

v Microsoft SQL Server

v Informix®

Easy (以前の Ready to Run!) オプションは、Informixデータベースを Content Store としてインストールして設定します。

すべてのデータベース・タイプで、TCP/IP 接続が必要です。

Web ブラウザーすべての Web ブラウザーで次のものが有効になっていること。

v Cookie

v JavaScript

Microsoft Internet Explorer の場合は、さらに次のものが有効になっている必要があります。

v ActiveX コントロールとプラグインの実行

v スクリプトを実行しても安全だとマークされているActiveX コントロールのスクリプトの実行

v アクティブ・スクリプト

v META REFRESH の実行許可

地図視覚化の要件

ダッシュボードとレポートで作成した地図は、クラウド・ベースのタイル地図とポリゴンのサービスを使用します。ご使用の Web ブラウザーが HTTPS 接続を介して当該サービスにアクセスできるように、ワークステーションからのインターネット・アクセスが必要です。

Cognos Analytics サーバーからサービスへのインターネット・アクセスは必要ありません。このサービスでは、基本の地図とポリゴンのみ提供されます。ユーザー・データはクラウド・サービスに送信されません。

メモリー設定メモリー設定は、多くの要因に依存します。例えば、サーバーで予想される処理のレベル、IBM Cognos アプリケーションの複雑さ、ユーザーおよび要求の数、許容可能な応答時間などです。

使用する環境で 100 を超える名前付きユーザーがサポートされていたり、複雑な環境であったり、使用量がピークに達する期間があったり、あるいはそれらの要因の組み合わせが環境に存在する場合、キャパシティー・プランニングの実行を検討し


てください。詳しくは、IBM Cognos Analytics サービス (www.ibm.com/software/analytics/cognos/services/) を参照してください。

環境に最も適した設定を判別するには、パフォーマンス・テストを行うことをお勧めします。

開始点として以下のメモリー設定を使用し、使用するシステムのメモリー使用量に基づいて調整してください。

v 基本オペレーティング・システムおよび付属ソフトウェア (アンチウィルス、バックアップ、および企業管理ソフトウェアなど) に 2 GB

v ディスパッチャー JVM (Content Manager またはアプリケーション層) に 4GB

v Cognos Graphics サービス JVM に 2 GB

v クエリー・サービス / データ・セット・サービス JVM に 8 GB

v レポート・サーバー・プロセス (BIBus) 用のコアごとに 2 GB

UNIX および Linux オペレーティング・システムでの ulimit 値の設定UNIX または Linux オペレーティング・システムでの適切な ulimit 値の設定は、IBM Cognos Analytics のパフォーマンスに影響を与える場合があります。

例えば、Linux オペレーティング・システムの場合、スタック ulimit 設定が原因で生じる問題として、BIBusTKServerMain による過剰なメモリー使用や、サイズの大きなレポートを処理する際の BIBusTKServerMain エラーの発生があります。

Linux オペレーティング・システムでレポート・サービスを使用している場合、レポートの実行またはアイドル状態の BIBusTKServerMain プロセスによって、使用可能なすべての RAM が使用されてしまう可能性があります。

一方、UNIX オペレーティング・システムでは、スタックの ulimit 設定が低すぎる場合に問題が発生する可能性があります。

正しいスタックの ulimit 設定を使用することで、これらの問題が発生しないようにすることができます。

新規インストール済み環境で推奨される ulimit 設定は、次のとおりです。

IBM AIX®

v CPU 時間 (秒): ulimit -t unlimited

v ファイル・サイズ (ブロック): ulimit -f unlimited

v 最大メモリー・サイズ (K バイト): ulimit -m unlimited

v 最大ユーザー・プロセス: ulimit -u unlimited

v オープン・ファイル: ulimit -n 8192 (最小値)

v スタック・サイズ (K バイト): ulimit -s 8192 (最小値)

v 仮想メモリー (K バイト): ulimit -v unlimited

Oracle Solaris



https://www.ibm.com/analytics/us/en/services/



v メモリー (K バイト): ulimit -m unlimited


v スタック・サイズ (K バイト): ulimit -s 8192 (最小値)


Linux (x、z、および p)



v 最大メモリー・サイズ (K バイト): ulimit -m unlimited



v スタック・サイズ (K バイト): ulimit -s unlimited


注: アプリケーションのライフサイクル中に、ご使用の環境に合わせてこれらの設定を調整する必要が生じる可能性があります。

Java の要件IBM Cognos Analytics で標準暗号化サービスをサポートするには、Java のバージョンの更新または JAVA_HOME 環境変数の設定が必要になることがあります。セキュリティー・ポリシーの要件によっては、無制限 Java Cryptography Extension(JCE) ポリシー・ファイルのインストールも必要になります。

既存の Java Runtime Environment (JRE) か、IBM Cognos Analytics で提供される JRE を使用できます。

暗号標準

IBM Cognos® 暗号サービスは bcprov-jdknn-nnn.jar という名前の固有の .jar(Java アーカイブ) ファイルを使用します。これは Java ランタイム環境になければなりません。このファイルは、デフォルトの JVM (Java 仮想マシン) インストールの一部として提供されていない追加の暗号化および暗号化解除ルーチンを提供します。セキュリティーを確実なものとするには、Java 拡張ディレクトリーを使用して、JVM により暗号化ファイルがロードされなければなりません。

1. install_location/jre/lib/ext ディレクトリーに移動します。

2. bcprov-jdk14-145.jar ファイルを $JAVA_HOME/lib/ext ディレクトリーにコピーします。

デフォルトでは、IBM Cognos Analytics は NIST SP800-131a セキュリティー標準をサポートするように設定されます。このセキュリティー標準に準拠するには、この標準もサポートする JRE を使用する必要があります。


IBM Cognos Analytics 用にサポートされる Java のバージョンについて詳しくは、IBM ソフトウェア互換性レポート (www.ibm.com/support/docview.wss?uid=swg27047186)を参照してください。

このセキュリティー標準の詳細については、IBM SDK, Java Technology EditionKnowledge Center (www.ibm.com/support/knowledgecenter/SSYKE2/welcome_javasdk_family.html) を参照してください。

JAVA_HOME

独自の Java を使用する場合は、JAVA_HOME 環境変数を設定してください。

JRE バージョンが IBM Cognos 製品でサポートされていることを確認します。

Microsoft Windows オペレーティング・システムでは、JAVA_HOME 変数を設定しない場合、インストールで提供される JRE ファイルが使用されます。

JRE がサポートされていることを確認するには、IBM ソフトウェア互換性レポート(www.ibm.com/support/docview.wss?uid=swg27047186)を参照してください。

無制限 JCE ポリシー・ファイル

JRE には、制限付きポリシー・ファイルが含まれています。使用できる暗号アルゴリズムおよび暗号スイートはこのファイルによって制限されます。必要な暗号アルゴリズムおよび暗号スイートが、IBM Cognos Configuration に表示されるものよりも広範囲に及ぶ場合は、無制限 JCE ポリシー・ファイルをダウンロードしてインストールできます。

IBM によって提供される Java の無制限 JCE ポリシー・ファイルは、IBM Webサイト (www14.software.ibm.com/webapp/iwm/web/preLogin.do?source=jcesdk) から入手できます。

デフォルト・ポート設定の確認インストールが終了すると、設定ツールを使用して、IBM Cognos Analytics のデフォルト設定を変更することができます。「簡易 (Easy)」インストール・タイプでは、ポート設定が自動的に選択されます。

重要: これらのポートを、インバウンドおよびアウトバウンドのトラフィックに対して公開する必要があります。

Cognos Analytics コンポーネントのデフォルト・ポート設定

次の表は、IBM Cognos Analytics のデフォルトのポートおよび URI の設定です。

表 3. Cognos Analytics コンポーネントのデフォルト・ポート設定

設定デフォルト値説明

Content Manager URI http://localhost:9300/

p2pd/servlet

Content Manager の URI。

ゲートウェイ URI http://computer_name:port/

bi/v1/disp

ゲートウェイの URI。



http://www.ibm.com/support/knowledgecenter/SSYKE2/welcome_javasdk_family.html

http://www.ibm.com/support/knowledgecenter/SSYKE2/welcome_javasdk_family.html


https://www14.software.ibm.com/webapp/iwm/web/preLogin.do?source=jcesdk


表 3. Cognos Analytics コンポーネントのデフォルト・ポート設定 (続き)

設定デフォルト値説明

ディスパッチャー URI

(内部、外部)

http://localhost:9300/

p2pd/servlet/dispatch

ディスパッチャーの URI。

外部アプリケーション用ディスパッチャー URI

http://localhost:9300/bi/

v1/disp

ディスパッチャーの URI。

ログ・サーバーのポート 9362 ローカル・ログ・サーバーが使用するポート。

メンバー同期ポート 4300 サーバー間で設定情報を転送したり同期したりするネットワーク通信で使用するローカル・ポート。

メンバー調整ポート 5701 グループ調整のためのネットワーク通信に使用するローカル・ポート。このポートは、グループのディスカバーとそのグループへの参加、および構成グループ・メンバーの最新リストの保守に使用します。

データ・セット・サービス・ポート

9301 プロセス間通信に使用されるローカル・ポート。このポートは、Cognos Analytics が初めて開始されたときに割り当てられます。ポート番号は、Cognos Analyticsディスパッチャー・ポートに 1 を加算した値になります。例えば、9300 + 1 = 9301 になります。

詳細については、 169 ページの『ポートと URI の設定』を参照してください。

Content Store を作成する際のガイドラインContent Store は、グローバル設定データ、グローバル設定 (ユーザー・インターフェースに表示される言語や通貨形式など)、データ・ソースへの接続、および製品固有の内容を保存するために Content Manager によって使用されるデータベースです。実働環境では、Content Store として、サポートされているエンタープライズ・レベルのデータベースのいずれかを使用する必要があります。

デザイン・モデルとログ・ファイルは、Content Store には保管されません。

IBM Cognos Analytics 製品を使用する前に、Content Store を作成する必要があります。Easy (以前の Ready to Run!) オプションを使用すると、Informix がインストールされ、Content Store として使用するように設定されます。


IBM Db2 を Content Store のために使用している場合、DDL を生成して、データベース管理者が Content Store に適した Db2 データベースを作成できるようにすることができます。詳細については、 74 ページの『IBM Db2 Content Store のデータベースを作成するスクリプト・ファイルの生成』を参照してください。

データベース・プロパティー

次のリスト表にあるデータベースのいずれかを使用して、Content Store データベースを作成する必要があります。

以下の表に、さまざまなタイプのデータベースで使用される文字エンコードとプロトコルを示します。

表 4. Content Store データベースの文字エンコードおよびプロトコル

データベース文字のエンコード方式プロトコル

Db2 UTF-8 TCP/IP

Oracle AL32UTF8 またはAL32UTF16

TCP/IP

Microsoft SQL Server UTF-8 または UTF-16 TCP/IP

Informix UTF-8 TCP/IP

照合順序

Cognos Analytics では、単一のソート順序を使用しており、これによって、データベースで文字データの解釈、収集、比較、表現に使用する規則が決まります。例えば、文字「A」が文字「B」より小さいか大きいか、あるいは等しいかなどの大小関係や、照合における大文字、小文字、アクセントの区別の有無が、ソート順序によって決まります。照合および照合順序について詳しくは、ICU - InternationalComponents for Unicode web site (http://site.icu-project.org/) を参照し、「ユーザー・ガイド」を選択して、「照合」を検索してください。

Linux、Windows、および UNIX オペレーティング・システムのIBM Db2 に Content Store を作成する際の推奨設定

Microsoft Windows、Linux、または UNIX オペレーティング・システム上にContent Store として作成するデータベースには、指定の設定が含まれていなければなりません。

正常にインストールを行うために、Content Store を作成する際には次のガイドラインに従ってください。ログ・メッセージ用のデータベースを作成する場合も同じガイドラインを使用します。

Content Store を作成する際のガイドライン

次のチェックリストに従って、Db2 上に Content Store をセットアップしてください。

v 次の表に示す Db2 用の該当する環境変数を設定します。


http://site.icu-project.org/

http://site.icu-project.org/

表 5. Db2 用の環境変数

環境変数説明

DB2PATH データベース・クライアント・ソフトウェアまたはデータベース全体がインストールされる最上位のディレクトリー。

LD_LIBRARY_PATH ロード・ライブラリーのパス。

ドライバーの場所をパスに追加し、二重のハッシュ記号を 64-bit に置き換えます。

Windows の場合: LD_LIBRARY_PATH=

$DB2_location/sqllib/lib##:

$LD_LIBRARY_PATH

Solaris と Linux の場合: LD_LIBRARY_PATH=

$DB2DIR/lib##: $LD_LIBRARY_PATH

AIX の場合: LIBPATH=$DB2DIR/lib##:$LIBPATH

DB2INSTANCE デフォルトのデータベース・サーバー接続。

DB2CODEPAGE 多言語データベース・サポートの有無を指定する、オプションの環境変数。サポートするには、値を 1208 に設定します。

この環境変数を使用するかどうかについては、Db2 資料を参照してください。

COGUDA_EXTENDEDCHAR_SUPPORT 一部のデータベースの文字列関数は、デフォルトではバイト・ベースの方式を使用します。これにより、文字列処理に問題が発生することがあります。例えば、文字セットが UTF-8 のDb2 データベースで LENGTH 関数を使用すると、文字数ではなく、意図に反してバイト数が返されます。

このような問題を回避するには、この変数を Tまたは t に設定します。これにより、IBMCognos ソフトウェアは、Db2 SQL のSUBSTRING、CHARACTER_LENGTH、および POSITION の式に対して文字列単位CODEUNIT32 を指定するため、それらの式が文字ベース方式で処理されるようになります。

動的クエリー・モードでは、この変数を使用しないでください。

v データベースの作成時に、コード・セット値として「UTF-8」を使用します。

データベースに適切なコード・セットが設定されていることを確認するには、コマンド行インターフェースを使用して、コマンド・プロンプトで次のように入力します。

db2 get database configuration for データベース名

コード・セット値は UTF-8、コード・ページ値は 1208 です。


v 設定パラメーターが次の表のとおりに設定されていることを確認する。

表 6. Db2 の設定パラメーター

プロパティー設定

アプリケーションのヒープ・サイズ

(applheapsz)

AUTOMATIC または少なくとも 1024 KB

アプリケーションのヒープ・サイズの値が小さすぎると、使用しているユーザーの数が多い場合にメモリー不足によるエラーが発生する可能性があります。

ロック・タイムアウト (locktimeout) 240 秒

タイムアウトに無限値を設定しないでください。

Db2 レジストリー変数(DB2_INLIST_TO_NLJN)

はい

この変数を「はい」に設定すると、パフォーマンスが向上します。

v ページ・サイズが 32 KB のバッファー・プールを作成して、次にページ・サイズが 8 KB のバッファー・プールを作成します。

v 前の手順で作成した 32KB のバッファー・プールを使用して、システム一時表スペースを作成する。

v 作成した 8 KB のバッファー・プールを使用して、ユーザー一時表スペースを作成する。

グローバル一時テーブルは、ユーザーの一時表スペースに作成されます。

v 作成した 8 KB のバッファー・プールを使用して、通常のユーザー表スペースを作成する。

また、ログ記録データベースを作成する場合は、さらにページ・サイズ 8KB の通常のユーザー表スペースを作成します。

v IBM Cognos Analytics でデータベースへのアクセスに使用されるユーザー・アカウントに次のデータベース権限を付与する。

– データベースへの接続

– テーブルの作成

– スキーマの暗黙的な作成

ヒント: Db2 のインスタンスで複数の Content Store をホストして同時に使用する場合は、IBM Cognos Analytics の各インスタンスが互いに完全に独立するように、各 Content Store に別々のユーザー・アカウントを使用してください。

v USER TEMPORARY 表スペースや、データベースに関連付けられているその他の適切な表スペースに対する、USE 権限があることを確認します。

v IBM Cognos Analytics でデータベースへのアクセスに使用されるユーザー・アカウント用のスキーマを作成し、ユーザーにそのスキーマの作成、ドロップ、および変更権限を持たせる。


v Db2 ユーザーのホーム・ディレクトリーにある sqllib/db2profile をソースとしたプロファイルを作成する。例えば、プロファイルの内容は、次のようになります。

if[ -f /home/db2user/sqllib/db2profile ]; then./home/db2user/sqllib/db2profilefi

v IBM Cognos Analytics データベースには IBM Cognos データが含まれているため、データベース管理者は定期的にバックアップを取る必要があります。データベースのセキュリティーおよび整合性を確保するために、承認されていない不正なアクセスからデータベースを保護します。

z/OS 上の IBM Db2 で Content Store を作成するための推奨設定

Content Store として作成するデータベースには、指定の設定が含まれていなければなりません。

正常にインストールを行うために、Content Store を作成する際には次のガイドラインに従ってください。

次のチェックリストに従って、z/OS® 上の Db2 で Content Store をセットアップしてください。

v Db2 で、システム管理者 (SYSADM) またはシステム制御 (SYSCTRL) 権限を持つユーザーとして z/OS システムにログオンし、データベースを作成します。

v Content Store 用のデータベース・インスタンス、ストレージ・グループ、およびユーザー・アカウントを作成する。

IBM Cognos Analytics では、ユーザー・アカウントの資格情報を使用してデータベース・サーバーと通信します。

v 32KB のページ・サイズでバッファー・プールを確保し、データベース・インスタンス用に 4KB のページ・サイズでバッファー・プールをもう 1 つ確保する。

v 管理者は、Content Store 用の大きいオブジェクトおよびその他のデータを保持するための表スペースを作成するスクリプトを実行し、表スペースに対する権限をユーザーに付与する必要がある。スクリプトの実行については 75 ページの『IBM Db2 for z/OS での Content Store の表スペースの作成』を参照してください。

v Content Store には IBM Cognos データ・アプリケーションおよびセキュリティー情報が含まれているため、データベース管理者は定期的にそのバックアップを取る必要があります。 Content Store データベースのセキュリティーおよび整合性を確保するために、承認されていないアクセスや不正なアクセスからそのデータベースを保護してください。

Oracle で Content Store を作成するための推奨設定Content Store として作成するデータベースには、指定の設定が含まれていなければなりません。



次のリストに従って、Oracle 上に Content Store を設定してください。

v Content Store データベースのデータベース・インスタンスの互換レベル・パラメーターが 9.0.1 以上に設定されていることを確認する。

例えば、次の SQL 文を実行して、COMPATIBLE 初期化パラメーターの設定を確認できます。 SELECT name, value, description FROM v$parameter WHERE

name='compatible';

インスタンスの設定パラメーターを変更する方法に関する情報は、Oracle のドキュメントを参照してください。

v データベースが Unicode であるかどうかを確認する。

ヒント: 1 つの方法として、次の select 文入力します。

select * from NLS_DATABASE_PARAMETERS

NLS_CHARACTERSET が Unicode ではない結果が返されたら、新しいデータベースを作成し、データベースの文字セット・パラメーターに AL32UTF8 を指定します。

互換クエリー・モードを使用する場合は、一般に、COGUDA_EXTENDEDCHAR_SUPPORT 環境変数に T または t の値を指定する必要があります。この変数は、部分文字列の式を Oracle の SUBSTRC に置き換えて、文字列に Unicode 補助文字が含まれている場合に正しい結果が返されるようにします。

v データベースにアクセスするためのユーザー・アカウントを決定する。

ヒント: Oracle のインスタンスで複数の Content Store をホストして同時に使用する場合は、IBM Cognos Analytics の各インスタンスが互いに完全に独立するように、各 Content Store に別々のユーザー・アカウントを使用してください。

v データベースにアクセスするユーザー・アカウントに次の作業を行う権限があることを確認する。

– データベースに接続する

– トリガー、ビュー、プロシージャー、シーケンスを作成、変更、ドロップする

– テーブルを作成し変更する

– データベース表へのデータの挿入と、データベース表のデータの更新および削除を行う

v IBM Cognos Analytics データベースには Cognos データが含まれているため、データベース管理者は定期的にバックアップを取る必要がある。データベースのセキュリティーおよび整合性を確保するために、承認されていない不正なアクセスからデータベースを保護します。


Microsoft SQL Server で Content Store を作成するための推奨設定

Content Store として作成するデータベースには、指定の設定が含まれていなければなりません。


次のチェックリストに従って、Microsoft SQL Server 上に Content Store を設定してください。

v 照合順序で大文字と小文字が区別されていないことを確認する。

Microsoft SQL Server の設定時に、カスタム・インストールで、照合を選択します。これには文字セットおよびソート順序が含まれます。一般的なインストールでは、インストール・プログラムで照合用に指定されたロケールを使用します。この設定は、後で変更できません。

v データベースを作成するにあたって Microsoft SQL Server Management Studioに接続する際は、Microsoft SQL Server 認証を使用する。

Microsoft Windows オペレーティング・システム認証を使用して接続した場合は、データベースでも Windows 認証が使用されます。この場合、IBM CognosConfiguration でデータベースの種類として「Microsoft SQL Server データベース (Windows 認証)」を使用してデータベース接続を設定する必要があります。

v データベースへのアクセスに使用するユーザー・アカウントについては、「セキュリティー」で新しいログオンを作成し、次のように設定する。

– 「SQL Server 認証」を選択する

– 「パスワード・ポリシーを適用する」チェック・ボックスをオフにする

ヒント: Microsoft SQL Server のインスタンスで複数の Content Store をホストして同時に使用する場合は、IBM Cognos Analytics の各インスタンスが互いに完全に独立するように、各 Content Store に別々のユーザー・アカウントを使用してください。

v Microsoft SQL Server 2008 の場合は、データベースにアクセスするユーザー・アカウントに EXECUTE 権限を付与する。

v Content Store データベース用に、「データベース」で新しいデータベースを作成する。

v 新規データベースの「セキュリティー」で、新しいスキーマを作成して、名前を割り当てる。

v 新規データベースの「セキュリティー」で、次のように設定して新しいユーザーを作成する。

– 「ログオン名」で、ユーザー・アカウント用に作成した新しいログオンを指定する

– 「既定のスキーマ」で、新規スキーマを指定する

– 「所有されているスキーマ」で、新規スキーマを選択する


– 「ロール・メンバー」で、「db_datareader」、「db_datawriter」、「db_ddladmin」を選択する

IBM Informix データベース・サーバーで Content Store を作成するための推奨設定

IBM Cognos Analytics Content Store として作成するデータベースには、特定の設定が含まれていなければなりません。

以下のガイドラインに従って Content Store を作成してください。ログ・メッセージ用のデータベースを作成する場合も同じガイドラインを使用します。

次のチェックリストに従って、IBM Informix データベース・サーバーのデータベース上に Content Store を設定してください。

v 次の環境変数を設定する。

– International Components for Unicode (ICU) を Informix データベース・サーバーで有効にするには、GL_USEGLU を 1 に設定する。

– データベース・ロケールを Unicode に設定するには、DB_LOCALE をen_us.utf8 に設定する。

v ログ記録をオンにして、ANSI モードでデータベースを作成する。

v データベースへのアクセスに使用するユーザー・アカウントに対して、DBA データベース権限を付与する。

重要: Informix のインスタンスで複数のデータベースをホストして同時に使用する場合は、各データベースに別々のユーザー・アカウントを使用してください。さらに、詳細プロパティー・パラメーターを作成し、その値にユーザー・アカウントを指定することによって、IBM Cognos Configuration アプリケーションの各インスタンスにユーザー・アカウントを定義する必要があります。複数のContent Store データベースの場合は、CMSCRIPT_CS_ID という名前のプロパティーを指定します。複数のロギング・データベースの場合は、IPFSCRIPTIDX という名前のプロパティーを指定します。

IBM Cognos Analytics のユーザー・アカウントまたはネットワーク・サービス・アカウントの設定

IBM Cognos Analytics に対し、ユーザー・アカウントまたはネットワーク・サービス・アカウントを設定できます。

IBM Cognos Analytics を実行するユーザー・アカウントまたはネットワーク・サービス・アカウントは、次の要件を満たしている必要があります。

v プリンターなどの必要なすべてのリソースに対してのアクセス権がある

v サービスとしてログオンし、オペレーティング・システムの一部として機能する権限がある

さらに、ユーザー・アカウントはローカル管理者グループのメンバーでなければなりません。


例えば、ネットワーク・プリンターを使用してレポートを印刷するには、そのネットワーク・プリンターに対するアクセス権がアカウントに設定されているか、またはログオン・アカウントを IBM Cognos サービスに割り当てる必要があります。

ユーザー・アカウントの設定

Microsoft Windows オペレーティング・システムの場合は、ログオン・アカウントを IBM Cognos サービスに割り当てます。特定のユーザー・アカウントを使用するように IBM Cognos サービスを設定することもできます。このような設定を行うには、Windows の「サービス」ウィンドウに表示されるサービス・リストで IBMCognos サービスを選択します。次に、ユーザー・アカウントのプロパティーを定義します。

UNIX または Linux オペレーティング・システムでは、例えば "cognos"という新しい UNIX グループまたは Linux グループを作成します。このグループには、IBM Cognos ファイルの所有者となるユーザーを含める必要があります。IBMCognos ファイルのグループ所有権を cognos グループに変更し、すべての IBMCognos ファイルに対するアクセス権を GROUP READABLE/WRITABLE/EXECUTABLE に変更します。

Web サーバーを、別名を使用するように設定します。詳細については、Web サーバーの設定に関するトピックを参照してください。

ネットワーク・サービス・アカウントの設定

ネットワーク・サービス・アカウントは、オペレーティング・システムに組み込まれている "NT AUTHORITY¥NetworkService" というアカウントです。管理者はパスワードを管理したり、アカウントを保守管理する必要はありません。

Windows Server 2008 にインストールを行う場合は、管理者権限を持つアカウントを使用します。

Web サーバーを、アプリケーション・プールを使用するように設定します。詳細については、Web サーバーの設定に関するトピックを参照してください。ディレクトリーにインストールを行うには、適切な書き込み権限も必要になります。

Web ブラウザーの設定IBM Cognos Analytics コンポーネントでは、デフォルトのブラウザー設定が使用されます。他に必要な設定は、ブラウザーによって異なります。


Cognos Analytics で必要なブラウザー設定

次の表は、有効にする必要がある設定を示しています。

表 7. 有効にされたブラウザー設定

ブラウザー設定

Internet Explorer Cookie の使用

アクティブ・スクリプト

META REFRESH の実行許可

ActiveX コントロールとプラグインの実行

スクリプトを実行しても安全だとマークされている ActiveX コントロールのスクリプトの実行

バイナリーおよびスクリプトの動作

スクリプトによる貼り付け処理の許可

ユーザー・データのパーシスタンス

Firefox Cookie の使用

Java の有効化

JavaScript の有効化

画像のロード

Safari 5 Java の有効化

JavaScript の有効化

Cookies をブロック: しない

Google Chrome Cookies: ローカルへのデータを設定する

画像: すべての画像を表示する

JavaScript: すべてのサイトで JavaScript の実行を許可する

Reporting および Query Studio では、ブラウザーのコンポーネントであるネイティブの Microsoft Internet Explorer XML サポートが使用されます。Microsoft のアプリケーションでは、ActiveX を使用して XML を実装しているため、ActiveXサポートを有効にする必要があります。Cognos Analytics は ActiveX コントロールを備えていません。また、ActiveX コントロールのダウンロードも行われません。この構成で有効になるのは、Internet Explorer の一部としてインストールされた ActiveX コントロールのみです。

Microsoft Internet Explorer を使用している場合は、ゲートウェイの URL を信頼済みサイトのリストに追加できます。例えば、「http://<サーバー名>:<ポート番号>/ibmcognos」などです。これによって、「ファイルのダウンロード時に自動的にダイアログを表示」が有効になります。


すべてのブラウザーのすべての Cognos Analytics ページでポップアップを許可します。

Cognos Analytics コンポーネントで使用する Cookie

Cognos Analytics では、次の Cookie を使用してユーザー情報を保存します。

表 8. Cognos Analytics コンポーネントで使用する Cookie

Cookie タイプ目的

AS_TICKET 1 セッションのみの一時Cookie

Cognos Analytics が IBMCognos Series 7 ネームスペースを使用するように設定されている場合に作成される。

caf 1 セッションのみの一時Cookie

セキュリティー状態の情報を保持する。

Cam_passport 1 セッションのみの一時Cookie

Content Manager サーバーに保存されたユーザー・セッションへの参照を保存する。

管理者は HTTPOnly 属性を設定して、Web ブラウザーを使用するユーザーのセッション中に、スクリプトによるCAM パスポート cookie の読み取りや操作をブロックすることができます。

詳細については、「IBMCognos Analytics管理およびセキュリティー・ガイド」を参照してください。

cc_session 1 セッションのみの一時Cookie

セッション情報を保持する。

cc_state 1 セッションのみの一時Cookie

切り取り、コピー、貼り付けなどの編集操作中の情報を保存する。

CRN 1 セッションのみの一時Cookie

データおよびユーザー・インターフェースのロケール情報を保存し、すべての IBMCognos ユーザーに設定される。

CRN_RS 永続 Cookie Reporting のメンバー・フォルダーの表示についてユーザーが選択した内容を保存する。


表 8. Cognos Analytics コンポーネントで使用する Cookie (続き)

Cookie タイプ目的

PAT_CURRENT_ FOLDER 永続 Cookie ローカル・ファイルへのアクセスを行う場合に現在のフォルダー・パスを保存し、「開く」または「保存」ダイアログ・ボックスを使用した後に更新される。

qs 永続 Cookie メニューやツールバーなどのユーザー・インターフェースの設定内容が保存される。

userCapabilities 1 セッションのみの一時Cookie

現在のユーザーのすべての機能と署名が格納される。

usersessionid 1 セッションのみの一時Cookie

ブラウザー・セッション中に有効な一意のユーザー・セッション識別子が格納される。

XSRF (クロスサイト・リクエスト・フォージェリー)

1 セッションのみの一時Cookie

XSRF は Web ブラウザーを巧妙に操って、ユーザーが現在認証されている信頼できるサイトで悪意のあるアクションを実行させます。 XSRFはユーザーのブラウザーがサイトに対して持っている信頼を悪用します。

ユーザーが既にドメイン Yに認証済みである場合に、ドメイン X から読み込まれたWeb ページがドメイン Y に対して要求を行うことができないようにします。

Cognos Analytics に対して最初に認証されるときに、XSRF Cookie が設定されます。この時点から、すべての要求で、XSRF-TOKENCookie と X-XSRF-TOKENという HTTP ヘッダーの両方が必要になります。

アップグレードまたは新しいソフトウェアのインストールが完了したら、Web ブラウザーを再起動し、ブラウザーのキャッシュをクリアするようにユーザーに指示してください。



第 2 章分散オプション

IBM Cognos Analytics を実装する前に、使用環境でのインストール方法を決めておく必要があります。サーバー・コンポーネントは、すべてを 1 台のコンピューターにインストールすることも、ネットワーク上に分散してインストールすることもできます。最適な分散オプションは、レポート作成要件、リソース、および設定によって異なります。設定要件は、すべてのコンポーネントを 1 台のコンピューターにインストールするか、複数のコンピューターに分散するかによって異なります。

Cognos Analytics は、その他の Cognos 製品と互換性があります。使用している環境に他の Cognos 製品がある場合は、Cognos Analytics の環境内における位置づけを考慮する必要があります。

Cognos Analytics を、Cognos Framework Manager、CognosTransformer、Cognos PowerPlay などの他の Cognos 製品と同じ場所にインストールすることはできません。

Cognos Analytics コンポーネントIBM Cognos Analytics は、レポート作成、ダッシュボード、分析、イベント管理などの機能を統合した、Web ベースのビジネス・インテリジェンス・ソリューションです。 Cognos Analytics にはサーバー・コンポーネントとモデル作成コンポーネントが含まれています。

Cognos Analytics は、環境内のリソースを利用して、既存のインフラストラクチャーに簡単に統合できます。これらの既存のリソースのいくつかは、必ず使用する必要があります (Content Store のデータベースなど)。認証用のセキュリティー・プロバイダーなどの他のリソースは、オプションです。

ヒント: 「簡易インストール (Easy install)」オプションを使用して CognosAnalytics をインストールする際には、Content Store データベースやセキュリティー・プロバイダーを設定する必要はありません。この製品は事前に設定済みであるため、すぐに使用できます。

IBM Cognos Analytics は、WebSphere® Application Server Liberty Profile をアプリケーション・サーバーとして実行します。

サーバー・コンポーネントIBM Cognos Analytics のサーバー・コンポーネントは、データ層、アプリケーション層、およびオプションのゲートウェイ層の 3 層に分かれています。

サーバー・コンポーネントには、ユーザー要求のルーティングと処理を行うための機能だけでなく、レポート作成、ダッシュボード、分析、イベント管理などを行うためのユーザー・インターフェースも用意されています。

インストール・プログラムでは、次のサーバー・コンポーネントをインストールすることを選択できます。

21

v 『データ層: Content Manager』

v 『アプリケーション層: コンポーネント』

v 24 ページの『オプションのゲートウェイ層: Web 通信』

ヒント: オプションのゲートウェイが必要になるのは Kerberos だけです。

オプションのサーバー・コンポーネントとして Cognos Analytics サンプルをインストールすることもできます。 Sample Outdoors 社という架空の企業のデータを使用したサンプルは、製品の機能と、技術やビジネスに関するベスト・プラクティスについて説明しています。これらのサンプルを使用すると、レポートのデザイン方法を試したり共有したりできるほか、トラブルシューティングを行うこともできます。詳しくは、「IBM Cognos Analytics サンプル・ガイド」を参照してください。

データ層: Content ManagerContent Manager は、セキュリティー、設定データ、モデル、レポート仕様、レポート出力などのアプリケーション・データの保存を管理する IBM CognosAnalytics サービスです。

Content Manager は、パッケージの発行、レポート仕様の取得と保存、スケジュール情報の管理、および Cognos ネームスペースの管理を行うために必要です。

Content Manager では、Content Store データベースに情報が保存されます。

アプリケーション層: コンポーネントIBM Cognos Analytics のアプリケーション層には、1 つ以上の Cognos Analyticsサーバーが含まれます。このサーバーでは、レポート、分析、クエリーなどゲートウェイによって転送された要求が実行され、インターフェースが表示されます。

製品の設定と管理 - IBM Cognos Configuration

IBM Cognos Configuration は、Cognos Analytics の設定と、そのサービスの開始や停止を行うために使用されます。

コンテンツの発行、管理、および表示 - Cognos Analytics ポータル

Cognos Analytics ポータルは、この製品で利用できる企業データへの単一のアクセス・ポイントとなります。データをクエリー、分析、編成したり、レポート、スコアカード、およびイベントを作成したりするための単一のエントリー・ポイントを提供します。ユーザーは、ポータルからすべての Web ベースの Cognos Analyticsアプリケーションを実行できます。他のアプリケーションや、他のアプリケーションへの Web アドレスをポータルに統合できます。

プロフェッショナル・レポート

Reporting ツールを使用して、レポート作成者はさまざまなプロフェッショナル・レポートの作成、編集および配布を行います。


ダッシュボード

Cognos Analytics には、洞察や分析を人に伝えるためのダッシュボードが用意されています。グラフ、図表、プロット、表、マップなどの視覚化、あるいはその他のデータ視覚表現を含むビューを組み立てることができます。

ダッシュボードは、イベントやアクティビティーを一目でモニターするために役立つ、ビューの一種です。 1 つ以上のページまたは画面で、データに関する重要な洞察や分析を表します。

一元管理 - 管理および管理コンソール

Cognos Analytics には「管理」機能があります。この機能を使用して、一般的な管理タスクを日常的に実行できます。「管理」メニューのオプションから、IBMCognos Analytics の管理タスクが含まれている一元管理インターフェースである、「管理コンソール」が開きます。これにより、IBM Cognos 環境のすべての管理に簡単にアクセスできます。管理機能に対するアクセス権限は、ユーザーの権限によって異なります。

IBM Cognos Mobile

IBM Cognos Mobile は、Cognos Analytics およびパフォーマンス管理をモバイル・デバイスに拡張します。Cognos Mobile の Rich Client を使用することにより、ユーザーは、Reporting、Query Studio、Analysis Studio、Cognos Workspaceなどのツールで生成された、Cognos Analytics レポート、ワークスペース、および分析を自分のデバイスに表示できます。Cognos Mobile は、モバイル・ユーザーの意思決定処理をサポートするタイムリーで有用でインタラクティブな情報を、ユーザーの現在位置に関係なく配信します。

Cognos Mobile は、受け取るそれぞれの Cognos Analytics レポートを処理して、モバイルに適したバージョンにレンダリングします。

Cognos Mobile は、Cognos Analytics プロンプト機能およびスケジューリング・メカニズムを使用して、カスタマイズされたレポートをタイムリーな方法で配信します。プロンプトについて詳しくは、「IBM Cognos Analytics - Reporting ユーザー・ガイド」を参照してください。スケジュールについて詳しくは、「IBM CognosAnalytics 管理およびセキュリティー・ガイド」を参照してください。

Cognos Mobile は、Cognos Analytics セキュリティーを使用し、モバイル・アプリケーションに固有の追加のセキュリティー方式を実装し、ベンダー固有のさまざまなセキュリティー・アーキテクチャーを活用し、デバイス・ベースおよびサーバー・ベースのセキュリティー方式を利用します。

Cognos Mobile によって使用されるデバイス固有の管理サーバー・ツールおよび管理ツールの多くには、リモート側でデバイスのコンテンツを削除したり、デバイスを完全に使用不可にしたりする機能があります。そのため、例えばデバイスが紛失または盗難に遭った場合、Cognos Analytics 管理者はこの機能を使用してデバイス上の重要コンテンツを保護できます。または、Cognos Analytics 管理者がレポートの有効期限日付を設定することにより、その日付を超過したレポートはユーザーが再認証するまでアクセス不能にすることができます。Cognos Analytics について詳

第 2 章分散オプション 23

しくは、IBM Cognos Analytics「管理およびセキュリティー・ガイド」を参照してください。デバイスの管理およびセキュリティーについて詳しくは、デバイスの資料を参照してください。

また、Cognos Mobile では、モバイル・デバイスとサーバー環境の間での、検索、参照、および実行といった製品機能の要求もサポートしています。

同じバージョンの Cognos Mobile および Cognos Analytics サーバーをインストールして実行する必要があります。

アドホックなクエリーおよびセルフサービスによるレポートの作成 - QueryStudio

Query Studio を使用すると、ほとんどトレーニングを受けなくてもレポートを素早く設計、作成、および保存でき、Reporting で作成される標準のプロフェッショナル・レポートでは対応できないレポート作成のニーズを満たすことができます。

例外条件のデータの監視 - Event Studio

Event Studio では、データを監視し、処理する必要があるデータで業務上のイベントや例外的な状態が発生したときにタスクを実行するようにエージェントを設定します。イベントが発生すると、対処するようにアラートを受けます。エージェントによって、ポータルへの詳細の発行、E メールによるアラートの送信、イベントに基づくレポートの実行と配布、およびイベント・ステータスの監視を行えます。例えば、重要な顧客からのサポート要求や大量注文のキャンセルによってイベントが発生した場合に、関係者に E メールが送信されます。

意思決定の促進 - IBM Cognos Workspace

固有の情報のニーズに応じて、IBM Cognos コンテンツや、TM1®

Websheet、CubeView などの外部データ・ソースを使用して、高度な双方向ワークスペースを作成できます。お気に入りのワークスペースやレポートを表示して開いたり、コンテンツを操作したり、発見した内容を E メールで送信したりすることが可能です。コラボレーションによる意思決定にコメントやアクティビティーを使用することもできます。

また、コラボレーションによる意思決定には、IBM Connections などのソーシャル・ソフトウェアを使用することもできます。

Microsoft Office との互換性 - IBM Cognos for Microsoft Office

IBM Cognos for Microsoft Office を使用すると、Microsoft Office ユーザーがExcel、PowerPoint、Word などの Microsoft Office アプリケーションの中からIBM Cognos レポートのデータや可視化にアクセスできます。

Cognos for Microsoft Office コンポーネントは Cognos Analytics に同梱されていますが、別個にインストールする必要があります。

オプションのゲートウェイ層: Web 通信多くの場合、ゲートウェイは CGI プログラムですが、Internet Server ApplicationProgram Interface (ISAPI) や Apache モジュール (apache_mod) などの他の規格


を使用することもできます。 IBM Cognos Analytics で CGI、ISAPI、またはApache モジュールを使用するのは、Kerberos を使用する場合のみです。その他の場合にゲートウェイを設定する必要はありません。

IBM Cognos Analytics では、アプリケーション層がゲートウェイの機能を提供します。

モデル作成コンポーネントモデル作成コンポーネントでは、ユーザーに有意義な方法でデータを構築して提供するために、データ・ソース内でデータのモデルが作成されます。モデル作成コンポーネントには次のツールが含まれています。

IBM Cognos Analytics Web モデリング

IBM® Cognos® Analytics には、簡単に使用できる、ゼロ・フットプリントのモデル作成ツールが備わっています。このツールを使用して、さまざまなデータ・ソースからデータ・モジュールを素早く作成することができます。データ・サーバー、アップロード済みファイル、以前に保存されたデータ・モジュールなどのデータ・ソースを使用して、データ・モジュールを作成できます。 Cognos Analytics データ・モデリングは、目的駆動型のモデリングを使用してユーザーが定義した用語を使用することにより、モジュールを生成します。使用可能な全機能の詳細については、「IBM Cognos Analytics Data Modeling Guide」を参照してください。

Cognos Analytics データ・モデリングは、IBM Cognos Framework Manager やIBM Cognos Cube Designer のより複雑なモデリング機能を置き換えるものではありません。これらのツールは、Cognos Analytics で現在も使用可能です。

データのビジネス・ビューの作成 - Framework Manager

IBM Cognos Framework Manager は、IBM Cognos Analytics で使用するビジネス関連のメタデータを作成して管理するためのモデル作成ツールです。メタデータは、レポート作成ツールで使用するためにパッケージとして発行され、任意の数の、異なる種類のデータ・ソースを 1 つに統合したビジネス・ビューを提供します。

Framework Manager は、Cognos Analytics とは異なる場所にインストールする必要があります。

ROLAP モデリング - Cube Designer

IBM® Cognos® Cube Designer は、IBM Cognos Dynamic Cubes に備わっているモデル作成ツールです。これを使用して、動的キューブを作成し、IBM CognosAnalytics で使用するために発行します。

まず始めに、リレーショナル・データベースからメタデータをインポートします。メタデータを使用して、動的キューブをモデル化し、キューブ定義をプロジェクトに保存します。キューブは、発行後 Content Manager にデータ・ソースとしてリストされ、レポート作成者がそれらの関連パッケージを使用できるようになります。


Cube Designer は、Cognos Analytics とは異なる場所にインストールする必要があります。

多次元モデルの作成 - IBM Cognos Transformer

IBM Cognos Analytics のモデル作成ツールである IBM Cognos Transformer は、IBM Cognos Analytics で使用する PowerCube を作成するために使用されます。保護された IBM Cognos Analytics PowerCube は、IBM Cognos Series 7 と互換性がありません。

Transformer は、Cognos Analytics とは異なる場所にインストールする必要があります。

ヒント: 8.4 より前のバージョンの Transformer のインストールと設定については、ご使用の Transformer のエディションに付属のドキュメントを参照してください。

地図のインポートと管理 (既存の Map Manager 地図のみ)

IBM Cognos Map Manager は、管理者やモデル作成者が地図をインポートし、Reporting で地図のラベルを更新するために使用する Windows ベースのユーティリティーです。また、管理者やモデルの作成者は国名や地域名および都市名などの地図特性に対して代替の名前を定義し、地図に表示されるテキストの多言語のバージョンを提供できます。

Map Manager は、Cognos Analytics とは異なる場所にインストールする必要があります。

詳細については、IBM Cognos Map Manager「Installation and User Guide」を参照してください。

必要なデータベース・コンポーネントIBM Cognos Analytics では、装備されているツールの他に、その他のリソースで作成された次のコンポーネントが必要になります。

Content Store

Content Store は、レポート仕様や発行されたモデルやこれらを含むパッケージ、データ・ソースの接続情報、外部ネームスペースや Cognos ネームスペース自体に関する情報、レポートのスケジュールやバーストに関する情報など、CognosAnalyticsでの処理が必要なデータを格納するリレーショナル・データベースです。

Cognos Analytics 環境をセットアップする際には、パフォーマンスと安定性の調整やセキュリティー保護が可能な、サポート対象データベースを使用して ContentStore をセットアップします。詳細については、「IBM Cognos Analytics 管理およびセキュリティー・ガイド」の Content Store 全体の配布に関するトピックを参照してください。

デザイン・モデルとログ・ファイルは、Content Store には保管されません。


Content Store は、Content Manager という IBM Cognos サービスで使用されます。

データ・ソース

データ・ソースはクエリー・データベースとも呼ばれ、Cognos Analytics からアクセス可能なリレーショナル・データベース、ディメンション・キューブまたはOLAP キューブ、ファイル、またはその他の物理データ・ストアです。アプリケーション層コンポーネントでは、データ・ソース接続を使用してデータ・ソースにアクセスします。

Cognos Mobile のコンポーネントIBM Cognos Mobile には、Cognos Mobile サービスと Cognos Mobile アプリが含まれます。これらのコンポーネントは、IBM Cognos Analytics とともにインストールされます。

the Cognos Mobile サービスを設定した後、ユーザーはモバイル・デバイスにCognos Mobile アプリをインストールして、レポートやダッシュボードなどのCognos Analytics コンテンツにアクセスすることができます。アプリを使用するには、ユーザーは Apple App Store から iOS バージョンをダウンロードするか、Google Play Store から Android バージョンをダウンロードします。

Cognos Mobile サービスは、次の処理を扱います。

v レポートおよび分析のコンテンツをモバイル・デバイスにプッシュする。

v モバイル・デバイスと環境との間でレポートを検索、表示、および実行するために、レポート関連および分析関連の要求の着信と発信を容易にする。

v サーバー上のモバイル Content Store をモバイル・デバイス上のモバイル・データベースと同期させる。

v モバイル・デバイスと通信する。

モバイル・デバイスには、 Cognos Mobile アプリと、圧縮されて暗号化されたMobile の Content Store が組み込まれています。これらのコンポーネントは、モバイル・デバイス・ユーザーが Cognos Analytics のレポート、ダッシュボード、および分析に関する作業を行うために必要な機能を提供します。

次の図は、Cognos Analytics 環境内でさまざまなコンポーネントが相互作用する様子を示しています。モバイル・デバイスは、インターネット、および HTTP を使用するワイヤレス回線業者を介して IBM Cognos サーバーに接続されています。


コンポーネントの分散IBM Cognos Analytics サーバー・コンポーネントをインストールするときには、アプリケーション層、データ層 (Content Manager)、およびオプションのゲートウェイ層のコンポーネントの配置場所を指定します。

以下のインストール・シナリオを使用できます。

v 1 台のコンピューターにすべてのコンポーネントをインストールする。

通常、このオプションは、部署での配布のため、デモンストレーション・システムとして、または概念の検証を行う環境で使用します。

v アプリケーション層コンポーネントと Content Manager を別個のコンピューターにインストールする。

パフォーマンス、可用性、容量、セキュリティーを、組織独自の処理方法に応じて最適化する場合に、このオプションを選択します。

v オプションのゲートウェイを別のコンピューターにインストールする。

このオプションでは、ゲートウェイと Web サーバーが同じコンピューターにインストールされ、他の Cognos コンポーネントは別のコンピューターに分散されます。 Cognos Analytics コンポーネントからの要求を処理できる Web サーバーがある場合に、このオプションを選択できます。

v System z® に複数のサーバーをインストールして、サーバーを統合する。

図 1. Cognos Analytics 環境内の Cognos Mobile コンポーネント


IBM Cognos Analytics は Linux on System z オペレーティング・システムに対応しています。このタイプのインストールは、IT やインフラストラクチャーの要件に合うように、使用環境のインストールを設定したり、カスタマイズしたりする際に適しています。

サーバー・コンポーネントをインストールした後、これらのコンポーネントが相互に通信できるように設定する必要があります。

データ層 (Content Manager)、アプリケーション層、およびオプションのゲートウェイ層の各コンポーネントのインストールに加え、メタデータ・モデル作成ツールである Cognos Framework Manager と、PowerCubes 作成用のモデル作成ツールである Cognos Transformer をインストールすることもできます。どのような方法で IBM Cognos をインストールする場合でも、モデル作成コンポーネントを別々の場所にインストールしてください。

別のコンピューターへのアプリケーション層コンポーネントとContent Manager のインストール

アプリケーション層コンポーネントでは、負荷分散、データ・アクセス、クエリーの実行、ジョブのスケジュール、レポートの表示を行います。Content Manager では、すべてのレポート仕様、結果パッケージ、フォルダー、ジョブが ContentStore 内に格納されます。

アプリケーション層コンポーネントと Content Manager は、同じコンピューターにインストールすることも、別のコンピューターにインストールすることもできます。別のコンピューターにインストールすると、パフォーマンス、可用性、容量の向上を期待できます。

複数の Content ManagerContent Manager はいくつでもインストールできますが、一度にアクティブになるのは 1 つのみです。その他の Content Manager は、バックアップ用として動作します。その他の Content Manager がアクティブになるのは、アクティブなContent Manager コンピューターに影響する障害が発生した場合のみです。フェイルオーバー保護として、Content Manager を複数のコンピューターにインストールすることを推奨します。

複数の Content Manager のインストール

Content Manager では、レポート仕様、発行されたモデル、およびこれらを使用するパッケージ、データ・ソースの接続情報、外部ネームスペースに関する情報、Cognos ネームスペース、レポートのスケジュールとバーストに関する情報など、IBM Cognos Analytics の動作に必要なデータを格納します。Content Store は、リレーショナル・データベース管理システム (RDBMS) です。インストールした各IBM Cognos には Content Store が 1 つずつあります。

Content Manager を、アプリケーション層コンポーネントとは別のコンピューターにインストールすることもできます。例えば、Content Manager を、アプリケーション層ではなくデータ層にインストールできます。


アクティブな Content Manager でエラーが発生した場合、保存されていないセッション・データは失われます。別の Content Manager に切り替わった場合、ユーザーはログオンを求められることがあります。

次の図では、要求がゲートウェイによってディスパッチャー (非表示) に渡された後、そこからデフォルトのアクティブな Content Manager コンピューターに渡されます。コンピューターに障害が発生した場合、要求は待機中の Content Managerコンピューターに転送されます。このバックアップ用コンピューターは、デフォルトのアクティブな Content Manager コンピューターに障害が発生した場合にアクティブになります。

設定要件

Content Manager がインストールされている各コンピューターで、次の作業を行います。

v Content Store との接続情報を指定する

v ディスパッチャー URI を指定する

v すべての Content Manager URI を指定する

v 外部アプリケーションのディスパッチャー URI を指定する

v E メール・サーバーへの接続をセットアップする (E メール・レポートを使用したり通知を送信したりする場合)

図 2. アクティブな Content Manager と待機中の Content Manager を含むインストール


複数のアプリケーション層コンポーネント・コンピューター大量のレポート要求を処理することの多い環境で拡張性を向上させるには、アプリケーション層コンポーネントを複数のコンピューターにインストールして、そのコンピューターは受信した要求の処理のみを実行するようにします。アプリケーション層コンポーネントを複数のコンピューターにインストールすると、コンピューター間で負荷を分散し、バランスをとることができます。また、単独のコンピューターで対応するよりもアクセス性や処理量が向上するだけでなく、フェイルオーバーにも対応できます。

設定要件

1 つ以上のアプリケーション層コンポーネントを別のコンピューターにインストールする場合は、それらが他の IBM Cognos Analytics コンポーネントと通信できるようにするために、次の作業を行う必要があります。

v すべての Content Manager URI を指定する

v ディスパッチャー URI を指定する

v 外部アプリケーションのディスパッチャー URI を指定する

Linux on System z でのサーバーの統合Linux on System z オペレーティング・システムは、Linux オペレーティング・システムのネイティブ実装です。ホスト・オプションには、1 つ以上の論理パーティション (logical partition:LPAR) で Linux を実行するものがあります。

Integrated Facility for Linux (IFL)

IFL は専用の System z プロセッサーであり、ユーザーの要件に応じて Linux オペレーティング・システムのワークロードをネイティブで、または仮想ソフトウェア環境で実行します。IFL を使用すると、System z の Linux リソースを統合し、一元管理することができます。

論理パーティション (LPAR) モード

Linux オペレーティング・システムは LPAR で実行することが可能で、TCP/IP 接続を使用して、その他の Linux パーティションと通信できます。

大規模な Linux 環境での水平方向の拡張性は、作成可能な LPAR の数によって制限されます。実行している Linux イメージの数が少なく、それらの各イメージが大量のプロセッサー・パワーを使用する場合、または非常に大きな専用メモリーを必要とする場合は、Linux を LPAR で実行するのが最適と言えます。これにより、各イメージは、割り当てられたリソースを十分に活用できるようになります。

オプションのモデル作成コンポーネントのインストールFramework Manager および Transformer などのモデル作成ツールを MicrosoftWindows オペレーティング・システム・コンピューターにインストールします。

パッケージを発行してユーザーがそのパッケージを使用できるようにするには、直接またはゲートウェイ経由でディスパッチャーを使用するように、オプションのモ


デル作成ツールを設定する必要があります。ポータルが保護されている場合は、ポータルでデータ・ソースを作成してパッケージを発行する権限が必要になります。

ファイアウォールに関する考慮事項モデル作成ツールが、アプリケーション層コンポーネントを保護するネットワーク・ファイアウォールの外にある場合、ディスパッチャーとの通信で問題が発生する可能性があります。セキュリティー上の理由により、デフォルトの IBM CognosAnalytics 設定では、ディスパッチャーは、ネットワーク・ファイアウォールの外にある場合、モデル作成ツールからの要求を受け入れないように設定されています。

Framework Manager などのモデル作成ツールがネットワーク・ファイアウォールの外側にある場合、ネットワークを越えて IBM Cognos Analytics アプリケーション・サーバー上のディスパッチャーに要求を送信することはできません。ネットワーク・ファイアウォール越しに通信するときに発生する通信の問題を回避するために、モデル作成ツールをアプリケーション層コンポーネントと同じ階層にインストールします。次の図は、ネットワーク・ファイアウォールの内側にある FrameworkManager コンピューターが、IBM Cognos Analytics アプリケーション・サーバー上のディスパッチャーと問題なく通信している様子を示しています。

次の図のように、モデル作成ツールとの通信用に専用のゲートウェイを追加してインストールする方法もあります。そこで、ディスパッチャーがモデル作成ツールから要求を受け入れるように、モデル作成ツールとそのゲートウェイを設定します。

図 3. ファイアウォールの外側にあるクライアント・コンピューター


Framework Manager のコンポーネントの分散Framework Manager ではアプリケーション層コンポーネントとの通信が行われますが、アプリケーション層コンポーネントは 1 つ以上のアプリケーション・サーバーにインストールされる場合があります。パッケージを発行するには、ディスパッチャーと直接または専用ゲートウェイ経由で通信できるように、FrameworkManager を設定する必要があります。

設定要件

Framework Manager をインストールしたコンピューターでは、次の環境プロパティーを設定してください。

v ゲートウェイ URI

v 外部アプリケーション用ディスパッチャー URI

モデル作成ツールが直接ディスパッチャーと通信する代わりに、専用のゲートウェイを使用している場合は、専用のゲートウェイ・コンピューターでも「ゲートウェイ用ディスパッチャー URI」プロパティーを設定する必要があります。

Transformer コンポーネントの配布Transformer は、IBM Cognos Analytics の他のコンポーネントと同じコンピューターにインストールすることも、IBM Cognos Analytics の他のコンポーネントと

図 4. ファイアウォールの外側にあるクライアント・コンピューター


は別のコンピューターにインストールすることもできます。別々にインストールした場合、Transformer をスタンドアロン製品として使用することも、IBM CognosAnalytics の他のコンポーネントと通信するように設定することもできます。

Transformer は、次のコンポーネントから構成されます。環境によって、どちらか一方しか使用しない場合もあれば両方使用する場合もあります。

v Windows 用 Transformer

IBM Cognos Analytics で使用される PowerCube を Microsoft Windows オペレーティング・システムで設計するためのモデル作成ツールです。PowerCubeの作成と発行にも役立ちます。

v UNIX または Linux 用 Transformer

UNIX および Linux オペレーティング・システムで PowerCube を作成するためのコマンド行ユーティリティーです。最初に Transformer Windows またはMDL スクリプトを使用してモデルを設計し、そのモデルを使用してPowerCube を作成します。

Linux on System z 用の Transformer PowerCube 構築コンポーネントをインストールします。

サポートされている機能

Transformer をスタンドアロン製品として使用する場合、IBM Cognos Analyticsの外部にあるデータ・ソースを使用することはできますが、ディメンションによるフィルター処理によって保護されているビューを作成することはきません。IBMCognos Analytics の他のコンポーネントとともに Transformer を使用した場合、IBM Cognos Analytics の次の機能を利用することができます。

v IBM Cognos Analytics 認証プロバイダー

v 発行されたパッケージ、Query Studio レポート、Reporting レポートなどのIBM Cognos Analytics データ・ソース

フラット・ファイルをデータ・ソースとして使用することはできません。

v PowerCube データ・ソースおよびパッケージを発行するポータル

v PowerCube の構築

役割ベースのサーバーに関する考慮事項

キューブ作成時のパフォーマンスと IBM Cognos Analytics ユーザーのアクセス性を高めるために、専用の Transformer サーバーをセットアップすることができます。その場合は、次の要件を考慮する必要があります。

v Transformer を使用して PowerCube を作成するかデータ・ソースをテストする、すべてのコンピューターに、データベース・クライアント・ソフトウェアをインストールする

v データ・ソースとの接続を確保するために、UNIX サーバーや Linux サーバーの該当する環境変数を設定する、

v レポート・サーバーが PowerCube にアクセスできるようにするために、PowerCube の格納場所へのアクセス権を IBM Cognos Analytics サーバーに付与する


実働環境用の PowerCube の作成と更新を行うスクリプトを記述し、適切なアクセスとユーザー権限を設定してからリモート実行できます。実働環境用の PowerCubeの作成と更新の詳細については、「Transformer ユーザー・ガイド」を参照してください。

ビジネス・アナリストまたはスペシャリスト

専門的なビジネス・ユーザーやパワー・ユーザーは、企業と個人のデータ・ソースを組み合わせて PowerCube のモデルを作成したい場合があります。このようなユーザーは、自身の業務や少数のユーザー・グループのために、データを独自に分析することができます。次の要件を満たせば、社内の IT およびセキュリティー・インフラストラクチャー内で、このようなユーザーが独自に PowerCube を作成できるようになります。

v IBM Cognos Analytics データ・ソースまたは IBM Cognos Series 7 IQD データ・ソースにアクセスするために使用される Transformer コンピューターに、データベース・クライアント・ソフトウェアをインストールするかモデル作成者がインストールできるようにする。

v モデル作成者に、IBM Cognos Administration でデータ・ソースを作成する権限を付与する。

IBM Cognos Administration に直接アクセスする権限をモデル作成者に付与する必要はありません。モデル作成者は、Transformer またはコマンド行ツールを使用して、データ・ソースの作成と更新を行えます。PowerCube パッケージの発行として、ポータル内のセキュリティー保護されたフォルダーをモデル作成者に提供できます。

v 作成した PowerCube を格納する場所へのアクセス権をモデル作成者に付与する。

この格納場所は、IBM Cognos サービスからもアクセス可能である必要があり、LAN 上のセキュリティー保護された共有の場所にすることができます。

v 特定の Transformer サーバー上で PowerCube を構築する場合は、モデルを転送するための FTP 権限と、そのサーバーでキューブを作成するための実行権限をモデル作成者に付与する。

モデル作成者は、スクリプトを使用してモデルの転送とキューブの作成を実行できます。また、自動化された方法で PowerCube を作成することもできます。詳細については、「管理およびセキュリティー・ガイド」を参照してください。

設定要件

PowerCube パッケージを発行するには、ディスパッチャーと直接または専用ゲートウェイ経由で通信できるように、Transformer を設定する必要があります。IBMCognos Connection がセキュリティーで保護されている場合は、ポータルでデータ・ソースを作成してパッケージを発行する権限が必要になります。

Transformer をインストールしたコンピューターでは、次の環境プロパティーを設定してください。

v ゲートウェイ URI



モデル作成ツールが直接ディスパッチャーと通信する代わりに、専用のゲートウェイを使用している場合は、専用のゲートウェイ・コンピューターでも「ゲートウェイ用ディスパッチャー URI」プロパティーを設定する必要があります。

Cognos Mobile の配布オプションIBM Cognos Mobile は、IBM Cognos Analytics アーキテクチャーの統合コンポーネントです。IBM Cognos Mobile のコンポーネントは、すべてを 1 台のコンピューターにインストールすることも、ネットワーク上に分散してインストールすることもできます。

Cognos Mobile は、以下のコンポーネントで構成されます。

v アプリケーション層コンポーネント

v Cognos Mobile アプリ

Cognos Mobile アプリケーション層コンポーネントを Cognos Analytics アプリケーション層コンポーネントと一緒にインストールする必要があります。

必要なすべてのコンポーネントはデフォルトでインストールされ、使用可能にされます。

単一のコンピューター上にインストールされる Cognos Mobileコンポーネント

単一のコンピューター上に IBM Cognos Mobile をインストールして構成できます。

次の図は、すべてのサーバー・コンポーネントが 1 台のコンピューターにインストールされる例を示しています。


複数の異なるコンピューター上にインストールされる CognosMobile コンポーネント

IBM Cognos Mobile コンポーネントの配布に使用するインストールおよび構成の方法は、IBM Cognos Analytics コンポーネントの配布に使用する方法と同じです。

各コンピューターでインストールを実行してから、配布された IBM CognosAnalytics コンポーネントの場所を指定して、構成を完了します。

分散インストールでは、Cognos Mobile アプリケーション層コンポーネントを、Cognos Mobile サービスを実行する複数のシステム上にインストールします。

IBM Cognos Mobile サービスのすべてのインスタンスは、IBM Cognos Mobile テーブルが保管されたデータベースにアクセスできることが必要です。 IBM CognosAnalytics サーバー・インスタンスが IBM Cognos Content Store のデータベース詳細によって構成されていない場合、または IBM Cognos Mobile が IBM CognosContent Store 以外のデータベース・インスタンスを使用するようにする場合は、IBM Cognos Configuration を使用してデータベースを追加します。

IBM Cognos Analytics と他の IBM Cognos 製品との共存IBM Cognos Analytics は、別の IBM Cognos 製品がある環境にインストールすることができます。

IBM Cognos Analytics のインストール・ウィザードでは互換性のあるディレクトリーが認識され、競合が発生すると警告が表示されます。IBM Cognos Analytics

図 5. 単一のコンピューター上にインストールされる Cognos Mobile サーバー・コンポーネント


のインストール後には、IBM Cognos Analytics から別の IBM Cognos 製品で作成されたオブジェクトにアクセスできます。アクセスの要件は、2 つの製品を実行する方法によって異なります。

複数の製品を使用する場合に重複するサービス

多くの IBM Cognos 製品では、Report サービスと Presentation サービスのように、類似のサービスが使用されます。 IBM Cognos Analytics を IBM CognosPowerPlay® とともに使用するなど、複数の製品を使用している場合は、重複しているサービスのいくつかを無効にし、それらの製品が正常に機能するようにする必要があります。

例えば、IBM Cognos Analytics と IBM Cognos PowerPlay とがインストールされているとします。両方の製品には、Report サービスおよび Presentation サービスがあります。両方の製品に同じゲートウェイからアクセスした場合、IBM CognosAnalytics サービスで実行する必要のあるレポートが、IBM Cognos PowerPlay サービスに経路指定される可能性があります。結果として、レポートでエラーが表示される可能性があります。

IBM Cognos Analytics との相互運用が可能な IBM Cognos 製品

IBM Cognos 製品の中には、IBM Cognos Analytics では提供されていない機能を備えているものがあります。これらの製品は IBM Cognos Analytics と同じ環境で使用できます。一部の製品と組み合わせると、IBM Cognos Analytics ポータルで異なるタイプのキューブやレポートにアクセスできるようになります。それ以外の製品では、IBM Cognos Analytics ポータル独自の機能にアクセスできます。

Cognos Planning - Analyst

Generate Framework Manager Model ウィザードを使用すると、発行済みのプラン・データに IBM Cognos Analytics でアクセスできます。この場合、IBMCognos Planning - Analyst 7.3 MR1 以降が必要です。

この製品を IBM Cognos Analytics サーバーと組み合わせて使用する場合は、両方の製品が同じバージョンになるようにする必要があります。

詳細については、「IBM Cognos Analyst User Guide」を参照してください。

Cognos Planning - Contributor

IBM Cognos Analytics - Contributor Data Server コンポーネントをカスタム・インストールすると、未発行のリアルタイム Contributor キューブに IBM CognosAnalytics でアクセスできます。このコンポーネントは、IBM Cognos Planning -Contributor 7.3 MR1 以降のリリースに含まれています。Contributor の GenerateFramework Manager Model 管理拡張を使用すると、発行済みのプラン・データにIBM Cognos Analytics でアクセスできます。この場合、IBM Cognos Planning -Contributor 7.3 MR1 以降が必要です。


この製品を IBM Cognos Analytics サーバーと組み合わせて使用する場合は、両方の製品が同じバージョンになるようにする必要があります。IBM Cognos Planningを 64 ビット版 IBM Cognos Analytics と同じパスにインストールすることはできません。

詳しくは、「IBM Cognos Contributor Administration Guide」を参照してください。

Cognos Controller

IBM Cognos Controller のインストール時に作成した定義済みの FrameworkManager モデルを使用すると、IBM Cognos Analytics にアクセスして、IBMCognos Controller Standard Reports を作成できます。また、発行済みのController データや構造に Framework Manager でアクセスし、カスタム・レポートの作成や分析を行えます。

Cognos Transformer

Transformer 7.3 以降のリリースで作成した IBM Cognos PowerCube やTransformer モデルは、そのまま IBM Cognos Analytics で使用できます。キューブやモデルには上位互換性があり、移行やアップグレードのツールは不要です。IBM Cognos Analytics では、IBM Cognos PowerCube を使用したレポートや分析を実行できます。

IBM Cognos Analytics で Transformer の新しい統合機能を使用したい場合、IBMCognos Series 7.x Transformer モデルを IBM Cognos Analytics Transformer 8.4以降にアップグレードすることができます。これにより、IBM Cognos Analyticsデータ・ソース (発行されたパッケージなど) を使用したり、Query Studio またはReporting で作成されたレポートをリスト表示したり、IBM Cognos Analytics のセキュリティー機能を使用して認証したり、ポータルに直接発行したりできるようになります。

モデルをロードするには、IBM Cognos Analytics で IBM Cognos Series 7 ネームスペースを設定しておく必要があり、IBM Cognos Analytics での設定に使用される名前 ID は IBM Cognos Series 7 で使用される名前と一致している必要があります。

IBM Cognos Series 7 の保護された PowerCube のアップグレードの詳細については、「IBM Cognos Analytics Transformer ユーザー・ガイド」を参照してください。

IBM Cognos Series 7 PowerCube を IBM Cognos Analytics で使用する場合、IBM Cognos Analytics に用意されている pcoptimizer ユーティリティーを実行して、IBM Cognos Analytics での使用のためにキューブを最適化します。これを行わないと、以前のバージョンの Transformer で作成した PowerCube を IBMCognos Analytics の Studio/Authoring ツールで開くときに、時間がかかる場合があります。この最適化ユーティリティーは、Transformer 8.4 よりも前のバージョンで作成された古い PowerCube 向けのユーティリティーで、モデルにもデータ・ソースにもアクセスする必要がありません。Transformer 8.4 以降で作成されたキューブに対してこのコマンド行ユーティリティーを実行する必要はありません。PowerCube の最適化の詳細については、「Transformer ユーザー・ガイド」を参照してください。


PowerCube、Transformer 8.4 または Framework Manager を使用して発行するか、あるいは IBM Cognos Analytics ポータルに直接発行することがきます。1 つの PowerCube のデータ・ソースおよびパッケージをポータルに発行できます。これは、Transformer を使用して対話的に行うことも、コマンド行を使用して行うこともできます。また、PowerCube を作成した後で、バッチ・スクリプトを使用してサイレント・モードで発行することもできます。ポータルでデータ・ソースおよびパッケージを作成する権限があるユーザーは、ポータルで PowerCube を発行することもできます。MDC ファイルは、IBM Cognos Analytics ディスパッチャーとレポート・サーバー・プロセスがアクセスできるセキュリティー保護された場所に格納されている必要があります。PowerCube 定義が異なる複数の PowerCube や別のデータ・ソースと PowerCube を組み合わせて使用しているパッケージは、Framework Manager を使用して発行する必要があります。

IBM Cognos Series 7 の PowerCube をデータ・ソースとして使用する場合、IBMCognos Analytics により、PowerCube が作成されたシステムで使用されていたエンコード方式からキューブのデータが変換されます。変換が成功するためには、PowerCube に含まれるデータと同じシステム・ロケールで IBM Cognos Series 7の PowerCube が作成されている必要があります。

Cognos Lifecycle Manager

Lifecycle Manager は、Cognos 8 以上から新しいバージョンの IBM CognosAnalytics へのアップグレードを監査する、Windows ベースのアプリケーションです。 2 つの異なる IBM Cognos Analytics リリースからのレポート結果を検証、実行、比較する検証機能を有しています。これは、リリース間のアップグレードや互換性の問題を識別するために役立ちます。ユーザー・インターフェース・デザインとステータス・レポート作成機能により、アップグレード・プロジェクトを計画し、ステータス・レポートを作成するための、実証済みの実行プロセスとサポートを利用できます。

詳しくは、「IBM Cognos Lifecycle Manager User Guide」を参照してください。

Planning Analytics

IBM Planning Analytics は、ビジネス計画、パフォーマンス測定、運用データを統合しています。そのため、企業は地理的状況や構造的状況に関係なく、ビジネスの効果性や顧客との対話を最適化することができます。 Planning Analytics を使用すれば、データを即座に可視化し、協同プロセス内の責任を明確にして、一貫した情報を表示できるので、経営陣は運営の変動を迅速に安定化させ、新しいビジネス・チャンスを活用することができます。

詳細については、IBM Planning Analytics の資料を参照してください。


第 3 章 IBM Cognos Analytics のアップグレード

IBM Cognos Analytics の新しいバージョンでの拡張機能は、ビジネス・インテリジェンス環境の多くの部分に影響を与える可能性があります。そのため、アップグレードは段階ごとに行うことが最善です。成功させるためには、アップグレードを綿密な計画、十分な時間、十分なリソースを必要とする IT プロジェクトとして扱う必要があります。

Cognos Upgrade Central Web サイト

Cognos Upgrade Central の Web サイト (www-01.ibm.com/support/docview.wss?uid=swg22011664) では、アップグレードに役立つ追加情報が記載されています。例えば、よくある質問、デモンストレーション・ビデオ、追加リソースへのリンクが Web サイトで提供されています。

アップグレード処理すべてのアップグレードには計画が必要で、各計画は同じ基本的なアップグレード・プロセスに従います。

アップグレードの計画を作成して、作業の各段階で必要な処理を理解する必要があります。計画段階では、アップグレード・ドキュメントを読み、予想される動作、新機能、サポート対象外の機能、バージョン間の互換性、実働環境を準備するための要件に関する情報を確認します。これらの確認が終了したら、サイトを調査してBI の構造、アプリケーション、レポート、カスタム構成設定を確認します。最後に、本格的なアップグレードの前に、データのサブセットを使用してアップグレードをテストし、レポートおよびデータを微調整します。

アップグレードを計画する際、必ず以下のタスクを行ってください。

v 各段階で必要な入力データや予想される出力など、必要な情報を収集する。

v レポート作成環境でアプリケーションを評価し、類似したレポートを同じグループにまとめる。

v 新規ソフトウェアをテスト環境にインストールし、コンテンツをテスト環境に配布する。

v アップグレード後のアプリケーションをテストして、レポートが予想どおりに実行されることを確認する。

Lifecycle Manager を使用して、異なるバージョンの IBM Cognos Analytics からのレポートを比較できます。詳しくは、Lifecycle Manager のドキュメントを参照してください。

配布およびテストは反復して行うのが一般的です。ソース環境とターゲット環境との間に差異がある場合はそれを評価します。配布されたアプリケーションがビジネス要件を満たすことが確認できたら、実働環境に移動します。

41

http://www-01.ibm.com/support/docview.wss?uid=swg22011664

次の図には、一般的なアップグレードのワークフロー、およびアップグレード処理の各段階が示されています。プロセスには、以下の段階が含まれます。

v アップグレード計画を作成します。これには以下のアクティビティーが含まれます。

– ドキュメントや Upgrade Central の Web サイト (www.ibm.com/support/docview.wss?uid=swg22011664)、および http://www-01.ibm.com/support/docview.wss?uid=swg21994915 にあるアップグレード手順などのリソースの確認。

– IBM ソフトウェア互換性レポート (www.ibm.com/support/docview.wss?uid=swg27047186)にアクセスしてサポートされる環境を調べ、使用する他のソフトウェアとの互換性を確認する。オペレーティング・システムのアップグレードを検討している場合も、このページを参照できます。

– 新しいバージョンの製品に何を移動するかを決めるための、既存のシステムの評価。

– アップグレード戦略を実装するための詳細な計画の作成。

v 新しいバージョンの製品での開発またはテスト・システムの作成。

v 開発またはテスト・システムから習得した情報の使用、および QA システムや実動システムを作成する際のその適用。






ドキュメントの確認アップグレードを正常に行えるように、さまざまなソースからの役立つ資料が提供されています。

すべての資料は、IBM Cognos Knowledge Center (http://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.cbi.doc/welcome.html) からオンラインで利用できます。

アップグレードの前に環境内のアプリケーションを評価するアップグレードの準備は、既存のアプリケーションを見直し、ソース環境をクリーンアップする機会になります。

図 6. アップグレード処理

第 3 章 IBM Cognos Analytics のアップグレード 43

http://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.cbi.doc/welcome.html

例えば、使用環境に多数のアプリケーションがある場合があります。しかし、使用されていないアプリケーションや要件に合わなくなったアプリケーションがいくつか見つかることも珍しくありません。

アプリケーションを評価すると、アップグレード中に検討するアプリケーションの数が少なくなるので便利です。

既存アプリケーションの監査には、次のような作業が含まれることがあります。

v 現在の実稼働環境を評価し、アップグレード時に注意が必要な領域を確認するために、サイト調査を行います。サイト調査には、インフラストラクチャー、アプリケーション、ユーザー、構成設定に関する情報を含めます。

v 環境内で使用するソフトウェアを評価して、オペレーティング・システム、Webサーバー、セキュリティー・プロバイダー、データベースなどのソフトウェアのリストを作成します。

オペレーティング・システム、パッチ、ブラウザー、Web サーバー、ディレクトリー・サーバー、データベース・サーバー、アプリケーション・サーバーなど、IBM Cognos Analytics 製品でサポートされる環境の最新のリストを確認するには、IBM ソフトウェア互換性レポート (www.ibm.com/support/docview.wss?uid=swg27047186) のページを参照してください。

v アプリケーションの詳細な評価を完了します。アプリケーションの用途、使用年数、サイズ、複雑さは、アップグレード計画を立てる上で考慮すべき重要な要素です。アプリケーションの合計サイズは、アップグレードを完了するまでに必要な時間に影響を与える場合があります。

v 設定に関する次の情報を収集する。

– IBM Cognos Configuration で有効にした構成設定

製品の新しいバージョンを既存のバージョンとは異なる場所にインストールすると、それら 2 つのバージョンの設定を比較することが可能になります。2 つのバージョンを実行するには、一意のポート番号と Web サーバー別名、および固有の Content Store データベースを使用する必要があります。

– 他の構成ファイルに対する変更

他の構成ファイルは、アップグレード中に手動で変更する必要があります。他の構成ファイルを変更した場合は、アップグレード後の環境でも維持したい変更を評価する必要があります。これには、 configuration、templates、webapps、および webcontent ディレクトリー内の、 .xml、.txt、および.css ファイルが含まれることがあります。

注: .ini ファイルを変更した場合、カスタマー・サポートに問い合わせて、それらの変更が新しいバージョンのソフトウェアでサポートされるかどうかを確認してください。

v Content Store データベースをバックアップします。

監査が完了した後に、アップグレード計画を作成できます。



オペレーティング・システムをアップグレードする際のガイドライン

IBM Cognos Analytics がインストールされたコンピューターのオペレーティング・システムをより新しいバージョンにアップグレードする前に、以下のガイドラインを検討してください。

v IBM ソフトウェア互換性レポート (www.ibm.com/support/docview.wss?uid=swg27047186)を参照して、IBM Cognos Analytics のバージョンが、移行先のオペレーティング・システムのバージョンをサポートしていることを確認します。

v IBM Cognos Analytics によって使用されるサード・パーティー製ソフトウェアが、提案されたオペレーティング・システムのバージョンでサポートされていることを確認します。サード・パーティー製ソフトウェアには、データベースとデータベース・ドライバー、アプリケーション・サーバー、Web サーバー、ブラウザーなどのコンポーネントが含まれます。

v IBM Cognos Analytics SDK アプリケーションを再コンパイルする必要があるかどうかを判別します。

v Web アーカイブ (.war) ファイルやエンタープライズ・アーカイブ (.ear) ファイルなどの Web デプロイメントを再作成する必要があるかどうかを判別します。

Cognos Analytics をアップグレードする際に保持されるファイルとフォルダー

以前のバージョンの構成設定を上書きせずに、実行中の現行バージョンの製品の上に、新しいバージョンの IBM Cognos Analytics をインストールすることができます。

アップグレード時に保持すべきファイルは、install_location¥configuration¥preserve¥.ca_base_preserve.txt ファイルにリストされています。このファイルを編集しないでください。アップグレード時に特定のファイルまたはディレクトリーを削除または保持するには、install_location¥configuration¥preserve¥preserve.txt ファイルの方を編集してください。 preserve.txt の使用方法に関する説明は、このファイル自体に含まれています。

ヒント: Cognos Analytics ファイル構造内に顧客がハード・リンクやソフト・リンクを作成することは、サポートされていません。

Cognos Analytics をアップグレードする際に、デフォルトで以下のフォルダーとファイルは保持されます。

フォルダーinstall_location¥data

install_location¥deployment

install_location¥drivers

install_location¥ldapschema

install_location¥informix

install_location¥configuration¥certs



install_location¥configuration¥csk

install_location¥configuration¥data

install_location¥webcontent¥bi¥alp¥images

install_location¥webapps¥p2pd¥WEB-INF¥AAA¥lib

設定ファイルinstall_location¥configuration¥cogconfig.prefs

install_location¥configuration¥cogconfig_reg.txt

install_location¥configuration¥coglocale.xml

install_location¥configuration¥cogstartup.xml

install_location¥configuration¥dispatcher.properties

install_location¥configuration¥install_gatewayurl.xml

install_location¥configuration¥installData.properties

install_location¥configuration¥ipfclientconfig.xml

install_location¥configuration¥configuration¥caSerial

install_location¥configuration¥xqe.diagnosticlogging.xml

各種ファイルinstall_location¥webapps¥p2pd¥WEB-INF¥web.xml

install_location¥wlp¥usr¥servers¥cognosserver¥bootstrap.properties

install_location¥wlp¥usr¥servers¥cognosserver¥jvm.options

install_location¥wlp¥usr¥servers¥cognosserver¥server.xml

install_location¥cgi-bin¥web.config

install_location¥webcontent¥web.config

install_location¥webcontent¥default.htm

install_location¥webcontent¥index.html

install_location¥webcontent¥bi¥web.config

TM1 ファイルinstall_location¥templates¥ps¥portal¥variables_TM1.xml

install_location¥templates¥ps¥portal¥variables_plan.xml

install_location¥templates¥ps¥portal¥icon_active_application.gif

install_location¥webcontent¥planning.html

install_location¥webcontent¥tm1¥web¥tm1web.html

install_location¥templates¥ps¥system.xml

install_location¥templates¥ps¥portal¥system.xml

PowerPlay ファイルinstall_location¥webcontent¥skins¥series7¥ppwb

install_location¥webcontent¥skins¥presentation¥ppwb

install_location¥webcontent¥skins¥modern¥ppwb


install_location¥webcontent¥skins¥corporate¥ppwb

install_location¥webcontent¥skins¥contemporary¥ppwb

install_location¥webcontent¥skins¥classic¥ppwb

install_location¥webcontent¥skins¥business¥ppwb

install_location¥webcontent¥bi¥skins¥series7¥ppwb

install_location¥webcontent¥bi¥skins¥presentation¥ppwb

install_location¥webcontent¥bi¥skins¥modern¥ppwb

install_location¥webcontent¥bi¥skins¥corporate¥ppwb

install_location¥webcontent¥bi¥skins¥contemporary¥ppwb

install_location¥webcontent¥bi¥skins¥classic¥ppwb

install_location¥webcontent¥bi¥skins¥business¥ppwb

install_location¥webcontent¥bi¥ppwb

install_location¥webcontent¥ps¥powerplaystudio

install_location¥webcontent¥fragments¥ppesAdmin

install_location¥webcontent¥ppwb

install_location¥webapps¥p2pd¥WEB-

INF¥fragments¥applications¥cogadmin¥pages¥ppesAdminPage.xml

install_location¥webapps¥p2pd¥WEB-

INF¥fragments¥applications¥cogadmin¥fragments¥ppesAdmin.xml

install_location¥msgsdk¥ppesAdminStrings_en.xml

install_location¥msgsdk¥ppesAdminStrings_ldkspec.xml

install_location¥eclipse¥plugins¥org.eclipse.equinox.cm_1.0.400.v20120522-

1841.jar

install_location¥eclipse¥plugins¥org.eclipse.equinox.ds_1.4.1.v20120926-

201320.jar

install_location¥eclipse¥plugins¥org.eclipse.equinox.event_1.2.200.v20120522-

2049.jar

install_location¥eclipse¥plugins¥org.eclipse.equinox.util_1.0.400.v20120917-

192807.jar

install_location¥eclipse¥plugins¥org.eclipse.osgi.services_3.3.100.v20120522-

1822.jar

install_location¥eclipse¥plugins¥org.eclipse.osgi.util_3.2.300.v20120913-

144807.jar

LCM ファイルinstall_location¥wlp¥usr¥servers¥lcm¥server.xml

install_location¥project

install_location¥benchmarks

install_location¥configuration


これらのファイルやフォルダーを手動で移行する必要があるのは、以下の場合に限られます。

v 新しいディレクトリーに新しいバージョンをインストールしようとしている。

v 現行バージョンをアンインストールして、新しいバージョンをインストールしようとしている。

現行バージョンをアンインストールすると、install_location ディレクトリーが完全に削除されます。

アップグレード作業アップグレードするとき、以下の作業を行います。

1. 新しいバージョンの製品をインストールして構成する。

2. コンテンツを新しいバージョンの製品に移動する。

3. レポート仕様をアップグレードする

4. アップグレードしたコンテンツを既存のコンテンツと比較して整合性を確認する。

新しいバージョンの製品のインストールと構成新しいバージョンの製品を新しい場所にインストールする。その場所は、既存のバージョンの製品と同じコンピューター上にすることも、別のコンピューター上にすることもできます。

新しい場所にインストールすると、既存のバージョンの製品を維持して、新しいバージョンの製品とは別に実行することが可能になります。これは、既存のバージョンに影響を与えないで新しいバージョンをテストするのに役立ちます。バージョン間の構成設定を比較することや、両方の環境でレポートの外観や機能を比較して同じであることを確認することもできます。

同一コンピューター上における IBM Cognos Analytics の複数バージョン/インスタンスの実行:

IBM Cognos Analytics の複数のバージョンまたはインスタンスを同じコンピューター上で実行するには、設定を変更して、それらのバージョンがポート番号や他のリソースを共有しないようにする必要があります。

複数のバージョンを同じコンピューターで実行するために必要な設定の変更

同じコンピューターで IBM Cognos Analytics の複数のバージョンを実行するには、それぞれのインストールが固有のものであることを確認します。それぞれのバージョンまたはインスタンスは、別々のディレクトリーにインストールする必要があります。以下の設定プロパティーの構成設定に関して、バージョンごとに異なる設定を使用する必要があります。

ポートと URI の設定

デフォルトのアプリケーション・サーバーを使用している場合は、ポートの競合を回避するために 9300 以外のポート番号を使用する必要があります。IBM Cognos Analytics はポート番号の範囲を予約するので、ポート番号のオフセットを少なくとも 100 にしてください。例えば、IBM Cognos


Analytics の 1 つのインスタンス用にデフォルト・ポート番号 9300 を使用するとします。同じコンピューター上の 2 番目のインストールでは、ポート番号を少なくとも 9400 以降に変更する必要があります。両方のインストール済み環境で同じポート番号を使用しないでください。

次のポートを変更します。

v ゲートウェイ用ディスパッチャー URI

v 外部ディスパッチャー URI

v 内部ディスパッチャー URI


v Content Manager URI

v ローカル・ログ・サーバーのポート番号

IBM Cognos Analytics に備わっているものとは異なるアプリケーション・サーバー上に製品をインストールする場合、新しいアプリケーション・サーバー・プロファイル (または既存のバージョンとは異なるインスタンス) に新しいバージョンを必ずインストールしてください。

Content Storeインストールごとに異なる Content Store またはスキーマを使用します。アップグレード後にコンテンツを戻すことはできません。より新しいバージョンの IBM Cognos Analytics に対して、既存の Content Store のコピーをリストアしたものを使用できます。より新しいバージョンの製品は、サービスの開始時にコンテンツをアップグレードします。

オプションの Web サーバーの仮想ディレクトリー

IBM Cognos Analytics の静的コンテンツを表示するには、バージョンごとに Web サーバーの仮想ディレクトリーが異なっている必要があります。Cognos Configuration でゲートウェイ URI を更新し、仮想ディレクトリーの名前を反映させてください。

例えば、デフォルトの仮想ディレクトリーは http://<サーバー名>/ibmcognos です。同じコンピューター上に 2 つのゲートウェイがインストールされている場合、どちらかのゲートウェイの ibmcognos 仮想ディレクトリーを変更する必要があります。

アプリケーション・プール (Microsoft IIS Web サーバー)cognosisap.dll を使用する場合、それぞれのゲートウェイは別のアプリケーション・プールを使用する必要があります。

サービスを開始するユーザー・アカウント (オプション)トラブルシューティングの際に、ユーザー・アカウントを変更すると役立つことがあります。例えば、所有者によって Java プロセスをトラブルシューティングすることができます。

同じサーバー上の複数のバージョンで同一の構成設定

同じコンピューターで実行される IBM Cognos Analytics の複数のインスタンスまたはバージョンは、同じリソース (メモリー、ネットワーク、ディスク・スペースなど) を使用します。


複数のバージョンの IBM Cognos は、両方のバージョンに同じ認証ソースを使用できます。ネームスペースには同じプロパティーを設定できます。

カスタマイズした設定ファイル

設定ファイルを手作業で編集した場合、その変更内容を再適用する必要があります。アップグレード後に再適用できるように、カスタマイズ内容を記録しておいてください。必要に応じて、元のバージョンが復元できるように、これらのファイルをバックアップする必要もあります。

system.xml ファイルの中には、IBM Cognos Analytics の Presentation サービスによって自動的にアップグレードされるファイルもあります。system.xml ファイルに大幅なカスタマイズを行った場合、アップグレードの後に変更内容を手作業で再適用する代わりに、この自動アップグレード機能を使用できます。system.xml ファイルを以前のバージョンの製品のファイルに置き換えることにより、ファイルは最新のバージョンの製品によってアップグレードされます。自動アップグレードは、IBM Cognos サービスの開始時に適用されます。

自動アップグレードがサポートされている system.xml ファイルは、次のディレクトリーにあります。

v install_location/templates/ps

v install_location/templates/ps/portal

v install_location/templates/ps/qs

1 つのコンピューター上で IBM Cognos Analytics の 2 番目のインスタンスを設定する:

1 つのコンピューター上に IBM Cognos Analytics の複数のインスタンスがある場合、ポート、Web サーバー仮想ディレクトリー、および Content Store データベースについて、各インスタンスを一意の値で設定する必要があります。

始める前に

新しいバージョンの製品では、新しい Content Store が必要になります。 ContentStore 全体をアップグレードする場合、既存の Content Store のバックアップからContent Store を作成します。配布アーカイブを使用してコンテンツを移動する場合、ブランクの Content Store データベースを作成できます。

新しいバージョンの製品を設定する前に、新しい Content Store データベースが配置されていることを確認してください。

重要: Content Store のバックアップに接続する場合、IBM Cognos サービスを初めて開始するときに、レポートのアップグレードを求めるプロンプトが出されます。レポートのアップグレードには長い時間がかかることがあるので、新しいバージョンの実行が開始した後にそれらをアップグレードする方が優れています。後にIBM Cognos Administration を使用してレポートをアップグレードできます。

手順

1. IBM Cognos Analytics の新しいインスタンスの場合、IBM CognosConfiguration を起動します。


2. 「エクスプローラー」ウィンドウで、「環境」をクリックします。

3. 以下の設定でのポート番号が、IBM Cognos Analytics の他のインスタンスまたはバージョンと競合しないことを確認してください。

v ゲートウェイ用ディスパッチャー URI

v 外部ディスパッチャー URI

v 内部ディスパッチャー URI


v Content Manager URI

4. 「ゲートウェイ URI」が、IBM Cognos Analytics の他のインスタンスまたはバージョンとは異なる仮想ディレクトリーまたは別名を使用するようにします。

5. 「ログ記録」をクリックして、「ローカル・ログ・サーバーのポート番号」が一意であることを確認します。

6. Portal Services を使用している場合は、次の手順で applications.xml ファイルの場所を更新します。

v 「エクスプローラー」ウィンドウで、「環境」>「Portal Services」の順にクリックします。

v 「プロパティー」ウィンドウで、「'applications.xml' の場所」プロパティーのポート番号がその他の URI プロパティーのポート番号と一致することを確認します。

7. 「エクスプローラー」ウィンドウの「データ・アクセス」>「ContentManager」で、IBM Cognos Analytics の他のインスタンスまたはバージョンで使用される Content Store と同じものを使用しないでください。

8. 設定を保存し、IBM Cognos Analytics を起動します。

コンテンツを新しいバージョンの製品に移動するコンテンツを移動するには 2 つの方法があります。コンテンツ・ストア全体を移動するか、配布アーカイブを作成してコンテンツを移動することができます。

Content Store 全体を移動する

この方法では、既存の Content Store のバックアップを作成してから、そのバックアップを新しい Content Store に復元することが必要になります。その後、新しいバージョンの製品を復元された Content Store に接続すると、製品は ContentStore を新しいバージョンにアップグレードします。

この方法では、すべてのセキュリティーおよびユーザーの設定が維持されますが、新しい Content Store データベースが必要となります。

セキュリティーを設定する際、アップグレード前のリリースと同じ値に一意の識別子を設定してください。そうしないと、セキュリティー設定が失われます。

アップグレードの前に Content Store で整合性検査を実行して、不整合がないことを確認してください。詳細については、「IBM Cognos Business Intelligence 管理およびセキュリティー・ガイド」の『Content Store の保守タスクの作成』というトピックを参照してください。


重要: この方法を使用すると、IBM Cognos サービスを初めて開始するときに、レポートのアップグレードを求めるプロンプトが出されます。レポートのアップグレードには長い時間がかかることがあるので、新しいバージョンの実行が開始した後にそれらをアップグレードする方が優れています。また、レポート仕様を作成、変更、または保存する Software Development Kit アプリケーションがある場合は、レポート仕様をアップグレードするオプションは選択しないでください。後で IBMCognos Administration を使用してレポートをアップグレードできます。

また、以前のバージョンの製品からディスパッチャーを登録抹消する必要があります。これは、サービスの開始後に IBM Cognos Administration を使用して行うことができます。

重要:

スナップショット・モード ( より以前) でアップロードされたファイルとデータ・モジュールは、ファイル・システムに保存されます。これらのデータ・ファイルは、Content Store やその他のデータベースには保管されません。これらのデータ・ファイルのデフォルト場所は、install_location¥data¥datafiles です。既存のインストールに対してアンインストールやアップグレードを実行する前に、必ず、これらのファイルをバックアップしておき、後で新しい場所に復元する必要があります。

配布アーカイブを作成してコンテンツを移動する

配布アーカイブを作成してコンテンツを移動できます。

この方法では特定のコンテンツを移動できますが、大きな Content Store の場合には時間がかかることがあります。

Content Store データベースのベンダーを変更する場合、コンテンツを移動するための配布を作成する必要があります。例えば、Content Store を Microsoft SQLServer から IBM Db2 に変更する場合は、これを配布アーカイブを使用して行う必要があります。

2 つの方法に関する考慮事項

アップグレード中に既存の NC テーブルを取得する要件はありません。システムによって再同期されます。キュー・テーブルを空にする要件があることを考慮し、アップグレードの実行中に既存の NC テーブルを使用することを避けてください。

アップグレードを実行する前に、NC テーブルは完全に空にする必要があります。アップグレードする前に、適切な NC_DROP_Database_Type.sql を実行してください。

アップグレード処理の一環として、新しいバージョンでアプリケーションが予想どおりに作動することを確認します。場合によっては、バージョンの変更により、予期しない結果が生じることがあります。アプリケーションを実稼働環境に移行する前に、それを新しいバージョンの製品でテストすることが重要です。


Content Store のアップグレードIBM Cognos Analytics は、そのサービスを初めて始動するとき、Content Store データベースを新しいバージョンの製品にアップグレードします。

Content Store を新しいバージョンの製品にアップグレードするプロセスには、以下のステップが含まれます。

1. 既存の Content Store データベースのバックアップを作成します。

2. バックアップからデータベースを作成します。

3. IBM Cognos Configuration で、新しいバージョンの製品をバックアップから作成した Cognos Configuration に接続します。

4. サービスを開始します。

始動プロセス中に Content Store がアップグレードされます。

ヒント: サービスを手動で再開する場合は、ApacheDS - cognos サービスを IBMCognos サービスよりも前に開始しておく必要があります (該当する場合)。

このプロセスにより、各バージョンにその Content Store がある、古いバージョンの製品と新しいバージョンの製品とを同時に使用できます。

この方法を使用すると、IBM Cognos サービスを初めて開始するときに、レポートのアップグレードを求めるプロンプトが出されます。レポートのアップグレードには長い時間がかかることがあるので、新しいバージョンの実行が開始した後にそれらをアップグレードする方が優れています。 IBM Cognos Administration を使用してレポートをアップグレードできます。また、レポート仕様を作成、変更、または保存する Software Development Kit アプリケーションがある場合は、レポート仕様をアップグレードするオプションは選択しないでください。

新しいバージョンの製品をバックアップから作成した Content Store に接続すると、 Content Store データベースはアップグレードされて、古いバージョンの製品では使用できなくなります。

以前のバージョンのディスパッチャーを Content Store から登録解除する:

既存の Content Store のバックアップを新しいバージョンの製品と共に使用する場合、ディスパッチャーを以前のバージョンから登録解除する必要があります。

手順

1. 「管理」 > 「管理コンソール」から、IBM Cognos Administration を開きます。

2. 「設定」をクリックしてから、「ディスパッチャーとサービス」をクリックします。

3. 「詳細」をクリックして、以前のバージョンに属するディスパッチャーを表示します。

4. 「登録解除」をクリックし、次に「OK」をクリックします。

ディスパッチャー情報が Content Store から削除されます。


配布アーカイブを使用してコンテンツを移動するContent Store から特定のコンテンツを移動するには、配布アーカイブを使用できます。配布アーカイブは、新しいバージョンの製品にインポートできる圧縮ファイルです。

重要: 既存の Content Store を復元することによりコンテンツを移動した場合、配布アーカイブを使用してコンテンツを移動する必要はありません。

配布アーカイブを使用してコンテンツを移動する手順には、以下が含まれます。

1. アーカイブを作成する。

2. アーカイブを新しいバージョンの製品にコピーする。

3. コンテンツをインポートする。

配布アーカイブの作成:

以下のタスクを使用して、配布アーカイブを作成します。

手順

1. 「IBM Cognos Administration」の「設定」タブで、「コンテンツ管理」をクリックします。

2. ツールバーで、「エクスポートの新規作成」アイコン

をクリックします。

3. アーカイブの「名前」を入力します。

4. アーカイブに含めるコンテンツを選択します。

v 特定のフォルダーやディレクトリーの内容をエクスポートするには、「共有フォルダーとディレクトリーの内容を選択」をクリックします。

v Content Store 全体をエクスポートするには、「Content Store 全体を選択」をクリックします。 Content Store 全体を選択する場合、「ユーザー・アカウント情報を含める」も選択できます。

5. 「次へ」をクリックします。

6. 「Content Store 全体を選択」をクリックした場合、コンテンツをインポートする際に使用するパスワードを入力して、「OK」をクリックします。

7. 「共有フォルダーとディレクトリーの内容を選択」をクリックした場合、以下を行います。

a. 「共有フォルダーの内容を選択」パネルで、「追加」をクリックします。

b. 「エントリーを選択」パネルの「使用できるエントリー」ボックスで、エクスポートするパッケージかフォルダーを選択します。

共有フォルダー階層を参照し、目的のパッケージかフォルダーを選択する

ことができます。「追加」アイコン

をクリックして、選択したアイテムを「選択されたエントリー」ボックスに移動し、「OK」をクリックします。

c. エクスポートするパッケージやフォルダーごとに次の操作を行い、「次へ」をクリックします。


v ターゲット環境のパッケージやフォルダーに変更を加えるには、「編

集」アイコン

をクリックし、変更を行って「OK」をクリックします。

v パッケージやフォルダー、およびそのエントリーに対するアクセスを禁止する場合は、「インポート後に無効化」列のチェック・ボックスをオンにします。この方法は、ターゲット環境で公開する前にレポートをテストする場合に便利です。

v 「オプション」で、出力レポート・バージョン、実行履歴、およびスケジュールを含めるかどうか、および競合が発生したときのエントリーの処理方法を選択します。

d. 「ディレクトリーの内容を選択」パネルで、任意のオプションを選択してから「次へ」をクリックします。

e. 「全般オプションを設定」パネルで、任意のオプションを選択してから「次へ」をクリックします。

f. 「配布アーカイブの指定」パネルで、リストから既存の配布アーカイブを選択するか、新規に作成します。

配布アーカイブに新しい名前を入力する場合は、名前にスペースを入れないでください。新しい配布仕様の名前が既存の配布アーカイブの名前と同じ場合は、既存の配布アーカイブが上書きされます。

8. 概要情報を確認し、「次へ」をクリックします。

9. 「操作」で、「保存して 1 回実行」を選択します。

10. 「オプションを指定して実行」パネルで、「今すぐ実行」を選択して「実行」をクリックします。

タスクの結果

配布アーカイブが、IBM Cognos Analytics をインストールした deployment ディレクトリーに作成されました。

配布アーカイブを新しいバージョンにコピーする:

配布アーカイブを、それらが作成されたインスタンスから新しいインスタンスに手動でコピーする必要があります。

手順

作成した配布アーカイブを、<古いバージョンのインストール場所>/deployment ディレクトリーから <新しいバージョンのインストール場所>/deployment ディレクトリーにコピーします。

注: deployment ディレクトリーは、 IBM Cognos Configuration で設定可能です。デフォルトで、その場所は <インストール場所>/deployment となります。別の場所を使用する場合、配布アーカイブを適切なディレクトリーにコピーしてください。


Content Store 全体の配布アーカイブをインポートするときに設定オブジェクトを含める:

Content Store 全体をインポートする際に、設定オブジェクトを含めることができます。例えば、ソース環境から取り入れるサービスについての一連の詳細設定があるために、設定をインポートする場合があります。

設定オブジェクトは、エクスポートには含まれますが、Content Store 全体のインポートの際はデフォルトでは、除外されます。設定オブジェクトには、ディスパッチャーやディスパッチャーのグループ化に使用する設定フォルダーなどがあります。

手順

1. 「IBM Cognos Administration」の「設定」タブで、「ディスパッチャーとサービス」をクリックします。

2. 適切なディスパッチャーをクリックします。

3. 「ContentManagerService」の横にある「プロパティーを設定」アイコンをクリックします。

4. 「設定」タブをクリックします。

5. 「値」列で、「編集」をクリックします。

6. 「親エントリーから取得した設定をオーバーライド」チェック・ボックスをオンにします。

7. 「パラメーター」列に、次のテキストを大文字で入力します。

CM.DEPLOYMENTINCLUDECONFIGURATION

8. 「値」列に、「true」と入力します。

9. 「OK」をクリックして終了します。

配布アーカイブのインポート:

エントリーをインポートするには、インポート配布仕様を作成します。

インポートを行う際には、エクスポートしたエントリーから選択します。エクスポートの際に設定したデフォルト・オプションをそのまま使用するか、または変更します。選択できるオプションは、エクスポートの際に配布アーカイブに含まれていたものです。

特定の共有フォルダーとディレクトリーの内容を部分的に配布する場合は、ターゲット環境におけるパッケージやフォルダーの有無と、存在する場合はそれらが最後に変更された日時がインポート・ウィザードに表示されます。この情報は、競合が発生したときの対応に使用できます。再配布の際には、パッケージとフォルダーが元の配布に含まれていたかどうかもウィザードに表示されます。

始める前に

配布アーカイブを新しいバージョンの製品の <インストールの場所>/deployment ディレクトリーにコピーしたことを確認してください。


手順

1. 新しいバージョンの製品で、「IBM Cognos Administration」の「設定」タブの「コンテンツ管理」をクリックします。

2. ツールバーの「インポートの新規作成」アイコンをクリックします。

3. 「配布アーカイブ」ボックスで、インポートする配布アーカイブを選択して、「次へ」をクリックします。

4. 配布アーカイブが Content Store 全体のものである場合、エクスポートの際に指定したパスワードを入力して、「OK」をクリックします。

5. インポートのための名前を入力し、保存先フォルダーを選択して、「次へ」をクリックします。

6. インポートに含める内容を選択し、オプションを選択して、「次へ」をクリックします。

ヒント: インポートされるコンテンツのターゲットの場所を変更する場合、パ

ッケージクリックの横の


7. 「全般オプションを設定」パネルで、任意のオプションを選択してから「次へ」をクリックします。

8. 概要情報を確認し、「次へ」をクリックします。

9. 「操作」で、「保存して 1 回実行」を選択して、「終了」をクリックします。

10. 「オプションを指定して実行」パネルで、以下を行います。

a. インポートの際にレポート仕様をアップグレードする場合は、「全レポート仕様を最新のバージョンにアップグレード」を選択します。このタスクは、コンテンツをインポートした後に実行することもできます。

b. 「実行」をクリックします。

Lifecycle Manager を使用して製品のバージョン間でレポートを比較するLifecycle Manager を使用すると、古い環境内のレポートを新しいバージョンの製品内のレポートと比較することによって、アップグレード済みコンテンツを検証できます。

詳しくは、IBM Cognos Lifecycle Manager のドキュメントを参照してください。

レポート仕様をアップグレードする:

レポート仕様は、IBM Cognos Analytics のあるバージョンから別のバージョンに変更することになります。以前のバージョンの製品で作成されたレポート仕様は、アップグレードする必要があります。

既存の Content Store のバックアップからアップグレードする場合、サービスを開始した後にレポート仕様をアップグレードする必要があります。

配布アーカイブを使用してコンテンツを新しいバージョンに移動する場合、インポート中にインポート仕様をアップグレードするように選択できます。


配布アーカイブを使用してコンテンツを移動した場合、レポート仕様をアップグレードするオプションを選択している可能性があります。インポートの際にレポート仕様をアップグレードした場合、それを繰り返す必要はありません。

始める前に

重要: レポート仕様を作成、変更、または保存する Software Development Kit アプリケーションがある場合は、レポート仕様をアップグレードしないでください。まず Software Development Kit アプリケーションを IBM Cognos レポート仕様スキーマに準拠するように更新する必要があります。この更新を実行しないと、使用している Software Development Kit アプリケーションがアップグレードされたレポート仕様にアクセスできなくなる場合があります。レポート仕様のアップグレードの詳細については、「IBM Cognos Software Development Kit Developer Guide」を参照してください。

手順

1. 「IBM Cognos Administration」を開きます。

2. 「設定」タブで、「コンテンツ管理」をクリックします。

3. ツールバーの「コンテンツ保守を新規作成」ボタン

の矢印をクリックし、「レポートのアップグレードを新規作成」をクリックします。

4. アップグレード・タスクの名前を入力し、必要に応じて説明や画面のヒントを入力します。「次へ」をクリックします。

5. アップグレードするレポート仕様のパッケージと場所を選択します。「次へ」をクリックします。

レポート仕様をパッケージ別にアップグレードする場合は、パッケージのモデルに基づく Content Store 内のすべてのレポートがアップグレードされます。レポート仕様をフォルダー別にアップグレードする場合は、フォルダー内のすべてのレポートがアップグレードされます。

6. 次のいずれかを選択します。

v 「保存して 1 回実行」を選択して、「オプションを指定して実行」ページを開きます。

v 「保存してスケジュール」を選択して、スケジュール設定ツールを開きます。

v 「保存のみ」を選択して、後で実行するためにアップグレードを保存します。

バージョン 11.0.3 から 11.0.4 以上にアップグレードする際の IISと Cognos Analytics のセットアップ

始める前に

このトピックでは、バージョン 11.0.3 環境を使用していて、IIS がセットアップされており、シングル・サインオンが機能していることを想定しています。


このタスクについて

このトピックでは、以下のように想定しています。

v IIS サーバー名: iis-host

v IIS ポート #: 80

v IIS 仮想ディレクトリー名: ibmcognos

v Cognos Analytics サーバー名: ca-host

v Cognos Analytics ポート #: 9300

手順

1. ご使用の 11.0.3 Content Store のバックアップを行います。

2. バージョン 11.0.4 をバージョン 11.0.3 のインストール済み環境の上にインストールします。必要に応じて、データ層、アプリケーション層、およびゲートウェイ層のマシンに対して実行してください。

3. Cognos Analytics サービスを開始する前に、環境に対して以下の変更を行います。

a. 次の項目を (データ層とアプリケーション層の)install_location¥wlp¥usr¥servers¥cognosserver¥server.xml ファイルから削除します: <jndiEntry jndiName="glass/sso/login"

value="/ibmcognos/cgi-bin/cognosisapi.dll"/>

b. gateway_install_location/webcontent フォルダー内の default.htm とindex.html を調べます。<meta http-equiv="refresh" content="0;

URL=bi/"> という行の URL=bi/ 属性に後続スラッシュ (/) が含まれているか確認します。

c. ゲートウェイ層で Cognos Configuration を起動します。次のフォーマットを使用するように、「環境」 > 「ゲートウェイ設定」 > 「ゲートウェイ用ディスパッチャー URI」を変更します: http://

<apptier_host>:<apptier_port>/bi/v1/disp

d. データ層およびアプリケーション層で Cognos Configuration を起動します。該当する「環境」 > 「ゲートウェイ設定」を変更します。

v ゲートウェイ URI: http(s)://iis-host:80/ibmcognos/bi/v1/disp

切断されたコンテンツ (PDF、Excel、アクティブ・レポートに組み込まれているリンクなど) の URL です。E メールで送信するリンクでも使用されます。

v ゲートウェイ用ディスパッチャー URI: http(s)://ca-host:9300/bi/v1/

disp

要求転送時の Cognos ISAPI コードの接続先 URI のリストです。フェイルオーバーのために複数のエントリーを使用できます。関連するCognos Analytics アプリケーション・サーバーをすべて含めてください。

v 外部アプリケーション用ディスパッチャー URI: http(s)://ca-

host:9300/bi/v1/disp


外部アプリケーション (Framework Manager など) は、この URL に接続して SDK 操作を実行します。

e. 135 ページの『Cognos Analytics 11.0.3 での IIS の設定』の手順に従って、IIS を再構成してください。

4. 次の順序でサービスを開始します: 1) データ層、2) アプリケーション層、3) ゲートウェイ層および IIS。


第 4 章サーバー・コンポーネントのインストールと設定

IBM Cognos Analytics のすべてのコンポーネントを 1 つのコンピューターにインストールすることも、分散インストール環境用の複数のサーバーにインストールすることも、パフォーマンスの改善のために既存の 1 つのコンピューターにあるインストール環境を別のサーバーに展開することもできます。

IBM Cognos Analytics をインストール・ウィザードからインストールするときには、以下のオプションを選択できます。

v 「簡易インストール (Easy install)」オプションを使用すると、追加の構成をしたり補助ソフトウェアをインストールしたりすることなく、ただちに IBMCognos Analytics の実行を開始できます。

重要: 「簡易インストール (Easy install)」は Windows OS 専用です。「簡易インストール (Easy install)」をアップグレードする場合 (つまり既存のインストール環境の上にインストールする場合)、まず Informix サービスや ApacheDSサービスなどのすべてのサービスを手動でシャットダウンします。

このインストール・オプションを使用すると、すべての構成が既に行われた状態の以下のものが提供されます。

– すべての新機能を含むフルバージョンの IBM Cognos Analytics ソフトウェア。

– インストールされ、Content Store データベースとして使用するために構成された Informix 12.10。

– ユーザーを作成して管理するための Apache Directory Server。

v 「カスタム」オプションを使用すると、インストールする IBM CognosAnalytics のコンポーネントを柔軟に選択できます。 IBM Cognos Analytics をサード・パーティー製のソフトウェアによってカスタマイズしたり統合したりする場合があります。その際には、このオプションを選択してください。

複数のコンポーネントを同じコンピューターにインストールする場合は、ポートやその他のデフォルト設定の競合を避けるために、同じ場所にインストールします。

カスタム・インストールを実行する場合、サーバー・コンポーネントは以下の層に収集されます。

v コンテンツ・リポジトリー (Content Manager)

v アプリケーション・サービス

v オプションのゲートウェイ層

各コンポーネントは、別のコンピューターにインストールすることも、同じコンピューターにインストールすることもできます。ゲートウェイは、Web サーバーも実行しているコンピューターにインストールする必要があります。

61

サービスを停止する手順

分散環境でサービスを停止する必要がある場合は、特定の手順に従うことが重要です。まず、アプリケーション層コンポーネントの IBM Cognos サービスを停止し、次に待機中の Content Manager、アクティブな Content Manager の順番に停止します。

また、次のものも停止することが重要です。

v IBM Cognos サービスに関連するアプリケーション (FrameworkManager、Cognos Transformer、または IBM Cognos Administration など)。

v 実行中の Software Development Kit アプリケーション。

インストールのアップグレード

IBM Cognos 製品の以前のリリースからアップグレードする場合は、 41 ページの『第 3 章 IBM Cognos Analytics のアップグレード』を参照してください。

以前のバージョンの IBM Cognos Analytics からアップグレードする場合、分散コンポーネントはすべて IBM Cognos Analytics と同じバージョンでなければなりません。IBM Cognos Analytics を新しいホストや代替のホストにインストールする場合、IBM Cognos Configuration の場所指定用のプロパティーを更新する必要があります。

64 ビットのインストール

IBM Cognos Analytics ゲートウェイでは、インストール先が 64 ビット・サーバーか 32 ビット・サーバーかに関係なく、32 ビット・ライブラリーが提供されます。一部の Web サーバー (Apache Web Server など) では、コンパイル済みの32 ビット・ライブラリーをコンパイル済みの 64 ビット・サーバーにロードできません。このような場合は、32 ビット・バージョンの IBM Cognos ゲートウェイを32 ビット Web サーバーにインストールします。

アプリケーション層コンポーネントに付属の Report Server コンポーネントは、32ビットと 64 ビットの両方のバージョンで提供されます。使用するバージョンの選択は、インストール後に IBM Cognos Configuration を使用して行います。デフォルトでは、Report Server コンポーネントは、64 ビット・コンピューター上でも、32 ビット・モードを使用するように設定されています。 64 ビット・モードでは動的クエリー・モード用に作成されたレポートのみ実行できるのに対し、32 ビット・モードではすべてのレポートを実行できます。

IBM Cognos Business Intelligence Controller バージョン 8.x、IBM CognosAnalytics Planning バージョン 8.x、IBM Cognos Business Intelligence Analysisfor Microsoft Excel バージョン 8.x など、他の IBM Cognos Analytics 製品の以前のバージョンが含まれる環境で IBM Cognos Analytics のアップグレードを行う場合、IBM Cognos Analytics の他の製品とは別の場所に新しいバージョンの IBMCognos Analytics をインストールし、他の IBM Cognos Analytics 製品から独立して実行されるように設定します。他の製品が IBM Cognos Analytics と互換性のあるバージョンにアップグレードされたら、これらの製品が同時に動作するように設定できます。


Windows インストール

Microsoft Windows オペレーティング・システム・インストールの場合、インストールする Windows コンピューターの管理者権限が必要になります。また、一時ファイルを保存するディレクトリーを指す TEMP システム変数が、コンピューターに設定されている必要があります。インストール時に、ディスクのファイルが、一時的にこのディレクトリーにコピーされます。

UNIX インストール

UNIX オペレーティング・システムのインストールの場合、グラフィカル・ユーザー・インターフェースを使用するかサイレント・インストールを実行することによって、サーバー・コンポーネントをインストールできます。グラフィカル・モードのインストールを実行するには、UNIX コンピューターに接続されているコンソールで、Java ベースのグラフィカル・ユーザー・インターフェースがサポートされている必要があります。

また、 IBM Cognos Analytics は 755 権限を使用します。この影響を受けるのは、インストール・ディレクトリーのみです。ディレクトリー内のファイルのアクセス権には、影響を与えません。

プリンターの要件

Windows 上でレポートが正しく印刷されるようにするには、Adobe Reader で、アプリケーション層コンポーネントがインストールされているオペレーティング・システム上で少なくとも 1 台のプリンターを設定する必要があります。選択した印刷形式に関係なく、すべてのレポートが一時 PDF ファイルとして印刷用に AdobeReader に送信されます。

アンインストール

アンインストールの手順については、 337 ページの『第 12 章 IBM CognosAnalytics のアンインストール』を参照してください。

サーバー・コンポーネントのインストールの順序分散インストールでは、コンポーネントを設定する順序が重要です。ContentManager をインストールした場所の少なくとも 1 つ以上でサービスを設定および開始した後、その他のサーバー・コンポーネントを設定します。

ゲートウェイ・コンポーネントは最後に設定する必要があります。これにより、3つのコンポーネント間で暗号鍵が共有され、安全に通信が行えるようになります。ゲートウェイ・コンピューターの「外部ディスパッチャー URI」プロパティーに指定されているサーバー・コンポーネントは、最後に起動する必要があります。

次の図に、分散コンポーネントのインストール・プロセスの順序を示します。環境を計画して準備したら、Content Manager コンポーネント、アプリケーション層コンポーネント、ゲートウェイの順にコンポーネントをインストールして設定します。サーバー・コンポーネントのインストールが完了したら、Framework Managerをインストールして設定します。

第 4 章サーバー・コンポーネントのインストールと設定 63

推奨 - 分散インストール環境における基本インストールでのインストールおよび設定

分散インストールを実行するときは、さまざまなインストール・オプションと設定オプションを使用して IBM Cognos Analytics をカスタマイズして、企業のインフラストラクチャーに合わせることができます。

最初に基本インストールを実行し、必要なサーバー・コンポーネント (データ層(Content Manager)、アプリケーション層コンポーネント、およびゲートウェイ層)のそれぞれのインスタンスを 1 つ以上インストールします。設定をカスタマイズする前に、分散コンポーネントが相互に通信するための設定など、必要な設定タスクのみを実行して分散環境を稼働してください。

その後、ビジネス・インテリジェンスのニーズにより適合するように、オプション・コンポーネントを追加し、設定をカスタマイズします。

図 7. 分散インストール・プロセスのワークフロー


コンピューターを設定する際は、順序が重要です。まず Content Manager がインストールされているコンピューターを少なくとも 1 台以上設定してサービスを設定してから、その他のサーバー・コンポーネントまたは Framework Manager を設定する必要があります。詳細については、 63 ページの『サーバー・コンポーネントのインストールの順序』を参照してください。

IBM Cognos Analytics を環境で稼働する最も簡単かつ迅速な方法は、その環境で基本インストールが機能するようにします。

インストール・モードインストールを完了するには、サーバーにコンポーネントをインストールしてから、それらのコンポーネントを環境で機能するように設定する必要があります。

対話モード

通常、IBM Cognos のインストール・プログラムと設定プログラムは、対話モードで実行します。つまり、ユーザーは、情報を指定するようにインストール・ウィザードから要求され、設定ツールでデフォルト設定を変更することができます。インストール・ウィザードは、 ca_srv_<platform>_<build>.exe (Windows) またはca_srv_<platform>_<build>.bin (UNIX、Linux) です。

サイレント・モード

応答ファイルを使用してインストール・プログラムをサイレント・モードで実行すると、コンポーネントのインストールを自動化することができます。

インストールしたコンポーネントが同じであれば、あるコンピューターから別のコンピューターに設定をエクスポートすることにより、コンポーネントの設定を自動化することができます。初回は IBM Cognos Configuration を対話モードで実行します。

または、環境に適用する設定を使用して"cogstartup.xml"ファイルを編集してから、設定ツールをサイレント・モードで実行する方法もあります。

UNIX システムの対話モード

サイレント・モードでのインストールを実行しない場合は、X Window System ワークステーション、X 端末、または X サーバー・ソフトウェアがインストールされた PC もしくはその他のシステムからインストールを実行します。

対話モードでインストールを実行するには、コンピューターに接続されているコンソールで、Java ベースのグラフィカル・ユーザー・インターフェースがサポートされている必要があります。

UNIX または Linux オペレーティング・システムでのサーバー・コンポーネントのインストール

インストール・ウィザードを使用して、インストールするサーバー・コンポーネントと、それらをインストールするコンピューター上の場所を選択します。


始める前に

IBM ソフトウェア互換性レポート (www.ibm.com/support/docview.wss?uid=swg27047186) に移動して、必要なパッチがコンピューターにインストールされていることを確認します。

手順1. Java Runtime Environment (JRE) のインストール場所を指すように

JAVA_HOME 環境変数を設定します (例えば /directory/java/java_version/jre)。

IBM Cognos Analytics を Linux オペレーティング・システムで実行するには、JVM が必要です。これは IBM などによって提供されています。

2. HP-UX では、_M_ARENA_OPTS 環境変数を _M_ARENA_OPTS 1:4 のように設定します。

これにより、HP-UX のメモリー割り当て量が増加し、他の UNIX プラットフォームのメモリー割り当て量に近くなります。

3. インストール・ファイルをダウンロードして解凍した場所に移動します。

ヒント: 新しいバージョンのファイル圧縮ソフトウェアを使用してファイルを解凍してください。古いバージョンのソフトウェアでは、ファイルが解凍されない可能性があります。

4. インストール・ウィザードを開始するには、オペレーティング・システムのディレクトリーに移動し、次のコマンドを入力します。

./ca_srv_<platform>_<build>.bin

ここで、<build> はビルド番号、<platform> は、win (Windows)、i386 (Linuxi386)、ppcle (Linux pl E)、ppc (Linux Power PC)、s390x (Linux z)、sol(Solaris)、aix (AIX)、および zos (z/OS) です。

ヒント: ./ca_srv_<platform>_<build>.bin コマンドを X Window で使用した場合、メッセージやログ・ファイルの日本語文字が文字化けすることがあります。 UNIX または Linux 上に日本語環境でインストールする場合、最初に環境変数を LANG=C および LC_ALL=C のように設定します。ここで、C は言語コード (例えば Solaris では ja_JP.PCK) を表します。次にインストール・ウィザードを起動します。

X Window を使用しない場合は、無人インストールを実行します。詳細については、 329 ページの『第 11 章無人インストール、無人アンインストール、および無人構成』を参照してください。

5. インストール・ウィザードの指示に従って、ファイルをコンピューターにコピーします。

パス名に ASCII 文字のみが含まれるディレクトリーにインストールします。一部の UNIX Web サーバーおよび Linux Web サーバーでは、ディレクトリー名に ASCII 以外の文字は使用できません。



ヒント: バージョン 11.0.7 以降の Cognos Analytics AIX インストール・キットでは、サンプルは使用できません。詳細については、この記事を参照してください。

6. インストール・ウィザードの「終了」ページで「表示」をクリックすると、ログ・ファイルにアクセスできます。 IBM Cognos Analytics をすぐに設定しないでください。IBM Cognos Analytics の設定を行う前に、使用環境が正しく設定されているかどうかを確認する必要があります。

7. インストールの場所/bin ディレクトリーを、次のいずれかのライブラリー・パス環境変数に追加します。

v Solaris と Linux の場合:LD_LIBRARY_PATH

v AIX の場合:LIBPATH

v HP-UX の場合:SHLIB_PATH

次のタスク

IBM Cognos Configuration を使用して IBM Cognos Analytics を設定できます。Cognos Configuration を開始するには、install_location/bin ディレクトリーでcogconfig.sh と入力します。

Windows オペレーティング・システムでのサーバー・コンポーネントのインストール

インストール・ウィザードを使用して、インストールするサーバー・コンポーネントと、それらをインストールするコンピューター上の場所を選択します。

Windows コンピューターでは、デフォルトのインストール場所として ProgramFiles ディレクトリーが使用されます。この場所にインストールする場合は、IBMCognos Configuration を管理者として実行していることを確認してください。そうでない場合は、Program Files 以外のディレクトリー (例えばC:¥IBM¥cognos¥analytics) に製品をインストールすることもできます。

インストールには、少なくとも 5 GB の一時ディレクトリーが必要です。一時ディレクトリーは、環境変数 TMP を使用して設定されます。

手順1. インストール・ファイルをダウンロードし解凍した場所に移動し、

ca_srv_<platform>_<build>.exe をダブルクリックします。


2. インストール時に使用する言語を選択します。

ここで選択した言語によって、ユーザー・インターフェースの言語が決まります。サポートされている言語はすべてインストールされます。インストール後に、インストールされている任意の言語にユーザー・インターフェースを変更することも可能です。




以下のいずれかのインストール・オプションを使用できます。

v 「簡易インストール (Easy install)」オプションを使用すると、コンポーネントを単一のコンピューターにインストールし、 Content Store のためのInformix データベースのインスタンスをインストールし、システムを設定することができます。

重要: 「簡易インストール (Easy install)」をアップグレードする場合 (つまり既存のインストール環境の上にインストールする場合) は、まず Informixサービスや ApacheDS サービスなどのすべてのサービスを手動でシャットダウンします。

v 複数のサーバーにコンポーネントをインストールする分散インストールの場合は、「カスタム」オプションを使用します。

パス名に ASCII 文字のみが含まれるディレクトリーに IBM Cognos Analyticsコンポーネントをインストールします。一部の Windows Web サーバーでは、ディレクトリー名に ASCII 以外の文字は使用できません。

4. これが最初のインストールである場合、「最初のインストール (First install)」オプションを選択します。実行中のインストール環境の機能を拡張するには、「接続してインストール (Connect and install)」オプションを選択します。次に、インストールするコンポーネント、および実行中のシステムの URL と資格情報を求めるプロンプトが出されます。ネームスペースと資格情報は、システム管理者のものでなければなりません。

v 実行中のインストール環境の URL 値は、IBM Cognos Configuration の「環境」 > 「ディスパッチャー設定」カテゴリーで確認できます。必要なURL 値は、「外部ディスパッチャー URI」です。

v 実行中のインストール環境のネームスペースは、IBM Cognos Configurationの「セキュリティー」 > 「認証」カテゴリーで確認できます。

コンテンツ・リポジトリーへの Content Manager のインストールと設定Content Manager を複数インストールすると、フェイルオーバーを行うことができます。また、Content Manager をその他のコンポーネントとは別の場所にインストールすると、パフォーマンスを高めることができます。

Content Manager のコンピューターでは、Content Store の場所、他の ContentManager コンポーネントの場所、および通知用データベースを認識する必要があります。

分散インストール環境で、IBM Cognos 環境内の他のコンピューターを設定するには、Content Manager をインストールしたコンピューターの少なくとも 1 台がすでに設定され、実行中で、アクセス可能な必要があります。これにより、ContentManager と同時にインストールされる認証局 Service を利用して、他のコンピューターに証明書を発行できるようになります。


インストール環境では、複数の Content Manager が異なるコンピューターにインストールされている場合があります。この場合、1 台の Content Manager コンピューターがアクティブで、残りのコンピューターが待機状態になります。

権限

ルートの権限または非ルートの権限を使用してインストールを実行できます。

また、IBM Cognos Analytics には、インストール・プログラムを実行するアカウントのファイル・モード作成マスク (umask) が関連します。この影響を受けるのは、インストール・ディレクトリーのみです。ディレクトリー内のファイルのアクセス権には、影響を与えません。ただし、ログなど実行時に生成されるファイルには、マスクが関連します。インストール・ディレクトリーには、umask 022 を推奨します。

設定の規則

複数の Content Manager コンポーネントがインストールされている環境、またはContent Manager が独立した場所にインストールされている環境では、1 つ以上のContent Manager を設定、実行、およびアクセス可能にしてから、環境内のその他のコンポーネントを設定する必要があります。これにより、Content Manager と同時にインストールされる認証局 Service を利用して、他の IBM Cognos のコンピューターに証明書を発行できるようになります。

分散コンポーネントのインストール・プロセスの順序については、 63 ページの『サーバー・コンポーネントのインストールの順序』を参照してください。

アクティブな Content Manager の規則

複数の Content Manager コンポーネントをインストールしている場合は、最初に起動した Content Manager コンピューターがデフォルトのアクティブな ContentManager になります。IBM Cognos Administration を使用すると、別の ContentManager コンピューターをデフォルトのアクティブな Content Manager として指定できます。

フェイルオーバー保護のために、これらの Content Manager コンピューターが待機状態となります。ソフトウェアまたはハードウェアの障害によってアクティブなContent Manager コンピューターが使用不可になった場合は、待機中の ContentManager コンピューターがアクティブになり、そのコンピューターに要求が転送されます。

アクティブな Content Manager に障害が発生すると、保存されていないセッション・データは失われます。別の Content Manager がアクティブになると、ユーザーはログオンするように要求されます。

Content Manager サービスをアクティブにする方法については、「管理およびセキュリティー・ガイド」を参照してください。アクティブおよび待機中の ContentManager コンポーネントについては、 70 ページの『アクティブおよび待機中のContent Manager コンポーネント』を参照してください。


複数の Content Manager を使用するインストールでは、デフォルト CGI ゲートウェイの代わりにコンパイル済みゲートウェイを使用するように IBM CognosAnalytics を設定します。例えば、Apache Server または IBM HTTP Server の場合は Apache モジュールを使用し、IIS の場合は ISAPI を使用します。設定しない場合、フェイルオーバー後のパフォーマンスに影響が出る可能性があります。

アップグレード

ReportNet または以前のバージョンの IBM Cognos Business Intelligence からアップグレードする場合は、既存の設定データを利用できます。ただし、IBM CognosAnalytics にはいくつかの新機能があり、設定が必要な場合もあります。

PowerCube

IBM Cognos Transformer のインストールを計画しており、IBM Cognos Series 7ネームスペースに対してセキュリティー保護された PowerCube を使用する場合は、IBM Cognos Series 7 をサポートするコンピューターに Content Manager をインストールする必要があります。

アクティブおよび待機中の Content Manager コンポーネントContent Manager はいくつでもインストールできますが、一度にアクティブになるのは 1 つのみです。その他の Content Manager は、バックアップ用として動作します。

待機中の Content Manager コンポーネントは、フェイルオーバー保護を目的としています。ソフトウェアまたはハードウェアの障害によってアクティブな ContentManager が使用不可になった場合は、待機中の Content Manager がアクティブになり、その Content Manager に要求が転送されます。

アクティブな Content Manager に障害が発生すると、保存されていないセッション・データは失われます。別の Content Manager がアクティブになると、ユーザーはログオンするように要求されます。

デフォルトでは IBM Cognos Analytics に最初にインストールされた ContentManager がアクティブになります。IBM Cognos Analytics サーバー管理者は、デフォルトの Content Manager とアクティブな Content Manager をいつでも変更できます。IBM Cognos Analytics が起動すると、デフォルトの Content Managerによって、他の Content Manager から Content Store へのアクセスがすべてロックされます。インストールされた他の Content Manager は待機モードに入ります。

フェイルオーバー機構が動作するのは、ディスパッチャーとアクティブな ContentManager とで相互に定期的な通信を行っているためです。ディスパッチャーからContent Manager への通信が不能になると、ディスパッチャーから待機中のContent Manager に信号が送信され、この Content Manager がアクティブになります。それ以外の Content Manager では待機モードの状態が維持され、フェイルオーバーのサポートが続行されます。待機中の Content Manager によって、アクティブの Content Manager から共通対称鍵 (データの暗号化と復号化に使用される) などの暗号化設定が取得されます。


複数の Content Manager をインストールする場合は、Content Manager 間で正常にフェイルオーバーされるように、Content Manager コンピューターのシステム・クロックが同期していることを確認する必要があります。

UNIX または Linux オペレーティング・システムでの ContentManager のインストール

次の手順に従って、UNIX または Linux オペレーティング・システムに ContentManager をインストールします。

始める前に


手順1. Java Runtime Environment (JRE) のインストール場所を指すように

JAVA_HOME 環境変数を設定します (例えば /directory/java/java_version/jre)。

IBM Cognos Analytics を Linux オペレーティング・システムで実行するには、JVM が必要です。これは IBM などによって提供されています。



3. インストール・ウィザードを開始するために、オペレーティング・システムのディレクトリーに移動して、./ca_srv_<platform>_<build>.bin と入力します。

ヒント: ca_srv_<platform>_<build>.bin コマンドを X Window で使用した場合、メッセージやログ・ファイルの日本語文字が文字化けすることがあります。UNIX または Linux 上に日本語環境でインストールする場合、最初に環境変数を LANG=C および LC_ALL=C のように設定します。ここで、C は言語コード (例えば Solaris では ja_JP.PCK) を表します。次にインストール・ウィザードを起動します。


4. インストール・ウィザードの指示に従って、ファイルをコンピューターにコピーし、基本的な設定を実装します。

v ディレクトリーを選択する場合は、次の点に注意してください。

パス名に ASCII 文字のみが含まれるディレクトリーに Content Manager をインストールします。一部の UNIX Web サーバーおよび Linux Web サーバーでは、ディレクトリー名に ASCII 以外の文字は使用できません。



以前のバージョンの IBM Cognos Analytics がインストールされているコンピューターに IBM Cognos Analytics をインストールする場合で、以前のバージョンも残すには、新しいバージョンを別のディレクトリーにインストールする必要があります。

v コンポーネントを選択するときに、「コンテンツ・リポジトリー」以外のすべてのコンポーネントの選択を解除します。

5. 「終了」をクリックします。





次のタスク

IBM Cognos Analytics をすぐに設定しないでください。IBM Cognos Analyticsの設定を行う前に、使用環境が正しく設定されているかどうかを確認する必要があります。

IBM Cognos Configuration を使用して、IBM Cognos Analytics を後で設定することも可能です。これを行うには、install_location/bin ディレクトリーでcogconfig.sh と入力します。

Windows オペレーティング・システムでの Content Managerのインストール

次の手順に従って、Microsoft Windows オペレーティング・システムに ContentManager をインストールします。


インストールには、少なくとも 5 GB の一時ディレクトリーが必要です。一時ディレクトリーは、環境変数 TMP を使用して設定されます。

始める前に


手順1. インストール・ファイルをダウンロードし解凍した場所に移動し、

ca_srv_<platform>_<build>.exe をダブルクリックします。






3. 「カスタム」インストール・オプションを選択し、インストール・ウィザードの指示に従ってファイルをコンピューターにコピーします。


パス名に ASCII 文字のみが含まれるディレクトリーに Content Manager をインストールします。一部の Microsoft Windows オペレーティング・システムの Web サーバーでは、ディレクトリー名に ASCII 以外の文字は使用できません。

以前のバージョンの IBM Cognos Analytics がインストールされているコンピューターに IBM Cognos Analytics をインストールする場合で、以前のバージョンも残すには、IBM Cognos Analytics を別のディレクトリーにインストールする必要があります。

v コンポーネントを選択するときに、「カスタム」インストール・オプションから「コンテンツ・リポジトリー」以外のすべてのコンポーネントの選択を解除します。


次のタスク

インストール・ウィザードから IBM Cognos Configuration を開始する場合、サービスを開始する前に、このセクションの追加タスクに従って環境が適切に設定されていることを確認してください。

「スタート」メニューから IBM Cognos Configuration ショートカットを使用して IBM Cognos Configuration を開始できます。

Content Store データベース用のデータベース接続の設定Content Manager をインストールする各コンピューターに、データベース・クライアント・ソフトウェアまたは JDBC (Java Database Connectivity) ドライバー (あるいはその両方) をインストールしなければならない場合があります。これを行うと、Content Manager から Content Store データベースへのアクセスが可能になります。

Microsoft SQL Server Content Store のデータベース接続のセットアップ


SQL Server 用の JSQLConnect ドライバーは、Microsoft JDBC ドライバーに置き換わっています。バージョン以降、Microsoft からダウンロードして、新しいタイプ 4 ドライバーを install_location/drivers フォルダー内に入れる必要があります。

ドライバー JAR ファイル sqljdbc42.jar は、IBM Cognos Analytics 付属の Javaバージョンをサポートするために必要なファイルです。

重要: シングル・サインオン (SSO) と Windows 認証の場合、sqljdbc_auth.dll

を bin64 ディレクトリー内に入れる必要があります。Windows 認証は、シングル・サインオン・セットアップです。構成マネージャー内の Content Manager に関する選択項目は、「Microsoft SQL Server データベース (Windows 認証)」と呼ばれます。

IBM Db2 Content Store のデータベース接続のセットアップこの手順では、Db2 Content Store のデータベース接続をセットアップする方法を説明します。この手順は、Content Manager がインストールされている各コンピューターで実行する必要があります。

タイプ 4 の Java Database Connectivity (JDBC) ドライバーを使用して ContentStore に接続する必要があります。

タイプ 4 のドライバーは、独立した製品として扱われます。このドライバーは、Db2 クライアントをインストールしなくても使用できます。

手順

以下のファイルを DB2_installation\sqllib\java ディレクトリーからinstall_location\drivers ディレクトリーにコピーします。

v 汎用ドライバー・ファイル、db2jcc4.jar

v ライセンス・ファイル:

Linux、UNIX、または Windows オペレーティング・システム上の Db2 の場合は、db2jcc_license_cu.jar を使用します。

z/OS 上の Db2 の場合は、db2jcc_license_cisuz.jar を使用します。

z/OS 上の Db2 に接続する場合は、Linux、UNIX、または Windows のバージョン 9.1 フィックスパック 5、またはバージョン 9.5 フィックスパック 2 のドライバー・バージョンを使用します。

ヒント: ドライバーのバージョンを確認するには、次のコマンドを実行します。

java -cp path\db2jcc4.jar com.ibm.db2.jcc.DB2Jcc -version

IBM Db2 Content Store のデータベースを作成するスクリプト・ファイルの生成:

すべてのプラットフォームの Db2 で、Content Store を自動的に作成するためのスクリプト・ファイルを生成できます。スクリプト・ファイルは、DDL ファイルです。


手順

1. IBM Cognos Configuration を開始します。

2. 「エクスプローラー」ウィンドウの「データ・アクセス」 > 「ContentManager」で、「Content Store」をクリックします。

デフォルト設定は、Db2 データベース用です。「タイプ」が「DB2 データベース」であることを確認してください。

3. 「データベース・サーバーとポート番号」フィールドに、Db2 が実行されているコンピューターの名前とポート番号を入力します。例えば、localhost:50000

とします。ここで 50000 は、Db2 によって使用されるデフォルトのポート番号です。別のポート番号を使用している場合は、その値を使用するようにしてください。

4. 「ユーザー ID とパスワード」プロパティーの隣にある「値」フィールドをクリックして、編集アイコンをクリックします。適切な値を入力して、「OK」をクリックします。

5. 「プロパティー」ウィンドウで、「データベース名」プロパティーに、ご使用のContent Store データベースの名前を入力します。

重要: 名前は 8 文字以下でなければならず、使用できるのは英数字、アンダースコアー、ハイフンのみです。

6. 「コンテンツ・ストア」を右クリックし、そして「DDL の生成」をクリックします。

7. 「詳細」をクリックして、生成された DDL ファイルの場所を記録します。

createDB.sql という名前の DDL ファイルが作成されます。スクリプトは、<

インストールの場所>¥configuration¥schemas¥content¥db2 ディレクトリーに作成されます。

次のタスク

このスクリプトを使用して、Db2 でデータベースを作成します。 DDL ファイルの使用方法について詳しくは、Db2 の資料を参照してください。

Db2 コマンド行インターフェースを使用する場合は、次のコマンドを入力してスクリプトを実行できます。

db2 -tvf createDB.sql

IBM Db2 for z/OS での Content Store の表スペースの作成:

データベース管理者は、Content Store データベースで必要な一連の表スペースを作成するスクリプトを実行する必要があります。スクリプトを変更して、プレースホルダー・パラメーターを環境に適したものに置き換えます。

デフォルトで、Content Store は通知、ヒューマン・タスク、および注釈に使用されます。それぞれに別個のデータベースを作成できます。



必ず z/OS 上の Db2 用の命名規則を使用してください。例えば、パラメーター名はすべて文字で始まり、8 文字以下でなければなりません。この文字長の制限には、次の 2 つの例外があります。

v CMSCRIPT_CS_ID は、2 文字以下でなければなりません。

v CMSCRIPT_TABLESPACE は、6 文字以下でなければなりません。

これらの例外の理由は、2 つのパラメーターが連結されるときに文字長が 8 文字以下でなければならないためです。

詳しくは、IBM Db2® for z/OS Knowledge Center (http://www.ibm.com/support/knowledgecenter/SSEPEK/db2z_prodhome.html) を参照してください。

手順

1. 表スペースの作成と削除の権限、および SQL 文の実行を許可する権限のあるユーザーとしてデータベースに接続します。

2. スクリプトが格納されているディレクトリーに移動します。

install_location/configuration/schemas/content/db2zOS

3. tablespace_db2zOS.sql スクリプト・ファイルのバックアップ・コピーを作成して、そのファイルを別の場所に保存します。

4. 元の tablespace_db2zOS.sql スクリプト・ファイルを開きます。

a. スクリプトの先頭に接続ステートメントを追加します。

例えば、次のようになります。

connect to databasename;

b. 次の表を参考にして、汎用パラメーターを環境に適したものに置き換えます。

この表に挙げたすべてのパラメーターがスクリプトに存在するわけではありませんが、いくつかは将来追加される可能性があります。

表 9. Content Store の表スペース・スクリプトのパラメーター名および説明

パラメーター名説明

CMSCRIPT_STOGROUP ストレージ・グループの名前を指定します。

CMSCRIPT_DATABASE Content Store データベースの名前を指定します。

CMSCRIPT_CS_ID Content Store データベースのサブシステムID を指定します。

この ID は、2 文字以下にしてください。

CMSCRIPT_TABLESPACE Content Store のすべての基準テーブルが格納される表スペースの名前を指定します。

補助テーブルは含まれません。

この名前は、6 文字以下にしてください。


http://www.ibm.com/support/knowledgecenter/SSEPEK/db2z_prodhome.html

表 9. Content Store の表スペース・スクリプトのパラメーター名および説明 (続き)


CMSCRIPT_LARGE_BP 特に大きいオブジェクトに対して割り当てられる大きいバッファー・プールの名前を指定します。

このバッファー・プールは、z/OS システム上でデータベース管理者が Content Store データベースを作成した際に作成された 32 KBバッファー・プールです。

CMSCRIPT_REGULAR_BP 通常のオブジェクトと大きいオブジェクトに対して割り当てられる通常サイズのバッファー・プールの名前を指定します。

このバッファー・プールは、z/OS システム上でデータベース管理者が Content Store データベースを作成した際に作成された 16 KBバッファー・プールです。

CMSCRIPT_USERNAME Content Store データベースにアクセスするユーザー・アカウントを指定します。

5. スクリプトを保存して実行します。

例えば、clp.properties ファイルと Db2 別名をプロファイルの中またはtcshrc スクリプト・ファイルの中にセットアップした場合、以下のコマンドを入力してスクリプトを実行します。

db2 -tvf tablespace_db2zOS.sql

6. "tablespace_db2zOS.sql" ファイル・スクリプトを実行したときに作成された表スペースに対する権限を IBM Cognos ユーザーに付与します。

a. rightsGrant_db2zOS.sql スクリプト・ファイルのコピーを作成して、それを別の場所に保管します。

b. リモート・アクセス・ツールで元の rightsGrant_db2zOS.sql スクリプト・ファイルを開き、プレースホルダー・パラメーターを環境に適した値に置き換えます。

バッファー・プールとユーザー・アカウントにリソースを割り当てたときに使用した値と同じ値を使用してください。.

c. スクリプトの先頭に接続ステートメントを追加します。


connect to databasename user username using password;

d. スクリプトを保存して実行します。


db2 -tvf rightsGrant_db2zOS.sql

7. 通知の表スペースを作成するには、<インストールの場所>/configuration/

schemas/delivery/zosdb2 ディレクトリーに移動します。


a. NC_TABLESPACES.sql スクリプト・ファイルのバックアップ・コピーを作成して、そのファイルを別の場所に保存します。

b. 元の NC_TABLESPACES.sql スクリプト・ファイルを開き、以下の表を参考にしながら、プレースホルダー・パラメーターをご使用の環境に適した値に置き換えます。

表 10. z/OS 上の Db2 通知データベース用の表スペースのパラメーター名と説明


NCCOG 通知データベースの名前を指定します。

DSN8G810 ストレージ・グループの名前を指定します。

BP32K バッファー・プールの名前を指定します。

この表に挙げたすべてのパラメーターがスクリプトに存在するわけではありませんが、将来追加される可能性があります。

c. スクリプトを保存して実行します。


db2 -tvf NC_TABLESPACES.sql

d. NC_CREATE_DB2.sql スクリプト・ファイルを開き、NCCOG プレースホルダー・パラメーターを通知データベース名に置き換えます。

e. スクリプトを保存します。

Job サービスと Scheduling Monitor サービスでスクリプトが自動的に実行されます。スクリプトを自分で実行するように選択することも可能です。

8. Human Task の表スペースを作成するには、インストールの場所/configuration/schemas/hts/zosdb2 ディレクトリーに移動します。

a. HTS_tablespaces.sql スクリプト・ファイルのバックアップ・コピーを作成して、そのファイルを別の場所に保存します。

b. 元の HTS_TABLESPACES.sql スクリプト・ファイルを開き、次の表を参考にして、汎用パラメーターを環境に適した汎用パラメーターに置き換えます。

表 11. Db2 for z/OS における Human Task 用の表スペース・パラメーター名と説明


NCCOG データベースの名前を指定する。


BP32K 32 K のバッファー・プールの名前を指定します。

必要なパラメーターのリストについては、スクリプトを参照してください。


d. HTS2_CREATE_Db2zos.sql スクリプト・ファイルを開き、次の表を参考にして、汎用パラメーターを環境に適した汎用パラメーターに置き換えます。




NCCOG データベースの名前。


e. スクリプトを保存して実行します。

9. Annotation の表スペースを作成するには、インストールの場所/configuration/schemas/ans/zosdb2 ディレクトリーに移動します。

a. ANN_TABLESPACES.sql スクリプト・ファイルのバックアップ・コピーを作成して、そのファイルを別の場所に保存します。

b. 元の ANN_TABLESPACES.sql スクリプト・ファイルを開き、次の表を参考にして、汎用パラメーターを環境に適した汎用パラメーターに置き換えます。

表 13. Db2 for z/OS における Annotation 用の表スペース・パラメーター名と説明



DSN8G810 ストレージ・グループの名前。

BP32K 32 K バッファー・プールの名前。



d. ANS2_CREATE_Db2zos.sql スクリプト・ファイルを開き、次の表を参考にして、汎用パラメーターを環境に適した汎用パラメーターに置き換えます。






Oracle Content Store のデータベース接続の設定以下に記されている手順では、Oracle Content Store のデータベース接続を設定する方法について取り上げています。この手順は、Content Manager がインストールされている各コンピューターで実行する必要があります。

手順

1. Oracle クライアントがインストールされているコンピューターで、"ORACLE_HOME/jdbc/lib" ディレクトリーに移動します。

2. Content Manager がインストールされていて、Oracle データベースに通知が送信されるコンピューターの install_location\drivers ディレクトリーに、使用している Oracle クライアントのバージョンの適切なライブラリー・ファイルをコピーします。

Oracle 12c を使用している場合は、ojdbc7.jar が必要です。


Oracle 11g を使用している場合は、ojdbc5.jar が必要です。

このファイルは Oracle のクライアントかサーバーのインストールによって提供されますが、Oracle の技術 Web サイトからもダウンロードできます。

Informix Content Store のデータベース接続の設定以下に記されている手順では、Informix Content Store のデータベース接続を設定する方法について取り上げています。この手順は、Content Manager がインストールされている各コンピューターで実行する必要があります。

手順

1. Informix がインストールされているコンピューターで、<Informix の場所>/sqllib/java ディレクトリーに移動します。

2. Content Manager がインストールされているすべてのコンピューターのinstall_location\drivers ディレクトリーに、次のファイルをコピーします。


v ライセンス・ファイル、db2jcc4_license_cisuz.jar

はじめに行う重要な設定アクションこれらの設定アクションは、正常にインストールを行うために重要です。これらのアクションは、コンポーネントをインストールした後に実行してください。

JDBC ドライバーが正しい場所にあることの確認

IBM Cognos Analytics 11.0.x リリースでは、JDBC ドライバーはinstall_location¥drivers ディレクトリーにコピーする必要があります。

install_location¥webapps¥p2pd¥WEB-INF¥lib を JDBC ドライバー用に使用することはサポートされていません。

Microsoft SQL Server 用 JSQL ドライバーの Microsoft JDBC ドライバーとの置き換え

IBM Cognos Analytics バージョン 11.0.5 以降、Microsoft SQL Server 用 JSQLドライバーは Microsoft JDBC ドライバーに置き換えられています。必要な JARファイルをダウンロードし、install_location¥drivers ディレクトリーに配置してください。詳細については、Microsoft SQL Server Content Store のセットアップを参照してください。

「設定グループ (Configuration Group)」プロパティーの指定

「カスタム」インストールを使用して IBM Cognos Analytics をインストールした場合は、IBM Cognos Configuration を開き、「設定グループ (ConfigurationGroup)」プロパティーを設定します。詳細については、「設定グループ(Configuration Group)」の管理を参照してください。

Web ベースのモデル作成の有効化または無効化

デフォルトでは、IBM Cognos Administration で作成した JDBC データ・ソース接続が、データ・モジュールで使用するために「管理」 > 「データ・サーバー」管


http://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.inst_cr_winux.doc/t_MSdriver_SSLconfig.html



理インターフェースに公開されることはありません。データ・モジュールを作成するために既存の (アップグレードされた) データ・ソース接続を使用する場合は、これらの接続で Web ベースのモデル作成を有効にする必要があります。

一部のデータ・ソースは、データ・モジュールを作成するためのソースとして使用するには不適切です。この場合、データ・ソース接続での Web ベースのモデル作成の使用を禁止することができます。

データ・ソース接続に対して Web ベースのモデル作成を有効または無効にするには、以下の手順を実行します。

1. IBM Cognos Analytics で、「管理」 > 「管理コンソール」に移動します。

2. IBM Cognos Administration の「設定」タブで、「データ・ソース接続」を選択します。

3. データ・ソースを見つけ、その「プロパティーを設定」操作をクリックします。

4. 「接続」タブで、「Web ベースのモデル作成を可能にする (Allow web-basedmodeling)」チェック・ボックスを選択またはクリアします。

IBM Cognos Configuration の起動IBM Cognos Configuration を使用して IBM Cognos Analytics コンポーネントを設定したり、IBM Cognos サービスを開始/停止したりします。

始める前に

IBM Cognos Configuration を起動する前に、オペレーティング環境が正しく設定されていることを確認してください。例えば、すべての環境変数が設定されていることを確認します。

Microsoft Windows オペレーティング・システムの場合は、追加の設定を行う必要がない場合にのみ、インストール・ウィザードの最終ページで IBM CognosConfiguration を起動できます。例えば、Content Store 用に Microsoft SQL 以外のデータベース・サーバーを使用する場合は、JDBC (Java Database Connectivity)ドライバーをインストールの場所/drivers フォルダーにコピーしてから、設定ツールを起動します。

UNIX または Linux オペレーティング・システムの場合は、インストール・ウィザードの最終ページで IBM Cognos Configuration を起動しないでください。 IBMCognos Analytics の設定前に必要な、追加作業があります。例えば、Java 環境を更新する必要があります。

IBM Cognos の実行に使用されるユーザーまたはサービス・アカウントがセットアップされていることを確認してください。

1 ページの『はじめに行う重要な設定アクション』をお読みください。

手順1. Microsoft Windows の場合、「スタート」 > 「IBM Cognos

Configuration」をクリックします。


Windows コンピューターを使用している場合に、製品を Program Files (x86)

ディレクトリーにインストールしたときは、IBM Cognos Configuration を管理者として開始してください。

2. UNIX または Linux オペレーティング・システムの場合は、<インストールの場所>/bin64 ディレクトリーに移動して、次のコマンドを入力します。

./cogconfig.sh

IBM Cognos Configuration が開かない場合は、DISPLAY 環境変数を設定したか確認します。

JAVA.Lang.unsatisfied link メッセージが表示された場合は、サポートされているバージョンの Java を使用していることを確認します。

Java.lang.unsupportedClassVersionError メッセージが表示された場合は、64ビット・バージョンの Java を使用していることを確認します。

Content Store のデータベース接続プロパティーの設定Content Manager から Content Store 用のデータベースに接続できるように、データベース・サーバー情報を指定する必要があります。このデータベース・ログオンを使用して、Content Manager から Content Store へのアクセスが行われます。データベース接続プロパティーを設定すると、Content Manager と ContentStore 間の接続をテストできるようになります。

実働環境では、Content Store にエンタープライズ・レベルのデータベースを使用してください。詳細については、「管理およびセキュリティー・ガイド」のContent Store 全体の配布に関するトピックを参照してください。

IBM Cognos Business Intelligence または以前のリリースの IBM CognosAnalytics からアップグレードする場合は、既存の Content Store データベースのコピー版を指すように IBM Cognos Analytics を設定します。設定を保存してIBM Cognos サービスを開始すると、Content Store のデータが自動的にアップグレードされ、以前のバージョンでは使用できなくなります。元のデータベースのコピー版を新しいバージョンで使用すれば、IBM Cognos Analytics やその旧バージョンで、元のデータを今までどおり実行できます。

Content Store は、サポートされているデータベース・サーバーを使用して作成してください。

IBM Db2 Content Store のデータベース接続プロパティーの設定Content Manager から Content Store 用のデータベースに接続できるように、データベース・サーバー情報を指定する必要があります。

手順

1. Content Manager がインストールされている場所で、IBM CognosConfiguration を起動します。

2. 「エクスプローラー」ウィンドウの「データ・アクセス」、「ContentManager」で、「Content Store」をクリックします。


3. 「プロパティー」ウィンドウで、「データベース」プロパティーにデータベース名またはデータベースの別名を入力します。

4. ログオンの資格情報を変更して、有効なユーザー ID とパスワードを指定します。

v 「ユーザー ID とパスワード」プロパティーの隣にある「値」ボックスをクリックして、表示される「編集」ボタンをクリックします。

v 適切な値を入力して、「OK」をクリックします。

5. 「データベース・サーバーとポート番号」フィールドに、Db2 が実行されているコンピューターの名前とポート番号を入力します。例えば、localhost:50000

とします。 50000 は Db2 によって使用されるデフォルトのポート番号です。別のポート番号を使用している場合は、その値を使用するようにしてください。

6. 「ファイル」メニューの「保存」をクリックします。

7. Content Manager と Content Store データベースとの間の通信をテストするには、「操作」メニューの「テスト」をクリックします。

Content Manager がデータベースに接続され、データベースに対する権限が確認され、テーブルの作成とデータ挿入が行われます。テーブルは削除されず、テストのたびに使用されます。

IBM Db2 for z/OS での Content Store のデータベース接続プロパティーの設定Content Manager から Content Store 用のデータベースに接続できるように、データベース・サーバー情報を指定する必要があります。

手順

1. Content Manager がインストールされている場所で、IBM CognosConfiguration を起動します。

2. 「エクスプローラー」ウィンドウの「データ・アクセス」 > 「ContentManager」で、「Content Store」をクリックします。

3. 「プロパティー」ウィンドウで、「データベース」プロパティーにデータベース名またはデータベースの別名を入力します。

4. ログオンの資格情報を変更して、有効なユーザー ID とパスワードを指定します。

v 「ユーザー ID とパスワード」プロパティーの隣にある「値」ボックスをクリックして、表示される「編集」アイコンをクリックします。表スペースを作成したときに CMSCRIPT_USERNAME に対して指定した値と同じユーザーID を指定していることを確認してください。


5. 「データベース・サーバーとポート番号」プロパティーに、ホスト名:ポートのように、データベース情報を入力します。

6. 「エクスプローラー」ウィンドウで、「ローカル設定」をクリックします。

7. 「詳細プロパティー」の「値」ボックスをクリックし、「編集」アイコンをクリックします。

「値 - 詳細プロパティー」ダイアログ・ボックスが開きます。


8. 「追加」をクリックして、データベース接続のパラメーターを追加します。

表の値は例なので、ご使用の環境に適切な値を入力するようにしてください。

表 15. Db2 for z/OS 用の Content Store の接続パラメーター

パラメーター名値の例

CMSCRIPT_CREATE_IN COGUCS.T1TSCS

CMSCRIPT_STOGROUP DBOIUSR

CMSCRIPT_DATABASE COGUCS

CMSCRIPT_CS_ID T1

CMSCRIPT_TABLESPACE TSCS

CMSCRIPT_LARGE_BP BP32K

CMSCRIPT_REGULAR_BP BP16K0

9. 「ファイル」 > 「保存」をクリックします。


Microsoft SQL Server、Oracle、Informix Content Store のデータベース接続プロパティーの設定Content Manager から Content Store 用のデータベースに接続できるように、データベース・サーバー情報を指定する必要があります。

手順

1. Content Manager がインストールされているコンピューターで、IBM CognosConfiguration を起動します。

2. 「エクスプローラー」ウィンドウの「データ・アクセス」、「ContentManager」で、「Content Store」を右クリックし、「削除」をクリックします。

このステップにより、デフォルトのリソースへの接続が削除されます。Content Manager からアクセス可能な Content Store は 1 つのみです。

3. 「Content Manager」を右クリックし、「リソースの新規作成」、「データベース」の順にクリックします。

4. 「名前」ボックスに、リソースの名前を入力します。

5. 「タイプ」ボックスでデータベースのタイプを選択し、「OK」をクリックします。

ヒント: Oracle PDB ( ) または Oracle RAC の機能を使用する場合は、「Oracle データベース (詳細設定)」を選択してください。

6. 「プロパティー」ウィンドウで、データベースのタイプに応じた値を指定します

v Microsoft SQL Server データベースを使用する場合は、「ポート番号とインスタンス名によるデータベース・サーバー」および「データベース名」プロパティーに適切な値を入力します。


Microsoft SQL Server の場合、「ポート番号とインスタンス名によるデータベース・サーバー」プロパティーの値には、1433 などのポート番号を使用することも、インスタンス名を使用することもできます。

Microsoft SQL Server のインスタンスが複数ある場合は、「ポート番号とインスタンス名によるデータベース・サーバー」プロパティーにインスタンス名を入力します。

名前付きのインスタンスに接続するには、インスタンス名を JDBC (JavaDatabase Connectivity)URL プロパティーまたはデータ・ソース・プロパティーとして指定する必要があります。例えば、「localhost¥instance1」と入力できます。インスタンス名プロパティーが指定されていない場合、デフォルトのインスタンスに対する接続が作成されます。

名前付きインスタンスに指定されたプロパティー、ユーザー ID とパスワード、およびデータベース名が、JDBC URL の作成で使用されます。次に例を示します。

jdbc:JSQLConnect://localhost\\instance1/user=sa/必要に応じてプロパティーを追加

v Oracle データベースを使用する場合、「データベース・サーバーとポート番号」プロパティーおよび「SID」プロパティーに適切な値を入力します。

v Oracle PDB を使用する場合は、「データベース指定子」プロパティーに、 //<server>/<servicename> を入力します。例://corpserv1:1522/PDB1

v 高度な Oracle Net 8 データベースを使用する場合は、「データベース指定子」プロパティーに、接続に使用する Oracle Net8 のキーワード値のペアを入力します。

Oracle Net8 キーワード値ペアの例を次に示します。

(description=(address=(host=myhost)(protocol=tcp)(port=1521)(connect_data=(sid=(orcl)))))

高度な機能を持つ Oracle データベースを選択すると、IBM CognosAnalytics では、企業向けの Oracle の機能を使用してリスナーが選択され、最初のリスナーが失敗すると別のリスナーに切り替えられます。また、接続が失敗すると自動的にデータベースに再接続され、接続要求に対してリスナー間およびディスパッチャー間で負荷分散が行われます。

v Informix データベースを使用する場合、「データベース・サーバーとポート番号」プロパティーと「データベース名」プロパティーに適切な値を入力します。

7. ログオン資格情報を設定するには、ユーザー ID とパスワードを指定します。

v 「ユーザー ID とパスワード」プロパティーの隣にある「値」ボックスをクリックして、表示される「編集」アイコンをクリックします。


8. Informix のインスタンスで複数の Content Store データベースをホストする場合は、詳細プロパティー CMSCRIPT_CS_ID を作成し、インスタンスを実行するアカウントを指定します。

v 「エクスプローラー」ウィンドウで、「ローカル設定」をクリックします。


v 「プロパティー」ウィンドウで、「詳細プロパティー」の「値」列をクリックし、「編集」アイコンをクリックします。

v 「値 - 詳細プロパティー」ダイアログ・ボックスで「追加」をクリックします。

v 「名前」列に、「CMSCRIPT_CS_ID」と入力します。

v 「値」列に、Content Store のインスタンスを実行するアカウントのユーザー ID を入力します。

Informix の Content Store データベースのインスタンスごとに、異なるユーザー・アカウントを使用します。


ログオンの資格情報は、すぐに暗号化されます。


Content Manager がデータベースに接続され、データベースに対する権限が確認され、テーブルの作成とデータ挿入が行われます。テーブルは削除されず、テストのたびに使用されます。

タスクの結果

これで、IBM Cognos サービスを初めて開始したときに Content Manager によって必要なテーブルが Content Store に作成されるようになります。接続プロパティーが正確に指定されていない場合、IBM Cognos サービスを開始できません。

Content Manager コンピューターの環境プロパティーの設定Content Manager のコンピューターで、Content Store、他の Content Managerのコンピューター、および通知用データベースの場所を認識できるようにします。

フェイルオーバー保護として使用するコンピューターに Content Manager をインストールしたら、これらのコンピューターで Content Manager を設定する必要があります。Content Manager を複数インストールした場合、すべての ContentManager の URI を各 Content Manager コンピューターでリスト表示する必要があります。

必要な設定作業を完了して IBM Cognos Analytics サービスを開始すると、認証局Service を使用して他のコンピューターに証明書を発行できます。次に、アプリケーション層コンポーネントのコンピューターやゲートウェイのコンピューターなど、他のコンピューターで必要な設定を行うことができます。他のコンピューターの設定を行わない場合は、Content Manager コンピューターの設定作業を続行し、使用環境に合わせてデフォルトのプロパティー設定を変更できます ( 169 ページの『デフォルト設定の変更』を参照)。例えば、認証プロバイダーの使用 ( 265 ページの『第 8 章認証プロバイダーの設定』を参照)、Content Manager コンピューターのサービスの有効化および無効化 ( 185 ページの『サービスの有効化と無効化』を参照)、グローバル設定の変更 ( 240 ページの『グローバル設定の変更』を参照) などの IBM Cognos Analytics コンポーネントの設定を行えます。


1 台の Content Manager コンピューターでグローバル設定を変更した場合は、他の Content Manager コンピューターでも同様の変更を行う必要があります。

アクティブな Content Manager の設定Content Manager のコンピューターで、Content Store、他の Content Managerのコンピューター、および通知用データベースの場所を認識できるようにします。

手順

1. デフォルトのアクティブな Content Manager にする Content Manager のコンピューターで、IBM Cognos Configuration を起動します。


3. 「プロパティー」ウィンドウで「Content Manager URI」の値をクリックし、「編集」ボタンをクリックします。

4. 他の Content Manager コンピューターの URI を指定します。

v 「値 - Content Manager URI」ダイアログ・ボックスで「追加」をクリックします。

v 表の空白の行をクリックして、Content Manager コンピューターの完全なURI を入力します。

表の最初の値は削除しないでください。この値はローカルの ContentManager コンピューターを識別する、必須の情報です。

URI の"localhost"の部分をホスト名または IP アドレスに置き換えます。すべての URI プロパティーで同じ形式 (すべてホスト名かすべて IP アドレス) を使用する必要があります。

v 一覧に追加する各 URI について、上記の 2 つの手順を繰り返します。

リストにはすべての Content Manager URI を含める必要があります。

v 「OK」をクリックします。


待機中の Content Manager の設定Content Manager のコンピューターで、Content Store、他の Content Managerのコンピューター、および通知用データベースの場所を認識できるようにします。

手順

1. 少なくとも 1 台の Content Manager コンピューターで環境プロパティーがすでに設定されていることと、そのコンピューターで IBM Cognos Analytics コンポーネントが実行中であることを確認します。

2. 待機中の Content Manager コンピューターで IBM Cognos Configuration を起動します。


4. 「プロパティー」ウィンドウで「Content Manager URI」の値をクリックし、「編集」ボタンをクリックします。

5. 他の Content Manager コンピューターの URI を指定します。




表の最初の値は削除しないでください。この値はローカルの ContentManager コンピューターを識別する、必須の情報です。





6. 「エクスプローラー」ウィンドウの「セキュリティー」 > 「暗号化」で、デフォルトの暗号化プロバイダーである「Cognos」をクリックします。

7. 暗号化に関するすべての設定が、デフォルトのアクティブな Content Managerコンピューターで設定した内容と一致することを確認します。

8. 「エクスプローラー」ウィンドウの「データ・アクセス」>「ContentManager」で、「Content Store」をクリックします。

9. すべてのプロパティーの値が、デフォルトのアクティブな Content Managerコンピューターで設定した内容と一致することを確認します。


E メール・サーバーへの接続の指定レポートを E メールで送信するには、E メール・サーバーへの接続を設定する必要があります。

手順1. 「エクスプローラー」ウィンドウの「データ・アクセス」で、「通知」をクリッ

クします。

2. 「プロパティー」ウィンドウの「SMTP メール・サーバー」プロパティーに、SMTP (送信用) E メール・サーバーのホスト名とポート番号を入力します。

E メールで送信されたレポートを開けるようにするには、「ゲートウェイURI」のホスト名の部分を、localhost からコンピューターの IP アドレスまたはコンピューター名に変更する必要があります。ホスト名を変更しないと、Eメールの URL に localhost が含まれるため、リモート・ユーザーはレポートを開くことができません。

リンクとして送信されるレポートを開けるように、レポート・サーバーと通知サーバーの「ゲートウェイ URI」の参照先が、IBM Cognos のコンテンツを収容するアクセス可能な Web サーバーになるようにしてください。モバイル・ユーザーが遠隔からリンクにアクセスする必要性があれば、外部からアクセス可能なURI を使用することを考慮してください。


3. 「アカウントとパスワード」プロパティーの隣にある「値」ボックスをクリックして、表示される「編集」ボタンをクリックします。

4. 「値」-「アカウントとパスワード」ダイアログ・ボックスに値を入力し、「OK」をクリックします。

SMTP サーバーにログオン資格情報が必要ない場合は、「アカウントとパスワード」プロパティーのデフォルト情報を削除します。このプロパティーを空白のままにするかどうかを確認するプロンプトが表示されたら、「OK」をクリックします。デフォルトのユーザー名が削除されていることを確認してください。削除されていない場合、デフォルトのアカウントが使用されるので、通知が正常に機能しません。

5. 「プロパティー」ウィンドウに、デフォルトの送信者アカウント用の値を入力します。

6. 「エクスプローラー」ウィンドウで「通知」を右クリックし、「テスト」をクリックします。

IBM Cognos Analytics によって、E メール・サーバーの接続がテストされます。

E メール・サーバーへの安全な TLS 接続の有効化E メール・サーバーへの安全な TLS 接続を有効にして、暗号化された TLS 通信を行えるようにします。

注: SSL 暗号化を構成していても安全な TLS 接続を有効にしていない場合は、接続は失敗し、以下のメッセージが表示されます。

502 不明なコマンドです

始める前に

証明書がなければなりません。特に、E メール・サーバーに共通の .crt 形式の証明書が必要です。

手順

1. 証明書をインポートし、Cognos Analytics と E メール・サーバーの間のトラストを有効にします。

a. ディスパッチャー URI 上で HTTP を使用している場合は、以下のようにJRE 鍵ストア内に証明書をインポートしなければなりません。

v Windows の場合、install_location¥bin¥DLS_SSL_CertImportTool.bat

certificate_location¥email_certificate.crt -p keystore_password

と入力します

v Unix または Linux の場合、install_location/bin/

DLS_SSL_CertImportTool.sh certificate_location/

email_certificate.crt -p keystore_password と入力します

b. ディスパッチャー URI 上で HTTPS を使用している場合は、以下のようにCognos 鍵ストア内に証明書をインポートしなければなりません。


v Windows の場合、install_location¥bin¥ThirdPartyCertificateTool.bat -T -i -r

certificate_location¥email_certificate.crt -p keystore_password

と入力します

v Unix または Linux の場合、install_location/bin/

ThirdPartyCertificateTool.sh -T -i -r certificate_location/

email_certificate.crt -p keystore_password と入力します

2. Cognos Configuration で、「データ・アクセス」 > 「通知」を選択し、以下のようにプロパティーを編集します。

名前値

SMTP メール・サーバー email_server_name:port_number。port_numberは、TLS/SSL または STARTTLS に有効なポートを表わします

アカウントとパスワード E メール・サーバーに対する認証が必要な場合のユーザー ID とパスワード。

デフォルトの送信者 E メール・サーバーから E メールを送信する E メール・アカウント。

SSL 暗号化有効有効

3. Cognos Configuration で、「ローカル設定」を選択します。

a. 「詳細プロパティー」の「値」フィールドをクリックします。

b. 鉛筆アイコンをクリックします。

c. 「追加」をクリックします。

d. 「名前」フィールドに、emf.mail.tls.enabled と入力します。

e. 「値」フィールドに、true と入力します。

f. 「OK」をクリックします。

4. Cognos Administration で、拡張設定 emf.mail.tls.enabled の値を true で構成します。詳細は、「特定のサービスに対する詳細設定の構成」を参照してください。

注: この変更を加えた後に Delivery サービスを再始動しなければなりません。

セキュリティーの有効化デフォルトで、IBM Cognos Analytics では匿名アクセスが許可されます。IBMCognos Analytics 環境でセキュリティーを使用するには、匿名アクセスを無効にして、認証プロバイダーを使用するように IBM Cognos Analytics を設定する必要があります。

手順1. IBM Cognos Configuration の「エクスプローラー」ウィンドウで、「セキュリ

ティー」>「認証」>「Cognos」の順にクリックします。

2. 「匿名アクセスを許可」の「値」ボックスをクリックし、「無効」を選択します。

3. 「認証」を右クリックし、「リソースの新規作成」>「ネームスペース」の順にクリックします。


4. 「名前」ボックスに認証ネームスペースの名前を入力します。

5. 「タイプ」リストで適切なネームスペースのタイプをクリックし、「OK」をクリックします。

「エクスプローラー」ウィンドウの「認証」コンポーネントに、新しい認証プロバイダーのリソースが表示されます。

6. 「プロパティー」ウィンドウの「ネームスペース ID」プロパティーに、ネームスペースの一意の識別子を指定します。


Content Manager の開始Content Store のデータベース接続プロパティーを設定し、セキュリティー・ネームスペースを設定した後、Content Manager コンピューターを起動できます。

始める前に

ユーザーまたはサービス・アカウントが設定されていることを確認します。詳細については、 15 ページの『IBM Cognos Analytics のユーザー・アカウントまたはネットワーク・サービス・アカウントの設定』を参照してください。

手順1. IBM Cognos Configuration を起動します。

アップグレードを行う場合、設定ファイルの検出とアップグレードが行われたことを通知するメッセージが表示されます。

2. 設定が保存されていることを確認します。保存されていない場合、IBM Cognosサービスを開始できません。

3. 「操作」メニューの「テスト」をクリックします。

IBM Cognos Configuration では、共通対称鍵 (CSK) の可用性の確認、ネームスペースの設定のテスト、Content Store およびその他のリソースへの接続のテストが行われます。

ヒント: 「テスト」を選択できない場合は、「エクスプローラー」ウィンドウで「ローカル設定」をクリックします。

4. テストが失敗した場合は、該当するプロパティーを再設定し、もう一度テストを実行します。

コンポーネントの中から決まったものを 1 つずつテストする場合は、「エクスプローラー」パネルでコンポーネントを右クリックし、「テスト」を選択します。

すべてのテストがエラー・フリーになるまでサービスを開始しないでください。

5. 「操作」メニューの「開始」をクリックします。

IBM Cognos サービスの開始には、数分かかることがあります。

この操作によって、実行中でないすべてのインストール済みのサービスが開始され、IBM Cognos サービスが Windows に登録されます。


Content Manager のインストールのテストWeb ブラウザーを使用してインストールをテストできます。

手順1. Web ブラウザーを開きます。

2. アクティブな Content Manager の URI を入力して、Content Manager が動作していることをテストします。例えば、http://host_name:port/p2pd/

servlet と入力します。

host_name:port のデフォルト値は localhost:9300 です。

Content Manager は、「状態区分」の値が「実行中」または「待機」のときに使用できます。

アプリケーション・サービスのインストールと設定アプリケーション・サービス・コンポーネントは、異なるコンピューターまたは同じコンピューターにインストールできます。

アプリケーション・サービス・コンポーネントのインストール

アプリケーション・サービス・コンポーネントのコンピューターを設定する前に、アクティブな Content Manager をインストールしたコンピューターを設定し、アクセス可能にしておく必要があります。

アップグレードする場合、IBM Cognos Analytics では、アプリケーション・サービス・コンポーネントのコンピューターに既存の設定データが使用されます。ただし、アプリケーション・サービス・コンポーネントを新しい場所にインストールした場合、環境プロパティーを設定する必要があります。

64 ビットのインストール

アプリケーション・サービス・コンポーネントに付属の Report Server コンポーネントは、32 ビットと 64 ビットの両方のバージョンで提供されます。使用するバージョンの選択は、インストール後に IBM Cognos Configuration を使用して行います。デフォルトでは、Report Server コンポーネントは、64 ビット・コンピューター上でも、32 ビット・モードを使用するように設定されています。 64 ビット・モードでは動的クエリー・モード用に作成されたレポートのみ実行できるのに対し、32 ビット・モードではすべてのレポートを実行できます。

プリンターの要件

Microsoft Windows オペレーティング・システム上でレポートが正しく印刷されるようにするには、Adobe Reader で、アプリケーション・サービス・コンポーネントがインストールされているオペレーティング・システム上で少なくとも 1 台のプリンターを設定する必要があります。選択した印刷形式に関係なく、すべてのレポートが一時 PDF ファイルとして印刷用に Adobe Reader に送信されます。


UNIX または Linux オペレーティング・システムでのアプリケーション・サービス・コンポーネントのインストールアプリケーション・サービス・コンポーネントは、環境に合わせて 1 台以上のコンピューターにインストールできます。

始める前に


手順



2. インストール・ウィザードを開始するため、オペレーティング・システムのディレクトリーに移動して、./ca_srv_<platform>_<build>.bin と入力します。

ヒント: ca_srv_<platform>_<build>.bin コマンドを X Window で使用した場合、メッセージやログ・ファイルの日本語文字が文字化けすることがあります。UNIX または Linux 上に日本語環境でインストールする場合、最初に環境変数を LANG=C および LC_ALL=C のように設定します。ここで、C は言語コード (例えば Solaris では ja_JP.PCK) を表します。次にインストール・ウィザードを起動します。

X Window を使用しない場合は、無人インストールを実行します。詳細については、 329 ページの『無人インストールの使用』を参照してください。



パス名に ASCII 文字のみが含まれるディレクトリーにアプリケーション・サービス・コンポーネントをインストールします。一部の UNIX Web サーバーおよび Linux Web サーバーでは、ディレクトリー名に ASCII 以外の文字は使用できません。

v コンポーネントを選択するときに、「アプリケーション・サービス」以外のすべてのコンポーネントの選択を解除します。

4. 「終了」をクリックします。 IBM Cognos Analytics をすぐに設定しないでください。IBM Cognos Analytics の設定を行う前に、使用環境が正しく設定されているかどうかを確認する必要があります。







次のタスク

IBM Cognos Configuration を使用して、IBM Cognos Analytics を設定します。このツールを開くには、install_location/bin64 ディレクトリーで cogconfig.shと入力します。

Windows オペレーティング・システムでのアプリケーション・サービス・コンポーネントのインストール環境によっては、1 台以上のコンピューターにアプリケーション・サービス・コンポーネントをインストールできます。


手順

1. インストール・ファイルをダウンロードし解凍した場所に移動し、ca_srv_<platform>_<build>.exe をダブルクリックします。




3. 「カスタム」インストール・オプションを選択し、インストール・ウィザードの指示に従ってファイルをコンピューターにコピーします。


パス名に ASCII 文字のみが含まれるディレクトリーにアプリケーション・サービス・コンポーネントをインストールします。一部の Web サーバーでは、ディレクトリー名に ASCII 以外の文字は使用できません。

v コンポーネントを選択するときに、「アプリケーション・サービス」以外のすべてのコンポーネントの選択を解除します。


次のタスク


レポート作成データベース用のデータベース接続の設定IBM Cognos Analytics とデータ・ソース間の通信をサポートするには、レポート・サーバーをホストするコンピューターと同じコンピューターにデータ・ソース


用の追加のソフトウェアをインストールする必要があります。データ・ソースとクエリー・モードに応じて、データベース・クライアント・ソフトウェアまたはJDBC (Java Database Connectivity) ドライバー、あるいはその両方が必要となる場合があります。

IBM Cognos Analytics では、クエリー・データベース (レポート作成データベースとも呼ばれる) は、レポートを実行するレポート作成エンジンのみからアクセスされます。レポート作成エンジンは、アプリケーション層コンポーネントとともにインストールされ、Framework Manager、および IBM Cognos Transformer によっても使用されます。

互換クエリー・モード

互換クエリー・モードを使用するレポートを実行するには、32 ビットのデータ・ソース・クライアント・ライブラリーを使用し、レポート・サーバーを 32 ビットに構成する必要があります。互換クエリー・モードでは、データ・ソースとの通信にネイティブ・クライアントと ODBC 接続を使用します。

動的クエリー・モード

動的クエリー・モードでは、Java/XMLA 接続を使用してデータ・ソースへの通信が提供されます。

サポートされているリレーショナル・データベースの場合は、タイプ 4 の JDBC接続が必要です。タイプ 4 の JDBC ドライバーでは、JDBC 呼び出しがベンダー固有のデータベース・プロトコルに直接変換されます。このドライバーは PureJava で作成されており、プラットフォームに依存しません。

OLAP データ・ソースの場合は、特定ソースおよび特定バージョンの OLAP テクノロジー用にカスタマイズおよび拡張された MDX を使用することで、Java/XMLA 接続によってアクセスが最適化され、高機能の OLAP データ・ソースが利用されます。

オペレーティング・システム、パッチ、ブラウザー、Web サーバー、ディレクトリー・サーバー、データベース・サーバー、アプリケーション・サーバーなど、IBMCognos Analytics 製品でサポートされる環境の最新のリストを確認するには、IBMソフトウェア互換性レポート (www.ibm.com/support/docview.wss?uid=swg27047186) のページを参照してください。

Windows オペレーティング・システムでの OLAP データ・ソースへのアクセスレポートの作成に使用するリレーショナル・データベースおよび OLAP データ・ソースにアクセスするには、データ・ソース・ベンダーによって提供されているクライアント API ソフトウェアをインストールする必要があります。このソフトウェアは、アプリケーション層コンポーネントがインストールされているのと同じコンピューターにインストールしなければなりません。




手順

1. (アプリケーション層コンポーネントをインストールした) レポート・サーバーをホストするコンピューターに、リレーショナル・データベースおよび OLAPデータ・ソース用のデータベース API ソフトウェアをインストールします。

Microsoft Windows オペレーティング・システムでは、レポート作成エンジンによりネイティブのデータベース接続または ODBC がサポートされています。

2. Framework Manager がアプリケーション層コンポーネントとは別の場所にインストールされている場合は、Framework Manager がインストールされているコンピューターにクライアント API ソフトウェアもインストールする必要があります。詳細については、 150 ページの『Framework Manager のデータ・ソース接続の変数の設定』を参照してください。

UNIX または Linux オペレーティング・システム上の ODBC データ・ソースへのアクセスUNIX または Linux 上の ODBC データ・ソースを使用して、サポートされているデータ・ソースに接続する場合は、環境を構成して、データ・ソース、接続ライブラリー、およびそれらに付随するドライバー・マネージャー・ライブラリーへの参照を含む .odbc.ini ファイルの位置を指定する必要があります。

サポートされる ODBC データ・ソースを確認するには、IBM ソフトウェア互換性レポート (www.ibm.com/support/docview.wss?uid=swg27047186)を参照してください。

ODBC 接続を構成した後に、IBM Cognos Administration でデータ・ソースへの接続を作成する必要があります。詳細については、「IBM Cognos 管理およびセキュリティー・ガイド」を参照してください。

データベース・ベンダーがドライバー・マネージャーを提供していない場合は、使用するオペレーティング・システムに応じて、unixODBC または iODBC を使用できます。

Linux オペレーティング・システムの場合は、オペレーティング・システムに付属している unixODBC パッケージによって、ODBC ドライバー・マネージャーが提供されます。データ・ソース接続をセットアップする前に、unixODBC バージョン2.2.11 以降をインストールする必要があります。インストールしたバージョンを確認するには、コマンド odbcinst --version を使用します。ご使用のデータベースに必要な unixODBC のバージョンを確認して、必ず正しいバージョンを使用するようにしてください。

UNIX オペレーティング・システムの場合は、オープン・ソース iODBC ドライバー・マネージャーが IBM Cognos インストール環境の一部として提供されます。

手順

1. .odbc.ini ファイルの場所を指定するための環境変数を作成します。


export ODBCINI=/usr/local/etc/.odbc.ini




2. 適切なライブラリー・パス環境変数を設定して、使用しているデータベース用の32 ビット接続ライブラリーおよびドライバー・マネージャーの場所を指定します。

次の表では、ドライバー・マネージャー・ライブラリーの場所を指定する必要のあるオペレーティング・システム別に、環境変数のリストを示します。

表 16. オペレーティング・システムの環境変数

オペレーティング・システム環境変数

AIX LIBPATH

Solaris と Linux LD_LIBRARY_PATH

3. データベース・ベンダーがドライバー・マネージャーを提供していない場合は、ローカル・ドライバー・マネージャーのパスを含むようにライブラリー・パスを設定してください。

v UNIX では、iODBC が IBM Cognos インストール環境の一部として提供されます。ライブラリー・ファイルは、<インストールの場所>/bin ディレクトリーにあります。ライブラリー・パスには、<インストールの場所>/bin ディレクトリーが既に含まれています。


LIBPATH=/usr/IBM/cognos/bin:$LIBPATH

v Linux では unixODBC パッケージが、必要なドライバー・マネージャー・ライブラリーを提供します。


LD_LIBRARY_PATH=/usr/lib:$LD_LIBRARY_PATH

次のタスク

UNIX または Linux オペレーティング・システムで複数の ODBC ソースを使用している場合、名前が共通でも接続とドライバー・マネージャーの両方で実装が異なる、ライブラリー・ファイルの依存関係が検出されることがあります。ある ODBCソースが検証されても別の ODBC ソースは依存関係のために失敗する状況のときには、カスタマー・サポートに問い合わせてください。共通の .odbc.ini を使用すると、複数の異なるドライバー・マネージャーに対して互換性のないエントリーが生じることがあります。この問題を解決するには、使用している複数のドライバー・マネージャーの間の構造要件を検討し、競合するドライバー・マネージャーの間で共通の構文を使用するようにしてください。

Oracle Essbase を使用するための IBM Cognos Analytics の設定IBM Cognos Analytics と一緒に Oracle Essbase データ・ソースのバージョン11.1.1 を使用する場合、設定ファイルを編集して、IBM Cognos Analytics サーバーのバージョンを指定する必要があります。

デフォルトでは、IBM Cognos Analytics は Oracle Essbase バージョン 11.1.2 を使用するように設定されます。そのため、このバージョンを使用する場合には追加


設定は不要です。サポート対象の別のバージョンの Oracle Essbase を使用する場合には、ご使用のバージョン用に qfs.config.xml ファイルを編集しなければなりません。

また、Oracle Essbase バージョン 11.1.2 を使用する場合には、Oracle FoundationServices と Oracle Essbase クライアントをインストールしなければなりません。

手順

1. <インストールの場所>/configuration ディレクトリーに移動します。

2. XML エディターまたはテキスト・エディターで qfs_config.xml ファイルを開きます。

3. 以下の行を見つけてください。

<provider name="DB2OlapODP" libraryName="essodp1112" connectionCode="DO">

4. Oracle Essbase 11.1.1 の場合、次のように変更します。

<provider name="DB2OlapODP" libraryName="essodp111" connectionCode="DO">

5. Oracle Essbase 11.1.2 の場合、それらの行が次のようになるようにします。

<provider name="DB2OlapODP" libraryName="essodp1112" connectionCode="DO">

6. ファイルを保存して、IBM Cognos サービスを再開します。

UNIX または 64 ビット Microsoft Windows オペレーティング・システム上での Oracle Essbase の設定UNIX または 64 ビット Microsoft Windows オペレーティング・システム上でIBM Cognos Analytics とともに Oracle Essbase バージョン 11.1.2 データ・ソースを使用する場合は、ARBORPATH および ESSBASEPATH 環境変数を手作業で設定する必要があります。

ARBORPATH および ESSBASEPATH 環境変数は、Oracle Essbase クライアントのインストール時に作成されます。IBM Cognos Analytics は、これらの変数を使用してOracle Essbase クライアントのロケーションを検出します。

UNIX または 64 ビット Microsoft Windows オペレーティング・システム上でIBM Cognos Analytics とともに Oracle Essbase を使用するには、64 ビットOracle Essbase クライアントをインストールする必要があります。この 64 ビット・クライアントには、IBM Cognos Analytics が使用する 32 ビット・クライアントが含まれています。その 32 ビット・クライアントを示すように、ARBORPATHおよび ESSBASEPATH 環境変数を手作業で変更して、EssbaseClient をEssbaseClient-32 に置き換える必要があります。次の例では、クライアントが Cドライブにインストールされていることを前提としています。インストール場所は異なることがあります。

ARBORPATH=C:\Hyperion\EPMSystem11R1\products\Essbase\EssbaseClient-32

ESSBASEPATH=C:\Hyperion\EPMSystem11R1\products\Essbase\EssbaseClient-32

32 ビット Oracle Essbase クライアントとともに 32 ビット Microsoft Windowsオペレーティング・システムを使用する場合は、これらの環境変数を変更する必要はありません。


IBM Cognos Configuration の起動IBM Cognos Configuration を使用して IBM Cognos Analytics コンポーネントを設定したり、IBM Cognos サービスを開始/停止したりします。

始める前に

IBM Cognos Configuration を起動する前に、オペレーティング環境が正しく設定されていることを確認してください。例えば、すべての環境変数が設定されていることを確認します。

Microsoft Windows オペレーティング・システムの場合は、追加の設定を行う必要がない場合にのみ、インストール・ウィザードの最終ページで IBM CognosConfiguration を起動できます。例えば、Content Store 用に Microsoft SQL 以外のデータベース・サーバーを使用する場合は、JDBC (Java Database Connectivity)ドライバーをインストールの場所/drivers フォルダーにコピーしてから、設定ツールを起動します。

UNIX または Linux オペレーティング・システムの場合は、インストール・ウィザードの最終ページで IBM Cognos Configuration を起動しないでください。 IBMCognos Analytics の設定前に必要な、追加作業があります。例えば、Java 環境を更新する必要があります。

IBM Cognos の実行に使用されるユーザーまたはサービス・アカウントがセットアップされていることを確認してください。

1 ページの『はじめに行う重要な設定アクション』をお読みください。

手順1. Microsoft Windows の場合、「スタート」 > 「IBM Cognos

Configuration」をクリックします。

Windows コンピューターを使用している場合に、製品を Program Files (x86)

ディレクトリーにインストールしたときは、IBM Cognos Configuration を管理者として開始してください。

2. UNIX または Linux オペレーティング・システムの場合は、<インストールの場所>/bin64 ディレクトリーに移動して、次のコマンドを入力します。

./cogconfig.sh



Java.lang.unsupportedClassVersionError メッセージが表示された場合は、64ビット・バージョンの Java を使用していることを確認します。


アプリケーション・サービス・コンポーネントのコンピューターの環境プロパティーの設定

Content Manager とは異なるコンピューターにアプリケーション・サービス・コンポーネントをインストールする場合、Content Manager の場所を認識できるようにアプリケーション・サービス・コンポーネントのコンピューターを設定する必要があります。この設定により、分散コンポーネント間の相互通信が可能になります。

アプリケーション・サービス・コンポーネントのコンピューターで、ContentManager のコンピューターと、ジョブやスケジュールの情報を格納するための通知データベースの場所を認識できるようにします。アプリケーション・サービス・コンポーネントのコンピューターでは Content Manager コンピューターが使用するものと同じ通知データベースを使用する必要があります。詳細については、 198 ページの『通知データベースの変更』を参照してください。

複数の Content Manager をインストールした場合は、すべての Content Managerの URI のリストを各アプリケーション・サービス・コンポーネントのコンピューターで表示する必要があります。



3. 「プロパティー」ウィンドウで、「Content Manager URI」プロパティーの"localhost"の部分を任意の Content Manager コンピューターの名前に変更します。

4. 残りの Content Manager コンピューターの URI を指定します。







5. 「ゲートウェイ URI」プロパティーの"localhost"の部分を、ゲートウェイ・コンポーネントをインストールする予定のコンピューターの名前に変更します。

これにより、ユーザーは、E メールで送信されるレポートやワークスペースにさまざまな場所から接続できます。

6. 残りの URI プロパティーの"localhost"の部分を、使用している IBM CognosAnalytics サーバーの名前または IP アドレスに変更します。



8. 「認証局設定」プロパティー・グループで、デフォルトのアクティブなContent Manager コンピューターで指定したプロパティーに合わせて、「パスワード」プロパティーを設定します。

9. 暗号化に関する他のすべての設定が、デフォルトのアクティブな ContentManager コンピューターで設定した内容と一致することを確認します。


64 ビット・バージョンのレポート・サーバーの使用可能化32 ビットと 64 ビットのどちらのバージョンのレポート・サーバー・コンポーネントを使用するか選択できます。 64 ビット・バージョンを使用するには、IBMCognos Configuration を使用して使用可能にする必要があります。デフォルトのオプションは 32 ビットです。

32 ビットのレポート・サーバーは、動的クエリー・モードおよび互換クエリー・モードの両方のパッケージで使用可能です。 64 ビットのレポート・サーバーは、動的クエリー・モード・パッケージでのみ使用可能です。

レポート・サーバーは Query サービスと共に機能します。 Query サービスは、動的クエリー・モードと動的キューブを作動させるエンジンです。 64 ビット・インストールの場合、Query サービスは、レポート・サーバー・コンポーネントが 32ビットと 64 ビットのどちらに構成されている場合であっても 64 ビットとなります。

64 ビット・バージョンのレポート・サーバーを使用すると、レポート出力を表示するために使用可能なメモリー量が増えます。例えば、レポート実行時の表示段階におけるメモリー不足状態を回避できます。これが当てはまるのは大規模なレポート出力、例えば、1000 ページを超える PDF レポートなどの場合のみです。その場合には 64 ビット・バージョンのレポート・サーバー・コンポーネントが必要になります。

動的クエリー・モードを使用しないパッケージには、32 ビット・バージョンのレポート・サーバーを使用する必要があります。例えば、パッケージが IBM CognosPowerCubes に基づいている場合、32 ビット・バージョンのレポート・サーバーを使用する必要があります。

環境に複数のアプリケーション層コンポーネント・インスタンスがある場合、32 ビットのレポート・サーバーを使用するように 1 つのインスタンスを設定できます。その後、ルーティング規則を使用して、非動的クエリー・モードのパッケージのレポート要求を 32 ビット・バージョンのレポート・サーバーを実行しているインスタンスにルーティングできます。ルーティング規則の詳細については、「管理およびセキュリティー・ガイド」を参照してください。

64 ビット・バージョンを使用可能にするには、64 ビット・コンピューター上にアプリケーション層コンポーネントの 64 ビット・バージョンをインストールする必要があります。アプリケーション層コンポーネントの 32 ビット・バージョンをインストールしている場合、または 32 ビット・コンピューターを使用している場合には、64 ビットのレポート・サーバーを使用可能にしないでください。


手順1. IBM Cognos Configuration の「エクスプローラー」ウィンドウで、「環境」を

クリックします。

2. 「Report Server の実行モード」の「値」ボックスをクリックして、「64 ビット」を選択します。


4. 実行中の IBM Cognos サービスを再始動します。

アプリケーション・サービス・コンポーネントの起動環境プロパティーを設定すると、アプリケーション・サービス・コンポーネントのコンピューターでサービスを開始できるようになります。

始める前に

レポート作成に IBM Cognos Analytics を使用するには、サーバー・コンポーネントをインストールして設定し、IBM Cognos サービスを開始し、使用可能なデータ・ソースを参照しているパッケージを用意する必要があります。ただし、アップグレードを行う場合は、同じデータ・ソースを引き続き使用できます。

ユーザーまたはサービス・アカウントが設定されていることを確認します。詳細については、 15 ページの『IBM Cognos Analytics のユーザー・アカウントまたはネットワーク・サービス・アカウントの設定』を参照してください。


アップグレードを行う場合、設定ファイルの検出とアップグレードが行われたことを通知するメッセージが表示されます。

2. 設定が保存されていることを確認します。保存されていない場合、IBM Cognosサービスを開始できません。

3. 「操作」メニューの「テスト」をクリックします。

IBM Cognos Configuration では、共通対称鍵 (CSK) の可用性の確認、ネームスペースの設定のテスト、Content Store およびその他のリソースへの接続のテストが行われます。

ヒント: 「テスト」を選択できない場合は、「エクスプローラー」ウィンドウで「ローカル設定」をクリックします。

4. テストが失敗した場合は、該当するプロパティーを再設定し、もう一度テストを実行します。

コンポーネントの中から決まったものを 1 つずつテストする場合は、「エクスプローラー」パネルでコンポーネントを右クリックし、「テスト」を選択します。

すべてのテストがエラー・フリーになるまでサービスを開始しないでください。

5. 「操作」メニューの「開始」をクリックします。

IBM Cognos サービスの開始には、数分かかることがあります。


この操作によって、実行中でないすべてのインストール済みのサービスが開始され、IBM Cognos サービスが Windows に登録されます。

アプリケーション・サービス・コンポーネントのテストWeb ブラウザーを使用してインストールをテストできます。

手順1. Web ブラウザーを開きます。

2. IBM Cognos Configuration に設定されている「外部ディスパッチャー URI」の値を入力し、ディスパッチャーを使用できるかどうかをテストします。例えば、次のようになります。

http://host_name:port/bi

host_name:port のデフォルト値は localhost:9300 です。

ポータルが表示されるとディスパッチャーを使用できます。

Cognos Mobile データベースのセットアップデフォルトでは、Cognos Mobile 表は IBM Cognos Analytics Content Store データベース内に作成されます。 Cognos Analytics Content Manager とアプリケーション層コンポーネントが同じ場所にインストールされていない場合、代わりのCognos Mobile データベースを設定できます。

Cognos Mobile データベースを設定するには、最初にデータベースを作成し、データベースの操作に使用するユーザー・アカウントを作成してから、 CognosAnalytics がそのデータベースを使用するように設定する必要があります。

手順1. Content Store データベースの作成と同じ手順で、データベースを作成しま

す。詳細については、 8 ページの『Content Store を作成する際のガイドライン』を参照してください。

2. データベースの操作に使用するユーザー・アカウントを作成します。

3. アプリケーション層コンポーネントがインストールされているコンピューターで IBM Cognos Configuration を起動します。

4. 「エクスプローラー」ウィンドウの「データ・アクセス」で、「モバイル」を右クリックし、「新規リソース」 > 「データベース」を選択します。

5. 「タイプ」フィールドでデータベース・タイプを選択します。

6. データベースの名前を入力し、「OK」をクリックします。

7. 「データベース - リソース・プロパティー」ウィンドウで、データベース・サーバー名とポート番号、およびステップ 2 で指定したユーザー ID とパスワードを指定します。



9. 新しいデータベースへの接続をテストするには、「操作」メニューの「テスト」をクリックします。


10. 「アクション」メニューから「開始」または「再開」を選択して IBM Cognosサービスを開始します。

Cognos Mobile テーブルは、Mobile サービスを最初に開始すると自動的に作成されます。

ヒント: テーブルが作成されない場合、原因としては Cognos Analytics セキュリティー資格情報によって許可されていないことが考えられます。その場合は、手動で作成できます。作成するためのスクリプトはinstall_location¥configuration¥schemas¥mobile ディレクトリーにあります。

次のタスク

ユーザーは IBM Cognos Mobile アプリを自分のモバイル・デバイスにインストールして、IBM Cognos Analytics のレポートまたは分析にアクセスできます。アプリの iOS バージョンは Apple App Store から、Android バージョンは GooglePlay Store からダウンロードできます。


第 5 章ゲートウェイのインストールと設定

オプションのゲートウェイは、1 台以上のコンピューターにインストールできます。 IIS の Kerberos セキュリティーを使用したシングル・サインオン、Web サーバーがファイアウォールの外側で公に利用可能なアーキテクチャーなど、拡張オプションを設定する予定がある場合に、ゲートウェイをインストールします。 IBMCognos Analytics は Web サーバーを使用して、アイコンや画像ファイルなどの静的コンテンツのホスティングとサービス提供に加えて、特定の要求の負荷分散を行います。

ゲートウェイ・コンピューターを設定する前に、アクティブなアプリケーション・サービスをインストールしたコンピューターを設定し、アクセス可能にしておく必要があります。

次の図は、ゲートウェイ・サーバーと複数の Cognos Analytics サーバーを示しています。負荷分散が有効になっている場合、作業負荷をサーバー間で分散できます。

この設定は、ルーティングが 1 台のサーバーを通過するような単一アプリケーション層の環境でも推奨されており、必要に応じて、追加の層のサーバーを追加することができます。

次の手順を行ってゲートウェイをインストールして設定します。

v ゲートウェイ・コンポーネントをインストールします。 106 ページの『Cognos Analytics ゲートウェイのインストール』を参照してください。

v IBM Cognos Analyticsを設定します。 107 ページの『Cognos Analytics とWeb サーバーの設定』を参照してください。

v ご使用の Web サーバーが Apache HTTP Server または IBM HTTP Server の場合は、 111 ページの『Apache HTTP Server または IBM HTTP Server の設定』の手順を実行します。

105

v ご使用の Web サーバーが Microsoft インターネット・インフォメーション・サービスの場合は、 126 ページの『Microsoft インターネット・インフォメーション・サービスの設定』の手順を実行します。

v ゲートウェイのインストールをテストします。

Cognos Analytics ゲートウェイのインストールIBM Cognos Analytics ゲートウェイは、1 台以上のコンピューターにインストールできます。 Web ファームを使用している場合は、IBM Cognos Analytics ゲートウェイを各 Web サーバーにインストールできます。

始める前に


一時ディレクトリーに 5 GB 以上のメモリーがあることを確認してください。

ヒント: 一時ディレクトリーは、UNIX または Linux オペレーティング・システムの場合は環境変数 IATEMPDIR、Microsoft Windows オペレーティング・システムの場合は環境変数 TMP を使用して設定されます。

手順1. インストール・ウィザードを開始します。

a. UNIX または Linux の場合は、オペレーティング・システムのディレクトリーに移動して、./ca_srv_platform_build.bin と入力します。

ヒント: ca_srv_<platform>_<build>.bin コマンドを X Window で使用した場合、メッセージやログ・ファイルの日本語文字が文字化けすることがあります。 UNIX または Linux 上に日本語環境でインストールする場合、最初に環境変数を LANG=C および LC_ALL=C のように設定します。ここで、C は言語コード (例えば Solaris では ja_JP.PCK) を表します。次にインストール・ウィザードを起動します。


b. Microsoft Windows の場合は、オペレーティング・システムのディレクトリー、またはインストール・ファイルがダウンロードされた場所に移動して、ca_srv_platform_build.exe をダブルクリックします。



3. 「カスタム」インストール・オプションを選択し、インストール・ウィザードの指示に従って、必要なファイルをコンピューターにコピーします。




パス名に ASCII 文字のみが含まれるディレクトリーにゲートウェイ・コンポーネントをインストールします。一部の UNIX Web サーバーおよび LinuxWeb サーバーでは、ディレクトリー名に ASCII 以外の文字は使用できません。

v コンポーネントを選択するときに、「ゲートウェイ」以外のすべてのコンポーネントの選択を解除します。


Cognos Analytics と Web サーバーの設定ユーザーが IBM Cognos Analytics ポータルに接続できるようにするには、事前にWeb サーバーを設定しておく必要があります。

レポートの作成に使用する IBM Cognos Analytics の場合は、Web ブラウザーによる初回アクセス後に画像のステータスがチェックされないように、Web サーバーの「images」ディレクトリーのコンテンツ期限も設定する必要があります。

ファイルに対するアクセス権

Web サーバーの実行に使用するアカウントには、Cognos のインストール場所に対する読み取り、書き込み、実行の権限が必要です。読み取り権限は、cogstartup.xml ファイルの ./configuration ディレクトリーに対して必要になります。書き込み権限は、デバッグ・トレースが必要な場合に、./logs に対して必要になります。実行権限は、./cgi-bin ディレクトリーに対して必要になります。これは、Apache HTTP Server、IBM HTTP Server、または Microsoft インターネット・インフォメーション・サービスの SSO モジュールをその Web サーバーで実行できるようにするためです。

設定手順での参照値

必要に応じて以下の値を参考にしてください。

v サーバー名: Web サーバーのホスト名

v ポート番号: 80 (非 SSL) または 443 (SSL)

v 仮想ディレクトリー名: ibmcognos

v Cognos Analytics サーバー名: IBM Cognos Analytics サーバーのホスト名

重要: ご使用の環境に複数の Cognos Analytics サーバーが含まれる場合、以下の手順では Content Manager サービスを実行しているサーバーを含めないでください。アプリケーション・サーバーのコンポーネントがインストールされて構成されている Cognos Analytics サーバーのみ含めてください。

v Cognos Analytics ポート #: 9300

使用するインストールのタイプに応じて、以下の URI 設定の一部またはすべてがCognos Configuration 内に存在します。

v ゲートウェイ URI: 非 SSL の場合は、http://web_server_host_name:80/

ibmcognos/bi/v1/disp を使用します。 SSL の場合は、https://

web_server_host_name:443/ibmcognos/bi/v1/disp を使用します

第 5 章ゲートウェイのインストールと設定 107

切断されたコンテンツ (PDF、Excel、アクティブ・レポートに組み込まれているリンクなど) の URL です。E メールで送信するリンクでも使用されます。

v ゲートウェイ用ディスパッチャー URI: http(s)://

IBM_Cognos_Analytics_server_host_name:9300/bi/v1/disp

これは、要求転送時の Cognos Apache モジュールまたは ISAPI コードの接続先 URI のリストです。フェイルオーバーのために複数のエントリーを使用できます。関連する IBM Cognos Analytics アプリケーション・サーバーをすべて含めてください。

v 外部アプリケーション用ディスパッチャー URI: http(s)://

IBM_Cognos_Analytics_server_host_name:9300/bi/v1/disp

外部アプリケーション (Framework Manager など) は、この URL に接続してSDK 操作を実行します。

Microsoft インターネット・インフォメーション・サービス

シングル・サインオン (SSO) を設定する場合、IsapiModule およびWindowsAuthenticationModule がインストールされて有効化されていることを確認します。

IIS 用の Application Request Routing 拡張機能をインストールします。インストール方法について詳しくは、https://www.iis.net/downloads/microsoft/application-request-routing を参照してください。これにより、URL 書き換え(URL Rewrite) 拡張機能もインストールされます。

Web 管理者は、URL 書き換え (URL Rewrite) を使用すると、強力な規則を作成して、ユーザーが覚えやすく検索エンジンで検出しやすい URL を実装できます。Web サーバー管理者は、Application Request Routing を使用すると、規則ベースのルーティング、クライアントとホスト名の親和性、HTTP サーバー要求の負荷分散、分散ディスク・キャッシュにより、web アプリケーションの拡張性と信頼性を向上できます。

Cognos Analytics 11.0.3 から Cognos Analytics 11.0.4 (またはそれ以降) にアップグレードしようとしており、server.xml を変更して sso/login パスが/ibmcognos/cgi-bin/cognosisapi.dll を指すように設定してある場合は、以下の項目を install_location/wlp/usr/servers/cognosserver/server.xml から削除します。

<jndiEntry jndiName="glass/sso/login" value="/ibmcognos/cgi-bin/cognosisapi.dll"/>

Active Directory Server の設定について詳しくは、 280 ページの『ActiveDirectory サーバーと IBM Cognos コンポーネント間でのシングル・サインオンの有効化』を参照してください。

32 ビット Web ゲートウェイの有効化32 ビット Web サーバーでは、インストール・ディレクトリーに手動で 32 ビット・ゲートウェイ・ファイルを移動する必要があります。


https://www.iis.net/downloads/microsoft/application-request-routing

https://www.iis.net/downloads/microsoft/application-request-routing

手順1. インストールの場所/cgi-bin に移動します。

2. 次のコマンドを入力します。

v UNIX または Linux オペレーティング・システムの場合は、./copyGateMod.sh 32bit と入力します。

v Windows オペレーティング・システムの場合は、copyGateMod.bat 32bit

と入力します。

タスクの結果

32 ビットのゲートウェイ・ファイルは cgi-bin/lib ディレクトリーから cgi-binディレクトリーにコピーされます。

注: デフォルトの 64 ビットのゲートウェイ・ファイルを置き換える必要がある場合、手順に従って「./copyGateMod.sh 64bit」または「copyGateMod.bat

64bit」と入力します。 64 ビットのゲートウェイ・ファイルは cgi-bin/lib64 ディレクトリーから cgi-bin ディレクトリーにコピーされます。

ディスパッチャー URI の設定Content Manager やアプリケーション層コンポーネントとは異なるコンピューターにゲートウェイ・コンポーネントをインストールする場合、ディスパッチャーの場所を認識できるようにゲートウェイのコンピューターを設定する必要があります。ディスパッチャーは、Content Manager とアプリケーション層コンポーネントのすべてのコンピューターにインストールされます。ゲートウェイでは、アプリケーション層コンポーネントのコンピューターのディスパッチャーを使用するように設定します。

フェイルオーバー保護として、ゲートウェイのコンピューターに複数のディスパッチャーを設定できます。複数のディスパッチャーが設定されると、要求は通常、リスト内の最初のディスパッチャーにルーティングされます。このディスパッチャーが使用できなくなると、ゲートウェイによって、リスト内で次に機能するディスパッチャーが指定され、その場所へ要求がルーティングされます。プライマリー・ディスパッチャーの状態はゲートウェイによって監視され、ディスパッチャーが再び正常に機能するようになると、要求がこのコンポーネントにルーティングされます。

必要な設定作業を完了すると、ゲートウェイ・コンピューターは使用している環境で正しく動作するようになります。

始める前に

ゲートウェイ・コンピューターを設定する前に、Content Manager をインストールしたコンピューターの設定が済んでおり、デフォルトのアクティブな ContentManager コンピューターが利用可能になっていることを確認します。


a. Microsoft Windows の場合、「スタート」 > 「IBM CognosConfiguration」をクリックします。


Windows 7、または Windows 2008 コンピューターを使用していて、製品を Program Files (x86) ディレクトリーにインストールした場合は、IBMCognos Configuration を Administrator として始動してください。

b. UNIX または Linux オペレーティング・システムの場合は、<インストールの場所>/bin64 ディレクトリーに移動して、次のコマンドを入力します。

./cogconfig.sh



Java.lang.unsupportedClassVersionError メッセージが表示された場合は、64 ビット・バージョンの Java を使用していることを確認します。


3. 「プロパティー」ウィンドウの「ゲートウェイ設定」で、次のように「ゲートウェイ用ディスパッチャー URI」の値を指定します。

v 「値」列をクリックします。

v 「編集」ボタンをクリックします。

v URI の localhost の部分を、アプリケーション層コンポーネントのコンピューターの名前または IP アドレスに変更します。

これにより、ユーザーは、E メールで送信されるレポートやワークスペースにさまざまな場所から接続できます。

ヒント: ネットワーク・ファイアウォールの外にある Software DevelopmentKit アプリケーションまたは IBM Cognos Analytics モデル作成ツールからディスパッチャーに要求を送信する場合は、ユーザー環境の内部ディスパッチャー URI (例えば、http://localhost:9300/p2pd/servlet/dispatch) を使用して、ディスパッチャーに接続するように設定された専用ゲートウェイに接続します。セキュリティー上の理由から、ゲートウェイ・プロパティー用ディスパッチャー URI のデフォルト設定では、ディスパッチャーがファイアウォールの外にある Software Development Kit アプリケーションまたはモデル作成ツールの要求を受け入れないようになっています。この専用ゲートウェイに、SSL などの適切なセキュリティーを設定する必要があります( 209 ページの『IBM Cognos コンポーネントの SSL プロトコルの設定』を参照)。メイン・ゲートウェイを、内部ディスパッチャー URI を使用するように変更しないでください。メイン・ゲートウェイを変更すると、IBMCognos Analytics ポータルおよび Studio/Authoring ツールのセキュリティーが低下します。

v 別の URI を追加するには、「追加」をクリックし、新しい URI の localhostの部分を別のアプリケーション層コンポーネントのコンピューターの名前または IP アドレスに変更します。

ヒント: 待機中の Content Manager コンピューターのディスパッチャーを使用する場合は、必ずアプリケーション層コンポーネントのコンピューターを追加してから、そのディスパッチャーを追加します。アクティブな


Content Manager コンピューターからディスパッチャーを追加する場合は、そのディスパッチャーがリストの最後にあることを確認してください。

v すべての URI を指定したら、「OK」をクリックします。


5. 「認証局設定」プロパティー・グループで、デフォルトのアクティブな ContentManager コンピューターで指定したプロパティーに合わせて、「パスワード」プロパティーを設定します。

6. 暗号化に関する他のすべての設定が、デフォルトのアクティブな ContentManager コンピューターで設定した内容と一致することを確認します。

7. 対称鍵を取得できることをテストします。「エクスプローラー」ウィンドウの「暗号化」を右クリックし、「テスト」をクリックします。

IBM Cognos Analytics コンポーネントによって、共通対称鍵 (CommonSymmetric Key:CSK) の可用性がチェックされます。


Apache HTTP Server または IBM HTTP Server の設定このセクションでは、Apache HTTP Server または IBM HTTP Server を IBMCognos Analytics の Web サーバーとして設定する方法について説明します。

Cognos Analytics 11.0.10+ での IBM HTTP Server V9 の設定

IBM HTTP Server (IHS) V9 Web サーバーを使用して、複数の IBM CognosAnalytics アプリケーション・サーバー間の負荷分散とフェイルオーバーをサポートできます。

そうするには、IHS V9 と Web Server Plug-ins for IBM WebSphere ApplicationServer V9 をインストールした後、cognos.conf ファイルを使用するように IHSV9 を設定する必要があります。

Web Server Plug-ins for IBM WebSphere Application Server V9 のインストールについて詳しくは、この記事 (www.ibm.com/support/knowledgecenter/en/SSAW57_9.0.0/com.ibm.websphere.installation.nd.doc/ae/rins_plugins_info.html)を参照してください。

手順1. IBM Installation Manager (IIM) をまだインストールしていなければ、なるべ

くバージョン 1.8.5 以降をインストールします。

IIM はこの場所 (www.ibm.com/support/docview.wss?uid=swg24041188) からダウンロードできます。

2. IIM を使用して、Online product repositories for Liberty offerings(www.ibm.com/support/knowledgecenter/SSEQTP_liberty/com.ibm.websphere.wlp.nd.multiplatform.doc/ae/cwlp_ins_repositories.html)


https://www.ibm.com/support/knowledgecenter/en/SSAW57_9.0.0/com.ibm.websphere.installation.nd.doc/ae/rins_plugins_info.html


https://www.ibm.com/support/knowledgecenter/SSEQTP_liberty/com.ibm.websphere.wlp.nd.multiplatform.doc/ae/cwlp_ins_repositories.html

から IBM HTTP Server (IHS) V9 と Web Server Plug-ins for IBMWebSphere Application Server V9 をインストールします。

以下のインストール・パスを使用してください。

v IHS V9 のインストール・ルートとして /opt/IHS90

v Web Server Plug-ins for IBM WebSphere Application Server のインストール・ルートとして /opt/IHS90Plugin

IHS V9 のインストール・ルート内に Plug-ins をインストールすることはできません。

3. 以下のコマンドを実行して、WAS Web Server Plug-ins V9 と IHS V9 を関連付けます。

. cd /opt/IHS90

. bin/simplepct.sh /opt/IHS90Plugin

ヒント: UNIX では、このコマンドを実行した後に、IHS V9 インストール済み環境内の httpd.conf ファイルを確認してください。 $PLG_ROOT があれば、WAS Web Server Plug-ins V9 インストール・ルート・フォルダー (例えば/opt/IHS90Plugin) に置き換えてください。

4. WAS Web Server Plug-ins 用の plugin-cfg.xml ファイルを生成します。詳細については、 114 ページの『Cognos Analytics サーバーのためのplugin-cfg.xml の生成』を参照してください。

5. ステップ 4 で生成された plugin-cfg.xml ファイルをWAS_Web_Server_Plugins_install_root/config/webserver1 ディレクトリー (例えば /opt/IHS90Plugin/config/webserver1) にコピーします。

ヒント: UNIX では、plugin-cfg.xml ファイルをコピーした後、そのファイルに読み取り権限と実行権限を設定しておいてください。

6. 以下のステップに従って、IHS V9 を設定します。

a. cognos_analytics_gateway_component_install_location/cgi-bin/

templates ディレクトリー内のテンプレート・ファイルcognos_IHS9_SSO.conf または cognos_IHS9.conf にアクセスします。

b. テンプレート・ファイルを IHS9_install_root/conf ディレクトリー (例えば /opt/IHS90/conf) にコピーして、名前を cognos.conf に変更します。cognos.conf ファイルを変更して、適切なインストール場所を指すようにします。

c. Cognos Analytics と Apache HTTP Server または IBM HTTP Server の設定の記事に記載されているように httpd.conf を設定します。

d. IHS V9 Web サーバーを再始動します。

IBM HTTP Server V9 での SSL の設定Web サーバーが IBM HTTP Server V9 であるときに、IBM Cognos Analytics でSecure Socket Layer (SSL) を使用する場合は、IBM Cognos 証明書を抽出してWAS Web Server Plug-ins トラストストアにそれを追加することにより、WASWeb Server Plug-ins と Cognos Analytics アプリケーション・サーバーの間にSSL をセットアップする必要があります。


IBM HTTP Server V9 で SSL を使用する場合は、 116 ページの『IBM HTTPServer での SSL の設定』の記事に記載されているように環境を設定する必要があります。

手順

1. SSL を使用するように設定された IBM Cognos Analytics アプリケーション・サーバーを始動します。

2. Cognos_Analytics_applicaton_server_install_root/wlp/usr/servers/

cognosserver/logs/state/plugin-cfg.xml ファイル内の Server セクションをplug-in/config/webserver1/plugin-cfg.xml ファイルにコピーします。CognosAnalyticsの https エントリー・ポイントが次の例のように指定されていることを確認してください。

<Server CloneID="a4949c5e-cb36-40dd-9f43-58702daf7b1a" ConnectTimeout="5"ExtendedHandshake="false" LoadBalanceWeight="20" MaxConnections="-1"Name="default_node_cognosserver" ServerIOTimeout="900" WaitForContinue="false">

<Transport Hostname="hostname" Port="xxx" Protocol="https"><Property Name="keyring" Value="D:\install\IBM\WebSphere\Plugins\config\

webserver1\plugin-key.kdb"/><Property Name="stashfile" Value="D:\install\IBM\WebSphere\Plugins\config\

webserver1\plugin-key.sth"/></Transport>

</Server>

3. Plug-in/config/webserver1/plugin-cfg.xml ファイルで、次の属性を Configセクションに追加します。

AutoSecurity="false"

4. 以下のステップに従って、IBM Cognos 証明書を取得します。

a. Cognos Analytics applicaton_server_install_root/bin ディレクトリーに移動します。

b. ご使用のオペレーティング・システムに応じた適切なコマンドを入力して、証明書を抽出します。

UNIX または Linux オペレーティング・システムの場合は、次のように入力します。

ThirdPartyCertificateTool.sh -E -T -r destination file -p NoPassWordSet

Windows オペレーティング・システムの場合は、次のように入力します。

ThirdPartyCertificateTool.bat -E -T -r destination file -p NoPassWordSet

5. ステップ 4 で生成された .cert ファイル (例えば ca-host1.cert) を WASWeb Server Plug-ins ホストにコピーします。

6. Cognos Analytics の .cert ファイルを WAS Web Server Plug-ins 鍵ストアplugin-key.kdb に追加します。 plugin-key.kdb ファイルが存在しない場合は、ステップ 7 の説明に従って作成してください。

.cert ファイルを鍵ストアに追加するには、いくつかの方法を使用できます。以下のステップは、IHS V9 に付属の gskcapicmd ツールを使用して行う方法を示しています。

a. IHS9 ROOT フォルダーに移動します。

b. ご使用のオペレーティング・システムに応じた適切なコマンドを入力します。



bin/gskcapicmd -cert -add -db WAS_Plugin_root/config/webserver1/plugin-key.kdb-stashed -label ca-host1 -file ca-host1.cert


bin\gskcapicmd.bat -cert -add -db WAS_Plugin_root\config\webserver1\plugin-key.kdb-stashed -label ca-host1 -file ca-host1.cert

証明書ファイルを鍵ストアに追加する他の方法は、IBM Knowledge Center(www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/) で検索して確認してください。

7. WAS Web Server Plug-ins 用の空の鍵ストアを作成します。

a. IHS9 ROOT フォルダーに移動します。

b. ご使用のオペレーティング・システムに応じた適切なコマンドを入力します。


bin/gskcapicmd -keydb -create -db WAS_Plugin_root/config/webserver1/plugin-key.kdb -pw xxx -stash


bin\gskcapicmd.bat -keydb -create -db WAS_Plugin_root\config\webserver1\plugin-key.kdb -pw xxx -stash

Cognos Analytics サーバーのための plugin-cfg.xml の生成WebSphere Application Server が使用される環境では、Web サーバー・プラグインが要求をどのように転送するかを決定するための設定情報が plugin-cfg.xml ファイルに格納されます。

ヒント: 以下の手順は、Content Manager サービスを実行するために使用されるIBM Cognos Analytics サーバーには適用されません。

手順

1. Cognos Analytics アプリケーション・サーバーのインストール場所に移動します。

2. ca_applicaton_server_install_root/wlp/usr/servers/cognosserver/

server.xml ファイルを開き、次の設定をファイルに追加します。

<pluginConfiguration pluginInstallRoot="WAS_Web_Server_Plugin_install_root"webserverPort="IHS9_port"/>

次に例を示します。

<pluginConfiguration pluginInstallRoot="/opt/IHS90Plugin" webserverPort="8080"/>

3. Cognos Analytics アプリケーション・サーバーを設定して始動します。

サーバーが始動すると、plugin-cfg.xml という名前のファイルが CognosAnalytics applicaton_server_install_root/wlp/usr/servers/cognosserver/

logs/state ディレクトリーに生成されます。


https://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.cbi.doc/welcome.html

4. plugin-cfg.xml ファイルを開き、UriGroup セクションを変更して以下の 2 つの要素以外をすべて削除します。

<UriGroup Name="default_host_cognosserver_default_node_Cluster_URIs"><Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"

Name="/bi/*"/><Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"

Name="/bi/v1/*"/></UriGroup>

ヒント: 2 つ目の URL 項目はこのファイルに存在しません。これを追加する必要があります。

5. plugin-cfg.xml ファイルを保存します。

ServerCluster の Cognos Analytics アプリケーション・サーバーを 1 つ設定しただけです。

6. 別の Cognos Analytics アプリケーション・サーバーを ServerCluster に追加するには、以下のステップを実行します。

a. Cognos Analytics の application_server_install_root/wlp/usr/servers/cognosserver/logs/state ディレクトリーから plugin-cfg.xml ファイルを開きます。 ServerCluster セクションにある Server 要素をコピーします。例えば、次の Server 要素をコピーします。

<Server CloneID="081cd7c5-bb6c-4a93-a074-33fa07e587f3" ConnectTimeout="5"ExtendedHandshake="false" LoadBalanceWeight="20" MaxConnections="-1"Name="default_node_cognosserver" ServerIOTimeout="900" WaitForContinue="false"><Transport Hostname="caserverhost" Port="9300" Protocol="http"/></Server>

b. ステップ 4 で生成された plugin-cfg.xml ファイル内の ServerCluster セクションに Server 要素を貼り付けます。Server 要素で指定されたエンドポイントが Web サーバー・ホストからアクセスできることを確認してください。

c. Name 属性の値を変更してサーバーの名前を変更します。この名前はServerCluster に含まれる他のサーバー名とは異なるようにしてください。例えば、値を default_node_cognosserver からdefault_node_cognosserver_1 に変更します。

d. 以下に示すように、新しいサーバーを PrimaryServers セクションに追加します。

<PrimaryServers><Server Name="default_node_cognosserver"/><Server Name="default_node_cognosserver_1"/>

</PrimaryServers>

e. plugin-cfg.xml ファイルを保存します。新しいサーバーが ServerClusterに追加されます。

7. さらにサーバーを追加するには、ステップ 6 を繰り返します。

次のタスク

複数のスタンドアロン WebSphere Liberty Profile サーバーから plugin-cfg.xmlをマージする方法について詳しくは、この記事 (www.ibm.com/support/knowledgecenter/en/SSAW57_9.0.0/com.ibm.websphere.nd.multiplatform.doc/ae/twsv_merge_configfiles.html) を参照してください。


https://www.ibm.com/support/knowledgecenter/en/SSAW57_9.0.0/com.ibm.websphere.nd.multiplatform.doc/ae/twsv_merge_configfiles.html

IBM HTTP Server または Apache HTTP Server での WebDAVの設定

Reporting で画像を表示および参照するためには、Web サーバー上の WebDistributed Authoring and Versioning (WebDAV) を設定します。レポート作成者は、ファイル・システムを参照するときと類似の方法で、レポートに組み込む画像を参照できます。IBM HTTP Server または Apache HTTP Server で、ディレクティブをサーバー構成ファイルに追加し、ディレクトリー・アクセスを設定する必要があります。

手順1. <Web サーバーの場所>/conf ディレクトリーで、 httpd.conf ファイルをテキス

ト・エディターで開きます。

2. modules/mod_dav.so および modules/mod_dav_fs.so をロードするディレクティブのコメントを外します。

LoadModule dav_module modules/mod_dav.soLoadModule dav_fs_module modules/mod_dav_fs.so

3. DAVLockDB ディレクティブの場所を指定します。


DAVLockDB "webserver_location/var/DavLock"

このディレクトリーが存在することを確認してください。

4. 画像が保管されているディレクトリーの別名を作成します。

5. 別名の <Directory> 情報に、Dav On を追加します。


Alias /images "path/shared_images"

<Directory "path/shared_images">Dav OnOptions Indexes MultiViewsAllowOverride NoneOrder allow,denyAllow from all

</Directory>

6. ファイルを保存します。

7. Web サーバーを再始動します。

タスクの結果

WebDAV が有効になり、Reporting のユーザーはレポートに画像を追加できます。ユーザーが画像ブラウザーで「参照」をクリックするとき、参照のためのデフォルトの場所は http://servername/ibmcognos/bi/samples/images になります。別の場所を作成した場合、ユーザーはその場所を入力できます。

IBM HTTP Server での SSL の設定IBM HTTP Server で Secure Socket Layer (SSL) を使用する場合、IBM CognosConfiguration の「ゲートウェイ URI」値を変更して、ポータルにアクセスできるようにする必要があります。


Web サーバーで SSL を有効化するには、認証局 (Certificate Authority) (CA) によって署名された Web サーバー証明書を取得し、使用する Web サーバーにインストールする必要があります。証明書を Web サーバーと共に使用する方法について詳しくは、Web サーバーのドキュメントを参照してください。それらの証明書は、IBM Cognos 製品には備わっていません。

ユーザーが SSL を使用して IBM Cognos ポータルにアクセスできるようにするには、アプリケーション層コンポーネントおよび Framework Manager がインストールされた各コンピューターについて、IBM Cognos Configuration で「ゲートウェイ URI」値を変更する必要があります。

始める前に

IBM HTTP Server に IBM Global Security Kit (GSKit) がインストールされている必要があります。 IBM HTTP Server でサポートされるバージョンの GSKit について詳しくは、IBM Support ポータルの Global Security Kit (GSKit) supportedversions for releases of IBM HTTP Server (www.ibm.com/support/docview.wss?rs=177&context=SSEQTJ&uid=swg21173214) を参照してください。

手順1. アプリケーション層コンポーネントまたは Framework Manager がインスト

ールされている各コンピューターで、IBM Cognos Configuration を起動します。

2. 「ローカル設定」の下の「環境」をクリックして、「ゲートウェイ URI」値をhttp から https に変更します。

3. 「ゲートウェイ URI」値で、ポート番号を Web サーバー用に定義されたSSL ポート番号に変更します。例えば、SSL 接続のデフォルトのポート番号は通常 443 です。

4. アプリケーション層コンポーネントまたは Framework Manager がインストールされている各コンピューターで、<インストールの場所>/bin ディレクトリーに移動し、信頼チェーンを構成するすべての証明書を、ルート CA 証明書から始めて順に IBM Cognos トラストストアにインポートします。

以下のコマンドを入力して証明書をインポートしてください。

UNIX または LINUX の場合は、次のように入力します。

ThirdPartyCertificateTool.sh -T -i -r path/certificate_fileName -p

password

Windows の場合は、次のように入力します。

ThirdPartyCertificateTool.bat -T -i -r path¥certificate_fileName -D

install_location¥configuration¥certs -p password

注: パスワードが設定されていない場合、デフォルトのパスワードはNoPassWordSet です。

5. Web サーバーの ihs_install_root/bin ディレクトリーから次のコマンドを入力します。 ihs_install_root/bin/script_name


http://www.ibm.com/support/docview.wss?rs=177&context=SSEQTJ&uid=swg21173214


ここで、ihs_install_root は IBM HTTP Server がインストールされているディレクトリーです。また、script_name は、Microsoft Windows の場合はgskver.bat、UNIX または Linux の場合は gskver.sh です。 GSKit 共有ライブラリーおよびバージョン情報が表示されます。表示されるバージョンが、この手順の「始めに」セクションに記載されたサポート・ドキュメントに示されている最小サポート・バージョンであることを確認します。

6. 以下のコマンドを入力して、iKeyman ユーティリティーを開始します。ihs_install_root/bin/script_name

ここで、ihs_install_root は IBM HTTP Server がインストールされているディレクトリーです。また、script_name は、Microsoft Windows の場合はikeyman.bat、UNIX または Linux の場合は ikeyman.sh です。

7. メニューから、「鍵データベース・ファイル」 > 「新規」を選択します。

8. 以下の値を入力して、「OK」をクリックします。

ファイル名鍵データベース・ファイルの名前。デフォルト値は key.kdb です。

場所 key.kdb ファイルを格納する場所。デフォルト値はihs_install_root/bin です。

9. 「パスワード・プロンプト (Password Prompt)」ウィンドウで、パスワードを入力し、「パスワードをファイルに隠す (Stash a password to a file)」チェック・ボックスを選択して「OK」をクリックします。「パスワードをファイルに隠す (Stash a password to a file)」チェック・ボックスを選択すると、パスワードは暗号化されて、鍵データベース・ファイルと同じディレクトリーに .sth ファイルとして保存されます。

注: 認証局に送信する認証要求の作成方法については、Using iKeyman tocreate a key database file (www.ibm.com/support/docview.wss?rs=177&context=SSEQTJ&uid=swg21006430) を参照してください。正常に完了したことを示すメッセージが表示されます。

10. テキスト・エディターで ihs_install_root/conf/httpd.conf ファイルを開きます。

11. 鍵データベース・ファイルのパスとともに Keyfile ディレクティブを追加します。このディレクティブは、ファイル内の VirtualHost セクションの後に配置します。例えば、次のようになります。

<VirtualHost *:443>...</VirtualHost>KeyFile ihs_install_root/key.kdb

12. httpd.conf ファイルを保存して閉じます。

13. Cognos Analytics の証明書をファイルに抽出します。次のコマンドをca_install/bin の IBM Cognos Analytics サーバーから実行します。

script_name -E -T -r ca_cert_file -p NoPassWordSet

ここで、script_name は、Microsoft Windows の場合はThirdPartyCertificateTool.bat、UNIX または Linux の場合はThirdPartyCertificateTool.sh です。また、ca_cert_file は証明書ファイルの名前です。




14. 証明書ファイルを ihs_install_root/key_database_file_directory にコピーします。ここで、ihs_install_root は IBM HTTP Server のインストール先ディレクトリー、key_database_file_directory は鍵データベース・ファイルの保管先ディレクトリーです。

15. ihs_install_root/bin で、次のコマンドを入力します。

script_name -cert -import -db ca_cert_file-pw NoPassWordSet -target key.kdb -target_pw key_database_file_password

ここで、script_name は、Microsoft Windows の場合は gskcapicmd.bat、UNIX または Linux の場合は gskcapicmd.sh です。また、key_database_file_password は鍵データベース・ファイルのパスワードです。

16. IBM HTTP Server を開始します。 ihs_install_root/bin に次のコマンドを入力します。

script_name -k start

script_name は、Microsoft Windows の場合は apchectl.bat、UNIX またはLinux の場合は ./apachectl です。Microsoft Windows では、スクリプトをサービスとして開始することもできます。

17. Web ブラウザーのアドレス・フィールドに次の URI を入力して、IBM HTTPServer が実行されていることを確認します。

https://web_server_host_name:port

ここで、web_server_host_name は IBM HTTP Server のホスト名であり、portは IBM HTTP Server のポート番号です。

18. 設定を保存して、サービスを再開します。

タスクの結果

https://servername:443/ibmcognos を使用してポータルにアクセスすると、証明書のインストールを求めるプロンプトが出されます。新しいセッションで毎回セキュリティーに関するアラートが表示されないようにするには、使用している Web ブラウザーの証明書ストアのいずれかに証明書をインストールします。

Cognos Analytics 11.0.5+ での Apache HTTP Server またはIBM HTTP Server の設定

+

この手順を完了すると、サーバーは静的ファイル (.js、.html、.css など) に対する要求の処理、IBM Cognos Analytics への要求の負荷分散、および IBM CognosAnalytics ゲートウェイ・コードを使用した SSO 要求の送付を行うことができます。


IBM Cognos Analytics に付属のいずれかのサンプル設定ファイルを使用できます。サンプル・ファイルは gateway_component_install_location/cgi-bin/templates にあります。ここで、gateway_component_install_location は、ゲートウェ


イ・コンポーネントがインストールされているディレクトリーです。以下の表にサンプル・ファイルを記述します。ご使用の環境向けのファイルを選択してください。

環境サンプル・ファイル名

Apache 2.2 非 SSO cognos_apache22_loadbalance.conf

Apache 2.2 SSO cognos_apache22_loadbalance_SSO.conf

Apache 2.4 非 SSO cognos_apache24_loadbalance.conf

Apache 2.4 SSO cognos_apache24_loadbalance_SSO.conf

IBM HTTP Server 8.5 非 SSO cognos_IHS85_loadbalance.conf

IBM HTTP Server 8.5 SSO cognos_IHS85_loadbalance_SSO.conf

手順1. サンプル設定ファイルを apache_or_ihs_install_root/conf にコピーし、名前

を cognos.conf に変更します。

2. テキスト・エディターで cognos.conf を開き、HTTPS と完全修飾ドメイン名を使用するように BalancerMember ディレクティブを変更します。例えば、次のようになります。

<Proxy balancer://mycluster>BalancerMember https://ica-host1.domain:9300 route=1BalancerMember https://ica-host2.domain:9300 route=2</Proxy>

3. サンプル・ファイルに以下のセクションがあることを確認します。

# Rewrite Saved-Output and Viewer static referencesRewriteRule ^/ibmcognos/bi/rv/(.*)$ /ibmcognos/rv/$1 [PT,L]

このセクションがない場合、# Rewrite Event Studio static references セクションの後ろに追加してください。

4. Directory セクションを見つけて、IBM Cognos Analytics のインストール場所を指していることを確認します。

5. cognos.conf ファイルを保存します。

Cognos Analytics 11.0.4 での Apache HTTP Server またはIBM HTTP Server の設定

この手順を完了すると、サーバーは静的ファイル (.js、.html、.css など) に対する要求の処理、IBM Cognos Analytics への要求の負荷分散、および IBM CognosAnalytics ゲートウェイ・コードを使用した SSO 要求の送付を行うことができます。

始める前に

Cognos Analytics サーバーの 1 つ以上のインスタンスが設定され、動作している必要があります。そのインスタンスに、Web サーバーから http://IBM Cognos

Analytics サーバーのホスト名 1:9300/bi のような URL を使用してアクセスできなければなりません。複数の Cognos Analytics インスタンス間で要求を負荷分散


するには、mod_proxy_balancer を使用します。負荷分散のオプションについては、Apache の資料を参照してください。


このタスクの設定では、スティッキー・セッションの負荷分散が設定されます。http://web_server_host_name/ibmcognos/balancer-manager でロード・バランサーをモニターしたり設定したりできます

expires_module は、返されたリソースを保持できる期間をブラウザーに指示する応答ヘッダーを要求に追加します。その期間を過ぎると、新バージョンがあるか調べられます。deflate_module は、リソースを送信前に圧縮して帯域幅を節約します。

各プラットフォームの違いと、それぞれのコメントを以下に示します。下記の設定内の cognos_module の言及箇所は、シングル・サインオン (SSO) の設定時にのみ必要です。 SSO が不要な場合は、cognos_module は不要です。

手順1. apache/conf ディレクトリーで、cognos.conf という名前の空のファイルを作成

します。

2. テキスト・エディターで cognos.conf ファイルを開きます。

Apache 2.2 と Cognos Analytics バージョンには以下が適用されます。ご使用の環境に適用するときに、以下の例のようにコードを変更してください。コード内のいくつかの値は例として示しているにすぎません。使用可能なApache ディレクティブについて詳しくは、http://httpd.apache.org/docs/2.2/mod/mod_authnz_ldap.html を参照してください。

# cognos.conf for ▌Apache 2.2▐ and ▌IHS 8▐LoadModule headers_module modules/mod_headers.soLoadModule rewrite_module modules/mod_rewrite.soLoadModule expires_module modules/mod_expires.soLoadModule filter_module modules/mod_filter.soLoadModule proxy_module modules/mod_proxy.soLoadModule proxy_http_module modules/mod_proxy_http.soLoadModule proxy_balancer_module modules/mod_proxy_balancer.soLoadModule deflate_module modules/mod_deflate.so

▌# Apache 2.2 UNIX▐LoadModule cognos_module "/opt/IBM/cognos/analytics/cgi-bin/mod2_2_cognos.so"

▌# Apache 2.2 Windows▐LoadModule cognos_module "c:/IBM/cognos/analytics/cgi-bin/mod2_2_cognos.dll"

<IfModule mod_expires.c><FilesMatch "\.(jpe?g|png|gif|js|css|json|html|woff2?|template)$">

ExpiresActive OnExpiresDefault "access plus 1 day"

</FilesMatch></IfModule>

<IfModule mod2_2_cognos.c>CGIBinDir "/opt/IBM/cognos/analytics/cgi-bin"

</IfModule>

<Directory /opt/IBM/cognos/analytics><IfModule mod_deflate>

AddOutputFilterByType DEFLATE text/html application/json text/cssapplication/javascript

</IfModule>


https://httpd.apache.org/docs/2.2/mod/mod_proxy_balancer.html

http://httpd.apache.org/docs/2.2/mod/mod_authnz_ldap.html

http://httpd.apache.org/docs/2.2/mod/mod_authnz_ldap.html

Options Indexes MultiViewsAllowOverride NoneOrder allow,denyAllow from all

</Directory>

#Set up a cluster for load-balancing# Include all Cognos Analytics servers that have the Application server components# installed and configured.# Important: do not include Cognos Analytics servers that are used to run the# Content Manager service.<Proxy balancer://mycluster>

BalancerMember http://ca-host1:9300 route=1BalancerMember http://ca-host2:9300 route=2BalancerMember http://ca-host3:9300 route=3

</Proxy>

# UI to monitor/configure load balancer<Location /ibmcognos/balancer-manager>

SetHandler balancer-manager</Location>

# Use ScriptAlias if you plan to use ▌cognos.cgi▐ instead of mod_cognos for SSOScriptAlias /ibmcognos/cgi-bin /opt/IBM/cognos/analytics/cgi-bin

Alias /ibmcognos /opt/IBM/cognos/analytics/webcontent

RewriteEngine On

# Send default URL to serviceRewriteRule ^/ibmcognos/bi/$ balancer://mycluster/bi/ [P]

# Send login requests and legacy UI's through ▌cognos_module▐ for SSORewriteRule ^/ibmcognos/bi/v1/(login|disp)(/.*)?

/ibmcognos/sso/bi/v1/$1$2 [PT,L]

#Or Send login requests and legacy UI's through ▌cognos.cgi▐ for SSORewriteRule ^/ibmcognos/bi/v1/(login|disp)(/.*)?

/ibmcognos/bi/v1/disp/bi/v1/$1$2 [PT,L]

# Rewrite Event Studio static referencesRewriteCond %{HTTP_REFERER} v1/disp [NC]RewriteRule ^/ibmcognos/bi/(ags|cr1|prompting|ccl|common|skins|ps)/(.*)

/ibmcognos/$1/$2 [PT,L]

# Rewrite Saved-Output and Viewer static referencesRewriteRule ^/ibmcognos/bi/rv/(.*)$ /ibmcognos/rv/$1 [PT,L]

# Define cognos location<Location /ibmcognos>

RequestHeader set X-BI-PATH /ibmcognos/bi/v1</Location>

# Route CA REST service requests through proxy with load balancing<Location /ibmcognos/bi/v1>

Header add Set-Cookie "ROUTEID=.%{BALANCER_WORKER_ROUTE}e;path=/ibmcognos/bi/v1" env=BALANCER_ROUTE_CHANGED

ProxyPass balancer://mycluster/bi/v1 stickysession=ROUTEID</Location>

# Route login and legacy UI requests through ▌mod_cognos▐<Location /ibmcognos/sso>

SetHandler cognos-handler# Add SSO Directives here, for example...AuthType basicAuthName "LDAP"


AuthBasicProvider ldapAuthLDAPURL "ldap://ldap:389/ou=people, o=example.com?uid?sub?(objectClass=*)"

Require valid-user</Location>

# This is an example only.# For more information about the apache directives that can be used# see http://httpd.apache.org/docs/2.2/mod/mod_authnz_ldap.html# Route login and legacy UI requests through ▌cognos.cgi▐<Location /ibmcognos/cgi-bin>

# Add SSO Directives here, for example...AuthType basicAuthName "LDAP"AuthBasicProvider ldapAuthLDAPURL "ldap://ldap:389/ou=people, o=example.com?uid?sub?(objectClass=*)"

Require valid-user</Location>

3. IBM HTTP Server 8.5 を使用している場合は、cognos.conf の次の行を変更します。

LoadModule proxy_balancer_module modules/WebSphereCE/mod_proxy_balancer.so


5. サーバーを再始動します。

Cognos Analytics 11.0.3 での Apache HTTP Server またはIBM HTTP Server の設定

-

Red Hat Enterprise Linux バージョン 5.3 以降と共に提供された Apache Server2.2 のバージョンの Apache モジュールは使用できません。

始める前に

このトピックでは、オプションのゲートウェイ・コンポーネントをインストールしていること、Apache HTTP Server をインストールして実行していること、そしてLinux および UNIX 環境を管理できることを想定しています。

Apache HTTP Server を使用するときは、異なるバージョンで使用できる以下の機能に注意してください。

機能 Apache 2.2 Apache 2.4

負荷分散サポートされないあり

ゲートウェイ・モジュールありなし

プロキシーありあり

IBM Cognos Analytics で必要なすべての設定を保持する新しい設定ファイルを受け入れるように Apache Web サーバーを設定します。


Apache 2.2手順

1. cognos.conf ファイルを編集し、以下の行を追加します。

LoadModule headers_module modules/mod_headers.soLoadModule proxy_module modules/mod_proxy.soLoadModule proxy_http_module modules/mod_proxy_http.soLoadModule cognos_module "<gateway_location>/cgi-bin/mod2_2_cognos.<xx>"

<Location /<alias>/bi>RequestHeader set X-BI-PATH /alias/bi/v1ProxyPass http(s)://<app_server:port>/biProxyPassReverse http(s)://<app_server:port>/biProxyPassReverseCookieDomain "." "<domain>"</Location>

# Aliases for the CA web contentScriptAlias /<alias>/cgi-bin "<gateway_location>/cgi-bin"<Directory "<gateway_location>/cgi-bin">AllowOverride NoneOptions NoneOrder allow,denyAllow from all</Directory>

Alias /<alias> "<gateway_location>/webcontent"<Directory "<gateway_location>/webcontent">Options Indexes MultiViewsAllowOverride NoneOrder allow,denyAllow from all</Directory>

<Location /<alias>/cgi-bin/mod2_2_cognos.<xx>>SetHandler cognos-handler

CGIBinDir "<gateway_location>/cgi-bin/"Order allow,denyAllow from all

</Location>

2. 上記の手順で追加したセクションにあるプレースホルダーを適切な値で置き換えます。

v <別名> - Web の別名を指定します。例: ibmcognos

v <アプリケーション・サーバー:ポート> - Cognos Analytics アプリケーション・サーバーの名前とポート番号を指定します。例:appserver.ibm.com:9300

v <ドメイン> - サーバーが配置されているドメインを指定します。例:ibm.com

v <ゲートウェイの場所> - インストールされている Cognos AnalyticsGateway の物理的な場所を指定します。例: /opt/ibm/cognos/analytics

v <xx> - Apache がインストールされているオペレーション・システムに応じて拡張子の接尾辞を指定します。例: Windows = dll、Unix/Linux = so


4. IBM Cognos Analytics にシングル・サインオンを設定した場合、次の URL を使用して呼び出します。

http://ICA_Web_Server:80/ibmcognos/cgi-bin/mod2_2_cognos.so?b_action=xts.run&m=portal/main.xts&m_redirect=/ibmcognos/bi/


Apache 2.4手順

1. cognos.conf ファイルを編集し、以下を追加します。

LoadModule headers_module modules/mod_headers.soLoadModule proxy_module modules/mod_proxy.soLoadModule proxy_http_module modules/mod_proxy_http.soLoadModule slotmem_plain_module modules/mod_slotmem_plain.soLoadModule slotmem_shm_module modules/mod_slotmem_shm.soLoadModule proxy_balancer_module modules/mod_proxy_balancer.soLoadModule lbmethod_byrequests_module modules/mod_lbmethod_byrequests.so

# Header to add a cookie for sticky sessionsHeader add Set-Cookie "ROUTEID=.%{BALANCER_WORKER_ROUTE}e; path=/"

env=BALANCER_ROUTE_CHANGED

# Send everything which goes to BI Services through balanced proxy## Add/Remove the number of BalanceMember lines depending on the server in your# environment<Proxy balancer://mycluster>BalancerMember http://<app_server_x:port> route=1BalancerMember http://<app_server_x:port> route=2ProxySet stickysession=ROUTEID</Proxy>

<LocationMatch ^/<alias>/bi/(.*)$>RequestHeader set X-BI-PATH /<alias>/bi/v1ProxyPass balancer://mycluster/bi/$1ProxyPassReverseCookieDomain "." "<domain>"</LocationMatch>ProxyRequests off

# Aliases for the CA web contentScriptAlias /<alias>/cgi-bin "<gateway_location>/cgi-bin"<Directory "<gateway_location>/webcontent/cgi-bin">AllowOverride NoneOptions NoneRequire all granted</Directory>

Alias /<alias> "<gateway_location>/webcontent"<Directory "<gateway_location>/webcontent">Options Indexes MultiViewsAllowOverride NoneRequire all granted</Directory>

2. ご使用の環境を反映するように、以下のように変更します。

v <別名> - Web の別名を指定します。例: ibmcognos

v <アプリケーション・サーバー x:ポート> - ICA アプリケーション・サーバーの名前とポート番号を指定します。例: appserver.ibm.com:9300

v <ドメイン> - サーバーが配置されているドメインを指定します。例:ibm.com

v <ゲートウェイの場所> - ICA ゲートウェイがインストールされている物理的な場所を指定します。例: /opt/ibm/cognos/analytics

3. プロキシー設定にアプリケーション層サーバーを追加または削除するには、Proxy セクションに従って BalancerMember 行の数を調整します。


例えば、1 つのアプリケーション・サーバーを使用している場合、1 つのエントリーにします。

<Proxy balancer://mycluster>BalancerMember http://app_server_1:port route=1ProxySet stickysession=ROUTEID</Proxy>

4 つのアプリケーション・サーバーを使用している場合、4 つのエントリーにします。

<Proxy balancer://mycluster>BalancerMember http://app_server_1:port route=1BalancerMember http://app_server_2:port route=2BalancerMember http://app_server_3:port route=3BalancerMember http://app_server_4:port route=4ProxySet stickysession=ROUTEID</Proxy>

route= パラメーターによって、要求が送信される順序が決まります。


5. Apache HTTP サーバーを再始動します。

6. IBM Cognos Analytics でシングル・サインオンが設定されていれば、次のURL でシングル・サインオンを呼び出せます。http://ICA_Web_Server:80/

ibmcognos/bi/v1/disp?b_action=xts.run&m=portal/main.xts&m_redirect=/

ibmcognos/bi/

7. あるいは、URL のリダイレクト・セクションを削除する場合、以下を実行できます。

a. analytics/webcontent ディレクトリーに移動します。

b. 以下の行を変更して、default.htm ファイルを編集します。

<meta http-equiv="refresh" content="0; URL=/bi"> を <metahttp-equiv="refresh" content="0; URL=/<alias>/bi"> に変更します。

c. default.htm を保存します。

d. index.htm も同様に保存します。

e. http:// ICA_Web_Server:80/ibmcognos/bi/v1/disp または http://ICA_Web_Server:80/ibmcognos/cgi-bin/mod2_2_cognos.so を使用して接続をテストします。

Microsoft インターネット・インフォメーション・サービスの設定このセクションでは、Microsoft インターネット・インフォメーション・サービス(IIS) を IBM Cognos Analytics の Web サーバーとして設定する方法について説明します。

IIS での WebDAV の設定Reporting で画像を表示および参照するためには、Web サーバー上の WebDistributed Authoring and Versioning (WebDAV) を設定します。レポート作成者は、ファイル・システムを参照するときと類似の方法で、レポートに組み込む画像を参照できます。Microsoft インターネットインフォメーションサービス (IIS)


Web サーバーでは、まず WebDAV 機能を有効にし、イメージの場所にアクセスするように Web サーバーを設定する必要があります。

手順1. Microsoft Windows の「コントロールパネル」で、「プログラム」 > 「プ

ログラムと機能」をクリックします。

Microsoft Windows 8 または 2012 Server を使用する場合は、「プログラムと機能」を「コントロールパネル」から直接使用できます。

2. 「Windows の機能の有効化または無効化」をクリックします。

3. Microsoft Windows 2008 Server を使用している場合は、次の手順を使用します。

a. 「サーバーマネージャ」 > 「役割」 > 「Web サーバー (IIS)」をクリックします。

b. 「役割サービス」セクションで、「役割サービスの追加」を選択します。

c. 「Web サーバー」 > 「HTTP 基本機能」で、「WebDAV 発行」を選択します。

d. 「次へ」をクリックしてから「インストール」をクリックします。


a. 役割と機能の追加ウィザードで、「役割ベースまたは機能ベースのインストール」をクリックし、「次へ」をクリックします。

b. サーバーを選択し、「次へ」をクリックします。

c. 「Web サーバー (IIS)」 > 「Web サーバー」 > 「HTTP 基本機能」を展開し、「WebDAV 発行」を選択します。

d. 「次へ」 > 「次へ」をクリックし、「インストール」をクリックします。

5. Microsoft Windows 7 または 8 を使用している場合は、次の手順を使用します。

a. 「インターネットインフォメーションサービス」 > 「World WideWeb サービス」 > 「HTTP 共通機能」を展開します。

b. 「WebDAV 発行」を選択し、「OK」をクリックします。

6. 「インターネットインフォメーションサービス (IIS) マネージャー」コンソールの「接続」の下で、ご使用のサーバー名を選択します。

v Microsoft Windows 2012 Server を使用している場合は、「サーバーマネージャー」で「IIS」を選択し、サーバー名を右クリックして「インターネットインフォメーションサービス (IIS) マネージャー」をクリックします。

v Microsoft Windows 2008 Server を使用している場合は、「サーバーマネージャー」で「役割」 > 「Web サーバー (IIS)」を展開し、「インターネットインフォメーションサービス (IIS) マネージャー」をクリックします。

v Microsoft Windows 8 を使用している場合は、「コントロールパネル」から「管理ツール」をクリックして、「インターネットインフォメーションサービス (IIS) マネージャー」コンソールにアクセスします。


v Microsoft Windows 7 を使用している場合は、「スタート」>「コントロールパネル」から「システムとセキュリティ」 > 「管理ツール」をクリックして、「インターネットインフォメーションサービス (IIS) マネージャー」コンソールにアクセスします。

7. 「接続」で、ご使用の Web サーバー、「サイト」を展開し、Web サイトを選択します。例えば、「既定の Web サイト」を選択します。

8. 「WebDAV オーサリング」をダブルクリックします。

9. 「WebDAV の有効化」をクリックします。

10. 「WebDAV 設定」をクリックします。

11. 匿名アクセスが有効になっている場合は、「匿名プロパティの照会を許可」で「True」を選択し、「適用」をクリックします。

12. WebDAV アクセスを許可するディレクトリーまたは仮想ディレクトリーを選択します。

13. 「WebDAV オーサリング」をダブルクリックします。

14. 「オーサリング規則の追加」をクリックし、環境に適した規則を追加します。例えば、サンプルをインストールした場合、デフォルト・パスを使用するには、ibmcognos 仮想ディレクトリーで bi/samples を展開し、images を選択して、イメージ・ファイルのオーサリング規則を追加します。

15. オーサリング規則を追加したディレクトリーまたは仮想ディレクトリーを右クリックし、「権限を編集」をクリックします。

16. 「セキュリティー」をクリックし、適切な権限を追加します。例えば、Webサーバーへの匿名アクセスを許可する場合は、匿名アクセス・ユーザーの権限を追加します。 Web サイトを選択し、「認証」をダブルクリックして、表示されたユーザーのプロパティーを参照すると、そのユーザーが見つかります。

タスクの結果

WebDAV が有効になり、Reporting のユーザーはレポートに画像を追加できます。ユーザーが画像ブラウザーで「参照」をクリックするとき、参照のためのデフォルトの場所は http://servername/ibmcognos/bi/samples/images になります。別の場所を作成した場合、ユーザーはその場所を入力できます。

IIS での SSL の設定Microsoft インターネット・インフォメーション・サービス (IIS) で Secure SocketLayer (SSL) を設定するには、IBM Cognos 証明書を抽出し、それを IIS 上のトラストストアに追加します。

手順1. インストールの場所/bin ディレクトリーに移動します。

2. 次のコマンドを入力して IBM Cognos の証明書を抽出します。

UNIX または Linux オペレーティング・システムの場合、ThirdPartyCertificateTool.sh -E -T -r destination_file -p NoPassWordSet



Microsoft Windows オペレーティング・システムの場合、ThirdPartyCertificateTool.bat -E -T -r destination_file -p NoPassWordSet


3. IBM Cognos サーバーへの CA 証明書のコピーを実行します。

4. IIS のトラストストアに証明書をインポートします。 IIS のトラストストアに証明書をインポートする方法について詳しくは、ローカル・コンピューターの信頼されたルート証明機関ストアに証明書を追加するを参照してください。

Cognos Analytics 11.0.4 以降のバージョンでの IIS の設定

注:

これは必要に応じて更新される随時更新文書です。

注:

IIS 自動化スクリプトは、ここから入手できます。

このトピックでは、IBM Cognos Analytics をサポートするための Microsoft インターネット・インフォメーション・サービス (IIS) の設定について説明します。完了すると、直接 IIS から静的コンテンツ (.js、.html、.css など) を提供する一方で、REST やその他のサービス要求をバックエンドの Cognos Analytics サーバーに送信するように、IIS が設定されます。

手順1. IIS Application Request Routing 拡張機能をインストールします。

a. URL (http://www.iis.net/downloads/microsoft/application-request-routing) にアクセスし、IIS 用の Application Request Routing 拡張機能をインストールします。

b. Microsoft の Web ページが表示されたら、緑色の「新しい拡張機能のインストール」ボタンをクリックします。手順に従って、ARR 拡張機能をダウンロードし、実行します。

c. ARR 拡張機能が正常にインストールされたことを確認するには、Windowsの「スタート」>「管理ツール」メニューから IIS マネージャーを起動します。IIS マネージャーが起動したら、画面上部左側にあるサーバー名をクリックして、使用可能な機能を表示します。中央にある IIS ペイン内に、「URL 書き換え (URL Rewrite)」機能が表示されているはずです。それはARR がインストールされた際にインストールされました。

2. 新しい専用アプリケーション・プールを作成します。例えば、CAPool という名前にします。

a. 「アプリケーション・プール」を右クリックします。「アプリケーション・プールの追加」をクリックします。

3. オプションで、サーバー・ファームを作成して、Cognos Analytics サービス要求の負荷分散とフェイルオーバーを提供します。Application Server のコンポーネントがインストールされて構成されているすべての Cognos Analytics サーバーを含めます。


https://technet.microsoft.com/en-us/library/cc754841%28v=ws.11%29.aspx#BKMK_addlocal

https://technet.microsoft.com/en-us/library/cc754841%28v=ws.11%29.aspx#BKMK_addlocal


http://www.iis.net/downloads/microsoft/application-request-routing


a. 左側のツリーの「サーバー・ファーム (Server Farms)」を右クリックし、「サーバー・ファームの作成 (Create Server Farm)」を選択します。

b. 新しいサーバー・ファームに名前を付けます。例: ca_servers。

c. 各 Cognos Analytics サーバーで、次の手順を実行します。

v サーバー・アドレスを入力します。ca-host1 など。

v 「詳細設定」をクリックし、「applicationRequestRouting」を展開します。httpPort または httpsPort (HTTPS を使用する場合) を設定します。例えば、9300 にします。

d. 「終了」をクリックします。

e. IIS Manager に書き換え規則の作成を許可するプロンプトが出されたら、「いいえ」をクリックします。

f. 左側のツリー内でサーバー・ファームを選択して、「サーバーの親和性(Server Affinity)」をダブルクリックします。

g. 「クライアントの親和性 (Client Affinity)」チェック・ボックスを選択します。

h. 「適用」をクリックします。

i. 左側のツリー内でサーバー・ファームを選択して、「キャッシュ」をダブルクリックします。

j. 「クエリー文字列サポート (Query String Support)」を「クエリー文字列を含める (Include Query String)」に変更します。

k. 「適用」をクリックします。

l. 左側のツリー内でサーバー・ファームを選択して、「正常性のテスト(Health Test)」をダブルクリックします。

m. 「URL のテスト (URL Test)」セクションで、 URL http://ca_servers/

bi/v1/ping を入力します。

n. 「適用」をクリックします。

o. 左側のツリー内でサーバー・ファームを選択して、「プロキシー」をダブルクリックします。

p. 「タイムアウト (秒数)(Time-out (seconds))」フィールドで、値を 120 に変更します。

q. 「適用」をクリックします。

4. 「既定の Web サイト」を右クリックして、「アプリケーションの追加」をクリックします。

v 別名は ibmcognos です。

v アプリケーション・プールは、手順 1 で作成したプールです。

v 物理パスは install_location¥webcontent です。

a. Web コンテンツ期限を有効化します。

1) ibmcognos を選択し、「HTTP 応答ヘッダー」をダブルクリックします。

2) 「共通ヘッダーの設定」をクリックします。

3) 「期限切れの Web コンテンツ」にチェック・マークを付けて、最適な期限を設定します。


b. ibmcognos を選択し、「MIME タイプ」をダブルクリックします。

重要: 以下の MIME タイプがまだ IIS 構成にない場合は、追加してください。

v .svg : image/svg+xml

v .woff : application/x-font-woff

v .json : application/json

v .woff2 : font/woff2

v .template : text/html

v .txt : text/plain

5. IIS と Cognos の間のシングル・サインオンを設定している場合は、ibmcognos

を右クリックし、「アプリケーションの追加」をクリックします。

v 「別名」は sso です。

v 「アプリケーション・プール」は、手順 1 で作成したプールです。

v 「物理パス」は install_location¥cgi-bin です。

a. 「sso」を選択し、「ハンドラーマッピング」をダブルクリックします。

b. 右側の「操作」ペインで「モジュールマップの追加」をクリックします。

v 要求パスは cisapi です。

v モジュールは IsapiModule です。

v 実行可能ファイルは install_location¥cgi-bin¥cognosisapi.dll です。

v 名前は Cognos SSO です。

v 「要求の制限 (Request Restrictions)」をクリックして、「ハンドラーの起動 (Invoke Handler)」のチェック・マークが外されていることを確認します。

v 「OK」を 2 回クリックします。

v 「スクリプト・マップの編集」ダイアログで「はい」をクリックします。

v 「sso」を選択し、「モジュール」をダブルクリックします。リストにWebDAVModule が表示されている場合、その項目を削除します。

6. 要求を正しいハンドラーにマップする URL 書き換え規則を作成します。

a. 「ibmcognos」の下の「bi」ディレクトリーをクリックします。

b. 「URL 書き換え (URL Rewrite)」をダブルクリックします。

c. 「サーバー変数の表示 (View Server Variables)」をクリックして、CognosAnalytics の場所を示すサーバー変数を追加します。

v 「追加」をクリックします。

v 変数に HTTP_X_BI_PATH という名前を指定します。

v 「規則に戻る (Back to Rules)」をクリックします。


v 変数に HTTP_X_WEBCONTENTROOT という名前を指定します。




v 変数に HTTP_X_FORWARDED_HOST という名前を指定します。


d. 「ルールの追加」 > 「受信の規則」 > 「ブランク規則 (Blank Rule)」をクリックして、 Cognos Analytics の場所を ca-host コンピューターに渡す規則を追加します。

v 名前は Headers です。

v パターンは (.*) です

v アクション・タイプは「なし」です。

v 「サーバー変数」を展開し、

– 「追加」をクリックします。HTTP_X_BI_PATH を選択し、値を/ibmcognos/bi/v1 に設定します。

– 「追加」をクリックします。HTTP_X_FORWARDED_HOST を選択し、値を{HTTP_HOST} に設定します。

– 「追加」をクリックします。HTTP_X_WEBCONTENTROOT を選択し、値を/ibmcognos に設定します。

v 「後続の規則の処理を停止 (Stop processing of subsequent rules)」のチェック・マークをクリアします。

v 「適用」および「規則に戻る (Back to Rules)」をクリックします。

e. 前の手順で SSO アプリケーションを設定した場合は、ログインとレガシーUI サービス要求を SSO ハンドラーにマップする規則を追加します。

1) 「ルールの追加」 > 「受信の規則」 > 「ブランク規則 (BlankRule)」をクリックします。

v 名前は SSO Login です。

v パターンは v1/login$ です。

v アクション・タイプは「書き換え (Rewrite)」です。

v 書き換え URL は /ibmcognos/sso/cisapi/bi/v1/login です。

v 「後続の規則の処理を停止 (Stop processing of subsequentrules)」にチェック・マークを付けます。



v 名前は Legacy SSO です。

v パターンは (v1/disp(/.*)?) です。


v 書き換え URL は /ibmcognos/sso/cisapi/bi/{R:1} です。



f. Cognos Analytics REST サービス要求をバックエンド Cognos Analyticsサーバーにマップする規則を追加します。

1) 「ルールの追加」 > 「受信および送信の規則 (Inbound andOutbound Rules)」 > 「リバース・プロキシー」をクリックします。


v まだプロキシーが有効になっていない場合は、有効にするように求められます。「OK」をクリックします。

v サーバー名は ca-host:9300/bi です。

あるいは、サーバー・ファームを設定した場合は、http://ca_servers/bi です。

新しく作成した規則を選択し、「編集」をクリックします。

v パターンは、(^$)|(^v1(/.*)?)|(^[^/]+\.jsp) です。


v 書き換え URL は http://ca-host:9300/bi/{R:0} です。

あるいは、サーバー・ファームを設定した場合は、http://ca_servers/bi/{R:0} です。




v 名前は Event Studio です。

v パターンは ^(ags|cr1|prompting|ccl|common|skins|ps)/(.*) です。

v 「条件」セクションを開きます。

v 「論理グループ化 (Logical Grouping)」を「いずれかと一致 (MatchAny)」に変更します。


– 「条件入力 (Condition input)」は {HTTP_REFERER} です。

– 「文字列を入力する場合にチェック (Check if input string)」は「次のパターンと一致する」です。

– パターンは v1/disp です。

– 「大文字と小文字の区別を無視」にチェック・マークを付けます。




– パターンは (ags|cr1|prompting|ccl|common|skins|ps)/(.*)¥.css です。






– パターンは pat/rsapp.htm です。



v 書き換え URL は /ibmcognos/{R:0} です。



3) 「ルールの追加」 > 「受信の規則」 > 「空の規則」をクリックします。

v 名前は Report Viewer です。

v パターンは ^rv/(.*) です。


v 書き換え URL は /ibmcognos/{R:0} です。



7. 要求サイズの制限を調整します。

a. 以前に作成した ibmcognos アプリケーションの下の bi ディレクトリーを選択します。

b. 「フィルタリングの要求 (Request Filtering)」をダブルクリックします。

c. 右側のパネルで「機能設定の編集 (Edit Feature Settings)...」をクリックします。

v 「URL の最大長 (バイト数)(Maximum URL length (bytes))」を 8192に設定します。

v 「クエリ文字列の最大長 (バイト)」を 8192 に設定します。


d. 「フィルタリングの要求 (Request Filtering)」をダブルクリックします。

e. 「ヘッダー」タブを選択して、「ヘッダーを追加 (Add Header)」をクリックします。

f. 「ヘッダー・ボックス (Header Box)」で、ヘッダー・フィールド名をReferer として入力します。

g. 「サイズの上限」ボックスに、8192 と入力します。

h. 「OK」をクリックします。

i. 「サイズの上限」の 4096 を指定して、Cookie というヘッダー・フィールド名に対してもプロセスを繰り返します。

j. 「OK」をクリックします。

k. ibmcognos 仮想ディレクトリーをクリックします。

l. 「ホーム」ビューの「管理」セクションで、「構成エディター」をダブルクリックします。

m. 「セクション」ドロップダウン・リストで、「system.web」を展開して「httpRuntime」を選択します。


n. プロパティー「maxQueryStringLength」を 8192 に設定します。

o. 設定の変更を適用します。

8. CAM からのリカバリー可能な例外に使用されるカスタム 441 エラーのパススルーを許可するように IIS を設定します。設定しないと、IIS はこれらのエラーをブロックすることができ、ログオンしようとすると「無効なログオン応答(Invalid Logon Response)」エラーがお客様に対して表示されます。

a. ibmcognos 仮想ディレクトリーをクリックします。

b. 「ホーム」ビューの「管理」セクションで、「構成エディター」をダブルクリックします。

c. 「セクション」ドロップダウン・リストで、「system.webServer」を展開して「httpErrors」を選択します。

d. 「existingResponse」プロパティーを「パススルー」に設定します。

e. 設定の変更を適用します。

9. 前の手順で SSO アプリケーションを設定した場合は、「Windows 認証」を有効にします。

a. SSO アプリケーションを選択します。 Microsoft Edge ブラウザーの場合は、ibmcognos アプリケーションを選択します。

b. 「認証」をダブルクリックします。「匿名認証」を無効にし、「Windows認証」を有効にします。

http://iis-host/ibmcognos で Cognos Analytics が使用可能になっているはずです。

注: 複数レベルの仮想ディレクトリー・フォルダーを ibmcognos アプリケーションの上に構成した場合（例えば、デフォルトの Web サイト >MyVirtualDirectoryFolder > ibmcognos)、ステップ 6 で作成した URL 書き換え規則で /ibmcognos の代わりに /MyVirtualDirectoryFolder/ibmcognos を使用してください。

Cognos Analytics 11.0.3 での IIS の設定Microsoft インターネット・インフォメーション・サービス (IIS) バージョン 7 または 8 を使用している場合は、デフォルトの CGI ゲートウェイではなく ISAPIゲートウェイを使用するよう IBM Cognos を設定します。これは、シングル・サインオンを実装する場合に必要です。

注: このトピックは、バージョンからで役立ちます。バージョンでのよりシンプルな手法については、 129 ページの『Cognos Analytics

11.0.4 以降のバージョンでの IIS の設定』を参照してください。

始める前に

Cognos Analytics のオプションのゲートウェイ・コンポーネントを既にインストールしている必要があります。



Web サーバーとして Microsoft IIS を使用し、複数の IBM Cognos Analytics 製品または同じ製品の複数のインスタンスを 1 台のコンピューターで実行する場合は、以下の一連の手順を実行する必要があります。

1. IIS Application Request Routing (ARR) 拡張機能をインストールします。

2. IIS アプリケーション・プールを設定します。

3. IIS 仮想ディレクトリーとアプリケーションを設定します。

4. ISAPI を設定します。

5. リバース・プロキシーを設定します。

重要: 32 ビット・バージョンの ISAPI ゲートウェイを使用している場合、IBMCognos ゲートウェイに使用されるアプリケーション・プールで 32 ビット・アプリケーションを使用可能にする必要があります。Internet Information Services (IIS)Manager で、IBM Cognos に使用されるアプリケーション・プールを選択して、「詳細設定」をクリックします。「32 ビット・アプリケーションを使用可能にする(Enable 32-Bit Applications)」の値を「有効」に変更します。

手順1. IIS Application Request Routing 拡張機能をインストールします。

a. URL (http://www.iis.net/downloads/microsoft/application-request-routing) にアクセスし、IIS 用の Application Request Routing 拡張機能をインストールします。

b. Microsoft の Web ページが表示されたら、緑色の「新しい拡張機能のインストール」ボタンをクリックします。手順に従って、ARR 拡張機能をダウンロードし、実行します。

c. ARR 拡張機能が正常にインストールされたことを確認するには、Windowsの「スタート」>「管理ツール」メニューから IIS マネージャーを起動します。IIS マネージャーが起動したら、画面上部左側にあるサーバー名をクリックして、使用可能な機能を表示します。中央にある IIS ペイン内に、「URL 書き換え (URL Rewrite)」機能が表示されているはずです。それはARR がインストールされた際にインストールされました。

2. IIS アプリケーション・プールを設定します。

a. 「スタート」>「管理ツール」>「インターネットインフォメーションサービス (IIS) マネージャー」をクリックして、インターネット・インフォメーション・サービス・マネージャーを開きます。

b. 開始ページの下にある <サーバー名> を展開し、「アプリケーションプール」をクリックします。

c. 「操作」ウィンドウから「アプリケーションプールの追加...」をクリックします。

d. 「新しいアプリケーションプールの追加」ダイアログで必要な詳細を入力します。「名前」フィールドには、「新規アプリケーション・プール用のIBM Cognos Analytics」のような名前を指定します。「.Net Frameworkバージョン」および「マネージパイプラインモード」フィールドはデフォルトのままにします。「OK」をクリックして、アプリケーション・プールを作成します。




3. IIS 仮想ディレクトリーとアプリケーションを設定します。

IIS は、仮想ディレクトリー・ツリーを公開することによって、そのコンテンツをクライアントに提供します。この仮想ディレクトリーは、Web サーバーのホスト名またはアドレスの直後にある URL で使用されるパス (または別名) 要素を判別します。この例では、別名は ibmcognos になります。cgi-bin の IIS アプリケーションは、IBM Cognos Analytics ゲートウェイ・モジュールを以前に作成したアプリケーション・プールにマッピングします。

a. IIS マネージャーの左側にあるエクスプローラー・ウィンドウで、「サイト」および「既定の Web サイト」を展開します。

b. 「既定の Web サイト」を右クリックして、「仮想ディレクトリの追加」を選択します。

c. 「仮想ディレクトリの追加」ダイアログで必要な詳細を入力し、「OK」をクリックします。

「別名」フィールドに、ibmcognosのような仮想ディレクトリーの名前を指定します。このトピックの後続の部分では、ibmcognos が仮想ディレクトリー名として使用されます。

「物理パス」フィールドに、IBM Cognos Analytics ゲートウェイ・インストール内の webcontent サブディレクトリーの場所を指定します。必要な場合は、ディレクトリーを参照します。

d. IIS マネージャーの左側にあるエクスプローラー・ウィンドウで、少し前に作成した仮想ディレクトリーを見つけます。

e. 仮想ディレクトリーを右クリックし、「アプリケーションの追加...」を選択します。

f. 「アプリケーションの追加」ダイアログで必要な詳細を入力し、「OK」をクリックします。

v 「別名」フィールドに、cgi-bin の値を指定します。

v 「物理パス」フィールドに、IBM Cognos Analytics ゲートウェイ・インストール内の cgi-bin サブディレクトリーの場所を指定します。必要な場合は、ディレクトリーを参照します。

v 「アプリケーションプール」フィールドで、手順 3 で作成したアプリケーション・プールを選択し、「選択...」ボタンをクリックして IIS アプリケーション・プールを設定します。

4. ISAPI を設定します。

IBM Cognos Analytics は、IIS で使用されるゲートウェイ・モジュールの 2つの実装を提供します。すなわち、Internet Server Application ProgrammingInterface と Common Gateway Interface (CGI) です。 CGI よりも優れたパフォーマンスとリソース割り振りを実現できるため、IIS で ISAPI を使用することがベスト・プラクティスとみなされています。そのため、このセクションでは、ISAPI モジュールのセットアップについてのみ説明します。

ISAPI モジュールを機能させるために、2 つの手順を実行します。まず、モジュール・マッピングを設定する必要があります。これは、cognosisapi.dll を実


行可能ファイルに呼び出す要求を経路指定します。2 つ目に、IIS が拡張機能の実行をブロックしないように、そのモジュールを許可された拡張機能として追加する必要があります。

a. IIS マネージャーの左側のウィンドウで、「既定の Web サイト¥ibmcognos」ツリーから cgi-bin アプリケーションを選択し、中央のウィンドウの下方にあるバーから「機能ビュー」を選択します。

b. 中央のウィンドウにある「ハンドラーマッピング」をダブルクリックします。この操作により、このアプリケーションのハンドラー・マッピングのリストが表示されます。

c. 「操作」ウィンドウの右上で、「モジュールマップの追加...」をクリックして ISAPI マッピングを追加します。

d. 「モジュールマップの追加」ダイアログに必要な詳細を入力し、「OK」をクリックします。

v 「要求パス」フィールドに、値 cognosisapi.dll を指定します。この値は必須の値で、他の値を指定することはできません。

v 「モジュール」フィールドで、ドロップダウン・リストから「IsapiModule」を選択します。

v 「実行可能ファイル (オプション)」フィールドで、IBM CognosGateway インストール内の cognosisapi.dll へのパスを指定します。このファイルはインストールの場所/cgi-bin に位置します。インストールの場所は IBM Cognos BI インストール・ディレクトリーを参照します。この例では、ディレクトリーはD:¥Apps¥IBM¥Cognos¥Analytics¥cgi-bin になります。

v 「名前」フィールドに、このモジュールの名前を指定します。例:IBMCOGNOS-ISAPI

e. この新しい ISAPI 拡張機能を許可することを確認するダイアログが表示されたら、「はい」をクリックします。

「ハンドラーマッピング」画面に戻ると、新たに追加されたハンドラーが「有効」セクションの下に表示されます。この例では、ハンドラー名はIBMCOGNOS-ISAPI です。


この手順では、リバース・プロキシーをセットアップして、IIS によるゲートウェイ要求の書き換え、およびそれらのアプリケーション層への受け渡しを許可するために必要となる手順が示されます。これらの手順では、IBM CognosAnalytics ゲートウェイが Server1_Gateway にインストールされ、IBM CognosAnalytics アプリケーションが Server2_Application にインストールされた、2つのサーバーを使用するアーキテクチャーを想定しています。

a. Server1_Gateway サーバーで、IIS マネージャーを起動し、以前にセットアップした ibmcognos 仮想ディレクトリー内の「bi」フォルダーを選択します。

b. 機能ビューで、「URL 書き換え (URL Rewrite)」機能を開始します。

c. 「操作」ウィンドウで、「規則の追加」をクリックして、「リバースプロキシ (Reverse Proxy)」を選択します。「OK」をクリックします。


d. 「リバースプロキシ規則の追加 (Add Reverse Proxy Rule)」ダイアログ・ボックスの「受信の規則」セクション内で、「サーバー名または IP アドレスの入力... (Enter the server name or the IP address...)」フィールドに次の形式で入力します。 <Server2_Application:Port>/bi。例:Server2_Application:9300/bi

e. 「SSL のオフロードを有効にする (Enable SSL Offloading)」チェック・ボックスがチェックされていることを確認し、「OK」をクリックします。

f. 「規則」ページの「操作」ウィンドウで、「サーバー変数の表示 (ViewServer Variables)」をクリックします。

g. 「追加」をクリックし、Server1_Gateway に HTTP_X_BI_PATH という名前の変数を追加します。完了したら、「OK」をクリックして、変数を作成します。

h. 「操作」ウィンドウ内で、「規則に戻る (Back to Rules)」をクリックします。

i. 以前に作成した規則を選択し、右側にある「受信の規則」ウィンドウで、「編集...」をクリックします。

j. 「サーバー変数」セクションを展開します。

k. 「サーバー変数」セクション内で、「追加」ボタンをクリックします。

l. 「サーバー変数の設定 (Set Server Variable)」ダイアログで、HTTP_X_BI_PATH サーバー変数を選択し、「値」フィールドを/ibmcognos/bi/v1 に設定します。

m. 「既存の値を置き換える (Replace existing value)」チェック・ボックスがチェックされていることを確認します。

n. 「OK」をクリックして保存し、「操作」ウィンドウで「適用」をクリックします。

o. 右上にある「操作」ウィンドウで、「規則に戻る (Back to Rules)」をクリックして規則の定義を終了します。

p. ブラウザーを使用して次の URL パターンを入力することによって、設定をテストします。http(s)://<Web サーバー>:<Web サーバーのポート>/<別名>/bi/。この例では、URL は http://Server1_Gateway:80/ibmcognos/bi/になります。

タスクの結果

IBM Cognos Analytics ゲートウェイに直接アクセスする

ここでは、IBM Cognos Analytics 認証プロバイダーのシングル・サインオンが設定されていること、次のパターンの ISAP ゲートウェイへの完全な URL を使用して IBM Cognos Analytics 環境にアクセスすることによってシングル・サインオンを呼び出せることを想定しています。HTTP(S)://<Web サーバー>:<Web サーバーのポート>/<別名>/cgibin/cognosisapi.dll?b_action=xts.run&m=portal/main.xts

&m_redirect=/<alias>/bi/

URL を正しく解決するには、ゲートウェイ・エントリーのディスパッチャー URIが Server2_Application server を指すように設定するなど、Server1_Gateway サーバー上の IBM Cognos Configuration を設定する必要があります。


URL パターンとして HTTP(S)://<Web サーバー>:<Web サーバー・ポート>/<別名>/cgibin/cognosisapi.dll?b_action=xts.run&m=portal/main.xts&m_redirect=/

<alias>/bi/を入力して、完全な URL をテストします。

この例では、URL は http://Server1_Gateway:80/ibmcognos/cgibin/cognosisapi.dll?b_action=xts.run&m=portal/main.xts&m_redirect=/IBMCognos/

bi/ になります。

IIS バージョン 7 または 8 での CGI ゲートウェイの設定Microsoft インターネット・インフォメーション・サービス (IIS) バージョン 7 以降を使用している場合は、CGI ゲートウェイを設定します。これは、シングル・サインオンで必要になります。

CGI ゲートウェイは、32 ビットおよび 64 ビットの Web サーバーで使用可能です。


Web サーバーとして Microsoft IIS を使用し、複数の IBM Cognos Analytics 製品または同じ製品の複数のインスタンスを 1 台のコンピューターで実行する場合は、製品またはインスタンスごとに専用のアプリケーション・プールを作成し、各製品または各インスタンスの別名をそれぞれのアプリケーション・プールに関連付ける必要があります。

アプリケーション・プールの作成についての詳細は、Web サーバーの資料を参照してください。

手順1. Microsoft Windows の「コントロールパネル」で、「プログラム」 > 「プ

ログラムと機能」をクリックします。

Microsoft Windows 8 または 2012 Server を使用する場合は、「プログラムと機能」を「コントロールパネル」から直接使用できます。

2. 「Windows の機能の有効化または無効化」をクリックします。


a. 「サーバーマネージャ」 > 「役割」 > 「Web サーバー (IIS)」をクリックします。

b. 「HTTP 共通機能」または必要な機能が有効になっていることを確認します。

c. 「CGI」が「インストールされていません」に設定されている場合は、「CGI」を選択して、「役割サービスの追加」を選択します。


a. 役割と機能の追加ウィザードで、「役割ベースまたは機能ベースのインストール」をクリックし、「次へ」をクリックします。

b. サーバーを選択し、「次へ」をクリックします。


c. 「Web サーバー (IIS)」を選択します。まだインストールされていない場合は、「HTTP 共通機能」が選択されていることを確認し、ウィザードの「役割サービス」セクションが表示されるまで「次へ」をクリックします。

d. 「アプリケーション開発」を展開します。

e. 「CGI」を選択し (まだ選択されていない場合)、「次へ」をクリックします。

f. 「インストール」をクリックします。

5. Microsoft Windows 7 または 8 を使用している場合は、次の手順を使用します。

a. 「インターネットインフォメーションサービス」がまだ選択されていない場合はそれを選択します。

b. 「インターネットインフォメーションサービス」 > 「World WideWeb サービス」を展開します。

c. 「HTTP 共通機能」または必要な機能が有効になっていることを確認します。

d. 「アプリケーション開発機能」を展開します。

e. 「CGI」が選択されていない場合は、「CGI」を選択します。

f. 「OK」をクリックします。

6. 「インターネットインフォメーションサービス (IIS) マネージャー」コンソールの「接続」の下で、ご使用のサーバー名を選択します。

v Microsoft Windows 2012 Server を使用している場合は、「サーバーマネージャー」で「IIS」を選択し、サーバー名を右クリックして「インターネットインフォメーションサービス (IIS) マネージャー」をクリックします。

v Microsoft Windows 2008 Server を使用している場合は、「サーバーマネージャー」で「役割」 > 「Web サーバー (IIS)」を展開し、「インターネットインフォメーションサービス (IIS) マネージャー」をクリックします。

v Microsoft Windows 8 を使用している場合は、「コントロールパネル」から「管理ツール」をクリックして、「インターネットインフォメーションサービス (IIS) マネージャー」コンソールにアクセスします。

v Microsoft Windows 7 を使用している場合は、「スタート」>「コントロールパネル」から「システムとセキュリティ」 > 「管理ツール」をクリックして、「インターネットインフォメーションサービス (IIS) マネージャー」コンソールにアクセスします。

7. 「ISAPI および CGI の制限」をダブルクリックします。

8. 「操作」で、「追加」をクリックします。

9. cognos.cgi ファイルへのパスを入力します。このファイルは <インストールの場所>¥cgi-bin ディレクトリーにあります。

ファイル名を含む絶対パスを入力する必要があります。パスに空白文字が含まれている場合は、パスを引用符で囲んでください。例えば、次のように入力します。


『C:\Program Files\ibm\cognos\analytics\cgi-bin\cognos.cgi』

10. 「説明」に、CognosCGI のように入力します。

11. 「拡張パスの実行を許可する」を選択して、「OK」をクリックします。

12. 「接続」の下で「サイト」を展開し、ご使用の Web サイトの下で、表に示すように仮想ディレクトリーを追加します。

表 17. 必須の仮想ディレクトリー

別名場所

ibmcognos install_location/webcontent

ibmcognos/cgi-bin install_location/cgi-bin

重要: bi は、IBM Cognos Configuration の「ゲートウェイ URI」および「ゲートウェイ用 Controller URI」の値で使用されるデフォルト値です。Alias 値に bi を使用しない場合は、「ゲートウェイ URI」および「ゲートウェイ用 Controller URI」の値を使用する値に合わせて変更してください。

13. 作成した cgi-bin 仮想ディレクトリーを選択します。

14. 「ハンドラーマッピング」をダブルクリックします。

15. 「操作」で、「モジュールマップの追加」をクリックします。

a. 「要求パス」で、cognos.cgi と入力します。

b. 「モジュール」で、CgiModule を選択します。

c. 「実行可能ファイル (オプション)」は空白のままにします。

d. 「名前」で、CognosCGI など、エントリーの名前を入力します。

e. 「OK」をクリックします。


この手順では、リバース・プロキシーをセットアップして、IIS によるゲートウェイ要求の書き換え、およびそれらのアプリケーション層への受け渡しを許可するために必要となる手順が示されます。これらの手順では、IBM CognosAnalytics ゲートウェイが Server1_Gateway にインストールされ、IBMCognos Analytics アプリケーションが Server2_Application にインストールされている 2 つのサーバー・アーキテクチャーを想定しています。

a. Server1_Gateway サーバーで、IIS マネージャーを起動し、以前にセットアップした ibmcognos 仮想ディレクトリー内の「bi」フォルダーを選択します。

b. 機能ビューで、「URL 書き換え (URL Rewrite)」機能を開始します。

c. 「操作」ウィンドウで、「規則の追加」をクリックして、「リバースプロキシ (Reverse Proxy)」を選択します。「OK」をクリックします。

d. 「リバースプロキシ規則の追加 (Add Reverse Proxy Rule)」ダイアログ・ボックスの「受信の規則」セクション内で、「サーバー名または IPアドレスの入力... (Enter the server name or the IP address...)」フィールドに次の形式で入力します。 <Server2_Application:Port>/bi。例:Server2_Application:9300/bi

e. 「SSL のオフロードを有効にする (Enable SSL Offloading)」チェック・ボックスがチェックされていることを確認し、「OK」をクリックします。


f. 「規則」ページの「操作」ウィンドウで、「サーバー変数の表示 (ViewServer Variables)」をクリックします。

g. 「追加」をクリックし、HTTP_X_BI_PATH という名前の変数を追加します。完了したら、「OK」をクリックして、変数を作成します。

h. 「操作」ウィンドウ内で、「規則に戻る (Back to Rules)」をクリックします。

i. 以前に作成した規則を選択し、右側にある「受信の規則」ウィンドウで、「編集...」をクリックします。

j. 「サーバー変数」セクションを展開します。

k. 「サーバー変数」セクション内で、「追加」ボタンをクリックします。

l. 「サーバー変数の設定 (Set Server Variable)」ダイアログで、HTTP_X_BI_PATH サーバー変数を選択し、「値」フィールドを/ibmcognos/bi/v1 に設定します。

m. 「既存の値を置き換える (Replace existing value)」チェック・ボックスがチェックされていることを確認します。

n. 「OK」をクリックして保存し、「操作」ウィンドウで「適用」をクリックします。

o. 右上にある「操作」ウィンドウで、「規則に戻る (Back to Rules)」をクリックして規則の定義を終了します。

p. ブラウザーを使用して次の URL パターンを入力することによって、設定をテストします。http(s)://<Web サーバー>:<Web サーバーのポート>/<別名>/bi/。この例では、URL は http://Server1_Gateway:80/ibmcognos/bi/ になります。

タスクの結果

ユーザーは、Web ブラウザーで http://サーバー名/ibmcognos/bi/ と入力すると、CGI ゲートウェイにアクセスできます。

ゲートウェイのテストWeb ブラウザーを使用してインストールをテストできます。

手順1. Web サーバーが動作していることを確認します。

2. Web ブラウザーを開きます。

3. アドレス・フィールドに、IBM Cognos Configuration に設定されている「ゲートウェイ URI」を入力します。例えば、次のようになります。

http://host_name:port/ibmcognos

IBM Cognos Analytics ポータルの「ようこそ」ページが表示されます。



第 6 章オプションのモデル作成コンポーネントのインストールと設定

IBM Cognos Analytics サーバー・コンポーネントをインストールして設定した後、レポート作成用のモデル作成コンポーネントである IBM Cognos FrameworkManager と、PowerCubes 作成用のモデル作成ツールである IBM CognosTransformer をインストールして構成することができます。

Framework Manager と Transformer は、Cognos Analytics とは異なる場所にインストールしてください。

IBM Cognos Framework ManagerIBM Cognos Framework Manager は、IBM Cognos Analytics 用のメタデータ・モデル作成ツールです。

他の IBM Cognos Analytics コンポーネントと同じコンピューターにこれをインストールすることも、別のコンピューター上にインストールすることもできます。

Framework Manager の以前のバージョンからアップグレードした場合は、以前のバージョンで使用していたモデルとプロジェクトを使用できます。既存のプロジェクトをアップグレードするには、新しいバージョンの Framework Manager でプロジェクトを開く必要があります。

Framework Manager を以前のバージョンからアップグレードする場合は、最初に以前のバージョンをアンインストールする必要があります。詳細については、 337ページの『第 12 章 IBM Cognos Analytics のアンインストール』を参照してください。

Framework Manager をインストールする前に、現在実行中のプログラムがあればすべて終了します。これは、インストール・プログラムによってすべての必要なファイルをコンピューターに確実にコピーするためです。

また、インストールする Windows コンピューターの管理者権限が必要になります。管理者以外のユーザーがインストールする場合は、システム管理者に、そのユーザーのアカウントをコンピューターの管理者グループに追加するように依頼してください。Framework Manager の実行に使用するアカウントにも管理者権限が必要になります。

Framework Manager をインストールする前に、IBM Cognos Analytics のサーバー・コンポーネントをすべてインストールし、設定します。

パス名に ASCII 文字のみが含まれるディレクトリーにインストールします。一部のサーバーでは、ディレクトリー名に ASCII 以外の文字は使用できません。パス名にアポストロフィが含まれるディレクトリーに Framework Manager をインストールすると、ヘルプが適切に開かなくなる可能性があります。

145

さまざまなバージョンのメタデータを管理し、共有し、保護するため、外部ソース管理システムを使用するように Framework Manager を設定できます。詳細については、「IBM Cognos Framework Manager ユーザー・ガイド」の外部リポジトリー・コントロールの使用に関するセクションを参照してください。

IBM Cognos Framework Manager のシステム要件IBM Cognos Framework Manager をインストールする前に、Windows コンピューターが IBM Cognos Analytics のソフトウェア要件とハードウェア要件を満たしていることを確認します。モデルのサイズによって、ディスク領域などのハードウェア要件が決まります。

次の表は、Framework Manager の実行に必要なソフトウェアとハードウェアの最小限の要件です。

表 18. Framework Manager のシステム要件

要件仕様

オペレーティング・システム Windows

RAM 最小:512 MB

推奨:1 GB

ディスク容量最小: IBM Cognos Analytics で使われる一時ディレクトリーを含むドライブの空き容量 500 MB

データベース互換クエリー・モードを使用する場合、FrameworkManager と同じコンピューター上にデータベース・クライアント・ソフトウェアをインストールする必要があります。

データベース接続の設定

その他製品サンプルで使用するための Microsoft Data AccessComponent (MDAC)2.6 以降

さまざまなバージョンのメタデータを管理し、共有し、保護するため、外部ソース管理システムを使用するように Framework Manager を設定できます。詳細については、「Framework Manager ユーザー・ガイド」の外部リポジトリー・コントロールの使用に関するセクションを参照してください。

IBM Cognos Framework Manager のインストールIBM Cognos Analytics を完全にインストールするには、Cognos FrameworkManager を Windows コンピューターにインストールする必要があります。

インストール場所は、IBM Cognos Analytics のインストール場所とは異なっていなければなりません。

手順1. インストール・ファイルをダウンロードして解凍した場所に移動し、

ca_model_<platform>_<build>.exe ファイルをダブルクリックします。




3. インストール・ウィザードの指示に従って、必要なファイルをコンピューターにコピーします。

4. インストール・ディレクトリーを無許可アクセスから保護します。

次のタスク

設定にはデフォルト設定が使用されます。これらのデフォルト設定を、環境により適した設定にするために、インストール中や後で変更することができます。

IBM Cognos Framework Manager の設定IBM Cognos Framework Manager は、IBM Cognos Analytics およびそのコンポーネントと通信するように設定する必要があります。

始める前に

Framework Manager を設定する前に、IBM Cognos Analytics をインストールして設定しておきます。最初に少なくとも 1 台の Content Manager コンピューターに Content Manager をインストールして設定し、「IBM Cognos」サービスを開始する必要があります。これにより、認証局 Service から Framework Manager コンピューターに対して証明書が発行されます。

Framework Manager プロジェクト内で使用するように計画しているデータ・ソースを設定する必要もあります。


IBM Cognos Analytics と同じコンピューター (ディレクトリーは異なる) にFramework Manager をインストールする場合、次の条件に該当すれば、設定を行う必要はありません。

v Web サーバーが、デフォルトの仮想ディレクトリーを使用するように設定されている。

v デフォルトのポート、リソース、暗号設定を使用する。

Framework Manager が、アプリケーション層コンポーネントを保護するネットワーク・ファイアウォールの外側にインストールされていると、ディスパッチャーとの間で通信の問題が発生する可能性があります。このような問題を回避するには、Framework Manager をアプリケーション層コンポーネントと共にインストールするか、Framework Manager とディスパッチャーの間の通信専用のゲートウェイをインストールして設定することができます。詳細については、 148 ページの『ネットワーク・ファイアウォールの内側にある Framework Manager の設定』か、149 ページの『ネットワーク・ファイアウォールの外側にある FrameworkManager の設定』を参照してください。

第 6 章オプションのモデル作成コンポーネントのインストールと設定 147

手順1. Framework Manager がインストールされているコンピューターで、IBM

Cognos Configuration を起動します。

2. 「エクスプローラー」ペインで、「環境」をクリックします。

3. 以下の設定について、適切な値を指定します。

ゲートウェイ URIデフォルト: http://ca_server:port/bi/v1/disp

例: http://my_ca_server:9300/bi/v1/disp

この URI は、常に Cognos Analytics とものと同じでなければなりません。

URI に localhost が含まれている場合は、localhost を完全修飾ホスト名または IP アドレスに置き換える必要があります。

外部アプリケーション用ディスパッチャー URIデフォルト: http://ca_server:port/p2pd/servlet/dispatch

例: http://my_ca_server:9300/p2pd/servlet/dispatch



タスクの結果

Framework Manager が IBM Cognos Analytics と通信するように設定されました。

ネットワーク・ファイアウォールの内側にある Framework Managerの設定Framework Manager がネットワーク・ファイアウォールの内側にインストールされている場合、次の手順に従って、Framework Manager と IBM CognosAnalytics コンポーネントの間の通信を設定します。

手順

1. Framework Manager がインストールされているコンピューターで、IBMCognos Configuration を起動します。


3. 「プロパティー」ウィンドウで、「ゲートウェイ URI」に適切な値を入力します。 HTTPS または HTTP プロトコルを使用して、SSL 通信または非 SMS 通信を選択します。

4. 「ゲートウェイ URI」のホスト名の部分を、"localhost"からゲートウェイ・コンポーネントがインストールされているコンピューターの IP アドレスまたはホスト名に変更します。

5. アプリケーション層コンポーネントがインストールされているサーバーの URIを入力して、「外部アプリケーション用ディスパッチャー URI」の値を指定します。


この値は、アプリケーション層コンポーネントがインストールされているコンピューターでの「内部ディスパッチャー URI」プロパティーと同じです。

6. 「エクスプローラー」ウィンドウの「暗号化」で、デフォルトの暗号化プロバイダーである「Cognos」をクリックします。

7. 「認証局設定」プロパティー・グループの「パスワード」プロパティーに、デフォルトのアクティブな Content Manager コンピューターに設定したパスワードを入力します。


ネットワーク・ファイアウォールの外側にある Framework Managerの設定Framework Manager がネットワーク・ファイアウォールの外側にインストールされている場合、ディスパッチャーとの通信専用のゲートウェイをインストールして設定できます。

手順

1. Framework Manager の専用ゲートウェイを設定します。

2. ゲートウェイ・コンピューターで IBM Cognos Configuration を開き、「ゲートウェイ用ディスパッチャー URI」プロパティーを、アプリケーション層コンポーネントのコンピューターで「内部ディスパッチャー URI」に指定されている URI に変更します。

3. Framework Manager コンピューターで IBM Cognos Configuration を開始します。


5. 「プロパティー」ウィンドウにある「ゲートウェイ URI」に、専用ゲートウェイとして使用するサーバーに該当する値を入力します。

v ISAPI ゲートウェイ用に Web サーバーが設定されている場合、cognos.cgi

を cognosisapi.dll で置き換えます。

v Web サーバーが Apache モジュールを使用するよう設定されている場合、次の構文を使用します。

http://host_name:port/ibmcognos/cgi-bin/module_alias

6. 「ゲートウェイ URI」の"localhost"の部分を、専用ゲートウェイ・サーバーのIP アドレスまたはホスト名に変更します。

7. 「外部アプリケーション用ディスパッチャー URI」に、アプリケーション層コンポーネントがインストールされているサーバーで「内部ディスパッチャーURI」に指定されている URI を入力します。

8. 「エクスプローラー」ウィンドウの「暗号化」で、デフォルトの暗号化プロバイダーである「Cognos」をクリックします。

9. 「認証局設定」プロパティー・グループの「パスワード」プロパティーに、デフォルトのアクティブな Content Manager コンピューターに設定したパスワードを入力します。



タスクの結果

Framework Manager が IBM Cognos Analytics やそのコンポーネントと通信するように設定されました。

Framework Manager のデータ・ソース接続の変数の設定IBM Cognos Analytics モデル作成ツールでは、メタデータの作成と管理を行います。Framework Manager では、レポート作成機能に使用するメタデータの作成と管理が行われます。メタデータはマルチプラットフォーム環境またはマルチリンガル環境のデータ・ソースから派生するので、Framework Manager 用のデータ・ソース環境をセットアップする際には考慮すべき、または実行すべき事柄が幾つかあります。通常、検討や作業が必要となる事項は、データ・ソースまたはインポート・ソースに使用する技術によって異なります。

古いバージョンの Framework Manager からアップグレードする場合、データ・ソース環境に何かをセットアップする必要はありません。データ・ソース環境をセットアップする必要があるのは、古いバージョンとは異なる場所に FrameworkManager をインストールした場合のみです。

他の言語を使用するユーザーが同じ IBM Cognos Analytics インスタンスからMSAS 2005 データ・ソースに接続することはできません。モデル作成者は各言語用にパッケージを別個に作成する必要があります。ユーザーは任意の言語のレポートを実行できます。

データ・ソース接続の詳細については、IBM Cognos 「管理およびセキュリティー・ガイド」を参照してください。

使用する文字セットと通貨記号をサポートする適切なフォントがインストールされていることを確認してください。日本と韓国の通貨記号を正しく表示するには、Supplementary Language Documentation ディスクから追加のフォントをインストールする必要があります。

Framework Manager がインストールされている場所で次の手順を実行します。

手順1. 多言語サポートのための環境変数を設定します。

v Oracle の場合は、Framework Manager および IBM Cognos Analytics サーバーがインストールされている各コンピューターで、次のコマンドを入力して NLS_LANG (National Language Support) 環境変数を設定します。

NLS_LANG = language_territory.character_set


NLS_LANG = AMERICAN_AMERICA.UTF8

NLS_LANG = JAPANESE_JAPAN.UTF8


この変数の値によって、ロケールに基づいた IBM Cognos Analytics の動作が決まります。エラー・メッセージ、ソートの順序、日付、時刻、通貨、数字、カレンダーの規則には、ネイティブの言語とロケールが自動的に適用されます。

v IBM Db2 の場合は、環境変数 DB2CODEPAGE の値を 1252 に設定します。

このオプション環境変数を使用するかどうかについて詳しくは、Db2 のドキュメントを参照してください。

SAP BW に必要な設定はありません。SAP では、Unicode 以外の SAP BWシステムで単一のコード・ページしかサポートしていません。

2. Oracle の場合、$ORACLE_HOME/lib を LD_LIBRARY_PATH 変数に追加します。

ロード・ライブラリーのパスを設定するときは、32 ビット Oracle ライブラリーがライブラリー検索パス内にあることを確認します。ライブラリー検索パスは通常、$ORACLE_HOME/lib ディレクトリーであり、64 ビット Oracle クライアントをインストールした場合は $ORACLE_HOME/lib32 ディレクトリーです。

3. SAP BW の場合、モデル作成ツールでメタデータを取得できるように次の承認オブジェクトを設定します。

デフォルト値を指定した箇所は、SAP システム側で値を変更することも可能です。

v S_RFC

「アクティビティー」フィールドを 16 に設定します。

「Name of RFC to be protected」フィールドを SYST, RSOB, SUGU, RFC1,RS_UNIFICATION, RSAB, SDTX, SU_USER に設定します。

保護対象にするオブジェクトの「Type of RFC」フィールドを FUGR に設定します。

v S_TABU_DIS


「Authorization Group」フィールドを &NC& に設定します。

注: &NC& は、許可グループがない表を表します。セキュリティーを高めるため、許可グループを作成して、表 RSHIEDIR をそれに割り当ててください。この新しい許可グループを使用することにより、ユーザーのアクセスが、モデリング・ツールで必要な表のみに制限されます。許可グループは、SAP システムでカスタマイズすることによって作成します。

v S_USER_GRP

「アクティビティー」フィールドを 03, 05 に設定します。

「User group in user master main」フィールドをデフォルト値に設定します。

v S_RS_COMP


「アクティビティー」フィールドをデフォルト値に設定します。

「Info Area」フィールドを InfoArea テクニカル名に設定します。

「Info Cube」フィールドを InfoCube テクニカル名の値に設定します。

「Name (ID) of reporting components」フィールドをデフォルト値に設定します。

「Type of reporting components」フィールドをデフォルト値に設定します。

v S_RS_COMP1




「Owner (Person Responsible)」フィールドをデフォルト値に設定します。

v S_RS_HIER


「階層名」フィールドを階層名に設定します。

「InfoObject」フィールドをInfoObject テクニカル名に設定します。

「Version」フィールドを階層のバージョンに設定します。

v S_RS_ICUBE


「InfoCube sub-object」フィールドを値 DATA と DEFINITION に設定します。


「InfoCube」フィールドを InfoCube テクニカル名に設定します。

SAP BW 承認オブジェクトの詳細については、Transaction SU03 を参照してください。

Framework Manager のインストールのテストアプリケーションを起動してプロジェクトを作成することにより、設定をテストできます。


手順

Framework Manager を起動するには、「スタート」メニューから、「すべてのプログラム」 > 「IBM Cognos Framework Manager」 > をクリックします。Microsoft Windows 8 または Windows 2012 Server では、「スタート」パネルの「Framework Manager」アイコンをダブルクリックします。現在サポートされているバージョンよりもモデル・スキーマのバージョンが古い場合、アップグレードを求めるメッセージが表示されます。Framework Manager の「ようこそ」ページが表示されれば、インストールは正常に機能しています。

IBM Cognos TransformerIBM Cognos Transformer は、IBM Cognos 製品で使用する PowerCubes を作成するためのメタデータ・モデル作成ツールです。

モデルの設計や個人用の PowerCube の作成を行う必要があるビジネス・スペシャリストが、より簡単に Transformer を入手できるようになりました。例えば、IT部門では、企業ポータルやセキュリティー保護されたポータルから、ダウンロード可能な Web ベースのインストール・プログラムをビジネス・スペシャリストやTransformer モデル作成者に対して提供し、インストール・ファイルを手軽に配布できます。

Transformer は、以下のコンポーネントで構成されます。

v PowerCube を構築するための UNIX および Linux オペレーティング・システム・ユーティリティー

v IBM Cognos Transformer クライアント

このコンポーネントは、Windows コンピューターにインストールする必要があります。

両方のコンポーネントとも、IBM Cognos Analytics とは異なる場所にインストールする必要があります。

設定にはデフォルト設定が使用されます。これらのデフォルト設定は、必要に応じて変更できます。ただし、これらの設定は、IBM Cognos Analytics に対する設定と同じでなければなりません。

IBM Cognos Transformer のシステム要件IBM Cognos Transformer をインストールする前に、コンピューターがソフトウェア要件とハードウェア要件を満たしていることを確認します。 PowerCube のサイズによって、ディスク領域などのハードウェア要件が決まります。

次の表に、IBM Cognos Transformer の実行に必要なソフトウェアとハードウェアの最小限の要件を示します。


表 19. Transformer のシステム要件

要件仕様

オペレーティング・システム Windows

UNIX: Oracle Solaris、IBM AIX

Linux

RAM 最小:512 MB

推奨: 4 GB

ディスク容量最小: 一時ディレクトリー用のドライブに空き容量 500 MB

データ・ソース IBM Cognos Transformer と同じコンピューターにインストールされたデータベース・クライアント・ソフトウェア

データベース接続の設定

その他製品サンプルで使用するための MicrosoftData Access Component (MDAC)2.6 以降

IBM Cognos Transformer のインストールIBM Cognos 製品で使用する PowerCubes を作成する予定の場合は、IBM CognosTransformer をインストールします。

Transformer のインストール場所は、IBM Cognos Analytics のインストール場所と異なる場所でなければなりません。

Transformer をインストールする前に、Cognos Analytics サーバー・コンポーネントをインストールして設定する必要があります。

インストール・ウィザードで選択した言語によって、そのインストール・ウィザードと IBM Cognos Transformer のユーザー・インターフェースの言語が決まります。使用可能な言語はすべてインストールされます。

UNIX または Linux オペレーティング・システムの場合は、Microsoft Windowsオペレーティング・システムのコンピューターに IBM Cognos Transformer をインストールしない限り、IBM Cognos Transformer のインストールが完了しません。すべてのコンポーネントを両方の環境にインストールし、各環境に応じた機能とツールを使用します。例えば、IBM Cognos Transformer クライアントには、Windows コンピューターでモデルを設計するためのグラフィカル・ユーザー・インターフェースが用意されています。キューブは UNIX または Linux コンピューター上に作成します。IQD データ・ソースを含むモデルは Linux ではサポートされていません。

パス名に ASCII 文字のみが含まれるディレクトリーにインストールします。一部のサーバーでは、ディレクトリー名に ASCII 以外の文字は使用できません。

IBM Cognos Transformer をインストールする前に、現在実行中のプログラムがあればすべて終了してください。これは、インストール・プログラムによってすべての必要なファイルをコンピューターに確実にコピーするためです。


Windows にインストールする場合には、インストールする Windows コンピューターの管理者権限が必要になります。管理者以外のユーザーがインストールする場合は、システム管理者に、そのユーザーのアカウントをコンピューターの管理者グループに追加するように依頼してください。

UNIX または Linux オペレーティング・システムでの IBM CognosTransformer のインストール次の手順に従って、UNIX または Linux オペレーティング・システムで IBMCognos Transformer をインストールします。

手順


2. インストール・ウィザードを起動するため、オペレーティング・システムのディレクトリーに移動して、次のように入力します。

./issetup




ヒント: Linux では、Series 7 IQD Bridge コンポーネントはサポートされていません。

5. インストール・ウィザードの「終了」ページで次のように操作します。

v ログ・ファイルを確認する場合には、目的のログ・ファイルの「表示」をクリックします。

v IBM Cognos Configuration は、すぐに開始しないでください。まず、ご使用の環境が正しくセットアップされているかどうかを確認する必要があります。

IBM Cognos Configuration を使用して、Transformer を後から設定することも可能です。これを行うには、<インストールの場所>/bin64 ディレクトリーに cogconfig.sh を入力します。

v 「終了」をクリックします。

次のタスク

IBM Cognos Transformer でサポートされている UNIX のコマンド行オプションの構文については、IBM Cognos Analytics Knowledge Center の「IBM CognosTransformer UNIX Commands Guide」(www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.cbi.doc/welcome.html) を参照してください。

UNIX で IBM Cognos Transformer の man ページにアクセスするには、"インストールの場所/bin64"ディレクトリーから「cogtr man」と入力します。



Windows オペレーティング・システムでの IBM CognosTransformer のインストール次の手順に従って、Microsoft Windows オペレーティング・システムで IBMCognos Transformer をインストールします。

手順

1. インストール・ファイルをダウンロードして解凍した場所に移動し、issetup.ex

をダブルクリックします。




4. インストール・ウィザードの「終了」ページで次のように操作します。

v ログ・ファイルを確認する場合には、目的のログ・ファイルの「表示」をクリックします。

v IBM Cognos Configuration は、すぐに開始しないでください。まず、ご使用の環境が正しくセットアップされているかどうかを確認する必要があります。


v 「終了」をクリックします。

IBM Cognos Transformer の設定IBM Cognos Transformer が IBM Cognos Analytics と通信するように設定する必要があります。

始める前に

IBM Cognos Transformer を設定する前に、IBM Cognos Analytics コンポーネントをインストールして設定しておきます。IBM Cognos Transformer を設定する前に、少なくとも 1 台の Content Manager コンピューターに Content Manager をインストールして設定し、「IBM Cognos」サービスを開始する必要があります。これにより、認証局 Service から IBM Cognos Transformer コンピューターに対して証明書が発行されます。

Transformer で IBM Cognos Analytics データ・ソース (パッケージやレポートなど) を使用できるようにするには、Transformer がインストールされているコンピューターにデータベース・クライアントがインストールされていることを確認してください。

手順1. IBM Cognos Transformer がインストールされているコンピューターで、IBM

Cognos Configuration を起動します。


2. 「エクスプローラー」ペインで、「環境」をクリックします。

3. 以下の設定について、適切な値を指定します。

ゲートウェイ URIデフォルト: http://ca_server:port/bi/v1/disp

例: http://my_ca_server:9300/bi/v1/disp

この URI は、常に Cognos Analytics とものと同じでなければなりません。


外部アプリケーション用ディスパッチャー URIデフォルト: http://ca_server:port/p2pd/servlet/dispatch

例: http://my_ca_server:9300/p2pd/servlet/dispatch



タスクの結果

IBM Cognos Transformer は、IBM Cognos Analytics と通信するように設定されています。

Transformer と Cognos Analytics の間の通信IBM Cognos Transformer は、IBM Cognos Analytics およびそのコンポーネントと通信するように設定する必要があります。

このトピックの手順はインストール担当者や管理者向けのものです。Transformerのモデル作成者やビジネス・スペシャリストで、Transformer をダウンロードして使用したいという場合は、 164 ページの『モデル作成者への IBM CognosTransformer の配布』を参照してください。

IBM Cognos Analytics を複数の場所にインストールした場合は、すべての URI がIBM Cognos Analytics の正しいバージョンを指していることを確認します。

ファイアウォールがある場合のインストール

Transformer が、アプリケーション層コンポーネントを保護するネットワーク・ファイアウォールの外にある場合、ディスパッチャーとの間で通信の問題が発生する可能性があります。このような問題を回避するには、アーキテクチャーがアプリケーション層コンポーネントと同じである階層に Transformer をインストールするか、Transformer の通信専用のゲートウェイをインストールして設定することができます。詳細については、 32 ページの『ファイアウォールに関する考慮事項』を参照してください。

専用のゲートウェイを使用する場合は、そのゲートウェイがインストールされているコンピューターも設定する必要があります。詳細については、 105 ページの『第5 章ゲートウェイのインストールと設定』を参照してください。


データ・ソースと TransformerIBM Cognos Transformer では、PowerCube 用のメタデータが作成および管理されます。メタデータはマルチプラットフォーム環境や多言語環境のデータ・ソースから取得されるため、IBM Cognos Transformer のデータ・ソース環境を設定する際は、いくつかの事項を検討または実行する必要があります。通常、検討や作業が必要となる事項は、データ・ソースまたはインポート・ソースに使用する技術によって異なります。

他の異なる言語を使用するユーザーが Microsoft Analysis Services (MSAS) 2000データ・ソース接続する場合は、IBM Cognos Analytics インスタンスを言語ごとに別個に作成する必要があります。

他の言語を使用するユーザーが同じ IBM Cognos Analytics インスタンスからMSAS 2005 データ・ソースに接続することはできません。モデル作成者は各言語用にパッケージを別個に作成する必要があります。ユーザーは任意の言語のレポートを実行できます。

データ・ソース接続の詳細については、「IBM Cognos Analytics 管理およびセキュリティー・ガイド」を参照してください。


データ・ソースのセットアップ (Transformer)次の手順に従って、IBM Cognos Transformer の Oracle または SAP BW データ・ソースを設定します。

手順

1. 多言語サポートのための環境変数を設定します。

v Oracle の場合は、Framework Manager および IBM Cognos Analytics サーバーがインストールされている各コンピューターで、次のコマンドを入力して NLS_LANG (National Language Support) 環境変数を設定します。

NLS_LANG = language_territory.character_set


NLS_LANG = AMERICAN_AMERICA.UTF8

NLS_LANG = JAPANESE_JAPAN.UTF8

この変数の値によって、ロケールに基づいた IBM Cognos Analytics の動作が決まります。エラー・メッセージ、ソートの順序、日付、時刻、通貨、数字、カレンダーの規則には、ネイティブの言語とロケールが自動的に適用されます。

v IBM Db2 の場合は、環境変数 DB2CODEPAGE の値を 1252 に設定します。


このオプション環境変数を使用するかどうかについて詳しくは、Db2 のドキュメントを参照してください。

SAP BW に必要な設定はありません。SAP では、Unicode 以外の SAP BWシステムで単一のコード・ページしかサポートしていません。

2. Oracle の場合、$ORACLE_HOME/lib をライブラリー・パスに追加します。

ロード・ライブラリーのパスを設定するときは、32 ビット Oracle ライブラリーがライブラリー検索パス内にあることを確認します。ライブラリー検索パスは通常、$ORACLE_HOME/lib ディレクトリーであり、64 ビット Oracle クライアントをインストールした場合は $ORACLE_HOME/lib32 ディレクトリーです。

3. SAP BW の場合、モデル作成ツールでメタデータを取得できるように次の承認オブジェクトを設定します。

デフォルト値を指定した箇所は、SAP システム側で値を変更することも可能です。

v S_RFC


「Name of RFC to be protected」フィールドを SYST, RSOB, SUGU, RFC1,RS_UNIFICATION, RSAB, SDTX, SU_USER に設定します。

保護対象にするオブジェクトの「Type of RFC」フィールドを FUGR に設定します。

v S_TABU_DIS


「Authorization Group」フィールドを &NC& に設定します。

注: &NC& は、許可グループがない表を表します。セキュリティーを高めるため、許可グループを作成して、表 RSHIEDIR をそれに割り当ててください。この新しい許可グループを使用することにより、ユーザーのアクセスが、モデリング・ツールで必要な表のみに制限されます。許可グループは、SAP システムでカスタマイズすることによって作成します。

v S_USER_GRP

「アクティビティー」フィールドを 03, 05 に設定します。

「User group in user master main」フィールドをデフォルト値に設定します。

v S_RS_COMP



「Info Cube」フィールドを InfoCube テクニカル名の値に設定します。




v S_RS_COMP1




「Owner (Person Responsible)」フィールドをデフォルト値に設定します。

v S_RS_HIER


「階層名」フィールドを階層名に設定します。

「InfoObject」フィールドをInfoObject テクニカル名に設定します。

「Version」フィールドを階層のバージョンに設定します。

v S_RS_ICUBE


「InfoCube sub-object」フィールドを値 DATA と DEFINITION に設定します。


「InfoCube」フィールドを InfoCube テクニカル名に設定します。

SAP BW 承認オブジェクトの詳細については、Transaction SU03 を参照してください。

Transformer のインストールのテストアプリケーションを起動してモデルを作成することにより、設定をテストできます。

手順

IBM Cognos Transformer を起動するには、「スタート」メニューからプログラムに移動して、「IBM Cognos Transformer」をクリックします。Microsoft Windows 8 または Windows 2012 Server では、「スタート」パネルの「IBM Cognos Transformer」アイコンをダブルクリックします。IBM Cognos Transformer を手動で起動するには、<インストールの場所>¥bin ディ


レクトリーにある cogtr.exe ファイルをダブルクリックします。「Transformer」ウィンドウが表示されれば、インストールは正常に機能しています。

IBM Cognos Transformer の追加の設定タスクTransformer をインストールすると、次の作業を行えるようになります。

v IBM Cognos Series 7 の Transformer モデルを使用したいと考えており、引き続き IQD データ・ソースを使用したいという場合は、Transformer への IBMCognos Series 7 データ・ソースの追加を行います。

モデル作成者が Transformer をインストールして使用できるようにするには、次の作業を行います。

v Transformer のモデル作成者が利用できるネットワーク・インストールの場所を作成する

v Transformer のモデル作成者用に設定データをエクスポートする

v モデル作成者用の IBM Cognos Analytics Transformer を配布する

Transformer への IBM Cognos Series 7 データ・ソースの追加IBM Cognos Series 7 の Transformer モデルとデータ・ソースを使用する予定の場合は、Transformer ゲートウェイ・ファイルに IBM Cognos Series 7 データ・ソースの場所を追加する必要があります。


手順

1. 管理者としてログオンします。

2. "<インストールの場所>/CS7Gateways/bin"ディレクトリーの"cs7g.ini"をテキスト・エディターで開きます。

3. ファイルに IBM Cognos Series 7 データ・ソースの場所を追加します。


変更は、次回 Transformer を開く際に適用されます。

Transformer のモデル作成者が利用できるネットワーク・インストールの場所の作成組織にいる専門的なビジネス・ユーザーやパワー・ユーザーは、企業と個人のデータ・ソースを組み合わせて PowerCube のモデルを作成したい場合があります。このようなユーザーは、自身の業務や少数のユーザー・グループのために、データを独自に分析することができます。インストール担当者や管理者はインストール用の実行可能ファイルを Web や LAN 上の場所にダウンロードでき、モデル作成者はそのファイルを実行して IBM Cognos Transformer のインストール・ウィザードを起動できます。



始める前に

このインストール・ファイルを Transformer のモデル作成者が使用できるようにするにあたっては、あらかじめ他のリソースや権限を設定しておく必要があります。

v IBM Cognos Analytics データ・ソースまたは IBM Cognos Series 7 IQD データ・ソースにアクセスするために使用される Transformer コンピューターに、データベース・クライアント・ソフトウェアをインストールするかモデル作成者がインストールできるようにする。

v モデル作成者に、IBM Cognos Administration でデータ・ソースを作成する権限を付与する。

IBM Cognos Administration に直接アクセスする権限をモデル作成者に付与する必要はありません。モデル作成者は、Transformer またはコマンド行ツールを使用して、データ・ソースの作成と更新を行えます。PowerCube パッケージの発行として、ポータル内のセキュリティー保護されたフォルダーをモデル作成者に提供できます。

v 作成した PowerCube を格納する場所へのアクセス権をモデル作成者に付与する。

この格納場所は、IBM Cognos サービスからもアクセス可能である必要があり、LAN 上のセキュリティー保護された共有の場所にすることができます。

v 特定の Transformer サーバー上で PowerCube を構築する場合は、モデルを転送するための FTP 権限と、そのサーバーでキューブを作成するための実行権限をモデル作成者に付与する。

モデル作成者は、スクリプトを使用してモデルの転送とキューブの作成を実行できます。また、自動化された方法で PowerCube を作成することもできます。詳細については、「管理およびセキュリティー・ガイド」を参照してください。

手順

1. IBM Cognos Transformer モデル作成製品のディスクを挿入します。

2. インストール・ウィザードの「ようこそ」ページが表示された場合は、ウィザードを終了します。

3. ディスクに収録されている"C8transformerinstall.exe"ファイルを見つけます。

4. このファイルを、Transformer のモデル作成者がアクセス可能な、保護された場所にコピーします。

Transformer のモデル作成者用の設定データTransformer のインストール・ファイルを Transformer のモデル作成者が利用できるようにする場合、モデル作成者がローカル・コンピューター上で Transformer を設定できるようディスパッチャーおよび暗号化の設定が必要となります。設定は、1台の Transformer コンピューターのものを、他のすべての Transformer コンピューターで使用するようエクスポートできます。モデル作成者がエクスポートされた


設定ファイルを Transformer のインストール・ディレクトリーにコピーし、コマンドを実行すれば、Transformer コンピューターの設定は自動的に行われます。


Transformer コンピューターの coglocale.xml、cogtr.xml、cs7g.ini ファイルを更新した場合、Transformer のモデル作成者が自分のコンピューターに更新済みのファイルをダウンロードできるように、Web または LAN 上の場所にコピーする必要があります。

設定をエクスポートするには、ソース・コンピューターにインストールされているIBM Cognos Analytics コンポーネントと Transformer のモデル作成者のコンピューターにインストールされているコンポーネントが同じでなければなりません。157 ページの『Transformer と Cognos Analytics の間の通信』。

Transformer 設定のエクスポート:

IBM Cognos Configuration を使用して、1 台の Transformer コンピューターの設定を、他のすべての Transformer コンピューターで使用するようエクスポートします。

手順

1. IBM Cognos Configuration で、「ファイル」メニューの「名前を付けてエクスポート」をクリックします。

2. 現在の設定を別のフォルダーにエクスポートする場合、「検索先」ボックスでフォルダーを検索して開きます。

このフォルダーが承認されていない不正なアクセスから保護されていることを確認してください。

3. 「ファイル名」ボックスに設定ファイルの名前を入力します。

4. 「保存」をクリックします。

5. エクスポートしたファイルの名前を"cogstartup.xml"に変更します。

6. ソース・コンピューターからエクスポートした"cogstartup.xml"ファイルをTransformer のインストール・ファイルと同じ Web または LAN 上の場所にコピーします。

7. ソース・コンピューターでグローバル設定を変更したのであれば、"coglocale.xml"ファイルを Transformer のインストール・ファイルと同じ Webまたは LAN 上の場所にコピーします。

"coglocale.xml"ファイルのデフォルトの場所は"<インストールの場所>/configuration"です。

更新した Transformer 設定ファイルのコピー:

個特定の設定ファイルを更新した後、Transformer インストール・ファイルと同じ場所にそれをコピーする必要があります。


手順

1. cogtr.xml を更新したのであれば、<インストール場所>/configuration ディレクトリーから Transformer のインストール・ファイルと同じ Web またはLAN 上の場所にコピーします。

2. cs7g.ini を更新したのであれば、<インストール場所>/CS7Gateways/bin ディレクトリーから Transformer のインストール・ファイルと同じ Web またはLAN 上の場所にコピーします。

モデル作成者への IBM Cognos Transformer の配布ビジネス・スペシャリストや Transformer のモデル作成者は、PowerCube を構築して一部のユーザーやグループに発行できるように、Transformer を配布する必要があります。

インストールをまだ終えていない場合は、Transformer をインストールする手順に従ってください。Transformer が IBM Cognos Analytics のディスパッチャーと通信できるよう設定するには、Transformer を設定する手順に従ってください。

Transformer で IBM Cognos Analytics データ・ソース (パッケージやレポートなど) を使用できるようにするには、Transformer コンピューターにデータベース・クライアントがインストールされていることを確認してください。

Transformer のインストール:

ビジネス・スペシャリストまたは Transformer のモデル作成者は、次の手順に従って、管理者から指定された Web または LAN 上の場所から Transformer をインストールします。

手順

1. 管理者から指定された Web または LAN 上の場所から、"C8transformerinstall.exe"ファイルを実行します。


ヒント: Linux では、Series 7 IQD Bridge コンポーネントはサポートされていません。

3. ウィザードの「終了」ページで、「終了」をクリックします。

次のタスク

「IBM Cognos Transformer UNIX コマンド・ガイド」には、Cognos Transformerによってサポートされている UNIX コマンド行オプションの構文が記述されています。この資料は、IBM Cognos Analytics Knowledge Center (www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0) からアクセスできます。

Transformer の設定:

ビジネス・スペシャリストまたは Transformer のモデル作成者は、次の手順に従って Transformer を設定します。



手順

1. Transformer のインストール・ファイルと同じ Web または LAN 上の場所に移動します。

2. 拡張子が .xml のファイルがあれば、Transformer_location¥configuration ディレクトリーにコピーします。このパスの Transformer_location は Transformerをインストールしたディレクトリーです。

3. 拡張子が .ini のファイルがあれば、Transformer_location¥CS7Gateways¥bin

ディレクトリーにコピーします。

4. Transformer_location¥bin ディレクトリーに移動します。

5. 設定コマンドを次のように入力します。

./cogconfig.bat -s

IBM Cognos Configuration では、"cogstartup.xml"ファイルのローカル・コピーで指定した設定の適用、資格情報の暗号化、デジタル証明書の生成が行われます。その後 IBM Cognos サービスが開始されます。

6. IBM Cognos Transformer をテストするには、「スタート」メニューからプログラムに移動して、「IBM Cognos Transformer」をクリックします。

「Transformer」ウィンドウが表示されれば、インストールは正常に機能しています。

7. Transformer のインストールと実行に成功したら、インストール・ファイルから解凍されたインストール用ファイルを削除します。



第 7 章設定オプション

IBM Cognos コンポーネントをインストールして設定した後は、環境に合わせて設定を変更できます。コンポーネントの初期設定には、デフォルトのプロパティー設定が使用されますが、しかし、既存の条件によりデフォルト選択が適さない場合や、環境により適した設定を行うために、このデフォルト設定を変更することもできます。

例えば、IBM Cognos Application Firewall 機能の設定や、IBM Cognos コンポーネントで使用するリソース量の指定が可能です。また、Portal Services を設定すると、別のポータルを使用して IBM Cognos コンテンツを配布できるようになります。

他のリソースを使用するように IBM Cognos コンポーネントを設定することができます。例えば、認証プロバイダーを使用して、データベース接続とユーザーに対するシングル・サインオンを有効にすることができます。

負荷分散スキームを使用する場合は、パフォーマンスを向上させるように設定を変更できます。例えば、ディスパッチャーの処理容量を変更したり、プロセスや接続の最小数と最大数を設定して、複数のディスパッチャー間で要求を分散できます。サーバー・パフォーマンスの調整の詳細については、「管理およびセキュリティー・ガイド」を参照してください。

すべての Microsoft Windows オペレーティング・システムと、ほとんどの UNIXおよび Linux オペレーティング・システムにインストールした場合、IBM CognosConfiguration を使用して設定を行います。ただし、IBM Cognos コンポーネントをインストールする UNIX または Linux コンピューターに接続されているコンソールで Java ベースのグラフィカル・ユーザー・インターフェースがサポートされていない場合は、<インストールの場所>/configuration ディレクトリーにあるcogstartup.xml ファイルを手作業で編集してから、IBM Cognos Configuration をサイレント・モードで実行する必要があります。

次のオプションの設定作業では、IBM Cognos コンポーネントを既存の環境に簡単に統合できるように設定をカスタマイズします。

IBM Cognos Analytics コンポーネントで使用する Java のバージョンの変更

IBM Cognos Analytics コンポーネントを実行するには、JRE (Java RuntimeEnvironment) が必要です。

特定バージョンの JRE を必要とするアプリケーション・サーバーで IBMCognosAnalytics コンポーネントを使用する場合、または既に他のアプリケーションでJRE バージョンを使用している場合、Java バージョンを変更できます。Java バージョンは、JAVA_HOME 環境変数を設定して変更します。

167

JAVA_HOME

独自の Java を使用する場合は、JAVA_HOME 環境変数を設定してください。

JRE バージョンが IBM Cognos 製品でサポートされていることを確認します。

Microsoft Windows オペレーティング・システムでは、JAVA_HOME 変数を設定しない場合、インストールで提供される JRE ファイルが使用されます。

JRE がサポートされていることを確認するには、IBM ソフトウェア互換性レポート(www.ibm.com/support/docview.wss?uid=swg27047186)を参照してください。

無制限 JCE ポリシー・ファイル

JRE には、制限付きポリシー・ファイルが含まれています。使用できる暗号アルゴリズムおよび暗号スイートはこのファイルによって制限されます。必要な暗号アルゴリズムおよび暗号スイートが、IBM Cognos Configuration に表示されるものよりも広範囲に及ぶ場合は、無制限 JCE ポリシー・ファイルをダウンロードしてインストールできます。

IBM によって提供される Java の無制限 JCE ポリシー・ファイルは、IBM Webサイト (www14.software.ibm.com/webapp/iwm/web/preLogin.do?source=jcesdk) から入手できます。

手順1. Cognos Configuration を起動します。

2. 「ファイル」 > 「名前を付けてエクスポート (Export As...)」をクリックして、構成を configuration フォルダーに export_cogstartup.xml のようなテキスト・ファイルにエクスポートします。Cognos Configuration を終了します。

3. 以下のファイルとフォルダーのバックアップを作成します。

v ファイル

v install_location/configuration/cogstartup.xml

v install_location/configuration/caSerial

v フォルダー

v install_location/configuration/csk

v install_location/configuration/certs

4. フォルダー install_location/configuration/certs/mobile を除いて、バックアップを取ったフォルダーおよびファイルを削除します。 install_location/configuration/certs フォルダー内の他のすべてのファイルを削除します。

5. ステップ 2 で作成した構成バックアップ・ファイルの名前を cogstartup.xmlに変更します。

6. JAVA_HOME システム環境変数を、使用する JRE に設定します。jre/lib/ext

フォルダーに、この JRE の bcprov があらかじめあることを確認してください。

7. Cognos Configuration を起動し、構成を保存して、サーバーを再始動します。あるいは、install_location/bin64 フォルダーでコマンド行を使用してcogconfig.bat -s を実行します。





これにより、新しい JRE の鍵が再生成されます。

デフォルト設定の変更IBM Cognos コンポーネントをインストールすると、デフォルト値が使用されます。あるポートが別のプロセスで使用されているなどの理由でデフォルト値を使用できない場合には、IBM Cognos Configuration を使って値を変更します。

プロパティーの値を変更した場合は、設定を保存してから IBM Cognos サービスを再開して、新しい設定内容をコンピューターに適用する必要があります。

分散インストールの場合は、他の IBM Cognos コンピューターでデフォルトの設定を変更する前に、Content Manager をインストールしたすべてのコンピューターの設定が済んでいることを確認します。例えば、以下を行うことができます。

v URI の変更

v 設定グループの管理

v 設定サーバーの管理

v 暗号化の設定

v IBM Cognos Application Firewall を使用するための IBM Cognos コンポーネントの設定

v 一時ファイルのプロパティーの設定

v ネームスペースを使用するためのゲートウェイの設定

v サービスの有効化または無効化

v フォントの設定

v レポートのデフォルト・フォントの変更

v ファイル・システムへの出力レポートの保存

v Reporting の地図グラフの場所の変更

v 通知データベースの変更

IBM Cognos 環境により適合するように IBM Cognos コンポーネントのデフォルトの動作を変更した後、認証プロバイダーを構成し、Framework Manager をインストールして構成することができます。

ポートと URI の設定URI の一部の要素は、環境に合わせて変更できます。IBM Cognos URI には次の要素が含まれています。

ポートに関する追加情報は、 7 ページの『デフォルト・ポート設定の確認』のトピックに記載されています

v Content Manager URI、外部アプリケーション用ディスパッチャー URI、またはディスパッチャー URI の場合

<プロトコル>://<ホスト名または IP>:<ポート>/<コンテキスト・ルート>/<別名パス>

v ゲートウェイ URI または Web コンテンツ URI の場合

第 7 章設定オプション 169

<プロトコル>://<ホスト名または IP>:<ポート>/<仮想ディレクトリー>/<ゲートウェイ・アプリケーション>

あるいは

<プロトコル>://<ホスト名または IP>:<ポート>/<コンテキスト・ルート>/<別名パス>

重要: HTTPS/SSL 構成の場合、 URI には必ず完全修飾ホスト名を使用してください。

次の表で要素について説明します。

表 20. IBM Cognos URI の要素および説明

要素説明

プロトコル Hyper Text Transfer Protocol や Hyper Text TransferProtocol (Secure) など、情報の要求や転送に使用するプロトコルを指定する。

例: http または https

ホスト名または IP ネットワークのホストの ID を指定する。IP アドレス、コンピューター名、完全修飾ドメイン名を使用できます。

分散インストールでは、URI の"localhost"要素を変更する必要があります。

UNIX オペレーティング・システム・サーバーと MicrosoftWindows オペレーティング・システム・サーバーが混在する環境では、その環境内のすべてのサーバーでホスト名が IP アドレスとして解決できることを確認します。

例:localhost または 192.168.0.1 または[2001:0db8:0000:0000:0000:148:57ab]:80

ポートホスト・システムが要求を待機するポートを指定する。

IBM Cognos Analytics サービスのデフォルト・ポートは9300 です。Web サーバーのデフォルト・ポートは 80 です。

例: 9300 または 80

コンテキスト・ルート適切な Web アプリケーションに要求が転送され処理されるようにするために、アプリケーション・サーバーがアプリケーションのコンテキストを調べるときに使用する。

例: p2pd

別名パスアプリケーション・サーバーで、Web アプリケーション内の適切なコンポーネントに要求を転送する場合に使用する。

別名のパスは絶対に変更しないでください。変更すると、IBMCognos コンポーネントが正常に機能しなくなります。

例: servlet/dispatch


表 20. IBM Cognos URI の要素および説明 (続き)

要素説明

仮想ディレクトリー Web サーバーで、仮想ディレクトリーまたは別名を物理的な場所にマッピングする場合に使用する。

例えば、デフォルトのゲートウェイ URI である"http://localhost:80/ibmcognos/cgi-bin/cognos.cgi"では、仮想ディレクトリーは"ibmcognos/cgi-bin"です。

例:ibmcognos/

ゲートウェイ・アプリケーション使用している Cognos ゲートウェイ・アプリケーション名を

指定する。

例えば、Common Gateway Interface (CGI) を使用して IBMCognos コンポーネントにアクセスする場合、デフォルトのゲートウェイ・アプリケーションは"cognos.cgi"になります。

例: cognos.cgi

IBM Connections とのコラボレーションを使用する場合 IBM CognosConfiguration でのすべてのホスト名エントリーに対して、必ず完全ドメインを含めるようにします。例えば、コンピューター名が"MyComputer"でドメインが"MyCompanyName.com"の場合、<ホスト名または IP>の値には"MyComputer.MyCompanyName.com"を使用します。IBM Connections がアクセスできるようにするためには、ドメインを組み込む必要があります。

ポートまたは URI 設定の変更次の手順に従って、IBM Cognos Configuration の URI プロパティーを変更します。

手順

1. IBM Cognos Configuration を起動します。

2. 「エクスプローラー」ウィンドウで、適切なグループまたはコンポーネントをクリックします。

v ディスパッチャーの要素を変更するには、「環境」をクリックします。

v ローカル・ログ・サーバーの要素を変更するには、「環境」の「ログ記録」をクリックします。

3. 「プロパティー」ウィンドウで、変更する URI プロパティーの隣にある「値」ボックスをクリックします。

4. 要素を選択し、新しい情報を入力します。

v ローカル・ディスパッチャーで使用するポートを変更するには、内部ディスパッチャー URI プロパティーの値を変更します。この変更はローカル・ディスパッチャーを基準とするすべての URI に影響を及ぼすため、すべてのローカル・コンポーネントの URI を変更する必要があります。

v ディスパッチャー URI のディスパッチャー・ポートを変更する場合は、このシステムのディスパッチャー、Content Manager、または Software


Development Kit サービスを使用するリモート・コンピューターを設定する際に、変更したポート番号を指定する必要があります。

v HTTPS/SSL 構成の場合、 URI には必ず完全修飾ホスト名を使用してください。


Cognos Analytics データ・セット・サービス・ポートを 11.0.6 から 11.0.8 に変更するIBM Cognos Analytics データ・セット・サービス・ポートは、Cognos Analyticsが初めて開始されたときに動的に確保されます。

このポートは install_location/wlp/usr/servers/dataset-service/bootstrap.properties ファイルに保管され、そこで参照できます。

ポート番号は、Cognos Analyticsディスパッチャー・ポートに 1 を加算した値になります。例えば、9300 + 1 = 9301 になります (デフォルト)。

データ・セット・サービス・ポートは、割り当てて保管した後は、更新や変更ができません。ディスパッチャー・ポートを変更しても、変更できません。しかし、データ・セット・サービスに強制的にポートを再確保させたり、bootstrap.properties ファイル内でポートをハードコーディングしてクエリー・サービスの対象を強制的に特定のポートにしたりできます。

Cognos Analytics が初めて開始されたときにデータ・セット・サービス・ポートが割り当てられるので、Cognos Analytics を開始する前にすべてのソフトウェアを実行するのが最善です。こうすると、データ・セット・サービスは別の製品で使用されるポートを取得しなくなります。

データ・セット・サービスにポートを動的に再確保させるには、以下の手順に従います。

1. 更新しようとしている Cognos Analytics インスタンスを停止します。

2. テキスト・エディターで install_location/wlp/usr/servers/dataset-service/bootstrap.properties ファイルを開きます。

3. http.port 設定を 0 に設定します。つまり、http.port=0 のようにします。

4. Cognos Analytics を開始します。この製品の開始時に http.port が再確保されます。

5. bootstrap.properties ファイルを調べて、割り当てられたポート番号を確認します。

データ・セット・サービスを強制的に特定のポートにするには、以下の手順に従います。

1. 更新しようとしている Cognos Analytics インスタンスを停止します。

2. テキスト・エディターで install_location/wlp/usr/servers/dataset-service/bootstrap.properties ファイルを開きます。

3. http.port 設定を特定の値に設定します。例えば、http.port=9876 のようにします。


4. Cognos Analytics を開始します。この製品の開始時に http.port が割り当てられます。

5. bootstrap.properties ファイルを調べて、正しいポート番号が割り当てられたかどうか確認します。

Cognos Analytics の開始後に、割り当てられた http.port 上でデータ・セット・サービスが netstat を使用して listen していることを確認します。

ヒント: Cognos Analytics 11.0.9 以降、IBM Cognos Configuration でデータ・セット・サービス・ポートを設定できます。

「設定グループ (Configuration Group)」の管理

設定グループは、設定を共有するサーバーのグループを定義します。この設定は、ネットワーク分割後も設定値が使用可能なまま残り、すべてのノードで一貫性が保たれるため、マルチサーバー・インストール環境では重要になります。設定グループのコンタクト・ホストは、アクティブな Content Manager と同じインスタンスで実行されます。

このタスクについてv 「簡易 (Easy)」インストールで、「接続してインストール (Connect and

install)」オプションを選択して実行中のシステムの機能を拡張する場合、この値は自動的に設定されます。

v 「最初のカスタム (Custom First)」インストールの場合、アクティブな ContentManager として設定されたコンピューターの使用時には、この値は自動的に設定されます。

v カスタムの「接続してインストール (Connect and install)」の場合、インストール中に Cognos Analytics URL により Content Manager ノードに正常に接続すると、この値は自動的に設定されます。

v 「最初のカスタム (Custom First)」インストールの場合、Content Manager が待機中として設定されている際や、インストール中にゲートウェイ URL の検証に失敗したものの続行を選択する際には、以下のステップに従ってこれらのプロパティーを設定する必要があります。

手順1. Cognos Configuration を開始します。

2. 「エクスプローラー」ウィンドウの「ローカル設定」で、「環境」をクリックします。

3. 「設定グループ (Configuration Group)」をクリックします。

4. 適切な値を設定するには、以下のようにします。

v これがアクティブな Content Manager サーバーのインストール済み環境である場合、プロパティー名を右クリックして「デフォルトにリセット」をクリックすることによって、ローカル・サーバーの値を設定できます。

v これが待機中の Content Manager サーバーのインストールまたはアプリケーション層のインストールである場合、値を設定する必要があります。


a. 「設定グループ (Configuration Group)」を右クリックし、「取得(Retrieve)」ボタンをクリックして「設定サーバーの取得 (RetrieveConfiguration Servers)」ダイアログを起動します。

アクティブな Content Manager で SSL が有効な場合、Content Manager URL および他のプロパティーが正しく構成されて保存された後に、構成グループ・プロパティーを取り出すことができます。

b. アクティブな Content Manager サーバーにアクセスするための適切な情報を入力し、「OK」をクリックします。

ユーザー ID - サーバーでの管理特権を持つ ID。

パスワード - ユーザー ID のパスワード。

ネームスペース ID - 「セキュリティー」、「認証」リソースに表示される値。例: CognosEx

Cognos Analytics URL - Cognos Analytics を実行するために使用される URL。例: http://myserver:9300/bi

v 「取得」オプションを使用して値を取得できない場合、値を手動で設定できます。各プロパティーについて、プロパティー・ウィンドウの下部に表示されるガイダンスに従ってください。

「ローカル・メンバー設定 (Local Member Settings)」の下の 2 つのポートが、使用中でない別個のローカル・ポートであることを確認します。インストール中にコンピューター上のすべてのアプリケーションが実行中だった場合は、使用可能なポートを使ってこれらのポートが既に設定されているはずです。

重要: これらのポートを、インバウンドおよびアウトバウンドのトラフィックに対して公開する必要があります。

– 「メンバー同期ポート (Member synchronization port)」は、サーバー間で設定情報を転送したり同期したりするネットワーク通信で使用するローカル・ポートです。いずれのインストールも、その他のインストール上の MutualAuthSSLHttpEndpoint と対話できる必要があります。例えば、このポート上でアプリケーション層とデータ層の間のファイアウォールを開く必要があります。httpEndpoint は、Cognos Analytics インスタンス同士の内部通信にのみ使用されます。デフォルトは 4300 です。

– 「メンバー調整ポート (Member coordination port)」は、グループ調整のためにネットワーク通信で使用されるローカル・ポートです。このポートは、グループのディスカバーとそのグループへの参加、および構成グループ・メンバーの最新リストの保守に使用します。1 次 ContentManager インストールでは、グループ接続ポートは同じポートです。各インストールはグループ調整ポート上のその他のインストールと対話できる必要があります。したがって、このポートでインストール済み環境の各層の間のファイアウォールは開いている必要があります。デフォルトは5701 です。

5. 設定を保存します。


「設定サーバー (Configuration Server)」の管理

設定サーバーは、設定値を管理するサーバーを識別します。この設定は、ネットワーク分割後も設定値が使用可能なまま残り、すべてのノードで一貫性が保たれるため、マルチサーバー・インストール環境では重要になります。設定サーバーは、アクティブな Content Manager と同じインスタンスで実行されます。

( では設定グループに置き換えられました) に適用されます。


簡易インストールで、「接続してインストール (Connect and install)」オプションを選択して実行中のシステムの機能を拡張する場合、この値は自動的に設定されます。

手順1. Cognos Configuration を開始します。

2. 「エクスプローラー」ウィンドウの「ローカル設定」で、「環境」をクリックします。

3. 「環境 - グループ・プロパティー (Environment - Group Properties)」ウィンドウで、カテゴリー「その他の URI 設定」までスクロールダウンし、「設定サーバー (Configuration Server)」をクリックします。

4. 適切な値を設定するには、以下のようにします。

v これがアクティブな Content Manager サーバーのインストール済み環境である場合、右クリックして「デフォルトにリセット」をクリックすることによって、ローカル・サーバーに値を設定できます。

v これが待機中の Content Manager サーバーのインストールまたはアプリケ

ーション層のインストールである場合、編集アイコンをクリックして編集ダイアログを立ち上げることによって、値を設定する必要があります。

a. 「値 - 設定サーバー (Value - Configuration Server)」ダイアログで、「取得」ボタンをクリックして「設定サーバーの取得 (RetrieveConfiguration Servers)」ダイアログを起動します。アクティブなContent Manager サーバーにアクセスするための適切な情報を入力し、「OK」をクリックします。

ユーザー ID - サーバーでの管理特権を持つ ID。

パスワード - ユーザー ID のパスワード。

ネームスペース ID - 「セキュリティー」、「認証」リソースに表示される値。例: CognosEx

Cognos Analytics URL - Cognos Analytics を実行するために使用される URL。例: http://myserver:9300/bi

b. 「設定サーバー (Configuration Server)」値を取得します。「OK」をクリックして、値を設定します。



v 「取得」ボタンを使用して値を取得できない場合、値を手動で設定できます。

a. アクティブな Content Manager サーバーで、install_location/

zookeeper/conf/zoo.cfg を開きます

b. 2 つの設定を見つけるには、次のようにします。

server.1=Myhost.ibm.com:2888:3888clientPort=2181

c. 2 つの値をセミコロンで連結するには、次のようにします。

Myhost.ibm.com:2888:3888;2181

d. プロパティーの値を入力します。


暗号化の設定IBM Cognos コンポーネントを実行するには暗号化プロバイダーが必要です。これがないとこれらのコンポーネントは実行できません。デフォルトの暗号化プロバイダーを削除する場合、別の暗号化プロバイダーを設定する必要があります。

暗号化に関する次の設定を行うことができます。

v 全般的な暗号化の設定

v デフォルトの暗号化プロバイダーの設定

v Entrust セキュリティー・インフラストラクチャーにおける暗号化プロバイダーの設定

全般的な暗号化の設定の構成分散インストール環境では、IBM Cognos コンピューターと Content Manager との交信によって信頼が確立され、Content Manager から暗号鍵が取得されます。

アプリケーション・サーバーの変更や Content Manager の再インストールなどによって、Content Manager の暗号鍵を変更する場合には、他の IBM Cognos コンピューターの暗号鍵を削除する必要があります。その後、各コンピューターで設定を保存して、Content Manager から暗号鍵を入手できるようにする必要があります。また、分散インストールではすべての IBM Cognos コンポーネントで、同じ暗号化プロバイダー設定を使用する必要があります。

また分散インストール環境では、対称鍵は Content Manager をインストールしたコンピューターにのみ保存する必要があります。

暗号化に関して次の全般的な設定を行うことができます。

v 規格適合

IBM Cognos と NIST SP 800-131A のどちらの暗号標準を使用するか指定します。

v 共通対称鍵ストア (CSK) のプロパティー

CSK は、IBM Cognos でのデータの暗号化と復号化に使用されます。

v Secure Sockets Layer (SSL) 設定


これには、相互認証、機密保持、SSL Transport Layer Security 設定が含まれます。

注: Transport Layer Security は、検証済みの証明書と暗号化鍵を使用してインターネット経由の通信を保護する暗号化ルールのセットで構成されます。 TLSは、SSL プロトコルを更新したものです。1.1、1.2、または組み合わせ設定から選んでください。

v 詳細アルゴリズム設定

詳細アルゴリズムには、署名アルゴリズムとダイジェスト・アルゴリズムがあります。

手順


2. 「エクスプローラー」ウィンドウの「セキュリティー」で、「暗号化」をクリックします。

3. 「プロパティー」ウィンドウで「値」ボックスをクリックしてデフォルト値を変更し、必要な値を選択します。

v 規格適合の適用に関するオプションには、IBM Cognos と NIST SP800-131A があります。選択した規格で他のパラメーターが許可されていない場合、この値によって保存操作が失敗する可能性があります。選択したアルゴリズムまたは規格適合を変更する必要があります。サポートされるすべてのアルゴリズムを使用可能にするには、JRE の無制限管轄ポリシー・ファイルをインストールする必要が生じることがあります。これらのファイルはIBM から提供されています。

v Content Manager がないコンピューターで CSK をローカルに保存しない場合は、「CSK 設定」で「対称鍵をローカルに保存」を「無効」に変更します。

「対称鍵をローカルに保存」を「無効」に設定した場合は、必要に応じて、Content Manager から鍵が取得されます。「共通対称鍵ストアの場所」プロパティーは無視されます。

v 通信を行う両方のコンピューターの ID を確認する場合は、「SSL 設定」の「相互認証の使用」を「有効」に変更します。

「機密性を使用」は変更しないでください。

v ダイジェスト・アルゴリズムを変更する場合は、「ダイジェスト・アルゴリズム」プロパティーで別の値を選択します。


5. ゲートウェイ・コンピューターでのみ、暗号化プロバイダーをテストします。「エクスプローラー」ウィンドウの「暗号化」を右クリックし、「テスト」をクリックします。

IBM Cognos コンポーネントによって、対称鍵の可用性がチェックされます。


http://www.ibm.com/Search/?q=JRE+unlimited+jurisdiction+policy&v=17&en=utf&lang=en

タスクの結果

暗号化に関する設定を行うと、設定内のパスワードや作成したデータが暗号化されます。

デフォルトの暗号化プロバイダーの設定デフォルトの暗号化プロバイダーについて、いくつかの暗号化設定を行うことができます。

以下の設定を構成できます。

v アルゴリズムと暗号スイート

v ID 名の設定

v 暗号鍵ストアの設定

暗号鍵ペアには、データの暗号化に使用される秘密鍵と、データの復号化に使用される公開鍵が含まれます。

v 認証局設定

認証局 (CA) は、デフォルトの CA または別の CA のいずれかです。

v サブジェクト代替名の設定

サブジェクト代替名 (SAN) は、SSL 証明書の送信元を検証するために使用されます。

手順

1. IBM Cognos サーバー付属の JRE とは別の JRE を使用している場合は、install_location/jre/lib/ext に移動します。

2. bcprov-jdk<バージョン>.jar を <JRE の場所>/lib/ext にコピーします。

3. IBM 提供以外の JRE を使用している場合、ご使用の JRE 用に無制限 JavaCryptograph Extension (JCE) ポリシー・ファイルもダウンロードおよびインストールし、使用可能なすべてのアルゴリズムと暗号スイートが IBM CognosConfiguration に表示されていることを確認します。


5. 「エクスプローラー」ウィンドウの「セキュリティー」、「暗号化」で、「Cognos」をクリックします。

6. 「プロパティー」ウィンドウで、必要に応じてプロパティーを変更します。

ヒント: 各プロパティーの詳細情報については、IBM Cognos Configuration でプロパティーをクリックすると表示されるプロパティーの説明を参照してください。

v 機密性アルゴリズムを設定するには、「機密性アルゴリズム」と「PDF 機密性アルゴリズム」のうち、該当するほうのプロパティーの「値」列をクリックしてから、ドロップダウン・リストからアルゴリズムを選択します。

機密性アルゴリズムの値によって、IBM Cognos コンポーネントによるデータの暗号化方式が決まります。例えば、IBM Cognos Configuration で入力されるデータベース・パスワードは、設定を保存する際に暗号化されます。


データの暗号化時に選択されるアルゴリズムは、データを後日、暗号化解除する際にも使用できる必要があります。

機密性アルゴリズムの可用性は、使用している環境が変更されると、変わる場合があります。例えば、使用している Java Runtime Environment (JRE)が変更された、またはコンピューターに他の暗号化ソフトウェアをインストールしたなどの場合がこれにあたります。データの暗号化時に選択した「機密性アルゴリズム」の値が、データへのアクセス時にも使用できることを確認する必要があります。

JRE のアップグレードや、JRE のアップグレードを伴うようなソフトウェアのインストールを行うと、機密性アルゴリズムの可用性に影響を与えることがあります。使用可能なアルゴリズムと暗号スイートが IBM CognosConfiguration に表示されるようにするため、無制限 Java CryptographyExtension (JCE) ポリシー・ファイルをダウンロードしてインストールします。IBM が提供している Java の無制限 JCE ポリシー・ファイルは、無制限 JCE ポリシー・ファイル (https://www14.software.ibm.com/webapp/iwm/web/preLogin.do?source=jcesdk) からダウンロードできます。

v 暗号スイートを調整するには、「サポートする暗号スイート」で「値」列を

クリックし、「編集」アイコン


該当しない暗号スイートは削除し、それ以外の暗号スイートについては、リストの中で範囲の大きい順に並ぶように、リストの中で上下に移動します。

40～56 ビットの範囲の暗号スイートと、128～168 ビットの範囲の暗号スイートが混在しないようにしてください。

v 暗号鍵の場所を変更する場合は、「暗号化鍵の設定」で「暗号化鍵ストアの場所」を別の場所に変更します。

v 別の認証局を使用する場合は、「認証局設定」で「サード・パーティーの認証局を使用」を「有効」に変更します。

詳細については、 203 ページの『別の認証局を使用するための IBMCognos コンポーネントの設定』を参照してください。

v HTTPS/SSL を使用するように構成する場合は、「サーバー共通名」をCAMUSER からサーバーの完全修飾ドメイン名に変更します。

v 「サブジェクト代替名 (Subject Alternative Name)」を設定するには、サーバー証明書に関連付けられている「DNS 名 (DNSnames)」、「IPaddresses (IP アドレス)」、および「E メール・アドレス」(オプション) を指定します。これらの値がサーバー証明書内のサブジェクト代替名拡張領域に追加されます。プロパティーごとに複数の値を指定できます。値は空白文字を使用して区切ります。


タスクの結果

別の認証局 (CA) サーバーを使用する場合は、その CA を使用するように IBMCognos コンポーネントを設定します。詳細については、 203 ページの『別の認証局を使用するための IBM Cognos コンポーネントの設定』を参照してください。




Entrust セキュリティー・インフラストラクチャーにおける暗号化プロバイダーの設定Entrust セキュリティー・インフラストラクチャーで暗号化を設定するには、IBMCognos Configuration のデフォルトの暗号化プロバイダーを Entrust で使用するプロバイダーに置き換え、IBM Cognos 環境内のセキュリティー・ファイルを更新します。

始める前に

鍵ストアのパスワードが Entrust Profile (EPF) のパスワードと一致していることを確認してください。

ゲートウェイ・エラーを防ぐために、インターネット・ゲスト・アカウントがEntrust .epf ファイルに対して読み取り権限と書き込み権限を、Entrust .ual ファイルに対しては読み込み権限を持つようにします。

手順

1. IBM Cognos サーバー付属の JRE とは別の JRE を使用している場合は、install_location/jre/lib/ext に移動します。

2. bcprov-jdk<バージョン>.jar を <JRE の場所>/lib/ext にコピーします。

3. IBM Cognos および Entrust の次のファイルを、JRE がインストールされている場所に含める必要があります。

v Entrust からダウンロードした Entrust Authority Security Toolkit から<JRE の場所>/lib/ext に enttoolkit.jar などの .jar ファイルをコピーする。

4. 使用可能なすべのアルゴリズムと暗号スイートが IBM Cognos Configurationに表示されるようにするため、無制限 Java Cryptography Extension (JCE) ポリシー・ファイルをダウンロードしてインストールします。IBM が提供している Java の無制限 JCE ポリシー・ファイルは、無制限 JCE ポリシー・ファイル (https://www14.software.ibm.com/webapp/iwm/web/preLogin.do?source=jcesdk) からダウンロードできます。


6. 「エクスプローラー」ウィンドウの「セキュリティー」グループで、「暗号化」をクリックします。

7. 「プロパティー」ウィンドウの「詳細アルゴリズム設定」で、「ダイジェスト・アルゴリズム」を適切なメッセージ・ダイジェストまたはセキュリティー・ポリシーのセキュア・ハッシュ・アルゴリズムに変更します。

8. 「エクスプローラー」ウィンドウの「セキュリティー」グループおよび「暗号化」コンポーネントで、「IBM Cognos」リソースを右クリックして「削除」をクリックします。

9. 「セキュリティー」グループで、「暗号化」を右クリックし、「リソースの新規作成」>「プロバイダー」の順にクリックします。

10. 「名前」フィールドに、作成する暗号化サービスの名前を入力します。

11. 「タイプ」フィールドで矢印をクリックし、「Entrust」をクリックしてから、「OK」をクリックします。




割り当てた名前の付いた分岐が「暗号化」の下に表示されます。

12. 作成した分岐をクリックします。

リソースのプロパティーが「プロパティー」ウィンドウに表示されます。

13. 「リソース・プロパティー」ウィンドウで、次の表に示すとおりに適切な値を入力します。

表 21. 暗号化のプロパティー値および説明

プロパティー説明

INI ファイルの場所 Entrust 初期化ファイル (.ini) の場所。

ID ファイルの識別名 (DN) Entrust ID のプロファイルに関連付けられている識別名。

ID ファイルの場所 Entrust ID プロファイル・ファイル (.epf)の場所。

Entrust サーバー・ログオンを使用ユーザーがパスワードを入力して EntrustPKI にログオンする必要があるかどうかを制御するパラメーター。

ID ファイルのパスワード Entrust Profile のパスワード。EntrustProfile (EPF) 内のパスワードと一致している必要があります。

機密性アルゴリズムセキュリティー・ポリシーを遵守するために必要な暗号化レベル。

PDF 機密性アルゴリズム PDF データを暗号化する際に使用する暗号化アルゴリズム。

サポートする暗号スイートセキュリティー環境でサポートされている暗号スイート。不適切なスイートは削除し、残りの暗号スイートをレベルの高い順に並べ替えます。これにより、最も安全な暗号スイートがまず使用されるようになります。

署名鍵ストアの場所署名鍵のペアが格納される鍵ストアの場所。

暗号化鍵ストアの場所暗号化鍵のペアが格納される鍵ストアの場所。

重要: パスワードは保護された場所に記録してください。


15. Entrust Java Toolkit 7.2 SP2 Patch 170072 に更新します。

IBM Cognos Application FirewallHTTP 要求と XML 要求は IBM Cognos Application Firewall による解析と検証が完了してから、IBM Cognos のサーバーによって処理されます。HTTP 要求とXML 要求は、IBM Cognos Application Firewall によって変更されることもあります。

IBM Cognos Application Firewall では、IBM Cognos Web 製品を悪意のあるデータから保護します。悪意のあるデータの最も一般的なものとしては、有効なページへのスクリプトの挿入や別の Web ページへの転送による、バッファーのオーバーフローや、クロスサイト・スクリプト (XSS) 攻撃などがあります。


ログ・ファイルを確認して、ファイアウォールによる処理状況を監視できます。ログ・ファイルには、拒否された要求が記録されています。デフォルトで、ログ・メッセージは install_location/logs/cogaudit.log ファイルに保管されます。

IBM Connections とのコラボレーション機能を使用している場合は、IBMConnections が実行されているホスト名、ドメイン、およびポート番号を、CognosApplication Firewall の「有効なドメインまたはホスト」プロパティーに追加する必要があります。

Cognos Application Firewall の設定はすべて、IBM Cognos アプリケーション層コンポーネントがインストールされている分散インストール環境内の全コンピューターに対して同じでなければなりません。例えば、Cognos Application Firewall が一部のコンピューターでは無効であり、その他のコンピューターでは有効となっていると、予期しない動作や製品エラーが発生する場合があります。

Cognos Application Firewall 検証では、次のタイプの URL が受け付けられます。

v 完全修飾 (絶対)URL

形式は"<プロトコル>://<ホスト>:<ポート>/<パス>"です。この場合、<プロトコル>は http または https であり、<ホスト>は有効なドメイン・リストに対して検証されています。

v Web インストール・ディレクトリーに相対的な URL

形式は"/<Web インストール・ルート>/.*"です。この場合、<Web インストール・ルート>は、Web サーバー上に設定した ibmcognos という別名に基づいた、ゲートウェイ Web ディレクトリーです。


/ibmcognos/ps/portal/images/action_delete.gif

v 次のような特定の許可された URL (いずれも大文字と小文字の区別なし)

about:blank

JavaScript:window.close( )

JavaScript:parent.close( )

JavaScript:history.back( )

parent.cancelErrorPage( )

doCancel( )

IBM Cognos Application Firewall を使用するように IBM Cognosコンポーネントを設定するIBM Cognos Configuration を使用すると、他の XSS ツール・サポートに対する設定を変更し、IBM Cognos の有効な名前のリストに、ホスト名またはドメイン名を追加できます。


手順

1. アプリケーション層コンポーネントがインストールされているそれぞれの場所で、IBM Cognos Configuration を開始します。

2. 「エクスプローラー」ウィンドウの「セキュリティー」で、「IBM CognosApplication Firewall」をクリックします。

3. 「プロパティー」ウィンドウの「CAF 検証を有効化」プロパティーで、適切な値を設定します。

デフォルトでは、IBM Cognos Application Firewall は有効になっています。

重要: IBM Cognos Application Firewall は、IBM Cognos セキュリティーに不可欠なコンポーネントであり、コンピューターやネットワークの脆弱性に対する保護を強化します。IBM Cognos Application Firewall を無効化すると、この保護も解除されます。通常の状況下では、IBM Cognos Application Firewallを無効化しないでください。

4. GET 要求パラメーター内で特定の文字をチェックする別の XSS ツールを使用する場合、「プロパティー」ウィンドウで「サード・パーティーの XSS チェック有効」プロパティーの値を「有効」に変更します。

デフォルトの禁止文字は、「>」、「<」、および「'」です。

5. IBM Cognos の有効な名前のリストに、ホスト名またはドメイン名を追加します。

v 「有効なドメインまたはホスト名」プロパティーの値をクリックし、「編

集」アイコン


v 「値 - 有効なドメインまたはホスト名」ダイアログ・ボックスの「追加」をクリックします。

ポータルで追加するすべてのハイパーリンクのドメインを指定する必要があります。詳細については、「IBM Cognos Analytics 管理およびセキュリティー・ガイド」の URL の作成に関するトピックを参照してください。

ヒント: IBM Cognos Series 7 から IBM Cognos Analytics のレポートにドリルスルーする場合は、IBM Cognos Series 7 ゲートウェイ・サーバーのホスト名をリストに追加します。

v 表の空白行をクリックして、ホスト名またはドメイン名を入力します。

ドメインとそのすべてのサブドメインを許可する場合は、ドメイン名の先頭でワイルドカード文字を使用します。

例えば、「*.<自社名>.com」などのようになります。

IBM Connections とのコラボレーション機能を使用している場合は、IBMConnections をインストールした IBM WebSphere プロファイルのホスト名、ドメイン、およびポート番号を追加する必要があります。例えば、IBMConnections をインストールしたコンピューターの名前が「myserver」で、ドメインが「mycompany.com」の場合は、


「myserver.mycompany.com:9080」を追加します。「9080」は、IBMConnections が実行されている IBM WebSphere のポート番号です。

v 一覧に追加する各ホスト名またはドメイン名について、上記の 2 つの手順を繰り返します。


IBM Cognos Application Firewall では、作成される URL を保護するためにホスト名とドメイン名が検証されます。デフォルトでは、環境設定プロパティーから派生するドメイン名が、安全なドメインであるとみなされます。「戻る」または「キャンセル」機能を使用して IBM Cognos 以外のコンピューターに要求を転送する必要がある場合や、別の IBM Cognos 製品のインストール・セットにドリルスルーする場合は、有効な名前とホスト名のリストに名前を追加すると便利です。


7. サービスを再開します。

一時ファイルのプロパティーの暗号化IBM Cognos Analytics では、最近表示したレポートやサービスで処理中に使用されるデータが、一時ファイルに保存されます。一時ファイルの場所は変更できます。また、一時ファイルのコンテンツを暗号化するかどうかも指定できます。

デフォルトでは、IBM Cognos コンポーネントの一時ファイルは"<インストールの場所>¥temp"ディレクトリーに格納されますが、暗号化されません。

セキュリティーを最大限に確保するため、一時ディレクトリーへのアクセスは、IBM Cognos サービスを開始する際に使用するサービス・アカウントを除き、すべて拒否してください。サービス・アカウントには、読み取りと書き込みの権限が必要です。



3. 「プロパティー」ウィンドウの「一時ファイルの場所」プロパティーに、新しい場所を指定します。

4. 一時ファイルの内容を暗号化する場合、「一時ファイルの暗号化」プロパティーを「有効」に設定します。

5. IBM Cognos Analytics コンポーネントを実行するユーザー・アカウントに、一時ファイルの場所に対する適切なアクセス権を設定します。次に例を示します。

v Microsoft Windows オペレーティング・システムの場合: フルコントロール権限

v UNIX または Linux オペレーティング・システムの場合: 読み取り権限と書き込み権限

ネームスペースを使用するためのゲートウェイの設定IBM Cognos コンポーネントで複数のネームスペースが使用される場合や、匿名アクセスが有効で、IBM Cognos コンポーネントで使用されるネームスペースが 1 つ


の場合、1 つのネームスペースに接続するようにゲートウェイを設定できます。ゲートウェイが存在する Web サーバーにユーザーがログオンした場合、認証ソースを選択するプロンプトは表示されません。例えば、Web サーバーが 2 つある場合、各 Web サーバーが別のネームスペースを使用するように設定できます。

手順1. ゲートウェイがインストールされているコンピューターで、IBM Cognos

Configuration を起動します。


3. 「プロパティー」ウィンドウで、「ゲートウェイ・ネームスペース」プロパティーの隣にある「値」ボックスに、使用するネームスペースの ID を入力します。


5. Web サーバーを再始動します。

サービスの有効化と無効化分散インストールの場合、インストールされているサービスの有効/無効を切り替えることにより、特定タイプの要求の送信先を特定のコンピューターに限定できます。

例えば、任意のコンピューターをレポートの実行、配布専用にするには、アプリケーション層コンポーネントのコンピューターで Presentation サービスを無効にします。

注: Content Manager のみがインストールされているコンピューターでは、Dispatcher サービスおよび Presentation サービスのデフォルト値は「無効」です。それ以外のすべてのコンピューターでは、デフォルト値は「有効」です。

すべてのコンポーネントを複数のコンピューターにインストールした場合、各コンピューター上のサービスを適切に選択して無効にすることにより、目的に合った分散設定が可能になります。要求は、指定のサービスが有効になっているディスパッチャーにのみ送信されます。

無効にしたサービスは、メモリーにロードされません。サービスを無効にするとそのサービスは開始されないため、リソースは消費されません。無効にしたサービスは、有効にするまで実行されません。

ディスパッチャー・サービスを無効にすると、ディスパッチャー関連のサービスが無効になります。要求の処理は、有効になっているディスパッチャー・サービスで行われます。

制約事項: サービスを手動で再開する場合は、ApacheDS - cognos サービスを IBMCognos サービスよりも前に開始しておく必要があります (該当する場合)。

サービスの有効化および無効化次の手順に従って、分散インストールのコンポーネントで選択したサービスを無効にします。


手順


2. 「エクスプローラー」ウィンドウの「環境」で、「IBM Cognos サービス」をクリックします。

3. 「プロパティー」ウィンドウで、無効または有効にするサービスの隣にある「値」ボックスをクリックします。

デフォルトでは、すべてのサービスが有効になっています。

4. サービスに対して、必要な状態をクリックします。

v サービスを無にするには、「無効」をクリックします。

v サービスを有効にするには、「有効」をクリックします。

サービスを手動で再開する場合は、ApacheDS - cognos サービスを IBM Cognosサービスよりも前に開始しておく必要があります (該当する場合)。


フォントの設定IBM Cognos 製品は、フォントを使用して IBM Cognos サーバーで PDF レポートを表示します。また、PDF レポートと HTML レポートで使用されているグラフを表示する場合も、フォントが使用されます。

出力結果を正しく表示するには、レポートやグラフを表示する環境にフォントがなければなりません。グラフや PDF レポートの場合、フォントは IBM Cognos サーバーにインストールします。要求されたフォントが使用できない場合、IBM Cognosコンポーネントでは別のフォントが使用されます。

HTML レポートはブラウザーに表示されるので、レポートを表示する各 IBMCognos ユーザーのコンピューターに必要なフォントがインストールされていなければなりません。要求されたフォントを使用できない場合、ブラウザーでは別のフォントが使用されます。

次のチェックリストに従って、新しいフォントをレポートで使用してください。

__ v サポートされるフォントのリストに必要なフォントを追加する

__ v 新しいフォントのファイルが保存されている場所を指定する

__ v 新しいフォントを物理フォント名にマッピングする (必要な場合)

簡体字中国語をサポートするための考慮事項

IBM Cognos 製品では、簡体字中国語のロケールのエンコード方式で使用されるGB18030-2000 文字セットがサポートされています。

Microsoft Windows にインストールすると、Microsoft 社が提供するSimSun-18030 フォントの GB18030-2000 文字セットがサポートされます。

Windows 以外のオペレーティング・システムでは、GB18030-2000 をサポートするフォントをインストールする必要があります。


IBM Cognos 環境へのフォントの追加現在使用できないフォントを使用したレポートを作成する場合、IBM Cognos 環境にあるサポート対象フォントのリストにフォントを追加できます。またフォントを削除することもできます。デフォルトでは、グローバル・フォントのセットが使用されます。グローバル・フォントは、IBM Cognos のすべてのサーバー・コンピューターで使用できるフォントです。

手順

1. 各 Content Manager コンピューターで IBM Cognos Configuration を起動します。

2. 「操作」メニューの「グローバル設定を編集」をクリックします。

3. 「フォント」タブをクリックします。

4. 「追加」をクリックします。

ヒント: サポートされているフォントのリストからフォントを削除するには、フォント名の隣にあるボックスをクリックし、「削除」をクリックします。

5. 「サポートされているフォント名」ボックスで、フォント名を入力し、「OK」をクリックします。


ユーザーが新規に追加したフォントを含むすべてのグローバル・フォントは、使用環境のすべての IBM Cognos コンピューターにインストールされている必要があります。

タスクの結果

グローバル・フォントがすべての IBM Cognos コンピューターにインストールされていない場合は、インストールされている物理フォントにグローバル・フォントをマッピングする必要があります。

使用可能なフォントの場所の指定すべてのフォントのインストール先を指定する必要があります。これらのフォントには、サポートされるフォントのリストにユーザーが追加したフォントも含まれます。

デフォルトで、フォントのリストには、IBM Cognos コンピューターのインストールの場所¥bin¥fonts ディレクトリーにインストールされているフォントが表示されます。ただし、Microsoft Windows オペレーティング・システム・コンピューターに IBM Cognos コンポーネントをインストールした場合、Windows フォント・ディレクトリーにインストールされたフォントも使用されます。

アプリケーション層コンポーネントがインストールされているすべてのコンピューターで、フォントの場所を指定します。

手順

1. 各アプリケーション層コンポーネント・コンピューターで IBM CognosConfiguration を起動します。



3. 「プロパティー」ウィンドウの「物理フォントの場所」プロパティーに、フォントの場所を指定します。

フォント・パスが複数ある場合は、パスをセミコロン (;) で区切ります。

IBM Cognos Analytics に備わっているもの以外のアプリケーション・サーバーを使用している場合、フォントの場所を示す完全修飾パスを入力してください。例: インストールの場所¥bin¥fonts。


サポート対象フォントのインストール済みフォントへのマッピング物理フォントの代わりに、コンピューターにインストールされていないグローバル・フォントを使用できます。

アプリケーション層コンポーネントをインストールした各コンピューターにフォントをマッピングします。

例えば、IBM Cognos コンピューターにインストールされていないフォントを、サポート対象フォントのリストに追加します。ここで、使用する代替フォントを指定できます。

組み込み PDF フォントを使用してレポートの印刷速度を速くするには、次の手順を使用して、Arial などのグローバル・フォントを、Helvetica-PDF などの組み込みPDF フォントにマッピングします。Reporting または Query Studio で、テキスト・オブジェクトに対して組み込み PDF フォントを選択することもできます。詳細については、「Query Studio ユーザー・ガイド」または「Reporting ユーザー・ガイド」を参照してください。

サポート対象フォントのリストに、IBM Cognos コンピューターにインストールされているフォントを追加する場合、マッピングを行う必要はありません。ただし、フォントの場所を指定する必要があります。

手順

1. 各アプリケーション層コンポーネント・コンピューターで IBM CognosConfiguration を起動します。


3. 「プロパティー」ウィンドウで、「物理フォント・マップ」プロパティーの隣

にある「値」ボックスをクリックし、「編集」アイコン


「値」-「物理フォント・マップ」ダイアログ・ボックスが表示されます。


ヒント: フォントを削除するには、そのフォントの隣にあるチェック・ボックスをオンにして「削除」をクリックします。

5. 「グローバル・フォント名」ボックスに、サポート対象フォントのリストに追加したフォントの名前を入力します。

6. 「物理フォント名」ボックスをクリックします。


7. 物理フォント名がわかっている場合は、その名前を入力します。物理フォント

名が不明な場合は、「編集」アイコン


「物理フォント名」ダイアログ・ボックスで「今すぐ検索」をクリックし、検索結果内のフォントをクリックします。

8. マッピングが必要な各グローバル・フォントに対して手順 4～7 を繰り返します。

9. 「OK」をクリックします。


タスクの結果

必要に応じて、フォントのインストール場所を指定します。

IBM Cognos Configuration でのシステム・フォントの使用Microsoft Windows オペレーティング・システムでシステム・フォントを使用するよう IBM Cognos Configuration を設定することができます。

注: システム・フォント設定を有効にする場合、IBM Cognos Configuration 内のフォント設定を変更できません。

手順


2. テキスト・エディターで cogconfig.prefs ファイルを開きます。

3. 次の行を追加します。

UseSystemDisplaySetting=true

4. ファイルを保存して閉じます。

5. IBM Cognos Configuration を再始動します。

PDF レポートのデフォルト・フォントの変更IBM Cognos Analytics コンポーネントで PDF レポートに使用されるデフォルト・フォントを変更できます。レポートを開くと、このデフォルト・フォントで表示されます。

Content Manager がインストールされているコンピューターで、デフォルト・フォントを変更します。そのフォントは Cognos 8 がインストールされているすべてのコンピューターでデフォルト・フォントになります。PDF レポートに使用するフォントを変更するには、IBM Cognos Configuration を使用します。

IBM Cognos 環境のすべてのコンピューターにそのデフォルト・フォントがインストールされていることを確認してください。

PDF レポートで GB18030 文字を適切に表示するには、デフォルト・フォントをSimSun-GB18030 に設定します。


手順1. 各 Content Manager コンピューターで IBM Cognos Configuration を起動し

ます。


3. 「全般」タブをクリックします。

4. 「値」ボックスの「デフォルト・フォント」に、レポートのデフォルトとして使用するフォントを入力します。



7. アプリケーション層コンポーネントのすべてのコンピューターで、デフォルト・フォントのインストール先が「物理フォントの場所」プロパティー (「エクスプローラー」ウィンドウの「環境」の下) で指定されているか、デフォルト・フォントが Windows のフォント・ディレクトリーにあることを確認します。

PDF レポートの埋め込みフォントの設定PDF レポートを Adobe Reader で開く際には、そのレポートで使用されているすべてのフォントにアクセスできる必要があります。フォントは、レポートに埋め込まれているか、ユーザーのコンピューターにインストールされている必要があります。これらのいずれでもフォントが提供されていない場合、Adobe Reader では適当なフォントへの置き換えが試みられます。この置換により、レポートの表示が変わったり、文字の一部が表示されなくなる場合があります。

Adobe Reader で PDF レポートが正しく表示されるように、IBM CognosAnalytics ではレポートに必要なフォントがデフォルトで埋め込まれます。ファイル・サイズを最小限にするために、IBM Cognos Analytics ではフォント・セットのすべての文字を埋め込むのではなく、レポートで使用されている字のみ (グリフともいう) を埋め込みます。IBM Cognos Analytics でフォントが埋め込まれるのは、フォントのライセンスで埋め込みが許可されている場合だけです。ライセンス情報はフォント自体に格納されており、IBM Cognos Analytics によってこの情報が読み取られます。

レポートで使用されているフォントがユーザーのコンピューターで使用可能であることが確実な場合、埋め込みフォントを制限するか削除すれば、PDF レポートのサイズを小さくできます。フォントを制限する場合は、IBM Cognos Configurationの埋め込みフォント・リストを使用して、常に埋め込むフォントや埋め込んではいけないフォントを指定します。

手順1. Content Manager コンピューターで IBM Cognos Configuration を起動しま

す。


3. 「プロパティー」ウィンドウの「フォント設定」で、「埋め込むフォント(Batch Report サービス)」または「埋め込むフォント (Report サービス)」の

値をクリックし、「編集」アイコン



4. デフォルト・フォント・ディレクトリーを使用しない場合や追加ディレクトリーにパスを追加する場合は、「PDF レポートに埋め込むフォント」ダイアログ・ボックスでフォント・パス・ボックスに新しいパスを指定します。

ヒント:指定されたパス (複数指定可) にある使用可能なフォント・リストを取得するには、「今すぐ検索」をクリックします。

5. ユーザーのコンピューターで常に使用可能なフォントの場合、そのフォント名までスクロールし、「常に埋め込まない」チェック・ボックスをクリックします。

IBM Cognos Analytics は、どのレポートにもそのフォントを埋め込みません。Adobe Reader では、レポートを開いたときにユーザーのコンピューターからフォントを取得します。

6. ユーザーのコンピューターで常に使用可能とは限らないフォントの場合、そのフォント名までスクロールし、「常時」チェック・ボックスをクリックします。

IBM Cognos Analytics は、そのフォントを使用するすべてのレポートで、そのフォントを埋め込みます。レポートを開くと、Adobe Reader では埋め込まれたフォントが使用されます。


出力レポートの保存デフォルトでは、出力レポート・ファイルは Content Store に保存されます。また、出力レポートのコピーを別の場所に保存することもできます。保存先は IBMCognos Analytics の外部でも内部でもかまいません。別の場所に保存した場合は、_descr 拡張子を持つ記述ファイルも保存されます。保存されたファイルは、IBMCognos Analytics では管理されません。

IBM Cognos Analytics の外部への出力レポートの保存IBM Cognos Analytics の外部に存在するファイル・システムの場所を設定すると、外部アプリケーションや IBM Cognos Analytics を所有していないユーザーと出力レポートを共有することができます。ほとんどの出力レポート・ファイルは、このように保存されます。

この機能を使用するには、まず IBM Cognos Configuration でルート・ディレクトリーを設定する必要があります。その後、IBM Cognos Administration でファイルの場所を設定する必要があります。詳細については、「IBM Cognos Analytics 管理およびセキュリティー・ガイド」の、IBM Cognos Analytics の外部に保存される出力レポートのファイル格納場所の設定に関するトピックを参照してください。

レポート出力は、常に各 Delivery サービス・インスタンス用に構成されたディレクトリーに書き込まれます。レポート出力が複数のロケーションに書き込まれるのを防ぐには、Delivery サービスのインスタンスを 1 つのみ実行するようにするか、すべてのサービス・インスタンスが共有ネットワークのファイル・ロケーションを使用するように構成します。 Delivery サービスを実行しているすべてのディスパッチャーは、ファイル・システムへのアクセス権限を保持するか、レポート出力の保存先としないすべてのシステムへのアクセス権限を無効にする必要があります。


手順

1. ファイル・システムでディレクトリーを作成します。

ヒント:このディレクトリーは、ユーザーがアクセス可能でなければならず、かつインストール・ディレクトリーとは別の場所でなければなりません。例えば、Microsoft Windows の分散インストール環境では、"¥¥ サーバー名>¥<ディレクトリー>"などのアーカイブ・フォルダーを使用できます。

2. Content Manager コンピューターで IBM Cognos Configuration を起動します。


4. 「グローバル設定」ウィンドウで、「全般」タブをクリックします。

5. 「アーカイブ・ファイル・システムのルートの場所」に、次の形式で URI を入力します。

file://<ディレクトリー>

"<ディレクトリー>"は、手順 1 で作成したディレクトリーです。

URI の"file://"の部分は必須です。¥¥servername¥directory などの WindowsUNC 名を使用できますが、この場合には URI を次の形式にする必要があります。

file://¥¥<サーバー名>¥<ディレクトリー>

ヒント: Cognos を Microsoft Windows のサービスとして実行する場合は、マップされたドライブを使用しないでください。

6. 正しい場所が使用されるようになっているかを確認するには、「テスト」をクリックします。



タスクの結果

管理者はファイルの格納場所を設定する必要があります。詳細については、「IBMCognos Analytics 管理およびセキュリティー・ガイド」の、IBM Cognos Analyticsの外部に保存される出力レポートのファイル格納場所の設定に関するトピックを参照してください。

IBM Cognos Analytics の内部への出力レポートの保存IBM Cognos Analytics の内部に存在するファイル・システムの場所を設定すると、出力レポートを再利用できます。Content Store に保存されたファイルは、保存規則によって定期的に削除される可能性があるため、アーカイブ目的としてもこの方法は有効です。

この機能を使用するには、まず「出力レポートをファイル・システムに保存しますか。」プロパティーを有効にする必要があります。その後、IBM CognosAdministration で"CM.OutPutLocation"パラメーターを使用して、ファイルの場所を設定する必要があります。詳細については、「IBM Cognos Analytics 管理および


セキュリティー・ガイド」の、IBM Cognos Analytics の内部に保存される出力レポートのファイル格納場所の設定に関するトピックを参照してください。

レポート出力は、常に各 Delivery サービス・インスタンス用に構成されたディレクトリーに書き込まれます。レポート出力が複数のロケーションに書き込まれるのを防ぐには、Delivery サービスのインスタンスを 1 つのみ実行するようにするか、すべてのサービス・インスタンスが共有ネットワークのファイル・ロケーションを使用するように構成します。 Delivery サービスを実行しているすべてのディスパッチャーは、ファイル・システムへのアクセス権限を保持するか、レポート出力の保存先としないすべてのシステムへのアクセス権限を無効にする必要があります。

この機能を使用する際に、出力レポートの安全性が保護されるように、ファイル・システムにサード・パーティーの暗号が組み込まれている必要があります。

手順

1. ファイル・システムでディレクトリーを作成します。

ヒント: 認証されたユーザーのみがディレクトリーにアクセスできるようにします。

2. Content Manager コンピューターで IBM Cognos Configuration を起動します。

3. 「エクスプローラー」ウィンドウで、「データ・アクセス」>「ContentManager」をクリックします。

4. 「出力レポートをファイル・システムに保存しますか。」プロパティーで、「有効」をクリックします。

5. 出力レポート・ディレクトリーへの接続をテストするには、「操作」メニューの「テスト」をクリックします。


タスクの結果

管理者は CM.OutPutLocation パラメーターを使用して、ファイルの格納場所を設定する必要があります。詳細については、「IBM Cognos Analytics 管理およびセキュリティー・ガイド」の、IBM Cognos Analytics の内部に保存される出力レポートのファイル格納場所の設定に関するトピックを参照してください。

一時レポートの出力場所の変更ユーザーが双方向レポートを実行すると、出力レポートが Content Manager またはローカル・レポート・ファイル・システムの一時セッション・キャッシュに保存されます。この一時セッション・キャッシュの場所は、Microsoft Windows ベース・システムの共有ディレクトリー、または UNIX や Linux ベース・システムの共通マウント・ディレクトリーなどのリモート・コンピューターに変更できます。

デフォルトでは、レポート・ファイル・システムの一時セッション・キャッシュの場所は、install_location/temp/session です。 session ディレクトリーは、ユーザー・セッションから最初の要求を受信したときに、レポート・サーバーによって作成されます。


手順1. アプリケーション層コンポーネントがインストールされているコンピューター

で、IBM Cognos Configuration を開始します。


3. 「プロパティー」ウィンドウで、「一時ファイルの場所」の値をクリックし、

「編集」アイコン


4. 「フォルダーの選択」ダイアログ・ボックスで、「保存先」ボックスを使用してコンピューターとディレクトリーを参照し、「選択」をクリックします。


ユーザーが双方向のレポート・セッションを実行したときに、一時出力レポートが新しい場所に保存されるようになりました。

Reporting で使用する既存の Map Manager 地図の場所の変更IBM Cognos Analytics には、Reporting で使用できるサンプルの地図グラフが用意されています。この地図グラフの場所は、IBM Cognos Configuration で変更できます。

注: この情報は、レポートで使用可能な既存の Map Manager 地図にのみ適用されます。

デフォルトでは、これらの地図グラフは、アプリケーション層コンポーネント・コンピューターの <インストール場所>/maps ディレクトリーにあります。

地図グラフの使用方法の詳細については、「Reporting ユーザー・ガイド」を参照してください。

他のカスタム地図の使用方法については、「Map Manager Installation and UserGuide」を参照してください。

手順1. アプリケーション層コンポーネント・コンピューターで IBM Cognos



3. 「プロパティー」ウィンドウで、「地図ファイルの場所」の値をクリックします。

4. 「編集」ボタンをクリックします。

5. 「フォルダーの選択」ウィンドウで、目的のディレクトリーに移動して「選択」をクリックします。



WebSphere Liberty Profile の調整実稼働環境で、並行ユーザーの最大数が希望どおりになるよう WebSphere LibertyProfile を調整するには、リソースの詳細プロパティー内の coreThreads 値とmaxThreads 値を調整します。これらの値は、実行プログラムのスレッドのコア数と最大数を設定します。


2. 「エクスプローラー」ウィンドウの「環境」の「IBM Cognos サービス」で、リソース名 (デフォルトは「IBM Cognos」) をクリックします。

3. 「プロパティー」ウィンドウで、「詳細プロパティー」の隣にある「値」ボック

ス内をクリックし、「編集」アイコン


4. 必要に応じてパラメーター値を調整します。

表 22. サービス・リソースのパラメーターの名前および値

パラメーター名値

coreThreads WebSphere Liberty Profile サーバーの始動時のスレッドのコア数。この値を 0 より小さくすると、デフォルト値が使用されます。このデフォルト値は、システム上のハードウェア・スレッドの数に基づいて計算されます。

maxThreads WebSphere Liberty Profile サーバーに関連付けることができるスレッドの最大数。

詳しくは、WebSphere Liberty Profile Knowledge Center の Liberty プロファイルの調整 (http://www.ibm.com/support/knowledgecenter/?lang=en#!/SSEQTP_8.5.5/com.ibm.websphere.wlp.doc/ae/twlp_tun.html?cp=SSEQTP_8.5.5%2F1-3-11-0-7) を参照してください。


待機中の Content Manager サービス用のセッション複製の有効化セッション複製機能を使用すると、アクティブな Content Manager サービスと待機中の Content Manager サービスの間のシームレスな IBM Cognos ContentManager フェイルオーバーが可能になります。

セッション複製を有効な状態にすると、すべての Content Manager インスタンス間でユーザー・セッション・データが複製されます。アクティブな ContentManager で障害が発生しても、ユーザー・セッション・データが保持されるので、ユーザーは作業を中断することなくアプリケーションを継続して使用できます。

セッション複製では、1 つの環境内で構成されている複数の IBM Cognos ContentManager 間の通信を保護するために、2 つのポートが使用されます。

手順1. IBM Cognos Content Manager がインストールされているコンピューターで、

IBM Cognos Configuration を起動します。


http://www.ibm.com/support/knowledgecenter/?lang=en#!/SSEQTP_8.5.5/com.ibm.websphere.wlp.doc/ae/twlp_tun.html?cp=SSEQTP_8.5.5%2F1-3-11-0-7

http://www.ibm.com/support/knowledgecenter/?lang=en#!/SSEQTP_8.5.5/com.ibm.websphere.wlp.doc/ae/twlp_tun.html?cp=SSEQTP_8.5.5%2F1-3-11-0-7

2. 「エクスプローラー」ペインの「セキュリティー」で、「複製」をクリックします。

3. 次のプロパティーを指定します。

a. 「複製の有効化」を True に設定します。

b. 「ピア・リスナー・ポート番号」値ボックスに、ポート番号を入力します。

値を 0 にした場合、IBM Cognos サービス始動時に最初に使用可能になる動的ポートが選択されます。

c. 「RMI 複製ポート番号」値ボックスに、ポート番号を入力します。

注: 「詳細プロパティー」は、IBM 技術サポートの指示があった場合にのみ使用します。

4. 構成を保存して、IBM Cognos サービスを再開します。

5. 環境内のそれぞれの Content Manager インスタンスに関して各ステップを繰り返します。

指定するポート番号が、Content Manage インスタンスごとに同一である必要はありません。

レポート出力およびデータ・セットに外部オブジェクト・ストアを使用するContent Manager を設定して、外部オブジェクト・ストアを定義することによりレポート出力およびデータ・セットをローカル・ドライブまたはネットワーク共有に格納できます。レポート出力はポータルおよび IBM Cognos SDK を介して使用可能ですが、レポート出力は Content Store データベースに格納されません。

レポート出力に外部オブジェクト・ストアを使用すると、Content Store のサイズが削減され、Content Manager のパフォーマンスが向上します。

始める前に

外部オブジェクト・ストアの接続を作成する前に、以下を必ず実行してください。

v Content Manager コンピューターに外部オブジェクト・ストアのファイルの場所へのアクセス権を付与する。

v IBM Cognos サービスを実行するユーザー・アカウントにファイルの場所の読み取り権限および書き込み権限を付与する。

v Content Store を作成する


2. 「エクスプローラー」ウィンドウの「データ・アクセス」 > 「ContentManager」で、Content Store の名前を右クリックして、「リソースの新規作成」 > 「外部オブジェクト・ストア」をクリックします。

3. 「リソースの新規作成 - 外部オブジェクト・ストア」ウィンドウで、ファイル・システム・リポジトリーの一意の名前を入力し、「OK」をクリックします。

外部オブジェクト・ストアは 1 つのみ作成できます。


4. リポジトリーの名前をクリックします。

5. 「外部オブジェクト・ストア - リソース・プロパティー」ウィンドウで、値フィールドの内側をクリックして編集をクリックすると、「URI 値」ウィンドウが開くので、ファイル・システムの場所のパスを入力します。ここで、file-system-path は既存のファイルの場所の絶対パスです。

表 23. URI 値の例

ファイル・システム URI 値

Windows file:///c:/file-system-path

file://host/share/file-system-path

UNIX または Linux file:///file-system-path

注: 相対パス (file:///../file-system-path など) およびドライブ・マッピングはサポートされません。

分散インストール環境では、すべての Content Manager にファイル・システムの場所の読み取り権限と書き込み権限が付与されている必要があります。出力の読み取りパフォーマンスを向上させるため、アプリケーション層コンポーネント(基本的にはリポジトリー・サービス) にファイル・システムの場所の読み取り権限が付与されている必要があります。読み取り権限が付与されていない場合、要求はアクティブ Content Manager に経路指定されます。

6. IBM Cognos サービスを再開します。

外部オブジェクト・ストアへのアクセスの検証IBM Cognos Configuration を使用して、IBM Cognos コンポーネントから外部オブジェクト・ストアに接続できることを検証します。


2. 「エクスプローラー」 > 「データ・アクセス」から、外部オブジェクト・ストア接続の名前を右クリックします。

3. 「テスト」をクリックします。

IBM Cognos Configuration によって外部オブジェクト・ストアのファイルの場所へのアクセスが検証されます。

また、「ローカル設定」を右クリックして「テスト」を選択することによってもこの接続をテストできます。

UNIX および Linux プラットフォーム用のサーバー側印刷のカスタマイズIBM Cognos Analytics ポータルでのサーバー印刷の処理方法は、プラットフォームによって異なる場合があります。

このため、ポータルでの UNIX および Linux プラットフォームの PDF 形式レポートの印刷の処理方法は、"rsprintpdf.sh"ファイルを設定してカスタマイズできます。


rsprintpdf.sh ファイルは、Microsoft Windows オペレーティング・システムのプリント・サーバーに対しては設定できません。

ユーザーが「オプションを指定して実行」を選択し、「形式」を PDF に変更し、「配信」セクションから「レポートを印刷」を選択した後、「詳細オプション」を使用して、横向きの印刷、A4 用紙サイズ、またはレポートを実行する「時刻とモード」などの追加形式を指定した場合は、UNIX または Linux 印刷サーバーへの印刷時に問題が発生する場合があります。出力が生成されない場合や、一部が印刷されない、または正しい向きで印刷されない場合などがあります。

手順1. install_location/bin directory にある rsprintpdf.sh ファイルを開きます。

2. テキスト・エディターで、印刷サーバーのプラットフォーム (AIX、Linux など)に固有のセクションをカスタマイズします。

3. カスタマイズには次の情報を使用します。この情報は、サーバー・プロセスによって、コマンド行オプションとして"rsprintpdf.sh"スクリプトに渡されます。

表 24. PDF 形式レポートの印刷のためのカスタマイズ・オプション

オプション名前説明

-p プリンター印刷キューを指定する。印刷キューを指定しない場合は、デフォルトのキューが使用されます。

-o 印刷の向きファイルに対するページの印刷の向き (例: 横または縦)を指定する。印刷の向きを指定しない場合は、縦の印刷の向きが使用されます。

-m 用紙出力の用紙サイズ (例:レター・サイズ、A4 用紙サイズ)を指定する。用紙を指定しない場合や、高さまたは幅を指定しない場合は、デフォルトの用紙トレイが使用されます。

-h 高さカスタム・ページ・サイズの指定に使用。ページの高さをポイントで指定します。-w オプションとともに指定し、-m オプションを指定しない場合のみ有効です。

-w 幅カスタム・ページ・サイズの指定に使用。ページの幅をポイントで指定します。-h オプションとともに指定し、-m オプションを指定しない場合のみ有効です。

-L ログ・ファイルエラー・メッセージのログを記録するユーザー指定ファイルへのパスを指定する。ログ・ファイルのデフォルトのファイル名は、"rsprintpdf.errors.log"です。

4. ヒント:今後のソフトウェア・アップグレードによる上書きに備えて、"rsprintpdf.sh" ファイルのコピーを作成しておいてください。

通知データベースの変更デフォルトでは、通知サーバーによって使用されるデータベースは、ContentManager で Content Store として使用されるデータベースと同じです。大量のBatch Report や E メールを実行する場合、通知データベースは別のものを使用することもできます。

通知用のデータベースを別に用意する場合に必要となるタスク


v 通知データベースの作成。

IBM Db2、Oracle、Microsoft SQL Server の場合は、Content Store データベースを作成するのと同じ手順を使用します。 8 ページの『Content Store を作成する際のガイドライン』の手順を使用してください。

注: Db2 を使用している場合、Content Store の場合と同じ方法で通知データベースを作成するスクリプトを生成することはできません。

z/OS で Db2 を使用する場合は、『z/OS 上の IBM Db2 で通知データベースを作成するための推奨設定』の手順を使用します。

v データベース接続の設定。

Content Store データベース用の接続を設定したときと同じ手順 73 ページの『Content Store データベース用のデータベース接続の設定』を使用します。

v 通知データベースの接続プロパティーの変更。

201 ページの『通知データベースの接続プロパティーの変更』の手順を使用してください。

z/OS 上の IBM Db2 で通知データベースを作成するための推奨設定

通知データベースとして作成するデータベースには、指定の設定が含まれていなければなりません。

正常にインストールするには、次のガイドラインに従って通知データベースを作成してください。

次のチェックリストに従って、z/OS 上の Db2 で通知データベースをセットアップしてください。

__ v 通知データベース用のデータベース・インスタンス、ストレージ・グループ、およびユーザー・アカウントを作成します。

ユーザーは、データベース内のテーブルを作成および削除する権限を持っている必要があります。

IBM Cognos Analytics では、ユーザー・アカウントの資格情報を使用してデータベース・サーバーと通信します。

__ v 32K のページ・サイズでバッファー・プールを確保し、データベース・インスタンス用に 4K のページ・サイズでバッファー・プールをもう 1 つ確保します。

__ v 管理者は、大きいオブジェクトおよびその他のデータを保持するための表スペースを通知データベース用に作成するスクリプトを実行し、表スペースを使用できるようにする必要があります。

スクリプトの実行については 200 ページの『IBM Db2 for z/OS 上の通知データベース用の表スペースの作成』を参照してください。


__ v IBM Cognos Analytics データベースには IBM Cognos データが含まれているため、データベース管理者は定期的にバックアップを取る必要があります。

データベースのセキュリティーおよび整合性を確保するために、承認されていない不正なアクセスからデータベースを保護します。

IBM Db2 for z/OS 上の通知データベース用の表スペースの作成Db2 for z/OS を使用している場合、データベース管理者はスクリプトを実行して、通知データベースに必要な表スペースのセットを作成する必要があります。実行するスクリプトは、プレースホルダー・パラメーターが環境に適したものとなるように変更しておく必要があります。

必ず Db2 for z/OS 用の命名規則を使用してください。例えば、パラメーター名はすべて文字で始まり、6 文字以下でなければなりません。詳しくは、Db2Knowledge Center を参照してください。

手順1. 表スペースの作成と削除の権限、および SQL 文の実行を許可する権限のあるユ

ーザーとしてデータベースに接続します。

2. 通知の表スペースを作成するには、<インストールの場所>/configuration/

schemas/delivery/zosdb2 ディレクトリーに移動します。

a. NC_TABLESPACES.sql スクリプト・ファイルのバックアップ・コピーを作成して、そのファイルを別の場所に保存します。

b. 元の NC_TABLESPACES.sql スクリプト・ファイルを開き、以下の表を参考にしながら、プレースホルダー・パラメーターをご使用の環境に適した値に置き換えます。

表 25. z/OS 上の Db2 通知データベース用の表スペースのパラメーター名と説明


NCCOG 通知データベースの名前を指定します。


BP32K バッファー・プールの名前を指定します。




db2 -tvf NC_TABLESPACES.sql

d. NC_CREATE_DB2.sql スクリプト・ファイルを開き、NCCOG プレースホルダー・パラメーターを通知データベース名に置き換えます。

e. スクリプトを保存します。

Job サービスと Scheduling Monitor サービスでスクリプトが自動的に実行されます。スクリプトを自分で実行するように選択することも可能です。


通知データベースの接続プロパティーの変更通知用のデータベースを別に作成したら、そのデータベースを使用するように IBMCognos コンポーネントを設定する必要があります。

同じ通知データベースを使用するように、すべての Content Manager とアプリケーション層コンポーネントを設定する必要があります。

手順1. Content Manager またはアプリケーション層コンポーネントがインストールさ

れているそれぞれの場所で IBM Cognos Configuration を起動します。

2. 「エクスプローラー」ウィンドウの「データ・アクセス」で、「通知」をクリックします。

3. 通知用として使用するデータベースを指定します。

v 「エクスプローラー」ウィンドウで「通知」を右クリックし、「リソースの新規作成」>「データベース」を選択します。

v データベース・リソースの名前を入力します。

v プルダウン・メニューからデータベースのタイプを選択します。


4. 「プロパティー」ウィンドウで、通知データベース・リソースの値を入力します。


6. 通知をテストします。「エクスプローラー」ウィンドウの「通知」を右クリックし、「テスト」をクリックします。

データベースの接続とメール・サーバーの接続がテストされます。

Content Store データベースを通知に使用していた場合は、新しい通知データベースのテーブルにスケジュールが複製されます。

タスクの結果

通知データベース・リソースを識別するために使用する値が、すべての ContentManager コンピューターおよびアプリケーション層コンポーネント・コンピューターで同じになるようにします。デフォルトの通知データベースを使用する場合は、「プロパティー」ウィンドウの値を編集する必要はありません。

IBM Cognos トラストストアのセキュリティー標準への準拠の変更デフォルトでは、SSL 通信に使用される IBM Cognos のトラストストアには、NIST SP800-131a 標準に適合した証明書のみが含まれます。ThirdPartyCertificateTool を使用して、使用できる証明書を変更できます。

NIST SP800-131a 以外の標準を追加し、追加した NIST SP800-131a 以外の標準を削除することもできます。


IBM Cognos トラストストアへの NIST SP800-131a 非標準証明書の復元

デフォルトでは、IBM Cognos トラストストアには NIST SP800-131a 標準に適合する認証局 (CA) 証明書のみが含まれています。その他の証明書 (SHA1 や 1024ビット CA 証明書など) を使用する場合、これらの証明書を個別にトラストストアに追加する必要があります。または、使用している JRE のトラストストアからThirdPartyCertificateTool 復元コマンドでこれらの証明書を追加します。

ヒント: このトピックの例では、デフォルトのパスワード NoPassWordSet を使用しています。 IBM Cognos Configuration で「鍵ストアのパスワード」、および「認証局設定」のパスワードを変更する場合は、設定したパスワードを使用してください。

始める前に

UNIX または Linux オペレーティング・システムでは、ThirdPartyCertificateTool を使用する前に、JAVA_HOME 環境変数を設定する必要があります。

Microsoft Windows インストール環境では、-java:local 付きでツールを実行すると、インストールで提供されている JRE を使用できます。例えば、次のようになります。

ThirdPartyCertificateTool.bat -java:local -R

手順1. install_location/bin ディレクトリーに移動します。

2. 以下のコマンドを入力して、NIST SP800-131a 非標準証明書を復元します。


ThirdPartyCertificateTool.sh -R -p NoPassWordSet


ThirdPartyCertificateTool.bat -R -p NoPassWordSet

IBM Cognos トラストストアからの NIST SP800-131a 非標準証明書の削除

NIST SP800-131a 非標準の証明書 (SHA1 や 1024 ビット CA 証明書など) をIBM Cognos トラストストアに追加している場合、ThirdPartyCertificateTool を使用してこれらの証明書を削除できます。



始める前に



ThirdPartyCertificateTool.bat -java:local -N

手順1. install_location/bin ディレクトリーに移動します。



ThirdPartyCertificateTool.sh -N -p NoPassWordSet


ThirdPartyCertificateTool.bat -N -p NoPassWordSet

別の認証局を使用するための IBM Cognos コンポーネントの設定IBM Cognos Analytics コンポーネントでは、IBM Cognos セキュリティー・インフラストラクチャーにおける信頼性の基盤として、専用の認証局 (CertificateAuthority) がデフォルトで使用されます。ただし、 iPlanet や Microsoft など、別の認証局からの証明書を使用するように IBM Cognos コンポーネントを設定することもできます。

別の CA 証明書を使用するには、次のプロセスに従う必要があります。

1. 205 ページの『証明書署名要求 (CSR) ファイルの作成』.

このタスクの一部では、CSR を認証局に送信して、証明書を生成するように要求されます。そのプロセスの詳細については、CA の資料を参照してください。

2. 207 ページの『IBM Cognos コンポーネントへの CA 証明書のインポート』

3. 208 ページの『CA によって生成された証明書を使用するように IBM Cognosコンポーネントを設定する』.

ThirdPartyCertificateTool コマンドと例タスクのいくつかは、ThirdPartyCertificateTool という名前のコマンド行ツールを使用します。次の表には、このコマンド行ツールのオプションがリストされています。


ThirdPartyCertificateTool コマンド

表 26. 主要な処理モード

コマンド説明

-c 証明書署名要求 (CSR) を作成します。

-i 証明書をインポートします。

-E 証明書をエクスポートします。

表 27. 処理修飾子

コマンド説明

-e 暗号 ID を処理します。

-T トラストストアを処理します (-i および -E を使用する場合のみ)。

表 28. 情報フラグ

コマンド説明

-d 証明書に使用する識別名 (DN)。

-r CSR または証明書ファイルの場所 (モードに依存します)。

-t 認証局チェーン・ファイル。 PEM、バイナリー PKCS#7CA 証明書チェーン、または単一 DER 形式の CA 証明書が可能です。

-p 鍵ストアのパスワード。 -p が含まれていない場合、NoPassWordSet がデフォルト・パスワードとして使用されます。

-a 鍵ペアのアルゴリズム: RSA。RSA がデフォルト値です。

-P 現在の JRE によって信頼される認証局が含まれる CA 鍵ストアを作成します。

-N NIST SP800-131a 標準を使用するように CA トラストストアを設定します。

-R 非 NIST SP800-131a 証明書をトラストストアに復元します。

次の表に示すサンプル値を使用します。

表 29. サンプル値

プロパティー値

暗号化証明書 DN 固有値。形式は次のとおりです。

CN=EncryptCert,O=MyCompany,C=CA

鍵ストアのパスワードデフォルト・パスワード: NoPassWordSet

この値は、IBM Cognos Configuration の「セキュリティー」 > 「暗号化」 > 「Cognos」のパスワードと一致している必要があります。「署名鍵ストアのパスワード」、「暗号化鍵ストアのパスワード」、および「認証局鍵ストアのパスワード」のデフォルト値を変更する場合は、設定したパスワードを使用してください。


ThirdPartyCertificateTool の例

表 30. ThirdPartyCertificateTool の例

例コマンド

新しい暗号鍵ペアおよび PKCS#10CSR を作成する。

ThirdPartyCertificateTool.bat -c -e -d

cn=Me,o=MyCompany,c=CA -r crypto.csr -a

RSA -p password

サード・パーティー CA によって生成された暗号証明書およびPKCS#7 CA 証明書チェーンをインポートする。

ThirdPartyCertificateTool.bat -i -e -r

crypto.cer -p password -t cacert.p7b

サード・パーティー CA によって生成された暗号証明書および PEMCA 証明書チェーンをインポートする。

ThirdPartyCertificateTool.bat -i -e -r

crypto.cer -p password -t cacert.pem

信頼された証明書として ca.cer を追加する。

ThirdPartyCertificateTool.bat -i -T -r

ca.cer -p password -t cacert.cer

暗号証明書を crypto.cer にエクスポートする。

ThirdPartyCertificateTool.bat -E -e -r

crypto.cer -p password

IBM Cognos CA 証明書を ca.cerにエクスポートする (サード・パーティー CA を使用しない場合)。

ThirdPartyCertificateTool.bat -E -T -r

ca.cer -p password

すべての非 NIST SP800-131a CA証明書を削除し、CA トラストストアを NIST SP800-131a 標準に設定する。

ThirdPartyCertificateTool.bat -N -p password

JRE 非 NIST SP800-131a 証明書をCA トラストストアに復元する。

ThirdPartyCertificateTool.bat -R -p password

証明書署名要求 (CSR) ファイルの作成認証局 (CA) から証明書を入手するには、まず暗号鍵の証明書署名要求 (CSR) ファイルを IBM Cognos 鍵ストアから生成する必要があります。 CA はこのファイルを使用して、暗号証明書と、鍵ストアにインポートする CA 証明書を生成します。


始める前に




ThirdPartyCertificateTool.bat -java:local -c -d ...

手順1. 鍵データをバックアップします。

a. <インストールの場所>¥configuration ディレクトリーに移動します。

b. cogstartup.xml ファイルを保護された場所にバックアップします。

c. 次のディレクトリーの内容のバックアップを保護された場所に作成します。install_location¥configuration¥certs

2. install_location¥bin ディレクトリーに移動します。

3. 次のコマンドを入力して暗号鍵の証明書署名要求を作成します。

UNIX または Linux の場合は、次のように入力します。

ThirdPartyCertificateTool.sh -c -e -d "CN=EncryptCert,O=MyCompany,C=CA"-r encryptRequest.csr -p NoPassWordSet

Windows の場合は、次のように入力します。

ThirdPartyCertificateTool.bat -c -e -d "CN=EncryptCert,O=MyCompany,C=CA"-r encryptRequest.csr -p NoPassWordSet

コマンドの識別名 (DN) の値 ("CN=SignCert,O=MyCompany,C=CA") は、IBMCognos のインストール環境を一意的に特定します。使用する属性は、組織の階層構造を反映します。

この鍵に対して入力するパスワードは、証明書をインポートする際に再び使用し、IBM Cognos Configuration でも再び使用する必要があります。

ログ記録に関する警告は無視しても支障ありません。

このコマンドを実行すると、certs ディレクトリーへの CAMKeystore ファイルの作成、指定したパスワードの設定、鍵ペアの作成と鍵ストアへの保存、install_location¥bin ディレクトリーへの encryptRequest.csr ファイルのエクスポートが行われます。

4. encryptRequest.csr ファイルを、認証局がアクセスできるディレクトリーにコピーします。

5. encryptRequest.csr ファイルを認証局に入力し、証明書を生成します。

認証局は、暗号鍵の証明書と CA 証明書を生成します。

重要: CA によって生成される証明書は、PEM (Base-64 エンコード ASCII) 形式であることが必要です。

タスクの結果

これで、生成された証明書を IBM Cognos コンポーネントにインポートできるようになりました。


IBM Cognos コンポーネントへの CA 証明書のインポートCA から証明書を入手した後に、それらを IBM Cognos コンポーネントにインポートしなければなりません。

Content Manager、アプリケーション層コンポーネント、ゲートウェイ、モデル作成コンポーネントなど、IBM Cognos コンポーネントをインストールした各コンピューターに証明書をインポートする必要があります。


始める前に



ThirdPartyCertificateTool.bat -java:local -c -d ...

手順1. 暗号証明書のコピーを作成して、それに encryptCertificate.cer という名前を

付けます。

2. ルート CA 証明書のコピーを作成して、それに ca.cer という名前を付けます。

3. encryptCertificate.cer および ca.cer ファイルを <インストールの場所>/bin

ディレクトリーにコピーします。

4. 次のコマンドを入力して、暗号証明書を IBM Cognos 暗号化鍵ストアにインポートします。


ThirdPartyCertificateTool.sh -i -e -r encryptCertificate.cer -p

NoPassWordSet -t ca.cer


ThirdPartyCertificateTool.bat -i -e -r encryptCertificate.cer -p

NoPassWordSet -t ca.cer

重要: 直前のタスクで暗号化鍵をエクスポートする際に入力したパスワードを使用してください。

ログ記録に関する警告は無視しても支障ありません。


このコマンドを実行すると、指定されたパスワードを使用してinstall_location¥bin ディレクトリーの encryptCertificate.cer ファイルとca.cer ファイルが読み取られ、両方のファイルから certs ディレクトリーのCAMKeystore ファイルへ、証明書がインポートされます。

5. 次のコマンドを入力して、CA 証明書を IBM Cognos トラストストアにインポートします。


ThirdPartyCertificateTool.sh -i -T -r ca.cer -p NoPassWordSet


ThirdPartyCertificateTool.bat -i -T -r ca.cer -p NoPassWordSet

このコマンドを実行すると、指定されたパスワードを使用して ca.cer ファイルが読み取られ、その内容が certs ディレクトリーの CAMKeystore ファイルにインポートされます。

タスクの結果

これで、CA 証明書を使用するように IBM Cognos コンポーネントを設定できます。

CA によって生成された証明書を使用するように IBM Cognos コンポーネントを設定する

CA 証明書をインポートした後、IBM Cognos コンポーネントがインストールされている各コンピューターが証明書を使用するよう、IBM Cognos Configuration を使用して設定します。

注: IBM Cognos Configuration の鍵ストアの場所とパスワードが、コマンド行ツールで入力したものと一致しているか確認してください。例えば、IBM CognosConfiguration で「暗号化鍵ストアのパスワード」、および「認証局鍵ストアのパスワード」を変更する場合は、設定したパスワードを使用してください。


2. 「エクスプローラー」ウィンドウの「セキュリティー」 > 「暗号化」で、「Cognos」をクリックします。

3. 「サード・パーティーの CA を使用」の隣にある「値」ボックスをクリックして、「True」を選択します。

このプロパティーを有効に設定すると、認証局と ID 名に関するプロパティーはすべて無視されます。

4. 暗号鍵に使用したパスワードを「暗号化鍵ストアのパスワード」に入力し、「暗号化鍵ストアの場所」のパスを入力します。直前のタスクの例と同じ値を使用した場合、パスを変更する必要はありません。

5. 「認証局鍵ストアのパスワード」を入力します。



7. IBM Cognos サービスを再始動します。

IBM Cognos コンポーネントの SSL プロトコルの設定Secure Sockets Layer (SSL) プロトコルは、単一サーバー内の、および分散インストール環境の IBM Cognos コンポーネント同士の通信に使用できます。

IBM WebSphere Liberty Profile コネクター

内部ディスパッチャー URI が「http」で始まり、外部ディスパッチャー URI が「https」で始まる場合 (またはその逆の場合)、server.xml ファイルでは非 SSLLiberty HTTP/1.1 と SSL Liberty HTTP/1.1 の両方のコネクターが有効になります。

内部および外部ディスパッチャー URI で別のプロトコルやポートを使用する場合、内部ディスパッチャーのポートからはローカル・コンピューターのコンポーネントのみにアクセスできます。内部ディスパッチャー URI でも"localhost"を指定する必要があります。

1 台のコンピューターへのインストール

1 台のコンピューターにインストールした場合に、現在 SSL を使用していなければ、プロトコルを HTTPS に変更する前にサービスを停止する必要があります。SSL の設定を保存した後、サービスを再開できます。

分散インストール

分散インストール環境では、アプリケーション層コンポーネントおよびゲートウェイ・コンポーネントが SSL を使用するように構成する前に、まずデフォルトのアクティブな Content Manager コンピューターが SSL プロトコルを使用してそのコンピューター上のサービスを開始するように構成する必要があります。

分散インストール環境へのコンピューターの追加

コンピューターを SSL が有効な環境に追加すると、設定の保存時に証明書を一時的に信頼するように求めるメッセージが表示されます。一時証明書を受け入れることで、既存のコンポーネントとの永続トラストを確立できます。

コンピューターへのコンポーネントの追加

SSL を使用するように既に構成されているインストール環境にコンポーネントを追加する場合は、既存のコンポーネントから SSL 証明書へのトラストが継承されます。同じコンピューターの別の場所、ただし SSL を使用するように既に構成されている環境にコンポーネントを追加すると、設定の保存時に証明書を一時的に信頼するように求めるプロンプトが表示されます。一時証明書を受け入れることで、既存のコンポーネントとの永続トラストを確立できます。

IBM Cognos コンポーネント用の SSL の設定IBM Cognos コンポーネントでは、内部接続、外部接続、またはその両方で SSLを使用できます。


SSL を内部接続のみに設定すると、ローカル・コンピューターの IBM Cognos コンポーネントではこの SSL プロトコルが通信に使用されます。ディスパッチャーは、リモートの HTTP 要求を行うポート以外のポートで安全な接続を待機します。そのため、2 つのディスパッチャー URI を設定する必要があります。

SSL を外部接続のみに設定すると、リモートの IBM Cognos コンポーネントからローカル・コンピューターへの通信に SSL プロトコルが使用されます。ディスパッチャーが、ローカルの HTTP 要求が行われるポート以外のポートで安全なリモート要求を待機するように設定する必要があります。外部アプリケーションの ContentManager URI とディスパッチャー URI も、外部ディスパッチャーと同じプロトコルとポートを使用するように設定する必要があります。

すべての接続に対して SSL を設定する場合、ディスパッチャーでは内部接続用と外部接続用に同じポートを使用できます。同様に、ローカル通信と遠隔通信のどちらでも SSL を使用しない場合も、ディスパッチャーではすべての通信で同じポートを使用できます。

IBM Cognos Analytics コンポーネントでは、IBM Cognos セキュリティー・インフラストラクチャーにおける信頼性の基盤として、内部認証局 (CA) がデフォルトで使用されます。これは SSL 接続および非 SSL 接続の両方に適用されます。他のサービスによって管理される証明書を使用するには、 203 ページの『別の認証局を使用するための IBM Cognos コンポーネントの設定』を参照してください。

分散インストール環境では、アプリケーション層コンポーネント・コンピューターを構成する前に、まずデフォルトのアクティブな Content Manager コンピューターが SSL プロトコルを使用してそのコンピューター上のサービスを開始するように構成する必要があります。



3. 「プロパティー」ウィンドウで、URI 値に適切な値を入力します。

重要: HTTPS/SSL 構成の場合、 URI には必ず完全修飾ホスト名を使用してください。また、エクスプローラー・ウィンドウの「セキュリティー」 > 「暗号化」 > 「Cognos」 > 「ID 名」で、「サーバー共通名」を CAMUSER からサーバーの完全修飾ドメイン名に変更します。

v SSL を内部接続のみに設定するには、「内部ディスパッチャー URI」プロパティーに https および SSL 通信のポート番号を入力します。

「外部ディスパッチャー URI」および「外部アプリケーション用ディスパッチャー URI」プロパティーでは、プロトコルを http のままにして、デフォルトのポート番号または使用可能な別のポート番号を使用します。

IBM Cognos Analytics に備わっているアプリケーション・サーバーを使用する場合、「内部ディスパッチャー URI」プロパティーで「localhost」を指定する必要があります。

この 2 つのディスパッチャー URI には、異なるポート番号を指定する必要があります。


v SSL を外部接続のみに設定するには、「外部ディスパッチャー URI」および「外部アプリケーション用ディスパッチャー URI」プロパティーに httpsおよび SSL 通信のポート番号を入力します。

「内部ディスパッチャー URI」プロパティーでは、プロトコルを http のままにして、デフォルトのポート番号または使用可能な別のポート番号を使用します。

IBM Cognos Analytics に備わっているアプリケーション・サーバーを使用する場合、「内部ディスパッチャー URI」プロパティーで「localhost」を指定する必要があります。

この 2 つのディスパッチャー URI には、異なるポート番号を指定する必要があります。

v すべての接続に SSL を設定するには、「内部ディスパッチャー URI」、「外部ディスパッチャー URI」、および「外部アプリケーション用ディスパッチャー URI」プロパティーに同じ URI を入力します。 https およびSSL 通信のポート番号を入力します。

v さらに、「Content Manager URI」プロパティーにも https および SSL通信のポート番号を入力できます。

v 別のコンピューターにゲートウェイをインストールした場合、外部接続にSSL を使用するには、ゲートウェイ・コンピューターの IBM CognosConfiguration で「ゲートウェイ用ディスパッチャー URI」プロパティーにhttps および SSL 通信のポート番号を入力します。


5. サービスを再開します。

分散インストール環境では、最初に Content Manager コンピューターでサービスを開始し、次にアプリケーション層コンポーネントのコンピューターでサービスを開始します。

IBM Cognos サーバーと他のサーバー間で共有の信頼関係を確立する (必要な場合)。

IBM Cognos のデフォルトの認証局を使用し、他のサーバーから IBM Cognos サーバーへの接続に SSL を適用するには、IBM Cognos の証明書を他のサーバーのトラストストアに追加する必要があります。

注: ブラウザーを使用して IBM Cognos コンポーネントに接続する際は、ブラウザーでトラストストアの更新を要求するプロンプトが自動的に表示されます。

IBM Cognos サーバーと他のサーバー間の接続を手作業で認証するには、使用する認証局から IBM Cognos サーバーのトラストストアに証明書をコピーする必要があります。

別の認証局 (Certificate Authority) を使用するように IBM Cognos コンポーネントを設定した場合、IBM Cognos サーバーと他のサーバー間で共有信頼関係を設定する必要はありません。


別のサーバーへの IBM Cognos 証明書のコピーIBM Cognos 証明書を他のサーバーのトラストストアに追加する際にはまず行う作業は、サーバーに証明書をコピーすることです。

手順

1. <インストールの場所>/bin ディレクトリーに移動します。

2. 次のコマンドを入力して、IBM Cognos の証明書を抽出します。

v UNIX または Linux オペレーティング・システムの場合は、次のように入力します。

ThirdPartyCertificateTool.sh -E -T -r 宛先ファイル -p NoPassWordSet

v Microsoft Windows オペレーティング・システムの場合は、次のように入力します。

ThirdPartyCertificateTool.bat -E -T -r 宛先ファイル -p NoPassWordSet

3. サーバーのトラストストアに証明書をインポートします。

サーバーのトラストストアの更新方法については、サーバーのドキュメントを参照してください。

IBM Cognos サーバーへの CA 証明書のコピーIBM Cognos 証明書を他のサーバーにコピーした後、認証局から IBM Cognos サーバーに証明書をコピーします。

手順

1. 認証局 (Certificate Authority) の証明書を IBM Cognos サーバーの保護された場所にコピーします。

CA の証明書は、Base-64 でエンコードされた X.509 形式でなければなりません。

2. 次のコマンドを入力して CA の証明書をインポートします。

v UNIX または Linux オペレーティング・システムの場合は、次のように入力します。

ThirdPartyCertificateTool.sh -T -i -r CA の証明書ファイル -p

NoPassWordSet

v Microsoft Windows オペレーティング・システムの場合は、次のように入力します。

ThirdPartyCertificateTool.bat -T -i -r CA の証明書ファイル -p

NoPassWordSet

Secure Socket Layer の暗号スイートの選択と順位付けSSL 接続は、クライアントとサーバーがサポートする暗号スイートのリストを優先度の高い順に示すネゴシエーションから開始されます。暗号スイートは、接続の保護品質を制御します。暗号スイートには、暗号化、認証、ハッシュ、鍵交換の各アルゴリズムが組み込まれています。SSL プロトコルにより、クライアントとサーバーの両方がサポートする最も優先度の高いスイートが選択されます。


SSL に対しサポートされている暗号スイートのリストを用意してあります。要件を満たさない暗号スイートを消去し、残りの暗号スイートに優先度または設定を割り当てることができます。選択した暗号スイートは、クライアント側とサーバー側のネゴシエーション用に優先度の高い順に表示されます。選択した暗号スイートのうち少なくとも 1 つが、クライアント・プラットフォームとサーバー・プラットフォームの間で一致する必要があります。

サポートされる暗号スイートのリストは、各コンピューターで動的に生成され、Java Runtime Environment (JRE) や、コンピューターに他の暗号化ソフトウェアがインストールされているかどうかによって変わります。JRE のアップグレードや、JRE のアップグレードを伴うようなソフトウェアのインストールを行うと、そのコンピューターで使用できるサポートされている暗号スイートに影響を与えることがあります。サポートされている暗号スイートが環境内にある他のコンピューターに適合しなくなった場合、適合するようにそのコンピューターの JRE を変更する必要が生じる場合があります。


2. 「エクスプローラー」ウィンドウで、「暗号化」>「Cognos」をクリックします。

3. 「プロパティー」ウィンドウで、「サポートする暗号スイート」プロパティーの「値」列をクリックします。

4. 「編集」アイコンをクリックします。

v 暗号スイートを「現在の値」リストに移動するには、「使用できる値」リストのチェック・ボックスをオンにし、「追加」をクリックします。

v 暗号スイートを「現在の値」リスト内で上下に移動するには、チェック・ボックスをオンにし、上矢印または下矢印をクリックします。

v 暗号スイートを「現在の値」のリストから削除するには、チェック・ボックスをオンにし、「削除」をクリックします。



IBM Cognos Configuration でのデータベース接続のための SecureSockets Layer (SSL) プロトコルの使用

IBM Cognos Analytics によって使用されるデータベース (Content Store データベースや通知データベース、ログ記録データベースを含む) との通信に SecureSockets Layer (SSL) プロトコルを使用するよう IBM Cognos Analytics を設定することができます。

IBM Cognos Configuration で SSL を有効にする前に、データベース・サーバーでSSL を有効にする必要があり、さらにデータベース・サーバーに対して SSL 接続を使用するようデータベース・クライアントを設定する必要があります。

SSL サポートは、IBM Db2 for z/OS を除く、サポートされているすべてのデータベースで使用できます。


Db2

Db2 バージョン 9.1 フィックスパック 2 以降のバージョンでは、SSL を使用できます。

Db2 での SSL 接続の設定については、ご使用のバージョンの Db2 資料を参照してください。

例えば、バージョン 10.5 の場合は、IBM Db2 バージョン 10.5 の資料(pic.dhe.ibm.com/infocenter/db2luw/v10r5/index.jsp?topic=%2Fcom.ibm.db2.luw.admin.sec.doc%2Fdoc%2Fc0053514.html) を参照してください。

IBM Informix

IBM Informix での SSL 接続の設定については、ご使用のバージョンの IBMInformix 資料を参照してください。

例えば、バージョン 12.10 の場合は、IBM Informix バージョン 12.10 の資料(pic.dhe.ibm.com/infocenter/informix/v121/index.jsp?topic=%2Fcom.ibm.sec.doc%2Fids_ssl_001.htm) を参照してください。

Oracle

Oracle での SSL 接続の設定については、ご使用のバージョンの Oracle 資料を参照してください。

Oracle 発行の SSL With Oracle JDBC Thin Driver white paper(www.oracle.com/technetwork/database/enterprise-edition/wp-oracle-jdbc-thin-ssl-130128.pdf) では、データベース・サーバーおよびクライアントでの SSL の設定に関する情報が提供されています。

Microsoft SQL Server

Microsoft SQL Server での SSL 接続の設定については、ご使用のバージョンのMicrosoft SQL Server 資料を参照してください。

例えば、バージョン 2012 の場合は、Microsoft SQL Server バージョン 2012 の資料 (technet.microsoft.com/en-us/library/bb879949.aspx) を参照してください。

注: データベース・サーバーで SSL を有効にした後、IBM Cognos Configurationで「SSL 暗号化の有効化」を「有効」にすることができます。

Microsoft SQL Server における IBM Cognos Configurationでのデータベース接続のための SSL の使用

IBM Cognos Configuration でデータベース接続のために Secure Sockets Layer(SSL) を使用するには、SSL 証明書を Java 鍵ストアにインポートし、いくつかの


http://pic.dhe.ibm.com/infocenter/db2luw/v10r5/index.jsp?topic=%2Fcom.ibm.db2.luw.admin.sec.doc%2Fdoc%2Fc0053514.html

http://pic.dhe.ibm.com/infocenter/informix/v121/index.jsp?topic=%2Fcom.ibm.sec.doc%2Fids_ssl_001.htm

http://www.oracle.com/technetwork/database/enterprise-edition/wp-oracle-jdbc-thin-ssl-130128.pdf

http://technet.microsoft.com/en-us/library/bb879949.aspx

http://technet.microsoft.com/en-us/library/bb879949.aspx

IBM Cognos 設定ファイルを変更する必要があります。 Microsoft SQL Server での SSL 接続の設定については、ご使用のバージョンの Microsoft SQL Server 資料を参照してください。

IBM Cognos Configuration でのデータベース接続 (Content Store データベース、通知データベース、ログ記録データベース、Human Task サービス、Annotationサービス、Cognos Mobile を含む) に SSL を使用することができます。

SQL Server 用の JSQLConnect ドライバーは、Microsoft JDBC ドライバーに置き換わっています。バージョン以降、Microsoft からダウンロードして、新しいタイプ 4 ドライバーを install_location/drivers フォルダー内に入れる必要があります。

注: ドライバー JAR ファイルには sqljdbc4.jar、sqljdbc41.jar、sqljdbc42.jar

などのさまざまな名前があります。公式には、sqljdbc42.jar は JRE8 をサポートしています。このバージョンが Cognos Analytics に付属しています。

始める前に

データベース接続で SSL を使用するよう IBM Cognos を設定する前に、データベース・サーバーで SSL を有効にしておきます。

SSL 証明書をデータベース・サーバーからエクスポートし、IBM CognosConfiguration のデータベース接続を設定しているコンピューターで使用可能にしておきます。

手順1. Content Store データベースとして SSL 用に構成された SQL サーバーを使用

している場合、以下の手順を実行します。

a. ご使用の SQL サーバーの証明書を発行したルート認証局証明書 (または、Certificate Authority により発行されていない場合、自己署名サーバー証明書) を取得して、Cognos Analytics がインストールされているコンピューターにコピーします。例えば、ファイル sqlcert.cer をルート・ディレクトリー c:¥sqlcert.cer にコピーします。

b. cd C:¥Program Files¥ibm¥cognos¥analytics¥jre¥lib¥security を入力します。

c. 例えば、C:¥Progra~1¥ibm¥cognos¥analytics¥jre¥bin¥keytool -import

-trustcacerts -file "c:¥sqlcert.cer" -keystore cacerts -alias

SQLCert を入力します。

2. install_location¥bin64¥startwlp.bat (Windows) またはinstall_location¥bin64¥startwlp.sh (Linux、UNIX) を編集して、行 setJVM_ARGS=-Xmx4096m -XX:MaxNewSize=2048m -XX:NewSize=1024m %DEBUG_OPTS%

の後に以下の行を追加します。

Windows:

set JVM_ARGS="-Dcom.ibm.jsse2.overrideDefaultTLS=true" %JVM_ARGS%set JVM_ARGS="-Dcom.ibm.jsse2.sp800-131=strict" %JVM_ARGS%

Linux、UNIX:


JVM_ARGS=-Dcom.ibm.jsse2.overrideDefaultTLS=true $JVM_ARGSJVM_ARGS=-Dcom.ibm.jsse2.sp800-131=strict $JVM_ARGS

3. install_location¥bin64¥bootstrap_wlp_os_version.xml を編集して、行<param condName="${java_vendor}" condValue="IBM">-Xscmaxaot4m</param> の後に以下の行を追加します。

Windows:

<param>"-Dcom.ibm.jsse2.overrideDefaultTLS=true"</param><param>"-Dcom.ibm.jsse2.sp800-131=strict"</param>

Linux、UNIX:

<param>-Dcom.ibm.jsse2.overrideDefaultTLS=true</param><param>-Dcom.ibm.jsse2.sp800-131=strict</param>

4. install_location¥bin64¥cogconfig.bat (Windows) またはinstall_location¥bin64¥cogconfig.sh (Linux、UNIX) を編集し、set

J_OPTS=%DD_OPTS% %J_OPTS% 行の後に以下の行を追加します。

Windows:

set J_OPTS="-Dcom.ibm.jsse2.overrideDefaultTLS=true" %J_OPTS%set J_OPTS="-Dcom.ibm.jsse2.sp800-131=strict" %J_OPTS%

Linux、UNIX:

JAVA_OPTS=$JAVA_OPTS -Dcom.ibm.jsse2.overrideDefaultTLS=trueJAVA_OPTS=$JAVA_OPTS -Dcom.ibm.jsse2.sp800-131=strict

5. 前の手順で変更した cogconfig.bat または cogconfig.sh を使用して、CognosConfiguration を開始します。

重要: IBM Cognos Configuration を開始するには、通常の実行可能ファイル(cogconfigw.exe) やスタート・メニューのショートカットではなく、cogconfig.bat (変更して鍵ストアとパスワードを組み込んだもの) を使用しなければなりません。

6. 「データ・アクセス」のデータベース接続タイプの下で、データベース接続を選択します。

7. 「SSL 暗号化の有効化」に「有効」を選択します。

8. 接続をテストして、設定を保存します。

9. Cognos Analytics を開始します。SQL Server 構成マネージャー内のサーバーのフルネームと、証明書内のフルネーム (例えば、localhost ではなくmymachine.canlab.ibm.com) が一致している必要があります。

タスクの結果

重要: シングル・サインオン (SSO) と Windows 認証の場合、sqljdbc_auth.dll

を bin64 ディレクトリー内に入れる必要があります。Windows 認証は、シングル・サインオン・セットアップです。構成マネージャー内の Content Manager に関する選択項目は、「Microsoft SQL Server データベース (Windows 認証)」と呼ばれます。


IBM Db2、Informix データベースにおける IBM CognosConfiguration でのデータベース接続のための SSL の使用

IBM Cognos Configuration でデータベース接続のために Secure Sockets Layer(SSL) を使用するには、SSL 証明書を Java 鍵ストアにインポートし、いくつかのIBM Cognos 設定ファイルを変更する必要があります。

IBM Cognos Configuration でのデータベース接続 (Content Store データベースや通知データベース、ログ記録データベースを含む) に SSL を使用することができます。

始める前に


SSL 証明書をデータベース・サーバーからエクスポートし、IBM CognosConfiguration のデータベース接続を設定しているコンピューターで使用可能にしておきます。

手順1. ご使用のデータベース・バージョンの資料に従い、データベース・サーバーの

SSL を有効にし、SSL 証明書をエクスポートします。

2. 無制限の強度ポリシーの jar ファイルをダウンロードします。

IBM JRE の場合、https://www14.software.ibm.com/webapp/iwm/web/preLogin.do?source=jcesdk (https://www14.software.ibm.com/webapp/iwm/web/preLogin.do?source=jcesdk) にアクセスし、unrestrictedpolicyfiles.zip をダウンロードします。ポリシー・ファイルをインストールの場所/jre/lib/security に unzip します。

3. データベース接続を設定しているコンピューターで、IBM Cognos Analyticsで使用している JRE の keytool で SSL 証明書をインポートします。例えば、Microsoft Windows オペレーティング・システムの IBM CognosAnalytics インストールに付属する JRE を使用している場合、以下のステップを実行します。

a. インストールの場所/jre/bin ディレクトリーに移動します。

b. 次のコマンドを実行します。

keytool -import -file path/filename -keystore keystorename -alias aliasname

keystorename は新規鍵ストアの名前で、aliasname は証明書に付ける別名です。

c. 鍵ストアのパスワードを入力します。証明書を既存の鍵ストアに追加する場合、鍵ストアのパスワードを入力します。新規鍵ストアを作成する場合、新規鍵ストアのパスワードを入力します。

重要: IBM Cognos Analytics で使用している JRE の鍵ストアに SSL 証明書をインポートする必要があります。

4. java.security ファイルを編集し、SSL プロバイダーを組み込みます。




a. Microsoft Windows オペレーティング・システムの IBM CognosAnalytics インストールに付属する JRE を使用している場合、インストールの場所/jre/lib/security ディレクトリーに移動します。それ以外の場合、IBM Cognos Analytics で使用している JRE の lib/security ディレクトリーに移動します。

b. テキスト・エディターで java.security を開きます。

c. ファイル内で以下の行を見つけます。

ssl.KeyManagerFactory.algorithm=IbmX509ssl.TrustManagerFactory.algorithm=PKIX

d. 上記の行の後に以下の行を追加します。

ssl.SocketFactory.provider=com.ibm.jsse2.SSLSocketFactoryImplssl.ServerSocketFactory.provider=com.ibm.jsse2.SSLServerSocketFactoryImpl

e. ファイルを保存して閉じます。

5. IBM Cognos startwlp ファイルを編集します。このファイルは、IBM CognosAnalytics の開始時に使用されます。

a. インストールの場所/bin64 ディレクトリーに移動します。

b. テキスト・エディターで startwlp.bat ファイルを開きます。UNIX または Linux オペレーティング・システムの場合は、startwlp.sh ファイルを開きます。


Windows:

set JVM_ARGS=-Dcom.ibm.cognos.disp.useDaemonThreads=true %JVM_ARGS%

Linux、UNIX:

DISP_OPTS="-Dcom.ibm.cognos.disp.useDaemonThreads=true"


Windows:

set JVM_ARGS=-Dcom.ibm.jsse2.usefipsprovider=true %JVM_ARGS%set JVM_ARGS=-Djavax.net.ssl.trustStore=path/keystorename %JVM_ARGS%

Linux、UNIX:

DISP_OPTS="-Dcom.ibm.jsse2.usefipsprovider=true %DISP_OPTS%"DISP_OPTS="-Djavax.net.ssl.trustStore=path/keystorename"

path は鍵ストアへのパスで、keystorename は鍵ストアの名前です。


6. bootstrap_wlp_os_version.xml ファイルを編集します。このファイルは、IBMCognos Analytics を IBM Cognos Configuration からサービスとして開始する際に使用されます。


b. テキスト・エディターで bootstrap_wlp_os_version.xml ファイルを開きます。

c. ファイルに次の行を追加します。

<param>"-Dcom.ibm.jsse2.usefipsprovider=true"</param><param>"-Djavax.net.ssl.trustStore=path/keystorename"</param>



d. ファイルを保存して閉じます。

7. IBM Cognos cogconfig ファイルを編集します。


b. テキスト・エディターで cogconfig.bat ファイルを開きます。UNIX または Linux オペレーティング・システムの場合は、cogconfig.sh ファイルを開きます。


Windows:

J_OPTS=%DD_OPTS% %J_OPTS% %DEBUG_OPTS%

Linux、UNIX:

$JAVA_CMD $JAVA_OPTS CRConfig $*


Windows:

set J_OPTS=-Dcom.ibm.jsse2.usefipsprovider=true %J_OPTS%set J_OPTS=-Djavax.net.ssl.trustStore=path/keystorename %J_OPTS%

Linux、UNIX:

JAVA_OPTS="$JAVA_OPTS -Dcom.ibm.jsse2.usefipsprovider=true %JAVA_OPTS%"JAVA_OPTS="$JAVA_OPTS -Djavax.net.ssl.trustStore=path/keystorename"



8. 変更した cogconfig ファイルを使って IBM Cognos Configuration を開始します。

v Microsoft Windows オペレーティング・システムの場合、変更したcogconfig.bat ファイルをダブルクリックします。

v UNIX または Linux オペレーティング・システムの場合、変更したcogconfig.sh ファイルを実行します。


Content Store データベース、通知データベース、ログ記録データベース、ヒューマン・タスクおよび注釈データベースへの接続に SSL を使用できます。


11. 接続をテストします。


Oracle データベースにおける IBM Cognos Configuration でのデータベース接続のための SSL の使用

IBM Cognos Configuration でデータベース接続のために Secure Sockets Layer(SSL) を使用するには、SSL 証明書を Java 鍵ストアにインポートし、いくつかのIBM Cognos 設定ファイルを変更する必要があります。


IBM Cognos Configuration でのデータベース接続 (Content Store データベースや通知データベース、ログ記録データベースを含む) に SSL を使用することができます。

始める前に


手順1. IBM Cognos startwlp ファイルを編集します。


b. テキスト・エディターで startwlp.bat ファイルを開きます。UNIX またはLinux オペレーティング・システムの場合は、startwlp.sh ファイルを開きます。


set JVM_ARGS=-Doracle.net.ssl_version=3 %JVM_ARGS%set JVM_ARGS=-Doracle.net.ssl_client_authentication=false %JVM_ARGS%set JVM_ARGS=-Doracle.net.wallet_location=(SOURCE=(METHOD=file)(METHOD_DATA=(DIRECTORY=path/client_wallet))) %JVM_ARGS%

path パラメーターは、クライアントの Oracle ウォレット・ディレクトリーへのパスで、client_wallet パラメーターは、クライアントのウォレット・ディレクトリーの名前です。


2. bootstrap_wlp_os_version.xml ファイルを編集します。

このファイルは、IBM Cognos Analytics を IBM Cognos Configuration からサービスとして開始する際に使用されます。


b. テキスト・エディターで bootstrap_wlp_os_version.xml ファイルを開きます。


<param>-Doracle.net.ssl_version=3</param><param>-Doracle.net.ssl_client_authentication=false</param><param>-Doracle.net.wallet_location=(SOURCE=(METHOD=file)(METHOD_DATA=(DIRECTORY=path/client_wallet)))</param>

このファイルの Java パラメーターは手順 1 と同じである必要があります。

ヒント: bootstrap_wlp_linux38664.xml ファイルで二重引用符を使用すると、IBM Java の始動が妨げられ、Cognos の始動がハングおよび失敗する原因となります。


3. IBM Cognos cogconfig ファイルを編集します。



b. テキスト・エディターで cogconfig.bat ファイルを開きます。UNIX または Linux オペレーティング・システムの場合は、cogconfig.sh ファイルを開きます。


set J_OPTS=-Doracle.net.ssl_version=3 %J_OPTS%set J_OPTS=-Doracle.net.wallet_location=(SOURCE=(METHOD=file)(METHOD_DATA=(DIRECTORY=path/client_wallet))) %J_OPTS%set J_OPTS=-Doracle.net.ssl_client_authentication=false %J_OPTS%


4. 以下の Oracle ドライバー・ファイルを install_location/drivers ディレクトリーにコピーします。

v jssl-1_1.jar

v oraclepki.jar

v osdt_cert.jar

v osdt_core.jar



Content Store データベース、通知データベース、ログ記録データベース、ヒューマン・タスクおよび注釈データベースへの接続に SSL を使用できます。

ヒント: 接続で「Oracle データベース (詳細設定)」タイプが使用されていることを確認してください。「Oracle データベース (詳細設定)」タイプを選択しなかった場合、データベース接続を削除し、「Oracle データベース (詳細設定)」を使用するデータベース接続を新規作成してください。


8. 接続をテストします。


SSL を使用した JDBC データ・ソースの保護SSL を使用した JDBC データ・ソースの保護

手順1. データ・サーバーが SSL 用に構成されていることを確認します (IBM Cognos

Analytics 環境外で行います)。

2. Cognos Analytics で、データ・サーバー接続の JDBC URL、接続プロパティー、またはその両方が更新されており、プロバイダーの資料どおりに JDBC による SSL を有効にするのに必要なパラメーターが組み込まれていることを確認します。Db2 がデータ・サーバーの場合の必須の JDBC URL パラメーターの例: DB2 データ・サーバー接続のサンプル

3. 以下の資料のとおりに SSL 証明書を IBM Cognos JRE トラストストアにインポートします (証明書は jre/lib/security/cacerts にインポートする必要があり、そのデフォルトのパスワードは changeit です): CA 証明書の IBMCognos コンポーネントへのインポート


https://www.ibm.com/support/knowledgecenter/en/SS6NHC/com.ibm.swg.im.dashdb.doc/connecting/connect_connecting_jdbc_applications.html



Kerberos によるシングル・サインオンのための JDBC データ・ソース接続の構成

動的クエリー・モード (DQM) で使用する JDBC データ・ソース接続のために、Kerberos プロトコルを使ったシングル・サインオンを構成できます。

Microsoft SQL Server の場合を除き、シングル・サインオンによるデータ・ソース認証は、動的クエリー・モードでのみサポートされます。

制約付き委任 (Microsoft の Kerberos 拡張機能) のサポートにより、サービスは、ユーザーのサービス・チケットをそれ自体に提示してユーザーの代わりに別のサービスのためのチケットを取得することができます。そのサービス・チケットは、ユーザーから委任されたもの (Service for User to Proxy - S4U2Proxy)、またはユーザーが他の方法で認証されたときにサービス自体によって生成されたものです。

Kerberos を使用したシングル・サインオン認証用のデータ・ソースを構成するには、以下のようにします。

v Kerberos 初期設定ファイルを作成します。

v 動的クエリー・モードのデータ・ソース用にサービス・プリンシパル名 (SPN)を構成します。

v キータブ・ファイルを作成します。

v Kerberos ログイン・モジュールを構成します。には新しい代替プロシージャーがあります。

v データ・ソース接続を構成します。

始める前に、以下の条件が満たされていることを確認する必要があります。

1. IBM Cognos サービスが、Microsoft Active Directory ネームスペースを使用するシングル・サインオン用に構成されている。

2. データベースが Kerberos プロトコルを使用するように構成されている。

3. さらに、データベース・サーバー上で Active Directory ユーザーが構成されている。

4. シングル・サインオンに制約付き委任が構成されている場合は、ドライバーの資料を参照して、ドライバーが制約付き委任をサポートしていることを確認してください。 Kerberos 認証をサポートするドライバーのすべてが制約付き委任もサポートするというわけではありません。

動的クエリーが Kerberos 制約付き委任をサポートするのは、Netezza およびCloudera Impala 用の JDBC ドライバーを使用する場合です。この機能には、GSS 資格情報を受け取るように拡張された次のバージョン以上の JDBC ドライバーが必要です: Netezza 7.2.0.9-P3 および 7.2.1.3-P3 (詳しくはhttp://www-01.ibm.com/support/docview.wss?uid=swg21997658 を参照)、および Cloudera Impala 2.5.36。

IBM Cognos Analytics では、ORACLE または IBM の JRE を使用できます。 IBM に必要なバージョンは、サポートされている環境のページに記載しています。 Cognos Analytics で IBM JRE および Cloudera Impala JDBC を使




用する場合は、IBM JRE 8.0.3.12 以上を使用する必要があります。https://developer.ibm.com/javasdk/downloads/sdk8/ を参照してください。

シングル・サインオンなしの Kerberos 認証の使用

Active Directory ネームスペースを構成しない場合は、Kerberos 認証を構成できます。動的クエリー・モードの Query サービスは、提供された資格情報 (ユーザーID とパスワード) を、Kerberos Distribution Center (Active Directory または他のKerberos 実装) から TGT (Ticket Granting Ticket) を取得するための資格情報として解釈します。これらの資格情報は、サインオンの際に指定されるか、データベース資格情報を求めるプロンプトが出されたときにユーザーによって入力されます。この場合、構成手順は以下のように変わります。

v SPN を登録する必要はありません。

v キータブ・ファイルを作成する必要はありません。

v Kerberos ログイン・モジュールを構成する必要はありません。

- Kerberos Login Module は構成する必要がありますが、SPNとキータブ・ファイル仕様を指定する必要はありません。

v Kerberos 初期設定ファイルは指定する必要があります。

Kerberos 初期設定ファイルの作成Kerberos 初期設定ファイルを作成し、アプリケーション層コンポーネントがインストールされたすべてのコンピューター上の特定の場所に配置する必要があります。Kerberos 初期設定ファイル krb5.conf は、JRE Kerberos プロトコル実装が使用します。

Kerberos 初期設定ファイルの詳細については、MIT Kerberos Documentation(web.mit.edu/kerberos/krb5-devel/doc/admin/conf_files/krb5_conf.html) を参照してください。

手順

アプリケーション層コンポーネントがインストールされたすべてのコンピューターで、krb5.conf ファイルを JAVA_HOME/lib/security ディレクトリーにコピーします。UNIX が稼働しているコンピューター上では、krb5.conf ファイルを /etc/krb5 ディレクトリーにコピーします。Linux が稼働しているコンピューター上では、krb5.conf ファイルを /etc ディレクトリーにコピーします。Microsoft Windows が稼働しているコンピューター上では、krb5.conf ファイルをC:¥winnt ディレクトリーにコピーし、その名前を krb5.ini に変更します。

Query サービス用の SPN の作成使用する Query サービス用のサービス・プリンシパル名 (SPN) を作成する必要があります。 SPN は、委任に関して信頼された Active Directory ドメイン・ユーザーを使用して構成しなければなりません。


https://developer.ibm.com/javasdk/downloads/sdk8/

http://web.mit.edu/kerberos/krb5-devel/doc/admin/conf_files/krb5_conf.html

SPN は、spn@REALM とフォーマット設定される必要があります。spn 値は、サービス名/完全修飾ドメイン名とフォーマット設定されます。また、REALM は、Kerberos初期設定ファイルで構成されている領域名です。例えば、サービス名が dqm の場合、dqm/[email protected] となります。

Active Directory ドメイン・ユーザーの名前が dqmuser の場合、以下のコマンドを使用して SPN を登録できます。

setspn -s dqm/myserver.mydomain.com mywindowsdomain¥dqmuser

-L パラメーターと -Q パラメーターを使用して、SPN が正しく作成されたことを検証できます。次に例を示します。

setspn -L mywindowsdomain¥dqmuser

setspn -Q dqm/myserver.mydomain.com

キータブ・ファイルの作成SPN の作成後、サービス用のキータブ・ファイルを作成する必要があります。キータブ・ファイルを使用すると、サービスはパスワードなしでログインできます。サービス・アカウントのパスワードを変更した場合、キータブ・ファイルを再作成しなければなりません。

手順

以下のコマンドを使用して、キータブ・ファイルを作成します。ktpass -out krb5.keytab -princ SPN -mapUser username -mapOp set -pass

password -pType KRB5_NT_PRINCIPAL -crypto RC4-HMAC-NT

例えば、次のようになります。ktpass -out krb5.keytab -princ dqm/

[email protected] -mapUser dqmuser@mywindowsdomain

-mapOp set -pass password -pType KRB5_NT_PRINCIPAL -crypto RC4-HMAC-NT

Kerberos ログイン・モジュールの構成IBM Cognos Query サービスが Active Directory ドメインにログインできるようにするには、Kerberos ログイン・モジュールを構成する必要があります。ログインを可能にするには、Java 認証・承認サービス (JAAS) パッケージの構成ファイルが必要です。

使用する Cognos Analytics のバージョンに応じて、2 とおりの手順があります。

+

Kerberos のログイン・モジュールにシングル・サインオンを構成する方法 (ActiveDirectory):

1. Cognos Configuration で、Security > Authentication の Active Directory ネームスペースを選択します。

2. 「DQM サービス・プリンシパル名 (DQM Service Principal Name)」プロパティーで、キータブにリストされているとおりに正確に値を入力します。


コマンド klist -k <keytab file> を使用して、プリンシパル名を検索します。

3. キータブ・ファイルを ibmcognosba.keytab に名前変更して、install_location/configuration フォルダーに入れます。

Cognos Analytics は、必要なログイン構成を動的に作成します。

- . この手順は、 + でも使用できます。

構成ファイルは、JRE_HOME/lib/security ディレクトリーの java.security ファイルに含まれる必要があります。java.security ファイルに、次のような行を含める必要があります。

login.config.url.1=file:///${java.home}/lib/security/jaas.conf

JAAS 構成サンプルが IBM Cognos のインストール環境に備わっています。サンプル・ファイルの名前は jaas-ibm.config と jaas-oracle.config で、これらのファイルはインストールの場所¥configuration ディレクトリーにあります。

これらのサンプル・ファイルにおいて、以下の値を置換する必要があります。

v <principal name> は、作成した SPN です。

v <keytab file specification> は、作成したキータブ・ファイルのパスとファイル名です。

モデル作成用に Kerberos 認証が構成されたデータベース接続を使用していない場合、java.security ファイルを変更する代わりに、IBM Cognos Administration でQuery サービスの追加の始動パラメーターとして JAAS ログイン構成ファイルを指定できます。IBM Cognos Administration の「システム」で、使用しているサーバーを展開し、「Query サービス」 > 「プロパティーを設定」 > 「設定」を選択して、「Query サービス用の追加の JVM 引数」に-Djava.security.auth.login.config=<設定ファイル> という形式で値を入力します。

Kerebos 設定の検証Java 認証・承認サービス (JAAS) 設定とキータブ・ファイルを検証するには、Cognos Analytics が使用している JRE の Java コマンドを使用してコマンドを実行します。

手順

install_location/webapps/p2pd/WEB-INF/lib で以下のコマンドを実行します。java -cp xqeService.jar -Dcom.ibm.security.krb5.Krb5Debug=all-Dcom.ibm.security.jgss.debug=allcom.cognos.xqe.util.KerberosSSOLoginHelperユーティリティーはキータブ・ファイルを使用してログインを試み、プロセス内でKerberos デバッグ出力を表示します。最後に、「Helper login successful」または「Helper Login failed <error message>」と表示します。

JDBC ドライバー機能の検証シングル・サインオンが設定されているかどうかにかかわらず、DQM では、事前に承認されたサブジェクトを使用してデータベース・ドライバーが接続を作成でき


る必要があります。IBM Cognos Analytics インストールに付属のユーティリティーが、ドライバーのテストに役立ちます。

始める前に

ユーティリティーは url、uid、および password をパラメーターとして受け入れます。ドライバーが install_location/webapps/p2pd/WEB-INF/lib フォルダーにインストールされている必要があります。

手順

install_location/webapps/p2pd/WEB-INF/lib フォルダーで、jre Cognos が使用している Java コマンドを使用して、以下のコマンドを実行します。 java -cpxqeService.jar;<driver.jar> com.cognos.xqe.util.KerberosConnectionHelper<driver class name> <jdbc url> <user> <password>それぞれの意味は以下のとおりです。

v <driver.jar> は、ドライバーが含まれている JAR ファイルです。ドライバーに含まれる JAR ファイルが多すぎる場合は、クラスパス・パラメーターに "*" を指定できます。

v <driver class name> は、ドライバーのロードに使用されるクラス名です。

v <jdbc url> はデータ・ソース用の JDBC 接続 URL です。これには、Kerberos認証用のドライバー固有プロパティーが含まれます。

v <user> は Kerberos プリンシパルです。

v <password> は Kerberos プリンシパル・パスワードです。

このユーティリティーは、指定されたパラメーターを使用してデータベースに接続を試み、Kerberos デバッグ・トレースを出力します。

Kerberos 使用時のデータ・ソース接続の構成Kerberos シングル・サインオンを使ったデータ・ソース接続用に接続文字列を構成するときには、このトピックのガイドラインを使用してください。

手順1. 「サインオン」セクションで、「外部ネームスペース」を選択し、リストから

Active Directory ネームスペースを選択します。デュアル・タブ (「ネイティブ」と「JDBC」) の接続文字列の場合、「サインオン」セクションは「ネイティブ」タブ上に表示されます。

2. 「接続プロパティー」フィールドで、ibmcognos.authentication=java_krb5 を指定してから、Kerberos 認証用に JDBC ドライバーで必要なプロパティーがあれば追加します。デュアル・タブ (「ネイティブ」と「JDBC」) のデータ・ソース接続の場合、このフィールドは「JDBC」タブ上にあり、「JDBC 接続パラメーター」と呼ばれます。

Microsoft Windows オペレーティング・システムが稼働しているコンピューター上に IBM Cognos Analytics がインストールされている場合、MicrosoftSQL Server と Teradata のデータ・ソース接続に関してibmcognos.authentication=java_krb5 を指定する必要はありません。

3. データ・ソース接続をテストします。


例

いくつかのデータ・ソースにおけるデータ・ソース接続プロパティーの例を以下に示します。

v Teradata データ・ソース接続の場合:

ibmcognos.authentication=java_krb5;LOGMECH=KRB5;

v SAP-HANA データ・ソース接続の場合:

ibmcognos.authentication=java_krb5;

v Microsoft SQL Server データ・ソース接続の場合:

ibmcognos.authentication=java_krb5;authenticationScheme=JavaKerberos;

ログ・メッセージのリポジトリーの設定BI Bus プロトコルにはログ・メッセージ処理が組み込まれています。この処理はIBM Cognos Analytics の動作を調べるための重要な診断ツールです。

ログ・メッセージには、エラー・メッセージの他にも、コンポーネントのステータスや重要なイベントの概要が出力されます。例えば、サービスの開始や停止を試みた操作、処理要求の完了、致命的なエラーのインディケーターを記録できます。監査ログはログ記録データベースから使用でき、このログにはユーザーやレポート処理に関する情報が出力されます。

各コンピューターにある IBM Cognos サービスは、ローカル・ログ・サーバーにエラーやイベントに関する情報を送信します。ローカル・ログ・サーバーは、ContentManager やアプリケーション層コンポーネントが含まれているすべての IBMCognos Analytics コンピューター上のインストールの場所/logs フォルダーにインストールされます。ログ・サーバーは他の IBM Cognos Analytics コンポーネントとは異なるポートを使用するため、ローカル・コンピューターでディスパッチャーなどの他のサービスが使用不可になっても、イベント記録は続行されます。

次のワークフローは、ログ記録の準備に必要なタスクを示しています。

v 計画の段階では、使用する環境に合ったログ記録設定を決めます。例えば、さまざまなログ・メッセージのリポジトリーを評価します。リポジトリーとしては、ローカル・ログ・ファイルの他に、UNIX または Linux syslog や WindowsNT イベント・ログなどのリモート・ログ・サーバーおよびログ・ファイルも候補となります。データベースに監査ログ情報のみを送信することもできます。システム障害やユーザーによる改ざんからログ・ファイルを保護するために適用可能な方法など、セキュリティーについて検討してください。

v 設定の段階では、データベースへの接続設定などログ記録の始動プロパティーを定義します。監査ログを収集する予定であれば、ログ記録データベースも作成する必要があります。ローカル・ログ・サーバーとリモート・ログ・サーバー間の通信を保護する必要がある場合は、両方の IBM Cognos Analytics コンピューターで適切な設定変更を行います。また、ユーザー固有のログ記録など、特定のログ記録機能を有効にすることもできます。


v ログ記録の設定時に、所属している組織に関連のあるメッセージが重点的に記録されるように詳細レベルを指定します。ユーザーやレポート処理の状況を監視するよう監査レポートを設定することもできます。

ログのセットアップ方法について詳しくは、「IBM Cognos Analytics 管理およびセキュリティー・ガイド」を参照してください。

ログ・メッセージを使用して問題を解決する方法、およびログ記録に関する問題の解決方法については、「IBM Cognos Analytics トラブルシューティング・ガイド」を参照してください。

ログ記録データベースを作成する際のガイドラインログ・メッセージを保存するデータベースを作成できます。ログ記録データベースを作成するには、次の作業を行います。

v ログ記録データベースを作成する

IBM Db2、Oracle、Microsoft SQL Server の場合は、Content Store データベースを作成するのと同じ手順を使用します。 8 ページの『Content Store を作成する際のガイドライン』の手順を使用してください。

注: Db2 を使用している場合、Content Store の場合と同じ方法で通知データベースを作成するスクリプトを生成することはできません。

z/OS で Db2 を使用する場合は、『z/OS 上の Db2 でログ記録データベースを作成するための推奨設定』の手順を使用します。

v データベース接続を設定する

230 ページの『ログ記録データベース用のデータベース接続』の手順を使用してください。

v ログ・メッセージのリポジトリーを指定する。

232 ページの『ログ・メッセージのリポジトリー』の手順を使用してください。

z/OS 上の Db2 でログ記録データベースを作成するための推奨設定

作成するデータベースには、指定の設定が含まれていなければなりません。

次のチェックリストに従って、z/OS 上の Db2 でログ記録データベースを設定してください。

__ v z/OS 上の Db2 で管理者権限を持つユーザーとして z/OS システムにログオンします。

__ v Content Store 用のデータベース・インスタンス、ストレージ・グループ、およびユーザー・アカウントを作成する。IBM Cognos では、ユーザー・アカウントの資格情報を使用してデータベース・サーバーと通信します。

__ v データベース・インスタンス用に 8KB のページ・サイズのバッファー・プールを割り当ててください。

__ v z/OS 上の Db2 のログ記録データベースの場合、管理者は、ログ記録データベース用のラージ・オブジェクトやその他のデータを保持するための表スペ


ースを作成する表スペース・スクリプトを実行し、そのテーブルを使用する権限をユーザーに付与する必要があります。表スペース・スクリプトの実行については『z/OS 上の Db2 でログ記録データベース用の表スペースを作成する』を参照してください。

z/OS 上の Db2 でログ記録データベース用の表スペースを作成するz/OS 上の IBM Db2 を使用している場合、データベース管理者はスクリプトを実行して、ログ記録データベースに必要な表スペースのセットを作成する必要があります。プレースホルダー・パラメーターを環境に適したものに置き換えるように、スクリプトを変更する必要があります。

必ず z/OS 上の Db2 用の命名規則を使用してください。例えば、パラメーター名はすべて文字で始まり、6 文字以下でなければなりません。詳しくは、Db2Knowledge Center を参照してください。

手順

1. 表スペースの作成と削除の権限、および SQL 文の実行を許可する権限のあるユーザーとしてデータベースに接続します。

2. <インストールの場所>/configuration/schemas/logging/db2zos ディレクトリーに移動します。

3. LS_tablespace_db2zOS.sql スクリプト・ファイルを開き、次の表を参考にして、汎用パラメーターを環境に適した汎用パラメーターに置き換えます。

表 31. z/OS 上の Db2 におけるログ記録データベース用の表スペースのパラメーター名と説明


IPFSCRIPT_DATABASE ログ記録データベースの名前。

IPFSCRIPT_STOGROUP ストレージ・グループの名前。

IPFSCRIPT_TABLESPACE ログ記録データベースの基準テーブルが格納される表スペースの名前。

この表スペースは、補助テーブル用ではありません。

IPFSCRIPT_LS_ID 監査データベースのインスタンス ID。この値は、2 文字以下にしてください。

IPFSCRIPT_BP 通常のオブジェクトに対して割り当てられる8K のバッファー・プールの名前。

IPFSCRIPT_USERNAME ログ記録データベースにアクセスするユーザー・アカウント。


4. スクリプトを保存して実行します。

5. スクリプト・ファイルを実行したときに作成された表スペースに対する権限をIBM Cognos ユーザーに付与します。

v LS_rightsGrant_db2zOS.sql スクリプト・ファイルを開きます。

v パラメーターの値を環境に合わせて置き換えます。


ヒント:バッファー・プールとユーザー・アカウントを作成したときに使用した値と同じ値を使用してください。

v LS_rightsGrant_db2zOS.sql スクリプトを保存して実行します。

タスクの結果

ログ記録データベースが作成されます。

ログ記録データベース用のデータベース接続Oracle、IBM Db2、Informix Dynamic Server をデータベース・サーバーとして使用する場合は、監査ログのデータベースを作成した後、データベース・クライアントをセットアップするための追加ステップが必要になります。

分散環境では、アプリケーション層コンポーネントのコンピューターのローカル・ログ・サーバーにより、ログ・メッセージがリモート・ログ・サーバーに送信される場合があります。この場合、メッセージはさらにログ記録データベースに送信されます。Oracle と Db2 では、該当する JDBC ドライバーとデータベース・クライアント・ソフトウェアのいずれか、またはその両方が、ログ記録データベースに接続されているリモート・ログ・サーバーを使用するアプリケーション層コンポーネントのコンピューター上でのみ必要になります。

Microsoft SQL Server

Microsoft SQL Server データベースを使用する場合、"JSQLConnect.jar"ファイルは、デフォルトで適切な場所にインストールされます。必要な追加作業は、Microsoft SQL Server が TCP/IP 接続を使用していることの確認のみです。

IBM Db2 ログ記録データベースのデータベース接続の設定ログ記録データベースに接続するすべてのアプリケーション層コンポーネントのコンピューターに、データベース・クライアント・ソフトウェアおよび JDBC ドライバーを設定する必要があります。使用しているログ・メッセージ用のデータベースのタイプが、 Content Store で使用するものと同じでない場合は、ContentManager コンピューターで JDBC ドライバーをセットアップする必要があります。

ドライバー・バージョンは少なくとも、Linux または UNIX オペレーティング・システム、Microsoft Windows オペレーティング・システムのバージョン 9.1 FixPack の JCC 3.7、または Linux、UNIX オペレーティング・システム、MicrosoftWindows オペレーティング・システムのバージョン 9.5 Fix Pack 2 の JCC 3.42でなければなりません。

手順

以下のファイルを DB2_installation\sqllib\java ディレクトリーからinstall_location\drivers ディレクトリーにコピーします。


v ライセンス・ファイル:

Linux、UNIX、または Windows オペレーティング・システム上の Db2 の場合は、db2jcc_license_cu.jar を使用します。


z/OS 上の Db2 の場合は、db2jcc_license_cisuz.jar を使用します。

z/OS 上の Db2 に接続する場合は、Linux、UNIX、または Windows のバージョン 9.1 フィックスパック 5、またはバージョン 9.5 フィックスパック 2 のドライバー・バージョンを使用します。

ヒント: ドライバーのバージョンを確認するには、次のコマンドを実行します。

java -cp path\db2jcc4.jar com.ibm.db2.jcc.DB2Jcc -version

Oracle ログ記録データベースのデータベース接続の設定ログ記録データベースに接続するすべてのアプリケーション層コンポーネントのコンピューターに、JDBC ドライバーを設定する必要があります。 Content Store 用に使用しているのと同じタイプのデータベースをログ・メッセージ用に使用していない場合、Content Manager のコンピューターにも JDBC ドライバーを設定する必要があります。

手順

1. Oracle クライアントがインストールされているコンピューターで、"ORACLE_HOME/jdbc/lib" ディレクトリーに移動します。

2. Content Manager がインストールされていて、Oracle データベースに通知が送信されるコンピューターの install_location\drivers ディレクトリーに、使用している Oracle クライアントのバージョンの適切なライブラリー・ファイルをコピーします。

Oracle 12c を使用している場合は、ojdbc7.jar が必要です。

Oracle 11g を使用している場合は、ojdbc5.jar が必要です。

このファイルは Oracle のクライアントかサーバーのインストールによって提供されますが、Oracle の技術 Web サイトからもダウンロードできます。

Informix ログ記録データベースのデータベース接続の設定ログ記録データベースに接続するすべてのアプリケーション層コンポーネントのコンピューターに、JDBC ドライバーを設定する必要があります。 Content Store 用に使用しているのと同じタイプのデータベースをログ・メッセージ用に使用していない場合、Content Manager のコンピューターにも JDBC ドライバーを設定する必要があります。

手順

1. Informix がインストールされているコンピューターで、<Informix の場所>/sqllib/java ディレクトリーに移動します。

2. Content Manager がインストールされているすべてのコンピューターのinstall_location\drivers ディレクトリーに、次のファイルをコピーします。


v ライセンス・ファイル、db2jcc4_license_cisuz.jar


ログ・メッセージのリポジトリーローカル・ログ・サーバーは、Content Manager またはアプリケーション層コンポーネントのインストール時に自動的にインストールされます。ローカル・ログ・サーバーによって転送されるログ・メッセージのリポジトリーを 1 つ以上指定できます。

リモート・ログ・サーバーへのログ・メッセージの送信

分散インストール環境では、共通ログ・サーバーとして機能する単一のリモート・ログ・サーバーにログ・メッセージを送信するように、各 IBM Cognos コンピューターのログ・サーバーを設定できます。その後、同じコンピューターまたは別のコンピューターにあるローカル・ファイルまたはデータベースにログ・メッセージを送るように、共通ログ・サーバーを設定できます。

リモート・ログ・サーバーが使用できなくなった場合、ログ・メッセージはローカル・コンピューターのリカバリー・ファイルに転送されます。このリカバリー・ファイルは、<インストールの場所>/logs/recovery/remote ディレクトリーにあります。リカバリー・ファイルのファイル名にはタイム・スタンプ情報が含まれているため、通常のログ・ファイルのように読み取ることができません。リモート・ログ・サーバーが利用可能になると、自動リカバリー・プロセスにより、すべてのログ情報がリモート・ログ・サーバーに送られ、ローカル・ログ・ファイルは削除されます。

ファイルへのログ・メッセージの保存

ログ・サーバーは、デフォルトでは <インストールの場所>/logs/cogaudit.log ファイルにログ・メッセージを送信するように設定されています。 IBM Cognos サービスの開始時にデフォルトのログ・ファイルが存在しない場合、ファイルは自動的に作成されます。

ログ・メッセージを異なるファイルに送信するようにログ・サーバーを設定できます。異なるログ・ファイルを設定した場合、IBM Cognos では始動時にデフォルトのログ・ファイルに加えてこのファイルが自動的に作成されます。設定したログ・ファイルの場所が <インストールの場所>/logs ディレクトリーと異なる場合は、ログ・ファイルへのパスが存在することを確認してから、IBM Cognos サービスを開始します。例えば、メッセージを /usr/lpp/logfiles/cognos.log ファイルに送信するようにログ・サーバーを設定すると、IBM Cognos は /usr/lpp/logfiles フォルダーに cognos.log ファイルを自動作成しようとします。このフォルダーが存在しない場合、IBM Cognos は cognos.log ファイルを作成せず、ログ・メッセージはファイルに記録されません。このようなログ・メッセージはデフォルトのログ・ファイルに記録されないことに注意してください。IBM Cognos では、別のログ・ファイルが設定されている場合であっても自動的にデフォルトのログ・ファイルが作成されますが、デフォルトのログ・ファイルはバックアップとしては使用されません。

データベースへのログ・メッセージの保存

ログ・サーバーでは、同じコンピューターまたは別のコンピューターのデータベースに監査ログを送信することもできます。監査ログには、ユーザーやレポート処理に関する情報が表示されます。


ログ記録データベースの設定とユーザー・アカウントの要件は、Content Store データベースの要件と同じです。メッセージをログ記録データベースに送信するように IBM Cognos コンポーネントを設定し、IBM Cognos サービスを再開すると、必要なテーブルとテーブル・フィールドが作成されます。IBM Cognos サービスを再開する前に、ログ記録データベースへの接続をテストできます。

UNIX、Linux、または Windows の IBM Db2 でのログ・メッセージのリポジトリーの指定ログ・メッセージのリポジトリーのタイプを設定し、特定のリポジトリーのプロパティーを設定できます。また、ログ・メッセージのリポジトリーを複数指定することもできます。

始める前に

リポジトリーとしてデータベースを指定する前に、次のことを確認してください。

__ v ログ記録データベースを作成したこと

__ v データベース・クライアントを設定したこと

手順

1. Content Manager またはアプリケーション層コンポーネントをインストールしたコンピューターで、IBM Cognos Configuration を起動します。

2. 「エクスプローラー」ウィンドウの「環境」で、「ログ記録」をクリックします。

3. 「プロパティー」ウィンドウで、次の表を参考にしてログ・サーバーのプロパティーを設定します。

表 32. ログ・サーバーのプロパティー

タスク操作

コンピューターの IBM Cognos コンポーネントとそのローカル・ログ・サーバー間でTCP を使用する。

「TCP を使用」プロパティーを「有効」に設定します。

UDP では、TCP より接続遮断の危険性が少なく、高速の通信可能です。ただし、ローカル TCP では、接続遮断の危険性は少なくなります。ローカル・ログ・サーバーとリモート・ログ・サーバー間の通信では、常にTCP が使用されます。

ローカル・ログ・サーバーで使用できるスレッド数を変更する。

「ローカル・ログ・サーバーのワーカー・スレッド数」プロパティーに値を入力します。

デフォルトの値である"10"を維持します。有効範囲は 1～20 です。

ただし、多数のログ・メッセージがある場合は、パフォーマンスを向上させるために、さらに多くのスレッドを割り当てることができます。


4. 「エクスプローラー」ウィンドウの「環境」で、「ログ記録」を右クリックし、「リソースの新規作成」>「ターゲット」の順にクリックします。

5. 「名前」ボックスにリポジトリーの名前を入力します。

6. 「タイプ」リストでリポジトリーのタイプをクリックし、「OK」をクリックします。

7. リポジトリーがファイルの場合は、「プロパティー」ウィンドウの必須プロパティーとオプション・プロパティーに適切な値を入力します。

8. リポジトリーがリモート・ログ・サーバーの場合は、「プロパティー」ウィンドウの必須プロパティーとオプション・プロパティーに適切な値を入力します。

リポジトリー・コンピューターの「内部ディスパッチャー URI」が SSL を使用するように設定されている場合は、「プロパティー」ウィンドウで、「SSLを使用」プロパティーを「有効」に設定します。

後でリモート・ログ・サーバーを設定するときに、ログ・メッセージのリポジトリーを指定する必要があります。

9. リポジトリーがデータベースの場合は、「エクスプローラー」ウィンドウの「ログ記録」で、データベースのタイプとそのプロパティーを次のように指定します。

v データベース名を右クリックして、「リソースの新規作成」>「データベース」の順にクリックします。

v 「名前」ボックスにリポジトリーの名前を入力します。

v 「タイプ」リストでデータベースのタイプをクリックし、「OK」をクリックします。

v 「プロパティー」ウィンドウの必須プロパティーとオプション・プロパティーに適切な値を入力します。

Microsoft SQL Server の場合、「ポート番号とインスタンス名によるデータベース・サーバー」プロパティーの値には、1433 などのポート番号を使用することも、インスタンス名を使用することもできます。デフォルト以外のポートを使用している場合は、ポート番号を指定します。Microsoft SQLServer の複数のインスタンスが存在する場合は、インスタンス名を含めます。

名前付きのインスタンスに接続するには、インスタンス名を JDBC URL プロパティーまたはデータ・ソース・プロパティーとして指定する必要があります。例えば、「localhost¥instance1」と入力できます。インスタンス名プロパティーが指定されていない場合、デフォルトのインスタンスに対する接続が作成されます。

ユーザー ID およびパスワードとともに、名前付きのインスタンスに対して指定されたプロパティーとデータベース名は、JDBC URL を作成するために使用されることに注意します。次に例を示します。

jdbc:JSQLConnect://localhost¥¥instance1/user=sa/<必要に応じてプロパティーを追加>


v 新しいデータベースへの接続をテストします。「エクスプローラー」ウィンドウの「環境」で、「ログ記録」を右クリックし、「テスト」をクリックします。

IBM Cognos コンポーネントがデータベースに接続されます。メッセージのログ記録用に複数のデータベースを設定した場合は、IBM Cognos コンポーネントによってすべてのデータベースがテストされます。

10. ログ・サーバーからメッセージを送信する各リポジトリーに対して、手順 5～10 を繰り返します。


12. 「エクスプローラー」ウィンドウで、「IBM Cognos サービス」>「IBMCognos」をクリックします。

13. 「ファイル」メニューの「再開」をクリックします。

リポジトリーとしてデータベースを選択した場合は、作成したデータベースに、必要なテーブルとフィールドが作成されます。

タスクの結果

リポジトリーがリモート・ログ・サーバーである場合、リモート・ログ・サーバーを設定および起動します。次に、ローカル・コンピューターで IBM Cognos サービスを再開します。

リポジトリーがデータベースである場合、IBM Cognos コンポーネントを使用してデータベースからログ・レポートを実行できます。

ログ記録レベルを設定することもできます。ログ記録レベルでは、ログ・ファイルまたはデータベースに送られるメッセージの詳細とタイプを制御できます。その手順については、「IBM Cognos Analytics 管理およびセキュリティー・ガイド」を参照してください。

z/OS における IBM Db2 のログ・メッセージ・リポジトリーの指定ログ・メッセージのリポジトリーのタイプを設定し、特定のリポジトリーのプロパティーを設定できます。また、ログ・メッセージのリポジトリーを複数指定することもできます。

手順

1. Content Manager またはアプリケーション層コンポーネントをインストールしたコンピューターで、IBM Cognos Configuration を起動します。





タスク操作



UDP では、TCP より接続遮断の危険性が少なく、高速の通信可能です。

ローカル・ログ・サーバーとリモート・ログ・サーバー間の通信では、TCP が使用されます。



デフォルトの値である"10"を維持します。有効範囲は 1～20 です。ただし、多数のログ・メッセージがある場合は、パフォーマンスを向上させるために、さらに多くのスレッドを割り当てることができます。



6. 「タイプ」のリストで「データベース」をクリックし、「OK」をクリックします。

7. 「エクスプローラー」ウィンドウの「ログ記録」で、データベース名を右クリックし、「リソースの新規作成」>「データベース」の順にクリックします。


9. 「タイプ」のリストで「DB2 データベース」をクリックし、「OK」をクリックします。

10. 「プロパティー」ウィンドウで、「データベース・サーバーとポート番号」、「ユーザー ID とパスワード」、および z/OS の「データベース名」に入力します。

ユーザー ID は、"LS_tablespace_db2zOS.sql"スクリプト・ファイルでIPFSCRIPT_USERNAME パラメーターに対して指定したのと同じ値でなければなりません。 229 ページの『z/OS 上の Db2 でログ記録データベース用の表スペースを作成する』

11. 「エクスプローラー」ウィンドウで、「ローカル設定」をクリックします。

12. 「プロパティー」ウィンドウで、「詳細プロパティー」の隣にある「値」ボッ

クス内をクリックし、「編集」アイコン


13. 「追加」をクリックし、次の表に示す設定パラメーター名と値を追加します。


表 34. 構成パラメーターの名前および値

パラメーター名値

IPFSCRIPT_CREATE_IN 基準テーブルの場所。

例:databaseName.baseTablespaceName

IPFSCRIPT_STOGROUP ストレージ・グループの名前。

IPFSCRIPT_DATABASE ログ記録データベースの名前。

IPFSCRIPT_LS_ID 監査データベースのインスタンス ID。この値は、2 文字以下にしてください。


15. 新しいデータベースへの接続をテストします。「エクスプローラー」ウィンドウの「環境」で、「ログ記録」を右クリックし、「テスト」をクリックします。


Informix 用のログ・メッセージのリポジトリーの指定ログ・メッセージのリポジトリーのタイプを設定し、特定のリポジトリーのプロパティーを設定できます。また、ログ・メッセージのリポジトリーを複数指定することもできます。

手順




タスク操作



UDP では、TCP より接続遮断の危険性が少なく、高速の通信可能です。

ローカル・ログ・サーバーとリモート・ログ・サーバー間の通信では、TCP が使用されます。


表 35. ログ・サーバーのプロパティー (続き)

タスク操作



デフォルトの値である"10"を維持します。有効範囲は 1～20 です。ただし、多数のログ・メッセージがある場合は、パフォーマンスを向上させるために、さらに多くのスレッドを割り当てることができます。



5. 「タイプ」のリストで「データベース」をクリックし、「OK」をクリックします。

6. 「エクスプローラー」ウィンドウの「ログ記録」で、データベース名を右クリックし、「リソースの新規作成」>「データベース」の順にクリックします。


8. 「タイプ」のリストで「Informix Dynamic Server データベース」をクリックし、「OK」をクリックします。

9. 「プロパティー」ウィンドウで、「データベース・サーバーとポート番号」、「ユーザー ID とパスワード」、および「データベース名」の値を入力します。

10. Informix のログ記録データベースのインスタンスが複数ある場合は、詳細プロパティー IPFSCRIPTIDX を作成し、インスタンスを実行するアカウントを指定します。

v 「エクスプローラー」ウィンドウで、「ローカル設定」をクリックします。

v 「プロパティー」ウィンドウで、「詳細プロパティー」の「値」列をクリッ

クし、「編集」アイコン


v 「値 - 詳細プロパティー」ダイアログ・ボックスで「追加」をクリックします。

v 「名前」列に、「IPFSCRIPTIDX」と入力します。

v 「値」列に、ログ記録データベースのインスタンスを実行するアカウントのユーザー ID を入力します。

Informix のログ記録データベースのインスタンスごとに、異なるユーザー・アカウントを使用します。

v Informix のログ記録データベースのインスタンスを使用する IBM CognosConfiguration のすべてのインスタンスで繰り返します。


12. 新しいデータベースへの接続をテストします。「エクスプローラー」ウィンドウの「環境」で、「ログ記録」を右クリックし、「テスト」をクリックします。



ユーザー固有のログ記録の有効化問題を診断する際、すべてのユーザーを追跡するのではなく、1 人以上の特定のユーザーを追跡するように、ログ記録の設定を一時的に変更できます。診断の終了後に、通常のログ記録に戻すことができます。ユーザー固有のログ記録を有効にするには、IBM Cognos Configuration を使用して Java Management Extensions(JMX) の接続情報を設定します。JMX は、アプリケーションとサービス指向ネットワークの管理と監視を行うツールを提供する技術です。次に、配布プロパティー・ファイルで JMX 接続情報を設定します。

IBM Cognos コンポーネントでユーザー固有のログ記録を有効にした後は、JMX に対する Remote Process サービスを使用して特定のユーザーのログ記録を有効にします。詳細については、「IBM Cognos Analytics 管理およびセキュリティー・ガイド」で、特定のユーザーの問題を診断するためのログ記録に関するトピックを参照してください。

ユーザー固有のログ記録を有効にするには、Oracle Java SE Development Kit または Java Software Development Kit for IBM をインストールする必要があります。

IBM Cognos Configuration を使用した JMX 接続情報の設定IBM Cognos Configuration で Java Management Extensions (JMX) 接続情報を設定するには、Cookie 値を指定し、JMX ポートと資格情報を設定します。

手順

1. Content Manager がインストールされているコンピューターで IBM CognosConfiguration を起動します。


3. 「プロパティー」ウィンドウの「ディスパッチャー設定」で JMX プロパティーを次のように設定します。

v 「外部 JMX ポート」では、使用可能なポート番号を入力します。

v 「外部 JMX 資格情報」では、「値」列の「編集」アイコン

をクリックし、ユーザー ID とパスワードを入力してから、「OK」をクリックします。

ユーザー ID とパスワードを設定しておけば、「外部 JMX ポート」に指定されたポートを使って Java 環境に接続してログ記録対象のユーザーを指定できるユーザーを、許可されたユーザーのみに制限できます。



配布プロパティー・ファイルでの JMX 接続情報の設定使用しているアプリケーション・サーバーで Java Management Extensions (JMX)設定がサポートされるようにするには、p2pd 配布プロパティー・ファイルに JMXポートを指定します。

手順

1. テキスト・エディターで、<インストールの場所>/webapps/p2pd/WEB-INF にあるp2pd.deploy_defaults.properties ファイルを開きます。

2. rmiregistryport 行を非コメント行にし、値に IBM Cognos Configuration で設定した「外部 JMX ポート」を設定します。

3. p2pd.deploy_defaults.properties ファイルを保存します。

4. IBM Cognos のサービスを再開します。

タスクの結果

1 人以上の特定のユーザーのログ記録が IBM Cognos でサポートされるようになりました。詳細については、「IBM Cognos Analytics 管理およびセキュリティー・ガイド」で、特定のユーザーの問題を診断するためのログ記録に関するトピックを参照してください。

グローバル設定の変更ロケールは異なるソースから取得される場合があり、形式もそれぞれ異なっている可能性がありますが、デフォルトでは、IBM Cognos コンポーネントのすべてのロケールで標準形式が使用されます。したがって、拡張されたすべてのロケールは言語と地域コードの設定に準拠します。各コンピューターにはデフォルトのシステム・ロケールが設定されています。また、各ユーザーにはユーザー・ロケールが 1つ設定されています。ユーザー・ロケールは、デフォルトのシステム・ロケールと異なる場合があります。1 台の Content Manager コンピューターでグローバル設定を変更した場合は、他の Content Manager コンピューターでも同様の変更を行う必要があります。

次の場合、グローバル設定を変更します。

v ユーザー・インターフェース用にサポートする言語をカスタマイズする場合

v サポートする通貨をカスタマイズする場合

v コンテンツ・ロケール・サポートをカスタマイズする場合

v ユーザー・インターフェースで使用される言語をマッピングする場合

v コンテンツ・ロケールをマッピングする場合

v IBM Cognos 環境にフォントを追加する場合

v デフォルトのタイム・ゾーンをカスタマイズする場合

v E メール・メッセージのエンコード方式を変更する場合

v Cookie 設定をカスタマイズする場合


サポートする言語のユーザー・インターフェースでのカスタマイズユーザー・インターフェースでサポートする言語を追加または削除するには、"ユーザー・インターフェースのロケール"テーブルを使用します。例えば、ドイツ語のユーザー・インターフェースが不要な場合は、リストからドイツ語を削除します。

ユーザー・インターフェース言語を変更しても、データには影響しません。

始める前に



ます。


3. 「ユーザー・インターフェースのロケール」タブをクリックします。

サポートされているすべてのロケールが表示されます。


ヒント: サポートを削除するには、「サポートされているロケール」の隣にあるチェック・ボックスをオンにし、「削除」をクリックします。

5. 第 2 列にロケールの言語部分を入力します。

6. その他にもサポートする言語を追加する場合は、それぞれ手順 3～5 を繰り返します。



サポートする通貨のカスタマイズユーザー・インターフェース用にサポートする通貨を追加または削除するには、通貨表にある、サポートされている通貨のリストを更新します。日本や韓国の通貨を使用する場合は、日本円や韓国ウォンの文字が正しく表示されるように設定する必要があります。

IBM Cognos コンポーネントにおいて、デフォルトでユーザー・インターフェースに表示されるのは、サポートされている通貨のサブセットのみです。通貨は ISO4217 通貨コードで識別されます。サポート対象として追加できる通貨のリストは、"<インストール場所>/bin"ディレクトリーの"i18n_res.xml"ファイル内にあります。

通貨を IBM Cognos 環境に追加しても、通貨を表示する文字とフォントがコンピューターにインストールされるわけではありません。使用する通貨記号をサポートする適切なフォントをインストールする必要があります。例えば、インドの通貨記号(ルピー) を正しく表示するには、その文字を含むフォントをインストールします。また、日本と韓国の通貨記号を正しく表示するには、Supplementary LanguageDocumentation ディスクから追加のフォントをインストールする必要があります。


ユーザー・インターフェースへの通貨の追加サポートされる通貨またはサポートされない通貨をユーザー・インターフェースに追加できます。サポートされる通貨は IBM Cognos Configuration で追加します。サポートされない通貨は IBM Cognos に含まれる"i18n_res.xml"ファイルに追加します。

IBM Cognos でサポートされていない通貨コードは、"<インストールの場所>/bin"ディレクトリーの"i18n_res.xml"ファイルに手動で追加する必要があります。このファイルを、IBM Cognos がインストールされている各コンピューターにコピーします。

手順



3. 「通貨」タブをクリックします。


ヒント: サポートを削除するには、サポートされているアイテムの隣にあるチェック・ボックスをオンにし、「削除」をクリックします。

5. 第 2 列に適切な値を入力します。

通貨や形式を表すために追加する値には、ISO 4217 コードを使用する必要があります。通常、ここで追加する値は 3 文字のアルファベットです。先頭の 2 文字は、ISO 3166 で規定されている、通貨発行国または地域の国コードまたは地域コードを表す文字です。 3 番目の文字は通貨の先頭の文字を表します。

6. その他にもサポートする通貨を追加する場合は、それぞれ手順 3～5 を繰り返します。


コンテンツ・ロケールのサポートのカスタマイズレポート、データ、またはメタデータをユーザー指定言語で表示する場合、またはユーザーの地域に固有のレポート、データ、またはメタデータを表示する場合、ロケールの一部 (言語) またはロケール全体 (言語 - 地域) をコンテンツ・ロケール・テーブルに追加します。データを異なる言語や異なるロケールで使用できる場合、そのデータはユーザー・ロケールに基づいて表示されます。デフォルトでは、コンテンツの一部において、コンテンツ・ロケールでポータルのユーザー・インターフェースのロケールが上書きされます。

タイ語で記述されているレポートを表示するときには、数字がサポートされません。

始める前に

不要なロケールはリストから削除できます。アプリケーション層コンポーネントが正しく機能するために、リストに 1 つ以上のコンテンツ・ロケールを残しておく必要があります。


不足しているロケール (言語) を IBM Cognos 環境に追加しても、指定言語でWeb ページを表示するためのフォントが、ユーザーのコンピューターにインストールされていることが保証されるわけではありません。使用する文字セットと通貨記号をサポートする適切なフォントがインストールされていることを確認してください。日本と韓国の通貨記号を正しく表示するには、Supplementary LanguageDocumentation ディスクから追加のフォントをインストールする必要があります。


ます。


3. 「コンテンツ・ロケール」タブをクリックします。

サポートされているすべてのロケールが表示されます。


ヒント: サポートを削除するには、サポートされているアイテムの隣にあるチェック・ボックスをオンにし、「削除」をクリックします。

5. 第 2 列に適切な値を入力します。

v レポート・データおよびメタデータの表示に使用する言語をサポート対象として追加するには、ロケール (言語) 設定の一部を入力します。

v 地域固有のサポートを追加するには、ロケール設定全体 (言語 - 地域) を入力します。

6. サポート対象となる追加の各ロケールに対して、手順 3～5 を繰り返します。


コンテンツ・ロケールユーザー・ロケールをロケール全体 (言語 - 地域) またはロケールの一部 (言語) にマッピングするには、コンテンツ・ロケール Mappings テーブルを使用します。データをユーザー指定言語で表示できない場合、ユーザー指定言語を別の言語にマッピングすることもできます。

例えば、あるレポートまたはスコアカードをユーザー指定言語 (例: ベトナム語) では表示できないが、フランス語とドイツ語では表示できる場合、コンテンツ・ロケール Mappings テーブルを使用して、ユーザー指定言語 (ベトナム語) を別の言語(フランス語またはドイツ語) にマップできます。このマッピングにより、マッピングした言語でレポートまたはスコアカードが表示されます。

デフォルトでは、コンテンツ・ロケール Mappings テーブルには地域を含まないロケールが格納されています。つまり、ロケール設定を指定する際にロケールの言語部分のみを使用できるため、常に正しい情報を確認できます。例えば、一般に多言語データベース内のデータの表示は、フランス語 (fr)、スペイン語 (es)、英語 (en)などの言語によって行われます。英語 - カナダ (en-ca)、英語 - 米国 (en-us)、フランス語 - フランス (fr-fr) などのロケールで表示されるわけではありません。


次の例は、複数の言語バージョンが使用可能な場合に、ユーザーに表示されるレポートまたはスコアカードを IBM Cognos コンポーネントで判別する方法を示しています。

例 1

Content Manager で使用できるレポートが、en-us (英語 - 米国) および fr-fr (フランス語 - フランス) という 2 つのロケールで表示可能であるが、ユーザー・ロケールが fr-ca (フランス語 - カナダ) に設定されているとします。この場合、IBMCognos では、ユーザーに表示されるレポートがロケール・マッピングを使用して判別されます。

まず、IBM Cognos では Content Manager を使用してユーザー・ロケールでレポートを表示可能かどうかが確認されます。ユーザー・ロケールで表示できない場合、ユーザー・ロケールは「コンテンツ・ロケール・マッピング」タブで設定された標準ロケールにマッピングされます。ここではユーザーのロケールが fr-ca なので、fr にマッピングされます。IBM Cognos はマッピングされた値を使用して、レポートが fr で使用可能かどうか確認します。このケースでは、レポートは en-usと fr-fr で使用できますが、fr では使用できません。

次に、表示可能な各レポートが標準ロケールにマッピングされます。したがって、en-us は en になり、fr-fr は fr になります。

レポートとユーザー・ロケールの両方が fr にマッピングされるため、ユーザー・ロケールが fr-ca であるユーザーは、ロケール fr-fr で保存されたレポートを表示できます。

例 2

ユーザー・ロケールとレポート・ロケールがすべて同じ言語にマッピングされているとします。この場合、IBM Cognos によって使用するロケールが選択されます。例えば、ユーザー・ロケールが en-ca (英語 - カナダ) で、レポートが en-us (英語- 米国) および en-gb (英語 - イギリス) で表示できる場合、IBM Cognos によって各ロケールが en にマッピングされます。レポートは、IBM Cognos で選択されたロケール設定で表示されます。

例 3

レポート・ロケールとユーザー・ロケールが同じ言語にマッピングされていないとします。この場合、IBM Cognos によって言語が選択されます。また、ユーザーがマッピングを設定することもできます。例えば、レポートが en-us (英語 - 米国)および fr-fr (フランス語 - フランス) で表示可能であるが、ユーザー・ロケールはes-es (スペイン語 - スペイン) である場合、IBM Cognos によって言語が選択されます。

コンテンツ・ロケールのマッピングユーザー・ロケールをロケール全体 (言語 - 地域) またはロケールの一部 (言語) にマッピングするには、コンテンツ・ロケール Mappings テーブルを使用します。データをユーザー指定言語で表示できない場合、ユーザー指定言語を別の言語にマッピングすることもできます。


手順



3. 「コンテンツ・ロケール・マッピング」タブをクリックします。


5. 「キー」ボックスにユーザー・ロケールを入力します。

v ユーザー・ロケールのどの地域に対しても特定の言語でデータを表示するには、ロケールの言語部分を入力し、その後ろにダッシュ (-) とアスタリスク(*) を付けます。

例えば、「fr-*」と入力します。

v あるユーザー・ロケール (言語 - 地域) に対して特定の言語でデータを表示するには、ロケール全体を入力します。

例えば、「fr-ch」と入力します。

v ユーザー指定言語を別の言語にマッピングするには、ロケールのユーザー指定言語の部分を入力します。

例えば、「zh」と入力します。

ヒント: キーの範囲として使用するロケールを指定するには、「キー」の値にワイルドカード文字 (*) を入力し、「ロケール・マッピング」ボックスにそのロケールを入力します。例えば、ドイツのすべてのキーにドイツのロケールを使用するには、「キー」ボックスに「de*」と入力し、「ロケール・マッピング」ボックスに入力します。

6. 「ロケール・マッピング」ボックスに、ロケールの言語部分を入力します。

「キー」ボックスでユーザー・ロケールを指定すると、この言語でデータが表示されます。

7. その他にもマッピングするものがあれば、それぞれ手順 3～5 を繰り返します。



ユーザー・インターフェースのロケールのマッピングユーザー・ロケールで指定した言語が使用できない場合に、ユーザー・インターフェースで使用する言語を指定するには、「ユーザー・インターフェースのロケール・マッピング」テーブルを使用します。

ロケールのどの地域に対しても同じ言語を使用するか、または特定のロケール全体(言語 - 地域) に対して特定の言語を使用できます。

デフォルトでは、ユーザー・ロケールの言語設定と一致する言語でユーザー・インターフェースが表示されます。



ます。


3. 「ユーザー・インターフェースのロケール・マッピング」タブをクリックします。


5. 「キー」ボックスにユーザー・ロケールを入力します。

v ロケールのどの地域に対しても特定の言語でユーザー・インターフェースを表示するには、ロケールの言語部分を入力し、その後ろにダッシュ (-) とアスタリスク (*) を付けます。

例えば、「es-*」と入力します。

v ロケール全体 (言語 - 地域) に対して特定の言語でユーザー・インターフェースを表示するには、ロケール全体を入力します。

例えば、「es-es」と入力します。

v ユーザー指定言語を別の言語にマッピングするには、ロケールのユーザー指定言語の部分を入力します。

例えば、「zh」と入力します。

ヒント: デフォルトで使用するロケールを指定するには、「キー」の値にワイルドカード文字 (*) を入力し、「ロケール・マッピング」ボックスにロケールを入力します。

6. 「ロケール・マッピング」ボックスに、ロケールの言語部分を入力します。

「キー」ボックスでユーザー・ロケールを指定すると、この言語でデータが表示されます。

7. その他にもマッピングするものがあれば、それぞれ手順 3～5 を繰り返します。



サーバー・タイム・ゾーンのカスタマイズContent Manager で使用されるタイム・ゾーンをカスタマイズするには、IBMCognos Configuration で異なるサーバー・タイム・ゾーンを選択します。

Java ベースのグラフィカル・ユーザー・インターフェースがサポートされていないUNIX インストール環境では、Framework Manager がインストールされているWindows コンピューターで IBM Cognos Configuration を開くことにより、使用可能なタイム・ゾーンのリストを表示できます。

Content Manager は、デフォルトでオペレーティング・システムのタイム・ゾーンを使用するように設定されています。IBM Cognos でスケジュールされるすべての処理は、このタイム・ゾーンを使用して設定されます。また、ポータルのユーザーは、デフォルトのタイム・ゾーンを使用するように設定を設定している場合、この


タイム・ゾーンを使用することになります。ポータルのユーザー設定について詳しくは、「IBM Cognos Analytics管理およびセキュリティー・ガイド」を参照してください。




4. 「サーバー・タイム・ゾーン」の「値」列をクリックし、リストからタイム・ゾーンを選択します。


E メール・メッセージのエンコード方式IBM Cognos コンポーネントでは、デフォルトで UTF-8 エンコード方式が E メールに使用されます。この値により、すべての E メール・メッセージのこのインスタンスに、Delivery サービスによって使用されるデフォルトのエンコード方式が設定されます。古い E メール・クライアントを使用する場合や、IBM Cognos からUTF-8 を認識しない携帯電話や PDA に E メールを送信する場合は、E メールのエンコード方式をすべての E メール・クライアントで動作する値 (例:ISO-8859-1、Shift-JIS) に変更できます。使用可能な Delivery サービスのある IBMCognos の各インスタンスについて、変更を行う必要があります。

指定されたエンコード方式は、件名、添付ファイル、添付ファイル名、プレーン・テキストまたは HTML の本文テキストを含むメッセージ全体に影響を及ぼします。

次の表にエンコード方式の値を示します。

表 36. サポートされているエンコード値

文字セットサポートされているエンコード値

UTF-8 utf-8

西ヨーロッパ言語 (ISO 8859-1) iso-8859-1

西ヨーロッパ言語 (ISO 8859-15) iso-8859-15

西ヨーロッパ言語 (Windows-1252) windows-1252

中央ヨーロッパおよび東ヨーロッパ言語(ISO 8859-2)

iso-8859-2

中央ヨーロッパおよび東ヨーロッパ言語(Windows-1250)

windows-1250

キリル語 (ISO 8859-5) iso-8859-5

キリル語 (Windows-1251) windows-1251

トルコ語 (ISO 8859-9) iso-8859-9

トルコ語 (Windows-1254) windows-1254

ギリシャ語 (ISO 8859-7) iso-8859-7

ギリシャ語 (Windows-1253) windows-1253

日本語 (EUC-JP) euc-jp

日本語 (ISO-2022-JP) iso-2202-jp


表 36. サポートされているエンコード値 (続き)

文字セットサポートされているエンコード値

日本語 (Shift-JIS) shift_jis

繁体字中国語 (Big5) big5

簡体字中国語 (GB-2312) gb2312

韓国語 (EUC-KR) euc-kr

韓国語 (ISO 2022-KR) ISO 2022-KR

韓国語 (KSC-5601) ksc_5601

タイ語 (Windows-874) windows-874

タイ語 (TIS-620) tis-620

E メール・メッセージのエンコード方式の変更E メールのエンコード方式をすべての E メール・クライアントで動作する値に変更できます。

手順




4. 「E メールのエンコード方式」プロパティーの「値」列をクリックします。

5. 目的の設定までスクロールし、クリックします。


Cookie 設定のカスタマイズIBM Cognos 環境の要件に応じて、IBM Cognos コンポーネントで Cookie の作成に関する設定を変更する場合があります。IBM Cognos Configuration を使用して、Cookie のドメイン、パス、安全なフラグをカスタマイズできます。

IBM Cognos コンポーネントでは、クライアントによって送信された HTTP 要求から Cookie ドメインが決定されます。クライアントは通常、Web ブラウザーです。ほとんどのネットワーク設定では、HTTP 要求は、ブラウザーから IBMCognos コンポーネントに転送されるときに、プロキシー・サーバーやファイアウォールなどの中継点を通過します。この場合、IBM Cognos コンポーネントでCookie ドメインの計算に使用される情報が一部の中継点によって変更されるため、IBM Cognos コンポーネントが Cookie を設定できなくなることがあります。ほとんどの場合、この問題が原因となり、ユーザーが繰り返しログオンするように求められるという現象が発生します。この問題を回避するには、Cookie ドメインを設定します。

Cookie ドメインに正しい値を設定するには、次の提案どおりに、最も広いホストの範囲を指す形式と値を使用します。

v ドメイン値には、コンピューターまたはサーバー名のみを使用します。この名前は、ドットを使用せずに指定します。例: mycompany。


v ドメイン値には、接尾辞を指定することもできます。接尾辞は、.com、.edu、.gov、.int、.mil、.net、または .org です。接頭辞のドットを含めます。例: .mycompany.com。

v ドメイン値では他のレベルを使用できます。接頭辞にドットを含めます。例:.accounts.mycompany.com。

v パス値は、Cookie をさらに制限できます。最も一般的なパスは / です。パス/payables は、Cookie を "payable" で始まるすべてのパス (およびすべてのサブディレクトリー) に制限します。パス /payables/ は、Cookie を "payables"ディレクトリー (およびすべてのサブディレクトリー) に制限します。

さらにセキュリティーのために、管理者は HTTPOnly 属性を設定して、Web ブラウザーを使用するユーザーのセッション中に、スクリプトによる CAM パスポートcookie の読み取りや操作をブロックすることができます。この属性について詳しくは、IBM Cognos Analytics「管理およびセキュリティー・ガイド」を参照してください。


ます。


3. 「全般」タブをクリックします。

4. 変更する各プロパティーの「Cookie 設定」の「値」列をクリックし、新しい値を指定します。

「ドメイン」プロパティーを空白のままにしておくと、ディスパッチャーによって要求のホスト名からドメインが取得されます。


IP アドレスのバージョンの変更IBM Cognos 製品では、IPv4 と IPv6 の 2 つの IP アドレス・バージョンがサポートされています。 IPv4 では 32 ビットの IP アドレスが使用され、IPv6 では128 ビットの IP アドレスが使用されます。


v IPv4: 192.168.0.1:80

v IPv6: [2001:0db8:0000:0000:0000:148:57ab]:80

IBM Cognos Configuration の「ホスト名解決に使用する IP のバージョン」プロパティーを使用して、IBM Cognos の通信用に IPv4 または IPv6 を選択できます。デフォルトでは、IPv4 が使用されます。

この設定は、設定が行われたコンピューターのみに適用されます。「IPv4 アドレスを使用」を選択すると、そのコンピューター上の IBM Cognos からの発信接続がすべて IPv4 を使用して確立され、ディスパッチャーでは IPv4 の着信接続のみを受信するようになります。「IPv6 アドレスを使用」を選択すると、そのコンピューター上の IBM Cognos からの発信接続がすべて IPv6 を使用して確立され、ディスパッチャーでは IPv4 と IPv6 の両方の着信接続を受信するようになります。


IPv4 クライアント・コンピューターは IPv6 用に設定されたディスパッチャー・コンピューターと通信できます。

URI に指定されたホスト名は、「ホスト名解決に使用する IP のバージョン」プロパティーの値に基づいて解決されます。ただし、数字のアドレスが URI に指定されている場合は、その指定がこのプロパティーの設定よりも優先され、IPv4 を使用して通信が行われます。

IBM Cognos Configuration でローカル URI プロパティーの IPv6 アドレスを使用できるようにするには、-ipv6 オプションを指定して IBM CognosConfiguration を起動する必要があります。コマンド行から IBM CognosConfiguration を開くたびに、このオプションを指定できます。

Windows の「スタート」メニューのショートカットにこのオプションを追加することで、このオプションを恒久的に設定できます。

IP バージョンの設定IBM Cognos Configuration を使用して IP バージョンを選択します。



3. 「ホスト名解決に使用する IP のバージョン」の「値」ボックスをクリックし、「IPv4 アドレスを使用」または「IPv6 アドレスを使用」をクリックします。


5. IBM Cognos Configuration を閉じます。

IPv6 オプションを使って開始するように IBM CognosConfiguration を手動で設定する

開始コマンドでオプションを指定することにより、IPv6 オプションを使用するように IBM Cognos Configuration を手動で設定できます。

手順1. <インストールの場所>/bin または <インストールの場所>/bin64 ディレクトリ

ーに移動します。

2. 次のように IPv6 オプションをコマンドに含めることで、IBM CognosConfiguration を起動します。

v Windows の場合は、次のように入力します。

cogconfig.bat -ipv6

v UNIX または Linux の場合は、次のように入力します。

./cogconfig.sh -ipv6

3. IPv6 形式を使用する URI プロパティーを編集し、値を指定します。次に、「ファイル」メニューの「保存」をクリックします。


Windows 上で常に IPv6 オプションを使って開始するようにIBM Cognos Configuration を設定する

「スタート」メニューのショートカットのオプションを設定することにより、Microsoft Windows オペレーティング・システムで常に IPv6 オプションを使用するように IBM Cognos Configuration を設定できます。

手順1. 「スタート」メニューで、「IBM Cognos Configuration」を右クリックして、

「プロパティー」を選択します。

2. 「ショートカット」タブの「リンク先」ボックスに次のように入力します。 "<インストールの場所>¥bin¥cogconfigw.exe -ipv6"


Collaboration ディスカバリー URI の設定コラボレーションによる意思決定に IBM Connections を使用するように、IBMCognos Analytics および IBM Cognos Workspace を設定できます。IBMConnections との統合によって、ビジネス・ユーザーは、レポートの作成や閲覧、分析の実行、ワークスペースの監視を行いながら共同作業を行えます。ユーザーは、IBM Cognos Workspace 内から IBM Connections アクティビティーにアクセスし、IBM Cognos Analytics および IBM Cognos Workspace 内から IBMConnections のホーム・ページにアクセスできます。

Collaboration ディスカバリー URI は、コラボレーション・プロバイダーとして使用する IBM Connections サーバーを指定します。URI を指定すると、コラボレーション関連のサポートが IBM Cognos Analytics に次のように追加されます。

v リンクが IBM Cognos Analytics ポータルの「ようこそ」ページに追加される。ユーザーに IBM Connections のホーム・ページへのアクセス権がある場合、リンクは「個人用ソーシャル・ネットワークにアクセス」という名前になり、ユーザーはホーム・ページにリンクできます。ユーザーに IBM Connection アクティビティーへのアクセス権はあるものの、ホーム・ページへのアクセス権がない場合、リンクは「マイ・アクティビティー」という名前になり、ユーザーはアクティビティー・ページにアクセスできます。

v IBM Connections のホーム・ページへのリンクがポータルの「起動」メニューに追加される。

v IBM Connections のホーム・ページへのリンクが IBM Cognos Workspace の「操作」メニューに追加される。

v IBM Cognos Workspace のワークスペース・アプリケーション・バー上に「共同作業」メニュー・ボタンが追加される。この結果、ユーザーは、IBMConnections でワークスペース・アクティビティーを作成または表示できるようになります。

手順1. 「IBM Cognos Administration」の「設定」タブで、「ディスパッチャーとサ

ービス」をクリックしてディスパッチャーのリストを表示します。

2. ツールバーで、「プロパティーを設定」設定ボタンをクリックします。


3. 「設定」タブをクリックします。

4. 「環境」カテゴリーの「Collaboration ディスカバリー URI」に、URI を次のように指定します。

http://server_name:port_number/activities/serviceconfigs

例えば、http://server_name:9080/activities/serviceconfigs

<サーバー名> は、IBM Connections がインストールされているサーバー名を表します。


IBM Cognos Workspace の設定IBM Cognos Workspace は、IBM Cognos Analytics サーバーに付属しています。IBM Cognos Business Insight は、IBM Cognos コンテンツおよび外部データ・ソースを使用して双方向のワークスペースを素早く簡単に組み立てることを可能にする、動的でカスタマイズ可能な機能を実現します。IBM Cognos Workspace が実行中であることを確認した後、保護されている機能と特性に対するアクセス権を設定します。

次の設定作業を完了します。

__ v IBM Cognos Workspace へのアクセスの設定。

__ v Microsoft インターネットインフォメーションサービスでサポートされるMIME タイプの設定。

設定作業を完了した後は、必要に応じて次の作業を実行できます。

__ v 注釈用のデータベースのセットアップ。

__ v TM1 データ・サーバーのコンテンツを使用するように IBM CognosWorkspace を設定します。

__ v IBM Cognos TM1 Contributor にアクセスするように IBM CognosWorkspace を設定します。

__ v レポートのスタイルの変更。

__ v サンプルの使用。

IBM Cognos Workspace やその機能に対するアクセス権の設定IBM Cognos Workspace に対するアクセス権を設定するには、「エグゼクティブ・ダッシュボード」機能に対して必要な権限を特定のネームスペース、ユーザー、グループ、または役割に付与します。

IBM Cognos Workspace に対する完全なアクセス権のほか、アクセスを発行機能に限定したアクセス権を付与できます。

IBM Cognos Workspace に対するアクセス権を設定するには、IBM CognosAnalytics を設定して起動する必要があります。


IBM Cognos Workspace に対する完全なアクセス権の付与IBM Cognos Workspace とそのすべての機能に対するアクセス権を付与するには、「エグゼクティブ・ダッシュボード」機能に対する実行権限と通過権限を付与します。

ユーザーのアクセス権の構成に関する追加情報は、IBM Web サイトの技術情報(www.ibm.com/support/docview.wss?uid=swg21498402) で見つかります。

手順

1. IBM Cognos Analytics ポータルから IBM Cognos Administration を起動します。

2. 「セキュリティー」タブで「機能」をクリックします。

3. 「エグゼクティブ・ダッシュボード」機能を探し、機能名の横にある「操作」ボ

タン

をクリックして、「プロパティーを設定」を選択します。

4. 「権限」タブを選択します。

5. IBM Cognos Workspace にアクセスする必要があるすべてのユーザー・グループに実行権限を付与し、「OK」をクリックします。

IBM Cognos Workspace に対する発行機能へのアクセス権の付与IBM Cognos Workspace 内の発行機能にのみアクセスを許可するには、「エグゼクティブ・ダッシュボード」機能に対する通過権限と、保護されている機能である「コラボレーション・スペースへのダッシュボードの発行」に対する実行権限を付与します。

手順

1. IBM Cognos Analytics ポータルから IBM Cognos Administration を起動します。

2. 「セキュリティー」タブで「機能」をクリックします。

3. 「エグゼクティブ・ダッシュボード」機能を探して選択します。

4. 「コラボレーション・スペースへのダッシュボードの発行」の横にある「操作」

ボタン

をクリックし、「プロパティーを設定」をクリックします。

5. 「権限」タブを選択します。

6. 各エントリーに対するアクセス権を明示的に設定するには、「親エントリーから取得したアクセス権をオーバーライド」を選択します。

7. 各ユーザー・グループについて、エントリーのチェック・ボックスをオンにし、リストの横にあるボックスのチェック・ボックスをオンにしてエントリーに対する権限を付与します。

8. リストに新しいエントリーを追加するには、「追加」をクリックし、エントリーの選択方法を次の中から選択します。

v 表示されているエントリーから選択するには、適切なネームスペースをクリックし、ユーザー、グループ、または役割の横にあるチェック・ボックスをオンにします。



v エントリーを検索するには、「検索」をクリックし、「検索文字列」ボックスに検索語句を入力します。検索オプションを指定するには、「編集」をクリックします。目的のエントリーを検索してクリックします。

v 追加するエントリーの名前を入力するには、「名前を入力」をクリックし、「namespace/group_name;namespace/role_name;namespace/user_name;」の形式でグループ、役割、またはユーザーの名前を入力します。エントリーの間は半角のセミコロン (;) で区切ります。

その後、新しい各エントリーに適切な権限を付与できます。


Microsoft インターネットインフォメーションサービスでサポートされる MIME タイプの設定

Microsoft Internet Information Services (IIS)6.0 を使用している場合、IBMCognos Workspace を正しくロードするには、IBM Cognos Workspace で使用される MIME タイプを定義する必要があります。

手順1. Microsoft IIS 管理コンソールを開きます。

2. ローカル・コンピューター名を右クリックし、「プロパティー」をクリックします。

3. 「MIME タイプ」をクリックします。

4. 「新規作成」をクリックします。

5. 「拡張子」ボックスに「.cfg」と入力します。

6. 「MIME タイプ」ボックスに「text/plain」と入力します。

7. 新しい設定を適用します。

変更は、ワーカー・プロセスのリサイクル時に有効になります。すぐに有効にするには、World Wide Web 発行サービスを再起動します。詳細については、Microsoft オンライン・ライブラリーで「Handling MIME Types in InternetExplorer」を検索してください。

z/OS 上の IBM Db2 での Human Task と Annotation データベース用の表スペースの作成

z/OS 上の Db2 を使用している場合、データベース管理者はスクリプトを実行して、Human Task と Annotation データベースに必要な表スペースを作成する必要があります。プレースホルダー・パラメーターを環境に適したものに置き換えるように、スクリプトを変更する必要があります。

必ず z/OS 上の Db2 用の命名規則を使用してください。例えば、パラメーター名はすべて文字で始まり、6 文字以下でなければなりません。詳しくは、Db2Knowledge Center を参照してください。

Content Store データベースまたは別のデータベースを Human Task とAnnotation データベースに対して使用できます。いずれの場合でも、表スペースを作成するスクリプトを実行する必要があります。


手順1. 表スペースの作成と削除の権限、および SQL 文の実行を許可する権限のあるユ

ーザーとしてデータベースに接続します。

2. Human Task の表スペースを作成するには、インストールの場所/configuration/schemas/hts/zosdb2 ディレクトリーに移動します。

a. HTS_tablespaces.sql スクリプト・ファイルのバックアップ・コピーを作成して、そのファイルを別の場所に保存します。

b. 元の HTS_TABLESPACES.sql スクリプト・ファイルを開き、次の表を参考にして、汎用パラメーターを環境に適した汎用パラメーターに置き換えます。



NCCOG データベースの名前を指定する。


BP32K 32 K のバッファー・プールの名前を指定します。



d. HTS2_CREATE_Db2zos.sql スクリプト・ファイルを開き、次の表を参考にして、汎用パラメーターを環境に適した汎用パラメーターに置き換えます。






3. Annotation の表スペースを作成するには、インストールの場所/configuration/schemas/ans/zosdb2 ディレクトリーに移動します。

a. ANN_TABLESPACES.sql スクリプト・ファイルのバックアップ・コピーを作成して、そのファイルを別の場所に保存します。

b. 元の ANN_TABLESPACES.sql スクリプト・ファイルを開き、次の表を参考にして、汎用パラメーターを環境に適した汎用パラメーターに置き換えます。




DSN8G810 ストレージ・グループの名前。

BP32K 32 K バッファー・プールの名前。




d. ANS2_CREATE_Db2zos.sql スクリプト・ファイルを開き、次の表を参考にして、汎用パラメーターを環境に適した汎用パラメーターに置き換えます。






ヒューマン・タスクおよび注釈用のデータベースの設定デフォルトでは、IBM Cognos Workspace のヒューマン・タスク機能と注釈機能で使用されるデータは、Content Store と同じデータベースに格納されます。ヒューマン・タスクおよび注釈用に別のデータベースを設定できます。

データベースを設定するには、最初にデータベースを作成し、データベースの操作に使用するユーザー・アカウントを作成して、ヒューマン・タスク機能と注釈機能で新しいデータベースが使用されるように設定します。

手順1. 8 ページの『Content Store を作成する際のガイドライン』と同じ手順で、デ

ータベースを作成します。

z/OS 上の IBM Db2 をデータベースとして使用する場合は、スクリプトを 2つ実行して、必要な表スペースを作成する必要があります。詳細については、254 ページの『z/OS 上の IBM Db2 での Human Task と Annotation データベース用の表スペースの作成』を参照してください。

2. データベースの操作に使用するユーザー・アカウントを作成します。

3. アプリケーション層コンポーネントがインストールされているインスタンスで、IBM Cognos Configuration を起動します。

4. 「エクスプローラー」で、「Human Task サービスと Annotation サービス」を右クリックし、「リソースの新規作成」>「データベース」の順に選択します。

5. 「リソースを新規作成 - データベース」ダイアログ・ボックスに、データベース名を入力し、タイプを選択して、「OK」をクリックします。

6. データベース・リソースのプロパティー・ウィンドウで、次の項目を設定します。

v アスタリスクの付いているすべての必須プロパティー

v データベースを操作するアカウントの「ユーザー ID とパスワード」



8. 新しいデータベースへの接続をテストするには、「操作」メニューの「テスト」をクリックします。

9. 各アプリケーション層コンポーネントおよび Content Manager インスタンスに対して、この手順を繰り返します。


IBM Cognos TM1 データを使用するための IBM CognosWorkspace の設定

IBM Cognos Workspace で IBM Cognos TM1 データを使用できるようにするには、ご使用の IBM Cognos Analytics インストール済み環境の設定ファイルを変更する必要があります。

TM1 データ・サーバーを IBM Cognos Workspace 用に設定するには、次のタスクを実行する必要があります。

__ v TM1 Server に接続情報を設定する。

__ v IBM Cognos TM1 サーバーの名前が IBM Cognos Workspace で表示されるように名前を設定する。

__ v オプションで、表示フォルダーの名前を変更する。

TM1 Server への接続情報の設定ご使用の TM1 Server に接続情報を設定するために、設定ファイルを変更する必要があります。

IBM Cognos Analytics インストール環境には、作成アイテム・ファイルのサンプルが用意されています。分散インストール環境を使用している場合、設定ファイルはアプリケーション層コンポーネントをインストールしたコンピューターにあります。

IBM Cognos Analytics ゲートウェイが TM1 Web とは異なるコンピューター上で稼働している場合は、TM1WebHost などのサーバー名の値に完全修飾ドメイン名を使用するようにしてください。例えば、http://mycomputer/ibmcognos ではなく、http://mycomputer.mydomain.com/ibmcognos を使用します。また、IBM CognosConfiguration の「環境」セクション内のサーバー名の値にも完全修飾ドメイン名を使用する必要があります。

手順

1. IBM Cognos Analytics アプリケーション層コンポーネントがインストールされているコンピューターで、Application Tier Components, go to the <インストールの場所>¥configuration¥icd¥contributions¥contrib ディレクトリーに移動し、tm1_contribution.atom.sample ファイルの名前をtm1_contribution.atom に変更します。

2. テキスト・エディターで tm1_contribution.atom ファイルを開きます。

このファイルには、3 つの <atom:entry> セクションが含まれています。 IBMCognos Workspace にアクセスするには、各 TM1 サーバーで、1 つの<atom:entry> セクションの値を変更する必要があります。TM1 サーバーを追加しようとする場合は、必要に応じて <atom:entry> セクションを追加します。また、余分な <atom:entry> セクションはコメント化する必要があります。サンプル・ファイルの 3 つ目の <atom:entry> セクションは、既にコメント化されています。

最初の <atom:entry> セクションは、Cognos 認証を使用しない TM1 サーバー用です。


2 つ目の <atom:entry> セクションは、Cognos 認証を使用する TM1 サーバー用です。

3. 必要な認証に適した <atom:entry> セクションの TM1WebHostName 値とTM1HostName 値を TM1 Web サーバーと TM1 データ・サーバーの名前と IPアドレスに置き換えます。

例えば、サンプルの強調表示されたセクションを変更します。

TM1WebHost=TM1WebHostName&TM1WebVirtualDirectory=tm1web&TM1Host=TM1HostName&

4. IBM Cognos 認証を必要としない TM1 サーバーの場合は、TM1DataServer 値に対して強調表示されたセクションを次のように変更します。

TM1DataServer=TM1ServerHostWithoutCAM&TM1username=admin&TM1pass=apple

admin および apple を、TM1 サーバーに使用する管理者アカウントのユーザー ID とパスワードに置き換えます。

5. IBM Cognos 認証を使用する TM1 サーバーの場合は、TM1DataServer 値に対して強調表示されたセクションを次のように変更します。

TM1DataServer=CamAuthenticatedTM1ServerHost

6. デフォルト値を使用しない場合は、次のプロパティーを変更します。

v https

このプロパティーは、TM1 Web サーバーに使用されるプロトコルを記述します。HTTP セキュアを使用して TM1 Web を実行している場合は、0 を1 に置き換えます。

v TM1WebVirtualDirectory

このプロパティーは、TM1 Web の仮想ディレクトリーの名前です。TM1Web ディレクトリーの名前が"tm1web"でない場合は、"TM1WebVirtualDirectory"プロパティーの値を正しい名前に置き換えます。


TM1WebVirtualDirectory=planningweb&

v TM1Toolbar

このプロパティーは、内部ツールバーが表示されるかどうかを指定します。バージョン 9.5.2 より前の TM1Web のバージョンでは、外部ツールバーは許可されません。TM1Toolbar のデフォルト値は 0 です。内部ツールバーを表示するには、この値を 1 に設定します。

7. 複数の TM1 サーバー接続を定義している場合は、それぞれの TM1 サーバーに <atom:entry> セクションを 1 つずつ作成します。

すべての .atom エントリーに含まれるすべての atom:id 値はそれぞれ固有でなければなりません。例えば、次のようになります。

<atom:entry><atom:id>tag:ibm.cognos.icd.com,2010-01-01:/tm1_rootfeed_2

</atom:id>


<atom:entry><atom:id>tag:ibm.cognos.icd.com,2010-01-01:/tm1_rootfeed_2b

</atom:id>

サンプルは、tm1_rootfeed_2 および tm1_rootfeed_2b のために固有です。

tm1_rootfeed_1、rootfeed_title_1、rootfeed_summary_1 などの値には、必ず固有の名前を使用するようにしてください。

8. 使用しない <atom:entry> セクションは、必ずコメント化か削除をしてください。


10. IBM Cognos サービスを再始動します。IBM Cognos Workspace に表示される TM1 サーバーの名前を変更する場合は、次のタスクの後でサービスを再始動するとできます。

IBM Cognos TM1 サーバーの名前の設定ご使用の TM1 サーバーの名前を、IBM Cognos Workspace に表示するように定義することができます。

英語以外の言語を使用している場合は、別の言語のファイルを作成して、その名前を IBM Cognos Workspace に表示することができます。

手順

1. IBM Cognos Analytics アプリケーション層コンポーネントがインストールされているコンピューターで、<インストールの場所>¥configuration¥icd¥contributions¥contrib ディレクトリーに移動します。

2. テキスト・エディターで tm1_en.properties というファイルを開きます。

3. 等号 (=) の後のテキストを変更して、タイトルに定義されている TM1 サーバーに、意味を表す名前を付けます。

例えば、前のタスクで tm1_contribution.atom ファイルの rootfeed_title_1セクションを使用して TM1 サーバー接続を定義した場合は、名前を次のように変更します。

rootfeed_title_1 = MyTM1Server

4. rootfeed_summary_1 プロパティーの記述を、TM1 サーバーを説明するものに変更します。

例えば、TM1 サーバー接続の名前を rootfeed_title_1 を使用して定義した場合、 rootfeed_summary_1 の値を次のように変更します。

rootfeed_summary_1 = Detail about MyTM1Server

5. 前のタスクで、tm1_contribution.atom ファイルで追加した TM1 サーバーごとに新しい値を追加します。必ず、rootfeed_title セクションとrootfeed_summary セクションが、 tm1_contribution.atom ファイルで定義した値と一致するようにしてください。

6. 使用している環境で複数の言語をサポートしている場合は、次の手順を実行します。

v tm1_en.properties ファイルのコピーを作成します。


v ファイルの名前を tm1_<言語コード>.properties に変更します。<言語コード> は、ja、es など、使用する言語を示す 2 文字構成のコードです。

フランス語のサンプル・プロパティー・ファイル tm1_fr.properties が用意されています。

7. 変更を有効にするために、IBM Cognos サービスを再始動します。

表示フォルダーの名前の変更オプションで、IBM Cognos Workspace に表示される「表示」フォルダーの名前を変更できます。

IBM Cognos Workspace には、デフォルトで、tm1_contribution.atom ファイルで識別される TM1 サーバーごとにアプリケーション・フォルダーと表示フォルダーが表示されます。アプリケーション・フォルダーの名前は TM1 サーバーから返されます。表示フォルダーの名前は、IBM Cognos Workspace に付属するメッセージ・ファイルによって決まります。

手順

1. <インストールの場所>¥templates¥ps¥messages ディレクトリーに移動します。

2. tm1buxmsgs_en.xml ファイルのコピーを作成し、適切な言語コードを使用してコピーに名前を付けます。

フランス語のサンプル変換ファイル tm1buxmsgs_fr.xml が用意されています。

3. XML エディターで新しい変換ファイルを開きます。

4. 次のセクションの単語 Views を適切な値に置き換えます。

<string id="TM1_VIEWS" type="String" usage="TM1 views">Views</string>

5. 新しいファイルを保存して閉じます。

6. サポートされている言語ごとに、手順を繰り返します。

IBM Cognos TM1 Applications にアクセスするための IBMCognos Workspace の設定

IBM Cognos Analytics サーバーは、IBM Cognos Workspace のコンテンツ・ウィンドウに表示される外部 iWidget を介して、IBM Cognos TM1 Applications 用のWeb クライアントにアクセスできます。iWidget を表示できるようにするには、TM1 Applications のドキュメントを使用して次の作業を行う必要があります。

手順1. IBM Cognos TM1 Applications をインストールします。

2. IBM Cognos TM1 Applications を、IBM Cognos Analytics サーバーと相互運用するように設定します。

icon_active_application.gif ファイルを Cognos Analytics サーバーのポータル・イメージ・フォルダーにコピーするときに、このファイルもインストールの場所/webcontent/icd/feeds/images フォルダーにコピーします。

3. アプリケーションをデプロイします。


IBM Cognos TM1 Applications により、IBM Cognos Analytics サーバーで検出される URL が生成されます。

タスクの結果

TM1 Contributor の URL が、IBM Cognos Workspace のコンテンツ・ウィンドウ内の「共有フォルダー」に表示されます。

IBM Cognos Workspace に表示するレポート・オブジェクトのスタイルの変更

ワークスペースにレポート・オブジェクトをドラッグすると、そのオブジェクトは、製品の銀色と青の階調スタイルで表示されます。レポート・オブジェクトは、IBM Cognos Viewer 設定ファイルのグローバル・プロパティーを変更することにより、独自のスタイルで表示されるよう構成できます。

グローバル設定の影響を受けるレポート・オブジェクトには、IBM Cognos バージョン 1.x スタイル、バージョン 8.x スタイル、財務 (貸借対照表) スタイルを使用して作成されたクエリー、分析、レポート、レポート部品などがあります。これらのオブジェクトでは、グローバル設定を変更する以前に保存した場合でも、そのグローバル設定が適用されます。ワークスペースのサムネールには、サムネールを再実行する場合にのみグローバル設定が反映されます。

PowerPlay のレポートやレポート・オブジェクトのサムネールなどの一部のレポート・オブジェクトは、グローバル設定の影響を受けずに、作成されたスタイルで常に表示されます。

手順1. Content Manager とアプリケーション層コンポーネントの各インスタンスで、

インストールの場所/webapps/p2pd/WEB-INF/classes ディレクトリーに移動します。

2. テキスト・エディターで viewerconfig.properties ファイルを開きます。

3. 作成した独自のスタイルでレポート・オブジェクトを表示するには、useAuthoredReportStyles の値を true に変更します。

4. ファイルを保存して、サービスを再開します。

IBM Cognos Workspace サンプルへのアクセスIBM Cognos Workspace のサンプルは、IBM Cognos Analytics のサンプルと共に組み込まれています。

ビジネス・ユーザーは、既存のワークスペースを開くオプションを選択してから、「サンプル」>「モデル」>「Cognos Workspace サンプルの順に選択することで、IBM Cognos Workspace のサンプルにアクセスできます。

サンプルのインストールと設定について詳しくは、「IBM Cognos Analytics SamplesGuide」を参照してください。サンプルの使用方法について詳しくは、「IBMCognos Workspace ユーザー・ガイド」を参照してください。


ディスパッチャーの可用性をテストするためのルーターの設定ルーターを使用して IBM Cognos ディスパッチャーに要求を配布し、ルーターがテスト用 URL を使用してサーバーの可用性をテストできる場合は、IBM Cognos ディスパッチャーの可用性をテストするようにルーターを設定できます。

手順

"/p2pd/servlet/ping" というパスを含む URL を使用するようにルーターを設定します。ディスパッチャーの準備が整っていない場合は、次の応答が返されます。503 サービス使用不可 (503 Service Unavailable)

ディスパッチャーの準備が整っている場合は、次の応答が返されます。200 OK

別の IBM Cognos 製品とともに使用するための IBM Cognos Analyticsの設定

IBM Cognos 製品の中には、IBM Cognos Analytics では提供されていない機能を備えているものがあります。

このような製品を同一環境内で継続して使用することができます。IBM CognosAnalytics から別の IBM Cognos 製品で作成したオブジェクトにアクセスできるようにするために、追加の設定が必要となることがあります。追加のアクセス要件は、2 つの製品を実行する方法によって異なります。

IBM Cognos Planning Contributor データ・ソース用にスケジュールしたレポートとエージェントを有効化する方法

IBM Cognos Planning Contributor データ・ソースに基づくスケジュールしたレポートとエージェントを実行するには、共有の秘密パスワードを指定する必要があります。これにより、IBM Cognos Analytics サーバーと Contributor Data Server間の通信の安全性が保たれます。

手順1. アプリケーション層コンポーネント・コンピューターで IBM Cognos


2. 「エクスプローラー」ウィンドウで、「データ・アクセス」、「IBM CognosPlanning」、「Contributor Data Server」の順にクリックします。

3. 「プロパティー」ウィンドウで、「署名のパスワード」プロパティーの隣にある

「値」ボックスをクリックし、表示される「編集」ボタン


4. 「値 - 署名のパスワード」ダイアログ・ボックスにデジタル署名されたパスワードを入力します。


パスワードでは大文字と小文字が区別され、IBM Cognos Series 7 で設定したConfiguration Manager の「Cognos Planning」/「Cognos BI - ContributorData Server」/「全般」プロパティーにある「署名のパスワード」プロパティーと一致している必要があります。


タスクの結果

パスワードに基づいて、デジタル署名が作成されます。デジタル署名は IBMCognos Analytics によってエンコードされ、Contributor Data Server によってデコードされます。



第 8 章認証プロバイダーの設定

IBM Cognos コンポーネントは、匿名と認証の 2 つのアクセス・レベルで実行されます。デフォルトでは、匿名アクセスが有効になっています。

ユーザーは両方のタイプのログオンを使用できます。認証ログオンのみを使用するよう選択した場合は、匿名アクセスを無効にする必要があります。詳細については、匿名アクセスの無効化を参照してください。

認証ログオンの場合は、環境の認証プロバイダーのタイプに適切なネームスペースを IBM Cognos Analytics コンポーネントに設定する必要があります。認証用に複数のネームスペースを用意して、実行時に使用するネームスペースを選択できるように設定できます。詳細については、「管理およびセキュリティー・ガイド」を参照してください。

ReportNet からアップグレードした場合、以前に設定されたが、現在は設定されていないネームスペースが IBM Cognos で検出されると、未設定のネームスペースが管理ポータルの認証プロバイダーのリストに表示されます。ユーザー・アカウント情報が引き続き必要な場合には、ネームスペースを設定できます。それ以外の場合は、ネームスペースを削除できます。また、他のバージョンからアップグレードする場合、両方のバージョンで同じ認証ネームスペースを使用する必要があります。その他の場合、保護されている従来のコンテンツが使用できなくなります。新しいバージョンでは、ポリシー、ユーザー、役割、およびグループが同じになるとは限らないためです。

IBM Cognos コンポーネントでは、認証ソースとして次のタイプのサーバーがサポートされています。

v Active Directory サーバー

v カスタム認証プロバイダー

v IBM Cognos Series 7 ネームスペース

v LDAP

v OpenID 接続

v CA SiteMinder

v RACF®

v SAP

複数の Content Manager を使用する場合は、各 Content Manager の場所で同じ認証プロバイダーを設定する必要があります。つまり、選択した認証プロバイダーのタイプと、認証プロバイダーの設定方法が、すべてのプラットフォームのすべての場所で同じでなければなりません。認証プロバイダーの設定には、すべてのContent Manager からアクセス可能な情報が使用されている必要があります。

265

IBM Cognos または Content Manager が 1 台の Linux ベースのコンピューターにインストールされている場合は、LDAP V3 準拠のディレクトリー・サーバーとカスタムのプロバイダーのみを認証ソースとして使用するように IBM Cognos を設定できます。

一部の認証プロバイダーでは、IBM Cognos 環境の外部にあるライブラリーを使用できるようにする必要があります。このようなライブラリーを Linux で使用できない場合は、認証プロバイダーを初期化できません。

次のいずれかを認証ソースとして設定するには、サポートするオペレーティング・システムに、Content Manager をインストールする必要があります。

v IBM Cognos Series 7 ネームスペース (Windows、Solaris、AIX)

v Active Directory サーバー (Windows のみ)

v SAP BW (Power PC、z/OS、z/Linux を除くすべて)

セキュリティーを有効にする場合は、インストールと設定の手順を終えた後すぐにセキュリティー設定を行う必要があります。詳細については、「管理およびセキュリティー・ガイド」を参照してください。

重要: いったんセキュリティーを有効にしたら、無効にしないでください。つまり、既存の権限設定で、存在しないユーザー、グループ、役割が参照されることになります。これによって権限の機能に支障が生じるわけではありませんが、権限設定を管理しているユーザーに"不明な"エントリーが表示される可能性があります。これらのエントリーから参照されているのはすでに存在しないユーザーやグループ、役割であるため、削除しても問題ありません。ただし、すべてのネームスペースで認証していない場合、"不明な"エントリーが表示される可能性があります。ここでは、"

不明な"エントリーを削除しないでください。

IBM Cognos コンポーネントの認証プロバイダーを設定したら、認証プロバイダー環境と IBM Cognos コンポーネント間でシングル・サインオンを有効にすることができます。つまり、ユーザーはいったんログオンすると、再びログオンせずに別のアプリケーションに切り替えられるようになります。

ユーザーは、IBM Cognos Analytics ポータルにログインするときにネームスペースを選択できます。カスタム Java ネームスペースと CA SiteMinder ネームスペースは、ユーザーから見えないようにすることができます。詳細については、 291ページの『ユーザーのログオン時におけるネームスペースの非表示』を参照してください。

匿名アクセスの無効化認証ログオン専用に IBM Cognos Analytics を設定する場合は、アプリケーションへの匿名アクセスを無効にする必要があります。

デフォルトでは、IBM Cognos コンポーネントでユーザー認証は要求されません。ユーザーは匿名でログオンできます。

手順1. Content Manager がインストールされている各コンピューターで IBM Cognos



2. 「エクスプローラー」ウィンドウの「セキュリティー」>「認証」で、「Cognos」をクリックします。

Cognos ネームスペースは、IBM Cognos グループ、役割、連絡先、配布リストなどに関する情報を格納し、他のセキュリティー・ネームスペース内のオブジェクトを参照します。

3. 「プロパティー」ウィンドウの「匿名アクセスを許可」プロパティーの隣にあるボックスをクリックし、「無効」を選択します。


タスクの結果

次に、IBM Cognos Analytics にアクセスする際にログオン資格情報の提供が必須になるように、ネームスペースを設定する必要があります。

Cognos ネームスペースへのユーザー・アクセスの制限Cognos ネームスペースのいずれかのグループまたは役割のメンバーになっているユーザーのみがアプリケーションにアクセスできるように、IBM Cognos Analyticsへのアクセスを設定することができます。

この設定を有効にする前に、自分が Cognos ネームスペース内の組み込みの「システム管理者」役割のメンバーであることを確認します。


ます。

2. 「エクスプローラー」ウィンドウの「セキュリティー」で、「認証」をクリックします。

3. 「プロパティー」ウィンドウで、「組み込みネームスペースのメンバーのみにアクセスを限定する」の値を「有効」に変更します。


次のタスク

特定の Cognos 組み込みグループと役割から「すべてのユーザー」グループを削除し、許可されたユーザーが 1 つ以上の Cognos グループまたは役割に属するようにする必要があります。これらのタスクは、管理者が Cognos Analytics の管理インターフェースで実行します。詳細については、「IBM Cognos Analytics ManagingGuide」または「IBM Cognos Analytics 管理およびセキュリティー・ガイド」を参照してください。

Lightweight Third-Party Authentication の設定IBM Cognos Analytics コンポーネントが IBM Lightweight Third-PartyAuthentication (LTPA) を使用するように設定することができます。このトピックで説明する方法は、認証ソースとして IBM Tivoli Directory Server LDAP またはMicrosoft Active Directory を使用する Cognos Analytics 11.0.7 分散環境に基づきます。

第 8 章認証プロバイダーの設定 267

LTPA を実装する場合は、Cognos Analytics を、それ自体が実行されるWebSphere Liberty コンテナーで設定されている認証ソースを使用するように設定する必要があります。 Cognos ネームスペース内の ID マッピング設定を使用して、Cognos Analytics と WebSphere Liberty の間のシングル・サインオンを設定できます。例えば、認証に LDAP または Active Directory サーバーを使用するように WebSphere Liberty を設定してから、同じ LDAP または Active Directoryを使用するように Cognos Analytics を設定し、REMOTE_USER を使用するように ID マッピングを設定できます。

このことは、Cognos Analytics の場合、ユーザーが HTTP セッションで CognosAnalytics にアクセスするためには、その同じセッションに割り当てられた ID に対して事前に認証されている必要があることを意味します。外部と Cognos をつなぐセキュリティー・システムに資格情報を提示することにより、認証が完了されている必要があります。セキュリティー・システムによって、ID と、他のシステムへのシングル・サインオンを行うのに適した何らかの資格情報 (通常これは SSO トークンの形式になります) が提供される場合もあります。そのようなセキュリティー・システムになり得る代表的なものが、認証プロキシーです。これには、HTTPセッションを認証し、その認証をトークンのかたちで存続させることができる、IBM Tivoli WebSEAL、Oracle Oblix、Computer Associates SiteMinder などのソフトウェアまたはハードウェア・ソリューションが含まれます。

WebSphere Liberty には、ユーザーを認証するための多様なオプションがあります。詳しくは、WebSphere Liberty の資料 (https://www.ibm.com/support/knowledgecenter/en/SSD28V_8.5.5/com.ibm.websphere.wlp.nd.iseries.doc/ae/twlp_sec.html) を参照してください。

LDAP ネームスペースを使用した LTPA の設定以下の手順は、IBM Tivoli Directory Server LDAP を認証ソースとして使用してCognos Analytics のために LTPA をセットアップする方法を示しています。

LDAP の設定について詳しくは、 292 ページの『LDAP を使用するための IBMCognos コンポーネントの設定』を参照してください。

手順1. Content Manager がインストールされているそれぞれの場所で、IBM Cognos

Configuration を開きます。

2. 「エクスプローラー」ウィンドウの「セキュリティー」で、「認証」を右クリックし、「リソースの新規作成」 > 「ネームスペース」の順にクリックします。


4. 「タイプ」リストで「LDAP - 一般のデフォルト値」を選択します。


6. 次のプロパティーを指定します。

ホストとポートLDAP サーバーの完全修飾ホスト名とポート番号。


https://www.ibm.com/support/knowledgecenter/en/SSD28V_8.5.5/com.ibm.websphere.wlp.nd.iseries.doc/ae/twlp_sec.html



基本識別名例: o=organization_name.com

ユーザー検索例: uid=${userID},ou=people

外部 ID を使用有効

外部 ID マッピング例: uid=${environment("REMOTE_USER")},ou=people

7. 検索実行時に特定の「バインド・ユーザー DN とパスワード」を使用してLDAP 認証プロバイダーをディレクトリー・サーバーにバインドする場合は、これらの値を指定します。

値を指定しないと、LDAP 認証プロバイダーは匿名でバインドされます。

外部 ID マッピングを有効にすると、「バインド・ユーザー DN とパスワード」がすべての LDAP アクセスに使用されます。外部 ID マッピングが有効でない場合、「バインド・ユーザー DN とパスワード」が使用されるのは、検索フィルターが「ユーザー検索」プロパティーに指定されているときに限られます。その場合、ユーザー DN が確立されると、その後の LDAP サーバーに対する要求はユーザーの認証コンテキストに従って実行されます。

8. 外部 ID マッピングを使用しない場合、次の手順を使用して、LDAP ディレクトリー・サーバーの検索にバインド資格情報を使用します。

v 「外部 ID を使用」が「無効」に設定されていることを確認します。

v 「バインド資格情報を検索に使用しますか。」を「有効」に設定します。

v 「バインド・ユーザー DN とパスワード」にユーザー ID とパスワードを指定します。

ユーザー ID とパスワードを指定しなかった場合で、匿名アクセスが有効になっていれば、検索は匿名で実行されます。

9. 必要なオブジェクトと属性に対するマッピングの設定をチェックします。

LDAP の設定によっては、IBM Cognos コンポーネントと LDAP サーバー間で正しく通信ができるように、一部のデフォルト値を変更しなければならない場合があります。

「フォルダー・マッピング」、「グループ・マッピング」、「アカウント・マッピング」の「名前」プロパティーにマップされる LDAP 属性には、すべての認証済みユーザーがアクセスできる必要があります。また、「名前」プロパティーは空白であってはなりません。


11. local-server.xml という XML ファイルを作成して、それをinstall_location/configuration ディレクトリーに置きます。

12. local-server.xml ファイルに、ご使用の環境で適切な値を以下のように入力します。

<?xml version="1.0" encoding="UTF-8"?><server><featureManager>


<feature>ldapRegistry-3.0</feature><feature>appSecurity-2.0</feature></featureManager><ldapRegistry id="id" realm="realm"host="host" port="port" ignoreCase="true"baseDN="o=basedn" ldapType="Custom" sslEnabled="false"><idsFiltersuserFilter="(uid=%v,ou=people)"userIdMap="*:uid"groupFilter='(objectclass=groupofnames)'groupIdMap="*:cn" />

</ldapRegistry><webAppSecurity allowFailOverToBasicAuth="true" displayAuthenticationRealm="true"/>

</server>

13. SSL を使用するように Cognos Analytics が設定されている場合の詳細は、209 ページの『IBM Cognos コンポーネントの SSL プロトコルの設定』を参照してください。

14. 設定を確認するため http://host:port/bi にログオンします。SSL 対応システムの場合は https://host:port/bi にログオンします。ここで host はCognos Analytics の完全修飾ホスト・ドメインです。

Cognos Analytics のログオン・ページは表示されません。代わりに、ブラウザーがログオンを求めるプロンプトを表示します。

次のタスク

LTPA 認証を使用してセットアップされ、WebSphere インスタンスにデプロイされている Cognos Analytics アプリケーションとの間にシングル・サインオン (SSO)を設定する場合は、LTPA がセットアップされたCognos Analytics の各ディスパッチャーに WebSphere キーをインストールし、local-server.xml ファイルを次の<ltpa> 要素で更新します。

<ltpa keysFileName="yourLTPAKeysFileName.keys"keysPassword="keysPassword" expiration="120" />

詳しくは、WebSphere Liberty の資料を参照してください。

Active Directory ネームスペースを使用した LTPA の設定以下の手順は、Microsoft Active Directory を認証ソースとして使用して CognosAnalytics のために LTPA をセットアップする方法を示しています。





4. 「タイプ」のリストで「LDAP - Active Directory のデフォルト値」を選択し、「OK」をクリックします。


https://www.ibm.com/support/knowledgecenter/en/SSAW57_liberty/com.ibm.websphere.wlp.nd.multiplatform.doc/ae/twlp_sec_ltpa.html

「エクスプローラー」ウィンドウの「認証」コンポーネントに、新しい認証プロバイダーのリソースが表示されます。デフォルト値は自動的に生成されます。確認し、必要に応じて変更してください。


ヒント: 「ネームスペース ID」プロパティーでは、コロン (:) は使用しないでください。

6. IBM Cognos コンポーネントで既存の認証プロバイダーを見つけて使用されるように、その他の必要なプロパティーすべてに対して値を指定します。

v 「ユーザー検索」に、「(sAMAccountName=${userID})」と入力します。

v シングル・サインオンを使用する場合、「外部 ID を使用」の値を「有効」に設定します。

v シングル・サインオンを使用する場合、「外部 ID マッピング」に「(sAMAccountName=${environment("REMOTE_USER")})」と入力します。

REMOTE_USER 変数からドメイン名を削除する場合は、「(sAMAccountName=${replace(${environment("REMOTE_USER")},

"domain¥¥","")})」と入力します。

重要: 必ず変数 REMOTE_USER のみを使用してください。別の変数を使用すると、セキュリティーがぜい弱になる可能性があります。

v 「バインド・ユーザー DN とパスワード」に、「user@domain」と入力します。

v 「一意の識別子」には objectGUID と入力します。

7. local-server.xml という XML ファイルを作成して、それをinstall_location/configuration ディレクトリーに置きます。

8. local-server.xml ファイルに、ご使用の環境で適切な値を以下のように入力します。

<?xml version="1.0" encoding="UTF-8"?><server><featureManager><feature>ldapRegistry-3.0</feature><feature>appSecurity-2.0</feature></featureManager><ldapRegistry id="id" realm="realm"host="host" port="port" ignoreCase="true"baseDN="DC=dc,DC=dc,DC=dc" bindDN="CN=doejohn,

OU=Users,DC=dc,DC=dc,DC=dc"bindPassword="password" ldapType="Microsoft Active Directory" sslEnabled="false"><activedFiltersuserFilter="(&(sAMAccountName=%v)(objectcategory=user))"groupFilter="(&(cn=%v)(objectcategory=group))"userIdMap="user:sAMAccountName"groupIdMap="*:cn"groupMemberIdMap="memberOf:member"></activedFilters></ldapRegistry><webAppSecurity allowFailOverToBasicAuth="true" displayAuthenticationRealm="true"/></server>


9. SSL を使用するように Cognos Analytics が設定されている場合の詳細は、209 ページの『IBM Cognos コンポーネントの SSL プロトコルの設定』を参照してください。

10. 設定を確認するため http://host:port/bi にログオンします。SSL 対応システムの場合は https://host:port/bi にログオンします。ここで host はCognos Analytics の完全修飾ホスト・ドメインです。

Cognos Analytics のログオン・ページは表示されません。代わりに、ブラウザーがログオンを求めるプロンプトを表示します。

次のタスク

LTPA 認証を使用してセットアップされ、WebSphere インスタンスにデプロイされている Cognos Analytics アプリケーションとの間にシングル・サインオン (SSO)を設定する場合は、LTPA がセットアップされたCognos Analytics の各ディスパッチャーに WebSphere キーをインストールし、local-server.xml ファイルを次の<ltpa> 要素で更新します。

<ltpa keysFileName="yourLTPAKeysFileName.keys"keysPassword="keysPassword" expiration="120" />

詳しくは、WebSphere Liberty の資料を参照してください。

OpenID Connect 認証プロバイダーOpenID Connect は、OAuth 2.0 プロトコル上の単純な識別層です。これは、同じID プロバイダーを使用する複数のアプリケーションでのフェデレーテッド ID および認証に使用されます。 OpenID Connect は、IBM Cognos Analytics を他のアプリケーションと統合する場合に優先される Web ベースの認証プロバイダーです。

OpenID Connect は OpenID と OAuth 2.0 の標準を取り込んだ最新の標準です。Cognos Analytics のオンプレミスとクラウドの両方のインストール済み環境でサポートされます。

Cognos Analytics では、以下のタイプの OpenID Connect ID プロバイダーがサポートされます。

v ADFS (Active Directory Federation Services)

v Azure AD (Active Directory)

v Google

v IBMid (IBM ID プロバイダー)

v OKTA

v Ping

v SalesForce

v SiteMinder

ヒント: 使用する必要のある製品バージョンを確認するには、組織の ID プロバイダー管理者か、販売サポート組織にお問い合わせください。


https://www.ibm.com/support/knowledgecenter/en/SSAW57_liberty/com.ibm.websphere.wlp.nd.multiplatform.doc/ae/twlp_sec_ltpa.html

OpenID Connect 認証プロキシー特に記載がない限り、バージョン11.0.10 以降に適用されます

Cognos Analytics は、Cognos Configuration で「OpenID Connect 認証プロキシー」という新しいプロバイダー・タイプを提供するようになりました。このメニューは、OpenID Connect のための信用サインオン・プロバイダー (TSP) を設定するオプションを提供します。OpenID Connect のエントリーと同様に、現在サポートされている ID プロバイダーのリストが表示されます。

「詳細プロパティー」の下に追加の構成設定エントリーが表示されるようになりました。実際のプロバイダーに渡すクレームと、実際のプロバイダーのネームスペース ID の設定が必要になります。

v ID クレーム名: ターゲット・ネームスペースに対して指定されるクレームの名前(例えば、John Doe) を指定します。

v 信頼済み環境名: ターゲット・ネームスペースにクレームを転送するために使用される環境変数名 (例えば、REMOTE_USER) を指定します。

v リダイレクト・ネームスペース ID: OpenID ID プロバイダーから取得されるクレームで呼び出されるネームスペース ID (例えば、LDAP) を指定します。

ID プロバイダーのシングル・サインオンの利用

OpenID Connect ID プロバイダーでシングル・サインオンおよび 2 要素認証がサポートされている場合、Cognos Analytics でこの機能を利用することができます。

ID プロバイダーでシングル・サインオンがサポートされない場合にユーザーがCognos Analytics に認証要求を行うと、ユーザーは OpenID Connect ID プロバイダーのログオン・ページにリダイレクトされます。必要な情報を入力すると、ユーザーは、ユーザーの ID を含む ID トークンに交換される許可コードとともに、リダイレクトにより Cognos Analytics に戻されます。これにより、ユーザーはCognos Analytics にアクセスできるようになります。

ID プロバイダーでシングル・サインオンがサポートされる場合、Cognos Analyticsに認証要求を行うと、ユーザーは ID トークンを受け取り、アプリケーションにすぐにアクセスすることができます。

IBMid と SAML 2.0 ID プロバイダーとの統合

IBMid は IBM OpenID Connect ID プロバイダーです。ご使用の ID プロバイダー (IdP) で OpenID Connect はサポートされないが、SAML 2.0 はサポートされる場合、Cognos Analytics で、IBMid を使用して、OpenID Connect ネームスペースを認証プロバイダーとして設定することができます。単に、OpenID Connectネームスペースを設定する際に IBMid を ID プロバイダーとして選択するだけです。

ネームスペースをこのように設定すると、Cognos Analytics をほとんどの SAML2.0 ID プロバイダーと統合することができます。その結果、ユーザーは、CognosAnalytics にログオンすると、IBMid のサインオン・ページにリダイレクトされ、ここで E メール・アドレスを入力します。E メール・アドレスが IBMid によって認識されると、ユーザーは組織の SAML 2.0 ID プロバイダーのログオン・ページにリダイレクトされます。ユーザーは、このページで資格情報を提供することによ


って認証プロセスを完了します。これにより、Cognos Analytics にアクセスできるようになります。

OpenID Connect ネームスペースの設定IBM Cognos Analytics で OpenID Connect ID プロバイダーを使用するには、OpenID Connect ネームスペースを設定する必要があります。

IBMid を OpenID Connect ID プロバイダーとして使用する場合、詳細については、OpenID Connect ネームスペースの管理を参照してください。

OpenID Connect ネームスペースを正常に設定した後に、ユーザーに認証の問題が発生する場合は、Cognos Analytics の「管理」コンポーネントの診断ログ記録を使用して、問題のトラブルシューティングを行ってください。事前定義されているAAA トピックに基づいて、新しいログ記録トピックを作成する必要があります。AAA ログ記録トピックを変更するには、以下のコードを追加します。

{"loggerDefinitions": [{"loggerName": "com.ibm.cognos.camaaa.internal.OIDC","level": "DEBUG","additivity": true}],"topicName": "OIDC"}

診断ログ記録の詳細については、Logging types and files を参照してください。

手順1. Content Manager コンピューターで IBM Cognos Configuration を開きます。

2. 「セキュリティー」 > 「認証」の下で、右クリックして「リソースの新規作成」 > 「ネームスペース」を選択します。

3. 「タイプ (グループ) (Type (Group))」で、「OpenID connect」を選択します。

4. 「タイプ」で、サポートされる ID プロバイダーが含まれるドロップダウン・リストから、いずれかの ID プロバイダーを選択します。

5. 「名前」フィールドにネームスペース名を入力してから、「OK」をクリックします。

新しいネームスペースは、「エクスプローラー」ペインの「セキュリティー」> 「認証」の下に追加され、そのプロパティーがプロパティー・ペインに表示されます。

6. ネームスペースのプロパティーの値を指定します。

ヒント: プロパティーをクリックすると、各プロパティーの情報がユーザー・インターフェースに表示されます。

v CAMID に「ネームスペース ID」が使用されます。


http://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.ag_manage.doc/t_ca_openid_namespace.html

https://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.ag_manage.doc/c_ca_config_logging.html

v OpenID Connect 管理者の推奨に従って「ディスカバリー・エンドポイント(Discovery Endpoint)」、「クライアント ID (Client Identifier)」、および「OpenID Connect クライアント機密事項 (OpenID Connect clientsecret)」の値を指定します。

v 次の例に示されているように、「返信 URL (Return URL)」をゲートウェイまたはディスパッチャー URL で更新します。

http://mycompany:9300/bi/completeAuth.jsp

環境でロード・バランサーが使用されている場合は、次の例に示されているように、「返信 URL (Return URL)」のゲートウェイまたはディスパッチャー・ノードの前にロード・バランサーの DNS エントリーを含めてください。

https://MyLoadbalancerDNS.mycompany.com:443/ibmcognos/bi/

completeAuth.jsp

この例では、Cognos Analytics ゲートウェイは Web サーバーにインストールされています。

Cognos Analytics ゲートウェイが Web サーバーにインストールされていない状況で、ロード・バランサーの背後に一連のディスパッチャー・ノードを使用している場合は、「返信 URL (Return URL)」は次のようになります。

https://MyLoadbalancerDNS.mycompany.com:9300/bi/completeAuth.jsp

ヒント: 「マルチテナンシー」プロパティーは現時点では指定する必要がありません。

7. サード・パーティーの証明書ツールを使用して、OpenID Connect のルート証明機関証明書を Cognos Analytics 鍵ストアにインポートします。

v UNIX または Linux オペレーティング・システムの場合、ThirdPartyCertificateTool.sh -i -T -r cert.cer -p NoPassWordSet と入力します。

v Windows オペレーティング・システムの場合、ThirdPartyCertificateTool.bat -i -T -r cert.cer -p NoPassWordSet と入力します。

ヒント: cert 変数は、OpenID Connect ID プロバイダーで使用される証明書ファイルの名前に置き換えます。 IBMid の場合、ファイル名は blueid.cer です。このコマンドを実行すると、指定されたパスワードを使用して certs ディレクトリー内の CAMKeystore ファイルにコンテンツがインポートされます。

8. バックアップの Content Manager コンピューターで同じ設定手順を実行します。

9. Content Manager およびバックアップの Content Manager コンピューターで、IBM Cognos サービスを再始動します。


タスクの結果

OpenID Connect ID プロバイダーに登録されているすべてのユーザーが、CognosAnalytics にアクセスできるようになりました。

Active Directory サーバーを使用するための IBM Cognos コンポーネントの設定

Content Manager が Microsoft Windows オペレーティング・システムのコンピューターにインストールされている場合、Active Directory ネームスペースを認証ソースとして設定できます。

Content Manager を UNIX ベースのコンピューターにインストールする場合には、Active Directory を認証ソースとして設定する際に、Active Directory ネームスペースの代わりに LDAP ネームスペースを使用します。Windows と UNIX の両方のコンピューターに Content Manager をインストールする場合には、LDAPネームスペースを使用して、すべての Content Manager の Active Directory を設定する必要があります。Active Directory サーバーでの認証に LDAP ネームスペースを使用する場合、LDAP 機能のみに限定されます。ドメインの詳細プロパティー、Kerberos 委任によるシングル・サインオンなどの Active Directory 機能を利用することはできません。

Linux ベースのコンピューターに Content Manager をインストールする場合、UNIX と同じ制限が適用されます。LDAP ネームスペースを使用して、認証ソースとして Active Directory を設定する必要があります。

Microsoft SQL Server または Microsoft Analysis Server をデータ・ソースとして使用し、認証にシングル・サインオンを使用する場合は、Active Directory を認証ソースとして使用する必要があります。

Active Directory グローバル・カタログには接続できません。これは ActiveDirectory サーバー用のキャッシュ・サーバーです。接続にポート 3268 を使用している場合は、これを変更する必要があります。デフォルトでは、Active Directoryサーバーはポート 389 を使用しています。

手順1. Active Directory サーバーのネームスペースを使用するように IBM Cognos コ

ンポーネントを設定する

2. Active Directory サーバーへの保護された通信を有効にする (必要な場合)

3. Active Directory と IBM Cognos コンポーネント間でシングル・サインオンを有効にする

Active Directory ネームスペースの設定Active Directory サーバーを認証プロバイダーとして使用できます。

また、Active Directory サーバーのカスタム・ユーザー・プロパティーを、IBMCognos コンポーネントで使用できるようにすることもできます。


始める前に

IBM Cognos が Active Directory サーバーで正しく動作するように、ユーザーが保存されている Active Directory フォルダーに対する読み取り権限が"認証済みユーザー"グループに割り当てられていることを確認します。

Microsoft SQL Server または Microsoft Analysis Server データ・ソースを使用したシングル・サインオンをサポートするように Active Directory ネームスペースを設定する場合は、次のように設定します。

v IBM Cognos ゲートウェイが、Microsoft Windows オペレーティング・システムの統合認証用に設定された IIS Web サーバーにインストールされている

v Web ブラウザーでゲートウェイがローカル・イントラネット Web サイトに割り当てられている

v Content Manager が Windows 2008 サーバーまたは Windows 2012 サーバーにインストールされている

v Content Manager、アプリケーション層コンポーネント、IIS Web サーバー、およびデータ・ソース・サーバー (Microsoft SQL Server または MicrosoftAnalysis Server) が、Active Directory ドメインに属している

v Microsoft SQL Server または Microsoft Analysis Server のデータ・ソース接続が「外部ネームスペース」で設定済みで、そのネームスペースが ActiveDirectory ネームスペースである

データ・ソースについて詳しくは、IBM Cognos Analytics「管理およびセキュリティー・ガイド」を参照してください。





4. 「タイプ」ボックスで適切なネームスペースをクリックし、「OK」をクリックします。




7. 「ホスト名とポート番号」プロパティーの値を指定します。

Active Directory サーバーのフェイルオーバーをサポートするために、特定のドメイン・コントローラーの代わりにドメイン名を指定することができます。例えば、"dc1.<ドメイン名>.com:389"の代わりに、"<ドメイン名>.com:389"と指定します。


8. 認証が失敗したときに詳細情報を検索するには、「資格情報のバインド」プロパティーにユーザー ID とパスワードを指定します。

Active Directory サーバーに対して検索権限と読み取り権限を持つユーザーの資格情報を使用してください。


10. 新しいネームスペースへの接続をテストします。「エクスプローラー」ウィンドウの「認証」で、新しい認証リソースを右クリックし、「テスト」をクリックします。

テストを完了するために、ネームスペース内のユーザーの資格情報を入力するよう求めるプロンプトが出されます。

ネームスペースの構成方法に応じて、ネームスペース内のユーザーの有効なユーザー ID とパスワードか、バインド・ユーザー DN とパスワードを入力することができます。

タスクの結果

IBM Cognos によって、ネームスペースのプロバイダー・ライブラリーのロード、初期化、および設定が行われます。

Active Directory のカスタム・ユーザー・プロパティーを IBMCognos コンポーネントで使用可能にする方法

IBM Cognos コンポーネントで、Active Directory サーバーの任意のユーザー属性を使用できます。この設定を行うには、使用したい属性を Active Directory ネームスペースのカスタム・プロパティーとして追加する必要があります。

カスタム・プロパティーは、Framework Manager を介してセッション・パラメーターとして使用できます。セッション・パラメーターの詳細については、「Framework Manager User Guide」を参照してください。

また、コマンド・ブロック内でカスタム・プロパティーを使用して、Oracle セッションおよび接続を設定することもできます。コマンド・ブロックは、Oracle の簡易接続と仮想プライベート・データベースとともに使用できます。詳細については、「IBM Cognos Analytics管理およびセキュリティー・ガイド」を参照してください。



2. 「エクスプローラー」ウィンドウの「セキュリティー」>「認証」で、"ActiveDirectory"ネームスペースをクリックします。

3. 「プロパティー」ウィンドウで、「カスタム・プロパティー」の「値」列をクリックし、「編集」アイコンをクリックします。

4. 「値」-「カスタム・プロパティー」ウィンドウで「追加」をクリックします。

5. 「名前」列をクリックし、IBM Cognos コンポーネントでセッション・パラメーターに使用する名前を入力します。


6. 「値」列をクリックし、Active Directory サーバーのアカウント・パラメーターの名前を入力します。

7. カスタム・パラメーターごとに手順 4 から 6 を繰り返します。



Active Directory サーバーに対する保護された通信の有効化Active Directory サーバーに対し保護された通信 (SSL 接続) を有効にするには、Active Directory サーバーから Content Manager の場所に証明書をコピーする必要があります。

手順1. 各 Content Manager の場所で、Web ブラウザーを使用して Active Directory

サーバーに接続し、Content Manager の場所に CA ルート証明書をコピーします。

2. 現在の IBM Cognos セッションで使用しているアカウントの証明書ストアにCA ルート証明書を追加します。

v ユーザー・アカウントで IBM Cognos セッションを実行している場合は、手順 1 と同じ Web ブラウザーを使用して、ユーザー・アカウントの証明書ストアに CA ルート証明書をインポートします。

詳細については、Web ブラウザーのドキュメントを参照してください。

v ローカルのアカウントで IBM Cognos セッションを実行している場合は、Microsoft Management Console (MMC) を使用して、ローカル・コンピューターの証明書ストアに CA ルート証明書をインポートします。

詳細については、MMC のドキュメントを参照してください。

3. IBM Cognos Configuration で、サービスを再開します。

v 「エクスプローラー」ウィンドウで、「IBM Cognos サービス」、「IBMCognos」をクリックします。

v 「操作」メニューの「再開」をクリックします。

詳細プロパティーを使用してドメインを含める、または除外する方法

IBM Cognos 用に認証ネームスペースを構成する場合、ログインできるのは 1 つのドメインのユーザーに限定されます。 Active Directory サーバーの拡張プロパティーを使用すると、関連 (親子) ドメインのユーザーおよび同じフォレスト内の無関係のドメイン・ツリーのユーザーもログインできます。クロス・フォレストはサポートされません。各フォレストに対してネームスペースが必要です。

chaseReferrals というパラメーターを有効にすると、元の認証済みドメインのユーザーと、そのドメイン・ツリーの子ドメインすべてのユーザーが IBM Cognos にログオンできます。元の認証ドメインの親ドメインからのユーザーまたは別のドメイン・ツリー内のユーザーは、ログインできません。


MultiDomainTrees というパラメーターを有効にすると、フォレスト内にあるすべてのドメイン・ツリーのユーザーが IBM Cognos にログオンできます。



2. 「エクスプローラー」ウィンドウの「セキュリティー」>「認証」で、"ActiveDirectory"ネームスペースをクリックします。

3. 「プロパティー」ウィンドウで、「ホスト名とポート番号」プロパティーを指定します。

v 1 つのドメイン内のユーザーの場合は、単一のドメインに対するドメイン・コントローラーのホスト名とポート番号を指定します。

v 1 つのドメイン・ツリー内のユーザーの場合は、そのドメイン・ツリーの最上位にあるコントローラーのホスト名とポート番号を指定します。

v フォレスト内にあるすべてのドメイン・ツリーのユーザーの場合は、フォレスト内の任意のドメイン・コントローラーのホスト名とポート番号を指定します。

4. 「詳細プロパティー」の「値」列をクリックし、「編集」アイコンをクリックします。

5. 「値 - 詳細プロパティー」ウィンドウで「追加」をクリックします。

6. 2 つの新しいプロパティー、"chaseReferrals"および"MultiDomainTrees"に、次の表に示す値を指定します。

表 41. 詳細プロパティーの設定

認証の対象 chaseReferrals MultiDomainTrees

1 つのドメイン無効無効

1 つのドメイン・ツリー有効無効

フォレスト内のすべてのドメイン・ツリー

有効有効



Active Directory サーバーと IBM Cognos コンポーネント間でのシングル・サインオンの有効化

デフォルトでは、Active Directory プロバイダーは Kerberos 認証を使用します。Microsoft インターネット・インフォメーション・サービス (IIS) Web サーバーでWindows 認証 (旧称 NT チャレンジ・レスポンス) が有効になっている場合、IISWeb サーバーと統合され、シングル・サインオンが実行されます。

Windows 認証が有効な場合、Active Directory ネームスペースによって保護されている IBM Cognos コンテンツにアクセスするときに、認証情報を再入力するように求められることはありません。


Kerberos 認証を使用する場合、Service for User (S4U) の使用を選択できます。S4U により、ユーザーは Active Directory ドメイン上にないコンピューターからIBM Cognos Analytics にアクセスできます。S4U を有効にするには、制約付き委任の有効化を使用する必要があります。

例えば、ユーザーのコンピューターがドメインに属していないものの、ドメイン・アカウントは持っているユーザーがあるとします。そのユーザーが Web ブラウザーを開くと、ドメイン・アカウントの入力を促されます。ただし、そのユーザーには ID 特権のある Kerberos チケットだけが付与されるため、IBM CognosAnalytics に対する認証が行われません。この問題を解決するために、S4U を使用できます。

Kerberos 認証を使用しない場合は、REMOTE_USER 環境変数にアクセスするようにプロバイダーを設定して、シングル・サインオンを実行できます。


Kerberos 認証を使用するためのシングル・サインオンを有効にするには、以下のタスクを完了する必要があります。

1. ibmcognos/cgi-bin アプリケーション用に Microsoft IIS Web サーバーでのWindows 認証を設定します。

2. アクティブな Content Manager と待機中の Content Manager の両方で、Active Directory ドメインの一部であるコンピューターに Content Managerをインストールします。

3. コンピューター、または Content Manager を実行するときのユーザー・アカウントを、信頼されるように設定します。

詳しくは、以下の技術情報資料を参照してください。

v Enabling single sign-on to CRN or Cognos secured against Active Directorytechnote (www.ibm.com/support/docview.wss?uid=swg21341889)

v When using Kerberos Single Sign-on (SSO) with Active Directory in Cognos,user is prompted for credentials technote (www.ibm.com/support/docview.wss?uid=swg21659267)

REMOTE_USER を使用する Active Directory サーバーと IBMCognos コンポーネント間でのシングル・サインオンの有効化Kerberos 認証を使用しない場合は、REMOTE_USER 環境変数にアクセスするようにプロバイダーを設定して、シングル・サインオンを実行できます。

詳細プロパティー singleSignonOption の値を IdentityMapping に設定してください。また、Active Directory ネームスペース用のバインド資格情報の指定も必要になります。

Microsoft IIS では、Windows 認証を有効にすると、デフォルトで REMOTE_USER が設定されます。 Kerberos 認証が使用されない場合、Microsoft OLAP (MSAS) データ・ソースへのシングル・サインオンを行うことはできません。






REMOTE_USER を定義するとき、REMOTE_USER を信頼されている資格情報として保存するように選択することもできます。信頼されている資格情報として保存すると、スケジュールされたジョブは REMOTE_USER を「資格情報のバインド」権限によって認証することになります。


手順

1. Content Manager をインストールしたコンピューターで、IBM CognosConfiguration を開きます。

2. 「エクスプローラー」ウィンドウの「セキュリティー」 > 「認証」で、ActiveDirectory ネームスペースを選択します。


4. 「値 - 詳細プロパティー」ダイアログ・ボックスで「追加」をクリックします。

5. 「名前」列に、singleSignonOption と入力します。

6. 「値」列に、IdentityMapping と入力します。

7. REMOTE_USER を信頼されている資格情報として保存する場合、「値 - 詳細プロパティー」ダイアログ・ボックスで「追加」をクリックします。

8. 「名前」列に、trustedCredentialType と入力します。

9. 「値」列に、IdentityMappingForTC と入力します。


11. 「資格情報のバインド」の「値」列をクリックし、「編集」アイコンをクリックします。

12. 「値 - 資格情報のバインド」ダイアログ・ボックスで、ユーザー ID とパスワードを指定し、「OK」をクリックします。

Kerberos 認証を使用するシングル・サインオンの有効化IIS Web サーバーが Windows 認証用に構成されている場合、追加の設定を行う必要はありません。 Kerberos 認証がデフォルトで使用されます。

Kerberos 認証を制約付き委任と共に使用するシングル・サインオンの有効化制約付き委任を使用可能にするには、IBMCognos コンポーネントと Microsoft インターネットインフォメーションサービス (IIS) Web サーバーのアプリケーション・プールとを Active Directory ドメインで実行するように構成された、ユーザーのサービス・プリンシパル名 (SPN) を定義する必要があります。

Kerberos を制約付き委任と共に使用する場合、ゲートウェイを構成するときに、Content Manager のための sAMAccountName ユーザーを追加する必要があります。アクティブ状態およびスタンバイ状態のすべての Content Manager は、同じアカウントの下で実行するように構成される必要があります。


データベース・サーバーへのシングル・サインオンを構成する場合、ActiveDirectory ネームスペースを追加するときに、アプリケーション層コンポーネントを実行するユーザーの sAMAccountName を構成する必要があります。すべてのアプリケーション層コンポーネントは、同じアカウントの下で実行するように構成される必要があります。

SPN は、IBM Cognos Configuration の sAMAccountName フィールドに入力するユーザーです。

例えば、あるユーザーが Content Manager コンポーネントを実行し、別のユーザーがアプリケーション層コンポーネントを実行し、さらに別のユーザーが Web サーバーのアプリケーション・プールを実行すると想定します。 Content Managerのユーザーは CognosCMUser です。アプリケーション層コンポーネントのユーザーは CognosATCUser です。アプリケーション・プールのユーザーは IISUser です。各ユーザーは、MyDomain ドメイン内に存在します。

1. MyDomain\IISUser がアプリケーション・プールの ID となるように、IIS をセットアップする必要があります。

2. IIS が実行しているコンピューターで、setspn コマンドを実行します。


setspn -A http/IISServerName MyDomain\IISUsersetspn -A http/IISServerName.MyDomain.com MyDomain\IISUser

3. IBM Cognos ユーザーに対して setspn コマンドを実行します。


setspn -A ibmcognosba/CognosCMUser MyDomain\CognosCMUsersetspn -A ibmcognosba/CognosATCUser MyDomain\CognosATCUser

これらのコマンドでは、例に示すように、ibmcognosba を使用する必要があります。ユーザー名とドメインは、使用する環境に適合するものでなければなりません。

注: この例で、入力する必要のある sAMAccountName ユーザーは、CognosCMUser および CognosATCUser です。

4. Microsoft SQL Server または Microsoft SQL Server Analysis Services データベース・サーバーへのシングル・サインオンを構成する場合、データベース・サーバーの SPN をセットアップする必要があります。詳しくは、使用するデータベース・サーバーのドキュメントを参照してください。

5. 最後に、Active Directory の Users and Computers 管理ツールで、制約付き委任を構成する必要があります。すべてのユーザー (IISUser、CognosCMUser、および CognosATCUser) の「委任」タブで、Kerberos を制約付き委任と共に使用するために、「指定のサービスへの委任に限ってこのユーザーを信頼する」および「Kerberos だけを使用する」を選択する必要があります。 S4U Kerberos拡張を使用する場合は、「指定のサービスへの委任に限ってこのユーザーを信頼する」および「任意の認証プロトコルを使用する」を選択します。

その後、必要な SPN を追加しなければなりません。例えば、サービス・タイプとして ibmcognosba を追加します。さらに、DomainController1 およびDomainController2 をサービス・タイプ ldap として追加します。


データソースのシングル・サインオンを構成する場合、MSOLAPSvc3 またはMSQLSVC サービスを追加します。

手順

1. Content Manager をインストールしたコンピューターで、IBM CognosConfiguration を開きます。

2. 「エクスプローラー」ウィンドウの「セキュリティー」 > 「認証」で、ActiveDirectory ネームスペースを選択します。



5. 「名前」列に、singleSignonOption と入力します。

6. 「値」列に以下のいずれかの値を入力します。

v 最初に Kerberos 認証を使用する場合、KerberosS4UAuthentication と入力します。 Kerberos が失敗した場合は、Service For User (S4U) 認証が試行されます。 S4U が失敗した場合は、ユーザーに資格情報の入力を求めるプロンプトが出されます。

v 最初に S4U 認証を使用する場合、S4UAuthentication と入力します。 S4Uが失敗した場合は、ユーザーに資格情報の入力を求めるプロンプトが出されます。


8. 「名前」列に、trustedCredentialType と入力します。

9. 「値」列に以下のいずれかの値を入力します。

v ユーザーの資格情報を信頼されている資格情報として保存する場合、CredentialForTC と入力します。例えば、その資格情報を使用してスケジュールされたジョブを実行する場合などです。

v 認証されたユーザー名だけを信頼されている資格情報として保存する場合、S4UForTC と入力します。ユーザー名が UPN 形式で保存され、スケジュールされたジョブはその UPN を使用して、ユーザーのパスワードの入力なしで実行できます。


11. 「アプリケーション層コンポーネント sAMAccountName」の「値」列をクリックして、アプリケーション層コンポーネントを実行するユーザーのsAMAccountName を入力します。

重要: Microsoft SQL Server または Microsoft SQL Server Analysis Servicesデータベース・サーバーへのシングル・サインオンを構成する場合にのみ、この値が必要になります。データベース・サーバーへのシングル・サインオンを構成しない場合は、この値を変更しないでください。


13. IBM Cognos サービスを再開します。

14. ゲートウェイ・コンポーネントをインストールしたコンピューターで、IBMCognos Configuration を開きます。



16. 「Content Manager sAMAccountName」の「値」列をクリックして、Content Manager を実行するユーザーの sAMAccountName を入力します。


IBM Cognos Series 7 ネームスペースを使用するための IBM Cognos の設定

IBM Cognos Series 7 ネームスペースを認証プロバイダーとして使用するようにIBM Cognos コンポーネントを設定できます。IBM Cognos Series 7 ネームスペースの認証とサインオンの設定に基づいて、ユーザーが認証されます。

IBM Cognos Series 7 の PowerCube および Transformer モデルを IBM CognosAnalytics で使用する場合、IBM Cognos Series 7 ネームスペースが必要になります。ネームスペースは Transformer モデルをロードする前に設定する必要があります。

注: IBM Cognos コンポーネントでの認証には、IBM Cognos Series 7 LocalAuthentication Export (LAE) ファイルは使用できません。

IBM Cognos Series 7 の複数の認証プロバイダーを使用するように IBM Cognosコンポーネントを設定できます。すべての IBM Cognos Series 7 ネームスペースでは、同じプライマリー IBM Cognos Series 7 Ticket Server を使用します。同じ値に設定しなかった場合、エラーが発生したり、認証要求が繰り返されたりすることがあります。パフォーマンスを維持するために、Ticket Server が動作していることも確認します。

IBM Cognos Series 7 で使用するディレクトリー・サーバーに保存されている設定情報を変更した場合は、IBM Cognos のインストール環境にその変更内容を反映するため、IBM Cognos サービスを再始動する必要があります。

IBM Cognos コンポーネントにログオンするには、ユーザーは少なくとも 1 つのAccess Manager ユーザー・クラスに属している必要があります。

手順1. Series 7 ネームスペースの構成

2. IBM Cognos Series 7 ネームスペースで使用されるディレクトリー・サーバーへの保護された通信を有効にする (必要な場合)

3. IBM Cognos Series 7 と IBM Cognos 間でシングル・サインオンを有効にする

IBM Cognos Series 7 ネームスペースの設定1 つ以上の IBM Cognos Series 7 ネームスペースを認証に使用するように IBMCognos を設定できます。










IBM Cognos Series 7 ネームスペースのバージョンが 16.0 の場合は、「データのエンコード方式」プロパティーが「UTF-8」に設定されていることを確認します。また、Content Manager をインストールしている場所で使用しているロケールが IBM Cognos Series 7 ネームスペースのデータに使用しているものと同じであることも必要です。

ホスト名の値は、サーバー名または IP アドレスのいずれかです。PowerPlayEnterprise Server から IBM Cognos Analytics に発行する場合、ディレクトリー・サーバーの場所の指定には、IBM Cognos Series 7 ConfigurationManager で使用しているものと同じ書式で値を使用する必要があります。例えば、IBM Cognos Series 7 Configuration Manager でサーバー名が使用されている場合、IBM Cognos Analytics の IBM Cognos Configuration でもサーバー名を使用する必要があります。

7. 使用しているネームスペース環境に IBM Cognos Series 7 ネームスペースのバージョン 15.2 が含まれている場合、「Series7NamespacesAreUnicode」設定を無効化する必要があります。

v 「プロパティー」ウィンドウにある「詳細プロパティー」の値の「編集」アイコンをクリックします。

v 「値 - 詳細プロパティー」ウィンドウで「追加」をクリックします。

v 「名前」ボックスに「Series7NamespacesAreUnicode」と入力します。

v 「値」ボックスに「無効」と入力し、「OK」をクリックします。

8. 「プロパティー」ウィンドウの「Cookie 設定」で、「パス」、「ドメイン」、「セキュア・フラグを立てる」の各プロパティーが IBM CognosSeries 7 の設定と同じであることを確認します。






IBM Cognos Series 7 ネームスペースで使用されるディレクトリー・サーバーへの保護された通信の有効化

IBM Cognos Series 7 ネームスペースで使用されるディレクトリー・サーバーとの間で保護された通信 (SSL 接続) を有効にするには、ディレクトリー・サーバーから各 Content Manager の場所に証明書をコピーする必要があります。

詳細については、IBM Cognos Access Manager の「管理者ガイド」およびディレクトリー・サーバーのドキュメントを参照してください。

IBM Cognos Series 7 と IBM Cognos 間でのシングル・サインオンの有効化

シングル・サインオンのための外部認証機構と統合するように IBM Cognos Series7 ネームスペースが設定されている場合、IBM Cognos Series 7 プロバイダーによってその設定が自動的に使用されます。

シングル・サインオンを設定すると、IBM Cognos Series 7 ネームスペースによって保護されている IBM Cognos コンテンツにアクセスするときに、認証情報を再入力するよう求められることがなくなります。

手順1. IBM Cognos コンポーネントが、認証プロバイダーとして IBM Cognos Series

7 ネームスペースを使用するように設定されていることを確認します。

2. IBM Cognos Series 7 で、Configuration Manager を起動します。

3. 「現在の設定を開く」をクリックします。

4. 「エクスプローラー」ウィンドウの「コンポーネント」タブで、「サービス」、「Access Manager - Web Authentication」を展開し、「Cookie 設定」をクリックします。

5. 「プロパティー」ウィンドウで、「パス」、「ドメイン」、「セキュア・フラグを立てる」の各プロパティーが IBM Cognos Analytics の設定と同じであることを確認します。

6. 変更内容を保存して、Configuration Manager を終了します。

7. IBM Cognos Series 7 ネームスペースでシングル・サインオンに TrustedSignon プラグインが使用されている場合は、ここでSaferAPIGetTrustedSignonWithEnv 関数を定義する必要があります。

タスクの結果

これで、IBM Cognos Upfront Series 7 の NewsBoxes を IBM Cognos Analyticsに追加できるようになりました。


IBM Cognos Series 7 ネームスペースと IBM Cognos Series7 Trusted Signon プラグイン

IBM Cognos Series 7 ネームスペースでシングル・サインオンに Trusted Signonプラグインが使用されている場合は、プラグインにSaferAPIGetTrustedSignonWithEnv 関数を定義する必要があります。次に、ライブラリーの再コンパイルと再配布を行い、IBM Cognos コンポーネントと認証機構の間でシングル・サインオンを実現します。

SaferAPIGetTrustedSignonWithEnv 関数は、SaferAPIGetTrustedSignon 関数のアップデート版です。このアップデートが必要なのは、IBM Cognos Series 7 のアプリケーションとは異なり、IBM Cognos のログオンが Web サーバーで実行されないためです。このため、プラグインが getenv( ) API を呼び出して、Web サーバーの環境変数を取得することができません。SaferAPIGetTrustedSignonWithEnv 関数を使用すると、これらの環境変数を Web サーバーから削除するようにプラグインが要求できます。

同じプラグインを使用して IBM Cognos Series 7 製品と IBM Cognos 製品の両方を実行している場合は、SaferAPIGetTrustedSignonWithEnv 関数とSaferAPIGetTrustedSignon 関数の両方が必要になります。SaferAPIGetTrustedSignon 関数の詳細については、IBM Cognos Series 7 のドキュメントを参照してください。

SaferAPIGetTrustedSignonWithEnv 関数ユーザーが Access Manager で認証されるには、OS サインオンがあり、現在のネームスペースで有効になっている必要があります。

API 関数から戻される trustedSignonName と trustedDomainName のためのメモリーは、同じ API 関数の内部で割り当てられます。関数の戻り値がSAFER_SUCCESS の場合は、Access Manager によってSaferAPIFreeTrustedSignon が呼び出され、割り当てられたメモリーが解放されます。

API 関数から戻される reqEnvVarList のためのメモリーは、同じ API 関数の内部で割り当てられます。関数の戻り値が SAFER_INFO_REQUIRED の場合は、Access Manager によって SaferAPIFreeBuffer() が呼び出され、割り当てられたメモリーが解放されます。

SaferAPIGetTrustedSignonWithEnv 関数が実装されているときにライブラリーを正しく登録するには、SaferAPIGetTrustedSignon 関数と SaferAPIFreeBuffer 関数の両方を実装する必要があります。SaferAPIGetError 関数が必要になるのは、プラグインから特定のエラー・メッセージを取得する場合に限られます。

構文SaferAPIGetTrustedSignonWithEnv(

EnvVar envVar[], /*[IN]*/

char **reqEnvVarList, /*[OUT]*/

void **trustedSignonName, /*[OUT]*/

unsigned long *trustedSignonNameLength, /*[OUT]*/


void **trustedDomainName, /*[OUT]*/

unsigned long *trustedDomainNameLength, /*[OUT]*/

SAFER_USER_TYPE *userType, /*[OUT]*/

void **implementerData); /*[IN/OUT]*/

SaferAPIGetTrustedSignonWithEnv 関数のパラメーター

表 42. SaferAPIGetTrustedSignonWithEnv 関数のパラメーターおよび説明

パラメーター説明

[入力] envVar Web サーバーから取得された環境変数の名前と値の配列。配列の終わりは、null の envVarName と null のenvVarValue を持つエントリーによって表されます。最初にこの API が呼び出されるときには、envVar 配列に含まれるのは配列の終わりを示すマーカーのみです。

[入力] reqEnvVarList Safer 実装によって要求された環境変数名のコンマ区切りのリストが含まれるストリング。このリストの終了記号はnull です。

[出力] trustedSignonName 現在認証されているユーザーを表すバイト列。この値はnull で終了しない場合があります。この値は必須です。

[出力]trustedSignonNameLength

trustedSignonName の長さを表す整数値。null 終了記号がある場合、この長さに null 終了記号は含まれません。この値は必須です。

[出力] trustedDomainName 現在認証されているユーザーのドメインを表すバイト列。この値は null 終了する必要はありません。trustedDomainName が存在しない場合には、null が返されます。この値はオプションです。

[出力]trustedDomainNameLength

trustedDomainName の長さを表す整数値。null 終了記号がある場合、この長さに null 終了記号は含まれません。この値は必ず出力されます。trustedDomainName が存在しない場合には、ゼロに設定される必要があります。


表 42. SaferAPIGetTrustedSignonWithEnv 関数のパラメーターおよび説明 (続き)


[出力] userType Access Manager によって認証されるユーザーのタイプを表す値。この値は必須です。

Access Manager でユーザーが正しく認証されるためには、次の戻り値が必要です。

SAFER_NORMAL_USER名前付きユーザー。OS サインオンが存在し、現在のネームスペースで有効になっている必要があります。

SAFER_GUEST_USERゲスト・ユーザー。ゲスト・ユーザーのアカウントが存在し、現在のネームスペースで有効になっている必要があります。

SAFER_ANONYMOUS_USER匿名ユーザー。匿名ユーザーのアカウントが存在し、現在のネームスペースで有効になっている必要があります。

[入力/出力]implementerData

この API 関数を複数回呼び出すときに、実装に固有のデータを保持するために使用されるポインター。呼び出しはAccess Manager が信頼されたサインオン・プラグインを呼び出すたびに起こります。この値は、信頼されたサインオン・プラグインが呼び出され、それに値を設定した場合にのみ有効です。

カスタム認証プロバイダーを使用するための IBM Cognos の設定カスタム Java 認証プロバイダーを既存のセキュリティー・インフラストラクチャーに実装した場合、カスタム Java 認証プロバイダーを使用するように IBMCognos コンポーネントを設定できます。

カスタム認証プロバイダーを使用して、ユーザーが認証ソースにアクセスして認証を行うようにすることができます。また、カスタム認証プロバイダーをシングル・サインオン機構として使用し、IBM Cognos コンポーネントをセキュリティー・インフラストラクチャーと統合することも可能です。ユーザーのログオン時に、ネームスペースを非表示にすることができます。

詳細については、「Custom Authentication Provider Developer Guide」を参照してください。

カスタム認証ネームスペースの設定カスタム認証ネームスペースを使用するように IBM Cognos コンポーネントを設定できます。認証ソース・アクセス、シングル・サインオン、またはカスタム属性の追加の設定は、カスタム認証プロバイダーの実装に応じて決まります。


Java Runtime Environment (JRE) のバージョンと Java Software DevelopmentKit のバージョンに互換性があるかどうかを確認します。サポートされているバージョンの JRE と Java Software Development Kit を使用していて、これらの間に互換性がない場合、設定したカスタムの Java 認証プロバイダーは IBM CognosConfiguration のネームスペースのリストに表示されません。



2. 「エクスプローラー」ウィンドウの「セキュリティー」で、「認証」を右クリックし、「リソースの新規作成」>「ネームスペース」の順にクリックします。


4. 「タイプ」のリストで「カスタム Java プロバイダー」を選択し、「OK」をクリックします。




6. IBM Cognos で既存の認証プロバイダーを見つけて使用されるように、その他の必要なプロパティーすべてに対して値を指定します。





タスクの結果


ユーザーのログオン時におけるネームスペースの非表示ユーザーのログオン時にネームスペースを非表示にすることができます。ユーザーのログオン時にネームスペースの選択リストに表示することなく、信用サインオン・ネームスペースを使用できます。


例えば、複数のシステムをシングル・サインオンに統合したいと考えているものの、ネームスペースの選択を求めるプロンプトを表示することなく顧客を IBMCognos において直接認証する機能は維持したいと考えているような場合に適しています。

手順1. カスタム Java 認証プロバイダーを設定したそれぞれの場所で、IBM Cognos


2. 「エクスプローラー」ウィンドウの「セキュリティー」>「認証」で、customJava 認証プロバイダーをクリックします。

3. 「プロパティー」ウィンドウの「認証で選択可能」の隣にあるボックスをクリックし、「無効」を選択します。


タスクの結果

ログオン時に表示される選択リストに、このネームスペースが表示されなくなります。

LDAP を使用するための IBM Cognos コンポーネントの設定LDAP ネームスペースを認証プロバイダーとして使用するように IBM Cognos コンポーネントを設定できます。LDAP ユーザー・ディレクトリー、ActiveDirectory Server、IBM Directory Server、Novell Directory Server、OracleDirectory Server に保存されているユーザーに対しては、LDAP ネームスペースを使用できます。

データ・ソース接続をセットアップするときに LDAP ネームスペースを指定すると、IBM Db2 と Essbase OLAP のデータ・ソースで LDAP 認証を使用することもできます。詳細については、「IBM Cognos Analytics管理およびセキュリティー・ガイド」を参照してください。

また、LDAP ネームスペースのカスタム・ユーザー・プロパティーを、IBMCognos コンポーネントで使用できるようにすることもできます。

ユーザーを LDAP サーバーにバインドする方法については、 293 ページの『LDAP マッピング』を参照してください。

手順1. 293 ページの『LDAP ネームスペースの設定』

2. IBM Cognos コンポーネントでカスタム・ユーザー・プロパティーを使用可能にする (必要な場合)

3. LDAP サーバーへの保護された通信を有効にする (必要な場合)

4. LDAP と IBM Cognos コンポーネント間でシングル・サインオンを有効にする (必要な場合)


LDAP マッピングユーザーを LDAP サーバーにバインドするには、LDAP 認証プロバイダーで識別名 (DN) を作成する必要があります。「外部 ID を使用」プロパティーを「有効」に設定すると、「外部 ID マッピング」プロパティーによってユーザーの DN が識別されます。環境変数または DN が LDAP サーバー内で見つからない場合は、「ユーザー検索」プロパティーによって DN を作成することを試みます。

ディレクトリー・サーバーにユーザーが階層的に保存されている場合、「ユーザー検索」プロパティーと「外部 ID マッピング」プロパティーでフィルターを使用するように設定できます。「ユーザー検索」プロパティーと「外部 ID マッピング」プロパティーに設定したフィルターは、LDAP 認証プロバイダーによる検索実行時に使用されます。ディレクトリー・サーバーとのバインドも、「バインド・ユーザー DN とパスワード」プロパティーに指定した値で (値を指定しない場合は匿名で)行われます。

「外部 ID マッピング」プロパティーを認証に使用するように LDAP ネームスペースを設定すると、LDAP プロバイダーでは、「バインド・ユーザー DN とパスワード」の値を使用してディレクトリー・サーバーへのバインドが実行されます。値が指定されていない場合は匿名でバインドされます。外部 ID マッピングで IBMCognos にログオンするすべてのユーザーには、バインド・ユーザーと同じユーザー、グループ、およびフォルダーが表示されます。

外部 ID マッピングを使用しない場合は、「バインド資格情報を検索に使用しますか。」プロパティーを設定することで、バインド資格情報を使用して LDAP ディレクトリー・サーバーを検索するかどうかを指定できます。このプロパティーが有効になっている場合、バインド・ユーザーの資格情報を使用して検索が実行されます。値の指定がない場合は、検索は匿名で実行されます。このプロパティーが無効になっている場合 (デフォルト設定)、検索はログオン・ユーザーの資格情報を使用して実行されます。バインド資格情報を使用することの利点は、複数のユーザーの管理権限を変更しなくても、バインド・ユーザーの管理権限を変更するだけでよいという点です。

注: uid=${userID}, ou=mycompany.com などの DN 構文を「ユーザー検索」、「外部 ID マッピング」、または「バインド・ユーザー DN とパスワード」のプロパティーに使用する場合、その DN で使用されるすべての特殊文字をエスケープする必要があります。(uid=${userID}) などの検索構文を「ユーザー検索」または「外部 ID マッピング」プロパティーに使用する場合は、DN で使用される特殊文字をエスケープしないでください。

LDAP ネームスペースの設定LDAP ユーザー・ディレクトリーにユーザー情報が保存されている場合は、LDAPネームスペースを使用するように IBM Cognos コンポーネントを設定できます。LDAP ユーザー・ディレクトリーへは、Active Directory サーバーや CASiteMinder などの他のサーバー環境からアクセスできます。

LDAP 以外のディレクトリー・サーバーの LDAP ネームスペースを設定する場合は、次の該当するセクションを参照してください。


v Active Directory Server については、Active Directory サーバーに対するLDAP ネームスペースの設定を参照してください。

v IBM Directory Server については、IBM Directory Server に対する LDAP ネームスペースの設定を参照してください。

v Novell Directory Server については、Novell Directory Server に対する LDAPネームスペースの設定を参照してください。

v Oracle Directory Server については、Oracle Directory Server に対する LDAPネームスペースの設定を参照してください。

データ・ソース接続をセットアップするときに LDAP ネームスペースを指定すると、IBM Db2 と Essbase OLAP のデータ・ソースで LDAP 認証を使用することもできます。詳細については、「IBM Cognos Analytics管理およびセキュリティー・ガイド」を参照してください。











外部 ID マッピングを有効にすると、「バインド・ユーザー DN とパスワード」がすべての LDAP アクセスに使用されます。外部 ID マッピングが有効でない場合、「バインド・ユーザー DN とパスワード」が使用されるのは、検索フィルターが「ユーザー検索」プロパティーに指定されているときに限られます。その場合、ユーザー DN が確立されると、その後の LDAP サーバーに対する要求はユーザーの認証コンテキストに従って実行されます。

8. 外部 ID マッピングを使用しない場合、次の手順を実行して、LDAP ディレクトリー・サーバーの検索にバインド資格情報を使用します。





ユーザー ID とパスワードを指定しなかった場合で、匿名アクセスが有効になっていれば、検索は匿名で実行されます。

9. 必要なオブジェクトと属性に対するマッピングの設定をチェックします。

LDAP の設定によっては、IBM Cognos コンポーネントと LDAP サーバー間で正しく通信ができるように、一部のデフォルト値を変更しなければならない場合があります。






タスクの結果


Active Directory サーバーに対する LDAP ネームスペースの設定Active Directory サーバーで使用するために新しい LDAP ネームスペースを設定する場合、デフォルト値は自動的に生成されます。





4. 「タイプ」のリストで「LDAP - Active Directory のデフォルト値」を選択し、「OK」をクリックします。

「エクスプローラー」ウィンドウの「認証」コンポーネントに、新しい認証プロバイダーのリソースが表示されます。デフォルト値は自動的に生成されます。確認し、必要に応じて変更してください。





次に、設定例を示します。

v 「ユーザー検索」に、「(sAMAccountName=${userID})」と入力します。

v シングル・サインオンを使用する場合、「外部 ID を使用」で、値を「有効」に設定します。

v シングル・サインオンを使用する場合、「外部 ID マッピング」で、「(sAMAccountName=${environment("REMOTE_USER")})」と入力します。

REMOTE_USER 変数からドメイン名を削除する場合は、「(sAMAccountName=${replace(${environment("REMOTE_USER")},

"domain¥¥","")})」と入力します。


v 「バインド・ユーザー DN とパスワード」に、「user@domain」と入力します。

v 「一意の識別子」には objectGUID と入力します。












タスクの結果


IBM Directory Server に対する LDAP ネームスペースの設定IBM Directory Server で使用するために新しい LDAP ネームスペースを設定する場合、デフォルト値は自動的に生成されます。





4. 「タイプ」のリストで「LDAP - IBM Tivoli のデフォルト値」をクリックし、「OK」をクリックします。

「エクスプローラー」ウィンドウの「認証」コンポーネントに、新しい認証ネームスペースのリソースが表示されます。確認し、必要に応じて変更してください。



6. IBM Cognos で既存の認証ネームスペースを見つけて使用されるように、その他の必要なプロパティーすべてに対して値を指定します。

v 「ユーザー検索」に、「(cn=${userID})」と指定します。

v 「バインド・ユーザー DN とパスワード」に、「cn=root

」と指定します。









Novell Directory Server に対する LDAP ネームスペースの設定Novell Directory Server で使用する新しい LDAP ネームスペースを設定する場合、必要な設定を変更し、Novell Directory オブジェクトのすべてのプロパティーの値を変更する必要があります。





4. 「タイプ/グループ」のリストで「LDAP」をクリックし、「タイプ」のリストで「LDAP - 一般のデフォルト値」を選択してから、「OK」をクリックします。

「エクスプローラー」ウィンドウの「認証」コンポーネントに、新しい認証ネームスペースのリソースが表示されます。




v 「ユーザー検索」に、「(cn=${userID})」と指定します。

v 「バインド・ユーザー DN とパスワード」で、cn=Admin,o=COGNOS など、管理ユーザーのベース DN を指定します。







9. Novell Directory Server オブジェクトで使用する LDAP の詳細マッピング・プロパティーを設定するには、次の表に示す値を使用します。

表 43. Novell Directory サーバー・オブジェクトで使用するための LDAP の詳細マッピング値

マッピング LDAP のプロパティー LDAP の値

フォルダーオブジェクト・クラス organizationalunit,organization,container


表 43. Novell Directory サーバー・オブジェクトで使用するための LDAP の詳細マッピング値 (続き)

マッピング LDAP のプロパティー LDAP の値

説明 description

名前 ou,o,cn

グループ化オブジェクト・クラス groupofnames

説明 description

メンバー member

名前 cn

アカウントオブジェクト・クラス inetOrgPerson

電話番号 (勤務先) telephonenumber

コンテンツ・ロケール Language

説明 description

E メール mail

Fax/電話 facsimiletelephonenumber

名 givenname

電話番号 (自宅) homephone

携帯電話 mobile

名前 cn

ポケットベル pager

パスワード (空白)

郵送先 postaladdress

ユーザー・インターフェースのロケール

Language

姓 sn

Username uid

これらのマッピング・プロパティーは、デフォルトの Novell Directory Serverのインストールに基づいた変更を表しています。スキーマを変更する場合、マッピングをさらに変更することが必要な場合があります。


ポータルに正常にログオンするには、ou および o 属性の読み取り権限を持っている必要があります。


Oracle Directory Server に対する LDAP ネームスペースの設定Oracle Directory Server で使用するために新しい LDAP ネームスペースを設定する場合、デフォルト値は自動的に生成されます。






4. 「タイプ」のリストで「 LDAP - Oracle Directory Server のデフォルト値」をクリックし、「OK」をクリックします。

「エクスプローラー」ウィンドウの「認証」コンポーネントに、新しい認証ネームスペースのリソースが表示されます。確認し、必要に応じて変更してください。




次に、設定例を示します。

v 「ユーザー検索」に、「(uid=${userID})」と入力します。

v シングル・サインオンを使用する場合、「外部 ID を使用」で、値を「有効」に設定します。

v シングル・サインオンを使用する場合、「外部 ID マッピング」で、NT ユーザー・ドメイン ID またはユーザー ID などの属性を指定します。

(ntuserdomainid=$environment("REMOTE_USER")})

(uid=${environment("REMOTE_USER")})


v 「一意の識別子」には nsuniqueid と入力します。









LDAP のカスタム・ユーザー・プロパティーを IBM Cognos コンポーネントで使用可能にする方法

IBM Cognos コンポーネントで、LDAP 認証プロバイダーの任意のユーザー属性を使用できます。この設定を行うには、使用したい属性を LDAP ネームスペースのカスタム・プロパティーとして追加する必要があります。カスタム・プロパティーは、Framework Manager を介してセッション・パラメーターとして使用できます。

また、コマンド・ブロック内でカスタム・プロパティーを使用して、Oracle セッションおよび接続を設定することもできます。コマンド・ブロックは、Oracle の簡易接続と仮想プライベート・データベースで使用できます。詳細については、「IBMCognos Analytics管理およびセキュリティー・ガイド」を参照してください。

セッション・パラメーターの詳細については、「Framework Manager User Guide」を参照してください。

手順1. Content Manager がインストールされているそれぞれの場所で、Cognos


2. 「エクスプローラー」ウィンドウの「セキュリティー」>「認証」で、LDAP ネームスペースを選択します。

3. 「プロパティー」ウィンドウで、「カスタム・プロパティー」の「値」列をクリックし、「編集」アイコンをクリックします。

4. 「値」-「カスタム・プロパティー」ウィンドウで「追加」をクリックします。

5. 「名前」列をクリックし、IBM Cognos コンポーネントでセッション・パラメーターに使用する名前を入力します。

6. 「値」列をクリックし、LDAP 認証プロバイダーのアカウント・パラメーターの名前を入力します。

7. カスタム・パラメーターごとに上記の 2 つの手順を繰り返します。



LDAP サーバーへの保護された通信の有効化Secure LDAP プロトコル (LDAPS) は、Content Manager の Access Manager コンポーネントとディレクトリー・サーバー間の通信を暗号化します。LDAPS を使用すると、ディレクトリー・サーバー内の機密情報と LDAP 資格情報が平文で送信されなくなります。

LDAPS を有効にするには、認証局 (Certificate Authority) によって署名されたサーバー証明書をディレクトリー・サーバーにインストールします。次に、証明書を格納する証明書データベースを作成します。最後に、ディレクトリー・サーバーとIBM Cognos LDAP ネームスペースが LDAPS を使用するように設定します。

サーバー証明書は次のいずれかのコピーでなければなりません。

v 信頼されたルート証明書およびディレクトリー・サーバー証明書の信頼チェーンを構成するその他のすべての証明書


信頼されたルート証明書とは、ディレクトリー・サーバー証明書に署名したルート認証局の証明書のことです。

v ディレクトリー・サーバー証明書のみ

証明書は、Base64 でエンコードされた ASCII (PEM) 形式であることが必要です。信頼されたルート証明書を除くすべての証明書は、自己署名証明書であってはなりません。

始める前に

IBM Cognos は、 cert8.db バージョンと cert7.db バージョンの両方のクライアント証明書データベースで動作します。証明書データベースを作成するには、Netscape Security Services (NSS) の certutil ツールを使用する必要があります。 IBM Cognos では、Microsoft Active Directory に付属の certutilツールからのファイルで作成されるものを含め、他のバージョンの cert8.db ファイルは使用できません。Netscape Security Services (NSS) がシステム要件としてリストされていないプラットフォームでは、IBM Cognos に certutil ツールが組み込まれるようになりました。 NSS がシステム要件としてリストされているプラットフォームでは、そのバージョンの certutil ツールを使用してください。

手順1. 証明書データベースのディレクトリーを作成します。

2. 次のコマンドを入力して証明書データベースを作成します。

certutil -N -d certificate_directory

<証明書ディレクトリー> は、手順 1 で作成したディレクトリーです。

このコマンドにより、新しいディレクトリーに cert8.db ファイルと key3.dbファイルが作成されます。

3. 認証局証明書またはディレクトリー・サーバー証明書を証明書データベースに追加します。証明書の種類に応じて、次のいずれかのコマンドを入力します。

v CA 証明書の場合は、次のように入力します。

certutil -A -n certificate_name -d certificate_directory -i CA.cert

-t C,C,C

v ディレクトリー・サーバー証明書の場合は、次のように入力します。

certutil -A -n certificate_name -d certificate_directory -i

server_certificate.cert -t P

<証明書名> は、CA 名やホスト名など、自分が指定した別名です。 <サーバー証明書> はディレクトリー・サーバー証明書ファイルのプレフィックスです。

4. 証明書データベースのディレクトリーを、Content Manager がインストールされているすべての場所の <インストールの場所>/configuration ディレクトリーにコピーします。

5. LDAPS を使用するようにディレクトリー・サーバーを設定し、ディレクトリー・サーバーを再起動します。


詳細については、ディレクトリー・サーバーのドキュメントを参照してください。

6. LDAP ネームスペースでディレクトリー・サーバーを使用するように設定したContent Manager のそれぞれの場所で、IBM Cognos Configuration を起動します。

7. 「エクスプローラー」ウィンドウの「セキュリティー」 > 「認証」で、LDAPネームスペースをクリックします。

8. 「プロパティー」ウィンドウの「ホスト名とポート番号」プロパティーで、ポートを安全な LDAPS ポートに変更します。

「SSL 証明書データベース」プロパティーで、cert7.db ファイルへのパスを指定します。

9. 「エクスプローラー」ウィンドウで、LDAP ネームスペースを右クリックし、「テスト」をクリックします。

テストに失敗した場合、プロパティーを修正し、正しい証明書が確実に使用されるようにします。


11. 「操作」メニューの「再開」をクリックします。

12. Content Manager がインストールされている各場所で、手順 6 ～ 11 を繰り返します。

LDAP と IBM Cognos コンポーネント間でのシングル・サインオンの有効化

IBM Cognos コンポーネントへのシングル・サインオンを有効にするには、「外部ID マッピング」プロパティーを設定します。

外部 ID マッピングでは、CGI 環境変数または HTTP ヘッダー変数を参照できます。IBM Cognos コンポーネントを指しているアプリケーション・サーバー・ゲートウェイまたはディスパッチャー・エントリーでは、外部 ID マッピングでuserPrincipalName セッション変数を参照できます。「外部 ID マッピング」プロパティーを実行時に解決した値は、有効なユーザー DN でなければなりません。

「外部 ID マッピング」プロパティーを認証に使用するように LDAP ネームスペースを設定すると、LDAP プロバイダーでは、「バインド・ユーザー DN とパスワード」の値を使用してディレクトリー・サーバーへのバインドが実行されます。値が指定されていない場合は匿名でバインドされます。外部 ID マッピングで IBMCognos にログオンするすべてのユーザーには、バインド・ユーザーと同じユーザー、グループ、およびフォルダーが表示されます。

Java またはアプリケーション・サーバーのセキュリティー機能を使用するアプリケーションを IBM Cognos コンポーネントとともに使用するには、Java UserPrincipal からユーザー ID を取得するように「外部 ID マッピング」プロパティーを設定します。${environment("USER_PRINCIPAL")} というトークンを「外部 ID マッピング」プロパティーの値に含めてください。詳細については、IBM CognosConfiguration のオンライン・ヘルプを参照してください。


置換演算を使用して、「外部 ID マッピング」プロパティーで行う式の編集を制限できます。

置換演算置換演算を実行すると、既存の部分文字列がすべて新しい部分文字列に置き換えられた文字列のコピーが返されます。

置換演算には次の規則が適用されます。

v 文字 ¥ を使用して、関数パラメーター内の文字をエスケープする。¥ や " などの文字はエスケープする必要があります。

v ネストされた関数呼び出しはサポートされない。

v 特殊文字はサポートされない。

構文

${replace(<文字列>,<旧>,<新>)}

Replace 操作のパラメーター

表 44. Replace 操作のパラメーターおよび説明


str 検索対象の文字列

<旧> 新しい部分文字列で置き換えられる既存の部分文字列

<新> 既存の部分文字列を置き換える新しい部分文字列

例

${replace(${environment("REMOTE_USER")},"NAMERICA¥¥",)}

${replace(${environment("REMOTE_USER")},"NAMERICA¥¥","")}

CA SiteMinder 認証プロバイダーCA SiteMinder ネームスペースを認証ソースとして使用するように IBM CognosAnalytics を設定できます。

認証プロバイダーでは、CA SiteMinder Software Development Kit を使用してカスタム・エージェントを実装します。カスタム・エージェントを配布するには、CASiteMinder Policy Server の管理コンソールで 4.x エージェントをサポートするように「エージェントのプロパティー」を設定する必要があります。

CA SiteMinder 設定要件

CA SiteMinder Policy Server で以下の項目を設定します。

v Cognos Analytics では、Cognos Analytics Server 11.0.x URL での特定の特殊文字および文字シーケンスを許可する必要があります。エラーを回避するには、


以下の文字シーケンスを CA SiteMinder Policy Server の Agent ConfigurationObject の BadURLChars パラメーターのリストから削除します。

– 波形記号 (~)

– ピリオド (.)

– ピリオドとスラッシュ (./)

– スラッシュとピリオド (/.)

– 大なり記号 (>)

ヒント: レポートに URL を埋め込むお客様は、URL パラメーターで渡される文字を確認し、CA SiteMinder がこれらの文字を BadURLChars またはBadCSSChars として扱わないようにする必要があります。詳細については、CASiteMinder のドキュメントを参照してください。

v Cognos Analytics は、その機能を提供するために 4 つの verb を必要とします。 CA SiteMinder Policy Server で、GET、POST、PUT、および DELETEの各値を有効にしてください。

複数のユーザー・ディレクトリーを使用するように設定された CASiteMinder

複数のユーザー・ディレクトリーを使用するように CA SiteMinder 環境を設定した場合には、IBM Cognos Configuration で SiteMinder ネームスペース・タイプを使用する必要があります。

また、IBM Cognos Configuration で SiteMinder ネームスペースを設定した後、CA SiteMinder で定義した各ユーザー・ディレクトリーに対し、対応する LDAPネームスペースまたは Active Directory サーバー・ネームスペースを IBMCognos Configuration に追加する必要があります。

対応する LDAP ネームスペースを設定する場合は、「外部 ID マッピング」プロパティーが有効になっており、REMOTE_USER トークンがプロパティー値に含まれていることを確認します。これは、REMOTE_USER を設定するように CA SiteMinderを設定する必要があるということではありません。

対応する Active Directory ネームスペースを設定する際には、singleSignonOptionプロパティーが IdentityMapping に設定されていることを確認します。

SiteMinder ネームスペースでは、CA SiteMinder 環境から正しいユーザー識別番号が渡されると、REMOTE_USER 環境変数を使用して、該当する LDAP ネームスペースにユーザー情報が内部的に渡されます。

詳細については、 281 ページの『REMOTE_USER を使用する Active Directoryサーバーと IBM Cognos コンポーネント間でのシングル・サインオンの有効化』を参照してください。



単一のユーザー・ディレクトリーのみを使用するように設定されたCA SiteMinder

単一のユーザー・ディレクトリーのみを使用するように CA SiteMinder 環境を設定した場合には、IBM Cognos Configuration で SiteMinder ネームスペース・タイプを使用する必要はありません。

この場合、適切なネームスペースを設定することでユーザー・ディレクトリーを認証ソースとして使用するか、1 つのユーザー・ディレクトリーを使用するようにSiteMinder を設定できます。例えば、CA SiteMinder ユーザー・ディレクトリーが LDAP の場合は、LDAP ネームスペースを使用して IBM Cognos コンポーネントを設定できます。または、LDAP ネームスペースである 1 つのユーザー・ディレクトリーを参照し、単一の SiteMinder ネームスペースを使用します。

CA SiteMinder ユーザー・ディレクトリーが Active Directory である場合、Active Directory ネームスペースか、Active Directory とともに動作するように設定された LDAP ネームスペースを使用できます。

SiteMinder ネームスペースを構成する代わりにユーザー・ディレクトリーを認証ソース・ディレクトリーとして使用したい場合は、適切な LDAP または ActiveDirectory ネームスペースを構成することができます。この場合、CA SiteMinderPolicy Server の「Agent Configuration Object」プロパティーを検証する必要があります。SetRemoteUser が有効であることを確認します。

Active Directory ネームスペースを設定する際には、singleSignonOption プロパティーが IdentityMapping に設定されていることを確認します。

対応する LDAP ネームスペースを設定する場合は、「外部 ID マッピング」プロパティーが有効になっており、REMOTE_USER トークンがプロパティー値に含まれていることを確認します。

詳細については、 281 ページの『REMOTE_USER を使用する Active Directoryサーバーと IBM Cognos コンポーネント間でのシングル・サインオンの有効化』を参照してください。


SiteMinder ネームスペースの設定複数のユーザー・ディレクトリーを使用するように CA SiteMinder を設定した場合には、IBM Cognos Configuration で SiteMinder ネームスペース・タイプを使用する必要があります。また SiteMinder ネームスペースを追加した後に、CASiteMinder 環境の各ユーザー・ディレクトリーについて、対応する LDAP ネームスペースを追加する必要もあります。

ユーザーが LDAP サーバーまたは Active Directory サーバーに格納されている場合は、SiteMinder ネームスペース・タイプも使用できます。

ユーザーのログオン時にネームスペースを非表示にすることができます。ユーザーのログオン時にネームスペースの選択リストに表示することなく、信用サインオン・ネームスペースを使用できます。例えば、複数のシステムをシングル・サイン


オンに統合したいと考えているものの、ネームスペースの選択を求めるプロンプトを表示することなく顧客を IBM Cognos において直接認証する機能は維持したいと考えているような場合に適しています。

始める前に

SiteMinder ネームスペースを使用するには、次の表に示す必要な CA SiteMinderライブラリー・ファイルを入手し、オペレーティング・システムの適切なライブラリー・パスにそれらのファイルを追加する必要があります。

表 45. CA SiteMinder ライブラリー・ファイル

オペレーティング・システム CA SiteMinder ライブラリー・ファイル

Solaris および AIX libsmagentapi.so

Microsoft Windows 64 ビット smagentapi.dll

smerrlog.dll

手順1. Content Manager がインストールされているコンピューターで、CA

SiteMinder ライブラリー・ファイルが含まれているディレクトリーを適切なライブラリー・パス環境変数に追加します。

v Solaris オペレーティング・システムの場合: LD_LIBRARY_PATH

v AIX オペレーティング・システムの場合: LIBPATH

v Microsoft Windows オペレーティング・システムの場合: PATH

2. IBM Cognos Configuration を開きます。



5. 「タイプ」のリストで「SiteMinder」を選択し、「OK」をクリックします。

6. 追加したネームスペースを選択します。

7. 「ネームスペース ID」プロパティーに、ネームスペースの一意の識別子を指定します。

ヒント: 識別子では、コロン (:) を使用しないでください。

8. 他の必要なプロパティーの値を指定します。

ヒント: ユーザーがログインしているときにネームスペース名を表示できないようにする場合は、「認証のために選択可能」プロパティーを「無効 (False)」に設定します。

9. 「エクスプローラー」ウィンドウの「セキュリティー」 > 「認証」で、追加したネームスペースを右クリックし、「リソースの新規作成」 >「SiteMinder Policy Server」の順にクリックします。

10. 「名前」ボックスにポリシー・サーバーの名前を入力し、「OK」をクリックします。


11. 「プロパティー」ウィンドウで、「ホスト名」プロパティーと、変更を要するその他のプロパティー値を指定します。

12. 「エクスプローラー」ウィンドウで、追加した新しい SiteMinder PolicyServer を右クリックし、「リソースの新規作成」 > 「ユーザー・ディレクトリー」の順にクリックします。

13. 「名前」ボックスにユーザー・ディレクトリーの名前を入力し、「OK」をクリックします。

重要: 名前は、Policy Server にあるユーザー・ディレクトリーの名前と一致している必要があります。

14. 「プロパティー」ウィンドウで、「ネームスペース ID の参照」プロパティーの値を入力します。

15. ユーザー・ディレクトリーは、SiteMinder Policy Server のユーザー・ディレクトリーごとに設定します。





18. ユーザー・ディレクトリーごとに、対応する LDAP または Active Directoryのネームスペースを構成します。

SiteMinder ネームスペースの「ネームスペース ID」プロパティーに使用したのと同じ値を、必ず「ネームスペース ID」プロパティーに使用してください。

SAP を使用するための IBM Cognos の設定SAP サーバーを認証プロバイダーとして使用するには、SAP BW のサポートされているバージョンを使用する必要があります。

SAP BW では、ユーザーをユーザー・グループまたは役割、あるいはその両方に割り当てることができます。SAP 認証プロバイダーでは、役割のみが使用されます。

SAP ユーザーに必要な承認権限は、IBM Cognos コンポーネントを使用するユーザーや管理者に応じて変わります。


IBM Cognos ユーザー用の SAP 承認設定

IBM Cognos ユーザーには、次の表に示す承認オブジェクトが必要です。

表 46. IBM Cognos ユーザー用の SAP 承認設定

承認オブジェクトフィールド値

S_RFC

RFC アクセスのための許可検査

アクティビティー

保護される RFC の名前 RFC1 RS_UNIFICATION、SDTX、 SH3A、SU_USER、 SYST、 SUSO

保護される RFC のタイプ FUGR

S_USER_GRP

ユーザー・マスター・メンテナンス: ユーザー・グループ

アクティビティー 03

ユーザー・グループの名前 *

「*」と表示されているものなど、記載されている値のいくつかはデフォルト値であり、使用環境に合わせて変更することができます。

IBM Cognos 管理者用の SAP 承認設定

管理用タスクおよびユーザーや役割の検索を実行するユーザーには、IBM Cognosユーザーに対する値に加えて、次の表に示す値を S_RFC 承認オブジェクトに追加する必要があります。

表 47. IBM Cognos 管理者用の SAP 承認設定

承認オブジェクトフィールド値

S_RFC

RFC アクセスのための許可検査

アクティビティー 16

RFC_NAME PRGN_J2EE、SHSS、SOA3

保護される RFC オブジェクトのタイプ

FUGR

「*」など、記載されている値の一部はデフォルト値であり、使用環境に合わせて変更してください。

UNIX における SAP BW と IBM Cognos の接続

UNIX オペレーティング・システムにおける SAP BW と IBM Cognos コンポーネントの接続を設定するには、SAP により提供されている SAP 共有ライブラリー・ファイルをインストールし、このファイルをライブラリー・パスの環境変数に次のように追加します。

v Solaris


LD_LIBRARY_PATH=$LD_LIBRARY_PATH:<librfccm.so_directory>

v AIX

LIBPATH=$LIBPATH:<librfc.a_directory>

SAP ネームスペースの設定SAP サーバーを認証ソースとして使用するように IBM Cognos コンポーネントを設定できます。

始める前に

64 ビットのサーバーに IBM Cognos 製品をインストールした場合は、SAP RFCライブラリー・ファイルを IBM Cognos のインストール・ディレクトリーに手動でコピーする必要があります。

手順1. 64 ビットのサーバーで実行する場合は、次の手順に従います。

v 64 ビットのサーバーの SAP インストール・ディレクトリーに移動します。

v 64 ビットの SAP RFC ライブラリー・ファイルをすべて、インストールの場所¥bin64 にコピーします。

v 32 ビットの SAP RFC ライブラリー・ファイルをすべて、インストールの場所¥bin にコピーします。

2. 32 ビットのサーバーで実行する場合は、32 ビットの SAP ライブラリー・ファイルをすべて、SAP インストール・ディレクトリーからinstall_location¥bin64 ディレクトリーにコピーします。

3. Content Manager がインストールされている場所で、IBM CognosConfiguration を開きます。

4. 「エクスプローラー」ウィンドウの「セキュリティー」で、「認証」を右クリックし、「リソースの新規作成」>「ネームスペース」の順にクリックします。


6. 「タイプ」のリストで「SAP」をクリックし、「OK」をクリックします。



重要: 「ネームスペース ID」プロパティーでは、コロン (:) は使用しないでください。

8. IBM Cognos コンポーネントで既存の認証プロバイダーを見つけて使用されるように、必要なプロパティーすべてに対して値を指定します。

使用している環境によっては、「ホスト名」プロパティーで、SAP ルーター文字列を SAP ホスト名に追加することが必要となります。


9. SAP システムで Cookie の内容がエンコードされる場合、チケットのデコード機能を有効にします。

v 「プロパティー」ウィンドウの「詳細プロパティー」で、「値」をクリックしてから「編集」アイコンをクリックします。


v 名前に「URLDecodeTickets」と入力し、値に「有効 (true)」と入力します。


SAP ログオン・チケットはすべて、接続の確立前に SAP ネームスペースでデコードされます。





SAP と IBM Cognos 間でのシングル・サインオンの有効化SAP BW データ・ソース接続の外部ネームスペース機能を使用する場合のほかにも、SAP Enterprise Portal と IBM Cognos コンポーネント間でシングル・サインオンを有効にすることができます。

これには、SAP BW サーバーの次のシステム・パラメーターを設定する必要があります。

v login/accept_sso2_ticket = 1

v login/create_sso2_ticket = 1

v login/ticket_expiration_time = 200

認証プロバイダーの削除追加したネームスペースや、IBM Cognos コンポーネントによって検出された未設定のネームスペースが不要になった場合、不要なネームスペースを削除できます。

Cognos ネームスペースは削除できません。Cognos ネームスペースには、すべてのユーザーに関する認証データが収められており、設定を保存する際に必要になります。

一度ネームスペースを削除すると、そのネームスペースにはログオンできなくなります。ネームスペースのセキュリティー・データは、ポータルから永久に削除するまで Content Manager に残ります。詳細については、「IBM Cognos Analytics管理およびセキュリティー・ガイド」を参照してください。


手順1. Content Manager がインストールされているそれぞれの場所で、Cognos


2. 「エクスプローラー」ウィンドウの「セキュリティー」>「認証」で、ネームスペースを右クリックし、「削除」をクリックします。

3. 「はい」をクリックして、削除を確認します。

「エクスプローラー」ウィンドウでネームスペースが表示されなくなり、その場所のネームスペースにログオンできなくなります。


5. Content Manager をインストールした各場所に対して、手順 1～4 を繰り返します。

最後に、ポータルにログオンして、ネームスペースのデータを完全に削除します。詳細については、「IBM Cognos Analytics管理およびセキュリティー・ガイド」を参照してください。

タスクの結果

削除されたネームスペースは、ポータルに「非アクティブ」と表示されます。


第 9 章パフォーマンスの保守

ここでは、IBM Cognos Analytics やその他のツールと評価指標を使用して IBMCognos Analytics 環境のパフォーマンスを保守する方法について説明します。

システム・パフォーマンス評価指標IBM Cognos Analytics に用意されているシステム評価指標を使用すると、システム全体に加えて、各サーバー、ディスパッチャー、サービスの状態を監視することができます。また、評価指標スコアのしきい値を設定することもできます。システム・パフォーマンス評価指標には、システム内のセッション数、キュー内のレポートの待ち時間、Java 仮想マシン (Java Virtual Machine:JVM) の実行時間、システム内の要求数やプロセス数などがあります。

システム・パフォーマンス評価指標そのものは Java 環境側にありますが、ポータルを使えば、IBM Cognos Administration で監視することも可能です。システム・パフォーマンスの評価指標を監視する方法について詳しくは、「IBM CognosAnalytics 管理およびセキュリティー・ガイド」を参照してください。

システムの長期的な傾向を追跡したり、特定の時点におけるシステムの状態を詳細に確認するために、システム評価指標の現在のスナップショットを保存できます。詳しくは、「IBM Cognos Analytics トラブルシューティング・ガイド」で評価指標ダンプ・ファイルに関するトピックを参照してください。

Java Management Extensions (JMX) という技術を使えば、IBM CognosAdministration とは別の場所からでもシステム評価指標を監視できます。この技術には、アプリケーションとサービス指向のネットワークの管理と監視を行うためのツールも付いています。

システム評価指標の外部からの監視Java Management Extensions (JMX) という業界標準を使用すれば、IBM CognosAdministration とは別の場所からでもシステム評価指標を監視できます。まず、Java 環境側の評価指標に安全にアクセスできるように、IBM CognosConfiguration 側で 2 つの JMX プロパティーを設定します。次に、ユーザー IDとパスワードを使って、JMX 接続ツールから評価指標への接続を保護します。

始める前に

外部監視機能を使用するには、Oracle Java SE Development Kit、または IBM のJava Software Development Kit をインストールする必要があります。

手順1. Content Manager がインストールされているそれぞれの場所で IBM Cognos



313

3. 「プロパティー」ウィンドウの「ディスパッチャー設定」で「外部 JMX ポート」をクリックします。

4. 「値」列に空いているポート番号を入力します。

5. 「外部 JMX 資格情報」をクリックします。

6. 「値」列の「編集」アイコンをクリックし、ユーザー ID とパスワードを入力してから、「OK」をクリックします。

ユーザー ID とパスワードを設定しておけば、Java 環境のシステム評価指標データに、「外部 JMX ポート」に指定したポートを使って接続してくるユーザーを権限のあるユーザーに制限できます。

7. 変更内容を保存し、サービスを再起動します。

8. システム評価指標データにアクセスするには、JMX 接続ツールに次の情報を指定します。

v システム評価指標データへの接続用の URL


service:jmx:rmi://<Content Manager サーバー>/jndi/rmi://<監視サーバー>:<JMX のポート番号>/proxyserver

<JMX のポート番号> には「外部 JMX ポート」に入力した値、<ContentManager サーバー> と <監視サーバー> にはコンピューター名をそれぞれ指定します。ローカルで接続する場合でも、localhost は使用しないでください。

v 接続を保護するためのユーザー ID とパスワード

「外部 JMX 資格情報」に設定したとおりの値を使用します。

必要なサービスのみの有効化使用する環境で一部の IBM Cognos Analytics サービスが必要ない場合、不要なサービスを無効にすることで他のサービスのパフォーマンスの向上を図ることができます。

例えば、任意のコンピューターをレポートの実行、配布専用にするには、アプリケーション層コンポーネントのコンピューターで Presentation サービスを無効にします。Presentation サービスを無効にすると、アプリケーション層コンポーネントのパフォーマンスが向上します。

注:

v Presentation サービスは、IBM Cognos Analytics 環境の少なくとも 1 台のコンピューターで有効にしておく必要があります。

v Query Studio を使用する場合は、Presentation サービスを有効にする必要があります。

v Analysis Studio を使用する場合は、Report サービスを有効にする必要があります。

v 一部の IBM Cognos Analytics コンポーネントがコンピューターにインストールされていない場合は、インストールされていないコンポーネントに関連したサー


ビスを無効にする必要があります。有効にしたままにすると、IBM CognosAnalytics コンポーネントは規則性なく失敗します。

IBM Cognos サービス

IBM Cognos Analytics をインストールして設定すると、デフォルトでは 1 台のコンピューターにつき 1 つのディスパッチャーが使用可能となります。各ディスパッチャーには、次の表のような一連の関連サービスがあります。

表 48. IBM Cognos サービス

サービス目的

Agent サービスエージェントを実行する。エージェントが実行されているときにエージェントの条件が一致すると、Agent サービスから Monitor サービスに、タスクを実行するように指示が送られます。

Annotation サービスIBM Cognos ワークスペース経由でレポートにコメントを追加する。このコメントは、レポートの各バージョンにわたって存続します。

Batch Report サービスレポートを実行するためのバックグラウンド要求を管理し、Monitor サービスのための出力を行う。

Content Manager Cache サービス頻度の高いクエリー結果を各ディスパッチャーにキャッシュすることによって、全体的なシステム・パフォーマンスと ContentManager の拡張性を高める。

Content Manager サービスv 追加、クエリー、更新、削除、移動、コピ

ーなどの Content Store 内のオブジェクト操作機能を実行する。

v インポートやエクスポートなどの ContentStore 管理機能を実行する。

Delivery サービスReport サービス、Job サービス、Agent サービスなどの他のサービスのために、外部SMTP サーバーに E メールを送信する。

Event Management サービスレポート、ジョブ、エージェント、ContentStore 保守、および配布のインポートとエクスポートを表すイベント・オブジェクトの作成、スケジュール、管理を行う。

Graphics サービスReport サービスのために画像を生成する。画像は、Raster、Vector、Microsoft ExcelXML、または PDF という 4 種類の形式で生成できます。

Human Task サービスヒューマン・タスクを作成および管理できるようにする。レポート承認などのヒューマン・タスクは、その場で、またはその他の任意のサービスによって、個人またはグループに割り当てることができます。

第 9 章パフォーマンスの保守 315

表 48. IBM Cognos サービス (続き)

サービス目的

Interactive Discovery Visualization サービス

視覚化の推奨を提供するために CognosWorkspace で使用される。

Job サービスジョブ・ステップをバックグラウンドで実行するように Monitor サービスに指示を送ることでジョブを実行する。ステップには、レポート、その他のジョブ、インポート、エクスポートなどがあります。

Log サービスディスパッチャーや他のサービスによって生成されたログ・メッセージを記録する。Logサービスによって記録されるログ情報の保存先として、ファイル、データベース、リモート・ログ・サーバー、Windows イベント・ビューアー、UNIX システム・ログを指定できます。これにより、次に挙げるログ情報を自分自身で、あるいは Cognos SoftwareServices の担当者が分析できます。

v セキュリティー・イベント

v システムおよびアプリケーションのエラー情報

v 選択した診断情報

Metadata サービスCognos Viewer、Reporting、QueryStudio、Analysis Studio で表示されるデータ系統情報をサポートする。系統情報には、データ・ソースや算出式などの情報があります。

Migration サービスIBM Cognos Series 7 から IBM CognosAnalytics への移行を管理する。



サービス目的

Mobile サービスIBM Cognos Mobile クライアントに関連した以下の処理を管理します。

v レポートおよび分析をモバイルでの使用のために変換する。

v レポートおよび分析のコンテンツを圧縮し、Over the Air 方式でモバイル・デバイスに短時間で配布してそれらのデバイスからアクセスできるようにする。

v レポートおよび分析のコンテンツをモバイル・デバイスにプッシュする。

v モバイル・デバイスと環境との間でレポートを検索、表示、および実行するために、レポート関連および分析関連の要求の着信と発信を容易にする。

v サーバー上のモバイル Content Store をモバイル・デバイス上のモバイル・データベースと同期させる。

v Simple Object Access Protocol (SOAP)メッセージをワイヤレス対応メッセージに変換する。

v モバイル・デバイスと通信する。

Monitor サービスv スケジュールされているか、後で実行する

ように送信されているか、またはバックグラウンド・タスクとして実行されているタスクの監視および実行を管理する。

v スケジュールされたタスクを処理するターゲット・サービスを割り当てる。例えばMonitor サービスでは、Batch Report サービス、Job サービス、Agent サービスに対して、それぞれレポートの実行、ジョブの実行、エージェントの実行の指示が送られる場合があります。

v Content Manager 内に履歴オブジェクトを作成し、エントリー実行のフェイルオーバーと回復を管理する。

PowerPlay サービス PowerPlay レポートを実行するための要求を管理する。

Presentation サービスv 他のサービスから受け取った汎用の XML

応答を、HTML や PDF などの出力形式に変換する。

v 表示、ナビゲーション、および管理機能を提供する。

Query サービス動的クエリー要求を管理し、要求元の BatchReport サービスまたは Report サービスに結果を返す。



サービス目的

Relational metadata サービスリレーショナル・データベースからメタデータをインポートするために FrameworkManager および CubeDesigner によって使用される。また、実行時に Dynamic QueryAnalyzer によって使用されることもあります。

Report Data サービスIBM Cognos Analytics と、データを使用する IBM Cognos for Microsoft Office やIBM Cognos Mobile などのアプリケーションの間の、レポート・データの転送を管理する。

Report サービスレポートを実行するための対話式要求を管理し、ユーザー向けの出力を行う。

リポジトリー・サービスアーカイブ・リポジトリーまたはオブジェクト・ストアからアーカイブされた出力レポートを取得するための要求を管理する。

IBM Db2 Content Store の調整Content Store として Db2 データベースを使用する場合は、要求の処理速度を上げる手順があります。

Db2 のデフォルトでは、ラージ・オブジェクト (LOB) を格納するテーブルは、データベースで管理される表スペースに割り当てられます。そのため、それらの LOBは Db2 バッファー・プールでは管理されません。この結果、LOB についての直接的な入出力要求が発生し、パフォーマンスに影響を与えることになります。LOB を含むテーブルをシステムで管理される表スペースに再割り当てすると、直接的な入出力要求の数を削減できます。

Db2 Content Store を変更する前に、データベースを再構成するのに十分なログ・スペースを割り当ててください。

Db2 Content Store の再設定を行うには、次の手順に従います。

v 1 つ以上のラージ・オブジェクト (LOB) を含むテーブルからデータをエクスポートします。

v システムで管理される表スペースにテーブルを作成します。

v エクスポートしたデータを、このテーブルにインポートします。

IBM Cognos サービスのメモリー・リソースの調整分散環境では、IBM Cognos サービスで使用するリソース量を変更すると、パフォーマンスが向上します。

IBM Cognos サービスでは、最小限のメモリー・リソースが使用され、始動時間が可能な限り短くなるようにデフォルトで設定されています。


IBM Cognos サービスの設定は、IBM Cognos Analytics においてデフォルトで使用されるアプリケーション・サーバーにのみ適用されます。IBM Cognos Analyticsを別のアプリケーション・サーバーで実行するように構成する場合は、リソースの設定に IBM Cognos Configuration を使用しないでください。代わりに、そのアプリケーション・サーバーの環境内でリソースを設定します。

IBM Cognos サービスは、Content Manager またはアプリケーション層コンポーネントがインストールされているコンピューターでのみ使用できます。


2. 「エクスプローラー」ウィンドウで、「環境」 > 「IBM Cognos サービス」と展開し、「IBM Cognos」をクリックします。

3. 「プロパティー」ウィンドウで、「最大メモリー (MB)」の値を変更します。

v 起動時間を短縮し、メモリー占有スペースと使用リソースを減らすには、デフォルト設定 4096 を使用します。

v 使用可能なシステム・リソースに基づいて、この値を調整できます。


Cognos Mobile のパフォーマンスIBM Cognos Mobile 環境のパフォーマンスを評価および制御するために、さまざまな方法を使用できます。

IBM Cognos Mobile に必要な帯域幅の推定

IBM Cognos Mobile は、レポートの圧縮バージョンをサーバーからモバイル・デバイスに送信します。

レポートの各バージョンは 1 回だけ送信されます。その後、それはモバイル・デバイスのキャッシュに保管されます。その後、モバイル・ユーザーは追加の帯域幅を消費することなく、レポートをデバイス上で任意の回数表示できます。

Cognos Workspace ダッシュボードでの Content Store のブラウズやプロンプトに対する応答など、他の操作でも帯域幅を消費します。消費される帯域幅は、デスクトップ・ブラウザーで同じ操作を実行する場合に使用される帯域幅に比例します。

帯域幅のコストを推定するために、管理者は次の式をガイドとして使用できます。

(number of users) x (average size of a report) x(number of number of scheduled reports sent to each user per day)

必要なサーバー数の推定

あるユーザーがサーバー (ディスパッチャー) 上で IBM Cognos Mobile を使用するときに生成される負荷が最小になるのは、そのユーザーがアクティブ・レポートのみを消費している場合です。 Cognos Workspace ダッシュボードのユーザーの場合、デスクトップ・ユーザーの場合と比べて、アプリによってサーバーに追加の負荷がかかることはありません。


ネットワークでのレポート配信時間の短縮グローバルに配布されたレポートをリモートの場所で開く場合、ローカルにあるレポートを開くよりも長い時間がかかります。また、PDF レポートに比べると、HTML レポートではより多くの要求が処理されるため、レポートを開く時間が長くなります。

リモートの場所にあるレポートを開く場合、2 つの方法で時間を短縮できます。PDF 形式でレポートを実行すると、ブラウザーとサーバーの間で処理される要求の数を減らすことができます。HTML レポートが必要である場合は、リモートにあるいくつかの場所で追加のゲートウェイを設定することで、レポートの配信を高速化できます。画像やスタイル・シートなどの静的コンテンツは、より短時間で配信されます。

ユーザー負荷の大きい環境では非同期タイムアウトに大きな値を設定するユーザー負荷が大きく (ユーザーが 165 人を超える場合)、分散インストールで双方向レポートが常時実行されている場合は、エラー・メッセージが表示されるのを防ぐために、非同期タイムアウトに大きな値を設定できます。デフォルト設定は30000 です。

また、キューの時間制限に 360 を設定することもできます。詳しくは、「IBMCognos Analytics 管理およびセキュリティー・ガイド」を参照してください。

この問題を解決するには、待機のタイムアウトの値を大きくします。

手順1. 次のディレクトリーに移動します。

<インストールの場所>/webapps/p2pd/WEB-INF/services/

2. テキスト・エディターで"reportservice.xml"ファイルを開きます。

3. "async_wait_timeout_ms"パラメーターを 120000 に変更します。


5. サービスを再起動します。


第 10 章 UNIX および Linux オペレーティング・システムでIBM Cognos Analytics を手作業で構成する

IBM Cognos Analytics をインストールする UNIX または Linux オペレーティング・システム・コンピューターに接続されているコンソールでは、Java ベースのグラフィカル・ユーザー・インターフェースがサポートされていない場合があります。

次の作業を手作業で行う必要があります。

__ v デフォルトの設定を変更する。 <インストールの場所>/configuration ディレクトリーにある cogstartup.xml ファイルを編集します。

__ v サポートする言語や通貨、またはロケール・マッピングを変更する。 <インストールの場所>/configuration ディレクトリーにある coglocale.xml ファイルを編集します。

__ v 変更後の設定とロケールの設定をコンピューターに適用する。 IBM CognosConfiguration をサイレント・モードで実行します。

どのような方法でインストールを行う場合でも、環境で IBM Cognos Analytics が動作するように設定作業を行う必要があります。IBM Cognos Analytics コンポーネントを複数のコンピューターに分散してインストールする場合は、コンピューターを設定して起動する順序が重要です。

その他の設定作業はオプションです。レポート作成環境に応じて行ってください。IBM Cognos Analytics のデフォルトの動作を変更するには、cogstartup.xml ファイルを編集してプロパティー値を変更します。また、サンプル・ファイルを使用して、環境内にある既存のリソースを IBM Cognos Analytics で利用することもできます。

デフォルトの構成設定を手動で変更するUNIX または Linux オペレーティング・システム・コンピューターに接続されているコンソールで Java ベースのグラフィカル・ユーザー・インターフェースがサポートされていない場合は、"cogstartup.xml"ファイルを編集して、使用環境で IBMCognos Analytics が正常に動作するように設定する必要があります。

重要: 設定の中には、グラフィカル・ユーザー・インターフェースを使用しないと"cogstartup.xml"ファイルに保存できないものもあります。例えば、"cogstartup.xml"ファイルを直接変更して IBM Cognos Configuration をサイレント・モードで実行すると、IBM Cognos コンポーネントにサーバーのタイム・ゾーンが設定されません。この場合、サーバーのタイム・ゾーンに基づく他のユーザー設定が予想どおりに動作しないことがあります。

環境内にある既存の認証プロバイダーなどのリソースを IBM Cognos Analytics で利用する場合は、設定にコンポーネントを追加できます。この作業では、サンプル・ファイル内の XML コードの必要な部分を"cogstartup.xml"ファイルにコピーして、環境に合わせて値を編集します。

321

デフォルトの設定では、"cogstartup.xml"ファイルは UTF-8 でエンコードされています。"cogstartup.xml"ファイルを保存する際に、使用されているエンコード方式に合わせてユーザー・ロケールのエンコード方式を変更する必要があります。ユーザー・ロケールのエンコード方式は、環境変数で設定されています。

"cogstartup.xml"ファイルを編集する場合、XML では大文字と小文字が区別されることに注意してください。要素ラベル、属性ラベル、要素、値など、あらゆるテキスト・データの取り扱いにおいて、大文字と小文字の使い分けが必要です。

"cogstartup.xml"ファイルを編集する前に、次の作業を必ず実行してください。

v バックアップ・コピーを作成する

v ネットワーク上の利用可能なコンピューターに Content Store を作成する

v インストールのタイプに必要な設定要件を確認する

手順1. <インストールの場所>/configuration ディレクトリーに移動します。

2. エディターで cogstartup.xml ファイルを開きます。

3. コメントを参考にして、変更する設定を見つけます。コメントは、<crn:parameter> 要素の開始タグの前に記述されています。

4. <crn:value> 要素の値を使用環境に合わせて変更します。

ヒント: 設定プロパティーのデータ型を指定する場合には、type 属性を使用すると便利です。

5. 手順 3 ～ 4 を繰り返し、環境に合わせてすべての設定値を変更します。


タスクの結果

ここで、検証用の XML エディターを使用して、変更内容が"cogstartup.xsd"ファイルに指定されている規則に従っていることを検証する必要があります。このファイルは"インストールの場所/configuration"ディレクトリーにあります。

コンポーネントを設定に追加するcogstartup.xml ファイルには、IBM Cognos Analytics およびデフォルトのコンポーネントで使用される構成設定が含まれています。IBM Cognos Analytics で使用されるコンポーネントを変更するには、サンプル・ファイルの XML 要素をcogstartup.xml ファイルにコピーします。次に、使用環境に合わせて設定値を編集します。

例えば、Content Store 用データベースとして Oracle データベースを使用する場合、「ContentManager_<言語コード>.xml」というサンプル・ファイルを使用してデフォルトのデータベース接続情報を置換できます。

IBM Cognos Analytics では、次の要素のインスタンスを一度に 1 つしか使用できません。

v Content Store 用データベース

v 暗号化プロバイダー


v IBM Cognos サービス用の設定テンプレート

XML ファイルの編集を開始する前に、ファイルの構造を理解しておく必要があります。

手順1. <インストールの場所>/configuration/samples ディレクトリーに移動します。

2. エディターで開くサンプル・ファイルを選択します。

v Oracle または IBM Db2 を Content Store として使用するには、ContentManager_language_code.xml ファイルを開きます。

v 認証プロバイダーを使用するには、「Authentication_<言語コード>.xml」ファイルを開きます。

v 暗号化プロバイダーを使用するには、「Cryptography_<言語コード>.xml」ファイルを開きます。

v ログ・メッセージをファイル以外に送るには、「Logging_<言語コード>.xml」ファイルを開きます。

v IBM Cognos Analytics のプロセスで使用されるリソース量に応じて中規模用または大規模用のテンプレートを使用するには、「CognosService_言語コード.xml」ファイルを開きます。

3. 必要な要素をコピーします。

ヒント: コードをコピーする際、<crn:instance> 要素の開始タグと終了タグを含める必要があります。

例えば、(Begin of) および (End of) コメントを参照してください。

<crn:instance ...>...</crn:instance>



6. サンプル・ファイルからコピーしたコードを cogstartup.xml ファイルに貼り付けて、対応する <crn:instance> 要素を置換します。

7. 使用環境に合わせて、置換後の要素の値を変更します。

<crn:instance> 要素では、クラス属性を変更しないでください。 name 属性は、使用環境に合わせて変更できます。

例えば、Content Store 用データベースとして Oracle を使用する場合、使用環境に合わせて name 属性のみを変更します。

<crn:instance class="Oracle" name="MyContentStore">


第 10 章 UNIX および Linux オペレーティング・システムで IBM Cognos Analytics を手作業で構成する 323

9. 次のコマンドを入力して、IBM Cognos Configuration をサイレント・モードで実行します。

./cogconfig.sh -s

この結果ファイルが有効になり、パスワードが暗号化されます。

暗号化設定の手動による変更パスワードやユーザー資格情報など、"cogstartup.xml"ファイル内の暗号化設定を手作業で変更できます。

IBM Cognos Configuration に暗号化設定の保存を指示するには、値を変更して、暗号化フラグを"false"に設定します。

手順1. <インストールの場所>/configuration ディレクトリーに移動します。


3. コメントを参考にして、変更する暗号化設定を見つけます。コメントは、<crn:parameter> 要素の開始タグの前に記述されています。

4. <crn:value> 要素の値を使用環境に合わせて変更します。

ヒント: 設定プロパティーのデータ型を指定する場合には、type 属性を使用すると便利です。

5. 暗号化の値を"false"に変更します。


<crn:value encrypted="false">

6. 手順 3～5 を繰り返し、環境に合わせてすべての設定値を変更します。


8. 次の設定コマンドを入力します。

./cogconfig.sh -s

タスクの結果

新しい設定が保存されて暗号化されます。

UNIX および Linux オペレーティング・システムでのグローバル設定UNIX または Linux オペレーティング・システム・コンピューターに接続されているコンソールで Java ベースのグラフィカル・ユーザー・インターフェースがサポートされていない場合は、coglocale.xml ファイルを手動で編集する必要があります。

次の場合、グローバル設定を変更します。

v ユーザー・ロケールの言語を使用できない場合にユーザー・インターフェースで使用する言語を指定する


v ユーザー・ロケールを使用できない場合にレポートに使用するロケールを指定する

v レポート・データやメタデータに通貨やロケールのサポートを追加する

v ユーザー・インターフェース用にサポートする言語を追加する

ロケールは異なるソースから取得される場合があり、形式もそれぞれ異なっている可能性がありますが、デフォルトでは、IBM Cognos Analytics コンポーネントのすべてのロケールで標準形式が使用されます。したがって、拡張されたすべてのロケールは言語と地域コードの設定に準拠します。

ユーザー・インターフェース用にサポートする言語を追加するには、分散インストール環境のすべてのコンピューターに言語ファイルをインストールする必要があります。詳細については、サポート担当者に問い合わせてください。

例 1

Content Manager で使用できるレポートが、en-us (英語 - 米国) および fr-fr (フランス語 - フランス) という 2 つのロケールで表示可能であるが、ユーザー・ロケールが fr-ca (フランス語 - カナダ) に設定されているとします。この場合、IBMCognos では、ユーザーに表示されるレポートがロケール・マッピングを使用して判別されます。

まず、IBM Cognos では Content Manager を使用してユーザー・ロケールでレポートを表示可能かどうかが確認されます。ユーザー・ロケールで表示できない場合、ユーザー・ロケールは「コンテンツ・ロケール・マッピング」タブで設定された標準ロケールにマッピングされます。ここではユーザーのロケールが fr-ca なので、fr にマッピングされます。IBM Cognos はマッピングされた値を使用して、レポートが fr で使用可能かどうか確認します。このケースでは、レポートは en-usと fr-fr で使用できますが、fr では使用できません。

次に、表示可能な各レポートが標準ロケールにマッピングされます。したがって、en-us は en になり、fr-fr は fr になります。

レポートとユーザー・ロケールの両方が fr にマッピングされるため、ユーザー・ロケールが fr-ca であるユーザーは、ロケール fr-fr で保存されたレポートを表示できます。

例 2

ユーザー・ロケールとレポート・ロケールがすべて同じ言語にマッピングされているとします。この場合、IBM Cognos によって使用するロケールが選択されます。例えば、ユーザー・ロケールが en-ca (英語 - カナダ) で、レポートが en-us (英語- 米国) および en-gb (英語 - イギリス) で表示できる場合、IBM Cognos によって各ロケールが en にマッピングされます。レポートは、IBM Cognos で選択されたロケール設定で表示されます。

例 3

レポート・ロケールとユーザー・ロケールが同じ言語にマッピングされていないとします。この場合、IBM Cognos によって言語が選択されます。また、ユーザーがマッピングを設定することもできます。例えば、レポートが en-us (英語 - 米国)


および fr-fr (フランス語 - フランス) で表示可能であるが、ユーザー・ロケールはes-es (スペイン語 - スペイン) である場合、IBM Cognos によって言語が選択されます。

UNIX および Linux オペレーティング・システムのグローバル設定を手動で変更する

次の手順に従って、coglocale ファイルを使って UNIX および Linux オペレーティング・システムでグローバル設定を変更します。

手順1. Content Manager をインストールしたすべてのコンピューターで、"インストー

ルの場所/configuration"ディレクトリーに移動します。

2. エディターで coglocale.xml ファイルを開きます。

3. 開始タグと終了タグで囲まれている要素と属性を、必要に応じて追加または変更します。

次の表は、要素、属性、開始タグ、終了タグのリストです。

表 49. グローバル設定のタグ

要素のタイプ開始タグ終了タグ

言語 <supportedProductLocales> </supportedProductLocales>

コンテンツ・ロケール <supportedContentLocales> </supportedContentLocales>

通貨 <supportedCurrencies> </supportedCurrencies>

ユーザー・インターフェースのロケール・マッピング

<productLocaleMap> </productLocaleMap>

コンテンツ・ロケール・マッピング

<contentLocaleMap> </contentLocaleMap>

フォント <supportedFonts> </supportedFonts>

Cookie 設定、レポートのアーカイブ場所

<parameter name="setting"> </parameter>

ヒント: サポートを削除するには、その要素を削除します。


タスクの結果

ヒント: 検証用の XML エディターを使用して、変更内容が <インストールの場所>/configuration にある cogstartup.xsd ファイルに指定された規則に従っていることを検証します。

サポートされていない通貨コードは、"インストールの場所/bin/"ディレクトリーの"i18n_res.xml"ファイルに手動で追加する必要があります。このファイルを、IBM


Cognos がインストールされている各コンピューターにコピーします。

UNIX および Linux オペレーティング・システムでのサイレント・モードによる Cognos Analytics の起動および停止

Java ベースのグラフィカル・ユーザー・インターフェースをサポートしない UNIXまたは Linux オペレーティング・システム・コンピューターで、設定を適用してサービスを起動するには、IBM Cognos Configuration をサイレント・モードで実行します。

設定ツールをサイレント・モードで実行する前に、"cogstartup.xml"ファイルが"cogstartup.xsd" ファイルに定義されている規則に従っており、有効であることを確認する必要があります。cogstartup.xsd ファイルは、<インストールの場所>/configuration ディレクトリーにあります。

UNIX および Linux オペレーティング・システムでのサイレント・モードによる Cognos Analytics の起動

次の手順に従って、サイレント・モードで IBM Cognos Analytics ソフトウェアを起動します。

手順1. "cogstartup.xml"ファイルが環境に合わせて変更されていることを確認します。

このファイルは、"インストールの場所/configuration"ディレクトリーにあります。

詳細については、 321 ページの『デフォルトの構成設定を手動で変更する』を参照してください。

2. インストールの場所/bin64 ディレクトリーに移動します。


./cogconfig.sh -s

ヒント: 無人設定時に生成されたログ・ファイルのメッセージを確認するには、<インストールの場所>/logs ディレクトリーにある cogconfig_response.csv ファイルの内容を調べます。

タスクの結果

IBM Cognos Configuration では、"cogstartup.xml"ファイルで指定した設定の適用、資格情報の暗号化、デジタル証明書の生成が行われます。適切な場合は、Cognos サービスまたはプロセスが開始されます。

UNIX および Linux オペレーティング・システムでのサイレント・モードによる Cognos Analytics の停止

次の手順に従って、サイレント・モードで IBM Cognos Analytics ソフトウェアを停止します。


手順1. インストールの場所/bin64 ディレクトリーに移動します。


./cogconfig.sh -stop


第 11 章無人インストール、無人アンインストール、および無人構成

無人インストール、無人アンインストール、および無人構成は、次のような場合に使用します。

v ネットワーク上の複数のコンピューターに同じ設定をインストールする場合

v ユーザーごとのオプションと設定を指定して、インストールと設定を自動化する場合

v X Window を使用しない UNIX 環境または Linux 環境にコンポーネントをインストールし、設定する場合

v IBM Cognos Analytics をアンインストールする場合

無人インストールと設定を行う前に、システム要件と前提条件がすべて満たされており、必要なその他のソフトウェアがすべてインストールおよび設定されていることを確認してください。

無人インストールの使用以下の手順に従って、コンピューター間でインストール環境を複製します。その際、情報の入力を求めるプロンプトは表示されません。

手順1. 331 ページの『応答テンプレート・ファイルを使用したカスタム・インストー

ルまたは簡易インストールの作成』を実行するか、または、応答ファイルを保存するパラメーターを指定してコマンド行からインストール・ウィザードを実行します。次に例を示します。

Windows: ca_srv_<platform>_<build>.exe -r

"C:¥ResponseFile¥ResponseFile.properties".

UNIX または Linux: ./ca_srv_<platform>_<build> -r "./ResponseFile/

ResponseFile.properties"

注: インストール・ウィザードを実行する前に、ディレクトリー (例えばC:¥ResponseFile) が存在している必要があります。

応答ファイルを作成するためにフルインストールを実行する必要はありません。 -r オプションを使用してインストールを起動し、要約パネルまでそれを実行してから、インストールをキャンセルすることができます。いったんインストールが終了すると、応答プロパティー・ファイルが作成されます。

2. インストールが完了したら、必要に応じて応答ファイルを変更します。

応答ファイルには、応答ファイルを作成するためにインストール・ウィザードの実行時に使用した値に対応する値が含まれています。インストールの際に入力したパスワードは、暗号化された状態で応答ファイル内に含まれています。

329

3. ソフトウェアをインストールしようとしているコンピューターで、以下のいずれかを行います。

v 適切な製品のインストール・ディスクを挿入して、ディスクの内容をコンピューターにコピーします。

v ダウンロードした製品のインストール・ファイルをコンピューターにコピーします。

4. コマンドまたは端末ウィンドウで、インストール・ファイルをコピーしたオペレーティング・システムのディレクトリーに移動し、次のコマンドを入力します。

v Windows では、場所は、応答ファイル名ファイルを作成またはコピーしたディレクトリーです。

ca_srv_<platform>_<build> -f location¥response_filename -i silent

ヒント:

無人インストール応答ファイルをバッチ・ファイルから起動します。これは、インストールが完全に完了するまでインストール処理を待機してから、返します。また、バッチ・ファイルの末尾に %errorlevel% echo コマンドを追加することにより、インストール・バッチ・ファイル・エントリーの終了コードを知ることができます。例: install_location\

ca_srv_win64_11.0.3.16051211.exe -i silent -f location\

response_filename echo %errorlevel%

インストール中にエラーが発生すると、インストールのコマンド・プロンプト・ウィンドウに重要な情報が即座に表示される場合があります。成功すると、表示される終了コードは 0 (ゼロ) になるはずです。終了コードが 0 でない場合、2 つのオプションがあります。

a. install_location\logs\

IBM_Cognos_Analytics_Install_<timestamp>.log にあるインストール・ログを表示します

b. ユーザーの一時フォルダー %TEMPDIR%\install_output_log_cognos_analytics.txt にある追加の出力ログを表示します。このログ・ファイルには、考えられる終了コードとその説明のリストが示されます。また、さらに詳細を知りたい場合、語句「Install Error:」で検索できます。

v UNIX または Linux の場合:

./ca_srv_<platform>_<build> -f location/response_filename -i silent

v サポートされている言語でインストールするには、-l <lang_code> オプションを使用します。

例えば、フランス語でインストールして応答ファイルを作成するには、次のようにします。

Windows: ca_srv_<platform>_<build>.exe -l <lang_code> –r

location\response_filename.

UNIX または Linux: ./ca_srv_<platform>_<build> -l <lang_code> –r

location/response_filename


例えば Windows の場合に応答ファイルを使用してフランス語でインストールするには、以下のようにします。

c:¥CAinstallkit¥ca_srv_win64_11.0.3.16051211.exe -l fr -i silent -f

c:¥responselocation¥responsefile.properties echo %errorlevel%

表 50. サポートされる言語コード

コード言語

en 英語

es スペイン語

fr フランス語

it イタリア語

ja 日本語

ko 韓国語

pt_BR ポルトガル語 (ブラジル)

zh_CN 中国語 (簡体字)

zh_TW 中国語 (繁体字)

タスクの結果

ゼロ (0) 以外のステータスが返された場合には、ログ・ファイルにエラー・メッセージが記録されていないかどうかを調べてください。エラーは、インストール場所¥logs ディレクトリーの概要エラー・ログ・ファイルに記録されます。ファイル名の形式は、「tl-<製品コード>-<バージョン>-yyyymmdd-hhmm_summary-error.txt」です。

十分な初期化が終了する前にエラーが発生した場合は、Temp ディレクトリーにあるログ・ファイルにログ・メッセージが送られます。ファイル名の形式は、「tl-<

製品コード>-<バージョン>-yyyymmdd-hhmm.txt」です。

すべてのエラーが解決したら、無人設定を行えます。

応答テンプレート・ファイルを使用したカスタム・インストールまたは簡易インストールの作成

このトピックでは、無人インストールを作成するために使用できる 2 つの応答ファイル・テンプレートについて説明します。これらのテンプレートを使用すれば、応答ファイルを生成するためにインストールを実行する必要がありません。

.

手順1. このトピックをカット・アンド・ペーストして、カスタム・インストールまたは

簡易インストールに使用する応答ファイルを作成できます。

2. ファイル内のコメントのガイドラインに従って、作成した応答ファイルに変更を加えてください。

第 11 章無人インストール、無人アンインストール、および無人構成 331

▌Custom install response file template:▐

#Template of Response file for IBM Cognos Analytic Software Silent installation##This template is for a "Custom" install. If you want to do an "Easy" install#please use other template, located below.##(C) Copyright IBM(R) Corp. 2016. All rights reserved.

#Remember to make a copy of this file before editing it.

#Please DO NOT change the following variable since this is a "Custom" installBISRVR_INSTALLTYPE_CUSTOM=1

#Required - Install type for "Custom" install#-----------------------------------------------------------#You must select one of the following install types# If you want to perform "Custom/First Install",# set BISRVR_CUSTOM_FIRST to be 1, set the other to be 0# If you want to perform "Custom/Connect and install",# set BISRVR_CUSTOM_EXPAND to be 1, set the other to be 0#-----------------------------------------------------------BISRVR_CUSTOM_FIRST=BISRVR_CUSTOM_EXPAND=

#Required - Features#-----------------------------------------------------------------------#For "Custom/First install", feature DATATIER must be selected.# Other features can be selected at the same time too.#For Custom Expand Install, you must select at least one of the features.##BISRVR_FEATURE_DATATIER is called "Content repository" in GUI install.#BISRVR_FEATURE_APPTIER is called "Application services" in GUI install.#BISRVR_FEATURE_GATEWAY is called "Optional Gateway" in GUI install.#-----------------------------------------------------------------------BISRVR_FEATURE_DATATIER=BISRVR_FEATURE_APPTIER=BISRVR_FEATURE_GATEWAY=

#Required - Install Location#----------------------------------------------#The installation location#It is called "Install location" in GUI# DEFAULT:# on UNIX, and Linux# /opt/ibm/cognos/analytics# on Windows# C:\\Program Files\\ibm\\cognos\\analytics#----------------------------------------------USER_INSTALL_DIR=

#Required - Input Required for "Custom/Connect and install"#---------------------------------------------------------------------------------#The URL of the First Install and Cognos administrator credentials are required for# "Custom/Connect and install"##BISRVR_CANALYTICS_URL is called "Cognos Analytics URL" in GUI install#BISRVR_NAMESPACE is called "Namespace" in GUI install#BISRVR_COGNOSUSER is called "Cognos administrator user ID" in GUI install#BISRVR_COGNOSUSER_PASSWORD is called "Password" in GUI install.# The password must be encrypted. It can be obtained by recording a GUI install.#---------------------------------------------------------------------------------BISRVR_CANALYTICS_URL=BISRVR_NAMESPACE=BISRVR_COGNOSUSER=BISRVR_COGNOSUSER_PASSWORD=


#Optional - Options for Windows Install#-----------------------------------------------------------------------------#The following two entries are for Windows only#BISRVR_SHORTCUT is called "Program folder" in GUI install#BISRVR_ALLUSERS is called "Make shortcut visible to all users in the Start menu"# in GUI install. Set to 1 if you want the shortcut visible.#-----------------------------------------------------------------------------#BISRVR_SHORTCUT=#BISRVR_ALLUSERS=

#End of Custom install template#-----------------------------------------------------------------------------

▌Easy Install response file template:▐

#Template of Response file for IBM Cognos Analytic Software Silent installation##This template is for an "Easy" install. If you want to do a "Custom" install#please use other template, located above.##(C) Copyright IBM(R) Corp. 2016. All rights reserved.

#Remember to make a copy of this file before editing it.

#Required - Install type for "Easy install"#-----------------------------------------------------------------#You must select one of the following install types# If you want to perform "Easy install/First Install",# set BISRVR_INSTALLTYPE_READY to be 1, set the other to be 0# If you want to perform "Easy install/Connect and Install",# set BISRVR_INSTALLTYPE_EXPAND to be 1, set the other to be 0#-----------------------------------------------------------------BISRVR_INSTALLTYPE_READY=BISRVR_INSTALLTYPE_EXPAND=

#Required - Install Location#----------------------------------------------#The installation location#It is called "Install location" in GUI# DEFAULT:# on UNIX, and Linux# /opt/ibm/cognos/analytics# on Windows# C:\\Program Files\\ibm\\cognos\\analytics#----------------------------------------------USER_INSTALL_DIR=

#Required - Input Required for "Easy install"#-----------------------------------------------------------------------------#Cognos administrator credentials are required for "Easy install".#BISRVR_COGNOSUSER is called "Cognos administrator user ID" in GUI install.#BISRVR_COGNOSUSER_PASSWORD is called "Password" in GUI install.# The password must be encrypted. It can be obtained by recording a GUI install.#-----------------------------------------------------------------------------BISRVR_COGNOSUSER=BISRVR_COGNOSUSER_PASSWORD=

#Required - Input Required for "Easy install/Connect and Install"#--------------------------------------------------------------------#BISRVR_CANALYTICS_URL is called "Cognos Analytics URL" in GUI install#---------------------------------------------------------------------#BISRVR_CANALYTICS_URL=

#Optional - Options for Windows Install#-----------------------------------------------------------------------------#The following two entries are for Windows only


#BISRVR_SHORTCUT is called "Program folder" in GUI install#BISRVR_ALLUSERS is called "Make shortcut visible to all users in the Start menu"# in GUI install. Set to 1 if you want the shortcut visible.#-----------------------------------------------------------------------------#BISRVR_SHORTCUT=#BISRVR_ALLUSERS=

#End of Easy install template#-----------------------------------------------------------------------------

次のタスク

329 ページの『無人インストールの使用』のトピックの説明に従って、応答ファイルを実行します。

無人設定の使用無人設定を使用するには、設定するものと同じ IBM Cognos Analytics コンポーネントがすでにインストールされている既存のインストール環境から設定をエクスポートする必要があります。設定のエクスポートが終了したら、IBM CognosConfiguration をサイレント・モードで実行できます。

エクスポートした設定には、1 台のコンピューターにインストールした IBMCognos Analytics コンポーネントのプロパティーが含まれています。

始める前に

設定をエクスポートしているコンピューターの構成設定を、同じコンポーネントがインストールされている別のコンピューターで適切に使用できることを確認します。例えば、「ゲートウェイ URI」プロパティーのホスト名の部分を、ローカル・ホストから IP アドレスやコンピューター名に変更した場合は、この設定を新しいコンピューターの設定にそのまま使用できるか確認する必要があります。

手順1. IBM Cognos Configuration で、「ファイル」メニューの「名前を付けてエクス

ポート」をクリックします。

2. 復号化されたコンテンツをエクスポートするかどうかを尋ねられたら、「はい」をクリックします。

3. 現在の設定を別のフォルダーにエクスポートする場合、「検索先」ボックスでフォルダーを検索して開きます。

4. 「ファイル名」ボックスに設定ファイルの名前を入力します。

5. 「保存」をクリックします。

6. エクスポートした設定ファイルを、無人設定を行うコンピューターの <インストールの場所>/configuration ディレクトリーにコピーします。

7. ファイルの名前を cogstartup.xml に変更します。

8. <インストールの場所>/bin または <インストールの場所>/bin64 ディレクトリーに移動します。


v UNIX または Linux の場合は、次のように入力します。


./cogconfig.sh -s

v Windows の場合は、次のように入力します。

cogconfig.bat -s

ヒント: 無人設定時に生成されたログ・ファイルのメッセージを確認するには、<インストールの場所>/logs ディレクトリーにある cogconfig_response.csv ファイルの内容を調べます。

無人設定が成功したかどうかを確認するには、戻されるステータス値をチェックします。ステータス値がゼロ (0) である場合、設定が成功したことを示します。その他のステータス値はすべて、エラーが発生したことを示します。

タスクの結果

IBM Cognos Configuration では、cogstartup.xml ファイルで指定した設定の適用、資格情報の暗号化、デジタル証明書の生成が行われます。適切な場合は、IBMCognos サービスまたはプロセスが開始されます。

無人アンインストールの使用同じコンポーネントがインストールされた複数のコンピューター上のコンポーネントの削除を自動化するか、X Window を使用しない UNIX 環境または Linux 環境でコンポーネントを削除するように無人アンインストールを使用します。

ヒント: アンインストール中に Process エクスプローラーや MMC (MicrosoftManagement Console) などのモニタリング・ツールを実行していると、サービスの削除が妨げられます。一般にこれはすべてのサービスに言えることです。例えば、Cognos Analytics をアンインストールした後に、ApacheDS、IBMCognos、Informix などの製品サービスが完全に削除されずに、保守パネル上に停止状態または無効な状態として表示されます。これを回避するためには、アンインストールの実行中にモニタリング・ツールを実行しないでください。また、アンインストール後にそれらのモニタリング・ツールをシャットダウンすると、サービスの削除は完了します。

手順

以下のように、コマンド行からパラメーターを指定してアンインストール・ウィザードを実行します。Windows: インストールの場所/Uninstall_IBM_Cognos_Analytics.exe -i silent.UNIX または Linux: ./install_location/Uninstall_IBM_Cognos_Analytics -i

silent



第 12 章 IBM Cognos Analytics のアンインストール

すべての関連ファイルの削除とシステム・ファイルに対する変更の削除を完全に実行するには、アンインストール・プログラムを使用してください。IBM CognosAnalytics をアンインストールするには、サーバー・コンポーネントとモデル作成ツールをアンインストールします。

IBM Cognos Analytics をアプリケーション・サーバー環境で実行している場合は、アプリケーション・サーバーのベンダーから提供されている管理ツールを使用して、実行中のアプリケーションを停止し、IBM Cognos Analytics コンポーネントの Java の部分を配布解除します。多くのアプリケーション・サーバーでは、配布されたすべてのアプリケーション・ファイルまたはディレクトリーが完全に削除されないため、この作業を手動で行う必要があります。IBM Cognos Analytics コンポーネントを削除した後、このセクションの手順に従って UNIX およびMicrosoft Windows オペレーティング・システムでアンインストールを行います。

ヒント: アンインストール中に Process エクスプローラーや MMC (MicrosoftManagement Console) などのモニタリング・ツールを実行していると、サービスの削除が妨げられます。一般にこれはすべてのサービスに言えることです。例えば、Cognos Analytics をアンインストールした後に、ApacheDS、IBMCognos、Informix などの製品サービスが完全に削除されずに、保守パネル上に停止状態または無効な状態として表示されます。これを回避するためには、アンインストールの実行中にモニタリング・ツールを実行しないでください。また、アンインストール後にそれらのモニタリング・ツールをシャットダウンすると、サービスの削除は完了します。

重要: 新しいバージョンの IBM Cognos Analytics にアップグレードする際に、新しいバージョンで現在の設定データを使用する場合は、設定ファイルとデータ・ファイルを削除しないでください。

UNIX または Linux オペレーティング・システムでの IBM CognosAnalytics のアンインストール

IBM Cognos Analytics が不要になった場合や、UNIX または Linux オペレーティング・システムでアップグレードする場合は、IBM Cognos Analytics をアンインストールします。

アンインストールを行っても、設定ファイルやユーザー・データ・ファイルなど、インストール後に変更されたファイルは削除されません。インストール場所もコンピューターに残り、これらのファイルは手動で削除するまで維持されます。

手順1. コンピューターに接続されているコンソールで Java ベースのグラフィカル・ユ

ーザー・インターフェースがサポートされていない場合は、次のコマンドで、IBM Cognos Analytics のプロセス識別番号 (pid) を確認します。

337

ps -ef | grep cogbootstrapservice

2. IBM Cognos Analytics プロセスを次の手順に従って停止します。

v X Window を実行している場合は、IBM Cognos Configuration を起動し、「操作」メニューの「停止」をクリックします。

v X Window を実行していない場合は、次のように入力します。

kill -TERM プロセス識別番号

3. IBM Cognos Analytics をアンインストールするには、インストールの場所ディレクトリーに移動し、次の該当するコマンドを入力します。

v X Window を使用している場合は、次のように入力します。

./uninst -u

v X Window を使用しない場合は、無人アンインストールを実行します( 329 ページの『無人インストールの使用』を参照)。

4. プロンプトに従って、アンインストールを完了します。

5. Web ブラウザー・コンピューターからすべてのインターネット一時ファイルを削除します。

Microsoft Windows オペレーティング・システムでの IBM CognosAnalytics のアンインストール

IBM Cognos Analytics が不要になった場合や、アップグレードする場合は、IBMCognos Analytics のすべてのコンポーネントと IBM Cognos サービスをアンインストールします。

同じ場所に複数のコンポーネントがインストールされている場合は、アンインストール・ウィザードで、アンインストールするパッケージを選択できます。パッケージの全コンポーネントがアンインストールされます。アンインストールは、IBMCognos Analytics コンポーネントがインストールされている各コンピューターで繰り返し実行する必要があります。

Microsoft Windows オペレーティング・システムの設定ファイルやデータ・ファイルのバックアップを取る必要はありません。これらのファイルは、アンインストールを行っても削除されることはありません。

すべてのプログラムを閉じてから、IBM Cognos Analytics をアンインストールしてください。終了しないと、一部のファイルが削除されないことがあります。

アンインストールを行っても、設定ファイルやユーザー・データ・ファイルなど、インストール後に変更されたファイルは削除されません。インストール場所もコンピューターに残り、これらのファイルは削除するまで維持されます。新しいバージョンの IBM Cognos Analytics にアップグレードする際に、新しいバージョンで現在の設定データを使用する場合は、設定ファイルとデータ・ファイルを削除しないでください。


手順1. 「スタート」メニューから、「すべてのプログラム」 > 「IBM Cognos

Analytics」 > 「IBM Cognos Analytics のアンインストール」の順にクリックします。

「アンインストール」ウィザードが起動します。

ヒント: IBM Cognos Analytics は、インストール時に作成されるプログラム・フォルダーのデフォルトの名前です。別の名前を付けた場合は、そのフォルダーに移動してプログラムを選択してください。

2. 指示に従ってコンポーネントをアンインストールします。

"cognos_uninst_log.htm"ファイルには、ファイルのアンインストール時にアンインストール・ウィザードで実行された処理状況が記録されます。

ヒント: ログ・ファイルは、Temp ディレクトリーにあります。

3. Web ブラウザー・コンピューターからすべてのインターネット一時ファイルを削除します。

詳細については、Web ブラウザーのドキュメントを参照してください。

失敗したアンインストールからのリカバリーアンインストールが失敗すると、削除されるはずのファイル、レジストリー項目、サービスが残ることがあります。このトピックでは、簡易インストールとカスタム・インストールの両方の場合の指針を示します。

手順1. 初めての簡易インストールの場合:

a. 以下の Informix アンインストール・コマンドを実行して Informix を削除します。

install_location¥informix¥bin¥ifxdeploy.exe -u install_location¥informix -delifx

a. レジストリー・キーHKEY_LOCAL_MACHINE¥SOFTWARE¥Informix¥Online¥ol_cognoscm を削除します。

b. インストール・フォルダー install_location を削除します。

c. コンピューター上で他に InstallAnywhere ベースのインストールがない場合は、InstallAnywhere レジストリー・ファイル %PROGRAM FILES%¥Zero G

Registry¥.com.zerog.registry.xml を削除できます。

2. その他のすべてのインストール済み環境の場合:

a. インストール・フォルダー install_location を削除します。

b. コンピューター上で他に InstallAnywhere ベースのインストールがない場合は、以下の InstallAnywhere レジストリー・ファイルを削除できます。

Windows の場合 (非表示ディレクトリー): %PROGRAM FILES%¥Zero G

Registry¥.com.zerog.registry.xml

UNIX の場合: レジストリー・ファイル: .com.zerog.registry.xml、場所:

第 12 章 IBM Cognos Analytics のアンインストール 339

v ルートとしてログインしている場合、グローバル・レジストリーは /var内にあります。

v ユーザーとしてログインしている場合、そのユーザーのホーム・ディレクトリー内にあります。

InstallAnywhere インストール済み環境の状況が不明な場合は、このファイルのコピーを保持するために、ファイル名の変更だけを行うことができます。


第 13 章 IBM Cognos Content Archival

アーカイブしたコンテンツを外部リポジトリーに保管することにより、規制コンプライアンス要件に準拠できます。また、Content Store にあるコンテンツのサイズを削減して IBM Cognos 製品のスケーラビリティーとパフォーマンスを高めることもできます。

このソフトウェアは IBM FileNet® Content Manager with IBM FileNet CMIS 外部リポジトリーをサポートしています。 IBM Filenet CMIS のソフトウェアのバージョン 1 が既にインストールされている場合、このソフトウェアをフィックスパック・バージョン 2 でアップグレードする必要があります。ファイル・システムを使用するようにコンテンツ・アーカイブを構成することもできます。

管理者は、外部リポジトリーへのデータ・ソース接続を作成して、Content Storeからリポジトリーへコンテンツを移動できるようにします。その後、ユーザーは外部リポジトリーにあるアーカイブ・コンテンツを表示できます。最新のコンテンツとアーカイブされたコンテンツの検索結果が見ることができるので、ユーザーは現行データと履歴データの間で重要な比較を行えます。この効果的なメカニズムにより、お客様の会社は、シームレスなユーザー・エクスペリエンスを提供しながら企業および政府の要件を満たせます。

外部リポジトリーにあるアーカイブされたコンテンツが、IBM Cognos 環境で管理されることはありません。例えば、IBM Cognos Analytics でレポートを削除した場合、外部リポジトリーにあるアーカイブされた出力は削除されません。

アーカイブの管理方法について詳しくは、「IBM Cognos Analytics 管理およびセキュリティー・ガイド」を参照してください。

コンテンツをアーカイブするための、2 つのワークフロー・シナリオがあります。最初のワークフローは、IBM Cognos コンテンツ・アーカイブ・ソフトウェアのインストール後に、管理者がパッケージとフォルダーをアーカイブするものです。 2番目のワークフローは、管理者が、新しいパッケージとフォルダーのリポジトリー接続を作成するものです。

ワークフロー 1: Connectivity Software のインストール後にコンテンツをアーカイブする

管理者は、IBM Cognos Analytics のインストールまたはアップグレード後に、特定のパッケージとフォルダーまたはすべてのパッケージとフォルダーの保存済みのレポート出力をアーカイブすることができます。すべてのコンテンツは現在Content Store に存在するので、このワークフローは 1 回しか行う必要はありません。

v 外部リポジトリーへのデータ・ソース接続を作成する。

v アーカイブする必要があるパッケージとフォルダーのリポジトリー接続を選択する。

341

v コンテンツ・アーカイブ保守タスクを作成して実行し、外部リポジトリーにアーカイブするフォルダーとパッケージを選択する。

一度パッケージとフォルダーのリポジトリー接続を設定すれば、すべての新規レポート出力は自動的にアーカイブされます。つまり、コンテンツ・アーカイブ保守タスクを再度行う必要はありません。

ワークフロー 2: 新しいパッケージとフォルダーのリポジトリー接続を作成する

管理者は、これらのタスクを行って、新しいパッケージとフォルダーのリポジトリー接続を作成することができます。

v 外部リポジトリーへのデータ・ソース接続を作成する。

v アーカイブする必要があるパッケージとフォルダーのリポジトリー接続を選択する。

コンテンツ・アーカイブ・コンテンツ保守タスクの使用

コンテンツ・アーカイブ・コンテンツ保守タスクは、選択し設定したフォルダーとパッケージにあるレポート・バージョンへの参照を作成します。フォルダーとパッケージを選択してその中のコンテンツにマークを付け、外部リポジトリーにアーカイブされるまで Content Store に残るようにすることができます。

重要な点ですが、このタスクは、コンテンツを Content Store から外部リポジトリーに移動するものではないことにご注意ください。最初に、パッケージとフォルダーのリポジトリー接続を選択しなければなりません。フォルダーとパッケージにある、アーカイブするマークを付けられていないレポート・バージョンは、ContentStore から削除できます。

一度コンテンツにマークを付ければ、コンテンツ・アーカイブ・タスクは完了です。 Content Manager のバックグラウンド・タスクが、マークの付いた項目を見つけて、外部リポジトリーにコピーして保存します。

外部リポジトリーにアーカイブするものとして構成されているフォルダーまたはパッケージにコンテンツをインポートしても、インポートされたコンテンツが自動的にリポジトリーに移動されてアーカイブされるわけではありません。管理者は、このフォルダーまたはパッケージにコンテンツ・アーカイブ・コンテンツ保守タスクを実行して、インポートされたコンテンツをアーカイブしなければなりません。

バックグラウンド・タスク

Content Store から外部リポジトリーにコンテンツを移動するために使用されるバックグラウンド XML タスクは、archiveTask.xml および deleteTask.xml です。archiveTask.xml ファイルは、マークの付いたコンテンツを外部リポジトリーに移動します。このファイルを使用して、スレッド実行時間を設定し、選択したフォーマットの出力をアーカイブすることもできます。 deleteTask.xml ファイルは、マークの付いたバージョンのオブジェクトをキューから取り出し削除する構成ファイルです。このファイルを変更しないでください。


アーカイブ前のコンテンツ ID の保持

必要に応じて、レポート出力をアーカイブする前に、コンテンツ ID を保持できます。

インポート配布を実行しコンテンツをターゲット環境に移動する際、デフォルトでは、Content Store にあるオブジェクトのコンテンツ ID は削除されて新しい IDに置き換えられます。しかし、例えば、レポート出力を外部レポート・リポジトリーに移動する場合のように、コンテンツ ID を保持しなければならない場合があります。

コンテンツ・アーカイブの設定コンテンツ・アーカイブの環境を設定する必要があります。設定の変更を有効にするには、IBM Cognos サービスをいったん停止してから開始しなければなりません。

ファイル・システム・リポジトリーのファイル場所の作成レポートまたはレポート仕様をアーカイブして IBM Cognos コンテンツ・アーカイブのファイル・システム・リポジトリーに入れるには、ローカル・ドライブ上またはネットワーク共有上のファイル場所を示す別名ルートを作成する必要があります。

始める前に

管理者でありファイルの場所にアクセスする権限を持っている必要があります。Content Manager とアプリケーション層コンポーネントは、ファイル URI を使用してこの場所にアクセスすることが可能でなければなりません。

手順1. IBM Cognos サービスが実行中の場合は停止します。


3. 「アクション」 > 「グローバル設定を編集」をクリックします。

4. 「全般」タブで、「別名ルート」を選択して、値のフィールドの内側をクリックし、編集ボタンをクリックします。「値 - 別名ルート (Value - AliasRoots)」ダイアログ・ボックスが表示されたら、「追加」をクリックします。

5. 「別名ルート名」列に、ファイル・システム・リポジトリーのための一意の名前を入力します。

注: 作成できる別名の数に制限はありません。

6. ファイル・システムの場所へのパスを入力します。ファイル・システム・パスは、既存のファイル場所の絶対パスです。

v Windows では、windowsURI 列に、例えば file:///c:/file-system-pathのように、 file:/// の後にローカル・パスを続けて入力します。あるいは、file://server/share のように、file:// の後にサーバー名と共有パスを続けて入力します。

第 13 章 IBM Cognos Content Archival 343

v UNIX または Linux では、unixURI 列で、例えば file:///<ファイル・システム・パス> のように、file:/// の後にローカル・パスを続けて入力します。

注: file:///../ファイル・システム・パスなどの相対パスはサポートされません。

分散インストール環境では、Content Manager およびアプリケーション層コンポーネントの両方のコンピューターに、ファイルの場所にアクセスする権限が必要です。分散インストール環境でのみ、両方の URI を使用してください。別名ルートにある UNIX URI および Windows URI は、ファイル・システム上の同じ場所を示している必要があります。


8. IBM Cognos サービスを再開します。これには数分かかる場合があります。

タスクの結果

このファイル・システム・リポジトリー名を使用して、Cognos コンテンツ・アーカイブ・ソフトウェアと共に使用するデータ・ソース接続を作成します。詳細については、IBM Cognos「管理およびセキュリティー・ガイド」を参照してください。

IBM FileNet Content Manager へのカスタム・クラス定義とプロパティーのインポート

IBM Cognos コンテンツ・アーカイブを使用するには、カスタム・クラスおよびプロパティー・ファイルのセットを IBM FileNet Content Manager にインポートする必要があります。

カスタム・クラス定義とプロパティーには、FileNet 固有のメタデータが含まれています。カスタム・クラスとプロパティーのファイルは、いつでもインストール可能です。

手順1. FileNet のアーカイブをセットアップした場合は、インストールの場

所/configuration/repository/filenet/upgrade/ ディレクトリーに移動します。

2. FileNet のアーカイブがまだセットアップされていない場合は、インストールの場所/configuration/repository/filenet/new/ ディレクトリーに移動します。

3. CMECMIntegrationObjects_CEExport._xxx.xml ファイルを FileNet サーバーのローカル・フォルダーにコピーします。

4. FileNet Enterprise Manager Administration ツールを開き、FileNet 外部リポジトリーのドメインに接続します。

5. 対象のオブジェクト・ストアを選択し、「すべてのアイテムのインポート(Import All Items)」をクリックして、そのオブジェクト・ストアに定義をインポートします。


6. 「インポートのオプション (Import Options)」ウィンドウで「マニフェスト・ファイルのインポート (Import Manifest File)」をクリックして、CMECMIntegrationObjects_CEExport._xxx.xml ファイルがある場所を参照します。

7. CMECMIntegrationObjects_CEExport_Manifest.xml ファイルを選択し、「インポート」をクリックします。

8. FileNet Content Engine と FileNet CMIS アプリケーションを再始動して、変更内容をご使用の環境に適用します。

注: すべての FileNet ノードで変更が更新されるまでしばらくかかる場合があります。

IBM Content Manager 8 へのカスタム・クラス定義とプロパティーのインポート

IBM Cognos コンテンツ・アーカイブを IBM Content Manager 8 と共に使用するには、カスタム・クラスとプロパティー・ファイルのセットをインポートする必要があります。また、CMIS 設定ファイルを IBM Cognos フォルダー・タイプで更新する必要があります。

カスタム・クラス定義とプロパティーには、IBM Content Manager 8 固有のメタデータが含まれています。カスタム・クラスとプロパティーのファイルは、いつでもインストール可能です。

インストール処理中に定義されているリソース・マネージャーはないため、インポート処理中に競合エラー・メッセージが出されます。

始める前に

IBM Content Manager 8 は IBM Content Manager 8 CMIS バージョン 1.1 外部リポジトリーと共にインストールされている必要があります。

手順1. Content Manager 8 システム管理クライアントを開きます。

2. メインメニューから、「ツール」 > 「XML のインポート」をクリックします。

3. 「XML インポートのオプション」ウィンドウの「インポートするファイル」セクションで、以下を行います。

v 「データ・モデル・ファイル」フィールドで、「参照」をクリックし、オブジェクトのインポート元にするCMECMIntegrationTypes_RMImport_Manifest.xsd ファイルを選択します。

v 「管理オブジェクト・ファイル」フィールドで、「参照」をクリックし、管理オブジェクト・ファイルをインポートするCMECMIntegrationTypes_RMImport_MimeTypes.xml ファイルを選択します。

デフォルトの場所は、インストールの場所/configuration/repository/

contentManager8/New ディレクトリーです。

4. 競合を表示するには、「XML のインポート・オプション」ウィンドウの「処理オプション」で、「対話式に処理」を選択します。


5. 「インポート」をクリックして、インポート処理を開始します。

a. 「プリプロセッサーの結果のインポート」ウィンドウで、「項目タイプ」を展開し、競合を示す項目タイプをダブルクリックします。

b. 「インポート定義およびターゲット定義の詳細」ウィンドウの「結果のターゲット」列で、Content Manager 8 をインストールしたときに作成されたリソース・マネージャーとコレクションの名前を選択し、「承諾」をクリックします。

c. 競合を示す項目タイプごとにステップ a と b を繰り返します。

6. すべての競合を解決した後、「プリプロセッサーの結果のインポート」ウィンドウで「続行」をクリックします。

7. 「インポートの選択項目の確認」ウィンドウで「インポート」をクリックします。

8. インポートが完了したら、「OK」をクリックします。

9. CMIS 設定ファイルを更新して IBM Cognos フォルダー・タイプを検出するには、CMIS for Content Manager 8 設定プログラムを実行して、プロファイルを作成します。

10. IBM CMIS for Content Manager 設定プロファイル・フォルダー内のcmpathservice.properties ファイルを開きます。

UNIX の場合、デフォルトのファイル・パスは /opt/IBM/CM_CMIS/profiles/profile1 です。

Windows の場合、デフォルトのファイル・パスは C:¥ProgramFiles¥IBM¥CM_CMIS¥profiles¥profile1 です。

a. folderTypes 行を見つけます。

b. IBM Cognos フォルダー・タイプ COGNOSREPORT とREPORTVERSION を大文字で入力します。それぞれのフォルダー・タイプはコンマで区切ります。

例えば、次のようになります。folderTypes = ClbFolder,COGNOSSREPORT,REPORTVERSION

c. ファイルを保存して閉じます。

11. CMIS for Content Manager 8 設定プログラムを実行し、オプションを選択して、CMIS 設定ファイルを自動的に再デプロイします。

注: CMIS の手動デプロイについて詳しくは、IBMCMIS for Content Managerの手動デプロイ (http://pic.dhe.ibm.com/infocenter/cmgmt/v8r4m0/topic/com.ibm.installingcmcmis.doc/cmsde001.htm) を参照してください。

12. WebSphere Application Server Liberty Profile 管理コンソールから、CMISfor Content Manager アプリケーションを再始動します。

アーカイブ処理を実行できる時刻の指定ピーク時におけるシステム・パフォーマンスを高水準に保つため、アーカイブまたは削除のタスクを実行する時刻を指定するようにブラックアウト期間を設定できます。


http://pic.dhe.ibm.com/infocenter/cmgmt/v8r4m0/topic/com.ibm.installingcmcmis.doc/cmsde001.htm

http://pic.dhe.ibm.com/infocenter/cmgmt/v8r4m0/topic/com.ibm.installingcmcmis.doc/cmsde001.htm

ブラックアウト期間とは、データの移動が認められない一時的な期間のことです。デフォルトでは、ソフトウェアのインストール時にはブラックアウト期間は定義されません。

手順1. インストールの場所/webapps/p2pd/WEB-INF/cm/tasks/manager ディレクトリー

に移動します。

2. XML テキスト・エディターを使用して、tasksManager.xml ファイルを開きます。

3. 例えば、午前 8:00 から午後 5:00 までの週間ブラックアウト期間を火曜日から金曜日にかけて指定する場合、以下の <blackoutPeriods> エレメントをbackgroundTasksManager エレメントの子エレメントとして追加してください。

v start time = <hour>08</hour>

v stop time = <hour>17</hour>

v days =

<day>Tuesday</day><day>Wednesday</day><day>Thursday</day><day>Friday</day>

4. 必要に応じて、アーカイブおよび削除のプロセスで使用できるスレッド数を減らします。スレッドの最大数は 7 です。


6. Content Manager サービスでバックグラウンド処理を再開します。

スレッド実行時間の指定スレッドを使用して、オペレーティング・システムの処理時間をスケジュールに入れることができます。

アーカイブおよび削除のバックグラウンド・タスクは、スレッドを使用してコンテンツを移動します。スレッドとは、オペレーティング・システムによってスケジュールに入れられる処理時間の単位のことです。

手順1. インストールの場所/webapps/p2pd/WEB-INF/cm/tasks/config ディレクトリーに

移動します。

2. XML テキスト・エディターを使用して、archiveTask.xml ファイルを開きます。

3. 例えば、3 つのスレッドが深夜から午前 8:00 の間に実行され、1 つのスレッドは午前 8:00 から午後 5:00 にかけて実行され、午後 5:00 から深夜にかけて実行されるスレッドはなく、すべてのスレッドが 1 週間のうち毎日実行されるよう設定するには、次の <executionPeriods> XML 要素を backgroundTask 要素の子要素として追加します。

<executionPeriods><executionPeriod><threads>3</threads><startTime><hour>00</hour><minute>00</minute>


</startTime><stopTime><hour>08</hour><minute>00</minute></stopTime><days><day>Monday</day><day>Tuesday</day><day>Wednesday</day><day>Thursday</day><day>Friday</day><day>Saturday</day><day>Sunday</day></days></executionPeriod><executionPeriod><startTime><hour>08</hour><minute>00</minute></startTime><stopTime><hour>17</hour><minute>00</minute></stopTime><days><day>Monday</day><day>Tuesday</day><day>Wednesday</day><day>Thursday</day><day>Friday</day><day>Saturday</day><day>Sunday</day></days></executionPeriod></executionPeriods>


レポート出力に関する選択済み形式のアーカイブ特定の出力形式のアーカイブだけを保存するように制限できます。デフォルトでは、任意の形式の出力 (PDF、XML、HTML、Excel など) がアーカイブされます。

リポジトリーに対するアーカイブを特定の出力形式のものだけに限定できます。

手順1. インストールの場所/webapps/p2pd/WEB-INF/cm/tasks/config ディレクトリーに

移動します。

2. XML テキスト・エディターを使用して、archiveTask.xml ファイルを開きます。

3. 例えば、PDF の出力レポート・バージョンのみのアーカイブを定義するには、次の <outputFormats> XML 要素を、runOptions XML 要素の子要素として追加します。

<outputFormats><outputFormat>PDF</outputFormat></outputFormats>

既存の outputFormats サンプル要素を使用して、リストを変更し、アーカイブする出力形式を指定できます。


例えば、グラフィックを伴う HTML などの、複数のファイル・レポート出力を選択的にアーカイブすることはできません。

ファイルを保存して閉じます。

アーカイブしないレポート仕様の指定方法デフォルトでは、レポート仕様出力はアーカイブされます。レポート仕様には、レポートにおけるデータの生成方法が記述されます。

レポート仕様のアーカイブをオフにするには、2 つのファイル (CM.xml、およびIBM FileNet Content Manager リポジトリーと IBM Content Manager 8 リポジトリーのどちらにコンテンツをアーカイブするかに応じて、CM_FILENET.xml またはCM_CM8.xml) を変更する必要があります。

手順1. インストールの場所/webapps/p2pd/WEB-INF/repositories/config ディレクトリ

ーに移動します。

2. XML テキスト・エディターを使用して、CM.xml ファイルを開きます。

3. 以下の行をコメント化するか、削除します。<property

name="specifications" metadataPropertyName="specification"

useTempFile="true"


5. インストールの場所/webapps/p2pd/WEB-INF/repositories/config ディレクトリーに移動します。

6. 以下のいずれかの手順を行います。

v コンテンツを FileNet にアーカイブする場合は、CM.FILENET.xml という名前のファイルをテキスト・エディターで開きます。

v コンテンツを IBM Content Manager 8 にアーカイブする場合は、CM.xml

という名前のファイルをテキスト・エディターで開きます。

7. 以下の要素をコメント化するか、削除します。

<property repositoryName="REPORTEXECUTIONSPECIFICATION" repositoryType="ASSOCIATED"metadataPropertyName="specification">

<associatedObjectTypes><objectType name="VERSIONSPECIFICATION"><properties><property repositoryName="cmis:name" repositoryType="STRING"

metadataPropertyName="reportVersionDefaultName" valueHandler="com.cognos.cm.repositoryPluginFramework.PropertyValueAppendStringHandler" valueHandlerArgument="_specification"/>

</properties></objectType></associatedObjectTypes></property>

注: CM.xml ファイルで、objectType name 値は <objectTypename="$t!-2_VERSIONSPECIFICATIONv-1"> です。

8. Content Manager サービスでバックグラウンド処理を再開します。詳細については、「IBM Cognos Analytics管理およびセキュリティー・ガイド」を参照してください。



付録 A. IBM Cognos Configuration のコマンド行オプション

コマンド行オプションと設定コマンドを使用して、IBM Cognos Configuration の起動時の動作を変更できます。

表 51. コマンド行のオプションと説明

オプション説明

-h IBM Cognos Configuration のコマンドを表示します。

-s IBM Cognos Configuration をサイレント・モードで実行します。

cogstartup.xml ファイルに指定されているプロパティー値を使用して、インストールされているコンポーネントを設定してすべてのサービスを開始します。

./cogconfig.sh -s

cogconfig.bat -s

-stop すべての IBM Cognos サービスを停止します。

./cogconfig.sh -stop

cogconfig.bat -stop

-startupfile <パス>/filename.xml <インストールの場所>/configuration ディレクトリーの cogstartup.xml ファイル以外のファイルを使用して、IBM CognosConfiguration を実行します。

-test cogstartup.xml ファイルに指定されているプロパティー値を使用して、構成設定のテストを行います。

./cogconfig.sh -test

cogconfig.bat -test

-notest 自動テスト・タスクを無効にして、IBMCognos Configuration を開始します。

./cogconfig.sh -notest

cogconfig.bat -notest

製品を初めて始動するときや設定を変更するときには、このオプションを使用できません。

351

表 51. コマンド行のオプションと説明 (続き)

オプション説明

-utf8 UTF-8 エンコードで設定を保存します。

./cogconfig.sh -s -utf8

cogconfig.bat -s -utf8

-l language ID 言語 ID で指定された言語を使用して IBMCognos Configuration を実行する。

中国語 (簡体字) を使ってサイレント・モードで設定ツールを実行するには、以下のようにします。

./cogconfig.sh -l zh-cn

cogconfig.bat -l zh-cn

-e filename.xml 指定したファイルに現在の設定をエクスポートします。

./cogconfig.sh -e <ファイル名>.xml

cogconfig.bat -e <ファイル名>.xml

-log <Cognos の場所>/logs ディレクトリーにcogconfig.timestamp.log エラー・ログ・ファイルを作成します。

./cogconfig.sh -log

cogconfig.bat -log

-java:{local|env} 次のいずれかで定義された Java RuntimeEnvironment のバージョンを使用し、Microsoft Windows オペレーティング・システムで IBM Cognos Configuration を実行する。

v env: JAVA_HOME 環境変数を使用して環境で定義

v local: <インストールの場所>/bin/jre ディレクトリーからローカルに定義

このフラグを設定しない場合、IBM Cognosでは JAVA_HOME 環境変数の設定が使用されます。

ローカル JVM を使用して IBM CognosConfiguration をサイレント・モードで実行する場合は、次のコマンドを入力します。

./cogconfig.sh -s -java:local

cogconfig.bat -s -java:local


一度に複数のコマンド行オプションを使用できます。例えば、IBM CognosConfiguration をサイレント・モードで実行して、すべてのエラー・メッセージをログ・ファイルに送信することができます。

付録 A. IBM Cognos Configuration のコマンド行オプション 353


付録 B. トラブルシューティング

ここで説明するトラブルシューティングの参考情報と解決方法は、IBM CognosBusiness Intelligence コンポーネントのインストール時やインストール後に発生した問題を解決する手段として利用してください。

トラブルシューティングを行うには、まず問題の状況を把握します。特定のトラブルシューティングのツールやテクニックを使用すれば、問題の原因をしぼることができます。原因がわかれば、一連の作業を行うことで各問題を解決できます。

トラブルシューティングには、ログ・ファイルを利用できます。もう 1 つの便利なトラブルシューティング・ツールとしてサポート・コミュニティーが用意されています。これは IBM サポート・ポータル (新しいウィンドウで開きます) で使用できます。サポート・コミュニティーは、すべての IBM Cognos 製品に関する問題を解決するのに役立ちます。

これらの情報を使用しても問題を解決できない場合は、技術サポートの担当者へ連絡します。技術サポートの担当者が問題を分析するには、問題が発生したときの状況や状態に関する情報が必要です。技術サポートの担当者に問い合わせる前に、問題の原因を特定するために必要なデータを用意しておいてください。

問題のトラブルシューティングトラブルシューティングは、問題解決のための系統的なアプローチです。トラブルシューティングの目的は、ある部分が予期したとおりに機能しない理由および問題を解決する方法を判別することです。

トラブルシューティング手順の第 1 段階は、問題を完全に記述することです。問題の記述は、お客様および IBM 技術サポート担当員が問題の原因を突き止めるうえで、出発点となる情報として役立ちます。この段階では、お客様ご自身が次のような基本的な質問に答えます。

v 問題にはどのような症状があるか?

v 問題はどこで発生するか?

v 問題が発生するのはいつか?

v どのような条件下で問題が発生するか?

v 問題を再現できるか?

通常は、これらの質問に答えることで問題を適切に記述でき、それが問題の解決につながる可能性があります。

問題にはどのような症状があるか?

問題の記述を開始するときに、物事を最も明確にする質問は「何が問題であるか」です。この質問は単純に見えるかもしれませんが、的を絞ったいくつかの質問に細分化することで、問題をより良く描写できます。例えば次のような質問が考えられます。

355

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

v 誰が (または何が) 問題を報告しているか?

v どのようなエラー・コードとメッセージが出されたか?

v システムにどのような障害が起きるか? 例えば、ループ、ハング、クラッシュ、パフォーマンス低下、間違った結果などの問題のうち、どれが発生するか?

問題はどこで発生するか?

問題の発生源となっている箇所の判別は必ずしも容易ではありませんが、問題を解決するうえで、これは最も重要な手順の 1 つです。報告を出しているコンポーネントと障害が起こっているコンポーネントの間には、テクノロジーの多くのレイヤーが存在する可能性があります。ネットワーク、ディスク、およびドライバーは、問題を調査する際に考慮すべきコンポーネントのごく一部に過ぎません。

問題が起きているレイヤーを見分けるうえで、次のような質問が役立ちます。

v その問題は 1 つのプラットフォーム (またはオペレーティング・システム) に固有のものか、それとも複数のプラットフォーム (またはオペレーティング・システム) にまたがって共通するものか?

v 現在の環境および構成はサポートされているか?

あるレイヤーが問題を報告するとしても、問題の発生源は必ずしもそのレイヤーであるとは限りません。問題の発生場所を特定するには、その問題が存在する環境を理解することも必要です。時間をかけて問題の環境を完全に記述してください。オペレーティング・システムとバージョン、対応するすべてのソフトウェアとそのバージョン、さらにハードウェアについての記述を含めます。実際にサポートされる環境で稼働していることを確かめてください。併用されるよう意図されていない(または併用が十分にテストされていない) 複数のソフトウェア・レベルの非互換性が、問題の根本原因となるケースが数多くあります。

問題が発生するのはいつか?

障害が発生するまでのさまざまなイベントを記述した詳細な時系列を作成します(特に、1 回限りの発生である場合)。最も簡単に時系列を作る方法は、前にさかのぼることです。エラーが報告された時点 (できればミリ秒単位に至るまで精密に) から始めて、使用可能なログや情報を活用して逆方向にたどります。通常は、診断ログで最初に検出した疑わしいイベントまで調べるだけでかまいません。

イベントの詳細な時系列を作成するには、次の質問に答えます。

v 問題が発生するのは、一日 (昼間または夜間) の特定の時刻だけですか?

v 問題はどのくらいの頻度で発生しますか?

v 問題が報告された時刻に至るまでに、どんな一連のイベントが発生しましたか?

v 環境が変化した後に問題が発生しますか (例えばソフトウェアやハードウェアのアップグレード後/インストール後)?

どのような条件下で問題が発生するか?

問題の発生時にどのようなシステムとアプリケーションが稼働していたかを知ることは、トラブルシューティングの重要な部分です。環境について以下の質問に答えることで、問題の原因を特定できる可能性があります。

v その問題は、常に同じタスクの実行中に発生しますか?


v 特定の一連のイベントが発生した場合にのみ、その問題が発生しますか?

v 同時に他のいずれかのアプリケーションも障害を起こしますか?

このような質問に答えることで、問題が発生する環境を説明し、依存関係があればそれらを相互に関連付けることができます。なお、ほぼ同時に複数の問題が発生したとしても、それらの間に関連があるとは限らないことに注意してください。

問題を再現できるか?

再現可能な問題は、多くの場合、より簡単に解決できます。ただし、再現可能な問題にも不利な点があります。業務に大きな影響を与える問題の場合、それを繰り返したいとは思わないでしょう。可能であればテスト環境または開発環境で問題を再現させます。通常、このようにすると、調査の際の柔軟性が高まり、制御しやすくなります。次のような質問に答えてください。

v 問題をテスト・システムで再現できますか?

v 複数のユーザーまたはアプリケーションで同じ種類の問題が発生していますか?

v 問題を再現できるのは、単一のコマンドを実行した場合、一連のコマンドを実行した場合、または特定のアプリケーションを実行した場合のどれですか。

知識ベースの検索IBM の知識ベースを検索することで、問題の解決方法が見つかることがよくあります。使用可能なリソース、サポート・ツール、検索方式を使って結果を最適化することができます。


IBM Cognos のインフォメーション・センターを検索すると役立つ情報が見つかります。しかし、問題を解決するためにインフォメーション・センターよりも詳しい情報を調べる必要が生じることもあります。

手順

知識ベースで必要な情報を検索するには、以下の方法のうちの 1 つ以上を使用します。

v IBM サポート・ポータルを使用して必要なコンテンツを見つけます。

IBM サポート・ポータルは、すべての IBM システム、ソフトウェア、およびサービスに関するあらゆる技術サポート・ツールと情報を集めた統合ビューです。IBM サポート・ポータルによって、電子的な IBM サポート・ポートフォリオに1 箇所からアクセスできます。ページを調整すると、問題の防止および問題の素早い解決のために必要な情報やリソースに焦点を絞ることができます。 IBM サポート・ポータルをよく理解するために、このツールに関するデモ・ビデオをご覧いただけます。これらのビデオは、IBM サポート・ポータルについて紹介し、トラブルシューティングその他のリソースを参照する方法、ポートレットを移動/追加/削除することによりページを調整する方法を示します。

v 以下のいずれかの追加的な技術リソースを使用して、IBM Cognos についてのコンテンツを検索する。

– IBM Cognos Analytics APAR (問題報告書)

付録 B. トラブルシューティング 357

http://www.ibm.com/support/entry/portal/

https://www.youtube.com/playlist?list=PLMp5LlSAupxKzTTgNJ-mp4DK2Bxm0lbbk

https://www.ibm.com/support/home/search-results/N180263X74618Y31/Cognos_Analytics?sortby=-dcdate_sortrange&filter=DC.Type_avl:CT748&prod=N180263X74618Y31&prod=U025040U04546H36&ct=apr

– IBM Cognos フォーラムとコミュニティー

v IBM マストヘッド検索を使ってコンテンツを検索する。どの ibm.com® ページでも、検索フィールドに検索ストリングを入力することによって、IBM マストヘッド検索を使用できます。

v Google、Yahoo、Bing などの任意の外部検索エンジンを使ってコンテンツを検索する。外部の検索エンジンを使用すると、ibm.com ドメイン以外の情報が結果に含まれる可能性が高くなります。しかし、ibm.com 以外のニュースグループ、フォーラム、およびブログなどで IBM 製品の問題解決に役立つ情報が見つかる場合があります。

ヒント: IBM 製品についての情報を探している場合は、「IBM」および製品の名前を含めて検索してください。

フィックスの入手該当する問題を解決するための製品フィックスが提供されている場合があります。

手順

フィックスを見つけてインストールするには、以下の手順に従います。

1. 必要なフィックスを特定します (Fix Central) (新しいウィンドウで開きます)(http://www.ibm.com/support/fixcentral/)。

2. フィックスをダウンロードします。ダウンロードした資料を開き、『Downloadpackage』セクションのリンクをたどります。

3. ダウンロード資料の『Installation Instructions』にある説明に従って、フィックスを適用します。

4. フィックスその他の IBM サポート情報に関する週ごとの E メール通知を受信するためにサブスクライブします。

IBM サポートと連絡を取るソフトウェアの問題の解決に役立つさまざまな IBM リソースを IBM サポートから入手することができます。

始める前に

他の自己ヘルプ・オプション (技術情報など) を使用して回答または解決方法を探した後、IBM サポートと連絡を取ることができます。 IBM サポートと連絡を取るには、IBM との保守契約を会社が事前に結んでおり、それが有効である必要があります。また、IBM に問題を送信する許可が必要です。次の情報を揃えておく必要もあります。

v カスタマー識別番号

v サービス要求番号 (すでにサービス要求が進行中の場合)

v 連絡先電話番号

v 使用しているソフトウェアのバージョン

v 使用している操作環境のバージョン

v 問題発生時点で行っていた操作の詳細

v 表示されるエラー・メッセージの正確な内容


http://www.ibm.com/support/entry/portal/Forums_communities/Software/Information_Management/Cognos_Business_Intelligence_and_Financial_Performance_Management

https://www-945.ibm.com/support/fixcentral/

v 問題解決のために試みた操作の手順

利用可能なサポートのタイプについては、「Software Support Handbook」のSupport portfolio (新しいウィンドウで開きます) のトピックを参照してください。

手順

問題について IBM サポートに連絡を取る場合には、以下の手順を実行します。

1. 問題を明確にし、背景情報を収集し、問題の重大度を判断します。詳しくは、「Software Support Handbook」の Getting IBM support (新しいウィンドウで開きます) のトピックを参照してください。

2. 診断情報を収集します。

3. 以下のいずれかの方法で、IBM サポートに問題を報告します。

v IBM Support Assistant (ISA) を使用する方法: このフィーチャーを使用して、IBM に対する Electronic Service Request をオープン、更新、および表示します。収集されたデータはすべて、サービス要求に添付できます。これにより、分析が迅速に行われ、より短時間で解決できるようになります。

v IBM サポート・ポータル (新しいウィンドウで開きます) からオンラインで行う方法:「サービス・リクエスト」ページの「サービス・リクエスト」ポートレットから、すべてのサービス・リクエストをオープン、更新、および表示することができます。

v 電話による方法: 電話番号については、Web ページ Directory ofworldwide contacts (新しいウィンドウで開きます) を参照してください。

タスクの結果

ユーザーが提出した問題が、ソフトウェア障害または資料の不正確や欠落が原因である場合、IBM サポートはプログラム診断依頼書 (APAR) を作成します。 APARには、問題が詳細に記述されます。可能な場合には常に、APAR が解決されてフィックスが配信されるまでに実施しておくことができる回避策が IBM サポートによって提供されます。 IBM は解決済みの APAR を IBM サポートの Web サイト上に日々公開します。これにより、同じ問題が発生している他のユーザーもその同じ解決方法を参照できるようになります。

IBM との情報交換問題を診断したり特定したりするために、システムからのデータと情報を IBM サポートに提出する必要が生じる場合があります。

場合によっては、問題判別に使用するためのツールまたはユーティリティーが IBMサポートによって提供されることもあります。

IBM サポートへの情報の送信問題解決にかかる時間を短縮するために、トレースおよび診断情報を IBM サポートに送信することができます。

手順

IBM サポートに診断情報を送信するには、以下の手順に従います。


http://www14.software.ibm.com/webapp/set2/sas/f/handbook/offerings.html

http://www14.software.ibm.com/webapp/set2/sas/f/handbook/getsupport.html


http://www.ibm.com/planetwide/

http://www.ibm.com/planetwide/

1. 問題管理レコード (PMR) を開きます。 IBM Support Assistant (新しいウィンドウで開きます) または IBM サービス・リクエスト・ツール (新しいウィンドウで開きます) を使用することができます。

2. 必要な診断データを収集します。診断データは、PMR の解決にかかる時間の短縮につながります。診断データは手動でも自動でも収集できます。

3. TRSMAIN または AMATERSE プログラムを使ってファイルを圧縮します。IBM から IBM Cognos Analytics システムに無料のユーティリティーをダウンロードした後、TSO RECEIVE コマンドを使ってユーティリティーをインストールします。

4. ファイルを IBM に転送します。 IBM へのファイルの転送は、次のいずれかの方法で行えます。

v サービス・リクエスト・ツール (新しいウィンドウで開きます)

v 標準的なデータ・アップロード方式: FTP、HTTP

v セキュアなデータ・アップロード方式: FTPS、SFTP、HTTPS

v E メール

IBM Cognos 製品を使用しており、ServiceLink / IBMLink で PMR をサブミットする場合、E メールまたは FTP を使用して IBM サポートに診断データを送信することができます。

これらすべてのデータ交換方式については、IBM Support サイト(新しいウィンドウで開きます) で説明されています。

IBM サポートからの情報の受信時折、IBM 技術サポート担当者から、診断ツールまたはその他のファイルをダウンロードするように依頼されることがあります。それらのファイルは FTP を使ってダウンロードできます。

始める前に

IBM 技術サポート担当者から、ファイルのダウンロードに使用する優先サーバーと、アクセス先の正確なディレクトリー名およびファイル名が提供されていることを確認してください。

手順

IBM サポートからファイルをダウンロードするには、以下の手順に従います。

1. FTP を使用して、IBM 技術サポート担当員によって指定されたサイトに接続し、anonymous でログインします。パスワードには自分の E メール・アドレスを使用します。

2. 以下の該当するディレクトリーに移動します。

a. /fromibm ディレクトリーに移動します。

cd fromibm

b. IBM 技術サポート担当者によって指定されたディレクトリーに移動します。

cd nameofdirectory

3. セッションでバイナリー・モードを使用可能にします。


http://www.ibm.com/software/support/isa

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

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

http://www-01.ibm.com/software/support/exchangeinfo.html

binary

4. get コマンドを使用して、IBM 技術サポート担当者によって指定されたファイルをダウンロードします。

get filename.extension

5. FTP セッションを終了します。

quit

サポート更新情報のサブスクライブご使用の IBM 製品についての重要な情報を継続的に得るには、更新情報をサブスクライブすることができます。


更新情報を受け取るようサブスクライブ (登録) することで、特定のサポート・ツールおよびリソースに関する重要な技術情報とアップデートを入手できます。以下の2 つの方法のいずれかを使って、更新情報をサブスクライブできます。

RSS フィードおよびソーシャル・メディア登録IBM Cognos Analytics に関する以下の RSS フィードおよびソーシャル・メディア登録を利用できます。

v developerWorks® フォーラムの RSS フィード (新しいウィンドウで開きます)。

v IBM Cognos Analytics のサポート・サイトの RSS フィード (新しいウィンドウで開きます)

RSS の一般情報 (入門情報、RSS を使用できる IBM Web ページのリストなど) については、 IBM ソフトウェア・サポート RSS フィード (新しいウィンドウで開きます) のサイトをご覧ください。

My NotificationsMy Notifications を使用すると、任意の IBM 製品のサポート更新情報をサブスクライブできます。毎日、または週ごとに E メール通知を受信するよう指定することができます。どんな種類の情報を受け取ることを希望するか(出版物、ヒント、製品フラッシュつまりアラート、ダウンロード、ドライバーなど) を指定できます。 My Notifications を使用すると、どの製品についての通知をどんな配信方法で受け取るか、必要に合わせてカスタマイズして分類することができます。

手順

サポート更新情報にサブスクライブするには、次のようにします。

1. 「製品名」RSS フィードにサブスクライブします。

2. My Notifications にサブスクライブするには、まず IBM サポート・ポータル(新しいウィンドウで開きます) に移動して、「通知」ポートレットの「MyNotifications」をクリックします。

3. マイ・サポートに登録済みの場合は、サインインして、次のステップに進みます。まだ登録していない場合は、「今すぐ登録 (Register now)」をクリックします。ご使用の E メール・アドレスを IBM ID として使用して登録フォームにすべて入力し、「送信する (Submit)」をクリックします。


https://www.ibm.com/developerworks/community/forums/html/category?id=33333333-0000-0000-0000-000000000164

http://www-947.ibm.com/systems/support/myfeed/xmlfeeder.wss?feeder.requid=feeder.create_public_feed&feeder.feedtype=RSS&feeder.maxfeed=25&OC=SSEP7J&feeder.subdefkey=swgimgmt&feeder.channel.title=Cognos%20Business%20Intelligence&feeder.channel.descr=The%20latest%20updates%20about%20Cognos%20Business%20Intelligence

http://www.ibm.com/software/support/rss/


4. 「プロファイルの編集 (Edit profile)」をクリックします。

5. 「製品の追加 (Add products)」をクリックして、製品カテゴリー (例えば「ソフトウェア (Software)」) を選択します。

6. 2 番目のリストで製品区分を選択します (例えば「データ/情報管理 (Data &Information Management)」)。

7. 3 番目のリストで、製品の副区分を選択します (例えば「データベース(Databases)」)。

8. 更新情報の受信を希望する製品を選択します。

9. 「製品の追加 (Add products)」をクリックします。

10. 関心のある製品をすべて選択したら、「プロファイルの編集 (Edit profile)」タブの「E メールをサブスクライブ (Subscribe to email)」をクリックします。

11. 「これらのドキュメントを毎週 E メールで送信してください (Please sendthese documents by weekly email)」を選択します。

12. 必要に応じて E メール・アドレスを更新します。

13. 「ドキュメント・リスト (Documents list)」で、製品カテゴリー (例えば「ソフトウェア (Software)」) を選択します。

14. どんな種類のドキュメントに関する情報を受け取るかを選択します。

15. 「更新」をクリックします。

タスクの結果

RSS フィードおよび My Notifications 設定を変更するまで、要求した更新の通知を受け取ります。例えば、ある製品の使用を停止して別の製品を使い始めた場合など、必要なときに設定を変更することができます。

ログ・ファイルログ・ファイルには、製品の使用時に行った操作が記録されており、問題の解決に役立てることができます。

IBM Cognos Analytics で実行した操作は、追跡のために各種ログ・ファイルに記録されます。例えば、IBM Cognos Analytics のインストールで問題が発生した場合は、転送ログ・ファイルを調べて、ファイルの転送中にインストール・ウィザードで実行した処理を確認します。

ログ・ファイルを参照する前に、必要とする情報がログ・ファイルに記録されていることを確認します。

IBM Cognos Administration を使用して、各カテゴリーについてログに記録される詳細レベルを設定します。

詳しくは、「IBM Cognos Analytics 管理およびセキュリティー・ガイド」を参照してください。

IBM Cognos Configuration を使用して、ログ・ファイルのサイズ、数、場所を指定し、ログ・サーバーのプロパティーを設定します。


問題解決には、次のファイルが役立ちます。

転送ログ・ファイル

このファイルには、インストールされているコンポーネント、ディスク容量情報、転送ダイアログでの設定、およびコンポーネントの転送中にインストール・ウィザードで発生したエラーがすべて記録されます。さらに、インストール・ウィザードでファイルの転送中に実行された処理も記録されます。

転送ログ・ファイルは、インストールの場所¥logs ディレクトリーにあります。ファイル名には、製品名およびタイム・スタンプが含まれます。ファイル名の形式の例を次に示します。

IBM_Cognos_Analytics_Install_04_21_2016_11_00_59.log

インストール設定ログ・ファイル

このログ・ファイルは、インストール中のすべての設定処理を記録します。例えば、ディスパッチャーの使用可能なポートについてレポートします。

転送の概要/エラー・ログ・ファイルは、インストールの場所¥logs ディレクトリーにあります。このファイルは、install_configuration.log という名前が付けられています。

始動設定ファイル

このファイルには、プロパティー設定を保存するたびに選択した設定が記録されます。ファイル名は cogstartup.xml です。

設定を保存できない場合や問題が発生した場合には、以前に保存した設定ファイルを使って元に戻すことができます。バックアップ設定ファイルは、インストールの場所/configuration ディレクトリーにあります。バックアップ設定ファイルのファイル名の形式の例を次に示します。

cogstartup_200811231540.xml

始動設定ロック・ファイル

このファイルは、IBM Cognos Configuration を開くたびに作成されるので、複数の IBM Cognos Configuration ウィンドウが開くことはありません。

IBM Cognos Configuration の起動時に問題が発生した場合は、install_location/configuration ディレクトリーの cogstartup.lock ファイルを確認してください。このファイルが存在していて IBM Cognos Configuration を起動できない場合は、前回 IBM Cognos Configuration を使用したときに適切に終了されなかったことを意味します。この場合は、ロック・ファイル削除すると、IBMCognos Configuration を起動できます。

ロケール設定ファイル

このファイルには、製品とコンテンツ・ロケール、ロケール・マッピング、およびサポートする通貨に関して IBM Cognos Configuration で設定した内容が記録されます。


ユーザー・インターフェースやレポート用にサポートする言語に関して問題が発生した場合、このファイルを使って変更を追跡できます。バックアップ設定ファイルは、インストールの場所/configuration ディレクトリーにあります。ファイル名の形式の例を次に示します。

coglocale_200811231540.xml

実行時ログ・ファイル

デフォルトの IBM Cognos ログ・ファイルである cogaudit.log ファイル、またはログ・サーバーからログ・メッセージを受信するように設定した他のログ・ファイルには、IBM Cognos Analytics サービス開始後の情報が記録されます。ファイルは install_location/logs ディレクトリーにあります。ログ・メッセージに別の出力先を設定した場合は、該当するファイルまたはデータベースを調べてください。

ログ・メッセージの一部は、問題が発生したことを示しています。ほとんどのメッセージは情報を提供するだけですが、実行時環境での問題の診断に利用できるメッセージもあります。

ゲートウェイ・ログ・ファイル

ゲートウェイ・ログ・ファイルにはゲートウェイのエラーが記録されます。このファイルは install_location/logs ディレクトリーにあります。

ゲートウェイ・ログ・ファイルを使用して、ゲートウェイで要求を処理できなかったり、暗号化を使用できない問題を解決できます。これらの問題の症状は次のとおりです。

v ユーザー ID およびパスワードが機能しない

v シングル・サインオンが機能しない

v ディスパッチャーは実行中だが、IBM Cognos Analytics サーバーが使用できないというエラー・メッセージがユーザーに表示される

ゲートウェイ・ログ・ファイルには、次のような名前形式が使用されます。gateway_interface は、 "cgi"、"mod2" (Apache 2.0 モジュール)、または "isapi" です。

gwgateway_interface.log (例えば、gwcgi.log)

アンインストール・ログ・ファイル

このファイルには、アンインストール・ウィザードでファイルのアンインストール中に実行された処理が記録されます。ログ・ファイルの名前はcognos_uninst_log.htm で、Temp ディレクトリーに置かれます。このログ・ファイルを使用して、IBM Cognos Analytics コンポーネントのアンインストールに関する問題を解決できます。

サイレント・モードのログ・ファイル

このファイルには、サイレント・モードでの実行時に IBM Cognos Configurationで行われた処理状況が記録されます。このログ・ファイルは


cogconfig_response.csv という名前で、install_location/logs ディレクトリーにあります。



付録 C. サポート対象外についての情報

このトピックでは、 IBM Cognos Analytics の将来のリリースで非推奨となる機能をリストします。

v インストールの場所¥webapps¥p2pd¥WEB-INF¥lib を JDBC ドライバーの置き場所として使用することは、将来のリリースでは推奨されません。これは、インストールの場所¥drivers ディレクトリーに置き換えられます。

367


付録 D. ガイドについて

本書は、IBM Cognos Analytics で使用することを意図しています。IBM CognosAnalytics は、レポート作成、ダッシュボード、分析、およびイベント管理の機能を統合した Web 製品です。

このガイドでは、IBM Cognos Analytics のインストール、アップグレード、構成、およびテストの手順について説明しています。

対象読者

本書を使用するには、以下について理解している必要があります。

v レポートに関する概念

v データベースやデータ・ウェアハウスに関する概念

v セキュリティーの問題

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

v 組織内の既存のサーバー環境およびセキュリティー・インフラストラクチャー

情報の入手方法

Web 上で製品資料 (各国語版のすべての資料を含む) を探すには、IBM KnowledgeCenter (http://www.ibm.com/support/knowledgecenter) にアクセスしてください。リリース・ノートは直接 IBM Knowledge Center に公開されます。これには、最新の技術情報および APAR へのリンクが含まれています。

また、各 HTML ページの上部にある PDF リンクをクリックして製品のオンライン・ヘルプ・ファイルの PDF 版を参照するか、IBM Cognos 製品資料の Web ページ (www.ibm.com/support/docview.wss?uid=swg27047187) から PDF にアクセスすることができます。

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

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

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

Sample Outdoors 社、Great Outdoors 社、GO 販売、Sample Outdoors 名またはGreat Outdoors 名のすべてのバリエーション、および Planning サンプルでは、IBM および IBM のお客様向けのサンプル・アプリケーションを開発するために使用されるサンプル・データにより、架空の企業活動が描出されています。これらの架空データには、販売取引、商品流通、財務、および人事のサンプル・データが含まれます。実在する名称、住所、連絡先電話番号、取引額とは一切関係がありません。また、サンプル・ファイルの中には、手動またはコンピューターで生成された

369

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

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

https://www.ibm.com/support/docview.wss?uid=swg27047187

https://www.ibm.com/support/docview.wss?uid=swg27047187

架空のデータ、学術的ソースまたは公共のソースを基に編集された実際のデータ、版権所有者の許可を得て使われているデータなどが、サンプル・アプリケーションを開発するためのサンプル・データとして使用されている場合もあります。参照される製品名は、それぞれの所有者の商標である可能性があります。許可なく複製することは禁止されています。


索引

日本語, 数字, 英字, 特殊文字の順に配列されています。なお, 濁音と半濁音は清音と同等に扱われています。

［ア行］アーカイブ時刻

指定方法 347アーカイブする

レポート出力 193IBM Cognos コンテンツ 341

アーキテクチャー 27アクティブな Content Manager 70アクティブ・スクリプト

Web ブラウザーで有効にする 17アップグレード 41

異なるバージョンのレポートの比較 57コンテンツの移動 51作業 48他の IBM Cognos 製品から IBM Cognos Analytics への

37プロセス 41リソース 43レポート仕様 58Content Store 53IBM Cognos ReportNet からのアップグレードをサポート

するツール 40アプリケーション層

コンポーネント 22アプリケーション層コンポーネント

設定要件 31別のコンピューターにインストールする 29ログ・サーバー 227

アプリケーション・プール 107アンインストール

失敗 339Cognos Analytics 339Framework Manager 339IBM Cognos Analytics 337Transformer 339

暗号化

無人設定を変更する 324暗号化プロバイダー

証明書署名要求 205設定 178

暗号スイート

SSL 接続の優先度を設定する 213一時ファイルの場所 184

設定 184一時ファイルのプロパティーの暗号化 184

イベント・ログ 232インストール 67

オプション 36コンポーネントの分散 36サーバー・コンポーネントのオプション 31サーバー・コンポーネントの順番 63テスト 92, 103, 143複数の場所での基本 64無人 329無人インストール 329モード 65Content Manager のオプション 29Framework Manager 145Framework Manager のオプション 33Framework Manager をテストする 153IBM Cognos Analytics 329Transformer 153Transformer のオプション 34Transformer をテストする 160UNIX、Linux 66

インストールをテストする 92, 103, 143インストール・オプション 28

モデル作成コンポーネント 31インストール・ファイル

Transformer のモデル作成者のためにダウンロードする

162インターフェース

言語サポートをカスタマイズする 241インポート

設定 56配布アーカイブ 56FileNet に対するカスタム・クラスのインポート 344

埋め込みフォント 190エクスポートする

設定ファイル 334オペレーティング・システム

サポートされるバージョン 2メモリー設定 4

［カ行］外部 ID マッピング・プロパティー

LDAP ネームスペース用の特殊文字 292LDAP ネームスペースを編集する 304

外部オブジェクト・ストア

接続のテスト 197レポート出力 196

外部リポジトリー

コンテンツのアーカイブ 341カスタム認証プロバイダー 290

371

カスタム・ユーザー・プロパティー

Active Directory サーバー 278LDAP 301

画像

コンテンツ期限 107Reporting でのロード 107

仮想化

サポートされている環境 2仮想ディレクトリー

IBM Cognos Analytics 107環境変数

アプリケーション・サービス・コンポーネントに対して設定

する 100UNIX または Linux でのインストール 66, 71, 93, 106

監査

ログ 227監査ログ

ログ・ターゲット 227参照：トラブルシューティング

参照：ログ・メッセージ

基本インストール

複数の場所 64機密性アルゴリズム 178共存 48共通対称鍵 176共有信頼関係

IBM Cognos Analytics と他のサーバーとの間で設定する

211クエリーのスタイル

ワークスペース内 261クエリー・データベース 27クライアント設定

Db2 データベース 74クロス・スクリプトの検査

IBM Cognos Application Firewall での設定 181ゲートウェイ

インストール 106コンポーネントの説明 25設定 109ネームスペースを使用するように設定する 185ネットワークに追加して配信時間を短縮する 320ログ・ファイル 36432 ビット・ゲートウェイの使用 109apache_mod を設定する 148, 149ISAPI を設定する 148, 149Transformer 用に設定する 157

権限

実行 252通過 252ポリシー設定 252IBM Cognos サービスに使用されるユーザー・アカウント

の 81, 99Transformer のモデル作成者用 162

言語

コンテンツ・ロケールのサポートのカスタマイズ 242ユーザー・インターフェース用にカスタマイズする 241

言語 (続き)

Transformer のユーザー・インターフェースを設定する

154更新

Java 環境 6互換クエリー・モード

メモリー設定 464 ビット・データ・ソース 95

コマンド行オプション 351コラボレーション

IBM Connections を使用する 181コンテンツ期限

画像ディレクトリー 107コンテンツ・ロケール

カスタマイズ 242サポートされているロケールを表示する 242ユーザー・ロケールにマッピングする 243

コンポーネント 21アプリケーション層コンポーネント 29, 31ゲートウェイ 25データ・ソース 27配布 36Cognos Analytics ポータル 22Content Manager 22, 29Content Store 26Event Studio 24Framework Manager 25IBM Cognos Administration 23IBM Cognos Configuration 22IBM Cognos Workspace 24Map Manager 26Query Studio 24Reporting 22Transformer 26

［サ行］サーバー

数の推定 319システム評価指標 313

サーバー・コンポーネント 21インストール・オプション 31インストール・シーケンス 63

サーバー・タイム・ゾーン

変更 247サービス

アンインストール 337移行 316コマンド行で開始する 327コマンド行で停止する 327システム評価指標 313パフォーマンスを改善するために調整する 314プレゼンテーション 314, 317メタデータ 316有効化と無効化 185リポジトリー 318


サービス (続き)

レポート 314ログ 316Agent 315Annotation 315Batch Report 315Content Manager 315Delivery 315Event Management 315Graphics 315Human Task 315IBM Cognos Analytics 317Interactive Discovery Visualization 316Job 316mobile 317Monitor 317Query 317relational metadata 318Report 318Report Data 318

サイレント構成 329サイレント・アンインストール 335サイレント・インストール 329サイレント・モード 329削除する

ディスパッチャー 53サブスクライブ

トラブルシューティング・テンプレート 361サポートされている環境 2サンプル

IBM Cognos Workspace 261システム評価指標

リモート監視する 313システム要件 3

Framework Manager 146Transformer 153

失敗したアンインストールからのリカバリー 339始動

設定ロック・ファイル 363始動オプション 351出力形式

制限する 348証明書署名要求 205シングル・サインオン

Active Directory ネームスペース 280IBM Cognos Series 7 ネームスペースを使用する 287LDAP ネームスペース 303SAP ネームスペース 311

診断

参照：トラブルシューティング

診断ログ記録

OpenID Connect ネームスペースのトラブルシューティン

グ 274スクリプト

Db2 での Content Store の作成 75

スレッド実行時間

指定方法 347製品

サポートされるバージョン 2セキュア・フラグ

Cookie の設定 249セキュリティー

有効化 90Web ブラウザーの設定 3

設定 351アプリケーション・サービス・コンポーネントの環境プロパ

ティー 100一時ファイルの場所 184カスタム認証プロバイダー 291グローバル設定 240ゲートウェイ 109ゲートウェイ用の apache_mod 148, 149ゲートウェイ用の ISAPI 148, 149コマンド行で実行する 327自動化する 329設定グループ 173, 175待機中の Content Manager 86他の IBM Cognos 製品とともに使用するために IBM

Cognos Analytics を設定する 262他のサーバーとの共有信頼関係 211通知データベース 201デフォルト設定の変更 169デフォルトの暗号化プロバイダー 178デフォルトのタイム・ゾーン 247転送仕様ファイル (.ats) 329テンプレートを変更する 319フォント 186無人 329, 334無人設定のプロパティー 324リソースを追加する 322ルーター 262ログ・メッセージのターゲット 227ロック・ファイル 363Active Directory サーバーの LDAP ネームスペース 295Active Directory ネームスペース 277Certificate Authority サービス 203Cognos Analytics 用の設定 7Content Manager 29Entrust セキュリティー・インフラストラクチャー 180Framework Manager 33IBM Cognos Analytics 15IBM Cognos Analytics の複数のバージョン 48IBM Cognos Configuration を開くことができない 363IBM Cognos Workspace 252IBM Cognos サービス 319IBM Directory Server の LDAP ネームスペース 297LDAP ネームスペース 294Microsoft Analysis Server または Microsoft SQL Server

を使用したシングル・サインオンの要件 277Reporting の地図グラフ 194SAP ネームスペース 310

索引 373

設定 (続き)

SiteMinder ネームスペース 307SSL プロトコル 209Transformer 34Web サーバー 107Web ブラウザー 17

設定グループ 173, 175設定ファイル

エクスポートする 334coglocale.xml 324cogstartup.xml 322

その他のコンポーネント 26ソフトウェア要件

サポートされている製品バージョン 2

［タ行］帯域幅

推定 319待機中の Content Manager 29, 70

設定 86タイ語の E メールのエンコード方式

JRE 要件 247タイム・ゾーン

変更 247地図グラフ 194中国語 (簡体字)

フォントの設定 186, 190調整

Db2 Content Store 318通貨

サポートのカスタマイズ 241通知データベース

作成 198設定 201表スペースの作成 76Db2 for z/OS 用の表スペース 200SSL の使用 214z/OS 上の Db2 用の設定 199

データ層

Content Manager 22データベース

通知 88ログ記録 232ログ記録データベースのクライアント 230

データベース接続 82レポート作成データベース 95MS SQL Server および SSL 214SSL 214

データベース接続文字列

IBM Db2 82Microsoft SQL Server 82Oracle 82

データベース・クライアント

ログ記録データベース用の設定 230Transformer のモデル作成者のための要件 162

データベース・クライアント (続き)

Transformer の要件 35データベース・ドライバー

Db2 74Informix 80, 231Oracle 79

データ・セット・サービス・ポート

変更 172データ・ソース

コンポーネントの説明 27Framework Manager 用の 150IBM Cognos Transformer 用の 158ODBC 接続 96

データ・ソース接続

設定 82データ・ソースのコード・ページ 150, 158データ・ソースへの ODBC 接続 96ディスパッチャー

インポート 56削除する 53システム評価指標 313

テスト

Framework Manager 153Transformer インストール 160

転送仕様ファイル (.ats)設定 329

テンプレート

テンプレートのサイズを変更する 319動的クエリー・モード 95

データベース接続 95メモリー設定 4

登録を解除する

ディスパッチャー 53特殊文字

LDAP ネームスペース・プロパティーでの 292匿名ログオン

無効にする 266ドメイン

Active Directory サーバー・ドメイン・ツリー 280Cognos Workspace 用に承認済み 181Cookie の設定 249

トラブルシューティング 355サポート情報のサブスクライブ 361知識ベース

トラブルシューティングの解決策を検索する 357知識ベースの検索 357特定のユーザー用 239フィックス

入手 358フィックスの入手 358問題の識別 355ログ記録 227IBM サポートと情報を交換する 359IBM サポートと連絡を取る 358


［ナ行］認証

カスタム認証プロバイダー 290, 291匿名ログオンを無効にする 266ネームスペースの使用 265ネームスペースを削除する 312Active Directory サーバー 276Active Directory サーバーに対するドメイン・ツリー 280Active Directory サーバーのカスタム・プロパティー 278Active Directory サーバーを使用した LDAP 295Active Directory サーバーを使用したシングル・サインオ

ン 280CA SiteMinder 304IBM Cognos Series 7 ネームスペースを使用したシング

ル・サインオン 287IBM Cognos Series 7 ネームスペースを設定する 285IBM Cognos Series 7 の Trusted Signon プラグイン 288IBM Directory Server を使用した LDAP 認証 297LDAP 292, 294LDAP のカスタム・ユーザー・プロパティー 301LDAP を使用した SSL 302LDAP を使用したシングル・サインオン 303Microsoft Analysis Server または Microsoft SQL Server

を使用したシングル・サインオンの要件 277Novell Directory Server を使用した LDAP 認証 298Oracle Directory Server を使用した LDAP 300SaferAPIGetTrustedSignon 関数 288SAP 308SAP を使用したシングル・サインオン 311SiteMinder 307

認証局

サービスの設定 203設定 203

認証プロバイダー

セキュリティーを使用するように IBM Cognos BI を設定

する 90ネームスペース

カスタム認証プロバイダーを設定する 291ゲートウェイ用に設定する 185削除する 312認証 265ログオン時に非表示にする 292OpenID Connect 272Transformer で Series 7 ネームスペースを使用する場合の

Content Manager の要件 285

［ハ行］配信

レポートを開く時間を短縮する 320配布

設定オブジェクト 56Transformer をモデル作成者に 164

配布アーカイブ

移動する 55

配布アーカイブ (続き)

インポート 56「バインド・ユーザー DN とパスワード」プロパティー

LDAP ネームスペース用の特殊文字 292場所

地図グラフ 194パス

Cookie の設定 249パスワード

無人設定を変更する 324パフォーマンス

サーバー数の推定 319推定 319帯域幅の推定 319

非同期タイムアウト 320評価指標

サーバー、ディスパッチャー、サービス 313表スペース 318

Content Store のスクリプト 76Db2 for z/OS 200z/OS 上の Db2 229, 255

ファイアウォール

インストールに関する考慮事項 32Transformer と Cognos Analytics の間のアクセス 157

ファイル・システム

レポート出力のコピーを保存する 191フェイルオーバー保護 29フォント

設定 186デフォルトを変更する 190Cognos Configuration でのシステム・フォントの使用 189PDF レポートの変更 190PDF レポート用の埋め込みフォント・リスト 190

フォント埋め込みリスト 190負荷分散 15, 119, 120

サービスの有効化と無効化 185設定 29E メール・サーバーの設定 88

ブラックアウト期間

指定方法 347プロトコル

IP アドレス 249プロパティー

一時ファイルの場所 184無人設定を変更する 324

分散インストール

オプション 36シナリオ 28

分析のスタイル

ワークスペース内 261別名

Web サーバーに設定する 107変更

設定テンプレート 319デフォルト設定 169E メールのエンコード方式 247

索引 375

変更 (続き)

Java のバージョン 167URI 169

ポート

データ・セット・サービス・ポート 172デフォルト設定 7変更 169, 171, 172IBM Cognos Analytics の複数のバージョン 48

保護された LDAP 通信 302保守

システム・パフォーマンスの改善 313本書の対象読者 369

［マ行］待ち時間

向上させる 320無人アンインストール 335無人インストール

応答ファイル・テンプレート 331設定する 329

無人設定

設定する 329プロパティーを変更する 324

無人モード 329メモリー設定 4モデリング 25モデル作成コンポーネント 25

インストール・オプション 31Transformer のモデル作成者用のインストール・ファイル

162モデル作成者

Transformer を配布する 164問題判別

IBM サポートと情報を交換する 359

［ヤ行］役割ベースのサーバー

Transformer での考慮事項 34ユーザー検索プロパティー

LDAP ネームスペース用の特殊文字 292ユーザー資格情報

無人設定を変更する 324ユーザー・アカウント

IBM Cognos サービスを実行するための要件 81, 99ユーザー・インターフェース

言語サポートをカスタマイズする 241ユーザー・インターフェースのロケール用にマッピングする

246ユーザー・インターフェースのロケール

サポートされているロケールを表示する 241ユーザー・インターフェース用にマッピングする 246

ユーザー・ログ 239

ユーザー・ロケール

コンテンツ・ロケールにマッピングする 243有効化

サービス 185IBM Cognos アプリケーション・ファイアウォール 181

［ラ行］ライブラリー・ファイル 9リソース

追加する 322リポジトリー・サービス 318リモート・ログ・サーバー 232

設定 233リリース・ノート

確認 1ルーター

設定 262ルート・ディレクトリー

IBM Cognos Analytics の外部に出力レポートを保存する

192レポート

言語サポートをカスタマイズする 242デフォルト・フォントを変更する 190配信時間を短縮する 320

レポート作成の要件

Transformer ユーザーの 35レポート出力

再利用する 193ファイル・システムに保存 191IBM Cognos Analytics を所有していないユーザーと共有す

る 192レポート仕様

アーカイブのオフ設定 349アップグレード 58

レポートの印刷

UNIX および Linux 印刷サーバー用にカスタマイズする

198レポートのスタイル

ワークスペース内 261レポート配布

ネットワーク上の 320レポート・サーバー

64 ビットを使用可能にする 102ログ

サービス 316メッセージ処理 227

ログオン

セキュリティーを設定する 90ネームスペースを非表示にする 292

ログ記録

設定 233データベース・クライアント 230ファイルの使用 232リモート・ログ・サーバー 232database 232


ログ記録データベース

作成のガイドライン 228Db2 9Informix データベース・サーバーを使用して作成する 15Microsoft SQL Server を使用して作成する 14Oracle を使用して作成する 13SSL の使用 214z/OS 上の Db2 の表スペース 229

ログ・ターゲット

タイプ 227ログ・ファイル 362

アンインストール 364インストール設定 363ゲートウェイ・エラー 364サイレント・モード 364実行時 364始動設定 363転送 363ロケール設定 363

ログ・メッセージ

リモート・ログ・サーバー 227ログ・ターゲット 227IBM Cognos Application Firewall で使用可能にする 181参照：監査ログ

参照：トラブルシューティング

ログ・メッセージを処理する 227ロケール

サポートされているコンテンツ・ロケールを表示する 242サポートされているユーザー・インターフェースのロケール

を表示する 241

［ワ行］ワークスペース

レポートのスタイル 261

［数字］1024 ビットの証明書 201, 20232 ビット・ゲートウェイ 10964 ビット

レポート・サーバー 102

AActive Directory

LTPA 270Active Directory サーバー

詳細プロパティー 280シングル・サインオンを有効にする 280認証に使用する 276複数のドメインで認証する 280LDAP ネームスペース 295SSL の有効化 279

Agent サービス 315

AIX環境変数 66, 71, 93, 106

Annotation サービス 315Apache HTTP Server

Cognos Analytics 11.0.4 用の設定 120Cognos Analytics 11.0.5+ 用の設定 119

Apache Web サーバー

別名の設定 107Apache モジュール 123apache_mod ファイル

ゲートウェイ用に設定する 148, 149ARBORPATH 環境変数 98

BBatch Report サービス 315

PDF レポート用の埋め込みフォント・リスト 190

CCA SiteMinder 304

IBM Cognos Application Firewall でクロス・スクリプト

を検査する 181CA 証明書 201, 202CA、

参照：認証局

chase_referral ファイル 280cogconfig.sh

コマンド行オプション 351Cognos Analytics の開始 143Cognos Analytics ポータル 22Cognos Mobile データベース

手動で表を作成 103設定 103

Cognos Mobile のコンポーネント 27Cognos Workspace 承認済みドメイン 181Cognos サービス

コマンド行で開始する 327Cognos サービスを開始する

コマンド行から 327Cognos サービスを停止する

コマンド行から 327cogstartup.lock ファイル 363cogstartup.xml ファイル 322, 327

プロパティーを手作業で変更する 324Collaboration ディスカバリー URI

設定 251Content Manager

アクティブおよび待機用 70, 195インストール・オプション 29コンポーネント 29コンポーネントの説明 22設定 29待機 29タイム・ゾーンを変更する 247

索引 377

Content Manager (続き)

フェイルオーバー保護 29複数のコンピューターで設定する 86複製 195レポート出力の外部保存 196ログ・サーバー 227IBM Cognos Transformer で Series 7 ネームスペースを使

用する場合の要件 153, 285Content Manager 8

レポート仕様のアーカイブをオフに設定する 349Content Manager URI 86, 100Content Manager サービス 315Content Store

および他の場所へのレポート出力の保管 191コンポーネントの説明 26接続管理 82表スペースの作成 76IBM Cognos BI の複数のバージョン 48Oracle 上に作成する 13SSL の使用 214

Cookieカスタマイズ 249設定 249Web ブラウザーで有効にする 17

DDb2

クライアント設定 74コード・ページ 150, 158データベース接続 95データベース・ドライバー 74ログ・メッセージのリポジトリーとして指定する 233

Db2 Content Store 318スクリプト 75

Delivery サービス 315

EE メール・サーバー

設定 88E メール・メッセージ

エンコード方式の変更 247Entrust セキュリティー・インフラストラクチャー 180ESSBASEPATH 環境変数 98Event Management サービス 315Event Studio

コンポーネントの説明 24

FFileNet

カスタム・クラスのインポート 344レポート仕様のアーカイブをオフに設定する 349

Firefox設定 17

Framework Managerアンインストール 339インストール 145, 146インストールと設定をテストする 153インストール・オプション 33コンポーネントの説明 25システム要件 146設定 33データ・ソースの設定 150ネットワーク・ファイアウォールの内側 148ファイアウォールの外側 149参照： Cognos Framework Manager

GGB18030 186, 190Google Chrome

設定 17Graphics サービス 315

HHTML Cookie、

参照： CookiehttpEndpoint

設定グループ 173Human Task サービス 315Human Task と Annotation データベース

z/OS 上の Db2 の表スペース 255

IIBM Cognos Administration

コンポーネントの説明 23IBM Cognos Analytics

アンインストール 337インストールのトラブルシューティング 355サービス 317設定 15ディスパッチャー 317ログオン 90

IBM Cognos Analytics for Microsoft Office 24IBM Cognos Configuration

コマンド行オプション 351コンポーネントの説明 22システム・フォントの使用 189開く際の問題 363無人モード 334

IBM Cognos Configuration を開くことができない 363IBM Cognos Content Archival

外部リポジトリー 341IBM Cognos Controller

IBM Cognos Analytics におけるデータ・アクセス 39


IBM Cognos Planning - AnalystIBM Cognos Analytics におけるデータ・アクセス 38

IBM Cognos Planning - Contributorスケジュールしたレポートとエージェントを有効化する 262IBM Cognos BI におけるデータ・アクセス 38

IBM Cognos Series 7シングル・サインオンを有効にする 287認証に使用する 285SSL の有効化 287Trusted Signon プラグイン 288

IBM Cognos Series 7 PowerCube適切な言語変換のための要件 39

IBM Cognos Transformerデータ・ソースの設定 158

IBM Cognos Workspace 24サンプル 261設定 252レポートのスタイル 261Microsoft IIS のロード要件 254

IBM Cognos アプリケーション・ファイアウォール

設定 181IBM Cognos サービス

コマンド行で停止する 327サービスで使用されるユーザー・アカウントの要件 81, 99設定 319

IBM Connections 181コラボレーションの設定 251

IBM Content Manager 8インポート

IBM Content Manager 8 に対するカスタム・クラスの

インポート 345カスタム・クラスのインポート 345

IBM Db2接続文字列を作成する 82

IBM Directory ServerLDAP ネームスペース 297

IBM FileNet Content Manager 341IBM HTTP Server

Cognos Analytics 11.0.4 用の設定 120Cognos Analytics 11.0.5+ 用の設定 119

IBM Java Software Development Kit 239IBM サポート

情報を送受信する 359連絡を取る 358

IBM の Java Software Development Kit 313IBMid 274IIS

設定 129SSO の設定 129

IIS Web サーバー

Active Directory を使用したシングル・サインオン 280Informix

データベース・ドライバー 80, 231ログ記録データベースの作成 15ログ・メッセージのリポジトリーとして指定する 233Content Store の作成 15

Integrated Facility for Linux (IFL) 31Interactive Discovery Visualization サービス 316Internet Explorer

設定 17IP アドレスのバージョン 249IPv4 249IPv6 249ISAPI

ゲートウェイ用に設定する 148, 149ISAPI ゲートウェイ 135

JJava

バージョン変更 167Runtime Environment を更新する 6

Java Management Extensionsシステム評価指標をリモート監視する JMX プロパティーを

設定する 313ユーザー・ログを使用 239

JavaScriptWeb ブラウザーで有効にする 17

JDBCKerberos シングル・サインオン 222, 223, 225, 226

JDBC ドライバー

Oracle データベースを設定する 231Job サービス 316JRE ファイル

更新 6JVM

変更 167

KKerberos シングル・サインオン

JDBC 222, 223, 225, 226Kerberos 認証 282

制約付き委任 284

LLDAP

外部 ID マッピング・プロパティーを編集する 304カスタム・プロパティー 301シングル・サインオンを有効にする 303認証に使用する 292ネームスペースを設定する 294Active Directory サーバー 295IBM Directory Server 297LTPA 268Novell Directory Server 298Oracle Directory Server 300SSL の有効化 302

Lifecycle Manager 40, 57Lightweight Third-Party Authentication (LTPA) 268

索引 379

Lightweight Third-Party Authentication (LTPA) (続き)

Active Directory 270LDAP ネームスペース 268

Linux環境変数 66, 71, 93, 106データ・ソースへの ODBC 接続 96ログ・メッセージ 232Cognos サービスの開始と停止 327ulimit 設定 5

MMap Manager

コンポーネントの説明 26Metadata サービス 316Microsoft Analysis Server

ネームスペースの要件 277Microsoft Analysis Services

データ・ソース環境を設定する 150, 158MSAS データ・ソースへのシングル・サインオン 280

Microsoft IISそこでの SSL の設定 128IBM Cognos Workspace をロードするための要件 254

Microsoft OfficeReport Data サービス 318

Microsoft SQL Server接続文字列を作成する 82データベース接続 95ネームスペースの要件 277ログ・メッセージのリポジトリーとして指定する 233SSL 214

Migration サービス 316MIME タイプ

IBM Cognos Workspace をロードするために MicrosoftIIS での指定が必要 254

Mobile サービス 317Monitor サービス 317MSAS、

参照： Microsoft Analysis Servicesmulti_domain_tree 280

NNetezza

データ・ソース接続 95ODBC 接続を設定する 96

NIST SP800-131a 201, 202Novell Directory Server

LDAP ネームスペース 298

OOpenID Connect

サポートされる ID プロバイダー 272診断ログ記録 274

OpenID Connect (続き)

ネームスペースを設定する 274ID プロバイダー 274

OpenID Connect の ID プロバイダー 274OpenID Connect 用の ID プロバイダー 272Oracle

接続文字列を作成する 82多言語サポート 150, 158データベース JDBC ドライバー 231データベース接続 95データベース・ドライバー 79ログ・メッセージのリポジトリーとして指定する 233

Oracle Directory ServerLDAP ネームスペース 300

Oracle ESSBASEデータ・ソース接続 95

Oracle Essbase設定 9864 ビット Microsoft Windows 98UNIX 98

Oracle Java SE Development Kit 239, 313

PPDF フォント

高速なレポート印刷のために組み込み PDF フォントにマッ

ピングする 188Planning Analytics 40PowerCube

適切な言語変換のための要件 39IBM Cognos Analytics におけるアクセス 39

Presentation サービス 317要件 314

QQuery Studio

コンポーネントの説明 24Query サービス 317

Rrelational metadata サービス 318Report Data サービス 318Report サービス 318

要件 314PDF レポート用の埋め込みフォント・リスト 190

Reporting画像のロード 107コンポーネントの説明 22地図グラフの場所の変更 194

RSS フィード

トラブルシューティング 361


SSafari 5

設定 17SaferAPIGetTrustedSignon 関数

認証に使用する 288sAMAccountName

Kerberos 認証を使用する 284SAP

シングル・サインオンを有効にする 311認証に使用する 308

SAP BW接続 310データ・ソース接続 95IBM Cognos BI の管理者用の承認設定 310IBM Cognos BI のユーザー用の承認設定 308

Secure Sockets Layer、参照： SSL

Series 7 IQD Bridgeインストール 153

Series 7 PowerCube適切な言語変換のための要件 39

SHA1 証明書 201, 202SiteMinder

ネームスペースの設定 307Solaris

環境変数 66, 71, 93, 106SSL

設定 128, 209他のサーバーとの間で共有信頼関係を設定する 211通知データベース用 214保護品質 213ログ記録データベース用 214Active Directory サーバー 279Content Store データベース用 214IBM Cognos Series 7 ネームスペースを使用する 287LDAP ネームスペース 302Microsoft SQL Server 214Web サーバーで有効にする 117

SSL 接続の保護品質 213SSO 119, 120syslog

ログ・メッセージのターゲット 232

TTeradata

データ・ソース接続 95TM1

データ・ソース接続 95Transformer

アンインストール 339

Transformer (続き)

インストール 145, 153, 154インストールをテストする手順 160インストール・オプション 34コンポーネントの説明 26システム要件 153設定 34ファイアウォールの外側から Cognos Analytics にアクセ

スする 157モデル作成者に配布する 164IBM Cognos Analytics におけるデータ・アクセス 39Linux および UNIX でのインストール 155Series 7 ネームスペースを使用する場合の Content

Manager の要件 153, 285Windows でのインストール 156

Transformer のインストール・ファイル 162

Uulimit 設定 5UNIX

環境変数 66, 71, 93, 106データ・ソースへの ODBC 接続 96ログ・メッセージ 232Cognos サービスの開始と停止 327ulimit 設定 5

URIデフォルト設定 7変更 169, 171

UTF-8E メール・メッセージのエンコード方式 247

WWeb サーバー

設定 107Active Directory と IIS Web サーバーを使用したシング

ル・サインオン 280Reporting のロード時間を設定する 107SSL の有効化 117

Web の別名

IBM Cognos Analytics 107Web ブラウザー

セキュリティー設定 3設定 17

Windows 67Windows イベント・ログ

ログ・メッセージのターゲット 232Windows 認証 280Windows のインストール 67

索引 381

Documents

IBM Cognos Analytics oW 110nCXg...IBM Cognos Transformer の追加の設定タスク . 161 第 7 章 設定オプション..... . 167IBM Cognos Analytics コンポーネントで使用する

IBM Cognos Analytics oW 110nCXg...IBM Cognos Transformer の追加の設定タスク . 161 第 7 章設定オプション..... . 167IBM Cognos Analytics コンポーネントで使用する