Oracle Database 11.1 or later
ORDS 19.2 or later, up to 21.2 (i.e. NOT 22.1 and later)
On the target database instances...
For users returned by the following query, make sure the account is unlocked and you know the passwords
SELECT username,
account_status
FROM dba_users
WHERE username IN ('SYS','APEX_LISTENER','APEX_PUBLIC_USER','APEX_REST_PUBLIC_USER','ORDS_PUBLIC_USER')
/
mkdir /tomcat/ords
unzip /tomcat/ords*.zip -d /tomcat/ords
mkdir -p /tomcat/ords/conf
If you are installing to a single-tenant architecure or to a CDB, ignore this step. If you are installing to a PDB you can create a user (e.g. ORDS_OWNER) to use for ORDS installation. After creating this user you need to run a script to grant the correct privileges. The script can be found here (copy it to your db server if necessary):
/tomcat/ords/installer/ords_installer_privileges.sql
Edit the parameter file...
/tomcat/ords/params/ords_params.properties
In the sections below, non-default parameters have values in bold italicdb.connectionType=basic
db.hostname=databaseserver
db.port=1521
db.servicename=ORCL1
db.sid=ORCL1
You must specify either db.sid or db.servicename (but not both)basic uses service:hostname:port JDBC connect format
hostname
port
service
SID
For connection to a PDB you must specify db.servicenamerest.services.ords.add=true
user.public.password=PUBpassword
schema.tablespace.default=SYSAUX
schema.tablespace.temp=TEMP
user.tablespace.default=SYSAUX
user.tablespace.temp=TEMP
bequeath.connect=false
Install the ORDS schema
Specifies password for ORDS_PUBLIC_USER
ORDS_METADATA default tablespace (must exist)
ORDS_METADATA temp tablespace (must exist)
ORDS_PUBLIC_USER default tablespace (must exist)
ORDS_PUBLIC_USER temp tablespace (must exist)
Only set to true if db is on same server as app server
restEnabledSql.active=false
Enable REST-Enabled SQL
database.api.enabled=false
Enable Database API
feature.sdw=false
Enable SQL Developer Web
cdb.common.schema=false
db.serviceNameSuffix=.your_db_domain
plsql.gateway.add=true
db.username=APEX_PUBLIC_USER
db.password=APUpassword
rest.services.apex.add=true
user.apex.listener.password=ALpassword
user.apex.restpublic.password=ARPUpassword
security.externalSessionTrustedOrigins
Configure ORDS for APEX.
PL/SQL gateway username. For APEX must be APEX_PUBLIC_USER
Password for APEX_PUBLIC_USER
Configure ORDS for APEX RESTful Services.
Specifies password for APEX_LISTENER
Specifies password for APEX_REST_PUBLIC_USER.
origins trusted for CORS reqs for PL/SQL Gateway or APEX
migrate.apex.rest=false
standalone_mode=false
Copy the APEX images (${APXDIR}/images) to the Tomcat "webapps" directory.
If the Tomcat server and database server are separate hosts (recommended) then you will need to scp the files across.su - root
mkdir /tomcat/latest/webapps/i/
cp -R ${APXDIR}/images/* /tomcat/latest/webapps/i/
chown -R tomcat:tomcat /tomcat/latest/webapps/i/
NOTE:
This step needs to be repeated each time you install a new version of APEX or a new version of Tomcat.
cd /tomcat/ords
java -jar ords.war configdir /tomcat/ords/conf
java -jar ords.war install
cd /tomcat/ords
java -jar ords.war validate
java -jar ords.war standalone
Use Ctrl-C to terminate the ORDS process when you are done.In a browser, test that ORDS is working, e.g.
http://tomcatserver:8181
Where tomcatserver is your Tomcat/ORDS server and databaseserver is your database server and 8181 is the port.cd /tomcat/ords
cp ords.war /tomcat/latest/webapps/
The following URL should work..
http://tomcatserver:8080/ords
ORDS should also show up as an application in Tomcat Web Application Manager...
http://tomcatserver:8080/manager/html