Zero Downtime Migration ZDMCLIコマンドのリファレンス

D Zero Downtime Migration ZDMCLIコマンドのリファレンス

次の各トピックでは、Zero Downtime Migration ZDMCLIコマンドの使用方法およびオプションについて説明します。

add imagetype
指定した名前の新しいイメージ・タイプとそれに関連するユーザーアクションを構成します。
add useraction
指定した名前の新しいユーザーアクションとそれに関連するスクリプトおよびアクション・ファイルを構成します。
migrate database
Oracle Cloudへのデータベースの移行を実行します。
modify useraction
指定した名前でユーザーアクションの構成を変更します。
query job
指定されたジョブIDを持つスケジュール済ジョブの現在のステータスを取得します。

add imagetype

指定した名前の新しいイメージ・タイプとそれに関連するユーザーアクションを構成します。

構文

zdmcli add imagetype -imagetype image_type -basetype 
 {SOFTWARE |
         ORACLEGISOFTWARE |
         ORACLEDBSOFTWARE |
         ORACLEGGSOFTWARE |
         LINUXOS |
         CUSTOM_PLUGIN} 
 [-useractions user_action_list]

オプション

表D-1 ZDMCLI add imagetypeのオプション

オプション	説明
-imagetype image_type	作成するイメージ・タイプの名前
-basetype {SOFTWARE \| ORACLEGISOFTWARE \| ORACLEDBSOFTWARE \| ORACLEGGSOFTWARE \| LINUXOS \| CUSTOM_PLUGIN}	イメージ・タイプが作成されるベース・イメージ・タイプ
-useractions user_action_list	ユーザーアクション名のカンマ区切りリスト

ノート:

-basetype CUSTOM_PLUGIN値は、このコマンドのヘルプ出力には表示されませんが、有効な値です。

親トピック: Zero Downtime Migration ZDMCLIコマンドのリファレンス

add useraction

指定した名前の新しいユーザーアクションとそれに関連するスクリプトおよびアクション・ファイルを構成します。

構文

zdmcli add useraction -useraction user_action_name -actionscript script_name 
 [-actionfile file_name] 
 {-pre |
  -post} -optype 
 {IMPORT_IMAGE |
  ADD_WORKINGCOPY |
  DELETE_WORKINGCOPY |
  ADD_DATABASE |
  DELETE_DATABASE |
  ADD_PDB_DATABASE |
  DELETE_PDB_DATABASE |
  MOVE_DATABASE |
  MOVE_GIHOME |
  UPGRADE_DATABASE |
  UPGRADE_GIHOME |
  ADDNODE_GIHOME |
  DELETENODE_GIHOME |
  ADDNODE_DATABASE |
  DELETENODE_DATABASE |
  ADDNODE_WORKINGCOPY |
  ZDTUPGRADE_DATABASE |
  ZDTUPGRADE_DATABASE_SNAPDB |
  ZDTUPGRADE_DATABASE_DBUA |
  ZDTUPGRADE_DATABASE_SWITCHBACK |
  MIGRATE_DATABASE } 
 [-phase <operation phase>]
 [-onerror
       {ABORT |
        CONTINUE}]
 [-runscope
       {ONENODE |
        ALLNODES |
        AUTO |
        FIRSTNODEONRHPS |
        LASTNODEONRHPS |
        ALLNODESONRHPS}]

オプション

表D-2 ZDMCLI add useractionのオプション

オプション	説明
-useraction user_action_name	ユーザーアクションの名前
-actionscript script_name	実行するスクリプト・ファイル
-actionfile file_name	ユーザーアクションに関連付けられ、必要となるファイル
-pre	操作の前にユーザーアクションを実行します。
-post	操作の後にユーザーアクションを実行します。
-optype {IMPORT_IMAGE \| ADD_WORKINGCOPY \| DELETE_WORKINGCOPY \| ADD_DATABASE \| DELETE_DATABASE \| ADD_PDB_DATABASE \| DELETE_PDB_DATABASE \| MOVE_DATABASE \| MOVE_GIHOME \| UPGRADE_DATABASE \| UPGRADE_GIHOME \| ADDNODE_GIHOME \| DELETENODE_GIHOME \| ADDNODE_DATABASE \| DELETENODE_DATABASE \| ADDNODE_WORKINGCOPY \| ZDTUPGRADE_DATABASE \| ZDTUPGRADE_DATABASE_SNAPDB \| ZDTUPGRADE_DATABASE_DBUA \| ZDTUPGRADE_DATABASE_SWITCHBACK \| MIGRATE_DATABASE}	ユーザーアクションが構成される操作
-phase phase of operation	ユーザーアクションが構成される操作フェーズ
-onerror {ABORT \| CONTINUE}	実行中にユーザーアクションでエラーが発生した場合のレスポンス
-runscope {ONENODE \| ALLNODES \| AUTO \| FIRSTNODEONRHPS \| LASTNODEONRHPS \| ALLNODESONRHPS}	ユーザーアクションが実行されるサーバー。AUTOは、他のコマンド・オプションに基づいて実行範囲を選択する場合に指定します。FIRSTNODEONRHPS、LASTNODEONRHPSまたはALLNODESONRHPSは、最初のサーバー、最後のサーバーまたはすべてのサーバー上で操作を実行する際に、RHPSでユーザーアクション・スクリプトを実行する場合に指定します。

