This command must be run only one time from the Oracle Grid Infrastructure home.

Syntax

srvctl add asm [-listener listener_name] [-pwfile password_file_path
    [-flex [-count {number_of_instances | ALL}] | -proxy [-spfile server_parameter_file_path]]

Parameters

-listener listener_name

-pwfile password_file_path

-flex [-count {number_of_instances | ALL}] | 
-proxy [-spfile server_parameter_file_path]

Usage Notes

To manage Oracle ASM on Oracle Database 12c and later installations, use the SRVCTL binary in the Oracle Grid Infrastructure home for a cluster (Grid home). If you have Oracle RAC or Oracle Database installed, then you cannot use the SRVCTL binary in the database home to manage Oracle ASM.

Example

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

$ srvctl add asm

Syntax

srvctl config asm [-proxy] [-detail]

Parameters

Usage Notes

To manage Oracle ASM on Oracle Database 12c and later installations, use the SRVCTL binary in the Oracle Grid Infrastructure home for a cluster (Grid home). If you have Oracle RAC or Oracle Database installed, then you cannot use the SRVCTL binary in the database home to manage Oracle ASM.

Example

$ srvctl config asm

ASM Home: /u01/app/21.0.0/grid
ASM Listener: LISTENER
ASM instance count: 3
Password file:

Oracle ASM will restart if it contains Oracle Clusterware data or if the node restarts and it was running before the node failed. The srvctl disable asm command also prevents the srvctl start asm command from starting Oracle ASM instances.

Disabling the Oracle ASM proxy resource prevents the databases and disk groups from starting because they depend on the Oracle ASM proxy resource.

Syntax

srvctl disable asm [-proxy] [-node node_name]

Parameters

Usage Notes

• To manage Oracle ASM on Oracle Database 12c and later installations, use the SRVCTL binary in the Oracle Grid Infrastructure home for a cluster (Grid home). If you have Oracle RAC or Oracle Database installed, then you cannot use the SRVCTL binary in the database home to manage Oracle ASM.

• Oracle ASM is part of the Oracle Clusterware stack and when OCR and voting files are stored on Oracle ASM, then Oracle ASM starts when OHASD starts the Oracle Clusterware stack. The srvctl disable asm command does not prevent the Oracle ASM instance managed by OHASD from starting. Oracle ASM, therefore, starts as needed by the Oracle Clusterware stack.

  The srvctl disable asm command prevents the Oracle ASM Oracle Clusterware proxy resource, and any resources that depend on it, from starting. So, the command prevents Oracle Clusterware-managed objects, such as databases, disk groups, and file systems that depend on Oracle ASM, from starting. For example, the srvctl start database | diskgroup | filesystem command fails to start any of those objects on nodes where the Oracle ASM Oracle Clusterware proxy resource is disabled. The command also prevents the srvctl start asm command from starting Oracle ASM on remote nodes.

Example

$ srvctl disable asm -node crmnode1

Syntax

srvctl enable asm [-proxy] [-node node_name]

Parameters

Usage Notes

To manage Oracle ASM on Oracle Database 12c and later installations, use the SRVCTL binary in the Oracle Grid Infrastructure home for a cluster (Grid home). If you have Oracle RAC or Oracle Database installed, then you cannot use the SRVCTL binary in the database home to manage Oracle ASM.

Example

$ srvctl enable asm -node crmnode1

Syntax

srvctl getenv asm [-envs "name_list"]

Usage Notes

• If you choose not use the -env parameter, then the values of all environment variables associated with Oracle ASM are displayed.

• You can specify a comma-delimited list of the names of environment variables for which you want to retrieve the values.

Example

$ srvctl getenv asm

Syntax

srvctl modify asm [-listener listener_name] [-pwfile password_file_path]
  [-count {number_of_instances | ALL}] [-diskstring asm_diskstring]
  [-spfile spfile_path_name [-proxy] [-force]]

Parameters

Example

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

$ srvctl modify asm -listener lsnr1

Syntax

srvctl predict asm [-node node_name] [-verbose]

Usage Notes

• Optionally, you can specify a particular node on which you want to predict the consequences of an Oracle ASM failure.

• You can choose verbose output.

Example

$ srvctl predict asm -node crmnode2

Syntax

srvctl relocate asm -currentnode current_node [-targetnode target_node] [-force]

Parameters

Usage Notes

• You cannot use this command if there is only one Oracle Flex ASM instance running.

• Because of bootstrap issues between Oracle ASM and Oracle Clusterware, on the node where Oracle Clusterware uses Oracle ASM run either crsctl stop crs or crsctl stop cluster to stop Cluster Ready Services on the node before you relocate the Oracle ASM instance.

Example

An example of this command to relocate an Oracle Flex ASM instance from the current node to a node named hubnode2 is:

$ srvctl relocate asm -currentnode hubnode1 -targetnode hubnode2

Syntax

srvctl remove asm [-proxy] [-force]

Parameters

Example

$ srvctl remove asm -force

Syntax

Use this command with one of the following syntaxes:

srvctl setenv asm -envs "name=value,[...]"

srvctl setenv asm -env "name=value"

Parameters

Example

$ srvctl setenv asm -envs "LANG=en"

Syntax

srvctl start asm [-proxy] [-node node_name [-startoption start_options]]

Parameters

Examples

$ srvctl start asm -node crmnode1

$ srvctl start asm

Syntax

srvctl status asm [-proxy] [-node node_name] [-detail] [-verbose]

Parameters

-proxy

-node node_name

-detail

-verbose

Example

This command returns output similar to the following:

$ srvctl status asm -verbose

ASM is running on node2, node3, node4
iDetailed state on node node2: Started
Detailed state on node node3: Started
Detailed state on node node4: Started

Syntax

srvctl stop asm [-proxy] [-node node_name] [-stopoption stop_options] [-force]

Parameters

Usage Notes

• To manage Oracle ASM on Oracle Database 12c and later installations, use SRVCTL in the Oracle Grid Infrastructure home for a cluster (Grid home). If you have Oracle RAC or Oracle Database installed, then you cannot use SRVCTL in the database home to manage Oracle ASM.

• You cannot use this command when OCR is stored in Oracle ASM because it will not stop Oracle ASM. To stop Oracle ASM you must shut down Oracle Clusterware.

Example

$ srvctl stop asm -node crmnode1 -stopoption IMMEDIATE

Syntax

srvctl unsetenv asm -envs "name_list"

Usage Notes

Use the -envs parameter to specify a comma-delimited list of the names of environment variables enclosed in double quotation marks ("").

Example

$ srvctl unsetenv asm -envs "CLASSPATH"

Syntax

srvctl add asmnetwork [-netnum asm_network_number] [-deptype {optional |
  mandatory}] -subnet subnet[/netmask/if1[|if2...]]

Parameters

Syntax

srvctl config asmnetwork [-netnum asm_network_number]

Usage Notes

Optionally, you can specify an Oracle ASM network number (default number is 1) for which you want to view configuration information.

Syntax

srvctl modify asmnetwork [-netnum asm_network_number] [-deptype {optional | mandatory}]

Parameters

Syntax

srvctl remove asmnetwork {-netnum asm_network_number | -all} [-force]

Parameters

Syntax

srvctl add cdp [-port port_number] [–passfile_admin afile] [-passfile_readonly rfile]

Parameters

Syntax

srvctl config cdp [-cdpnumber cdp_ordinal_number]

Usage Notes

You can optionally specify the ordinal number of a specific cross-cluster dependency proxy resource for which you want to display configuration information. If you do not specify the ordinal number option, then SRVCTL displays the configuration information for all cross-cluster dependency proxy resources in a cluster.

Syntax

srvctl disable cdp [-cdpnumber cdp_ordinal_number]

Usage Notes

You can optionally specify the ordinal number of a specific cross-cluster dependency proxy resource that you want to disable. If you choose not to do so, then SRVCTL disables all cross-cluster dependency proxy resources in a cluster.

Syntax

srvctl enable cdp [-cdpnumber cdp_ordinal_number]

Usage Notes

You can optionally specify the ordinal number of a specific cross-cluster dependency proxy resource that you want to enable. If you choose not to do so, then SRVCTL enables all cross-cluster dependency proxy resources in cluster.

Syntax

srvctl modify cdp [-port port_number] [–passfile_admin afile] [-passfile_readonly rfile]

Parameters

Usage Notes

You must stop the cross-cluster dependency proxy resource before you make any changes.

Syntax

srvctl relocate cdp -cdpnumber cdp_ordinal_number [-node node_name] [-force]

Parameters

Syntax

srvctl remove cdp [-force]

Usage Notes

• Use the –force parameter to remove a running cross-cluster dependency proxy resource.

• This command completely removes all cross-cluster dependency proxy configuration. If you use -force while proxies exist, then the proxies will no longer function until they are re-created.

Syntax

srvctl start cdp [-cdpnumber cdp_ordinal_number] [-node node_name]

Parameters

Syntax

srvctl status cdp [-cdpnumber cdp_ordinal_number]

Usage Notes

You can optionally specify the ordinal number of a specific cross-cluster dependency proxy resource. If you choose not to do so, then SRVCTL returns the status of all cross-cluster dependency proxy resources in the cluster.

Syntax

srvctl stop cdp [-cdpnumber cdp_ordinal_number]

Usage Notes

Optionally, you can stop a specific cross-cluster dependency proxy resource by specifying its identifying ordinal number.

Syntax

srvctl add cdpproxy -client_type client_type -client_name client_name
  [-remote_start {YES|NO}]

Parameters

Usage Notes

• For Oracle Clusterware 18c, the client type is always diskgroup.

• For Oracle Clusterware 18c, the client name is the name of a remote disk group.

Syntax

srvctl config cdpproxy -client_type client_type [-client_name client_name]

Parameters

Usage Notes

• For Oracle Clusterware 18c, the client type is always diskgroup.

• For Oracle Clusterware 18c, the client name is the name of a remote disk group.

Syntax

srvctl disable cdpproxy -client_type client_type -client_name client_name

Parameters

Usage Notes

• For Oracle Clusterware 18c, the client type is always diskgroup.

• For Oracle Clusterware 18c, the client name is the name of a remote disk group.

Syntax

srvctl enable cdpproxy -client_type client_type -client_name client_name

Parameters

Usage Notes

• For Oracle Clusterware 18c, the client type is always diskgroup.

• For Oracle Clusterware 18c, the client name is the name of a remote disk group.

Syntax

srvctl modify cdpproxy -client_type client_type -client_name client_name
  [-remote_start {YES|NO}]

Parameters

Usage Notes

• For Oracle Clusterware 18c, the client type is always diskgroup.

• For Oracle Clusterware 18c, the client name is the name of a remote disk group.

Syntax

srvctl relocate cdpproxy -client_type client_type -client_name client_name
  [-node node_name] [-force]

Parameters

Usage Notes

• For Oracle Clusterware 18c, the client type is always diskgroup.

• For Oracle Clusterware 18c, the client name is the name of a remote disk group.

Syntax

srvctl remove cdpproxy -client_type client_type [-client_name client_name]
  [-force]

Parameters

Usage Notes

• For Oracle Clusterware 18c, the client type is always diskgroup.

• For Oracle Clusterware 18c, the client name is the name of a remote disk group.

Syntax

srvctl start cdpproxy -client_type client_type -client_name client_name
  [-node node_name]

Parameters

Usage Notes

• For Oracle Clusterware 18c, the client type is always diskgroup.

• For Oracle Clusterware 18c, the client name is the name of a remote disk group.

Syntax

srvctl status cdpproxy -client_type client_type -client_name client_name]

