Server Control Utility (SRVCTL)
To manage the RAC environment, first build a configuration profile and optionally save it. The configuration can be built by commands such as add and setenv. It is a good practice to build configuration profiles and export them to ASCII files.
SRVCTL syntax has the following components:
> srvctl verb noun options
Where:
srvctl is the SRVCTL command.
verb is an action word such as start, stop, or remove.
noun is an object upon which SRVCTL performs the action verb, such as a database or instance. Alternatively, abbreviations can be used, which in this case are db and inst respectively.
options extends the use of preceding verb-noun combinations.
To see the online command syntax and options for each SRVCTL command, enter:
> srvctl verb noun -h
Table 8.9 shows the common SRVCTL verbs.
VERB
|
DESCRIPTION
|
add
|
Add a database or instance.
|
config
|
Lists the configuration for the database or instance.
|
Getenv
|
Lists the environment variables in the SRVM configuration.
|
Modify
|
Modifies the instance configuration.
|
remove
|
Removes the database or instance.
|
Setenv
|
Sets the environment variable in the SRVM configuration.
|
Start
|
Starts the database or instance.
|
Status
|
Status of the database or instance.
|
Stop
|
Stops the database or instance.
|
Unsetenv
|
Sets the environment variable in the SRVM configuration to unspecified
|
Table 8.9: Common SRVCTL verbs
Table 8.10 shows the common srvctl nouns.
NOUN
|
ABBREVIATION
|
DESCRIPTION
|
database
|
db
|
Operation refers to objects for the database.
|
asm
|
asm
|
To add, configure, enable, start, obtain the status of, stop, disable, and remove ASM instances.
|
instance
|
Inst
|
Operation refers to objects for the instances.
|
nodeapps
|
no abbreviation
|
To add, configure, modify, manage environment variables for, start, obtain the status of, stop, and remove node applications.
|
Service
|
serv
|
To add, configure, modify, manage environment variables for, enable, start, obtain the status of, relocate, disable, stop, and remove services from your cluster database.
|
Table 8.10: Common SRVCTL nouns
Table 8.11 shows the common srvctl command options.
OPTION
|
MEANING
|
-d
|
Database name
|
-h
|
Print Usage
|
-i
|
Comma-separated list of instance names
|
-n
|
Node names or comma-separated node list
|
Table 8.11: Common SRVCTL command options
Some commonly used commands will be examined next.
srvctl add
This command adds configuration information for the database or for named instances. Command specific actions for add command:
OPTION
|
MEANING
|
-n
|
Node name that will support an instance.
|
-o
|
$ORACLE_HOME to locate lsnrctl (node option) and oracle binaries (other options)
|
-s
|
SPFILE name
|
-m
|
Database domain name, in the form ?us.domain.com?
|
For example, to add a new database:
> srvctl add database -d racdb -o /app/oracle/product/920
To add named instances to a database:
> srvctl add instance -d racdb -i rac1 -n mynode1
> srvctl add instance -d racdb -i rac2 -n mynode2
> srvctl add instance -d racdb -i rac3 -n mynode3
srvctl config
This command displays a list of configured databases. The syntax is:
srvctl config database -d database_name
For example, to display configured databases:
> srvctl config database -d RACDB
Gives the output:
mynode1 RACDB1 /app/oracle/product/dbms/920
mynode2 RACDB2 /app/oracle/product/dbms/920
srvctl getenv
This command displays values for the environment from the SRVM configuration file. The syntax is:
> srvctl getenv database -d database_name [-t name]
> srvctl getenv instance -d database_name
-i instance_name [-t name]For example, to list all environment variables for a database:
> srvctl getenv database ?d racdb
srvctl setenv
This command sets values for the environment in the SRVM configuration file. The syntax is:
> srvctl setenv database -d database_name
-t name=value [,name=value,?]
srvctl setenv instance -d database_name
[-i instance_name] -t name=value [,name=value,?]
For example, to set list all environment variables for a database:
> srvctl setenv database -d mydb -t LANG=en
srvctl start
This command starts the database, all or named instances, and all listeners associated with the database. The syntax is:
> srvctl start database -d database_name
[-o start_options] [-c connect_string]
> srvctl start instance -d database_name -i instance_name
[,insta_name-list] [-o start_options] [-c connect_string]
Command-Specific Options for srvctl start
OPTION
|
MEANING
|
-o
|
Options passed directly to startup command in SQL*Plus including PFILE.
|
-c
|
Connect string for connecting to the Oracle instance using SQL*Plus.
|
For example, to start the database and all enabled instances:
> srvctl start database -d mydb
To start specified instances:
> srvctl start instance -d racdb -i racdb1, racdb3
srvctl status
This command displays the status of the database and instance. The syntax is:
> srvctl status database -d database_name
> srvctl status instance -d database_name
-i instance_name [,instance_name-list]
For example, to get the current status of two instances:
> srvctl status instance -d RAC -i racdb1, racdb2
Gives the output:
Instance RACDB1 is running on node mynode1
Instance RACDB2 is not running on node mynode1
srvctl stop
This command stops the database and all or named instances. The syntax is:
> srvctl stop database -d database_name
[-o stop_options] [-c connect_string]
> srvctl stop instance -d database_name
-i instance_name [,instance_name_list]
[-o stop_options][-c connect_string]
For example, to stop the database all instances:
> srvctl stop database -d RACDB
To stop named instances:
> srvctl stop instance -d RACDB -i racdb1
Use the srvconfig command to export/import the SRVM configuration information. The following is an example of how to export the contents of the configuration information to the text file:
> srvconfig -exp file_name
To import the configuration information from the text file named to the configuration repository for the RAC, use the command:
> srvconfig -imp file_name
