IBM Cognos Content Managerパッケージ - インポート

ブリッジの仕様

ベンダー	IBM
ツール名	Cognos Content Managerパッケージ
ツールバージョン	ReportNet 1.1～Cognos 12.x
ツールのWebサイト	http://www.ibm.com/software/analytics/cognos/ (英語のみ)
サポートされている方法論	[ビジネスインテリジェンス] メタデータリポジトリー、Java API経由のBIデザイン(RDBMSソース、OLAPソース、ディメンショナルターゲット、変換来歴、式解析)
データプロファイリング
増分収集
マルチモデル収集
モデル選択のためのリモートリポジトリーの参照

仕様
ツール: Java API経由のIBM / Cognos Content Manager PackagesバージョンReportNet 1.1〜Cognos 12.x
http://www.ibm.com/software/analytics/cognos/をご覧ください。
メタデータ: [ビジネスインテリジェンス] メタデータリポジトリー、BIデザイン(RDBMSソース、OLAPソース、ディメンショナルターゲット、変換来歴、式解析)
コンポーネント: CognosRnModelRepositoryバージョン11.2.0

概要
このインポートブリッジは次のタイプのオブジェクトをサポートしています。
- FrameworkManagerモデル
- DataModule
- Dynamic Cubeモデル
- PowerPlay Transformerモデル(Transformer import configurationというパラメーター経由での設定が必要)
- QueryStudioクエリー
- ReportStudioレポート
- Explorationレポート(ダッシュボードとストーリー)

このインポートブリッジは次のタイプのオブジェクトはサポートしていません。
- AnalysisStudioレポート
- PowerPlayレポート

要件
該当なし

よくある質問
Q: Content Managerから抽出されたパッケージのバージョンが複数あるのはなぜですか?

A: どのCognosデザインモデルでも、Cognos Framework Manager(FM)で編集またはアップデートし、Content Manager (CM)でFMパッケージの新バージョンとして公開できます。Cognosの全開発ライフサイクルプロセスでは、CMでこの新バージョンのFMパッケージを使用できるよう、関連するレポートを移行させる必要があります。そのようなレポートのすべてについて移行が完了していない場合、レポートによっては古いバージョンのパッケージがまだ使われていたり、古いバージョンのパッケージがもう使われておらず削除が必要であったり、新しいバージョンのパッケージがどのバージョンでもまだ使われていなかったりする可能性があります。その場合、複数のバージョンのパッケージが異なるレポートで使用され、インポートされる可能性があります。

Q: Content Managerから最新バージョンのパッケージだけを抽出するにはどうすればいいですか?