Parameters

Usage Notes

• For Oracle Clusterware 18c, the client type is always diskgroup.

• For Oracle Clusterware 18c, the client name is the name of a remote disk group.

Syntax

srvctl stop cdpproxy -client_type client_type -client_name client_name
  [-node node_name]

Parameters

Usage Notes

• For Oracle Clusterware 18c, the client type is always diskgroup.

• For Oracle Clusterware 18c, the client name is the name of a remote disk group.

Syntax and Parameters

Use the srvctl add cvu command with the following syntax:

srvctl add cvu [-checkinterval time_in_minutes]

Usage Notes

• Optionally, you can change the interval between checks. By default, CVU runs once every 6 hours and verifies the health of the cluster. The shortest interval you can specify for CVU check is 10 minutes.

• Run this command while logged in as the Grid home user.

Example

To add CVU with a check interval of 6 hours, use the following command:

$ srvctl add cvu -checkinterval 360

Syntax and Parameters

Use the srvctl config cvu command with the following syntax:

srvctl config cvu

This command has no parameters.

Example

CVU is configured to run once every 360 minutes

Syntax

srvctl disable cvu [-node node_name]

Parameters

Optionally, you can specify the name of a particular node on which you want to disable CVU. Otherwise, SRVCTL disables CVU on all nodes.

