Quick and Easy APEX and ORDS Installation for Oracle Database 23c Developer Release on OCI
5 min read
Are you ready to take your Oracle Database 23c experience to the next level?
In this article, we'll guide you through the simple steps to install APEX and ORDS for Oracle Database 23c on Oracle Linux 8 in the Oracle Cloud Infrastructure (OCI). With these powerful tools, you'll be able to unlock the full potential of your database and explore the amazing world of APEX and SQL-Developer Web. So let's get started!
Prerequisites for Installing ORDS and APEX
In order to successfully install ORDS (Oracle REST Data Services) and APEX (Oracle Application Express) for Oracle Database 23c on Oracle Linux 8 within the Oracle Cloud Infrastructure (OCI), it is essential to have a Compute instance running with a fully operational Oracle Database. If you haven't already configured this setup, we've got you covered with a comprehensive guide on how to accomplish this task. Just follow the link provided here to read the step-by-step process and get your Oracle Database up and running on a Compute instance within OCI.
Install Oracle APEX
In this section, we will guide you through the process of setting up Oracle Application Express (APEX). So, let's dive into the process of installing Oracle APEX.
First, log in to your compute instance using your preferred method, whether it be through a remote desktop connection or a terminal. Once you have successfully accessed your instance, download the latest Oracle APEX package by running the following command:
cd /home/oracle/ wget https://download.oracle.com/otn_software/apex/apex-latest.zip
Next, extract the downloaded package using the following command:
Navigate to the extracted
apex directory by executing the following command:
Connect to your Oracle Database as a
sysdba user by executing the command below:
sqlplus sys@localhost:1521/FREEPDB1 as sysdba
Note: It's recommended to install APEX in a pluggable database!
apexins.sql script to install Oracle APEX using the following command:
@apexins.sql SYSAUX SYSAUX TEMP /i/
apxchpwd.sql script to change the APEX administrator password:
APEX_PUBLIC_USER account and set a new password using the following commands:
ALTER USER APEX_PUBLIC_USER ACCOUNT UNLOCK; ALTER USER APEX_PUBLIC_USER IDENTIFIED BY <password>;
Finally, configure APEX RESTful services by executing the
Congratulations! You have successfully set up Oracle APEX on your OCI Compute instance.
Easy Peasy Installation of ORDS
The Oracle REST Data Services (ORDS) can be found in both the Oracle Linux 7 (OL7) and Oracle Linux 8 (OL8) repositories. As we have already enabled the appropriate repository in our previous blog post, the installation process for ORDS becomes quite straightforward. You can effortlessly install ORDS by using either the
dnf package manager, depending on your system's preference.
First, log in to your compute instance using your preferred method, whether it be through a remote desktop connection or a terminal. Once you have successfully accessed your instance, you will need to switch to the
Optional: Install Java 17
Before proceeding, it's essential to ensure that your system has Java 11 or a higher version installed. If not, install Java using the following commands:
wget https://download.oracle.com/java/17/archive/jdk-17.0.6_linux-x64_bin.rpm yum -y install jdk-17.0.6_linux-x64_bin.rpm
Verify your Java version.
Next, execute the command below, which will initiate the installation process for ORDS.
yum install ords -y
Once the installation is finished, you can begin configuring and using ORDS.
ords --config /etc/ords/config install
You'll be asked a few questions, so just go ahead and answer them. No worries, you can likely press Enter/Return for most of them to accept the default options.
Type of installation >  Enter Database connection type >  Enter Host name > [localhost] Enter Listen port >  Enter Service name > FREEPDB1 Administrator username > sys Password > Default tablespace > [SYSAUX] Enter Temp tablespace > [TEMP] Enter Additional features >  Enter Start ORDS in standalone mode >  Enter Protocol > [HTTP] Enter Port >  Enter Static Resources > /home/oracle/apex/images
ORDS is about to do its magic and take care of the installation tasks for us! Just a heads up, there's going to be quite a bit of scrolling on the screen. But don't worry, when it's all done, we'll have something that looks pretty close to this.
It is recommended to deploy ORDS directly into each PDB in most cases. This way, you can handle your database connection pools one by one. Plus, with PDB-level installs, you can run various ORDS versions in the same CDB or even have different configurations and options enabled. So, in a nutshell, PDB installs provide the most flexibility.
Once everything is complete, start ORDS using the command below.
Setting Up the Firewall
At last, we need to configure the firewall to permit incoming connections. To accomplish this, execute the commands below.
firewall-cmd --permanent --zone=public --add-port=1521/tcp firewall-cmd --permanent --zone=public --add-port=8080/tcp firewall-cmd --reload
Next, we need to update the Ingress Rules for the VCN to allow incoming HTTP traffic. So it is not enough to open the VM's firewall.
The final Test
With the setup now complete, you have the ability to access APEX or SQL-Developer Web by using the Compute instance's IP address, along with the assigned port
Woohoo! Get ready to explore the amazing world of APEX and SQL-Developer Web!
In conclusion, installing ORDS and APEX for Oracle Database 23c on Oracle Linux 8 in OCI is a simple process as long as you have met the prerequisites and followed the steps outlined in this article. By utilizing the
dnf package manager to install ORDS, configuring the firewall to allow incoming connections, and updating the Ingress Rules for the VCN to allow incoming HTTP traffic, you can easily access ORDS and APEX. With these tools at your disposal, you can take your Oracle Database 23c to the next level and unlock its full potential.