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_040100 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_040100 schema.

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

トピック:

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

• データベースからのOracle Application Expressの削除

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

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

トピック:

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

• 元のリリースに戻す

• Oracle Application Expressリリース4.1のスキーマの削除

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

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

1. 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_%' or username = 'APEX_030200';
   

   問合せによってすべての行が戻される場合、データベースには以前のリリースのOracle Application Expressが含まれています。

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

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

1. imagesディレクトリを変更した場合は、テキスト別名/i/が元のリリースのimagesディレクトリを指すように戻す必要があります。「アップグレード後のimagesディレクトリのコピー」を参照してください。

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
     

3. 元のリリースに応じて、SQL*Plusで適切なコマンドを実行します。

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

      ALTER SESSION SET CURRENT_SCHEMA = FLOWS_010500;
      exec flows_010500.wwv_flow_upgrade.switch_schemas('APEX_040100','FLOWS_010500');
      

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

      ALTER SESSION SET CURRENT_SCHEMA = FLOWS_010600;
      exec flows_010600.wwv_flow_upgrade.switch_schemas('APEX_040100','FLOWS_010600');
      

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

      ALTER SESSION SET CURRENT_SCHEMA = FLOWS_020000;
      exec flows_020000.wwv_flow_upgrade.switch_schemas('APEX_040100','FLOWS_020000');
      

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

      ALTER SESSION SET CURRENT_SCHEMA = FLOWS_020200;
      exec flows_020200.wwv_flow_upgrade.switch_schemas('APEX_040100','FLOWS_020200');
      

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

      ALTER SESSION SET CURRENT_SCHEMA = FLOWS_030000;
      exec flows_030000.wwv_flow_upgrade.switch_schemas('APEX_040100','FLOWS_030000');
      ALTER SESSION SET CURRENT_SCHEMA = SYS;
      exec validate_apex;
      

   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
        @wwv_dbms_sql.plb
        

      • 作業ディレクトリを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
        ALTER SESSION SET CURRENT_SCHEMA = FLOWS_030100;
        exec flows_030100.wwv_flow_upgrade.switch_schemas('APEX_030200','FLOWS_030100');
        ALTER SESSION SET CURRENT_SCHEMA = SYS;
        exec validate_apex;
        
        

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

      • 作業ディレクトリを3.2ソースの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
        @wwv_dbms_sql.plb
        

      • 作業ディレクトリを3.2ソースの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 APEX_030200
        ALTER SESSION SET CURRENT_SCHEMA = APEX_030200;
        exec apex_030200.wwv_flow_upgrade.switch_schemas('APEX_040100','APEX_030200');
        ALTER SESSION SET CURRENT_SCHEMA = SYS;
        exec validate_apex;
        

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

      • 作業ディレクトリを4.0ソースの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
        @wwv_dbms_sql.plb
        

      • 作業ディレクトリを4.0ソースの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 APEX_040000
        ALTER SESSION SET CURRENT_SCHEMA = APEX_040000;
        exec apex_040000.wwv_flow_upgrade.switch_schemas('APEX_040100','APEX_040000');
        ALTER SESSION SET CURRENT_SCHEMA = SYS;
        exec validate_apex;
        

4. 次のセクション「Oracle Application Expressリリース4.1のスキーマの削除」を参照してください。

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

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

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

1. 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
     

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

   DROP USER APEX_040100 CASCADE;
   

   Oracle Application Express 4.1のスキーマを削除したら、再度アップグレードを試行できます。

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

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

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

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

1. 作業ディレクトリを、Oracle Application Expressソフトウェアを解凍したapexディレクトリに変更します。

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
     

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

   SQL> @apxremov.sql
   

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

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

• 可能な場合は、/i/の1つ目のインスタンスの名前を、異なる別名に変更します。

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