データの移行

移行コンポーネントおよび出力を検証するには、-evalフラグを指定してデータベースの移行コマンドを実行します。事前チェックが正常に完了したら、-evalフラグを指定せずに同じコマンドを使用して、クラウドへの移行を開始します。

事前チェックの実行

事前チェックを実行して移行プロセス・コンポーネントを検証し、出力を評価して調整が必要かどうかを判断します。

移行のたびに、まずデータベースを評価モードで実行することをお薦めします。この評価により、本番データベースで実際の移行を実行する前に、設定および構成の潜在的な問題を修正できるようになります。評価モードでは、移行プロセスが変更に影響を与えずに実行されます。実際の移行ジョブを実行する前に、-evalオプションを必要な回数だけ使用してコマンドを実行できます。

Zero Downtime Migrationサービス・ホストにログインし、zdmuserインストール・ユーザーに切り替えて、ゼロ・ダウンタイム移行ホームの/binディレクトリに変更します。
たとえば、Zero Downtime Migrationホーム・ディレクトリは/oracle/zdm/gridです。
```
su - zdmuser
zdmuser> cd /u01/app/oracle/zdm/grid/bin
```
-evalフラグを使用して、zdmcli migrate databaseコマンドを実行します。ソース・データベース、ソース・ノード、ターゲット・ノード、ターゲット・ホーム、Oracle Cloud Infrastructure Object Storageログイン・ユーザー名、レスポンス・ファイルの場所およびターゲット・データベース・サーバーのログイン・ユーザー名を定義します。
ソース・データベースを定義する場合は、-sourcedb database_unique_nameを使用します。ソースのシングル・インスタンス・データベースがGrid Infrastructureホームなしでデプロイされている場合は、-sourcedbのかわりに-sourcesid source_oracle_sidを使用します。ソースおよびターゲットのデータベース・サーバー名には、完全修飾ドメイン名(FQDN)を使用します。

ソース・データベースがPASSWORDベースのウォレット用に構成されている場合、-tdekeystorepasswdオプションをコマンドに追加し、プロンプトにソース・データベースのTDEキーストア・パスワード値を指定します。

バックアップ・ユーザーはOracle Cloud Infrastructureユーザーです。コンソールでバックアップ・ユーザー名またはIDを検索するには、「ユーザー」、「プロファイル」の順に移動します。
```
zdmuser> ./zdmcli migrate database -sourcesid source_oracle_sid \.
-sourcenode source_FQDN_database_server_name 
-srcauth zdmauth \
-srcarg1 user: opc \
-srcarg2 identity file: /home/zdmuser/.ssh/zdm_service_tool.ppk
-srcarg3 sudo_location: /usr/bin/sudo \
-targetnode target_FQDN_database_server_name \
-targethome target_database_ORACLE_HOME \  
-backupuser Object_store_login_user_name \  
-rsp response_file_location
-tgtauth zdmauth 
-tgtarg1 user:target_database_server_login_user_name 
-tgtarg2 identity_file:/home/zdmuser/.ssh/zdm_service_tool.ppk \
-tgtarg3 sudo_location:/usr/bin/sudo 
-ignore ALL -eval
```
プロンプトが表示されたら、ソース・データベースのSYSパスワードとソース・データベース・サーバーのrootユーザー・パスワードを入力します。バックアップの保存先(バケット)に、Oracle Cloud Infrastructureユーザー認証トークンを入力します。
ソース・データベースとターゲット・データベースの両方にアクセスするためのDB SYSDBAパスワード。パスワードは、両方のデータベースで同じである必要があります。ユーザー・パスワードはAUTH TOKENです。
```
Enter source database zdmsdb SYS password:
Enter source user "root" password:
Enter user "backup_user@example.com" password:
```
データベース移行ジョブを発行すると、コマンド出力にjobIDが表示されます。jobIDを保存して、ジョブ・ステータスの問合せに使用します。
(オプション) query jobコマンドを使用して、ジョブのステータスを確認します。
```
./ zdmcli query job -jobid job-id-number
```
出力ステータスを確認します。
サービス・ログは、ソース・データベースおよびターゲット・データベースで使用できます。出力に場所がリストされます。

