test

Sun Cluster Data Service for WebLogic Server ガイド (Solaris OS 版)

Sun Cluster HA for BEA WebLogic Server のインストールと構成

この章では、Sun Cluster HA for BEA WebLogic Server のインストールと構成の方法について説明します。

この章では、次の手順について説明します。

Sun Cluster HA for BEA WebLogic Server の概要

この節では、BEA WebLogic Server アプリケーションの高可用性を実現する方法について説明します。

BEA WebLogic Server は、Sun Cluster システム上で稼動することで、分散型の異種混合アプリケーション環境を対象にした基幹系の E コマースアプリケーションの開発と配備を行う高可用プラットフォームとして機能します。

Sun Cluster HA for BEA WebLogic Server は、BEA WebLogic Server アプリケーションを対象として、障害監視機能を提供するとともに高可用性を実現します。高可用性が確立されるのは、WebLogic Administration Server と WebLogic Managed Server です。Sun Cluster HA for BEA WebLogic Server がサポートするのはクラスタ化されていない BEA WebLogic Server だけであるため、フェイルオーバーまたは再起動時にクライアントセッションが失われる可能性があります。

注 –

Sun Cluster HA for BEA WebLogic Server は、スタンドアロンの WebLogic Server インスタンス (WebLogic Server クラスタリングを使用していないインスタンス) の高可用性を実現します。

フェイルオーバーサービスについての概念的な情報については、『 Sun Cluster の概念 (Solaris OS 版)』を参照してください。

表 1–1 BEA WebLogic Server コンポーネントの保護

BEA WebLogic Server コンポーネント 

▼コンポーネントを保護するデータサービス 

BEA WebLogic Server 

Sun Cluster HA for BEA WebLogic Server 

リソースタイプは SUNW.wls

BEA WebLogic Server データベース 

BEA WebLogic Server によってサポートされるすべてのデータベースと、Sun Cluster 上でサポートされるすべてのデータベース 

HTTP サーバー 

BEA WebLogic Server によってサポートされるすべての HTTP サーバーと、Sun Cluster 上でサポートされるすべての HTTP サーバー 

Sun Cluster HA for BEA WebLogic Server のインストールと構成

表 1–2 に、Sun Cluster HA for BEA WebLogic Server のインストールと構成に必要となる作業を示します。指定された順番どおりに、各作業を行ってください。

表 1–2 Task Map:Sun Cluster HA for BEA WebLogic Server のインストールと構成

タスク 

参照先 

BEA WebLogic Server のインストールについて計画を立てる 

「Sun Cluster HA for BEA WebLogic Server のインストールと構成の計画」

ノードとディスクを準備する 

「ノードを準備する」

BEA WebLogic Server のインストールと構成を行う 

「BEA WebLogic Server をインストールする」

「データベースをインストールする」

「Web サーバーをインストールする」

BEA WebLogic Server のインストールと構成を確認する 

「BEA WebLogic Server のインストールおよび構成を確認する」

Sun Cluster HA for BEA WebLogic Server パッケージをインストールする 

「Web Start プログラムを使用して Sun Cluster HA for BEA WebLogic Server パッケージをインストールする」

「scinstall ユーティリティーを使用して Sun Cluster HA for BEA WebLogic Server パッケージをインストールする」

Sun Cluster HA for BEA WebLogic Server をフェイルオーバーデータサービスとして登録し、構成する 

「フェイルオーバーデータサービスとして Sun Cluster HA for BEA WebLogic Server を登録して構成する」

Sun Cluster HA for BEA WebLogic Server のインストールと構成を確認する 

「Sun Cluster HA for BEA WebLogic Server のインストールおよび構成を確認する」

Sun Cluster HA for BEA WebLogic Server 障害モニターの表示 

「Sun Cluster HA for BEA WebLogic Server 障害モニターの操作」

Sun Cluster HA for BEA WebLogic Server のインストールと構成の計画

ここでは、Sun Cluster HA for BEA WebLogic Server のインストールと構成の計画について説明します。

構成に関する制限事項

注意 – 注意 –

これらの制限事項を守らないと、データサービスの構成がサポートされない場合があります。

この節では、Sun Cluster HA for BEA WebLogic Server に適用される、ソフトウェア構成とハードウェア構成の制限事項を示します。この節に示している制限事項を参考にして、Sun Cluster HA for BEA WebLogic Server のインストールと構成の計画を行なってください。

すべてのデータサービスに適用される制限事項については、『 Sun Cluster Release Notes for Solaris OS』を参照してください。

構成に関する要件

注意 – 注意 –

次の要件を満たさないと、データサービスの構成がサポートされない場合があります。

ここで示す要件を参考にして、Sun Cluster HA for BEA WebLogic Server のインストールと構成の計画を行なってください。これらの要件は、Sun Cluster HA for BEA WebLogic Server にのみ適用されます。Sun Cluster HA for BEA WebLogic Server のインストールと構成を始める前に、次の要件を満たしておく必要があります。

