アプリケーション・サーバーへの Web サービス・アプリケーションのデプロイ

Web サービスの Web モジュールを使用可能にするために必要な成果物をエンタープライズ・アーカイブ (EAR) ファイルにアセンブルした後、この EAR ファイルをアプリケーション・サーバーにデプロイできます。

始める前に

Java ベース Web サービスをデプロイするには、エンタープライズ・アプリケーション (EAR ファイルとも呼ばれ、Web サービス用に構成され、使用可能になっています) が必要です。

Java™ API for XML-Based Web Services (JAX-WS) アプリケーションは、 デプロイメント用に追加のバインディングおよびデプロイメント記述子を必要としませんが、 Java API for XML-based RPC (JAX-RPC) Web サービス・アプリケーションでは、 アプリケーションのデプロイメント用にバインディングおよびデプロイメント記述子を追加する必要があります。JAX-WS は、JAX-RPC よりかなり動的であるため、 JAX-RPC アプリケーションのデプロイに必要なデプロイメント・ステップで生成される静的データのいずれも必要としません。

JAX-WS Web サービスの場合、webservices.xml デプロイメント記述子はオプションで使用できます。これは、アノテーションを使用して、デプロイメント記述子ファイル内に含まれるすべての情報を指定することができるためです。デプロイメント記述子ファイルを使用して、 既存の JAX-WS アノテーションの拡張またはオーバーライドを行うことができます。webservices.xml デプロイメント記述子で定義した すべての情報により、アノテーションによって指定された対応するすべての情報がオーバーライドされます。

混合バージョン環境 (Mixed-version environment) 混合バージョン環境 (Mixed-version environment): 混合ノード・セルでは、WebSphere® Application Server バージョン 7.0 以降を使用するサーバーのターゲットとして、JAX-WS 対応エンタープライズ Bean モジュールのみを指定できます。ただし、WebSphere Application Server バージョン 7.0 以降の Feature Pack for Web Services または WebSphere Application Server バージョン 6.1 Feature Pack for Web Services を使用するサーバーには、JAX-WS 対応 Web アプリケーション・アーカイブ (WAR) モジュールをターゲットとして指定できます。mixv

JAX-RPC アプリケーションで wsdeploy コマンドを使用すると、WebSphere 製品固有のデプロイメント・クラスを Web サービス互換のエンタープライズ・アプリケーションのエンタープライズ・アーカイブ (EAR) ファイルまたはアプリケーション・クライアントの Java アーカイブ (JAR) ファイルに追加することができます。

JAX-WS アプリケーション をインストールまたはデプロイするには、 JAX-WS 対応 EAR ファイルをインストールする必要があります。Web サービス・アプリケーションに JAX-WS エンドポイントのみが含まれている場合は、wsdeploy コマンドを実行する必要はありません。このコマンドは、JAX-RPC エンドポイントのみを処理するものです。

Web サービス・エンタープライズ Bean JAR ファイルと同じターゲットに、endptEnabler コマンドを使用して生成された HTTP ルーター・モジュールまたは Java Message Service (JMS) ルーター・モジュールがインストールされていることを確認します。この HTTP ルーター・モジュールまたは JMS ルーター・モジュールは Web サービス・アプリケーション に組み込まれます。これらのモジュールでは、アプリケーション・サーバーの ランタイム・ライブラリーを使用する必要があります。

このタスクについて

このタスクは、Web サービスを開発および実装するためのステップの 1 つです。

EAR ファイルをデプロイするには、管理コンソールまたは wsadmin スクリプト・ツールのいずれかを使用します。 wsadmin コマンドを使用して Web サービスを含むアプリケーションをインストールする場合は、JAX-RPC アプリケーションの -deployws オプションを指定します。管理コンソールを使用して Web サービスを含むアプリケーションをインストールする場合は、「新規アプリケーションのインストール」ウィザードで「WebServices のデプロイ」を選択してください。管理コンソールを使用したアプリケーションのインストールについて詳しくは、 コンソールを使用したエンタープライズ・アプリケーション・ファイルのインストールに関する情報を参照してください。

JAX-RPC Web サービス・アプリケーションが既に wsdeploy コマンドでデプロイされていた場合は、インストールの際に Web サービス・デプロイメントを指定する必要はありません。

以下のアクションでは、wsadmin コマンドを使用して EAR ファイルがデプロイされます。

手順

  1. コマンド・プロンプトから install_root/bin/wsadmin を開始します。

    [AIX][Linux][HP-UX][Solaris]AIX や Linux のようなオペレーティング・システムでは、install_root/bin/wsadmin.sh を開始します。

  2. EAR ファイルをデプロイします。
    • JAX-WS Web サービス・アプリケーションの場合、wsadmin プロンプトで $AdminApp install EARfile "-usedefaultbindings" コマンドを入力します。
    • JAX-RPC Web サービス・アプリケーションの場合、wsadmin プロンプトで $AdminApp install EARfile "-usedefaultbindings -deployws" コマンドを入力します。

タスクの結果

Web サービスがアプリケーション・サーバーにインストールされました。

トラブルの回避 (Avoid trouble) トラブルの回避 (Avoid trouble): 数多くのエンタープライズ Bean が含まれている Web サービス・アプリケーションをアプリケーション・サーバーにインストールしているときに、メモリー不足エラーが発生することがあります。このメモリー不足エラーが発生した場合は、Java 仮想マシン (JVM) の ヒープ・サイズを増やします。Network Deployment 環境にアプリケーション・サーバーを インストールしている場合は、アプリケーションをインストールするアプリケーション・サーバーの JVM、およびデプロイメント・マネージャー・プロファイル dmgr のヒープ・サイズを増やす 必要があります。アプリケーション・サーバー環境の調整について詳しくは、IBM の Java 仮想マシンの 資料を参照してください。gotcha

次のタスク

Web サービス・アプリケーションが、ブラウザーに Web サービス・エンドポイント URL を入力し、情報ページを表示したことでデプロイされたことを確認することができます。情報ページには、以下の情報が含まれています。
{http://webservice.pli.tc.wssvt.ibm.com}RetireWebServices 
Hello! This is an Axis2 Web service!
この情報の最初の行は、ご使用の Web サービスによって変更します。大括弧内の URI は名前空間で、それに続くストリング (この例では、RetireWebServices) は Web サービスにアクセスするために使用するポート名です。

次に実行を考慮するステップは、Web サービスにセキュリティーを適用することです。


トピックのタイプを示すアイコン タスク・トピック



タイム・スタンプ・アイコン 最終更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twbs_deployapp2
ファイル名:twbs_deployapp2.html