この章では、Oracle Web Services Manager(Oracle WSM)のデプロイのトラブルシューティング情報について説明します。
Javaリソース(ゲートウェイおよびほとんどのエージェント)に依存するポリシー実行ポイント(PEP)には次の制限があります。
Java PEPは、SOAPメッセージ内のactorやroleをサポートしません。Java PEPは、通常、セキュリティ・ヘッダーを処理します。これは、このような処理を回避するactorやroleの情報がセキュリティ・ヘッダーに含まれている場合でも行われます。
SOAPメッセージ(リクエスト)に、actorを含まない1つのセキュリティ・ヘッダーがある場合、Java PEPは、actor情報を含まないセキュリティ・ヘッダーをもう1つ追加することが頻繁にあります。このアクションは、WS-Security仕様に違反します。
Secure Sockets Layer(SSL)ライブラリを使用している場合、OC4J_Home/libディレクトリからjssl-1_1.jarファイルを削除して、jssl-1_2.jarファイルで置き換えます。その他のSSLライブラリを使用している場合、OC4J_Home/libディレクトリからjssl-1_1.jarファイルを削除します。これを行うと、その他のベンダーのJava Secure Socket Extension(JSSE)を実装できます。
レポート・エンジンを有効にするには、次の事項がすべて当てはまるかどうかを確認します。
使用するプラットーフォーム用の『Oracle Application Serverインストレーション・ガイド』で、LinuxとSolarisに必要なX Window System(X11)パッケージ、およびLinuxとSolarisに必要なDISPLAY変数に関する項に示された要件を満たしているかどうかを確認します。
X-clientが、Cordaを実行するコンピュータのDISPLAY変数によって指し示されるコンピュータで動作しているかどうかを確認します。
Cordaチャート・サーバーが動作しているかどうかを確認します。Solarisシステムでは、操作管理のチャートおよびグラフを表示するためのXサーバーが必要です。Xサーバーをインストールしていない場合、イメージは適切に表示されません。Xサーバーの詳細は、次のURLを参照してください。
http://developers.sun.com/solaris/articles/solaris_graphics.html
問題
UDDIまたはWSILからWebサービスをインポートすることでゲートウェイにサービスを登録する場合、次のいずれかのようなエラーが発生します。
URL_addressへの接続を確立できない
指定したURLへのアクセス時にエラーが発生する
解決策
この問題は、プロキシ・サーバーの設定が設定されていないことが原因で発生する可能性があります。次の手順に従い、プロキシ・サーバー設定を設定してください。
スタンドアロンのOracle WSMの場合
次のファイルを開きます。
ORACLE_HOME
/owsm/bin/coresv.properties
次のパラメータを編集します。
proxy.host =
proxy_server
proxy.port =
listen_port
noproxy.hosts =
host_name
表11-1では、パラメータの値の設定方法について説明します。
構成の変更が有効になるようにOracle WSMサーバーを再起動します。
Oracle Application Server 10gリリース3(10.1.3.1.0)の一部としてインストールするOracle WSMの場合
次のファイルを開きます。
ORACLE_HOME
/opmn/conf/opmn.xml
process-type id
を見つけます。この値は、Oracle Web Services Managerをインストールするインスタンスの名前です。"home"
または別のインスタンス名になります。たとえば、次のようになります。
... <ias-component id="default_group"> <process-type id="home" module-id="OC4J" status="enabled"> ...
ファイルのcategory id="start-parameters"
セクションのdata id="java-options"
を見つけます。
... <category id="start-parameters"> <data id="java-options" value="-server -XX:MaxPermSize=128M .../> </category> ...
-Dhttp.proxySet
、-Dhttp.proxyHost
、-Dhttp.proxyPort
および-Dhttp.nonproxyHosts
パラメータをdata_ id
タグのjava-options
属性に追加します。
<data_id="java-options" value="-server -XX:MaxPermSize=128M -Dhttp.proxySet=true -Dhttp.proxyHost=proxy_server -Dhttp.proxyPort=listen_port -Dhttp.nonproxyHosts=host_name .../>
表11-2 Oracle Application Serverの一部としてインストールするOracle WSMのパラメータ設定
パラメータ値 | 値の説明 |
---|---|
|
値 |
|
プロキシ・サーバーの名前。 |
|
接続先のプロキシ・サーバーのポート番号。80などです。 |
|
何も経由せずにプロキシ・サーバーから直接接続するホスト。この値は、縦棒(|)またはアスタリスク( |
構成の変更が有効になるようにサーバーを再起動します。
問題
サンプルUDDIレジストリhttp://<oc4jhost>:<port>/registry/uddi/inquiry
を使用してサービスをインポートしようとすると、「URLへの接続を確立できませんでした」というエラーが発生します。該当のURLは、http://oc4jhost:port/registry/uddi/inquiryです。
解決策
このUDDIを使用するには、Oracle Registryをインストールする必要があります。
問題
ブラウザにWebサービスのWSDL URLを入力するか、貼り付けると、次のエラーが発生します。
Oracle Web Services Manager Gateway C0003001: サービスSID0003003にポリシーは見つかりません。サービスが正しく登録されているかどうか、ゲートウェイ・ポリシーが最新かどうかを確認してください。
解決策
1つの原因として、ゲートウェイのコンポーネントIDが正しく設定されていない可能性があります。次の手順に従ってください。
ナビゲーション・ペインから、「ポリシー管理」を選択して、「ポリシーの管理」を選択します。
コンポーネントのリストで該当のゲートウェイを探し、コンポーネントIDを取得します。
次のファイルを開きます。
ORACLE_HOME/owsm/config/gateway/gateway-config-installer.properties
gateway.component.IDプロパティが、該当のゲートウェイのIDと同じIDに設定されているかどうかを確認します。同じではない場合、ファイルに必要な変更を加えます。
ファイルでコンポーネントIDを変更する場合、変更が有効になるようにゲートウェイ・アプリケーションを再デプロイする必要があります。アプリケーションのデプロイの詳細は、『Oracle Web Services Managerデプロイメント・ガイド』を参照してください。
問題
テスト・ページを使用して、Webサービスへのアクセスをテストします。WSDL URLを入力して、「問合せの発行」をクリックすると、「http://host_name:port/gateway/services/SID000300n?wsdlからのWSDL読込みに失敗しました。WSDLが見つかりません」というエラーが発生します。
解決策
1つの原因として、ゲートウェイのコンポーネントIDが正しく設定されていない可能性があります。「WSDLアクセス時のエラー」の手順に従ってください。
もう1つの原因として、プロキシ・サーバー設定が設定されていない可能性があります。「WSILインポート時のエラー」の解決策を参照してください。
問題
スタンドアロンのOracle WSMを実行しています。Web Services Manager Controlにログインすると、500 Server Errorが発生します。「操作管理」→「ツール」→「管理」メニューをクリックして、それぞれにアクセスできます。「ポリシー管理」メニューにアクセスしようとする場合のみ、このエラーが発生します。
解決策
この問題は、非プロキシ・ホスト設定がインストール時に設定されていないために発生します。「WSILインポート時のエラー」の解決策を参照してください。
問題
Web Services Manager Controlがきわめて短時間でタイムアウトするため、セッションにログインする必要があります。
解決策
ブラウザ・セッションはデフォルトで60分に設定されています。ORACLE_HOME/owsm/config/ccore/ui-config-common.propertiesファイルのui.session.timeoutパラメータを編集します。
問題
Webサービス起動のメトリックは一定の期間表示されます。ある程度の時間が経過すると、特定の起動メトリックがWeb Services Manager Controlに表示されなくなります。
解決策
過去10分から最大60日まで、様々な期間におけるOracle Web Services Managerのメトリックを表示できます。ただし、Oracle WSM Databaseは、デフォルトで過去100分のみのデータを保持します。したがって、100分を超える履歴データを表示するには、ORACLE_HOME/owsm/config/coreman/monitor-config-installer.propertiesファイルのmonitor.aggregator.measurementStore.WindowSizeパラメータを構成する必要があります。詳細は、「メトリック・データ永続性の構成」を参照してください。
問題
ログ・ファイルに、正しいレベルの情報が記録されません。おおよその情報が必要です。
解決策
Oracle Web Services Managerの各アプリケーションには、それぞれのロギング構成ファイルがあります。
ロギング・レベルの変更の詳細は、「低レベル・イベントおよび状態のログ」を参照してください。
問題
ログ・レベルを変更しても、ログ・ファイルのレベル情報が変更されません。
解決策
Oracle WSM Policy Manager、Oracle WSM Monitor、Oracle WSM Gateway、Oracle WSM Server Agent、Oracle WSM ClientおよびWeb Services Manager Controlの各アプリケーションには、それぞれのロギング構成ファイルがあります。正しいファイルを構成しているかどうかを確認してください。
クラスごとにログ・レベルを設定できます。ほとんどの場合、1つのアプリケーションのすべてのクラスに同じログ・レベルを設定します。ただし、異なるログ・レベルを設定した場合、目的のとおりにログ・レベルが正しいクラスに設定されているかどうかを確認してください。
ログ・レベルの構成後、変更が有効になるようにアプリケーションを再デプロイする必要があります。
分散システム内のパフォーマンス問題の総合的な対処法は、このドキュメントの範囲に収まらない複雑なレベルになります。ガイドラインの他に、パフォーマンス問題やパフォーマンス・チューニングの詳細を提示する有用なリファレンス・ガイドが数多くあります。
パフォーマンスに関する総合的な考察を提供するかわりに、この項では、パフォーマンス・ボトルネックの特定方法とこのような問題の対処方法に関する一般的なガイドラインを示します。
パフォーマンス・ボトルネックを見つけた場合、Webサービスのデプロイ全体において、予期されるトラフィック負荷に対応しているかどうかを最初に確認する必要があります。システムが、CPU使用率100%のクリティカル・パスの状態にある場合、クラスタに1つ以上のコンピュータを追加する必要があります。
デプロイにボトルネックがある場合、ボトルネックは次のいずれかの中にあると考えられます。
エージェントとの遅い接続を経由するトラフィック
ゲートウェイとの遅い接続を経由するトラフィック
データベースに接続するOracle WSM Monitorを経由する、予想外に量が多いトラフィック
JMSまたはMQなどのサード・パーティのキューイング・システムに対する接続の待機時間
これらの問題の場合、可能性として考えられる次の原因を確認します。
外部リソース(特に次のタイプ)への接続を含むポリシー・ステップに関する問題
データベース・リポジトリ
LDAPリポジトリ
保護されたリソース
独自のセキュリティ・システム
データベース・パフォーマンスに関する問題
前述のいずれかをボトルネックの原因とみなす場合、データベースまたはLDAP接続の処理方法、リソースの保護、Oracle WSM監視データの集約と保持方法の詳細を変更する必要があります。
問題
Web Services Manager Controlにログインしたときに、次のエラーを受け取ります。
The following exception occurred when processing the JSP: org.xml.sax.SAXException: Bad envelope tag: HTML Use your browsers "Back" button if you would like to try again.
解決策
これは、Oracle WSM Policy Managerをデプロイした後に発生する既知の不具合です。Oracle WSMコンポーネントがインストールされているOC4Jインスタンスで、Oracle Process Manager and Notification Server(OPMN)プロセス(opmnctl restartproc
)を再起動します。その後、Web Services Manager Controlへのログインを再試行してください。