A Server Control Utility Reference

Syntax and Options

Use the srvctl add asm command with the following syntax:

srvctl add asm [-l listener_name]

This command has only one option, -l, which calls for the name of a listener. If you do not specify this option, then the listener name defaults to LISTENER.

Example

To add a clusterware resource for Oracle ASM on every node in the cluster, use the following command:

srvctl add asm

Syntax and Options

Use the srvctl add cvu command with the following syntax:

srvctl add cvu [-t check_interval_in_minutes]

-t check_interval_in_minutes

Examples

An example of this command to add CVU with a check interval of 6 hours is:

$ srvctl add cvu -t 360

Syntax and Options

Use the srvctl add database command with the following syntax:

srvctl add database -d db_unique_name -o oracle_home
     [-x node_name] [-m domain_name] [-p spfile]
     [-c  {RACONENODE | RAC | SINGLE} [-e server_list] [-i instance_name] [-w timeout]]
     [-r {PRIMARY | PHYSICAL_STANDBY | LOGICAL_STANDBY | SNAPSHOT_STANDBY}]
     [-s start_options] [-t stop_options] [-n db_name -j "acfs_path_list"]
     [-y {AUTOMATIC | MANUAL | NORESTART}] [-g server_pool_list] [-a disk_group_list]

-d db_unique_name

-o oracle_home

-x node_name

-m db_domain

-p spfile

-c {RACONENODE | RAC | SINGLE}

-e server_list

-i instance_name

-w timeout

-r {PRIMARY | PHYSICAL_STANDBY |
 LOGICAL_STANDBY |
 SNAPSHOT_STANDBY}

-s start_options

-t stop_options

-n db_name

-j "acfs_path_list"

-y {AUTOMATIC | MANUAL |
 NORESTART}

-g "server_pool_list"

-a "disk_group_list"

Examples

An example of this command to add a policy-managed database is:

srvctl add database -d crm -o /u01/oracle/product/112/mydb -m foo.com
     -p +diskgroup1/crm/spfilecrm.ora -r PHYSICAL_STANDBY -s MOUNT -t NORMAL
     -n database2 -y MANUAL -g svrpool1,svrpool2 -a "diskgroup1,diskgroup2"

An example of this command to add an administrator-managed database is:

srvctl add database -d crm -o /u01/oracle/product/112/mydb -m foo.com

Syntax and Options

Use the srvctl add filesystem command with the following syntax:

srvctl add filesystem -d volume_device -v volume_name -g diskgroup_name
                      [-m mountpoint_path] [-u user_name]

-d volume_device

-v volume_name

-g diskgroup_name

-m mountpoint_path

-u user_name

Example

An example of this command is the following:

srvctl add filesystem -d /dev/asm/d1volume1-295 -v VOLUME1 -g RAC_DATA \
  -m /oracle/cluster1/acfs1

Syntax and Options

Use the srvctl add gns command with the following syntax:

srvctl add gns -i ip_address -d domain

-i ip_address

-d domain

Example

An example of this command is:

srvctl add gns -i 192.168.16.17 -d cluster.mycompany.com

Syntax and Options

Use the srvctl add instance command with the following syntax:

srvctl add instance -d db_unique_name -i instance_name -n node_name

-d db_unique_name

-i instance_name

-n node_name

Examples

Examples of this command are:

$ srvctl add instance -d crm -i  crm01 -n gm01
$ srvctl add instance -d crm -i  crm02 -n gm02
$ srvctl add instance -d crm -i  crm03 -n gm03

Syntax and Options

Use the srvctl add listener command with the following syntax:

srvctl add listener [-l listener_name] [-o Oracle_home] 
    [-p "[TCP:]port_list[/IPC:key][/NMP:pipe_name][/TCPS:s_port][/SDP:port]"]
    [-k network_number] [-s]

-l listener_name

-o oracle_home

-p "[TCP:]port_list [/IPC:key]
[/NMP:pipe_name]
[/TCPS:s_port]
[/SDP:port]

-k network_number

-s

Example

The following command adds a listener named listener112 that is listening on port 1341 and runs from the /ora/ora112 home directory on every node in the cluster:

$ srvctl add listener -l listener112 -p 1341 -o /ora/ora112

Syntax and Options

Use the srvctl add network command with the following syntax:

srvctl add network [-k net_number] -S subnet/netmask[/if1[|if2|...]]
  [-w network_type] [-v]

-k net_number

-S subnet/netmask
[/if1[|if2|...]]

-w network_type

-v

Example

An example of this command is:

$ srvctl add network -k 3 -S 1.2.3.4/255.255.255.0

Syntax and Options

Use the srvctl add nodeapps command with one the following syntax models:

srvctl add nodeapps -n node_name -A {name | ip}/netmask[/if1[|if2|...]]
  [-e em_port] [-l ons_local_port] [-r ons_remote-port]
  [-t host[:port][,host[:port],...]] [-v]
 

srvctl add nodeapps -S subnet/netmask[/if1[|if2|...]] [-e em_port]
  [-l ons_local_port] [-r ons_remote-port]
  [-t host[:port][,host[:port],...]] [-v]

-n node_name

-A {name | ip}
/netmask[/if1
|[if2|...]]

-S subnet/netmask
[/if1 [| if2 |...]]

-e em_port

-l ons_local_port

-r ons_remote_port

