6.3 Downloading and Installing APEX
Learn about downloading and installing Oracle APEX.
How you install Oracle APEX depends upon by the type of database into which you are installing. This chapter describes how to download and install Oracle APEX in self-managed databases, such as your laptop or your data center, or co-managed Cloud databases such as Database Cloud Service (DBaaS) and Exadata Cloud Service.
Tip:
In fully managed Cloud databases, such as an Autonomous Database or Oracle APEX Application Development (APEX Service), APEX is pre-installed and pre-configured, so you may skip the steps listed in this chapter. To learn more, refer to the documentation for your service.- Installing APEX
Install Oracle APEX by downloading a ZIP file from the APEX download page. - Creating or Updating Your Instance Administration Account
Learn how to create or update Instance Administrator account. - Restarting Processes
Restart the processes that you stopped before you began the installation. - Configuring the APEX_PUBLIC_USER Account
It is important to correctly configure theAPEX_PUBLIC_USER
account to enable proper operation of Oracle APEX. - Configuring the APEX_PUBLIC_ROUTER Account
The APEX_PUBLIC_ROUTER account is a minimally privileged account used for an ORDS REST module to resolve friendly URLs.
See Also:
- Welcome to Oracle APEX Application Development Service in Getting Started with Oracle APEX Application Development
- Creating Applications with Oracle Application Express on Autonomous Database in Using Oracle Autonomous Database Serverless
- Utilizing Multitenant Architecture
6.3.1 Installing APEX
Install Oracle APEX by downloading a ZIP file from the APEX download page.
Tip:
APEX must be installed from a writable directory on the file system. See Reviewing a Log of an Installation Session.To install APEX:
When APEX installs, it creates the following database accounts:
APEX_240100
- This account owns the APEX schema and metadata.FLOWS_FILES
- This account owns the APEX uploaded files.APEX_PUBLIC_USER
- This minimally privileged account is used by Oracle REST Data Services (ORDS) to invoke APEX engine. This account must remain unlocked.APEX_PUBLIC_ROUTER
- This minimally privileged account is used for an ORDS REST module to resolve friendly URLs. This is a schema-only account without a password and it must remain unlocked.
If you configured RESTful Web services, then these additional accounts will be created:
APEX_REST_PUBLIC_USER
- The account used when invoking RESTful Services definitions stored in APEX.APEX_LISTENER
- The account used to query RESTful Services definitions stored in APEX.
If you are upgrading from a previous release, then FLOWS_FILES
, APEX_PUBLIC_USER
, and APEX_PUBLIC_ROUTER
database accounts may already exist.
See Also:
- About the APEX Runtime Environment
- Configuring Password Protection in Oracle Database Security Guide
- Working with SQLcl in Oracle SQLcl User’s Guide
Parent topic: Downloading and Installing APEX
6.3.2 Creating or Updating Your Instance Administration Account
Learn how to create or update Instance Administrator account.
This section describes how to create or update your Instance Administrator account.
Tip:
Skip this section if you are upgrading from a previous release of Oracle APEX. In an upgrade scenario, the Instance Administrator account and password is preserved and carried over from the prior release.
- What Is an Instance Administrator?
Instance administrators are superusers that are responsible for managing an entire Oracle APEX instance, including managing workspace provisioning, configuring features and instance settings, and managing security. - About apxchpwd.sql
Running theapxchpwd.sql
script enables you to create or update your Instance Administrator account. - Running apxchpwd.sql
Run theapxchpwd.sql
script to create and update your Instance Administrator account.
Parent topic: Downloading and Installing APEX
6.3.2.1 What Is an Instance Administrator?
Instance administrators are superusers that are responsible for managing an entire Oracle APEX instance, including managing workspace provisioning, configuring features and instance settings, and managing security.
To perform these tasks, an Instance administrator signs in to the Oracle APEX Administration Services application.
See Also:
Oracle APEX Administration Services in Oracle APEX Administration Guide
6.3.2.2 About apxchpwd.sql
Running the apxchpwd.sql
script enables you to create or update your Instance Administrator account.
Note:
Theapxchpwd.sql
script is not supported on Oracle Autonomous Database
Serverless and Oracle APEX Application
Development (APEX Service).
You must run the apxchpwd.sql
script in the following
scenarios:
- New Oracle APEX installations - Run
apxchpwd.sql
to create an Instance Administrator account and password. - Converting of a runtime environment to a development environment - Run
apxchpwd.sql
to change the Instance Administrator account password. - Changing Your Instance Administrator Password -Run
apxchpwd.sql
to change the password for an existing Instance Administrator account. - Unlocking Your Instance Administrator Account - Run
apxchpwd.sql
to unlock an existing Instance Administrator account.
Tip:
You do not need to run apxchpwd.sql
when upgrading from a
previous release of Oracle APEX. In an upgrade scenario, the Instance Administrator account password is preserved and
carried over from the prior release.
6.3.3 Restarting Processes
Restart the processes that you stopped before you began the installation.
After you install Oracle APEX, you must restart the processes that you stopped before you began the installation.
Parent topic: Downloading and Installing APEX
6.3.4 Configuring the APEX_PUBLIC_USER Account
It is important to correctly configure the APEX_PUBLIC_USER
account to enable proper operation of Oracle APEX.
- About the APEX_PUBLIC_USER Account
TheAPEX_PUBLIC_USER
account is created with a random password in a new installation of Oracle APEX. - Unlocking the APEX_PUBLIC_USER Account
Unlock theAPEX_PUBLIC_USER
account by running a SQL statement. - Changing the Password for the APEX_PUBLIC_USER Account
Change the password for theAPEX_PUBLIC_USER
account by running a SQL statement. - About Password Expiration in Oracle Database
You can setPASSWORD_LIFE_TIME
parameter to unlimited by alteringAPEX_PUBLIC_USER
to prevent password expiration. To do this create another profile in which thePASSWORD_LIFE_TIME
parameter is set to unlimited and alter theAPEX_PUBLIC_USER
account and assign it to the new profile.
Parent topic: Downloading and Installing APEX
6.3.4.1 About the APEX_PUBLIC_USER Account
The APEX_PUBLIC_USER
account is created with a random
password in a new installation of Oracle APEX.
You must change the password for this account before configuring the database access descriptor (DAD) in a new installation.
Parent topic: Configuring the APEX_PUBLIC_USER Account
6.3.4.2 Unlocking the APEX_PUBLIC_USER Account
Unlock the APEX_PUBLIC_USER
account by running a SQL statement.
Tip:
If you are upgrading from a prior release of Oracle APEX, this step is unnecessary.
To unlock the APEX_PUBLIC_USER
account:
Parent topic: Configuring the APEX_PUBLIC_USER Account
6.3.4.3 Changing the Password for the APEX_PUBLIC_USER Account
Change the password for the APEX_PUBLIC_USER
account by running a SQL statement.
Tip:
If you are upgrading from a prior release of Oracle APEX, this step is unnecessary.
To change the password for the APEX_PUBLIC_USER
account:
Parent topic: Configuring the APEX_PUBLIC_USER Account
6.3.4.4 About Password Expiration in Oracle Database
You can set PASSWORD_LIFE_TIME
parameter to unlimited by altering APEX_PUBLIC_USER
to prevent password expiration. To do this create another profile in which the PASSWORD_LIFE_TIME
parameter is set to unlimited and alter the APEX_PUBLIC_USER
account and assign it to the new profile.
In the default profile in Oracle
Database, the parameter PASSWORD_LIFE_TIME
is set to 180. If you are using Oracle
Database with Oracle APEX, this causes the password for APEX_PUBLIC_USER
to expire in 180 days. As a result, your APEX instance will become unusable until you change the password.
See Also:
Oracle Database Security Guide for information on creating profiles and assigning them to database users
Parent topic: Configuring the APEX_PUBLIC_USER Account
6.3.5 Configuring the APEX_PUBLIC_ROUTER Account
The APEX_PUBLIC_ROUTER account is a minimally privileged account used for an ORDS REST module to resolve friendly URLs.
About Sessions Per User in Oracle Database
On highly active systems, APEX_PUBLIC_ROUTER may reach the maximum number of sessions allowed in the database which results in a "Service Unavailable HTTP 503" error. You can set the SESSIONS_PER_USER
parameter to "unlimited" by modifying APEX_PUBLIC_ROUTER to remove limit on the maximum number of sessions.
Create another profile in which the SESSIONS_PER_USER
parameter is set to "unlimited" and modify the APEX_PUBLIC_ROUTER account and assign it to the new profile.
This behavior differs depending on your version of Oracle REST Data
Services (ORDS). For ORDS 24.x and later, all GET requests that reference the /r/
path use an ORDS REST module.
If ORDS was updated after Oracle APEX, you must run sys.validate_apex
.
After each ORDS upgrade or if ORDS is installed after APEX is installed, you must run the following as sys
:
-- Run as SYS
set serveroutput on
begin
sys.validate_apex;
end;
/
See Also:
- DBA_PROFILES in Oracle Database Reference
Parent topic: Downloading and Installing APEX