名前 | 形式 | 説明 | サブコマンド | オプション | オペランド | 詳細説明 | 終了状態 | 使用例 | 属性 | 参照
geopg コマンドを使用すると、保護グループの構成と維持を行うことができます。たとえば、次のような作業を行えます。
パートナーシップに参加するクラスタ間での保護グループの構成。この作業には、関連付けられたデータ複製パラメータの構成が含まれます。
リソースグループおよびデータ複製ディスクデバイスグループの追加または削除。
保護グループのプロパティーと関連付けられたデータ複製パラメータの追加、変更、および削除。
特定の保護グループまたはすべての定義済み保護グループの現在の構成の取得。
保護グループのアクティブ化。
保護グループのアクティブ化の解除。
保護グループのロールの切り替え。
保護グループの主ロールのテイクオーバー。
保護グループを作成する前には、保護グループをホストするクラスタがすでにパートナーシップ内に存在する必要があります。
geopg コマンドを実行して保護グループまたはデータ複製ディスクデバイスグループの作成、変更、または削除を行うには、コマンド実行者に、適切な、役割に基づくアクセス制御 (Role-Based Access Control、RBAC) 権利のプロファイルが割り当てられている必要があります。
ルートアクセス権を持っている場合は、あらゆる処理を行う権限があります。ルートアクセス権を持っていない場合は、次の RBAC 権が適用されます。
基本的な Solaris ユーザー。Sun Cluster Geographic Edition エンティティーについての情報は、geopg list、geohb list、geops list などのコマンドを実行して確認できます。
Geo 管理。「基本的な Solaris ユーザー」アクセス権を持つユーザーに認められているあらゆる読み取り処理が行えます。また、geohb create、geopg switchover、geoadm start、geoadm stop などの管理作業や構成作業も行うことができます。
詳細については、rbac(5) のマニュアルページと『Sun Cluster Geographic Edition のシステム管理』の 「Sun Cluster Geographic Editon ソフトウェアと RBAC」 を参照してください。
このコマンドの書式は次のとおりです。
geopg [subcommand] [options] [operands]
subcommand は、options に -?、-o、- V、または -v が指定されている場合にかぎり省略可能です。
このコマンドの各オプションには、長い形式と短い形式があります。この 2 つの形式については、このマニュアルページのオプションの節で説明します。
geopg start コマンドは、主クラスタと二次クラスタの両方で保護グループをアクティブにします。このアクティブ化により、Sun Cluster Geographic Edition は、保護グループ内のリソースグループの管理を開始します。使用するコマンドの書式とコマンドを実行するクラスタによっては、保護グループをアクティブにしても、そのクラスタでリソースグループが起動されない場合があります。リソースグループは、主クラスタ上でのみ起動し、オンライン化されます。
-e オプションは、geopgstart コマンドの有効範囲を定義します。-e local を指定すると、geopg start コマンドは、コマンドを実行するクラスタでのみ実行されます。-e global を指定すると、geopg start コマンドは、パートナーシップ内の両方のクラスタで実行されます。
これらの異なるコマンド書式は、次に示す効果を持っています。
geopg start -e local が主クラスタで実行された場合および、geopg start -e global がいずれ のクラスタで実行された場合 : Sun Cluster Geographic Edition ソフトウェアは、パートナーシップ内の両方のクラスタで保護グループをアクティブ にします。このソフトウェアは、主クラスタでのみリソースグループをオンライン化します。リソースグループは、管理状態に置かれます。
geopg start -e local が二次クラスタ上で実行される場合 : Sun Cluster Geographic Edition ソフトウェアは、二次クラスタでのみ保護グループをアクティブにします。二次クラスタでは、リソースグループは起動されません。リソースグループは、管理されない状態に置かれます。
サポートされているサブコマンドは次のとおりです。
データ複製ディスクデバイスグループを保護グループの一部にすることができます。
アプリケーションリソースグループを保護グループの一部にすることができます。
追加するリソースグループがオンラインである場合、リソースグループを追加する前に保護グループもアクティブにする必要があります。geopg add-resource-group コマンドが失敗するのは、保護グループが非アクティブであり、追加されるリソースグループがオンラインである場合です。
オフラインであるリソースグループを追加する時点で保護グループがすでに起動されている場合、リソースグループはオフラインのままになります。オフラインのリソースグループを起動するには、コマンド geopg start を実行します。
保護グループまたはデータ複製ディスクデバイスグループを作成します。
保護グループを作成する場合、管理モジュールはローカル構成を更新し、リモートクラスタに構成の変更を通知します。
保護グループを削除します。
パートナークラスタ上ですでに作成されている保護グループ用のローカル構成を作成します。
パートナークラスタが接続されている場合、既存の保護グループの構成は、保護グループをホストするパートナークラスタに伝播されます。パートナークラスタが切断されている間、またはパートナーがパートナーシップに参加する前に保護グループを作成する場合、geopg get コマンドを実行して構成を伝播する必要があります。
定義済みの保護グループ
保護グループに組み込まれたリソースグループ
運用状態の情報
データ複製ディスクデバイスグループのプロパティーを変更します。
保護グループからデータ複製ディスクデバイスグループを削除します。
データ複製デバイスグループを削除しても、データ複製は停止せず、またそのデータ複製デバイスグループのデータ複製状態は変更されません。
保護グループからリソースグループを削除します。
アプリケーションリソースグループを削除しても、アプリケーションリソースグループは Offline 状態に変更されません。
保護グループのプロパティーを変更します。
保護グループをアクティブにします。サブコマンドがアクティブにされた後、クラスタ上の保護グループのロールは、ユーザーが保護グループを構成した時点でユーザーがクラスタに割り当てたロールになります。
start サブコマンドは、Sun Cluster のコマンドを使用してリソースおよびリソースグループをオンラインにします。
保護グループは、次のレベルでアクティブにすることができます。
保護グループが構成されたすべてのクラスタ上。
主クラスタまたは二次クラスタ上。
保護グループのアクティブ化とその保護グループ内のリソースグループに対する効果については、このマニュアルページの「説明」セクションにある「保護グループの起動方法を理解する」を参照してください。
保護グループをアクティブにすることで、次のイベントを実行できるようになります。
保護グループの構成の検証。
クラスタによる、ある操作が完了したかどうかの判別。
使用するデータ複製機能によっては、データの複製が開始される場合もあります。
Sun StorageTek Availability Suite ソフトウェアを使用している場合は、主クラスタからのみデータの複製を開始できます。Hitachi TrueCopy や EMC Symmetrix Remote Data Facility ソフトウェアを使用している場合は、主クラスタまたは二次クラスタのどちらからでもデータの複製を開始できます。
サポートされているどのデータ複製ソフトウェアでも、コマンドのこの書式を使用する場合は、-n オプションを使用しないでください。s
保護されたアプリケーションの起動。
パートナーに到達可能である場合、パートナークラスタへの保護グループのアクティブ化の通知。
「オンライン」となっている保護グループは、アクティブな保護グループです。
保護グループのアクティブ化を解除します。保護グループは、次のレベルでアクティブ化を解除できます。
保護グループが構成されたすべてのクラスタ上。
主クラスタまたは二次クラスタ上。
保護グループを停止すると、次のイベントを発生させることができます。
保護グループの非アクティブ化。
使用しているデータ複製機能によっては、データ複製の停止。保護グループを停止する前に、保護グループからリソースグループを削除すると、データの複製が停止するのを防止できます。
Sun StorageTek Availability Suite ソフトウェアを使用している場合は、主クラスタからのみデータの複製を停止できます。Hitachi TrueCopy や EMC Symmetrix Remote Data Facility ソフトウェアを使用している場合は、主クラスタまたは二次クラスタのどちらからでもデータの複製を停止できます。
サポートされているどのデータ複製ソフトウェアでも、コマンドのこの書式を使用する場合は、-D オプションを使用しないでください。
保護されたアプリケーションの停止。
アプリケーションクラスタが到達可能である場合、パートナークラスタは、保護グループが停止したという通知を受け取ります。
保護グループのクラスタの割り当て済みロールを切り替えます。
パートナークラスタの状態を考慮することなく、あるクラスタを強制的に 主 クラスタにします。
二次クラスタからテイクオーバーを行う場合で、クラスタがパートナークラスタと通信できる場合、Sun Cluster Geographic Edition ソフトウェアは、パートナークラスタのロールを切り替えて、パートナークラスタを新しい二次クラスタにします。この操作は、スイッチオーバーと同じではありません。保護グループは新しい二次クラスタ上で非アクティブになります。
geopg takeover コマンドが正常に実行されたあとで二次クラスタ上の保護グループを再びアクティブにする場合は、データ回復とデータの同期処理が必要になることがあります。
可能な場合は、geopg takeover コマンドの代わりに geopg switchover コマンドを実行して、パートナークラスタ間での調整を行い、複製されたデータの損失を回避します。
geopg takeover コマンドは、新しい主クラスタが緊急に必要になる場合だけ実行してください。そのような状況では、潜在的なデータの消失と修復のほか、二次クラスタ上の保護グループの再アクティブ化が避けられません。
ローカル保護グループの構成情報とそのパートナーの構成情報を再同期させます。
動的な値の妥当性検査を実行することで、ローカルクラスタ上の保護グループを検証します。
次のオプションがサポートされています。
ヘルプ情報を表示します。このオプションを指定すると、その他の処理は実行されません。
このオプションを指定するとき、サブコマンドは指定してもしなくてもかまいません。
このオプションをサブコマンドなしで指定した場合、このコマンドのサブコマンドリストが表示されます。
このオプションをサブコマンド付きで指定した場合、そのサブコマンドの使用方法が表示されます。
一部のシェルでは、疑問符は特別な文字として解釈される場合があります。引用符 (-"?") またはエスケープ文字を使用して、パターンマッチングを回避します。
保護グループをアクティブにしたまま、データ複製のみのアクティブ化を解除する必要があることを指定します。このオプションを使用しない場合、保護グループ全体でアクティブ化が解除されます。データ複製サブシステムをすでに停止した保護グループを停止するには、geopg stop コマンドをもう一度実行し、このオプションを除外する必要があります。
保護グループのクラスタ間のデータ複製に関するデータ複製メカニズムを指定します。
datareptype は、次のいずれかの文字列である必要があります。
データ複製メカニズムが、パッチを適用した Sun StorageTek Availability Suite Remote Mirror Release であることを指定します。
データ複製メカニズムが動的な EMC Symmetrix Remote Data Facility であることを指定します。
データ複製メカニズムが Hitachi TrueCopy であることを指定します。
コマンドをローカルクラスタに対してだけ実行させるか ( local)、あるいは保護グループが構成されている両方のクラスタに対して実行させるか (global) を指定します。
ユーザーに確認することなく、強制的にコマンドを実行します。
保護グループの主クラスタにするクラスタの名前を指定します。
データ複製を、当該保護グループに使用してはならないことを指定します。このオプションを省略すると、データ複製は保護グループと同時に始まります。
create サブコマンドととに使用した場合、ローカルクラスタのロールを PRIMARY または SECONDARY のいずれかに指定します。geopg switchover コマンドを実行することで、クラスタのロールを変更できます。
保護グループのプロパティーを設定します。
保護グループプロパティーに値を割り当てるには、 name=statement ペア文を使用します。複数の文を使用して、一度に複数のプロパティーを設定できます。
定義済みのプロパティーについては、詳細説明の節を参照してください。
当該保護グループをアクティブにできるクラスタを含むパートナーシップの名前を指定します。
コマンドのバージョンを表示します。
このオプションには、サブコマンドやオペランドなどのオプションは指定しないでください。サブコマンドやオペランドなどのオプションは無視されます。-V オプションは、コマンドのバージョンを表示するだけです。その他の処理は行いません。
次のオペランドを指定できます。
作成されるディスクデバイスグループの名前を指定します。
保護グループの名前を指定します。このオプションを使用して指定されている保護グループがすでに存在する場合、create サブコマンドは失敗します。指定された保護グループが有効ではない場合、modify サブコマンドは失敗します。
保護グループに追加する、または保護グループから削除するリソースグループをコンマで区切って指定します。指定したリソースグループはすでに定義されている必要があります。
リソースグループを追加する前に、保護グループはアクティブである必要があります。geopg add-resource-group コマンドが失敗するのは、保護グループが非アクティブであり、追加されるリソースグループがオンラインである場合です。
リソースグループを追加する時点で保護グループがすでに起動されている場合、リソースグループはオフラインのままになります。geopg start コマンドを実行することで、手動でリソースグループを起動する必要があります。
次の表にプロパティーを示します。これらのプロパティーの値は作成時に割り当てられます。true や false などのプロパティー値は、大文字と小文字は区別されません。プロパティー調整のタイミングについての詳細は、プロパティー説明に示されています。
保護グループについて説明します。
オプションのプロパティーです。
次のように入力します。文字列型。
デフォルト値 : なし
チューニングの推奨事項: 作成時に割り当て、実行時に調整することを推奨します。
ロール変更コールバックコマンドの実行時に、コマンド行の最後にあるシステム定義引数に続く文字列を指定します。
オプションのプロパティーです。
次のように入力します。文字列型。
デフォルト値 : なし
チューニングの推奨事項: 作成時に割り当て、実行時に調整することを推奨します。
保護グループの主クラスタが変わる場合に実行する実行可能コマンドの絶対パスを指定します。このパスは、保護グループをホストするすべてのパートナークラスタで有効である必要があります。
オプションのプロパティーです。
次のように入力します。文字列型。
デフォルト値 : なし
チューニングの推奨事項: 作成時に割り当て、実行時に調整することを推奨します。
Sun Cluster Geographic Edition ソフトウェアが、start、stop、switchover、takeover などの geopg コマンドの実行後、応答を待つ最長時間を秒数で指定します。timeout 内にコマンドから応答がない場合、Sun Cluster Geographic Edition ソフトウェアは、配下で実行されたコマンドが最終的に成功する場合でも、操作がタイムアウトになったと報告します。
timeout 間隔は、クラスタごとに処理に適用されます。ローカルスコープを持つ処理が指定された timeout 間隔を過ぎても完了しない場合、この処理はタイムアウトします。
適用範囲が Global である処理には、ローカルクラスタに対するアクションとリモートクラスタに対するアクションが含まれます。ローカルアクションとリモートアクションは、個別に時間が測定されます。このため、指定された timeout 間隔を過ぎてもローカル処理が完了しないか、指定された timeout 間隔を過ぎてもリモート処理が完了しない場合、グローバルスコープを持つ処理はタイムアウトします。
たとえば、次の処理はローカルスコープ指定で開始されます。
# geopg start -e local protectiongroupname |
timeout プロパティーを 200 秒に設定すると、200 秒を過ぎても geopg start 処理が完了しないとこの処理はタイムアウトします。
同じ操作をグローバルスコープで行う場合、次のようにします。
# geopg start -e global protectiongroupname |
timeout プロパティーを 200 秒に設定すると、200 秒を過ぎてもローカルクラスタ上で処理が完了しないか、あるいは 200 秒を過ぎてもリモートクラスタ上で処理が完了しない場合、geopg start はタイムアウトします。ローカルアクションに 150 秒かかり、リモートアクションに 150 秒かかる場合、処理はタイムアウトしません。
保護グループの timeout 値は概算されます。保護グループに対するすべての処理が timeout 間隔に照らして計時されるわけではありません。たとえば、データ構造を初期化して処理の前提条件が満たされているか確認するためにかかる時間は、timeout 間隔内の時間として計算されません。
このリリースにおける timeout プロパティーの最大値は 1,000,000 秒です。
オプションのプロパティーです。
次のように入力します。整数です。少なくとも最小値 20 が必要です。
デフォルト値 : 200 秒。
チューニングの推奨事項: 作成時に割り当て、実行時に調整することを推奨します。
ファイル内で定義されているボリュームセットが有効であるかどうかを定義します。True か False のいずれかに設定します (大文字と小文字の区別なし)。
オプションのプロパティーです。
次のように入力します。ブール型。
チューニングの推奨事項: デバイスグループが保護グループに追加されたあとでこのプロパティーを調整することはできません。
デフォルト値 : False。
ディスクデバイスグループの複製に使用されるローカル論理ホスト名を定義します。論理ホスト名では下線 (_) を使用しないでください。
必須プロパティーです。
次のように入力します。文字列型。
チューニングの推奨事項: デバイスグループが保護グループに追加されたあとでこのプロパティーを調整することはできません。
デフォルト値 : なし
複製メカニズムのプライマリになることができるマシンのホスト名のリストです。このリストはコンマで区切ります。
オプションのプロパティーです。
次のように入力します。文字配列。
チューニングの推奨事項: このプロパティーを調整できるのは保護グループがアクティブでない状態の場合だけです。
デフォルト値 : 空。
ディスクデバイスグループの複製に使用されるリモート論理ホスト名を指定します。
必須プロパティーです。
次のように入力します。文字列型。
チューニングの推奨事項: デバイスグループが保護グループに追加されたあとでこのプロパティーを調整することはできません。
デフォルト値 : なし
データが書き込まれるディスクデバイスグループのリストです。リストはコンマで区切ります。
オプションのプロパティーです。
次のように入力します。文字配列。
チューニングの推奨事項: このプロパティーは、両方のパートナークラスタ上で保護グループがアクティブでない場合にのみ調整できます。
デフォルト値 : 空。
ディスクデバイスグループにより使用されるフェンスレベルを定義します。フェンスレベルにより、そのディスクデバイスグループの主ボリュームおよび二次ボリューム間での整合性のレベルが決定されます。とりうる値は data、status、never、および async です。
このプロパティーは、現在のペア状態が SMPL のときに、任意の有効な Fence_level に設定できます。
主クラスタ上のアプリケーション障害を防ぐには、Fence_level を never または async に指定します。Fence_level パラメタが never または async に設定されていないと、二次サイトが停止する際にデータ複製が正しく行われない可能性があります。
data と status は、特殊な状況下で必要になる場合があるため、Fence_level パラメータがこれらの値に設定されないようにするプログラムは使用しないでください。
data または status の Fence_level を使用する特別なニーズがある場合は、ご購入先に問い合わせてください。
必須プロパティーです。
次のように入力します。列挙型。
チューニングの推奨事項: このプロパティーを調整できるのは保護グループがアクティブでない状態の場合だけです。Hitachi TrueCopy デバイスグループの場合、ペアがすでに作成されていれば、このプロパティーはペアの現在の Fence_level のみに設定できます。既存のペアの Fence_level を変更したい場合は、先に Hitachi TrueCopy CCI コマンドを使用して Fence_level を変更したあと、Fence_level のプロパティーを調整します。
デフォルト値 : なし
複製メカニズムのプライマリになることができるマシンのホスト名のリストです。このリストはコンマで区切ります。
オプションのプロパティーです。
次のように入力します。文字配列。
チューニングの推奨事項: このプロパティーを調整できるのは保護グループがアクティブでない状態の場合だけです。
デフォルト値 : 空。
データが書き込まれるディスクデバイスグループのリストです。リストはコンマで区切ります。
オプションのプロパティーです。
次のように入力します。文字配列。
チューニングの推奨事項: このプロパティーはいつでも調整できます。
デフォルト値 : 空。
デバイス識別子を "SRDF Device Group" として指定します。このプロパティーは DG に設定します。
オプションのプロパティーです。
次のように入力します。文字列型。
チューニングの推奨事項: このプロパティーはいつでも調整できます。
デフォルト値 : DG。
複製メカニズムのプライマリになることができるマシンのホスト名のリストです。このリストはコンマで区切ります。
オプションのプロパティーです。
次のように入力します。文字配列。
チューニングの推奨事項: このプロパティーを調整できるのは保護グループがアクティブでない状態の場合だけです。
デフォルト値 : 空。
Symmetrix Remote Data 機能の主デバイスの識別情報を指定します。
必須プロパティーです。
次のように入力します。文字配列。
チューニングの推奨事項: このプロパティーはいつでも調整できます。
デフォルト値 : なし
Symmetrix Remote Data 機能の二次デバイスの識別情報を指定します。
必須プロパティーです。
次のように入力します。文字配列。
チューニングの推奨事項: このプロパティーはいつでも調整できます。
デフォルト値 : なし
次の geopg コマンドは、主クラスタ cluster-paris 上に、Sun StorageTek Availability Suite 保護グループを作成します。
# geopg create -s paris-newyork-ps -d avs -o primary \ -p Nodelist=phys-paris-1,phys-paris-2 avspg |
次の geopg コマンドは、データ複製を使用しないように構成されている保護グループを作成します。
# geopg create -s paris-newyork-ps -o primary example-pg |
次の geopg コマンドは、2 つのアプリケーションリソースグループ apprg1 と apprg2 をオンラインにしたまま保護グループ avspg を削除します。保護グループからアプリケーションリソースグループを除去し、続いて保護グループを削除します。
# geopg remove-resource-group apprg1,apprg2 avspg # geopg stop -e global avspg # geopg delete avspg |
次の geopg コマンドは、保護グループ avspg のタイムアウトのプロパティーを変更します。
# geopg set-prop -p Timeout=300 avspg |
次の geopg コマンドは、avspg 保護グループ内に、Sun StorageTek Availability Suite データ複製デバイスグループを作成します。
# geopg add-device-group -p Local_logical_host=lh-paris-1 \ -p Remote_logical_host=lh-newyork-1 avsdg avspg |
次の属性の詳細については、attributes(5) のマニュアルページを参照してください。
|
属性タイプ |
属性値 |
|---|---|
|
アーキテクチャー |
SPARC |
|
使用可能 |
SUNWscgctl |
|
インタフェースの安定性 |
発展中 |
名前 | 形式 | 説明 | サブコマンド | オプション | オペランド | 詳細説明 | 終了状態 | 使用例 | 属性 | 参照