親トピック: Zero Downtime Migration ZDMCLIコマンドのリファレンス

migrate database

Oracle Cloudへのデータベースの移行を実行します。

構文

zdmcli migrate database 
 {-sourcedb db_name |
  -sourcesid source_oracle_sid} -sourcenode node_name -targetnode node_name -targethome target_home -rsp zdm_template 
  [-eval] 
  [-imagetype] 
  [-tdekeystorepasswd] 
  [-tdemasterkey] 
  [-useractiondata user_action_data] -backupuser user_name 
  [{-srcroot |
         -srccred cred_name |
         -srcuser user_name |
             {-srcsudouser sudo_user_name -srcsudopath sudo_binary_path} |
             {-srcauth plugin_name  
             [-srcarg1 name1:value1 
             [-srcarg2 name2:value2...]]}}]
  {-tgtroot |
   -tgtcred cred_name |
   -tgtuser user_name |
       {-tgtsudouser sudo_user_name -tgtsudopath sudo_binary_path} |
       {-tgtauth plugin_name 
           [-tgtarg1 name1:value1 
           [-tgtarg2 name2:value2...]]}} 
  [-schedule 
       { timer_value |
         NOW }] 
  [-pauseafter phase] 
  [-listphases] 
  [-ignoremissingpatches patch_name
       [,patch_name...]] 
  [-ignore 
       {ALL|
        WARNING|
        PATCH_CHECK}]

オプション

表D-3 ZDMCLI migrate databaseのオプション

オプション	説明
-sourcedb db_name	移行するソース・データベースの名前
-sourcenode node_name	ソース・データベースが実行されているホスト
-targetnode node_name	ソース・データベースの移行先となるターゲット・サーバー
-targethome target_home	ターゲット・データベースORACLE_HOMEの場所
-imagetype image_type	ユーザーアクション・イメージタイプの名前
-useractiondata user_action_data	ユーザーアクション・スクリプトのuseractiondataパラメータに渡される値
-rsp zdm_template	Zero Downtime Migrationのテンプレート
-sourcesid source_oracle_sid	Grid Infrastructureを使用しないソースのシングル・インスタンス・データベースのORACLE_SID
-eval	コマンドを実行せずに評価します。
-backupuser user_name	データベースのバックアップまたはリストアを許可されたユーザーの名前
-srcroot	ルート資格証明を使用してソース・データベース・サーバーにアクセスするようZero Downtime Migrationに指示します
-srccred cred_name	ソース・データベース・サーバーにアクセスするためのユーザー名およびパスワード資格証明を関連付ける資格証明名
-srcuser user_name	ソース・データベース・サーバーで操作を実行する特権ユーザーの名前
-srcsudouser username	ソース・データベース・サーバー上でsudoユーザー名としてスーパーユーザーの操作を実行します
-srcsudopath sudo_binary_path	ソース・データベース・サーバー上のsudoバイナリの場所
-srcauth plug-in_name [plug-in_args]	認証プラグインを使用して、ソース・データベース・サーバーにアクセスします
-tgtroot	ルート資格証明を使用してターゲット・データベース・サーバーにアクセスします
-tgtcred cred_name	ターゲット・データベース・サーバーにアクセスするためのユーザー名およびパスワード資格証明を関連付ける資格証明名
-tgtuser user_name	ターゲット・データベース・サーバーで操作を実行するユーザーの名前
-tgtsudouser username	ターゲット・データベース・サーバー上でsudoユーザー名としてスーパーユーザーの操作を実行します
-tgtsudopath sudo_binary_path	ターゲット・データベース・サーバー上のsudoバイナリの場所
-tgtauth plugin_name [plugin_args]	認証プラグインを使用して、ターゲット・データベース・サーバーにアクセスします
-tdekeystorepasswd	キーストア/ウォレットに基づいたパスワードに必要なTDEキーストア・パスワード
-tdemasterkey	TDEマスター暗号化キー
-schedule timer_value	操作を実行するスケジュール時間(ISO-8601形式)。例: 2016-12-21T19:13:17+05
-pauseafter phase	指定されたフェーズの実行後にジョブを一時停止します
-ignoremissingpatches	ソース・パスまたは作業用コピーに存在する指定のパッチが宛先パスまたは作業用コピーから欠落している場合でも、移動/アップグレードを続行します
-ignore {ALL\|WARNING\|PATCH_CHECK}	すべてのチェックまたは特定のタイプのチェックを無視します
-listphases	この操作のフェーズをリストします

