Zero Downtime Migrationサービスの管理

Zero Downtime Migrationサービスの開始と停止

Zero Downtime Migrationを使用してデータベースを移行するには、Zero Downtime Migrationサービスを起動する必要があります。

次のコマンドを使用して、ユーザーzdmuserとしてZero Downtime Migrationサービスzdmserviceを開始します。

zdmuser> $ZDM_HOME/bin/zdmservice start

Zero Downtime Migrationサービスを停止する必要がある場合は、次のコマンドを実行します。

zdmuser> $ZDM_HOME/bin/zdmservice stop

Zero Downtime Migrationサービスのステータスの確認

Zero Downtime Migrationのステータスを確認して、実行中かどうか、およびその他のサービス詳細を確認します。

Zero Downtime Migrationサービスのステータスを確認するには、次のコマンドを使用します。

zdmuser> $ZDM_HOME/bin/zdmservice status
---------------------------------------
        Service Status
---------------------------------------
Running:       true
Tranferport:   5000-7000
Conn String:   jdbc:mysql://localhost:8897/
RMI port:      8895
HTTP port:     8896
Wallet path:   /u01/app/zdmbase/crsdata/fopds/security

Zero Downtime Migrationソフトウェアの更新

Zero Downtime Migrationソフトウェアがすでにホストにインストールされている場合は、それが利用可能な最新のリリースであることを常に確認する必要があります。Zero Downtime Migrationソフトウェアの更新では、既存のジョブ情報、メタデータおよびログ・ファイルを保持しながら、最新の機能と修正が提供されます。

ソフトウェア更新を開始する前に、次の要件を確認します。

Zero Downtime Migration 19cから21cへの更新は、最新のZero Downtime Migration 19cソフトウェア・キットからのみ実行できます。次のコマンドを使用して、19cソフトウェア・キットを確認します。
```
zdmuser> $ZDM_HOME/bin/zdmcli -build

full version: 19.8.0.0.0
label date: 200907
ZDM kit build date: Thu Sep 24 06:22:07 PDT 2020
```
既存のZero Downtime Migrationソフトウェアのインストール場所に15GB以上の空き領域があることを確認します。
既存のZero Downtime Migrationホーム(ZDM_HOME)およびZDM_BASEをソフトウェアのダウンロード場所にバックアップするのに十分な領域があることを確認します。
重要: 現在インストールされているZero Downtime Migrationホーム外から更新スクリプトを実行します。

Zero Downtime Migrationホーム内からスクリプトを実行すると、ホームのインストールおよびアンインストールが失敗し、サービスは一貫性のない状態のままになります。
ziplocで指定されたパスには、zdmuserに対する読取り/書込みアクセス権が必要です。
次の手順のコマンドはすべて、既存のZero Downtime Migrationソフトウェア所有者として実行する必要があります。たとえば、次の例ではzdmuserとして実行します。

Zero Downtime Migrationソフトウェア・キットをhttps://www.oracle.com/database/technologies/rac/zdm-downloads.htmlからZero Downtime Migrationサービス・ホストにダウンロードします。
Zero Downtime Migrationソフトウェアがダウンロードされるディレクトリに移動し、ソフトウェアを解凍します。
```
zdmuser> cd zdm_download_directory
zdmuser> unzip zdmversion.zip 
```
zdminstall.shスクリプトを既存のZero Downtime Migrationホーム所有者として実行し、ソフトウェアのダウンロード場所からソフトウェアを更新します。
```
zdmuser>./zdminstall.sh update oraclehome=existing_zdm_oracle_home
   ziploc=zdm_software_location –zdm
```
- zmdinstall.shは、インストールおよび更新スクリプトです。
- oraclehomeは、既存のZero Downtime MigrationソフトウェアがインストールされているOracleホームの絶対パスです
- ziplocは、Zero Downtime Migrationキットに含まれる圧縮ソフトウェア・ファイル(zip)の場所です
次に例を示します。
```
zdmuser>/u01/app/oracle/zdm/shiphome/update/zdminstall.sh update
     oraclehome=/u01/app/zdmhome
     ziploc=/u01/app/oracle/zdm/shiphome/update/zdm_home.zip -zdm
```
更新スクリプトにより、次の操作が実行されます。
1. 既存のZero Downtime Migrationホーム(ZDM_HOME)およびZDM_BASEをソフトウェアのダウンロード場所にバックアップします
2. 現在実行中のZero Downtime Migrationサービスを停止します
3. 現在インストールされているZero Downtime Migrationホームを削除します
4. 新しいバイナリをZero Downtime Migrationホームにインストールします
5. 構成データをリストアします。
新しいZero Downtime Migrationホームには、以前のZero Downtime Migrationホームで実行された移行の詳細がすべて保持されます。
Zero Downtime Migrationサービスは、アップグレード後に手動で開始する必要があります。Zero Downtime Migrationサービスをユーザーzdmuserとして開始します。
```
zdmuser> $ZDM_HOME/bin/zdmservice start
```
Zero Downtime Migrationを使用してデータベースを移行するには、zdmserviceを開始する必要があります。

