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

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

Essbaseサービス管理者ユーザーとして、移行ユーティリティを使用してインスタンス全体(すべてのアプリケーション、ユーザーとグループ、およびその他のアーティファクト)をクラウド・インスタンス間で、単一プロセスで移行できます。Essbaseコマンドライン・インタフェース(CLI)のコマンドlcmimportおよびlcmexportでは、ユーザーおよびグループは移行されない点に注意してください。

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

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

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

移行ユーティリティを使用してクラウド・サービスのアプリケーションおよびユーザーを移行する方法

ユーティリティを使用する前に、まだ行っていない場合は、ソースEssbaseインスタンスにパッチを適用して最新バージョンにします。
Java SE Development Kit (JDK) 8がまだインストールされていない場合は、Oracle Technology Networkからダウンロードしてインストールします。
JDKインストール・フォルダを指すようにJAVA_HOME環境変数名をシステムに設定します。インストール・パスに空白が含まれる場合、"C:\Program Files\Java\jdk1.8.0_171"のように、変数値のパスを引用符で囲みます。
ターゲットEssbaseにサインインし、「コンソール」タブに移動します。
「コンソール」で、「デスクトップ・ツール,」に移動して、「コマンド・ライン・ツール」を展開します。
「移行ユーティリティ」の横にある「ダウンロード」をクリックします。
移行ユーティリティのzipファイルをローカル・ドライブにダウンロードします。最適な結果を得るためには、C:\Oracleのように、空白が含まれないパスを選択します。
zipファイルを解凍し、migrationToolsフォルダで解凍されたファイル(properties、jarおよびreadme)を確認します。
移行ユーティリティに用意されているインポートまたはエクスポートのコマンドを実行する前に、プロパティ・ファイルを編集する必要があります。
1. export.propertiesファイルのプロパティ文字列を編集します。
  - userName - Essbase管理者のユーザー名。
  - password - Essbase管理者のパスワード。
  - host - EssbaseホストまたはIPアドレス。
  - port - Essbaseのポート。LDAPソースに対して値80を入力します。それ以外の場合は、Identity Cloud Serviceソースに対してデフォルト値443 (SSL/TLS)を受け入れます。
  - proxy - プロキシ・サーバーのURL。
  - skiprole - Oracle Analytics Cloud - Essbaseからのロールのインポートがスキップされます。値を空のままにするか、trueにする必要があります。
2. import.propertiesファイルのプロパティ文字列を編集します。
  - userName - Essbase管理者のユーザー名。
  - password - Essbase管理者のパスワード。
  - host - EssbaseホストまたはIPアドレス。
  - port - Essbase HTTPリスニング・ポート。デフォルト値443 (SSL/TLS)。
  - userPassword - 新しいユーザーすべてに割り当てられる初期パスワード。
  - proxy - プロキシ・サーバーのURL (オプション)
3. import.propertiesでIdentity Cloud Serviceの情報を編集します。Oracle Identity Cloud Serviceについてサービス・コンソールからこれらの値を取得します。
  - idcsHost - Identity Cloud Serviceホスト
  - idcsTenant - Identity Cloud Serviceテナント
  - clientId - OAuth認可のクライアント識別子
  - clientSecret - OAuth認可のクライアント・シークレット
  - appId - アプリケーション識別子

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

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

例:

 e.g. java –jar -Dhttps.proxyHost=www-proxy-abcdef.example.com
      -Dhttps.proxyPort=80 migrationTools.jar import import.properties 115ldap.tar.gz

ソース・インスタンスからエクスポートしたら、次のjavaコマンドを使用してデータtarファイルをターゲット・インスタンスにインポートします。
```
java -jar -Dhttps.proxyHost=<proxy-url> -Dhttps.proxyPort=<nn>
      migrationTools.jar import import.properties <existing_tar_file>
```
インポートを実行すると、データがターゲット・インスタンスのEssbaseカタログに格納されます。エクスポートされたアプリケーションがターゲットにすでに存在する場合、上書きされません。