You are on page 1of 52

Oracle Application Express Installation Guide

Release 4.2
Part Number E35123-05 Home Book Contents Index Master Contact
List Index Us

PDF Mobi ePub

Previous Up Next

3 Downloading from Oracle Technology Network


This chapter describes how to install Oracle Application Express by downloading a ZIP file from Oracle
Technology Network (OTN) and completing the appropriate post installation tasks.

The instructions in this chapter apply to both new and upgrade installations. To learn more, see
"Upgrading from a Previous Release of Oracle Application Express".

Topics:

Recommended Pre-installation Tasks


Choosing a Web Listener
Downloading from OTN and Configuring Oracle Application Express Listener
Downloading from OTN and Configuring the Embedded PL/SQL Gateway
Downloading from OTN and Configuring Oracle HTTP Server
Post Installation Tasks for Upgrade Installations
Performance Optimization Tasks
About the Oracle Application Express Runtime Environment

Note:
Within the context of this document, the Apache Oracle home directory
(ORACLE_HTTPSERVER_HOME) is the location where Oracle HTTP Server is
installed.

3.1 Recommended Pre-installation Tasks


Before installing Oracle Application Express, Oracle recommends that you complete the following
steps:

1. Review and satisfy all Oracle Application Express installation requirements. See "Oracle
Application Express Installation Requirements".

2. Shut down with normal or immediate priority the Oracle Database instances where you plan to
install Oracle Application Express. On Oracle Real Application Clusters (Oracle RAC) systems,
shut down all instances on each node.

An alternative to shutting down the database is to prevent all users from accessing Oracle
Application Express when upgrading your installation from a previous release of Oracle
Application Express. Oracle only recommends this option in high availability production
environments where planned outages are not available. For all other scenarios, the database
should be shut down.

To disable access to Oracle Application Express when the existing installation is using the
Application Express Listener, shut down the appropriate application server where the Application
Express listener is deployed.

To disable user access to Oracle Application Express when the existing installation is using the
Oracle HTTP Server with mod_plsql, you should either shut down the Web server or disable the
Application Express Database Access Descriptor of the Web server.

For an existing installation using the embedded PL/SQL gateway, you should disable the Oracle
XML DB Protocol Server by setting the HTTP port to 0. This can be accomplished by starting
SQL*Plus, connecting as SYS to the database where Oracle Application Express is installed, and
running:

EXEC DBMS_XDB.SETHTTPPORT(0);
Hide Navigation Once you have prevented access from Oracle Application Express users, you should log into
SQL*Plus as SYS, connecting to the database where Oracle Application Express is installed, and
query V$SESSION to ensure there are no long running sessions which would interfere with the
This Book Entire Library upgrade process.

Quick Lookup 3. Back up the Oracle Database installation.


Home Master Index Master
Glossary Master Book List Oracle recommends that you create a backup of the current Oracle Database installation before
Advanced Search you install Oracle Application Express. You can use Oracle Database Recovery Manager, which is
Main Categories included in the Oracle Database installation, to perform the backup.
Security

This Page See Also:


Recommended
Oracle Database Backup and Recovery User's Guide
Pre-installation Tasks
Choosing a Web Listener
Downloading from OTN and
Configuring Oracle 4. Start the Oracle Database instance that contains the target database.
Application Express Listener
Install the Oracle After backing up the system, you must start the Oracle instance that contains the target Oracle
Database and Complete database. Do not start other processes such as a Web Listener. However, if you are performing
Pre-installation Tasks a remote installation, make sure the database listener for the remote database has started.
Download and Install
Oracle Application
Express 3.2 Choosing a Web Listener
Change the Password for
the ADMIN Account In order to receive and respond to requests over the Internet, Oracle Application Express uses one of
Restart Processes the following three web listeners, Oracle Application Express Listener, Oracle HTTP Server with
Configure mod_plsql,or the embedded PL/SQL gateway.
APEX_PUBLIC_USER
Account
For further information on selecting the best web listener, please review the Oracle Application Express
Unlocking the
APEX_PUBLIC_USER Deployment page on Oracle Technology Network (OTN):
Account
Changing the Password http://www.oracle.com/technetwork/developer-tools/apex/application-express/apex-
for the deploy-installation-1878444.html#listener
APEX_PUBLIC_USER
Account
Download and Install
3.3 Downloading from OTN and Configuring Oracle
Oracle Application Application Express Listener
Express Listener
Disabling Oracle XML This section describes how to install Oracle Application Express by downloading a ZIP file from OTN
DB Protocol Server
and then configuring the Oracle Application Express Listener.
Configure RESTful
Services
Topics:
Enable Network Services
in Oracle Database 11g
Install the Oracle Database and Complete Pre-installation Tasks
Granting Connect
Privileges Download and Install Oracle Application Express
Troubleshooting an Change the Password for the ADMIN Account
Invalid ACL Error Restart Processes
Security Considerations
Configure APEX_PUBLIC_USER Account
About Managing
JOB_QUEUE_PROCESSES Download and Install Oracle Application Express Listener
Viewing the Number of Configure RESTful Services
JOB_QUEUE_PROCESSES Enable Network Services in Oracle Database 11g
Changing the Number Security Considerations
of
About Managing JOB_QUEUE_PROCESSES
JOB_QUEUE_PROCESSES
About Developing Oracle About Developing Oracle Application Express in Other Languages
Application Express in Create a Workspace and Add Oracle Application Express Users
Other Languages
Installing a Translated
Version of Oracle See Also:
Application Express
"About the Oracle Application Express Runtime Environment"
Create a Workspace and
Add Oracle Application
Express Users
Creating a Workspace 3.3.1 Install the Oracle Database and Complete Pre-installation
Manually Tasks
Creating Oracle
Application Express
Users Oracle Application Express requires an Oracle database that is Release 10.2.0.4 and later or Oracle
Logging in to Your
Hide Navigation Database 10g Express Edition. To learn more, see the Oracle Database Installation Guide for your
operating environment and "Recommended Pre-installation Tasks".

This Book Entire Library 3.3.2 Download and Install Oracle Application Express
Quick Lookup
To install Oracle Application Express:
Home Master Index Master
Glossary Master Book List
1. For installations where the development will be in English only, download the file
Advanced Search
apex_4.2_en.zip from the Oracle Application Express download page. Where the development
Main Categories will include languages other than English, download apex_4.2.zip from the Oracle Application
Security Express download page. See:
This Page
http://www.oracle.com/technetwork/developer-tools/apex/downloads/index.html
Recommended
Pre-installation Tasks
Choosing a Web Listener Note that the actual file name may differ if a more recent release has shipped since this
Downloading from OTN and document was published.
Configuring Oracle
Application Express Listener 2. Unzip downloaded zip file:
Install the Oracle
Database and Complete If English only, unzip apex_4.2_en.zip as follows, preserving directory names:
Pre-installation Tasks
Download and Install UNIX and Linux: $ unzip apex_4.2_en.zip
Oracle Application
Windows: Double click the file apex_4.2_en.zip in Windows Explorer
Express
Change the Password for
If multiple languages, unzip apex_4.2.zip as follows, preserving directory names:
the ADMIN Account
Restart Processes
Configure UNIX and Linux: $ unzip apex_4.2.zip
APEX_PUBLIC_USER Windows: Double click the file apex_4.2.zip in Windows Explorer
Account
Unlocking the
APEX_PUBLIC_USER Note:
Account You should keep the directory tree where you unzip the files short and not
Changing the Password
for the under directories that contain spaces. For example, within Windows unzip to
APEX_PUBLIC_USER C:\TEMP.
Account
Download and Install
Oracle Application 3. Change your working directory to apex.
Express Listener
Disabling Oracle XML 4. Start SQL*Plus and connect to the database where Oracle Application Express is installed as SYS
DB Protocol Server
specifying the SYSDBA role. For example:
Configure RESTful
Services
On Windows:
Enable Network Services
in Oracle Database 11g
SYSTEM_DRIVE:\ sqlplus /nolog
Granting Connect
SQL> CONNECT SYS as SYSDBA
Privileges
Troubleshooting an Enter password: SYS_password
Invalid ACL Error
Security Considerations On UNIX and Linux:
About Managing
JOB_QUEUE_PROCESSES $ sqlplus /nolog
Viewing the Number of SQL> CONNECT SYS as SYSDBA
JOB_QUEUE_PROCESSES Enter password: SYS_password
Changing the Number
of 5. Select the appropriate installation option.
JOB_QUEUE_PROCESSES
About Developing Oracle
Full development environment provides complete access to the Application Builder
Application Express in
Other Languages environment to develop applications. A Runtime environment enables users to run
Installing a Translated applications that cannot be modified. To learn more, see "About the Oracle Application Express
Version of Oracle Runtime Environment".
Application Express
Create a Workspace and Available installation options include:
Add Oracle Application
Express Users Full development environment. Run apexins.sql passing the following four
Creating a Workspace
arguments in the order shown:
Manually
Creating Oracle
@apexins.sql tablespace_apex tablespace_files tablespace_temp images
Application Express
Users
Logging in to Your
Hide Navigation Where:

tablespace_apex is the name of the tablespace for the Oracle Application Express
application user.
This Book Entire Library

Quick Lookup tablespace_files is the name of the tablespace for the Oracle Application Express
Home Master Index Master files user.
Glossary Master Book List
Advanced Search tablespace_temp is the name of the temporary tablespace or tablespace group.

Main Categories images is the virtual directory for Oracle Application Express images. To support
Security
future Oracle Application Express upgrades, define the virtual image directory as
This Page /i/.
Recommended
Pre-installation Tasks Example:
Choosing a Web Listener
Downloading from OTN and @apexins.sql SYSAUX SYSAUX TEMP /i/
Configuring Oracle
Application Express Listener
Install the Oracle
Note:
Database and Complete
Pre-installation Tasks If you receive the following error, please exit SQL*Plus and change
Download and Install your working directory to where you unzipped the installation file, for
Oracle Application example C:\TEMP in Windows, before starting SQL*Plus:
Express
Change the Password for SP2-0310: unable to open file "apexins.sql"
the ADMIN Account
Restart Processes
Configure
APEX_PUBLIC_USER
Runtime environment. Run apxrtins.sql passing the following arguments in the
Account
Unlocking the order shown:
APEX_PUBLIC_USER
Account @apxrtins.sql tablespace_apex tablespace_files tablespace_temp images
Changing the Password
for the Where:
APEX_PUBLIC_USER
Account tablespace_apex is the name of the tablespace for the Oracle Application Express
Download and Install application user.
Oracle Application
Express Listener tablespace_files is the name of the tablespace for the Oracle Application Express
Disabling Oracle XML
DB Protocol Server files user.
Configure RESTful
Services tablespace_temp is the name of the temporary tablespace or tablespace group.
Enable Network Services
in Oracle Database 11g images is the virtual directory for Oracle Application Express images. To support
Granting Connect future Oracle Application Express upgrades, define the virtual image directory as
Privileges /i/.
Troubleshooting an
Invalid ACL Error Example:
Security Considerations
About Managing @apxrtins.sql SYSAUX SYSAUX TEMP /i/
JOB_QUEUE_PROCESSES
Viewing the Number of
JOB_QUEUE_PROCESSES
Changing the Number See Also:
of Oracle Database PL/SQL Language Reference for more information about
JOB_QUEUE_PROCESSES SQL*Plus
About Developing Oracle
Application Express in
Other Languages
When Oracle Application Express installs, it creates three new database accounts:
Installing a Translated
Version of Oracle
APEX_040200 - The account that owns the Oracle Application Express schema and metadata.
Application Express
Create a Workspace and
Add Oracle Application FLOWS_FILES - The account that owns the Oracle Application Express uploaded files.
Express Users
Creating a Workspace APEX_PUBLIC_USER - The minimally privileged account is used for Oracle Application Express
Manually configuration with Oracle Application Express Listener or Oracle HTTP Server and mod_plsql.
Creating Oracle
Application Express If you configured RESTful Web services, then these additional accounts will be created:
Users
Logging in to Your
Hide Navigation APEX_REST_PUBLIC_USER - The account used when invoking RESTful Services definitions stored
in Oracle Application Express.

APEX_LISTENER - The account used to query RESTful Services definitions stored in Oracle
This Book Entire Library
Application Express.
Quick Lookup
Home Master Index Master If you are upgrading from a previous release, then FLOWS_FILES already exists and
Glossary Master Book List APEX_PUBLIC_USER is created if it does not already exist.
Advanced Search

Main Categories
Security Tip:
Oracle Application Express must be installed from a writable directory on the file
This Page system. See "Reviewing a Log of an Installation Session".
Recommended
Pre-installation Tasks
Choosing a Web Listener
Downloading from OTN and 3.3.3 Change the Password for the ADMIN Account
Configuring Oracle
Application Express Listener In a new installation of Oracle Application Express, or if you are converting a runtime environment to a
Install the Oracle development environment, you must change the password of the ADMIN account. In an upgrade
Database and Complete
scenario, the password will be preserved and carried over from the prior release. If you are unsure of
Pre-installation Tasks
Download and Install the password for the ADMIN account in an existing installation you can run the commands below to
Oracle Application reset the password.
Express
Change the Password for
the ADMIN Account Tip:
Restart Processes
You use the ADMIN account to log in to Oracle Application Express
Configure
APEX_PUBLIC_USER Administration Services and manage an entire Oracle Application Express
Account instance.
Unlocking the
APEX_PUBLIC_USER
Account To change the password for the ADMIN account:
Changing the Password
for the 1. Change your working directory to the apex directory where you unzipped the installation
APEX_PUBLIC_USER
software.
Account
Download and Install
Oracle Application 2. Start SQL*Plus and connect to the database where Oracle Application Express is installed as SYS
Express Listener specifying the SYSDBA role. For example:
Disabling Oracle XML
DB Protocol Server On Windows:
Configure RESTful
Services SYSTEM_DRIVE:\ sqlplus /nolog
Enable Network Services SQL> CONNECT SYS as SYSDBA
in Oracle Database 11g Enter password: SYS_password
Granting Connect
Privileges On UNIX and Linux:
Troubleshooting an
Invalid ACL Error $ sqlplus /nolog
Security Considerations
SQL> CONNECT SYS as SYSDBA
About Managing
Enter password: SYS_password
JOB_QUEUE_PROCESSES
Viewing the Number of
JOB_QUEUE_PROCESSES 3. Run apxchpwd.sql. For example:
Changing the Number
of @apxchpwd.sql
JOB_QUEUE_PROCESSES
About Developing Oracle When prompted, enter a password for the ADMIN account.
Application Express in
Other Languages
Installing a Translated
See Also:
Version of Oracle
Application Express Oracle Database PL/SQL Language Reference for more information about
Create a Workspace and SQL*Plus
Add Oracle Application
Express Users
Creating a Workspace
3.3.4 Restart Processes
Manually
Creating Oracle
Application Express After you install Oracle Application Express, you must restart the processes that you stopped before
Users you began the installation.
Logging in to Your
Hide Navigation 3.3.5 Configure APEX_PUBLIC_USER Account
It is important to correctly configure the APEX_PUBLIC_USER account to enable proper operation of
This Book Entire Library Oracle Application Express.

Quick Lookup
Home Master Index Master 3.3.5.1 Unlocking the APEX_PUBLIC_USER Account
Glossary Master Book List
Advanced Search The APEX_PUBLIC_USER account is locked at the end of a new installation of Oracle Application
Main Categories Express. You must unlock this account before configuring the database access descriptor (DAD) in a
Security new installation.

This Page
Recommended Tip:
Pre-installation Tasks
Choosing a Web Listener If you are upgrading from a prior release of Oracle Application Express, this step
Downloading from OTN and is unnecessary.
Configuring Oracle
Application Express Listener
Install the Oracle To unlock the APEX_PUBLIC_USER account:
Database and Complete
Pre-installation Tasks 1. Start SQL*Plus and connect to the database where Oracle Application Express is installed as SYS
Download and Install
specifying the SYSDBA role. For example:
Oracle Application
Express
On Windows:
Change the Password for
the ADMIN Account
SYSTEM_DRIVE:\ sqlplus /nolog
Restart Processes
Configure SQL> CONNECT SYS as SYSDBA
APEX_PUBLIC_USER Enter password: SYS_password
Account
Unlocking the On UNIX and Linux:
APEX_PUBLIC_USER
Account $ sqlplus /nolog
Changing the Password SQL> CONNECT SYS as SYSDBA
for the Enter password: SYS_password
APEX_PUBLIC_USER
Account 2. Run the following statement:
Download and Install
Oracle Application
ALTER USER APEX_PUBLIC_USER ACCOUNT UNLOCK
Express Listener
Disabling Oracle XML
DB Protocol Server 3.3.5.2 Changing the Password for the APEX_PUBLIC_USER Account
Configure RESTful
Services
Enable Network Services The APEX_PUBLIC_USER account is created with a random password in a new installation of Oracle
in Oracle Database 11g Application Express. You must change the password for this account before configuring the database
Granting Connect access descriptor (DAD) in a new installation.
Privileges
Troubleshooting an
Invalid ACL Error
Security Considerations Tip:
About Managing If you are upgrading from a prior release of Oracle Application Express, this step
JOB_QUEUE_PROCESSES is unnecessary.
Viewing the Number of
JOB_QUEUE_PROCESSES
Changing the Number To change the password for the APEX_PUBLIC_USER account:
of
JOB_QUEUE_PROCESSES
1. Start SQL*Plus and connect to the database where Oracle Application Express is installed as SYS
About Developing Oracle
Application Express in specifying the SYSDBA role. For example:
Other Languages
Installing a Translated On Windows:
Version of Oracle
Application Express SYSTEM_DRIVE:\ sqlplus /nolog
Create a Workspace and SQL> CONNECT SYS as SYSDBA
Add Oracle Application Enter password: SYS_password
Express Users
Creating a Workspace On UNIX and Linux:
Manually
Creating Oracle $ sqlplus /nolog
Application Express SQL> CONNECT SYS as SYSDBA
Users
Logging in to Your
Enter password: SYS_password
Hide Navigation

2. Run the following statement:

This Book Entire Library ALTER USER APEX_PUBLIC_USER IDENTIFIED BY new_password


Quick Lookup
Home Master Index Master Where new_password is the new password you are setting for APEX_PUBLIC_USER. You will use
Glossary Master Book List this password when creating the DAD in the sections that follow.
Advanced Search
3.3.5.2.1 About Password Expiration in Oracle Database 11g
Main Categories
Security In the default profile in Oracle Database 11g, the parameter PASSWORD_LIFE_TIME is set to 180. If
This Page you are using Oracle Database 11g with Oracle Application Express, this causes the password for
Recommended APEX_PUBLIC_USER to expire in 180 days. As a result, your Oracle Application Express instance will
Pre-installation Tasks become unusable until you change the password.
Choosing a Web Listener
Downloading from OTN and To prevent this behavior, create another profile in which the PASSWORD_LIFE_TIME parameter is set to
Configuring Oracle
unlimited and alter the APEX_PUBLIC_USER account and assign it to the new profile.
Application Express Listener
Install the Oracle
Database and Complete
Pre-installation Tasks See Also:
Download and Install Oracle Database Security Guide for information on creating profiles and
Oracle Application assigning them to database users.
Express
Change the Password for
the ADMIN Account
Restart Processes 3.3.6 Download and Install Oracle Application Express Listener
Configure
APEX_PUBLIC_USER To download the Oracle Application Express Listener:
Account
Unlocking the 1. Download the latest release of the Oracle Application Express Listener,
APEX_PUBLIC_USER apex_listener.version.number.zip, from the Oracle Application Express download page.
Account
See:
Changing the Password
for the
http://www.oracle.com/technetwork/developer-tools/apex-listener/downloads/index.html
APEX_PUBLIC_USER
Account
Download and Install Note that the version.number in the file name reflects the current release number.
Oracle Application
Express Listener 2. Unzip the downloaded zip file into a directory (or folder) of your choice:
Disabling Oracle XML
DB Protocol Server UNIX and Linux: unzip apex_listener.version.number.zip
Configure RESTful Windows: Double-click the file apex_listener.version.number.zip in Windows
Services
Explorer
Enable Network Services
in Oracle Database 11g
3. Locate the installation guide for Oracle Application Express Listener and follow instructions to
Granting Connect
Privileges complete installation and configuration steps.
Troubleshooting an
Invalid ACL Error
3.3.6.1 Disabling Oracle XML DB Protocol Server
Security Considerations
About Managing
JOB_QUEUE_PROCESSES If you were previously using the embedded PL/SQL Gateway and now wish to use Oracle Application
Viewing the Number of Express Listener, you need to disable the Oracle XML DB Protocol server.
JOB_QUEUE_PROCESSES
Changing the Number To disable Oracle XML DB Protocol server:
of
JOB_QUEUE_PROCESSES 1. Start SQL*Plus and connect to the database where Oracle Application Express is installed as SYS
About Developing Oracle
specifying the SYSDBA role. For example:
Application Express in
Other Languages
Installing a Translated On Windows:
Version of Oracle
SYSTEM_DRIVE:\ sqlplus /nolog
Application Express
Create a Workspace and SQL> CONNECT SYS as SYSDBA
Add Oracle Application Enter password: SYS_password
Express Users
Creating a Workspace On UNIX and Linux:
Manually
Creating Oracle $ sqlplus /nolog
Application Express SQL> CONNECT SYS as SYSDBA
Users
Logging in to Your
Enter password: SYS_password
Hide Navigation

