レプリケーション用のOracle ACFSコマンドライン・ツール

このトピックでは、Oracle ACFSスナップショットベースのレプリケーション用コマンドの概要を示します。

表16-30に、Oracle ACFSのスナップショットベースのレプリケーション・コマンドと簡単な説明を示します。Oracle ACFSレプリケーションの概要は、「Oracle ACFSレプリケーション」を参照してください。

Oracle ACFS acfsutilコマンドの実行の詳細は、「Oracle ACFSコマンドライン・ツールの使用について」を参照してください。

表16-30 Oracle ACFSレプリケーション用のコマンドの概要

コマンド	説明
acfsutil repl bg	Oracle ACFSレプリケーション・バックグラウンド・プロセスを開始、停止、または情報を表示します。
acfsutil repl compare	Oracle ACFSストレージ・ロケーション上でファイルがレプリケートされていることを確認します。
acfsutil repl failover	計画外の障害が発生した場合に、レプリケーションのスタンバイ・ロケーションのロールをプライマリ・ロケーションのロールに変換します。
acfsutil repl info	Oracle ACFSストレージ・ロケーションのレプリケーション・プロセスに関する情報を表示します。
acfsutil repl init	Oracle ACFSストレージ・ロケーションでファイルのレプリケーションを開始します。
acfsutil repl pause	Oracle ACFSストレージ・ロケーションでレプリケーションを一時停止します。
acfsutil repl resume	Oracle ACFSストレージ・ロケーションでレプリケーションを再開します。
acfsutil repl reverse	レプリケーションのプライマリ・ストレージ・ロケーションとスタンバイ・ストレージ・ロケーションのロールを入れ替えます。
acfsutil repl sync	プライマリ・ストレージ・ロケーションとスタンバイ・ストレージ・ロケーションを同期します。
acfsutil repl terminate	Oracle ACFSストレージ・ロケーションでのすべてのレプリケーション・アクティビティを停止します。
acfsutil repl trace	レプリケーション情報のトレース・レベルを指定します。
acfsutil repl update	レプリケーションの実行中にレプリケーション情報を更新します。
acfsutil repl upgrade	スナップショットベースのレプリケーションを使用するために、アクティブな既存のレプリケーション・インストールをアップグレードします。

acfsutil repl bg

目的

Oracle ACFSレプリケーション・バックグラウンド・プロセスを開始、停止、または情報を表示します。

構文および説明

acfsutil repl bg -h
acfsutil repl bg {start | stop | info} [snap_shot@]mount_point

acfsutil repl bg -hは、ヘルプ・テキストを表示して終了します。

次の表に、acfsutil repl bgコマンドで使用可能なオプションを示します。

表16-31 acfsutil repl bgコマンドのオプション

オプション	説明
`start`	レプリケーション・バックグラウンド・プロセスを開始します。
`stop`	レプリケーション・バックグラウンド・プロセスを停止します。
`info`	関連するクラスタウェア・リソースを使用してレプリケーション・バックグラウンド・プロセスの情報を表示します。リソースがプライマリ・クラスタのノードで`ONLINE`の場合、プロセスは実行されています。そうでない場合、プロセスは実行されていません。
[`snap_shot@`]`mount_point`	レプリケートされるロケーション(マウントされているプライマリ・ファイル・システムのマウント・ポイントまたはスナップショットのいずれか)を指定します。

Oracle ACFSレプリケーションは、プライマリ・クラスタのバックグラウンド・プロセスを使用して、ファイル・システムの変更をスタンバイ・ロケーション(ファイル・システムまたはスナップショットのいずれか)に転送します。このプロセスは、レプリケーションが機能するために実行する必要があります。レプリケーションがacfsutil repl initコマンドで開始されると、このプロセスが開始されてOracle Clusterwareに登録され、再起動またはシステム・クラッシュ後に自動的に再開できるようになります。このプロセスは、クラスタ規模です。

Oracle ACFSレプリケーション・バックグラウンド・プロセスがプライマリ・サイトで実行中かどうかを判別するには、acfsutil repl bg infoコマンドをプライマリ・クラスタで実行できます。コマンドの使用例は、例16-27を参照してください。

ノート:

レプリケーションに関与するロケーションを含むプライマリ・ファイル・システムは、そのレプリケーション・バックグラウンド・プロセスが実行中でも、常にアンマウントできます。umountコマンド(Windowsではacfsdismountコマンド)は、アンマウントの実行が必要な場合、バックグラウンド・プロセスを停止します。処理中のレプリケーション操作はすべて中断されます。レプリケーションに関与しているロケーションを含むプライマリ・ファイル・システムが再マウントされると、レプリケーションが自動的に再開し、バックグラウンド・プロセスが再開されます。

レプリケーションに関与しているロケーションを含むスタンバイ・ファイル・システムは、そのファイル・システムでレプリケーション操作が現在進行中でない場合にのみアンマウントできます。レプリケーション操作が進行中の場合、ファイル・システムをアンマウントしようとすると、ファイル・システムがビジーであることが示されてアンマウントは失敗します。

例

例16-27は、レプリケーション・プロセスに関する情報を表示するためのacfsutil repl bgコマンドの使用方法を示しています。

例16-27 acfsutil repl bgコマンドの使用方法

$ /sbin/acfsutil repl bg info /acfsmounts/acfs1
Resource:      ora.repl.dupd.crsdg1.crsdg1vol1.acfs
Target State:  ONLINE             
Current State: ONLINE on primnode1

acfsutil repl compare

目的

Oracle ACFSストレージ・ロケーション上でファイルがレプリケートされていることを確認します。

構文および説明

acfsutil repl compare -h 
acfsutil repl compare [-v] [ -a [-s] | -t { all | tagname, ...} [-s] ]           
[snap_shot@]primary_mount_point [snap_shot@]standby_mount_point

acfsutil repl compare -hは、ヘルプ・テキストを表示して終了します。

次の表に、acfsutil repl compareコマンドで使用可能なオプションを示します。

表16-32 acfsutil repl compareコマンドのオプション

オプション	説明
`-a`	すべてのファイルとその拡張された属性名を比較します。
`-t` { `all` \| `tagname`, `...` }	`acfsutil` `repl` `init`操作で指定されたすべてまたは一部のタグ名とファイルを比較します。`acfsutil` `repl` `init`操作で指定されたすべてのタグ名を指定する`all`オプションタグ名のカンマ区切りのリストには、`acfsutil` `repl` `init`操作中に指定されたタグ名のみを使用する必要があります。
`-s`	`-a`または`-t`オプションの使用時に、拡張属性およびタグのsymlinkの比較を省略します。symlinkは、権限や所有権など、その他すべてについて引き続きチェックされます。
`-v`	ファイルが比較された後、各場所のファイルの名前が出力されます。
`[snap_shot@]primary_mount_point`	レプリケートされるロケーション(マウントされているプライマリ・ファイル・システムのマウント・ポイントまたはスナップショットのいずれか)を指定します。
`[snap_shot@]standby_mount_point`	レプリケートされるロケーション(マウントされているスタンバイ・ファイル・システムのマウント・ポイントまたはスナップショットのいずれか)を指定します。