Example

An example of this command to disable CVU on a node named crmnode1 is:

$ srvctl disable cvu -node crmnode1

Syntax

srvctl enable cvu [-node node_name]

Parameters

Optionally, you can specify the name of a particular node on which you want to enable CVU. Otherwise, SRVCTL enables CVU on all nodes.

Example

An example of this command to enable CVU on a node named crmnode1 is:

$ srvctl enable cvu -node crmnode1

Syntax

srvctl modify cvu [-checkinterval time_in_minutes]

Parameters

By default, CVU runs once every 360 minutes (six hours) and verifies the health of cluster. If you change the interval, then the shortest interval you can specify for CVU check is 10 minutes.

Example

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

$ srvctl modify cvu -checkinterval 240

Syntax

srvctl relocate cvu [-node node_name]

Usage Notes

Optionally, you can specify a particular node to which you want to relocate CVU.

Example

$ srvctl relocate cvu -node crmnode2

Syntax

srvctl remove cvu [-force]

Usage Notes

Use the -force parameter to remove a CVU resource that is running or starting.

Syntax

srvctl start cvu [-node node_name]

Usage Notes

Optionally, you can specify a particular node to which you want to start CVU. Otherwise, SRVCTL starts CVU on all nodes.

Example

$ srvctl start cvu -node crmnode1

Syntax

srvctl status cvu [-node node_name]

Usage Notes

Optionally, you can specify a particular node where the CVU resource is running, if it is not the local node.

Example

$ srvctl status cvu -node crmnode1

Syntax

srvctl stop cvu [-force]

Usage Notes

Optionally, you can specify the -force parameter to stop CVU if it is a dependant resource.

Example

$ srvctl stop cvu

Syntax

srvctl add exportfs -name unique_name -id havip_name -path path_to_export
    [-clients export_clients] [-options export_options] [-type NFS | SMB]

Parameters

-clients @netgroup1,
*.example.com,
16.140.0.0, hostname1

Usage Notes

• You cannot use the –clients parameter with —type SMB.

• You must run this command as root on Linux and UNIX platforms.

Example

To export with operating system defaults:

# srvctl add exportfs -name cifsExport -path "/acfs1" -options "browsable = yes,read only = no,comment = acfs1"

To export read-only to certain clients:

# srvctl add exportfs -name export1 -id havip1 -path /u01/db1 -clients node1 -options ro

Syntax

srvctl config exportfs [-name unique_name | -id havip_name]

Parameters

Example

If you specify the -name parameter, then this command returns output similar to the following, whether you specify -name or -id:

$ srvctl config exportfs -id havip1

export file system kep1 is configured
Exported path: /scratch/ghnew/base/mymount3
Export options: 
Export Type: 
Exported clients: 
export file system kexp2 is configured
Exported path: /scratch/ghnew/base/mymount3
Export options: 
Export Type: 
Exported clients: 

Syntax

srvctl disable exportfs -name filesystem_name

Usage Notes

• This command takes only the unique name of the file system you want to disable.

• You must run this command as root user on Linux and UNIX platforms.

Example

The following example disables an export file system called export1:

# srvctl disable exportfs -name export1

Syntax

srvctl enable exportfs -name filesystem_name

This command takes only the name of the file system you want to enable, which is a required parameter.

Usage Notes

You must run this command as the root user on Linux and UNIX platforms.

Example

The following command example enables a file system named export1:

# srvctl enable exportfs -name export1

Syntax

srvctl modify exportfs -name unique_name [-path path_to_export]
    [-clients node_list] [-options nfs_options_string]

Parameters

-clients @netgroup1,*.example.com,16.140.0.0, hostname1

Usage Notes

• You must run this command as root user on Linux and UNIX platforms.

• You must start and stop the NFS export before any changes you make take effect.

Example

The following command example modifies the path of an export file system named exportfs1:

# srvctl modify exportfs -name exportfs1 -path /mnt/racdb1

Syntax

srvctl remove exportfs -name exportfs_name [-force]

Parameters

Usage Notes

• You must run this command as root user on Linux and UNIX platforms.

• If you do not use the -force parameter, then you must first stop the export file system you want to remove before you remove it.

• If you use the -force parameter, then the resulting configuration can cause errors when attempting to shut down the Oracle Clusterware stack.

Examples

To remove the stopped export file system named export1:

# srvctl remove exportfs -name export1

To remove a running export file system, leaving it exported:

# srvctl remove exportfs -name export1 -force

Syntax

srvctl start exportfs {-name unique_name | -id havip_name}

Parameters

Example

To start an export file system:

$ srvctl start exportfs -name export1

Syntax

srvctl status exportfs [-name unique_name | -id havip_name]

Parameters

Usage Notes

If you do not specify any parameters, then SRVCTL displays the status for all NFS exports in the cluster.

Example

$ srvctl status exportfs

export file system export1 is enabled
export file system export1 is not exported
export file system export2 is enabled
export file system export2 is exported on node node1

Syntax

srvctl stop exportfs {-name unique_name | -id havip_name} [-force]

Parameters

Usage Notes

You must run this command as root user on Linux and UNIX platforms.

Example

An example of this command is:

# srvctl stop exportfs -name export1

An Oracle ACFS file system resource is typically created for use with application resource dependency lists. For example, if an Oracle ACFS file system is configured for use as an Oracle Database home, then a resource created for the file system can be included in the resource dependency list of the Oracle Database application. This will cause the file system and stack to be automatically mounted because of the start action of the database application.

Syntax

srvctl add filesystem {-device volume_device | -volume volume_name -diskgroup disk_group_name}
    -path mountpoint_path [-node "node_list" | -serverpool "server_pool_list"] 
    [-user "user_list"] [-mountowner user_name] [-mountgroup group_name] [-mountperm octal_permission] 
    [-fstype {ACFS | EXT3 | EXT4}] [-fsoptions options] [-description description]
    [-appid application_id] [-autostart {ALWAYS | NEVER | RESTORE}] [-acceleratorvols volume_name]

