手順 1: HTTP トンネルサーブレットを配備する (Sun Java System Message Queue 3.7 UR1 管理ガイド)

Sun Java System Message Queue 3.7 UR1 管理ガイド

手順 1: HTTP トンネルサーブレットを配備する

HTTP トンネルサーブレットは、Sun Java System Web Server または Sun Java System Application Server に、Web アーカイブ (.war) ファイルとして配備できます。

HTTP トンネルサーブレットを .war ファイルとして配備するときは、Web サーバーまたはアプリケーションサーバーで提供される配備メカニズムを使用します。HTTP トンネルサーブレットの .war ファイル (imqhttp.war ) は、.jar、 .war、および .rar ファイルを含むディレクトリに配備します。これはオペレーティングシステムによって異なります (付録 A 「プラットフォームごとの Message Queue^TM データの場所」を参照)。

.war ファイルには、Web サーバーまたはアプリケーションサーバーがサーブレットを読み込んで実行するときに必要となる基本的な設定情報が示された配備記述子が含まれています。Web サーバーまたはアプリケーションサーバーによっては、サーブレットの URL のコンテキストルート部分を指定しなければならない場合もあります。

Web アーカイブファイルとして配備する

Sun Java System Web Server への配備については、「HTTP トンネルサーブレットを Sun Java System Web Server に配備する」を参照してください。

Sun Java System Application Server への配備については、「HTTP トンネルサーブレットを Message Queue Application Server に配備する」を参照してください。

HTTP トンネルサーブレットを Sun Java System Web Server に配備する

ここでは、Message Queue Web Server への配備手順について説明します。Web ブラウザを使用してサーブレットの URL にアクセスすると、HTTP トンネルサーブレットが問題なく配備されたことが確認できます。ステータス情報も表示されます。

HTTP トンネルサーブレットを .war ファイルとして配備する

ブラウザベースの管理 GUI で、「Virtual Server Class」タブを選択してから、「Manage Classes」を選択します。

適切な仮想サーバークラス名 (defaultClass など) を選択して、「Manage」ボタンをクリックします。

「Manage Virtual Servers」を選択します。

適切な仮想サーバー名を選択し、「Manage」ボタンをクリックします。

「Web Applications」タブを選択します。

「Deploy Web Application」をクリックします。

「WAR File On」フィールドおよび「WAR File Path」フィールドで、imqhttp.war ファイルを指す適切な値を選択します。このファイルはオペレーティングシステムによって異なるディレクトリに格納されています (付録 A 「プラットフォームごとの Message Queue^TM データの場所」を参照)。

「Application URI」フィールドにパスを入力します。

「Application URI」フィールドの値は、トンネルサーブレット URL の /contextRoot 部分です。

http://hostName :portNumber / contextRoot/tunnel

たとえば、contextRoot を imq に設定した場合、「Application URI」フィールドは次のようになります。

/imq

サーブレットを配備するインストールディレクトリのパス (通常は、Message Queue Web Server インストールルートの内の場所) を入力します。

「OK」をクリックします。

Web サーバーインスタンスを再起動します。

サーブレットは次のアドレスで利用可能となります。
http://hostName:portNumber/ contextRoot/tunnel
クライアントはこの URL を使用することで、HTTP 接続を使ってメッセージサービスに接続できます。

サーバーのアクセスログを無効にする

必ずしもサーバーのアクセスログを無効にする必要はありませんが、無効にしたほうがより良いパフォーマンスを得ることができます。

サーバーのアクセスログを無効にする

「Status」タブを選択します。

「Log Preferences Page」を選択します。

Log クライアントアクセス制御を使用して、ロギングを無効にします。

HTTP トンネルサーブレットを Message Queue Application Server に配備する

この節では、HTTP トンネルサーブレットを Message Queue Application Server に .war ファイルとして配備し、Message Queue ブローカからの接続を受け付けるようにトンネルサーブレットを設定する方法について説明します。

2 段階の手順が必要です。

Application Server の配備ツールを使用して HTTP トンネルサーブレットを配備します。
アプリケーションサーバーインスタンスの server.policy ファイルを変更します。

配備ツールを使用する

HTTP トンネルサーブレットを Application Server 環境に配備する

Web ベースの管理 GUI で、次を選択します。

「App Server」>「Instances」>「server1」>「Applications」>「Web Applications」

「Deploy」ボタンをクリックします。

「File Path:」テキストフィールドに、HTTP トンネルサーブレットの .war ファイル (imqhttp.war) の場所を入力し、「OK」をクリックします。

imqhttp.war ファイルの場所は、オペレーティングシステムによって異なります (付録 A 「プラットフォームごとの Message Queue^TM データの場所」を参照)。

「Context Root」テキストフィールドの値を設定し、「OK」をクリックします。

「Context Root 」フィールドの値は、トンネルサーブレット URL の /contextRoot 部分です。

http:// hostName :portNumber / contextRoot/tunnel

たとえば、「Context Root」フィールドは /imq に設定できます。

表示される確認画面で、トンネルサーブレットが正常に配備され、デフォルトで有効になっており、この場合は次の場所に格納されていることが確認されます。
/var/opt/SUNWappserver8/domains/domain1/server1/applications/ j2ee-modules/imqhttp_1
サーブレットは次の URL で利用可能となります。
http://hostName:portNumber/ contextRoot/tunnel
クライアントはこの URL を使用することで、HTTP 接続を使ってメッセージサービスに接続できます。

server.policy ファイルを変更する

Application Server は、セキュリティーポリシーが変更されていないかぎり、強制的にデフォルトのセキュリティーポリシーセットを適用し、HTTP トンネルサーブレットが Message Queue ブローカからの接続を受け入れるのを阻止します。

各アプリケーションサーバーインスタンスには、セキュリティーポリシーまたはルールを含むファイルがあります。たとえば、Solaris 上の server1 インスタンスのこのファイルは次の場所にあります。

/var/opt/SUNWappserver8/domains/domain1/server1/config/
server.policy

トンネルサーブレットに Message Queue ブローカからの接続を受け入れさせるように設定するには、このファイルにエントリを追加する必要があります。

アプリケーションサーバーの server.policy ファイルを変更する

server.policy ファイルを開きます。

次のエントリを追加します。

grant codeBase
"file:/var/opt/SUNWappserver8/domains/domain1/server1/
                applications/j2ee-modules/imqhttp_1/-”
{
        permission java.net.SocketPermission "*",
                “connect,accept,resolve";
};