-t host[:port],
[host[:port],[...]

-v

Example

An example of this command is:

# srvctl add nodeapps -n crmnode1 -A 1.2.3.4/255.255.255.0

Syntax and Options

srvctl add oc4j [-v]

This command has only one option, -v, which displays verbose output.

Example

An example of this command is:

srvctl add oc4j

Syntax and options

srvctl add ons [-l ons_local_port] [-r ons_remote_port] 
    [-t host[:port][,host[:port]][...]] [-v]

-l ons_local_port

-r ons_remote_port

-t host[:port][,host[:port]][...]

-v

Example

An example of this command is:

$ srvctl add ons -l 6200

Syntax and Options

Use the srvctl add scan command with the following syntax:

srvctl add scan -n scan_name [-k network_number]
  [-S subnet/netmask[/if1[|if2|...]]]

-n scan_name

-k network_number

-S subnet/netmask
[/if1 [|if2|...]]

Example

An example of this command is:

# srvctl add scan -n scan.mycluster.example.com

Syntax and Options

Use the srvctl add scan_listener command with the following syntax:

srvctl add scan_listener [-l lsnr_name_prefix] [-s]
  [-p "[TCP:]port_list[/IPC:key][/NMP:pipe_name][/TCPS:s_port] [/SDP:port]"]

-l lsnr_name_prefix

-s

-p "[TCP:]port_list
[/IPC:key][/NMP:pipe_name]
[/TCPS:s_port]
[/SDP:port]"

Example

An example of this command is:

# srvctl add scan_listener -l myscanlistener

Syntax and Options

Use the srvctl add service command to create a service, using the first of the following syntax models, or to update an existing service, using the second syntax model:

srvctl add service -d db_unique_name -s service_name {-r "preferred_list"
   [-a "available_list"] [-P {BASIC | NONE | PRECONNECT}] | -g server_pool
   [-c {UNIFORM | SINGLETON]} [-k network_number]
   [-l [PRIMARY | PHYSICAL_STANDBY | LOGICAL_STANDBY | SNAPSHOT_STANDBY]
   [-y {AUTOMATIC | MANUAL}] [-q {TRUE | FALSE}] [-x {TRUE | FALSE}]
   [-j {SHORT | LONG}][-B {NONE | SERVICE_TIME | THROUGHPUT}]
   [-e {NONE | SESSION | SELECT}] [-m {NONE | BASIC}] [-z failover_retries]
   [-w failover_delay]

srvctl add service -d db_unique_name -s service_name
   -u {-r preferred_list | -a available_list} [-f]

Table A-17 lists and describes all the srvctl add service options and whether they can be used when adding a service to a noncluster or Oracle RAC database.

-d db_unique_name

-s service_name

-r preferred_list

-a available_list

-P {BASIC | NONE | PRECONNECT}

-g server_pool

-c {UNIFORM | SINGLETON}

-k network_number

-l {[PRIMARY] |
[PHYSICAL_STANDBY] |
[LOGICAL_STANDBY] |
[SNAPSHOT_STANDBY]}

-y {AUTOMATIC | MANUAL}

-q {TRUE | FALSE}

-x {TRUE | FALSE}

-j {SHORT | LONG}

-B {NONE | SERVICE_TIME | THROUGHPUT}

-e {NONE | SESSION | SELECT}

-m {NONE | BASIC}

-z failover_retries

-w failover_delay

-u

-f

Examples

Use this example syntax to add the gl.example.com service to the my_rac database with AQ HA notifications enabled, a failover method of BASIC, a Connection Load Balancing Goal of LONG, a failover type of SELECT, and 180 failover retries with a delay of 5:

srvctl add service -d my_rac -s gl.example.com -m BASIC -e SELECT \
-z 180 -w 5 -j LONG

Use this example syntax to add a named service to a database with preferred instances in list one and available instances in list two, using preconnect failover for the available instances:

srvctl add service -d crm -s sales -r crm01,crm02 -a crm03 -P PRECONNECT

Syntax and Options

Use the srvctl add srvpool command with the following syntax:

srvctl add srvpool -g server_pool [-i importance] [-l min_size] [-u max_size]
     [-n "node_list"] [-f]

-g server_pool

-i importance

-l min_size

-u max_size

-n "node_names"

Example

An example of this command is:

$ srvctl add srvpool -g SP1 -i 1 -l 3 -u 7 -n "mynode1,mynode2"

Syntax and Options

Use the srvctl add vip command with the following syntax:

srvctl add vip -n node_name -A {name|ip}/netmask[/if1[if2|...]]
     [-k network_number] [-v]

-n node_name

-A {name|ip}/netmask
[/if1[|if2|...]]

-k network_number

-v

Example

An example of this command is:

# srvctl add vip -n node7 -A 192.168.16.17/255.255.255.0 -k 2

The preceding example creates a network number, 2, for the VIP just added. You can specify the network number after the -k option in other SRVCTL commands.

Syntax and Options

Use the srvctl config asm command with the following syntax:

srvctl config asm [-a]

-a

Example

An example of this command is:

srvctl config asm -a

Syntax and Options

Use the srvctl config cvu command with the following syntax:

srvctl config cvu

This command has no options.

Examples

The srvctl config cvu command returns output similar to the following:

CVU is configured to run once every 360 minutes

Syntax and Options

Use the srvctl config database command with the following syntax:

srvctl config database [-d db_unique_name] [-a]

-d db_unique_name

-a

Examples

To list the configuration of all databases, use the following example:

srvctl config database -d myDB

The following is example output from the srvctl config database command:

$ srvctl config database -d myDB
Database unique name: myDB
Database name:
Oracle home: /scott_st2/oracle
Oracle user: scott
Spfile:
Domain:
Start options: open
Stop options: immediate
Database role: PRIMARY
Management policy: AUTOMATIC
Server pools: myDB
Database instances:
Disk Groups:
Services: scottsvc1
Type: RACOneNode
Online relocation timeout: 30
Instance name prefix: myDB
Candidate servers: node1 node2
Database is administrator managed

The preceding sample output shows the database type as RACOneNode, an Oracle RAC One Node database. Other potential types are RAC and SingleInstance. The Online relocation timeout, Instance name prefix, and Candidate servers fields only apply to Oracle RAC One Node databases and do not display for the other two database types. Similarly, the Database instances field is empty because the database type is RACOneNode.

Syntax and Options

Use the srvctl config filesystem command with the following syntax:

srvctl config filesystem -d volume_device_path

-d volume_device_path

Examples

The following example shows how to retrieve the configuration for an Oracle ACFS file system:

srvctl config filesystem -d /dev/asm/d1volume293

Syntax and Options

Use the srvctl config gns command with the following syntax:

srvctl config gns [-a] [-d] [-k] [-m] [-n node_name] [-p] [-s] [-V]
[-q name] [-l] [-v]

-a

-d

-k

-m

-n node_name

-p

-s

-V

-q name

-l

-v

Syntax and Options

Use the srvctl config listener command with the following syntax:

srvctl config listener [-l listener_name] [-a]

-l listener_name

-a

Example

An example of this command is:

srvctl config listener

Syntax and Options

Use the srvctl config nodeapps command with the following syntax:

srvctl config nodeapps [-a] [-g] [-s]

-a

-g

-s

Example

An example of this command is:

$ srvctl config nodeapps -a -g -s

Syntax and Options

Use the srvctl config scan command with the following syntax:

srvctl config scan [-i ordinal_number]

The only option available for this command is -i ordinal_number, which identifies any one of the three SCAN VIPs, and can take a range of values from 1 to 3.

Example

An example of this command is:

$ srvctl config scan -i 1

Syntax and Options

Use the srvctl config scan_listener command with the following syntax:

srvctl config scan_listener [-i ordinal_number]

The only option available for this command is -i ordinal_number, which identifies any one of the three SCAN VIPs, and can take a range of values from 1 to 3.

Example

An example of this command is:

$ srvctl config scan_listener -i 1

Syntax and Options

Use the srvctl config service command with the following syntax:

srvctl config service -d db_unique_name [-s service_name]

-d db_unique_name

-s service_name

Examples

An example output of this command is for a policy-managed database is:

$ srvctl config service -d mjkpdb -s mjkpsvc1
Service name: mjkpsvc1
Service is enabled
Server pool: mjksrvpool1
Cardinality: SINGLETON
Disconnect: false
Service role: PRIMARY
Management policy: AUTOMATIC
DTP transaction: false
AQ HA notifications: false
Failover type: NONE
Failover method: NONE
TAF failover retries: 0
TAF failover delay: 0
Connection Load Balancing Goal: LONG
Runtime Load Balancing Goal: NONE
TAF policy specification: NONE
Service is enabled on nodes:
Service is disabled on nodes:
Edition: "my Edition"

An example output of this command is for an administrator-managed database is:

$ srvctl config service -d mjkdb -s mjksvc1
Service name: mjksvc1
Service is enabled
Server pool: mjkdb
Cardinality: 1
Disconnect: false
Service role: PRIMARY
Management policy: AUTOMATIC
DTP transaction: false
AQ HA notifications: false
Failover type: NONE
Failover method: NONE
TAF failover retries: 0
TAF failover delay: 0
Connection Load Balancing Goal: LONG
Runtime Load Balancing Goal: NONE
TAF policy specification: NONE
Preferred instances: mjkdb_1
Available instances:
Edition: "my Edition"

Service configuration for administrator-managed Oracle RAC One Node databases displays the one instance as preferred.

Syntax and Options

Use the srvctl config srvpool command with the following syntax:

srvctl config srvpool [-g server_pool]

Example

An example of this command is:

$ srvctl config srvpool -g dbpool

Syntax and Options

Use the srvctl config vip command with one of the following syntax models:

srvctl config vip -n node_name

srvctl config vip -i vip_name

-n node_name

-i vip_name

Example

An example of this command is:

$ srvctl config vip -n crmnode1

Syntax and Options

Use the srvctl disable asm command with the following syntax:

srvctl disable asm [-n node_name]

-n node_name

Example

An example of this command is:

$ srvctl disable asm -n crmnode1

Syntax and Options

Use the srvctl disable cvu command with the following syntax:

srvctl disable cvu [-n node_name]

You can specify a particular node on which to disable CVU.

-n node_name

Examples

An example of this command to disable CVU on a single node of a cluster is:

$ srvctl disable cvu -n crmnode1

Syntax and Options

Use the srvctl disable database command with the following syntax:

srvctl disable database -d db_unique_name [-n node_name]

-d database_name

-n node_name

Example

An example of this command is:

$ srvctl disable database -d mydb1

Syntax and Options

Use the srvctl disable diskgroup command with the following syntax:

srvctl disable diskgroup -g diskgroup_name [-n node_list]

-g diskgroup_name

-n node_list

Example

An example of this command is:

$ srvctl disable diskgroup -g diskgroup1 -n mynode1, mynode2

Syntax and Options

Use the srvctl disable filesystem command with the following syntax:

srvctl disable filesystem -d volume_device_name

-d volume_device_name

Example

An example of this command is:

$ srvctl disable filesystem -d /dev/asm/d1volume293

Syntax and Options

Use the srvctl disable gns command with the following syntax:

srvctl disable gns [-n node_name]

-n node_name

Example

An example of this command is:

$ srvctl disable gns -n crm7

Syntax and Options

Use the srvctl disable instance command with the following syntax:

srvctl disable instance -d db_unique_name -i instance_name_list

-d db_unique_name

-i instance_name_list

Example

An example of this command is:

$ srvctl disable instance -d crm -i "crm1,crm3"

Syntax and Options

Use the srvctl disable listener command with the following syntax:

srvctl disable listener [-l listener_name] [-n node_name]

-l listener_name

-n node_name

Example

An example of this command is:

$ srvctl disable listener -l listener_crm -n node5

Syntax and Options

Use the srvctl disable nodeapps command with the following syntax:

srvctl disable nodeapps [-g] [-v]

-g

-v

Example

An example of this command is:

$ srvctl disable nodeapps -g -v

Syntax and Options

Use the srvctl disable oc4j command with the following syntax:

srvctl disable oc4j [-n node_name] [-v]

-n node_name

-v

Example

An example of this command is:

$ srvctl disable oc4j -n crm3

Syntax and Options

Use the srvctl disable scan command with the following syntax:

srvctl disable scan [-i ordinal_number]

The only option available for this command is -i ordinal_number, which represents which identifies any one of the three SCAN VIPs, and can take a range of values from 1 to 3.

Example

An example of this command is:

$ srvctl disable scan -i 1

Syntax and Options

Use the srvctl disable scan_listener command with the following syntax:

srvctl disable scan_listener [-i ordinal_number]

The only option available for this command is -i ordinal_number, which identifies any one of the three SCAN listeners, and can take a range of values from 1 to 3.

Example

An example of this command is:

$ srvctl disable scan_listener -i 1

Syntax and Options

Use the srvctl disable service command with the following syntax:

srvctl disable service -d db_unique_name
      -s "service_name_list" [-i instance_name | -n node_name]

If you do not specify either the -i instance_name or -n node_name options, then the command disables the service on all nodes.

-d db_unique_name

-s "service_name_list"

-i instance_name

-n node_name

Examples

The following example globally disables two services for the CRM database:

$ srvctl disable service -d crm -s "crm,marketing"

The following example disables a service for the CRM database that is running on the CRM1 instance, resulting in the service still being available for the database, but on one less instance:

$ srvctl disable service -d crm -s crm -i crm1

Syntax and Options

Use the srvctl disable vip command with the following syntax:

srvctl disable vip -i vip_name [-v]

-i vip_name

-v

Example

An example of this command is:

$ srvctl disable vip -i vip1 -v

Syntax and Options

Use the srvctl downgrade database command as follows:

srvctl downgrade database -d db_unique_name -o Oracle_home -t to_version

-d db_unique_name

-o Oracle_home

-t to_version

Syntax and Options

Use the srvctl enable asm command with the following syntax:

srvctl enable asm [-n node_name]

-n node_name

Example

An example of this command is:

$ srvctl enable asm -n crmnode1

Syntax and Options

Use the srvctl enable cvu command with the following syntax:

srvctl enable cvu [-n node_name]

You can specify a particular node on which to enable CVU.

-n node_name

Examples

An example of this command to enable CVU on a single node of a cluster is:

$ srvctl enable cvu -n crmnode1

Syntax and Options

Use the srvctl enable database command with the following syntax:

srvctl enable database -d db_unique_name [-n node_name]

-d database_name

-n node_name

Example

An example of this command is:

$ srvctl enable database -d mydb1

Syntax and Options

Use the srvctl enable diskgroup command with the following syntax:

srvctl enable diskgroup -g diskgroup_name [-n node_list]

-g diskgroup_name

-n node_list

Example

An example of this command is:

$ srvctl enable diskgroup -g diskgroup1 -n mynode1,mynode2

Syntax and Options

Use the srvctl enable filesystem command with the following syntax:

srvctl enable filesystem -d volume_device_name 

-d volume_device_name

Example

An example of this command is:

$ srvctl enable filesystem  -d /dev/asm/d1volume293

Syntax and Options

Use the srvctl enable gns command with the following syntax:

srvctl enable gns [-n node_name]

-n node_name

Example

An example of this command is:

$ srvctl enable gns

Syntax and Options

Use the srvctl enable instance command with the following syntax:

srvctl enable instance -d db_unique_name -i instance_name_list

-d db_unique_name

-i instance_name_list

Example

An example of this command is:

$ srvctl enable instance  -d crm -i "crm1,crm2"

Syntax and Options

Use the srvctl enable listener command with the following syntax:

srvctl enable listener [-l listener_name] [-n node_name]

-l listener_name

-n node_name

Example

An example of this command is:

$ srvctl enable listener -l listener_crm -n node5

Syntax and Options

Use the srvctl enable nodeapps command with the following syntax:

srvctl enable nodeapps [-g] [-v]

-g

-v

Example

An example of this command is:

$ srvctl enable nodeapps -g -v

Syntax and Options

Use the srvctl enable oc4j command with the following syntax:

srvctl enable oc4j [-n node_name] [-v]

-n node_name

-v

Example

An example of this command is:

$ srvctl enable oc4j -n crm3

Syntax and Options

Use the srvctl enable ons command with the following syntax:

srvctl enable ons [-v]

The only option for this command is -v, which indicates that verbose output should be displayed.

Example

An example of this command is:

$ srvctl enable ons

Syntax and Options

Use the srvctl enable scan command with the following syntax:

srvctl enable scan [-i ordinal_number]

The only option available for this command is -i ordinal_number, which identifies any one of the three SCAN VIPs, and takes a range of values from 1 to 3.

Example

An example of this command is:

$ srvctl enable scan -i 1

Syntax and Options

Use the srvctl enable scan_listener command with the following syntax:

srvctl enable scan_listener [-i ordinal_number]

The only option available for this command is -i ordinal_number, which identifies any one of the three SCAN listeners, and takes a range of values from 1 to 3.

Example

An example of this command is:

$ srvctl enable scan_listener -i 1

Syntax and Options

Use the srvctl enable service command with the following syntax:

srvctl enable service -d db_unique_name -s "service_name_list"
     [-i instance_name | -n node_name]

-d db_unique_name

-s service_name_list

-i instance_name

-n node_name

Examples

The following example globally enables a service:

$ srvctl enable service -d crm -s crm

The following example enables a service to use a preferred instance:

$srvctl enable service -d crm -s crm -i crm1

Syntax and Options

Use the srvctl enable vip command with the following syntax:

srvctl enable vip -i vip_name [-v]

-i vip_name

-v

Example

An example of this command is:

$ srvctl enable vip -i crm1-vip -v

Syntax and Options

Use the srvctl getenv asm command with the following syntax:

srvctl getenv asm [-t "name_list"]

-t "name_list"

Example

The following example displays the current values for all the environment variables used by Oracle ASM:

$ srvctl getenv asm

Syntax and Options

Use the srvctl getenv database command with the following syntax:

srvctl getenv database -d db_unique_name [-t "name_list"]

-d db_unique_name

-t "name_list"

Example

The following example gets the environment configuration for the CRM database:

$ srvctl getenv database -d crm

Syntax and Options

Use the srvctl getenv listener command with the following syntax:

srvctl getenv listener [-l listener_name] [-t "name_list"]

-l listener_name

-t "name_list"

Example

The following example lists all environment variables for the default listener:

$ srvctl getenv listener

Syntax and Options

Use the srvctl getenv nodeapps command with the following syntax:

srvctl getenv nodeapps [-a] [-g] [-s] [-t "name_list"] [-v]

-a

-g

-s

-t "name_list"

-v

Example

The following example lists all environment variables for the node applications:

$ srvctl getenv nodeapps -a

Syntax and Options

Use the srvctl getenv vip command with the following syntax:

srvctl getenv vip -i vip_name [-t "name_list"] [-v]

-i vip_name

-t "name_list"

-v

Example

The following example lists all environment variables for the specified VIP:

$ srvctl getenv vip -i node1-vip

Syntax and Options

Use the srvctl modify asm command with the following syntax:

srvctl modify asm [-n node_name] [-l listener_name] 
     [-d asm_diskstring] [-p spfile_path_name]

-n node_name

-l listener_name

-d asm_diskstring

-p spfile_path_name

Example

An example of this command to modify the configuration of Oracle ASM is:

$ srvctl modify asm -l lsnr1

Syntax and Options

Use the srvctl modify cvu command with the following syntax:

srvctl modify cvu [-t check_interval_in_minutes]

-t check_interval_in_minutes

Examples

An example of this command to modify CVU to a check interval of 4 hours is:

$ srvctl modify cvu -t 240

Syntax and Options

Use the srvctl modify database command with the following syntax:

srvctl modify database -d db_unique_name [-n db_name]
     [-o oracle_home] [-u user_name] [-m db_domain] [-p spfile] 
     [-r {PRIMARY | PHYSICAL_STANDBY | LOGICAL_STANDBY | SNAPSHOT_STANDBY}]
     [-s start_options] [-t stop_options] [-y {AUTOMATIC | MANUAL | NORESTART}]
     [-g "server_pool_list"] [{-a "diskgroup_list" | -z}]
     [-e server_list] [-w timeout] [-j "acfs_path_list"]

-d db_unique_name

-n db_name

-o oracle_home

-u user_name

-m db_domain

-p spfile

-r role [PRIMARY |
 PHYSICAL_STANDBY |
 LOGICAL_STANDBY |
 SNAPSHOT_STANDBY]

-s start_options

-t stop_options

-y [AUTOMATIC |
 MANUAL | NORESTART]

-g "server_pool_list"

-a "diskgroup_list"

-z

-e server_list

-w timeout

-j "acfs_path_list"

Usage Notes

• The srvctl modify database command can convert administrator-managed databases to policy-managed databases. For a running administrator-managed database, if the server list is supplied, then the node where the database is running must be on that list. The instance name prefix cannot be modified after running the srvctl add database command.

• You cannot change the management policy from AUTOMATIC (using the -y option) for Oracle RAC One Node databases. Any attempt to do so results in an error message. The same is true for the -x option, which is used to change the node on which a noncluster database runs.

• For policy-managed Oracle RAC One Node databases, you can use the -g option to move an Oracle RAC One Node database between server pools but you can only specify one server pool. Specifying a list of server pools returns an error.

Examples

The following example changes the role of a database to a logical standby:

$ srvctl modify database -d crm -r logical_standby

The following example directs the racTest database to use the SYSFILES, LOGS, and OLTP Oracle ASM disk groups.

$ srvctl modify database -d racTest -a "SYSFILES,LOGS,OLTP"

Syntax and Options

Use the srvctl modify filesystem command with the following syntax:

srvctl modify filesystem -d volume_device_name -u user_name 

-d volume_device_name

-u user_name

Examples

The following example changes the authorized user to sysad for the RACVOL1 volume:

$ srvctl modify filesystem -d /dev/asm/racvol1 -u sysad

Syntax and Options

Use the srvctl modify gns command with the following syntax:

srvctl modify gns [-i ip_address] [-d domain]

-i ip_address

-d domain

Example

An example of this command is:

$ srvctl modify gns -i 192.000.000.003

Syntax and Options

Use the srvctl modify instance command with the following syntax:

srvctl modify instance -d db_unique_name -i instance_name
     {-n node_name | -z}

-d db_unique_name

-i instance_name

-n node_name

-z

Examples

The following example to changes the configuration of an administrator-managed database, amdb, so that the database instance, amdb1, runs on the specified node, mynode:

$ srvctl modify instance -d amdb -i amdb1 -n mynode

The following example causes the policy-managed database pmdb, when and if it runs on mynode, to use the instance name pmdb1:

$ srvctl modify instance -d pmdb -i pmdb1 -n mynode

The following example removes the directive established by the previous example:

$ srvctl modify instance -d pmdb -i pmdb1 -z

Syntax and Options

Use the srvctl modify listener command with the following syntax:

srvctl modify listener [-l listener_name] [-o oracle_home] [-u user_name]
     [-p "[TCP:]port_list[/IPC:key][/NMP:pipe_name][/TCPS:s_port][/SDP:port]"]
     [-k network_number]

-l listener_name

-o oracle_home

-u user_name

-p "[TCP:]port_list [/IPC:key][/NMP:pipe_name]
[/TCPS:s_port][/SDP:port]"

-k network_number

Example

The following example changes the TCP ports for the default listener on the node mynode1:

$ srvctl modify listener -l listener1 -p "TCP:1521,1522"

Syntax and Options

Use the srvctl modify network command with one of the following syntax models:

srvctl modify network [-k network_number [-S subnet/netmask[/if1[|if2|...]]]
     [-w network_type] [-v]

-k network_number

-S subnet/netmask
[/if1[|if2|...]]

-w network_type

-v

Examples

The following example changes the subnet number, netmask, and interface list:

$ srvctl modify network -S 192.168.2.0/255.255.255.0/eth0

The following example changes the second network to DHCP:

$ srvctl modify network -k 2 -w dhcp

Syntax and Options

Use the srvctl modify nodeapps command with one of the following syntax models:

srvctl modify nodeapps [-n node_name -A new_vip_address]
[-S subnet/netmask[/if1[|if2|...]] [-u network_type]
     [-e em_port] [-l ons_local_port] [-r ons_remote_port]
     [-t host[:port][,host:port,...]] [-v]

-n node_name

-A new_vip_address/
netmask

-S subnet/netmask
[/if1[|if2|...]]

-u network_type

-e em_port

-l ons_local_port

-r ons_remote_port

-t host:port, [host:port,...]

-v

Example

The following example changes the nodeapps resource on mynode1 to use the application VIP of 100.200.300.40 with a subnet mask of 255.255.255.0 on the network interface eth0:

$ srvctl modify nodeapps -n mynode1 -A 100.200.300.40/255.255.255.0/eth0

Syntax and Options

Use the srvctl modify oc4j command with the following syntax:

srvctl modify oc4j -p oc4j_rmi_port [-v]

-p oc4j_rmi_port

-v

Example

An example of this command is:

$ srvctl modify oc4j -p 5385

Syntax and Options

Use the srvctl modify ons command with the following syntax:

srvctl modify ons [-l ons_local_port] [-r ons_remote_port]
     [-t host[:port][,host[:port]][...]] [-v]

-l ons_local_port

-r ons_remote_port

-t host[:port]
[,host[:port]][...]]

Syntax and Options

Use the srvctl modify scan command with the following syntax:

srvctl modify scan -n scan_name

The only option available for this command is -n scan_name, which identifies the SCAN name that resolves to the SCAN VIPs that you want to use.

Example

Assume your system currently has a SCAN named scan_name1, and it resolves to a single IP address in DNS. If you modify the SCAN scan_name1 in DNS to resolve to three IP addresses, then use the following command to create the additional SCAN VIP resources:

$ srvctl modify scan -n scan_name1

Syntax and Options

Use the srvctl modify scan_listener command with the following syntax:

srvctl modify scan_listener {-p [TCP:]port[/IPC:key][/NMP:pipe_name]
     [/TCPS:s_port][/SDP:port] | -u }

-p [TCP:]port[/IPC:key]
[/NMP:pipe_name]
[/TCPS:s_port][/SDP:port]

-u

Example

Assume your system currently has a SCAN named scan_name1, and you recently modified the DNS entry to resolve to three IP addresses instead of one. After running the srvctl modify scan command to create additional SCAN VIP resources, use the following command to create Oracle Clusterware resources for the additional two SCAN listeners to go with the two additional SCAN VIPs:

$ srvctl modify scan_listener -u

Syntax and Options

Use one of the following forms of the srvctl modify service command with the specified syntax:

To move a service from one instance to another:

srvctl modify service -d db_unique_name -s service_name -i old_instance_name
  -t new_instance_name [-f]

-d db_unique_name

-s service_name

-i old_instance_name

-t new_instance_name

-f

To change an available instance to a preferred instance for a service:

srvctl modify service -d db_unique_name -s service_name -t edition_name
-i avail_inst_name -r [-f]

-d db_unique_name

-s service_name

-t edition_name

-i available_inst_name

-r

-f

To change the available and preferred status for multiple instances:

srvctl modify service -d db_unique_name -s service_name -n -i preferred_list 
     [-a available_list] [-f]

-d db_unique_name

-s service_name

-n

-i preferred_instance_list

-a available_instance_list

-f

To modify other service attributes or to modify a service for Oracle Clusterware:

srvctl modify service -d db_unique_name -s service_name
     [-g server_pool] [-c {UNIFORM|SINGLETON}] [-P {BASIC|PRECONNECT|NONE}] 
     [-l {[PRIMARY] | [PHYSICAL_STANDBY] | [LOGICAL_STANDBY] | [SNAPSHOT_STANDBY]}
     [-q {TRUE|FALSE}] [-x {TRUE|FALSE}] [-j {SHORT|LONG}] 
     [-B {NONE|SERVICE_TIME|THROUGHPUT}] [-e {NONE|SESSION|SELECT}] 
     [-m {NONE|BASIC}] [-z failover_retries] [-w failover_delay]
     [-y {AUTOMATIC | MANUAL}]

-d db_unique_name

-s service_name

-g server_pool

-c {UNIFORM | SINGLETON}

-P {BASIC|PRECONNECT|NONE}

-l {[PRIMARY] | [PHYSICAL
_STANDBY] | [LOGICAL
_STANDBY] | [SNAPSHOT
_STANDBY]}

-q {TRUE | FALSE}

-x {TRUE | FALSE}

-j {SHORT | LONG}

-B {NONE | SERVICE_TIME | THROUGHPUT}

-e {NONE | SESSION | SELECT}

-m {NONE | BASIC}

-z failover_retries

-w failover_delay

-y {AUTOMATIC | MANUAL}

Examples

An example of moving a service member from one instance to another is:

$ srvctl modify service -d crm -s crm -i crm1 -t crm2

An example of changing an available instance to a preferred instance is:

srvctl modify service -d crm -s crm -i crm1 -r

The following command exchanges a preferred and available instance:

$ srvctl modify service -d crm -s crm -n -i crm1 -a crm2

Syntax and Options

Use the srvctl modify srvpool command with the following syntax:

srvctl modify srvpool -g server_pool [-i importance] [-l min_size]
     [-u max_size] [-n node_name_list] [-f]

-g server_pool

-i importance

-l min_size

-u max_size

-n node_name_list

-f

Example

The following example changes the importance rank to 0, the minimum size to 2, and the maximum size to 4 for the server pool srvpool1 on the nodes mynode3 and mynode4:

$ srvctl modify srvpool -g srvpool1 -i 0 -l 2 -u 4 -n mynode3, mynode4

Syntax and Options

Use the srvctl relocate cvu command with the following syntax:

srvctl relocate cvu [-n node_name]

-n node_name

Examples

An example of this command to temporarily relocate CVU to another node in a cluster is:

$ srvctl relocate cvu -n crmnode2

Syntax and Options

Use the srvctl relocate gns command with the following syntax:

srvctl relocate gns [-n node_name]

-n node_name

Example

An example of this command is:

$ srvctl relocate gns -n node1

Syntax and Options

Use the srvctl relocate oc4j command with the following syntax:

srvctl relocate oc4j [-n node_name] [-v]

-n node_name

Example

An example of this command is:

$ srvctl relocate oc4j -n staih01 -v

Syntax and Options

Use the srvctl relocate scan command with the following syntax:

srvctl relocate scan -i ordinal_number [-n node_name]

-i ordinal_number

-n node_name

Example

An example of this command is:

$ srvctl relocate scan -i 1 -n node1

Syntax and Options

Use the srvctl relocate scan_listener command with the following syntax:

srvctl relocate scan_listener -i ordinal_number [-n node_name]

-i ordinal_number

-n node_name

Example

An example of this command is:

$ srvctl relocate scan_listener -i 1 -n node3

Syntax and Options

Use the srvctl relocate server command with the following syntax:

srvctl relocate server -n "server_name_list" -g server_pool_name [-f]

-n "server_name_list"

-g server_pool_name

-f

Example

An example of this command is:

$ srvctl relocate server -n "server1, server2" -g sp3

Syntax and Options

Use the srvctl relocate service command with the following syntax:

srvctl relocate service -d db_unique_name -s service_name
    {-c source_node -n target_node | -i old_instance_name -t new_instance_name}
    [-f]

-d db_unique_name

-s service_name

-c source_node

-n target_node

-i old_instance_name

-t new_instance_name

-f

Example

To temporarily relocate a named service member from crm1 to crm3:

$ srvctl relocate service -d crm -s crm -i crm1 -t crm3

Syntax and Options

Use the srvctl relocate vip command with the following syntax:

srvctl relocate vip -i vip_name [-n node_name] [-f]

-i vip_name

-n node_name

-f

Example

An example of this command is:

$ srvctl relocate vip -i vip1 -n node3

Syntax and Options

Use the srvctl remove asm command with the following syntax:

srvctl remove asm [-f]

The -f option is the only option you can use with this command and it forcefully removes an Oracle ASM resource.

Example

An example of this command is:

$ srvctl remove asm -f

Syntax and Options

Use the srvctl remove cvu command with the following syntax:

srvctl remove cvu [-f]

Use the -f option to remove a running or starting CVU.

Examples

An example of this command to remove CVU is:

$ srvctl remove cvu -f

Syntax and Options

Use the srvctl remove database command with the following syntax:

srvctl remove database -d db_unique_name [-f] [-y]

-d db_unique_name

-f

-y

Example

An example of this command is:

$ srvctl remove database -d crm

Syntax and Options

Use the srvctl remove diskgroup command with the following syntax:

srvctl remove diskgroup -g diskgroup_name [-n node_list] [-f]

-g diskgroup_name

-n node_list

-f

Example

An example of this command is:

$ srvctl remove diskgroup -g DG1 -f

Syntax and Options

Use the srvctl remove filesystem command with the following syntax:

srvctl remove filesystem -d volume_device_name [-f]

-d volume_device_name

-f

Example

An example of this command is:

$ srvctl remove filesystem -d /dev/asm/d1volume293

Syntax and Options

Use the srvctl remove gns command with the following syntax:

srvctl remove gns [-f]

The only option for this command is -f, which indicates GNS should be removed regardless of any errors that might occur.

Example

An example of this command is:

$ srvctl remove gns

Syntax and Options

Use the srvctl remove instance command with the following syntax:

srvctl remove instance -d db_unique_name -i instance_name [-f]

-d db_unique_name

-i instance_name

-f

Example

An example of this command is:

$ srvctl remove instance -d crm -i crm01

Syntax and Options

Use the srvctl remove listener command with the following syntax:

srvctl remove listener [-l listener_name] [-a] [-f]

-l listener_name

-a

-f

Examples

The following command removes the configuration of the listener named lsnr01:

$ srvctl remove listener -l lsnr01

Syntax

Use the srvctl remove nodeapps command as follows:

srvctl remove nodeapps [-f] [-y] [-v]

Example

An example of this command is:

# srvctl remove nodeapps

-f

-y

-v

Syntax and Options

Use the srvctl remove oc4j command with the following syntax:

srvctl remove oc4j [-f] [-v]

-f

-v

Syntax and Options

Use the srvctl remove ons command with the following syntax:

srvctl remove ons [-f] [-v]

-f

-v

Syntax and Options

Use the srvctl remove scan command with the following syntax:

srvctl remove scan [-f]

The only option available for this command is -f, which removes the SCAN VIPs even though there are SCAN listeners running that are dependent on the SCAN VIPs. SCAN VIPs that are running are not stopped before the resources are removed, which may require manual cleanup.

Example

An example of this command is:

$ srvctl remove scan -f

Syntax and Options

Use the srvctl remove scan_listener command with the following syntax:

srvctl remove scan_listener [-f]

The only option available for this command is -f, which removes the resource even if the listener(s) is running, without stopping the listener.

Example

An example of this command is:

$ srvctl remove scan_listener -f

Syntax and Options

Use the srvctl remove service command as follows:

srvctl remove service -d db_unique_name -s service_name [-i instance_name] [-f]

-d db_unique_name

-s service_name

-i instance_name

-f

Examples

An example of this command is:

$ srvctl remove service -d crm -s sales

The following example removes the services from specific instances:

$ srvctl remove service -d crm -s sales -i crm01,crm02

Syntax and Options

Use the srvctl remove srvpool command with the following syntax:

srvctl remove srvpool -g server_pool

Example

An example of this command is:

$ srvctl remove srvpool -g srvpool1

Syntax and Options

Use the srvctl remove vip command with the following syntax:

srvctl remove vip -i "vip_name_list" [-f] [-y] [-v]

-i "vip_name_list"

-f

-y

-v

Example

An example of this command is:

$ srvctl remove vip -i "vip1,vip2,vip3" -f -y -v

Syntax and Options

Use the srvctl setenv asm command with the following syntax:

srvctl setenv asm {-t "name=val[,name=val][...]" | -T "name=val"}

-t "name=val[,name=val][...]"

-T "name=val"

Example

The following example sets the language environment configuration for Oracle ASM:

$ srvctl setenv asm -t LANG=en

Syntax and Options

Use the srvctl setenv database command with the following syntax:

srvctl setenv database -d db_unique_name 
     {-t "name=val[,name=val][...]" | -T "name=val"}

-d db_unique_name

-t "name=val,..."

-T "name=val"

Example

The following example sets the language environment configuration for a cluster database:

$ srvctl setenv database -d crm -t LANG=en

Syntax and Options

Use the srvctl setenv listener with the following syntax:

srvctl setenv listener [-l listener_name] 
     {-t "name=val[,name=val][...]" | -T "name=val"}

-l listener_name

-t "name=val"

-T "name=val"

Example

The following example sets the language environment configuration for the default listener:

$ srvctl setenv listener -t LANG=en

Syntax and Options

Use the srvctl setenv nodeapps command as follows:

srvctl setenv nodeapps {-t "name=val[,name=val][...]" | -T "name=val"} [-v]