ZDMサービスを使用したデータの移行

移行コマンドを実行して、データ移行を開始します。コマンドおよびパラメータは、-evalフラグを指定せずに事前チェックと同じです。

Zero Downtime Migrationサービス・ホストにログインし、zdmuserインストール・ユーザーに切り替えて、ゼロ・ダウンタイム移行ホームの/binディレクトリに変更します。
たとえば、Zero Downtime Migrationホーム・ディレクトリは/oracle/zdm/gridです。
```
su - zdmuser
zdmuser> cd /u01/app/oracle/zdm/grid/bin
```
zdmcli migrate databaseコマンドを実行します。ソース・データベース、ソース・ノード、ターゲット・ノード、ターゲット・ホーム、Oracle Cloud Infrastructure Object Storageログイン・ユーザー名、レスポンス・ファイルの場所およびターゲット・データベース・サーバーのログイン・ユーザー名を定義します。
ソース・データベースを定義する場合は、-sourcedb database_unique_nameを使用します。ソースのシングル・インスタンス・データベースがGrid Infrastructureホームなしでデプロイされている場合は、-sourcedbのかわりに-sourcesid source_oracle_sidを使用します。ソースおよびターゲットのデータベース・サーバー名には、完全修飾ドメイン名(FQDN)を使用します。

ソース・データベースがPASSWORDベースのウォレット用に構成されている場合、-tdekeystorepasswdオプションをコマンドに追加し、プロンプトにソース・データベースのTDEキーストア・パスワード値を指定します。

バックアップ・ユーザーはOracle Cloud Infrastructureユーザーです。コンソールでバックアップ・ユーザー名またはIDを検索するには、「ユーザー」、「プロファイル」の順に移動します。
```
zdmuser> ./zdmcli migrate database -sourceid source_db_ID \.
-sourcenode source_database_server_name 
-srcauth zdmauth \
-srcarg1 user: opc \
-srcarg2 identity file: /home/zdmuser/.ssh/zdm_service_tool.ppk
-srcarg3 sudo_location: /usr/bin/sudo \
-targetnode target_database_server_name \
-targethome target_database_ORACLE_HOME \  
-backupuser Object_store_login_user_name \  
-rsp response_file_location
-tgtauth zdmauth 
-tgtarg1 user:target_database_server_login_user_name 
-tgtarg2 identity_file:/home/zdmuser/.ssh/zdm_service_tool.ppk \
-tgtarg3 sudo_location:/usr/bin/sudo \
-ignore ALL
```
プロンプトが表示されたら、ソース・データベースのSYSパスワードとソース・データベース・サーバーのrootユーザー・パスワードを入力します。バックアップの保存先(バケット)に、Oracle Cloud Infrastructureユーザー認証トークンを入力します。
ソース・データベースとターゲット・データベースの両方にアクセスするためのDB SYSDBAパスワード。パスワードは、両方のデータベースで同じである必要があります。
```
Enter source database zdmsdb SYS password:
Enter source user "root" password:
Enter user "backup_user@example.com" password:
```
データベース移行ジョブを発行すると、コマンド出力にjobIDが表示されます。jobIDを保存して、ジョブ・ステータスを問い合せます。
(オプション) query jobコマンドを使用して、ジョブのステータスを確認します。
サービス・ログは、ソース・データベースおよびターゲット・データベースで使用できます。出力に場所がリストされます。
```
./ zdmcli query job -jobid job-id-number
```

移行のトラブルシューティング

移行ジョブでエラーが発生した場合は、移行ジョブの出力ログ、Zero Downtime Migrationサービスのログおよびそれぞれのソースまたはターゲットのデータベース・サーバーにあるサーバー固有の操作フェーズ・ログを参照してください。

移行ジョブで例外が発生した場合、ログから障害の性質がわかることがあります。ソースおよびターゲットの環境で実行された移行プロシージャのログは、それぞれのソースおよびターゲットの環境のサーバーに格納されます。ログ・ファイルの場所が移行出力およびジョブ・ステータスの問合せ時に出力に含まれます。

次の表に、移行フェーズと各フェーズ名の説明を示します。

