2.4.1 Oracle 起動・停止時のスクリプトの設定

PRIMECLUSTER Wizard for Oracle 導入運用手引書 4.2 - Linux for Itanium 版 -

2.4.1 Oracle 起動・停止時のスクリプトの設定

PRIMECLUSTER Wizard for Oracle では、Oracle インスタンス、リスナーの起動・停止（Online 処理・Offline 処理）の途中、またはその前後で、ユーザー独自の処理を実行させることができます。例えば、Oracle インスタンス、リスナーの起動・停止に連動して、アプリケーションの起動・停止や、バッチ処理を実行することができます。

■スクリプトの種類

スクリプト			説明
起動系	PreOnlineScript		リソースの Online 処理の前に実行されます。 RMS Wizard (hvw コマンド) を使った userApplication 作成中に設定してください。
	OnlineScript		リソースとして登録された対象 (Oracle インスタンス、リスナー) の起動 (Online 処理) を行います。 Wizard for Oracle 内部で自動設定されるものであり、ユーザーが明示的に設定することはできません。
		prestartup*	スタンバイ運用の Oracle インスタンスリソースのみ設定可能です。 Oracle インスタンス起動処理 (Online 処理) において、インスタンス起動処理前に呼び出されます。Oracle の状態 (V$INSTANCE ビューの STATUS 列) を意識する必要がある場合、呼び出された側で考慮する必要があります。 /opt/FJSVclora/usr 配下に "prestartup" で始まる実行形式ファイルを格納してください。
		nomount*	スタンバイ運用の Oracle インスタンスリソースのみ設定可能です。 Oracle インスタンス起動処理 (Online 処理) において、Oracle の状態 (V$INSTANCE ビューの STATUS 列) が "STARTED" のときに呼び出されます。 /opt/FJSVclora/usr 配下に "nomount" で始まる実行形式ファイルを格納してください。
		mount*	スタンバイ運用の Oracle インスタンスリソースのみ設定可能です。 Oracle インスタンス起動処理 (Online 処理) において、Oracle の状態 (V$INSTANCE ビューの STATUS 列) が "MOUNTED" のときに呼び出されます。 /opt/FJSVclora/usr 配下に "mount" で始まる実行形式ファイルを格納してください。
	PostOnlineScript		リソースの Online 処理の後に実行されます。 RMS Wizard (hvw コマンド) を使った userApplication 作成中に設定してください。
停止系	PreOfflineScript		リソースの Offline 処理の前に実行されます。 RMS Wizard (hvw コマンド) を使った userApplication 作成中に設定してください。
	OfflineScript		リソースとして登録された対象 (Oracle インスタンス、リスナー) の停止 (Offline 処理) を行います。 Wizard for Oracle 内部で自動設定されるものであり、ユーザーが明示的に設定することはできません。
	PostOfflineScript		リソースの Offline 処理の後に実行されます。 RMS Wizard (hvw コマンド) を使った userApplication 作成中に設定してください。
その他	FaultScript		リソース異常発生時に実行されます。 RMS Wizard (hvw コマンド) を使った userApplication 作成中に設定してください。

次のスクリプトの設定方法は、「2.2.9」の手順“5”または“6”、「2.3.4」の手順“8”、「2.3.5」の手順“12”を参照してください。

PreOnlineScript
PostOnlineScript
PreOfflineScript
PostOfflineScript
FaultScript
次のスクリプトの処理内容は、「3.1」を参照してください。
OnlineScript (Online 処理)
OfflineScript (Offline 処理)

■スクリプトの実行順序

スクリプト			userApplication 起動時	リソースの AutoRecover 時	userApplication 停止 (通常時)	userApplication 停止 (リソース異常時)
起動系	PreOnlineScript		1	―	―	―
	OnlineScript		2	1	―	―
		prestartup*	3	2	―	―
		nomount*	4	3	―	―
		mount*	5	4	―	―
	PostOnlineScript		6	5	―	―
停止系	PreOfflineScript		―	―	1	2
	OfflineScript		―	―	2	3
	PostOfflineScript		―	―	3	4
その他	FaultScript		―	―	―	1

Oracle インスタンスとリスナーが StartPriority=Listener でリソース登録されたスタンバイ運用の場合、以下の順序で実行されます。

userApplication 起動時
全てのリソースの PreOnlineScript が最初に実行されることに注意してください。

リスナーリソースの PreOnlineScript
Oracle インスタンスリソースの PreOnlineScript
リスナーリソースの OnlineScript
リスナーリソースの PostOnlineScript
Oracle インスタンスリソースの OnlineScript (prestartup*・nomount*・mount* 含む)
Oracle インスタンスリソースの PostOnlineScript

リスナーリソースの AutoRecover 時
PreOnlineScript は実行されないことに注意してください。

リスナーリソースの OnlineScript
リスナーリソースの PostOnlineScript

userApplication 停止時
全てのリソースの PreOfflineScript が最初に実行されることに注意してください。

Oracle インスタンスリソースの PreOfflineScript
リスナーリソースの PreOfflineScript
Oracle インスタンスリソースの OfflineScript
Oracle インスタンスリソースの PostOfflineScript
リスナーリソースの OfflineScript
リスナーリソースの PostOfflineScript

リスナーリソース異常に伴う userApplication 停止時
FaultScript は異常が発生したリソースだけでなく、その上位リソース (後に起動し、先に停止するリソース) でも実行されることに注意してください。

リスナーリソースの FaultScript
Oracle インスタンスリソースの FaultScript
Oracle インスタンスリソースの PreOfflineScript
リスナーリソースの PreOfflineScript
Oracle インスタンスリソースの OfflineScript
Oracle インスタンスリソースの PostOfflineScript
リスナーリソースの OfflineScript
リスナーリソースの PostOfflineScript

■留意事項 (PreOnlineScript・PostOnlineScript・PreOfflineScript・PostOfflineScript・FaultScript)

root ユーザーで実行されます。
exit コード 0 で正常終了です。0 以外の場合は異常終了となり、Online 処理または Offline 処理が異常となります。
スクリプトの実行時間が ScriptTimeout を超えると異常終了となり、Online 処理または Offline 処理が異常となります。
各スクリプトには、RMS で定義された環境変数が設定されています。

各スクリプトの詳細は「PRIMECLUSTER RMS 導入運用手引書」の「2.6.3 スクリプト」などを参照してください。

■留意事項 (prestartup・nomount・mount*)

格納場所は /opt/FJSVclora/usr 配下とし、複数存在する場合は名前順に実行されます。
正常終了時は 0、異常終了時は 0 以外で復帰してください。
異常終了した場合、Oracle インスタンス起動処理自体もその時点で異常終了します。
root ユーザーで実行されます。
次のパラメータが渡されます。
- $1 : $ORACLE_HOME
- $2 : $ORACLE_SID
- $3 : Oracleユーザー名
起動タイムアウト時間内に終了しなかった場合、異常終了と見なされます。
起動タイムアウト時間については、「2.2.9」の手順“5”または“6”、「2.3.4」の手順“8”、「2.3.5」の手順“12”を参照してください。

これらのスクリプトは、スタンバイ運用の Oracle インスタンスリソースのみ使用可能です。

その他のリソースや Oracle RAC スケーラブル運用では使用できません。