すべてのデータサービスに適用される要件については、『Sun Cluster データサービスの計画と管理 (Solaris OS 版)』の「Sun Cluster データサービス構成のガイドライン」を参照してください。

▼▼データサービスの標準構成

この節に示している標準の構成を参考にして、Sun Cluster HA for BEA WebLogic Server のインストールと構成の計画を行なってください。Sun Cluster HA for BEA WebLogic Server は、この節に示している標準の構成をサポートします。

これらの標準構成のほかに、以下の BEA WebLogic Server 構成も利用できます。

注 –

BEA WebLogic Server は、現在、フェイルオーバーデータサービスとしてサポートされています。

Sun Cluster HA for BEA WebLogic Server では、上記以外の構成もサポートできる場合があります。ただし、Sun サービスプロバイダに連絡し、他の構成に関する情報を得る必要があります。

シンプルな構成

Sun Cluster HA for BEA WebLogic Server 用のこのシンプルな構成では、次のように構成された 2 つのリソースグループを使用します。

RG1 と RG2 はフェイルオーバーリソースグループです。

この構成を利用できるのは、BEA WebLogic Server が広域ファイルシステムにインストールされている場合だけです。図 1–1 に、この構成の概略を示します。

図 1–1 Sun Cluster HA for BEA WebLogic Server によるシンプルな構成

図 :この図については、前の本文中で説明しています。

構成 1

この構成では、フェイルオーバーリソースグループ RG1、RG2、RG3、および RG4 が次のように構成されています。

この構成を利用できるのは、BEA WebLogic Server が広域ファイルシステムにインストールされている場合だけです。

構成 2

この構成では、RG1、RG2、および RG3 は次のように構成されたフェイルオーバーリソースグループです。

この構成を利用できるのは、BEA WebLogic Server が広域ファイルシステムにインストールされている場合だけです。

構成 3

BEA WebLogic Server が HAStoragePlus を使用したフェイルオーバーファイルシステムにインストールされている場合、このフェイルオーバーファイルシステムに依存している同一のフェイルオーバーリソースグループ内に BEA WebLogic Server のすべてのインスタンスを構成する必要があります。

RG1 には、論理ホストリソース、すべての Administration Server リソース、およびすべての Managed Server リソースが含まれます。

HAStoragePlus リソースに依存したリソースを登録する方法については、『Sun Cluster データサービスの計画と管理 (Solaris OS 版)』の「高可用性ローカルファイルシステムの有効化」を参照してください。

図 1–2 に、この構成の概略を示します。

図 1–2 Sun Cluster HA for BEA WebLogic Server ファイルシステムのフェイルオーバー構成

図 :この図については、前の本文中で説明しています。

▼▼ノードとディスクの準備

ここでは、ノードとディスクを準備する手順について説明します。

注 –

以下の手順は、「シンプルな構成」で説明しているシンプルな構成に基づいています。

ノードを準備する

この手順は、BEA WebLogic Server のインストールと構成の準備作業として実施してください。

    論理ホスト名リソースと BEA Administration Server リソースを保持するフェイルオーバーリソースグループを作成します。


    # scrgadm -a -g RG1 [-h nodelist]

    論理ホスト名リソースを追加します。

    logical-host–1 は、BEA WebLogic Admin Server が待機 (リッスン) するホスト名です。これは、WebLogic コンソールから設定できます。


    # scrgadm -a -L -g RG1 -l logical-host-1

    リソースグループをオンラインにします。


    # scswitch -Z -g RG1

    論理ホスト名リソースと WebLogic Managed Server リソースを保持するフェイルオーバーリソースを作成します。

    注 –

    BEA WebLogic Server の数と計画している構成に基づき、リソースグループと logical_hostname リソースを作成してください(「▼▼データサービスの標準構成」を参照)。


    # scrgadm -a -g RG2 [-h nodelist]

    論理ホスト名リソースを追加します。

    logical-host-2 は、BEA WebLogic Admin Server が待機するホスト名です。


    # scrgadm -a -L -g RG2 -l logical-host-2

    リソースグループをオンラインにします。


    # scswitch -Z -g RG2

BEA WebLogic Server アプリケーションのインストールと構成

この節では、BEA WebLogic Server アプリケーションのインストールと構成に必要な手順について説明します。

BEA WebLogic Server をインストールする

注 –

