Chapter 4 Software Installation
Installation Oracle db23ai, Apex 24.1, JDK 17, ORDS 24.1
(Oracle Rest Database Service)
4.1. Install Oracle Database 23ai
Download Oracle Database 23ai, and copy the download link address from Oracle Database
Free Get Started page.
Figure 4.1 Oracle DB 23ai Installation
After Installation go for Configuration
Figure 4.2 Oracle DB 23ai Configuration command
18 | P a g e
4.2 Oracle DB 23ai Configuration
Figure 4.3 Oracle DB 23ai configuration
Figure 4.4 Oracle DB 23ai Configuration Done
Figure 4.5 sqlplus command not working
When we try to enter in database but the environment variable is not set so
this command is not working so we have to setup the environment
19 | P a g e
Time to set few paths –
Figure 4.6 Going Bash Profile
Add the following lines.
Figure 4.7 Adding Environment Variable
set some environment variable
Our .bash_profile file would look like this.
Figure 4.8 Bash Profile Final look
20 | P a g e
Save and source the profile file.
Figure 4.9 Bash Profile Saving
So far so good, let’s try to connect to database as SYS user. Replace <Your-
SYS-Password> as you had setup during installation.
Figure 4.10 Login in DB with sqlplus
Run a simple select statement.
Figure 4.11 Simple Statement in DB23ai
Running Simple statement in Oracle DB 23ai
21 | P a g e
Create Database User.
Login as an SYS user and create a new Database user; we will use this user
later in our Oracle APEX application
Figure 4.12 User Creation in DB for Apex
If you come across this error message
Figure 4.13 Error during User creation in DB23ai
If this error occurred during user creation then try with Below Image
Create user with c##
Figure 4.14 User Creation in DB for Apex
22 | P a g e
4.3 Oracle Apex 24.1 Installation
Install Oracle APEX
Copy the file download link from Oracle APEX download page.
Figure 4.15 Apex 24.1 Download with Wget
Download Apex 24.1 and unzip it in your personalize directory and start
installation
If you will see this the installation is successfully completed
Figure 4.16 Apex Installation Completed
Apex Installation Completed
23 | P a g e
4.4 Oracle Apex 24.1 Configuration
Figure 4.17 Apex configuration Start
Figure 4.18 Apex Configuration Completed
Figure 4.19 Apex Public User Unlocking
Note: > if you forget to unlock the APEX_PUBLIC_USER you might get
following error, Account is locked 570
Figure 4.20 Error of apex
if you forget to unlock the APEX_PUBLIC_USER you might get following error,
Account is locked 570
24 | P a g e
Set Ora Env
Figure 4.21 Setting Environment Variable for Apex
Configuring RESTful Services and set passwords for
Figure 4.22 Apex Listener User Unlock and password Creation
4.5 Download and Install JDK
Get JDK 17 URL from Java Download page.
Figure 4.23 JDK Download
After Installation we should see
Figure 4.24 JDK Installation Complete
25 | P a g e
4.6 ORDS 24.1(Oracle Rest Database Service) Installation
Install ORDS
Figure 4.25 ORDS Install
Install Ords with yum command and after installation configuration start
4.7 ORDS 24.1(Oracle Rest Database Service) Configuration
Most Important step here is to configure ORDS.
[opc@devdb23ai ~]$ sudo su -
Last login: Mon May 6 17:15:19 GMT 2024 on pts/0
# ords --config /etc/ords/config install
ORDS: Release 24.1 Production on Mon May 06 18:43:46 2024
Copyright (c) 2010, 2024, Oracle.
Configuration:
/etc/ords/config
...
Enter a number to select the TNS net service name to use or specify the
database connection
[1] FREE SERVICE_NAME=FREE
[S] Specify the database connection
Choose [1]: 1
...
Provide database username with administrator privileges.
Enter the administrator username: SYS
26 | P a g e
Enter the database password for SYS AS SYSDBA: *****
....
PDB FREEPDB1 - install ORDS 24.1.0.r1080942
PDB FREEPDB1 - configure PL/SQL gateway user APEX_PUBLIC_USER in
ORDS version 24.1.0.r1080942
...
Install ORDS in the database
[1] Yes
[2] No
Choose [1]: 1
...
Enter a number to update the value or select option A to Accept and Continue
[1] Connection Type: TNS
[2] TNS Connection: TNS_NAME=FREE
TNS_FOLDER=/opt/oracle/product/23ai/dbhomeFree/network/admin
Administrator User: SYS AS SYSDBA
[3] Database password for ORDS runtime user (ORDS_PUBLIC_USER):
<generate>
[4] ORDS runtime user and schema tablespaces: Default: SYSAUX
Temporary TEMP
[5] Additional Feature: Database Actions
[6] Configure and start ORDS in Standalone Mode: Yes
[7] Protocol: HTTP
[8] HTTP Port: 8080
[9] APEX static resources location:
[A] Accept and Continue - Create configuration and Install ORDS in the
database
[Q] Quit - Do not proceed. No changes
Choose [A]: A
...
standalone.static.context.path=/ords
database.api.enabled=true
db.username=ORDS_PUBLIC_USER
standalone.http.port=8080
restEnabledSql.active=true
resource.templates.enabled=false
plsql.gateway.mode=proxied
feature.sdw=true
config.required=true
db.connectionType=tns
27 | P a g e
....
Oracle REST Data Services version: 24.1.0.r1080942
Oracle REST Data Services server info: jetty/10.0.20
Oracle REST Data Services java info: Java Hotspot(TM) 64-Bit Server VM
22.0.1+8-16
Note >: if the above installation does not return back to command prompt, then
press control + c button on keyboard to proceed.
Start ORDS
Figure 4.26 Start ORDS
Set up network and open Linux firewall ports.
Please check step 1 while setting up compute instance to open any required network
ports on cloud.oracle.com VCN.
In the Linux console we will alter the firewall settings as shown below.
Figure 4.27 Adding Port in Firewall
28 | P a g e
Access Oracle APEX environment
Reality check access http://<your-public-ip>:8080/ords
Figure 4.28 Oracle Apex Front Page
Figure 4.29 Apex Login
Change PDB to freepdb1 and click on Go button.
29 | P a g e
You may get this following error message.
Figure 4.30 Error of apex while login with freepdb
Figure 4.31 Apex Page Not load perfectly
How do we fix this issue? The APEX page seems to be broken.
Troubleshooting APEX Installation
In your VSCode create a Database connection as shown below.
Figure 4.32 Download Extension in VS Code
30 | P a g e
I have installed SQL Developer Extension for VSCode and created a database
connection as SYS user
Connection Parameters:
Hostname <Public IP Address>
User SYS as SYSDBA, Port 1521 and Service Name as FREEPDB1
Figure 4.33 Setup Oracle DB in VS Code
Open the worksheet. And run this
begin
apex_instance_admin.set_parameter(p_parameter => 'IMAGE_PREFIX',
p_value => 'https://static.oracle.com/cdn/apex/23.2.0/' );
commit;
end;
if you have a different version of APEX installed the CDN URL might change
Figure 4.34 run a command in DB in VS Code
Now let us access the ORACLE APEX page again at http://<public-ip>:8080/ords
and then select Oracle APEX
This works like a charm
31 | P a g e
Figure 4.35 Oracle Apex Front Page
Create Oracle APEX workspace
Login as ADMIN user into INTERNAL workspace
Figure 4.36 Login in Apex with Admin User
32 | P a g e
4.8 Workspace Creation in Apex
Click on Create Workspace
Figure 4.37 Creating Workspace in Apex
Protect Workspace Name, Workspace Description
Figure 4.38 Identifying Workspace
Re-use existing schema = Yes (since we already have created user)
Schema Name <Select from the one shown in the list>
Figure 4.39 Identifying Schema
33 | P a g e
Provide Admin username and password.
Figure 4.40 User Creation on Apex Workspace
Click Next and Create Workspace
Figure 4.41 Error of apex
After entering all details create workspace
34 | P a g e
Login to our new workspace with the user previously created in Step 5.
Figure 4.42 Login with Created User
Sign in to APEX workspace.
Figure 4.43 Dashboard of Apex
35 | P a g e