2. Run the following command:

This Book Entire Library EXEC DBMS_XDB.SETHTTPPORT(0);


Quick Lookup
Home Master Index Master 3.3.7 Configure RESTful Services
Glossary Master Book List
Advanced Search
In a new installation of Oracle Application Express, you configure RESTful Services by running the
Main Categories configuration script apex_rest_config.sql. This step is optional and only needs to be completed if
Security you wish to use RESTful Services with the Oracle Application Express Listener on the instance. Once
This Page configured, the instance administrator can control the availability of the feature. If the instance
Recommended administrator has disabled RESTful Services for this Application Express instance, RESTful Services are
Pre-installation Tasks not available for this instance and the RESTful Services icon does not display. See "Configuring SQL
Choosing a Web Listener Workshop" in Oracle Application Express Administration Guide .
Downloading from OTN and
Configuring Oracle
Application Express Listener
Note:
Install the Oracle
Database and Complete RESTful Services requires Oracle Application Express Listener 2.0 or later.
Pre-installation Tasks
Download and Install
Oracle Application To configure RESTful Services in Oracle Application Express:
Express
Change the Password for 1. Change your working directory to the apex directory where you unzipped the installation
the ADMIN Account software.
Restart Processes
Configure 2. Start SQL*Plus and connect to the database where Oracle Application Express is installed as SYS
APEX_PUBLIC_USER
specifying the SYSDBA role. For example:
Account
Unlocking the
APEX_PUBLIC_USER On Windows:
Account
SYSTEM_DRIVE:\ sqlplus /nolog
Changing the Password
for the SQL> CONNECT SYS as SYSDBA
APEX_PUBLIC_USER Enter password: SYS_password
Account
Download and Install On UNIX and Linux:
Oracle Application
Express Listener $ sqlplus /nolog
Disabling Oracle XML SQL> CONNECT SYS as SYSDBA
DB Protocol Server Enter password: SYS_password
Configure RESTful
Services
3. Run apex_rest_config.sql. For example:
Enable Network Services
in Oracle Database 11g
@apex_rest_config.sql
Granting Connect
Privileges
Troubleshooting an When Prompted, enter a password for the APEX_LISTENER and APEX_REST_PUBLIC_USER
Invalid ACL Error accounts.
Security Considerations
About Managing When configuring RESTful Services in Oracle Application Express, it creates two new database
JOB_QUEUE_PROCESSES accounts.
Viewing the Number of
JOB_QUEUE_PROCESSES APEX_LISTENER - The account used to query RESTful Services definitions stored in Oracle
Changing the Number
of Application Express.
JOB_QUEUE_PROCESSES
About Developing Oracle APEX_REST_PUBLIC_USER - The account used when calling RESTful Services definitions
Application Express in stored in Oracle Application Express.
Other Languages
Installing a Translated
Version of Oracle
3.3.8 Enable Network Services in Oracle Database 11g
Application Express
Create a Workspace and By default, the ability to interact with network services is disabled in Oracle Database 11g Release 1 or
Add Oracle Application 2. Therefore, if you are running Oracle Application Express with Oracle Database 11g Release 1 or 2,
Express Users you must use the new DBMS_NETWORK_ACL_ADMIN package to grant connect privileges to any host for
Creating a Workspace
the APEX_040200 database user. Failing to grant these privileges results in issues with:
Manually
Creating Oracle
Sending outbound mail in Oracle Application Express.
Application Express
Users
Logging in to Your
Hide Navigation Users can call methods from the APEX_MAIL package, but issues arise when sending outbound
email.

Using Web services in Oracle Application Express.


This Book Entire Library

Quick Lookup PDF report printing.


Home Master Index Master
Glossary Master Book List Topics:
Advanced Search
Granting Connect Privileges
Main Categories Troubleshooting an Invalid ACL Error
Security

This Page
Tip:
Recommended
Pre-installation Tasks To run the examples described in this section, the compatible initialization
Choosing a Web Listener parameter of the database must be set to at least 11.1.0.0.0. By default a 11g
Downloading from OTN and database will already have the parameter set properly, but a database upgraded
Configuring Oracle
to 11g from a prior version may not. See "Creating and Configuring an Oracle
Application Express Listener
Install the Oracle Database" in Oracle Database Administrator's Guide for information about
Database and Complete changing database initialization parameters.
Pre-installation Tasks
Download and Install
Oracle Application 3.3.8.1 Granting Connect Privileges
Express
Change the Password for
the ADMIN Account The following example demonstrates how to grant connect privileges to any host for the APEX_040200
Restart Processes database user. This example assumes you connected to the database where Oracle Application
Configure Express is installed as SYS specifying the SYSDBA role.
APEX_PUBLIC_USER
Account DECLARE
Unlocking the
ACL_PATH VARCHAR2(4000);
APEX_PUBLIC_USER
BEGIN
Account
Changing the Password -- Look for the ACL currently assigned to '*' and give APEX_040200
for the -- the "connect" privilege if APEX_040200 does not have the privilege yet.
APEX_PUBLIC_USER
Account SELECT ACL INTO ACL_PATH FROM DBA_NETWORK_ACLS
Download and Install WHERE HOST = '*' AND LOWER_PORT IS NULL AND UPPER_PORT IS NULL;
Oracle Application
Express Listener IF DBMS_NETWORK_ACL_ADMIN.CHECK_PRIVILEGE(ACL_PATH, 'APEX_040200',
Disabling Oracle XML
'connect') IS NULL THEN
DB Protocol Server
DBMS_NETWORK_ACL_ADMIN.ADD_PRIVILEGE(ACL_PATH,
Configure RESTful
Services 'APEX_040200', TRUE, 'connect');
Enable Network Services END IF;
in Oracle Database 11g
Granting Connect EXCEPTION
Privileges -- When no ACL has been assigned to '*'.
Troubleshooting an WHEN NO_DATA_FOUND THEN
Invalid ACL Error DBMS_NETWORK_ACL_ADMIN.CREATE_ACL('power_users.xml',
Security Considerations
'ACL that lets power users to connect to everywhere',
About Managing
'APEX_040200', TRUE, 'connect');
JOB_QUEUE_PROCESSES
Viewing the Number of DBMS_NETWORK_ACL_ADMIN.ASSIGN_ACL('power_users.xml','*');
JOB_QUEUE_PROCESSES END;
Changing the Number /
of COMMIT;
JOB_QUEUE_PROCESSES
About Developing Oracle The following example demonstrates how to provide less privileged access to local network resources.
Application Express in
This example is used to enable access to servers on the local host only, such as email and report
Other Languages
Installing a Translated servers.
Version of Oracle
Application Express DECLARE
Create a Workspace and ACL_PATH VARCHAR2(4000);
Add Oracle Application BEGIN
Express Users -- Look for the ACL currently assigned to 'localhost' and give APEX_040200
Creating a Workspace -- the "connect" privilege if APEX_040200 does not have the privilege yet.
Manually SELECT ACL INTO ACL_PATH FROM DBA_NETWORK_ACLS
Creating Oracle
WHERE HOST = 'localhost' AND LOWER_PORT IS NULL AND UPPER_PORT IS NULL;
Application Express
Users
Logging in to Your
IF DBMS_NETWORK_ACL_ADMIN.CHECK_PRIVILEGE(ACL_PATH, 'APEX_040200',
Hide Navigation
'connect') IS NULL THEN
DBMS_NETWORK_ACL_ADMIN.ADD_PRIVILEGE(ACL_PATH,
'APEX_040200', TRUE, 'connect');
This Book Entire Library
END IF;
Quick Lookup
Home Master Index Master EXCEPTION
Glossary Master Book List -- When no ACL has been assigned to 'localhost'.
Advanced Search WHEN NO_DATA_FOUND THEN
DBMS_NETWORK_ACL_ADMIN.CREATE_ACL('local-access-users.xml',
Main Categories
'ACL that lets users to connect to localhost',
Security
'APEX_040200', TRUE, 'connect');
This Page DBMS_NETWORK_ACL_ADMIN.ASSIGN_ACL('local-access-users.xml','localhost');
Recommended END;
Pre-installation Tasks /
Choosing a Web Listener COMMIT;
Downloading from OTN and
Configuring Oracle
Application Express Listener 3.3.8.2 Troubleshooting an Invalid ACL Error
Install the Oracle
Database and Complete
Pre-installation Tasks If you receive an ORA-44416: Invalid ACL error after running the previous script, use the following
Download and Install query to identify the invalid ACL:
Oracle Application
Express REM Show the dangling references to dropped users in the ACL that is assigned
Change the Password for REM to '*'.
the ADMIN Account
Restart Processes SELECT ACL, PRINCIPAL
Configure FROM DBA_NETWORK_ACLS NACL, XDS_ACE ACE
APEX_PUBLIC_USER
WHERE HOST = '*' AND LOWER_PORT IS NULL AND UPPER_PORT IS NULL AND
Account
NACL.ACLID = ACE.ACLID AND
Unlocking the
APEX_PUBLIC_USER NOT EXISTS (SELECT NULL FROM ALL_USERS WHERE USERNAME = PRINCIPAL);
Account
Changing the Password Next, run the following code to fix the ACL:
for the
APEX_PUBLIC_USER DECLARE
Account ACL_ID RAW(16);
Download and Install CNT NUMBER;
Oracle Application BEGIN
Express Listener
-- Look for the object ID of the ACL currently assigned to '*'
Disabling Oracle XML
SELECT ACLID INTO ACL_ID FROM DBA_NETWORK_ACLS
DB Protocol Server
Configure RESTful WHERE HOST = '*' AND LOWER_PORT IS NULL AND UPPER_PORT IS NULL;
Services
Enable Network Services -- If just some users referenced in the ACL are invalid, remove just those
in Oracle Database 11g -- users in the ACL. Otherwise, drop the ACL completely.
Granting Connect SELECT COUNT(PRINCIPAL) INTO CNT FROM XDS_ACE
Privileges WHERE ACLID = ACL_ID AND
Troubleshooting an EXISTS (SELECT NULL FROM ALL_USERS WHERE USERNAME = PRINCIPAL);
Invalid ACL Error
Security Considerations
IF (CNT > 0) THEN
About Managing
JOB_QUEUE_PROCESSES
Viewing the Number of FOR R IN (SELECT PRINCIPAL FROM XDS_ACE
JOB_QUEUE_PROCESSES WHERE ACLID = ACL_ID AND
Changing the Number NOT EXISTS (SELECT NULL FROM ALL_USERS
of WHERE USERNAME = PRINCIPAL)) LOOP
JOB_QUEUE_PROCESSES UPDATE XDB.XDB$ACL
About Developing Oracle SET OBJECT_VALUE =
Application Express in
DELETEXML(OBJECT_VALUE,
Other Languages
'/ACL/ACE[PRINCIPAL="'||R.PRINCIPAL||'"]')
Installing a Translated
Version of Oracle WHERE OBJECT_ID = ACL_ID;
Application Express END LOOP;
Create a Workspace and
Add Oracle Application ELSE
Express Users DELETE FROM XDB.XDB$ACL WHERE OBJECT_ID = ACL_ID;
Creating a Workspace END IF;
Manually
Creating Oracle
END;
Application Express
/
Users
Logging in to Your
Hide Navigation
REM commit the changes.

COMMIT;
This Book Entire Library

Quick Lookup Once the ACL has been fixed, you must run the first script in this section to apply the ACL to the
Home Master Index Master APEX_040200 user. See "Granting Connect Privileges".
Glossary Master Book List
Advanced Search
3.3.9 Security Considerations
Main Categories
Security Oracle highly recommends you configure and use Secure Sockets Layer (SSL) to ensure that
passwords and other sensitive data are not transmitted in clear text in HTTP requests. Without the use
This Page
Recommended of SSL, passwords could potentially be exposed, compromising security.
Pre-installation Tasks
Choosing a Web Listener SSL is an industry standard protocol that uses RSA public key cryptography in conjunction with
Downloading from OTN and symmetric key cryptography to provide authentication, encryption, and data integrity.
Configuring Oracle
Application Express Listener
Install the Oracle See Also:
Database and Complete "Requiring HTTPS" in Oracle Application Express Administration Guide
Pre-installation Tasks
Download and Install
Oracle Application
Express 3.3.10 About Managing JOB_QUEUE_PROCESSES
Change the Password for
the ADMIN Account JOB_QUEUE_PROCESSES determine the maximum number of concurrently running jobs. In Oracle
Restart Processes
Application Express Release 4.2, transactional support and SQL scripts require jobs. If
Configure
APEX_PUBLIC_USER JOB_QUEUE_PROCESSES is not enabled and working properly, you cannot successfully execute a script.
Account
Unlocking the Topics:
APEX_PUBLIC_USER
Account Viewing the Number of JOB_QUEUE_PROCESSES
Changing the Password Changing the Number of JOB_QUEUE_PROCESSES
for the
APEX_PUBLIC_USER
Account 3.3.10.1 Viewing the Number of JOB_QUEUE_PROCESSES
Download and Install
Oracle Application There are three ways to view the number of JOB_QUEUE_PROCESSES:
Express Listener
Disabling Oracle XML In the installation log file
DB Protocol Server
On the About Application Express page in Oracle Application Express
Configure RESTful
Services From SQL*Plus
Enable Network Services
in Oracle Database 11g 3.3.10.1.1 Viewing JOB_QUEUE_PROCESSES in the Installation Log File
Granting Connect
Privileges After installing or upgrading Oracle Application Express to Release 4.2, you can view the number of
Troubleshooting an JOB_QUEUE_PROCESSES in the installation log files. See "Reviewing a Log of an Installation Session".
Invalid ACL Error
Security Considerations 3.3.10.1.2 Viewing JOB_QUEUE_PROCESSES in Oracle Application Express
About Managing
JOB_QUEUE_PROCESSES You can also view the number of JOB_QUEUE_PROCESSES on the About Application Express page.
Viewing the Number of
JOB_QUEUE_PROCESSES To view the About Application Express page:
Changing the Number
of 1. Log in to Oracle Application Express. See "Logging in to Your Workspace".
JOB_QUEUE_PROCESSES
About Developing Oracle 2. On the Administration list, click About Application Express.
Application Express in
Other Languages The current number JOB_QUEUE_PROCESSES displays at the bottom of the page.
Installing a Translated
Version of Oracle
3.3.10.1.3 Viewing JOB_QUEUE_PROCESSES from SQL*Plus
Application Express
Create a Workspace and
You can also view the number of JOB_QUEUE_PROCESSES from SQL*Plus by running the following SQL
Add Oracle Application
Express Users statement:
Creating a Workspace
Manually SELECT VALUE FROM v$parameter WHERE NAME = 'job_queue_processes'
Creating Oracle
Application Express
Users 3.3.10.2 Changing the Number of JOB_QUEUE_PROCESSES
Logging in to Your
Hide Navigation You can change the number of JOB_QUEUE_PROCESSES by running a SQL statement in SQL*Plus:

To update the number of JOB_QUEUE_PROCESSES:

This Book Entire Library 1. Start SQL*Plus and connect to the database where Oracle Application Express is installed as SYS
Quick Lookup specifying the SYSDBA role:
Home Master Index Master
Glossary Master Book List On Windows:
Advanced Search
SYSTEM_DRIVE:\ sqlplus /nolog
Main Categories SQL> CONNECT SYS as SYSDBA
Security Enter password: SYS_password

This Page
On UNIX and Linux:
Recommended
Pre-installation Tasks
$ sqlplus /nolog
Choosing a Web Listener
Downloading from OTN and SQL> CONNECT SYS as SYSDBA
Configuring Oracle Enter password: SYS_password
Application Express Listener
Install the Oracle 2. In SQL*Plus run the following SQL statement:
Database and Complete
Pre-installation Tasks ALTER SYSTEM SET JOB_QUEUE_PROCESSES = <number>
Download and Install
Oracle Application For example, running the statement ALTER SYSTEM SET JOB_QUEUE_PROCESSES = 20 sets
Express
JOB_QUEUE_PROCESSES to 20.
Change the Password for
the ADMIN Account
Restart Processes 3.3.11 About Developing Oracle Application Express in Other
Configure
APEX_PUBLIC_USER
Languages
Account
Unlocking the The Oracle Application Express interface is translated into German, Spanish, French, Italian, Japanese,
APEX_PUBLIC_USER Korean, Brazilian Portuguese, Simplified Chinese, and Traditional Chinese. A single instance of Oracle
Account Application Express can be installed with one or more of these translated versions. Developers can
Changing the Password
choose to run the Application Express development environment in any of the installed languages by
for the
APEX_PUBLIC_USER simply selecting the language from the Application Builder log in screen or home page.
Account
Download and Install In order to install other languages you must use the apex_4.2.zip file which contains the extra files
Oracle Application referenced below. If you previously downloaded apex_4.2_en.zip, then you do not need to re-install
Express Listener Oracle Application Express. Simply download apex_4.2.zip and unzip the file into the same directory
Disabling Oracle XML
where you unzipped apex_4.2_en.zip.
DB Protocol Server
Configure RESTful
Services The translated version of Oracle Application Express should be loaded into a database that has a
Enable Network Services character set that supports the specific language. If you attempt to install a translated version of
in Oracle Database 11g Oracle Application Express into a database that does not support the character encoding of the
Granting Connect language, the installation may fail or the translated Oracle Application Express instance may appear
Privileges
corrupt when run. The database character set AL32UTF8 supports all the translated versions of Oracle
Troubleshooting an
Invalid ACL Error Application Express.
Security Considerations
About Managing You can manually install translated versions of Oracle Application Express using SQL*Plus. The
JOB_QUEUE_PROCESSES installation files are encoded in AL32UTF8.
Viewing the Number of
JOB_QUEUE_PROCESSES
Changing the Number Note:
of
Regardless of the target database character set, to install a translated version of
JOB_QUEUE_PROCESSES
About Developing Oracle Oracle Application Express, you must set the character set value of the
Application Express in NLS_LANG environment variable to AL32UTF8 before starting SQL*Plus.
Other Languages
Installing a Translated
Version of Oracle The following examples illustrate valid NLS_LANG settings for loading Oracle Application Express
Application Express
translations:
Create a Workspace and
Add Oracle Application
Express Users American_America.AL32UTF8
Creating a Workspace Japanese_Japan.AL32UTF8
Manually
Creating Oracle
Application Express 3.3.11.1 Installing a Translated Version of Oracle Application Express
Users
Logging in to Your
Hide Navigation Whether you are installing for the first time or upgrading from a previous release, you must run the
load_lang.sql script to run a translated version of Oracle Application Express.

The installation scripts are located in subdirectories identified by a language code in the unzipped
This Book Entire Library
distribution apex/builder. For example, the German version is located in apex/builder/de and the
Quick Lookup Japanese version is located in apex/builder/ja. Within each directory, there is a language loading
Home Master Index Master
script identified by the language code (for example, load_de.sql or load_ja.sql).
Glossary Master Book List
Advanced Search
To install a translated version of Oracle Application Express:
Main Categories
Security 1. Set the NLS_LANG environment variable, making sure that the character set is AL32UTF8. For
example:
This Page
Recommended Bourne or Korn shell:
Pre-installation Tasks
Choosing a Web Listener NLS_LANG=American_America.AL32UTF8
Downloading from OTN and export NLS_LANG
Configuring Oracle
Application Express Listener C shell:
Install the Oracle
Database and Complete setenv NLS_LANG American_America.AL32UTF8
Pre-installation Tasks
Download and Install
For Windows based systems:
Oracle Application
Express
set NLS_LANG=American_America.AL32UTF8
Change the Password for
the ADMIN Account
Restart Processes 2. Navigate to the directory under apex/builder based on the language you need to install. For
Configure example for German, navigate to apex/builder/de. Start SQL*Plus and connect to the
APEX_PUBLIC_USER database where Oracle Application Express is installed as SYS specifying the SYSDBA role. For
Account
example:
Unlocking the
APEX_PUBLIC_USER
On Windows:
Account
Changing the Password
SYSTEM_DRIVE:\ sqlplus /nolog
for the
APEX_PUBLIC_USER SQL> CONNECT SYS as SYSDBA
Account Enter password: SYS_password
Download and Install
Oracle Application On UNIX and Linux:
Express Listener
Disabling Oracle XML $ sqlplus /nolog
DB Protocol Server SQL> CONNECT SYS as SYSDBA
Configure RESTful Enter password: SYS_password
Services
Enable Network Services
3. Execute the following statement:
in Oracle Database 11g
Granting Connect
ALTER SESSION SET CURRENT_SCHEMA = APEX_040200;
Privileges
Troubleshooting an
Invalid ACL Error 4. Execute the appropriate language specific script. For example:
Security Considerations
About Managing @load_lang.sql
JOB_QUEUE_PROCESSES
Viewing the Number of Where lang is the specific language (for example, load_de.sql for German or load_ja.sql
JOB_QUEUE_PROCESSES for Japanese).
Changing the Number
of
JOB_QUEUE_PROCESSES 3.3.12 Create a Workspace and Add Oracle Application Express
About Developing Oracle Users
Application Express in
Other Languages
You access the Oracle Application Express home page by logging in to a workspace using a Web
Installing a Translated
Version of Oracle browser. Your Web browser must have JavaScript enabled. See "Browser Requirements".
Application Express
Create a Workspace and A workspace is a virtual private database allowing multiple users to work within the same Oracle
Add Oracle Application Application Express installation while keeping their objects, data and applications private. Each
Express Users workspace has a unique ID and name.
Creating a Workspace
Manually An instance administrator can create a workspace manually within Oracle Application Express
Creating Oracle
Administration Services or have users submit requests. Oracle Application Express Administration
Application Express
Users Services is a separate application for managing an entire Oracle Application Express instance. See
Logging in to Your
Hide Navigation "Creating Workspaces" and "Managing Workspace Requests" in Oracle Application Express
Administration Guide.