Parameters

Usage Notes

• Use the -device parameter to specify the path to the file system resource for which you want to add, or specify -volume volume_name -diskgroup disk_group_name.

• You must run this command as root user on Linux and UNIX platforms, or as an Administrator user on Windows platforms.

• This command must be run only one time from the Oracle Grid Infrastructure home.

• To manage Oracle ACFS on Oracle Database installations, use the SRVCTL binary in the Oracle Grid Infrastructure home for a cluster (Grid home). If you have Oracle RAC or Oracle Database installed, then you cannot use the SRVCTL binary in the database home to manage Oracle ACFS.

• Standard Edition High Availability (SEHA) databases are supported only on Oracle Database 19c (19.7) release or later.

• This command is only available with Oracle Clusterware.

Examples

# srvctl add filesystem -device /dev/asm/d1volume1-295
  -path /oracle/cluster1/acfs1

# srvctl add filesystem -fstype ACFS -device asm-test-55 -path myacfs
 -node node1,node2,node3

To add an Oracle ACFS file system for configuring Standard Edition High Availability (SEHA) on the sehome volume of the DATA disk group with a mount point of /u01/app/oracle:

# srvctl add filesystem -volume sehome -diskgroup DATA -path /u01/app/oracle -fstype ACFS 
  -autostart ALWAYS -user oracle

Syntax

srvctl config filesystem [-device volume_device | -volume volume_name -diskgroup disk_group_name]

Parameters

Usage Notes

• Use the -device parameter to specify the path to the file system resource for which you want to display the configuration or specify -volume volume_name -diskgroup disk_group_name.

• This command is only available with Oracle Clusterware.

Examples

$ srvctl config filesystem

$ srvctl config filesystem -device /dev/asm/d1volume1-295

Syntax

srvctl disable filesystem {-device volume_device | -volume volume_name -diskgroup disk_group_name}

Parameters

Usage Notes

• Use the -device parameter to specify the path to the file system resource for which you want to disable, or specify -volume volume_name -diskgroup disk_group_name.

• This command is only available with Oracle Clusterware.

Example

# srvctl disable filesystem -device /dev/asm/racvol1

Syntax

srvctl enable filesystem {-device volume_device | -volume volume_name -diskgroup disk_group_name}

Parameters

Usage Notes

• Use the -device parameter to specify the path to the file system resource for which you want to enable, or specify -volume volume_name -diskgroup disk_group_name.

• This command is only available with Oracle Clusterware.

Example

# srvctl enable filesystem -device /dev/asm/racvol1

Syntax

srvctl modify filesystem 
    {-device volume_device | -volume volume_name -diskgroup disk_group_name} 
    [-user {/+|/-}user_name | "user_list"]
    [-mountowner user_name] [-mountgroup group_name] [-mountperm octal_permission] 
    [-path mountpoint_path] [-node "node_list" | -serverpool "server_pool_list"]
    [-fsoptions options] [-description description]
    [-autostart {ALWAYS | NEVER | RESTORE}] [-force]

Parameters

Usage Notes

• Use the -device parameter to specify the path to the file system resource for which you want to modify, or specify -volume volume_name -diskgroup disk_group_name.

• When performing online changes to the file system resource, the changes take effect only after the resource is next (re)started.

• You must run this command as root user on Linux and UNIX platforms.

• This command is only available with Oracle Clusterware.

Example

# srvctl modify filesystem -device /dev/asm/racvol1 -user /+sysad

Syntax

srvctl predict filesystem {-device volume_device | -volume volume_name -diskgroup disk_group_name} [-verbose]

Parameters

Usage Notes

• Specify the -device parameter to specify the path to the file system resource for which you want to predict the consequences of file system failure, or specify -volume volume_name -diskgroup disk_group_name.

• Optionally, you can choose verbose output.

• This command is only available with Oracle Clusterware.

Example

$ srvctl predict filesystem -device /dev/asm/volume1-123

Syntax

srvctl remove filesystem {-device volume_device | -volume volume_name -diskgroup disk_group_name} [-force]

Parameters

Usage Notes

• Specify the -device parameter to specify the path to the file system resource for which you want to remove, or specify -volume volume_name -diskgroup disk_group_name.

• Optionally, you can use the -force parameter to ignore any resource dependencies and forcibly remove the resource from the cluster.

• You must run this command as root user on Linux and UNIX platforms, or as an Administrator user on Windows platforms.

• This command is only available with Oracle Clusterware.

Examples

# srvctl remove filesystem -device /dev/asm/racvol1

Syntax

srvctl start filesystem {-device volume_device | -volume volume_name -diskgroup disk_group_name} [-node node_name]

Parameters

Usage Notes

• Use the -device parameter to specify the path to the file system resource for which you want to start, or specify -volume volume_name -diskgroup disk_group_name.

• You must run this command as root user on Linux and UNIX platforms, or as an Administrator user on Windows platforms, or as a configured file system user.

  If srvctl add filesystem was executed with the -user parameter to identify users authorized to mount and unmount the file system, then you can run srvctl start filesystem as one of the configured file system users.

  See Also:

  srvctl add filesystem for more information about configuring file system users

• This command is only available with Oracle Clusterware.

Examples

$ srvctl start filesystem -device /dev/asm/data_db1-68

$ srvctl start filesystem -device /dev/asm/data_db1-68 -node node1

Syntax

srvctl status filesystem [-device volume_device | -volume volume_name -diskgroup disk_group_name] [-verbose]

Parameters

Usage Notes

• Optionally, you can use the -device parameter to specify the path to the file system resource for which you want to obtain status, or specify -volume volume_name -diskgroup disk_group_name. If you do not specify -device or -volume -diskgroup, then SRVCTL displays the status of all file systems.

• This command is only available with Oracle Clusterware.

Examples

You can specify a device, or volume and disk group.

$ srvctl status filesystem -d /dev/asm/fs1vol-358
ACFS file system /acfs/fs1 is not mounted

