4.2 About the SERVER Script

A single script called server manages the installation and administration of Oracle R Enterprise Server. You can rerun the server script whenever you need to install, uninstall, upgrade, or configure server-side components of Oracle R Enterprise.

4.2.1 Overview of SERVER Operations

The server script supports the following operations:

• Installs Oracle R Enterprise Server

• Uninstalls Oracle R Enterprise Server

• Upgrades Oracle R Enterprise Server and migrates data from the earlier installation

• Installs the supporting packages, if they are available

• Creates or configures a database user, if one does not exist

Note:

You can use the server script to install the supporting packages and create users, or you can choose to perform these tasks separately, as described in the following sections:

• Installing the Oracle R Enterprise Supporting Packages

• Creating a Database User for Oracle R Enterprise

4.2.2 SERVER Syntax

The server script supports a set of command-line arguments that direct its activities. The script can be run in interactive mode, in batch mode, or in hybrid mode. If you run the script without arguments, it installs or upgrades Oracle R Enterprise Server in interactive mode; it attempts to install the supporting packages; and it creates or configures a database user.

The command-line arguments for the server script are described in the following table. The arguments for the script are the same for Linux, UNIX, and Windows. You can obtain a listing of the arguments with brief descriptions by executing the following on a Linux or UNIX system:

./server.sh -h
or
./server.sh --help

On a Windows system, you can obtain a listing of the arguments with brief descriptions by executing the following:

server.bat -h
or
server.bat --help

Table 4-1 SERVER Script Command-Line Arguments

Argument	Description
-y	Never prompt.
-i, --install	Install or upgrade Oracle R Enterprise Server. An installation or upgrade includes the following by default: Installation of the supporting packages, if they are present. Creation or configuration of a database user, if one does not exist.
-u, --uninstall	Uninstall Oracle R Enterprise Server: When used with --keep (the default), the script removes the RQSYS metadata and PL/SQL packages from the database but retains the libraries and R packages under Oracle home (partial uninstall). When used with --full, the script removes the libraries and R packages under Oracle home in addition to the RQSYS metadata and PL/SQL packages in the database. (full uninstall). See Uninstalling Oracle R Enterprise.
-s, --setup-user	Create or configure a database user for Oracle R Enterprise (the default).
--keep	When uninstalling Oracle R Enterprise Server, keep the R packages and libraries under Oracle home but remove the database objects. Allows Oracle R Enterprise support to be removed from a single database instance or pluggable database (PDB) without affecting other databases in Oracle home. See Performing a Partial Uninstall.
--full	When uninstalling Oracle R Enterprise Server, remove the R packages and libraries under Oracle home in addition to the database objects. See Performing a Full Uninstall.
--no-supp	When combined with --install, prevents installation of the supporting packages. By default the supporting packages are installed if they are available.
--no-user	When combined with --install, prevents the creation of an Oracle R Enterprise user. By default a user is created if one does not already exist.
--admin	Grant the rqadmin role to the Oracle R Enterprise user. By default, the rqadmin role is not granted. The --admin option should be used with caution. It is only available in batch mode. See About the RQADMIN Role.
--sys PASSWORD	sys password. The sys password is not required if the script is running under operating system authentication, as described in About Operating System Authentication.
--pdb NAME	The name of a pluggable database (PDB) in a multitenant container database (CDB). Multitenant architecture enables an Oracle database to function as a container database that includes zero, one, or many pluggable databases. For information about multitenant architecture, see Oracle Database Concepts.
--perm PERM	Permanent tablespace for RQSYS.
--temp TEMP	Temporary tablespace for RQSYS.
--rqsys PASSWORD	RQSYS password. See About the RQSYS Schema.
--user-perm PERM	Permanent tablespace for Oracle R Enterprise user.
--user-temp TEMP	Temporary tablespace for Oracle R Enterprise user.
--pass PASSWORD	Oracle R Enterprise user password.
--user USER	Oracle R Enterprise database user name.

4.2.3 SERVER Examples

This topic provides these examples:

• A Default Interactive Installation

• A Default Batch Installation

• User Configuration in Interactive Mode

• User Configuration in Batch Mode

See Also:

Example A-1 for an example with output

4.2.3.1 A Default Interactive Installation

If your Linux or UNIX or Windows system meets the requirements specified in System Requirements, then this command performs a default, first-time installation of Oracle R Enterprise Server:

For Linux or UNIX:

./server.sh

For Windows:

server.bat

As shown in Example A-1, a default, interactive installation performs the following:

• Prints out information about the environment

• Prompts for the password and permanent and temporary tablespaces for rqsys

• Prompts whether to install the supporting packages. (Installs the supporting packages by default if they are available.)

• Prompts whether to create a user account for Oracle R Enterprise. (Creates a user by default if one does not exist.) When creating a user, prompts for the permanent and temporary tablespaces.

4.2.3.2 A Default Batch Installation

This example shows an installation like the one in A Default Interactive Installation, but specified to run in batch mode.

For Linux or UNIX:

./server.sh  -y  --install  --setup-user  --sys ORASYSPSWD, 
          --perm SYSAUX  --temp TEMP  --rqsys RQSYSPSWD 
          --user-perm USERS  --user-temp TEMP  --pass RQUSERPSWD  --user RQUSER

For Windows:

server.bat  -y  --install  --setup-user  --sys ORASYSPSWD, 
          --perm SYSAUX  --temp TEMP  --rqsys RQSYSPSWD 
          --user-perm USERS  --user-temp TEMP  --pass RQUSERPSWD  --user RQUSER

4.2.3.3 User Configuration in Interactive Mode

The server script automatically creates or configures a user if one does not already exist. If you supply the name of an existing user, the script configures it to support Oracle R Enterprise.

See Example 8-2.

4.2.3.4 User Configuration in Batch Mode

This example shows how the server script could be run to grant the rqadmin role to the user created in A Default Batch Installation. The --admin argument is only available in batch mode.

For Linux or UNIX:

./server.sh  -y  --setup-user  --admin  --sys ORASYSPSWD -
          -pass RQUSERPSWD  --user RQUSER

For Windows:

server.bat  -y  --setup-user  --admin  --sys ORASYSPSWD -
          -pass RQUSERPSWD  --user RQUSER
 

See About the RQADMIN Role.