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

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

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

インストール・セッションのログの確認
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 APEX_030200 schema.

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

A.2 Oracle Application Expressインストールの妥当性の検証

Oracle Application Expressインストールの妥当性は、次の問合せを実行して検証できます。

SELECT STATUS FROM DBA_REGISTRY
WHERE COMP_ID = 'APEX';

結果がVALIDの場合、インストールは正常に実行されたと想定できます。

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

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

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

再インストールするには、インストール・タイプに応じて、Oracle Application Expressデータベース・スキーマを削除するか、データベースからApplication Expressを完全に削除するスクリプトを実行する必要があります。

このセクションの内容は次のとおりです。

アップグレード・インストール失敗後の旧リリースへの復旧
データベースからのOracle Application Expressの削除

A.3.1 アップグレード・インストール失敗後の旧リリースへの復旧

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

このセクションの内容は次のとおりです。

以前のリリースのOracle Application Expressがインストールされているかどうかの確認
元のリリースに戻す
Oracle Application Expressリリース3.2のスキーマの削除

A.3.1.1 以前のリリースのOracle Application Expressがインストールされているかどうかの確認

以前のリリースのApplication Expressがインストールされているかどうかを確認するには、次のステップを実行します。

SQL*Plusを起動し、Oracle Application Expressがインストールされているデータベースに、SYSDBAロールが指定されているSYSとして接続します。次に例を示します。
- Windowsの場合:
```
SYSTEM_DRIVE:\ sqlplus /nolog
SQL> CONNECT SYS as SYSDBA
Enter password: SYS_password
```
- UNIXおよびLinuxの場合:
```
$ sqlplus /nolog
SQL> CONNECT SYS as SYSDBA
Enter password: SYS_password
```
2. SQL*Plusで次のコマンドを実行します。
```
SELECT username FROM dba_users WHERE username LIKE 'FLOWS_%';
```
問合せによってすべての行が戻される場合、データベースには以前のリリースのOracle Application Expressが含まれています。

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

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

imagesディレクトリを変更した場合は、テキスト別名/i/が元のリリースのimagesディレクトリを指すように戻す必要があります。「アップグレード後のimagesディレクトリのコピー」または「アップグレード後のimagesディレクトリのコピー」を参照してください。
SQL*Plusを起動し、Oracle Application Expressがインストールされているデータベースに、SYSDBAロールが指定されているSYSとして接続します。
- Windowsの場合:
```
SYSTEM_DRIVE:\ sqlplus /nolog
SQL> SQL> CONNECT SYS as SYSDBA
Enter password: SYS_password
```
- UNIXおよびLinuxの場合:
```
$ sqlplus /nolog
SQL> SQL> CONNECT SYS as SYSDBA
Enter password: SYS_password
```
元のリリースに応じて、SQL*Plusで適切なコマンドを実行します。
1. Oracle Application Expressをリリース1.5に戻すには、次のステップを実行します。
```
ALTER SESSION SET CURRENT_SCHEMA = FLOWS_010500;
exec flows_010500.wwv_flow_upgrade.switch_schemas
('APEX_030200','FLOWS_010500');
```
2. Oracle Application Expressをリリース1.6に戻すには、次のステップを実行します。
```
ALTER SESSION SET CURRENT_SCHEMA = FLOWS_010600;
exec flows_010600.wwv_flow_upgrade.switch_schemas
('APEX_030200','FLOWS_010600');
```
3. Oracle Application Expressをリリース2.0に戻すには、次のステップを実行します。
```
ALTER SESSION SET CURRENT_SCHEMA = FLOWS_020000;
exec flows_020000.wwv_flow_upgrade.switch_schemas
('APEX_030200','FLOWS_020000');
```
4. Oracle Application Expressをリリース2.2に戻すには、次のステップを実行します。
```
ALTER SESSION SET CURRENT_SCHEMA = FLOWS_020200;
exec flows_020200.wwv_flow_upgrade.switch_schemas
('APEX_030200','FLOWS_020200');
```
5. Oracle Application Expressをリリース3.0に戻すには、次のステップを実行します。
```
ALTER SESSION SET CURRENT_SCHEMA = FLOWS_030000;
exec flows_030000.wwv_flow_upgrade.switch_schemas
('APEX_030200','FLOWS_030000');
```
6. Oracle Application Expressをリリース3.1に戻すには、次のステップを実行します。
  - 作業ディレクトリを3.1ソースのapex/coreに変更します。
  - SQL*Plusを起動し、Oracle Application Expressがインストールされているデータベースに、SYSDBAロールが指定されているSYSとして接続します。
    
    Windowsの場合:
```
SYSTEM_DRIVE:\ sqlplus /nolog
SQL> SQL> CONNECT SYS as SYSDBA
Enter password: SYS_password
```
    UNIXおよびLinuxの場合:
```
$ sqlplus /nolog
SQL> SQL> CONNECT SYS as SYSDBA
Enter password: SYS_password
```
  - 次のコマンドを実行します。
```
@wwv_flow_val.plb
@wwv_dbms_sql.sql
```
    Oracle Database Express Edition(Oracle Database XE)またはリリース10.2.0.3以上を実行している場合は、次のコマンドを実行します。