This Book Entire Library


See Also:
Quick Lookup Oracle Database 2 Day + Oracle Application Express Developer's Guide if you
Home Master Index Master are new to Oracle Application Express
Glossary Master Book List
Advanced Search

Main Categories Topics:


Security
Creating a Workspace Manually
This Page Creating Oracle Application Express Users
Recommended Logging in to Your Workspace
Pre-installation Tasks
Choosing a Web Listener
Downloading from OTN and 3.3.12.1 Creating a Workspace Manually
Configuring Oracle
Application Express Listener
To create an Oracle Application Express workspace manually:
Install the Oracle
Database and Complete
Pre-installation Tasks 1. Log in to Oracle Application Express Administration Services. Oracle Application Express
Download and Install Administration Services is a separate application for managing an entire Oracle Application
Oracle Application Express instance. You log in using the ADMIN account and password created or reset during the
Express installation process.
Change the Password for
the ADMIN Account a. In a Web browser, navigate to the Oracle Application Express Administration Services
Restart Processes
Configure application.
APEX_PUBLIC_USER
Account Because your setup uses Oracle Application Express Listener, go to:
Unlocking the
APEX_PUBLIC_USER http://hostname:port/apex/apex_admin
Account
Changing the Password Where:
for the
APEX_PUBLIC_USER hostname is the name of the system where Oracle Application Express Listener is
Account installed.
Download and Install
Oracle Application port is the port number assigned when configuring the Oracle Application Express
Express Listener
Listener. In a default installation, this number is 8080. To learn more, see Oracle
Disabling Oracle XML
DB Protocol Server Application Express Listener Installation and Developer Guide.
Configure RESTful
Services apex is the service name defined when configuring the Oracle Application Express
Enable Network Services Listener.
in Oracle Database 11g
Granting Connect b. On the Login page:
Privileges
Troubleshooting an In Username, enter admin.
Invalid ACL Error
Security Considerations In Password, enter the Oracle Application Express administrator account password
About Managing
you specified in "Change the Password for the ADMIN Account".
JOB_QUEUE_PROCESSES
Viewing the Number of
Click Login to Administration.
JOB_QUEUE_PROCESSES
Changing the Number
Note that, depending on your setup, you might be required to change your password
of
JOB_QUEUE_PROCESSES when you log in for the first time.
About Developing Oracle
Application Express in
Other Languages See Also:
Installing a Translated See "Logging in to Oracle Application Express Administration Services" in
Version of Oracle
Oracle Application Express Administration Guide.
Application Express
Create a Workspace and
Add Oracle Application
Express Users Next, create a workspace.
Creating a Workspace
Manually 2. Click Manage Workspaces.
Creating Oracle
Application Express 3. Under Workspace Actions, click Create Workspace.
Users
Logging in to Your
Hide Navigation The Create Workspace Wizard appears.

4. For Identify Workspace, enter the following:

This Book Entire Library a. Workspace Name - Enter a unique workspace name.
Quick Lookup
b. Workspace ID - Leave Workspace ID blank to have the new Workspace ID automatically
Home Master Index Master
Glossary Master Book List generated. A Workspace ID must be a positive integer greater than 100000.
Advanced Search
c. Workspace Description - Enter a workspace description.
Main Categories
Security d. Click Next.

This Page 5. For Identify Schema, specify whether you are re-using an existing schema or creating a new
Recommended one.
Pre-installation Tasks
Choosing a Web Listener If you are using an existing schema:
Downloading from OTN and
Configuring Oracle
a. For Re-use existing schema, select Yes.
Application Express Listener
Install the Oracle b. Select a schema from the list.
Database and Complete c. Click Next.
Pre-installation Tasks
Download and Install If you are creating a new schema:
Oracle Application
Express a. For Re-use existing schema, select No.
Change the Password for b. Enter a schema name and password.
the ADMIN Account c. Specify a space quota.
Restart Processes
Configure d. Click Next.
APEX_PUBLIC_USER
Account 6. For Identify Administrator, enter the Workspace administrator information and click Next.
Unlocking the
APEX_PUBLIC_USER 7. Confirm your selections and click Create Workspace.
Account
Changing the Password 3.3.12.2 Creating Oracle Application Express Users
for the
APEX_PUBLIC_USER
Account To create an Oracle Application Express user account:
Download and Install
Oracle Application 1. Log in to Oracle Application Express Administration Services as described in the previous section.
Express Listener See "Logging in to Oracle Application Express Administration Services" in Oracle Application
Disabling Oracle XML Express Administration Guide.
DB Protocol Server
Configure RESTful 2. Click the Manage Workspaces icon.
Services
Enable Network Services
The Administration page appears.
in Oracle Database 11g
Granting Connect
3. Click Manage Developers and Users.
Privileges
Troubleshooting an
4. Click Create User.
Invalid ACL Error
Security Considerations
The Create User page appears.
About Managing
JOB_QUEUE_PROCESSES
5. Under User Attributes, enter:
Viewing the Number of
JOB_QUEUE_PROCESSES
Changing the Number a. Username - Enter the username used to log in to the system. Restrictions include:
of
JOB_QUEUE_PROCESSES Maximum length of 100 characters
About Developing Oracle No spaces
Application Express in Only these special characters are permitted: ampersand (@) and period (.)
Other Languages
Installing a Translated b. Email Address - Enter the valid email address for this user.
Version of Oracle
Application Express c. First Name - Enter the first or given name to further identify the user.
Create a Workspace and
Add Oracle Application d. Last Name - Enter the last or family name to further identify the user.
Express Users
Creating a Workspace e. Description - Enter comments about this user.
Manually
Creating Oracle f. Default Date Format - Enter the default Oracle date format for the user. This controls
Application Express
the default date format within SQL Workshop.
Users
Logging in to Your
Hide Navigation 6. Under Account Privileges:

a. Workspace - Select a workspace from the list.

This Book Entire Library b. Default Schemas - Specify the default schema used for data browsing, application
Quick Lookup creation, and SQL script execution.
Home Master Index Master
Glossary Master Book List When using workspaces that have more than one schema available, this schema is the
Advanced Search default. This setting does not control security, only the user's preference.

Main Categories c. User is a workspace administrator - Specify if this user should have workspace
Security administrator privileges.
This Page
Administrators are given access to all components. Additionally, they can manage user
Recommended
Pre-installation Tasks accounts, groups, and development services. Components may not be available if they are
Choosing a Web Listener switched off by Instance Administrators.
Downloading from OTN and
Configuring Oracle d. User is a developer - Specify if this user should have developer privileges.
Application Express Listener
Install the Oracle Developers must have access to either Application Builder, SQL Workshop, or both. These
Database and Complete components may not be available if they are switched off by the Instance Administrator.
Pre-installation Tasks
Download and Install e. Application Builder Access - Determines whether a developer has access to the
Oracle Application
Application Builder.
Express
Change the Password for
f. SQL Workshop Access - Determines whether a developer has access to the SQL
the ADMIN Account
Restart Processes Workshop.
Configure
APEX_PUBLIC_USER g. Team Development Access - Determines whether a developer has access to the Team
Account Development.
Unlocking the
APEX_PUBLIC_USER h. Set Account Availability - Select Locked to prevent the account from being used.
Account Select Unlocked to allow the account to be used.
Changing the Password
for the If the user has exceeded the maximum login failures allowed, specified in Workspace
APEX_PUBLIC_USER
Preferences, then their account will be locked automatically.
Account
Download and Install
Oracle Application 7. Under Password:
Express Listener
Disabling Oracle XML Password - Enter a case sensitive password.
DB Protocol Server
Configure RESTful Confirm Password - Enter the password again.
Services
Enable Network Services Require Change of Password On First Use - Select No to allow the user to use the
in Oracle Database 11g same password until it expires. Select Yes to require the user to change the password
Granting Connect immediately when logging in the first time.
Privileges
Troubleshooting an 8. Click Create User or Create and Create Another.
Invalid ACL Error
Security Considerations
About Managing 3.3.12.3 Logging in to Your Workspace
JOB_QUEUE_PROCESSES
Viewing the Number of Once you create a workspace, you must log in to it using your login credentials (that is, the workspace
JOB_QUEUE_PROCESSES
Changing the Number name, user name, and password).
of
JOB_QUEUE_PROCESSES
About Developing Oracle See Also:
Application Express in See "Creating Workspaces" and "Managing Workspace Requests" in Oracle
Other Languages Application Express Administration Guide
Installing a Translated
Version of Oracle
Application Express
Create a Workspace and To log in to your workspace:
Add Oracle Application
Express Users 1. In a Web browser, navigate to the Oracle Application Express Login page.
Creating a Workspace
Manually Because your setup uses the Oracle Application Express Listener, go to:
Creating Oracle
Application Express http://hostname:port/apex/
Users
Logging in to Your
Hide Navigation Where:

hostname is the name of the system where Oracle Application Express Listener is
installed.
This Book Entire Library

Quick Lookup port is the port number assigned when configuring the Oracle Application Express
Home Master Index Master Listener. In a default installation, this number is 8080. To learn more, see Oracle
Glossary Master Book List Application Express Listener Installation and Developer Guide.
Advanced Search
apex is the service name defined when configuring the Oracle Application Express
Main Categories
Security Listener.

This Page The Login page appears.


Recommended
Pre-installation Tasks 2. Under Login, enter the following:
Choosing a Web Listener
Downloading from OTN and Workspace field - Enter the name of your workspace.
Configuring Oracle Username field - Enter your user name.
Application Express Listener Password field - Enter your case-sensitive password.
Install the Oracle
Database and Complete
3. Click Login.
Pre-installation Tasks
Download and Install
Note that, depending on your setup, you might be required to change your password when you
Oracle Application
Express log in for the first time.
Change the Password for
the ADMIN Account 3.4 Downloading from OTN and Configuring the Embedded
Restart Processes
Configure PL/SQL Gateway
APEX_PUBLIC_USER
Account This section describes how to install Oracle Application Express by downloading a ZIP file from OTN
Unlocking the and then configuring the embedded PL/SQL gateway.
APEX_PUBLIC_USER
Account Topics:
Changing the Password
for the Install the Oracle Database and Complete Pre-installation Tasks
APEX_PUBLIC_USER
Download and Install Oracle Application Express
Account
Download and Install Change the Password for the ADMIN Account
Oracle Application Configure the Embedded PL/SQL Gateway
Express Listener Enable Network Services in Oracle Database 11g
Disabling Oracle XML Security Considerations
DB Protocol Server
About Managing JOB_QUEUE_PROCESSES
Configure RESTful
Services About Running Oracle Application Express in Other Languages
Enable Network Services Configuring the SHARED_SERVERS Parameter
in Oracle Database 11g Create a Workspace and Add Oracle Application Express Users
Granting Connect
Privileges
Troubleshooting an
See Also:
Invalid ACL Error
Security Considerations "About the Oracle Application Express Runtime Environment"
About Managing
JOB_QUEUE_PROCESSES
Viewing the Number of 3.4.1 Install the Oracle Database and Complete Pre-installation
JOB_QUEUE_PROCESSES
Changing the Number Tasks
of
JOB_QUEUE_PROCESSES Oracle Application Express requires an Oracle database that is Release 10.2.0.4 or later or Oracle
About Developing Oracle Database 10g Express Edition. To learn more, see the Oracle Database Installation Guide for your
Application Express in operating environment and "Recommended Pre-installation Tasks".
Other Languages
Installing a Translated
Version of Oracle 3.4.2 Download and Install Oracle Application Express
Application Express
Create a Workspace and To install Oracle Application Express:
Add Oracle Application
Express Users 1. For installations where the development will be in English only, download the file
Creating a Workspace
apex_4.2_en.zip from the Oracle Application Express download page. Where the development
Manually
Creating Oracle will include languages other than English, download apex_4.2.zip from the Oracle Application
Application Express Express download page. See:
Users
Logging in to Your
Hide Navigation http://www.oracle.com/technetwork/developer-tools/apex/downloads/index.html

Note that the actual file name may differ if a more recent release has shipped since this
This Book Entire Library document was published.

Quick Lookup 2. Unzip downloaded zip file:


Home Master Index Master
Glossary Master Book List If English only, unzip apex_4.2_en.zip as follows, preserving directory names:
Advanced Search
UNIX and Linux: $unzip apex_4.2_en.zip
Main Categories
Windows: Double click the file apex_4.2_en.zip in Windows Explorer
Security

This Page If multiple languages, unzip apex_4.2.zip as follows, preserving directory names:
Recommended
Pre-installation Tasks UNIX and Linux: $unzip apex_4.2.zip
Choosing a Web Listener Windows: Double click the file apex_4.2.zip in Windows Explorer
Downloading from OTN and
Configuring Oracle
Application Express Listener Note:
Install the Oracle
You should keep the directory tree where you unzip the files short and not
Database and Complete
Pre-installation Tasks under directories that contain spaces. For example, within Windows unzip to
Download and Install C:\TEMP.
Oracle Application
Express
Change the Password for 3. Change your working directory to apex.
the ADMIN Account
Restart Processes 4. Start SQL*Plus and connect to the database where Oracle Application Express is installed as SYS
Configure
specifying the SYSDBA role. For example:
APEX_PUBLIC_USER
Account
Unlocking the On Windows:
APEX_PUBLIC_USER
SYSTEM_DRIVE:\ sqlplus /nolog
Account
Changing the Password SQL> CONNECT SYS as SYSDBA
for the Enter password: SYS_password
APEX_PUBLIC_USER
Account On UNIX and Linux:
Download and Install
Oracle Application $ sqlplus /nolog
Express Listener SQL> CONNECT SYS as SYSDBA
Disabling Oracle XML Enter password: SYS_password
DB Protocol Server
Configure RESTful
5. Disable any existing password complexity rules for the default profile. See "Configuring
Services
Enable Network Services Password Protection" in Oracle Database Security Guide.
in Oracle Database 11g
Granting Connect 6. Select the appropriate installation option.
Privileges
Troubleshooting an Full development environment provides complete access to the Application Builder
Invalid ACL Error environment to develop applications. A Runtime environment enables users to run
Security Considerations applications that cannot be modified. To learn more, see "About the Oracle Application Express
About Managing
Runtime Environment".
JOB_QUEUE_PROCESSES
Viewing the Number of
Available installation options include:
JOB_QUEUE_PROCESSES
Changing the Number
Full development environment. Run apexins.sql passing the following four
of
JOB_QUEUE_PROCESSES arguments in the order shown:
About Developing Oracle
Application Express in @apexins.sql tablespace_apex tablespace_files tablespace_temp images
Other Languages
Installing a Translated Where:
Version of Oracle
Application Express tablespace_apex is the name of the tablespace for the Oracle Application Express
Create a Workspace and
application user.
Add Oracle Application
Express Users
tablespace_files is the name of the tablespace for the Oracle Application Express
Creating a Workspace
Manually files user.
Creating Oracle
Application Express tablespace_temp is the name of the temporary tablespace or tablespace group.
Users
Logging in to Your
Hide Navigation images is the virtual directory for Oracle Application Express images. To support
future Oracle Application Express upgrades, define the virtual image directory as
/i/.
This Book Entire Library
Example:
Quick Lookup
Home Master Index Master @apexins.sql SYSAUX SYSAUX TEMP /i/
Glossary Master Book List
Advanced Search

Main Categories Note:


Security If you receive the following error, please exit SQL*Plus and change
your working directory to apex:
This Page
Recommended SP2-0310: unable to open file "apexins.sql"
Pre-installation Tasks
Choosing a Web Listener
Downloading from OTN and
Configuring Oracle Runtime environment. Run apxrtins.sql passing the following arguments in the
Application Express Listener
Install the Oracle order shown:
Database and Complete
Pre-installation Tasks @apxrtins.sql tablespace_apex tablespace_files tablespace_temp images
Download and Install
Oracle Application Where:
Express
Change the Password for tablespace_apex is the name of the tablespace for the Oracle Application Express
the ADMIN Account application user.
Restart Processes
Configure tablespace_files is the name of the tablespace for the Oracle Application Express
APEX_PUBLIC_USER
Account files user.
Unlocking the
APEX_PUBLIC_USER tablespace_temp is the name of the temporary tablespace or tablespace group.
Account
Changing the Password images is the virtual directory for Oracle Application Express images. To support
for the future Oracle Application Express upgrades, define the virtual image directory as
APEX_PUBLIC_USER /i/.
Account
Download and Install Example:
Oracle Application
Express Listener @apxrtins.sql SYSAUX SYSAUX TEMP /i/
Disabling Oracle XML
DB Protocol Server
Configure RESTful
Services See Also:
Enable Network Services Oracle Database PL/SQL Language Reference for more information about
in Oracle Database 11g SQL*Plus
Granting Connect
Privileges
Troubleshooting an
When Oracle Application Express installs, it creates three new database accounts:
Invalid ACL Error
Security Considerations
APEX_040200 - The account that owns the Oracle Application Express schema and metadata.
About Managing
JOB_QUEUE_PROCESSES
Viewing the Number of FLOWS_FILES - The account that owns the Oracle Application Express uploaded files.
JOB_QUEUE_PROCESSES
Changing the Number APEX_PUBLIC_USER - The minimally privileged account used for Oracle Application Express
of configuration with Oracle Application Express Listener or Oracle HTTP Server and mod_plsql.
JOB_QUEUE_PROCESSES 'This account is created to enable a later switch to a different HTTP server.
About Developing Oracle
Application Express in If you are upgrading from a previous release, then FLOWS_FILES already exists and
Other Languages
APEX_PUBLIC_USER is created if it does not already exist.
Installing a Translated
Version of Oracle
Application Express
Create a Workspace and Tip:
Add Oracle Application Oracle Application Express must be installed from a writable directory on the file
Express Users system. See "Reviewing a Log of an Installation Session".
Creating a Workspace
Manually
Creating Oracle
Application Express 3.4.3 Change the Password for the ADMIN Account
Users
Logging in to Your
Hide Navigation In a new installation of Oracle Application Express, or if you are converting a runtime environment to a
development environment, you must change the password of the internal ADMIN account. In an
upgrade scenario, the password will be preserved and carried over from the prior release.
This Book Entire Library

Quick Lookup Tip:


Home Master Index Master You use the ADMIN account to log in to Oracle Application Express
Glossary Master Book List
Administration Services and manage an entire Oracle Application Express
Advanced Search
instance.
Main Categories
Security
To change the password for the ADMIN account:
This Page
Recommended
1. Change your working directory to the apex directory where you unzipped the installation
Pre-installation Tasks
Choosing a Web Listener software.
Downloading from OTN and
Configuring Oracle 2. Start SQL*Plus and connect to the database where Oracle Application Express is installed as SYS
Application Express Listener specifying the SYSDBA role. For example:
Install the Oracle
Database and Complete On Windows:
Pre-installation Tasks
Download and Install SYSTEM_DRIVE:\ sqlplus /nolog
Oracle Application SQL> CONNECT SYS as SYSDBA
Express Enter password: SYS_password
Change the Password for
the ADMIN Account
On UNIX and Linux:
Restart Processes
Configure
$ sqlplus /nolog
APEX_PUBLIC_USER
SQL> CONNECT SYS as SYSDBA
Account
Unlocking the Enter password: SYS_password
APEX_PUBLIC_USER
Account 3. Run apxchpwd.sql. For example:
Changing the Password
for the @apxchpwd.sql
APEX_PUBLIC_USER
Account When prompted, enter a password for the ADMIN account.
Download and Install
Oracle Application
Express Listener
See Also:
Disabling Oracle XML
DB Protocol Server Oracle Database PL/SQL Language Reference for more information about
Configure RESTful SQL*Plus
Services
Enable Network Services
in Oracle Database 11g
Granting Connect
3.4.4 Configure the Embedded PL/SQL Gateway
Privileges
Troubleshooting an The embedded PL/SQL gateway installs with the Oracle Database 11g. However, you must configure it
Invalid ACL Error before you can use it with Oracle Application Express. To accomplish this, you run a configuration
Security Considerations script and unlock the ANONYMOUS account.
About Managing
JOB_QUEUE_PROCESSES
Viewing the Number of
Note:
JOB_QUEUE_PROCESSES
Changing the Number The Oracle XML DB Protocol Server with the embedded PL/SQL gateway is not
of supported before Oracle Database 11g.
JOB_QUEUE_PROCESSES
About Developing Oracle
Application Express in Topics:
Other Languages
Installing a Translated Running the apex_epg_config.sql Configuration Script
Version of Oracle
Updating the Images Directory When Upgrading from a Previous Release
Application Express
Create a Workspace and Verifying the Oracle XML DB Protocol Server Port
Add Oracle Application Enabling Oracle XML DB Protocol Server
Express Users
Creating a Workspace
Manually See Also:
Creating Oracle
"About Choosing a Web Listener" and "About the Embedded PL/SQL Gateway"
Application Express
Users
Logging in to Your
Hide Navigation 3.4.4.1 Running the apex_epg_config.sql Configuration Script