acfsutil repl compareコマンドは、プライマリ・ロケーションのすべてまたは一部がスタンバイ・ロケーションにレプリケートされたことを確認します。スタンバイ・ロケーションは、比較のためにローカルにマウントされる必要があります。最適な結果は、プライマリ・ロケーションの変更が最小限のときに得られます。コマンドは常に、スタンバイ・ロケーション上のファイルと照合して、プライマリ・ロケーション上のすべてのファイルをチェックしようとします。コマンドの機能を最大化してすべてのファイルをチェックするには、rootユーザーとして呼び出す必要があります。ただし、これは必須ではありません。コマンドは、どのユーザーとして呼び出されたときにもファイルを比較しようとします。

通常、acfsutil repl init操作中に指定されたタグ名がない場合に-aオプションが使用されます。-aオプションは、スタンバイ・ロケーション上のファイルに照らして、プライマリ・ロケーション上のすべてのファイルをチェックします。また、-aオプションを使用すると、プライマリに存在しないスタンバイ・ロケーション上のその他のファイルをテストできます。その他のファイルのテスト時に、コマンドでは拡張属性のチェックも試行します。ただし、NFSを使用してスタンバイ・ロケーションをローカルにマウントする場合、スタンバイではNFSプロトコル制限のため拡張属性の一致をチェックできません。

acfsutil repl init操作中にタグが指定された場合に-tオプションが使用されます。-t操作は、指定したタグ名を持つ、プライマリ・ロケーション上のすべてのファイル名を見つけ、それらをスタンバイ上の対応するファイルと比較します。-tオプションは、引数としてallオプションかまたはタグ名のカンマ区切りリストのどちらかを取ります。-tオプションがall引数とともに使用される場合、acfsutil repl init操作で指定されたすべてのタグ名が選択されます。そうでない場合、指定されたタグ名は、acfsutil repl init操作中に指定されたタグ名と正確に一致する必要があります。-tオプションはまた、acfsutil repl init操作中に指定された、関連するタグ名を持たないスタンバイ・ロケーション上のその他のファイルについてもテストします。NFSを使用してスタンバイ・ロケーションをローカルにマウントした場合、スタンバイでは、NFSプロトコルの制限のために、タグ名と拡張属性の一致についてチェックできません。

acfsutil repl info -cオプションを使用して、acfsutil repl init操作中に指定されたタグを特定できます。

-aオプションと-tオプションは両方を同時に指定できません。-aまたは-tの指定時に、—sオプションも指定してsymlinkについての拡張属性の比較を省略できます。-aまたは-tのオプションのどちらも提供されない場合、プライマリからスタンバイへのファイル比較はタグ名または拡張属性のテストを行わずに実行されます。

-vオプションを指定して、ファイルの比較後に各ファイルの名前を出力できます。

例

例16-28に、acfsutil repl compareコマンドの使用を示します。

例16-28 acfsutil repl compareコマンドの使用方法

$ /sbin/acfsutil repl compare /acfsmounts/acfs1 /nfs_mounted_standby

acfsutil repl failover

目的

レプリケーションのスタンバイ・システムのロールをプライマリ・ロケーションのロールに変換し、対応するプライマリ・ロケーションのロールをスタンバイのロールに変換します。

構文および説明

acfsutil repl failover -h
acfsutil repl failover [-T timeout] [snap_shot@]mount_point

acfsutil repl failover -hは、ヘルプ・テキストを表示して終了します。

次の表に、acfsutil repl failoverコマンドで使用可能なオプションを示します。

表16-33 acfsutil repl failoverコマンドのオプション

オプション	説明
`-T timeout`	プライマリ・ロケーションが使用できないことを確認するまでの待機時間(分)を指定します。`-T`オプションを省略した場合、プライマリ・ロケーションは可用性を1回チェックされます。
[`snap_shot@`]`mount_point`	レプリケートされるロケーション(マウントされているファイル・システムのマウント・ポイントまたはスナップショットのいずれか)を指定します。

acfsutil repl failoverコマンドは、レプリケーションのスタンバイ・ロケーションのロールを入れ替えてレプリケーションのプライマリ・ロケーションになるようにするか、オプションでレプリケーション関係を終了します。failoverコマンドは、最後に成功したレプリケーション転送の結果の完全コピーがスタンバイ・ロケーションに含まれることを保証します。必要に応じて、このコマンドではロケーションが転送時の状態にリストアされます。acfsutil repl failoverは、実行されたシナリオに基づいて動作が異なります。

スタンバイ・ロケーションと対応するプライマリ・ロケーションの両方が正常に動作している

この例では、コマンドはレプリケーション関係を逆転します。データ消失はありません。このケースでは、レプリケーションが一時停止している場合フェイルオーバーが失敗することに注意してください。このケースを正常に実行するには、acfsutil repl resumeを実行します。
プライマリ・ロケーションを現在使用できないが、それがオンラインに戻るまで待つ

このシナリオでは、コマンドはレプリケーションのプライマリのステータスを検証します。このコマンドは、プライマリにアクセスできずタイムアウト期間が経過した場合(指定されていた場合)には、スタンバイ・ロケーションを、レプリケーション転送が最後に成功した時点での状態にリストアし、レプリケーションのプライマリに変換します。プライマリ・ロケーションが使用不可になったときに転送の処理中だった場合などは、データが失われる可能性があります。元のプライマリ・ロケーションが使用可能になると、failoverコマンドが実行されてレプリケーションのスタンバイ・ロケーションに変換されることに注意してください。
プライマリ・ロケーションを現在使用できず、それがオンラインに戻るまで待たない

このシナリオでは、コマンドはレプリケーションのプライマリのステータスを検証します。このコマンドは、プライマリにアクセスできずタイムアウト期間が経過した場合(指定されていた場合)には、スタンバイ・ロケーションを、レプリケーション転送が最後に成功した時点での状態にリストアし、レプリケーションのプライマリに変換します。プライマリ・ロケーションが使用不可になったときに転送の処理中だった場合などは、データが失われる可能性があります。failoverコマンドを実行した後には、次の2つのオプションがあります。
- 1つ目は、acfsutil repl updateコマンドを使用して新しいスタンバイ・ロケーションを構成するという方法です。新しいスタンバイを指定した後に元のプライマリが(スタンバイとして)復帰しても問題ありません。元のプライマリ・ロケーションは、そのロケーションに対してacfsutil repl terminate standbyを実行するまでアイドル状態となります(スタンバイとして)。
- もう1つは、新しいプライマリでacfsutil repl terminate primaryを実行することでレプリケーションを終了するという方法です。

現在のプライマリ・ロケーションがアクティブな場合は、acfsutil repl failoverを実行する前に、プライマリに対するアプリケーションの更新を停止する必要があります。スタンバイへの変換前に現在のプライマリ・ロケーションに対して試行された更新は、破棄されます。変換後に試行された更新は、他のスタンバイ・ロケーションに対する更新と同様にすべて失敗します。

アプリケーションの更新が再開されたら、それらを新しいプライマリ・ロケーションに送信する必要があります。

例

次の例は、acfsutil repl failoverコマンドの使用方法を示しています。コマンドはスタンバイ・ロケーションで起動し、プライマリ・ロケーション(/repl_data)を指定します。

例16-29 acfsutil repl failoverコマンドの使用方法

acfsutil repl failover /repl_data

acfsutil repl info

目的

Oracle ACFSストレージ・ロケーションのレプリケーション・プロセスに関する情報を表示します。

