移行ユーティリティを使用したアプリケーションの移行

Essbaseサービス管理者として、移行ユーティリティ(migrationTools.jar)を使用して、1つのクラウド・インスタンスから別のクラウド・インスタンスにEssbaseインスタンス全体(アプリケーション、ユーザーとグループ、およびその他のアーティファクト)を移行できます。

移行ユーティリティを使用して、ソース・アプリケーションおよび要素をOCI上のEssbaseデプロイメントからマーケットプレイス経由で移行できます。ユーティリティにより、一度に複数のアプリケーションが移行されます。また、アーティファクト、ルール、ユーザーおよびグループも移行されます。

Essbaseコマンドライン・インタフェース(CLI)のコマンドlcmimportおよびlcmexportでは、ユーザーおよびグループは移行されない点に注意してください。

移行ユーティリティを使用する前、前提条件について、SSL証明書の設定を参照してください。

移行ユーティリティのユース・ケース

移行ユーティリティを使用した移行に関するユースケースを次に示します。

  • ソースのWebLogic LDAPからターゲットのOCI Identity and Access Management (IAM)またはOracle Identity Cloud Service (IDCS)にEssbaseユーザーを移行します。
  • カスタマイズされていない基本的なデプロイメントには、移行ユーティリティを使用します。デプロイメントにカスタマイズ(カスタムの単一サインオン・ソリューションなど)が含まれる場合は、移行ユーティリティではなくCLIを使用します。
  • ソースEssbaseのデプロイメント元
    • OCI Identity and Access Management (IAM)またはOracle Identity Cloud Service (IDCS)を使用したOracle Cloud Infrastructure上のEssbaseマーケットプレイス、または
    • Essbase Marketplace - Oracle Cloud Infrastructure上にあり、組込みLDAPを使用している
    次に、次に示す移行ユーティリティのステップを使用してエクスポートする前に、機密アイデンティティ・アプリケーションの作成の概説に従って、新しい機密アプリケーションを作成してください。また、移行ユーティリティを使用してインポートする前に、import.propertiesでホストおよびIAMまたはIDCSの詳細を変更し、ターゲットEssbaseインスタンスを指すことを確認します。