フェーズ名	説明
ZDM_GET_SRC_INFO	ソース・データベースに関する情報を検出します
ZDM_GET_TGT_INFO	ターゲット・データベースに関する情報の検出
ZDM_SETUP_SRC	ソース・サーバーでのZDMヘルパー・モジュールの設定
ZDM_SETUP_TGT	ターゲット・サーバーでのZDMヘルパー・モジュールの設定
ZDM_PREUSERACTIONS	ソースで移行の事前ユーザー・アクションを実行します。
ZDM_PREUSERACTIONS_TGT	ターゲットで移行の事前ユーザー・アクションを実行します。
ZDM_OBC_INST_SRC	ソースでOracle Database Cloud Backupモジュールをインストールします
ZDM_OBC_INST_TGT	ターゲットでOracle Database Cloud Backupモジュールをインストールします
ZDM_GEN_RMAN_PASSWD	Oracle Recovery Manager (RMAN)バックアップを暗号化するためのランダム・パスワードを生成します
ZDM_BACKUP_FULL_SRC	ソース・データベースの全体バックアップを実行します
ZDM_BACKUP_INCREMENTAL_SRC	ソース・データベースの増分バックアップを実行します
ZDM_VALIDATE_SRC	ソースで検証を実行します
ZDM_VALIDATE_TGT	ターゲットで検証を実行します
ZDM_DISCOVER_SRC	Oracle Data Guardを設定するためにソースでデータベース検出を実行します
ZDM_COPYFILES	Oracleパスワード・ファイルおよびTransparent Data Encryption (TDE)ウォレットをソースからターゲットにコピーします
ZDM_OSS_STANDBY_SETUP_TDE_TGT	TDEウォレット・ファイルをソースからターゲットのキーストンの場所にコピーします
ZDM_PREPARE_TGT	Oracle Data Guardスタンバイを作成するためにターゲットを準備します
ZDM_CLONE_TGT	Oracle Data Guardスタンバイをクラウド・バックアップから作成します
ZDM_FINALIZE_TGT	ターゲットのOracle Data Guardスタンバイの準備を完了します
ZDM_CONFIGURE_DG_SRC	クラウド・スタンバイをソースに登録します
ZDM_SWITCHOVER_SRC	ソースでスイッチオーバー・アクションを開始します
ZDM_SWITCHOVER_TGT	ターゲットでスイッチオーバー・アクションを完了します
ZDM_POSTUSERACTIONS	ソースで移行後ユーザー・アクションを実行します
ZDM_POSTUSERACTIONS_TGT	ターゲットで移行後ユーザー・アクションを実行します
ZDM_CLEANUP_SRC	ソースでのクリーンアップの実行
ZDM_CLEANUP_TGT	ターゲットでのクリーンアップの実行
ZDM_POSTUSERACTIONS_TGT	ターゲットで移行後ユーザー・アクションを実行します

ゼロ・ダウンタイム移行サービスが開始しない場合は、プロセス起動エラーについてゼロ・ダウンタイム移行サービスのログを確認し、レポートされたエラーの原因を特定します。Zero Downtime Migrationサービスのログは、$ZDM_BASE/crsdata/zdm_service_node/rhp/rhpserver.log.0にあります。
query jobコマンドを使用して、ジョブのステータスを確認します。
サービス・ログは、ソース・データベースおよびターゲット・データベースで使用できます。出力に場所がリストされます。
```
./ zdmcli query job -jobid job-id-number
```
障害時に移行ジョブがどの操作フェーズにあったか、フェーズがソース・データベースかターゲット・データベースかを確認します。
$ZDM_BASE/crsdata/zdm_service_node/rhp/rhpserver.log.0でゼロ・ダウンタイム移行サービス・ホストのログを確認し、それぞれのソース・サーバーまたはターゲットのサーバーにアクセスして、/tmp/zdm-unique id/zdm/logディレクトリで操作フェーズに関連付けられているログを確認します。

Zero Downtime Migrationのトラブルシューティングおよび現行リリースでの既知の問題の詳細は、Zero Downtime Migrationリリース・ノートを参照してください。