構文および説明

acfsutil repl info -h 

acfsutil repl info -c [-v] {[snap_shot@]mount_point}                    

acfsutil repl info -c -u user [-o sshStrictKey=yn_value] standby_host [standby_host...]
                    [snap_shot@]primary_mount_point

acfsutil repl info -c -u user [-o sshStrictKey=yn_value] primary_host [primary_host...]
                    [snap_shot@]standby_mount_point

acfsutil repl info -s [-v][-l] [-n number{m|h|d|w|y}] 
                   {-f eventlog | [snap_shot@]mount_point}}

acfsutil repl info [-a|-e|-t] [-v][-l]
                   {-f eventlog | [snap_shot@]mount_point }

acfsutil repl info -hは、ヘルプ・テキストを表示して終了します。

次の表に、acfsutil repl infoコマンドで使用可能なオプションを示します。

表16-34 acfsutil repl infoコマンドのオプション

オプション	説明
`-a`	レプリケーション・イベント・ログから適用レコードのみを表示します。適用レコードには、レプリケートされた変更のセットがプライマリ・ロケーションで取得された日時と、それらがスタンバイ・ロケーションで適用された日時が含まれます。
`-c`	構成情報を表示します。
`-e`	レプリケーション・イベント・ログからエラー・レコードのみを表示します。
`-f` `eventlog`	情報のソースとして使用されるレプリケーション・イベント・ログへの絶対パスを指定します。デフォルトの場所は、`mount_point/.ACFS/repl/logs/ReplicationEventsLog`です。
`-h`	ヘルプ・テキストを表示します。
`-l`	最後のイベントのみを表示します。
`-n` `number`{`m`\|`h`\|`d`\|`w`\|`y`}	情報を表示する間隔を指定します。`number`には、分(`m`)、時間(`h`)、日(`d`)、週(`w`)または年(`y`)を指定します。たとえば、`-n` `5d`です。統計は指定した時間単位でまとめられます。
`-u user`	userをアクセス権が有効なユーザーとして使用して、現行ホストとstandby引数で指定されている各スタンバイ・ホスト間で現在構成されているホスト・キーおよびユーザー・キーを検証します。
`-o sshStrictKey=yn_value`	`ssh`で厳密なホスト・キー・チェックを使用するかどうかを指定します。`y`で始まる値で、このチェックは有効になります(デフォルト設定)。`n`で始まる値で、チェックは無効になります。
`-s`	統計情報を表示します。統計を意味のあるものにするために、プライマリおよびスタンバイ・ノードがネットワーク・タイム・サービスを実行していることが重要です。
`-t`	レプリケーション・イベント・ログから転送レコードのみを表示します。
`-v`	冗長出力を表示します。
`standby_host`	`-u`オプションの指定時に処理されるスタンバイ・ホストのいずれかのホスト名またはIPアドレスを指定します。
[`snap_shot@`]`primary_mount_point`	レプリケーションに関与するロケーション(プライマリ・ファイル・システムがマウントされたディレクトリまたはスナップショットのいずれか)を指定します。
`primary_host`	`-u`オプションの指定時に処理されるプライマリ・ホストのいずれかのホスト名またはIPアドレスを指定します。＊
[`snap_shot@`]`standy_mount_point`	レプリケーションに関与するロケーション(スタンバイ・ファイル・システムがマウントされたディレクトリまたはスナップショットのいずれか)を指定します。＊
[`snap_shot@`]`mount_point`	レプリケートされるロケーション(マウントされたプライマリ・ファイル・システムまたはスタンバイ・ファイル・システムのマウント・ポイントまたはスナップショットのいずれか)を指定します。

レプリケーション構成の情報を表示するには、-cオプションを指定したacfsutil repl infoを使用します。構成情報には、スタンバイ・ロケーションが表すプライマリ・ロケーションでのポイント・イン・タイムを識別するApplied primary as ofタイムスタンプが含まれます。このタイムスタンプを使用すると、Oracle ACFSロケーション内のデータを、Oracle Data Guardでレプリケートされたデータベース・データと同期された状態で保つ必要がある場合に、このポイント・イン・タイムにデータベースを戻すことができます。

-uオプションを指定する場合は、レプリケーション・ユーザーであるrepluserとしてコマンドを実行する必要があります。このオプションを指定すると、スナップショット・ベースのレプリケーションで使用される場合と同様に、sshでローカル・クラスタからリモート・クラスタに接続できることをこのコマンドは確認します。このコマンドは、次の2つのコンテキストで使用する必要があります。

プライマリ・クラスタの各ホストで、sshですべてのスタンバイ・ホストに接続し、各ホストにユーザーとしてログインできることを確認します
スタンバイ・クラスタの各ホストで、sshですべてのプライマリ・ホストに接続し、各ホストにユーザーとしてログインできることを確認します

プライマリ・ホストでこのコマンドを実行する場合は、各standby_host文字列にスタンバイ・ノードのホスト名またはホストのIPアドレスを指定します。指定する[snap_shot@]primary_mount_pointは、レプリケーションに使用されるプライマリ・クラスタ内のアクティブなOracle ACFSロケーションにする必要があります。＊

スタンバイ・ホストでこのコマンドを実行する場合は、各primary_host文字列にプライマリ・ノードのホスト名またはホストのIPアドレスを指定します。指定する[snap_shot@]standby_mount_pointは、レプリケーションに使用されるスタンバイ・クラスタ内のアクティブなOracle ACFSロケーションにする必要があります。

すべての場合に、指定するユーザーは、acsfutil repl initコマンドで指定するrepluserと同じにする必要があります。＊レプリケーションのこのインスタンスで厳密なホスト・キー・チェックが無効になっていた(または無効になっている)場合(-o sshStrictKey=noを指定してacsfutil repl init primaryを使用した場合など)、ここでもオプションを指定してホスト・キー検証をスキップする必要があります。指定されたOracle ACFSの場所でレプリケーションが現在アクティブであるかどうかにかかわらず、acfsutil repl info -c -uはいつでも実行できます。

レプリケーション統計の情報を表示するには、-sオプションを指定したacfsutil repl infoを使用します。

すべてのレプリケーション・イベントの情報を表示するには、オプションを指定せずにacfsutil repl infoを使用します。特定の種類のイベントの情報を表示するには、-a、-eまたは-tオプションを指定してacfsutil repl infoを使用します。

例

例16-30に、acfsutil repl infoコマンドの使用を示します。

例16-30 acfsutil repl infoコマンドの使用方法

検証コマンドの形式は次のとおりです。

# /sbin/acfsutil repl info -c -u repluser standby-addr1 [standby-addr2 …] my_primary_mountpoint

このコマンドは、ユーザーrepluserがsshを使用して、初期化時にレプリケーションと同じように指定された各standby-addrに接続できることを確認します。指定するmy_primary_mountpointは、レプリケーションに使用されるアクティブなOracle ACFSマウント・ポイントにする必要があります。

standby1およびstandby2という名前の2つのスタンバイ・ノードがあり、いずれのノードも指定できるstandby12_vipという名前のVIPもある場合は、プライマリ・クラスタの各ノードで次のコマンドを実行することで、standby1/standby2クラスタのキー設定を検証できます。

# /sbin/acfsutil repl info -c -u repluser standby1 standby2 my_primary_mountpoint

