Oracle Application Express
Return to Oracle APEX Home
Installation Frequently Asked Questions
  1. Can I install Application Express into a 9i Database?
  2. The Installation Guide references a marvel.conf file, but I don't seem to have one. What should i do?
  3. The SQL Command Processor is solid red, and I can't type in it.
  4. My installation consistently fails at the same point. The error always shows a ORA-04088.
  5. How much disk space is required to install Application Express?
  6. I've sucessfully installed Application Express from the Oracle 10g Companion CD. Now what?
  7. I've sucessfully installed Oracle 11g. How do I get APEX to work?
  8. How do I Completely Uninstall Oracle Application Express from the Database?
  9. I'm getting a ORA-01017 even though my SYS password is correct.
  10. On Windows 2003, the installer fails to connect to my database.
  11. I forgot the Application Express Service Administration Password.
  12. My Oracle HTTP Server installation seems fine, but i get an error stating the page cannot be found or "The server is temporarily unable to service your request due to maintenance downtime or capacity problems" when I try to access Application Express.
  13. I've tried a few different things and my installation still seems to fail.
1. Can I install Application Express into a 9i Database?
Yes, you can use the companion CD for use of Application Express with a  9.2.0.3 or newer version of 9iR2.  If you wish to also use the Apache HTTP server included with 9iR2, please read this how to document.

Back to top

2. The Installation Guide references a marvel.conf file, but I don't seem to have one. What should i do?
The marvel.conf file is simply the location in which, except for uploaded images, all required modifications to Oracle HTTP Server for Application Express are to be made. In a new installation made without using the Oracle Universal Installer, it will be necessary to create this file. Directions for doing so can be found in the Application Express 2.0 Release Notes.

Back to top

3. The SQL Command Processor is solid red, and I can't type in it.
This issue occurs in Application Express if the mime types were not properly added to the Oracle HTTP Server using the AddType commands shown in the installtion guide's post installation steps.

Back to top

4. My installation consistently fails at the same point. The error always shows a ORA-04088.
If your installation consistently fails at the same point returning messages resembling:
Error page=167 item="P167_REGION" id="12754902714045613"
declare
*
ERROR at line 1:
ORA-06502: PL/SQL: numeric or value error
ORA-06512: at "SYS.OWA_UTIL", line 325
ORA-06512: at "SYS.HTP", line 1322
ORA-06512: at "SYS.HTP", line 1397
ORA-06512: at "SYS.HTP", line 1689
ORA-06512: at "FLOWS_020000.WWV_FLOW_API", line 3243
ORA-06502: PL/SQL: numeric or value error: character string buffer too small
ORA-06512: at "FLOWS_020000.WWV_BIU_STEP_ITEMS", line 63
ORA-04088: error during execution of trigger 'FLOWS_020000.WWV_BIU_STEP_ITEMS'
ORA-06512: at line 7
and your database is running with NLS_LENGTH_SEMANTICS=CHAR, then you need to change it to NLS_LENGTH_SEMANTICS = BYTE. The following technique can be used for this change:
  1. alter system set nls_length_semantics = BYTE scope = spfile;
  2. shutdown the database
  3. restart the database

Back to top

5. How much disk space is required to install Application Express?
Oracle Application Express requires about 150MB of tablespace for a single language install (assuming an 8K block size). Each additional language will take up approximately 35MB of additional tablespace. You will also need about 30MB in the filesystem for the images and stylesheets required for Application Express.
Thus, if you installed Application Express with all nine supported languages, you will need approximately 460MB of tablespace. Since most users only require a single language, figure on needing 180MB of free tablspace for Application Express.

Back to top

6. I've sucessfully installed Application Express from the Oracle 10g Companion CD. Now what?
Once you have installed Application Express, the first step is to create a Workspace. To do this, go to the Application Express Service Administration page, which can be found at a URL similar to http://your_host.com:/pls/htmldb/htmldb_admin. Login as the Admin user and create a Workspace. Detailed instructions can be found in the Post-Installation Steps of the Application Express Installation Guide. Next, you may want to practice using the Create a Database Centric Web Application with Oracle Application Express OBE.

Back to top

7. I've sucessfully installed Oracle 11g. How do I get APEX to work?
When you install Oracle Database 11g Oracle Application Express is also installed by default. First you must decide whether you wish to utilize the Embedded Pl/SQL Gateway (EPG) or the Oracle HTTP Server to act as a Web Server for Oracle Application Express. Oracle Database 11g also installs the Embedded PL/SQL Gateway by default, however you need to configure this component by following the Oracle Application Express Installation Guide section About Configuring the Embedded PL/SQL Gateway. If you choose to use Oracle HTTP Server follow About Configuring Oracle HTTP Server. Once the Web Server has been configured you need to follow Enabling Network Services in Oracle Database 11g. Now post-installation tasks are complete the first step is to create a workspace as specified above.

Back to top

8. How do I Completely Uninstall Oracle Application Express from the Database?
In Application Express 3.1 execute the following commands:
     drop user FLOWS_030100 cascade;
     drop user FLOWS_FILES cascade;

And to remove Oracle Application Express from the database execute the following command:

     @apxremov.sql 