この手順は、「シンプルな構成」で説明している構成に基づいています。別の構成を計画している場合は、BEA WebLogic Server を適宜構成する必要があります。

  1. BEA WebLogic Server のマニュアルに従って、広域ファイルシステムまたはフェイルオーバーファイルシステムに BEA WebLogic Server をインストールします。

  2. 『BEA WebLogic Server Administration Guide』に従って WebLogic ドメインを構成します。

    注 –

    BEA WebLogic Server の構成時には、論理ホスト名または IP アドレスを入力してください。

  3. ドメインに必要な構成がすべて完了したところで、Administration Server をシャットダウンします。

  4. Administration Server の START スクリプトと Managed Server の START スクリプトを編集し、WLS_USER と WLS_PW を設定します。

    START スクリプトは、引数を指定することなく実行できなければなりません。

    注 –

    WLS_USER と WLS_PW は、このエージェントが BEA WebLogic Server をスムーズにシャットダウンするために必要なものです。この設定ではセキュリティー上で懸念がある場合は、これらのプロパティを boot.properties ファイルに設定できます。しかし、この方法ではスムーズなシャットダウンは行えず、エージェントは BEA WebLogic Server を強制的にシャットダウンします。

  5. Managed Server の START スクリプトに、ADMIN_URL 変数と SERVER_NAME 変数を設定します。

    このスクリプトは、引数を指定することなく実行できなければなりません。

  6. setWLSEnv.sh スクリプトまたは startWLS.sh スクリプトに、必要な環境変数を設定します。

    環境変数には、CLASSPATH や LD_LIBRARY_PATH などを追加できます。これらのスクリプトには、必要となるあらゆる環境変数 (CLASSPATH や LD_LIBRARY_PATH など) が含まれます。

  7. config.xml ファイルが START スクリプトと同じディレクトリに存在するかを確認します。

データベースをインストールする

BEA WebLogic Server でデータベースを使用する場合は、そのインストールマニュアルを参照してデータベースをインストールしてください。使用するデータベースに Sun Cluster 用の HA エージェントが含まれる場合は、該当するバージョンをインストールしてください。

Web サーバーをインストールする

BEA WebLogic Server で Web サーバーを使用する場合は、そのインストールマニュアルを参照してその Web サーバーをインストールしてください。使用する Web サーバーに Sun Cluster 用の HA エージェントが含まれる場合は、該当するバージョンをインストールしてください。

BEA WebLogic Server のインストールと構成の確認

この節では、BEA WebLogic Server のインストールと構成を確認する手順について説明します。

BEA WebLogic Server のインストールおよび構成を確認する

この手順は、BEA WebLogic Server Administration Server、BEA WebLogic Managed Server、およびデータベースのインストールと構成を確認する場合に使用してください。データサービスをまだインストールしていないため、この手順ではアプリケーションの可用性が高いかどうかを確認することはできません。

注 –

以下の手順は、「シンプルな構成」で説明している構成に基づいています。別の構成を計画している場合は、BEA WebLogic Server を適宜構成する必要があります。

  1. RG1 と RG2 で構成されている logical-host-1 と logical-host-2 が cluster-node1 でオンライン状態であるかどうかを確認します。

  2. データベースを使用している場合は、そのデータベースが稼動しているかどうかを確認します。

  3. Administration Server と Managed Server の START スクリプト (「BEA WebLogic Server アプリケーションのインストールと構成」で構成したもの) が含まれるディレクトリへ移動します。

  4. Administration Server START スクリプトを実行して Administration Server を起動します。


    例:
cluster-node1>cd /global/wls/user_projects/petstore
cluster-node1>./startWebLogic.sh

  5. Administration Server が正常に起動したあとで、Managed Server を起動します。


    例:
cluster-node1>cd /global/wls/user_projects/petstore
cluster-node1>./startManagedWebLogic.sh

  6. クライアントから logical-host-1 と logical-host-2 に正常に接続できるかを確認します。

  7. Administration Server と Managed Server が cluster-node1 で RUNNING モードにあるかを確認します。

  8. Administration Server と Managed Server を停止します。

  9. Resource Groups RG1 と RG2 を cluster-node2 に切り替えます。

    これにより、cluster-node1 の logical-host-1 と logical-host-2 が停止し、これらの論理ホストが cluster-node2 で起動します。


    scswitch -z -g RG1 -h cluster-node2
scswitch -z -g RG2 -h cluster-node2

  10. cluster-node2 上で手順 4、手順 5、および 手順 6 を繰り返します。

  11. Administration Server と Managed Server が cluster-node2 で RUNNING モードにあるかを確認します。

  12. クライアントが各潜在マスターノード上で Administration Server と Managed Server に正常に接続できる場合、Sun Cluster HA for BEA WebLogic Server と併用できるように BEA WebLogic Server の構成が問題なく行われています。

  13. Administration Server と Managed Servers を停止して次のセッションへ進み、Sun Cluster HA for BEA WebLogic Server をインストールします。

Sun Cluster HA for BEA WebLogic Server パッケージのインストール

Sun Cluster の初回のインストール時に Sun Cluster HA for BEA WebLogic Server パッケージをインストールしなかった場合は、この手順でパッケージをインストールしてください。この手順は、Sun Cluster HA for BEA WebLogic Server パッケージをインストールする各クラスタノード上で個別に実行します。この手順の実行には、Sun Java Enterprise System Accessory CD Volume 3 が必要です。

複数のデータサービスを同時にインストールする場合は、『Sun Cluster ソフトウェアのインストール (Solaris OS 版)』の「ソフトウェアのインストール」に記載されている手順を実行してください。

次のいずれかのインストールツールを使用して、Sun Cluster HA for BEA WebLogic Server パッケージをインストールします。

注 –

Web Start プログラムは、Sun Cluster 3.1 Data Services 10/03 より前のリリースでは使用できません。

