Oracle® Fusion Middleware Oracle WebLogic Server JAX-RPC Webサービス・スタート・ガイド 11g リリース1 (10.3.4) B61647-02 |
|
![]() 前 |
![]() 次 |
次の各項では、WebLogic Webサービスの管理方法について説明します。
jwsc
Antタスクを使用してWebLogic Webサービスをコンパイルおよびパッケージ化すると、Webサービスはエンタープライズ・アプリケーションの一部としてパッケージ化されます。デフォルトでは、Webサービス自体はエンタープライズ・アプリケーション内にWebアプリケーションWARファイルとしてパッケージ化されます。ただし、JWSファイルにセッションBeanが実装されている場合、WebサービスはEJB JARファイルとしてパッケージ化されます。したがって、Webサービスの基本的な管理は、標準のJava Platform, Enterprise Edition(Java EE)バージョン5アプリケーションおよびモジュールの基本的な管理と非常に似ています。標準的なタスクは次のとおりです。
Webサービスを含むエンタープライズ・アプリケーションのインストール。
デプロイされたエンタープライズ・アプリケーションを起動および停止します。
エンタープライズ・アプリケーションと、実際のWebサービスを実装するアーカイブ・ファイルの構成。エンタープライズ・アプリケーションの一般的な特性(デプロイメント順など)や、モジュールに固有の特性(Webアプリケーションのセッション・タイムアウト、EJBのトランザクションの種類など)を構成できます。
エンタープライズ・アプリケーションのデプロイメント・プランを作成および更新します。
エンタープライズ・アプリケーションをモニターします。
エンタープライズ・アプリケーションをテストします。
Webサービス固有の管理タスクは次のとおりです。
Webサービスの信頼性のあるメッセージングやJMSトランスポートに使用するJMSリソースの構成。
Webサービス・エンド・ポイントまたはそのオペレーションに関連付けられたWS-Policyファイルの構成。
注意: JWSファイルのプログラミング時にWebサービスの@Policy アノテーションを使用して、関連付けるWS-Policyファイルを指定した場合は、実行時に管理コンソールなどの管理ツールを使用してこの関連付けを変更することはできません。新しいWS-Policyファイルの関連付けや、実行時に追加したWS-Policyファイルの関連付けの解除のみが可能です。 |
Webサービスに関連付けられたSOAPハンドラの表示。
WebサービスのWSDLの表示。
Webサービスのセキュリティ構成の作成。
WebLogic Serverで動作するJava EEモジュールおよびアプリケーション(Webサービスを含む)を管理するには様々な方法があります。ニーズに最も適合するツールを使用してください。
WebLogic Server管理コンソールは、サーバーやクラスタにデプロイされたWebLogic Serverドメイン、1つ以上のWebLogic Serverインスタンス、クラスタおよびアプリケーション(Webサービスを含む)の管理に使用するWebブラウザ形式のグラフィカル・ユーザー・インタフェースです。
各ドメインでは、1つのWebLogic Serverインスタンスが管理サーバーとして構成されます。管理サーバーではWebLogic Serverドメインを一元的に管理できます。ドメイン内の他のすべてのWebLogic Serverインスタンスは、管理対象サーバーと呼ばれます。1つのWebLogic Serverインスタンスしか含まれないドメインでは、そのサーバーが管理サーバーおよび管理対象サーバーとして機能します。管理コンソールは、管理サーバーによってホストされるWebアプリケーションであり、サポートされている任意のWebブラウザから、管理サーバーへのネットワーク・アクセスを使用してアクセスできます。
システム管理コンソールを使用して、以下の作業を行うことができます。
ブラウザで管理コンソールを起動するには、次のURLを入力します。
http://host
:port/console
説明:
host
は、管理サーバーが動作しているコンピュータを指します。
port
は、管理サーバーが接続リクエストをリスニングしているポート番号を指します。管理サーバーのデフォルトのポート番号は7001です。
管理コンソールの右上にある「ヘルプ」ボタンをクリックすると、管理コンソールの詳しい使い方を説明するオンライン・ヘルプが表示されます。
次の図は、管理コンソールのメイン・ウィンドウを示しています。
通常、Webサービスはエンタープライズ・アプリケーションの一部としてWebLogic Serverにデプロイされます。エンタープライズ・アプリケーションは、EARとしてアーカイブするか、展開されたディレクトリの形式とすることができます。Webサービス自体はほとんどの場合、Webアプリケーションとしてパッケージ化されます。ただし、JWSファイルにセッションBeanが実装されている場合にかぎり、EJBとしてパッケージ化されます。Webサービスは、アーカイブ形式(Webアプリケーションの場合はWARファイル、EJBの場合はEJB JARファイル)または展開されたディレクトリ形式にできます。
Webサービスは、必ずしもエンタープライズ・アプリケーションの一部としてインストールする必要はありません。WebアプリケーションまたはEJBとしてそのままインストールすることもできます。ただし、Oracleでは、Webサービスをエンタープライズ・アプリケーションの一部としてインストールすることをお薦めしています。Webサービスの作成に使用されるWebLogic Antタスク(jwsc
)は、生成されたWebサービスを常にエンタープライズ・アプリケーションにパッケージ化します。
管理コンソールを使用してWebサービスに関するWebサービス固有の構成情報を表示および更新するには、左ペインの「デプロイメント」ノードをクリックし、右ペインに表示される「デプロイメント」表でWebサービスがパッケージ化されているエンタープライズ・アプリケーションを探します。「+」
ノードをクリックしてアプリケーションを展開すると、「Webサービス」カテゴリにアプリケーション内のWebサービスのリストが表示されます。構成を表示または更新するには、そのWebサービスの名前をクリックします。
次の図では、管理コンソールの「デプロイメント」表に、helloWorldEar
エンタープライズ・アプリケーションにパッケージ化されているHelloWorldService
Webサービスが表示されています。
メッセージ・レベルのセキュリティ(WS-Security仕様で定義されている暗号化およびデジタル署名)を使用するWebLogic Webサービスがデプロイされている場合、Webサービス・ランタイムでは、このサービスのWebサービス・セキュリティ構成との関連付けについても確認が行われます。このセキュリティ構成では、IDの認証にX.509証明書を使用するかどうか、パスワード・ダイジェストを使用するかどうか、暗号化にキーストアを使用するかどうかなどの情報を指定します。1つのセキュリティ構成を多数のWebサービスに関連付けることができます。
Webサービスのセキュリティ構成はドメイン全体を対象とするため、管理コンソールでは「デプロイメント」タブではなく「domainName」→「Webサービス・セキュリティ」タブから作成します。次の図に、このタブの場所を示します。
管理コンソールで、Webサービスおよびクライアントの実行時情報(呼出し、エラー、フォルトの数など)をモニターできます。
管理コンソールを使用してWebサービスをモニターするには、左ペインの「デプロイメント」ノードをクリックし、右ペインに表示される「デプロイメント」表でWebサービスがパッケージ化されているエンタープライズ・アプリケーションを探します。「+」ノードをクリックしてアプリケーションを展開すると、「Webサービス」カテゴリにアプリケーション内のWebサービスのリストが表示されます。Webサービスの名前をクリックし、「監視」タブをクリックします。
次の表に、Webサービス情報のモニターを選択できるタブをまとめます。各ページでは、Webサービスが実行されているすべてのサーバーの統計が集計されます。
表7-1 Webサービスのモニター
クリックするタブ | 表示される内容 |
---|---|
「監視」→「全般」 |
Webサービスの全般的な統計(エラー総数や呼出し総数など)。 |
「監視」→「呼出し」 |
呼出し統計(ディスパッチと実行の回数や平均など)。 |
「監視」→「WS-Policy」 |
認証、認可、機密性、整合性のカテゴリに分類された、Webサービスにアタッチされているポリシー。 |
「監視」→「ポート」 |
Webサービス・エンド・ポイント(ポート)をリストした表。この表は、各ポートの情報をまとめたものです。ポート名をクリックすると、クライアント・アプリケーションから呼び出せるパブリック・オペレーションが表示されます。 オペレーションごとに、WebLogic Serverインスタンスの起動後にオペレーションが呼び出された回数、Webサービスの呼出しに要した平均時間、Webサービスが応答に要した平均時間など、実行時の監視情報が表示されます。表に表示される情報をカスタマイズするには、「この表のカスタマイズ」をクリックします。 |
「監視」→「ポート」→「全般」 |
Webサービス・エンド・ポイントの全般的な統計。このページには、Webサービス・エンド・ポイントの名前、URI、関連付けられているWebサービス、エンタープライズ・アプリケーション、アプリケーション・モジュールなどの情報が表示されます。エラーと呼出しの数は、Webサービス・エンド・ポイントのすべてのオペレーションについて集計されます。 |
「監視」→「ポート」→「呼出し」 |
Webサービス・エンド・ポイントの呼出し統計(成功、フォルト、違反の数など)。 |
「監視」→「ポート」→「WS-Policy」 |
認証、認可、機密性、整合性のカテゴリに分類された、Webサービス・エンド・ポイントにアタッチされているポリシーに関連する統計。 |
「監視」→「ポート」→「操作」 |
Webサービス・エンド・ポイントのオペレーションのリスト。オペレーションごとに、レスポンス、実行およびディスパッチの平均時間、レスポンス、呼出しおよびエラーの回数など、実行時の監視情報が表示されます。表に表示される情報をカスタマイズするには、「この表のカスタマイズ」をクリックします。 注意: JAX-WS Webサービスの場合、組込みのWs-Protocolオペレーションについては基礎となるWS-*プロトコルに関連する統計が表示されます。この情報は、アプリケーションのパフォーマンス評価に役立ちます。 オペレーションの名前をクリックすると、詳細が表示されます。「全般」タブまたは「呼出し」タブをクリックすると、選択したオペレーションの全般的な統計または呼出し統計が表示されます。 |
管理コンソールを使用してWebサービス・クライアントを監視するには、左ペインの「デプロイメント」ノードをクリックし、右ペインに表示される「デプロイメント」表でWebサービスがパッケージ化されているエンタープライズ・アプリケーションを探します。「+」ノードをクリックし、Webサービス・クライアントが存在するアプリケーション・モジュールをクリックします。「監視」タブ>「Webサービス・クライアント」タブの順にクリックします。表に各Webサービス・クライアントの実行時情報のサマリーが表示されます。表のクライアント名をクリックすると、詳細が表示されます。
表7-2
クリックするタブ | 表示される内容 |
---|---|
「監視」→「全般」 |
Webサービス・クライアントの全般的な統計(エラーと呼出しの総数など)。このページには、Webサービス・クライアントの名前、関連付けられているエンタープライズ・アプリケーションおよびアプリケーション・モジュール、コンテキスト・ルートなどの情報が表示されます。エラーと呼出しの統計は、Webサービスが実行されているすべてのサーバーについて集計されます。 |
「監視」→「呼出し」 |
呼出し統計(ディスパッチと実行の回数や平均など)。 |
「監視」→「WS-Policy」 |
認証、認可、機密性、整合性のカテゴリに分類された、Webサービス・クライアントにアタッチされているポリシー。 |
「監視」→「サーバー」 |
クライアントが現在実行されているサーバーをリストした表。クライアント名をクリックし、以降の手順のタブを使用すると、そのサーバー上のWebサービス・クライアントの詳細が表示されます。 |
「監視」→「サーバー」→「全般」 |
Webサービス・クライアントの全般的な統計。このページには、Webサービス・クライアントのポート、関連付けられているエンタープライズ・アプリケーションおよびアプリケーション・モジュール、コンテキスト・ルートなどの情報が表示されます。エラーと呼出しの数は、Webサービス・クライアントのすべてのオペレーションについて集計されます。 |
「監視」→「サーバー」→「呼出し」 |
Webサービス・クライアントの呼出し統計(成功、フォルト、違反の数など)。 |
「監視」→「サーバー」→「WS-Policy」 |
認証、認可、機密性、整合性のカテゴリに分類された、Webサービス・クライアントにアタッチされているポリシーに関連する統計。 |
「監視」→「サーバー」→「操作」 |
Webサービス・クライアントのオペレーションのリスト。オペレーションごとに、レスポンス、実行およびディスパッチの平均時間、レスポンス、呼出しおよびエラーの回数など、実行時の監視情報が表示されます。表に表示される情報をカスタマイズするには、「この表のカスタマイズ」をクリックします。 オペレーションの名前をクリックすると、詳細が表示されます。「全般」タブまたは「呼出し」タブをクリックすると、選択したオペレーションの全般的な統計または呼出し統計が表示されます。 |
Oracle Enterprise Manager Fusion Middleware Control (Fusion Middleware Control)。Fusion Middleware Controlは、ファームをモニターおよび管理するWebブラウザ形式のグラフィカル・ユーザー・インタフェースです。ファームは、Fusion Middleware Controlによって管理されるコンポーネントの集合です。これは、Oracle WebLogic Serverドメイン、1つまたは複数の管理対象サーバー、およびドメインにインストール化、構成および実行できるOracle Fusion Middlewareシステムのコンポーネントが含まれています。
Fusion Middleware Controlは、様々なパフォーマンス・データおよび管理機能を個別のファームに対するWebベースのホームページ、Oracle WebLogic Serverドメイン、コンポーネントおよびアプリケーションに分割しています。Fusion Middleware Controlのホームページを使用すると、Webブラウザからの重要性の高いモニター・データと最もよく使用される管理機能のすべてを簡単に検索することができます。
次の図は、Fusion Middleware Controlを示します。
図7-4 Oracle Enterprise Manager Fusion Middleware Control
Enterprise Managerを使用してWebサービスをモニターおよびテストする方法の詳細は、『Oracle Fusion Middleware Webサービスのためのセキュリティおよび管理者ガイド』の「WebLogic Webサービスのセキュリティと管理」を参照してください。
Fusion Middleware Controlは、Oracle Fusion Middleware製品に含まれていますが、Oracle WebLogic Serverのスタンドアロン・バージョンを購入した場合には同梱されていません。Fusion Middleware Controlの詳細は、『Oracle Fusion Middleware管理者ガイド』の「Oracle Enterprise Manager Fusion Middleware Controlの開始」を参照してください。
WebLogic Scripting Tool(WLST)は、コマンド・ライン形式のスクリプト・インタフェースで、WebLogic Serverのドメインやインスタンスと対話して構成したり、Java EEモジュールおよびアプリケーション(Webサービスを含む)を特定のWebLogic Serverインスタンスにデプロイする目的で使用します。システム管理者およびオペレータは、WLSTを使用してWebLogic Serverの構成の変更を開始、管理および永続化できます。
通常、Webサービスの管理に使用するWLSTコマンドは、デプロイメント・カテゴリに分類されます。
WLSTの使い方の詳細は、『Oracle Fusion Middleware Oracle WebLogic Scripting Toolガイド』を参照してください。
WebLogic Serverには、構成タスクや管理タスクの多くを単一のAntビルド・スクリプトに一元化するのに使用できる様々なAntタスクが用意されています。これらのAntタスクを使用すると、以下のことが行えます。
wlserver
およびwlconfig
Antタスクを使用して、新しいWebLogic Serverドメインを作成、起動、および構成します。
wldeploy
Antタスクを使用して、新しく作成したドメインに、コンパイル済みアプリケーションをデプロイします。
Webサービスに関係のないWebLogic Antタスクに固有の情報については、『Oracle Fusion Middleware Oracle WebLogic Serverアプリケーションの開発』のAntタスクを使用したWebLogic Serverドメインの構成と使用に関する項およびwldeploy Antタスクのリファレンスの項を参照してください。
管理対象Bean (MBean)は、Java Management Extensions (JMX)インタフェースを提供するJava Beanです。JMXは、ネットワーク上のリソースをモニターおよび管理するためのJava EEソリューションです。JMXはSNMPおよび他の管理規格と同様に公開された仕様であり、一般的に用いられるモニター用製品を扱うベンダーの多くでサポートされています。
WebLogic Serverには、JMXを使用してWebLogic Serverリソースを構成、モニターおよび管理するための様々なMBeanが用意されています。WebLogic Webサービスにも、Webサービス管理タスクを実行する目的で使用する専用のMBeanが複数あります。
MBeanには、読取り専用のモニター情報の表示に使用する実行時MBeanと、デプロイ済のWebサービスの構成に使用する構成MBeanの2種類があります。
構成WebサービスMBeanは次のとおりです。
WebserviceSecurityConfigurationMBean
WebserviceCredentialProviderMBean
WebserviceSecurityMBean
WebserviceSecurityTokenMBean
WebserviceTimestampMBean
WebserviceTokenHandlerMBean
実行時WebサービスMBeanは次のとおりです。
WseeRuntimeMBean
WseeHandlerRuntimeMBean
WseePortRuntimeMBean
WseeOperationRuntimeMBean
WseePolicyRuntimeMBean
JMXの詳細は、『Oracle Fusion Middleware Oracle WebLogic Server MBeanリファレンス』および『Oracle Fusion Middleware Oracle WebLogic Server JMXによるカスタム管理ユーティリティの開発』の以下の項を参照してください。
WebLogic Server Mbeanについて
JMXを使用したWebLogic Server MBeanへのアクセス
JMXを使用したドメインの構成の管理
Java EE 5では、J2EE Application Deployment仕様(JSR-88) (http://jcp.org/en/jsr/detail?id=88
を参照)により、ターゲット・アプリケーション・サーバー環境へのデプロイメント用にアプリケーションを構成するために使用できる標準APIが定義されています。
この仕様には、Java EE Deploymentアーキテクチャが記述されています。このアーキテクチャでは、ツールやアプリケーション・プログラマがあらゆるJava EEプラットフォーム製品でアプリケーションを構成およびデプロイできるようにするための規約を定義しています。この規約では、アプリケーションのデプロイメント構成とデプロイメントについて、ツールとJava EEプラットフォーム製品の間での共通モデルが定義されています。Deploymentアーキテクチャを使用すると、アプリケーションのデプロイメントがより容易に行えます。多様なJava EEプラットフォーム製品にアプリケーションをデプロイするために、様々なJava EEデプロイメント・ツールのすべての機能を理解する必要はありません。
『Oracle Fusion Middleware Oracle WebLogic Serverアプリケーションのデプロイメント』を参照してください。
クライアント・アプリケーションとWebサービスの間の接続が確立されると、理論的にはこれらの間の対話がスムーズかつ迅速になり、クライアントによるリクエストとサービスによる応答がすばやく適切なタイミングで行われます。ただし、クライアント・アプリケーションが新しいリクエストを行うのに時間がかかり、その間(最長でWebLogic Serverインスタンスの存続時間の間)Webサービスが応答するのを待つ状況が発生することもあります。この現象を、実行スレッドのスタックと呼びます。ある一時点において実行スレッドのスタックが大量に発生すると、サーバーのパフォーマンスが全体的に低下する可能性があります。
特定のWebサービスが頻繁にこのような状態になる場合は、ワーク・マネージャを構成してサービスに適用することで、そのサービスにおいて作業の実行をどのように優先付けするかを指定できます。たとえば、レスポンス時間リクエスト・クラス(特定のタイプのワーク・マネージャ・コンポーネント)を構成すると、Webサービスのレスポンス時間の目標値を指定できます。
次に、デプロイメント記述子でレスポンス時間リクエスト・クラスを定義する方法の例を示します。
<work-manager> <name>responsetime_workmanager</name> <response-time-request-class> <name>my_response_time</name> <goal-ms>2000</goal-ms> </response-time-request-class> </work-manager>
レスポンス時間リクエスト・クラスは、管理コンソールを使用して構成することができます。Oracle Fusion Middleware Oracle WebLogic Server管理コンソール・ヘルプの「ワーク・マネージャ:レスポンス時間:構成」を参照してください。
ワーク・マネージャ全般、およびワーク・マネージャをWebサービスに対して構成する方法の詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverサーバー環境の構成』のワーク・マネージャを使用したスケジューリング済作業の最適化に関する項を参照してください。