APEX Install/Upgrade

The steps on this page have been tested with APEX 21.2. Check the installation Guide and Release Notes for later versions before continuing.

Assumptions

XML DB is assumed to be installed

Preparation

  • WORKAREA_SIZE_POLICY should be AUTO and MEMORY_TARGET should be at least 300M.

  • If you are following best practice and NOT using AMM, but you are using ASMM and APMM then the sum of SGA_TARGET and PGA_AGGREGATE_TARGET should be at least 300M.

export APXVER=21.2
mkdir -p /u01/img/apex/${APXVER}

  • Download to /u01/img/apex

unzip /u01/img/apex/apex_${APXVER}.zip -d /u01/img/apex/${APXVER}
rm
/u01/img/apex/apex_${APXVER}.zip

  • Create a Guaranteed Restore Point (or ensure you have another method to backout if necessary).

CREATE RESTORE POINT apexupgrade GUARANTEE FLASHBACK DATABASE;

DataPump is not recommended for backing up the APEX schema and FLOWS_FILES as this does not work under 12.1.0.2 and aboveSee: 1912162.1
  • You will need a version of ORDS, either Standalone or via Tomcat (or WebLogic). If this is your first APEX/ORDS implementation it is probably easier to install APEX before ORDS as the ORDS installation will prompt for details of an APEX installation to connect to.

  • If this is an Upgrade then temporarily prevent access to APEX (i.e. shutdown ORDS).


Prior to APEX 20.2, OHS or the Embeded PL/SQL Gateway were also options... see here for notes
ORDS can be installed before or after APEX.

Installation

If the first or second digit of the version will change as a result of this upgrade (e.g. 4.1 to 4.2) then you need a full install of APEX. If only the third digit will change (e.g. 4.2.2 to 4.2.6) then you just need a patch...

export APXVER=21.2

This should match the version number in your download location path (e.g. for /u01/img/apex/18.1 APXVER is 18.1)

cd /u01/img/apex/${APXVER}/apex

sqlplus / as sysdba

@apexins.sql SYSAUX SYSAUX TEMP /i/

If you want APEX to live in a different tablespace update the tablespace names accordingly.The tablespace names relate to "apex", "files", and "temp" segment storage.Homing APEX in SYSAUX is generally appropriate.This usually takes approximately 15 minutes to complete.

Patch

To apply a Patch instead of running the full install...

cd /u01/img/apex/${APXVER}/patch

sqlplus / as sysdba @apxpatch.sql

Review apxpatch.log for errors

First-time install only

You can skip these steps if you are upgrading an existing APEX installation...

@apxchpwd.sql

Consider using a non-default administrator username.

Set the Profile for APEX_PUBLIC_USER to prevent password expiration, unlock the acccount and change the password...

ALTER USER APEX_PUBLIC_USER PROFILE myNoExpireProfile;

ALTER USER APEX_PUBLIC_USER ACCOUNT UNLOCK;

ALTER USER APEX_PUBLIC_USER IDENTIFIED BY "Password";

Configure RESTful Services

@apex_rest_config.sql

Copy Images

Images need to be copied for initial installation and upgrades. This steps is different for Standalone, Tomcat and Weblogic.

Post-Install

  • Remember to drop any Guaranteed Restore Point (be sure you don't need to backout first)

  • Start ORDS if necessary

Backout

Bibliography


https://apex.oracle.com/en/
https://www.oracle.com/tools/downloads/apex-downloads.html
https://blogs.oracle.com/apex/post/on-premises-apex-installations-in-oracle-database-21c-and-beyondhttps://oracle-base.com/articles/misc/oracle-application-express-apex-installationhttps://mikedietrichde.com/2017/05/02/is-your-apex-version-certified-with-your-database-release/https://emarcel.com/deploying-apex-database-12c/
Master Note for Oracle Application Express (APEX) Upgrades (Doc ID 1088970.1)Application Express (APEX) Database and Web Server Certification Reference (Doc ID 1344948.1)12.1.0.1 EXPDP Does Not Export APEX Schema (Doc ID 1912162.1)
http://dgielis.blogspot.com/2015/01/preparing-architecture-for-apex-50.html (Running different versions in different PDBs using ORDS) http://dgielis.blogspot.com/2016/05/please-use-https-for-your-apex-apps.html
Static File Supporthttps://docs.oracle.com/cd/E59726_01/install.50/e39144/http_server.htm#HTMIG29474
22https://blogs.oracle.com/apex/post/announcing-oracle-apex-222https://blogs.oracle.com/apex/post/announcing-oracle-apex-221
21.2https://blogs.oracle.com/apex/post/announcing-oracle-apex-212https://apex.oracle.com/en/platform/features/whats-new-212/https://docs.oracle.com/en/database/oracle/application-express/21.2/htmrn/index.html (Release Notes)https://docs.oracle.com/en/database/oracle/application-express/21.2/htmig/index.html (Iinstallation Guide)
20.2https://www.oracle-and-apex.com/differences-between-apex-20-1-and-20-2/
Application Express Installation Guidehttps://docs.oracle.com/database/121/HTMIG/toc.htm (Release 12.1)https://docs.oracle.com/cd/E59726_01/install.50/e39144/listener.htm (Release 5: Installing Application Express and Configuring Oracle REST Data Services)https://docs.oracle.com/cd/E37097_01/install.42/e35123/overview.htm (Release 4.2)
OHShttps://docs.oracle.com/database/apex-18.1/HTMIG/Installing-AE-and-configuring-LWL-Oracle-HTTP-Server.htm