$ srvctl start filesystem -d /dev/asm/fs1vol-358
...
$ srvctl status filesystem -d /dev/asm/fs1vol-358
ACFS file system /acfs/fs1 is mounted on nodes nd1-4n-01,nd1-4n-02,nd1-4n-03,nd1-4n-04

$ srvctl status filesystem -volume fs1vol -diskgroup DATA
ACFS file system /acfs/fs1 is mounted on nodes nd1-4n-01,nd1-4n-02,nd1-4n-03,nd1-4n-04

$ srvctl status filesystem
ACFS file system /acfs/fs1 is mounted on nodes nd1-4n-01,nd1-4n-02,nd1-4n-03,nd1-4n-04

Syntax

srvctl stop filesystem {-device volume_device | -volume volume_name -diskgroup disk_group_name} [-node node_name] [-force]

Parameters

Usage Notes

• Use the -device parameter to specify the path to the file system resource for which you want to stop, or specify -volume volume_name -diskgroup disk_group_name.

• You must run this command as root user on Linux and UNIX platforms, or as an Administrator user on Windows platforms, or as a configured file system user.

  If srvctl add filesystem was executed with the -user parameter to identify users authorized to mount and unmount the file system, then you can run srvctl stop filesystem as one of the configured file system users.

  See Also:

  srvctl add filesystem for more information about configuring file system users

• This command is only available with Oracle Clusterware.

Example

# srvctl stop filesystem -device /dev/asm/racvol_1 -force

Syntax

Use the srvctl add gns command with one of the following syntax models:

To add GNS to a cluster that is not currently running GNS:

srvctl add gns [-domain domain_name] -vip {vip_name | ip_address} [-skip] [-verbose]

To change a cluster that is not running GNS to be a client cluster of another cluster that is running GNS:

srvctl add gns -clientdata file_name

To add a secondary GNS to a cluster:

srvctl add gns -vip vip_name | ip_address -clientdata file_name

Parameters

Usage Notes

• You must run this command as root user on Linux and UNIX platforms, or as an Administrator user on Windows platforms.

• When you are adding GNS to a cluster for the first time, use the -vip parameter with the -domain parameter.

• When you are adding GNS to a cluster using the -clientdata parameter, you must first export the GNS data to a file and manually copy the file to a node in the cluster you are adding. Use the -clientdata parameter and run this command on any node in the cluster.

• You can only specify the -vip and -clientdata parameters at the same time when you are adding a secondary GNS.

Examples

To add GNS to a cluster, making it a server cluster:

# srvctl add gns -vip 192.168.16.17 -domain cluster.mycompany.com

To add GNS to a cluster, making it a client cluster:

# srvctl add gns -clientdata /tmp/gnsdata

Syntax

srvctl config gns [-detail] [-subdomain] [-multicastport] [-node node_name] [-port] [-status]
  [-version] [-query name] [-list] [-clusterguid] [-clustername] [-clustertype] [-loglevel]
  [-network] [-role] [-instances]

Parameters

Syntax

srvctl disable gns [-node node_name] [-verbose]

Usage Notes

• Optionally, you can specify the name of a node in the cluster on which you want to disable GNS. If you do not specify this parameter, then SRVCTL disables GNS for the entire cluster.

• Optionally, you can use the -verbose parameter to display detailed output.

Example

$ srvctl disable gns -node crm7

Syntax

srvctl enable gns [-node node_name] [-verbose]

Usage Notes

• Optionally, you can specify the name of a node on which you want to enable GNS. If you do not specify this parameter, then SRVCTL enables GNS on all nodes in the cluster.

• Optionally, you can use the -verbose parameter to print detailed output.

Example

$ srvctl enable gns -node node1

Syntax

srvctl export gns {-instance path_to_file | {-clientdata path_to_file -role {CLIENT|SECONDARY} [-version]}}

Parameters

Example

The following command exports the GNS credentials data to a file named gns.txt:

$ srvctl export gns -clientdata /temp/gnsdata/gns.txt

Syntax

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

srvctl modify gns -loglevel log_level

or

srvctl modify gns [-resolve name] [-verify name]
  [-parameter name:value[,name:value...]]
  [-vip {vip_name | ip} [-skip]] [-clientdata file_name]
  [-role {PRIMARY} [-force]] [-verbose]

Parameters

Examples

An example of this command is:

$ srvctl modify gns -vip 192.0.2.15

Syntax

srvctl relocate gns [-node node_name] [-verbose]

Usage Notes

• Optionally, you can specify the name of a node to which you want to move GNS.

• Optionally, you can use the -verbose parameter to display verbose output.

• On Linux and UNIX systems, you must be logged in as root and on Windows, you must be logged in as a user with Administrator privileges to run this command.

Example

# srvctl relocate gns -node node1

Syntax

srvctl remove gns [-force] [-verbose]

Usage Notes

• Optionally, you can use the -force parameter to forcibly remove GNS from the cluster, regardless of any errors that might occur.

• Optionally, you can use the -verbose parameter to display verbose output.

Example

$ srvctl remove gns

Syntax

srvctl start gns [-loglevel log_level] [-node node_name] [-verbose]

Parameters

Usage Notes

You can only run this command in the server cluster. If you attempt to run this command in a client cluster, then an error occurs.

Example

An example of this command to start the GNS on the cluster node named crmnode1 is:

$ srvctl start gns -node crmnode1

Syntax

srvctl status gns [-node node_name] [-verbose]

Usage Notes

• Optionally, you can specify a node on which GNS is running for which you want to display the state.

• Optionally, you can use the -verbose parameter to display detailed output.

Syntax

srvctl stop gns [-node node_name] [-force] [-verbose]

Usage Notes

• Optionally, you can specify the name of a node on which GNS is running that you want to stop.

• Optionally, you can use -force and -verbose to forcibly stop GNS and print detailed output, respectively.

Example

$ srvctl stop gns

Syntax

Use the srvctl update gns command with one of these syntax models:

srvctl update gns -advertise name -address ip_address [-timetolive time_to_live
]
  [-verbose]

srvctl update gns -delete name [-address address] [-verbose]

srvctl update gns -alias alias -name name [-timetolive time_to_live] [-verbose]

srvctl update gns -deletealias alias [-verbose]

srvctl update gns -createsrv service -target target -protocol protocol
  [-weight weight] [-priority priority] [-port port_number]
  [-timetolive time_to_live] [-instance instance_name] [-verbose]