親トピック: Zero Downtime Migration ZDMCLIコマンドのリファレンス

modify useraction

指定した名前でユーザーアクションの構成を変更します。

構文

zdmcli modify useraction -useraction user_action_name 
 [-actionscript script_name] 
 [-actionfile file_name] 
 [-pre |
  -post] 
 [-optype
        {IMPORT_IMAGE |
         ADD_WORKINGCOPY |
         DELETE_WORKINGCOPY |
         ADD_DATABASE |
         DELETE_DATABASE |
         ADD_PDB_DATABASE |
         DELETE_PDB_DATABASE |
         MOVE_DATABASE |
         MOVE_GIHOME |
         UPGRADE_DATABASE |
         UPGRADE_GIHOME |
         ADDNODE_GIHOME |
         DELETENODE_GIHOME |
         ADDNODE_DATABASE |
         DELETENODE_DATABASE |
         ADDNODE_WORKINGCOPY |
         ZDTUPGRADE_DATABASE |
         ZDTUPGRADE_DATABASE_SNAPDB |
         ZDTUPGRADE_DATABASE_DBUA |
         ZDTUPGRADE_DATABASE_SWITCHBACK |
         MIGRATE_DATABASE } ] 
 [-phase phase] 
 [-onerror 
      {ABORT |
       CONTINUE}] 
 [-runscope 
      {ONENODE |
       ALLNODES |
       AUTO |
       FIRSTNODEONRHPS |
       LASTNODEONRHPS |
       ALLNODESONRHPS]

オプション

表D-4 ZDMCLI modify useractionのオプション

オプション	説明
-useraction user_action_name	ユーザーアクションの名前
-actionscript script_name	実行するスクリプト・ファイル
-actionfile file_name	ユーザーアクションに必要な添付ファイル
-pre	操作の前にユーザーアクションを実行します。
-post	操作の後にユーザーアクションを実行します。
-optype {IMPORT_IMAGE \| ADD_WORKINGCOPY \| DELETE_WORKINGCOPY \| ADD_DATABASE \| DELETE_DATABASE \| ADD_PDB_DATABASE \| DELETE_PDB_DATABASE \| MOVE_DATABASE \| MOVE_GIHOME \| UPGRADE_DATABASE \| UPGRADE_GIHOME \| ADDNODE_GIHOME \| DELETENODE_GIHOME \| ADDNODE_DATABASE \| DELETENODE_DATABASE \| ADDNODE_WORKINGCOPY \| ZDTUPGRADE_DATABASE \| ZDTUPGRADE_DATABASE_SNAPDB \| ZDTUPGRADE_DATABASE_DBUA \| ZDTUPGRADE_DATABASE_SWITCHBACK \| MIGRATE_DATABASE}	ユーザーアクションが構成される操作
-onerror {ABORT \| CONTINUE}	実行中にユーザーアクションでエラーが発生した場合の結果
-runscope {ONENODE \| ALLNODES \| AUTO \| FIRSTNODEONRHPS \| LASTNODEONRHPS \| ALLNODESONRHPS}	ユーザーアクションが実行されるサーバー。AUTOは、他のコマンド・オプションに基づいて実行範囲を選択する場合に指定します。FIRSTNODEONRHPS、LASTNODEONRHPSまたはALLNODESONRHPSは、最初のサーバー、最後のサーバーまたはすべてのサーバー上で操作を実行する際に、RHPSでユーザーアクション・スクリプトを実行する場合に指定します。

親トピック: Zero Downtime Migration ZDMCLIコマンドのリファレンス

query job

指定されたジョブIDを持つスケジュール済ジョブの現在のステータスを取得します。

構文

zdmcli query job
 [-jobid <job_id>] 
 [-status 
     {SCHEDULED |
      EXECUTING |
      UNKNOWN |
      TERMINATED |
      FAILED |
      SUCCEEDED |
      PAUSED |
      ABORTED}] 
 [-dbname <database_name>] 
 [-since <timer_value>] 
 [-upto <timer_value>] 
 [-brief]

オプション

表D-5 ZDMCLI query jobのオプション

オプション	説明
-jobid jobid	ジョブのスケジュール時に取得される、スケジュール済ジョブの一意の整数ジョブID値
-status {SCHEDULED \| EXECUTING \| UNKNOWN \| TERMINATED \| FAILED \| SUCCEEDED \| PAUSED \| ABORTED}	ジョブを取得するジョブ・ステータス
-dbname unique_db_name	データベースの名前(DB_UNIQUE_NAME)
-since timer_value	ジョブの取得を開始する日付(ISO-8601形式)。例: 2016-12-21T19:13:17+05
-upto timer_value	ジョブを取得する上限時間(ISO-8601形式)。例: 2016-12-21T19:13:17+05
-brief	ジョブ詳細サマリーのみ

親トピック: Zero Downtime Migration ZDMCLIコマンドのリファレンス