![]() | |
Sun Java System Application Server Enterprise Edition 8.1 2005Q1 |
クイックスタートガイド
『Sun JavaTM System Application Server Enterprise Edition 8.1 2005Q1 クイックスタートガイド』へようこそ。このマニュアルは、Sun JavaTM System Application Server Enterprise Edition 8.1 2005Q1 ソフトウェアの機能の学習を目的とする開発者、システム管理者、および Application Server 管理者を対象としています。
このマニュアルの最新版については、次の場所にある docs.sun.com のオンライン版を参照してください。
http://docs.sun.com/app/docs/prod/sjs.asse
このマニュアルでは、Application Server を使用する場合の基本的な手順と高度な手順について説明します。手順は、それらを完了させるために必要な順序で示されます。次の項で説明する基本手順は、通常 45 分未満で完了します。
次の項で説明する高度な手順は、通常およそ 45 分で完了します。
このマニュアルの最後の項では、クリーンアップの手順を説明し、次のステップの説明を行います。
次の表に、このマニュアルで使用するディレクトリの変数名とデフォルトパスをまとめてあります。最初の列は変数名、2 番目の列はデフォルトのパスです。
Application Server の管理について管理者が複数のホスト上で実行されるサーバーインスタンスとクラスタを管理できるようにするために、Application Server は次のツールを提供します。
これらのツールは、すべての管理タスク内で仲介機能を果たす特別に指定された Application Server インスタンスである「ドメイン管理サーバー」と呼ばれるサーバーに接続します。ドメイン管理サーバーは、使用するインタフェースに関係なく、管理コマンドを検証し、実行するためのセキュリティで保護された単一のインタフェースを提供します。
「ドメイン」は、設定データ、配備されたアプリケーション、および管理者が指定されたマシンなどの集合です。ドメイン定義は、複数のアプリケーション、スタンドアロンのアプリケーションサーバーインスタンス、およびクラスタの動作を記述し、その制御を可能にし、複数のマシンに配布することができます。ドメイン管理サーバーをインストールすると、常に domain1 と呼ばれるデフォルトドメインがインストールされます。このマニュアルでは、デフォルトドメインを使用します。
このマニュアルで説明する大部分の手順を完了するには、管理コンソールを使用します。
ドメイン管理サーバーの起動このトピックでは、3 つの基本的なトピックの最初として、次の手順について説明します。
管理サーバーの起動
管理サーバーを起動するには、次の手順に従います。
- PATH 環境変数に、install_dir/bin/ ディレクトリを追加します。
C シェル:
setenv PATH install_dir/bin:$PATH
Bourne シェル:
PATH=install_dir/bin:$PATH
export PATH- コマンドを実行するたびに入力しなくても済むように、管理ユーザーの環境変数を設定します。
C シェル:
setenv AS_ADMIN_USER admin_user
Bourne シェル:
AS_ADMIN_USER=admin_user
export AS_ADMIN_USER- install_dir から次のコマンドを入力して、サーバーを起動します。
asadmin start-domain domain1
管理パスワードおよびマスターパスワードの入力を求められた場合は、インストール時に使用したパスワードを入力します。
- ドメイン管理サーバーが起動中であることを知らせるメッセージが表示されます。
domain1 ドメインを起動しています。お待ちください。ログが domain_dir/domain1/logs/server.log にリダイレクトされます...- 起動プロセスが完了すると、次のメッセージが表示されます。
ドメイン domain1 が起動しました。
管理コンソールへのログイン
管理コンソールは、さまざまな管理作業および設定作業を単純化するブラウザインタフェースです。通常、管理コンソールは次の作業に使用されます。
管理コンソールの使用に関する詳細は、オンラインヘルプまたは『Sun Java System Application Server Enterprise Edition 8.1 2005Q1 管理ガイド』を参照してください。
管理コンソールにログインするには、次の手順に従います。
- ブラウザで、次の URL を入力します。
https://localhost:4849/asadmin
管理コンソールはセキュリティで保護された Web アプリケーションであるため、http ではなく https を使用する必要があります。
localhost 変数を、ドメイン管理サーバーを実行するシステム名に置き換えます。
4849 は管理コンソールのデフォルトのポート番号です。インストール時にポート番号を変更した場合は、その番号を使用してください。
注
ポップアップウィンドウに、「Web サイトは不明の認証局により認証されました」のようなメッセージが表示された場合は、「了解」をクリックしてください。
このメッセージが表示されるのは、セキュア伝送プロトコルで、管理コンソールのサービスを提供するために使用するドメイン管理サーバーが使用する自己署名の証明書をユーザーのブラウザが認識しないためです。
- ログインウィンドウが表示されたら、管理ユーザー名とパスワードを入力します。
- 「ログイン」をクリックします。
管理コンソールが次のように表示されます。
左側の区画では、用意されたツリーを使用して、管理する項目を選択できます。右側の区画では、「共通操作」見出しの下に、さまざまな管理タスクが表示されています。
ログファイルの調査
Application Server インスタンスとドメイン管理サーバーは、ファイルシステム上で注釈つきのログを生成します。デフォルトでは、すべてのエラー、警告、また有用な通知メッセージがログとして記録されます。管理サーバーのログファイルを確認するには、次の手順に従います。
- 右側の区画の「共通操作」から、「ログファイルを検索します」をクリックして、ログビューア用の新しいブラウザウィンドウを起動します。
- ログビューアウィンドウで、「インスタンス名」ドロップダウンリストからサーバーを選択し、「検索」をクリックします。ドメイン管理サーバーの最近のログファイルエントリが表示されます。
- メッセージをスキャンして、サーバーの起動時に問題が検出されたことを示す「WARNING」メッセージ、または「SEVERE」メッセージを調べます。
ログビューアは、いつでも閉じることができます。クラスタを作成し、アプリケーションを配備した後で、操作の失敗がないかどうかを確認するために、ログファイルを調べることをお勧めします。ログビューアは、ドメイン内で実行している Application Server インスタンスのログファイルを表示するために使用できます。
ログファイルに関する詳細は、『Sun Java System Application Server Enterprise Edition 8.1 2005Q1 管理ガイド』を参照してください。
ここでは、ドメイン管理サーバーを起動し、サーバーが正常に実行されていることを確認しました。また、管理コンソールにログインし、ログビューアを使用しました。続行しない場合は、ここでクイックスタート手順の実習を中止することができます。
クラスタの作成ここでは、3 つの基本トピックの 2 番目として、2 つの Application Server インスタンスを含むクラスタの作成方法について説明します。説明を簡単にするために、クラスタは完全に 1 つのマシン内で実行されているものとします。このトピックでは、次の手順について説明します。
ノードエージェントの起動
「ノードエージェント」は、Application Server の管理ドメインに参加する各マシンで実行される軽量プロセスです。ノードエージェントは、ホスト上のサーバーインスタンスの起動および停止を管理します。また、ドメイン管理サーバーと共同して、新しい Application Server インスタンスを作成します。
マシンが属する各 Application Server の管理ドメイン用として、1 台のマシンに 1 つのノードエージェントが必要です。インストール時に「ノードエージェントコンポーネント」を選択した場合は、hostname と呼ばれるデフォルトのノードエージェントが作成されます。
デフォルトノードエージェントを起動するには、次の手順に従います。
クラスタの定義
「クラスタ」とは、同一の設定、リソース、アプリケーションを共有する、サーバーインスタンスのグループで、通常、複数のホスト上に構成されます。クラスタにより、サーバーインスタンス間のロードバランスが保たれ、フェイルオーバーを通じて処理が継続されることで、高可用性を実現します。複数のマシンにまたがるクラスタを作成し、各マシン上で、ノードエージェントを用いてこれらのクラスタを管理することができます。このマニュアルでは、説明を簡単にするために、サンプルとして使用するクラスタは、ドメイン管理サーバーを実行するマシンと同じホスト上にあるものとします。
前述の項で説明したとおり、各マシンでノードエージェントプロセスをあらかじめ実行している必要があります。クラスタの作成時にインスタンスを指定する場合は、インスタンスを実行するマシンで実行しているノードエージェントと指定するインスタンスとを関連付ける必要があります。ノードエージェントとインスタンスの名前は、1 つのドメインで作成されるクラスタ間で一意のものとする必要があります。
クラスタを作成するには、次の手順に従います。
- まだログインしていない場合は、管理コンソール (https://localhost:4849) にログインします。
localhost 変数を、ドメイン管理サーバーを実行するシステム名に置き換えます。
4849 は管理コンソールのデフォルトのポート番号です。インストール時にポート番号を変更した場合は、その番号を使用してください。
- 右側の区画の「共通操作」で、「新しいクラスタを作成します」をクリックし、「クラスタの作成」入力ページを表示します。
- 新しいクラスタの名前として、FirstCluster と入力します。
- 利用可能な設定テンプレートのドロップダウンリストから、default-config 設定を選択し、「選択している設定のコピーを作成します」を選択します。
- 「追加」ボタンを 2 回クリックして、クラスタ用の 2 つのインスタンスを指定する 2 つのエントリを作成します。
- インスタンス名として、i1 と i2を入力します。ノードエージェント名には、ローカルマシンの名前が自動的に割り当てられます。
次のような画面が表示されます。
- 「了解」をクリックします。この作成プロセスには数分かかります。
作成プロセスが完了すると、「クラスタは正しく作成されました」ページが表示され、FirstCluster が左側の区画のツリーに表示されます。このクラスタ用に、設定テンプレート default-config のコピーが作成され、FirstCluster-config という名前が割り当てられています。
- 左側の区画でクラスタを展開し、「FirstCluster」をクリックして、クラスタの「一般情報」ページを表示します。
- 「インスタンス」タブをクリックして、作成したインスタンス i1 と i2 を表示します。
ここでは、1 つのマシンで、1 つのクラスタを作成しました。各マシンにソフトウェアをインストールし、ノードエージェントを実行している限り、同じ基本手順を使用して、複数のマシンにまたがるクラスタを作成することもできます。
続行しない場合は、ここでクイックスタート手順の実習を中止することができます。
アプリケーションの配備ここでは、3 つの基本トピックの最後として、次の手順について説明します。
サンプルアプリケーションの配備
このマニュアルでは、clusterjsp というサンプルアプリケーションを使用して Web パスのロードバランス機能を説明します。
- まだ移動していない場合は、「ホーム」ボタンをクリックして「共通操作」ページに移動します。
- 右側の区画の「共通操作」の下で、「Enterprise アプリケーションを配備」をクリックします。
- 「アップロードするファイル」テキストボックスで、「ブラウズ」ボタンをクリックして、install_dir/samples/ee-samples/highavailability/apps/clusterjsp/clusterjsp.ear に移動します。
- 「次へ」をクリックして、「Enterprise アプリケーションを配備」ページを表示します。
- スクロールダウンして、ページの「ターゲット」セクションに移動します。
- 利用可能なリストから FirstCluster を選択し、「追加」をクリックして、選択されたリストに FirstCluster を移動します。
- 「了解」をクリックします。
これで、clusterjsp アプリケーションが FirstCluster に配備されました。
次の画面で、clusterjsp アプリケーションが FirstCluster に配備されていることを確認します。
クラスタ化されたアプリケーションの動作確認
この手順では、クラスタを起動し、アプリケーションが両方のインスタンスでアクセス可能かどうかを確認します。
クラスタを起動するには、次の手順に従います。
各インスタンスでアプリケーションにアクセスするには、次の手順に従います。
- ブラウザで、次の URL を入力します。
http://localhost:port/clusterjsp
localhost 変数を、ドメイン管理サーバーを実行するシステム名に置き換えます。
port 変数を、i1 の HTTP-LISTENER-PORT の値に置き換えます。この例では、http://localhost:38081/clusterjsp を使用します。
- セッションの属性データのいくつかを追加します。
- セッションおよびホスト情報が次のとおり表示されるかどうかを確認します。たとえば、次のように表示されます。
- セッションデータのいくつかを追加して、「セッションに追加」ボタンをクリックします。
- ブラウザで、次の URL を入力し、インスタンス i2 に対してこの手順を繰り返します。
http://localhost:38080/clusterjsp
ここでは、クラスタにアプリケーションを配備して、クラスタのすべてのインスタンスでアプリケーションが利用可能かどうかをテストしました。
おめでとうございます。これで、この『クイックスタートガイド』の基本手順が修了しました。高度な手順に進まない場合は、ここでクイックスタート手順の実習を中止することができます。
ロードバランスの設定通常、ロードバランサはクラスタの前面に配備されます。これにより、次を実行することができます。
Application Server には、Apache、Sun JavaTM System Web Server などの一般的な Web サーバー用のロードバランスプラグインが用意されています。
ここでは、Sun Java System Web Server ソフトウェアをダウンロードし、Application Server のクラスタに対するロードバランサとして機能するように設定する方法の手順について説明します。この項を完了するには、このマニュアルの手順に従って今までに作成したドメイン管理サーバーと 2 つの Application Server のインスタンスに加え、Web Server を実行するための十分なメモリーがシステムに必要です。このため、512 〜 1024M バイトのメモリーを持つシステムをお勧めします。
このトピックでは、次の手順について説明します。
Web Server ソフトウェアのインストール
すでに Web Server ソフトウェアがインストールされていて、Web Server インスタンスがロードバランサとして機能することが確認できる場合は、このインスタンスのファイルシステム内の場所をメモして、「ロードバランサプラグインのインストール」に進んでください。
Sun Java Enterprise System ソフトウェアを使用する場合は、ロードバランサプラグインのインストールを選択すると、Web Server が自動的にインストール用に選択されます。ただし、次の手順を使用して Web Server ソフトウェアをインストールすることもできます。
スタンドアロンの Sun Java System Application Server を使用する場合、または Sun Java Enterprise System インストーラへのアクセス権がない場合は、次の手順を使用して Web Server ソフトウェアをインストールします。
- http://www.sun.com/downloads にアクセスします。スクロールダウンして「Web & Proxy Servers」見出しに移動し、「Web Servers」をクリックします。
- 選択したロケールおよびプラットフォームの Web Server 6.1 Service Pack 2 以上をダウンロードします。
ダウンロードするには、MySunSM、Sun StoreSM、SunSolveSM、またはオンラインサポートセンターに登録したユーザー名とパスワードを使用してログインする必要があります。ログインアカウントを持っていない場合は、オンラインで登録することができます。
- 手順に従って Web Server ソフトウェアをインストールします。次の操作を実行する必要があります。
- 圧縮されたアーカイブからこのソフトウェアを抽出します。
- セットアッププログラムを実行します。追加情報が必要な場合は、http://docs.sun.com/doc/819-0131-10 にある Web Server のインストール手順を参照してください。
- Web Server のインストールプロセスでは、Web Server 用の管理サーバーが構成され、デフォルトの Web Server インスタンスの定義が要求されます。
ロードバランサプラグインのインストール
ロードバランサプラグインをインストールするには、次の手順を実行します。
ロードバランサ設定の作成
ここで、Application Server のドメイン管理サーバーの操作に戻ります。ここでは、シェル実行環境が必要になります。
- 次のコマンドを実行して、FirstCluster クラスタを対象にした MyLbConfig と呼ばれるロードバランサ設定を作成します。
asadmin create-http-lb-config --target FirstCluster MyLbConfig
- FirstCluster およびこのクラスタに配備されている clusterjsp アプリケーションを次のように有効化して、HTTP のロードバランスができるようにします。
asadmin enable-http-lb-server FirstCluster
asadmin enable-http-lb-application --name clusterjsp FirstCluster
- ロードバランサ用の診断プログラムを作成します。このプログラムは、ダウンしているインスタンスが復旧したときにシグナルを送ります。
asadmin create-http-health-checker --interval 10 --config MyLbConfig FirstCluster
interval は、診断プログラムが健全でないインスタンスのチェック間で待機する秒数です。
- この設定をファイル loadbalancer.xml にエクスポートします。
asadmin export-http-lb-config --config MyLbConfig loadbalancer.xml
- loadbalancer.xml を web_server_install_dir/https-hostname/config/loadbalancer.xml にコピーします。
ロードバランサの起動
ロードバランサとして機能する Web Server インスタンスがまだ実行されていない場合は、次のコマンドを使用して Web Server ソフトウェアを起動します。
ロードバランサとして機能する Web Server インスタンスがまだ実行されていない場合は、次のコマンドを使用して Web Server ソフトウェアを再起動します。
ロードバランスの検証
- clusterjsp アプリケーションを表示するには、ブラウザで、次の URL を入力します。
http://localhost:web_server_port/clusterjsp
localhost 変数を、Web Server を実行するシステム名に置き換えます。
web_server_port 変数を、web_server_install_dir/https-hostname/config/server.xml の LS 要素のポート属性の値に置き換えます。この例では、ポート 38000 を使用しています。
「クラスタ化されたアプリケーションの動作確認」の項で使用したページと類似したページが表示されます。
- セッションおよびホスト情報が次のとおり表示されるかどうかを確認します。たとえば、次のように表示されます。
- Server Port Number は 38000、つまり Web Server のポートです。ロードバランサは、クラスタの 2 つのインスタンスに要求を転送しました。
- 別のブラウザソフトウェア、または別のマシン上のブラウザを使用して、新しいセッションを作成します。同じブラウザからの要求は「スティッキー (sticky)」であるため、同じインスタンスに転送されます。
これらのセッションは、クラスタの 2 つのインスタンスに分散されている必要があります。次の場所にあるサーバーアクセスログファイルを調べれば確認できます。
- Solaris Java Enterprise System インストールの場合
/var/opt/SUNWappserver/nodeagents/nodeagent_name/i1/logs/access/server_access_log
/var/opt/SUNWappserver/nodeagents/nodeagent_name/i2/logs/access/server_access_log- Linux Java Enterprise System インストールの場合
/var/opt/sun/appserver/nodeagents/nodeagent_name/i1/logs/access/server_access_log
/var/opt/sun/appserver/nodeagents/nodeagent_name/i2/logs/access/server_access_log- スタンドアロンの Application Server インストールの場合
install_dir/nodeagents/nodeagent_name/i1/logs/access/server_access_log
install_dir/nodeagents/nodeagent_name/i2/logs/access/server_access_log- HttpSession に格納する名前と値のペア (Name=Name Value=Duke) を追加します。
- 「セッションデータに追加」ボタンをクリックします。
- セッションデータが追加されたかどうかを確認します。
ここでは、ロードバランサとして使用するインスタンスを作成し、ロードバランス設定をセットアップしました。また、ロードバランスの検証も行いました。
HTTP セッションのフェイルオーバーを設定し検証するには、「高可用性フェイルオーバーの設定」に進んでください。
クリーンアップクリーンアップを行うには、「オプション 1: インストールした Application Server のアンインスール」で説明する手順を実行して、インストールした Application Server をアンインストールするか、または「オプション 2: サンプルクラスタの削除」で説明する手順を実行して、作成したサンプルクラスタを削除します。
警告
「高可用性クラスタと HADB について」の手順に進む場合は、ここではインストールをクリーンアップしないでください。代わりに、「高可用性クラスタと HADB について」の項に進み、それが完了したときに、そこに記載されている手順を使用してクリーンアップしてください。
オプション 1: インストールした Application Server のアンインスール
完全にアンインストールするには、次の手順に従います。
- 次のコマンドを使用して、Application Server プロセスを停止します。
asadmin stop-cluster FirstCluster
asadmin stop-node-agent hostname
asadmin stop-domain domain1
この時点で、Application Server に関連するすべてのプロセスが停止します。
- Application Server をアンインストールします。
Java Enterprise System インストールでは、 var/sadm/prod/entsys/uninstall を実行して、アンインストールウィザードが示す手順に従います。
スタンドアロンの Application Server インストールでは、install_dir/uninstall を実行して、アンインストールウィザードが示す手順に従います。
- この実習で Web Server をインストールした場合は、ロードバランサとして機能している Web サーバーインスタンスを停止し、Web Server 製品をアンインストールします。インスタンスを停止するには、次のコマンドを実行します。
web_server_install_dir/https-hostname/stop
- Web Server 製品をアンインストールする場合は、web_server_install_dir からアンインストールプログラムを実行します。
オプション 2: サンプルクラスタの削除
FirstCluster (サンプル用の高可用性クラスタ) と、この実習中に使用したサンプルアプリケーションだけを削除する場合は、次の手順に従います。
- 次のコマンドを使用して、Application Server プロセスを停止し、設定をクリーンアップします。
asadmin stop-cluster FirstCluster
asadmin disable-http-lb-server FirstCluster
asadmin delete-http-lb-ref --config MyLbConfig FirstCluster
asadmin delete-http-lb-config MyLbConfig
asadmin delete-instance i1
asadmin delete-instance i2
asadmin delete-cluster FirstCluster
asadmin undeploy clusterjsp
- 次のコマンドを実行して、ロードバランサとして機能する Web サーバーインスタンスを停止します。
web_server_install_dir/https-hostname/stop
- web_server_install_dir/https-hostname/config にある loadbalancer.xml ファイルの名前を loadbalancer.xml.sav に変更します。
おめでとうございます。これで、Application Server のクイックスタートの手順をすべて修了しました。
次のステップApplication Server ソフトウェアの学習や使用に活用できるリソースとして、さらに次のものがあります。