Sun Cluster HA for Apache Tomcat をスケーラブルデータサービスまたはマルチマスターデータサービスとして登録して構成する方法 (Sun Cluster 3.1 Data Service for Apache Tomcat ガイド)

Sun Cluster 3.1 Data Service for Apache Tomcat ガイド

Sun Cluster HA for Apache Tomcat をスケーラブルデータサービスまたはマルチマスターデータサービスとして登録して構成する方法

この手順は、Sun Cluster HA for Apache Tomcat をスケーラブルデータサービスまたはマルチマスターデータサービスとして構成する場合に使用します。この手順は、Sun Cluster の初回のインストール時にこのデータサービスパッケージをインストールしている場合を想定しています。

この手順は、Apache Tomcat をスケーラブル構成またはマルチマスター構成で配備するために使用します。

Sun Cluster の初回のインストールの一部として Sun Cluster HA for Apache Tomcat パッケージをインストールしなかった場合は、Sun Cluster HA for Apache Tomcat パッケージのインストールに戻ってください。

インストールした場合は、次の手順に従って Sun Cluster HA for Apache Tomcat データサービスを構成します。

Apache Tomcat のホストとなるクラスタノードの 1 つで、スーパーユーザーになります。

SUNW.gds というリソースタイプを登録します。
# scrgadm -a -t SUNW.gds

SharedAddress リソースのフェイルオーバーリソースグループを作成します。
# scrgadm -a -g Apache-Tomcat-SharedAddress-resource-group

SharedAddress リソースを作成します。

# scrgadm -a -S -j Apache-Tomcat-SharedAddress-resource  \
> -g Apache-Tomcat-SharedAddress-resource-group\
> -l Apache-Tomcat-SharedAddress-hostname

SharedAddress リソースグループを有効にします。

# scswitch -Z -g  Apache-Tomcat-SharedAddress-resource-group

Sun Cluster HA for Apache Tomcat で必要となるパラメタファイルを用意します。

# cd /opt/SUNWsctomcat/bin
cp pfile desired place

ファイル内のコメントに従って、パラメタファイル pfile を編集します。次に例を示します。

#!/usr/bin/ksh 
# Set the Apache Tomcat specific environment variables which the start, 
# stop and check functions will use 
#
# EnvScript     Script to set runtime environment for tomcat
# User          Apache Tomcat user name
# Basepath      Absolute pathname to tomcat Home directory ie 4.x CATALINA_HOME
#               or TOMCAT_HOME for 3.x
# Host          Hostname to test Apache Tomcat 
# Port          Port where Apache Tomcat is configured
# TestCmd       Apache Tomcat test command
# Startwait     Sleeping $Startwait seconds after completion of the 
#               start command
(日本語)
#!/usr/bin/ksh 
# 起動、停止、およびチェックの各機能が使用する
# Apache Tomcat 固有の環境変数を設定する
#
# EnvScript     Tomcat の実行時環境を設定するスクリプト
# User          Apache Tomcat ユーザー名
# Basepath      Tomcat のホームディレクトリの絶対パス。つまり、4.x CATALINA_HOME
#               または TOMCAT_HOME for 3.x
# Host          Apache Tomcat  をテストするホストの名前
# Port         Apache Tomcat が構成されるポート
# TestCmd      Apache Tomcat のテストコマンド
# Startwait    起動コマンドが完了したあと $Startwait 秒の間休眠状態
#               になる
EnvScript=
User=
Basepath=
Host=
Port=8080
TestCmd="get /index.jsp"
ReturnString="CATALINA"
Startwait=20

次に、Apache Tomcat 4.1.24 の場合の例を示します。

EnvScript=/tomcat/env.ksh
User=tomcat
Basepath=/tomcat/jakarta-tomca-4.1.24
Host=localhost
Port=8080
TestCmd="get /index.jsp"
ReturnString="CATALINA"
Startwait=20

これは、デフォルトの起動ページ index.jsp を使用してスタンドアロン Web サーバーとして構成された Apache Tomcat 4.1.24 の例です。この起動ページには、文字列 CATALINA が含まれます。

Host パラメタは、pfile の場所によって異なります。

pfile が共有記憶装置に保存されている場合は、ローカルホストを使用する必要があります。
pfile がローカル記憶装置に保存されている場合は、ローカルホストまたはノードホスト名のどちらかになります。