VIP standby12_vipを使用したクラスタへの接続の検証には、同じコマンドを使用します。

厳密なホスト・キー・チェックを無効にする予定の場合は、-o sshStrictKey=noオプションをコマンドラインに追加して、このチェックを省略できます。

統計および適用レコードを表示するためのその他のコマンドは、次のとおりです。

$ /sbin/acfsutil repl info -s -n 5d /acfsmounts/acfs1

$ /sbin/acfsutil repl info -a -v /acfsmounts/acfs1

acfsutil repl init

目的

Oracle ACFSストレージ・ロケーションのすべてのファイル、または指定したタグ・リストを持つファイルのみでレプリケーションを開始します。

構文および説明

acfsutil repl init -h

acfsutil repl init standby -u repluser [-d trace_level] [snap_shot@]standby_mount_point

acfsutil repl init primary -s repluser@netname { -C | -M | -i interval} [tag_name...]
                           [-m [snap_shot@]standby_mount_point] [-d trace_level] [-z {on | off}] 
                           [-o sshCmdPath=pathname] [-o sshStrictKey=ynvalue] 
                           [-o sshCipher=ciphername] [-p repluser@netname] [-o sshOptions=options]
                           [-p [repluser@]netname] [snap_shot@]primary_mount_point

acfsutil repl init -hは、ヘルプ・テキストを表示して終了します。

次の表に、acfsutil repl initコマンドで使用可能なオプションを示します。

表16-35 acfsutil repl initコマンドのオプション

オプション	説明
`primary`	プライマリ・ロケーションのレプリケーションを指定します。
`standby`	スタンバイ・ロケーションのレプリケーションを指定します。
`-s repluser@netname`	プライマリ・サイトがスタンバイ・サイトに接続するための標準`ssh`接続文字列を指定します。接続文字列のrepluserは、スタンバイ・ノードで`ssh`ログインするユーザーです。最小限の権限を持つユーザー・アイデンティティを選択します。このユーザーは、Oracle ASM管理者権限を持ち、Oracle DBAグループに属する必要があります。ノート: プライマリ・クラスタとスタンバイ・クラスタの両方で、同じユーザーとグループのアイデンティティ(すべての`uids`と`gids`を含む)をレプリケーション・ユーザーに指定する必要があります。接続文字列のnetnameは、ホスト名、VIP名、IPアドレスなど、ネットワーク・エンドポイントを指定します。
`-C`	常時モードのレプリケーションを指定します。スナップショットが絶えず生成され、スタンバイ・サイトにレプリケートされます。各スナップショットのレプリケーションが完了するとすぐに、新しいスナップショットの生成が開始されます。
`—M`	手動モードのレプリケーションを指定します。初回レプリケーション操作が実行された後、以降のレプリケーションは、`acfsutil` `repl` `sync`を実行して手動で要求されるまで行われません。
`—i interval`	間隔(スケジュール)モードのレプリケーションを指定します。新しいスナップショットが取得され、可能な場合は、指定した頻度でレプリケートされます。接尾辞を指定して、間隔の測定単位を指定する必要があります。接尾辞は、`s` (秒)、`m` (分)、`h` (時間)、`d` (日)または`w` (週)のいずれかにする必要があります。たとえば、`30m`は30分、`2h`は2時間です。
`tag_name`	レプリケーションの制限で使用する1つ以上のタグ名を指定します。タグ名を指定すると、それらのタグ名の少なくとも1つを使用してタグ付けされているファイルのみがレプリケートされます。Oracle ACFSタグの詳細は、「Oracle ACFSタグ付け」を参照してください。
`-m` `[snap_shot@]standby_mount_point`	スタンバイ・ストレージ・ロケーションがプライマリ・ロケーションと異なる場合、スタンバイ・ストレージ・ロケーションを指定します。
`-d` `trace_level`	トレース・レベル設定[0..6]を指定します。
`-z` `on`\|`off`	プライマリからスタンバイに送信されるレプリケーション・データ・ストリームの圧縮を有効または無効にします。
`-o sshCmdPath=pathname`	`ssh`コマンドへのパス名を指定します。
`-p repluser@netname`	プライマリ・ロケーションのネットワーク・エンドポイントを指定します。netnameは、ホスト名、VIP名、IPアドレスなどのネットワーク・エンドポイントを指定します。netnameは、それがアクセス可能であることを確認するためにチェックされます。repluserは、`-s`オプションで指定されたrepluserと一致する必要があります。 `-p`を指定しない場合、このコマンドが呼び出されたマシンのホスト名が使用されます。
`-o sshStrictKey=ynvalue`	`ssh`で厳密なホスト・キー・チェックを使用するかどうかを指定します。`y`で始まる値で、このチェックは有効になります(デフォルト設定)。`n`で始まる値で、チェックは無効になります。
`-o sshCipher=ciphername`	セッションを暗号化するために`ssh`に渡される暗号を指定します。
`-o sshOptions=options`	レプリケーションによって実行される`ssh`の各起動に渡されるオプションを指定します。optionsのコンテンツに制限は課されません。ただし、結果として起こる`ssh`の起動はレプリケーションの開始前に検証され、`ssh`の起動の検証が失敗した場合、`acfsutil` `repl` `init` `primary`は失敗します。
`-p [repluser@]netname`	プライマリ・ロケーションのネットワーク・エンドポイントを指定します。netnameは、ホスト名、VIP名、IPアドレスなどのネットワーク・エンドポイントを指定します。netnameは、それがアクセス可能であることを確認するためにチェックされます。repluserは、指定された場合、`acfsutil` `repl` `init` `standby`に対して指定されたrepluserに一致する必要があります。 `-p`が指定されていない場合、プライマリ・クラスタに関連付けられているSCAN VIPが使用可能な場合は、プライマリ・ロケーションのネットワーク・エンドポイントとして使用されます。SCAN VIPが使用できない場合、このコマンドが呼び出されたマシンのホスト名が使用されます。
`-u`	repluserを指定します。
`[snap_shot@]standby_mount_point`	レプリケートされるロケーション(マウントされているスタンバイ・ファイル・システムのマウント・ポイントまたはスナップショットのいずれか)を指定します。
`[snap_shot@]primary_mount_point`	レプリケートされるロケーション(マウントされているプライマリ・ファイル・システムのマウント・ポイントまたはスナップショットのいずれか)を指定します。

acfsutil repl init primaryおよびstandbyの各コマンドは、指定されたプライマリ・サイトと指定されたスタンバイ・サイトの間でレプリケーションを開始します。acfsutil repl init standbyコマンドを先に実行する必要があります。次に、acfsutil repl init primaryコマンドを実行します。

acfsutil repl init primaryコマンドが正常に完了すると、指定したすべてのファイルの最初のコピーをスタンバイ・ロケーションにレプリケートする処理が開始されます。さらに、これらのファイルへの変更と、プライマリ・ストレージ・ロケーションにその後作成された新しいファイルが取得されて、スタンバイ・ロケーションに転送されます。しかし、コマンドの正常な完了は、指定したファイルがスタンバイ・ロケーションに完全にコピーされたことを示しているわけではありません。指定した全ファイルのスタンバイ・ロケーションへの初回レプリケーションの進行を監視するには、acfsutil repl info -cコマンドを実行できます。

