Oracle Analytics Cloudスナップショットの使用した移行

ダウンロードおよびアップロード機能を使用すると、スナップショットをローカル・ファイル・システムに保存したり、クラウドにアップロードできます。これらの機能を使用して、2つの異なるサービス間でコンテンツを移行し、開発環境、テスト環境および本番環境間で移行し、Oracle Cloud Infrastructure ClassicにデプロイされたサービスをOracle Cloud Infrastructureに移行します。

トピック:

Oracle Analytics Cloud移行について

スナップショットを使用して、あるOracle Analytics Cloud環境から別のOracle Analytics Cloud環境にコンテンツや設定を簡単に移行できます。すべてのものを移行したり、特定タイプのコンテンツを移行できます。

移行の前提条件

スナップショットを使用してユーザー・コンテンツを移行する前に、ソース環境とターゲット環境を検証します。

ソース環境とターゲット環境の両方でOracle Analytics Cloud 5.1.x以上を使用する必要があります。以前のバージョンから取得したスナップショットでは、環境全体は取得されません。

不明な場合は、Oracle担当者に確認してください。
ターゲット・サービスをまだ作成していない場合は、Oracle Cloud Infrastructureで作成します。

「Oracle Cloud Infrastructure (Gen 2)でのOracle Analytics Cloudの管理」の「Oracle Analytics Cloudでサービスを作成」を参照してください。
ファイルベースのデータを移行する場合は、ソース環境とターゲット環境が稼働していること、および有効なストレージ資格証明で構成されていることを確認してください。

ストレージ・アクセスの問題は、スナップショットを使用したデータファイルの移行を防止できます。そのような場合は、データ移行ユーティリティを使用して、別々にデータ・ファイルをダウンロードしてからアップロードできます。

移行されない項目

一部のOracle Analytics Cloudアーティファクトはスナップショットに含まれていません。 Oracle Analytics Cloud以外のアーティファクトも含まれていません。

移行されない項目	詳細情報
ウイルス・スキャナ構成	ソース環境で使用されているウィルス・スキャナ構成を記録し、同じ情報を使用してウィルス・スキャナをターゲット環境に構成します。「ウイルス・スキャナの構成」を参照してください。
メール・サーバー構成	ソース環境で使用されているSMTPメール・サーバー構成を記録し、その情報を使用してメール・サーバーをターゲットに構成します。「レポートを配信するためのメール・サーバーの設定」を参照してください。
ソース環境のその他の保存済スナップショット	必要に応じて、移行する個々のスナップショットをダウンロードし、ターゲットにアップロードします。「スナップショットのインポート」を参照してください。
ユーザー(およびグループ)	Oracle Cloud Infrastructure Identity and Access Management (IAM)アイデンティティ・ドメインからの移行 Oracle Cloud Infrastructureコンソールのエクスポートおよびインポート機能を使用して、アイデンティティ・ドメイン間でユーザーおよびロールを移行します。 Oracle Cloud Infrastructureドキュメンテーションの「データの転送中」を参照してください。 Oracle Identity Cloud Serviceからの移行 Oracle Identity Cloud Serviceコンソールのエクスポートおよびインポート機能を使用して、アイデンティティ・ドメイン間でユーザーおよびロールを移行します。「Oracle Identity Cloud Serviceユーザーの管理」と「Oracle Identity Cloud Serviceグループの管理」を参照してください。埋込みWebLogic LDAPサーバーから移行スクリプト`wls_ldap_csv_exporter`を使用して、ユーザーおよびグループを、ターゲットOracle Identity Cloud Serviceにインポート可能なCSVファイルにエクスポートします。「組込みWebLogic LDAPサーバーからのユーザーおよびグループのエクスポート」を参照してください。
アイデンティティ管理構成	ターゲット環境でOracle Cloud Infrastructureコンソールを使用して、ソースで構成したユーザー(またはグループ)アプリケーション・ロール割当てを再構成し、シングル・サインオン(SSO)を再構成します。
ネットワーク構成	必要に応じて、ターゲット環境でネットワーク要件を設定します。

移行する一般的なワークフローOracle Analytics Cloud

スナップショットを使用してOracle Analytics Cloudを別の環境に移行します。実行する必要があることを次に示します。