srvctl update gns -deletesrv service_name -target target -protocol protocol
   [-verbose]

srvctl update gns -createtxt name -target target [-timetolive time_to_live]
   [-namettl name_ttl] [-verbose]

srvctl update gns -deletetxt name -target target [-verbose]

srvctl update gns -createptr name -target target [-timetolive time_to_live]
   [-namettl name_ttl] [-verbose]

srvctl update gns -deleteptr name -target target [-verbose]

Parameters

Usage Notes

You must be logged in as the root user on Linux and UNIX platforms, or as an Administrator user on Windows platforms, to run this command.

Example

# srvctl update gns -advertise myname -address 192.168.1.45

Syntax

srvctl add havip -id havip_name -address {host_name | ip_address}
    [-netnum network_number] [-description text] [-skip] [-homenode node_name]

Parameters

Example

An example of this command is:

# srvctl add havip -id myhavip -address 192.0.2.1 -netnum 2 -description
    "My HA VIP" -skip -homenode myNode2

Syntax

Use the srvctl config havip command with the following syntax:

srvctl config havip [-id havip_name]

Parameters

Example

This command returns output similar to the following:

$ srvctl config havip -id hrexports

VIP: /mjk-vm3-vip/10.149.237.196/10.149.236.0/255.255.252.0/eth0
Description: HR Exports

Syntax

srvctl disable havip -id havip_name [-node node1,node2,...,noden]

Parameters

Usage Notes

You must run this command as root user on Linux and UNIX platforms.

Example

An example of this command is:

# srvctl disable havip -id myhavip -node myNode1,myNode3

Syntax

srvctl enable havip -id havip_name [-node node_name]

Parameters

Usage Notes

You must run this command as root user on Linux and UNIX platforms.

Examples

An example of this command is:

# srvctl enable havip -id myhavip -node myNode1

Syntax

srvctl modify havip -id havip_name [-address {host_name | ip_address}
    [-netnum network_number] [-skip]] [-description text] [-homenode node_name]

Parameters

Usage Notes

You must run this command as root user on Linux and UNIX platforms.

Example

An example of this command is:

# srvctl modify havip -id myhavip -address 192.168.16.17 -netnum 2

Syntax

srvctl relocate havip -id havip_name [-node node_name] [-force]

Parameters

Example

An example of this command is:

$ srvctl relocate havip -id myhavip -node node3

Syntax

srvctl remove havip -id havip_name [-force]

Parameters

Usage Notes

• You must first stop the HAVIP resource before you attempt to remove it.

• You must run this command as root user on Linux and UNIX platforms.

Example

An example of this command is:

# srvctl remove havip -id myhavip -force

Syntax

srvctl start havip -id havip_name [-node node_name]

Parameters

Usage Notes

You must run this command as root user on Linux and UNIX platforms.

Example

An example of this command is:

# srvctl start havip -id myhavip -node myNode1

Syntax

srvctl status havip [-id havip_name]

Usage Notes

Specify the unique name of the HAVIP resource you want to display. If you do not specify this parameter, then SRVCTL displays the status of all HAVIPs known to Oracle Clusterware.

Example

This command returns output similar to the following:

$ srvctl status havip

HAVIP ora.ha1.havip is enabled
HAVIP ora.ha1.havip is not running

Syntax

srvctl stop havip -id havip_name [-node node_name] [-force]

Parameters

Usage Notes

You must run this command as root user on Linux and UNIX platforms.

Examples

An example of this command is:

# srvctl stop havip -id myhavip -node myNode1 -force

When you configure, upgrade, or convert from a standard cluster to an Oracle Flex Cluster you can create Oracle ASM IOServers on the Hub nodes in the cluster.

Syntax

srvctl add ioserver [-spfile spfile] [-count number_of_ioserver_instances| ALL] [-listener listener_name]

Parameters

-spfile spfile

-count number_of_ioserver_instances| ALL

-listener listener_name

Example

An example of this command is:

# srvctl add ioserver -count 2

Syntax

srvctl config ioserver

Usage Notes

This command has no parameters.

Example

This command displays output similar to the following:

$ srvctl config ioserver
ASM I/O Server instance count: 3
ASM I/O Server is enabled. 
ASM I/O server is enabled on nodes:
ASM I/O server is disabled on nodes:

Syntax

srvctl disable ioserver -node node_name

Usage Notes

Use the -node parameter to specify the name of a Hub node on which you want to disable an Oracle ASM IOServer.

Syntax

srvctl enable ioserver [-node node_name]

Usage Notes

Use the -node parameter to specify the name of a Hub node on which you want to enable an Oracle ASM IOServer.

Syntax

srvctl getenv ioserver [-envs "name_list"]

Usage Notes

Specify a comma-delimited list of the names of environment variables. If you do not specify this parameter, then SRVCTL displays the values of all environment variables associated with the database.

Syntax

srvctl modify ioserver [-spfile spfile] [-count number_of_ioserver_instances | ALL]
  [-listener listener_name] [-force] 

Parameters

Syntax

srvctl relocate ioserver -currentnode node_name [-targetnode node_name] [-force]

Parameters

Example

The following command relocates the Oracle ASM IOServer from a node called crsNode2 to a node called crsNode5:

$ srvctl relocate ioserver -currentnode crsNode2 -targetnode crsNode5

Syntax

srvctl remove ioserver [-force]

Usage Notes

Use the -force parameter to forcibly remove the Oracle ASM IOServer instance, ignoring any dependencies.

Syntax

srvctl setenv ioserver {-envs "name=val[,name=val][...]" | -env "name=val"}

Parameters

You can also start an Oracle ASM IOServer on a particular Hub Node by specifying the node name.

Syntax

srvctl start ioserver [-node node_name]

Usage Notes

If you choose to start an Oracle ASM IOServer on a particular Hub Node, then use the -node parameter and specify the name of the node. If you do not specify a particular Hub Node, then SRVCTL starts all Oracle ASM IOServers in the cluster.

Example

The following command starts an Oracle ASM IOServer on a Hub node named mjkhub46:

$ srvctl start ioserver -node mjkhub46

You can display the status of all Oracle ASM IOServers running a cluster, the status of an Oracle ASM IOServer running on a particular Hub Node, or the information about clients from a specific database.

