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

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

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.

Use this parameter to delete a resource that is online.

Specify a short, descriptive name for the resource.

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

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

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 "SERVER_POOL_NAMES=
  'ora.pool1 ora.pool2',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

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

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.

• To add resources of application type because you may need to move servers into the Generic server pool. If the servers currently host resources that must be stopped, then the force parameter is required.

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.

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

Specify the name of the server on which the resource that you want to simulate a failure resides.

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.

Specify the name of a resource you want to relocate.

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

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

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

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.

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.

Specify the name of the resource you want to evaluate.

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 "SERVER_POOL_NAMES=
  'ora.pool1 ora.pool2',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

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

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

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

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

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.

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.

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

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

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.

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

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

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

The name of the resource you want to modify.

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 "SERVER_POOL_NAMES=
  'ora.pool1 ora.pool2',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

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.

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

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

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.

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 ("").

Specify the name of a resource you want to relocate.

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.

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

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

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

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.

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 ("").

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.

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.

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

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

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

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.

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 ("").

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.

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.

Specify the name of the resource for which you want to set permissions.

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

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

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

Use this parameter to start all resources in the cluster.

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.

Specify a single server pool name or a space-delimited list of server pools in which a resource resides that you want to start.

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

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.

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 ("").

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

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

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.

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.

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

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

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

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.

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.

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

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

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

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

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.

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.

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 ("").

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

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.

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.

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

Specify the name of the resource group.

Specify a group type for the resource group.

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 ("").

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

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.

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

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.

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

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.

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

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

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

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.

Specify the name of the resource group.

Specify a group type for the resource group.

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 ("").

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

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

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

Optionally, you can specify the name of the server to which resource groups reside that you want to evaluate.

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 ("").

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

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

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

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

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

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

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

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

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

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.

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

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.

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.

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

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

Specify the name of the resource group you want to modify.

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 "SERVER_POOL_NAMES=
  'ora.pool1 ora.pool2',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

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.

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.

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

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

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.

Specify this parameter to relocate all resource groups on the source server.

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

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

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.

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 ("").

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

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.

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

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

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

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 ("").

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.

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.

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

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

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

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.

Specify a single server pool name or a space-delimited list of server pools in which a resource group resides that you want to start.

Specify the resource group cardinality ID. If you specify this parameter, then CRSCTL starts the resource instances that have the cardinality you specify.

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 ("").

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.

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.

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

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.

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

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

Optionally, you can specify this parameter to display the full configuration of the resource group.

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.

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

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.

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.

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

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.

Specify a single server pool name or a space-delimited list of server pools in which a resource group resides that you want to stop.

Specify the resource group cardinality ID. If you specify this parameter, then Oracle Clusterware stops the resource instances that have the cardinality you specify.

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 ("").

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.

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.

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

Specify the name of the resource group type.

Specify the base group type of the resource group type.

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 ("").

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.

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 ("").

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

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.

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
• ctss: Cluster Time Synchronization Service
• evm: Event Manager
• gipc: Grid Interprocess Communication

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

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

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.

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.

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.

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

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

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

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

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

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

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

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

Specify the name of the resource type for which you want to set permissions.

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

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

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

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.

Specify a particular resource. Multiple resource names must be separated by a space.

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

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 ("").

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

Specify a name for the server category you want to add.

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:

• Table 3-4 for a list of attributes you can use with this command

• "Filters" for information about operators

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

Specify the name of the server category you want to modify.

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::---',
ACTIVE_CSS_ROLE=hub"

See Also:

• Table 3-4 for a list of attributes you can use with this command

• "Filters" for information about operators

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

Use this parameter to force the operation.

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

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

See Also: "Filters" for more information

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

Use this parameter to start the Oracle Clusterware stack on all servers in the cluster.

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.

Optionally, you can specify -hub to start the Oracle Clusterware stack on Hub Nodes in the cluster.

Optionally, you can use this parameter to start only servers that match a filter, such as "ACTIVE_CSS_ROLE = hub".

See Also: Filters for more information about filters.

Use this parameter to start the Oracle Clusterware stack on all servers in the cluster.

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.

Optionally, you can specify -hub to stop the Oracle Clusterware stack on a specific Hub Node in the cluster.

Optionally, you can use this parameter to stop only servers that match a filter, such as "ACTIVE_CSS_ROLE = hub".

See Also: Filters for more information about filters.

Specify the name of the site you want to modify.

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.

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.

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.

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.

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

Start only OHASD.

The name of the user to whom you want to give Oracle Clusterware administrative privileges.

Use this parameter to override the user name validity check.

The name of the user whose Oracle Clusterware administrative privileges you want to remove.

By default, the list of users with Oracle Clusterware administrative privileges consists of the user who installed Oracle Clusterware, root, and *. The user who installed Oracle Clusterware and root are permanent members this list. The * value gives Oracle Clusterware administrative privileges to all users and must be removed to enable role-separated management.

Use this parameter to override the user name validity check.

Specify the number of seconds to delay Oracle Clusterware autostart.

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

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

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

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.

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

Specify the port to which CRSCTL sends the discovery packets.

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

Specify the name of the cluster where the cluster resources are configured.

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

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

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.

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

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

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

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.

Specify the fully-qualified domain name that you want to query.

Optionally, you can specify the address of the DNS server on which you want the domain name to be queried.

Optionally, you can select either IPv4 or IPv6 by specifying either A or AAAA, respectively, as a query type.

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.

Optionally, you can specify the number of retry attempts.

Optionally, you can specify the timeout length in seconds.

Verbose output.

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.

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.

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.

Specify an interface on which to stop the IP.

Specify the name of the new member cluster.

Specify the path of the cluster manifest file (including the .xml extension) you want to create.

Specify the type of member cluster you want to create. If you choose database, then you can use the cluster to deploy Oracle databases. If you choose application, then you can use the cluster to only deploy applications.

Optionally, you can specify the five-digit version of Oracle Grid Infrastructure (such as 12.2.0.1.0) on the new member cluster, if is different from that of the domain services cluster.

Optionally, you can specify services to be initially configured for this member cluster. If you do not use the -domain_services parameter, then CRSCTL only configures the Grid Infrastructure Management Repository and TFA services.

Additionally, you can optionally specify the Oracle ASM storage access path for the database member clusters.

• local: Storage is local to the cluster
• direct or indirect: Choose direct or indirect access to storage provided on the domain services cluster

Optionally, you can choose rhp to generate credentials and configuration for a Fleet Patching and Provisioning Client cluster.

Optionally, you can choose acfs for an indirect-access Member Cluster to utilize Oracle ACFS Remote to provide storage to the Member Cluster.

Specify a name for the policy you want to add.

Specify a description for the policy using the DESCRIPTION policy attribute preceded by the -attr flag.

A value for the DESCRIPTION policy attribute that describes the policy.

Note: The attr_name and attr_value parameters must be enclosed in double quotation marks ("") and separated by commas. For example:

-attr "DESCRIPTION=daytime"

Specify this parameter to evaluate what happens if you try to forcibly activate a policy.

You must specify -admin if you specify any combination of -l, -x, and -a.

If you specify the -l parameter, then you can choose one of the following three output levels:

• serverpools: Restricts the output to servers running in a server pool

• resources: Restricts the output to resources running on servers in a server pool

• 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.

Specify the name of the policy you want to modify.

Specify a description for the policy using the DESCRIPTION policy attribute following the -attr flag.

A value for the DESCRIPTION policy attribute that describes the policy.

Note: The attr_name and attr_value parameters must be enclosed in double quotation marks ("") and separated by commas. For example:

-attr "DESCRIPTION=daytime"

