9.26　monswap（サーバの系切り替え）

形式

サーバの計画系切り替え

monswap {サーバ識別名|-g　グループ名}

サーバの強制系切り替え

monswap -f {サーバ識別名|-g　グループ名}

実行できるユーザ

スーパユーザ

機能

サーバの計画系切り替えまたはサーバの強制系切り替えを実行します。

サーバの計画系切り替え

monswap -gコマンドを実行すると，連動系切り替えでグループ化したサーバグループ全体の計画系切り替えをします。待機系のサーバグループ内に連動系切り替え待ち状態の待機サーバがある場合は，monswap -gコマンドを実行してサーバグループ全体の系切り替えをすることで，実行サーバとして起動できます。

マルチスタンバイ機能を使用している場合，monswapコマンドを実行したときに最も優先度が高い待機サーバに計画系切り替えをします。なお，現用系で待機サーバが稼働している場合（サーバ対応の環境設定のinitialオペランドにonlineが指定されているサーバが，待機サーバとして稼働している場合），この待機サーバを最も優先度が高い待機サーバと判断されます。

なお，このコマンドは，計画系切り替えの対象となる実行サーバが稼働している系で実行できます。

サーバの強制系切り替え

monswap -fコマンドを実行すると，実行サーバが稼働するOSを強制停止して，系切り替えをします。

マルチスタンバイ機能を使用している場合，monswapコマンドを実行したときに最も優先度が高い待機サーバに強制系切り替えをします。なお，現用系で待機サーバが稼働している場合（サーバ対応の環境設定のinitialオペランドにonlineが指定されているサーバが，待機サーバとして稼働している場合），この待機サーバを最も優先度が高い待機サーバと判断されます。

なお，このコマンドは，強制系切り替えの対象となるサーバ，グループがある実行系，およびグループがある待機系のどれからでも実行できます。

オプション

• サーバ識別名

  計画系切り替えをするサーバの識別名を指定します。ただし，グループ化されていないサーバに対して有効です。

• -g グループ名

  計画系切り替えをするサーバグループのグループ名を指定します。

  このオプションは，連動系切り替え可能状態のサーバグループに対して使用できます。

  グループ内で系切り替え可能なサーバが一つだけの場合は使用できないため，サーバ識別名指定でmonswapコマンドを実行してください。

• -f サーバ識別名

  強制系切り替えをするサーバの識別名を指定します。このオプションは，ペアになるサーバが存在しているサーバに対して使用できます。

• -f -g グループ名

  強制系切り替えをするサーバグループのグループ名を指定します。このオプションは，ペアになるサーバが存在しているサーバの，連動系切り替え可能状態のサーバグループに対して使用できます。

  グループ内で系切り替え可能なサーバが一つだけの場合は使用できないため，サーバ識別名指定でmonswap -fコマンドを実行してください。

リターンコード

値	意味
0	正常終了（計画系切り替えの要求を受け付けました）
0以外	異常終了

使用例

サーバの強制系切り替え（monswap -f サーバ識別名の場合）

>monswap -f server1
サーバ：server1の強制系切り替えをするため，ホスト：host1を強制停止します。
処理を続行するには大文字でYESを入力してください。
YES以外を入力した場合は，コマンド処理を中止します。
--->
> YES
KAMN703-I ホスト：host1を強制停止します。
KAMN459-I monswapコマンド処理を終了しました。

（凡例）　>：ユーザの操作を示します。

サーバの強制系切り替え（monswap -f -g グループ名の場合）

>monswap -f -g groupA
グループ：groupAの強制系切り替えをするため，ホスト：host1を強制停止します。
処理を続行するには大文字でYESを入力してください。
YES以外を入力した場合は，コマンド処理を中止します。
--->
> YES
KAMN703-I ホスト：host1を強制停止します。
KAMN459-I monswapコマンド処理を終了しました。

（凡例）　>：ユーザの操作を示します。

注意事項

• HAモニタの環境設定のexitcodeオペランドにtype2を指定した場合，次のメッセージ出力時にもリターンコードが0となります。

  KAMN212-E，KAMN215-E，KAMN216-E，KAMN322-E，KAMN323-E，KAMN328-E，KAMN330-E，KAMN426-E，KAMN431-E

• monswapコマンドのリターンとは非同期に計画系切り替えまたは強制系切り替えが行われます。

• 強制系切り替えの場合，対象サーバまたは対象グループが実行サーバとして稼働しているホストのOSを強制停止するため，同一ホストで稼働しているすべてのサーバが停止します。

• 系切り替え可能状態となっていない（待機サーバで，メッセージKAMN252-Iを出力していない）サーバは，強制系切り替えができません。