初回レプリケーション操作は、スタンバイ・ロケーションに全体が転送される、プライマリ・ロケーションのスナップショットに基づきます。後続の各レプリケーション操作では、その後のプライマリ・ロケーションのスナップショットが使用され、そのスナップショットと直前のスナップショットの差異のみがスタンバイ・ロケーションに転送されます。

プライマリ・ロケーションのディレクトリはすべて、タグが指定されている場合でも、常にスタンバイにレプリケートされます。

シンボリック・リンク・ファイルはそのままレプリケートされます。シンボリック・リンクが絶対パス名に解決され、そのパス名がスタンバイ・ロケーションに存在しない場合、シンボリック・リンクを参照するとエラーになります。

指定されたソケット、キャラクタ・デバイス・ファイルまたはブロック・デバイス・ファイルをサポートするプラットフォームでは、これらのファイル・タイプがレプリケートされません。

プライマリ・ストレージ・ロケーションまたはスタンバイ・ストレージ・ロケーションを含むファイル・システムは、クラスタ内の1つのマウント・ポイントにのみマウントできます。ファイル・システムを1つのクラスタ内のすべてのノードにマウントする必要はありませんが、マウントする場合は、acfsutil repl initコマンドで指定したマウント・ポイントにマウントする必要があります。さらに、他のノードのそのマウント・ポイントには他のファイル・システムはマウントできません。

1つのOracle ACFSロケーションは、プライマリ・ロケーションとスタンバイ・ロケーションの両方として構成できません。レプリケーションを同じホスト上または同じクラスタ内に構成する場合、プライマリ・ロケーションとスタンバイ・ロケーションは同じ名前のマウント・ポイントを使用できません。

Linux、SolarisまたはAIXのオペレーティング・システムの組合せで稼働しているサイト間ではレプリケーションが可能です。

例

例16-31に、プライマリからスタンバイ・サイトへのスナップショットベースのレプリケーションを開始するためのacfsutil repl initの使用方法を示します。

例16-31 acfsutil repl initコマンドの使用方法

# /sbin/acfsutil repl init standby -u my_repluser /my_standby/repl_data

# /sbin/acfsutil repl init primary -s my_repluser@my_host -i 2h
                                   -m /my_standby/repl_data /my_primary/repl_data

acfsutil repl pause

目的

Oracle ACFSプライマリ・ロケーションでレプリケーションを一時停止します。

構文および説明

acfsutil repl pause -h
acfsutil repl pause [snap_shot@]mount_point

acfsutil repl pause -hは、ヘルプ・テキストを表示して終了します。

次の表に、acfsutil repl pauseコマンドで使用可能なオプションを示します。

表16-36 acfsutil repl pauseコマンドのオプション

オプション	説明
[`snap_shot@`]`mount_point`	レプリケートされるロケーション(マウントされているプライマリ・ファイル・システムのマウント・ポイントまたはスナップショットのいずれか)を指定します。

acfsutil repl pauseコマンドは、プライマリ・レプリケーション・サイトでのみ発行します。レプリケーション操作を続行するには、後でacfsutil repl resumeを同じプライマリ・サイトで実行する必要があります。

acfsutil repl pauseは、レプリケーション・デーモンの操作を一時的に停止します。その後にacfsutil repl resumeを実行すると、デーモンの操作が再開されます。

レプリケーション操作がアクティブであるときにacfsutil repl pauseを実行すると、一時停止アクションに関係なく、アクティブなレプリケーション操作は完了します。この場合、一時停止操作は有効でなく、現行データ・ストリームがスタンバイに適用されるまで、コマンドは戻りません。その後、acfsutil repl resumeが発行されるまで、このレプリケーションに関して操作は実行されません。

例

例16-32に、acfsutil repl pauseコマンドの使用を示します。

例16-32 acfsutil repl pauseコマンドの使用方法

$ /sbin/acfsutil repl pause /acfsmounts/acfs1

acfsutil repl resume

目的

一時停止されたOracle ACFSロケーションでのレプリケーションを再開します。

構文および説明

acfsutil repl resume -h
acfsutil repl resume [snap_shot@]mount_point

acfsutil repl resume -hは、ヘルプ・テキストを表示して終了します。

次の表に、acfsutil repl resumeコマンドで使用可能なオプションを示します。

表16-37 acfsutil repl resumeコマンドのオプション

オプション	説明
[`snap_shot@`]`mount_point`	レプリケートされるロケーション(マウントされているプライマリ・ファイル・システムのマウント・ポイントまたはスナップショットのいずれか)を指定します。

acfsutil repl resumeコマンドは、acfsutil repl pauseコマンドの実行後にレプリケーション・プロセスを再開します。このコマンドは、acfsutil repl pauseコマンドでレプリケーションを一時停止したすぐ後に、同じプライマリ・サイトで実行する必要があります。

例

例16-33に、acfsutil repl resumeコマンドの使用を示します。

例16-33 acfsutil repl resumeコマンドの使用方法

$ /sbin/acfsutil repl resume /acfsmounts/acfs1

acfsutil repl reverse

目的

レプリケーションのプライマリ・ロケーションとスタンバイ・ロケーションのロールを入れ替えます。

構文および説明

acfsutil repl reverse -h
acfsutil repl reverse primary [snap_shot@]mount_point
acfsutil repl reverse standby [-o sshCmdPath=path_name] [snap_shot@]mount_point

acfsutil repl reverse -hは、ヘルプ・テキストを表示して終了します。

次の表に、acfsutil repl reverseコマンドで使用可能なオプションを示します。

表16-38 acfsutil repl reverseコマンドのオプション

オプション	説明
`primary`	プライマリ・ロケーションを指定します。
`standby`	スタンバイ・ロケーションを指定します。
`-o sshCmdPath=path_name`	現在のスタンバイ・ロケーションで`ssh`コマンドのpath_nameを指定します。
[`snap_shot@`]`mount_point`	レプリケートされるロケーション(マウントされているファイル・システムのマウント・ポイントまたはスナップショットのいずれか)を指定します。

acfsutil repl reverseコマンドは、レプリケーションを終了して再開する必要なしに、レプリケーションのプライマリ・ロケーションとスタンバイ・ロケーションのロールを入れ替えます。まず、「Oracle ACFSスナップショットベースのレプリケーションの構成」で説明されている、ロール・リバーサル・レプリケーションの必要な構成を完了します。構成の完了後、次に示すプライマリとスタンバイのロール・リバーサル・ステップを実行します。

ロール・リバーサルを開始するには、プライマリ・クラスタでacfsutil repl reverse primary操作を実行します。このステップは、プライマリ・レプリケーション・ロケーション、スタンバイ・レプリケーション・ロケーション、およびスタンバイのバックアップ・スナップショットがすべて同一であることを確認し、現在のプライマリをスタンバイに変換します。最後のステップが完了するまで、レプリケーションは中断されます。
ロール・リバーサルを完了するには、スタンバイ・クラスタ内でacfsutil repl reverse standby操作を実行します。このステップは、現在のスタンバイ・レプリケーション・ロケーションをプライマリ・ロケーションに変換し、次に、新しいプライマリから新しいスタンバイへのレプリケーションを再開します。

