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

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

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

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

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

コマンド	説明
acfsutil repl bg	Oracle ACFSレプリケーション・バックグラウンド・プロセスを開始、停止、または情報を表示します。
acfsutil repl compare	Oracle ACFSストレージ・ロケーション上でファイルがレプリケートされていることを確認します。
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-30 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-26を参照してください。

注意:

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

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

acfsutil repl bg startまたはacfsutil repl bg stopコマンドを実行するには、システム管理者権限が必要です。acfsutil repl bg infoコマンドを実行するには、システム管理者またはOracle ASM管理者権限が必要です。

例

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

例16-26 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-31 acfsutil repl compareコマンドのオプション

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

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

通常、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オプションを指定して、ファイルの比較後に各ファイルの名前を出力できます。

このコマンドを実行するには、システム管理者またはOracle ASM管理者権限が必要です。

例

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

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

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

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 -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-32 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です。 統計は指定した時間単位でまとめられます。
-uuser	userをアクセス権が有効なユーザーとして使用して、現行ホストとstandby引数で指定されている各スタンバイ・ホスト間で現在構成されているホスト鍵およびユーザー鍵を検証します。
-o sshStrictKey=yn_value	sshで厳密なホスト鍵チェックを使用するかどうかを指定します。yで始まる値で、このチェックは有効になります(デフォルト設定)。nで始まる値で、チェックは無効になります。
-s	統計情報を表示します。統計を意味のあるものにするために、プライマリおよびスタンバイ・ノードがネットワーク・タイム・サービスを実行していることが重要です。
-t	レプリケーション・イベント・ログから転送レコードのみを表示します。
-v	冗長出力を表示します。
standby_host	-uオプションの指定時に処理されるスタンバイ・ホストのいずれかのホスト名またはIPアドレスを指定します。
[snap_shot@]primary_mount_point	レプリケーションに関与するロケーション(プライマリ・ファイル・システムがマウントされたディレクトリまたはスナップショットのいずれか)を指定します。
[snap_shot@]mount_point	レプリケートされるロケーション(マウントされたプライマリ・ファイル・システムまたはスタンバイ・ファイル・システムのマウント・ポイントまたはスナップショットのいずれか)を指定します。

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

—uオプションを指定する場合は、コマンドをプライマリ・クラスタの各ホストでroot (またはローカルSYSTEM)として実行し、スナップショットベースのレプリケーションで使用されるように、sshですべてのスタンバイ・ホストに接続し、各ホストでuserとしてログインできることを確認する必要があります。指定するuserは、acsfutil repl initコマンドで指定するrepluserと同じにする必要があります。各standby_host文字列は、スタンバイ・ノードのホスト名またはホストIPアドレスを指定します。指定する[snap_shot@]primary_mount_pointは、レプリケーションに使用されるプライマリ・クラスタ内のアクティブなOracle ACFSロケーションにする必要があります。-o sshStrictKey=noを使用して、このようなacsfutil repl init primaryの使用に対して厳密なホスト鍵チェックが無効になっていた(または無効にする)場合、ここでもオプションを指定してホスト鍵検証を省略する必要があります。[snap_shot@]primary_mount_pointでレプリケーションが現在アクティブかどうかに関係なく、acfsutil repl info -c -uはいつでも実行できます。

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

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

このコマンドを実行するには、システム管理者またはOracle ASM管理者権限が必要です。

例

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

例16-28 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]
                           [snap_shot@]primary_mount_point

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

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

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

オプション	説明
primary	プライマリ・ロケーションのレプリケーションを指定します。
standby	スタンバイ・ロケーションのレプリケーションを指定します。
-s repluser@netname	プライマリ・サイトがスタンバイ・サイトに接続するための標準ssh接続文字列を指定します。 接続文字列のrepluserは、スタンバイ・ノードでsshログインするユーザーです。最小限の権限を持つユーザー・アイデンティティを選択します。このユーザーは、Oracle ASM管理者権限を持ち、Oracle DBAグループに属する必要があります。 接続文字列のnetnameは、ホスト名、VIP名、IPアドレスなど、ネットワーク・エンドポイントを指定します。
-C	常時モードのレプリケーションを指定します。スナップショットが絶えず生成され、スタンバイ・サイトにレプリケートされます。各スナップショットのレプリケーションが完了するとすぐに、新しいスナップショットの生成が開始されます。
—M	手動モードのレプリケーションを指定します。初回レプリケーション操作が実行された後、以降のレプリケーションは、acfsutil repl syncを実行して手動で要求されるまで行われません。
—iinterval	間隔(スケジュール)モードのレプリケーションを指定します。新しいスナップショットが取得され、可能な場合は、指定した頻度でレプリケートされます。接尾辞を指定して、間隔の測定単位を指定する必要があります。接尾辞は、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コマンドへのパス名を指定します。
-o sshStrictKey=ynvalue	sshで厳密なホスト鍵チェックを使用するかどうかを指定します。yで始まる値で、このチェックは有効になります(デフォルト設定)。nで始まる値で、チェックは無効になります。
-o sshCipher=ciphername	セッションを暗号化するためにsshに渡される暗号を指定します。
-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ロケーションは、プライマリ・ロケーションとスタンバイ・ロケーションの両方として構成できません。レプリケーションを同じホスト上または同じクラスタ内に構成する場合、プライマリ・ロケーションとスタンバイ・ロケーションは同じ名前のマウント・ポイントを使用できません。

