SafeCLUSTER/HA for Oracle 導入運用ガイド V1.1L21

3.2 Oracle起動/停止時のスクリプトの設定

Oracleインスタンスの起動時にOracleの状態を確認したり、起動/停止に連動してユーザスクリプトやアプリケーションを実行したりしたい場合について説明します。

■Oracleインスタンスの起動

Oracleインスタンスの起動は、次のように行われます。

*%HAORACLE_PATH%は本製品をインストールしたパスです。

1. %HAORACLE_PATH%\usr\start_before.bat の実行
2. OradimコマンドでのOracle起動
3. %HAORACLE_PATH%\usr\start_after.bat の実行

実行したいユーザシェルスクリプトやアプリケーションがある場合は、サンプルを参考にして各スクリプトに記述してください。

スクリプト	実行のタイミング
start_before.bat	Oracleインスタンスの起動前に呼び出されます。
start_after.bat	Oracleインスタンスの起動後に呼び出されます。

各ファイルが存在しない場合は、処理は行われません。

■Oracleインスタンスの停止

Oracleインスタンスの停止は、次のように行われます。

1. %HAORACLE_PATH%\usr\stop_before.bat の実行
2. Oracleインスタンスのshutdown、サービスの停止
3. %HAORACLE_PATH%\usr\stop_after.bat の実行

実行したいユーザスクリプトやアプリケーションがある場合は、サンプルを参考にして各シェルスクリプトに記述してください。

スクリプト	実行のタイミング
stop_before.bat	Oracleインスタンスの停止処理前に呼び出されます。
stop_after.bat	Oracleインスタンスの停止処理後に呼び出されます。

各ファイルが存在しない場合は、処理は行われません。

■運用例

Oracleインスタンスの起動停止に連動して、アプリケーションの起動停止を行う場合、次のように設定します。

1. %HAORACLE_PATH%\usr\start_after.bat

   Oracleインスタンスの起動後に呼び出されるスクリプト内に、アプリケーションの起動を記載します。

   @echo off
   
   start C:\app.exe
   exit 0

   アプリケーションが常駐するプログラムの場合は必ずstartコマンドで呼び出してください。アプリケーション実行時に処理が復帰しなくなり、Oracle起動処理が停止してしまいます。

2. %HAORACLE_PATH%\usr\stop_before.bat

   Oracleインスタンスの停止前に呼び出されるスクリプト内に、アプリケーションの停止を記載します。

   @echo off
   
   start "C:\app.exe stop"
   
   exit 0

   アプリケーションの停止に時間がかかる場合や、復帰しなくなる可能性のある場合は、必ずstartコマンドで実行してください。

■注意事項

• 各バッチファイルはシステム権限で実行されます。
  
• 環境設定ファイルで定義されている ORACLE_SID が 環境変数%ORACLE_SID% として引き継がれますので必要に応じて使用してください。
  
• 各バッチファイルの終了コードはクラスタの動作には影響ありませんが、終了コードが0以外の値だった場合、HAOracleのログに終了コードが出力されます。
  
• 各バッチファイルは、必ず復帰しなければなりません。
  
  Oracle起動時（クラスタサービス起動時等）に呼び出されるstart_before.batにおいて、復帰しないプログラムを実行した場合、Oracleは起動されず、起動処理でタイムアウトが発生しクラスタサービスが起動しません。
  この場合は、次のようにstartコマンドで実行してください。

  @echo off
  rem start_before.bat
  
  start C:\app.exe
  exit 0

  
  
• Oracleインスタンスの起動停止処理は、タイムアウト値が設定されています。タイムアウト値以内ですべての処理が終了するように、見積もってください。設定した時間内でOracleインスタンスの起動停止処理が完了しない場合は、フェイルオーバ等が発生する場合があります。