Sun Cluster Geographic Edition のシステム管理

第 14 章スイッチオーバーとテイクオーバーの動作のカスタマイズ

この章では、保護グループの役割が二次クラスタから主クラスタに変わるときに実行されるスクリプトをどのような方法で作成できるかについて説明します。この章の内容は、次のとおりです。

役割変更アクションスクリプトの作成

Sun Cluster Geographic Edition ソフトウェアは、保護グループ内のクラスタが secondary 役割から primary 役割に変わるときにコマンドを実行するように構成できます。この役割変更は、スイッチオーバーまたはテイクオーバー操作の結果として発生する可能性があるものです。

このアクションコマンドは、役割が二次クラスタから主クラスタに変わるクラスタ上で、イベントについての情報を提供する引数を指定して実行します。スクリプトは、Sun Cluster Geographic Edition ソフトウェアがリソースグループをオンライン状態にする前に実行されます。スクリプトの実行は次のコマンドによって行われます。

# custom-action-command-path -o primary -c cluster-name \ 
 -s partnership-name protection-group-name user-arguments

custom-action-command-path

作成したアクションコマンドのパスを指定します。

-o primary

クラスタに、主クラスタの役割 (primary) を指定します。

-c cluster-name

新しく主クラスタの役割を担う二次クラスタの名前を指定します。

-s partnership-name

保護グループをホストするパートナーシップの名前を指定します。

protection-group-name

役割変更が行われる保護グループの名前を指定します。

user-arguments

Sun Cluster Geographic Edition に用意されているオプションがすべて渡されてから渡される静的引数を指定します。

必要に応じ、スクリプトを使用してこの自由書式の文字列を解析できます。たとえば、 name=sun.com,ip=10.1.2.3 のように、key=value のペアのリストを指定できます。また、-n sun.com -a 10.1.2.3.4 のように、複数のオプションを並べて指定することもできます。これらの引数の書式は、Sun Cluster Geographic Edition ソフトウェアによる制限を受けません。

役割変更アクションスクリプトの終了状態は、geopg switchover または geopg takeover コマンドの結果の一部として報告されます。アクションスクリプトが正常に実行された場合、終了状態は 0 になります。エラーや障害が発生した場合、終了状態は 0 以外になります。終了状態の値は、役割変更アクションのほかの側面には影響を及ぼしません。スイッチオーバーやテイクオーバーを実行すると、アクションスクリプトの終了状態とは関係なく、保護グループ内のアプリケーションリソースグループがオンライン状態になります。

ほかの処理に移行する前に、スクリプトの戻り値を待つべきです。アクションスクリプトを作成する場合は、そのスクリプトの実行に必要な時間を考慮してください。

例 14–1 DNS を更新するスイッチオーバーアクションスクリプト

この例では、nsupdate コマンドを使用して、新しいクラスタを指すようにホスト名を再構成するスクリプトの作成方法を示します。nsupdate コマンドについては、nsupdate(1M) のマニュアルページを参照してください。

companyX.com に接続を試みるクライアントは、ネームサービスによって、保護グループの主クラスタのアドレス cluster-paris として参照されます。主クラスタが応答しない場合、管理者は、保護グループを代替クラスタ cluster-newyork にスイッチオーバーします。

#!/bin/ksh
# script to update dns
# Assumes each cluster has an entry with name "lh-paris-1" in /etc/hosts
# but different value for the IP in each cluster
# for forward DNS (A) entry: will delete old entry for "lh-paris-1"
# and add one that is correct for "this cluster"
#
# For reverse (PTR) DNS entry, will just add one for this cluster. 
# Will NOT delete PTR record left over from old cluster. So
# eventually you will just have reverse lookup for the IP for both clusters
# doing reverse resolution to the same name (lh-paris-1.odyssey.com)
# This should be fine, as long as the forward resolution stays "correct"
#
# The blank line of input at the end of nsupdate is REQUIRED
#
# A short TTL is put on the new records (600 = 10 minutes)
# but you can't really control what kind of caching goes on on
# the client side


# get IP corresponding to name "lh-paris-1" on THIS Cluster
NEWIP=$(getent hosts lh-paris-1|cut -f1)

# this bit splits out the octets in order to add the reverse PTR entry
IFS=.
set $NEWIP
unset IFS

/usr/sbin/nsupdate <<ENDNSUPDATE
update delete ora-lh.odyssey.com A
update add ora-lh.odyssey.com 600 A $NEWIP
update add $4.$3.$2.$1.in-addr.arpa 600 PTR ora-lh.odyssey.com.

ENDNSUPDATE

スイッチオーバーまたはテイクオーバー時にスクリプトが実行されるように保護グループを構成する

スクリプトの作成後、スイッチオーバーまたはテイクオーバーの際にスクリプトが実行されるように、保護グループを構成する必要があります。スイッチオーバーまたはテイクオーバーが発生すると、主クラスタになるクラスタ上でスクリプトが実行されます。

スイッチオーバーまたはテイクオーバー時にスクリプトが実行されるように保護グループを構成する方法

手順

クラスタノードの 1 つにログインします。

この手順を行うには、Geo Management RBAC 権利プロファイルがユーザーに割り当てられている必要があります。RBAC の詳細は、「Sun Cluster Geographic Edition ソフトウェアと RBAC」を参照してください。

保護グループの RoleChange_ActionCmd プロパティーと RoleChange_ActionArgs プロパティーを構成します。
# geopg set-prop -p RoleChange_ActionCmd=fully-qualified-script -p RoleChange_ActionArgs=script-arguments
-p property-setting

保護グループのプロパティーを設定します

RoleChange_ActionCmd プロパティーを使用して、コマンドのパスを指定します。このパスは、保護グループをホストできるすべてのパートナークラスタの全ノードで有効にしてください。

RoleChange_ActionArgs プロパティーを使用して、アクションコマンドの実行時にコマンド行に追加する引数を定義します。

設定できるプロパティーについての詳細は、付録 A 「Sun Cluster Geographic Edition の標準プロパティー」を参照してください。

protection-group-name

保護グループの名前を指定します

例 14–2 クラスタのスイッチオーバーまたはテイクオーバー時にコマンドが実行されるように保護グループを構成する

次のコマンドを実行すると、newDNS という名前のカスタムコマンドを実行するように保護グループが構成されます。

# geopg set-prop -p RoleChange_ActionCmd=/usr/bin/newDNS \
-p RoleChange_ActionArgs=domain=companyx.com,ip=1.2.3.4 avspg