Web Start プログラムを使用して Sun Cluster HA for BEA WebLogic Server パッケージをインストールする

Web Start プログラムは、コマンド行インタフェース (CLI) またはグラフィカルユーザーインタフェース (GUI) を使用して実行できます。CLI と GUI での作業の内容と手順はほとんど同じです。Web Start プログラムの詳細は、installer(1M) のマニュアルページを参照してください。

  1. Sun Cluster HA for BEA WebLogic Server パッケージをインストールするクラスタノード上で、スーパーユーザーになります。

  2. (省略可能) Web Start プログラムを GUI で実行する場合は、必ず DISPLAY 環境変数を設定します。

  3. ▼CD-ROM ドライブに Sun Java Enterprise System Accessory CD Volume 3 を挿入します。

    ボリューム管理デーモン vold(1M) が実行されており、CD-ROM デバイスを管理するように構成されている場合は、デーモンによって CD-ROM が自動的に /cdrom/cdrom0 ディレクトリにマウントされます。

  4. CD-ROM の Sun Cluster HA for BEA WebLogic Server コンポーネントディレクトリに切り替えます。

    Sun Cluster HA for BEA WebLogic Server データサービスの Web Start プログラムは、このディレクトリに入っています。


    # cd /cdrom/cdrom0/\
components/SunCluster_HA_BEA_WLS_3.1

  5. Web Start プログラムを起動します。


    # ./installer

  6. プロンプトが表示されたなら、インストールの種類を選択します。

    • C ロケールのみをインストールする場合は、Typical を選択します。

    • ほかのロケールをインストールする場合は、Custom を選択します。

  7. 表示される手順に従って、ノードに Sun Cluster HA for BEA WebLogic Server パッケージをインストールします。

    インストールが完了すると、Web Start プログラムがインストールサマリを提供します。このサマリーを使用して、インストール時に Web Start によって作成されたログを確認できます。これらのログは /var/sadm/install/logs ディレクトリに置かれます。

  8. Web Start プログラムを終了します。

  9. CD-ROM ドライブから Sun Java Enterprise System Accessory CD Volume 3 を取り出します。

    1. CD-ROM が使用されないように、CD-ROM 上のディレクトリ以外に移動します。

    2. CD-ROM を取り出します。


      # eject cdrom

scinstall ユーティリティーを使用して Sun Cluster HA for BEA WebLogic Server パッケージをインストールする

  1. ▼CD-ROM ドライブに Sun Java Enterprise System Accessory CD Volume 3 を挿入します。

  2. オプションは指定せずに、scinstall ユーティリティーを実行します。

    scinstall ユーティリティーが対話型モードで起動します。

  3. メニューオプション「新しいデータサービスのサポートをこのクラスタノードに追加」を選択します。

    scinstall ユーティリティーにより、ほかの情報を入力するためのプロンプトが表示されます。

  4. ▼▼Sun Java Enterprise System Accessory CD Volume 3 のパスを指定します。

    ▼ユーティリティーはこの CD-ROM をデータサービス CD-ROM として示します。

  5. インストールするデータサービスを指定します。

    選択したデータサービスが scinstall ユーティリティーによって示され、この選択内容の確認が求められます。

    注 –

    scinstall ユーティリティーは、このデータサービスがサポートされていない旨を知らせるエラーメッセージを表示する場合があります。このメッセージは無視して次の手順へ進んでください。

  6. scinstall ユーティリティーを終了します。

  7. ▼ドライブから CD-ROM を取り出します。

Sun Cluster HA for BEA WebLogic Server の登録と構成

ここでは Sun Cluster HA for BEA WebLogic Server の構成手順について説明します。

Sun Cluster HA for BEA WebLogic Server 拡張プロパティ

リソースを作成する際には、「拡張プロパティ」に示されている拡張プロパティを使用してください。コマンド scrgadm -x parameter-value を使用して、リソースを作成するときに拡張プロパティを構成します。リソースが作成済みの場合は、『Sun Cluster データサービスの計画と管理 (Solaris OS 版)』の「データサービスリソースの管理」に記載されている手順で、拡張プロパティを構成します。拡張プロパティの中には動的に変更できるものがあります。それ以外の拡張プロパティは、リソースを作成するか無効にするときにしか更新できません。そのプロパティをいつ変更できるかについては、説明欄の「調整 : 」を参照してください。Sun Cluster のすべてのプロパティの詳細については、『Sun Cluster データサービスの計画と管理 (Solaris OS 版)』の「標準プロパティ」を参照してください。

フェイルオーバーデータサービスとして Sun Cluster HA for BEA WebLogic Server を登録して構成する

次の手順で、Sun Cluster HA for BEA WebLogic Server をフェイルオーバーデータサービスとして構成します。以下の手順は、「シンプルな構成」 で解説した構成が使用され、BEA WebLogic Server が 「BEA WebLogic Server アプリケーションのインストールと構成」 に従って構成されていることを想定しています。また、これらの手順はユーザーがすでにリソースグループ RG1 と RG2 を作成し、これらのリソースグループ内にリソース logical-host-1 と logical-host-2 を作成してあることを前提としています。論理ホスト名リソースの作成方法については、「ノードを準備する」を参照してください。別の構成を計画している場合は、BEA WebLogic Server リソースを適宜構成する必要があります。