```
@wwv_dbms_sql.plb
```
    Oracle Database XEまたはリリース10.2.0.3以上を実行していない場合は、次のコマンドを実行します。
```
@wwv_dbms_sql_noroles.plb
```
  - 次の文を実行します。
```
ALTER SESSION SET CURRENT_SCHEMA = FLOWS_030100;
exec flows_030100.wwv_flow_upgrade.switch_schemas
('APEX_030200','FLOWS_030100');
```
  - 作業ディレクトリを3.1ソースのapexに変更します。
  - SQL*Plusを起動し、Oracle Application Expressがインストールされているデータベースに、SYSDBAロールが指定されているSYSとして接続します。
    
    Windowsの場合:
```
SYSTEM_DRIVE:\ sqlplus /nolog
SQL> SQL> CONNECT SYS as SYSDBA
Enter password: SYS_password
```
    UNIXおよびLinuxの場合:
```
$ sqlplus /nolog
SQL> SQL> CONNECT SYS as SYSDBA
Enter password: SYS_password
```
  - 次の文を実行します。
```
@apexvalidate x x FLOWS_030100
```
次のセクション「Oracle Application Expressリリース3.2のスキーマの削除」を参照してください。

A.3.1.3 Oracle Application Expressリリース3.2のスキーマの削除

以前のリリースに戻した後、Oracle Application Express 3.2のスキーマを削除できます。

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

SQL*Plusを起動し、Oracle Application Expressがインストールされているデータベースに、SYSDBAロールが指定されているSYSとして接続します。
- Windowsの場合:
```
SYSTEM_DRIVE:\ sqlplus /nolog
SQL> SQL> CONNECT SYS as SYSDBA
Enter password: SYS_password
```
- UNIXおよびLinuxの場合:
```
$ sqlplus /nolog
SQL> SQL> CONNECT SYS as SYSDBA
Enter password: SYS_password
```
次のコマンドを実行します。
```
DROP USER APEX_030200 CASCADE;
```
Oracle Application Express 3.2のスキーマを削除したら、再度アップグレードを試行できます。

A.3.2 Oracle Application Expressのデータベースからの削除

このセクションでは、データベースを削除せずに、Oracle Application Expressスキーマ、シノニムおよびユーザーをデータベースから削除する方法を説明します。データベースを削除する場合は、このステップを実行する必要があります。

注意:

旧リリースのデータベースをアップグレードし、引き続き旧リリースのOracle Application Expressを使用する必要がある場合は、このステップを実行しないでください。旧リリースへの復旧については、「元のリリースに戻す」を参照してください。新規インストールまたはアップグレード・インストールが完了したかどうかわからない場合は、「インストールが失敗した後のクリーンアップ」のステップに従い、旧リリースのApplication Expressがデータベースに存在するかどうかを確認します。

データベースからOracle Application Expressを削除するには、次のステップを実行します。

作業ディレクトリを、Oracle Application Expressソフトウェアを解凍したapexディレクトリに変更します。
SQL*Plusを起動し、Oracle Application Expressがインストールされているデータベースに、SYSDBAロールが指定されているSYSとして接続します。
- Windowsの場合:
```
SYSTEM_DRIVE:\ sqlplus /nolog
SQL> SQL> CONNECT SYS as SYSDBA
Enter password: SYS_password
```
- UNIXおよびLinuxの場合:
```
$ sqlplus /nolog
SQL> SQL> CONNECT SYS as SYSDBA
Enter password: SYS_password
```
次のコマンドを実行します。
```
SQL> @apxremov.sql
```

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

Oracle Application Expressでイメージが正しく表示されない場合は、/i/別名の定義が複数ある可能性があります。この問題に対処するには、次のステップを実行します。

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

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

このセクションではOracle Application Expressのオンライン・ヘルプに関する問題について説明します。

このセクションの内容は次のとおりです。

仮想ホスト使用時にオンライン・ヘルプが動作しない
オンライン・ヘルプの検索の問題

参照:

ご使用のインストール例の「Oracle Database 11g でのネットワーク・サービスの有効化」

A.5.1 仮想ホスト使用時にオンライン・ヘルプが動作しない

仮想ホストを介して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のデータベース・アクセス記述子(DAD)に次の行を追加して、CGI環境変数SERVER_NAMEおよびSERVER_PORTを上書きします。

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

参照:

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

A.5.2 オンライン・ヘルプの検索の問題

Oracle Application Expressのオンライン・ヘルプで検索機能を有効にするときの基礎となる索引は、初回使用時に作成されます。この索引は、非SSLリンクを介して作成する必要があります。接続がSSLリンクの場合、URLにhttpsと表示されます。オンライン・ヘルプに索引付けするには、非SSLリンクを介してOracle Application Expressにアクセスする必要があります。オンライン・ヘルプ索引が作成された後は、通常のhttpsアクセスに戻ることができます。

参照:

インストール例については、「Oracle Database 11gリリース2以上でのオンライン・ヘルプの索引付けの有効化」を参照してください。