A: [コンテンツ]パラメーター(例: /content/package[@name='GO Sales and Retailers]/model)で単一のパッケージを選択し、[依存オブジェクトの追加]パラメーターをFalseに設定することで、パッケージの最新バージョンのみを抽出できます。この場合は、パッケージの最新バージョンのみインポートされます。

さらに、一度に1つのパッケージだけをインポートするFMパッケージインポートブリッジを使用できます。この場合は、パッケージの最新バージョンのみインポートされます。

Q: インポートログに表記されている「Could not get model reference for Report XXX」という警告はどういう意味ですか?

A: リポジトリーレポートのメタデータにレポートやクエリーのモデルへの有効な参照がない可能性があります。
ReportかQuery Studioでレポートやクエリーを開き、変更を加えずにそのまま再保存するとよいかもしれません。
それによってリポジトリー内のメタデータ参照がアップデートされます。再保存後、問題のレポートやクエリーをインポートし直してみてください。
また、レポートやクエリーのベースとなっているモデルに(削除されたり名前が変更されたりして)アクセスできなくなっていることも考えられます。
この場合は、正しいモデルが参照されるよう、レポートまたはクエリーを固定してみてください。

Q: ランタイムで必要となるCognos Javaライブラリーは何ですか?

A: インポートブリッジは、次のフォルダーにあるJavaライブラリーを使用します: MIMB_HOME/java/CognosRepository
Cognosバージョン10.2.x以降、Javaライブラリーはバージョン混在の互換性がなくなりました。このライブラリーはCognosサーバーのバージョンと完全に一致する必要があります。
デフォルトで提供されているライブラリーが特定バージョンのCognosサーバーで動作しない場合は、次のように置き換える必要があります。

- IBMのWebサイトからIBM Cognos Software Development Kitソフトウェアパッケージをダウンロードし、お使いのサーバーに適合したバージョン(例: 11.0.5)を選択します。
- インポートブリッジを実行しているマシンにCognos SDKソフトウェアパッケージをインストールします。
- SDK内のJavaライブラリー(例: /ibm/cognos/sdk/sdk/java/lib)を検索します。
- [Cognos SDKディレクトリー]インポートブリッジパラメーターがこのディレクトリーパスをポイントするように設定します。
Cognosバージョン11.1より、ソフトウェア開発キットがCognos Analyticsサーバーにデフォルトでインストールされるようになりました。

制限事項
現在判明している一般的な制限事項は、MIMB Known Limitationsか、バンドルされているDocumentation/ReadMe/MIMBKnownLimitations.htmlをご覧ください。
Cognos Content Managerにアクセスするためには、そのWebサービスが完全に動作している必要があります。これは、ネットワークプロキシとファイアウォールの設定を含む可能性があります。このインポートブリッジの使用を試みる前に、Cognosが提供するユーティリティを使い、Cognos 10.2でhttp://localhost/c8/cm_tester.htmかhttp://localhost:9300/p2pd/cm_tester.htmに接続してみます。localhostは適切なIP名とポートに置き換えてください。
詳細は、Dispatcher URLパラメーターのドキュメンテーションをお読みください。必要であればCognos管理者かCognosサポートにご連絡ください。cm_testerが完全に動作していない場合、このインポートブリッジは動作しません。

cm_testerツールを使うためのステップは次のとおりです。
- Webブラウザー(FirefoxやChromeなど)を起動してテスターURLに接続する
- オプションボタンをクリックしてコンテンツマネージャーURLを設定し、[テスト]ボタンを使って接続できることを確認する
- [ログオン]ボタンをクリックしてログイン情報を入力します(例: ネームスペース = CognosEx、ユーザー名 = アドミンパスワード = *****)
- [Content Manager Service v1]ネームスペースを選択します。
- queryMultipleというリクエストテンプレートを選択します。
- SOAPリクエストテキストを編集し、#PATH#というクエリー検索パスを/content/folder[@name='Samples']//*のような値に置き換えます。
- SOAPリクエストテキストを編集し、返すプロパティを指定します: #PROPERTY1# => defaultName #PROPERTY2# => searchPath
- SOAPリクエストテキストを編集し、ソート基準となるプロパティを指定します: #SORT_BY# => defaultName
- 送信ボタンをクリックします。

また、WSILマッシュアップサービスのエンドポイントを使い、ContentManagerで利用できるReportStudioレポートである<ゲートウェイURI>/rds/wsilを参照することも可能です。
バージョン8.xの場合: http://localhost:9300/ibmcognos/bi/v1/disp/rds/wsil
バージョン11.xの場合: http://localhost:9300/bi/v1/disp/rds/wsil
https://www.ibm.com/docs/en/cognos-analytics/11.1.0?topic=reports-identifying-programmatically

サポート
トラブルシューティングパッケージを次の項目と共に提供してください。
- デバッグログ(UIまたはconf/conf.propertiesでMIR_LOG_LEVEL=6を使って設定可能)
- 利用できる場合はメタデータバックアップ(技術的理由によりこの共通オプションが実装されていないブリッジがあるものの、Miscellaneousパラメーターで-backupオプションを使って設定可能)

Q: サポートチームが問題を再現できるよう、どのように IBM Cognosメタデータを提供すればよいですか?
バックアップ方法は2種類あります。説明されている長さの方法が有効で、サポートチームによって指定されている場合に使用できます。

このブリッジはレポートやモデルをローカルのMIMBキャッシュの下に保存し、サポートの目的で十分な量のメタデータを提供します。Miscellaneousパラメーターで-backupを起動し、関連する全メタデータをブリッジが保存するディレクトリーを指定します。

A: 次の手順に従って、IBM Cognos 8.4またはIBM Cognos 10サーバーからメタデータをZIPアーカイブにエクスポートする必要があります。
1) Webブラウザーを使ってIBM Cognos Connectionに接続します。
2) [起動] -> [IBM Cognos Administration]をクリックします。
3) [設定]をクリックします。
4) [コンテンツ管理]をクリックします。
5) [新規エクスポート]アイコンをクリックします。新規エクスポートウィザードが表示されます。
6) デプロイメント仕様の一意名、オプションの説明、画面ヒントを入力します。保存先フォルダーを選択して[次へ]をクリックします。
7) コンテンツストア全体をエクスポートするか、特定のフォルダーやディレクトリーのコンテンツを部分的にエクスポートするかを選択します。
注: コンテンツストア全体のエクスポートはしないでください。一般に必要とされることはなく、このタイプのエクスポートを復元すると、デスティネーションサーバーのコンテンツストアが消去されてしまう可能性があるためです。
特定のフォルダーとディレクトリーの内容をエクスポートするためには、[パブリックフォルダーとディレクトリーの内容を選択]をクリックし、[次へ]をクリックします。
8) [パブリックフォルダー]コンテンツの選択ページで、[追加]をクリックします。
9) エントリーの選択ページの[利用可能なエントリー]ボックスで、エクスポートしたいパッケージまたはフォルダーを選択します。
[パブリックフォルダー]の階層を参照して、必要なパッケージやフォルダーを選択できます。
右矢印ボタンをクリックし、選択した項目を[選択したエントリー]ボックスに移動させて[OK]をクリックします。
10) [オプション]では、いずれも必須ではないレポート出力のバージョン、実行履歴、スケジュールを含めるかどうか、そして競合が発生した場合にエントリーをどのように処理するかを選択します。[次へ]をクリックします。
11) [ディレクトリーの内容の選択]ページでは、Cognosのグループとロール、分散リストと連絡先、データソースと接続をエクスポートするかどうか、競合した場合のエントリーの処理をどうするかを選択します。Cognosのグループとロール、配布リストと連絡先をエクスポートする必要はありません。
12) [次へ]をクリックします。
13) [一般的なオプションを指定する]ページでは、IBM Cognos以外のネームスペースへのアクセス許可や参照を含めるかどうか、対象環境にインポートした後のエントリーを誰が所有するかを選択します。
IBM Cognos以外のネームスペースへのアクセス権限や参照は含めないことを強くお勧めします。
また、エントリーの所有権はインポートを実行するユーザーに設定することをお勧めします。
14) デプロイメント履歴の記録レベルを指定します。デフォルトは[基本]です。[トレース]はのデプロイメントの詳細をすべて保存しますが、最も多くのメモリを必要とします。[次へ]をクリックします。
15) デプロイメントアーカイブの指定ページのデプロイメントアーカイブで、リストから既存のデプロイメントアーカイブを選択するか、新しい名前を入力して作成します。
デプロイメントアーカイブの新しい名前を入力する場合、IBM Cognosでは名前にスペースを使用しないことをお勧めします。
新しいデプロイメント仕様の名前が既存のデプロイメントアーカイブの名前と一致する場合は、名前の最後に _1、_2、_3といった文字が追加されます。
16) [次へ]をクリックします。
17) サマリー情報を確認して[次へ]をクリックします。情報を変更したい場合は、[戻る]をクリックして指示に従います。
18) アーカイブをエクスポートする準備ができたら、必要なアクションを選択します:
今すぐ、または後で実行する場合は、[保存]をクリックして一度実行し、[完了]をクリックします。実行する日時を指定します。続いて[実行]をクリックします。ランタイムを確認して[OK]をクリックします。
定期的にスケジュールするためには、[保存]をクリックしてスケジュールを立て、[完了]をクリックします。次に、頻度、開始日、終了日を選択します。[OK]をクリックします。
スケジューリングや実行をせずに保存する場合は、[保存]のみをクリックして[終了]をクリックします。
19) エクスポートを実行した後、生成されたZIPアーカイブをサポートチームに送信してください。エクスポートは単一のZIPファイルか複数ボリュームのZIPアーカイブになります。
エクスポートされたアーカイブは通常、サーバーのC:\Program FilesCognos\c8deploymentディレクトリーに配置されています。
お使いのバージョンのCognosからメタデータをエクスポートする方法の詳細は、IBM Cognosのドキュメンテーションをお読みください。

ブリッジパラメーター

ブリッジのマッピング