نصب Oracle REST Data Services (ORDS) و استقرار آن بر روی Apache Tomcat

Oracle REST Data Services (ORDS) که قبلا به عنوان APEX Listener شناخته می شد، به برنامه های APEX اجازه می دهد بدون استفاده از Oracle HTTP Server (OHS)، mod_plsql یا Embedded PL/SQL Gateway مستقر شوند. همچنین ORDS نسخه 3.0 به بعد شامل پشتیبانی JSON API برای کار با JSON در پایگاه داده 12c می باشد. استقرار ORDS می تواند در WebLogic، Glassfish یا Tomcat انجام شود. در این مقاله نصب ORDS در Tomcat 7، 8 و 9 توضیح داده شده است.

پیش نیاز

نصب Apache Tomcat 9 بر روی لینوکس

دانلود

جهت نصب ORDS، نرم افزار زیر را دانلود نمائید. همیشه از آخرین نسخه موجود استفاده کنید.

• Oracle REST Data Services (ORDS)

مراحل نصب

بررسی کنید که کاربران عمومی آنلاک باشند و همچنین رمز عبور آن ها را می دانید.

SQL> CONN sys@pdb1 AS SYSDBA
CONN / AS SYSDBA
SQL> ALTER USER APEX_LISTENER IDENTIFIED BY OraPassword1 ACCOUNT UNLOCK;
SQL> ALTER USER APEX_PUBLIC_USER IDENTIFIED BY OraPassword1 ACCOUNT UNLOCK;
SQL> ALTER USER APEX_REST_PUBLIC_USER IDENTIFIED BY OraPassword1 ACCOUNT UNLOCK;

اگر ORDS قبلا نصب نشده باشد، دستور ذیل با خطا مواجه می شود و آن را نادیده بگیرید.

SQL> ALTER USER ORDS_PUBLIC_USER IDENTIFIED BY OraPassword1 ACCOUNT UNLOCK;

با کاربر tomcat (ایجاد شده در زمان نصب Tomcat) مسیر u01/ords/ را ایجاد و فایل ORDS دانلود شده را در آن از حالت فشره خارج نمائید.

# su - tomcat
$ mkdir /u01/ords
$ cd /u01/ords
$ unzip /home/ords-20.4.3.050.1904.zip

دایرکتوری u01/ords/conf/ را جهت نگهداری تنظیمات ایجاد نمائید.
در صورتی که در حین نصب با مشکل مواجه شدید، حتما قبل از تلاش مجدد، محتویات این مسیر را حذف کنید.

$ mkdir -p /u01/ords/conf

فایل “u01/ords/params/ords_params.properties/” مربوط به ORDS را ویرایش و پارامترهای مناسب را تنظیم نمائید. نمونه محتوای فایل به شرح ذیل می باشد:

db.hostname=ol7-122.localdomain
db.port=1521
db.servicename=pdb1
#db.sid=
# Next 2 lines for CDB installations only.
#cdb.common.schema=false
#db.serviceNameSuffix=.your_db_domain
db.username=APEX_PUBLIC_USER
db.password=OraPassword1
migrate.apex.rest=false
plsql.gateway.add=true
rest.services.apex.add=true
rest.services.ords.add=true
schema.tablespace.default=APEX
schema.tablespace.temp=TEMP
standalone.mode=false
# Next 3 lines for standalone mode only.
#standalone.use.https=true
#standalone.http.port=8080
# ORDS19 Onward
#standalone.static.path=/home/oracle/apex/images
# Pre-ORDS19
#standalone.static.images=/home/oracle/apex/images
user.apex.listener.password=OraPassword1
user.apex.restpublic.password=OraPassword1
user.public.password=OraPassword1
user.tablespace.default=APEX
user.tablespace.temp=TEMP
sys.user=SYS
sys.password=OraPassword1
# Enable REST Enabled SQL.
restEnabledSql.active=true
# Enable SQL Developer Web. Available from 19.4 onward. Requires REST Enabled SQL.
feature.sdw=true
# Enable database APIs. Available from 19.1 onward. 
database.api.enabled=true

مسیر conf را با استفاده از “ords.war” به عنوان دایرکتوری پیکربندی تنظیم نمائید.

# cd /u01/ords
$ java -jar ords.war configdir /u01/ords/conf

با دستور ذیل ORDS را نصب نمائید.

$ java -jar ords.war install

استقرار ORDS بر روی Tomcat

پوشه images مربوط به APEX را در مسیر “webapps” مربوط به Tomcat کپی نمائید.

$ mkdir $CATALINA_HOME/webapps/i/
$ cp -R /tmp/apex/images/* $CATALINA_HOME/webapps/i/

فایل “ords.war” را در مسیر “webapps” مربوط به Tomcat کپی نمائید.

$ cd /u01/ords
$ cp ords.war $CATALINA_HOME/webapps/

با راه اندازی مجدد سرویس Tomcat و وارد کردن آدرس ذیل در مرورگر، ORDS در دسترس می باشد.

http://<server-name>:<port>/ords/

http://ol7.localdomain:8080/ords/