Oracle REST Data Servicesのトラブルシューティング

D Oracle REST Data Servicesのトラブルシューティング

この付録では、Oracle REST Data Servicesのトラブルシューティングについて説明します。

トピック:

D.1 詳細なリクエスト・エラー・メッセージの有効化

詳細なリクエスト・エラー・メッセージを有効にするには、defaults.xmlという名前のOracle REST Data Servicesの構成ファイルに次の設定を追加します。

<entry key="debug.printDebugToScreen">true</entry>

この設定がdefaults.xmlの中に存在すると、任意のリクエストの生成するエラー・レスポンスにスタック・トレースを含む詳細なメッセージが含まれます。機密情報が攻撃者に漏れるリスクがあるため、この設定は本番システムでは有効にしないでください。

D.2 Oracle REST Data ServicesでのApplication Expressの静的リソースの構成

Oracle REST Data Servicesを使用していて、Oracle Application Expressのページにアクセスしようとすると(たとえば、https://example/ords/を表示しようとすると)空白のページが表示されることがあります。この問題の原因はApplication Expressの静的リソースの不適切な構成にあり、そのためにApplication Expressで必要とするJavaScriptおよびCSSリソースが見つからず、Application Expressのページが正しくレンダリングされません。

具体的な原因として、次のいずれかが考えられます。

Application Expressの静的イメージがOracle REST Data Servicesのインスタンスと同じサーバーに配置されていることを確認していない。
WebLogic Serverにi.warをデプロイしていない。
java -jar ords.war staticコマンドを使用してi.warを生成するときに、誤ったパスを指定した。
静的リソース(/i)にデフォルト以外のコンテキスト・パスを使用してApplication Expressを構成し、java -jar ords.war staticを使用するときに、それと同じコンテキスト・パスを指定していない(--context-pathオプションを使用する)。
i.warをデプロイした後で、i.warから参照しているフォルダを移動、名前の変更、または削除した。
スタンドアロン・モードで実行していて、スタンドアロン・モードの最初の実行時にメッセージが表示されたときに、誤ったパスを入力した(またはパスを指定しなかった)。
スタンドアロン・モードで実行していて、--static-imagesオプションに誤ったパスを入力した。
Application Expressを新規バージョンにアップグレードしたが、Application Expressの新規バージョンの静的リソースを指すように i.warを再構成および再デプロイしていないか、またはスタンドアロン・モードで--apex-imagesオプションを使用して場所を更新していない。

問題の診断に役立てるため、apex_version.txtファイルにアクセスしてみることができます。たとえば、Application Expressのデプロイがhttps://example.com/ords/にあり、静的リソースがhttps://example.com/i/にデプロイされている場合、ブラウザを使用して次のURLにアクセスします。

https://example.com/i/apex_version.txt

「404 見つかりません」というエラーになる場合は、i.warがデプロイされていない、Application Expressの静的リソースを含むフォルダを指していない、といった前述の具体的な原因のリストをチェックします。

プレーン・テキストのファイルが表示される場合は、次のようなテキストが含まれているはずです。

Application Express Version:  4.2.1

このバージョン番号がデータベースにデプロイされているApplication Expressのバージョンと一致していることを確認してください。番号が一致しない場合は、Oracle REST Data Servicesがデータベース内のApplication Expressのバージョンと一致するApplication Expressの静的リソースの正しいバージョンを使用するように構成されていないので、前述の具体的な原因リストの最後の項目で説明した誤りがないかを確認してください。

問題を解決する上でのヘルプを必要とする場合は、WebLogic Serverなどのご使用環境でのi.warの作成およびデプロイについて、本書内の情報をチェックしてください。

また、コマンド・プロンプトで次のように入力して、静的リスナー・コマンドの詳細なヘルプを表示できます。

java -jar ords.war help static