ここでは共有アドレスは使用しないでください。

注意 –

パラメタファイルは、Apache Tomcat データサービスをホスティングできるすべてのノードで利用できる必要があります。スケーラブル構成またはマルチマスター構成の場合は、各ノードのローカルファイルシステムに保存するか、共有記憶装置に保存します。Apache Tomcat インスタンスのパラメタファイルは、すべてのノードで同一である必要があります。

必要なすべての Apache Tomcat インスタンスとノードで、この手順を繰り返します。

スケーラブルサービスのリソースグループを作成します。
# scrgadm -a -g Apache-Tomcat-Scalable-resource-group \ > -y Maximum_primaries=2 \ > -y Desired_primaries=2 \ > -y RG_dependencies=Apache-Tomcat-SharedAddress-resource-group
ノードを増やす必要がある場合は、Maximum_primaries と Desired_primaries を適切な値に調整してください。

Apache Tomcat ディスク記憶装置のリソースを作成します ( ルートファイルシステム内に存在しない場合)。その必要がない場合は、手順 10 へ進みます。
# scrgadm -a -j Apache-Tomcat-has-resource \ > -g Apache-Tomcat-failover-resource-group \ > -t SUNW.HAStoragePlus \ > -x FilesystemMountPoints=Apache Tomcat- instance-mount-points

Apache-Tomcat-has-resource を有効にします。

# scstat

# scswitch -e -j Apache- Tomcat-has-resource

必要な Apache Tomcat コンポーネントを作成して登録します。

# cd /opt/SUNWsctomcat/util
# cp sctomcat_config desired place
# cp sctomcat_register desired place

コメントに従って sctomcat_config ファイルを編集します。

# これらのパラメタは、(key=value) フォームを使用してカスタマイズできます。
#
# Copyright 2003 Sun Microsystems, Inc.  All rights reserved.
# Use is subject to license terms.
# 
# This file will be sourced in by sctomcat_register and the parameters
# listed below will be used.
#
# These parameters can be customized in (key=value) form
#
#        RS - name of the resource for the application
#        RG - name of the resource group containing RS
#      PORT - name of the port number
#        LH - name of the LogicalHostname SC resource
#  SCALABLE - true or false for a scalable or failover resource
#     PFILE - absolute pathname to the parameter file for the Tomcat resource
#    HAS_RS - name of the HAStoragePlus SC resource 
#             (it can be a , separated list for the dependencies)
(日本語)
# このファイルは、sctomcat_register によってソースに取り込まれます。
# パラメタは以下のものが使用されます。
#
# これらのパラメタは、(key=value) フォームを使用してカスタマイズできます。
#
#        RS - アプリケーションのリソースの名前
#        RG - RS を含むリソースグループの名前
#      PORT - ポート番号の名前
#        LH - LogicalHostname SC リソースの名前
#  SCALABLE - スケーラブルリソースかフェイルオーバーリソースかを true または false で指定
#     PFILE - Tomcat リソースのパラメタファイルの絶対パス名
#    HAS_RS - HAStoragePlus SC リソースの名前
#             (依存関係にもとづいて個別のリストにもできる)
#

RS=
RG=
PORT=8080
LH=
SCALABLE=false
PFILE=
HAS_RS=

次に、Apache Tomcat の場合の例を示します。

RS=tomcat-res
RG=tomcat-rg
PORT=8080
LH=tomcat-lh
SCALABLE=true
PFILE=/tomcat/pfile
HAS_RS=Apache-Tomcat-has-resource

パラメタ LH には、共有アドレス名を設定する必要があります。パラメタ HAS_RS needs を設定する必要があるのは、ほかのファイルシステム (「グローバルファイルシステム」GFS またはローカルファイルシステム) が使用されている場合で、適切な Apache-Tomcat-has-resource が作成されているときだけです。

sctomcat_config の編集後、リソースを登録する必要があります。
# ./sctomcat_register
必要なすべての Apache Tomcat インスタンスで、最後の 3 つの手順を繰り返します。

Apache Tomcat リソースを有効にします。

先の手順で作成したすべての Apache Tomcat リソースで次の手順を繰り返します。
# scstat
# scswitch -e -j Apache-Tomcat-resource