プライマリ・コンテンツに移動
Oracle® Fusion Middleware Oracle Business Intelligence Enterprise Editionシステム管理者ガイド
12c (12.2.1.2.0)
E85890-01
目次へ移動
目次

前
前へ
次
次へ

サービス・インスタンスの管理

サービス・インスタンスには、すべてのOracle Business Intelligenceメタデータ(つまり、リポジトリ・データ、プレゼンテーション・カタログ、セキュリティ・ポリシー)が含まれ、メタデータに行うカスタマイズが含まれます。次の表で説明されているWebLogic Scripting Tool (WLST)コマンドを使用してBIドメインのサービス・インスタンスを管理します。

「WLST (WebLogic Scripting Tool)の使用」を参照してください。

コマンド 説明

listBIServiceInstances

このコマンドは、BIドメインのすべてのサービス・インスタンス・キーを示します。

getBIServiceInstance

このコマンドは、特定のサービス・インスタンス・キーのサービス・インスタンスの詳細を取得します。

scaleOutBIServiceInstance

このコマンドは、新しいコンピュータにサービス・インスタンスをスケールアウトし、サービス・インスタンスがBIドメイン内の指定されたコンピュータで使用できることを確認します。このコマンドは、拡張した場合のみ使用されます。

exportServiceInstance

このコマンドは、BARファイル形式でサービス・インスタンスを特定のエクスポート・ディレクトリにエクスポートします。

importServiceInstance

このコマンドは、カスタマイズとしてすでにエクスポートされたバー(サービス・インスタンス)を特定の環境にインポートします。

refreshServiceInstance

このコマンドは、BIドメインから継承されるサービス・インスタンスのserviceKeyの一部の側面をリフレッシュします。たとえば、新しいモジュールまたは製品がBIドメインに追加されると、サービス・インスタンスがリフレッシュされる場合にそのモジュールまたは製品の権限セットのみをサービス・インスタンスで使用できます。

refreshDomainServiceInstances

このコマンドは、ドメインのすべてのサービス・インスタンスをリフレッシュします。

resetServiceInstance

このコマンドは、特定のサービス・インスタンスを空の状態にリセットします。空のBARファイルのインポートと同等です。

パラメータ 説明

domainHome

BIドメイン・ホームへのパス。

/oraclehome/user_projects/domains/bi

serviceInstanceKey

関連付けるかスケール・アウトするサービス・インスタンスのキー。

例:

mycompany.facility

machine

スケール・アウトするコンピュータの名前。

例:

machine=mycompany.example.com

port

スケール・アウトしたコンピュータで使用するポート番号。

例:

port=9768

monitorPort

スケール・アウトしたコンピュータで使用するモニター・ポートの名前。

例:

portMonitor=9502

BIサービス・インスタンスおよびBARファイルに対するすべてのWLSTコマンドの前提:

listBIServiceInstances

このコマンドでは、すべてのサービス・インスタンスをリストできます。

  1. WLSTコマンドライン・スクリプティング・ツールを起動します。

    「WLST (WebLogic Scripting Tool)の使用」を参照してください。

  2. 次のようにコマンドを入力します。

    listBIServiceInstances(domainHome)

    domainHomeはBIドメイン・ホームのパスです。

    例:

    listBIServiceInstances('/oraclehome/user_projects/domains/bi')
    
  3. コマンドは、サービス・インスタンス・キーのリストを返します

    「getBIServiceInstance」を参照してください。

getBIServiceInstance

このコマンドは、サービス・インスタンス詳細を表示します。

情報の一部を次に示します。

  • メタデータ構成: アプリケーションの関連付けおよびカスタマイズ。

  • コンポーネントの詳細。

  • 説明。

  1. 次のコマンドを入力して、指定されたサービス・インスタンス詳細をフェッチします。

    getBIServiceInstance(domainHome, serviceInstanceKey)

    例:

    getBIServiceInstance('/oraclehome/user_projects/domains/bi', 'mycompany.facility')
    
  2. コマンドは、詳細の一部を含むサービス・インスタンス・オブジェクトを返します。
    • サービス・インスタンス・キー。

    • 説明。

    • コンポーネントのリスト。

    • アプリケーション・モジュールの一覧表示。

scaleOutBIServiceInstance

このコマンドは、サービス・インスタンスを新しいコンピュータにスケールアウトして、ドメインでサービス・インスタンスを使用できるようにします。

可用性が増えた後にサービス・インスタンスが作成される場合、このコマンドを使用します。「Oracle Business Intelligenceの可用性の管理(水平方向のスケーリング)」を参照してください。

scaleOutBIServiceInstance(domainHome, serviceInstanceKey, machine, port=None, portMonitor=None)

このコマンドは、詳細を含むサービス・インスタンス・オブジェクトを返します。

前提条件:

  • 指定しないかぎり、すべてのポートがデフォルトのBIポート範囲から割り当てられます。

  • クラスタ・コントローラ、スケジューラおよびBIサーバー・マスターが変更されていません。

  • 新しいコンポーネントを起動する必要があります。オフラインにする場合、管理サーバーとノード・マネージャを最初に起動する必要があります。「ドメインのOracle Business Intelligenceコンポーネント・プロセスの起動」を参照してください。

次の表に、このコマンドのパラメータを示します。

パラメータ 説明

domainHome

BIドメイン・ホームへのパス。

serviceInstanceKey

スケール・アウトするサービス・インスタンスのキー。

machine

サービス・インスタンスをスケール・アウトするコンピュータの名前。

次に例を示します。

scaleOutBIServiceInstance('/oraclehome/user_projects/domains/bi','mycompany.facility', 'example.com')

