A Oracle Application Expressのトラブルシューティング

この付録では、トラブルシューティングの情報を示します。

この付録の内容は次のとおりです。

インストール・セッションのログの確認
インストールが失敗した後のクリーンアップ
Oracle Application Expressでイメージが正しく表示されない
オンライン・ヘルプが動作しない

A.1 インストール・セッションのログの確認

apexins.sqlスクリプトを実行すると、installYYYY-MM-DD_HH24-MI-SS.logというネーミング規則に従って、ログ・ファイルがapexディレクトリに作成されます。インストールが成功した場合、ログ・ファイルには次のテキストが含まれます。

Thank you for installing Oracle Application Express.
Oracle Application Express is installed in the FLOWS_020200 schema.

ログ・ファイルにいくつかのエラーが含まれていても、インストールが失敗したことを意味しません。許容できるエラーはログ・ファイルにその旨が記載されていることに注意してください。

A.2 インストールが失敗した後のクリーンアップ

インストールが成功した場合、インストールの終わりに次のメッセージ・バナーが表示されます。

Thank you for installing Oracle Application Express.
Oracle Application Express is installed in the FLOWS_020200 schema.

再インストールするには、インストール・タイプに応じて1つまたは2つのデータベース・スキーマを削除する必要があります。

A.2.1 アップグレード・インストールに失敗した後

アップグレード・インストールに失敗した場合は、Oracle Application Expressを元のリリースに戻してから、リリース2.2に関連付けられているスキーマを削除する必要があります。

A.2.1.1 元のリリースに戻す

Oracle Application Expressを元のリリースに戻すには、次のステップを実行します。

imagesディレクトリを変更した場合は、テキスト別名/i/がリリース1.5のimagesディレクトリを指すように戻す必要があります。「アップグレード時のimagesディレクトリのコピー」を参照。
SQL*Plusで次のコマンドを実行します。
1. SQL*Plusを起動して、SYSまたはSYSTEMとしてOracle Application Expressがインストールされているデータベースに接続します。次に例を示します。
```
c:\> sqlplus sys/SYS_password as sysdba
```
2. Oracle Application Expressをリリース1.5に戻すには、次のステップを実行します。
```
ALTER SESSION SET CURRENT_SCHEMA = FLOWS_010500;
exec flows_010500.wwv_flow_upgrade.switch_schemas
('FLOWS_020200','FLOWS_010500');
```
3. Oracle Application Expressをリリース1.6に戻すには、次のステップを実行します。
```
ALTER SESSION SET CURRENT_SCHEMA = FLOWS_010600;
exec flows_010600.wwv_flow_upgrade.switch_schemas
('FLOWS_020200','FLOWS_010600');
```
4. Oracle Application Expressをリリース2.0に戻すには、次のステップを実行します。
```
ALTER SESSION SET CURRENT_SCHEMA = FLOWS_020000;
exec flows_020000.wwv_flow_upgrade.switch_schemas
('FLOWS_020200','FLOWS_020000');
```

リリース2.2のスキーマを削除するには、次のステップを実行します。

SQL*Plusを起動して、SYSまたはSYSTEMとしてOracle Application Expressがインストールされているデータベースに接続します。
次のコマンドを実行します。
```
DROP user FLOWS_020200 CASCADE;
```

A.2.2 新規インストールに失敗した後

新規インストールが失敗した後にスキーマを削除するには、次のステップを実行します。

SQL*Plusを起動して、SYSまたはSYSTEMとしてOracle Application Expressがインストールされているデータベースに接続します。

次のコマンドを実行します。

drop user FLOWS_020200 cascade;
drop user FLOWS_FILES cascade;

A.3 Oracle Application Expressでイメージが正しく表示されない

「新規インストール時のOracle HTTP Serverの構成」で、imagesディレクトリをコピーしたファイル・システム・パスを指す別名エントリを追加しました。 Oracle Application Expressでイメージが正しく表示されない場合は、/i/別名の定義が複数ある可能性があります。この問題に対処するには、次のステップを実行します。

可能な場合は、/i/の1つ目のインスタンスの名前を、異なる別名に変更します。
それができない場合は、ORACLE_BASE\ORACLE_HOME\marvel\imagesディレクトリから1つ目の/i/別名で定義されたディレクトリにイメージをコピーします。

A.4 オンライン・ヘルプが 動作しない

仮想ホストを介してOracle Application Expressにアクセスしている場合、オンライン・ヘルプは動作しません。次に例を示します。

Oracle Application ExpressのDADが格納されているOracle HTTP Serverのホスト名がinternal.server.com、ポートが7777の場合。
仮想ホストを介してOracle Application Expressにアクセスする場合。 Webブラウザにはexternal.server.comおよびポート80が表示されます。

この場合、internal.server.comにアクセスできなければ、Oracle Application Expressのオンライン・ヘルプは動作しません。この問題に対処するには、Oracle Application ExpressのDatabase Access Descriptor（DAD）に次の行を追加して、CGI環境変数SERVER_NAMEおよびSERVER_PORTを上書きします。

PlsqlCGIEnvironmentList SERVER_NAME=external.server.com
PlsqlCGIEnvironmentList SERVER_PORT=80

参照:

『Oracle HTTP Server mod_plsqlユーザーズ・ガイド』（CGI環境変数の上書きについて）および「Oracle Textの要件」