Syntax

srvctl status ioserver [-node node_name] [-detail]

Parameters

Example

If you run the command with the -detail parameter, then SRVCTL displays output similar to the following:

$ srvctl status ioserver -detail
ASM I/O Server is enabled
ASM I/O Server is running on nodes: mjk376, mjk377

ASM I/O Server instance +IOS1 running on node mjk376 is connected to ASM instance +ASM2:
Number of clients connected: 2
Names of clients: later14, alus16, later12, alus9, db0010

ASM I/O Server instance +IOS2 running on node mjk377 is connected to ASM instance +ASM3:
Number of clients connected: 3
Number of requests completed per sec: 110
Names of networks: eth1, eth2
Names of clients: later11, later3, later14, later15, later16, alus19, alus17, alus13

Syntax

srvctl stop ioserver [-node node_name] [-force]

Usage Notes

• Use the -node parameter to stop an Oracle ASM IOServer on a particular Hub Node. If you do not specify a particular Hub Node, then SRVCTL stops all of the Oracle ASM IOServers in the cluster.

• Use the -force parameter to stop an Oracle ASM IOServer, regardless of any dependencies.

Syntax

srvctl unsetenv ioserver -envs "name_list"

Usage Notes

Use the -envs parameter to specify a comma-delimited list of the names of environment variables enclosed in double quotation marks ("").

Syntax

srvctl add mgmtdb [-domain domain]

Usage Notes

Optionally, you can specify the domain for the database. If you have the DB_DOMAIN database initialization parameter set, then you must provide a value for this parameter.

Example

$ srvctl add mgmtdb -domain example.com

Syntax

srvctl config mgmtdb [-verbose] [-all]

Usage Notes

• Optionally, use the -verbose parameter to print detailed output.

• Optionally, use the -all parameter to print detailed configuration information.

Syntax

srvctl disable mgmtdb [-node node_name]

Usage Notes

Optionally, you can specify the name of a cluster node on which the management database you want to disable is running.

Example

$ srvctl disable mgmtdb

Syntax

srvctl enable mgmtdb [-node node_name]

Usage Notes

Optionally, you can specify the name of a cluster node on which you want to enable a management database resource.

Example

$ srvctl enable mgmtdb -node node5

Syntax

srvctl getenv mgmtdb [-envs "name_list"]

Usage Notes

Specify a comma-delimited list of the names of environment variables enclosed in double quotation marks (""). If you do not use this parameter, then SRVCTL displays the values of all environment variables associated with the listener.

Example

$ srvctl getenv mgmtdb

Syntax

srvctl modify mgmtdb [-pwfile password_file_path] [-spfile spfile_path]
  [-startoption start_option] [-stopoption stop_option] [-diskgroup "diskgroup_list"]

Parameters

Example

$ srvctl modify mgmtdb -diskgroup "SYSFILES"

Syntax

srvctl relocate mgmtdb [-node node_name]

Usage Notes

Specify a node to which you want to relocate the management database.

Example

$ srvctl relocate mgmtdb -node crsNode2

Syntax

srvctl remove mgmtdb [-force] [-noprompt] [-verbose]

Parameters

Usage Notes

You must first shut down the management database before you attempt to remove it.

Example

$ srvctl remove mgmtdb -noprompt

Syntax

Use this command with one of these syntax models:

srvctl setenv mgmtdb -envs "name=val[,...]"

srvctl setenv mgmtdb -env "name=val"

Parameters

Example

$ srvctl setenv mgmtdb -env LANG=en

Syntax

srvctl start mgmtdb [-startoption start_options] [-node node_name]

Parameters

Example

$ srvctl start mgmtdb -node crmnode1

Syntax

srvctl status mgmtdb [-verbose]

Usage Notes

Optionally, you can use the -verbose parameter to display detailed output.

Example

$ srvctl status mgmtdb

Syntax

srvctl stop mgmtdb [-stopoption stop_options] [-force]

Parameters

Example

$ srvctl stop mgmtdb -stopoption NORMAL

Syntax

srvctl unsetenv mgmtdb -envs "name_list"

Usage Notes

Use the -envs parameter to specify a comma-delimited list of the names of environment variables enclosed in double quotation marks ("").

Example

$ srvctl unsetenv mgmtdb -envs "LANG"

Syntax