acfsutil repl reverse primaryを実行する前に、現在のプライマリへのアプリケーション更新を停止する必要があります。スタンバイへの変換後に現在のプライマリに対して試行された更新は、他のスタンバイに対して更新が試行された場合と同様にすべて失敗します。アプリケーションの更新が再開されたら、それらは新しいプライマリに送信する必要があります。

例

次に、acfsutil repl reverseコマンドの使用例を示します。

例16-34 acfsutil repl reverseコマンドの使用方法

acfsutil repl reverse primary /my_primary/repl_data
acfsutil repl reverse standby /my_standby/repl_data

acfsutil repl sync

目的

プライマリ・ロケーションとスタンバイ・ロケーションを同期します。

構文および説明

acfsutil repl sync -h
acfsutil repl sync [apply] [snap_shot@]mount_point

acfsutil repl sync -hは、ヘルプ・テキストを表示して終了します。

次の表に、acfsutil repl syncコマンドで使用可能なオプションを示します。

表16-39 acfsutil repl syncコマンドのオプション

オプション	説明
`apply`	すべての変更をスタンバイ・ロケーションに適用するように指定します。現在は、コマンドの動作に影響しません。
[`snap_shot@`]`mount_point`	レプリケートされるロケーション(マウントされているプライマリ・ファイル・システムのマウント・ポイントまたはスナップショットのいずれか)を指定します。

acfsutil repl syncコマンドは、プライマリ・サイトおよびスタンバイ・サイトの状態を同期するのに使用できます。このコマンドは、プライマリ・サイトでのみ実行できます。同期された状態がユーザーにわかり、意味のあるものにするためには、まずアプリケーションを停止してsync(1)コールを発行する必要があります。次に、acfsutil repl syncを実行すると、確実にすべての未処理のレプリケーション・データがプライマリ・サイトからスタンバイ・サイトに送信されます。具体的には、このコマンドは処理中のレプリケーション操作を完了でき、その後にプライマリのすべての変更が確実にレプリケートされるようにもう一度レプリケーションを実行します。

スタンバイ・サイトのレプリケーション・ロケーションにすべての変更が正常に適用されると、コマンドは正常に完了します。この時点で、プライマリ・サイト・クラスタ上の最後のノードがアンマウントされようとしていないかぎり、アプリケーションは再開できます。

プライマリ・サイト上のレプリケートされたロケーションを正常にアンマウントしても、アンマウント前に行われたすべての変更がスタンバイ・サイトに正常に送信されたことや、スタンバイ・ロケーションに適用されたことを示すわけではありません。プライマリ・ロケーションが、あるプライマリ・サイト・ノード上のアンマウントされたファイル・システムにあるが、1つ以上のプライマリ・サイト・ノードでマウントされたままである場合、アンマウント前にそのロケーションに対して行われた変更は、アンマウント後に引き続き他のノードからスタンバイ・サイトに転送されます。しかし、マウントされている最後のプライマリ・サイト・ノードでプライマリ・ロケーションのアンマウントの処理中であり、その時点までのプライマリ・ロケーションでのすべてのファイル・システムへの変更が、スタンバイ・ロケーションに正常に適用されていることを知りたい場合は、次の操作を実行して、スタンバイ・ロケーションが最新であることを確実にする必要があります。

レプリケーション・ロケーションを変更するプライマリ・サイトでアプリケーションを停止します。
acfsutil repl syncを実行します。

acfsutil repl syncが正常に返されたら、関与しているレプリケーション・ロケーションを含むファイル・システムをアンマウントできます。ファイル・システムをアンマウントすると、そのロケーションのレプリケーション・バックグラウンド・プロセスが停止します。

例

例16-35に、acfsutil repl syncコマンドの使用を示します。

例16-35 acfsutil repl syncコマンドの使用方法

$ /sbin/acfsutil repl sync /acfsmounts/acfs1

acfsutil repl terminate

目的

このコマンドを実行するサイトで、Oracle ACFSロケーションのすべてのレプリケーション・アクティビティを停止します。

構文および説明

acfsutil repl terminate -h
acfsutil repl terminate primary [-d trace_level] [snap_shot@]mount_point 
acfsutil repl terminate standby [remote [-f]] [immediate] [-k] [-d trace_level] [snap_shot@]mount_point

acfsutil repl terminate -hは、ヘルプ・テキストを表示して終了します。

次の表に、acfsutil repl terminateコマンドで使用可能なオプションを示します。

表16-40 acfsutil repl terminateコマンドのオプション

オプション	説明
`primary`	プライマリ・ロケーションでレプリケーションを停止します。
`standby`	スタンバイ・ロケーションでレプリケーションを停止します。
`remote [-f]`	スタンバイ・ロケーションの処理を停止する前に、プライマリ・ロケーションのレプリケーション処理を停止します。リモート・キーワードを指定すると、`-f`オプションは、プライマリ・ロケーションでのレプリケーションを終了できない場合でも、スタンバイ・ロケーションでのレプリケーションの終了を強制します。
`immediate`	スタンバイ・ロケーションでレプリケーション・プロセスを即時停止します。
`—k`	スタンバイに存在するバックアップ・スナップショットを保持することを指定します。ただし、このオプションではバックアップ・スナップショットの存在は保証されず、そのようなバックアップ・スナップショットの存在はエラーになりません。このオプションを指定しない場合、バックアップ・スナップショットが存在していれば削除されます。
`-d` `trace_level`	トレース・レベル設定[0..6]を指定します。
[`snap_shot@`]`mount_point`	レプリケートされるロケーション(マウントされているファイル・システムのマウント・ポイントまたはスナップショットのいずれか)を指定します。

acfsutil repl terminateコマンドは、すべてのレプリケーション処理を停止します。レプリケーションを停止する場合は、先にプライマリ・ロケーションのレプリケーションを停止し、次にスタンバイ・ロケーションのレプリケーションを停止する必要があります。プライマリ・サイトを停止する前にすべての変更がスタンバイ・ロケーションに送信されていることを確認する場合は、すべてのアプリケーションを停止し、acfsutil repl syncコマンドを実行します。ロケーションをホストしている両方のサイトが利用可能な場合は、両方のサイトでterminateコマンドを実行する必要があります。

acfsutil repl terminate standbyの実行後は、スタンバイ・ロケーションを読取り/書込みモードで使用できます。acfsutil repl terminateの実行後にレプリケーションを再開する場合は、acfsutil repl initコマンドを使用して最初からレプリケーションを再開する必要があります。

repl terminate standbyコマンドは、スタンバイ・ロケーションのレプリケーション・データが適用されるまで待機します。すべてのレプリケーション・データを適用せずにレプリケーションを即時停止する場合は、immediateオプションを使用します。ただし、このオプションではスタンバイ・ロケーションに不確定な状態のファイルが残されることがあります。

Oracle ACFSレプリケーションを一時的に停止するには、acfsutil repl pauseコマンド、その後すぐにacfsutil repl resumeコマンドを使用できます。

ノート:

remoteオプションを指定してacfsutil repl terminate standbyを実行すると失敗します。

プライマリ・ロケーションが一時停止している場合。
プライマリ・ロケーションがスタンバイに変換中の場合。

たとえば、acfsutil repl reverse primaryがプライマリ・ロケーションで起動された場合などです。

例

例16-36に、acfsutil repl terminateコマンドの使用を示します。

例16-36 acfsutil repl terminateコマンドの使用方法

