ORDS,Oracle REST Data Services,通过REST接口映射到数据库事务,并返回JSON格式的结果。
环境说明
Tomcat 7、8或9
Oracle Linux 7
APEX映像(可选)
多租户:
CDB或PDB安装
使用多租户体系结构时,有几种用于安装ORDS的选项。
对于Lone-PDB安装(带有一个PDB的CDB)或具有少量PDB的CDB,可以将ORDS直接安装到PDB中。db.servicename参数将在属性文件中设置为PDB服务名称。
如果每个CDB使用多个PDB,则可以将ORDS安装到CDB中,以允许所有PDB共享相同的连接池。与每个PDB具有单独的连接池相比,这将大大减少所使用的数据库连接数。在这种情况下,db.servicename参数设置为CDB服务名称。从版本18.1开始,有两种将ORDS安装到CDB中的方法。推荐的方法是在属性文件中设置cdb.common.schema = false,这将允许每个PDB运行不同版本的ORDS。或者,您可以在属性文件中使用cdb.common.schema = true,这意味着所有PDB都必须使用相同版本的ORDS。无论选择哪个选项,您都可能还希望使用db.serviceNameSuffix = .your_db_domain参数来启用可插拔映射功能。
db.servicename=cdb1cdb.common.schema=falsedb.serviceNameSuffix=.example.com
也可以在安装完成后设置以下参数。完成后,将需要重新启动ORDS。
cd /u01/ords$JAVA_HOME/bin/java -jar ords.war set-property cdb.common.schema false$JAVA_HOME/bin/java -jar ords.war set-property db.serviceNameSuffix ".example.com"
下载ORDS
从这里下载最新版本的 ORDS:http://www.oracle.com/technetwork/developer-tools/rest-data-services/downloads/index.html
安装 ORDS
检查SYS用户和普通公共用户是否已解锁,您是否知道其密码。在安装完成后锁定SYS用户。
CONN / AS SYSDBAALTER USER SYS IDENTIFIED BY OraPassword1 ACCOUNT UNLOCK;--ALTER USER SYS IDENTIFIED BY OraPassword1 ACCOUNT UNLOCK CONTAINER=ALL;--ALTER SESSION SET CONTAINER = pdb1;ALTER USER APEX_LISTENER IDENTIFIED BY OraPassword1 ACCOUNT UNLOCK;ALTER USER APEX_PUBLIC_USER IDENTIFIED BY OraPassword1 ACCOUNT UNLOCK;ALTER USER APEX_REST_PUBLIC_USER IDENTIFIED BY OraPassword1 ACCOUNT UNLOCK;-- The next one will fail if you've never installed ORDS before. Ignore errors.ALTER USER ORDS_PUBLIC_USER IDENTIFIED BY OraPassword1 ACCOUNT UNLOCK;
解压缩ORDS安装包。我们以服务器上的“tomcat”用户身份执行此操作。
# su - tomcat$ mkdir /u01/ords$ cd /u01/ords$ unzip /tmp/ords.17.4.0.348.21.07.zip
创建目录以保存配置。
$ mkdir -p /u01/ords/conf
如果在安装过程中发生任何问题,先删除该目录的内容,然后再试一次。
编辑ORDS软件随附的 /u01/ords/params/ords_params.properties 文件,并为您的安装设置适当的参数。
db.hostname=ol7-122.localdomaindb.port=1521db.servicename=pdb1#db.sid=# Next 2 lines for CDB installations only.#cdb.common.schema=false#db.serviceNameSuffix=.your_db_domaindb.username=APEX_PUBLIC_USERdb.password=OraPassword1migrate.apex.rest=falseplsql.gateway.add=truerest.services.apex.add=truerest.services.ords.add=trueschema.tablespace.default=APEXschema.tablespace.temp=TEMPstandalone.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/imagesuser.apex.listener.password=OraPassword1user.apex.restpublic.password=OraPassword1user.public.password=OraPassword1user.tablespace.default=APEXuser.tablespace.temp=TEMPsys.user=SYSsys.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
如果出于任何原因需要重新启动安装,请记住在重新启动安装之前清除/u01/ords/conf目录并检查 /u01/ords/params/ords_params.properties 文件的内容。
使用 ords.war 文件通过以下命令指定配置目录。
$ $JAVA_HOME/bin/java -jar ords.war configdir /u01/ords/confDec 17, 2017 8:50:19 AMINFO: Set config.dir to /u01/ords/conf in: /u01/ords/ords.war
使用以下命令配置ORDS。这等效于指定简单安装命令行参数。如果您在参数文件中正确输入了参数,则不会出现提示。如果某些参数丢失或不正确,将提示您进行输入。
$ $JAVA_HOME/bin/java -jar ords.warRetrieving information.Dec 17, 2017 8:50:59 AMINFO: Updated configurations: defaults, apex, apex_pu, apex_al, apex_rtInstalling Oracle REST Data Services version 17.4.0.348.21.07...Log file written to /u01/ords/logs/ords_install_core_2017-12-17_085059_00767.log...Verified database prerequisites...Created Oracle REST Data Services schema...Created Oracle REST Data Services proxy user...Granted privileges to Oracle REST Data Services...Created Oracle REST Data Services database objects...Log file written to /u01/ords/logs/ords_install_datamodel_2017-12-17_085224_00812.log...Log file written to /u01/ords/logs/ords_install_apex_2017-12-17_085234_00725.logCompleted installation for Oracle REST Data Services version 17.4.0.348.21.07. Elapsed time: 00:01:40.123$
如果参数文件在其它位置,则可以使用以下语法。
$ $JAVA_HOME/bin/java -jar ords.war --parameterFile /path/to/my_params.properties --silent
锁定 SYS 用户。
ALTER USER SYS ACCOUNT LOCK;
Tomcat 部署
将APEX映像复制到Tomcat webapps目录。(可选)
$ mkdir $CATALINA_HOME/webapps/i/$ cp -R /tmp/apex/images/* $CATALINA_HOME/webapps/i/
将 ords.war 映像复制到Tomcat webapps目录。
$ cd /u01/ords$ cp ords.war $CATALINA_HOME/webapps/
现在应该可以使用以下类型的URL访问ORDS。
http://:/ords/http://ol7.localdomain:8080/ords/
在Tomcat下启动/停止ORDS
通过启动或停止要部署到的Tomcat实例来启动或停止ORDS。假设您正确设置了CATALINA_HOME环境变量,则应使用以下命令。
启动
$ $CATALINA_HOME/bin/startup.sh
停止
$ $CATALINA_HOME/bin/shutdown.sh
ORDS验证
您可以使用validate选项验证/修复当前的ORDS安装。
$ $JAVA_HOME/bin/java -jar ords.war validateEnter the name of the database server [ol7-122.localdomain]:Enter the database listen port [1521]:Enter the database service name [pdb1]:Requires SYS AS SYSDBA to verify Oracle REST Data Services schema.Enter the database password for SYS AS SYSDBA:Confirm password:Retrieving information.Oracle REST Data Services will be validated.Validating Oracle REST Data Services schema version 18.2.0.r1831332... Log file written to /u01/asi_test/ords/logs/ords_validate_core_2018-08-07_160549_00215.logCompleted validating Oracle REST Data Services version 18.2.0.r1831332. Elapsed time: 00:00:06.898$