タスク	説明	詳細情報
スナップショットを使用した移行方法の理解	スナップショット内の移行可能なものと移行できないもの、および前提条件について理解します。	Oracle Analytics Cloud移行について
ターゲット・サービスの作成	Oracle Cloud Infrastructureコンソールを使用して、新しいサービスをOracle Cloud Infrastructureにデプロイします。	Oracle Analytics Cloudでサービスを作成
ユーザーとグループの移行	Oracle Cloud Infrastructureコンソールのエクスポートおよびインポート機能を使用して、アイデンティティ・ドメイン間でユーザーおよびロールを移行します。 Oracle Analytics Cloudのユーザーの移行方法は、アイデンティティ・ドメインがクラウド・アカウントで使用可能かどうかによって異なります。不明な場合は、「ユーザーとグループの設定について」を参照してください。アイデンティティ管理に埋込みWebLogic LDAPサーバーが使用されているソース・システムの場合は、`wls_ldap_csv_exporter`スクリプトを使用して、ユーザーおよびグループをCSVファイルにエクスポートします。	データの転送(IAMユーザー) Oracle Identity Cloud Serviceユーザーの管理組込みWebLogic LDAPサーバーからのユーザーおよびグループのエクスポート
ソースでのスナップショットの取得	ソース・システムで移行するコンテンツを取得します。	スナップショットの作成
スナップショットのエクスポート	ローカル・ファイル・システムまたはOracle Cloud Infrastructureのストレージ・バケットに移行するスナップショットをダウンロードします。	スナップショットのエクスポート
スナップショットをターゲットにアップロード	ターゲット・システムにサインインし、スナップショットをアップロードします。	スナップショットのインポート
スナップショット・コンテンツのリストア	保存済スナップショットのリストで新しくアップロードされたスナップショットを選択し、スナップショットの内容をリストアします。	スナップショットからのリストア
データ・ファイルの移行	データ移行ユーティリティを使用して、データ・ファイルを環境間で移行します。次の場合のみ必要です: 別のリージョンに移行する。 Gen 1またはOracle Cloud Infrastructure ClassicのOracle Analytics Cloudから、Gen 2のOracle Analytics Cloudに移行します。復元プロセスが、ネットワーク接続またはストレージ・アクセスの問題により失敗した。	ファイルベース・データの移行
ウイルス・スキャナの再構成	ウイルス・スキャナ構成をソース環境に記録し、ターゲットにウイルス・スキャナを構成するために使用します。	ウィルス・スキャナの構成
メール・サーバーの再構成	ソース環境でSMTPメール・サーバー構成を記録し、ターゲットでメール・サーバーを構成するために使用します。	レポート配信のためのメール・サーバーの設定
(オプション)他のスナップショットを移行	移行する個々のスナップショットをダウンロードして、必要に応じてターゲット環境にアップロードします。	スナップショットのエクスポートスナップショットのインポート
アイデンティティ管理構成の移行	ターゲット環境でOracle Cloud Infrastructureコンソールを使用して、ソースで構成したユーザー(またはグループ)アプリケーション・ロール割当てを再構成し、シングル・サインオン(SSO)を再構成します。

ファイルベース・データの移行

ユーザーは、スプレッドシートなどのデータ・ファイルをOracle Analytics Cloudにアップロードしてデータセットを作成します。新しいOracle Analytics Cloud環境に移行する場合、このファイルベースのデータを使用できます。では、ネットワークの接続性やストレージ・アクセスの問題により、スナップショット内のデータファイルを移行できない場合があります。このような場合、 Oracle Analytics Cloudには、データファイルを新しいロケーションに移動できるCLIユーティリティ(コマンドライン・インタフェース)が用意されています。スナップショットCLIユーティリティで、データ・ビジュアライゼーション用にユーザーがアップロードする可能性のあるマップ関連のプラグインおよび拡張ファイルも移行されます。

データファイルを含むスナップショットをリストアしようとしたときに、メッセージRestore succeeded with errors - data restore failed (または同様)が表示された場合は、データ移行CLIユーティリティを実行します。これは、次の場合に発生します:

コンテンツを別のリージョンから移行する。
Gen 1またはOracle Cloud Infrastructure ClassicのOracle Analytics CloudからGen 2のOracle Analytics Cloudにコンテンツを移行します。
復元プロセスが、一部のその他のネットワーク接続またはストレージ・アクセスの問題により失敗した。

CLIユーティリティを使用すると、1回のステップでデータ・ファイルを環境間で移行できます。または、ファイルベースのデータをZIPファイルにダウンロードし、選択した環境に2つの異なるステップでデータ・ファイルをアップロードすることもできます。

環境詳細を確認します。
- ソース・システムとターゲット・システムの両方でOracle Analytics Cloud 5.3以上が使用されていることを確認します。以前のバージョンではCLIユーティリティを使用できません。
  
  不明な場合は、Oracle担当者に確認してください。
- ソースとターゲットのシステムが両方とも稼働していること、およびOracle Analytics Cloudが有効なストレージ資格証明を使用して構成されていることを確認してください。
- ローカル環境を確認してください。 CLIユーティリティを実行するには、Java 1.8以上が必要です。
- CLIユーティリティを実行する予定のローカル環境からソース環境およびターゲットOracle Analytics Cloudにアクセスできることを確認します。
- ファイルベースのデータが含まれている、以前にダウンロードしたスナップショットの名前および場所を確認します。たとえば、/tmp/20190307095216.barです。
CLIユーティリティをダウンロードします。
1. ターゲットOracle Analytics Cloudで、コンソールをクリックして、「スナップショット」をクリックします。
2. 「ページ」メニューをクリックし、「データ移行ユーティリティのダウンロード」を選択します。
  指示に従って、migrate-oac-data.zipファイルをローカルに保存します。
migrate-oac-data.zipを解凍します。
ZIPファイルには次の3つのファイルが含まれます:
- migrate-oac-data.jar
- config.properties
- readme