$ /sbin/acfsutil repl terminate /acfsmounts/acfs1

acfsutil repl trace

目的

Oracle ACFSロケーションのトレース情報の収集のレプリケーション・トレース・レベルを設定します。

構文および説明

acfsutil repl trace -h
acfsutil repl trace level [snap_shot@]mount_point

acfsutil repl trace -hは、ヘルプ・テキストを表示して終了します。

次の表に、acfsutil repl traceコマンドで使用可能なオプションを示します。

表16-41 acfsutil repl traceコマンドのオプション

オプション	説明
`level`	トレース・レベル設定[0..6]を指定します。デフォルトのレベルは2です。
[`snap_shot@`]`mount_point`	レプリケートされるロケーション(マウントされているファイル・システムのマウント・ポイントまたはスナップショットのいずれか)を指定します。

トレース・レベルを上げると、パフォーマンスに影響する場合があるので、Oracleサポート・サービスの推奨に従い実行する必要があります。

Oracle ACFSレプリケーションのトレース・ファイルは次の場所に保存されます。

GRID_BASE/diag/crs/hostname/crs/trace

前述の場所で、GRID_BASEはOracle Grid InfrastructureホームのORACLE_BASEを指定します。

例

例16-37に、acfsutil repl traceコマンドの使用を示します。

例16-37 acfsutil repl traceコマンドの使用方法

$ /sbin/acfsutil repl trace 5 /acfsmounts/acfs1

acfsutil repl update

目的

レプリケーションが開始され、Oracle ACFSロケーションで実行されている間にレプリケーション情報を更新します。

構文および説明

acfsutil repl update -h

acfsutil repl update  [-s repluser@netname] [-C | -M | -i interval] 
                      [-d trace_level] [-z {on | off}] 
                      [-o sshCmdPath=pathname] [-o sshStrictKey=ynvalue] [-o sshCipher=ciphername]
                      [-p repluser@netname]
                      [-m [snap_shot@]standby_mount_point]
                      [snap_shot@]primary_mount_point
acfsutil repl update [-u repluser] [-d trace_level] [snap_shot@]standby_mount_point

acfsutil repl update -hは、ヘルプ・テキストを表示して終了します。

次の表に、acfsutil repl updateコマンドで使用可能なオプションを示します。

表16-42 acfsutil repl updateコマンドのオプション

オプション	説明
`-s repluser@netname`	プライマリ・サイトがスタンバイ・サイトに接続するための標準`ssh`接続文字列を指定します。接続文字列のrepluserは、スタンバイ・ノードで`ssh`ログインするユーザーです。最小限の権限を持つユーザー・アイデンティティを選択します。このユーザーは、Oracle ASM管理者権限を持ち、Oracle DBAグループに属する必要があります。接続文字列のnetnameは、ホスト名、VIP名、IPアドレスなど、ネットワーク・エンドポイントを指定します。
`—C`	常時モードのレプリケーションを指定します。スナップショットが絶えず生成され、スタンバイ・サイトにレプリケートされます。各スナップショットのレプリケーションが完了するとすぐに、新しいスナップショットの生成が開始されます。
`-M`	手動モードのレプリケーションを指定します。次のレプリケーション操作が実行された後、以降のレプリケーションは、acfsutil repl syncを実行して手動で要求されるまで行われません。
`—i interval`	間隔(スケジュール)モードのレプリケーションを指定します。新しいスナップショットが取得され、可能な場合は、指定した頻度でレプリケートされます。接尾辞を指定して、間隔の測定単位を指定する必要があります。接尾辞は、`s` (秒)、`m` (分)、`h` (時間)、`d` (日)または`w` (週)のいずれかにする必要があります。たとえば、`30m`は30分、`2h`は2時間です。
`-d` `trace_level`	トレース・レベル設定[0..6]を指定します。
`-z` `on`\|`off`	プライマリからスタンバイに送信されるレプリケーション・データ・ストリームの圧縮を有効または無効にします。
`-o sshCmdPath=pathname`	`ssh`コマンドへのパス名を指定します。
`-o sshStrictKey=ynvalue`	`ssh`で厳密なホスト・キー・チェックを使用するかどうかを指定します。`y`で始まる値で、このチェックは有効になります(デフォルト設定)。`n`で始まる値で、チェックは無効になります。
`-o sshCipher=ciphername`	セッションを暗号化するために`ssh`に渡される暗号を指定します。
`-p repluser@netname`	プライマリ・サイトの新しいレプリケーション・ユーザーまたは新しいネットワーク・エンドポイント(あるいはその両方)を指定します。netnameは、ホスト名、VIP名、IPアドレスなどのネットワーク・エンドポイントを指定します。netnameは、それがアクセス可能であることを確認するためにチェックされます。 repluserまたはnetnameの既存の値が指定されている場合、それが引き続き使用されます。
`-u`	repluserを指定します。
`-m [snap_shot@]standby_mount_point`	スタンバイ・ストレージ領域を指定します。
[`snap_shot@`]`primary_mount_point`	レプリケートされるロケーション(マウントされているプライマリ・ファイル・システムのマウント・ポイントまたはスナップショットのいずれか)を指定します。
[`snap_shot@`]`standby_mount_point`	レプリケートされるロケーション(マウントされているスタンバイ・ファイル・システムのマウント・ポイントまたはスナップショットのいずれか)を指定します。

acfsutil repl updateコマンドは、レプリケーションの開始後にレプリケーション情報および構成を更新します。たとえば、リモート・サイトへの接続のためにレプリケーションで現在使用されているネットワーク・インタフェースをシステム管理者が変更できます。この状況でacfsutil repl updateコマンドを発行して構成を更新すると、レプリケーションを中断せずに実行を継続できます。

acfsutil repl updateをプライマリ・サイトで実行すると、スタンバイ・サイトへの接続およびスタンバイ記憶域の場所の変更に使用されるユーザー名およびネットワーク・インタフェース名(ホスト名またはVIP名)を変更できます。また、このコマンドは、レプリケーション間隔またはトレース・レベルの変更、sshで使用される暗号やパス名の変更、圧縮の有効化/無効化にも使用できます。最後に、このコマンドを使用して、プライマリ・サイトに対して記録されたネットワーク・インタフェースを更新できます。

acfsutil repl updateをスタンバイ・サイトで実行すると、トレース・レベルまたはスタンバイ・サイトへの接続にプライマリ・サイトで使用されるユーザー名を変更できます。

このコマンドを発行する場合、オプションを少なくとも1つ指定する必要があります。必須のロケーションのみを指定してこのコマンドを実行することはできません。

acfsutil repl updateコマンドは、更新後の情報がローカル・サイトで受け入れられると、成功を返します。ユーザー名を変更するには、コマンドをプライマリ・サイトとスタンバイ・サイトの両方で実行する必要があります。-Cまたは-iオプションを指定してレプリケーション間隔を変更すると、acfsutil repl updateの実行時点でレプリケーション操作が発生します。次のレプリケーション操作は、新たに指定された間隔に基づいて発生します。

例

例16-38に、acfsutil repl updateコマンドの使用を示します。

例16-38 acfsutil repl updateコマンドの使用方法

$ /sbin/acfsutil repl update -i 1h /my_primary/repl_data

acfsutil repl upgrade

目的