事後状態:

  • 新しいコンポーネントが作成されます。

  • 新しいポートが割り当てられます。

  • 新しいサービス・インスタンスが登録されます。

exportServiceInstance

このコマンドは、BARファイルとしてサービス・インスタンスを指定されたエクスポート・ディレクトリにエクスポートします。

次に、別の環境または同じ環境にBARファイルをインポートできます。これらのオプション・パラメータの詳細は、次の表に示されています。

exportServiceInstance(domainHome serviceInstanceKey workDir, exportDir, applicationModuleName, applicationModuleDesc, applicationModuleVersion, includeCatalogRuntimeInfo, includeCredentials)

パラメータ 説明

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') 

importServiceInstance

このコマンドは、指定されたBARファイルからターゲット・サービス・インスタンスにBIメタデータをインポートします。

importServiceInstance(domainHome, serviceInstanceKey, barLocation, importRpd, importWebcat, importJazn, includeCredentials)

次の表に、このコマンドのパラメータを示します。

パラメータ 説明

domainHome

BIドメイン・ホームへのパス。

serviceInstanceKey

サービス・インスタンスのキー。

barLocation

インポートされたサービス・インスタンス・バーの絶対パス。

importRpd

オプション - このパラメータの値はtrueまたはfalseに設定できます。デフォルト値は'true'です。このパラメータはメタデータの選択インポートをサポートします。このフラグが'false'に設定されている場合、コマンド実行はリポジトリ・メタデータをインポートしません。

importWebcat

オプション - このパラメータの値はtrueまたはfalseに設定できます。デフォルト値は'true'です。このパラメータはカタログの選択インポートをサポートします。このフラグがfalseである場合、コマンドはカタログをインポートしません。

importJazn

オプション - このパラメータの値はtrueまたはfalseに設定できます。デフォルト値は'true'です。このパラメータはJaznの選択インポートをサポートします。このフラグがfalseである場合、コマンドはJaznをインポートしません。

includeCredentials

オプション - このパスワードを使用して、インポートされたrpdコンテンツを復号化します。

次に例を示します。

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')

注意:

12.2.1.2.0 BARファイルを、12.2.1.1.0や12.2.1.0.0などの以前のOracle BI EEリリースにインポートし、BARファイルに12.2.1.2.0より前のリリースでサポートされないデータセット・メタデータ(Excelスプレッドシートなど)が含まれている場合、データセット・メタデータはインポートされず、インポートされないメタデータはログにも記録されません。動作の概要は次のとおりです。
  • データセット・メタデータ(Excelスプレッドシートのsales.xlsなど)を含む上位バージョンのBARが、データセット・メタデータをサポートしない以前のOracle BI EEリリースにインポートされると、インポート・プロセスでは、新しいバージョン(リリース12.2.1.2.0以上)のインポート済BARにあるデータセット・メタデータのコンテンツがサイレントにスキップされます。

  • サービス・インスタンス・ログには、インポートされるメタデータの情報が示されます。ただし、このログには、インポート操作の一部として無視されるメタデータの情報は示されません。

refreshServiceInstance

このコマンドは、BIドメインから継承されるサービス・インスタンスの一部の側面をリフレッシュします。

たとえば、新しいモジュールまたは製品がBIドメインに追加されると、サービス・インスタンスがリフレッシュされる場合にそのモジュールまたは製品の権限セットのみをサービス・インスタンスで使用できます。

refreshServiceInstance(domainHome, serviceKey)

次の表に、このコマンドのパラメータを示します。

パラメータ 説明

domainHome

BIドメイン・ホームへのパス。

serviceKey

サービス・インスタンスのキー。サービス・インスタンスの一意の識別子です。

次に例を示します。

refreshServiceInstance('/oraclehome/user_projects/domains/bi', 'mycompany.finance')

refreshDomainServiceInstances

このコマンドは、BIドメインのすべてのサービス・インスタンスをリフレッシュします。

refreshDomainServiceInstances(domainHome)

次の表に、このコマンドのパラメータを示します。

パラメータ 説明

domainHome

BIドメイン・ホームへのパス。

次に例を示します。

refreshDomainServiceInstances('/oraclehome/user_projects/domains/bi')

resetServiceInstance

このコマンドは、特定のサービス・インスタンスのすべてのカスタマイズを削除します(空のBAR状態と同様)。

resetServiceInstance(domainHome, serviceKey)

次の表に、このコマンドのパラメータを示します。

パラメータ 説明

domainHome

BIドメイン・ホームのパス。たとえば、/oraclehome/user_projects/domains/biなどです。

serviceKey

サービス・インスタンスのキー。サービス・インスタンスの一意の識別子です。たとえば、'ssi'などです。

この例では、resetServiceInstanceコマンドを使用してカスタマイズを削除しています。

  1. 空のサービス・インスタンスを使用(空のBARファイルの使用と同じ)して、Oracle Business Intelligenceを構成します。

    注意:

    空のBARファイルは次の場所にあります。

    $BI_PRODUCT_HOME/bi/bifoundation/admin/provisioning/oracle.bi.application.empty.bar

  2. SampleAppLiteをBIドメインにデプロイし、サービス・インスタンスに関連付けます。
  3. ベースBAR上でカスタマイズを行います。
  4. resetServiceInstanceコマンドを使用します。

    次に例を示します。

    resetServiceInstance('/oraclehome/user_projects/domains/bi', 'ssi')
    

    これにより、手順3で作成されたカスタマイズが削除され、サービス・インスタンスが手順2の状態に戻ります。