Install Oracle REST Data Services (ORDS) for Oracle APEX

1- Introduction
2- What is Oracle REST Data Services?
3- Interaction between Oracle and Oracle APEX ORDS
4- Download Oracle ORDS
5- Config ORDS for APEX
6- Deploying ORDS

1- Introduction
Ti liu c vit da trn:
Oracle 11g, 12c
ORDS 3.x
2- What is Oracle REST Data Services?
Oracle REST Data Services (ORDS) is a data service which is used to replace Oracle HTTP server
and mod_plsql. It bases on Java EE that provides RESTful service and increases security capability. it
can deploy on WebLogic, Tomcat, Glassfish or independently.
3- Interaction between Oracle and Oracle APEX ORDS
Normally, there are two ways to install Oracle APEX.

Method 1: Configure the Embedded PL/SQL Gateway: This is the way to configure Oracle
APEX which can run onOracle XML DB HTTP Server, it is a HTTP that is available when you install
Oracle 11g or higher.

Method 2: Install Oracle APEX on a specific web server such as WebLogic, Tomcat or Glassfish, ...

Link worked with Oracle APEX as followed:

http://your-server:8080/apex
To use RESTful services, you need to install Oracle ORDS which can deploy on WebLogic Server,
Tomcat, Glassfish,.. or independently. Oracle ORDS can read directly to Oracle APEX and replace
completely Oracle HTTP Server, therefore you can use RESTful on APEX and new URL to work
with Oracle APEX.
http://your-server:8080/ords

4- Download Oracle ORDS

You can download Oracle ORDS at:
http://www.oracle.com/technetwork/developer-tools/rest-data-services/downloads/index.html
 Download results:

5- Config ORDS for APEX

CD to apex home directory.
Login to sqlplus as sysdba.
Run the command to configure REST Service.
?
1 -- Configuring REST Service.
2
3
4 @apex_rest_config.sql
Sau khi lnh trn thc thi thnh cng, 2 user APEX_LISTENER v APEX_REST_PUBLIC_USER
c to ra.
1. APEX_LISTENER - The account used to query RESTful Services definitions stored in Oracle
Application Express.
2. APEX_REST_PUBLIC_USER - The account used when calling RESTful Services definitions
stored in Oracle Application Express.
Enable Network Services
By default, Network Services are disable in Oracle 11g or the newer version. Therefore, you must use
the package ofDBMS_NETWORK_ACL_ADMIN in order to to grant connect privileges to any host for
the APEX_050000 database user
You need to query to view the APEX users in the database:
?
1 Select Username from All_Users where username like 'APEX%';

Run command to grant connect privileges to any host for the APEX_050000 database user.
?
1
2
3 Declare
4 Acl_Path Varchar2(4000);
5 Begin
6 -- Look for the ACL currently assigned to '*' and give APEX_050000
-- the "connect" privilege if APEX_050000 does not have the privilege yet.
7 Select Acl
8 Into Acl_Path
9 From Dba_Network_Acls
10
Where Host = '*'
11
And Lower_Port Is Null
12
And Upper_Port Is Null;
13 If Dbms_Network_Acl_Admin.Check_Privilege(Acl_Path
14 ,'APEX_050000'
15 ,'connect') Is Null Then
16 Dbms_Network_Acl_Admin.Add_Privilege(Acl_Path
,'APEX_050000'
17 ,True
18 ,'connect');
19 End If;
20 Exception
21 -- When no ACL has been assigned to '*'.
When No_Data_Found Then
22 Dbms_Network_Acl_Admin.Create_Acl('power_users.xml'
23 ,'ACL that lets power users to connect to
24 everywhere'
25 ,'APEX_050000'
,True
26
,'connect');
27 Dbms_Network_Acl_Admin.Assign_Acl('power_users.xml'
28 ,'*');
29 End;
30 /
31
Commit;
32
33
34
Grant connect for APEX_050000 user (If database is Oracle 11g):
?
1 Declare
2 Acl_Path Varchar2(4000);
Begin
3 -- Look for the ACL currently assigned to '*' and give APEX_050000
4 -- the "connect" privilege if APEX_050000
5 --does not have the privilege yet.
6 Select Acl
7 Into Acl_Path
8 From Dba_Network_Acls
9 Where Host = '*'
10 And Lower_Port Is Null
11 And Upper_Port Is Null;
12 If Dbms_Network_Acl_Admin.Check_Privilege(Acl_Path
,'APEX_050000'
13 ,'connect') Is Null Then
14 Dbms_Network_Acl_Admin.Add_Privilege(Acl_Path
15 ,'APEX_050000'
16 ,True
17 ,'connect');
End If;
18 Exception
19 -- When no ACL has been assigned to '*'.
20 When No_Data_Found Then
21 Dbms_Network_Acl_Admin.Create_Acl('power_users.xml'
,'ACL that lets power users to connect to
22 everywhere'
23 ,'APEX_050000'
24 ,True
25 ,'connect');
26 Dbms_Network_Acl_Admin.Assign_Acl('power_users.xml'
,'*');
27 End;
28 /
29
30 Commit;
 31