In a new installation, you configure the embedded PL/SQL gateway by running the configuration script
This Book Entire Library apex_epg_config.sql. Then, you unlock the ANONYMOUS account.

Quick Lookup
Home Master Index Master
Note:
Glossary Master Book List
Advanced Search If you are upgrading and have previously configured the embedded PL/SQL
gateway, skip this section and go to "Updating the Images Directory When
Main Categories Upgrading from a Previous Release".
Security

This Page
Recommended To run the apex_epg_config.sql configuration script:
Pre-installation Tasks
Choosing a Web Listener 1. Change your working directory to the apex directory where you unzipped the Oracle Application
Downloading from OTN and Express software.
Configuring Oracle
Application Express Listener 2. Start SQL*Plus and connect to the database where Oracle Application Express is installed as SYS
Install the Oracle
specifying the SYSDBA role. For example:
Database and Complete
Pre-installation Tasks
On Windows:
Download and Install
Oracle Application
SYSTEM_DRIVE:\ sqlplus /nolog
Express
SQL> CONNECT SYS as SYSDBA
Change the Password for
the ADMIN Account Enter password: SYS_password
Restart Processes
Configure On UNIX and Linux:
APEX_PUBLIC_USER
Account $ sqlplus /nolog
Unlocking the SQL> CONNECT SYS as SYSDBA
APEX_PUBLIC_USER Enter password: SYS_password
Account
Changing the Password 3. Run apex_epg_config.sql passing the file system path to the base directory where the Oracle
for the
APEX_PUBLIC_USER Application Express software was unzipped as shown in the following example:
Account
Download and Install On Windows:
Oracle Application
@apex_epg_config.sql SYSTEM_DRIVE:\TEMP
Express Listener
Disabling Oracle XML
DB Protocol Server On UNIX and Linux:
Configure RESTful
Services @apex_epg_config.sql /tmp
Enable Network Services
in Oracle Database 11g 4. Enter the following statement to unlock the ANONYMOUS account:
Granting Connect
Privileges ALTER USER ANONYMOUS ACCOUNT UNLOCK;
Troubleshooting an
Invalid ACL Error
Security Considerations 3.4.4.2 Updating the Images Directory When Upgrading from a
About Managing Previous Release
JOB_QUEUE_PROCESSES
Viewing the Number of
JOB_QUEUE_PROCESSES If you are upgrading Oracle Application Express from a previous release, you must run the
Changing the Number apxldimg.sql script to update the images directory.
of
JOB_QUEUE_PROCESSES
About Developing Oracle Tip:
Application Express in
If you are not upgrading from a prior release of Oracle Application Express, this
Other Languages
Installing a Translated step is unnecessary. The images will be loaded by running
Version of Oracle apex_epg_config.sql as described in the prior section.
Application Express
Create a Workspace and
Add Oracle Application To run the apxldimg.sql script:
Express Users
Creating a Workspace 1. Start SQL*Plus and connect to the database where Oracle Application Express is installed as SYS
Manually
Creating Oracle specifying the SYSDBA role:
Application Express
Users On Windows:
Logging in to Your
Hide Navigation SYSTEM_DRIVE:\ sqlplus /nolog
SQL> CONNECT SYS as SYSDBA
Enter password: SYS_password

This Book Entire Library


On UNIX and Linux:
Quick Lookup
Home Master Index Master $ sqlplus /nolog
Glossary Master Book List SQL> CONNECT SYS as SYSDBA
Advanced Search Enter password: SYS_password

Main Categories
2. Run apxldimg.sql passing the file system path to the base directory where the Oracle
Security
Application Express software was unzipped as shown in the following example:
This Page
Recommended On Windows:
Pre-installation Tasks
Choosing a Web Listener @apxldimg.sql SYSTEM_DRIVE:\TEMP
Downloading from OTN and
Configuring Oracle On UNIX and Linux:
Application Express Listener
Install the Oracle @apxldimg.sql /tmp
Database and Complete
Pre-installation Tasks
Download and Install
Tip:
Oracle Application
Express The above examples assume that you unzipped Oracle Application Express
Change the Password for in a directory called TEMP on Windows and tmp on UNIX or Linux.
the ADMIN Account
Restart Processes
Configure 3.4.4.3 Verifying the Oracle XML DB Protocol Server Port
APEX_PUBLIC_USER
Account
Unlocking the The embedded PL/SQL gateway runs in the Oracle XML DB Protocol Server in the Oracle database.
APEX_PUBLIC_USER You can determine if the Oracle XML DB Protocol Server is enabled by verifying the associated port
Account number.
Changing the Password
for the To verify the port number where the Oracle XML DB Protocol Server is running:
APEX_PUBLIC_USER
Account
1. Start SQL*Plus and connect to the database where Oracle Application Express is installed as SYS
Download and Install
Oracle Application specifying the SYSDBA role:
Express Listener
Disabling Oracle XML On Windows:
DB Protocol Server
Configure RESTful SYSTEM_DRIVE:\ sqlplus /nolog
Services SQL> CONNECT SYS as SYSDBA
Enable Network Services Enter password: SYS_password
in Oracle Database 11g
Granting Connect On UNIX and Linux:
Privileges
Troubleshooting an $ sqlplus /nolog
Invalid ACL Error SQL> CONNECT SYS as SYSDBA
Security Considerations Enter password: SYS_password
About Managing
JOB_QUEUE_PROCESSES
Viewing the Number of 2. Enter the following statement to verify the port number:
JOB_QUEUE_PROCESSES
Changing the Number SELECT DBMS_XDB.GETHTTPPORT FROM DUAL;
of
JOB_QUEUE_PROCESSES If the port number returns 0, the Oracle XML DB Protocol Server is disabled.
About Developing Oracle
Application Express in 3. To enable it, follow the instructions in "Enabling Oracle XML DB Protocol Server".
Other Languages
Installing a Translated
Version of Oracle 3.4.4.4 Enabling Oracle XML DB Protocol Server
Application Express
Create a Workspace and The embedded PL/SQL gateway runs in the Oracle XML DB Protocol Server in the Oracle database.
Add Oracle Application
Express Users To enable Oracle XML DB Protocol Server:
Creating a Workspace
Manually 1. Start SQL*Plus and connect to the database where Oracle Application Express is installed as SYS
Creating Oracle
specifying the SYSDBA role. For example:
Application Express
Users
Logging in to Your
Hide Navigation On Windows:

SYSTEM_DRIVE:\ sqlplus /nolog


SQL> CONNECT SYS as SYSDBA
This Book Entire Library
Enter password: SYS_password
Quick Lookup
Home Master Index Master On UNIX and Linux:
Glossary Master Book List
Advanced Search $ sqlplus /nolog
SQL> CONNECT SYS as SYSDBA
Main Categories Enter password: SYS_password
Security
2. Enter a statement similar to the following:
This Page
Recommended
EXEC DBMS_XDB.SETHTTPPORT(port);
Pre-installation Tasks
Choosing a Web Listener
Downloading from OTN and For example:
Configuring Oracle
Application Express Listener EXEC DBMS_XDB.SETHTTPPORT(8080);
Install the Oracle
Database and Complete
Pre-installation Tasks Note:
Download and Install
Oracle Application Port numbers less than 1024 are reserved for use by privileged processes on
Express many operating systems. To enable the XML DB HTTP listener on a port less
Change the Password for than 1024, such as 80, review the following documentation:
the ADMIN Account
Restart Processes "Accessing the Repository Using Protocols" in Oracle XML DB Developer's
Configure Guide.
APEX_PUBLIC_USER
Account "Protocol Address Configuration" and "Port Number Limitations" in Oracle
Unlocking the
APEX_PUBLIC_USER
Database Net Services Reference.
Account
Changing the Password
for the
APEX_PUBLIC_USER 3.4.5 Enable Network Services in Oracle Database 11g
Account
Download and Install By default, the ability to interact with network services is disabled in Oracle Database 11g Release 1 or
Oracle Application 2. Therefore, if you are running Oracle Application Express with Oracle Database 11g Release 1 or 2,
Express Listener
Disabling Oracle XML you must use the new DBMS_NETWORK_ACL_ADMIN package to grant connect privileges to any host for
DB Protocol Server the APEX_040200 database user. Failing to grant these privileges results in issues with:
Configure RESTful
Services Sending outbound mail in Oracle Application Express. Users can call methods from the
Enable Network Services APEX_MAIL package, but issues arise when sending outbound email.
in Oracle Database 11g
Granting Connect Using Web services in Oracle Application Express.
Privileges
Troubleshooting an PDF/report printing.
Invalid ACL Error
Security Considerations Topics:
About Managing
JOB_QUEUE_PROCESSES Granting Connect Privileges
Viewing the Number of
Troubleshooting an Invalid ACL Error
JOB_QUEUE_PROCESSES
Changing the Number
of
JOB_QUEUE_PROCESSES Tip:
About Developing Oracle To run the examples described in this section, the compatible initialization
Application Express in parameter of the database must be set to at least 11.1.0.0.0. By default an 11g
Other Languages
database will already have the parameter set properly, but a database upgraded
Installing a Translated
Version of Oracle to 11g from a prior version may not. See "Creating and Configuring an Oracle
Application Express Database" in Oracle Database Administrator's Guide for information about
Create a Workspace and changing database initialization parameters.
Add Oracle Application
Express Users
Creating a Workspace
Manually
3.4.5.1 Granting Connect Privileges
Creating Oracle
Application Express The following example demonstrates how to grant connect privileges to any host for the APEX_040200
Users
Logging in to Your
Hide Navigation database user. This example assumes you connected to the database where Oracle Application
Express is installed as SYS specifying the SYSDBA role.

DECLARE
This Book Entire Library
ACL_PATH VARCHAR2(4000);
Quick Lookup BEGIN
Home Master Index Master -- Look for the ACL currently assigned to '*' and give APEX_040200
Glossary Master Book List -- the "connect" privilege if APEX_040200 does not have the privilege yet.
Advanced Search
SELECT ACL INTO ACL_PATH FROM DBA_NETWORK_ACLS
Main Categories
WHERE HOST = '*' AND LOWER_PORT IS NULL AND UPPER_PORT IS NULL;
Security

This Page IF DBMS_NETWORK_ACL_ADMIN.CHECK_PRIVILEGE(ACL_PATH, 'APEX_040200',


Recommended 'connect') IS NULL THEN
Pre-installation Tasks DBMS_NETWORK_ACL_ADMIN.ADD_PRIVILEGE(ACL_PATH,
Choosing a Web Listener 'APEX_040200', TRUE, 'connect');
Downloading from OTN and
END IF;
Configuring Oracle
Application Express Listener
Install the Oracle EXCEPTION
Database and Complete -- When no ACL has been assigned to '*'.
Pre-installation Tasks WHEN NO_DATA_FOUND THEN
Download and Install DBMS_NETWORK_ACL_ADMIN.CREATE_ACL('power_users.xml',
Oracle Application 'ACL that lets power users to connect to everywhere',
Express 'APEX_040200', TRUE, 'connect');
Change the Password for DBMS_NETWORK_ACL_ADMIN.ASSIGN_ACL('power_users.xml','*');
the ADMIN Account
END;
Restart Processes
/
Configure
APEX_PUBLIC_USER COMMIT;
Account
Unlocking the The following example demonstrates how to provide less privileged access to local network resources.
APEX_PUBLIC_USER This example would enable indexing the Oracle Application Express Online Help and could possibly
Account enable email and PDF printing if those servers were also on the local host.
Changing the Password
for the DECLARE
APEX_PUBLIC_USER
ACL_PATH VARCHAR2(4000);
Account
BEGIN
Download and Install
Oracle Application -- Look for the ACL currently assigned to 'localhost' and give APEX_040200
Express Listener -- the "connect" privilege if APEX_040200 does not have the privilege yet.
Disabling Oracle XML SELECT ACL INTO ACL_PATH FROM DBA_NETWORK_ACLS
DB Protocol Server WHERE HOST = 'localhost' AND LOWER_PORT IS NULL AND UPPER_PORT IS NULL;
Configure RESTful
Services IF DBMS_NETWORK_ACL_ADMIN.CHECK_PRIVILEGE(ACL_PATH, 'APEX_040200',
Enable Network Services 'connect') IS NULL THEN
in Oracle Database 11g
DBMS_NETWORK_ACL_ADMIN.ADD_PRIVILEGE(ACL_PATH,
Granting Connect
'APEX_040200', TRUE, 'connect');
Privileges
Troubleshooting an END IF;
Invalid ACL Error
Security Considerations EXCEPTION
About Managing -- When no ACL has been assigned to 'localhost'.
JOB_QUEUE_PROCESSES WHEN NO_DATA_FOUND THEN
Viewing the Number of DBMS_NETWORK_ACL_ADMIN.CREATE_ACL('local-access-users.xml',
JOB_QUEUE_PROCESSES 'ACL that lets users to connect to localhost',
Changing the Number
'APEX_040200', TRUE, 'connect');
of
DBMS_NETWORK_ACL_ADMIN.ASSIGN_ACL('local-access-users.xml','localhost');
JOB_QUEUE_PROCESSES
About Developing Oracle END;
Application Express in /
Other Languages COMMIT;
Installing a Translated
Version of Oracle
Application Express 3.4.5.2 Troubleshooting an Invalid ACL Error
Create a Workspace and
Add Oracle Application If you receive an ORA-44416: Invalid ACL error after running the previous script, use the following
Express Users
Creating a Workspace query to identify the invalid ACL:
Manually
Creating Oracle REM Show the dangling references to dropped users in the ACL that is assigned
Application Express REM to '*'.
Users
Logging in to Your
SELECT ACL, PRINCIPAL
Hide Navigation
FROM DBA_NETWORK_ACLS NACL, XDS_ACE ACE
WHERE HOST = '*' AND LOWER_PORT IS NULL AND UPPER_PORT IS NULL AND
NACL.ACLID = ACE.ACLID AND
This Book Entire Library
NOT EXISTS (SELECT NULL FROM ALL_USERS WHERE USERNAME = PRINCIPAL);
Quick Lookup
Home Master Index Master Next, run the following code to fix the ACL:
Glossary Master Book List
Advanced Search DECLARE
ACL_ID RAW(16);
Main Categories CNT NUMBER;
Security
BEGIN
This Page -- Look for the object ID of the ACL currently assigned to '*'
Recommended SELECT ACLID INTO ACL_ID FROM DBA_NETWORK_ACLS
Pre-installation Tasks WHERE HOST = '*' AND LOWER_PORT IS NULL AND UPPER_PORT IS NULL;
Choosing a Web Listener
Downloading from OTN and -- If just some users referenced in the ACL are invalid, remove just those
Configuring Oracle -- users in the ACL. Otherwise, drop the ACL completely.
Application Express Listener SELECT COUNT(PRINCIPAL) INTO CNT FROM XDS_ACE
Install the Oracle
WHERE ACLID = ACL_ID AND
Database and Complete
EXISTS (SELECT NULL FROM ALL_USERS WHERE USERNAME = PRINCIPAL);
Pre-installation Tasks
Download and Install
Oracle Application IF (CNT > 0) THEN
Express
Change the Password for FOR R IN (SELECT PRINCIPAL FROM XDS_ACE
the ADMIN Account WHERE ACLID = ACL_ID AND
Restart Processes NOT EXISTS (SELECT NULL FROM ALL_USERS
Configure WHERE USERNAME = PRINCIPAL)) LOOP
APEX_PUBLIC_USER
UPDATE XDB.XDB$ACL
Account
SET OBJECT_VALUE =
Unlocking the
APEX_PUBLIC_USER DELETEXML(OBJECT_VALUE,
Account '/ACL/ACE[PRINCIPAL="'||R.PRINCIPAL||'"]')
Changing the Password WHERE OBJECT_ID = ACL_ID;
for the END LOOP;
APEX_PUBLIC_USER
Account ELSE
Download and Install DELETE FROM XDB.XDB$ACL WHERE OBJECT_ID = ACL_ID;
Oracle Application
END IF;
Express Listener
Disabling Oracle XML
DB Protocol Server END;
Configure RESTful /
Services
Enable Network Services REM commit the changes.
in Oracle Database 11g
Granting Connect COMMIT;
Privileges
Troubleshooting an
Once the ACL has been fixed, you must run the first script in this section to apply the ACL to the
Invalid ACL Error
Security Considerations APEX_040200 user. See "Granting Connect Privileges".
About Managing
JOB_QUEUE_PROCESSES 3.4.6 Security Considerations
Viewing the Number of
JOB_QUEUE_PROCESSES
Changing the Number Oracle highly recommends you configure and use Secure Sockets Layer (SSL) to ensure that
of passwords and other sensitive data are not transmitted in clear text in HTTP requests. Without the use
JOB_QUEUE_PROCESSES of SSL, passwords could potentially be exposed, compromising security.
About Developing Oracle
Application Express in SSL is an industry standard protocol that uses RSA public key cryptography in conjunction with
Other Languages symmetric key cryptography to provide authentication, encryption, and data integrity.
Installing a Translated
Version of Oracle
Application Express
See Also:
Create a Workspace and
Add Oracle Application "Requiring HTTPS" in Oracle Application Express Administration Guide
Express Users
Creating a Workspace
Manually 3.4.7 About Managing JOB_QUEUE_PROCESSES
Creating Oracle
Application Express
JOB_QUEUE_PROCESSES determine the maximum number of concurrently running jobs. In Oracle
Users
Logging in to Your
Hide Navigation Application Express Release 4.2, transactional support and SQL scripts require jobs. If
JOB_QUEUE_PROCESSES is not enabled and working properly, you cannot successfully execute a script.

Topics:
This Book Entire Library

Quick Lookup Viewing the Number of JOB_QUEUE_PROCESSES


Home Master Index Master Changing the Number of JOB_QUEUE_PROCESSES
Glossary Master Book List
Advanced Search
3.4.7.1 Viewing the Number of JOB_QUEUE_PROCESSES
Main Categories
Security There are three ways to view the number of JOB_QUEUE_PROCESSES:
This Page
In the installation log file
Recommended
Pre-installation Tasks On the About Application Express page in Oracle Application Express
Choosing a Web Listener From SQL*Plus
Downloading from OTN and
Configuring Oracle 3.4.7.1.1 Viewing JOB_QUEUE_PROCESSES in the Installation Log File
Application Express Listener
Install the Oracle After installing or upgrading Oracle Application Express to Release 4.2, you can view the number of
Database and Complete JOB_QUEUE_PROCESSES in the installation log files. See "Reviewing a Log of an Installation Session".
Pre-installation Tasks
Download and Install 3.4.7.1.2 Viewing JOB_QUEUE_PROCESSES in Oracle Application Express
Oracle Application
Express You can also view the number of JOB_QUEUE_PROCESSES on the About Application Express page.
Change the Password for
the ADMIN Account
To view the About Application Express page:
Restart Processes
Configure
1. Log in to Oracle Application Express. See "Logging in to Your Workspace".
APEX_PUBLIC_USER
Account
2. Click the Administration icon.
Unlocking the
APEX_PUBLIC_USER
3. From the Tasks list, click About Application Express.
Account
Changing the Password
for the The current number JOB_QUEUE_PROCESSES displays at the bottom of the page.
APEX_PUBLIC_USER
Account 3.4.7.1.3 Viewing JOB_QUEUE_PROCESSES from SQL*Plus
Download and Install
Oracle Application You can also view the number of JOB_QUEUE_PROCESSES from SQL*Plus by running the following SQL
Express Listener statement:
Disabling Oracle XML
DB Protocol Server SELECT VALUE FROM v$parameter WHERE NAME = 'job_queue_processes'
Configure RESTful
Services
Enable Network Services 3.4.7.2 Changing the Number of JOB_QUEUE_PROCESSES
in Oracle Database 11g
Granting Connect
You can change the number of JOB_QUEUE_PROCESSES by running a SQL statement in SQL*Plus:
Privileges
Troubleshooting an
To update the number of JOB_QUEUE_PROCESSES:
Invalid ACL Error
Security Considerations
1. Start SQL*Plus and connect to the database where Oracle Application Express is installed as SYS
About Managing
JOB_QUEUE_PROCESSES specifying the SYSDBA role:
Viewing the Number of
JOB_QUEUE_PROCESSES On Windows:
Changing the Number
of SYSTEM_DRIVE:\ sqlplus /nolog
JOB_QUEUE_PROCESSES SQL> CONNECT SYS as SYSDBA
About Developing Oracle Enter password: SYS_password
Application Express in
Other Languages On UNIX and Linux:
Installing a Translated
Version of Oracle $ sqlplus /nolog
Application Express SQL> CONNECT SYS as SYSDBA
Create a Workspace and
Enter password: SYS_password
Add Oracle Application
Express Users
Creating a Workspace 2. In SQL*Plus run the following SQL statement:
Manually
Creating Oracle ALTER SYSTEM SET JOB_QUEUE_PROCESSES = <number>
Application Express
Users For example, running the statement ALTER SYSTEM SET JOB_QUEUE_PROCESSES = 20 sets
Logging in to Your
Hide Navigation JOB_QUEUE_PROCESSES to 20.