For releases prior to Application Express 3.1 there are three steps required to completely uninstall Oracle Application Express from an instance of the Oracle Database. The first step is to drop the schemas associated with your Application Express installation. Two of those schemas are FLOWS_FILES and HTMLDB_PUBLIC_USER. Additionally, for each version of Application Express installed in your database, there will be a version-specific schema name similar to FLOWS_0XYYZZ. For Application Express 2.0 that schema name is FLOWS_020000. Application Express 1.5 uses FLOWS_010500, and the 1.6 version uses FLOWS_010600. Connect to the database as the SYSTEM user, and drop these schemas.

Next, you will need to drop the Application Express public synonyms. To do this, issue the following statement and run the resulting output:

     select 'drop public synonym ' || synonym_name || CHR(10) || '/' from sys.dba_synonyms
       where table_owner in ('FLOWS_010500','FLOWS_010600','FLOWS_020000','FLOWS_FILES');

Finally, if desired, remove the images directory that was associated with the Application Express install.

Back to top

9. After the Oracle Installer asks for the Application Express Configuration information during the install from the 10g Companion CD, I am getting an ORA-01017 Invalid Username/Password error.
Some users have received ORA-01017 errors from the Oracle Universal Installer indicating invalid login credentials for their SYS user even though they know those credentials to be correct. This issue is discussed in Metalink Note 114399.1. Please try setting remote_login_passwordfile to EXCLUSIVE as described there.

Back to top

10. On Windows 2003, the installer fails to connect to my database.
Some users are finding that the Oracle Universal Installer's Database Configuration Assistant on Windows 2003 fails or hangs when they attempt to install htmldb. Viewing the installation log, it appears to get some sort of TNS error right before it attempts to log into sqlplus. A java exception occurs right before that point, actually, and it says something like, "java.io.IOException: CreateProcess: env error=2". A description and fix for this issue is available in Metalink Note 273289.1. (A copy of this note for users without Metalink accounts can be accessed here.)

Back to top

11. I forgot the Application Express Service Administration Password.

First, make sure that you're using the Service Administration Login Page (http://somehost.com/pls/htmldb/htmldb_admin) If the screen you're seeing doesn't say something like "Welcome to Application Express Service Administration" then you're probably not properly attempting to log into the htmldb_admin interface. If you just installed Application Express, the password was specified as part of that install. The username will always be "admin" by default. If you still cannot remember the password, then you can use SQL*Plus to reset the password or create a new Administrator depending on which release of Oracle APplication Express you are using.

With release 3.0 and 3.1 to change the admin password start SQL*Plus and connect to the database where Oracle Application Express is installed as SYS. Then enter the following command followed by the new password:

     @apxxepwd.sql password

For Releases prior to 3.0 you will need to create a new Administrator. Using that newly created login, you should be able to log into the Service Administration Console and reset the original Admin user's password. To create the new admin user from SQL*Plus, customers connect to the database as sys or system and run this command:

     alter user FLOWS_020000 account unlock;

...and then connect to the FLOWS_020000 user and run this procedure:

     begin
       wwv_flow_api.set_security_group_id(p_security_group_id=>10);

       wwv_flow_fnd_user_api.create_fnd_user(
          p_user_name => 'admin2',
          p_email_address => 'myemail@mydomain.com',
          p_web_password => 'admin2') ;
     end;
     /

...which creates a new admin user with username "admin2" and password "admin2". Finally, execute a...

     alter user FLOWS_020000 account lock;

...from a schema like System after this process is completed.

Back to top

12. My Oracle HTTP Server installation seems fine, but I get an error stating the page cannot be found or "The server is temporarily unable to service your request due to maintenance downtime or capacity problems" when i try to access Application Express.
In some cases, users will find that their Oracle HTTP Server (OHS) is installed correctly as they can access the page http://<hostname>:<port>/, but they recieve generic error messages stating that the requested page cannot be found or even "The server is temporarily unable to service your request due to maintenance downtime or capacity problems" when they try to access Application Express. Further clues for troubleshooting this issue can usually be found by looking OHS log files. In most cases, an Oracle database error message is usually logged to the most recent error_log file in $ORACLE_OHS_HOME/Apache/Apache/logs/ directory. In some cases the access log in that directory might offer clues, as well.

Back to top

13. I've tried a few different things and my installation still seems to fail.
In some cases, users who seemed to be following the installation procedure correctly but were still having issues have found the these points helpful:
  1. Ensure that you do not have either of the TNS_ADMIN or ORACLE_HOME environment variables set.
  2. If the failed attempt to log into the database shows an ORA-12545, please check the troubleshooting tips in support Note 12101.1
  3. Some users have found that copying the "htmldb" tnsnames.ora entry from $ORACLE_APEX_HOME/network/admin/tnsnames.ora into the tnsnames.ora file used by their database has solved this issue for them.
  4. On a windows machine, removing traces of your ORACLE_HOME environment variable *could* mean checking the registry as well (please check support Metalink Note 208256.1 for guidance in this delicate matter).

Back to top

E-mail this page
Printer View Printer View
Oracle Is The Information Company About Oracle | Oracle RSS Feeds | Careers | Contact Us | Site Maps | Legal Notices | Terms of Use | Privacy