この付録では、Oracle REST Data Servicesのトラブルシューティングについて説明します。
トピック:
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またはGlassFishに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やGlassfishなどのご使用環境でのi.war
の作成およびデプロイについて、本書内の情報をチェックしてください。
また、コマンド・プロンプトで次のように入力して、静的リスナー・コマンドの詳細なヘルプを表示できます。
java -jar ords.war help static