32
33
34
Grant connect for APEX_050000 user (If database is Oracle 12c):
Procedures CREATE_ACL, ASSIGN_ACL, ADD_PRIVILEGE and CHECK_PRIVILEGE in
DBMS_NETWORK_ACL_ADMIN are deprecated in Oracle Database 12c. Oracle recommends using
APPEND_HOST_ACE instead.
?
1
-- S dng cho Oracle 12c.
2
3
BEGIN
4 DBMS_NETWORK_ACL_ADMIN.APPEND_HOST_ACE(
5 host => '*',
6 ace => xs$ace_type(privilege_list => xs$name_list('connect'),
7 principal_name => 'APEX_050000',
principal_type => xs_acl.ptype_db));
8 END;
9 /
10

6- Deploying ORDS
Note: you must sure that you have installed Jave version 7 or higher and declare PATH variable. You
can see how to install Java at:
http://o7planning.org/en/10377/installing-and-configuring-java
Add the path to bin folder of Java at the end of PATH
;C:\DevPrograms\Java\jdk1.8.0_65\bin

Unzip the file ord - **. zip that you have downloaded to a folder
You can see that in the folder unzipped have ords.war file

Copy images folder in apex to ords folder:

Now, we will install Oracle ORDS independently (It is not necessary to deploy on Weblogic, Tomcat or
other web server)
CD to ords folder:
Next, login sqlplus as sysdba.

Your Oracle APEX is running on Oracle XML DB HTTP Server, you should disable it with the
command:
?
1 -- Disable Oracle APEX on Oracle XML DB HTTP Server.
2
3 EXEC DBMS_XDB.SETHTTPPORT(0);
4
5
6 -- Note: You can enable it with command:
7
8 EXEC DBMS_XDB.SETHTTPPORT(8080)
Exit sqlplus. And CD to ords:
Run command:
?
1 # Run command:
2
3 java -jar ords.war
4
5 # Or:
6
7 java -jar ords.war install
Enter the address of the machine that contains the database (default is localhost):

Port of database (Default is 1521):

Enter Service Name or SID of database:

Enter password for ORDS_PUBLIC_USER

Sqlplus requests to re-enter the user database information with sysdba rights. (Enter sys and then
password).

SQLPlus will ask whether you use Oracle APEX or not, if yes let's enter 1, then press "enter" to
continue.
Entering a password for user will be created (APEX_PUBLIC_USER):

Next, enter 1 to specify password for 2 newly created user database (APEX_LISTENER,
APEX_REST_PUBLIC_USER).
Select 1 to start ORDS in standalone mode:

You have configured ORDS successfully. Close CMD window

Running ORDS
Note: You can run the command below to see the help:
?
1 java -jar ords.war help standalone
CD to ORDS folder and run command:
?
1 java -jar ords.war standalone --port 8080 --apex-images C:/DevPrograms/ords/images

For the 1st time, it will ask where to place configure file:
ORDS has been successfully deployed.

Note: If you receive an error:

Unlock for APEX_PUBLIC_USER user
?
1 Column username format a25;
2 Column account_status format a25;
3
4 -- Query unlocked APEX user.
5
6 select username,account_status from dba_users
7 where lock_date is not null
and username like 'APEX%';
8
?
1 Alter user APEX_PUBLIC_USER account unlock;
The configure file is also created after you deployed ORDS:

Don't close the window above, you can use APEX with new url:
 http://localhost:8080/ords