スナップショットベースのレプリケーションに、既存のレプリケーション・インストールをアップグレードします。

構文および説明

acfsutil repl upgrade -h

acfsutil repl upgrade prepare -s {repluser@netname | -u} primary_mount_point

acfsutil repl upgrade standby standby_mount_point

acfsutil repl upgrade primary {-C | -M | -i interval}
                              [-d trace_level] [-z {on | off}]
                              [-o sshCmdPath=pathname] [-o sshStrictKey=ynvalue] 
                              [-o sshCipher=ciphername]
                              primary_mount_point

acfsutil repl upgrade -hは、ヘルプ・テキストを表示して終了します。

次の表に、acfsutil repl upgradeコマンドで使用可能なオプションを示します。

表16-43 acfsutil repl upgradeコマンドのオプション

オプション	説明
`prepare`	スナップショットベースのレプリケーションにアップグレードできるように、既存のレプリケーション・インストールを準備します。
`-s repluser@netname`	プライマリ・サイトがスタンバイ・サイトに接続するための標準`ssh`接続文字列を指定します。接続文字列のrepluserは、スタンバイ・ノードで`ssh`ログインするユーザーです。最小限の権限を持つユーザー・アイデンティティを選択します。このユーザーは、Oracle ASM管理者権限を持ち、Oracle DBAグループに属する必要があります。接続文字列のnetnameは、ホスト名、VIP名、IPアドレスなど、ネットワーク・エンドポイントを指定します。
`-u` (`prepare`オプション)	完了した`acfsutil` `repl` `upgrade` `prepare`操作を元に戻します。このアクションは、`primary_mount_point`をすでに完了した`acfsutil` `repl` `upgrade` `prepare`操作の前の状態にリストアします。
`standby`	スタンバイ・ファイル・システムのレプリケーションを指定します。
`standby_mount_point`	このスタンバイ・ファイル・システムがマウントされるディレクトリを指定します。
`primary`	プライマリ・ファイル・システムのレプリケーションを指定します。
`—C`	常時モードのレプリケーションを指定します。スナップショットが絶えず生成され、スタンバイ・サイトにレプリケートされます。各スナップショットのレプリケーションが完了するとすぐに、新しいスナップショットの生成が開始されます。
`—M`	手動モードのレプリケーションを指定します。単一のレプリケーション操作が実行された後、以降のレプリケーションは、`acfsutil` `repl` `sync`を実行して手動で要求されるまで行われません。
`—i interval`	間隔(スケジュール)モードのレプリケーションを指定します。新しいスナップショットが取得され、可能な場合は、指定した頻度でレプリケートされます。接尾辞を指定して、間隔の測定単位を指定する必要があります。接尾辞は、`s` (秒)、`m` (分)、`h` (時間)、`d` (日)または`w` (週)のいずれかにする必要があります。たとえば、`30m`は30分、`2h`は2時間です。
`-d` `trace_level`	トレース・レベル設定(0..6)を指定します。
`-z` `on`\|`off`	プライマリからスタンバイに送信されるレプリケーション・データ・ストリームの圧縮を有効または無効にします。
`-o sshCmdPath=pathname`	`ssh`コマンドへのパス名を指定します。
`-o sshStrictKey=ynvalue`	`ssh`で厳密なホスト・キー・チェックを使用するかどうかを指定します。`y`で始まる値で、このチェックは有効になります(デフォルト設定)。`n`で始まる値で、チェックは無効になります。
`-o sshCipher=ciphername`	セッションを暗号化するために`ssh`に渡される暗号を指定します。
`primary_mount_point`	プライマリ・ファイル・システムがマウントされるディレクトリを指定します。

acfsutil repl upgradeコマンドは、スナップショットベースのレプリケーションを使用するために、アクティブな既存のレプリケーション関係をアップグレードすることをサポートします。アップグレード・プロセスの目的は、レプリケーションを終了または再開せずに、レプリケーション・プロセスでデータの失うことなく、現在のプライマリ・ファイル・システムとスタンバイ・ファイル・システムの間にアクティブなスナップショットベースのレプリケーション関係を提供することです。

アップグレード手順を開始する前に、プライマリ・ファイル・システムがクラスタの1つのノードにのみマウントされていることを確認する必要があります。最適なアップグレードを保証するには、プライマリ・ファイル・システムまたはスタンバイ・ファイル・システムを対象とするアプリケーション・アクティビティを停止する必要がありますが、この推奨を無視してもアップグレードは続行されます。

ノート:

アップグレードを開始したら、プロセスは完了する必要があります。acfsutil repl upgrade prepare操作は、-uオプションを使用して元に戻すことができます。しかし、acfsutil repl upgrade standby操作が開始されると、アップグレード・プロセス全体を完了する必要があります。その時点から、アップグレードの停止または取消しのための対処はありません。

アップグレード・プロセスを開始するには、まずプライマリ・クラスタでacfsutil repl upgrade prepareコマンドを実行します。このコマンドは、スナップショットベースのレプリケーションに使用されるユーザー名およびホスト名またはインタフェース名の他、プライマリ・マウント・ポイントも指定します。ユーザー名およびホスト名は、acfsutil repl init primaryコマンドのスナップショットベースのレプリケーション用オプションと同様に、—sオプションを使用して指定します。

次に、スタンバイ・サイトをアップグレードします。スタンバイで、acfsutil repl upgrade standbyコマンドを実行します。このコマンドは、スナップショットベースのレプリケーションに使用されるスタンバイ・マウント・ポイントを指定します。

このコマンドを発行したら、acfsutil repl upgrade primaryコマンドを発行してアップグレードを完了する必要があります。

スタンバイ・サイトでacfsutil repl upgrade standbyコマンドを実行したら、プライマリ・サイトでacfsutil repl upgrade primaryコマンドを実行して、スナップショットベースのレプリケーションへのアップグレードを完了する必要があります。このコマンドは、元のレプリケーション・プロセスを自動的に終了し、スナップショットベースのレプリケーションを開始します。acfsutil repl upgrade primaryは、acfsutil repl init primaryコマンドで受け入れられたスナップショットベースのレプリケーション用のコマンドライン・オプションを受け入れます(ただし-mオプション、-sオプションおよびタグ名を除きます)。-mオプションと-sオプションに必要な情報は、他のソースから取得されています。元のレプリケーション関係に指定されたタグ名は、新しい関係に自動的に移動されます。Oracle ACFSタグの詳細は、「Oracle ACFSタグ付け」を参照してください。

指定されたソケット、キャラクタ・デバイス・ファイルまたはブロック・デバイス・ファイルをサポートするプラットフォームでは、スナップショットベースのレプリケーションでこれらのファイル・タイプはレプリケートされません。しかし、acfsutil repl upgradeプロセスでは、スタンバイ・ファイル・システムにすでに存在するこれらのタイプのファイルは維持されます。これ以上更新されることはありませんが、アップグレードの一環として削除されることもありません。

例

次に、acfsutil repl upgradeコマンドの使用例を示します。

例16-39 acfsutil repl upgradeコマンドの使用方法

# /sbin/acfsutil repl upgrade prepare -s my_repluser@my_host /my_primary/repl_data

# /sbin/acfsutil repl upgrade standby /my_standby/repl_data

# /sbin/acfsutil repl upgrade primary -i 2h /my_primary/repl_data