3.4.8 About Running Oracle Application Express in Other


This Book Entire Library Languages
Quick Lookup
Home Master Index Master The Oracle Application Express interface is translated into German, Spanish, French, Italian, Japanese,
Glossary Master Book List Korean, Brazilian Portuguese, Simplified Chinese, and Traditional Chinese. A single instance of Oracle
Advanced Search Application Express can be installed with one or more of these translated versions. Developers can
choose to run the Application Express development environment in any of the installed languages by
Main Categories
Security simply selecting the language from the Application Builder log in screen or home page.

This Page In order to install other languages you must use the apex_4.2.zip file which contains the extra files
Recommended referenced below. If you previously downloaded apex_4.2_en.zip, then you do not need to re-install
Pre-installation Tasks Oracle Application Express. Simply download apex_4.2.zip and unzip the file into the same directory
Choosing a Web Listener
Downloading from OTN and where you unzipped apex_4.2_en.zip.
Configuring Oracle
Application Express Listener The translated version of Oracle Application Express should be loaded into a database that has a
Install the Oracle character set that supports the specific language. If you attempt to install a translated version of
Database and Complete Oracle Application Express into a database that does not support the character encoding of the
Pre-installation Tasks language, the installation may fail or the translated Oracle Application Express instance may appear
Download and Install
corrupt when run. The database character set AL32UTF8 supports all the translated versions of Oracle
Oracle Application
Express Application Express.
Change the Password for
the ADMIN Account You can manually install translated versions of Oracle Application Express using SQL*Plus. The
Restart Processes installation files are encoded in AL32UTF8.
Configure
APEX_PUBLIC_USER
Account
Note:
Unlocking the
APEX_PUBLIC_USER Regardless of the target database character set, to install a translated version of
Account Oracle Application Express, you must set the character set value of the
Changing the Password NLS_LANG environment variable to AL32UTF8 before starting SQL*Plus.
for the
APEX_PUBLIC_USER
Account The following examples illustrate valid NLS_LANG settings for loading Oracle Application Express
Download and Install
Oracle Application translations:
Express Listener
Disabling Oracle XML American_America.AL32UTF8
DB Protocol Server Japanese_Japan.AL32UTF8
Configure RESTful
Services
Enable Network Services 3.4.8.1 Installing a Translated Version of Oracle Application Express
in Oracle Database 11g
Granting Connect Whether you are installing for the first time or upgrading from a previous release, you must run the
Privileges
load_lang.sql script to run a translated version of Oracle Application Express.
Troubleshooting an
Invalid ACL Error
The installation scripts are located in subdirectories identified by a language code in the unzipped
Security Considerations
About Managing distribution apex/builder. For example, the German version is located in apex/builder/de and the
JOB_QUEUE_PROCESSES Japanese version is located in apex/builder/ja. Within each of directory, there is a language loading
Viewing the Number of script identified by the language code (for example, load_de.sql or load_ja.sql).
JOB_QUEUE_PROCESSES
Changing the Number To install a translated version of Oracle Application Express:
of
JOB_QUEUE_PROCESSES
1. Set the NLS_LANG environment variable, making sure that the character set is AL32UTF8. For
About Developing Oracle
Application Express in example:
Other Languages
Installing a Translated Bourne or Korn shell:
Version of Oracle
Application Express NLS_LANG=American_America.AL32UTF8
Create a Workspace and export NLS_LANG
Add Oracle Application
Express Users C shell:
Creating a Workspace
Manually setenv NLS_LANG American_America.AL32UTF8
Creating Oracle
Application Express For Windows based systems:
Users
Logging in to Your
Hide Navigation set NLS_LANG=American_America.AL32UTF8

2. Navigate to the directory under apex/builder based on the language you need to install. For
This Book Entire Library example for German, navigate to apex/builder/de. Start SQL*Plus and connect to the database
where Oracle Application Express is installed as SYS specifying the SYSDBA role. For example:
Quick Lookup
Home Master Index Master On Windows:
Glossary Master Book List
Advanced Search SYSTEM_DRIVE:\ sqlplus /nolog
SQL> CONNECT SYS as SYSDBA
Main Categories
Enter password: SYS_password
Security

This Page On UNIX and Linux:


Recommended
Pre-installation Tasks $ sqlplus /nolog
Choosing a Web Listener SQL> CONNECT SYS as SYSDBA
Downloading from OTN and Enter password: SYS_password
Configuring Oracle
Application Express Listener 3. Execute the following statement:
Install the Oracle
Database and Complete ALTER SESSION SET CURRENT_SCHEMA = APEX_040200;
Pre-installation Tasks
Download and Install
Oracle Application 4. Execute the appropriate language specific script. For example:
Express
Change the Password for @load_lang.sql
the ADMIN Account
Restart Processes Where lang is the specific language (for example, load_de.sql for German or load_ja.sql
Configure for Japanese).
APEX_PUBLIC_USER
Account
Unlocking the 3.4.9 Configuring the SHARED_SERVERS Parameter
APEX_PUBLIC_USER
Account The embedded PL/SQL gateway uses the shared server architecture of the Oracle database. To
Changing the Password achieve acceptable performance when using the embedded PL/SQL gateway, ensure the
for the
SHARED_SERVERS database initialization parameter is set to a reasonable value (that is, not 0 or 1).
APEX_PUBLIC_USER
Account For a small group of concurrent users, Oracle recommends a value of 5 for SHARED_SERVERS.
Download and Install
Oracle Application Consider the following example:
Express Listener
Disabling Oracle XML 1. Start SQL*Plus and connect to the database where Oracle Application Express is installed as SYS
DB Protocol Server specifying the SYSDBA role. For example:
Configure RESTful
Services On Windows:
Enable Network Services
in Oracle Database 11g SYSTEM_DRIVE:\ sqlplus /nolog
Granting Connect SQL> CONNECT SYS as SYSDBA
Privileges
Enter password: SYS_password
Troubleshooting an
Invalid ACL Error
Security Considerations On UNIX and Linux:
About Managing
$ sqlplus /nolog
JOB_QUEUE_PROCESSES
Viewing the Number of SQL> CONNECT SYS as SYSDBA
JOB_QUEUE_PROCESSES Enter password: SYS_password
Changing the Number
of 2. Run the following statement:
JOB_QUEUE_PROCESSES
About Developing Oracle ALTER SYSTEM SET SHARED_SERVERS = 5 SCOPE=BOTH;
Application Express in
Other Languages
Installing a Translated 3.4.10 Create a Workspace and Add Oracle Application Express
Version of Oracle Users
Application Express
Create a Workspace and
You access the Oracle Application Express home page by logging in to a workspace using a Web
Add Oracle Application
Express Users browser. Your Web browser must have JavaScript enabled. See "Browser Requirements".
Creating a Workspace
Manually A workspace is a virtual private database allowing multiple users to work within the same Oracle
Creating Oracle Application Express installation while keeping their objects, data and applications private. Each
Application Express workspace has a unique ID and name.
Users
Logging in to Your
Hide Navigation An instance administrator can create a workspace manually within Oracle Application Express
Administration Services or have users submit requests. Oracle Application Express Administration
Services is a separate application for managing an entire Oracle Application Express instance. See
This Book Entire Library "Creating Workspaces" and "Managing Workspace Requests" in Oracle Application Express
Administration Guide.
Quick Lookup
Home Master Index Master
Glossary Master Book List
See Also:
Advanced Search
Oracle Database 2 Day + Oracle Application Express Developer's Guide if you
Main Categories are new to Oracle Application Express
Security

This Page
Topics:
Recommended
Pre-installation Tasks
Choosing a Web Listener Creating a Workspace Manually
Downloading from OTN and Creating Oracle Application Express Users
Configuring Oracle Logging in to Your Workspace
Application Express Listener
Install the Oracle
Database and Complete 3.4.10.1 Creating a Workspace Manually
Pre-installation Tasks
Download and Install To create an Oracle Application Express workspace manually:
Oracle Application
Express 1. Log in to Oracle Application Express Administration Services. Oracle Application Express
Change the Password for
Administration Services is a separate application for managing an entire Oracle Application
the ADMIN Account
Restart Processes Express instance. You log in using the ADMIN account and password created or reset during the
Configure installation process.
APEX_PUBLIC_USER
Account a. In a Web browser, navigate to the Oracle Application Express Administration Services
Unlocking the application.
APEX_PUBLIC_USER
Account Because your setup uses the embedded PL/SQL gateway, go to:
Changing the Password
for the http://hostname:port/apex/apex_admin
APEX_PUBLIC_USER
Account
Download and Install Where:
Oracle Application
Express Listener hostname is the name of the system where Oracle XML DB Protocol server is installed.
Disabling Oracle XML
DB Protocol Server port is the port number assigned to HTTP on the Oracle XML DB Protocol server. In a
Configure RESTful default installation, this number is 8080.
Services
Enable Network Services apex is the database access descriptor (DAD) defined in the configuration file.
in Oracle Database 11g
Granting Connect b. On the Login page:
Privileges
Troubleshooting an In Username, enter admin.
Invalid ACL Error
Security Considerations In Password, enter the Oracle Application Express administrator account password
About Managing
you specified in "Change the Password for the ADMIN Account".
JOB_QUEUE_PROCESSES
Viewing the Number of
Click Login to Administration.
JOB_QUEUE_PROCESSES
Changing the Number
of
JOB_QUEUE_PROCESSES See Also:
About Developing Oracle See "Logging in to Oracle Application Express Administration Services" in
Application Express in Oracle Application Express Administration Guide.
Other Languages
Installing a Translated
Version of Oracle
Next, create a workspace.
Application Express
Create a Workspace and
2. Click Manage Workspaces.
Add Oracle Application
Express Users
3. Under Workspace Actions, click Create Workspace.
Creating a Workspace
Manually
The Create Workspace Wizard appears.
Creating Oracle
Application Express
4. For Identify Workspace, enter the following:
Users
Logging in to Your
Hide Navigation a. Workspace Name - Enter a unique workspace name.

b. Workspace ID - Leave Workspace ID blank to have the new Workspace ID automatically


generated. A Workspace ID must be a positive integer greater than 100000.
This Book Entire Library

Quick Lookup c. Workspace Description - Enter a workspace description.


Home Master Index Master
Glossary Master Book List d. Click Next.
Advanced Search
5. For Identify Schema, specify whether you are re-using an existing schema or creating a new
Main Categories one.
Security
If you are using an existing schema:
This Page
Recommended a. For Re-use existing schema, select Yes.
Pre-installation Tasks
b. Select a schema from the list.
Choosing a Web Listener
Downloading from OTN and c. Click Next.
Configuring Oracle
Application Express Listener If you are creating a new schema:
Install the Oracle
Database and Complete a. For Re-use existing schema, select No.
Pre-installation Tasks b. Enter a schema name and password.
Download and Install c. Specify a space quota.
Oracle Application
d. Click Next.
Express
Change the Password for
6. For Identify Administrator, enter the Workspace administrator information and click Next.
the ADMIN Account
Restart Processes
Configure 7. Confirm your selections and click Create Workspace.
APEX_PUBLIC_USER
Account 3.4.10.2 Creating Oracle Application Express Users
Unlocking the
APEX_PUBLIC_USER
Account To create an Oracle Application Express user account:
Changing the Password
for the 1. Log in to Oracle Application Express Administration Services as described in the previous section.
APEX_PUBLIC_USER See "Logging in to Oracle Application Express Administration Services" in Oracle Application
Account Express Administration Guide.
Download and Install
Oracle Application 2. Click the Manage Workspaces icon.
Express Listener
Disabling Oracle XML The Administration page appears.
DB Protocol Server
Configure RESTful 3. Click Manage Developers and Users.
Services
Enable Network Services
4. Click Create User.
in Oracle Database 11g
Granting Connect
The Create User page appears.
Privileges
Troubleshooting an
5. Under User Attributes, enter:
Invalid ACL Error
Security Considerations
a. Username - Enter the username used to log in to the system. Restrictions include:
About Managing
JOB_QUEUE_PROCESSES
Maximum length of 100 characters
Viewing the Number of
JOB_QUEUE_PROCESSES No spaces
Changing the Number Only these special characters are permitted: ampersand (@) and period (.)
of
JOB_QUEUE_PROCESSES b. Email Address - Enter the valid email address for this user.
About Developing Oracle
Application Express in c. First Name - Enter the first or given name to further identify the user.
Other Languages
Installing a Translated d. Last Name - Enter the last or family name to further identify the user.
Version of Oracle
Application Express e. Description - Enter comments about this user.
Create a Workspace and
Add Oracle Application f. Default Date Format - Enter the default Oracle date format for the user. This controls
Express Users
the default date format within SQL Workshop.
Creating a Workspace
Manually
6. Under Account Privileges:
Creating Oracle
Application Express
a. Workspace - Select a workspace from the list.
Users
Logging in to Your
Hide Navigation b. Default Schemas - Specify the default schema used for data browsing, application
creation, and SQL script execution.

When using workspaces that have more than one schema available, this schema is the
This Book Entire Library
default. This setting does not control security, only the user's preference.
Quick Lookup
Home Master Index Master c. User is a workspace administrator - Specify if this user should have workspace
Glossary Master Book List administrator privileges.
Advanced Search
Administrators are given access to all components. Additionally, they can manage user
Main Categories
accounts, groups, and development services. Components may not be available if they are
Security
switched off by Instance Administrators.
This Page
Recommended d. User is a developer - Specify if this user should have developer privileges.
Pre-installation Tasks
Choosing a Web Listener Developers must have access to either Application Builder, SQL Workshop, or both. These
Downloading from OTN and components may not be available if they are switched off by the Instance Administrator.
Configuring Oracle
Application Express Listener e. Application Builder Access - Determines whether a developer has access to the
Install the Oracle
Application Builder.
Database and Complete
Pre-installation Tasks
f. SQL Workshop Access - Determines whether a developer has access to the SQL
Download and Install
Oracle Application Workshop.
Express
Change the Password for g. Team Development Access - Determines whether a developer has access to the Team
the ADMIN Account Development.
Restart Processes
Configure h. Set Account Availability - Select Locked to prevent the account from being used.
APEX_PUBLIC_USER Select Unlocked to allow the account to be used.
Account
Unlocking the If the user has exceeded the maximum login failures allowed, specified in Workspace
APEX_PUBLIC_USER
Preferences, then their account will be locked automatically.
Account
Changing the Password
7. Under Password:
for the
APEX_PUBLIC_USER
Password - Enter a case sensitive password.
Account
Download and Install
Oracle Application Confirm Password - Enter the password again.
Express Listener
Disabling Oracle XML Require Change of Password On First Use - Select No to allow the user to use the
DB Protocol Server same password until it expires. Select Yes to require the user to change the password
Configure RESTful immediately when logging in the first time.
Services
Enable Network Services 8. Click Create User or Create and Create Another.
in Oracle Database 11g
Granting Connect
Privileges 3.4.10.3 Logging in to Your Workspace
Troubleshooting an
Invalid ACL Error Once you create a workspace, you must log in to it using your login credentials (that is, the workspace
Security Considerations
name, user name, and password).
About Managing
JOB_QUEUE_PROCESSES
Viewing the Number of
JOB_QUEUE_PROCESSES See Also:
Changing the Number See "Creating Workspaces" and "Managing Workspace Requests" in Oracle
of Application Express Administration Guide
JOB_QUEUE_PROCESSES
About Developing Oracle
Application Express in
To log in to your workspace:
Other Languages
Installing a Translated
1. In a Web browser, navigate to the Oracle Application Express Login page.
Version of Oracle
Application Express
Create a Workspace and Because your setup uses the embedded PL/SQL gateway, go to:
Add Oracle Application
Express Users http://hostname:port/apex/
Creating a Workspace
Manually Where:
Creating Oracle
Application Express hostname is the name of the system where Oracle XML DB Protocol server is installed.
Users
Logging in to Your
Hide Navigation port is the port number assigned to HTTP on the Oracle XML DB Protocol server. In a
default installation, this number is 8080.

apex is the database access descriptor (DAD) defined in the configuration file.
This Book Entire Library

Quick Lookup For users who have upgraded from earlier releases, or who have a custom configuration,
Home Master Index Master this value may be htmldb or something else. Verify your DAD with your Oracle Application
Glossary Master Book List Express administrator.
Advanced Search
The Login page appears.
Main Categories
Security
2. Under Login, enter the following:
This Page
Recommended Workspace field - Enter the name of your workspace.
Pre-installation Tasks Username field - Enter your user name.
Choosing a Web Listener Password field - Enter your case-sensitive password.
Downloading from OTN and
Configuring Oracle 3. Click Login.
Application Express Listener
Install the Oracle Note that, depending on your setup, you might be required to change your password when you
Database and Complete log in for the first time.
Pre-installation Tasks
Download and Install
Oracle Application 3.5 Downloading from OTN and Configuring Oracle HTTP
Express Server
Change the Password for
the ADMIN Account
Restart Processes This section describes how to install Oracle Application Express by downloading a ZIP file from OTN
Configure and then configuring Oracle HTTP Server with mod_plsql distributed with Oracle Database 11g or
APEX_PUBLIC_USER Oracle Application Server 10g.
Account
Unlocking the Topics:
APEX_PUBLIC_USER
Account Install the Oracle Database and Complete Pre-installation Tasks
Changing the Password
for the Download and Install Oracle Application Express
APEX_PUBLIC_USER
Account Change the Password for the ADMIN Account
Download and Install
Oracle Application Restart Processes
Express Listener
Disabling Oracle XML Configure Oracle HTTP Server Distributed with Oracle Database 11g or Oracle Application Server
DB Protocol Server
10g
Configure RESTful
Services
Enable Network Services in Oracle Database 11g
Enable Network Services
in Oracle Database 11g
Granting Connect Security Considerations
Privileges
Troubleshooting an About Managing JOB_QUEUE_PROCESSES
Invalid ACL Error
Security Considerations About Running Oracle Application Express in Other Languages
About Managing
JOB_QUEUE_PROCESSES About Obfuscating PlsqlDatabasePassword Parameter
Viewing the Number of
JOB_QUEUE_PROCESSES Create a Workspace and Add Oracle Application Express Users
Changing the Number
of
JOB_QUEUE_PROCESSES See Also:
About Developing Oracle "About the Oracle Application Express Runtime Environment"
Application Express in
Other Languages
Installing a Translated
Version of Oracle 3.5.1 Install the Oracle Database and Complete Pre-installation
Application Express Tasks
Create a Workspace and
Add Oracle Application
Oracle Application Express requires an Oracle database that is Release 10.2.0.4 or later or Oracle
Express Users
Creating a Workspace Database 10g Express Edition. To learn more, see the Oracle Database Installation Guide for your
Manually operating environment and "Recommended Pre-installation Tasks".
Creating Oracle
Application Express
Users
3.5.2 Download and Install Oracle Application Express
Logging in to Your
Hide Navigation To install Oracle Application Express:

1. For installations where the development will be in English only, download the file
apex_4.2_en.zip from the Oracle Application Express download page. Where the development
This Book Entire Library
will include languages other than English, download apex_4.2.zip from the Oracle Application
Quick Lookup Express download page. See:
Home Master Index Master
Glossary Master Book List http://www.oracle.com/technetwork/developer-tools/apex/downloads/index.html
Advanced Search

Main Categories Note that the actual file name may differ if a more recent release has shipped since this
Security document was published.

This Page 2. Unzip downloaded zip file:


