訳：日本アイ・ビー・エム(株) ソフトウェア事業部 米持 幸寿

このドキュメントは、Apache SOAP 2.0レベルのものを日本語訳したもので、 最新版のものとは異なる可能性があります。また、ウェブ上で見る場合、一部 のリンクが切れている可能性があります。Apache SOAPのディレクトリの該当 ファイルと置き換えることで、オリジナルのページにリンクさせることができ ます。

Apache-SOAP Version 2.0:
IBM WebSphere Advanced Edition への導入手順

以下の手順は次の環境に導入することを前提にしています。:

• WinNT 4.0 (他のプラットフォームでもだいたい同じです)
• WebSphere Advanced Edition 3.5 with fix pack 2 (SOAP 2.0 には、Servlet API　2.2　が必要です)

重要：
WebSphere には、DOM level1 インターフェイスを使う XML parser (WebSphere\AppServer\lib\xml4j.jar) が付いてきます。ユーザーのクラスパスに Xerces 1.1.2（またはそれ以降）の xerces.jar ファイルを追加すると、WebSphere の中で動くコードは間違ったインターフェイスを見つけてしまします。これは、WebSphere がユーザーのクラスパスを最後に追加するためです。そこで、WebSphere\AppServer\bin\admin.config　ファイルを編集して、xerces.jar ファイルが com.ibm.ejs.sm.adminserver.classpath= の値の先頭に来るようにします。

SOAP サーバーのセットアップ:

• NTスタートメニューの「WebSphere」メニューから:
  1. 「Start Admin Server」 を実行して終わるまで待ちます。
  2. 「管理コンソール」を起動します。
  　
  
• 管理コンソールから:
  1. コンソール/タスク/アプリケーション・サーバーの作成
     1. 「Web アプリケーション」を選択：「次へ」
     2. アプリケーション・サーバーのプロパティー：アプリケーション・サーバー名を「SOAP（別の名前でも構いません）」としてください。「次へ」
     3. アプリケーション・サーバー開始オプション：「サーバーを作成した後に自動的に開始しない」を選択して「次へ」
     4. ノードの選択：ご自分のノードを選択して「次へ」
     5. 仮想ホストの選択：「default_host」を選択して「次へ」
     6. サーブレット・エンジンのプロパティー：ディフォルトのままで「次へ」
     7. ウェブ・アプリケーションのプロパティー： Webアプリケーション・パスを「/soap」に設定します。/webapp/SoapWebApp のままでも構いませんが「/soap」のほうが短くて済みますし、この手順の中でもこれを使います。ここで、「/soap」にしなかった場合、あとのＵＲＬに影響しますので、「/soap」にしておくことをお薦めします。「次へ」
     8. システム・サーブレットの指定：「JSP 1.0」か「JSP 1.1 を使用可能にする」
     9. 「終了」を押すと SOAP アプリケーション・サーバーが作成されます。
  　
  
• ツリー表示から「SoapWebApp」を選択し、「拡張」タブを選択します。
  1. 文書ルートを "C:\install-dir\soap-2_0\webapps\soap" に変更します。
  2. クラスパスを以下のように設定します。
     • C:\install-dir\soap-2_0\lib\soap.jar
     • C:\install-dir\soap-2_0
     • 必要に応じてあなたのSOAPサーバークラス
  　
  
• コンソール/タスク/サーブレットの追加
  1. サーブレット： 「いいえ」を選択して「次へ」
  2. サーブレット： サーブレットを配置するサーバーとして「SOAPWebApp」を選択して「次へ」
  3. サーブレット： 「ユーザー定義サーブレット」を選択して「次へ」
  4. サーブレット：
     1. サーブレット名を「rpcrouter」と指定
     2. クラス名を「org.apache.soap.server.http.RPCRouterServlet」と指定
     3. 「default_host/soap/servlet/rpcrouter」をサーブレットWebパスリストに追加。ダイアログ・ポップアップには「servlet/rpcrouter」とだけ入力します。
     「次へ」
  5. サーブレット： ディフォルトで結構です。
  6. 「終了」
  　
  
• 同様の手順で「messagerouter」サーブレットも作成します
  • サーブレット名「messagerouter」
  • クラス名「org.apache.soap.server.http.MessageRouterServlet」
  • パスリストに「default_host/soap/servlet/messagerouter」を追加
  　
  
• SOAPサーバーを起動します。

SOAPサービスを一覧表示したり配置するページを次のURLで表示できます。

http://ホスト名：ポート番号/soap/admin

もし、ローカルサーバーがディフォルト設定になっていれば、次のURLでアクセスできます。
http://localhost/soap/admin

別の方法として、次のコマンドをクラスパスを正しく設定して実行すれば配置ができます。

java org.apache.soap.server.ServiceManagerClient 
     http://hostname:port/soap/servlet/rpcrouter 
     deploy <DeploymentDescriptor.xml>

管理ツールに関してはさらに詳しい説明が「User's Guide」にあります。サーバーのサービスを受けるためのエンドポイントは

http://hostname:port/soap/servlet/rpcrouter

です。

では、SOAPをお楽しみください！