注 –

データベースを使用している場合は、Sun Cluster HA for BEA WebLogic Server を起動する前にデータベースがアクセス可能かをチェックしてください。

  1. BEA WebLogic Server リソースタイプを追加します。


    # scrgadm -a -t SUNW.wls

  2. RG1 リソースグループ内に BEA WebLogic Admin Server リソースを作成します。


    # scrgadm -a -j admin-rs -t SUNW.wls -g RG1\
-x Confdir_list=/global/bea/beahome/weblogic700\
-x Server_url=http://logical-host-1:7001\
-x Start_script=/global/bea/beahome/user_projects\
/petstore/startWebLogic.sh
    注 –

    この構成ではスムーズなシャットダウンは有効になりません。Sun Cluster HA for BEA WebLogic Server の stop メソッドは、BEA WebLogic Administration Server を強制的にシャットダウンします (プロセスを終了する)。スムーズなシャットダウンを有効にする構成については、「スムーズにシャットダウンするリソースを作成する」を参照してください。詳細は、「STOP メソッド」を参照してください。

  3. RG2 リソースグループ内に BEA WebLogic Managed Server リソースを作成します。


    # scrgadm -a -j managed-rs -t SUNW.wls -g RG2 \
-x Confdir_list=/global/bea/beahome/weblogic700\
-x Server_url=http://logical-host-2:7004\
-x Start_script=/global/bea/beahome/user_projects\
/petstore/startManagedWebLogic.sh

Sun Cluster HA for BEA WebLogic Server のインストールと構成の確認

ここでは、データサービスが正しくインストールされ構成されているかどうかを確認する手順について説明します。

Sun Cluster HA for BEA WebLogic Server のインストールおよび構成を確認する

次の手順で、Sun Cluster HA for BEA WebLogic Server が正しくインストールされ、構成されているかどうかを確認します。

  1. クラスタ上で BEA WebLogic Server リソースグループをオンラインにします。


    # scswitch -z -g RG1 -h cluster-node1
# scswitch -z -g RG2 -h cluster-node1

    BEA WebLogic Administration Server と Managed Server は cluster-node1 でオンラインでなければなりません。

  2. クライアントから BEA WebLogic サーバーに正常に接続できることと、Administration Server と Managed Server の両方が RUNNING モードであることを確認します。

  3. リソースグループを cluster-node2 に切り替えます。


    # scswitch -z -g RG1 -h cluster-node2
# scswitch -z -g RG2 -h cluster-node2

    BEA WebLogic Administration および Managed Server は、cluster-node1 でオフラインに、cluster-node2 ではオンラインにする必要があります。cluster-node1 での BEA WebLogic Server プロセスが停止していることを確認します。スムーズなシャットダウンが有効になっていないため、BEA WebLogic Server プロセスのスムーズなシャットダウンは行われず、Sun Cluster HA for BEA WebLogic Server STOP メソッドによって終了されます。スムーズなシャットダウンを有効にする構成については、「スムーズにシャットダウンするリソースを作成する」を参照してください。詳細情報については、「STOP メソッド」を参照してください。

  4. クライアントから BEA WebLogic サーバーに正常に接続できることと、Administration Server と Managed Server の両方が RUNNING モードであることを確認します。

    注 –

    BEA WebLogic Server が cluster-node1 でオフラインになり cluster-node2 でオンラインになる際に、クライアントセッションは消失する可能性があります。

  5. cluster-node2 で、Administration Server プロセスを終了します。

    Fault Monitor によってこの終了が検出され、Administration Server が再起動されます。

  6. Administration Server プロセスを繰り返し終了します。

    設定された再試行時間内に再試行回数が限度を超えたあと、Administration Server Resource グループがフェイルオーバーします。

  7. cluster-node2 で、Managed Server プロセスを終了します。

    Fault Monitor によってこの停止が検出され、Managed Server が再起動されます。

  8. Managed Server プロセスを繰り返し終了します。

    設定された再試行時間内に再試行回数が限度を超えたあと、Managed Server Resource グループがフェイルオーバーします。

    以上の手順が正常に進んだ場合は、Sun Cluster HA for BEA WebLogic Server の構成は正しく行われています。

注 –

BEA WebLogic Administration Server と Managed Server が Sun Cluster の制御下で本稼動状態になったなら、手動、あるいは Administration Console を通して、それらのサーバーの起動または停止を行わないでください。サーバーの保守作業を行う必要がある場合は、初めにそれらに関連付けられたリソースを無効にする必要があります。

Sun Cluster HA for BEA WebLogic Server の代替構成

この章で解説するインストール、登録、および構成手順では、「シンプルな構成」 の解説に従い、シンプル構成をインストールすることを想定しています。この節では、Sun Cluster HA for BEA WebLogic Server で選択できるほかの構成例を示します。

