Sun Cluster 3.1 Data Service for Apache Tomcat ガイド

Sun Cluster HA for Apache Tomcat をフェイルオーバーデータサービスとして登録して構成する方法

この手順は、Sun Cluster HA for Apache Tomcat をフェイルオーバーデータサービスとして構成する場合に行います。この手順は、このデータサービスパッケージがインストールされていることを前提としています。

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

インストールした場合は、次の手順に従って Sun Cluster HA for Apache Tomcat データサービスを構成します。この手順は、Apache Tomcat のファイルシステムがフェイルオーバーファイルシステムとしてマウントされることを想定しています。

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

  2. SUNW.gds というリソースタイプを登録します。


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


    # scrgadm -a -t SUNW.HAStoragePlus
    
  4. フェイルオーバーリソースグループを作成します。


    # scrgadm -a -g Apache-Tomcat-failover-resource-group
    
  5. Apache Tomcat ディスク記憶装置に対応するリソースを作成します。


    # scrgadm -a -j Apache-Tomcat-has-resource  \
    > -g Apache-Tomcat-failover-resource-group   \
    > -t SUNW.HAStoragePlus  \
    > -x FilesystemMountPoints=Apache Tomcat- instance-mount-points
    
  6. Apache Tomcat 論理ホスト名に対応するリソースを作成します。


    # scrgadm -a -L -j Apache-Tomcat-lh-resource  \
    > -g Apache-Tomcat-failover-resource-group  \
    > -l Apache-Tomcat-logical-hostname
    
  7. Apache Tomcat ディスク記憶装置と 論理ホスト名のリソースが組み込まれたフェイルオーバーリソースグループを有効にします。


    # scswitch -Z -g  Apache-Tomcat-failover-resource-group
    
  8. 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 i.e. 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=/global/mnt1/tomtest/env.ksh
    User=tomtest
    Basepath=/global/mnt1/tomtest/jakarta-tomcat-4.1.24
    Host=tomcat-lh
    Port=8080
    TestCmd="get /index.jsp"
    ReturnString="CATALINA"
    Startwait=20
    

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


    注意 – 注意 –

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


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

  9. 必要な 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=false
    PFILE=/global/mnt1/pfile
    HAS_RS=tomcat-hastplus-res
    
  10. sctomcat_config の編集後、リソースを登録する必要があります。


    # ./sctomcat_register
    

    必要なすべての Apache Tomcat インスタンスで、最後の 3 つの手順を繰り返します。

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

    先の手順で作成したすべての Apache Tomcat リソースで次の手順を繰り返します。


    # scstat 
    

    # scswitch -e -j Apache-Tomcat-resource