Oracle® Fusion Middleware Oracle Business Intelligence Enterprise Editionシステム管理者ガイド 12c (12.2.1) E70044-01 |
|
![]() 前 |
![]() 次 |
この章では、BIアプリケーション・アーカイブ(BAR)・ファイルのOracle Business Intelligenceを管理する方法とサービス・インスタンスを操作する方法について説明します。
この章の内容は次のとおりです。
この節の内容は以下のとおりです。
Oracle Business Intelligenceのアプリケーション・アーカイブ(BAR)・ファイルは、密接したセットのBIメタデータ・アーティファクト(データ・モデル、コンテンツ・モデルおよび認可モデル)を含む圧縮されたアーカイブ・ファイルです。BARファイルをBIサービス・インスタンスにインポートできます。BIサービス・インスタンスをBARファイルにバックアップし、BIドメインで実行している既存のサービス・インスタンスまたは別のBIインストールで実行している異なるサービス・インスタンスに後でリストアできます。
BARファイルには、次のBIアプリケーション・モジュール・アーティファクトが含まれます。
Oracle BIサーバーのデータ・モデル・メタデータ。このメタデータはxmlベースですが、.RPDファイルと機能的に同等です。
サービス・インスタンスのプレゼンテーション・サービス・カタログ・メタデータ。
アプリケーション・ロールおよびアプリケーション・ロール・メンバーシップとサービス・インスタンスの権限および権限セット付与を含むセキュリティ・ポリシー・メタデータ。
BARファイルの依存性を宣言するマニフェスト・ファイル。
オラクル社では、サービス・インスタンスとともに使用するBIメタデータを含む多数の定義済のBARファイルを提供しています。
インストール中に次のBARファイルのいずれかを選択できます。
空のBAR - oracle.bi.application.empty.bar
空のBARファイルを使用すると、メタデータおよびセキュリティ・ポリシーを完全に制御できます。または、インポートできる別のシステムから既存のBARを使用できます。
ORACLE_HOME/bi/bifoundation/admin/provisioning/oracle.bi.application.empty.bar
空のBARファイルには、システムへのログインおよび管理を行う管理者ユーザーの十分な権限のみが含まれます。
表9-1に、空のBARファイルに含まれるアプリケーション・ロールおよび対応する権限セットを示します。
SampleAppLite BAR - SampleAppLite.bar
インストール時にSampleAppLiteを選択できます(『Oracle Fusion Middleware Oracle Business Intelligenceインストレーション・ガイド』を参照)。
SampleAppLite BARは、すぐにBI分析を使用して起動し、製品の機能を示すことができます。
SampleAppLite BARファイルには、2つのサブジェクト・エリア、レポートのコレクション、読取り、書込みおよび管理タスク用のアプリケーション・ロールを使用したファイル・ベースのデータ・ソースが含まれます。
ORACLE_HOME/bi/bifoundation/samples/sampleapplite/SampleAppLite.bar
表9-2に、SampleAppLite BARファイルに含まれるアプリケーション・ロールおよび対応する権限セットを示します。
表9-2 SampleAppLite BARのアプリケーション・ロールおよび権限セット
アプリケーション・ロール | 権限セット |
---|---|
BIServiceAdministrator |
obisch.administrator essbase.administrator obips.administrator cds.administrator bip.administrator obis.administrator |
BIConsumer |
bip.consumer |
BIContentAuthor |
va.author obisch.author bip.author |
詳細は、第1.6項「サンプル・アプリケーションでの作業」を参照してください。
初期BAR
最初からメタデータを作成する場合に初期BARを使用する必要がありますが、通常のセキュリティ・ポリシーを配置する必要があります。
初期BARは、サンプル・アプリケーションBARと同じセキュリティ・ポリシーを含むことを除いて実質的に空です。
たとえば、初期BARをサービス・インスタンスにインポートしてユーザーが最初から固有のデータをインポートする場合にVisual Analyzerのサービス・インスタンスを作成すると、初期アプリケーション・ロールを使用してユーザーをプロビジョニングするだけで、製品を使用してすぐにログインおよび起動できます。
BARファイルをサービス・インスタンスにインポートする場合、サービス・インスタンスはBARファイルからインポートされたデータ・モデル、コンテンツおよびセキュリティ・ポリシーを使用します。
インポート・プロセスは次の処理を行います。
BARで定義されているコンテンツ、モデルおよびセキュリティ・ポリシーを取得して、サービス・インスタンスにデプロイします。
サービス・インスタンスですでに確立されている既存のコンテンツ、モデル、セキュリティ・ポリシーを上書きします。
サービス・インスタンスには、すべてのOracle Business Intelligenceメタデータ(つまり、リポジトリ・データ、プレゼンテーション・カタログ、セキュリティ・ポリシー)が含まれ、メタデータに行うカスタマイズが含まれます。表9-3で説明されているWebLogic Scripting Tool (WLST)コマンドを使用してBIドメインのサービス・インスタンスを管理します。
WLSTの使用の詳細は、第8.3.3項「WebLogic Scripting Tool (WLST)の使用」を参照してください。
表9-3 Oracle Business Intelligenceサービス・インスタンス・コマンド
コマンド | 説明 |
---|---|
|
このコマンドは、BIドメインのすべてのサービス・インスタンス・キーを示します。 |
|
このコマンドは、特定のサービス・インスタンス・キーのサービス・インスタンスの詳細を取得します。 |
|
このコマンドは、新しいコンピュータにサービス・インスタンスをスケールアウトし、サービス・インスタンスがBIドメイン内の指定されたコンピュータで使用できることを確認します。このコマンドは、拡張した場合のみ使用されます。 |
|
このコマンドは、BARファイル形式でサービス・インスタンスを特定のエクスポート・ディレクトリにエクスポートします。 |
|
このコマンドは、カスタマイズとしてすでにエクスポートされたバー(サービス・インスタンス)を特定の環境にインポートします。 |
|
このコマンドは、BIドメインから継承されるサービス・インスタンスのserviceKeyの一部の側面をリフレッシュします。たとえば、新しいモジュールまたは製品がBIドメインに追加されると、サービス・インスタンスがリフレッシュされる場合にそのモジュールまたは製品の権限セットのみをサービス・インスタンスで使用できます。 |
"refreshDomainServiceInstances" |
このコマンドは、ドメインのすべてのサービス・インスタンスをリフレッシュします。 |
|
このコマンドは、特定のサービス・インスタンスを空の状態にリセットします。空のBARファイルのインポートと同等です。 |
表9-4 'ドメイン・サービス・インスタンスの管理'コマンドで使用するパラメータ
パラメータ | 説明 |
---|---|
domainHome |
BIドメイン・ホームへのパス。 /oraclehome/user_projects/domains/bi |
serviceInstanceKey |
関連付けるかスケール・アウトするサービス・インスタンスのキー。 例: mycompany.facility |
machine |
スケール・アウトするコンピュータの名前。 例: machine=mycompany.example.com |
port |
スケール・アウトしたコンピュータで使用するポート番号。 例: port=9768 |
monitorPort |
スケール・アウトしたコンピュータで使用するモニター・ポートの名前。 例: portMonitor=9502 |
BIサービス・インスタンスおよびBARファイルに対するすべてのWLSTコマンドの前提:
ファイル・システム(オフライン)権限を持つ必要があります。
WLSTコマンドをオフラインで実行します。
WLSTを使用してサービス・インスタンスを変更した後、システムを起動する必要があります。
このタスクでは、すべてのサービス・インスタンスをリストできます。
すべてのインスタンスをリストするには:
WLSTコマンドライン・スクリプティング・ツールを起動します。
詳細は、第8.3.3項「WebLogic Scripting Tool (WLST)の使用」を参照してください。
次のようにコマンドを入力します。
listBIServiceInstances(domainHome)
domainHomeはBIドメイン・ホームのパスです。
例:
listBIServiceInstances('/oraclehome/user_projects/domains/bi')
コマンドは、サービス・インスタンス・キーのリストを返します
詳細は、第9.2.2項「getBIServiceInstance」を参照してください
このコマンドは、サービス・インスタンス詳細を表示します。情報の一部を次に示します。
メタデータ構成: アプリケーションの関連付けおよびカスタマイズ。
コンポーネントの詳細が表示されます。
説明。
サービス・インスタンス詳細を表示するには:
次のコマンドを入力して、指定されたサービス・インスタンス詳細をフェッチします。
getBIServiceInstance(domainHome, serviceInstanceKey)
例:
getBIServiceInstance('/oraclehome/user_projects/domains/bi', 'mycompany.facility')
コマンドは、詳細の一部を含むサービス・インスタンス・オブジェクトを返します。
サービス・インスタンス・キー。
説明。
コンポーネントのリスト。
アプリケーション・モジュールの一覧表示。
このコマンドは、サービス・インスタンスを新しいコンピュータにスケールアウトして、ドメインでサービス・インスタンスを使用できるようにします。可用性が増えた後にサービス・インスタンスが作成される場合、このコマンドを使用します。詳細は、「Oracle Business Intelligenceの可用性の管理(水平方向のスケーリング)」を参照してください。
scaleOutBIServiceInstance(domainHome, serviceInstanceKey, machine, port=None, portMonitor=None)
このコマンドは、詳細を含むサービス・インスタンス・オブジェクトを返します。
前提:
指定しないかぎり、すべてのポートがデフォルトのBIポート範囲から割り当てられます。
クラスタ・コントローラ、スケジューラおよびBIサーバー・マスターが変更されていません。
新しいコンポーネントを起動する必要があり、オフラインの場合に管理サーバーおよびノード・マネージャを最初に起動する必要があることを示します。第2.3.2項「ドメインのOracle Business Intelligenceコンポーネント・プロセスの起動」を参照してください。
表9-5に、このコマンドのパラメータを示します。
表9-5 高可用性のためにサービス・インスタンスをスケール・アウトするパラメータ
パラメータ | 説明 |
---|---|
domainHome |
BIドメイン・ホームへのパス。 |
serviceInstanceKey |
スケール・アウトするサービス・インスタンスのキー。 |
machine |
サービス・インスタンスをスケール・アウトするコンピュータの名前。 |
たとえば、次のようになります。
scaleOutBIServiceInstance('/oraclehome/user_projects/domains/bi','mycompany.facility', 'example.com')
事後状態:
新しいコンポーネントが作成されます。
新しいポートが割り当てられます。
新しいサービス・インスタンスが登録されます。
このコマンドは、BARファイルとしてサービス・インスタンスを指定されたエクスポート・ディレクトリにエクスポートします。次に、別の環境または同じ環境にBARファイルをインポートできます。これらのオプション・パラメータの詳細は、表9-6に示されています。
exportServiceInstance(domainHome serviceInstanceKey workDir, exportDir, applicationModuleName, applicationModuleDesc, applicationModuleVersion, includeCatalogRuntimeInfo, includeCredentials)
表9-6に、このコマンドのパラメータを示します。
表9-6 サービス・インスタンスをエクスポートするパラメータ
パラメータ | 説明 |
---|---|
domainHome |
BIドメイン・ホームへのパス。 |
serviceInstanceKey |
サービス・インスタンスのキー。 |
workDir |
実行用の作業ディレクトリ。 |
exportDir |
BARファイルをエクスポートするディレクトリ |
applicationModuleName |
将来の使用のために予約されています。 |
applicationModuleDesc |
将来の使用のために予約されています。 |
applicationModuleVersion |
将来の使用のために予約されています。 |
includeCatalogRuntimeInfo |
オプション - このフラグがtrueである場合、カタログ・ランタイム情報(たとえば、ユーザー・フォルダ)がエクスポートに含まれます。それ以外の場合、カタログ・ランタイム情報がスキップされます。このフラグのデフォルト値はfalseです。 |
includeCredentials |
オプション - これは、エクスポートされたメタデータ・リポジトリ・コンテンツを暗号化するパスワードです。このフィールドのデフォルト値は、Noneです。この値を指定しない場合、接続資格証明はエクスポートされません。それ以外の場合、接続資格証明がエクスポートされます。 |
たとえば、次のようになります。
exportServiceInstance( '/oraclehome/user_projects/domains/bi','mycompany.facility', '/workDir', '/scratch/exportDir') exportServiceInstance('/oraclehome/user_projects/domains/bi/','mycompany.dev', '/scratch/workDir', '/scratch/exportDir', 'mycompany.dev.test' , 'mycompany dev test', '11.1.1.0') exportServiceInstance('/oraclehome/user_projects/domains/bi/','mycompany.dev', '/scratch/workDir', '/scratch/exportDir', 'mycompany.dev.test' , 'mycompany dev test', '11.1.1.0', true, 'Test123') exportServiceInstance('oraclehome/user_projects/domains/bi/','mycompany.dev', '/scratch/workDir', '/scratch/exportDir', 'mycompany.dev.test' , 'mycompany dev test') exportServiceInstance('/oraclehome/user_projects/domains/bi/','mycompanyexample.dev', '/scratch/workDir', '/scratch/exportDir', None , 'mycompany dev test')
このコマンドは、指定されたBARファイルからターゲット・サービス・インスタンスにBIメタデータをインポートします。
importServiceInstance(domainHome, serviceInstanceKey, barLocation, importRpd, importWebcat, importJazn, includeCredentials, includeCatalogRuntimeInfo, includeCredentials)
表9-7に、このコマンドのパラメータを示します。
表9-7 サービス・インスタンスをインポートするパラメータ
パラメータ | 説明 |
---|---|
domainHome |
BIドメイン・ホームへのパス。 |
serviceInstanceKey |
サービス・インスタンスのキー。 |
barLocation |
エクスポートされたサービス・インスタンス・バーの絶対パス。 |
importRpd |
オプション - このパラメータの値はtrueまたはfalseに設定できます。デフォルト値は'true'です。このパラメータはメタデータの選択インポートをサポートします。このフラグが'false'に設定されている場合、コマンド実行はリポジトリ・メタデータをインポートしません。 |
importWebcat |
オプション - このパラメータの値はtrueまたはfalseに設定できます。デフォルト値は'true'です。このパラメータはカタログの選択インポートをサポートします。このフラグがfalseである場合、コマンドはカタログをインポートしません。 |
importJazn |
オプション - このパラメータの値はtrueまたはfalseに設定できます。デフォルト値は'true'です。このパラメータはJaznの選択インポートをサポートします。このフラグがfalseである場合、コマンドはJaznをインポートしません。 |
includeCredentials |
オプション - このパスワードを使用して、インポートされたrpdコンテンツを復号化します。このフィールドのデフォルト値は、"Admin123"です。 |
includeCatalogRuntimeInfo |
オプション - このフラグがtrueである場合、カタログ・ランタイム情報(ユーザー・フォルダなど)がエクスポートに含まれます。それ以外の場合、カタログ・ランタイム情報がスキップされます。このフラグのデフォルト値はfalseです。 |
includeCredentials |
オプション - このパスワードは、エクスポートされたメタデータ・リポジトリ・コンテンツを暗号化します。デフォルトの値はNoneです。このパラメータが指定されない場合、接続資格証明はエクスポートされません。それ以外の場合、接続資格証明がエクスポートされます。 |
たとえば、次のようになります。
importServiceInstance( '/scratch/mydir/oraclehome/user_projects/domains/bi','mycompany.facility', '/scratch/exportDir/mycompany.finance.bar') importServiceInstance('/scratch/mydir/oraclehome/user_projects/domains/bi', 'demosvc1', '/scratch/mydir/oraclehome/bi/bifoundation/samples/sampleapplite/test/SampleAppLite1.bar', true, false, false, 'Test123') importServiceInstance('/scratch/mydir/oraclehome/user_projects/domains/bi', 'demosvc1', '/scratch/mydir/orahome/bi/bifoundation/samples/sampleapplite/test/SampleAppLite1.bar', importRPD=true,includeCredentials='Test123')
このコマンドは、BIドメインから継承されるサービス・インスタンスの一部の側面をリフレッシュします。たとえば、新しいモジュールまたは製品がBIドメインに追加されると、サービス・インスタンスがリフレッシュされる場合にそのモジュールまたは製品の権限セットのみをサービス・インスタンスで使用できます。
refreshServiceInstance(domainHome, serviceKey)
表9-8に、このコマンドのパラメータを示します。
表9-8 サービス・インスタンスをリフレッシュするパラメータ
パラメータ | 説明 |
---|---|
domainHome |
BIドメイン・ホームへのパス。 |
serviceKey |
サービス・インスタンスのキー。サービス・インスタンスの一意の識別子です。 |
たとえば、次のようになります。
refreshServiceInstance('/oraclehome/user_projects/domains/bi', 'mycompany.finance')
このコマンドは、BIドメインのすべてのサービス・インスタンスをリフレッシュします。
refreshDomainServiceInstances(domainHome)
表9-9に、このコマンドのパラメータを示します。
たとえば、次のようになります。
refreshDomainServiceInstances('/oraclehome/user_projects/domains/bi')
このコマンドは、特定のサービス・インスタンスのすべてのカスタマイズを削除します(空のBAR状態と同様)。
resetServiceInstance(domainHome, serviceKey)
表9-10に、このコマンドのパラメータを示します。
表9-10 サービス・インスタンスをリセットするパラメータ
パラメータ | 説明 |
---|---|
domainHome |
BIドメイン・ホームのパス。たとえば、/oraclehome/user_projects/domains/biなどです。 |
serviceKey |
サービス・インスタンスのキー。サービス・インスタンスの一意の識別子です。たとえば、'ssi'などです。 |
例 - resetServiceInstanceコマンドを使用してカスタマイズを削除するには:
空のサービス・インスタンスを使用(空のBARファイルの使用と同じ)して、Oracle Business Intelligenceを構成します。
注意: 空のBARファイルを次に示します。
$BI_PRODUCT_HOME/bi/bifoundation/admin/provisioning/oracle.bi.application.empty.bar
SampleAppLiteをBIドメインにデプロイし、サービス・インスタンスに関連付けます。
ベースBAR上でカスタマイズを行います。
resetServiceInstanceコマンドを使用します。
たとえば、次のようになります。
resetServiceInstance('/oraclehome/user_projects/domains/bi', 'ssi')
これにより、手順3で作成されたカスタマイズが削除され、サービス・インスタンスが手順2の状態に戻ります。