シンプルな BEA WebLogic Server リソースを作成する

この構成では、START スクリプト startWebLogic.sh が、引数の指定なしに BEA WebLogic Server を起動できることが前提となります。BEA WebLogic Server の起動に必要な username と password は、START スクリプト内または boot.properties ファイルに設定することができます。


# scrgadm -a -j bea-rs -t SUNW.wls- -g bea-rg\
-x Confdir_list=/global/bea/beahome/weblogic700\
-x Server_url=http://logical_host1:7001\
-x Start_script=/global/bea/beahome/user_projects/petstore/startWebLogic.sh

サーバー名を引数にするリソースを作成する

BEA WebLogic Server の START スクリプト startManagedWebLogic.sh が Managed Server 名を引数として使用する場合、拡張プロパティ Server_name を設定できます。START スクリプト startManagedWebLogic.sh は、複数の Managed Server の起動に使用できます。この START スクリプトには ADMIN_URL を設定する必要があります。BEA WebLogic Server を手動で起動するには、以下のコマンドを使用します。


cluster-node-1> cd /global/wls/user_projects/petstore
cluster-node-1> ./startManagedWebLogic.sh petstore1

start スクリプトがサーバー名 petstore1 を受け付ける Sun Cluster HA for BEA WebLogic Server リソースを構成するには、以下のコマンドを使用します。


# scrgadm -a -j bea-rs -t SUNW.wls -g bea-rg\
-x Confdir_list=/global/bea/beahome/weblogic700\
-x Server_url=http://logical_host1:7001\
-x Start_script=/global/bea/beahome/user_projects/petstore/startWebLogic.sh\
-x Server_name=petstore1

異なるサーバー petstore2 に同じ START スクリプトを使用する別の Sun Cluster HA for BEA WebLogic Server リソースを構成するには、以下のコマンドを使用します。


# scrgadm -a -j bea-rs -t SUNW.wls -g bea-rg\
-x Confdir_list=/global/bea/beahome/weblogic700\
-x Server_url=http://logical_host1:7001\
-x Start_script=/global/bea/beahome/user_projects/petstore/startWebLogic.sh\
-x Server_name=petstore2

スムーズにシャットダウンするリソースを作成する

Sun Cluster HA for BEA WebLogic Server STOP メソッドは、デフォルトでは BEA WebLogic Server のプロセスを終了してインスタンスをシャットダウンします。このような動作が望ましくない場合は、Smooth_shutdown 拡張プロパティを TRUE に設定して BEA WebLogic Server のスムーズなシャットダウンを有効にします。この拡張プロパティを有効にする場合は、WLS_USER と WLS_PW を START スクリプト内に設定する必要があります。この設定ではセキュリティー上で懸念がある場合は、Sun Cluster HA for BEA WebLogic Server によりデフォルトの強制的なシャットダウン (プロセスの終了) を行う必要があります。

スムーズにシャットダウンするリソースを構成するには、以下のコマンドを使用します。


# scrgadm -a -j bea-rs -t SUNW.wls -g bea-rg\
-x Confdir_list=/global/bea/beahome/weblogic700\
-x Server_url=http://logical_host1:7001\
-x Start_script=/global/bea/beahome/user_projects/petstore/startWebLogic.sh\
-x Server_name=petstore1\
-x Smooth_shutdown=TRUE

データベースの検証を行うリソースを作成する

Sun Cluster HA for BEA WebLogic Server はデータベースの状態を検査しません。Sun Cluster HA for BEA WebLogic Server の起動時にデータベースが停止していると、データサービスは開始されません。Sun Cluster HA for BEA WebLogic Server によってデータベースを検査したい場合は、独自のデータベース検証スクリプトを拡張プロパティとして Sun Cluster HA for BEA WebLogic Server に渡すことができます。このデータベース検証は、正常に完了した場合にゼロを、失敗時にゼロ以外を返すものでなければなりません。

スクリプト拡張プロパティ DB_probe を設定してリソースを構成するには、以下のコマンドを使用します。


# scrgadm -a -j bea-rs -t SUNW.wls -g bea-rg\
-x Confdir_list=/global/bea/beahome/weblogic700\
-x Server_url=http://logical_host1:7001\
-x Start_script=/global/bea/beahome/user_projects/petstore/startWebLogic.sh\
-x Server_name=petstore1\
-x Smooth_shtudown=TRUE\
-x DB_probe_script=/global/bea/script/db_probe_script

URI を監視するリソースを作成する

Sun Cluster HA for BEA WebLogic Server リソース内で構成された BEA WebLogic Server のサービスを受ける URI を監視するように設定するには、以下のコマンドを使用して拡張プロパティ Monitor_uri_list を設定してください。


# scrgadm -a -j bea-rs -t SUNW.wls -g bea-rg\
-x Confdir_list=/global/bea/beahome/weblogic700\
-x Server_url=http://logical_host1:7001\
-x Start_script=/global/bea/beahome/user_projects/petstore/startWebLogic.sh\
-x Server_name=petstore1\
Smooth_shutdown=TRUE\
DB_probe_script=/global/bea/script/db_probe_script\
-x Monitor_uri_list=http://logical_host1:7001/petstore,http://logical_host1:7001/bookstore

