HATS 管理インターフェースを使用して、接続を管理し、HATS Web アプリケーションの問題を判別できます。この章では、これらの管理機能の使用方法について説明します。HATS リッチ・クライアント・アプリケーションに関する情報については、HATS リッチ・クライアント・アプリケーションの管理を参照してください。
WebSphere® Application Server に展開されている Enterprise Archive (.ear) ファイルに含まれる一連の HATS アプリケーションに HATS 管理コンソールのサポート・ファイルを含めることができます。展開済み .ear ファイルはランタイム環境を提供します。この環境では、HATS 管理コンソールを使用することにより HATS アプリケーションを管理できます。複数のプロジェクトに HATS 管理コンソール・ファイルを含めると、異なるアプリケーション名を使用して複数の管理コンソールを開始できます。ただし、各管理コンソールは同一のビューと機能を提供します。
各 .ear ファイルに HATS 管理コンソール・サポート・ファイルを含める代わりに、HATS 管理コンソール・ファイルのみを含む .ear ファイルを作成することができます。この .ear ファイルを展開すると、HATS 管理コンソールを開始して管理の有効範囲を変更することで、1 つの管理コンソールのインスタンスで (HATS IBM® ポートレットおよび標準ポートレットに加えて) 複数の .ear ファイル の HATS アプリケーションをリモート側で管理できます。展開済み HATS 管理コンソール・アプリケーションにより、すべての HATS アプリケーションをまとめて 1 箇所から管理できます。新規 HATS プロジェクトを作成するときに、プロジェクトに HATS 管理コンソール・ファイルを含めるかどうかを指定します。HATS 管理コンソール・プロジェクトを作成する場合、作成したほかのプロジェクトに管理サポート・ファイルを追加する必要はありません。
HATS Toolkit で HATS 管理コンソール・プロジェクトを作成するには、「ファイル」>「新規」>「プロジェクト」>「HATS」>「HATS 管理プロジェクト」を選択します。このプロジェクトを HATS 管理コンソール・プロジェクトとして一意に識別する Enterprise Application プロジェクト名を指定します。HATS 管理コンソール・プロジェクトは、HATS Toolkit の「ナビゲーター」タブにのみ表示されます。作成した .ear ファイルを WebSphere Application Server に展開して開始します (HATS 管理コンソールの開始を参照)。HATS 管理コンソール・プロジェクトの管理の有効範囲を変更する場合には、管理の有効範囲の選択を参照してください。
その他の管理トピックについては、端末の表示機能で説明します。
HATS 管理コンソールでは、Java™ Management Extensions (JMX) Bean を使用してリモート管理が実行されます。WebSphere Application Server のグローバル・セキュリティーが有効になっている場合は、これらの JMX 呼び出しが WebSphere セキュリティーにより認証されるため、WebSphere で有効な許可レベルが設定されている必要があります。したがって、ユーザー ID が、管理者権限またはオペレーター権限が付与されている WebSphere Application Server 管理コンソール・ユーザーとして定義されていないと、HATS 管理コンソールから適切にリモート管理操作を実行できません。
HATS 管理コンソールでは、問題判別設定を表示および変更できます。また、接続状況を確認し、ホスト接続を切断できます。HATS 管理機能を使用して HATS アプリケーションを展開する場合は、セキュリティーのために、HATS の 3 つの役割をそれぞれ特定のシステム・ユーザー ID にマップできます。定義されている 3 つの HATS 役割 (HATSAdministrator、HATSOperator、および HATSMonitor) では、それぞれに HATS 管理コンソールで実行できる機能が異なります。詳しくは、HATS 管理コンソールの役割を参照してください。
同様に、WebSphere Application Server 管理コンソールでは WebSphere Application Server 環境の構成を表示および変更できます。また、Web アプリケーション (HATS アプリケーションなど) のインストール、開始、停止、およびアンインストールを実行できます。WebSphere コンソールのユーザー役割 (管理者、コンフィギュレーター、オペレーター、またはモニター) では、それぞれに WebSphere Application Server 管理コンソールで実行できる機能が異なります。これらのセキュリティーの役割およびポリシーの詳細については、WebSphere Application Server インフォメーション・センターの以下のリンクを参照してください。
WebSphere グローバル・セキュリティーが有効な場合は、HATS 役割が設定されているユーザー ID を使用して、HATS アプリケーションで HATS 管理コンソールに接続でき、また特定の HATS アプリケーション内でのみ各管理操作を実行できます。他の HATS アプリケーションをリモート側で管理するために管理の有効範囲を変更しようとすると、WebSphere セキュリティーによりユーザー ID の権限が検査されます。ユーザー ID が、管理者権限またはオペレーター権限が設定された有効な WebSphere Application Server 管理コンソール・ユーザーでない場合は、JMX 呼び出しがブロックされ、HATS リモート管理が正しく機能しません。
例えば、ユーザー ID が WebSphere Application Server 管理コンソール・ユーザーとして定義されていないか、またはモニター権限のみが設定されている場合は、HATS 管理コンソールの「管理の有効範囲」の下の「アプリケーションの選択」リストに、他の HATS アプリケーションが表示されません。他のアプリケーションがリストされていないために、管理の有効範囲を変更できません。
もう 1 つの例として、コンフィギュレーター権限が設定された WebSphere Application Server 管理コンソール・ユーザーとして定義されているユーザー ID の場合、このリストには他の HATS アプリケーションが表示されるので、ユーザーが有効範囲を別のアプリケーションに変更できます。ただし、HATS 管理コンソールに表示される情報が正しくないことがあり、この場合リモート管理操作で試行した変更はすべて無効になります。
したがって、WebSphere グローバル・セキュリティーが有効である場合は、HATS 管理コンソールの使用に関して次の 2 つのオプションがあります。
いずれのオプションでも、WebSphere グローバル・セキュリティーが有効である場合は、「アプリケーション・セキュリティーを有効にする (Enable application security)」オプションが選択されていることを確認してください。 WebSphere Application Server V6.x の場合、WebSphere 管理コンソールから、「セキュリティー」>「セキュアな管理、アプリケーション、およびインフラストラクチャー (Secure administration, applications, and infrastructure)」>「アプリケーション・セキュリティー」>「アプリケーション・セキュリティーを有効にする (Enable application security)」を選択します。WebSphere Application Server V7.x の場合、WebSphere 管理コンソールから、「セキュリティー」>「グローバル・セキュリティー」>「アプリケーション・セキュリティー」>「アプリケーション・セキュリティーを有効にする (Enable application security)」を選択します。
要約すると、WebSphere グローバル・セキュリティーが有効な場合は、HATS リモート管理が適切に機能するように、HATS 役割にマップされているユーザー ID を、WebSphere Application Server の管理者役割またはオペレーター役割にもマップする必要があります。
HATS 管理コンソールは WebSphere セキュリティーにバインドされています。つまり、WebSphere Application Server セキュリティーが使用可能な場合には、システム管理者には HATS 管理タスクを実行するための適切な認証が必要となります。HATS により使用されるセキュリティー機能は、Java EE フォーム・ベースの認証プロセスに基づいています。WebSphere Application Server セキュリティーが使用可能な場合には、HATS 管理コンソールの操作はユーザー ID に定義されている役割に基づいて制限されます。HATS 管理コンソールの使用には、次の 3 つの役割が定義されています。各役割ではそれぞれ実行できる機能が異なります。
ユーザーまたはユーザー・グループへの役割のマッピングは、WebSphere 管理コンソールを使用して実行されます。
WebSphere Application Server V6.x の場合、適切な HATS 役割について、「セキュリティー・ロールをユーザー/グループにマップ」パネルで「認証済みすべて」オプションに必ずチェックマークを付けてください。WebSphere Application Server V7.x の場合、適切な HATS 役割について、「セキュリティー・ロールをユーザー/グループにマップ」 パネルの「特殊サブジェクトのマップ (Map Special Subjects)」ドロップダウンを使用して、「アプリケーション・レルム内の認証済みすべて (All Authenticated in Application Realm)」オプションが選択されていることを確認してください。
HATS 管理コンソールは、Web ベースです。 Web ブラウザーを使用して、HATS 管理コンソール・サーブレットである HATSAdminServlet により提供されるユーザー・インターフェースを介して管理タスクを実行します。
HATS 管理コンソールを始動するには、ブラウザーで URL http://host:port/appname/hatsadmin/admin をロードします。ここで、host は使用するホスト名、port は HATS アプリケーションが稼働しているアプリケーション・サーバーの HTTP トランスポートのポート番号、appname は管理サポートが含まれている HATS アプリケーションの名前です。
HATS 管理コンソールを始動すると、サーバーのデフォルト言語が使用されます。ただし、この言語は変更できます。言語を変更するには、ナビゲーション・フレームの「プリファレンス」を選択し、言語を選択してからブラウザーを再開始します。ブラウザーでは新たに選択した言語がデフォルトになります。この言語を変更するには、「プリファレンス」を選択して別の言語を選択します。
HATS Toolkit では、「サーバーでデバッグ」または「サーバーで実行」モードで HATS 管理コンソールを開始できます。
特定のプロジェクトに対して HATS 管理コンソールを起動するには、「HATS プロジェクト」ビューでプロジェクトを右クリックし、「管理コンソールをオープン」をクリックします。
プロジェクトがローカル・テスト環境でまだ実行されていない場合は、「サーバーでデバッグ」モードを使用してこのプロジェクトが起動され、Web ブラウザー・ページで管理コンソール URL が表示されます。
「サーバーで実行」モードでプロジェクトが既に実行されている場合は、サーバーがデバッグ・モードで実行されていないことを示すプロンプトが表示されます。「現行モードで続行 (Continue in the current mode)」オプションを選択すると、管理コンソールが「サーバーで実行」モードで開きます。
異なるテスト・モードでの実行について詳しくは、「HATS スタートアップ・ガイド」の『Web プロジェクトのテスト・モード』を参照してください。
HATS Toolkit で管理コンソールを実行するときに変更するランタイム設定は、使用しているモードによって異なります。詳しくは、問題判別コンポーネントの管理を参照してください。
このセクションでは、HATS 管理コンソールのさまざまな機能について説明します。
管理の有効範囲を選択できます。HATS 管理コンソールでは、HttpSession の存続期間にわたる管理の有効範囲のリストが維持されます。最初の管理の有効範囲は、デフォルトでは、HATS 管理コンソールへのアクセスに使用される HATS アプリケーションの HATS Enterprise Application (.ear) として選択されます。同じ WebSphere セル内に展開されている別の HATS Enterprise Application を管理するように管理の有効範囲を変更できます。
管理の有効範囲の変更で重要なことは、HATS 管理コンソールがインストールされている HATS Enterprise Application を検出できるようにホストとポートに関する情報を提供することです。指定されているポート値は、アクティブな WebSphere BOOTSTRAP_ADDRESS ポートでなければなりません。WebSphere Application Server、ノード、およびセルにはそれぞれ、BOOTSTRAP_ADDRESS ポートがあります。1 つの WebSphere リソースにポート値を指定すると、そのリソースに展開されている HATS Enterprise Application の管理が可能になります。WebSphere ノードのホストとポートを指定すると、そのノードにインストールされているすべての HATS Enterprise Application の管理が可能になります。BOOTSTRAP_ADDRESS ポートの詳細については、WebSphere Application Server の資料を参照してください。
機密保護機能のある環境では、管理者が管理の有効範囲を変更しようとすると、HATS 管理コンソールで次のメッセージが表示されることがあります。
選択された有効範囲の管理中に問題が発生しました。HATS アプリケーションがありません。管理の有効範囲は変更されませんでした。
機密保護機能のある WebSphere 環境で、管理対象の使用可能なアプリケーションのリストにデータを設定するための通信を実行する権限がユーザーにない場合に、この問題が発生することがあります。
WebSphere でユーザー・レジストリーにローカル・オペレーティング・システムを使用している場合、HATS 管理コンソールへのアクセスで使用するユーザー名に、ローカル・オペレーティング・システムのレジストリーでの管理者権限を設定する必要があります。WebSphere でユーザー・レジストリーに LDAP を使用している場合は、HATS 管理コンソールへのアクセスで使用するユーザー名は、WebSphere で LDAP へのアクセスで使用するサーバー ID である必要があります。
左側のナビゲーション・フレームの「ライセンス管理」という見出しの下に、ライセンス情報を管理するための 2 つのパネルがあります。
左側のナビゲーション・フレームの「接続管理」という見出しの下に、各種接続をモニターできる独立したパネルがあります。
これらの表示画面に表示される各接続は、バックエンド・データ・ソース (3270 アプリケーションやデータベースなど) への通信リンクを示します。これらの表示画面では、データ・ソースとユーザーの接続と、ユーザーの接続 ID に関する詳細情報を確認できます。3270 接続用の LU またはプール名が存在する場合は、それも表示されます。また、セッションをシャットダウンすることもできます。
左側のナビゲーション・フレームの「接続管理」という見出しの下にある「接続プール」パネルには、定義されている接続プールに関する情報が表示されます。接続プールの 1 つ以上の接続が割り振られるまでは、接続プールはリストされません。
接続プールは、3270 アプリケーションやデータベースのようなバックエンド・データ・ソースへの通信リンクの集合です。クライアント要求の代理として統合オブジェクトまたはアプリケーションが実行されると、このオブジェクトまたはアプリケーションはプールから使用可能な接続を取得し、この接続を使用してデータ・ソースへアクセスし、接続をプールに戻します。接続プールが使用可能になる場合、接続の確立におけるプロセッサー使用は、最初の接続の使用時に吸収されます。この接続を再利用すると、前回確立された接続が利用され、処理が高速になります。
左側のナビゲーション・フレームの「接続管理」という見出しの下にある「接続プール定義」パネルには、ホストおよびデータベース接続のプール定義情報が表示されます。定義されているプールから 1 つ以上の接続が割り振られるまでは、プール定義はリストされません。
プール定義は、データ・ソース接続の集合に関する情報を提供します。プール定義には、関連する一部の定義 (接続とマクロの定義やユーザー・リスト名など) が関連付けられています。プール定義は、他のいくつかの定義間の関連を作成するほかに、最小および最大プール・サイズ (アクティブ接続数に換算) や接続タイマーなど、プール内のすべての接続に対する構成パラメーターを提供します。
左側のナビゲーション・フレームの「ユーザー管理」という見出しの下にある「ユーザー・リスト」パネルには、ユーザー・リストに関する情報が表示されます。
ユーザー・リストは、特定の接続プール定義に関連付けられているユーザー ID やその他の接続固有パラメーターを示します。ユーザー ID ごとに 1 つの接続だけが許可されるシステムでは、1 つのプールでアクティブな接続の数はユーザー ID の数によって決まります。
HATS 管理コンソールでは、問題解決時に役立つロギングとトレースをモニターできます。左側のナビゲーション・フレームの「トラブルシューティング」という見出しの下にあるリンクを選択して、ログ内のメッセージを表示したり、ログ設定やトレース設定を変更したりできます。このような問題判別補助機能の設定は、プロパティー・ファイルに維持されています。
ランタイム環境で実行されている HATS 管理コンソールへのアクセス中に設定を変更すると、この変更は runtime.properties ファイルに保存されます。この方法は推奨しませんが、ファイルを直接編集して設定を変更することもできます。このファイルは HATS Enterprise Application の was_dir/installedApps/ear_name ディレクトリーに格納されています。
HATS Toolkit 内のローカル・テスト環境で実行されている HATS 管理コンソールへのアクセス中に設定を変更すると、この変更は異なる 2 つのファイルのいずれか 1 つに保存されます。「サーバーで実行」モードで実行している場合は、変更は runtime.properties ファイルに保存されます。「サーバーでデバッグ」モードで実行している場合は、変更は runtime-debug.properties ファイルに保存されます。詳しくは、HATS Toolkit での管理コンソールの開始を参照してください。ファイルを直接編集して設定を変更することもできます。これらのファイルは HATS Toolkit の .ear プロジェクトのルートにあります。 HATS Toolkit で runtime.properties ファイルが変更された場合、その変更は保持され、HATS アプリケーションをランタイム環境に展開するときに有効になります。runtime-debug.properties ファイルは、ランタイム環境では無視されます。
これらのファイルでのログ設定とトレース設定について詳しくは、付録A. ランタイム・プロパティー・ファイルを参照してください。
runtime.properties に記述されている基本ログおよびトレース・ファイルの名前は、各アプリケーション・サーバーの一意のログ・ファイルおよびトレース・ファイルのセットを生成するときにテンプレートとして使用されます。デフォルトの基本トレース・ファイル名は trace.txt、デフォルトの基本ログ・ファイル名は messages.txt です。アプリケーション・サーバーのログ・ファイルおよびトレース・ファイルのテンプレートを生成するときには、基本ファイル名にアプリケーション・サーバー名が付加されます。このアプリケーション・サーバー名は、WebSphere で定義されているアプリケーション・サーバーの完全修飾名と同一です。この名前は cell_node_server です。
HATS を実行しているアプリケーション・サーバーの名前は、アンダースコアー文字 (_)、アプリケーション・サーバー名、アンダースコアー文字 (_) をこの順序で連結したものになります。
例えばトレース・ファイルを使用する場合、この名前は trace _cell_node_server_.txt となります。さらに、複数のファイルを区別する場合、この名前に索引 (1、2、3 ...) を追加します。複数のトレース・ファイルが構成されている場合、このアプリケーション・サーバーのトレース・ファイル名は trace_cell_node_server_1.txt, trace_cell_node_server_2.txt ... となります。
「ログの表示」パネルを使用して、HATS ログ・ファイルを表示したり、ファイル全体をダウンロードしたり、ファイルをクリアしたりできます。ログ・ファイルには、次の 2 種類のイベントに関する情報が記録されます。
ログ・ファイルは、管理者がトラブルシューティングを行うときに参照し、参考情報として使用することを目的としています。ログに表示されるメッセージのほとんどは、「HATS メッセージ」に収録されています。この資料では、必要に応じて実行できる問題訂正アクションを提案しています。
「ログ設定」パネルでは、ログ・ファイルへの情報と警告イベントの書き込みを制御し、ログ・イベントの書き込み先ファイルを定義できます。ログ・ファイル名の指定方法については、ログ・ファイルとトレース・ファイルの名前を参照してください。ファイルがすでに存在している場合には、新しいイベントはこのファイルに追加されます。エラー・イベントは常にログ・ファイルに書き込まれます。維持するログ・ファイルの数と各ログ・ファイルの最大サイズも定義できます。
「トレース設定」パネルを使用して、次のタイプのトレース・オプションを 1 つ以上選択できます。
複数のホスト・セッションを同時にトレースするため、ホスト・シミュレーションでは複数の TCP/IP ポートが使用されます。「記録の対象となる TCP/IP ポート範囲」フィールドを使用してサーバーが実行時に使用するポート番号の範囲を設定します。デフォルトの範囲開始ポートは 7021、デフォルトの終了ポートは 7050 です。
テスト・システムでアプリケーションをデバッグするときに、サーバーのディスプレイ上にホスト画面を表示する端末ウィンドウを作成するかどうかを制御できます。端末ウィンドウに表示されるホスト画面では、実行時に HATS アプリケーションとホスト・アプリケーションの間の対話を監視できます。また、端末ウィンドウのホスト画面を使用してホスト・アプリケーションと対話することもできます。このオプションがオンの間に確立された接続の端末画面のみが作成されます。既存の接続またはアイドル状態の接続には作成されません。ただし、HATS 管理コンソールの「ホスト接続」パネルには、選択されている接続の端末の表示をオンまたはオフにする「表示状況の切り替え (Toggle Display Status)」ボタンがあります。
新しいホスト接続で端末の表示をオンにするには、左側のナビゲーション・フレームにある「トラブルシューティング」という見出しの下の「トレース設定」パネルの「端末の表示を使用可能にする」ボックスを選択します。ただし、「トレース設定」パネルの「端末の表示を使用可能にする」ボックスが選択されているかどうかに関係なくいつでも特定の接続の端末の表示をオンまたはオフにするには、「ホスト接続」パネルの「端末の表示の切り替え」ボタンを使用します。