1. Real Application Clusters Administration and Deployment Guide
  2. SRVCTL Usage Information

SRVCTL Usage Information

SRVCTL is installed on each node in a cluster by default. To use SRVCTL, log in to the operating system of a node and enter the SRVCTL command and its parameters in case-sensitive syntax.

  • Use the version of SRVCTL that is provided with the current Oracle AI Database release from the Oracle home of the database that you are managing. The version of SRVCTL must be the same as the version of the object (listeners, Oracle ASM instances, Oracle AI Database, Oracle AI Database instances, and Oracle AI Database services) being managed.
  • SRVCTL does not support concurrent processing of commands on the same object. Therefore, run only one SRVCTL command at a time for each database, service, or other object.
  • When specifying a comma-delimited list as part of a SRVCTL command, there should not be any spaces between the items in the list.

    When you specify a comma-delimited list in a Windows environment, you must enclose the list in double quotation marks ( "" ). You can enclose a comma-delimited list in double quotation marks in a Linux or UNIX environment but they will be ignored.

  • If you are entering a SRVCTL command, and you want to continue the input on a new line, then you can use the operating system continuation character. In Linux, this is the backslash () symbol.
  • A SRVCTL command that produces no output is a successful command. Not all SRVCTL commands return a message when it completes, successfully. However, if a SRVCTL command fails, then it always returns an error message.
  • SRVCTL returns 0 on success, 1 on failure, and 2 on warnings. Some commands, such as start , stop , enable , and disable , can return 2 for a warning when the request would not change anything. In other words, the object of the command is already started, already stopped, already disabled, and so on. In warning cases, SRVCTL also prints a message about what was already done.

  • You can use the -eval parameter with several SRVCTL commands. This parameter, when you use it, enables you to simulate running a command without making any changes to the system. SRVCTL returns output that informs you what will happen if you run a particular command. For example, to know what might happen if you relocate a server:

    The -eval parameter is available with the following commands:

    • srvctl add database
    • srvctl modify database
    • srvctl relocate service
    • srvctl start database
    • srvctl start service
    • srvctl stop database
    • srvctl stop service