Zero Downtime Migrationサービスを停止する必要がある場合は、次のコマンドを実行します。
```
zdmuser> $ZDM_HOME/bin/zdmservice stop
```

Zero Downtime Migrationサービスのインストールが正常に終了したことを確認します。

次のコマンドを実行すると、出力は次に示すようなものになります。

zdmuser> $ZDM_HOME/bin/zdmservice status
---------------------------------------
        Service Status
---------------------------------------
Running:       true
Tranferport:   5000-7000
Conn String:   jdbc:mysql://localhost:8897/
RMI port:      8895
HTTP port:     8896
Wallet path:   /u01/app/zdmbase/crsdata/fopds/security

Zero Downtime Migrationソフトウェアのアンインストール

Zero Downtime MigrationソフトウェアをZero Downtime Migrationサービス・ホストから削除します。

コマンドはすべて、zdmuserとして実行されます。

Zero Downtime Migrationサービスを停止します。
```
zdmuser> $ZDM_HOME/bin/zdmservice stop
```
次のコマンドを実行してソフトウェアをアンインストールします。
```
zdmuser> $ZDM_HOME/bin/zdmservice deinstall
```

サイレント更新またはアンインストールの実行

Zero Downtime Migrationソフトウェアの更新またはアンインストール中に確認プロンプトをスキップして、これらの操作を円滑に実行できます。

次の例に示すように、zdminstall.shのupdateまたはdeinstall操作で-silentオプションを使用すると、確認を求められないようにすることができます。

サイレント更新の例:

zdmuser> cd zdm_download_directory
zdmuser> unzip zdmversion.zip 
...
zdmuser>./zdminstall.sh update -silent oraclehome=absolute_path_to_zdm_home  
ziploc=zdm_software_location -zdm

サイレント・アンインストールの例:

zdmuser> $ZDM_HOME/bin/zdmservice deinstall -silent

クラウド移行前アドバイザ・ツールのバージョンの表示

クラウド移行前アドバイザ・ツール(CPAT)の現在のバージョンを表示するには、2つの方法があります。

--versionオプションを指定してクラウド移行前アドバイザ・ツール・スクリプトを実行します。
```
$ZDM_HOME/rhp/zdm/lib/cpat/premigration.sh --version
```
-buildオプションを指定してZDMCLIを実行します。
```
zdmuser> $ZDM_HOME/bin/zdmcli -build
```

クラウド移行前アドバイザ・ツールの更新

クラウド移行前アドバイザ・ツールを最新の状態に保ち、最新の移行処置とツールのバグ修正を入手します。

ノート:

移行が実行されていないときにクラウド移行前アドバイザ・ツールを更新するようにスケジュールします。

Cloud Premigration Advisor Tool (CPAT) Analyzes Databases for Suitability of Cloud Migration (Doc ID 2758371.1)から最新バージョンのツールをダウンロードします。
Zero Downtime Migrationホームに現在インストールされているツールのバージョンを確認します。
```
./ZDM_home/rhp/zdm/lib/cpat/premigration.sh --version
```
ディレクトリ$ZDM_HOME/rhp/zdm/lib/cpatの内容のコピーを作成して、現在インストールされているツールをバックアップします。
ディレクトリ$ZDM_HOME/rhp/zdm/lib/cpat内のすべてのファイルを削除します。
クラウド移行前アドバイザ・ツールの新しいリリース・ファイルを$ZDM_HOME/rhp/zdm/lib/cpatに解凍します。
必要に応じて、不正なアクセスを排除するために、解凍されたファイルのアクセス権を変更します。
Zero Downtime Migrationホームに新しいバージョンのツールがインストールされていることを確認します。
```
./ZDM_home/rhp/zdm/lib/cpat/premigration.sh --version
```

MySQLポートの設定

Zero DowntimeサービスがMySQLに使用するポート番号を検出および設定できます。

MySQLのデフォルトのポート番号

Zero Downtime Migrationでは、MySQLが内部的に使用され、デフォルトでポート3306に構成されます。ポート番号が指定されておらず、デフォルトが使用できない場合、Zero Downtime Migrationはポート値を1増やし、最大5回再試行します。

現在のポート番号の確認

次に示すように、zdmservice statusを実行して、接続文字列の現在のMySQLポート番号を確認します。

zdmuser> $ZDM_HOME/bin/zdmservice status

Conn String: jdbc:mysql://localhost:8897/

ポート番号の変更

zdmservice modify mysqlPort=portオプションを使用して、このデフォルトを別の値に変更できます。

zdmuser> $ZDM_HOME/bin/zdmservice modify mysqlPort=port