ソース環境に格納されているデータファイルを単一のステップのターゲットに直接移行する場合は、セクション[MigrateData]をconfig.propertiesで構成します。

[MigrateData]
# Migrate data files from a source Oracle Analytics Cloud environment (OAC) to a target Oracle Analytics Cloud environment.
    # Specify the source environment as Oracle Analytics Cloud.
      SOURCE_ENVIRONMENT=OAC
    # Source Oracle Analytics Cloud URL. For example: https://sourcehost.com:443 or http://sourcehost.com:9704
      SOURCE_URL=http(s)://<Source Oracle Analytics Cloud Host>:<Source Port>

    # Name of a user with Administrator permissions in the source environment. For example: SourceAdmin
      SOURCE_USERNAME=<Source Administrator User Name>
    # Location of the source snapshot (.bar file). For example:  /tmp/20190307095216.bar
      BAR_PATH=<Path to Source Snapshot>
    # Target Oracle Analytics Cloud URL. For example: https://targethost.com:443 or http://targethost.com:9704
      TARGET_URL=http(s)://<Target Oracle Analytics Cloud Host>:<Target Port>
    # Name of a user with Administrator permissions in the target environment. For example: TargetAdmin
      TARGET_USERNAME=<Target Administrator User Name>

ソースOracle Analytics Cloudからローカル環境にデータ・ファイルを最初にダウンロードし、その後、データ・ファイルをターゲットOracle Analytics Cloud環境にアップロードする場合は、config.propertiesのセクション[DownloadDataFiles]および[UploadDataFiles]を構成します。

[DownloadDataFiles]
#Download Data Files: Download data files from Oracle Analytics Cloud storage to a local repository
    # Specify the source environment as Oracle Analytics Cloud.
      SOURCE_ENVIRONMENT=OAC
    # Source Oracle Analytics Cloud URL. For example: https://sourcehost.com:443 or http://sourcehost.com:9704
      SOURCE_URL=http(s)://<Source Oracle Analytics Cloud Host>:<Source Port>

    # Name of a user with Administrator permissions in the source environment. For example: SourceAdmin
      SOURCE_USERNAME=<Source Administrator User Name>
    # Location of the source snapshot (.bar file). For example:  /tmp/20190307095216.bar
      BAR_PATH=<Path to Source Snapshot>
    # Local data file directory. Make sure you have enough space to download the data files to this directory. For example: /tmp/mydatafiledir 
      DATA_FRAGMENTS_DIRECTORY=<Data Files Directory>
     # Data fragment size. Data files are downloaded in fragments. Default fragment size is 500MB.
      MAX_DATA_FRAGMENT_SIZE_IN_MB=500

[UploadDataFiles]
#Upload data files: Upload data files to the target Oracle Analytics Cloud. 
    # Target Oracle Analytics Cloud URL. For example: https://targethost.com:443 or http://targethost.com:9704
      TARGET_URL=http(s)://<Target Oracle Analytics Cloud Host>:<Target Port>
    # Name of a user with Administrator permissions in the target environment. For example: TargetAdmin
      TARGET_USERNAME=<Target Administrator User Name>
    # Local directory containing the data files you want to upload. For example: /tmp/mydatafiledir
      DATA_FRAGMENTS_DIRECTORY=<Data Files Directory>
    # Location of the source snapshot (.bar file). For example:  /tmp/20190307095216.bar
      BAR_PATH=<Path to Source Snapshot>

ローカル環境でmigrate-oac-data.jarファイルを実行します。
構文:
```
migrate-oac-data.jar [-config configfile] [-d] [-help] [-m]  [-u]
```
説明:
- -config configfile : config.propertiesファイルの名前
- -d : config.propertiesの情報を使用したデータのローカル・ダウンロード
- -help : ヘルプを表示
- -m : config.propertiesファイル内のソースおよびターゲット情報を使用してデータを移行
- -u : config.propertiesファイルの情報を使用してデータをアップロード
たとえば、1回のステップでデータファイルを移行するには:
```
java -jar migrate-oac-data.jar -m -config config.properties
```
たとえば、データ・ファイルをローカルでダウンロードするには、次の手順に従います:
```
java -jar migrate-oac-data.jar -d -config config.properties
```
たとえば、データ・ファイルをアップロードするには、次のようにします:
```
java -jar migrate-oac-data.jar -u -config config.properties
```
ターゲットOracle Analytics Cloudにサインインします。
Oracle Analytics Cloudでデータファイルを公開するには、残りのコンテンツの移行に使用したスナップショットを再度リストアする必要があります。今回は、「カスタム」リストア・オプションを選択する必要があります。
1. コンソールを開き、「スナップショット」をクリックします。
2. データ・ファイルを含むスナップショットを選択します。
3. 「カスタム」リストア・オプションを選択し、「ファイルベースのデータ」オプションを選択します。
  その他のすべてのオプションの選択を解除します。
4. 「リストア」をクリックします。
データ・ファイルが使用可能であることを確認します。