移行ユーティリティを使用してクラウド・アプリケーションとユーザーを移行するステップ

  1. 移行ユーティリティを使用する前に、まだ行っていない場合は、ソースEssbaseインスタンスにパッチの適用して最新バージョンにします。

  2. Java SE Development Kit (JDK) 8がまだインストールされていない場合は、Oracle Technology Networkからダウンロードしてインストールします。

  3. JDKインストール・フォルダを指すようにシステムのJAVA_HOME環境変数名を設定します。インストール・パスで空白が含まれている場合、"C:\Program Files\Java\jdk1.8.0_171"など、変数値内のパスは引用符で囲みます。

  4. ターゲットEssbase Webインタフェースにサインインし、「コンソール」に移動します。

  5. コンソールで「デスクトップ・ツール」に移動し、「コマンドライン・ツール」を展開します。

  6. 「移行ユーティリティ」の横にある「ダウンロード」をクリックします。

  7. 移行ユーティリティのzipファイルをローカル・ドライブにダウンロードします。最良の結果を得るには、C:\Oracleなど、スペースを含まないパスを選択します。

  8. migrationToolsフォルダで、zipファイルを解凍し、解凍されたファイル(プロパティ、jarおよびreadme)を確認します。

  9. 移行ユーティリティのエクスポートを実行する前に、ユーティリティと同じディレクトリにあるexport.propertiesファイルを編集します。移行元のEssbaseソース・インスタンスの詳細を指定します。

    プロパティのエクスポート 説明
    userName 必須フィールドです。Essbase管理者のユーザー名。
    パスワード 必須フィールドです。Essbase管理者のパスワード。
    ホスト 必須フィールドです。ロード・バランサのIPアドレス(Essbaseのデプロイメント中にロード・バランサが構成されている場合)。それ以外の場合は、EssbaseパブリックIPアドレスに対応するホスト名またはIPアドレス。
    ポート オプションです。ソースEssbaseインスタンスのHTTPリスニング・ポート。ソースインスタンスがセキュア(TLS)モードで構成されており、isTLS=trueポート 443が想定される場合。ソース・インスタンスがLDAPアイデンティティ・プロバイダで構成されている場合は、ポートを80に設定します。
    isTLS オプション: trueまたは false。trueの場合、ソース・インスタンスは、指定されたport値を使用してセキュア(TLS)モードで構成されます。
    プロキシ オプションです。HTTPプロキシ・ホスト・アドレス(ソースEssbaseインスタンスへの接続にプロキシが必要な場合)。プロキシホストとプロキシポートはコロンで区切ります。プロキシポートを省略すると、その値は80と見なされます。ポートを省略した例: www-proxy-example.com。ポートを含む例: www-proxy-example.com:80
    データをスキップ オプションです。デフォルトはfalseです。Essbaseアプリケーションのスキーマのみをエクスポートする場合は、trueに設定します。
    スキップユーザー オプション: trueまたは false。ユーザーまたはグループ(あるいはその両方)をエクスポートする必要がない場合にのみtrueに設定します。デフォルト値はfalseです。
    IDCSホスト Marketplaceを介してOCIにデプロイされたインスタンスからユーザーまたはグループ(あるいはその両方)を移行する場合にのみ必要です。IAMまたはIDCSのソース・アイデンティティ・ドメイン・ホスト。アイデンティティ・ドメインのURL (例: https://idcs-<string_of_numbers_and_letters>.identity.oraclecloud.com))から、文字列の後にドメイン・パートのみを抽出します。例: identity.oraclecloud.com
    idcsTenant Marketplace経由でOCIにデプロイされたインスタンスからユーザーまたはグループ(あるいはその両方)を移行する場合にのみ必要です。IAMまたはIDCSのソース・ホストのアイデンティティ・ドメイン・テナンシ識別子。アイデンティティ・ドメインのURL (例: https://idcs-<string_of_numbers_and_letters>.identity.oraclecloud.com))から、idcs-<string_of_numbers_and_letters>のみを抽出します。
    クライアントID Marketplace経由でOCIにデプロイされたインスタンスからユーザーまたはグループ(あるいはその両方)を移行する場合にのみ必要です。統合された機密アイデンティティ・アプリケーションで検出された、OAuth認可のソース・ホストのクライアント識別子。
    clientSecret Marketplace経由でOCIにデプロイされたインスタンスからユーザーまたはグループ(あるいはその両方)を移行する場合にのみ必要です。OAuth認可のソース・ホストのクライアント・シークレットは、統合機密アイデンティティ・アプリケーションにあります。
    appId Marketplace経由でOCIにデプロイされたインスタンスからユーザーまたはグループ(あるいはその両方)を移行する場合にのみ必要です。OCIアイデンティティ・ドメイン上の統合機密アイデンティティ・アプリケーションの識別子(IAMまたはIDCS)。このアイデンティティ・アプリケーションは、ユーザーおよびグループに付与可能なアプリケーション・ロールで構成する必要があります。このプロパティにより、移行されたユーザーおよびグループにロールを付与できます。

  10. ユーティリティーと同じディレクトリにある import.propertiesファイルを編集します。移行先のEssbaseターゲット・インスタンスの詳細を指定します。

    プロパティのインポート 説明
    userName 必須フィールドです。ターゲット・インスタンスのEssbase管理者ユーザー名。
    パスワード 必須フィールドです。ターゲット・インスタンスのEssbase管理者パスワード。
    ホスト 必須フィールドです。Essbaseのデプロイメント中にロード・バランサが構成されている場合、ロード・バランサのターゲット・インスタンスのIPアドレス。それ以外の場合は、EssbaseパブリックIPアドレスに対応するホスト名またはIPアドレス。
    ポート オプションです。ターゲットEssbaseインスタンスのHTTPリスニング・ポート。ターゲットインスタンスがセキュア(TLS)モードで構成されており、isTLS=trueポート 443が想定される場合。ソース・インスタンスがLDAPアイデンティティ・プロバイダで構成されている場合は、ポートを80に設定します。
    isTLS オプション: trueまたは false。trueの場合、ターゲット・インスタンスは、指定されたport値を使用してセキュア(TLS)モードで構成されます。
    userPassword オプションです。ユーティリティがIAMまたはIDCSの統合アイデンティティ・アプリケーションに移行する新規ユーザーに割り当てられる初期パスワード。移行後にパスワードを変更するには、OCIコンソールを使用します。
    プロキシ オプションです。HTTPプロキシ・ホスト・アドレス(ターゲットEssbaseインスタンスへの接続にプロキシが必要な場合)。プロキシホストとプロキシポートはコロンで区切ります。プロキシポートを省略すると、その値は80と見なされます。ポートを省略した例: www-proxy-example.com。ポートを含む例: www-proxy-example.com:80
    スキップユーザー オプション: trueまたは false。ユーザーまたはグループ(あるいはその両方)をインポートする必要がない場合にのみtrueに設定します。デフォルト値はfalseです。
    IDCSホスト Marketplaceを介してOCIにデプロイされたインスタンスにユーザーまたはグループ(あるいはその両方)を移行する場合にのみ必要です。ターゲット・アイデンティティ・ドメイン・ホスト。アイデンティティ・ドメインのURL (例: https://idcs-<string_of_numbers_and_letters>.identity.oraclecloud.com))から、文字列の後にドメイン・パートのみを抽出します。例: identity.oraclecloud.com
    idcsTenant Marketplaceを介してOCIにデプロイされたインスタンスにユーザーまたはグループ(あるいはその両方)を移行する場合にのみ必要です。ターゲット・ホストのアイデンティティ・ドメイン・テナンシ識別子。アイデンティティ・ドメインのURL (例: https://idcs-<string_of_numbers_and_letters>.identity.oraclecloud.com))から、idcs-<string_of_numbers_and_letters>のみを抽出します。
    クライアントID Marketplaceを介してOCIにデプロイされたインスタンスにユーザーまたはグループ(あるいはその両方)を移行する場合にのみ必要です。統合された機密アイデンティティ・アプリケーションで検出された、OAuth認可のターゲット・ホストのクライアント識別子。
    clientSecret Marketplaceを介してOCIにデプロイされたインスタンスにユーザーまたはグループ(あるいはその両方)を移行する場合にのみ必要です。統合された機密アイデンティティ・アプリケーションで検出された、OAuth認可のターゲット・ホストのクライアント・シークレット。
    appId Marketplaceを介してOCIにデプロイされたインスタンスにユーザーまたはグループ(あるいはその両方)を移行する場合にのみ必要です。OCIアイデンティティ・ドメイン上の統合機密アイデンティティ・アプリケーションの識別子(IAMまたはIDCS)。このアイデンティティ・アプリケーションは、ユーザーおよびグループに付与可能なアプリケーション・ロールで構成する必要があります。このプロパティにより、移行されたユーザーおよびグループにロールを付与できます。
    overwrite オプションです。インポートするアプリケーションがターゲットにすでに存在し、それらを上書きする場合は、trueに設定します。デフォルト値はfalseです。
    証明書 オプションです。すべてのTLS/SSLサーバーのすべての信頼証明書ファイルへのフルパス。Windowsの場合は、バックスラッシュを別のバックスラッシュでエスケープします。例: C:\\migrationTools\\all_certs.pem

  11. exportコマンドを使用してJavaで移行ユーティリティを実行し、すべてのアプリケーション、ユーザーおよびグループをEssbaseソース・インスタンス・カタログから圧縮ファイルにエクスポートします。 

    java -jar -Dhttps.proxyHost=<proxy-url> -Dhttps.proxyPort=<nn> migrationTools.jar export export.properties <new_tar_file>

    次に例を示します:

    java –jar -Dhttps.proxyHost=www-proxy-abcdef.example.com -Dhttps.proxyPort=80 migrationTools.jar export export.properties export.tar.gz

  12. インポート・コマンドを使用してJavaで移行ユーティリティを実行し、圧縮ファイルをターゲット・インスタンスにインポートします。

    java -jar -Dhttps.proxyHost=<proxy-url> -Dhttps.proxyPort=<nn> migrationTools.jar import import.properties <existing_tar_file>

  13. インポートを実行すると、データはターゲット・インスタンスのEssbaseカタログに移行されます。