srvctl add mgmtlsnr [-endpoints "[TCP:]port_list[/IPC:key][/NMP:pipe_name
  [/TCPS:s_port][/SDP:port][/EXADIRECT:port]"] [-skip]]

Parameters

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

-skip

Example

The following command adds a management listener that is listening on port 1341 to the cluster:

$ srvctl add mgmtlsnr -endpoints "TCP:1341"

Syntax

srvctl config mgmtlsnr [-all]

Usage Notes

Use the -all parameter to print detailed configuration information.

Syntax

srvctl disable mgmtlsnr [-node node_name]

Usage Notes

Optionally, you can specify the name of a cluster node on which the management listener you want to disable is running.

Example

$ srvctl disable mgmtlsnr

Syntax

srvctl enable mgmtlsnr [-node node_name]

Usage Notes

Optionally, you can specify the name of a cluster node on which you want to enable a management listener.

Example

$ srvctl enable mgmtlsnr -node node5

Syntax

srvctl getenv mgmtlsnr [-envs "name_list"]

Usage Notes

Optionally, you can specify a comma-delimited list of environment variable names. If you do not use this parameter, then SRVCTL displays the values of all environment variables associated with the listener.

Example

$ srvctl getenv mgmtlsnr

Syntax

srvctl modify mgmtlsnr [-endpoints "[TCP:]port_list[/IPC:key][/NMP:pipe_name]
   [/TCPS:s_port][/SDP:port]"]

Usage Notes

Optionally, you can specify protocol specifications for the management listener. port_list is comma-delimited list of port numbers. You can also modify this attribute using Online Resource Attribute Modification.

Example

$ srvctl modify mgmtlsnr -endpoints "TCP:2521,2522"

Syntax

srvctl remove mgmtlsnr [-force]

Usage Notes

Use the -force parameter to forcibly remove the management listener, ignoring any dependencies.

Example

$ srvctl remove mgmtlsnr

Syntax

Use this command with one of the following syntax models:

srvctl setenv mgmtlsnr -envs "name=val[,...]"

srvctl setenv mgmtlsnr -env "name=val"

Parameters

Example

$ srvctl setenv mgmtlsnr -env LANG=en

Syntax

srvctl start mgmtlsnr [-node node_name]

Usage Notes

Specify the node on which you want to start the management listener.

Example

$ srvctl start mgmtlsnr -node crmnode1

Syntax

srvctl status mgmtlsnr [-node node_name] [-verbose]

Usage Notes

• Optionally, you can specify the name of a cluster node.

• Optionally, use the -verbose parameter to display detailed output.

Examples

$ srvctl status mgmtlsnr -node node2

Syntax

srvctl stop mgmtlsnr [-node node_name] [-force]

Usage Notes

• Optionally, you can specify the name of a single node on which the management listener runs.

• Optionally, you can use the -force parameter to forcibly stop the management listener.

Example

$ srvctl stop mgmtlsnr -node mynode1

Syntax

srvctl unsetenv mgmtlsnr -envs "name_list"

Usage Notes

Use the -envs parameter to specify a comma-delimited list of the names of environment variables enclosed in double quotation marks ("").

Example

$ srvctl unsetenv mgmtlsnr -envs "LANG"

Syntax

srvctl add mountfs -name mountfs_name -path mount_path -exportserver server_name
   -exportpath path [-mountoptions mount_options] [-user user]

Parameters

Syntax

srvctl config mountfs [-name mountfs_name]

Usage Notes

Specify the unique name of the NAS for which you want to display configuration information.

Syntax

srvctl disable mountfs -name mountfs_name [-node node_list]

Parameters

Syntax

srvctl enable mountfs -name mountfs_name [-node node_list]

Parameters

Syntax

srvctl modify mountfs -name mountfs_name [-path mount_path] [-exportserver server_name]
   [-exportpath path] [-mountoptions mount_options] [-user user_name]

Parameters

Syntax

srvctl remove mountfs -name mountfs_name [-force]

Usage Notes

• Specify the unique name for the NAS to mount.

• Optionally, you can use the -force parameter to ignore resource dependencies while removing the NAS.

Syntax

srvctl start mountfs -name mountfs_name [-node node_list]

Parameters

Syntax

srvctl status mountfs -name mountfs_name

Usage Notes

Specify the unique name of the NAS for which you want to display the status.

Syntax

srvctl stop mountfs -name mountfs_name [-node node_list] [-force]

Parameters

Syntax

srvctl add netstorageservice -device volume_device

Parameters

Examples

To add the netstorageservice resource:

$ srvctl add netstorageservice -device /dev/asm/data_db1-68

Syntax

srvctl config netstorageservice

Examples

To list the netstorageservice resource configuration details:

$ srvctl config netstorageservice

Syntax

srvctl disable netstorageservice [-node node_name]

Parameters

Examples

To disable the netstorageservice resource on a specified node:

$ srvctl disable netstorageservice -node node1

Syntax

srvctl enable netstorageservice [-node node_name]

Parameters

Examples

To enable the netstorageservice resource on a specified node:

$ srvctl enable netstorageservice -node node1

Syntax

srvctl remove netstorageservice [-force]

Parameters

Examples

To remove the netstorageservice resource:

$ srvctl remove netstorageservice

Syntax

srvctl start netstorageservice [-node node_name]

Parameters

Examples

To start the netstorageservice resource on a specified node:

$ srvctl start netstorageservice -node node1

Syntax

srvctl status netstorageservice

Examples

To display the status of the netstorageservice resource:

$ srvctl status netstorageservice

Syntax

srvctl stop netstorageservice [-node node_name] [-force]

Parameters

Examples

To stop the netstorageservice resource on a specified node:

$ srvctl stop netstorageservice -node node1

Syntax

srvctl add ovmm -wallet certificate_wallet_file -username user_name -ovmmhost host_name | ip_address
  -ovmmport port_number [-autologin]

Parameters

Usage Notes

You must run this command as root or equivalent user.

Example

An example of this command is:

# srvctl add ovmm -username scott -wallet /tmp/ovmmcred/cwallet.sso -ovmmhost node1 -ovmmport 80

Syntax

srvctl config ovmm

Usage Notes

This command takes no parameters.

Example

This command returns output similar to the following:

$ srvctl config ovmm

OVMM Host: host1
OVMM Port: 80

Syntax

srvctl modify ovmm [-wallet certificate_wallet_file [-autologin]] [-username user_name]
   [-ovmmhost host_name | ip_address [-ovmmport port_number]

Parameters

Usage Notes

• You must run this command as root or equivalent user.

• The srvctl modify ovmm command deletes all credentials before writing new ones.

Example

An example of this command is:

$ srvctl modify ovmm -username scott -ovmport 81

Syntax

srvctl remove ovmm

Usage Notes

• You must run this command as root or equivalent user.

• This command takes no parameters.

Example

An example of this command is:

# srvctl remove ovmm

Syntax

srvctl add qosmserver [-verbose]

Usage Notes

Optionally, you can use the -verbose parameter to display verbose output.

Example

The following command adds an Oracle Database QoS Management Server instance:

$ srvctl add qosmserver

Syntax

srvctl config qosmserver

Parameters

This command has no parameters.

Example

The following command displays the configuration information for the qosmserver resource.

$ srvctl config qosmserver

Syntax

srvctl disable qosmserver [-node node_name] [-verbose]

Usage Notes

With this command you can optionally specify a particular node on which to disable an Oracle Database QoS Management Server instance, and you can also choose verbose output.

Example

The following example disables the Oracle Database QoS Management Server on a node called crsNode3:

$ srvctl disable qosmserver -node crsNode3

Syntax

srvctl enable qosmserver [-node node_name] [-verbose]

Usage Notes

With this command you can optionally specify a particular node on which to enable an Oracle Database QoS Management Server instance, and you can also choose verbose output.

Example

The following command example enables an Oracle Database QoS Management Server instance on a node named crsNode3:

$ srvctl enable qosmserver -node crsNode3

Syntax

srvctl modify qosmserver  
[-rmiport qosmserver_rmi_port]
[-httpport qosmserver_http_port]
[-secure '{YES|NO}']
[-enableHTTPS '{YES|NO}']
[-verbose]
[-force]