Recommended
Pre-installation Tasks If English only, unzip apex_4.2_en.zip as follows, preserving directory names:
Choosing a Web Listener
Downloading from OTN and UNIX and Linux: $unzip apex_4.2_en.zip
Configuring Oracle Windows: Double click the file apex_4.2_en.zip in Windows Explorer
Application Express Listener
Install the Oracle
If multiple languages, unzip apex_4.2.zip as follows, preserving directory names:
Database and Complete
Pre-installation Tasks
UNIX and Linux: $unzip apex_4.2.zip
Download and Install
Oracle Application Windows: Double click the file apex_4.2.zip in Windows Explorer
Express
Change the Password for
the ADMIN Account Note:
Restart Processes You should keep the directory tree where you unzip the files short and not
Configure
under directories that contain spaces. For example, within Windows unzip to
APEX_PUBLIC_USER
Account C:\TEMP.
Unlocking the
APEX_PUBLIC_USER
Account 3. Change your working directory to apex.
Changing the Password
for the 4. Start SQL*Plus and connect to the database where Oracle Application Express is installed as SYS
APEX_PUBLIC_USER specifying the SYSDBA role. For example:
Account
Download and Install
On Windows:
Oracle Application
Express Listener
SYSTEM_DRIVE:\ sqlplus /nolog
Disabling Oracle XML
SQL> CONNECT SYS as SYSDBA
DB Protocol Server
Configure RESTful Enter password: SYS_password
Services
Enable Network Services On UNIX and Linux:
in Oracle Database 11g
Granting Connect $ sqlplus /nolog
Privileges SQL> CONNECT SYS as SYSDBA
Troubleshooting an Enter password: SYS_password
Invalid ACL Error
Security Considerations 5. Disable any existing password complexity rules for the default profile. See "Configuring
About Managing
Password Protection" in Oracle Database Security Guide.
JOB_QUEUE_PROCESSES
Viewing the Number of
6. Select the appropriate installation option.
JOB_QUEUE_PROCESSES
Changing the Number
of Full development environment provides complete access to the Application Builder
JOB_QUEUE_PROCESSES environment to develop applications. A Runtime environment enables users to run
About Developing Oracle applications that cannot be modified. To learn more, see "About the Oracle Application Express
Application Express in Runtime Environment".
Other Languages
Installing a Translated Available installation options include:
Version of Oracle
Application Express Full development environment. Run apexins.sql passing the following four
Create a Workspace and
Add Oracle Application arguments in the order shown:
Express Users
Creating a Workspace @apexins.sql tablespace_apex tablespace_files tablespace_temp images
Manually
Creating Oracle Where:
Application Express
Users tablespace_apex is the name of the tablespace for the Oracle Application Express
Logging in to Your
Hide Navigation application user.

tablespace_files is the name of the tablespace for the Oracle Application Express
files user.
This Book Entire Library

Quick Lookup tablespace_temp is the name of the temporary tablespace or tablespace group.
Home Master Index Master
Glossary Master Book List images is the virtual directory for Oracle Application Express images. To support
Advanced Search future Oracle Application Express upgrades, define the virtual image directory as
/i/.
Main Categories
Security
Example:
This Page
Recommended @apexins.sql SYSAUX SYSAUX TEMP /i/
Pre-installation Tasks
Choosing a Web Listener
Downloading from OTN and Note:
Configuring Oracle
If you receive the following error, please exit SQL*Plus and change
Application Express Listener
Install the Oracle your working directory to apex:
Database and Complete
Pre-installation Tasks SP2-0310: unable to open file "apexins.sql"
Download and Install
Oracle Application
Express
Change the Password for Runtime environment. Run apxrtins.sql passing the following arguments in the
the ADMIN Account order shown:
Restart Processes
Configure @apxrtins.sql tablespace_apex tablespace_files tablespace_temp images
APEX_PUBLIC_USER
Account
Where:
Unlocking the
APEX_PUBLIC_USER
tablespace_apex is the name of the tablespace for the Oracle Application Express
Account
Changing the Password application user.
for the
APEX_PUBLIC_USER tablespace_files is the name of the tablespace for the Oracle Application Express
Account files user.
Download and Install
Oracle Application tablespace_temp is the name of the temporary tablespace.
Express Listener
Disabling Oracle XML images is the virtual directory for Oracle Application Express images. To support
DB Protocol Server
future Oracle Application Express upgrades, define the virtual image directory as
Configure RESTful
Services /i/.
Enable Network Services
in Oracle Database 11g Example:
Granting Connect
Privileges @apxrtins.sql SYSAUX SYSAUX TEMP /i/
Troubleshooting an
Invalid ACL Error
Security Considerations See Also:
About Managing
Oracle Database PL/SQL Language Reference for more information about
JOB_QUEUE_PROCESSES
Viewing the Number of SQL*Plus
JOB_QUEUE_PROCESSES
Changing the Number
of When Oracle Application Express installs, it creates three new database accounts:
JOB_QUEUE_PROCESSES
About Developing Oracle APEX_040200 - The account that owns the Oracle Application Express schema and metadata.
Application Express in
Other Languages FLOWS_FILES - The account that owns the Oracle Application Express uploaded files.
Installing a Translated
Version of Oracle APEX_PUBLIC_USER - The minimally privileged account used for Oracle Application Express
Application Express
configuration with Oracle Application Express Listener or Oracle HTTP Server and mod_plsql.
Create a Workspace and
Add Oracle Application
If you are upgrading from a previous release, then FLOWS_FILES already exists and
Express Users
Creating a Workspace APEX_PUBLIC_USER is created if it does not already exist.
Manually
Creating Oracle
Application Express Tip:
Users
Logging in to Your
Hide Navigation Oracle Application Express must be installed from a writable directory on the file
system. See "Reviewing a Log of an Installation Session".

This Book Entire Library


3.5.3 Change the Password for the ADMIN Account
Quick Lookup
Home Master Index Master In a new installation of Oracle Application Express, or if you are converting a runtime environment to a
Glossary Master Book List
development environment, you must change the password of the internal ADMIN account. In an
Advanced Search
upgrade scenario, the password will be preserved and carried over from the prior release.
Main Categories
Security
Tip:
This Page
Recommended You use the ADMIN account to log in to Oracle Application Express
Pre-installation Tasks Administration Services and manage an entire Oracle Application Express
Choosing a Web Listener instance.
Downloading from OTN and
Configuring Oracle
Application Express Listener To change the password for the ADMIN account:
Install the Oracle
Database and Complete
1. Change your working directory to the apex directory where you unzipped the installation
Pre-installation Tasks
Download and Install software.
Oracle Application
Express 2. Start SQL*Plus and connect to the database where Oracle Application Express is installed as SYS
Change the Password for specifying the SYSDBA role. For example:
the ADMIN Account
Restart Processes On Windows:
Configure
APEX_PUBLIC_USER SYSTEM_DRIVE:\ sqlplus /nolog
Account SQL> CONNECT SYS as SYSDBA
Unlocking the Enter password: SYS_password
APEX_PUBLIC_USER
Account
On UNIX and Linux:
Changing the Password
for the
$ sqlplus /nolog
APEX_PUBLIC_USER
SQL> CONNECT SYS as SYSDBA
Account
Download and Install Enter password: SYS_password
Oracle Application
Express Listener 3. Run apxchpwd.sql. For example:
Disabling Oracle XML
DB Protocol Server @apxchpwd.sql
Configure RESTful
Services When prompted, enter a password for the ADMIN account.
Enable Network Services
in Oracle Database 11g
Granting Connect
See Also:
Privileges
Troubleshooting an Oracle Database PL/SQL Language Reference for more information about
Invalid ACL Error SQL*Plus
Security Considerations
About Managing
JOB_QUEUE_PROCESSES
Viewing the Number of
3.5.4 Restart Processes
JOB_QUEUE_PROCESSES
Changing the Number After you install Oracle Application Express, you must restart the processes that you stopped before
of you began the installation. In addition, restart Oracle HTTP Server.
JOB_QUEUE_PROCESSES
About Developing Oracle
Application Express in 3.5.5 Configure Oracle HTTP Server Distributed with Oracle
Other Languages Database 11g or Oracle Application Server 10g
Installing a Translated
Version of Oracle This section describes how to configure Oracle HTTP Server with mod_plsql distributed with Oracle
Application Express
Database 11g or Oracle Application Server 10g.
Create a Workspace and
Add Oracle Application
Topics:
Express Users
Creating a Workspace
Manually Unlocking the APEX_PUBLIC_USER Account
Creating Oracle Changing the Password for the APEX_PUBLIC_USER Account
Application Express Copying the Images Directory
Users Configuring Oracle HTTP Server 11g or Oracle Application Server 10g
Logging in to Your
Hide Navigation Disabling Oracle XML DB Protocol Server

3.5.5.1 Unlocking the APEX_PUBLIC_USER Account


This Book Entire Library

Quick Lookup The APEX_PUBLIC_USER account is locked at the end of a new installation of Oracle Application
Home Master Index Master Express. You must unlock this account before configuring the database access descriptor (DAD) in a
Glossary Master Book List new installation.
Advanced Search

Main Categories
Tip:
Security
If you are upgrading from a prior release of Oracle Application Express, this step
This Page is unnecessary.
Recommended
Pre-installation Tasks
Choosing a Web Listener To unlock the APEX_PUBLIC_USER account:
Downloading from OTN and
Configuring Oracle
1. Start SQL*Plus and connect to the database where Oracle Application Express is installed as SYS
Application Express Listener
Install the Oracle specifying the SYSDBA role. For example:
Database and Complete
Pre-installation Tasks On Windows:
Download and Install
Oracle Application SYSTEM_DRIVE:\ sqlplus /nolog
Express SQL> CONNECT SYS as SYSDBA
Change the Password for Enter password: SYS_password
the ADMIN Account
Restart Processes On UNIX and Linux:
Configure
APEX_PUBLIC_USER $ sqlplus /nolog
Account SQL> CONNECT SYS as SYSDBA
Unlocking the Enter password: SYS_password
APEX_PUBLIC_USER
Account
Changing the Password 2. Run the following statement:
for the
APEX_PUBLIC_USER ALTER USER APEX_PUBLIC_USER ACCOUNT UNLOCK
Account
Download and Install
Oracle Application 3.5.5.2 Changing the Password for the APEX_PUBLIC_USER Account
Express Listener
Disabling Oracle XML The APEX_PUBLIC_USER account is created with a random password in a new installation of Oracle
DB Protocol Server Application Express. You must change the password for this account before configuring the database
Configure RESTful
Services access descriptor (DAD) in a new installation.
Enable Network Services
in Oracle Database 11g
Granting Connect Tip:
Privileges If you are upgrading from a prior release of Oracle Application Express, this step
Troubleshooting an is unnecessary.
Invalid ACL Error
Security Considerations
About Managing
To change the password for the APEX_PUBLIC_USER account:
JOB_QUEUE_PROCESSES
Viewing the Number of
JOB_QUEUE_PROCESSES 1. Start SQL*Plus and connect to the database where Oracle Application Express is installed as SYS
Changing the Number specifying the SYSDBA role. For example:
of
JOB_QUEUE_PROCESSES On Windows:
About Developing Oracle
Application Express in SYSTEM_DRIVE:\ sqlplus /nolog
Other Languages SQL> CONNECT SYS as SYSDBA
Installing a Translated Enter password: SYS_password
Version of Oracle
Application Express
On UNIX and Linux:
Create a Workspace and
Add Oracle Application $ sqlplus /nolog
Express Users
SQL> CONNECT SYS as SYSDBA
Creating a Workspace
Enter password: SYS_password
Manually
Creating Oracle
Application Express 2. Run the following statement:
Users
Logging in to Your
Hide Navigation ALTER USER APEX_PUBLIC_USER IDENTIFIED BY new_password

Where new_password is the new password you are setting for APEX_PUBLIC_USER. You will use
This Book Entire Library this password when creating the DAD in the sections that follow.

Quick Lookup 3.5.5.2.1 About Password Expiration in Oracle Database 11g


Home Master Index Master
Glossary Master Book List In the default profile in Oracle Database 11g, the parameter PASSWORD_LIFE_TIME is set to 180. If
Advanced Search you are using Oracle Database 11g with Oracle Application Express, this causes the password for
Main Categories APEX_PUBLIC_USER to expire in 180 days. As a result, your Oracle Application Express instance will
Security become unusable until you change the password.

This Page To prevent this behavior, create another profile in which the PASSWORD_LIFE_TIME parameter is set to
Recommended unlimited and alter the APEX_PUBLIC_USER account and assign it to the new profile.
Pre-installation Tasks
Choosing a Web Listener
Downloading from OTN and
Configuring Oracle See Also:
Application Express Listener Oracle Database Security Guide for information on creating profiles and
Install the Oracle assigning them to database users.
Database and Complete
Pre-installation Tasks
Download and Install
3.5.5.3 Copying the Images Directory
Oracle Application
Express
Change the Password for Whether you are loading a new installation or upgrading from a previous release, you must copy the
the ADMIN Account images directory from the top level of the apex\images directory, for example C:\TEMP, to the
Restart Processes
location on the file system containing the Oracle home for Oracle HTTP Server.
Configure
APEX_PUBLIC_USER
Topics:
Account
Unlocking the
Copying the Images Directory After an Upgrade
APEX_PUBLIC_USER
Account Copying the Images Directory in a New Installation
Changing the Password
for the 3.5.5.3.1 Copying the Images Directory After an Upgrade
APEX_PUBLIC_USER
Account During an upgrade, you overwrite your existing images directory. Before you begin the upgrade, to
Download and Install ensure that you can revert to the previous version, Oracle recommends that you create a copy of your
Oracle Application existing images directory for Oracle Application Express, indicating the release number of the images
Express Listener
(for example, images_3_1).
Disabling Oracle XML
DB Protocol Server
Configure RESTful To locate the images directory on the file system, review the following files for the text alias /i/:
Services
Enable Network Services Oracle Application Server 10gsee the marvel.conf files.
in Oracle Database 11g Oracle HTTP Server distributed with Oracle Database 11gsee the dads.conf files.
Granting Connect
Privileges When you locate the images directory path, copy the existing images directory to a backup location.
Troubleshooting an
Invalid ACL Error Use the following command syntax to copy the apex\images directory from the Oracle Database home
Security Considerations to the existing images directory path, overwriting the existing images:
About Managing
JOB_QUEUE_PROCESSES Oracle Application Server 10g:
Viewing the Number of
JOB_QUEUE_PROCESSES On Windows:
Changing the Number
of xcopy /E /I APEX_HOME\apex\images ORACLE_HTTPSERVER_HOME\Apache\images
JOB_QUEUE_PROCESSES
About Developing Oracle
On UNIX and Linux:
Application Express in
Other Languages
cp -rf APEX_HOME/apex/images ORACLE_HTTPSERVER_HOME/Apache
Installing a Translated
Version of Oracle
Application Express Oracle HTTP Server distributed with Oracle Database 11g:
Create a Workspace and
Add Oracle Application On Windows:
Express Users
Creating a Workspace xcopy /E /I APEX_HOME\apex\images ORACLE_HTTPSERVER_HOME\ohs\images
Manually
Creating Oracle On UNIX and Linux:
Application Express
Users cp -rf APEX_HOME/apex/images ORACLE_HTTPSERVER_HOME/ohs
Logging in to Your
Hide Navigation In the preceding syntax examples:

APEX_HOME is the directory where the Oracle Application Express software was unzipped, for
example C:\TEMP if installing on Windows.
This Book Entire Library

Quick Lookup ORACLE_HTTPSERVER_HOME is the existing Oracle Application Server or Oracle HTTP Server
Home Master Index Master Oracle home.
Glossary Master Book List
Advanced Search 3.5.5.3.2 Copying the Images Directory in a New Installation
Main Categories After installation, copy the directory apex/images.
Security
Oracle Application Server 10g:
This Page
Recommended
On Windows:
Pre-installation Tasks
Choosing a Web Listener
xcopy /E /I ORACLE_HOME\apex\images ORACLE_HTTPSERVER_HOME\Apache\images
Downloading from OTN and
Configuring Oracle
Application Express Listener On UNIX and Linux:
Install the Oracle
cp -rf $ORACLE_HOME/apex/images ORACLE_HTTPSERVER_HOME/Apache
Database and Complete
Pre-installation Tasks
Download and Install Oracle HTTP Server distributed with Oracle Database 11g:
Oracle Application
Express On Windows:
Change the Password for
the ADMIN Account xcopy /E /I ORACLE_HOME\apex\images ORACLE_HTTPSERVER_HOME\ohs\images
Restart Processes
Configure On UNIX and Linux:
APEX_PUBLIC_USER
Account cp -rf $ORACLE_HOME/apex/images ORACLE_HTTPSERVER_HOME/ohs
Unlocking the
APEX_PUBLIC_USER In the preceding syntax examples:
Account
Changing the Password ORACLE_HOME is the directory where the Oracle Application Express software was unzipped, for
for the
APEX_PUBLIC_USER example C:\TEMP if installing on Windows.
Account
ORACLE_HTTPSERVER_HOME is the existing Oracle Application Server or Oracle HTTP Server
Download and Install
Oracle Application Oracle home.
Express Listener
Disabling Oracle XML
DB Protocol Server
3.5.5.4 Configuring Oracle HTTP Server 11g or Oracle Application
Configure RESTful Server 10g
Services
Enable Network Services Perform the following post installation steps outlined in this section.
in Oracle Database 11g
Granting Connect Topics:
Privileges
Troubleshooting an
Editing the dads.conf File
Invalid ACL Error
Security Considerations Stopping and Restarting Oracle HTTP Server
About Managing
JOB_QUEUE_PROCESSES
Viewing the Number of Note:
JOB_QUEUE_PROCESSES Within the context of this document, ORACLE_HTTPSERVER_HOME is the location
Changing the Number
where Oracle HTTP Server is installed.
of
JOB_QUEUE_PROCESSES
About Developing Oracle
Application Express in 3.5.5.4.1 Editing the dads.conf File
Other Languages
Installing a Translated If this is a new installation of Oracle Application Express, you must edit the dads.conf or
Version of Oracle marvel.conf file. The dads.conf file contains the information about the Database Access Descriptor
Application Express (DAD) to access Oracle Application Express.
Create a Workspace and
Add Oracle Application To edit the dads.conf file:
Express Users
Creating a Workspace 1. Use a text editor and open the dads.conf.
Manually
Creating Oracle
Oracle Application Server 10g:
Application Express
Users
Logging in to Your
Hide Navigation On Windows see:

ORACLE_HTTPSERVER_HOME\Apache\modplsql\conf\dads.conf

This Book Entire Library On UNIX and Linux see:


Quick Lookup
ORACLE_HTTPSERVER_HOME/Apache/modplsql/conf/dads.conf
Home Master Index Master
Glossary Master Book List
Advanced Search Oracle HTTP Server distributed with Oracle Database 11g:

Main Categories On Windows see:


Security
ORACLE_HTTPSERVER_HOME\ohs\modplsql\conf\dads.conf
This Page
Recommended On UNIX and Linux see:
Pre-installation Tasks
Choosing a Web Listener ORACLE_HTTPSERVER_HOME/ohs/modplsql/conf/dads.conf
Downloading from OTN and
Configuring Oracle
2. In the dads.conf file, replace ORACLE_HTTPSERVER_HOME, host, port, service_name, and
Application Express Listener
Install the Oracle apex_public_user_password with values appropriate for your environment. Note that the
Database and Complete apex_public_user_password is the password you changed in "Changing the Password for the
Pre-installation Tasks APEX_PUBLIC_USER Account".
Download and Install
Oracle Application Note that the path listed is only an example. The path in the dads.conf file should reference the
Express
file system path described in "Copying the Images Directory".
Change the Password for
the ADMIN Account
Alias /i/ "ORACLE_HTTPSERVER_HOME/Apache/images/"
Restart Processes
Configure
APEX_PUBLIC_USER <Location /pls/apex>
Account Order deny,allow
Unlocking the PlsqlDocumentPath docs
APEX_PUBLIC_USER AllowOverride None
Account PlsqlDocumentProcedure wwv_flow_file_mgr.process_download
Changing the Password
PlsqlDatabaseConnectString host:port:service_name ServiceNameFormat
for the
PlsqlNLSLanguage AMERICAN_AMERICA.AL32UTF8
APEX_PUBLIC_USER
Account PlsqlAuthenticationMode Basic
Download and Install SetHandler pls_handler
Oracle Application PlsqlDocumentTablename wwv_flow_file_objects$
Express Listener PlsqlDatabaseUsername APEX_PUBLIC_USER
Disabling Oracle XML PlsqlDefaultPage apex
DB Protocol Server PlsqlDatabasePassword apex_public_user_password
Configure RESTful PlsqlRequestValidationFunction wwv_flow_epg_include_modules.authorize
Services
Allow from all
Enable Network Services
</Location>
in Oracle Database 11g
Granting Connect
Privileges 3. Locate the line containing PlsqlNLSLanguage.
Troubleshooting an
Invalid ACL Error The PlsqlNLSLanguage setting determines the language setting of the DAD. The character set
Security Considerations portion of the PlsqlNLSLanguage value must be set to AL32UTF8, regardless of whether or not
About Managing the database character set is AL32UTF8. For example:
JOB_QUEUE_PROCESSES
Viewing the Number of
...
JOB_QUEUE_PROCESSES
PlsqlNLSLanguage AMERICAN_AMERICA.AL32UTF8
Changing the Number
of ...
JOB_QUEUE_PROCESSES
About Developing Oracle 4. Save and exit the dads.conf file.
Application Express in
Other Languages 3.5.5.4.2 Stopping and Restarting Oracle HTTP Server
Installing a Translated
Version of Oracle To stop and restart Oracle HTTP Server:
Application Express
Create a Workspace and Windows:
Add Oracle Application
Express Users If database is 10g and lower, execute the following:
Creating a Workspace
Manually ORACLE_HTTPSERVER_HOME\opmn\bin\opmnctl stopproc ias-component=HTTP_Server
Creating Oracle ORACLE_HTTPSERVER_HOME\opmn\bin\opmnctl startproc ias-component=HTTP_Server
Application Express
Users
Logging in to Your
Hide Navigation UNIX and Linux

If database is 10g and lower, execute the following:

This Book Entire Library ORACLE_HTTPSERVER_HOME/opmn/bin/opmnctl stopproc ias-component=HTTP_Server