Sun Cluster HA for BEA WebLogic Server 障害モニターの操作

この節では、Sun Cluster HA for BEA WebLogic Server 障害モニターについて解説します。

拡張プロパティ

Sun Cluster HA for BEA WebLogic Server は、以下の拡張プロパティを使用します。次の拡張プロパティを調整できます。拡張プロパティの確認または設定の方法については、「Sun Cluster HA for BEA WebLogic Server 拡張プロパティ」を参照してください。

表 1–3 Sun Cluster HA for BEA WebLogic Server 拡張プロパティ

名前/データタイプ 

説明 

Confdir_list (文字列配列) 

BEA WebLogic Server のホームディレクトリ $WL_HOME のフルパスは、この拡張プロパティに設定します。

注 –

setWLSEnv.sh と startWLS.sh が標準の場所 $confdir_list/server/bin に存在しない場合には、$confdir_list/server/bin ディレクトリからこれらのファイルに対してリンクを作成する必要があります。このリンクを作成しないと、BEA WebLogic Server リソースの作成は失敗します。

初期値: なし

調整:作成時

Start_Script (文字列) 

BEA WebLogic Server インスタンス (Administration または Managed) の起動に使用されるスクリプトのフルパス。このスクリプトは通常、config.xml ファイルとともにドメイン名ディレクトリの下に存在します。各 BEA WebLogic Server を起動するために、個別スクリプトまたは単一スクリプトを設定することが可能です。詳細は、「構成に関する要件」を参照してください。

初期値: なし

調整:作成時

Server_Url (文字列) 

このリソースによって起動する BEA WebLogic Server の完全な URL (サーバーに接続するために使用されるプロトコルを含む)。検証メソッドは、この URL から HTTP GET を実行して、サーバーの健全性を検査します。URL 内のプロトコルは http に設定する必要があります。完全な URL 形式は次のようになります。


http://host:port

Server_Url の詳細については、使用するバージョンの BEA WebLogic Server マニュアルを参照してください。たとえば、BEA WebLogic Server 7.0 の場合は、マニュアルは以下の Web サイトにあります。


http://e-docs.bea/com/wls/docs70/adminguide
/startstop.html#1161188

server_url と monitor_uri_list には、必ず解決可能なホスト名を使用してください。Fully Qualified Domain Names (FQDNs) を使用する場合、DNS を使用するホスト名を解釈処理するためには、 DNS が使用可能で、さらに /etc/nsswitch.conf のエントリが正しくなければなりません。

初期値: なし

調整:作成時

Monitor_Uri_List (文字列) 

単一の URI またはコンマ区切りの URI リストです。障害モニターはこの URI に対して HTTP GET を実行することにより BEA WebLogic Server の機能性をテストします。Server_Url 拡張プロパティは、ホスト名とポートの単純な検証用です。この拡張プロパティで WLS の機能性を検証する場合、Java サーブレットを取得するか、WLS からアプリケーションを起動して HTTP サーバーのリターンコードを取得する必要があります。HTTP サーバーのリターンコードが 500 (Internal Server Error) となるか接続に失敗した場合、検証は対応処置を実行します。詳細は、検証メソッドの説明を参照してください。

server_url と monitor_uri_list には、必ず解決可能なホスト名を使用してください。Fully Qualified Domain Names (FQDNs) を使用する場合、DNS を使用するホスト名を解釈処理するためには、 DNS が使用可能で、さらに /etc/nsswitch.conf のエントリが正しくなければなりません。

初期値:Null

調整:任意の時点

Server_name (文字列) 

単一の起動スクリプトを使用してすべての Managed Server を起動する場合、起動スクリプトの引数として Managed Server 名を渡します。Agent 起動メソッドは、起動スクリプトの引数としてサーバー名を渡す必要が生じると、Managed Server 名をこの拡張プロパティに設定します。 

初期値:Null

調整:任意の時点

DB_Probe_Script (文字列) 

この拡張プロパティでは、データベース検証スクリプトへの絶対パスを設定します。HA-WLS 検証メソッドは、WLS インスタンスだけを検証します。管理者は、HA_WLS で DB も検証したい場合に、この拡張スクリプトからデータベース検証スクリプトを取得することができます。この検証スクリプトは、成功すると 0 を返します。BEA WebLogic Server は、データベース検証が成功すると起動されます。HA-WLS 検証は、WLS インスタンスの障害検出時にこの拡張プロパティが設定されていると、データベース検証が成功した場合にのみアクションを実行します。詳細については、「検証アルゴリズムと機能」を参照してください。

初期値:Null

調整:任意の時点

Smooth_shutdown 

これは、WebLogic クラスを使用してスムーズなシャットダウンを有効にする拡張プロパティです。Admin クラスWLS プロセスの終了前にスムーズシャットダウンを実行する方が望ましい場合は、この拡張プロパティを TRUE に設定します。このとき WLS_USER と WLS_PW は、boot.properties ではなく start_script に設定する必要があります。

