Professional Documents
Culture Documents
Release 4.2
Part Number E35123-05 Home Book Contents Index Master Contact
List Index Us
Previous Up Next
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:
Note:
Within the context of this document, the Apache Oracle home directory
(ORACLE_HTTPSERVER_HOME) is the location where Oracle HTTP Server is
installed.
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.
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
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:
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 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:
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.
Note that the actual file name may differ if a more recent release has shipped since this
This Book Entire Library document was published.
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
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
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:
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
Topics:
This Book Entire Library
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
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.
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.
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".
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.
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
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
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
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
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.
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:
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: