1. Clusterware Administration and Deployment Guide
  2. Oracle Clusterware Control (CRSCTL) Utility Reference

E Oracle Clusterware Control (CRSCTL) Utility Reference

This appendix contains reference information for the Oracle Clusterware Control (CRSCTL) utility.

Note:

Starting with Oracle Grid Infrastructure 23ai, Domain Services Clusters (DSC), which is part of the Oracle Cluster Domain architecture, are desupported.

Oracle Cluster Domains consist of a Domain Services Cluster (DSC) and Member Clusters. Member Clusters were deprecated in Oracle Grid Infrastructure 19c. The DSC continues to be available to provide services to production clusters. However, with most of those services no longer requiring the DSC for hosting, installation of DSCs are desupported in Oracle Database 23ai. Oracle recommends that you use any cluster or system of your choice for services previously hosted on the DSC, if applicable. Oracle will continue to support the DSC for hosting shared services, until each service can be used on alternative systems.

Note:

Do not use CRSCTL commands on Oracle entities (such as resources and resource types) that have names beginning with ora unless you are directed to do so by My Oracle Support. The Server Control utility (SRVCTL) is the correct utility to use on Oracle entities. Starting with Oracle Database 21c, PDBs are a resource managed by Oracle Clusterware. You can use SRVCTL commands to manage PDBs.

CRSCTL Overview

CRSCTL is an interface between you and Oracle Clusterware, parsing and calling Oracle Clusterware APIs for Oracle Clusterware objects.

CRSCTL provides cluster-aware commands with which you can perform check, start, and stop operations on the cluster. You can run these commands from any node in the cluster on another node in the cluster, or on all nodes in the cluster, depending on the operation.

You can use CRSCTL commands to perform several operations on Oracle Clusterware, such as:

  • Starting and stopping Oracle Clusterware resources

  • Enabling and disabling Oracle Clusterware daemons

  • Checking the health of the cluster

  • Managing resources that represent third-party applications

  • Integrating Intelligent Platform Management Interface (IPMI) with Oracle Clusterware to provide failure isolation support and to ensure cluster integrity

  • Debugging Oracle Clusterware components

Clusterized (Cluster Aware) Commands

You can run clusterized commands on one node to perform operations on another node in the cluster. These are referred to as remote operations. This simplifies administration because, for example, you no longer have to log in to each node to check the status of the Oracle Clusterware on all of your nodes.

Clusterized commands are completely operating system independent; they rely on the OHASD (Oracle High Availability Services daemon). If this daemon is running, then you can perform remote operations, such as the starting, stopping, and checking the status of remote nodes.

Clusterized commands include the following:

CRSCTL Operational Notes

Information about using the CRSCTL command-line interface.

Usage Information

  • The CRSCTL utility is located in the Grid_home/bin directory. To run CRSCTL commands, type in crsctl at the operating system prompt followed by the command and arguments, as shown in the following example: 

    crsctl stop crs

  • There are three categories of CRSCTL commands:

    • Those that you use in either the Oracle Real Application Clusters (Oracle RAC) environment or in the Oracle Restart environment

    • Those that you use in the Oracle RAC environment, only

    • Those that you use in the Oracle Restart environment, only

  • Many CRSCTL commands use the -f parameter to force the command to run and ignore any checks.

    For example, if you specify the force parameter for the crsctl stop resource command on a resource that is running and has dependent resources that are also running, then the force parameter omits the error message and instead stops or relocates all the dependent resources before stopping the resource you reference in the command.

  • You must use the CRSCTL commands from the same release to manage Oracle Clusterware.

Filters

You can use filters to narrow down Oracle Clusterware entities upon which a CRSCTL command operates, as follows:

  • Simple filters are attribute-value pairs with an operator.

  • Operators must be surrounded by spaces, as shown in the examples.

  • You can combine simple filters into expressions called expression filters using Boolean operators.

Supported filter operators are:

  • =
  • >
  • <
  • !=
  • co: Contains
  • st: Starts with
  • en: Ends with

Supported Boolean operators are AND and OR.

Examples of filters are:

  • TYPE = type1

  • ((TYPE = type1) AND (CHECK_INTERVAL > 50))

  • (TYPE = type1) AND ((CHECK_INTERVAL > 30) OR (AUTO_START co never))

  • NAME en network.res

  • TYPE st ora.db

Using CRSCTL Help

To print the help information for CRSCTL, use the following command:

crsctl -help

If you want help for a specific command, such as start, then enter the command and append -help to the end, as shown in the following example: 

crsctl start -help

You can also use the abbreviations -h or -? (this parameter functions in Linux, UNIX, and Windows environments) instead of -help.

Deprecated Subprograms or Commands

Table E-1 lists deprecated commands and their replacements that you can use to perform the same or similar functionality.

Table E-1 Deprecated CRSCTL Commands and Replacements

Deprecated Command Replacement Commands 
crs_stat
 
crsctl check cluster
crsctl status resource
 
crs_register
 
crsctl add resource
crsctl add type
crsctl modify resource
crsctl modify type
 
crs_unregister
 
crsctl stop resource
crsctl delete resource
 
crs_start
 
crsctl start resource
crsctl start crs
crsctl start cluster
 
crs_stop
 
crsctl stop resource
crsctl stop crs
crsctl stop cluster
 
crs_getperm
 
crsctl getperm resource
crsctl getperm type
 
crs_profile
 
crsctl add resource
crsctl add type
crsctl status resource
crsctl status type
crsctl modify resource
crsctl modify type
 
crs_relocate
 
crsctl relocate resource
 
crs_setperm
 
crsctl setperm resource
crsctl setperm type
 
crsctl check crsd
 
crsctl check crs
 
crsctl check cssd
 
crsctl check css
 
crsctl check evmd
 
crsctl check evm
 
crsctl debug res log
 resource_name:level
 
crsctl set log
 
crsctl set css votedisk
 
crsctl add css votedisk
crsctl delete css votedisk
crsctl query css votedisk
crsctl replace votedisk
 
crsctl start resources
 
crsctl start resource -all
 
crsctl stop resources
 
crsctl stop resource -all
 
crsctl set css logfilesize
 
crsctl get tracefileopts css
crsctl set tracefileopts css
 
crsctl get css logfilesize
 
crsctl set tracefileopts css
 
crsctl set trace module_name "component:debugging_level [,component:debugging_level][,...]"
   
crsctl get trace
  

Dual Environment CRSCTL Commands

Use these commands in either the Oracle RAC or the Oracle Restart environments.

The commands listed in this section manage the Oracle Clusterware resources in both Oracle RAC and Oracle Restart environments.

crsctl check css

Checks the status of Cluster Synchronization Services.

This command is most often used when Oracle Automatic Storage Management (Oracle ASM) is installed on the local server.

Syntax

crsctl check css

Example

This command returns output similar to the following:
CRS-4529: Cluster Synchronization Services is online

crsctl check evm

Checks the status of the Event Manager.

Syntax

crsctl check evm

Example

This command returns output similar to the following:
CRS-4533: Event Manager is online

crsctl get hostname

Retrieves the host name of the local server.

Syntax

crsctl get hostname

Example

Oracle Clusterware returns the host name of the local server:
$ crsctl get hostname

node2

crsctl add resource

Registers a resource to be managed by Oracle Clusterware.

A resource can be an application process, a database, a service, a listener, and so on.

Syntax

crsctl add resource resource_name -type resource_type [-group group_name [-file file_path |
   -attr "attribute_name=attribute_value[,...]"]
  [-i] [-f]

Parameters

Table E-2 crsctl add resource Command Parameters

Parameter Description
resource_name

Specify a short, descriptive name for the resource.
-type resource_type

Specify the type of resource that you are adding preceded by the -type flag.

-group group_name

Specify a resource group to which you want to add the resource.
-file file_path

Path name (either absolute or relative) for a text file containing line-delimited attribute name-value pairs that define the resource.
-attr "attribute_name=attribute_value[,...]"

You can specify attributes for a resource you are adding in two different ways:

  • Following the -attr flag, you can specify one or more comma-delimited attribute name-value pairs enclosed in double quotations marks (""). For example: 

    -attr "CHECK_INTERVAL=30,START_TIMEOUT=25"

    Some attributes can have multiple values. In those cases, separate the values with a space and enclose the list of values in single quotation marks. For example:

    -attr "HOSTING_MEMBERS='hostname1 hostname2',START_TIMEOUT=25"

  • Additionally, you can specify attribute values for resource instances with a particular cardinality value, and with a particular degree value. This method can be useful for applications that are tied to a particular server. Following the -attr flag, the syntax is as follows: 

    attribute_name{@SERVERNAME(server_name)
[@DEGREEID(did)] | @CARDINALITYID(cid)
[@DEGREEID(did)]}=attribute_value

    If you specify the @SERVERNAME(server_name) syntax, then the attribute value you specify for the attribute you specify is limited to resource instances residing on the server you specify.

    Alternatively, if you specify the @CARDINALITYID(cid) syntax, then the attribute value you specify for the attribute you specify is limited to resource instances with a specific cardinality ID (cid).

    Optionally, you can combine the @DEGREEID(did) syntax with either the SERVERNAME or CARDINALITYID syntax, or both, to limit the attribute value to resources with the specific DEGREE.

    Examples:

    CHECK_INTERVAL@SERVERNAME(node1)=45
STOP_TIMEOUT@CARDINALITYID(2)=65
STOP_TIMEOUT@SERVERNAME(node1)@DEGREEID(2)=65
STOP_TIMEOUT@CARDINALITYID(3)@DEGREEID(2)=65
-i

If you specify -i, then CRSCTL returns an error if processing this command requires waiting for Oracle Clusterware to unlock the resource or its dependents. Sometimes, Oracle Clusterware locks resources or other objects to prevent commands from interfering with each other.

-f

Use the force parameter:

  • To add a resource that has dependencies on other resources that do not yet exist. The force parameter overrides checks that would prevent a command from being completed.

  • To add a resource if the resource has hard dependencies on other resources and the owner of the resources does not have execute permissions on one or more of the dependencies. If you do not specify the force parameter in this case, an error displays.

Usage Notes

  • Both the resource_name and -type resource_type parameters are required. You can create an associated resource type using the crsctl add type command.

  • Any user can create a resource but only clusterware administrators can create resources of type local_resource or resources of type cluster_resource that have SERVER_POOLS=*.

    Once a resource is defined, its ACL controls who can perform particular operations with it. The Oracle Clusterware administrator list is no longer relevant.

    On Windows, a member of the Administrators group has full control over everything.

    See Also:

    "crsctl setperm resource" for more information about setting ACLs

  • If an attribute value for an attribute name-value pair contains commas, then the value must be enclosed in single quotation marks ('').

  • Following is an example of an attribute file:

    PLACEMENT=favored
HOSTING_MEMBERS=node1 node2 node3
RESTART_ATTEMPTS@CARDINALITYID(1)=0
RESTART_ATTEMPTS@CARDINALITYID(2)=0
FAILURE_THRESHOLD@CARDINALITYID(1)=2
FAILURE_THRESHOLD@CARDINALITYID(2)=4
FAILURE_INTERVAL@CARDINALITYID(1)=300
FAILURE_INTERVAL@CARDINALITYID(2)=500
CHECK_INTERVAL=2
CARDINALITY=2

  • Do not use this command for any resources with names that begin with ora because these resources are Oracle resources.

Examples

Example E-1 Example 1

To register a VIP as a resource with Oracle Clusterware:

$ crsctl add resource app.appvip -type app.appvip.type -attr "RESTART_ATTEMPTS=2,
START_TIMEOUT=100,STOP_TIMEOUT=100,CHECK_INTERVAL=10,
USR_ORA_VIP=172.16.0.0,
START_DEPENDENCIES=hard(ora.net1.network)pullup(ora.net1.network),
STOP_DEPENDENCIES=hard(ora.net1.network)"

Example E-2 Example 2

To register a resource based on the test_type1 resource type: 

$ crsctl add resource r1 -type test_type1 -attr "PATH_NAME=/tmp/r1.txt"
$ crsctl add resource r1 -type test_type1 -attr "PATH_NAME=/tmp/r2.txt"

Example E-3 Example 3

To register a Samba server resource of the generic_application resource type, using the EXECUTABLE_NAMES attribute: 

# crsctl add resource my_samba -type generic_application -attr
"EXECUTABLE_NAMES=smbd,START_PROGRAM='/etc/rc.d/init.d/smb start',
STOP_PROGRAM='/etc/rc.d/init.d/smb stop'"

Example E-4 Example 4

To register a DNS server of the generic_application resource type, using the EXECUTABLE_NAMES attribute: 

# crsctl add resource my_dns -type generic_application -attr
"EXECUTABLE_NAMES=named,START_PROGRAM='/etc/rc.d/init.d/named start',
STOP_PROGRAM='/etc/rc.d/init.d/named stop'"

Example E-5 Example 5

To register an Apache web server of the generic_application resource type using the PID_FILES attribute: 

# crsctl add resource my_apache -type generic_application -attr
"START_PROGRAM='/usr/sbin/httpd -k start',STOP_PROGRAM='/usr/sbin/httpd -k stop',
PID_FILES=/etc/httpd/run/httpd.pid"

Example E-6 Example 6

To register an application of generic_application resource type using environment variables: 

# crsctl add resource my_app -type generic_application -attr
"START_PROGRAM='/opt/my_app start', EXECUTABLE_NAMES=my_app,
ENVIRONMENT_VARS='USE_NETAPP=no,USE_BACKUP=yes,CLEAN_ON_KILL=yes'"

Related Topics

crsctl delete resource

Removes resources from the Oracle Clusterware configuration.

Syntax

crsctl delete resource {"resource_name [...]" | -w "filter"} [-i] [-f]

Parameters

Table E-3 crsctl delete resource Command Parameters

Parameter Description
resource_name

Specify one or more resource names that you want to delete. Multiple resources must be space-delimited and enclosed in double quotation marks ("").

-w "filter"

Specify a resource filter that Oracle Clusterware uses to limit the number of resources evaluated for deletion. The filter must be enclosed in double quotation marks (""). Examples of resource filters include:

  • "TYPE == cluster_resource": This filter limits Oracle Clusterware to relocate only resources of cluster_resource type

  • "CHECK_INTERVAL > 10": This filter limits Oracle Clusterware to relocate resources that have a value greater than 10 for the CHECK_INTERVAL resource attribute

  • "(CHECK_INTERVAL > 10) AND (NAME co 2)": This filter limits Oracle Clusterware to relocate resources that have a value greater than 10 for the CHECK_INTERVAL resource attribute and the name of the resource contains the number 2

Note: All operators must be surrounded by spaces.

See Also: Filters for more information about operators

-i

If you specify -i, then CRSCTL returns an error if processing this command requires waiting for Oracle Clusterware to unlock the resource or its dependents. Sometimes, Oracle Clusterware locks resources or other objects to prevent commands from interfering with each other.

-f

Use this parameter to delete a resource that is online.

Usage Notes

  • Either the resource_name or -w "filter" parameter is required

  • You must have read and write permissions to delete the specified resources

  • Do not use this command for any resources with names that begin with ora because these resources are Oracle resources

Example

To delete a resource from Oracle Clusterware:

# crsctl delete resource myResource

crsctl eval add resource

Predicts the effects of adding a resource without making changes to the system.

This command may be useful to application administrators.

Syntax

crsctl eval add resource resource_name -type resource_type [-file file_path
    | -attr "attribute_name=attribute_value[,...]"]] [-group group_name] [-f]

Parameters

Table E-4 crsctl eval add resource Command Parameters

Parameter Description
resource_name

Specify a short, descriptive name for the resource.
-type resource_type

Specify the type of resource that you are adding following the -type flag.

-file file_path

Path name (either absolute or relative) for a text file containing line-delimited attribute name-value pairs that define the resource.
-attr "attribute_name=attribute_value"

You can specify attributes for a resource you are adding in two different ways:

  • Following the -attr flag, you can specify one or more comma-delimited attribute name-value pairs enclosed in double quotations marks (""). For example: 

    -attr "CHECK_INTERVAL=30,START_TIMEOUT=25"

    Some attributes can have multiple values. In those cases, separate the values with a space and enclose the list of values in single quotation marks. For example:

    -attr "HOSTING_MEMBERS='hostname1 hostname2',START_TIMEOUT=25"

  • Optionally, you can specify attribute values for resource instances with a particular cardinality value, and with a particular degree value. This method can be useful for applications that are tied to a particular server. Following the -attr flag, the syntax is as follows: 

    attribute_name{@SERVERNAME(server_name)
[@DEGREEID(did)] | @CARDINALITYID(cid)
[@DEGREEID(did)]}=attribute_value

    If you specify the @SERVERNAME(server_name) syntax, then the attribute value you specify for the attribute you specify is limited to resource instances residing on the server you specify.

    Alternatively, if you specify the @CARDINALITYID(cid) syntax, then the attribute value you specify for the attribute you specify is limited to resource instances with a specific cardinality ID (cid).

    Optionally, you can combine the @DEGREEID(did) syntax with either the SERVERNAME or CARDINALITYID syntax, or both, to limit the attribute value to resources with the specific DEGREE.

    Examples:

    CHECK_INTERVAL@SERVERNAME(node1)=45
STOP_TIMEOUT@CARDINALITYID(2)=65
STOP_TIMEOUT@SERVERNAME(node1)@DEGREEID(2)=65
STOP_TIMEOUT@CARDINALITYID(3)@DEGREEID(2)=65
-group group_name

Specify a resource group to which you want to add the resource.
-f

Use the force parameter:

  • To add a resource that has dependencies on other resources that do not yet exist. The force parameter overrides checks that would prevent a command from being completed.

  • To add a resource if the resource has hard dependencies on other resources and the owner of the resources does not execute permissions on one or more of the dependencies. If you do not specify the force parameter in this case, an error displays.

crsctl eval fail resource

Predicts the consequences of a resource failing.

Syntax

crsctl eval fail resource {resource_name | -w "filter"} [-n server]
   [-env "attr=val[,...]"]

Parameters

Table E-5 crsctl eval fail resource Command Parameters

Parameter Description
resource_name

Specify the name of a resource for which you want to simulate a failure. You must specify either the name of a resource or resource filters using the -w parameter.

-w "filter"

Alternatively, you can specify a resource filter that Oracle Clusterware uses to limit the number of resources evaluated. The filter must be enclosed in double quotation marks (""). Examples of resource filters include:

  • "TYPE == cluster_resource": This filter limits Oracle Clusterware to relocate only resources of cluster_resource type

  • "CHECK_INTERVAL > 10": This filter limits Oracle Clusterware to relocate resources that have a value greater than 10 for the CHECK_INTERVAL resource attribute

  • "(CHECK_INTERVAL > 10) AND (NAME co 2)": This filter limits Oracle Clusterware to relocate resources that have a value greater than 10 for the CHECK_INTERVAL resource attribute and the name of the resource contains the number 2

Note: All operators must be surrounded by spaces.

See Also: Filters for more information about operators

-n server

Specify the name of the server on which the resource that you want to simulate a failure resides.
-env "attr=val[,...]"

You can optionally override one or more resource profile attribute values with the -env command parameter. If you specify multiple environment name-value pairs, then you must separate each pair with a comma and enclose the entire list in double quotation marks ("").

For example, you could use -env "RESTART_ATTEMPTS=0" to predict what would happen if the resource has run out of local restart attempts and cannot be restarted locally.

Example

This command returns output similar to the following:

$ crsctl eval fail res cs1
 
Stage Group 1:
-----------------------------------------------------------------------------
Stage Number    Required       Action
-----------------------------------------------------------------------------
 
     1              Y   Resource 'cs1' (1/1) will be in state
                        [ONLINE|INTERMEDIATE] on server
                        [mjkeenan_node_0]
                    Y   Resource 'cs1' (2/1) will be in state
                        [ONLINE|INTERMEDIATE] on server
                        [mjkeenan_node_1]
 
-----------------------------------------------------------------------------

crsctl eval relocate resource

Simulates relocating a resource without making changes to the system.

Syntax

crsctl eval relocate resource {resource_name | -all} {-s source_server | -w "filter"}
  [-n destination_server] [-f]

Parameters

Table E-6 crsctl eval relocate resource Command Parameters

Parameter Description
resource_name

Specify the name of a resource you want to relocate.
-all

Alternatively, you can use this parameter to specify all resources for relocation.
-s source_server

Specify a particular server from which you want to relocate the resources.

-w "filter"

Alternative to using -s, you can specify a resource filter that CRSCTL uses to limit the number of resources relocated. The filter must be enclosed in double quotation marks (""). Examples of resource filters include:

  • "TYPE == cluster_resource": This filter limits Oracle Clusterware to relocate only resources of cluster_resource type

  • "CHECK_INTERVAL > 10": This filter limits Oracle Clusterware to relocate resources that have a value greater than 10 for the CHECK_INTERVAL resource attribute

  • "(CHECK_INTERVAL > 10) AND (NAME co 2)": This filter limits Oracle Clusterware to relocate resources that have a value greater than 10 for the CHECK_INTERVAL resource attribute and the name of the resource contains the number 2

See Also: Filters for more information

-n destination_server

Specify the name of the server to which you want to relocate resources. If you do not specify a destination server, then CRSCTL relocates the resources to the best server according to the attribute profile of each resource.

–f

Specify the -f parameter to force the relocation of the resource when it has other resources running that depend on it. CRSCTL stops or relocates dependent resources when you use this parameter.

Note: When you are relocating resources that have cardinality greater than 1, you must use either -k or -s to narrow down which resource instances are to be relocated.

crsctl eval modify resource

Predicts the effects of modifying a resource without making changes to the system.

Syntax

crsctl eval modify resource resource_name -attr "attribute_name=attribute_value[,...]"
    [-group group_name] [-f]

Parameters

Table E-7 crsctl eval modify resource Command Parameters

Parameter Description
resource_name

Specify the name of the resource you want to evaluate.
-attr "attribute_name=attribute_value[,...]"

You can specify attributes for a resource you want to evaluate in two different ways:

  • Following the -attr flag, you can specify one or more comma-delimited attribute name-value pairs to modify enclosed in double quotations marks (""). For example: 

    -attr "CHECK_INTERVAL=30,START_TIMEOUT=25"

    Some attributes can have multiple values. In those cases, separate the values with a space and enclose the list of values in single quotation marks. For example:

    -attr "HOSTING_MEMBERS='hostname1 hostname2',START_TIMEOUT=25"

  • Alternatively, you can specify attribute values for resources on a particular server, with a particular cardinality value, and with a particular degree value. This method can be useful for applications that are somehow tied to a particular server. Following the -attr flag, the syntax is as follows: 

    attribute_name{@SERVERNAME(server_name)
[@DEGREEID(did)] | @CARDINALITYID(cid)
[@DEGREEID(did)]}=attribute_value

    If you specify the @SERVERNAME(server_name) syntax, then the attribute value you specify for the attribute you specify is limited to resources residing on the server you specify.

    Alternatively, if you specify the @CARDINALITYID(cid) syntax, then the attribute value you specify for the attribute you specify is limited to resource instances with a specific cardinality ID (cid).

    Optionally, you can combine the @DEGREEID(did) syntax with either the SERVERNAME or CARDINALITYID syntax, or both, to limit the attribute value to resources with the specific DEGREE.

    Examples:

    CHECK_INTERVAL@SERVERNAME(node1)=45
STOP_TIMEOUT@CARDINALITYID(2)=65
STOP_TIMEOUT@SERVERNAME(node1)@DEGREEID(2)=65
STOP_TIMEOUT@CARDINALITYID(3)@DEGREEID(2)=65
-group group_name

Specify a resource group to which the resource belongs that you want to evaluate.
–f

Specify this parameter to evaluate what happens if you run the command with the force parameter.

crsctl eval start resource

Predicts the effects of starting a resource without making changes to the system.

Syntax

crsctl eval start resource {resource_name [...] | -w "filter"}
   [-n server_name] [-f]

Parameters

Table E-8 crsctl eval start resource Command Parameters

Parameter Description
resource_name [...]

Specify one or more space-delimited resource names to start.
-w "filter"

Specify a resource filter surrounded by double quotation marks ("") that Oracle Clusterware uses to match resources. For example, -w "TYPE = ora.database.type" or -w "NAME = cs1".

See Also: "Filters" for more information

-n server_name

Specify the name of the server on which the resources you want to start reside. If you do not specify a server, then Oracle Clusterware starts the resources on the best server according to the attribute profile of each resource.
–f

Use the -f parameter to relocate a resource running on another server on which the resource you want to start has a hard start dependency. If you do not specify the force parameter in this case, then the start command fails.

crsctl eval stop resource

Predicts the effect of stopping a resource without making changes to the system.

Syntax

crsctl eval stop resource {resource_name [...] | -w "filter"} [-f]

Parameters

Table E-9 crsctl eval stop resource Command Parameters

Parameter Description
resource_name [...]

Specify one or more space-delimited resource names to stop.
-w "filter"

Specify a resource filter that Oracle Clusterware uses to limit the number of resources stopped. The filter must be enclosed in double quotation marks (""). Examples of resource filters include:

  • "TYPE == cluster_resource": This filter limits Oracle Clusterware to stop only resources of cluster_resource type

  • "CHECK_INTERVAL > 10": This filter limits Oracle Clusterware to stop resources that have a value greater than 10 for the CHECK_INTERVAL resource attribute

  • "(CHECK_INTERVAL > 10) AND (NAME co 2)": This filter limits Oracle Clusterware to stop resources that have a value greater than 10 for the CHECK_INTERVAL resource attribute and the name of the resource contains the number 2

See Also: Filters for more information

–f

Specify the -f parameter to force the stopping of the resource when it has other resources running that depend on it. Dependent resources are relocated or stopped when you use this parameter.

crsctl getperm resource

Displays the user and group permissions for the specified resource.

Syntax

crsctl getperm resource resource_name [{-u user_name | -g group_name}]

Parameters

Table E-10 crsctl getperm resource Command Parameters

Parameter Description
resource_name

Specify the name of the resource for which you want to obtain permissions.
-u user_name

If you specify -u, then Oracle Clusterware obtains permissions for a particular user.

-g group_name

If you specify -g, then Oracle Clusterware obtains permissions for a particular group.

Usage Notes

  • The resource_name parameter is required

  • You must have read permission on the specified resources to obtain their permissions

  • Do not use this command for any resources with names that begin with ora because these resources are Oracle resources

See Also:

Oracle Clusterware Resource Reference for more information about resources and resource attributes

Examples

The crsctl getperm resource command returns output similar to the following, depending on the command option you choose:
$ crsctl getperm resource app.appvip

Name: app.appvip
owner:root:rwx,pgrp:oinstall:rwx,other::r--
$ crsctl getperm resource app.appvip -u oracle

Name: app.appvip
rwx
$ crsctl getperm resource app.appvip -g dba

Name: app.appvip
r--

crsctl modify resource

Modifies the attributes of a particular resource in Oracle Clusterware.

Syntax

crsctl modify resource resource_name -attr "attribute_name=attribute_value"
[-i] [-f] [-delete] [-group group_name]  [-env "env1=val1,env2=val2,..."]

Parameters

Table E-11 crsctl modify resource Command Parameters

Parameter Description
resource_name

The name of the resource you want to modify.
-attr "attribute_name= attribute_value"

You can specify attributes for a resource you want to modify in two different ways:

  • Following the -attr flag, you can specify one or more comma-delimited attribute name-value pairs to modify enclosed in double quotations marks (""). For example: 

    -attr "CHECK_INTERVAL=30,START_TIMEOUT=25"

    Some attributes can have multiple values. In those cases, separate the values with a space and enclose the list of values in single quotation marks. For example:

    -attr "HOSTING_MEMBERS='hostname1 hostname2',START_TIMEOUT=25"

  • Alternatively, you can specify attribute values for resources on a particular server, with a particular cardinality value, and with a particular degree value. This method can be useful for applications that are somehow tied to a particular server. Following the -attr flag, the syntax is as follows: 

    attribute_name{@SERVERNAME(server_name)
[@DEGREEID(did)] | @CARDINALITYID(cid)
[@DEGREEID(did)]}=attribute_value

    If you specify the @SERVERNAME(server_name) syntax, then the attribute value you specify for the attribute you specify is limited to resources residing on the server you specify.

    Alternatively, if you specify the @CARDINALITYID(cid) syntax, then the attribute value you specify for the attribute you specify is limited to resource instances with a specific cardinality ID (cid).

    Optionally, you can combine the @DEGREEID(did) syntax with either the SERVERNAME or CARDINALITYID syntax, or both, to limit the attribute value to resources with the specific DEGREE.

    Examples:

    CHECK_INTERVAL@SERVERNAME(node1)=45
STOP_TIMEOUT@CARDINALITYID(2)=65
STOP_TIMEOUT@SERVERNAME(node1)@DEGREEID(2)=65
STOP_TIMEOUT@CARDINALITYID(3)@DEGREEID(2)=65
-i

If you specify -i, then CRSCTL returns an error if processing this command requires waiting for Oracle Clusterware to unlock the resource or its dependents. Sometimes, Oracle Clusterware locks resources or other objects to prevent commands from interfering with each other.

-f

Use the -f parameter when:

  • The resource has a hard dependency on a non-existing resource

  • The owner of the resource does not have execute permissions on one or more hard dependencies

  • The modification results in servers being moved into the Generic pool and resources being stopped or relocated to accomplish the server move
-delete

If you specify the -delete parameter, then Oracle Clusterware deletes the named attribute.

-group group_name

Specify a resource group to which the resource belongs. The resource group must exist, and the resource cannot be a member of any other explicit resource group. If you do not specify a resource group, then CRSCTL adds the resource to a resource group with the same name as the resource.
-env "env1=val1,env2=val2,..."

You can optionally override one or more resource profile attribute values for this command. If you specify multiple environment name-value pairs, then you must separate each pair with a comma and enclose the entire list in double quotation marks ("").

Usage Notes

  • The resource_name parameter is required

  • If an attribute value for an attribute name-value pair contains commas, then the value must be enclosed in single quotation marks (''). For example: 

    "START_DEPENDENCIES='hard(res1,res2,res3)'"

  • You must have read and write permissions on the specified resources to modify them

  • Do not use this command for any resources with names that begin with ora because these resources are Oracle resources

Example

To modify the attributes of the appsvip resource: 

$ crsctl modify resource appsvip -attr USR_ORA_VIP=10.1.220.17 -i

Related Topics

crsctl relocate resource

Relocates resources to another server in the cluster.

Syntax

crsctl relocate resource {resource_name [-k cid] | -all | -w "filter"} -s source_server |
  [-n destination_server] [-env "env1=val1,env2=val2,..."] [-i] [-f]

Parameters

Table E-12 crsctl relocate resource Command Parameters

Parameter Description
resource_name

Specify the name of a resource you want to relocate.
-k cid

Optionally, you can specify the resource cardinality ID. If you specify this parameter, then CRSCTL relocates the resource instance that has the cardinality you specify.
-all

Alternatively, you can use this parameter to specify all resources for relocation.
-w "filter"

Alternative to using -k or -all, you can specify a resource filter that CRSCTL uses to limit the number of resources relocated. The filter must be enclosed in double quotation marks (""). Examples of resource filters include:

  • "TYPE == cluster_resource": This filter limits Oracle Clusterware to relocate only resources of cluster_resource type

  • "CHECK_INTERVAL > 10": This filter limits Oracle Clusterware to relocate resources that have a value greater than 10 for the CHECK_INTERVAL resource attribute

  • "(CHECK_INTERVAL > 10) AND (NAME co 2)": This filter limits Oracle Clusterware to relocate resources that have a value greater than 10 for the CHECK_INTERVAL resource attribute and the name of the resource contains the number 2

See Also: "Filters" for more information

-s source_server

Specify a particular server from which you want to relocate the resources.

-n destination_server

Specify the name of the server to which you want relocate resources. If you do not specify a destination server, then CRSCTL relocates the resources to the best server according to the attribute profile of each resource.

-env "env1=val1,env2=val2,..."

You can optionally override one or more resource profile attribute values for this command. If you specify multiple environment name-value pairs, then you must separate each pair with a comma and enclose the entire list in double quotation marks ("").

–i

If you specify -i, then the command returns an error if processing this command requires waiting for Oracle Clusterware to unlock the resource or its dependents. Sometimes, Oracle Clusterware locks resources or other objects to prevent commands from interfering with each other.

–f

Specify the -f parameter to force the relocation of the resource when it has other resources running that depend on it. CRSCTL stops or relocates dependent resources when you use this parameter.

Note: When you are relocating resources that have cardinality greater than 1, you must use either -k or -s to narrow down which resource instances are to be relocated.

Usage Notes

  • Any one of the three following options is required to specify which resources you want to relocate:

    • You can specify one particular resource to relocate.

    • Or you can specify one particular or all the resources to relocate from a particular source server.

    • Thirdly, you can specify a resource filter that CRSCTL uses to match resources to relocate.

  • If a resource has a degree ID greater than 1, then CRSCTL relocates all instances of the resource.

  • You must have read and execute permissions on the specified resources to relocate them

  • Do not use this command for any resources with names that begin with ora because these resources are Oracle resources.

Examples

To relocate one particular resource from one server to another:

# crsctl relocate resource myResource1 -s node1 -n node3

crsctl restart resource

Restarts idle resources in the cluster, instead of having to run two commands to stop and start the resource.

Syntax

crsctl restart resource {resource_name [...] | -w "filter"} [-k cid] [-d did]
   [-env "env1=val1,env2=val2,..."] [-i] [-f]

Parameters

Table E-13 crsctl restart resource Command Parameters

Parameter Description
resource_name [...]

Specify one or more space-delimited names of resources you want to restart.
-w "filter"

Specify a resource filter surrounded by double quotation marks ("") that Oracle Clusterware uses to match resources. For example, -w "TYPE = ora.database.type" or -w "NAME = cs1".

See Also: "Filters" for more information

-k cid

Specify the resource cardinality ID. If you specify this parameter, then Oracle Clusterware restarts the resource instances that have the cardinality you specify.
-d did

Specify the resource degree ID. If you specify this parameter and the degree ID is greater than 1, then Oracle Clusterware restarts all resource instances that meet this criteria.

Note: You cannot use the -d parameter without specifying the -k parameter.

-env "env1=val1,env2=val2,..."

You can optionally override one or more resource profile attribute values with the -env command parameter. If you specify multiple environment name-value pairs, then you must separate each pair with a comma and enclose the entire list in double quotation marks ("").

-i

If you specify -i, then the command returns an error if processing this command requires waiting for Oracle Clusterware to unlock the resource or its dependents. Sometimes, Oracle Clusterware locks resources or other objects to prevent commands from interfering with each other.

–f

Use the -f parameter to relocate a resource running on another server on which the resource you want to restart has a hard start dependency. If you do not specify the force parameter in this case, then the start command fails.

Usage Notes

  • Either of the following options is required to specify which resources you want to restart:

    • You can specify one or more resources by name to restart

    • You can specify a resource filter that Oracle Clusterware uses to match resources to restart

  • You must have read and execute permissions on the specified resources to restart them

  • Do not use this command to restart any resources with names that begin with ora because these resources are Oracle resources

crsctl setperm resource

Sets permissions for a particular resource.

Syntax

crsctl setperm resource resource_name {-u acl_string | -x acl_string |
-o user_name | -g group_name}

Parameters

Table E-14 crsctl setperm resource Command Parameters

Parameter Description
resource_name

Specify the name of the resource for which you want to set permissions.
-u | -x | -o | -g

You can set only one of the following permissions for a resource:

  • -u acl_string: You can update the access control list (ACL) for a resource

  • -x acl_string: You can delete the ACL for a resource

  • -o user_name: You can change the owner of a resource by entering a user name

  • -g group_name: You can change the primary group of a resource by entering a group name

Specify a user, group, or other ACL string, as follows:

user:user_name[:readPermwritePermexecPerm] |
group:group_name[:readPermwritePermexecPerm] |
other[::readPermwritePermexecPerm]

  • user: User ACL

  • group: Group ACL

  • other: Other ACL

  • readPerm: Read permission for the resource; the letter r grants a user, group, or other read permission, the minus sign (-) denies read permission

  • writePerm: Write permission for the resource; the letter w grants a user, group, or other write permission, the minus sign (-) denies write permission

  • execPerm: Execute permission for the resource; the letter x grants a user, group, or other execute permission, the minus sign (-) denies execute permission

See Also:

Oracle Clusterware Resource Reference for more information about resources and resource attributes

Usage Notes

  • Do not use this command for any resources with names that begin with ora because these resources are Oracle resources.

  • You must have read and write permissions on the specified resources to set their permissions

Examples

To grant read, write, and execute permissions on a resource for user Scott:
$ crsctl setperm resource myResource -u user:scott:rwx

crsctl start resource

Starts idle resources on a particular server in the cluster.

Syntax

crsctl start resource {resource_name [...] | -w "filter" | -all}
   [-n server_name [-k cid] [-d did]
   [-env "env1=val1,env2=val2,..."] [-begin] [-end] [-i] [-f] [-l]

Parameters

Table E-15 crsctl start resource Command Parameters

Parameter Description
resource_name [...]

Specify one or more space-delimited names of resources you want to start.
-w "filter"

Specify a resource filter surrounded by double quotation marks ("") that Oracle Clusterware uses to match resources. For example, -w "TYPE = ora.database.type" or -w "NAME = cs1".

See Also: "Filters" for more information

–all

Use this parameter to start all resources in the cluster.
-n server_name

Specify the name of the server on which the resources you want to start reside. If you do not specify a server, then Oracle Clusterware starts the resources on the best server according to the attribute profile of each resource.
-k cid

Specify the resource cardinality ID. If you specify this parameter, then Oracle Clusterware starts the resource instances that have the cardinality you specify.
-d did

Specify the resource degree ID. If you specify this parameter and the degree ID is greater than 1, then Oracle Clusterware starts all resource instances that meet this criteria.

Note: You cannot use the -d parameter without specifying the -k parameter.

-env "env1=val1,env2=val2,..."

You can optionally override one or more resource profile attribute values with the -env command parameter. If you specify multiple environment name-value pairs, then you must separate each pair with a comma and enclose the entire list in double quotation marks ("").

-begin

You can specify this parameter to begin a transparent HA action.
-end

You can specify this parameter to end a transparent HA action.
–i

If you specify -i, then the command returns an error if processing this command requires waiting for Oracle Clusterware to unlock the resource or its dependents. Sometimes, Oracle Clusterware locks resources or other objects to prevent commands from interfering with each other.

–f

Use the -f parameter to relocate a resource running on another server on which the resource you want to start has a hard start dependency. If you do not specify the force parameter in this case, then the start command fails.

–l

Use the -l parameter to leave the resources in the state they were in if the start command fails.

Usage Notes

  • Any one of the three following options is required to specify which resources you want to start:

    • You can specify one or more resources to start

    • You can specify a resource filter that Oracle Clusterware uses to match resources to start

    • You can specify the -all parameter to start all resources on the specified server

  • You must have read and execute permissions on the specified resources to start them

  • Do not use this command to start any resources with names that begin with ora because these resources are Oracle resources

  • Oracle does not support starting managed applications outside of the Oracle Grid Infrastructure

Example

To start a resource:
# crsctl start resource myResource -n server1

crsctl status resource

Obtains the status and configuration information of any number of particular resources.

Syntax

crsctl status resource resource_name [...] | -w "filter" [-p | -v] | [-f | -l
   | -g] [[-k cid | -n server_name] [ -e [-p | -v]] [-d did]] | [-s -k cid
   [-d did]] [-p [-attr attribute_name[,...] [-noname]]

To print the status of the resources in tabular form:

crsctl status resource resource_name [...] | -w "filter" -t

To print a list of the resource dependencies:

crsctl status resource [resource_name [...]] -dependency [-stop | -pullup]

Parameters

Table E-16 crsctl status resource Command Parameters

Parameter Description
resource_name [...] | -w "filter"

Specify one or more space-delimited names of resources of which you want to check the status.

Optionally, you can specify a resource filter that CRSCTL uses to limit the number of resources displayed. The filter must be enclosed in double quotation marks (""). Values that contain parentheses or spaces must be enclosed in single quotation marks (''). Operators must be surrounded by spaces. Examples of resource filters include:

  • "TYPE == cluster_resource": This filter limits the display to only resources of cluster_resource type.

  • "CHECK_INTERVAL > 10": This filter limits the display to resources that have a value greater than 10 for the CHECK_INTERVAL resource attribute

  • "(CHECK_INTERVAL > 10) AND (NAME co 2)": This filter limits the display to resources that have a value greater than 10 for the CHECK_INTERVAL resource attribute and the name of the resource contains the number 2.

  • "START_DEPENDENCIES='hard(appsvip)'": This filter limits the display to resources that have a hard start dependency on the appsvip resource.

See Also: "Filters" for more information

[-p | -v] | [-f | -l | -g]
You can optionally specify the following parameters:

  • Specify either the -p parameter to display the static configuration of the resource or the -v parameter to display the run-time configuration of the resource.

  • Specify the -f parameter to display the full configuration of the resource; or specify the -l parameter to display all cardinal and degree values of the resource; or specify the -g parameter to check whether the specified resources are registered

[[-k cid | -n server_name] [ -e [-p | -v]] [-d did | [-s -k cid [-d did]]]
You can specify one of the following two options:

  • Specify the -k cid parameter to specify a cardinality ID of the resources you want to query. Or you can specify the -n parameter to specify a particular server on which to check resources. Optionally, you can specify the -d parameter with the -n parameter to specify the degree ID of resources you want to check. If you specify a degree ID greater than 1, then Oracle Clusterware checks all resource instances on the server that meet this criteria.

    Use the -e parameter to evaluate the special values of a resource instance. You must also specify -p or -v with the -e parameter.

  • Specify the -s parameter with the -k parameter to obtain a list of target servers for relocation. You can further limit the output by specifying a degree ID with the -d parameter.

–t

Specify the -t parameter to display the output in tabular form.

-p [-attr attribute_name[,...] [-noname]

Specify -attr (followed by a single attribute name or a comma-delimited list of attribute names) or -noname following -p to either print specific attributes or bypass the default printing of the resource name, respectively.

-dependency [-stop | -pullup]

Specify the -dependency parameter to display resource dependencies. If you do not specify either the -stop or -pullup option, then CRSCTL displays the start dependencies of the resource.

Use either of the following options with the -dependency parameter:

  • Specify the -stop parameter to display resource stop dependencies.

  • Specify the -pullup parameter to display resource pull up dependencies.

Usage Notes

  • Either a space-delimited list of resources or a resource filter is required.

  • You must have read permissions on the specified resources to obtain their status.

  • Use crsctl status resource to query the status information of any resource deployed in the cluster. Oracle recommends, however, that you use the respective SRCVTL command to query the status information of Oracle (ora.*) resources.

Examples

The crsctl status resource command returns output similar to the following: 

$ crsctl status resource ora.staii14.vip

NAME=ora.staii14.vip
TYPE=ora.cluster_vip_net1.type
TARGET=ONLINE
STATE=ONLINE on staii14

The following example shows the start dependencies for a resource named ora.newdb.db: 

$ crsctl status resource ora.newdb.db -dependency ora.newdb.db(ora.database.type)

  ora.ACFS_DG1.dg(ora.diskgroup.type)[hard,pullup]
    ora.asm(ora.asm.type)[hard,pullup]
      ora.LISTENER.lsnr(ora.listener.type)[weak]
        type:ora.cluster_vip_net1.type[hard:type,pullup:type]
          ora.net1.network(ora.network.type)[hard,pullup]
  ora.dbhome_dg.dbhome_dg_v.acfs(ora.acfs.type)[hard,pullup]
    ora.asm(ora.asm.type)[pullup:always]

crsctl stop resource

Stops running resources.

Syntax

crsctl stop resource {resource_name [...] | -w "filter" | -all} [-n server_name] [-k cid] [-d did] [-env "env1=val1,env2=val2,..."]
   [-begin | -end] [-i] [-f] [-l]

Parameters

Table E-17 crsctl stop resource Command Parameters

Parameter Description
resource_name [...]

Alternative to using -w or -all, you can specify one or more space-delimited resource names that you want to stop.

-w "filter"

Alternative to specifying a resource name or using -all, you can specify a resource filter that CRSCTL uses to limit the number of resources stopped. The filter must be enclosed in double quotation marks (""). Examples of resource filters include:

  • "TYPE == cluster_resource": This filter limits Oracle Clusterware to stop only resources of cluster_resource type

  • "CHECK_INTERVAL > 10": This filter limits Oracle Clusterware to stop resources that have a value greater than 10 for the CHECK_INTERVAL resource attribute

  • "(CHECK_INTERVAL > 10) AND (NAME co 2)": This filter limits Oracle Clusterware to stop resources that have a value greater than 10 for the CHECK_INTERVAL resource attribute and the name of the resource contains the number 2

See Also: "Filters" for more information

-all

Alternative to specifying a resource name or using -w, you can use this parameter to stop all resources in the cluster.

-n server_name

Optionally, you can specify the name of the server on which the resource instances you want to stop reside. If you do not specify a server, then CRSCTL stops all instances of the resource.
-k cid

Optionally, you can specify the resource cardinality ID. If you specify this parameter, then CRSCTL stops the resource instances that have the cardinality you specify.
-d did

Specify the resource degree ID. If you specify this parameter and the degree ID is greater than 1, then CRSCTL stops all resource instances that meet this criteria.
-env "env1=val1,env2=val2,..."

You can optionally override one or more resource profile attribute values with the -env command parameter. If you specify multiple environment name-value pairs, then you must separate each pair with a comma and enclose the entire list in double quotation marks ("").

-begin | -end

Optionally, you can specify either of these parameters to begin or end a transparent HA action, respectively.
–i

If you specify -i, then the command returns an error if processing this command requires waiting for Oracle Clusterware to unlock the resource or its dependents. Sometimes, Oracle Clusterware locks resources or other objects to prevent commands from interfering with each other.

–f

Specify the -f parameter to force the stopping of the resource when it has other resources running that depend on it. Dependent resources are relocated or stopped when you use this parameter.

–l

Use the -l parameter to leave the resources in the state they were in if the stop command fails.

Usage Notes

  • Any one of the three following options is required to specify which resources you want to stop:

    • You can specify by name one or more resources to stop.

    • You can specify a resource filter that CRSCTL uses to match resources to stop

    • You can specify the -all parameter to stop all resources on a particular server

  • You must have read and execute permissions on the specified resources to stop them

  • Do not use this command for any resources with names that begin with ora because these resources are Oracle resources

  • Oracle does not support stopping managed applications outside of the Oracle Grid Infrastructure

Example

To stop a resource:

$ crsctl stop resource -n node1 -k 2

crsctl add resourcegroup

Creates a resource group based on a resource group type.

Use this command to create an empty resource group into which you can add resources.

Syntax

crsctl add resourcegroup group_name –type group_type
  [[-file file_path] | [-attr "attribute_name=
  attribute_value"]] [-f] [-i]

Parameters

Table E-18 crsctl add resourcegroup Command Parameters

Parameter Description
group_name

Specify the name of the resource group.
–type group_type

Specify a group type for the resource group.
-file file_path | -attr "attribute_name=attribute_value[,...]"

Provide either a file or a list of attributes that define the resource group.

Path name (either absolute or relative) for a text file containing line-delimited attribute name-value pairs that define the resource group.

Following the -attr flag, you can specify one or more comma-delimited attribute name-value pairs enclosed in double quotations marks ("").

–f

Use this parameter to add a resource group that is online.
–i

If you specify -i, then CRSCTL returns an error if processing this command requires waiting for Oracle Clusterware to unlock the resource or its dependents. Sometimes, Oracle Clusterware locks resources or other objects to prevent commands from interfering with each other.

crsctl check resourcegroup

Initiates a check operation on all member resources of the specified groups.

Syntax

crsctl check resourcegroup {group_name [...] | -w "filter"}
  [-n server_name] [-k cid]

Parameters

Table E-19 crsctl check resourcegroup Command Parameters

Parameter Description
group_name

Specify a resource group or a number of resource groups in a space-delimited list that you want to check.
-w "filter"

Alternatively, you can specify a resource group filter surrounded by double quotation marks ("") that Oracle Clusterware uses to match resource groups. For example, -w "TYPE = ora.database.type" or -w "NAME = cs1".

See Also: Filters for more information about using filters.

-n server_name

Optionally, you can specify the name of the server on which the resource group you want to check resides.
-k cid

Optionally, you can specify the resource group cardinality ID. If you specify this parameter, then Oracle Clusterware checks the resource instances that have the cardinality you specify.

crsctl delete resourcegroup

Deletes one or more resource groups from Oracle Clusterware.

Syntax

crsctl delete resourcegroup {"group_name [...]" | -w "filter"} [-f] [-i]

Parameters

Table E-20 crsctl delete resourcegroup Command Parameters

Parameter Description
group_name

Specify one or more group names that you want to delete. Multiple groups must be space-delimited and enclosed in double quotation marks ("").

-w "filter"

Specify a resource filter that Oracle Clusterware uses to limit the number of resources evaluated for deletion. The filter must be enclosed in double quotation marks (""). Examples of resource filters include:

  • "TYPE == cluster_resource": This filter limits Oracle Clusterware to relocate only resources of cluster_resource type

  • "CHECK_INTERVAL > 10": This filter limits Oracle Clusterware to relocate resources that have a value greater than 10 for the CHECK_INTERVAL resource attribute

  • "(CHECK_INTERVAL > 10) AND (NAME co 2)": This filter limits Oracle Clusterware to relocate resources that have a value greater than 10 for the CHECK_INTERVAL resource attribute and the name of the resource contains the number 2

Note: All operators must be surrounded by spaces.

See Also: Filters for more information about operators

-f

Use this parameter to delete a resource group that is online.
-i

If you specify -i, then CRSCTL returns an error if processing this command requires waiting for Oracle Clusterware to unlock the resource or its dependents. Sometimes, Oracle Clusterware locks resources or other objects to prevent commands from interfering with each other.

Usage Notes

  • You must specify either a group name (or several group names) or a resource filter.

  • You can only delete a resource group if no other resource groups have dependencies to it.

crsctl eval add resourcegroup

Predicts the effects of adding a resource group without making changes to the system.

Syntax

crsctl eval add resourcegroup group_name -type group_type [-file file_path
   | -attr "attribute_name=attribute_value[,...]"] [-f]

Parameters

Table E-21 crsctl eval add resourcegroup Command Parameters

Parameter Description
group_name

Specify the name of the resource group.
-type group_type

Specify a group type for the resource group.
-file file_path | -attr "attribute_name=attribute_value[,...]"

Provide either a file or a list of attributes that define the resource group.

Path name (either absolute or relative) for a text file containing line-delimited attribute name-value pairs that define the resource group.

Following the -attr flag, you can specify one or more comma-delimited attribute name-value pairs enclosed in double quotations marks ("").

–f

Use this parameter to add a resource group that is online.

crsctl eval fail resourcegroup

Predicts the consequences of a resource failing.

Syntax

crsctl eval fail resourcegroup {group_name | -w filter} [-n server]
   [-env "attr=val[,...]"]

Parameters

Table E-22 crsctl eval fail resourcegroup Command Parameters

Parameter Description
group_name

Specify the name of a resource group you want to evaluate.
-w filter

Alternative you specifying a particular resource group, you can specify a resource group filter surrounded by double quotation marks ("") that CRSCTL uses to match resource groups. For example, -w "TYPE = ora.database.type" or -w "NAME = cs1".

See Also: Filters for more information about filters

-n server

Optionally, you can specify the name of the server to which resource groups reside that you want to evaluate.
-env "attr=val[,...]"

You can optionally override one or more resource group profile attribute values with the -env command parameter. If you specify multiple environment name-value pairs, then you must separate each pair with a comma and enclose the entire list in double quotation marks ("").

crsctl eval relocate resourcegroup

Predicts the effect of relocating a resource group without making changes to the system.

Syntax

crsctl eval relocate resourcegroup {group_name | -all} -s server | -w filter}
   {-n server} [-f]

Parameters

Table E-23 crsctl eval relocate resourcegroup Command Parameters

Parameter Description
group_name

Specify the name of a resource group that you want to evaluate.
-all

Alternative to specifying a particular resource group, you can use this parameter to evaluate relocating all resource groups.
-s server

Specify the name of the source server on which the resource group resides that you want to relocate. This parameter is required.
-w filter

Alternative to specifying a particular resource group, you can specify a resource group filter surrounded by double quotation marks ("") that CRSCTL uses to match resource groups. For example, -w "TYPE = ora.database.type" or -w "NAME = cs1". This parameter is required if you do not use -s.

See Also: Filters for more information about filters

-n server

Specify the name of the server to which you want to relocate the resource groups. This parameter is required.
–f

Use this parameter to evaluate the operation with the force option.

crsctl eval start resourcegroup

Predicts the effects of starting a resource group without making changes to the system.

Syntax

crsctl eval start resourcegroup {group_name | -w filter} [-n server] [-f]

Parameters

Table E-24 crsctl eval start resourcegroup Command Parameters

Parameter Description
group_name

Specify a resource group or a number of resource groups in a space-delimited list that you want to evaluate. This parameter is required.
-w filter

Alternatively, you can specify a resource group filter surrounded by double quotation marks ("") that CRSCTL uses to match resource groups. For example, -w "TYPE = ora.database.type" or -w "NAME = cs1". This parameter is required if you do not specify a particular resource group.

See Also: Filters for more information about filters

-n server

Specify the name of the server on which the resource group you want to evaluate resides.
–f

Use the -f parameter to evaluate a resource group on a server on which one of the resources in the resource group you want to start has a hard start dependency.

crsctl eval stop resourcegroup

Predicts the effect of stopping a resource group without making changes to the system.

Syntax

crsctl eval stop resourcegroup {group_name | -w filter} [-f]

Parameters

Table E-25 crsctl eval stop resourcegroup Command Parameters

Parameter Description
group_name

Specify a resource group or a number of resource groups in a space-delimited list that you want to stop.
-w "filter"

Alternative to specifying a resource group, you can specify a resource group filter surrounded by double quotation marks ("") that CRSCTL uses to match resource groups. For example, -w "TYPE = ora.database.type" or -w "NAME = cs1".

See Also: Filters for more information about using filters.

–f

Use the -f parameter to stop a resource running on another server on which one of the resources in the resource group you want to stop has a hard stop dependency.

crsctl export resourcegroup

Exports the complete information and attributes of a resource groups and its member resources to a script file.

This command also exports configuration information of the resource group type and member resource types. You can run the script file on another cluster to import the resource group configuration.

Syntax

crsctl export resourcegroup [group_name [...]] –file file_name

Parameters

Table E-26 crsctl export resource Command Parameters

Parameter Description
group_name

Specify a resource group or a number of resource groups in a space-delimited list that you want to export.
–file file_name

Specify a name for the output script file that you will run to import the group.

crsctl modify resourcegroup

Modifies a resource group to add attributes or update the values of existing attributes.

Syntax

crsctl modify resourcegroup group_name -attr "attribute_name=
attribute_value"} [-i] [-f] [-delete]

Parameters

Table E-27 crsctl modify resourcegroup Command Parameters

Parameter Description
group_name

Specify the name of the resource group you want to modify.
-attr "attribute_name= attribute_value"

You can specify attributes for a resource group you want to modify in two different ways:

  • Following the -attr flag, you can specify one or more comma-delimited attribute name-value pairs to modify enclosed in double quotations marks (""). For example: 

    -attr "CHECK_INTERVAL=30, START_TIMEOUT=25"

    Some attributes can have multiple values. In those cases, separate the values with a space and enclose the list of values in single quotation marks. For example:

    -attr "HOSTING_MEMBERS='hostname1 hostname2',START_TIMEOUT=25"

  • Alternatively, you can specify attribute values for resources on a particular server, with a particular cardinality value, and with a particular degree value. This method can be useful for applications that are somehow tied to a particular server. Following the -attr flag, the syntax is as follows: 

    attribute_name{@SERVERNAME(server_name)
[@DEGREEID(did)] | @CARDINALITYID(cid)
[@DEGREEID(did)]}=attribute_value

    If you specify the @SERVERNAME(server_name) syntax, then the attribute value you specify for the attribute you specify is limited to resources residing on the server you specify.

    Alternatively, if you specify the @CARDINALITYID(cid) syntax, then the attribute value you specify for the attribute you specify is limited to resource instances with a specific cardinality ID (cid).

    Optionally, you can combine the @DEGREEID(did) syntax with either the SERVERNAME or CARDINALITYID syntax, or both, to limit the attribute value to resources with the specific DEGREE.

    Examples:

    CHECK_INTERVAL@SERVERNAME(node1)=45
STOP_TIMEOUT@CARDINALITYID(2)=65
STOP_TIMEOUT@SERVERNAME(node1)@DEGREEID(2)=65
STOP_TIMEOUT@CARDINALITYID(3)@DEGREEID(2)=65
–i

If you specify -i, then CRSCTL returns an error if processing this command requires waiting for Oracle Clusterware to unlock the resource group or its dependents. Sometimes, Oracle Clusterware locks resource groups or other objects to prevent commands from interfering with each other.

–f

Use the -f parameter when:

  • The resource group has a hard dependency on a non-existing resource.

  • The owner of the resource group does not have execute permissions on one or more hard dependencies.

  • The modification results in servers being moved into the Generic pool and resources being stopped or relocated to accomplish the server move.
–delete

If you specify the -delete parameter, then Oracle Clusterware deletes the named attribute.

Usage Notes

You can modify the name of the resource group and add or change existing attributes.

crsctl relocate resourcegroup

Relocates online resource groups from a source server to a target server.

This command first stops the resource groups you specify on the source server and then starts them on the target server.

Syntax

crsctl relocate resourcegroup {group_name [...] [-k cid] | -all | -w "filter"}
   [-env "attr=val[,...]"] [-f] [-i]

Parameters

Table E-28 crsctl relocate resourcegroup Command Parameters

Parameter Description
group_name

Specify a resource group or a number of resource groups in a space-delimited list that you want to relocate.
-k cid

Optionally, you can specify the resource group cardinality ID. If you specify this parameter, then CRSCTL relocates the resource instances that have the cardinality you specify.
-all

Specify this parameter to relocate all resource groups on the source server.
-w "filter"

Specify a resource group filter surrounded by double quotation marks ("") that CRSCTL uses to match resource groups. For example, -w "TYPE = ora.database.type" or -w "NAME = cs1".

See Also: Filters for more information about filters

-s source_server_name

Specify the name of the source server on which the resource groups reside that you want to relocate. This parameter is required.
-n target_server_name

Optionally, you can specify the name of the server to which you want to relocate the resource groups. If you do not specify a target server, then CRSCTL relocates the resource groups on the best server according to the attribute profile of each resource group.
-env "attr=val[,...]"

You can optionally override one or more resource group profile attribute values with the -env command parameter. If you specify multiple environment name-value pairs, then you must separate each pair with a comma and enclose the entire list in double quotation marks ("").

–f

Specify this option force the relocation of the resource groups you specify.
–i

If you specify -i, then the command returns an error if processing this command requires waiting for Oracle Clusterware to unlock the resource or its dependents. Sometimes, Oracle Clusterware locks resources or other objects to prevent commands from interfering with each other.

Example

To relocate all resource groups running on node1 to node2: 

$ crsctl relocate resourcegroup resGrp1 -s node1 -n node2

crsctl restart resourcegroup

Restarts resource groups on the server where they currently reside.

Syntax

crsctl restart resourcegroup {group_name [...] | -w "filter"} [-k cid]
   [-env "env1=val1,env2=val2,..."] [-f] [-i]

Parameters

Table E-29 crsctl restart resourcegroup Command Parameters

Parameters Description
group_name

Specify a resource group or a number of resource groups in a space-delimited list that you want to restart.
-w "filter"

Specify a resource group filter surrounded by double quotation marks ("") that Oracle Clusterware uses to match resource groups. For example, -w "TYPE = ora.database.type" or -w "NAME = cs1".

See Also: Filters for more information about filters

-k cid

Specify the resource group cardinality ID. If you specify this parameter, then Oracle Clusterware restarts the resource instances that have the cardinality you specify.
-env "env1=val1,env2=val2,..."

You can optionally override one or more resource group profile attribute values with the -env command parameter. If you specify multiple environment name-value pairs, then you must separate each pair with a comma and enclose the entire list in double quotation marks ("").

–f

Use the -f parameter to restart a resource, running on the server on which the resource group resides that you want to restart, that has a hard start dependency on another resource. If you do not specify the force parameter in this case, then the start command fails.

–i

If you specify -i, then the command returns an error if processing this command requires waiting for Oracle Clusterware to unlock the resource or its dependents. Sometimes, Oracle Clusterware locks resources or other objects to prevent commands from interfering with each other.

Example

The following command restarts resource group resGrp1: 

$ crsctl restart resourcegroup resGrp1

crsctl start resourcegroup

Starts one or more resource groups on specific or preconfigured servers.

CRSCTL starts resource groups to which there is a hard or weak start dependency, and all enabled member resources of the group. This command reports progress messages for each resource and resource group that CRSCTL starts.

Syntax

crsctl start resourcegroup {group_name [...] | -w "filter"] | -all}
  [-n server_name] [-k cid] [-env "attr=val[,..."]]
  [-f] [-i] [-l]

Parameters

Table E-30 crsctl start resourcegroup Command Parameters

Parameter Description
group_name

Specify a resource group or a number of resource groups in a space-delimited list that you want to start.
-w "filter"

Specify a resource group filter surrounded by double quotation marks ("") that CRSCTL uses to match resource groups. For example, -w "TYPE = ora.database.type" or -w "NAME = cs1".

See Also: Filters for more information about filters

-all

Specify this parameter to start all resource groups on the cluster.
-n server_name

Specify the name of the server on which the resource group you want to start resides. If you do not specify a server, then CRSCTL starts the resources on the best server according to the attribute profile of each resource.
-k cid

Specify the resource group cardinality ID. If you specify this parameter, then CRSCTL starts the resource instances that have the cardinality you specify.
-env "attr=val[,...]"

You can optionally override one or more resource group profile attribute values with the -env command parameter. If you specify multiple environment name-value pairs, then you must separate each pair with a comma and enclose the entire list in double quotation marks ("").

–f

Use the -f parameter to start a resource group on a server on which one of the resources in the resource group you want to start has a hard start dependency. If you do not specify the force parameter in this case, then the start command fails.

–i

If you specify -i, then the command returns an error if processing this command requires waiting for Oracle Clusterware to unlock the resource or its dependents. Sometimes, Oracle Clusterware locks resources or other objects to prevent commands from interfering with each other.

–l

Use the -l parameter to leave the resource groups in the state they were in if the start command fails.

Examples

To start a resource group:

$ crsctl start resourcegroup rg1

crsctl status resourcegroup

Displays the state of resource groups.

Syntax

crsctl status resourcegroup [group_name [...] | -w "filter"]
   [-p [-attr "attribute_name=attribute_value" [-noname]] | -v [-attr
   "attribute_name=attribute_value"] [-noname]]] | [-f] [-l] [-g] | [[-k cid | 
   -n server_name] [-e [-p | -v]]] [-s -k cid] | -noauto]]

Parameters

Table E-31 crsctl status resourcegroup Command Parameters

Parameter Description
group_name

Specify a resource group or a number of resource groups in a space-delimited list that you want to query. If you do not specify a resource group name or filters, then CRSCTL displays the status for all resource groups.
-w "filter"

Specify a resource group filter surrounded by double quotation marks ("") that Oracle Clusterware uses to match resource groups. For example, -w "TYPE = ora.database.type" or -w "NAME = cs1".

See Also: Filters for more information about filters

-p -attr "attribute_name=attribute_value" [-noname]  
-v [-attr "attribute_name=attribute_value"] [-noname]]

Optionally, you can specify this parameter to display the status for all member resources of a particular resource group.
–f

Optionally, you can specify this parameter to display the full configuration of the resource group.
-l  
-g  
-k cid

Specify the resource group cardinality ID. If you specify this parameter, then CRSCTL displays the status of the resource groups that have the cardinality you specify.
-n server_name  
–e

Optionally, you can specify this parameter to exclude automatic resource groups. The default is to display the status of all resource groups.

-p | -v  
-s -k cid  
-noauto  

Example

The following command shows the status of resource group rg1, which resides on node1: 

$ crsctl status resourcegroup rg1 -n node1

crsctl stop resourcegroup

Stops one or more resource groups on optionally specified preconfigured servers.

CRSCTL stops all member resources of the resource group. You must use the -f to stop the resource group if other resource groups have stop dependencies on it.

Syntax

crsctl stop resourcegroup {group_name [...] | -w "filter"] | -all}
  [-n server_name] [-k cid] [-env "attr=val[,...]"]
  [-f] [-i] [-l]

Parameters

Table E-32 crsctl stop resourcegroup Command Parameters

Parameter Description
group_name

Alternative to using -w or -all, you can specify a resource group or a number of resource groups in a space-delimited list that you want to stop.

-w "filter"

Alternative to specifying a resource group name or using -all, you can specify a resource group filter surrounded by double quotation marks ("") that CRSCTL uses to match resource groups. For example, -w "TYPE = ora.database.type" or -w "NAME = cs1".

See Also: Filters for more information about using filters.

-all

Alternative to specifying a resource name or using -w, you can specify this parameter to stop all resource groups on the cluster.

-n server_name

Specify the name of the server on which the resource group you want to stop resides. If you do not specify a server, then CRSCTL stops the resources on the best server according to the attribute profile of each resource.
-k cid

Specify the resource group cardinality ID. If you specify this parameter, then Oracle Clusterware stops the resource instances that have the cardinality you specify.
-env "attr=val[,...]"

You can optionally override one or more resource group profile attribute values with the -env command parameter. If you specify multiple environment name-value pairs, then you must separate each pair with a comma and enclose the entire list in double quotation marks ("").

–f

Use the -f parameter to stop a resource running on another server on which one of the resources in the resource group you want to stop has a hard stop dependency. If you do not specify the force parameter in this case, then the stop command fails.

–i

If you specify -i, then the command returns an error if processing this command requires waiting for Oracle Clusterware to unlock the resource or its dependents. Sometimes, Oracle Clusterware locks resources or other objects to prevent commands from interfering with each other.

–l

Use the -l parameter to leave the resource groups in the state they were in if the stop command fails.

Example

The following command stops resource group rg1: 

$ crsctl stop resourcegroup rg1

crsctl add resourcegrouptype

Registers a new resource group type in Oracle Clusterware.

Oracle recommends that applications that are made up of multiple resources define a resource group type to obtain a distinct identity and also to create new group-level attributes.

Syntax

crsctl add resourcegrouptype group_type_name –basetype base_group_type
  {-file file_path | -attr "attribute_name=attribute_value"} [-i]

Parameters

Table E-33 crsctl add resourcegrouptype Command Parameters

Parameter Description
group_type_name

Specify the name of the resource group type.
–basetype base_group_type

Specify the base group type of the resource group type.
-file file_path | -attr "attribute_name=attribute_value"

You must provide either a file or a list of attributes that define the resource group type.

Path name (either absolute or relative) for a text file containing line-delimited attribute name-value pairs that define the resource group type.

Following the -attr flag, you can specify one or more comma-delimited attribute name-value pairs enclosed in double quotations marks ("").

-i

If you specify -i, then CRSCTL returns an error if processing this command requires waiting for Oracle Clusterware to unlock the resource or its dependents. Sometimes, Oracle Clusterware locks resources or other objects to prevent commands from interfering with each other.

crsctl delete resourcegrouptype

Deletes one or more resource group types from Oracle Clusterware.

Syntax

crsctl delete resourcegrouptype {"group_type_name [...]" | -w "filter" [-i]

Parameters

Table E-34 crsctl delete resourcegrouptype Command Parameters

Parameter Description
group_type_name

Specify one or more group type names that you want to delete. Multiple group types must be space-delimited and enclosed in double quotation marks ("").

-w "filter"

Specify a resource filter that Oracle Clusterware uses to limit the number of resources evaluated for deletion. The filter must be enclosed in double quotation marks (""). Examples of resource filters include:

  • "TYPE == cluster_resource": This filter limits Oracle Clusterware to relocate only resources of cluster_resource type

  • "CHECK_INTERVAL > 10": This filter limits Oracle Clusterware to relocate resources that have a value greater than 10 for the CHECK_INTERVAL resource attribute

  • "(CHECK_INTERVAL > 10) AND (NAME co 2)": This filter limits Oracle Clusterware to relocate resources that have a value greater than 10 for the CHECK_INTERVAL resource attribute and the name of the resource contains the number 2

Note: All operators must be surrounded by spaces.

See Also: Filters for more information about operators

-i

If you specify -i, then CRSCTL returns an error if processing this command requires waiting for Oracle Clusterware to unlock the resource or its dependents. Sometimes, Oracle Clusterware locks resources or other objects to prevent commands from interfering with each other.

crsctl modify resourcegrouptype

Modifies a resource group type to add attributes or update the values of existing attributes.

Syntax

crsctl modify resourcegrouptype group_type_name -attr "attribute_name=attribute_value"

Usage Notes

You can modify the name of the resource group type and add or change existing attributes.

crsctl get tracefileopts

Returns the tracing settings for a specific module.

Syntax

crsctl get tracefileopts module_name

Usage Notes

Specify one of the following modules to obtain tracing information:

  • mdns: Multicast domain name server
  • gpnp: Grid Plug and Play service
  • css: Cluster Synchronization Services
  • crf: Cluster Health Monitor
  • crs: Cluster Ready Services
  • evm: Event Manager
  • gipc: Grid Interprocess Communication

crsctl set tracefileopts

Sets the tracing parameters for a specific module.

Syntax

crsctl set tracefileopts module_name [-filesize file_size[K|k|M|m|G|g]]
   [-numsegments number_of_segments]

Parameters

Table E-35 crsctl set tracefileopts Command Parameters

Parameter Description
module_name

Specify one of the following modules to set tracing information:

  • mdns: Multicast domain name server
  • gpnp: Grid Plug and Play service
  • css: Cluster Synchronization Services
  • crf: Cluster Health Monitor
  • crs: Cluster Ready Services
  • evm: Event Manager
  • gipc: Grid Interprocess Communication
-filesize file_size

Specify the size of a single trace file in kilobytes (K|k), megabytes (M|m), or gigabytes (G|g).

-numsegments number_of_segments

Specify the number of trace files to save before Oracle Clusterware rotates the older files out.

crsctl add type

Creates a resource type in Oracle Clusterware.

Syntax

crsctl add type type_name -basetype base_type_name {-attr "ATTRIBUTE=attribute_name
 | -file file_path,TYPE={string | int} [,DEFAULT_VALUE=default_value][,FLAGS=typeFlags"} [-i]

Parameters

Table E-36 crsctl add type Command Parameters

Parameter Description
type_name

Specify a name for the resource type in the form of xxx.yyy.type. Resource type names must be unique and cannot be changed after the resource type is registered.

-basetype base_type_name

The name of an existing base type. Any resource type that you create must either have local_resource or cluster_resource as its base resource type.

-attr "ATTRIBUTE=attribute_name

You can specify the resource type attributes using the -attr argument. Each type attribute definition can contain up to four type attribute keywords that must be displayed in the order shown. Enter a comma-delimited description of one or more resource type attributes enclosed in double quotation marks (""). The keywords for an attribute include:

  1. ATTRIBUTE: Specify a name for the attribute. The name is case-sensitive and cannot contain spaces.

  2. TYPE: Specify whether the attribute type is integer or string.

  3. DEFAULT_VALUE: (Optional) If the attribute is required, then a default value is not required. For attributes that are not required, you must specify a default value that Oracle Clusterware uses when you create resources based on this resource type.

  4. FLAGS: (Optional) Specify one or more of the following types, separated by a vertical bar (|):

    CONFIG: After you register a resource with this resource type, you can configure the attribute.

    READONLY: After you register a resource with this resource type, you cannot modify this attribute.

    REQUIRED: You must specify the name and value of this attribute when you create a resource that is based on this resource type. If you specify that this attribute is not required, then Oracle Clusterware uses the default value of this attribute that you specify.

    HOTMOD: If you change the value of an attribute for resources of this type, then the changes are applied immediately with the need to restart the resource.

You cannot use multiple -attr arguments to define multiple arguments for the resource type. Instead, you can specify multiple types within the double quotation marks after the -attr flag. For example: 

"ATTRIBUTE=FOO,TYPE=integer,DEFAULT_VALUE=0,
FLAGS=REQUIRED|HOTMOD,ATTRIBUTE=BAR,TYPE=string"

The preceding example defines two type attributes, FOO and BAR. When you specify the ATTRIBUTE keyword, it ends the previous type attribute (if any) and begins a new type attribute.

-file file_path

Path name (either absolute or relative) for a text file containing line-delimited resource type keyword-value pairs that define the resource type. An example of the contents of the file is:

ATTRIBUTE=FOO
TYPE=integer
DEFAULT_VALUE=0
FLAGS=REQUIRED
ATTRIBUTE=BAR
TYPE=string

Note: The keywords must be in the following order: ATTRIBUTE, TYPE, DEFAULT_VALUE, and FLAGS. When you specify the ATTRIBUTE keyword, it ends the previous type attribute (if any) and begins a new type attribute.

The preceding example defines two type attributes, FOO and BAR.

Note: All operators must be surrounded by spaces.

See Also: "Filters" for more information about operators

–i

If you specify -i, then the command fails if Oracle Clusterware cannot process the request immediately.

See Also:

"Oracle Clusterware Resource Types" for more information about resource types

Usage Notes

  • Both the type_name and base_type_name parameters are required

  • You can either specify a file containing the type information or you can specify the type information on the command line

  • Do not use this command for any resource types with names that begin with ora because these resource types are Oracle resource types

  • You must have read permissions on the base type

Example

To create a resource type for demoActionScript:
# crsctl add type test_type1 -basetype cluster_resource -attr
  "ATTRIBUTE=FOO,TYPE=integer,DEFAULT_VALUE=0"

crsctl delete type

Removes resource types from the Oracle Clusterware configuration.

Syntax

crsctl delete type type_name [-i]

Usage Notes

  • The type_name parameter is required. You can specify more than one type by separating each type by a space.

  • If you specify -i, then the command fails if Oracle Clusterware cannot process the request immediately.

  • Do not use this command for any resource types with names that begin with ora because these resource types are Oracle resource types.

Example

To delete two resource types, run the following command as a user who has write permissions on the resource type:
$ crsctl delete type test_type1 test_type2

crsctl getperm type

Obtains permissions for a particular resource type.

Syntax

crsctl getperm type resource_type  [-u user_name] | [-g group_name]

Parameters

Table E-37 crsctl getperm type Command Parameters

Parameter Description
resource_type

Specify the resource type for which you want to obtain permissions.
-u user_name

If you specify -u, then Oracle Clusterware obtains permissions for a particular user.

-g group_name

If you specify -g, then Oracle Clusterware obtains permissions for a particular group.

Usage Notes

  • The resource_type parameter is required

  • Do not use this command for any resource types with names that begin with ora because these resource types are Oracle resource types

See Also:

"Oracle Clusterware Resource Types" for more information about resource types

Example

This command returns output similar to the following:
$ crsctl getperm type app.appvip.type

Name: app.appvip.type
owner:root:rwx,pgrp:oinstall:rwx,other::r--

crsctl modify type

Modifies an existing resource type.

Syntax

crsctl modify type type_name -attr "ATTRIBUTE=attribute_name,TYPE={string | int}
  [,DEFAULT_VALUE=default_value [,FLAGS=[READONLY][| REQUIRED]]" [-i] [-f]]

Parameters

Table E-38 crsctl modify type Command Parameters

Parameter Description
type_name

Specify the name of the resource type you want to modify. You cannot modify resource type names.
–attr

You can modify the following resource type keywords:

  • TYPE

  • DEFAULT_VALUE

  • FLAGS

Note: Although you must specify the ATTRIBUTE keyword, you cannot modify it.

See Also: crsctl add type for descriptions of these keywords

–i

If you specify the -i parameter, then the command fails if Oracle Clusterware cannot process the request immediately.

Usage Notes

  • The type_name parameter is required

  • Do not use this command for any resource types with names that begin with ora because these resource types are Oracle resource types

See Also:

"Oracle Clusterware Resource Types" for more information about resource types

Example

The following example modifies the two type attributes FOO and BAR:
$ crsctl modify type myType.type -attr "ATTRIBUTE=FOO,DEFAULT_VALUE=0
ATTRIBUTE=BAR,DEFAULT_VALUE=baz"

crsctl setperm type

Sets permissions for resources of a particular resource type.

Syntax

crsctl setperm type resource_type_name {-u acl_string | -x acl_string |
-o user_name | -g group_name}

Parameters

Table E-39 crsctl setperm type Command Parameters

Parameter Description
resource_type_name

Specify the name of the resource type for which you want to set permissions.
-u | -x | -o | -g

You can specify only one of the following parameters for a resource type:

  • -u acl_string: You can update the access control list (ACL) for a resource type

  • -x acl_string: You can delete the ACL for a resource type

  • -o user_name: You can change the owner of a resource type by entering a user name

  • -g group_name: You can change the primary group of a resource type by entering a group name

Specify a user, group, or other ACL string, as follows:

user:user_name[:readPermwritePermexecPerm] |
group:group_name[:readPermwritePermexecPerm] |
other[::readPermwritePermexecPerm]

  • user: User ACL

  • group: Group ACL

  • other: Other ACL

  • readPerm: Read permission for the resource type; the letter r grants a user, group, or other read permission, the minus sign (-) denies read permission

  • writePerm: Write permission for the resource type; the letter w grants a user, group, or other write permission, the minus sign (-) denies write permission

  • execPerm: Execute permission for the resource type; the letter x grants a user, group, or other execute permission, the minus sign (-) denies execute permission

Usage Notes

  • The resource_type_name parameter is required

  • You must have read and write permissions on the specified resources to set their permissions

  • Do not use this command for any resource types with names that begin with ora because these resource types are Oracle resource types

Example

To grant read, write, and execute permissions on a resource type for user Scott:
$ crsctl setperm type resType -u user:scott:rwx

crsctl status type

Obtains the configuration information of one or more particular resource types.

Syntax

crsctl status type [resource_type_name [...] | -w "filter"] [-g] [-p] [-f] [-r]

Parameters

Table E-40 crsctl status type Command Parameters

Parameter Description
resource_type_name [...] | -w "filter"

Specify one or more space-delimited resource type names of which you want to check the status.

Alternatively, you can specify a resource type filter surrounded by double quotation marks ("") that CRSCTL uses to match resource types. For example, -w "TYPE = ora.database.type".

See Also: "Filters" for more information

[-g] [-p] [-f] [-r]

You can specify the following parameters as options when CRSCTL checks the status of specific resource types:

  • -g: Use this parameter to check if the specified resource types are registered

  • -p: Use this parameter to display static configuration of the specified resource types

  • -f: Use this parameter to display the full configuration of the resource types

  • –r: Use this parameter to print all of the base types

Usage Notes

The resource_type_name parameter or a filter is required.

Example

The crsctl status type command returns output similar to the following: 

$ crsctl status type ora.network.type

TYPE_NAME=ora.network.type
BASE_TYPE=ora.local_resource.type

Oracle RAC Environment CRSCTL Commands

You can use the following commands only in an Oracle RAC environment.

The commands listed in this section manage the Oracle Clusterware stack in an Oracle RAC environment, which consists of the following:

  • Oracle Clusterware and the member nodes

  • Oracle ASM (if installed)

  • Cluster Synchronization Services

crsctl request action

Performs a specific action on specific resource.

Syntax

crsctl request action action_name {-r resource_name [...] | -w "filter"}
  [-env "env1=val1,env2=val2,..."] [-i]

Parameters

Table E-41 crsctl request action Command Parameters

Parameter Description
action_name

Specify the name of the action you want perform. Actions supported by a particular resource are listed in the ACTIONS resource attribute of that resource.

-r resource_name [...]

Specify a particular resource. Multiple resource names must be separated by a space.
-w "filter"

Alternative to specifying resource names, you can specify a resource filter that Oracle Clusterware uses to limit the number of resources on which actions are performed. Examples of resource filters include:

  • TYPE == cluster_resource: This filter limits Oracle Clusterware to perform actions on only resources of cluster_resource type

  • CHECK_INTERVAL > 10: This filter limits Oracle Clusterware to perform actions on only resources that have a value greater than 10 for the CHECK_INTERVAL resource attribute

  • (CHECK_INTERVAL > 10) AND (NAME co 2): This filter limits Oracle Clusterware to perform actions on only resources that have a value greater than 10 for the CHECK_INTERVAL resource attribute and the name of the resource contains the number 2

See Also: "Filters" for more information

-env "env1=val1,env2=val2,..."

You can optionally override one or more resource profile attribute values with the -env command parameter. If you specify multiple environment name-value pairs, then you must separate each pair with a comma and enclose the entire list in double quotation marks ("").

–i

If you specify -i, then the command fails if Oracle Clusterware cannot process the request immediately.

Usage Notes

The action_name must be a supported action, defined both in the agent and in the ACTIONS resource attribute, and the user must have permission to run the action. You can set permissions in the ACTIONS resource attribute.

Example

To initiate the specified action inside the application specific agent of a particular resource:
$ crsctl request action action1 -r res1

crsctl add category

Adds a server category.

Syntax

crsctl add category category_name [-attr "attr_name=attr_value
   [,attr_name=attr_value[,...]]"] [-i]

Parameters

Table E-42 crsctl add category Command Parameters

Parameter Description
category_name

Specify a name for the server category you want to add.
-attr "attr_name=attr_value[,...]"

Specify the name-value pair of a category attribute you want to add preceded by the -attr flag.

Note: The attr_name and attr_value parameters must be enclosed in double quotation marks (""), and separate multiple name-value pairs with commas. For example: 

-attr "EXPRESSION='(CPU_COUNT > 2) AND (MEMORY_SIZE > 2048)'"

See Also:

  • "Filters" for information about operators

–i

If you specify -i, then the command fails if Oracle Clusterware cannot process the request immediately.

Usage Notes

If an attribute value for an attribute name-value pair contains commas, then the value must be enclosed in single quotation marks (''). For example:
"START_DEPENDENCIES='hard(res1,res2,res3)'"

Example

To add a server category:
$ crsctl add category cat1 -attr "EXPRESSION='(CPU_COUNT > 2) AND (MEMORY_SIZE > 2048)'"

crsctl delete category

Deletes a server category.

Syntax

crsctl delete category category_name [category_name [...]] [-i]

Usage Notes

  • Specify the name of the server category or a space-delimited list of server categories that you want to delete.

  • If you specify -i, then the command fails if Oracle Clusterware cannot process the request immediately.

Example

To delete a server category:
$ crsctl delete category blue_server -i

crsctl modify category

Modifies an existing server category.

Syntax

crsctl modify category category_name [-attr "attr_name=attr_value
   [,attr_name=attr_value[,...]]"] [-i] [-f]

Parameters

Table E-43 crsctl modify category Command Parameters

Parameter Description
category_name

Specify the name of the server category you want to modify.
-attr "attr_name=attr_value[,...]"

Specify the name-value pair of a category attribute you want to modify preceded by the -attr flag.

Note: The attr_name and attr_value parameters must be enclosed in double quotation marks (""), and separate multiple name-value pairs with commas. For example: 

"ACL='owner:st-cdc\cdctest:rwx,pgrp::---',
EXPRESSION='(SITE_NAME = west)'"

See Also:

  • "Filters" for information about operators

–i

If you specify -i, then the command fails if Oracle Clusterware cannot process the request immediately.

–f

Use this parameter to force the operation.

Usage Notes

If an attribute value for an attribute name-value pair contains commas, then the value must be enclosed in single quotation marks (''). For example:
"START_DEPENDENCIESs=s'hard(res1,res2,res3)'"

Example

To modify a server category:
$ crsctl modify category blue_server -attr  "EXPRESSION='(SITE_NAME = west)'"

crsctl status category

Obtains information about a server category.

Syntax

crsctl status category {category_name [category_name [...]] | [-w "filter" |
   -server server_name]}

Parameters

Table E-44 crsctl status category Command Parameters

Parameter Description
category_name [...]

Specify the name of the server category or a space-delimited list of server categories for which you want to obtain the status.
-w "filter"

Alternatively, you can specify a category filter preceded by the -w flag.

See Also: "Filters" for more information

-server server_name

Alternatively, you can specify a particular server to list all of the categories that the server matches.

Examples

To print all resources containing ASM:
$ crsctl stat res -w "NAME co asm" -t
--------------------------------------------------------------------------------
Name   Target   State   Server            State details       
-------------------------------------------------------------------------------- 
Cluster Resources
--------------------------------------------------------------------------------
ora.asm(ora.asmgroup)
1      ONLINE   ONLINE   stbm000042-vm1   Started,STABLE
2      ONLINE   ONLINE   stbm000042-vm2   Started,STABLE
3      ONLINE   ONLINE   stbm000042-vm3   Started,STABLE 
ora.asmnet1.asmnetwork(ora.asmgroup)       
1      ONLINE  ONLINE    stbm000042-vm1   STABLE
2      ONLINE  ONLINE    stbm000042-vm2   STABLE
3      ONLINE  ONLINE    stbm000042-vm3   STABLE
--------------------------------------------------------------------------------
To print all resources containing db:
$ crsctl stat res -w "NAME co db" -t
--------------------------------------------------------------------------------
Name   Target   State   Server             State details       
-------------------------------------------------------------------------------- 
Cluster Resources
--------------------------------------------------------------------------------
ora.cdb19.db
1      ONLINE   ONLINE   stbm000042-vm1    Open,HOME=/u01/app/oracle/product/19c/dbhome,STABLE
2      ONLINE   ONLINE   stbm000042-vm2    Open,HOME=/u01/app/oracle/product/19c/dbhome,STABLE
3      ONLINE   ONLINE   stbm000042-vm3    Open,HOME=/u01/app/oracle/product/19c/dbhome,STABLE
4      ONLINE   ONLINE   stbm000042-vm4    Open,HOME=/u01/app/oracle/product/19c/dbhome,STABLE
--------------------------------------------------------------------------------
To print all resources containing db and their state is ONLINE:
crsctl stat res -w "(NAME en db) AND (STATE = ONLINE)" -t
--------------------------------------------------------------------------------
Name   Target   State   Server             State details       
--------------------------------------------------------------------------------
Cluster Resources
--------------------------------------------------------------------------------
ora.cdb19.db
1      ONLINE   ONLINE   stbm000042-vm1    Open,HOME=/u01/app/oracle/product/19c/dbhome,STABLE
2      ONLINE   ONLINE   stbm000042-vm2    Open,HOME=/u01/app/oracle/product/19c/dbhome,STABLE
3      ONLINE   ONLINE   stbm000042-vm3    Open,HOME=/u01/app/oracle/product/19c/dbhome,STABLE
4      ONLINE   ONLINE   stbm000042-vm4    Open,HOME=/u01/app/oracle/product/19c/dbhome,STABLE

crsctl check cluster

Checks the status of the Oracle Clusterware stack from any node in the cluster.

Syntax

crsctl check cluster [-all | [-n server_name [...]]

Usage Notes

  • You can check the status of the Oracle Clusterware stack on all nodes in the cluster with the -all parameter or you can specify one or more space-delimited nodes. If you do not specify either parameter, then Oracle Clusterware checks the status of the Oracle Clusterware stack on the local server.

  • You can use this cluster-aware command on any node in the cluster.

Example

The crsctl check cluster command returns output similar to the following:
$ crsctl check cluster -all
*****************************************************************
node1:
CRS-4537: Cluster Ready Services is online
CRS-4529: Cluster Synchronization Services is online
CRS-4533: Event Manager is online
*****************************************************************
node2:
CRS-4537: Cluster Ready Services is online
CRS-4529: Cluster Synchronization Services is online
CRS-4533: Event Manager is online
*****************************************************************

crsctl start cluster

Starts the Oracle Clusterware stack when run on any node in the cluster.

Syntax

crsctl start cluster [[-all] | [-n server [...]] | -w "filter"]

Parameters

Table E-45 crsctl start cluster Command Parameters

Parameter Description
-all

Use this parameter to start the Oracle Clusterware stack on all servers in the cluster.
-n server [...]

Optionally, you can specify one or more named servers in the cluster (separate multiple server names by a space), or the local server, if you do not specify either -all or -n.

-w "filter"

Optionally, you can use this parameter to start only servers that match a filter.

See Also: Filters for more information about filters.

crsctl stop cluster

Stops the Oracle Clusterware stack on all servers in the cluster or specific servers when you run the command on any node in the cluster.

Syntax

crsctl stop cluster [[-all] | [-n server [...]] | -w "filter"] [-f]

Parameters

Table E-46 crsctl stop cluster Command Parameters

Parameter Description
-all

Use this parameter to start the Oracle Clusterware stack on all servers in the cluster.
-n server [...]

Optionally, you can specify one or more named servers in the cluster (separate multiple server names by a space), or the local server, if you do not specify either -all or -n.

-w "filter"

Optionally, you can use this parameter to stop only servers that match a filter.

See Also: Filters for more information about filters.

Usage Notes

  • You must run this command as root.

  • If you do not specify -all or one or more space-delimited server names, then Oracle Clusterware stops the Oracle Clusterware stack on the local server.

  • You can use this cluster-aware command on any node in the cluster.

  • This command attempts to gracefully stop resources managed by Oracle Clusterware while attempting to stop the Oracle Clusterware stack.

    If any resources that Oracle Clusterware manages are still running after you run the crsctl stop cluster command, then the command fails. Use the -f parameter to unconditionally stop all resources and stop the Oracle Clusterware stack.

  • If you intend to stop Oracle Clusterware on all or a list of nodes, then use the crsctl stop cluster command, because it prevents certain resources from being relocated to other servers in the cluster before the Oracle Clusterware stack is stopped on a particular server. If you must stop the Oracle High Availability Services on one or more nodes, then wait until the crsctl stop cluster command completes and then run the crsctl stop crs command on any particular nodes, as necessary.

Example

To stop the Oracle Clusterware stack on a particular server:

# crsctl stop cluster -n node1

crsctl get cluster class

Obtains cluster class information.

Syntax

crsctl get cluster class

Usage Notes

This command has no parameters.

crsctl get cluster configuration

Displays the cluster configuration information.

Syntax

crsctl get cluster configuration

Usage Notes

This command has no parameters.

crsctl set cluster disabledtlsciphersuite

Adds a cipher suite to or removes a cipher suite from a list of disabled cipher suites used to secure inter-node communication.

Syntax

crsctl set cluster disabledtlsciphersuite add | delete cipher_suite_name

Usage Notes

Use the add or delete verb to perform the operation you want and specify the name of the cipher suite you want to add or remove.

crsctl get cluster extended

Determines whether the cluster is an extended cluster.

Syntax

crsctl get cluster extended

Usage Notes

This command has no parameters.

Example

This command returns output similar to the following:

$ crsctl get cluster extended
CRS-XXXX: The cluster is 'EXTENDED'
$ crsctl get cluster extended
CRS-XXXX: The cluster is 'NOT EXTENDED'

crsctl get cluster mode

Ascertains whether the cluster is configured for Oracle Flex Clusters or obtains the current status.

Syntax

crsctl get cluster mode [config | status]

Usage Notes

  • Specify the config option to obtain the mode in which the cluster is configured.

  • Specify the status option to obtain the current status of the cluster.

crsctl set cluster mode

Changes a standard cluster to an Oracle Flex Cluster.

Syntax

crsctl set cluster mode flex

Usage Notes

This command takes only the flex parameter, which is required.

crsctl get cluster name

Displays the current cluster name.

Syntax

crsctl get cluster name

Usage Notes

This command has no parameters.

crsctl add cluster site

Use the crsctl add cluster site command to add a site to an extended cluster.

Syntax

$ crsctl add cluster site site_name [-guid site_guid]

Usage Notes

  • You must specify a name for the site you are adding. Optionally, you can provide a GUID for the site.

  • An extended cluster can have a maximum of five sites.

  • You cannot run this command in a cluster that is not extended.

Examples

The following command example adds a site called SiteA to an extended cluster: 

$ crsctl add cluster site SiteA

crsctl delete cluster site

Use the crsctl delete cluster site command to delete a specific site from an extended cluster.

Syntax

$ crsctl delete cluster site site_name

Usage Notes

  • You must specify the name of the site that you want to delete.

  • You cannot run this command in a cluster that is not extended.

  • You cannot delete a site that has nodes or disks. You must delete the nodes and drop the disks before you can delete the site.

Examples

The following command deletes a site named SiteA from an extended cluster: 

$ crsctl delete cluster site SiteA

crsctl modify cluster site

Modifies the configuration of a site in an extended cluster.

Syntax

crsctl modify cluster site site_name {–n node1, node2, ... | -s {rejuvenate | quarantine} | [-local]}

Parameters

Table E-47 crsctl modify cluster site Command Parameters

Parameter Description
site_name

Specify the name of the site you want to modify.
–n node1, node2, ...

Specify this parameter to make a global change in Oracle Cluster Registry (OCR) and also push the changes to the Oracle Local Registry (OLR) on all the nodes.
-s {rejuvenate | quarantine}

Specify a state for the site.

  • rejuvenate: Use this option to enable a previously quarantined site.

    A site is typically quarantined by Oracle Clusterware and Oracle ASM when it detects a storage split.

  • quarantine: Use this option if you want to explicitly quarantine a site. Oracle Clusterware will not start any database instances nor Oracle ASM on a quarantined site. In the event of a storage split, Oracle Clusterware detects the condition and sets the site to quarantine status.

-local

Optionally, you can specify this parameter to make changes only to the Oracle Local Registry on the local node. Oracle provides this command for certain scripts that can run this when OCR is not available or for a user, if the node goes down when a global change is performed.

Examples

The following command example adds a node called node11 to the SiteA: 

$ crsctl modify cluster site SiteA –n node1, node2,node11

crsctl query cluster site

Displays site information in an extended cluster.

Syntax

$ crsctl query cluster site {site_name | -all}

Usage Notes

  • You can specify a particular site by name or you use -all to get the information for all the sites in the extended cluster.

  • The command returns the names of the sites, the site GUID, the site state, and the components of the site.

  • The Oracle Clusterware technology stack must be active and up to run this command.

  • An extended cluster can have up to five sites.

Examples

This command returns output similar to the following:

$ crsctl query cluster site –all
Site 'SiteA' identified by GUID '7b7b3bef4c1f5ff9ff8765bceb45433a' in state 'ONLINE' contains nodes 'node1,node2,node3', and disks 'disk1, disk2, disk3'.
Site 'SiteB' identified by GUID '23453bef4c1f5ff9ff8765bceb45433a' in state 'QUARANTINED' contains nodes 'node4, node5, node6', and disks 'disk4, disk5, disk6'.
Site 'SiteQ' identified by GUID '98763bef4c1f5ff9ff8765bceb45433a' in state 'ONLINE' contains no nodes and disk 'disk7'.
Site 'SiteD' identified by GUID '4abcd453c6bc6fc1ffd3a58849d5ba41' in state 'ONLINE' contains nodes 'cuj1234' and no disk.

crsctl get cluster tlsciphersuite

Lists available cipher suites used by transport layer security for securing inter-node communication.

Syntax

crsctl get cluster tlsciphersuite [disabled|all]

Usage Notes

Optionally, you can specify disabled to list only those cipher suites disabled for use, or you can specify all to list all cipher suites.

crsctl get cluster type

Use the crsctl get cluster type command to determine whether the cluster is an Oracle Flex Cluster or an application cluster.

Syntax

crsctl get cluster type

This command returns the cluster type, either flex or application.

crsctl set cluster type

Sets the type of the cluster.

Syntax

crsctl Set cluster type flex | application

Usage Notes

Specify either flex or application to choose which type of cluster you want to set.

crsctl get cpu equivalency

The crsctl get cpu equivalency command obtains the value of the CPU_EQUIVALENCY server configuration attribute.

Syntax

crsctl get cpu equivalency

Example

This command returns output similar to the following:

$ crsctl get cpu equivalency

CRS-4963: Current cpu equivalency parameter value is 1000

crsctl set cpu equivalency

The crsctl set cpu equivalency command sets a value for the CPU_EQUIVALENCY server configuration attribute.

Syntax

crsctl set cpu equivalency number

Usage Notes

This command takes only a numerical value to set the CPU_EQUIVALENCY server configuration attribute.

Example

The following example sets the value of the CPU_EQUIVALENCY server configuration attribute to 2000: 

$ crsctl set cpu equivalency 2000

CRS-4416: Server attribute 'CPU_EQUIVALENCY' successfully changed.
 Restart Oracle High Availability Services for new value to take effect.

crsctl get restricted placement

The crsctl get restricted placement command obtains the value of the placement policy for resources that use WORKLOAD_CPU server configuration attribute.

Syntax

crsctl get restricted placement

Example

This command returns output similar to the following:

 $ crsctl get restricted placement
CRS-46857: Current restricted placement value (of PACK_FLAVOR attribute) is 'spread'

crsctl set restricted placement

The crsctl set restricted placement command sets a value for the placement policy for resources that use the WORKLOAD_CPU server configuration attribute.

Syntax

crsctl set restricted placement {fill|spread}

Options

Option Description
fill Sets the placement policy for WORKLOAD_CPU resources to the value of fill.
spread Sets the placement policy for WORKLOAD_CPU resources to the value of spread.

Usage Notes

Specify either fill or spread to set the value of the placement policy for resources that use the WORKLOAD_CPU attribute.

Example

The following example sets the value of the placement policy for resources that use WORKLOAD_CPU to fill. 

$ crsctl set restricted placement fill

crsctl check crs

Checks the status of Oracle High Availability Services and the Oracle Clusterware stack on the local server.

Syntax

crsctl check crs

Example

This command returns output similar to the following:
CRS-4638: Oracle High Availablity Services is online
CRS-4537: Cluster Ready Services is onlin
CRS-4529: Cluster Synchronization Services is online
CRS-4533: Event Manager is online

crsctl config crs

Displays Oracle High Availability Services automatic startup configuration.

Syntax

crsctl config crs

Example

This command returns output similar to the following:
CRS-4622: Oracle High Availability Services autostart is enabled.

crsctl disable crs

Prevents the automatic startup of Oracle High Availability Services when the server boots.

Syntax

crsctl disable crs

Usage Notes

  • This command only affects the local server

  • If you disable Oracle High Availability Services automatic startup, you must use the crsctl start crs command to start Oracle High Availability Services

Example

This command returns output similar to the following:
CRS-4621: Oracle High Availability Services autostart is disabled.

crsctl enable crs

Enables automatic startup of Oracle High Availability Services when the server boots.

Syntax

crsctl enable crs

Usage Notes

This command only affects the local server

Example

This command returns output similar to the following:
CRS-4622: Oracle High Availability Services autostart is enabled.

crsctl start crs

Starts Oracle High Availability Services on the local server.

Syntax

crsctl start crs [-excl [-nocrs] [-cssonly]] | [-wait | -waithas | -nowait] | [-noautostart]

Parameters

Table E-48 crsctl start crs Command Parameters

Parameter Description
-excl [-nocrs] [-cssonly]

Starts Oracle Clusterware in exclusive mode with two options:

  • Specify the -nocrs parameter to start Oracle Clusterware in exclusive mode without starting CRSD.

  • Specify the -cssonly parameter to start CSSD, only.

-wait | -waithas | -nowait

Choose one of the following:

  • Specify -wait to wait until startup is complete and display all progress and status messages.

  • Specify -waithas to wait until startup is complete and display OHASD progress and status messages.

  • Specify -nowait to not wait for OHASD to start

-noautostart

Start only OHASD.

Usage Notes

  • You must run this command as root

  • This command starts Oracle High Availability Services only on the local server

Example

To start Oracle High Availability Services on the local server:
# crsctl start crs

crsctl stop crs

Stops Oracle High Availability Services on the local server.

Syntax

crsctl stop crs [-f]

Usage Notes

  • You must run this command as root.

  • This command attempts to gracefully stop resources managed by Oracle Clusterware while attempting to stop Oracle High Availability Services on the local server.

    If any resources that Oracle Clusterware manages are still running after you run the crsctl stop crs command, then the command fails. Use the -f parameter to unconditionally stop all resources and stop Oracle High Availability Services on the local server.

  • If you intend to stop Oracle Clusterware on all or a list of nodes, then use the crsctl stop cluster command, because it prevents certain resources from being relocated to other servers in the cluster before the Oracle Clusterware stack is stopped on a particular server. If you must stop the Oracle High Availability Services on one or more nodes, then wait until the crsctl stop cluster command completes and then run the crsctl stop crs command on any particular nodes, as necessary.

  • Before attempting to shut down the Oracle Clusterware technology stack on all nodes with an Oracle ASM instance running in parallel in an Oracle Clusterware standard Cluster with Oracle Flex ASM enabled, you must first relocate at least one Oracle ASM instance to another node where Oracle ASM is not running.

  • CRSCTL uses a shutdown abort stop option when running this command to improve high availability and failover times.

  • If you shut down the database with SRVCTL, before you run crsctl stop crs, then you must restart the resources after Oracle Clusterware comes up.

Example

To stop Oracle High Availability Services on the local server:

# crsctl stop crs

crsctl query crs activeversion

Displays the active version and the configured patch level of the Oracle Clusterware software running in the cluster.

During a rolling upgrade, however, the active version is not advanced until the upgrade is finished across the cluster, until which time the cluster operates at the pre-upgrade version. Additionally, during a rolling patch, the active patch level is not advanced until the patching is finished across the cluster, until which time the cluster operates at the pre-upgrade patch level.

Syntax

crsctl query crs activeversion [-f]

Usage Notes

If you specify the -f parameter, then this command also prints the patch level for each configured node in the cluster.

Example

This command returns output similar to the following:
Oracle Clusterware active version on the cluster is [23.0.0.0.0]. The cluster
upgrade state is [NORMAL]. The cluster active patch level is [456789126].

States

The following table lists and describes Oracle Clusterware upgrade states that are displayed by the crsctl query crs activeversion -f command.

Table E-49 Oracle Clusterware Upgrade State Descriptions

State Description
NORMAL

Oracle Clusterware upgrade has completed successfully and the cluster is ready for next patching or upgrade cycle.
FORCED

Oracle Clusterware upgrade was completed forcibly on all reachable nodes, while one or more cluster nodes were unreachable.

You can either upgrade or delete the unreachable cluster nodes to change the upgrade state from FORCED to NORMAL.

ROLLING PATCH

Oracle Clusterware is in the middle of a rolling patch.
ROLLING UPGRADE

Oracle Clusterware is in the middle of a rolling upgrade.
UPGRADE FINAL

Oracle Clusterware upgrade and the root script execution has completed successfully, and the installer is performing the final upgrade steps.

FORCED UPGRADE FINAL

Oracle Clusterware upgrade and the root script execution has completed successfully on all reachable nodes, while one or more cluster nodes were unreachable. The installer is performing the final upgrade steps.

ROLLING PATCH DURING ROLLING UPGRADE

Oracle Clusterware is being patched in the middle of a rolling upgrade.
UPGRADE AV UPDATED

Oracle Clusterware active version has updated to latest version and the root script is performing the final upgrade steps.

FORCED UPGRADE AV UPDATED

Oracle Clusterware active version has updated forcibly to latest version on all reachable nodes, while one or more nodes were unreachable. The root script is performing the final upgrade steps.

crsctl query crs autostart

Obtains the values of the Oracle Clusterware automatic resource start criteria.

Syntax

crsctl query crs autostart

Example

This command returns output similar to the following:
'Autostart delay':       60
'Autostart servercount': 2

crsctl set crs autostart

Sets the Oracle Clusterware automatic resource start criteria.

The autostart delay and minimum server count criteria delay Oracle Clusterware resource autostart until one of the two conditions are met.

Syntax

crsctl set crs autostart [delay delay_time] [servercount count]

Parameters

Table E-50 crsctl set crs autostart Command Parameters

Parameter Description
delay delay_time

Specify the number of seconds to delay Oracle Clusterware autostart.
servercount count

Specify the minimum number of servers required for Oracle Clusterware autostart.

Example

To ensure that Oracle Clusterware delays resource autostart for 60 seconds after the first server in the cluster is ONLINE:
$ crsctl set crs autostart delay 60
To ensure that Oracle Clusterware waits for there to be at least two servers ONLINE before it initiates resource autostart:
$ crsctl set crs autostart servercount 2
To ensure that Oracle Clusterware delays resource autostart until either of the previous two conditions are met (in no particular order):
$ crsctl set crs autostart delay 60 servercount 2

crsctl query crs releasepatch

Displays the patch level which is updated in the Grid home patch repository while patching a node.

The patch level corresponds to only the local node on which you run the command. You can run this command while the Oracle Clusterware stack is not running.

Syntax

crsctl query crs releasepatch

Example

This command returns output similar to the following for a node which has no patches applied:
Oracle Clusterware release patch level is [3180840333] and the complete list of
patches is [13559647] on the local node.

crsctl query crs releaseversion

Displays the version of the Oracle Clusterware software stored in the binaries on the local node.

Syntax

crsctl query crs releaseversion

Example

This command returns output similar to the following:
Oracle High Availablity Services release version on the local node is [23.0.0.0.0]

crsctl query crs site

Use the crsctl query crs site command to determine to which site a specific host or disk belongs.

Syntax

crsctl query crs site {-n host_name | -d disk_name}

Usage Notes

  • You must specify either a host name or a disk name.

  • The Oracle Clusterware technology stack must be active to run this command.

Examples

This command returns output similar to the following:

$ crsctl query crs site –n hostA
Host 'hostA' is a part of site 'SiteA'

crsctl query crs softwarepatch

Displays the configured patch level of the installed Oracle Clusterware.

Syntax

crsctl query crs softwarepatch [host_name]

Usage Notes

You can optionally specify a host name to display the patch level of Oracle Grid Infrastructure installed on that particular host. Otherwise, CRSCTL displays the patch level of Oracle Grid Infrastructure installed on the local host.

Example

This command returns output similar to the following:
Oracle Clusterware patch level on node [node1] is [456789126]

crsctl query crs softwareversion

Displays the latest version of the software that has been successfully started on the specified node.

Syntax

crsctl query crs softwareversion [node_name]

Usage Notes

If you do not provide a node name, then Oracle Clusterware displays the version of Oracle Clusterware running on the local server.

Example

This command returns output similar to the following:
Oracle Clusterware version on node [node1] is [23.0.0.0.0]

crsctl get css

Obtains the value of a specific Cluster Synchronization Services parameter.

Syntax

crsctl get css parameter

Usage Notes

  • Cluster Synchronization Services parameters and their default values include:

    clusterguid
diagwait
disktimeout (200 (seconds))
misscount (30 (seconds))
reboottime (3 (seconds))
priority (4 (UNIX), 3 (Windows))
logfilesize (50 (MB))

  • This command does not display default values.

  • This command only affects the local server.

Example

This command returns output similar to the following:
$ crsctl get css disktimeout
CRS-4678: Successful get disktimeout 200 for Cluster Synchronization Services.

crsctl pin css

Pins many specific nodes.

Pinning a node means that the association of a node name with a node number is fixed. If a node is not pinned, its node number may change if the lease expires while it is down. The lease of a pinned node never expires.

Syntax

crsctl pin css -n node_name [ node_name [...]]

Usage Notes

  • You can specify a space-delimited list of servers

  • Any pre-12c release 1 (12.1) Oracle software must reside on a pinned server.

  • A node may be unpinned with crsctl unpin css.

  • Deleting a node with the crsctl delete node command implicitly unpins the node.

Example

To pin the node named node2:
# crsctl pin css -n node2

crsctl set css

Sets the value of a Cluster Synchronization Services parameter.

Syntax

crsctl set css parameter value

Usage Notes

  • Do not use the crsctl set css command to set the following parameters unless instructed to do so by My Oracle Support.

  • Cluster Synchronization Services parameters include:

    diagwait
disktimeout
logfilesize
misscount
priority
reboottime

crsctl unpin css

Unpins many servers.

If a node is not pinned, its node number may change if the lease expires while it is down.

Syntax

crsctl unpin css -n node_name [node_name [...exit]]

Usage Notes

  • You can specify a space-delimited list of nodes.

  • Unpinned servers that stop for longer than a week are no longer reported by olsnodes. These servers are dynamic when they leave the cluster, so you do not need to explicitly remove them from the cluster.

  • Deleting a node with the crsctl delete node command implicitly unpins the node.

  • During upgrade of Oracle Clusterware, all servers are pinned, whereas after a fresh installation of Oracle Clusterware 12c or a later release, all servers you add to the cluster are unpinned.

  • You cannot unpin a server that has an instance of Oracle RAC that is older than 12c release 1 (12.1) if you installed Oracle Clusterware 12c or a later release on that server.

Example

To unpin two nodes:
$ crsctl unpin css -n node1 node4

crsctl unset css

Unsets the value of a Cluster Synchronization Services parameter and restores it to its default value.

Syntax

crsctl unset css parameter

Usage Notes

  • You can specify the following Cluster Synchronization Services parameters:

    • diagwait

    • disktimeout

    • misscount

    • reboottime

    • priority

    • logfilesize

Example

To restore the reboottime Cluster Synchronization Services parameter to its default value:
$ crsctl unset css reboottime

crsctl get ipmi binaryloc

Retrieves the location of the ipmitool or ipmiutil binary.

Syntax

get ipmi binaryloc

Usage Notes

Run the command to retrieve the ipmitool or ipmiutil binary location on each node. A value is returned only if the location has been previously set with the set ipmi binaryloc command.

Examples

To retrieve the ipmitool or ipmiutil binary location on a node: 

crsctl get ipmi binaryloc

crsctl set ipmi binaryloc

Sets the location of the ipmitool or ipmiutil binary.

Syntax

set ipmi binaryloc binary_location

Usage Notes

Run the command to set the ipmitool or ipmiutil binary location on each node.

Before running any other CRSCTL commands that modify the IPMI configuration, the crsctl set ipmi binaryloc command must be run on all nodes where the binary location has changed.

Examples

To set the ipmitool or ipmiutil binary location on a node: 


crsctl set ipmi binaryloc /usr/bin/ipmitool
crsctl set ipmi binaryloc /usr/bin/ipmiutil

crsctl get css ipmiaddr

Retrieves the address stored in the Oracle Local Registry of the local Intelligent Platform Management Interface (IPMI) device.

Syntax

crsctl get css ipmiaddr

Usage Notes

  • Run the command under the user account used to install Oracle Clusterware.

  • This command only obtains the IP address stored in the Oracle Local Registry. It may not be the IP address actually used by IPMI.

    Use either ipmiutil or ipmitool as root on the local server to obtain the IP address used by the IPMI device.

crsctl set css ipmiaddr

Stores the address of the local Intelligent Platform Management Interface (IPMI) device in the Oracle Local Registry.

Syntax

crsctl set css ipmiaddr ip_address

Usage Notes

  • Run the command under the user account used to install Oracle Clusterware

  • Obtain the IP address used by the IPMI device using either ipmiutil or ipmitool as root on the local server

  • Oracle Clusterware stores the IP address for IPMI in the configuration store, and distributes the address as required

  • This command only stores the IPMI IP address on the server from which you run it

  • This command fails if another server cannot access IPMI at the supplied address

Example

To store the IPMI IP address on a local server and distribute it to other cluster nodes:
$ crsctl set css ipmiaddr 192.0.2.244

crsctl set css ipmiadmin

Stores the login credentials of an Intelligent Platform Management Interface (IPMI) administrator in the Oracle Local Registry.

Syntax

crsctl set css ipmiadmin ipmi_administrator_name

Usage Notes

  • This command must be run under the user account that installed Oracle Clusterware.

  • When prompted, provide the new password to associate with the new administrator account name. Oracle Clusterware stores the name and password for the local IPMI in the configuration store, and distributes the new credentials as required.

  • This command only modifies the IPMI administrator on the server from which you run it.

  • This command fails if another server cannot access the local IPMI at the supplied address.

Example

To modify the IPMI administrator scott:
$ crsctl set css ipmiadmin scott

crsctl query css ipmiconfig

Determines whether Oracle Clusterware on the local server has been configured to use IPMI for failure isolation.

Note that this command detects the presence of configuration data, but cannot not validate its correctness.

Syntax

crsctl query css ipmiconfig

Usage Notes

  • This command attempts to locate and access the IPMI configuration stored in the Oracle Cluster Registry (OCR) and should be run under the account used to install Oracle Clusterware, or an authorization failure may be reported.

  • An authorization failure may not result when run under another account, if the registry contains no IPMI configuration data.

Example

This command returns output similar to the following:
CRS-4236: Oracle Clusterware configured to use IPMI
Or:
CRS-4237: Oracle Clusterware is not fully configured to use IPMI

crsctl unset css ipmiconfig

Clears all previously stored IPMI configuration (login credentials and IP address) from the Oracle Local Registry.

Prerequisites

This is appropriate when deconfiguring IPMI in your cluster or if IPMI configuration was previously stored by the wrong user.

Syntax

crsctl unset css ipmiconfig

Usage Notes

  • This command must be run under the user account originally used to configure IPMI or by a privileged user.

  • This command only clears the IPMI configuration on the server on which you run it.

  • If Oracle Clusterware was able to access and use the configuration data to be deleted by this command, then it will continue to do so until you restart Oracle Clusterware.

Example

To clear the IPMI configuration data from the Oracle Local Registry and restart Oracle Clusterware to prevent further use of IPMI, log in as root or a member of the Administrator's group on Windows and run the following commands:
# crsctl unset css ipmiconfig
# crsctl stop crs
# crsctl start crs

crsctl query css ipmidevice

Determines the presence of the Intelligent Platform Management Interface (IPMI) driver on the local system.

Syntax

crsctl query css ipmidevice

Usage Notes

  • This command performs a pre-check during IPMI installation, and is normally issued only by the installer.

  • This command performs a perfunctory check and a success return does not guarantee that the IPMI hardware is fully configured for use.

  • There are no special privileges required to run this command.

Example

This command returns output similar to the following:
CRS-4231: IPMI device and/or driver found
Or:
CRS-4218: Unable to access an IPMI device on this system

crsctl get css noautorestart

Lists the problems for which automatic restart of Cluster Synchronization Services is disabled.

Syntax

crsctl get css noautorestart

Usage Notes

  • This command has no parameters.

  • CRSCTL returns one of three possible values:
    • all: Auto restart is disabled for any problem.
    • interconnect: Auto restart is disabled when an interconnect problem occurs.
    • vf: Auto restart is disabled when a voting files problem occurs.

crsctl set css noautorestart

Stops the automatic restart of Cluster Synchronization Services when a specific problem occurs.

Syntax

crsctl set css noautorestart {all | interconnect | vf | none}

Usage Notes

Specify one of the following values:
  • all: Disables automatic restart when any problem occurs.
  • interconnect: Disables automatic restart when an interconnect problem occurs.
  • vf: Disables automatic restart when a voting files problem occurs.
  • none: Enables Cluster Synchronization Services automatic restart.

crsctl add css votedisk

Use the crsctl add css votedisk command to add one or more voting files to the cluster on storage devices other than an Oracle ASM disk group.

Syntax

crsctl add css votedisk vdisk [...] [-purge]

Parameters

Table E-51 crsctl add css votedisk Command Parameters

Parameter Description
vdisk [...]

Specify a fully qualified path of the voting file you want to add. Specify multiple voting file paths in a space-delimited list.
-purge

Specify the -purge option to remove all existing voting files at once. You can replace the existing set of voting files in one operation.

Usage Notes

  • You should have at least three voting files, unless you have a storage device, such as a disk array, that provides external redundancy. Oracle recommends that you do not use more than 5 voting files. The maximum number of voting files that is supported is 15.

Example

To add a voting file to the cluster:

$ crsctl add css votedisk /stor/grid/ -purge

crsctl delete css votedisk

Removes a voting file from the Oracle Clusterware configuration.

Syntax

crsctl delete css votedisk {voting_disk_GUID [...] | vdisk [...] | +diskgroup}

Parameters

Table E-52 crsctl delete css votedisk Command Parameters

Parameter Description
voting_disk_GUID [...]

Specify the file universal identifier (GUID) of the voting file you want to remove. Specify multiple GUIDs in a space-delimited list.
vdisk [...]

Alternatively, specify the path of the voting file you want to remove. Specify multiple voting file paths in a space-delimited list.
+diskgroup

Alternatively, specify the name of an Oracle ASM disk group that contains voting files you want to remove. You can only use parameter when Oracle Clusterware is in exclusive mode.

Usage Notes

  • You can specify one or more GUIDs of voting files you want to remove, one or more paths to voting files you want to remove, or the name of an Oracle ASM disk group that contains voting files you want to remove.

  • You can obtain the GUIDs of each current voting file by running the crsctl query css votedisk command

Example

To remove a voting file using a GUID:
$ crsctl delete css votedisk 26f7271ca8b34fd0bfcdc2031805581e

crsctl query css votedisk

Displays the voting files used by Cluster Synchronization Services, the status of the voting files, and the location of the disks, whether they are stored in Oracle ASM or elsewhere.

Syntax

crsctl query css votedisk

Example

This command returns output similar to the following:
##  STATE    File Universal Id                File Name Disk group
--  -----    -----------------                --------- ---------
1. ONLINE   296641fd201f4f3fbf3452156d3b5881 (/ocfs2/host09_vd3) []
2. ONLINE   8c4a552bdd9a4fd9bf93e444223146f2 (/netapp/ocrvf/newvd) []
3. ONLINE   8afeee6ae3ed4fe6bfbb556996ca4da5 (/ocfs2/host09_vd1) []
Located 3 voting file(s).

crsctl discover dhcp

Sends DHCP discover packets on the network at the specified port. If DHCP servers are present on the network, then they respond to the discovery message and the command succeeds.

Syntax

crsctl discover dhcp -clientid clientid [-port port] [-subnet subnet]

Parameters

Table E-53 crsctl discover dhcp Command Parameters

Parameter Description
-clientid clientid

Specify the client ID for which you want to attempt discovery. Obtain the client ID by running the crsctl get clientid dhcp command.

-port port

Specify the port to which CRSCTL sends the discovery packets.
-subnet subnet

Optionally, you can specify the subnet on which DHCP discover packets are sent.

Usage Notes

You must run this command as root.

Example

This command returns output similar to the following:

CRS-10009: DHCP server returned server: 192.168.53.232,
 loan address : 192.168.29.221/255.255.252.0, lease time: 43200

crsctl get clientid dhcp

Displays the client ID that the Oracle Clusterware agent uses to obtain the IP addresses from the DHCP server for configured cluster resources. The VIP type is required.

Syntax

crsctl get clientid dhcp -cluname cluster_name -viptype vip_type
[-vip vip_res_name] [-n node_name]

Parameters

Table E-54 crsctl get clientid dhcp Command Parameters

Parameter Description
-cluname cluster_name

Specify the name of the cluster where the cluster resources are configured.
-viptype vip_type

Specify the type of the VIP resource for which you want to display client IDs: HOSTVIP, SCANVIP, or APPVIP.

-vip vip_res_name

Specify the name of the VIP resource. This parameter is required if you specify the APPVIP VIP type.

-n node_name

Specify the name of the node for which you want to obtain the client ID. This parameter is required if you specify the HOSTVIP VIP type.

Example

This command returns output similar to the following:
CRS-10007: stmjk0462clr-stmjk01-vip

crsctl release dhcp

Sends a DHCP lease release request to a specific client ID, and sends release packets on the network to a specific port.

Syntax

crsctl release dhcp -clientid clientid [-port port]

Parameters

Table E-55 crsctl release dhcp Command Parameters

Parameter Description
-clientid clientid

Specify the client ID for which you want to attempt release. Obtain the client ID by running the crsctl get clientid command.

-port port

The port to which CRSCTL sends the release packets. If you do not specify a port, then CRSCTL uses the default value 67.

Example

This command returns output similar to the following:
CRS-10012: released DHCP server lease for client ID stmjk0462clr-stmjk01-vip
on port 67

crsctl request dhcp

Sends DHCP request packets on the network to the specified port.

If the DHCP server has an IP address it can provide, then it responds with the IP address for the client ID.

Syntax

crsctl request dhcp -clientid clientid [-port port]

Parameters

Table E-56 crsctl request dhcp Command Parameters

Parameter Description
-clientid clientid

Specify the client ID for which you want to attempt request. Obtain the client ID by running the crsctl get clientid command.

-port port

Optionally, you can specify the port to which CRSCTL sends the request packets. If you do not specify a port, then CRSCTL uses the default value 67.

Example

This command returns output similar to the following:
CRS-10009: DHCP server returned server: 192.168.53.232,
loan address : 192.168.29.228/255.255.252.0, lease time: 43200

crsctl replace discoverystring

Replaces the existing discovery string used to locate voting files.

Syntax

crsctl replace discoverystring "absolute_path[,...]"

Usage Notes

  • Specify one or more comma-delimited absolute paths that match one or more voting file locations. You can use wild cards and a list of paths must be enclosed in double quotation marks ("").

  • You must be root, the Oracle Grid Infrastructure installation owner, or a member of the Administrators group to run this command.

  • You can run this command on any node in the cluster.

  • If you store voting files in an Oracle ASM disk group, then you cannot change the discovery string.

Example

Assume the current discovery string is /oracle/css1/*. To also use voting files in the /oracle/css2/ directory, replace the current discovery string using the following command:
# crsctl replace discoverystring "/oracle/css1/*,/oracle/css2/*"

crsctl query dns

Obtains a list of addresses returned by DNS lookup of the name with the specified DNS server.

Syntax

crsctl query dns -name name [-dnsserver DNS_server_address] [-type query_type]
[-port port] [-attempts number_of_attempts] [-timeout timeout_in_seconds] [-v]

Parameters

Table E-57 crsctl query dns Command Parameters

Parameter Description
-name name

Specify the fully-qualified domain name that you want to query.
-dnsserver DNS_server_address

Optionally, you can specify the address of the DNS server on which you want the domain name to be queried.
-type query_type

Optionally, you can select either IPv4 or IPv6 by specifying either A or AAAA, respectively, as a query type.

-port port

Optionally, you can specify the port on which the DNS server listens. If you do not specify a port, then it defaults to port 53.
-attempts number_of_attempts

Optionally, you can specify the number of retry attempts.
-timeout timeout_in_seconds

Optionally, you can specify the timeout length in seconds.
–v

Verbose output.

Example

The crsctl query dns command returns output similar to the following for a DNS server named stmjk07-vip.stmjk0462.example.com: 

CRS-10024: DNS server returned 192.168.29.250 for name
stmjk07-vip.stmjk0462.example.com

crsctl start ip

Starts a given IP name or IP address on a specified interface with a specified subnet mask.

Run this command on the server on which you want to start the IP.

Syntax

crsctl start ip -A {IP_name | IP_address}/netmask/interface_name

Parameters

Table E-58 crsctl start ip Command Parameters

Parameter Description
IP_name | IP_address

Specify either a domain name or an IP address preceded by -A. If you do not specify a fully-qualified domain name, then CRSCTL uses a standard name search.

/netmask/interface_name

Specify a subnet mask and an interface name for the IP to start, separated by a forward slash (/). This pair must also be preceded by a forward slash.

Example

To start an IP on the local server, run the command similar to the following:
$ crsctl start ip -A 192.168.29.220/255.255.252.0/eth0

crsctl status ip

Checks if a given IP address is up on the network.

Syntax

crsctl status ip -A {IP_name | IP_address}

Usage Notes

Specify either a domain name or an IP address preceded by –A. If you do not specify a fully-qualified domain name, then CRSCTL uses a standard name search.

Example

This command returns output similar to the following:
CRS-10003: IP address 192.168.29.220 could be reached from current node

crsctl stop ip

Stops a given IP name or IP address on a specified interface with a specified subnet mask.

Run this command on the server on which you want to stop the IP.

Syntax

crsctl stop ip -A {IP_name | IP_address}/interface_name

Parameters

Table E-59 crsctl stop ip Command Parameters

Parameter Description
IP_name | IP_address

Specify either a domain name or an IP address preceded by -A. If you do not specify a fully-qualified domain name, then CRSCTL uses a standard name search.

interface_name

Specify an interface on which to stop the IP.

Example

To stop an IP on the local server, run the command similar to the following:
$ crsctl stop ip -A MyIP.example.com/eth0

crsctl lsmodules

Lists the components of the modules that you can debug.

Syntax

crsctl lsmodules {mdns | gpnp | css | crf | crs | evm | gipc}

Usage Notes

You can obtain a list of components for any of the following modules:

  • mdns: Multicast domain name server
  • gpnp: Grid Plug and Play service
  • css: Cluster Synchronization Services
  • crf: Cluster Health Monitor
  • crs: Cluster Ready Services
  • evm: Event Manager
  • gipc: Grid Interprocess Communication

Example

This command returns output similar to the following:

$ crsctl lsmodules evm
List EVMD Debug Module: CLSVER
List EVMD Debug Module: CLUCLS
List EVMD Debug Module: COMMCRS
List EVMD Debug Module: COMMNS
List EVMD Debug Module: CRSOCR
List EVMD Debug Module: CSSCLNT
List EVMD Debug Module: EVMAGENT
List EVMD Debug Module: EVMAPP
...

Related Topics

crsctl delete node

Removes a node from the cluster.

Syntax

crsctl delete node -n node_name [-purge]

Usage Notes

  • You must be root to run this command

  • The node_name parameter is required

  • Use the -purge option to delete the node permanently and to reuse its node number. However, if you want to add the deleted node back with the same node name and the same node number, then do not use the -purge option.

Example

To delete the node named node06 from the cluster, run the following command as root:
# crsctl delete node -n node06

crsctl check resource

Initiates the check action inside the application-specific agent of a particular resource.

Oracle Clusterware only provides output if something prevents the system from issuing the check request, such as a bad resource name.

Syntax

crsctl check resource {resource_name [...] | -w "filter"} [-n node_name]
   [-k cardinality_id] [-d degree_id]

Parameters

Table E-60 crsctl check resource Command Parameters

Parameter Description
resource_name [...]

Specify a particular resource. You can check multiple resources by entering a space-delimited list of resource names.
-w "filter"

Specify a resource filter that Oracle Clusterware uses to limit the number of resources checked. The filter must be enclosed in double quotation marks (""). Examples of resource filters include:

  • "TYPE == cluster_resource": This filter limits Oracle Clusterware to check only resources of cluster_resource type

  • "CHECK_INTERVAL > 10": This filter limits Oracle Clusterware to check resources that have a value greater than 10 for the CHECK_INTERVAL resource attribute

  • "(CHECK_INTERVAL > 10) AND (NAME co 2)": This filter limits Oracle Clusterware to check resources that have a value greater than 10 for the CHECK_INTERVAL resource attribute and the name of the resource contains the number 2

See Also: "Filters" for more information

-n node_name

Check the resource instance on a specific node. If you do not specify the -n parameter, then Oracle Clusterware checks the resource instances only on the local server.

-k cardinality_id

Specify the resource cardinality ID.
-d degree_id

Specify the resource degree ID.

Usage Notes

  • You must have read and execute permissions on the specified resources to check them.

  • Do not use this command for any resources with names that begin with ora because these resources are Oracle resources.

  • If this command is successful, it only means that a check was issued; it does not mean the CHECK action was completed.

Example

To initiate the check action inside the application-specific agent of a particular resource:
$ crsctl check resource appsvip

crsctl relocate resource

Relocates resources to another server in the cluster.

Syntax

crsctl relocate resource {resource_name [-k cid] | {resource_name | -all}
   -s source_server | -w "filter"} [-n destination_server] [-env "env1=val1,env2=val2,..."]
   [-i] [-f]

Parameters

Table E-61 crsctl relocate resource Command Parameters

Parameter Description
resource_name [-k cid]

Specify the name of a resource you want to relocate.

Optionally, you can also specify the resource cardinality ID. If you specify this parameter, then Oracle Clusterware relocates the resource instance that have the cardinality you specify.
resource_name | -all -s source_server

Alternatively, you can specify one particular resource or all resources located on a particular server that you specify from which you want to relocate those resources.

-w "filter"

Alternatively, you can specify a resource filter that Oracle Clusterware uses to limit the number of resources relocated. The filter must be enclosed in double quotation marks (""). Examples of resource filters include:

  • "TYPE == cluster_resource": This filter limits Oracle Clusterware to relocate only resources of cluster_resource type

  • "CHECK_INTERVAL > 10": This filter limits Oracle Clusterware to relocate resources that have a value greater than 10 for the CHECK_INTERVAL resource attribute

  • "(CHECK_INTERVAL > 10) AND (NAME co 2)": This filter limits Oracle Clusterware to relocate resources that have a value greater than 10 for the CHECK_INTERVAL resource attribute and the name of the resource contains the number 2

See Also: "Filters" for more information

-n destination_server

Specify the name of the server to which you want relocate resources. If you do not specify a destination server, then Oracle Clusterware relocates the resources to the best server according to the attribute profile of each resource.

-env "env1=val1,env2=val2,..."

You can optionally override one or more resource profile attribute values for this command. If you specify multiple environment name-value pairs, then you must separate each pair with a comma and enclose the entire list in double quotation marks ("").

–i

If you specify -i, then the command returns an error if processing this command requires waiting for Oracle Clusterware to unlock the resource or its dependents. Sometimes, Oracle Clusterware locks resources or other objects to prevent commands from interfering with each other.

–f

Specify the -f parameter to force the relocating of the resource when it has other resources running that depend on it. Dependent resources are relocated or stopped when you use this parameter.

Note: When you are relocating resources that have cardinality greater than 1, you must use either -k or -s to narrow down which resource instances are to be relocated.

Usage Notes

  • Any one of the three following options is required to specify which resources you want to relocate:

    • You can specify one particular resource to relocate.

    • Or you can specify one particular or all the resources to relocate from a particular source server.

    • Thirdly, you can specify a resource filter that Oracle Clusterware uses to match resources to relocate.

  • If a resource has a degree ID greater than 1, then Oracle Clusterware relocates all instances of the resource.

  • You must have read and execute permissions on the specified resources to relocate them.

  • Do not use this command for any resources with names that begin with ora because these resources are Oracle resources.

Example

To relocate one particular resource from one server to another:
# crsctl relocate resource myResource1 -s node1 -n node3

crsctl get resource use

Checks the current setting value of the RESOURCE_USE_ENABLED server configuration parameter.

Syntax

crsctl get resource use

Usage Notes

The possible values are 1 or 0. If the value for this attribute is 1, which is the default, then the server can be used for resource placement. If the value is 0, then Oracle Clusterware disallows starting resources on the server node.

Example

This command returns output similar to the following:
CRS-4966: Current resource use parameter value is 1

crsctl set resource use

Sets the value of the RESOURCE_USE_ENABLED server configuration parameter for the server on which you run this command.

Syntax

crsctl set resource use [1 | 0]

Usage Notes

  • The possible values are 1 or 0. If you set the value for this attribute to 1, which is the default, then the server can be used for resource placement. If you set the value to 0, then Oracle Clusterware disallows starting resources on the server node.

  • You must run this command as root or a cluster administrator, or an administrator on Windows systems.

Example

To set the value of the RESOURCE_USE_ENABLED server configuration parameter:
# crsctl set resource use 1

crsctl start rollingpatch

Transitions Oracle Clusterware and Oracle ASM into rolling patch mode.

Note:

crsctl start rollingpatch and crsctl stop rollingpatch should not be run directly except under the direction of Oracle Support. These commands are invoked as part of rootcrs.pl -prepatch/-postpatch which orchestrates patching on each node.

In this mode, the software tolerates nodes having different patch levels.

Syntax

crsctl start rollingpatch

Usage Notes

  • This command queries the Oracle Clusterware rolling patch state and Oracle ASM cluster state. If either one is not in rolling patch mode, then it will use the appropriate method to transition Oracle Clusterware or Oracle ASM to rolling patch mode.

  • If Oracle Clusterware and Oracle ASM are both in rolling patch mode when you run this command, then this command does nothing.

  • The rolling patch mode is not persistent. If all the nodes in a cluster are shut down and restarted, then the cluster transitions out of rolling patch mode when it is restarted. Similarly, if Oracle Clusterware is stopped and then restarted on all nodes in the cluster, then the rolling patch mode is lost.

  • This command does not transition Oracle ASM to rolling patch mode if issued within an Oracle ASM Client Cluster.

crsctl stop rollingpatch

Transitions Oracle Clusterware and Oracle ASM out of rolling patch mode.

Note:

crsctl start rollingpatch and crsctl stop rollingpatch should not be run directly except under the direction of Oracle Support. These commands are invoked as part of rootcrs.pl -prepatch/-postpatch which orchestrates patching on each node.

After the software transitions out of rolling patch mode, it does not tolerate nodes having different patch levels.

Syntax

crsctl stop rollingpatch

Usage Notes

  • This command queries the Oracle Clusterware rolling patch state and Oracle ASM cluster state. If either one is in rolling patch mode, then it will use the appropriate method to transition Oracle Clusterware or Oracle ASM out of rolling patch mode.

  • This command verifies that all the nodes in the cluster have a consistent patch level, and returns an error otherwise.

  • If neither Oracle Clusterware or Oracle ASM are in rolling patch mode when you issue this command, then this command does nothing.

  • This command does not transition Oracle ASM out of rolling patch mode if issued within an Oracle ASM Client Cluster.

crsctl start rollingupgrade

Transitions Oracle Clusterware and Oracle ASM into rolling upgrade mode.

Note:

This command should not be invoked directly except under the direction of Oracle Support. It is invoked by the rootupgrade scripts as part of the upgrade.

Syntax

crsctl start rollingupgrade version

Usage Notes

  • This command queries the Oracle Clusterware rolling upgrade state and Oracle ASM cluster state. If either one is not in rolling upgrade mode, then it will use the appropriate method to transition Oracle Clusterware or Oracle ASM to rolling upgrade mode.

  • If Oracle Clusterware and Oracle ASM are both in rolling upgrade mode when you run this command, then this command does nothing.

  • This command does not transition Oracle ASM to rolling upgrade mode if run within an Oracle ASM Client Cluster.

crsctl eval add server

Simulates the addition of a server without making changes to the system.

This command may be useful to cluster administrators.

Syntax

crsctl eval add server server_name [-file file_path] | [-attr "attr_name=attr_value[,...]"]
    [-admin [-l level [-x] [-a]] [-explain]

Parameters

Table E-62 crsctl eval add server Command Parameters

Parameter Description
server_name

The name of the server you want to add.
-file file_path

Fully-qualified path to a file containing server attributes.
-attr "attr_name=attr_value[,...]"

Alternatively, you can specify the name of a server attribute you want to modify preceded by the -attr flag, followed by a value for the server attribute.

Note: The attr_name=attr_value name-value pairs must be enclosed in double quotation marks (""). Multiple name-value pairs must be separated by commas. For example:
-attr "MAX_SIZE=30,IMPORTANCE=25"
-admin [-l level] [-x] [-a]

If you specify this parameter, then CRSCTL displays output for the cluster administrator.

If you specify the -l parameter, then you can choose one of the following output levels:

  • resources: Restricts the output to resources running on server nodes

  • all: Displays all available output

If you specify the -x parameter, then CRSCTL displays the differences.

If you specify the -a parameter, then CRSCTL displays all resources.

Note: To specify either the -l, -x, or -a parameters, or any combination of the three, you must specify the -admin parameter.

-explain Specify this parameter to display reasoned command evaluation information.

Example

This command returns output similar to the following:

$ crsctl eval add server scott_node5_0

Stage Group 1:
---------------------------------------------------------------------------
Stage   Required   Action
---------------------------------------------------------------------------
1       E  Looking for a suitable server pool for server 'scott_node5_0'.
        E  Scanning server pools with MIN_SIZE or more servers in
           descending order of IMPORTANCE.
        E  Considering server pools (IMPORTANCE): Free(0) for relocating
           servers.
        E  Relocating server 'scott_node5_0' to server pool 'Free'.
        Y  Server 'scott_node5_0' will be added to pools 'Free'.
---------------------------------------------------------------------------

crsctl eval delete server

Predicts the effects of deleting a server without making changes to the system.

This command may be useful to cluster administrators.

Syntax

crsctl eval delete server server_name [-admin [-l level] [-x] [-a]] [-f] [-explain]

Parameters

Table E-63 crsctl eval delete server Command Parameters

Parameter Description
server_name

Specify the name of the server you want to evaluate before deleting.
-admin [-l level] [-x] [-a]

If you specify this parameter, then CRSCTL displays output for the cluster administrator.

If you specify the -l parameter, then you can choose one of the following output levels:

  • resources: Restricts the output to resources running on server nodes

  • all: Displays all available output

If you specify the -x parameter, then CRSCTL displays the differences.

If you specify the -a parameter, then CRSCTL displays all resources.

Note:To specify either the -l, -x, or -a parameters, or any combination of the three, you must specify the -admin parameter.

-explain

Specify this parameter to display reasoned command evaluation information.

Examples

This command returns output similar to the following:

$ crsctl eval delete server scott_node1_0 -explain

Stage Group 1:
---------------------------------------------------------------------------
Stage Number    Required              Action
---------------------------------------------------------------------------
1      Y   Resource 'cs1' (1/1) will be in state 'OFFLINE'.
       E   Server 'scott_node1_0' is removed from server pool 'sp1'.
       E   Server pool 'sp1' is below the MIN_SIZE value of 2 with 1
           servers.
       E   Looking at other server pools to see whether MIN_SIZE value 2 of
           server pool 'sp1' can be met.
       E   Scanning server pools with more than MIN_SIZE servers in
           ascending order of IMPORTANCE.
       E   Considering server pools (IMPORTANCE): sp2(4) for suitable
           servers.
       E   Considering server pool 'sp2' because its MIN_SIZE is 1 and it
           has 1 servers above MIN_SIZE.
       E   Relocating server 'scott_node1_2' to server pool 'sp1'.
       Y   Server 'scott_node1_2' will be moved from pool 'sp2' to pool
           'sp1'.
       Y   Server 'scott_node1_0' will be removed from pools 'sp1'.
       Y   Resource 'cs2' (1/1) will be in state 'OFFLINE'.
2      Y   Resource 'cs1' (1/1) will be in state 'ONLINE|INTERMEDIATE' on
           server 'scott_node1_2'.
---------------------------------------------------------------------------

crsctl modify server

Modifies the configuration of a particular server.

Syntax

crsctl modify server server_name -attr "attr_name=attr_value[,...]"

Parameters

Table E-64 crsctl modify server Command Parameters

Parameter Description
server_name

Specify the name of the server you want to modify.
-attr "attr_name=attr_value

Specify the name of a server attribute you want to modify preceded by the -attr flag, followed by a value for the server attribute.

Note: The attr_name=attr_value name-value pairs must be enclosed in double quotation marks (""). Multiple name-value pairs must be separated by commas. For example: 

-attr "CHECK_INTERVAL=30,START_TIMEOUT=25"

Usage Notes

If an attribute value for an attribute name-value pair contains commas, then the value must be enclosed in single quotation marks (''). For example:
"START_DEPENDENCIES='hard(res1,res2,res3)'"

Example

To modify the configuration of a specific server, enter a command similar to the following:
$ crsctl modify server email_server_2 -attr  "WORKLOAD_VALUE=1"

crsctl status server

Obtains the status and configuration information of one or more particular servers.

Syntax

crsctl status server {server_name [...] | -w "filter"} [-g | -p | -v | -f] |
    [-category category_name | -w "filter"]

Parameters

Table E-65 crsctl status server Command Parameters

Parameter Description
server_name [...]

Specify one or more space-delimited server names.
-w "filter"

Alternatively, specify a filter to determine which servers are displayed. The filter must be enclosed in double quotation marks (""). Values that contain parentheses or spaces must be enclosed in single quotation marks (''). For example, "STATE = ONLINE" limits the display to servers that are online.

See Also: "Filters" for more information

-g | -p | -v | -f

You can specify one of the following parameters when Oracle Clusterware checks the status of specific servers:

  • -g: Use this parameter to check if the specified servers are registered

  • -p: Use this parameter to display static configuration of the specified servers

  • -v: Use this parameter to display the run-time configuration of the specified servers

  • -f: Use this parameter to display the full configuration of the specified servers

-category category_name

Optionally, you can specify a particular category of servers for which to obtain status.
-w "filter"

Alternatively, specify a filter to determine which categories are displayed. The filter must be enclosed in double quotation marks (""). Values that contain parentheses or spaces must be enclosed in single quotation marks (''). For example, "STATE = ONLINE" limits the display to servers that are online.

See Also: "Filters" for more information

Examples

Example E-7 Example 1

This command returns output similar to the following:

NAME=node1
STATE=ONLINE

NAME=node2
STATE=ONLINE

Example E-8 Example 2

The full configuration of a specific server is similar to the following:

NAME=node2
MEMORY_SIZE=72626
CPU_COUNT=12
CPU_CLOCK_RATE=1711
CPU_HYPERTHREADING=0 
CPU_EQUIVALENCY=1000
DEPLOYMENT=other
RESOURCE_USE_ENABLED=1
SERVER_LABEL=
PHYSICAL_HOSTNAME=
STATE=ONLINE
ACTIVE_POOLS=ora.pool1
STATE_DETAILS=

crsctl get server css_critical

Obtains the current configured value for the CSS_CRITICAL server attribute

Syntax

crsctl get server css_critical

Usage Notes

This command has no parameters.

crsctl set server css_critical

Sets the configuration value for the CSS_CRITICAL server attribute.

Syntax

crsctl set server css_critical {yes | no}

Usage Notes

Choose yes to set the server as CSS_CRITICAL.

crsctl get server label

Checks the current setting value of the SERVER_LABEL server attribute.

Syntax

crsctl get server label

Example

This command returns output similar to the following:
CRS-4972: Current SERVER_LABEL parameter value is HRserver

crsctl set server label

Sets the configuration value of the SERVER_LABEL server configuration attribute for the server on which you run this command.

Syntax

crsctl set server label value

Usage Notes

  • Specify a value for the server. This value can reflect a physical location, such as building_A, or some other identifying characteristic of the server, such as HRserver.

  • You must restart the Oracle Clusterware technology stack on the node before any changes you make take effect.

crsctl query socket udp

Verifies that a daemon can listen on a specified address and port.

Syntax

crsctl query socket udp [-address address] [-port port]

Parameters

Table E-66 crsctl query socket udp Command Parameters

Parameter Description
-address address

Specify the IP address on which the socket is to be created. If you do not specify an address, then CRSCTL assumes the local host as the default.
-port port

Specify the port on which the socket is to be created. If you do not specify a port, then CRSCTL assumes 53 as the default.

Usage Notes

You must run this command as root to verify port numbers less than 1024.

Examples

The command returns output similar to the following:
$ crsctl query socket udp

CRS-10030: could not verify if port 53 on local node is in use

# crsctl query socket udp

CRS-10026: successfully created socket on port 53 on local node
The first of the preceding two commands was not run as root, and in both commands no port was specified, so CRSCTL assumed the default, 53, which is less than 1024. This condition necessitates running the command as root.
$ crsctl query socket udp -port 1023

CRS-10030: could not verify if port 1023 on local node is in use

# crsctl query socket udp -port 1023

CRS-10026: successfully created socket on port 1023 on local node

Similar to the first two examples, the first of the preceding two commands was not run as root, and, although a port number was specified, it is still less than 1024, which requires root privileges to run the command.

In this last example, a port number greater than 1024 is specified, so there is no need to run the command as root:
$ crsctl query socket udp -port 1028

CRS-10026: successfully created socket on port 1028 on local node

crsctl start testdns

Starts a test DNS server that will listen on a specified IP address and port.

The test DNS server does not respond to incoming packets but does display the packets it receives. Typically, use this command to check if domain forwarding is set up correctly for the GNS domain.

Syntax

crsctl start testdns [-address address [-port port]] [-once] [-v]

Parameters

Table E-67 crsctl start testdns Command Parameters

Parameter Description
-address address

Specify a server address in the form IP_address/netmask[/interface_name].

-port port

The port on which the server listens. If you do not specify a port, then it defaults to port 53.
–once

Specify this parameter to indicate that the DNS server should exit after it receives one DNS query packet.
–v

Verbose output.

Example

To start a test DNS server on the local server, run the command similar to the following:
$ crsctl start testdns -address 192.168.29.218 -port 63 -v

crsctl status testdns

Queries the test DNS server running on a specified address and local host name.

Syntax

crsctl status testdns [-server DNS_server_address] [-port port] [-v]

Parameters

Table E-68 crsctl status testdns Command Parameters

Parameter Description
-server DNS_server_address

Optionally, you can specify the DNS server address for which you want to check the status.
-port port

Optionally, you can specify the port on which the DNS server listens. If you do not specify a port, then it defaults to port 53.
–v

Verbose output.

Example

This command returns output similar to the following:
CRS-10024: DNS server returned 192.168.28.74 for name
stmjk07-vip.stmjk0462.example.com

crsctl stop testdns

Stops a test DNS server.

Syntax

crsctl stop testdns [-address address] [-port port] [-v]

Parameters

Table E-69 crsctl stop testdns Command Parameters

Parameter Description
-address address

Optionally, you can specify the server address for which you started the test DNS server in the form IP_address/netmask[/interface_name].

-port port

Optionally, you can specify the port on which the DNS server listens. If you do not specify a port, then it defaults to port 53.
–v

Verbose output.

Example

This command returns output similar to the following:

CRS-10032: successfully stopped the DNS listening daemon running on port 53 on
local node

crsctl replace votedisk

Moves or replaces the existing voting files.

This command creates voting files in the specified locations, either in Oracle ASM or some other storage option. Oracle Clusterware copies existing voting file information into the new locations and removes the voting files from the former locations.

Syntax

crsctl replace votedisk [+asm_disk_group | path_to_voting_disk [...]]

Parameters

Table E-70 crsctl replace votedisk Command Parameters

Parameter Description
+asm_disk_group

Specify the Oracle ASM disk group (preceded by a plus sign (+))where you want to locate the voting file.

path_to_voting_disk [...]

Alternatively, you can specify a space-delimited list of voting file paths for voting files that reside outside of Oracle ASM.

Usage Notes

  • You must be root, the Oracle Grid Infrastructure installation owner, or a member of the Administrators group to run this command.

  • Specify to replace a voting file in either an Oracle ASM disk group or in some other storage device.

  • You can run this command on any node in the cluster.

Examples

Example E-9 Example 1

To replace a voting file that is located within Oracle ASM:

# crsctl replace votedisk +diskgroup1

Example E-10 Example 2

To replace a voting file that is located on a shared file system:

# crsctl replace votedisk /mnt/nfs/disk1 /mnt/nfs/disk2

crsctl add wallet

Creates and adds users to a wallet.

Syntax

crsctl add wallet -type wallet_type [-name name] [-user user_name -passwd]

Parameters

Table E-71 crsctl add wallet Command Parameters

Parameter Description
-type wallet_type

Specify the type of wallet you want to create, such as OSUSER or CVUDB.

  • OSUSER: This wallet type stores a low-privileged Windows user's user name and password that the agent uses when you create a Windows service on a database or in general to update the Windows service's password.

  • CVUDB: This wallet type stores a database user name and password that the health check component of CVU uses to connect to the database and perform database checks.

-name name

You must specify a name for the wallet to create APPQOSDB and CVUDB wallets.
-user user_name -passwd

Specify the user name you want to add to the wallet and provide the password through standard input. The user name is required to create an OSUSER wallet.

Usage Notes

The wallets are optional.

Example

To add a wallet:
$ crsctl add wallet -type OSUSER -user lp_oracle_home_user -passwd
In the preceding example, lp_oracle_home_user is a low-privileged Oracle home user who owns the home.

crsctl delete wallet

Removes wallets or users from a wallet.

Syntax

crsctl delete wallet -type wallet_type [-name name] [-user user_name]

Parameters

Table E-72 crsctl delete wallet Command Parameters

Parameter Description
-type wallet_type
Type of wallet you want to remove, such as OSUSER or CVUDB.

  • OSUSER: This wallet type stores a low-privileged Windows user's user name and password that the agent uses when you create a Windows service on a database or in general to update the Windows service's password.

  • CVUDB: This wallet type stores a database user name and password that the health check component of CVU uses to connect to the database and perform database checks.

-name name

You must specify the name of the wallet to remove an APPQOSDB wallet.
-user user_name

You must specify a user name to remove a user from an OSUSER wallet.

Example

To delete a user from the OSUSER wallet:
$ crsctl delete wallet -type OSUSER -user lp_oracle_home_user
In the preceding example, lp_oracle_home_user is a low-privileged Oracle home user who owns the home where the database was created. Additionally, the command does not delete the wallet if it contains other users.

crsctl modify wallet

Modifies the password for a specific user in a specific wallet.

Syntax

crsctl modify wallet -type wallet_type [-name name] [-user user_name -passwd]

Parameters

Table E-73 crsctl modify wallet Command Parameters

Parameter Description
-type wallet_type

Specify the type of wallet you want to create, such as OSUSER or CVUDB.

  • OSUSER: This wallet type stores a low-privileged Windows user's user name and password that the agent uses when you create a Windows service on a database or in general to update the Windows service's password.

  • CVUDB: This wallet type stores a database user name and password that the health check component of CVU uses to connect to the database and perform database checks.

-name name

You must specify the wallet name to modify an APPQOSDB wallet.
-user user_name -passwd

You must specify the user name for whom you want to modify the password. Modify the password through standard input.

Usage Notes

You cannot use this command to change a user name.

Example

To modify the password of a low-privileged Oracle home user:
$ crsctl modify wallet -type OSUSER -user lp_oracle_home_user -passwd

crsctl query wallet

Queries low-privileged users from a wallet.

Syntax

crsctl query wallet -type wallet_type [-name name] [-user user_name] [-all]

Parameters

Table E-74 crsctl query wallet Command Parameters

Parameter Description
-type wallet_type

Type of wallet you want to query, such as OSUSER or CVUDB.

  • OSUSER: This wallet type stores a low-privileged Windows user's user name and password that the agent uses when you create a Windows service on a database or in general to update the Windows service's password.

  • CVUDB: This wallet type stores a database user name and password that the health check component of CVU uses to connect to the database and perform database checks.

-name name

You must specify the name of the wallet to query an APPQOSDB wallet.
-user user_name

You must specify a user name to query a user from an OSUSER wallet.
–all

Specify -all to list all of the users in a specific wallet.

Example

To list all of the users in the OSUSER wallet:
$ crsctl query wallet -type OSUSER -all

Oracle Restart Environment CRSCTL Commands

You can only use these commands in the Oracle Restart environment.

The commands listed in this section control Oracle High Availability Services. These commands manage the Oracle High Availability Services stack in the Oracle Restart environment, which consists of the Oracle High Availability Services daemon (ohasd), Oracle ASM (if installed), and Cluster Synchronization Services (if Oracle ASM is installed). These commands only affect the local server on which you run them.

Note:

Oracle does not support using crs_* commands in an Oracle Restart environment.

Each server in the cluster is in one of two possible states:

  • The whole stack is up, which means that Oracle High Availability Services is active

  • The whole stack is down, which means that Oracle High Availability Services is inactive

crsctl check has

Checks the status of ohasd.

Syntax

crsctl check has

Example

This command returns output similar to the following:
CRS-4638: Oracle High Availability Services is online

crsctl config has

Displays the automatic startup configuration of the Oracle High Availability Services stack on the server.

Syntax

crsctl config has

Usage Notes

This command has no parameters.

Example

This command returns output similar to the following:

CRS-4622 Oracle High Availability Services autostart is enabled.

crsctl disable has

Disables automatic startup of the Oracle High Availability Services stack when the server boots up.

Syntax

crsctl disable has

Example

This command returns output similar to the following:
CRS-4621 Oracle High Availability Services autostart is disabled.

crsctl enable has

Enables automatic startup of the Oracle High Availability Services stack when the server boots up.

Syntax

crsctl enable has

Example

This command returns output similar to the following:
CRS-4622 Oracle High Availability Services autostart is enabled.

crsctl query has releaseversion

Displays the release version of the Oracle Clusterware software that is stored in the binaries on the local node.

Syntax

crsctl query has releaseversion

Example

This command returns output similar to the following:
Oracle High Availability Services release version on the local node is [23.0.0.0.0]

crsctl query has softwareversion

Displays the software version on the local node.

Syntax

crsctl query has softwareversion [server_name]

Usage Notes

If you do not provide a server name, then Oracle Clusterware displays the version of Oracle Clusterware running on the local server.

Example

This command returns output similar to the following:
Oracle High Availability Services version on the local node is [23.0.0.0.0]

crsctl start has

Starts Oracle High Availability Services on the local server.

Syntax

crsctl start has [-nowait] [-noautostart] [-wait]

Usage Notes

  • Use the -nowait parameter to skip waiting for Oracle High Availability Services to start.
  • Use the -noautorestart parameter to start only Oracle High Availability Services.
  • Use the -wait parameter to wait for Oracle High Availability Services to start.

Example

To start Oracle High Availability Services on the local server:
# crsctl start has

crsctl stop has

Stops Oracle High Availability Services on the local server.

This command attempts to gracefully stop resources managed by Oracle Clusterware while attempting to stop Oracle High Availability Services.

Syntax

crsctl stop has [-f]

Usage Notes

If any resources that Oracle Clusterware manages are still running after you run the crsctl stop has command, then the command fails. Use the -f parameter to unconditionally stop all resources and stop Oracle High Availability Services.

Example

To stop Oracle High Availability Services on the local server:
# crsctl stop has

Troubleshooting and Diagnostic Output

You can use crsctl set log commands as the root user to enable dynamic debugging for Cluster Ready Services (CRS), Cluster Synchronization Services (CSS), and the Event Manager (EVM), and the clusterware subcomponents.

You can dynamically change debugging levels using crsctl debug commands. Debugging information remains in the Oracle Cluster Registry (OCR) for use during the next startup. You can also enable debugging for resources.

Dynamic Debugging Using crsctl set log

Setting log levels for Oracle Clusterware.

Syntax

crsctl set log module_name "component1=level1,..."

Usage Notes

  • You can set log levels for various components of the following modules:

    • mdns: Multicast domain name server
    • gpnp: Grid Plug and Play service
    • css: Cluster Synchronization Services
    • crf: Cluster Health Monitor
    • crs: Cluster Ready Services
    • evm: Event Manager
    • gipc: Grid Interprocess Communication

    Use the crsctl lsmodules command to obtain a list of components for each module.

  • You can specify multiple component name/log level pairs in a comma-delimited list enclosed in double quotation marks ("").

  • Separate component name/log level pairs with an equals sign (=) in Oracle Clusterware 11g release 2 (11.2.0.3), and later. Previous Oracle Clusterware versions used a colon (:).

  • The log_level is a number from 1 to 5 that sets the log level for the component or resource, where 1 is the least amount of log output and 5 provides the most detailed log output. The default log level is 2.

Example

To set log levels for the CRSRTI and CRSCOMM components of the CRS module:

$ crsctl set log crs "CRSRTI=1,CRSCOMM=2"

Component Level Debugging

You can use crsctl set log and crsctl set trace commands as the root user to enable dynamic debugging for the various Oracle Clusterware modules.

Enabling Debugging for Oracle Clusterware Modules

You can enable debugging for Oracle Clusterware modules and their components, and for resources, by setting environment variables or by running the crsctl set log command.

Use the following syntax to enable debugging for various Oracle Clusterware modules:

crsctl set {log | trace} module_name "component:debugging_level[,...]"

Run the crsctl set command as the root user, and supply the following information:

  • module_name: Specify the name of one of the following modules:

    • mdns: Multicast domain name server
    • gpnp: Grid Plug and Play service
    • css: Cluster Synchronization Services
    • crf: Cluster Health Monitor
    • crs: Cluster Ready Services
    • evm: Event Manager
    • gipc: Grid Interprocess Communication

  • component: Specify the name of a component for one of the modules. See Table E-75 for a list of all of the components.

  • debugging_level: Specify a number from 1 to 5 to indicate the level of detail you want the debug command to return, where 1 is the least amount of debugging output and 5 provides the most detailed debugging output. The default debugging level is 2.

The following examples show how to enable debugging for the various modules:

  • To enable debugging for Oracle Clusterware:

    # crsctl set log crs "CRSRTI:1,CRSCOMM:2"

  • To enable debugging for OCR:

    # crsctl set log crs "CRSRTI:1,CRSCOMM:2,OCRSRV:4"

  • To enable debugging for EVM:

    # crsctl set log evm "EVMCOMM:1"

  • To enable debugging for resources

    # crsctl set log res "resname:1"

To obtain a list of components that can be used for debugging, run the crsctl lsmodules command, with the following syntax: 

$ crsctl lsmodules {mdns | gpnp | css | crf | crs | evm | gipc}

Note:

You do not have to be the root user to run the crsctl lsmodulues command.

Table E-75 shows the components for the CRS, CSS, and EVM modules, respectively. Note that some component names are common between the CRS, EVM, and CSS daemons and may be enabled on that specific daemon. For example, COMMNS is the NS layer and because each daemon uses the NS layer, you can enable this specific module component on any of the daemons to get specific debugging information.

Table E-75 Components for the CRS, CSS, and EVM Modules

CRS Components(1) CSS Components(2) EVM Components(3) 
CRSUI
CRSCOMM
CRSRTI
CRSMAIN
CRSPLACE
CRSAPP
CRSRES
CRSCOMM
CRSOCR
CRSTIMER
CRSEVT
CRSD
CLUCLS
CSSCLNT
COMMCRS
COMMNS
 
CSSD
COMMCRS
COMMNS
 
EVMD
EVMDMAIN
EVMCOMM
EVMEVT
EVMAPP
EVMAGENT
CRSOCR
CLUCLS
CSSCLNT
COMMCRS
COMMNS

Footnote 1 Obtain the list of CRS components using the crsctl lsmodules crs command.

Footnote 2 Obtain the list of CSS components using the crsctl lsmodules css command.

Footnote 3 Obtain the list of EVM components using the crsctl lsmodules evm command.

For example, use the following command to set debugging levels on specific cluster nodes, include the -nodelist keyword and the names of the nodes, as follows: 

crsctl set log crs "CRSRTI:1,CRSCOMM:2" -nodelist node1,node2

Table E-76 describes the Cluster Synchronization Services modules.

Table E-76 Cluster Synchronization Services (CSS) Modules and Functions

Module Description

CSS

CSS client component

CSSD

CSS daemon component

Table E-77 describes the function of each communication (COMM) module.

Table E-77 Communication (COMM) Modules and Functions

Module Description

COMMCRS

Clusterware communication layer

COMMNS

NS communication layer

Table E-78 describes the functions performed by each CRS module.

Table E-78 Oracle Clusterware (CRS) Modules and Functions

Module Descriptions

CRSUI

User interface module

CRSCOMM

Communication module

CRSRTI

Resource management module

CRSMAIN

Main module/driver

CRSPLACE

CRS placement module

CRSAPP

CRS application

CRSRES

CRS resources

CRSOCR

Oracle Cluster Registry interface

CRSTIMER

Various timers related to CRS

CRSEVT

CRS EVM/event interface module

CRSD

CRS daemon

Using the crsctl set log crs command, you can debug the OCR components listed in Table E-79. The components listed in Table E-79 can also be used for the Oracle Local Registry (OLR) except for OCRMAS and OCRASM. You can also use them for OCR and OLR clients, except for OCRMAS and OCRSRV. Some OCR and OLR clients are OCRCONFIG, OCRDUMP, and so on.

Table E-79 Oracle Cluster Registry (OCR) Component Names

Module Description

OCRAPI

OCR abstraction component

OCRCLI

OCR client component

OCRSRV

OCR server component

OCRMAS

OCR master thread component

OCRMSG

OCR message component

OCRCAC

OCR cache component

OCRRAW

OCR raw device component

OCRUTL

OCR util component

OCROSD

OCR operating system dependent (OSD) layer

OCRASM

OCR ASM component

Table E-80 describes the OCR tool modules.

Table E-80 OCRCONFIG Modules and Functions

Module Description

OCRCONFIG

OCRCONFIG component for configuring OCR

OCRDUMP

OCRDUMP component that lists the Oracle Cluster Registry contents

OCRCHECK

OCRCHECK component that verifies all of the configured OCRs

Enabling Debugging for Oracle Clusterware Resources

You can enable debugging for Oracle Clusterware resources by running the crsctl set log command, using the following syntax: 

crsctl set log res "resource_name=debugging_level"

Run the crsctl set log command as the root user, and supply the following information:

  • resource_name: The name of the resource to debug.

  • debugging_level: A number from 1 to 5 to indicate the level of detail you want the debug command to return, where 1 is the least amount of debugging output and 5 provides the most detailed debugging output.

    Note:

    After you resolve an issue that required additional debugging, you can reset the debug level to default, as follows:
    # crsctl set log crs resource_name=default

To obtain a list of resources that can be used for debugging, run the crsctl status resource command.

Example

To generate a debugging log for the VIP resource on node1, issue the following command: 

# crsctl set log res "ora.node1.vip:1"