以下のすべてに当てはまる場合に TRUE に設定します。

  • username と password を start_script に設定してもかまわない場合。

  • プロセスを終了する際、デフォルトではなくスムーズシャットダウンを実行する方が望ましい場合。

  • エージェントの停止メソッドが、ユーザー名とパスワードを起動スクリプトから読み込んで java weblogic.Admin コマンドに渡してもかまわない場合。

初期値:False

調整:任意の時点

検証アルゴリズムと機能

障害モニターは、障害を検出して処理を行います。BEA WebLogic Server 内で障害を検出すると、障害モニターは初めに BEA WebLogic Server の再起動を行います。一定の時間内に BEA WebLogic Server が一定の回数停止すると (時間と回数は管理者が設定可能)、BEA WebLogic Server を含んでいるリソースグループは動作中のほかのクラスタノードにフェイルオーバーして再起動します。

Fault Monitor メソッドは、デフォルトでは拡張プロパティ Server_url に設定されているサーバー URL の検証を行います。この検証メソッドはホスト名とポートに接続し、続いて URL に対して HTTP GET 要求を実行します。接続が失敗する場合は完全な障害とみなされ、BEA WebLogic Server を含むリソースグループの再起動が行われるか、あるいは動作中のほかのクラスタノードにフェイルオーバーし、再起動します。接続が成功したが http 応答コードが 500 (内部的なサーバーエラー) の場合も完全な障害とみなされ、リソースグループの再起動またはフェイルオーバーが行われます。ほかの http 応答コードはすべて正常とみなされます。

monitor_uri_list 拡張プロパティを設定すると、検証メソッドはリスト内に示された URI に接続し、障害が発生している場合は処理を行います。検証メソッドは、指定された URI (1 つ以上) に対して HTTP GET を実行します。

BEA WebLogic Server インスタンスの完全な停止が検証 (URL または URI の検証) によって検出された場合と、拡張プロパティ db_probe_script でデータベース検証スクリプトが指定された場合には、検証メソッドは BEA WebLogic Server リソースに対して処理を行う前にデータベースを検証します。データベース検証スクリプトが成功を示すコードを返す (データベースが稼動している) 場合は、BEA WebLogic Server リソースに対して処理が行われます。データベース検証スクリプトが障害を示すコードを返す (データベースが停止している) 場合は、BEA WebLogic Server 検証メソッドはデータベースが起動するまで何の処理 (再起動またはフェイルオーバー) も行いません。

START メソッド

リソース内で構成された BEA WebLogic Server が起動する前に、BEA WebLogic Server 構成とリソース拡張プロパティが検証されます。db_probe_script 拡張プロパティが設定されている場合には、この拡張プロパティに設定されたスクリプトを起動してデータベースの検証が行われます。データベースが起動している場合は、pmf 下の拡張プロパティ Start_script に構成されている START スクリプトを呼び出すことによって BEA WebLogic Server が起動されます。データベースが起動していない場合は、START メソッドは成功を示すコードを返し、検証メソッドに BEA WebLogic Server ソフトウェアの起動処理を任せます。「検証アルゴリズムと機能」で説明しているように、検証メソッドはデータベースが稼動状態になるのを待ってからBEA WebLogic Server を起動します。

pmf 下の START スクリプトを起動したあと、START メソッドは BEA WebLogic Server が RUNNING モードになるのを待ってから、成功を宣言します。BEA WebLogic Server の稼動を待機する間、検証メソッドはサーバーの起動をチェックするためにサーバーに接続を試みます。起動時に、コンソールにはメッセージが表示されます。メッセージ「Failed to connect to host logical-host-1 and port 7001:Connection refused」は、BEA WebLogic Server が完全に起動するまで継続して表示されます。BEA WebLogic Server が RUNNING モードになった時点で、START メソッドはステータスを「Started Successfully」に設定します。

STOP メソッド

STOP メソッドは、リソース内で構成された BEA WebLogic Server を停止します。STOP メソッドは、デフォルトでは SIGKILL を BEA WebLogic プロセスに送って BEA WebLogic Server を終了します。smooth_shutdown 拡張プロパティが TRUE に設定されている場合、STOP メソッドは次のコマンドを実行して BEA WebLogic インスタンスの停止を試みます。


java weblogic.Admin -url hostname:port -username $WLS_USER 
-password $WLS_PW SHUTDOWN

このコマンドが失敗する場合、BEA WebLogic Server は SIGKILL によってシャットダウンされます。このコマンドが成功する場合でも、STOP メソッドは SIGKILL を送信して BEA WebLogic プロセスを確実に停止します。

拡張プロパティ smooth_shutdown を TRUE に設定する場合は、必ず WLS_USER と WLS_PW を BEA WebLogic Server START スクリプトに設定してください。Smooth_shutdown を TRUE に設定すると、この拡張プロパティを再び FALSE に設定しないかぎり、WLS_USER と WLS_PW を START スクリプトから削除できません。