ORACLE_HTTPSERVER_HOME/opmn/bin/opmnctl startproc ias-component=HTTP_Server
Quick Lookup
Home Master Index Master
Glossary Master Book List
Advanced Search Note:
If you are using Oracle HTTP Server that is included with Oracle Fusion
Main Categories
Security Middleware 11.1.1, you may need to replace the ias-component name above if
the name given to the component was something other than HTTP_Server when
This Page it was installed. The default name is ohs1.
Recommended
Pre-installation Tasks
Choosing a Web Listener
Downloading from OTN and 3.5.5.5 Disabling Oracle XML DB Protocol Server
Configuring Oracle
Application Express Listener If you were previously using the embedded PL/SQL Gateway and now wish to use Oracle HTTP server
Install the Oracle
and mod_plsql, you need to disable the Oracle XML DB Protocol server.
Database and Complete
Pre-installation Tasks
To disable Oracle XML DB Protocol server:
Download and Install
Oracle Application
1. Start SQL*Plus and connect to the database where Oracle Application Express is installed as SYS
Express
Change the Password for specifying the SYSDBA role. For example:
the ADMIN Account
Restart Processes On Windows:
Configure
APEX_PUBLIC_USER SYSTEM_DRIVE:\ sqlplus /nolog
Account SQL> CONNECT SYS as SYSDBA
Unlocking the Enter password: SYS_password
APEX_PUBLIC_USER
Account On UNIX and Linux:
Changing the Password
for the $ sqlplus /nolog
APEX_PUBLIC_USER SQL> CONNECT SYS as SYSDBA
Account
Enter password: SYS_password
Download and Install
Oracle Application
Express Listener 2. Run the following command:
Disabling Oracle XML
DB Protocol Server EXEC DBMS_XDB.SETHTTPPORT(0);
Configure RESTful
Services
Enable Network Services
3.5.6 Enable Network Services in Oracle Database 11g
in Oracle Database 11g
Granting Connect By default, the ability to interact with network services is disabled in Oracle Database 11g Release 1 or
Privileges 2. Therefore, if you are running Oracle Application Express with Oracle Database 11g Release 1 or 2,
Troubleshooting an you must use the new DBMS_NETWORK_ACL_ADMIN package to grant connect privileges to any host for
Invalid ACL Error
the APEX_040200 database user. Failing to grant these privileges results in issues with:
Security Considerations
About Managing
Sending outbound mail in Oracle Application Express. Users can call methods from the
JOB_QUEUE_PROCESSES
Viewing the Number of APEX_MAIL package, but issues arise when sending outbound email.
JOB_QUEUE_PROCESSES
Changing the Number Using Web services in Oracle Application Express.
of
JOB_QUEUE_PROCESSES PDF/report printing.
About Developing Oracle
Application Express in Topics:
Other Languages
Installing a Translated Granting Connect Privileges
Version of Oracle Troubleshooting an Invalid ACL Error
Application Express
Create a Workspace and
Add Oracle Application
Tip:
Express Users
Creating a Workspace To run the examples described in this section, the compatible initialization
Manually parameter of the database must be set to at least 11.1.0.0.0. By default an 11g
Creating Oracle database will already have the parameter set properly, but a database upgraded
Application Express to 11g from a prior version may not. See "Creating and Configuring an Oracle
Users
Logging in to Your
Hide Navigation Database" in Oracle Database Administrator's Guide for information about
changing database initialization parameters.

This Book Entire Library


3.5.6.1 Granting Connect Privileges
Quick Lookup
Home Master Index Master
The following example demonstrates how to grant connect privileges to any host for the APEX_040200
Glossary Master Book List
Advanced Search database user. This example assumes you connected to the database where Oracle Application
Express is installed as SYS specifying the SYSDBA role.
Main Categories
Security DECLARE
ACL_PATH VARCHAR2(4000);
This Page
BEGIN
Recommended
Pre-installation Tasks -- Look for the ACL currently assigned to '*' and give APEX_040200
Choosing a Web Listener -- the "connect" privilege if APEX_040200 does not have the privilege yet.
Downloading from OTN and
Configuring Oracle SELECT ACL INTO ACL_PATH FROM DBA_NETWORK_ACLS
Application Express Listener WHERE HOST = '*' AND LOWER_PORT IS NULL AND UPPER_PORT IS NULL;
Install the Oracle
Database and Complete IF DBMS_NETWORK_ACL_ADMIN.CHECK_PRIVILEGE(ACL_PATH, 'APEX_040200',
Pre-installation Tasks
'connect') IS NULL THEN
Download and Install
DBMS_NETWORK_ACL_ADMIN.ADD_PRIVILEGE(ACL_PATH,
Oracle Application
Express 'APEX_040200', TRUE, 'connect');
Change the Password for END IF;
the ADMIN Account
Restart Processes EXCEPTION
Configure -- When no ACL has been assigned to '*'.
APEX_PUBLIC_USER WHEN NO_DATA_FOUND THEN
Account DBMS_NETWORK_ACL_ADMIN.CREATE_ACL('power_users.xml',
Unlocking the
'ACL that lets power users to connect to everywhere',
APEX_PUBLIC_USER
'APEX_040200', TRUE, 'connect');
Account
Changing the Password DBMS_NETWORK_ACL_ADMIN.ASSIGN_ACL('power_users.xml','*');
for the END;
APEX_PUBLIC_USER /
Account COMMIT;
Download and Install
Oracle Application The following example demonstrates how to provide less privileged access to local network resources.
Express Listener
This example would enable indexing the Oracle Application Express Online Help and could possibly
Disabling Oracle XML
DB Protocol Server enable email and PDF printing if those servers were also on the local host.
Configure RESTful
Services DECLARE
Enable Network Services ACL_PATH VARCHAR2(4000);
in Oracle Database 11g BEGIN
Granting Connect -- Look for the ACL currently assigned to 'localhost' and give APEX_040200
Privileges -- the "connect" privilege if APEX_040200 does not have the privilege yet.
Troubleshooting an SELECT ACL INTO ACL_PATH FROM DBA_NETWORK_ACLS
Invalid ACL Error
WHERE HOST = 'localhost' AND LOWER_PORT IS NULL AND UPPER_PORT IS NULL;
Security Considerations
About Managing
JOB_QUEUE_PROCESSES IF DBMS_NETWORK_ACL_ADMIN.CHECK_PRIVILEGE(ACL_PATH, 'APEX_040200',
Viewing the Number of 'connect') IS NULL THEN
JOB_QUEUE_PROCESSES DBMS_NETWORK_ACL_ADMIN.ADD_PRIVILEGE(ACL_PATH,
Changing the Number 'APEX_040200', TRUE, 'connect');
of END IF;
JOB_QUEUE_PROCESSES
About Developing Oracle EXCEPTION
Application Express in
-- When no ACL has been assigned to 'localhost'.
Other Languages
WHEN NO_DATA_FOUND THEN
Installing a Translated
Version of Oracle DBMS_NETWORK_ACL_ADMIN.CREATE_ACL('local-access-users.xml',
Application Express 'ACL that lets users to connect to localhost',
Create a Workspace and 'APEX_040200', TRUE, 'connect');
Add Oracle Application DBMS_NETWORK_ACL_ADMIN.ASSIGN_ACL('local-access-users.xml','localhost');
Express Users END;
Creating a Workspace /
Manually COMMIT;
Creating Oracle
Application Express
Users 3.5.6.2 Troubleshooting an Invalid ACL Error
Logging in to Your
Hide Navigation If you receive an ORA-44416: Invalid ACL error after running the previous script, use the following
query to identify the invalid ACL:

REM Show the dangling references to dropped users in the ACL that is assigned
This Book Entire Library
REM to '*'.
Quick Lookup
Home Master Index Master SELECT ACL, PRINCIPAL
Glossary Master Book List FROM DBA_NETWORK_ACLS NACL, XDS_ACE ACE
Advanced Search WHERE HOST = '*' AND LOWER_PORT IS NULL AND UPPER_PORT IS NULL AND
NACL.ACLID = ACE.ACLID AND
Main Categories
NOT EXISTS (SELECT NULL FROM ALL_USERS WHERE USERNAME = PRINCIPAL);
Security

This Page Next, run the following code to fix the ACL:
Recommended
Pre-installation Tasks DECLARE
Choosing a Web Listener ACL_ID RAW(16);
Downloading from OTN and CNT NUMBER;
Configuring Oracle BEGIN
Application Express Listener
-- Look for the object ID of the ACL currently assigned to '*'
Install the Oracle
SELECT ACLID INTO ACL_ID FROM DBA_NETWORK_ACLS
Database and Complete
Pre-installation Tasks WHERE HOST = '*' AND LOWER_PORT IS NULL AND UPPER_PORT IS NULL;
Download and Install
Oracle Application -- If just some users referenced in the ACL are invalid, remove just those
Express -- users in the ACL. Otherwise, drop the ACL completely.
Change the Password for SELECT COUNT(PRINCIPAL) INTO CNT FROM XDS_ACE
the ADMIN Account WHERE ACLID = ACL_ID AND
Restart Processes EXISTS (SELECT NULL FROM ALL_USERS WHERE USERNAME = PRINCIPAL);
Configure
APEX_PUBLIC_USER
IF (CNT > 0) THEN
Account
Unlocking the
APEX_PUBLIC_USER FOR R IN (SELECT PRINCIPAL FROM XDS_ACE
Account WHERE ACLID = ACL_ID AND
Changing the Password NOT EXISTS (SELECT NULL FROM ALL_USERS
for the WHERE USERNAME = PRINCIPAL)) LOOP
APEX_PUBLIC_USER UPDATE XDB.XDB$ACL
Account SET OBJECT_VALUE =
Download and Install
DELETEXML(OBJECT_VALUE,
Oracle Application
'/ACL/ACE[PRINCIPAL="'||R.PRINCIPAL||'"]')
Express Listener
Disabling Oracle XML WHERE OBJECT_ID = ACL_ID;
DB Protocol Server END LOOP;
Configure RESTful
Services ELSE
Enable Network Services DELETE FROM XDB.XDB$ACL WHERE OBJECT_ID = ACL_ID;
in Oracle Database 11g END IF;
Granting Connect
Privileges
END;
Troubleshooting an
/
Invalid ACL Error
Security Considerations
About Managing REM commit the changes.
JOB_QUEUE_PROCESSES
Viewing the Number of COMMIT;
JOB_QUEUE_PROCESSES
Changing the Number Once the ACL has been fixed, you must run the first script in this section to apply the ACL to the
of
APEX_040200 user. See "Granting Connect Privileges".
JOB_QUEUE_PROCESSES
About Developing Oracle
Application Express in 3.5.7 Security Considerations
Other Languages
Installing a Translated Oracle highly recommends you configure and use Secure Sockets Layer (SSL) to ensure that
Version of Oracle
Application Express passwords and other sensitive data are not transmitted in clear text in HTTP requests. Without the use
Create a Workspace and of SSL, passwords could potentially be exposed, compromising security.
Add Oracle Application
Express Users SSL is an industry standard protocol that uses RSA public key cryptography in conjunction with
Creating a Workspace symmetric key cryptography to provide authentication, encryption, and data integrity.
Manually
Creating Oracle
Application Express 3.5.8 About Managing JOB_QUEUE_PROCESSES
Users
Logging in to Your
Hide Navigation JOB_QUEUE_PROCESSES determine the maximum number of concurrently running jobs. In Oracle
Application Express Release 4.2, transactional support and SQL scripts require jobs. If
JOB_QUEUE_PROCESSES is not enabled and working properly, you cannot successfully execute a script.
This Book Entire Library
Topics:
Quick Lookup
Home Master Index Master Viewing the Number of JOB_QUEUE_PROCESSES
Glossary Master Book List Changing the Number of JOB_QUEUE_PROCESSES
Advanced Search

Main Categories 3.5.8.1 Viewing the Number of JOB_QUEUE_PROCESSES


Security

This Page There are three ways to view the number of JOB_QUEUE_PROCESSES:
Recommended
Pre-installation Tasks In the installation log file
Choosing a Web Listener On the About Application Express page in Oracle Application Express
Downloading from OTN and From SQL*Plus
Configuring Oracle
Application Express Listener 3.5.8.1.1 Viewing JOB_QUEUE_PROCESSES in the Installation Log File
Install the Oracle
Database and Complete After installing or upgrading Oracle Application Express to Release 4.2, you can view the number of
Pre-installation Tasks
JOB_QUEUE_PROCESSES in the installation log files. See "Reviewing a Log of an Installation Session".
Download and Install
Oracle Application
Express
3.5.8.1.2 Viewing JOB_QUEUE_PROCESSES in Oracle Application Express
Change the Password for
the ADMIN Account You can also view the number of JOB_QUEUE_PROCESSES on the About Application Express page.
Restart Processes
Configure To view the About Application Express page:
APEX_PUBLIC_USER
Account 1. Log in to Oracle Application Express. See "Logging in to Your Workspace".
Unlocking the
APEX_PUBLIC_USER 2. Click the Administration icon.
Account
Changing the Password 3. From the Tasks list, click About Application Express.
for the
APEX_PUBLIC_USER The current number JOB_QUEUE_PROCESSES displays at the bottom of the page.
Account
Download and Install 3.5.8.1.3 Viewing JOB_QUEUE_PROCESSES from SQL*Plus
Oracle Application
Express Listener You can also view the number of JOB_QUEUE_PROCESSES from SQL*Plus by running the following SQL
Disabling Oracle XML statement:
DB Protocol Server
Configure RESTful SELECT VALUE FROM v$parameter WHERE NAME = 'job_queue_processes'
Services
Enable Network Services
in Oracle Database 11g 3.5.8.2 Changing the Number of JOB_QUEUE_PROCESSES
Granting Connect
Privileges
Troubleshooting an You can change the number of JOB_QUEUE_PROCESSES by running a SQL statement in SQL*Plus:
Invalid ACL Error
Security Considerations To update the number of JOB_QUEUE_PROCESSES:
About Managing
JOB_QUEUE_PROCESSES 1. Start SQL*Plus and connect to the database where Oracle Application Express is installed as SYS
Viewing the Number of specifying the SYSDBA role:
JOB_QUEUE_PROCESSES
Changing the Number On Windows:
of
JOB_QUEUE_PROCESSES SYSTEM_DRIVE:\ sqlplus /nolog
About Developing Oracle SQL> CONNECT SYS as SYSDBA
Application Express in Enter password: SYS_password
Other Languages
Installing a Translated
On UNIX and Linux:
Version of Oracle
Application Express
$ sqlplus /nolog
Create a Workspace and
Add Oracle Application SQL> CONNECT SYS as SYSDBA
Express Users Enter password: SYS_password
Creating a Workspace
Manually 2. In SQL*Plus run the following SQL statement:
Creating Oracle
Application Express ALTER SYSTEM SET JOB_QUEUE_PROCESSES = <number>
Users
Logging in to Your
Hide Navigation For example, running the statement ALTER SYSTEM SET JOB_QUEUE_PROCESSES = 20 sets
JOB_QUEUE_PROCESSES to 20.

This Book Entire Library 3.5.9 About Running Oracle Application Express in Other
Quick Lookup Languages
Home Master Index Master
Glossary Master Book List The Oracle Application Express interface is translated into German, Spanish, French, Italian, Japanese,
Advanced Search Korean, Brazilian Portuguese, Simplified Chinese, and Traditional Chinese. A single instance of Oracle
Application Express can be installed with one or more of these translated versions. Developers can
Main Categories
Security choose to run the Application Express development environment in any of the installed languages by
simply selecting the language from the Application Builder log in screen or home page.
This Page
Recommended In order to install other languages you must use the apex_4.2.zip file which contains the extra files
Pre-installation Tasks referenced below. If you previously downloaded apex_4.2_en.zip, then you do not need to re-install
Choosing a Web Listener
Downloading from OTN and Oracle Application Express. Simply download apex_4.2.zip and unzip the file into the same directory
Configuring Oracle where you unzipped apex_4.2_en.zip.
Application Express Listener
Install the Oracle The translated version of Oracle Application Express should be loaded into a database that has a
Database and Complete character set that supports the specific language. If you attempt to install a translated version of
Pre-installation Tasks
Oracle Application Express into a database that does not support the character encoding of the
Download and Install
Oracle Application language, the installation may fail or the translated Oracle Application Express instance may appear
Express corrupt when run. The database character set AL32UTF8 supports all the translated versions of Oracle
Change the Password for Application Express.
the ADMIN Account
Restart Processes You can manually install translated versions of Oracle Application Express using SQL*Plus. The
Configure installation files are encoded in AL32UTF8.
APEX_PUBLIC_USER
Account
Unlocking the
APEX_PUBLIC_USER Note:
Account Regardless of the target database character set, to install a translated version of
Changing the Password Oracle Application Express, you must set the character set value of the
for the NLS_LANG environment variable to AL32UTF8 before starting SQL*Plus.
APEX_PUBLIC_USER
Account
Download and Install
Oracle Application The following examples illustrate valid NLS_LANG settings for loading Oracle Application Express
Express Listener translations:
Disabling Oracle XML
DB Protocol Server American_America.AL32UTF8
Configure RESTful Japanese_Japan.AL32UTF8
Services
Enable Network Services
in Oracle Database 11g 3.5.9.1 Installing a Translated Version of Oracle Application Express
Granting Connect
Privileges
Whether you are installing for the first time or upgrading from a previous release, you must run the
Troubleshooting an
Invalid ACL Error load_lang.sql script to run a translated version of Oracle Application Express.
Security Considerations
About Managing The installation scripts are located in subdirectories identified by a language code in the unzipped
JOB_QUEUE_PROCESSES distribution apex/builder. For example, the German version is located in apex/builder/de and the
Viewing the Number of Japanese version is located in apex/builder/ja. Within each of directory, there is a language loading
JOB_QUEUE_PROCESSES
script identified by the language code (for example, load_de.sql or load_ja.sql).
Changing the Number
of
JOB_QUEUE_PROCESSES To install a translated version of Oracle Application Express:
About Developing Oracle
Application Express in 1. Set the NLS_LANG environment variable, making sure that the character set is AL32UTF8. For
Other Languages example:
Installing a Translated
Version of Oracle Bourne or Korn shell:
Application Express
Create a Workspace and NLS_LANG=American_America.AL32UTF8
Add Oracle Application export NLS_LANG
Express Users
Creating a Workspace C shell:
Manually
Creating Oracle setenv NLS_LANG American_America.AL32UTF8
Application Express
Users
Logging in to Your
Hide Navigation For Windows based systems:

set NLS_LANG=American_America.AL32UTF8

This Book Entire Library


2. Navigate to the directory under apex/builder based on the language you need to install. For
Quick Lookup example for German, navigate to apex/builder/de. Start SQL*Plus and connect to the
Home Master Index Master database where Oracle Application Express is installed as SYS specifying the SYSDBA role. For
Glossary Master Book List example:
Advanced Search

Main Categories On Windows:


Security
SYSTEM_DRIVE:\ sqlplus /nolog
This Page SQL> CONNECT SYS as SYSDBA
Recommended Enter password: SYS_password
Pre-installation Tasks
Choosing a Web Listener On UNIX and Linux:
Downloading from OTN and
Configuring Oracle $ sqlplus /nolog
Application Express Listener SQL> CONNECT SYS as SYSDBA
Install the Oracle Enter password: SYS_password
Database and Complete
Pre-installation Tasks
3. Execute the following statement:
Download and Install
Oracle Application
ALTER SESSION SET CURRENT_SCHEMA = APEX_040200;
Express
Change the Password for
the ADMIN Account 4. Execute the appropriate language specific script. For example:
Restart Processes
Configure @load_lang.sql
APEX_PUBLIC_USER
Account Where lang is the specific language (for example, load_de.sql for German or load_ja.sql
Unlocking the
for Japanese).
APEX_PUBLIC_USER
Account
Changing the Password 3.5.10 About Obfuscating PlsqlDatabasePassword Parameter
for the
APEX_PUBLIC_USER The PlsqlDatabasePassword parameter specifies the password for logging in to the database. You
Account
can use the dadTool.pl utility to obfuscate passwords in the dads.conf file.
Download and Install
Oracle Application
Express Listener You can find the dadTool.pl utility in the following directory:
Disabling Oracle XML
DB Protocol Server For UNIX and Linux based systems:
Configure RESTful
Services ORACLE_HTTPSERVER_HOME/Apache/modplsql/conf
Enable Network Services
in Oracle Database 11g For Windows based systems:
Granting Connect
Privileges ORACLE_HTTPSERVER_HOME\Apache\modplsql\conf
Troubleshooting an
Invalid ACL Error
Security Considerations 3.5.10.1 Obfuscating Passwords
About Managing
JOB_QUEUE_PROCESSES To obfuscate passwords, run dadTool.pl by following the instructions in the dadTool.README file.
Viewing the Number of
JOB_QUEUE_PROCESSES
Changing the Number 3.5.11 Create a Workspace and Add Oracle Application Express
of Users
JOB_QUEUE_PROCESSES
About Developing Oracle
You access the Oracle Application Express home page by logging in to a workspace using a Web
Application Express in
Other Languages browser. Your Web browser must have JavaScript enabled. See "Browser Requirements".
Installing a Translated
Version of Oracle A workspace is a virtual private database allowing multiple users to work within the same Oracle
Application Express Application Express installation while keeping their objects, data and applications private. Each
Create a Workspace and workspace has a unique ID and name.
Add Oracle Application
Express Users An instance administrator can create a workspace manually within Oracle Application Express
Creating a Workspace
Administration Services or have users submit requests. Oracle Application Express Administration
Manually
Creating Oracle Services is a separate application for managing an entire Oracle Application Express instance. See
Application Express "Creating Workspaces" and "Managing Workspace Requests" in Oracle Application Express
Users Administration Guide.
Logging in to Your
Hide Navigation See Also:
Oracle Database 2 Day + Oracle Application Express Developer's Guide if you
are new to Oracle Application Express
This Book Entire Library

