Home > SQL Developer Dialog Boxes ... > Install/Run Oracle REST Dat...
This full installation wizard is displayed if you click Tools, then REST Data Services, then Install. The more limited run wizard (for running in standalone mode) is displayed if you click Tools, then REST Data Services, then Run.
The wizard is a convenient alternative to the command-line installation of Oracle REST Data Services that is documented in Oracle REST Data Services Installation, Configuration, and Development Guide. (However, to install and use Oracle REST Data Services, you should be familiar with the main concepts and techniques described in that guide.
ORDS WAR File Location: For the Oracle REST Data Services ords.war file, specify whether to use the one that is included with SQL Developer or one that you downloaded from the Oracle Technology Network.
Configuration Files Location: Specify a location to be used for Oracle REST Data Services configuration files. (This can be a location of your choice, and should be one dedicated to storing the configuration files.)
Optionally, reset the configuration files location using the value from the ords.war file that you specified.
Specify the database connection information for the database on which to install Oracle REST Data Services: host, port, and the database name (SID) or service name.
ORDS Public User: Specify the user name and password for the Oracle REST Data Services public user (the database user that has privileges to access the Oracle REST Data Services RESTful services). If you do not skip the verification of this user, you will be prompted for that user's name and password in the Verify Oracle REST Data Services Schema dialog box.
Skip verify/install of Oracle REST Data Service Schema: Causes the information that you entered on this page not to be verified. This option allows you to continue with the wizard steps if you do not know all the information.
Select the default tablespace and temporary tablespace for the ORDS_METADATA and ORDS_PUBLIC_USER users.
Specify credentials (user name and password) for the PL/SQL Gateway user, which is responsible for executing stored PL/SQL stored packages and procedures on the specified database connection.
Verify Database User: Displays a dialog box asking the for the privileged user (for example, SYS AS SYSDBA) and that user's password to be used to verify the user credentials that you entered. If you enter correct information for a suitably privileged account, the credentials are checked and a message is displayed. (Note that if you do not enter valid credentials specified user or users, you can still continue with the wizard steps; but to be able to use Oracle REST Data Services, you will need to provide valid credentials.)
Use Application Express RESTful Services: Enable this option if you want to be able to use the Oracle Application Express RESTful services. If you enable this option, enter credentials for the proxy user that has privileges to access the Application Express RESTful services and the user that has privileges to create and edit Application Express RESTful services.
Verify Database User: Displays a dialog box asking the for the privileged user (for example, SYS AS SYSDBA) and that user's password to be used to verify the user credentials that you entered. If you enter correct information for a suitably privileged account, the credentials are checked and a message is displayed. (Note that if you do not enter valid credentials specified user or users, you can still continue with the wizard steps; but to be able to use Oracle REST Data Services, you will need to provide valid credentials.)
Oracle REST Data Services includes a web server that enables you to run in standalone mode. Standalone mode is designed for use only in development and test environments, and is not supported for use in production environments.
Run in Standalone Mode when installation completes: Causes Oracle REST Data Services to run in standalone mode when the installation completes.
If you select (check) this option, SQL Developer creates the Oracle REST Data Services configuration files and performs the installation, and does not terminate. You can view the Oracle Rest Data Services Log by selecting View > Log. If you want to terminate the Oracle REST Data Services process, you can right-click on the Oracle REST Data Services Log and select Terminate, or you can click the red square icon.
If you do not select (uncheck) this option, SQL Developer creates the Oracle REST Data Services configuration files and performs the installation, but automatically terminates after that. You can view the Oracle Rest Data Services Log by selecting View > Log.
HTTP Port: HTTP port to use.
Application Express Static Resources Location: If you are using Oracle Application Express, specify the location of the Application Express static resources, including images and CSS files.
You can create Oracle REST Data Services users that are allowed to perform certain Oracle REST Data Services operations using Oracle SQL Developer:
ORDS Administrator: An administrator responsible for administering the Oracle REST Data Services configuration using SQL Developer.
ORDS RESTful Services User: A provisioned user that allows SQL Developer to be used to create and edit Oracle REST Data Services RESTful services.
Requires Secure Sockets Layer: Enable this option if your RESTful services require Secure Sockets Layer (SSL) security, for example, https.
Displays a summary of the information that you have specified. To change any information, press Back as needed and make changes, then press Next as needed to return to this page.
To perform the installation, click Finish. (Exactly what happens depends on your choice for the Run in Standalone Mode when installation completes option.) To cancel the installation, click Cancel.