Specify the name of the policy or a space-delimited list of policy names for which you want to view the status.

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

See Also: "Filters" for more information

Alternatively, you can specify this parameter to display the status of the active policy.

The name of a policy attribute you want to modify following the -attr flag. With this command, you can specify any of the following attributes:

• ACL
• LAST_ACTIVATED_POLICY
• SERVER_POOL_NAMES

A value for the policy attribute.

Note: The attr_name and attr_value parameters must be enclosed in double quotation marks ("") and separated by commas. For example:

-attr "ACL='owner:mjkeenan:rwx,pgrp:svrtech:rwx,other::r--',
SERVER_POOL_NAMES=sp1 sp2 Free"

If you specify this parameter instead of -attr, then enter a name of a file that contains policy set definitions.

If you specify this parameter, then CRSCTL keeps the server pools in the system, which means that they are independent and not managed by the policy set.

Specify this parameter to force enable policy set modifications.

Specify a particular resource. You can check multiple resources by entering a space-delimited list of resource names.

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

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.

Specify the resource cardinality ID.

Specify the resource degree ID.

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.

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.

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

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.

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 ("").

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.

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.

The name of the server you want to add.

Fully-qualified path to a file containing server attributes.

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.

-attr "MAX_SIZE=30,IMPORTANCE=25"

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 three output levels:

• serverpools: Restricts the output to servers running in a server pool

• resources: Restricts the output to resources running on servers in a server pool

• 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.

Specify the name of the server you want to evaluate before deleting.

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 three output levels:

• serverpools: Restricts the output to servers running in a server pool

• resources: Restricts the output to resources running on servers in a server pool

• 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.

Specify this parameter to display reasoned command evaluation information.

The name of the server you want to relocate. You can provide a space-delimited list of servers to evaluate relocating multiple servers.

Specify the name of the server pool to which you want relocate the server.

If you specify this parameter, then CRSCTL predicts the effects of forcibly relocating a server.

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 three output levels:

• serverpools: Restricts the output to servers running in a server pool

• resources: Restricts the output to resources running on servers in a server pool

• 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.

Specify the name of the server you want to modify.

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"

Specify the name of the server you want to relocate. You can provide a space-delimited list of servers to relocate multiple servers.

Specify the name of the server pool to which you want relocate the servers.

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

If you specify the -f parameter, then Oracle Clusterware stops resources running on the servers in another server pool and relocates that server into the server pool you specified.

If you do not specify the -f parameter, then Oracle Clusterware checks for resources that must be stopped on the servers that are being relocated. If it finds any, then Oracle Clusterware rejects the crsctl relocate server command.

Note: If the number of servers in the server pool is not above the value of the MIN_SIZE server pool attribute, then the force parameter will have no affect because CRSCTL will not violate the configuration.

Specify one or more space-delimited server names.

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

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

Optionally, you can specify a particular category of servers for which to obtain status.

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

A short, descriptive name for the server pool. A server pool name has a 254 character limit and can contain any platform-supported characters except the exclamation point (!), the tilde (~), and spaces. A server pool name cannot begin with a period nor with ora.

Fully-qualified path to an attribute file to define the server pool.

Alternatively, specify the name of a server pool attribute for the server pool you are adding preceded by the -attr flag, followed by a value for the server pool 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=3"

The available attribute names include:

• IMPORTANCE

• MIN_SIZE

• MAX_SIZE

• SERVER_NAMES

• PARENT_POOLS

• EXCLUSIVE_POOLS

• ACL

• SERVER_CATEGORY

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

If you specify the -f parameter, then Oracle Clusterware stops resources running on a server in another server pool and relocates that server into the server pool you are adding. If you do not specify the -f parameter, then Oracle Clusterware checks whether the creation of the server pool results in stopping any resources on a server in another server pool that is going to give up a server to the server pool you are adding. If so, then Oracle Clusterware rejects the crsctl add serverpool command.