プライマリ・ロケーションまたはスタンバイ・ロケーションをホストするいずれかのサイトがWindows上で稼働している場合は、どちらのサイトもWindows上で稼働している必要があります。Linux、SolarisまたはAIXのオペレーティング・システムの組合せで稼働しているサイト間ではレプリケーションが可能です。

このコマンドを実行するには、システム管理者権限が必要です。

例

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

例16-29 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-34 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が発行されるまで、このレプリケーションに関して操作は実行されません。

このコマンドを実行するには、システム管理者またはOracle ASM管理者権限が必要です。

例

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

例16-30 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-35 acfsutil repl resumeコマンドのオプション

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

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

このコマンドを実行するには、システム管理者またはOracle ASM管理者権限が必要です。

例

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

例16-31 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-36 acfsutil repl reverseコマンドのオプション

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

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

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

2. ロール・リバーサルを完了するには、スタンバイ・クラスタ内でacfsutil repl reverse standby操作を実行します。この手順は、現在のスタンバイ・レプリケーション・ロケーションをプライマリ・ロケーションに変換し、次に、新しいプライマリから新しいスタンバイへのレプリケーションを再開します。

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

例

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

例16-32 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-37 acfsutil repl syncコマンドのオプション

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

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

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

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

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

• acfsutil repl syncを実行します。

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

このコマンドを実行するには、システム管理者またはOracle ASM管理者権限が必要です。

例

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

例16-33 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 [immediate] [-k] [-d trace_level] [snap_shot@]mount_point 

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

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

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

オプション	説明
primary	プライマリ・ロケーションでレプリケーションを停止します。
standby	スタンバイ・ロケーションでレプリケーションを停止します。
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コマンドを使用できます。

このコマンドを実行するには、システム管理者権限が必要です。

例

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

例16-34 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-39 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を指定します。

このコマンドを実行するには、システム管理者またはOracle ASM管理者権限が必要です。

例

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

例16-35 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 | -i interval] 
                      [-d trace_level] [-z {on | off}] 
                      [-o sshCmdPath=pathname] [-o sshStrictKey=ynvalue] [-o sshCipher=ciphername]
                      [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-40 acfsutil repl updateコマンドのオプション

オプション	説明
-s repluser@netname	プライマリ・サイトがスタンバイ・サイトに接続するための標準ssh接続文字列を指定します。 接続文字列のrepluserは、スタンバイ・ノードでsshログインするユーザーです。最小限の権限を持つユーザー・アイデンティティを選択します。このユーザーは、Oracle ASM管理者権限を持ち、Oracle DBAグループに属する必要があります。 接続文字列のnetnameは、ホスト名、VIP名、IPアドレスなど、ネットワーク・エンドポイントを指定します。
—C	常時モードのレプリケーションを指定します。スナップショットが絶えず生成され、スタンバイ・サイトにレプリケートされます。各スナップショットのレプリケーションが完了するとすぐに、新しいスナップショットの生成が開始されます。
—iinterval	間隔(スケジュール)モードのレプリケーションを指定します。新しいスナップショットが取得され、可能な場合は、指定した頻度でレプリケートされます。接尾辞を指定して、間隔の測定単位を指定する必要があります。接尾辞は、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に渡される暗号を指定します。
-u	repluserを指定します。
[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-36に、acfsutil repl updateコマンドの使用を示します。

例16-36 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 | -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-41 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	常時モードのレプリケーションを指定します。スナップショットが絶えず生成され、スタンバイ・サイトにレプリケートされます。各スナップショットのレプリケーションが完了するとすぐに、新しいスナップショットの生成が開始されます。
—iinterval	間隔(スケジュール)モードのレプリケーションを指定します。新しいスナップショットが取得され、可能な場合は、指定した頻度でレプリケートされます。接尾辞を指定して、間隔の測定単位を指定する必要があります。接尾辞は、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-37 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