この節の情報は、Sun Cluster Apache Tomcat HA パラメタファイルの内容について理解するために使用してください。ここでは、Sun Cluster Apache Tomcat HA パラメタファイルの構造と内容について紹介するとともに、このファイルの変数を選択する方法について説明します。
Apache Tomcat HA は、パラメタファイルを使用して起動、停止、および検証を行う各コマンドにパラメタを渡します。このパラメタファイルは、いくつかの変数を設定する有効な korn シェルスクリプトとして作成する必要があります。このファイルの構造は次のとおりです。パラメタファイルの例は、Sun Cluster HA for Apache Tomcat の登録と構成を参照してください。
表 1–6 Apache Tomcat HA パラメタファイルの構造
変数 |
意味 |
---|---|
EnvScript |
これは、Apache Tomcat を所有するユーザー名のログインシェルによって決まる、ksh スクリプトまたは csh スクリプトです。このスクリプトは、Apache Tomcat インスタンスの起動と停止を行うために必要な Apache Tomcat 固有の環境変数を設定するために使用されます。 |
User |
Apache Tomcat インスタンスの所有者。 |
Basepath |
Basepath は、Tomcat bin ディレクトリが置かれているディレクトリの絶対パスです。通常は TOMCAT_HOME (3.x) または CATALINA_HOME (4.x) です。 |
Host |
変数 Host は、Apache Tomcat サーバープロセスの健全性を調べるホストを表します。このテストは、Host:Port に対する接続を介して行われます。 |
Port |
Apache Tomcat がサービスを行うポート。この Port と、Host を併用して、Apache Tomcat サーバープロセスの健全性を調べます。 |
TestCmd |
この変数は、Apache Tomcat サーバープロセスの健全性を調べるためにそのプロセスに渡されるコマンドを示します。 |
ReturnString |
変数 ReturnString は、TestCmd に対する応答内に存在する必要がある文字列を示します。「Connection refused」という文字列は、Apache Tomcat サーバープロセスが稼動していない場合に応答内で使用されるので、この文字列は指定できません。 |
Startwait |
この変数は、Apache Tomcat の起動コマンドが完了したあと待機する時間を秒数で指定するために使用します。Apache Tomcat の起動コマンドが完了したあと Apache Tomcat サーバープロセスが完全に稼動可能な状態になるまで、多少時間がかかります。実際の秒数は、ハードウェアの速度と負荷によって異なります。通常は、10 秒から 20 秒の間を指定することをお勧めします。 |
上記のすべてのパラメタは、任意の時点で変更できます。唯一の違いは、どの時点で変更が適用されるかです。
Apache Tomcat HA パラメタファイルの次のパラメタは、Apache Tomcat の起動と停止に使用されます。これらのパラメタに対する変更は、Apache Tomcat リソースの再起動または無効にして有効にする操作によって適用されます。
EnvScript
User
Basepath
Startwait
Apache Tomcat HA パラメタファイルの次のパラメタは、障害モニター内で使用されます。これらのパラメタに対する変更は、Thorough_probe_interval ごとに適用されます。
Host
Port
TestCmd
ReturnString
アプリケーションの起動ページを利用し、TestCmd にget /startpage を設定します。この場合は、起動ページに含まれる文字列を ReturnString に設定します。この方法で、Apache Tomcat がユーザーのアプリケーションに対してサービスを提供していることを確認できます。
Apache Tomcat のデフォルトの起動ページを使用し、TestCmd に get /default-startpage を設定します。この場合は、起動ページに含まれる文字列を ReturnString に設定します。この文字列は、配備された Apache Tomcat バージョンによって異なります。3.x の場合は Tomcat home であり、4.x の場合は CATALINA です。この方法で、Apache Tomcat がデフォルトのアプリケーションに対してサービスを提供していることを確認できます。
Apache Tomcat にテスト用のアプリケーションを配備します。(Sun Cluster Apache Tomcat エージェントには付属していません) get /startpage-of-the-application を TestCmd に設定します。この場合は、起動ページに含まれる文字列を ReturnString に設定します。この方法で、Apache Tomcat がユーザーのテストアプリケーションに対してサービスを提供していることを確認できます。
上記のどの方法も適切でない場合は、get /a-page-which-does-not-exists を TestCmd に設定します。この場合は、Error Page に含まれる文字列を ReturnString に設定します。この方法では、存在しないページが配布されたことがわかるため、Apache Tomcat が稼動していることを確認できます。
ブラウザで hostname:port を指定して接続すれば、異なるページを評価できます。