Quick Lookup
Topics:
Home Master Index Master
Glossary Master Book List
Creating a Workspace Manually
Advanced Search
Creating Oracle Application Express Users
Main Categories Logging in to Your Workspace
Security

This Page 3.5.11.1 Creating a Workspace Manually


Recommended
Pre-installation Tasks To create an Oracle Application Express workspace manually:
Choosing a Web Listener
Downloading from OTN and 1. Log in to Oracle Application Express Administration Services. Oracle Application Express
Configuring Oracle
Application Express Listener Administration Services is a separate application for managing an entire Oracle Application
Install the Oracle Express instance. You log in using the ADMIN account and password created or reset during the
Database and Complete installation process.
Pre-installation Tasks
Download and Install a. In a Web browser, navigate to the Oracle Application Express Administration Services
Oracle Application application.
Express
Change the Password for Because your setup uses Apache and mod_plsql, go to:
the ADMIN Account
Restart Processes
http://hostname:port/pls/apex/apex_admin
Configure
APEX_PUBLIC_USER
Account Where:
Unlocking the
APEX_PUBLIC_USER hostname is the name of the system where Oracle HTTP Server is installed.
Account
Changing the Password port is the port number assigned to Oracle HTTP Server. In a default installation, this
for the number is 7777.
APEX_PUBLIC_USER
Account pls is the indicator to use the mod_plsql cartridge.
Download and Install
Oracle Application apex is the database access descriptor (DAD) defined in the mod_plsql configuration file.
Express Listener
Disabling Oracle XML b. On the Login page:
DB Protocol Server
Configure RESTful In Username, enter admin.
Services
Enable Network Services
In Password, enter the Oracle Application Express administrator account password
in Oracle Database 11g
Granting Connect you specified in "Change the Password for the ADMIN Account".
Privileges
Troubleshooting an Click Login to Administration.
Invalid ACL Error
Security Considerations
About Managing See Also:
JOB_QUEUE_PROCESSES See "Logging in to Oracle Application Express Administration Services" in
Viewing the Number of Oracle Application Express Administration Guide.
JOB_QUEUE_PROCESSES
Changing the Number
of
JOB_QUEUE_PROCESSES Next, create a workspace.
About Developing Oracle
Application Express in 2. Click Manage Workspaces.
Other Languages
Installing a Translated 3. Under Workspace Actions, click Create Workspace.
Version of Oracle
Application Express The Create Workspace Wizard appears.
Create a Workspace and
Add Oracle Application 4. For Identify Workspace, enter the following:
Express Users
Creating a Workspace a. Workspace Name - Enter a unique workspace name.
Manually
Creating Oracle b. Workspace ID - Leave Workspace ID blank to have the new Workspace ID automatically
Application Express generated. A Workspace ID must be a positive integer greater than 100000.
Users
Logging in to Your
Hide Navigation c. Workspace Description - Enter a workspace description.

d. Click Next.

This Book Entire Library 5. For Identify Schema, specify whether you are re-using an existing schema or creating a new
Quick Lookup one.
Home Master Index Master
Glossary Master Book List If you are using an existing schema:
Advanced Search
a. For Re-use existing schema, select Yes.
Main Categories b. Select a schema from the list.
Security c. Click Next.
This Page
If you are creating a new schema:
Recommended
Pre-installation Tasks
a. For Re-use existing schema, select No.
Choosing a Web Listener
Downloading from OTN and b. Enter a schema name and password.
Configuring Oracle c. Specify a space quota.
Application Express Listener d. Click Next.
Install the Oracle
Database and Complete 6. For Identify Administrator, enter the Workspace administrator information and click Next.
Pre-installation Tasks
Download and Install 7. Confirm your selections and click Create Workspace.
Oracle Application
Express
Change the Password for 3.5.11.2 Creating Oracle Application Express Users
the ADMIN Account
Restart Processes
To create an Oracle Application Express user account:
Configure
APEX_PUBLIC_USER
1. Log in to Oracle Application Express Administration Services as described in the previous section.
Account
Unlocking the See "Logging in to Oracle Application Express Administration Services" in Oracle Application
APEX_PUBLIC_USER Express Administration Guide.
Account
Changing the Password 2. Click the Manage Workspaces icon.
for the
APEX_PUBLIC_USER The Administration page appears.
Account
Download and Install 3. Click Manage Developers and Users.
Oracle Application
Express Listener 4. Click Create User.
Disabling Oracle XML
DB Protocol Server The Create User page appears.
Configure RESTful
Services 5. Under User Attributes, enter:
Enable Network Services
in Oracle Database 11g a. Username - Enter the username used to log in to the system. Restrictions include:
Granting Connect
Privileges Maximum length of 100 characters
Troubleshooting an
No spaces
Invalid ACL Error
Security Considerations Only these special characters are permitted: ampersand (@) and period (.)
About Managing
JOB_QUEUE_PROCESSES b. Email Address - Enter the valid email address for this user.
Viewing the Number of
JOB_QUEUE_PROCESSES c. First Name - Enter the first or given name to further identify the user.
Changing the Number
of d. Last Name - Enter the last or family name to further identify the user.
JOB_QUEUE_PROCESSES
About Developing Oracle e. Description - Enter comments about this user.
Application Express in
Other Languages f. Default Date Format - Enter the default Oracle date format for the user. This controls
Installing a Translated the default date format within SQL Workshop.
Version of Oracle
Application Express 6. Under Account Privileges:
Create a Workspace and
Add Oracle Application a. Workspace - Select a workspace from the list.
Express Users
Creating a Workspace b. Default Schemas - Specify the default schema used for data browsing, application
Manually
creation, and SQL script execution.
Creating Oracle
Application Express
When using workspaces that have more than one schema available, this schema is the
Users
Logging in to Your
Hide Navigation default. This setting does not control security, only the user's preference.

c. User is a workspace administrator - Specify if this user should have workspace


administrator privileges.
This Book Entire Library

Quick Lookup Administrators are given access to all components. Additionally, they can manage user
Home Master Index Master accounts, groups, and development services. Components may not be available if they are
Glossary Master Book List switched off by Instance Administrators.
Advanced Search
d. User is a developer - Specify if this user should have developer privileges.
Main Categories
Security Developers must have access to either Application Builder, SQL Workshop, or both. These
This Page components may not be available if they are switched off by the Instance Administrator.
Recommended
Pre-installation Tasks e. Application Builder Access - Determines whether a developer has access to the
Choosing a Web Listener Application Builder.
Downloading from OTN and
Configuring Oracle f. SQL Workshop Access - Determines whether a developer has access to the SQL
Application Express Listener Workshop.
Install the Oracle
Database and Complete g. Team Development Access - Determines whether a developer has access to the Team
Pre-installation Tasks
Development.
Download and Install
Oracle Application
h. Set Account Availability - Select Locked to prevent the account from being used.
Express
Change the Password for Select Unlocked to allow the account to be used.
the ADMIN Account
Restart Processes If the user has exceeded the maximum login failures allowed, specified in Workspace
Configure Preferences, then their account will be locked automatically.
APEX_PUBLIC_USER
Account 7. Under Password:
Unlocking the
APEX_PUBLIC_USER Password - Enter a case sensitive password.
Account
Changing the Password Confirm Password - Enter the password again.
for the
APEX_PUBLIC_USER Require Change of Password On First Use - Select No to allow the user to use the
Account same password until it expires. Select Yes to require the user to change the password
Download and Install
Oracle Application immediately when logging in the first time.
Express Listener
Disabling Oracle XML 8. Click Create User or Create and Create Another.
DB Protocol Server
Configure RESTful 3.5.11.3 Logging in to Your Workspace
Services
Enable Network Services
in Oracle Database 11g Once you create a workspace, you must log in to it using your login credentials (that is, the workspace
Granting Connect name, user name, and password).
Privileges
Troubleshooting an
Invalid ACL Error See Also:
Security Considerations
See "Creating Workspaces" and "Managing Workspace Requests" in Oracle
About Managing
JOB_QUEUE_PROCESSES Application Express Administration Guide
Viewing the Number of
JOB_QUEUE_PROCESSES
Changing the Number To log in to your workspace:
of
JOB_QUEUE_PROCESSES 1. In a Web browser, navigate to the Oracle Application Express Login page.
About Developing Oracle
Application Express in Because your setup uses the HTTP server, go to:
Other Languages
Installing a Translated http://hostname:port/pls/apex/
Version of Oracle
Application Express
Where:
Create a Workspace and
Add Oracle Application
hostname is the name of the system where Oracle HTTP Server is installed.
Express Users
Creating a Workspace
port is the port number assigned to the Oracle HTTP Server. In a default installation, this
Manually
Creating Oracle number is 7777.
Application Express
Users pls is the indicator to use the mod_plsql cartridge.
Logging in to Your
Hide Navigation apex is the database access descriptor (DAD) defined in the configuration file.

For users who have upgraded from earlier releases, or who have a custom configuration,
this value may be htmldb or something else. Verify your DAD with your Oracle Application
This Book Entire Library
Express administrator.
Quick Lookup
Home Master Index Master The Login page appears.
Glossary Master Book List
Advanced Search 2. Under Login, enter the following:

Main Categories Workspace field - Enter the name of your workspace.


Security
Username field - Enter your user name.
This Page Password field - Enter your case-sensitive password.
Recommended
Pre-installation Tasks 3. Click Login.
Choosing a Web Listener
Downloading from OTN and Note that, depending on your setup, you might be required to change your password when you
Configuring Oracle log in for the first time.
Application Express Listener
Install the Oracle
Database and Complete 3.6 Post Installation Tasks for Upgrade Installations
Pre-installation Tasks
Download and Install Once you have verified that your upgrade installation was successful and all upgraded applications
Oracle Application function properly, you should remove schemas from prior Oracle Application Express installations.
Express
Change the Password for Topics:
the ADMIN Account
Restart Processes Remove Prior Oracle Application Express Installations
Configure Fix Invalid ACL in Oracle Database 11g
APEX_PUBLIC_USER
Account
Unlocking the 3.6.1 Remove Prior Oracle Application Express Installations
APEX_PUBLIC_USER
Account The database users associated with schemas from prior installations are privileged users and should
Changing the Password
be removed when they are no longer necessary. Removing schemas from a prior installation is a two
for the
APEX_PUBLIC_USER step process. First you verify if a prior installation exists and then you remove the schemas.
Account
Download and Install 3.6.1.1 Verify if a Prior Installation Exists
Oracle Application
Express Listener
Disabling Oracle XML To verify if a prior installation exists:
DB Protocol Server
Configure RESTful 1. Start SQL*Plus and connect to the database where Oracle Application Express is installed as
Services SYS. For example:
Enable Network Services
in Oracle Database 11g On Windows:
Granting Connect
Privileges SYSTEM_DRIVE:\ sqlplus /nolog
Troubleshooting an SQL> CONNECT SYS as SYSDBA
Invalid ACL Error
Enter password: SYS_password
Security Considerations
About Managing
JOB_QUEUE_PROCESSES On UNIX and Linux:
Viewing the Number of
$ sqlplus /nolog
JOB_QUEUE_PROCESSES
Changing the Number SQL> CONNECT SYS as SYSDBA
of Enter password: SYS_password
JOB_QUEUE_PROCESSES
About Developing Oracle 2. Run the following query:
Application Express in
Other Languages SELECT username
Installing a Translated FROM dba_users
Version of Oracle WHERE (username LIKE 'FLOWS_%' OR USERNAME LIKE 'APEX_%')
Application Express
AND USERNAME NOT IN (
Create a Workspace and
SELECT 'FLOWS_FILES'
Add Oracle Application
Express Users FROM DUAL
Creating a Workspace UNION
Manually SELECT 'APEX_PUBLIC_USER' FROM DUAL
Creating Oracle UNION
Application Express SELECT SCHEMA s
Users
Logging in to Your
FROM dba_registry
Hide Navigation
WHERE comp_id = 'APEX');

If the results contain entries in the form FLOWS_XXXXXX or APEX_XXXXXX where XXXXXX represents six
This Book Entire Library
numbers, those entries are candidates for removal.
Quick Lookup
Home Master Index Master
Glossary Master Book List
3.6.1.2 Remove Schemas from Prior Installations
Advanced Search
To remove schemas from prior installations:
Main Categories
Security 1. Start SQL*Plus and connect to the database where Oracle Application Express is installed as SYS
This Page specifying the SYSDBA role. For example:
Recommended
Pre-installation Tasks On Windows:
Choosing a Web Listener
Downloading from OTN and SYSTEM_DRIVE:\ sqlplus /nolog
Configuring Oracle SQL> CONNECT SYS as SYSDBA
Application Express Listener Enter password: SYS_password
Install the Oracle
Database and Complete On UNIX and Linux:
Pre-installation Tasks
Download and Install $ sqlplus /nolog
Oracle Application SQL> CONNECT SYS as SYSDBA
Express Enter password: SYS_password
Change the Password for
the ADMIN Account
Restart Processes 2. Execute a statement similar to the following example:
Configure
APEX_PUBLIC_USER DROP USER FLOWS_030000 CASCADE;
Account
Unlocking the
APEX_PUBLIC_USER
3.6.2 Fix Invalid ACL in Oracle Database 11g
Account
Changing the Password After following the instructions in"Remove Prior Oracle Application Express Installations", you may
for the need to fix an invalid ACL if you are running Oracle Database 11g and you enabled network services
APEX_PUBLIC_USER for the prior Oracle Application Express schema.
Account
Download and Install To fix an invalid ACL:
Oracle Application
Express Listener 1. Change your working directory to the apex directory where you unzipped the installation
Disabling Oracle XML
software.
DB Protocol Server
Configure RESTful
2. Start SQL*Plus and connect to the database where Oracle Application Express is installed as SYS
Services
Enable Network Services specifying the SYSDBA role. For example:
in Oracle Database 11g
Granting Connect On Windows:
Privileges
Troubleshooting an SYSTEM_DRIVE:\ sqlplus /nolog
Invalid ACL Error SQL> CONNECT SYS as SYSDBA
Security Considerations Enter password: SYS_password
About Managing
JOB_QUEUE_PROCESSES On UNIX and Linux:
Viewing the Number of
JOB_QUEUE_PROCESSES $ sqlplus /nolog
Changing the Number SQL> CONNECT SYS as SYSDBA
of
Enter password: SYS_password
JOB_QUEUE_PROCESSES
About Developing Oracle
Application Express in 3. Execute a statement similar to following:
Other Languages
Installing a Translated EXEC DBMS_NETWORK_ACL_ADMIN.DELETE_PRIVILEGE('power_users.xml', 'FLOWS_030000');
Version of Oracle
Application Express
Create a Workspace and
3.7 Performance Optimization Tasks
Add Oracle Application
Express Users Performance of web applications heavily depend on their size and how often a browser has to request
Creating a Workspace static content like images, CSS and JavaScript files. To improve performance, most web servers allow
Manually you to enable on-the-fly file compression and settings on how long browsers can cache a file. Please
Creating Oracle
see your web server manual on how to enable gzip compression and setting the expired header
Application Express
Users attribute for optimal performance of your Application Express application.
Logging in to Your
Hide Navigation 3.8 About the Oracle Application Express Runtime
Environment
This Book Entire Library The Oracle Application Express runtime environment enables users to run a production application
Quick Lookup without supporting the ability to change or edit the application. It includes only the packages necessary
Home Master Index Master to run your applications, making it a more hardened environment. It does not provide a Web interface
Glossary Master Book List for administration.
Advanced Search
You administer the Oracle Application Express runtime environment using SQL*Plus or SQL Developer
Main Categories
and the APEX_INSTANCE_ADMIN API. To learn more see, "Managing a Runtime Environment" and in
Security
Oracle Application Express Application Builder User's Guide.
This Page
Recommended Topics:
Pre-installation Tasks
Choosing a Web Listener Converting a Runtime Environment to a Full Development Environment
Downloading from OTN and Converting a Full Development Environment to a Runtime Environment
Configuring Oracle
Application Express Listener
Install the Oracle 3.8.1 Converting a Runtime Environment to a Full Development
Database and Complete Environment
Pre-installation Tasks
Download and Install To convert an Oracle Application Express runtime environment to a full development environment:
Oracle Application
Express 1. Change your working directory to the apex directory where you unzipped the installation
Change the Password for
the ADMIN Account software.
Restart Processes
Configure 2. Start SQL*Plus and connect to the database where Oracle Application Express is installed as SYS
APEX_PUBLIC_USER specifying the SYSDBA role. For example:
Account
Unlocking the On Windows:
APEX_PUBLIC_USER
Account SYSTEM_DRIVE:\ sqlplus /nolog
Changing the Password SQL> CONNECT SYS as SYSDBA
for the Enter password: SYS_password
APEX_PUBLIC_USER
Account
On UNIX and Linux:
Download and Install
Oracle Application
$ sqlplus /nolog
Express Listener
SQL> CONNECT SYS as SYSDBA
Disabling Oracle XML
DB Protocol Server Enter password: SYS_password
Configure RESTful
Services 3. Run apxdvins.sql. For example:
Enable Network Services
in Oracle Database 11g @apxdvins.sql
Granting Connect
Privileges 4. Follow the instructions in "Change the Password for the ADMIN Account".
Troubleshooting an
Invalid ACL Error
Security Considerations
See Also:
About Managing
JOB_QUEUE_PROCESSES Oracle Database PL/SQL Language Reference for more information about
Viewing the Number of SQL*Plus
JOB_QUEUE_PROCESSES
Changing the Number
of
JOB_QUEUE_PROCESSES
3.8.2 Converting a Full Development Environment to a Runtime
About Developing Oracle Environment
Application Express in
Other Languages Export all Websheet applications prior to converting a full development environment to a runtime
Installing a Translated environment. When you convert a development environment to runtime, existing Websheet data grids
Version of Oracle
and reports will be deleted from all workspaces. Converting the environment back to a full
Application Express
Create a Workspace and development environment will not restore these Websheet data grids or reports.
Add Oracle Application
Express Users To convert an Oracle Application Express full development environment to a runtime environment:
Creating a Workspace
Manually 1. Change your working directory to the apex directory where you unzipped the installation
Creating Oracle software.
Application Express
Users 2. Start SQL*Plus and connect to the database where Oracle Application Express is installed as SYS
Logging in to Your
Hide Navigation specifying the SYSDBA role. For example:

On Windows:

This Book Entire Library SYSTEM_DRIVE:\ sqlplus /nolog


SQL> CONNECT SYS as SYSDBA
Quick Lookup
Home Master Index Master Enter password: SYS_password
Glossary Master Book List
Advanced Search On UNIX and Linux:

Main Categories $ sqlplus /nolog


Security SQL> CONNECT SYS as SYSDBA
Enter password: SYS_password
This Page
Recommended
Pre-installation Tasks 3. Run apxdevrm.sql. For example:
Choosing a Web Listener
Downloading from OTN and @apxdevrm.sql
Configuring Oracle
Application Express Listener
Install the Oracle See Also:
Database and Complete Oracle Database PL/SQL Language Reference for more information about
Pre-installation Tasks
Download and Install SQL*Plus
Oracle Application
Express
Change the Password for Reader Comment
the ADMIN Account
Restart Processes subject
Configure
from abdallahkonare@hotmail.com Anonymous
APEX_PUBLIC_USER
Account
Unlocking the
APEX_PUBLIC_USER
Account
Changing the Password
for the
APEX_PUBLIC_USER
Account
Download and Install
Oracle Application Comments, corrections, and suggestions are forwarded to authors every week. By submitting, you
Express Listener confirm you agree to the terms and conditions. Use the OTN forums for product questions. For
Disabling Oracle XML support or consulting, file a service request through My Oracle Support.
DB Protocol Server
Configure RESTful
Services
Enable Network Services
in Oracle Database 11g
Copyright 2003,
Granting Connect Previous Up Next Home Book Contents Index Master Contact
2013, Oracle and/or its affiliates. All rights reserved.
Privileges Legal Notices List Index
Troubleshooting an
Invalid ACL Error
Security Considerations
About Managing
JOB_QUEUE_PROCESSES
Viewing the Number of
JOB_QUEUE_PROCESSES
Changing the Number
of
JOB_QUEUE_PROCESSES
About Developing Oracle
Application Express in
Other Languages
Installing a Translated
Version of Oracle
Application Express
Create a Workspace and
Add Oracle Application
Express Users
Creating a Workspace
Manually
Creating Oracle
Application Express
Users
Logging in to Your