E CRSCTL Utility Reference

Syntax

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

Parameters

resource_name

-type resource_type

-file file_path

-attr "attribute_name=
attribute_value

-i

-f

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.

Example

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 2

To register a resources 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"

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=[READONLY][|REQUIRED]]"}

Parameters

type_name

-basetype base_type_name

-attr

"ATTRIBUTE=FOO,TYPE=integer,DEFAULT_
VALUE=0,FLAGS=REQUIRED,ATTRIBUTE=BAR,TYPE=string"

-file file_path

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

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"

Syntax

crsctl check css

Usage Notes

Example

The crsctl check css command returns output similar to the following:

CRS-4529: Cluster Synchronization Services is online

Syntax

crsctl check evm

Usage Notes

Example

The crsctl check evm command returns output similar to the following:

CRS-4533: Event Manager is online

Syntax

crsctl delete resource resource_name [-i] [-f]

Parameters

resource_name

-i

-f

Usage Notes

• The resource_name 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

Syntax

crsctl delete type type_name [-i]

Usage Notes

• The type_name parameter is required

• 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 a resource type, run the following command as who has write permissions on the resource type:

$ crsctl delete type app.appvip.type

Syntax

crsctl get hostname

Example

Oracle Clusterware returns the host name of the local server:

$ crsctl get hostname
node2

Syntax

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

Parameters

resource_name

-u user_name

-g group_name

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

Example

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

Syntax

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

Parameters

resource_type

-u user_name

-g group_name

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

Example

The crsctl getperm type 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--

Syntax

crsctl modify resource resource_name -attr "attribute_name=attribute_value"
[-i] [-f] [-delete]

Parameters

resource_name

-attr "attribute_name=
attribute_value"

-i

-f

-delete

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

Syntax

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

Parameters

type_name

-attr

-i

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

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"

Syntax

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

Parameters

resource_name

{-u | -x | -o | -g}

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

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

Example

To grant read, write, and execute permissions on a resource for user Scott:

$ crsctl setperm resource myResource -u user:scott:rwx

Syntax

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

Parameters

resource_type_name

{-u | -x | -o | -g}

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

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

Syntax

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

Parameters

resource_name [...]

-w filter

-all

-n server_name

-k cid

-d did

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

-i

-f

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 option 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 for any resources with names that begin with ora because these resources are Oracle resources.

Example

To start a resource:

# crsctl start resource myResource -n server1

Syntax

crsctl status resource {resource_name [...] | -w "filter"}  [-p | -v [-e]] |
[-f | -l | -g] [[-k cid | -n server_name] [-d did]] | [-s -k cid [-d did]] [-t]

Parameters

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

[-p | -v [-e]] | [-f | -l | -g]

[-k cid | 
-n server_name] [-d did |
[-s -k cid [-d did]]]

-t

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.

Example

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

Syntax

crsctl status type resource_type_name [...]] [-g] [-p] [-f]

Parameters

[resource_type_name [...]

-g] [-p] [-f

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

Syntax

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

Parameters

resource_name [...]

-w "filter"

-all

-n server_name

-k cid

-d did

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

-i

-f

Usage Notes

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

  • You can specify one or more resources to stop

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

  • You can specify the -all option with the -n server_name option 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.

Example

To stop a resource:

$ crsctl stop resource -n node1 -k 2

Syntax

crsctl add crs administrator -u user_name [-f]

Parameters

-u user_name

-f

Usage Notes

• You must run this command as root or a cluster administrator, or an administrator on Windows systems

• By default, root, the user that installed Oracle Clusterware, and the * wildcard are members of the list of users who have Oracle Clusterware administrative privileges. Run the crsctl delete crs administrator command to remove the wildcard and enable role-separated management of Oracle Clusterware.

  See Also:

  "Role-Separated Management" for more information

Example

To add a user to the list of Oracle Clusterware administrators:

# crsctl add crs administrator -u scott

Syntax

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

Parameters

path_to_voting_disk

-purge

Usage Notes

• You should have at least three voting disks, 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 disks. The maximum number of voting disks that is supported is 15.

Example

To add a voting disk to the cluster:

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

Syntax

crsctl add serverpool server_pool_name {-file file_path | 
                  -attr "attr_name=attr_value[,attr_name=attr_value[,...]]"}
                  [-i] [-f]

Parameters

server_pool_name

-file file_path

attribute_name

attribute_value

-attr "MAX_SIZE=30, IMPORTANCE=3"

-i

-f

Usage Notes

• The server_pool_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 ('').

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

• Running this command may result in Oracle Clusterware relocating other servers between server pools to comply with the new configuration.

• You must run this command as root or a cluster administrator.

• Use the crsctl add serverpool command to create server pools that host non-database resources. To create server pools that host Oracle databases, use the SRVCTL command utility.

  See Also:

  Oracle Real Application Clusters Administration and Deployment Guide for information about using the SRVCTL command utility to create server pools

Example

Example 1

To add a server pool named testsp with a maximum size of 5 servers, run the following command as root or the Oracle Clusterware installation owner:

# crsctl add serverpool testsp -attr "MAX_SIZE=5"

Example 2

Create the sp1_attr file with the attribute values for the sp1 serverpool, each on its own line, as shown in the following example:

IMPORTANCE=1
MIN_SIZE=1
MAX_SIZE=2
SERVER_NAMES=node3 node4 node5
PARENT_POOLS=Generic
EXCLUSIVE_POOLS=testsp
ACL=owner:oracle:rwx,pgrp:oinstall:rwx,other::r--

Use the following command to create the sp1 server pool using the sp1_attr file as input:

$ crsctl add serverpool sp1 -file /tmp/sp1_attr

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 option or you can specify one or more space-delimited nodes. If you do not specify either option, 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
*****************************************************************

Syntax

crsctl check crs

Example

To check the health of Oracle Clusterware on the local server:

$ crsctl check crs
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

Syntax

crsctl check resource {resource_name [...] | -w "filter" }
      [-n node_name] [-k cardinality_id] [-d degree_id] }

Parameters

resource_name

-w "filter"

-n node_name

-k cardinality_id

-d 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 has been completed

Example

To initiate the check action inside the application-specific agent of a particular resource:

$ crsctl check resource appsvip

Syntax

crsctl check ctss

Example

The crsctl check ctss command returns output similar to the following:

CRS-4700: The Cluster Time Synchronization Service is in Observer mode.

or

CRS-4701: The Cluster Time Synchronization Service is in Active mode.
CRS-4702: Offset from the reference node (in msec): 100

Syntax

crsctl config crs

Example

The crsctl config crs command returns output similar to the following:

CRS-4622: Oracle High Availability Services autostart is enabled.

Syntax

crsctl delete crs administrator -u user_name [-f]

Parameters

-u user_name

-f

Usage Notes

• The user_name parameter is required

• You must run this command as root or a cluster administrator, or an administrator on Windows systems

• To enable role-separated management, you must remove the * value enclosed in double quotation marks ("")

Example

To remove a user from the list of cluster administrators:

# crsctl delete crs administrator -u scott

Syntax

crsctl delete css votedisk voting_disk_GUID [voting_disk_GUID [...]]

Parameters

voting_disk_GUID

Usage Notes

• You can use this command only to remove voting disks from non-Oracle ASM storage devices

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

Example

To remove a voting disk:

$ crsctl delete css votedisk 26f7271ca8b34fd0bfcdc2031805581e

Syntax

crsctl delete node -n node_name

Usage Notes

• You must be root to run this command

• The node_name parameter is required

Example

To delete the node named node06 from the cluster, run the following command as root:

# crsctl delete node -n node06

Syntax

crsctl delete serverpool server_pool_name [server_pool_name [...]] [-i]

Usage Notes

• The server_pool_name parameter is required

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

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

• While you can use this command in either environment, it is only useful in the Oracle RAC environment

Example

To delete a server pool, run the following command as root or the Oracle Clusterware installation owner:

# crsctl delete serverpool sp1

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

The crsctl disable crs command returns output similar to the following:

CRS-4621: Oracle High Availability Services autostart is disabled.

Syntax

crsctl discover dhcp -clientid clientid [-port port]

Parameters

-clientid clientid

-port port

Usage Notes

• You must run this command as root

Example

The crsctl discover dhcp command returns output similar to the following:

# crsctl discover dhcp -clientid stmjk0462clr-stmjk01-vip

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

Syntax

crsctl enable crs

Usage Notes

• This command only affects the local server

Example

The crsctl enable crs command returns output similar to the following:

CRS-4622: Oracle High Availability Services autostart is enabled.

Syntax

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

Parameters

-cluname cluster_name

-viptype vip_type

-vip vip_resource_name

-n node_name

Example

The crsctl get clientid dhcp command returns output similar to the following:

$ crsctl get clientid dhcp -cluname stmjk0462clr -viptype HOSTVIP -n stmjk01

CRS-10007: stmjk0462clr-stmjk01-vip

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

The crsctl get css disktimeout command returns output similar to the following:

$ crsctl get css disktimeout
CRS-4678: Successful get disktimeout 200 for Cluster Synchronization Services.

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.

Example

To obtain the IPMI device IP address:

$ crsctl get css ipmiaddr

Syntax

crsctl get nodename

Example

The crsctl get nodename command returns output similar to the following:

node2

Syntax

crsctl getperm serverpool server_pool_name  [-u user_name | -g group_name]

Parameters

server_pool_name

-u user_name

-g group_name

Usage Notes

• The server_pool_name parameter is required

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

• While you can use this command in either environment, it is only useful in the Oracle RAC environment

Example

The crsctl getperm serverpool command returns output similar to the following:

$ crsctl getperm serverpool sp1
NAME: sp1
owner:root:rwx,pgrp:root:r-x,other::r--

Syntax

crsctl lsmodules {mdns | gpnp | css | crf | crs | ctss | evm | gipc}

Usage Notes

You can specify any of the following components:

Example

The crsctl lsmodules 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
...

Syntax

crsctl modify serverpool server_pool_name -attr "attr_name=attr_value
                      [,attr_name=attr_value[, ...]]" [-i] [-f]

Parameters

server_pool_name

attr_name

attr_value

-attr "CHECK_INTERVAL=30,START_TIMEOUT=25"

-i

-f

Usage Notes

• You must run this command as root

• The server_pool_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)'"
  

• Running this command may result in Oracle Clusterware relocating other servers between server pools to comply with the new configuration

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

• While you can use this command in either environment, it is only useful in the Oracle RAC environment

Example

To modify an existing server pool, run the following command as root or the Oracle Clusterware installation owner:

# crsctl modify serverpool sp1 -attr "MAX_SIZE=7"

Syntax

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

Usage Notes

• You can specify a space-delimited list of servers

• Any pre-11g release 2 (11.2) 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

Syntax

crsctl query crs administrator

Example

The crsctl query crs administrator command returns output similar to the following:

CRS Administrator List: scott

Syntax

crsctl query crs activeversion

Example

The crsctl query crs activeversion command returns output similar to the following:

Oracle Clusterware active version on the cluster is [11.2.0.2.0]"

Syntax

crsctl query crs releaseversion

Example

The crsctl query crs releaseversion command returns output similar to the following:

Oracle High Availablity Services release version on the local node is [11.2.0.2.0]

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

The crsctl query crs softwareversion command returns output similar to the following:

Oracle Clusterware version on node [node1] is [11.2.0.2.0]

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 executed under the account used to install Oracle Clusterware, or an authorization failure may be reported.

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

Example

The crsctl query css ipmiconfig 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

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

The crsctl query css ipmidevice 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

Syntax

crsctl query css votedisk

Usage Notes

Example

The crsctl query css votedisk command returns output similar to the following:

$ crsctl query css votedisk
##  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 disk(s).

Syntax

crsctl query dns {-servers | -name name [-dnsserver DNS_server_address]
[-port port] [-attempts number_of_attempts] [-timeout timeout_in_seconds] [-v]}

Parameters

-servers

-name name

-dnsserver DNS_server_address

-port port

-attempts number_of_attempts

-timeout timeout_in_seconds

-v

Example

The crsctl query dns command returns output similar to the following for a DNS server named stmjk07-vip.stmjk0462.foo.com:

CRS-10024: DNS server returned 192.168.29.250 for name
stmjk07-vip.stmjk0462.foo.com

If you choose the -servers option, then the command returns output similar to the following:

CRS-10018: the following configuration was found on the system:
CRS-10019: There are 3 domains in search order. They are:
us.foo.com
foo.com
foocorp.com
CRS-10022: There are 3 name servers. They are:
192.168.249.41
192.168.249.52
192.168.202.15
CRS-10020: number of retry attempts for name lookup is: 2
CRS-10021: timeout for each name lookup is: 1

Syntax

crsctl release dhcp -clientid clientid [-port port]

Parameters

-clientid clientid

-port port

Example

The crsctl release dhcp command returns output similar to the following:

$ crsctl release dhcp -clientid  stmjk0462clr-stmjk01-vip

CRS-10012: released DHCP server lease for client ID stmjk0462clr-stmjk01-vip
on port 67

Syntax

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

Parameters

resource_name

resource_name | -all
-s source_server

-w "filter"

-n destination_server

-k cid

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

-i

-f

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

Syntax

crsctl relocate server server_name [...] -c server_pool_name [-i] [-f]

Parameters

server_name

-c server_pool_name

-i

-f

Usage Notes

• The server_name and -c server_pool_name parameters are required

Example

 To move the node6 and node7 servers into the sp1 server pool without disrupting any active resources on those nodes, use the following command:

$ crsctl relocate server node6 node7 -c sp1

Syntax

crsctl replace discoverystring "absolute_path[,...]"

Parameters

absolute_path

Usage Notes

• You must be root, the Oracle Clusterware installation owner, or a member of the Administrators group to run this command.

• You can run this command on any node in the cluster.

Example

Assume the current discovery string is /oracle/css1/*. To also use voting disk files in the /oracle/css2/ directory, replace the current discovery string using the following command:

# crsctl replace discoverystring "/oracle/css1/*,/oracle/css2/*"

Syntax

crsctl replace votedisk [+asm_disk_group | path_to_voting_disk [...]]

Parameters

Usage Notes

• You must be root, the Oracle Clusterware installation owner, or a member of the Administrators group to run this command.

• Specify to replace a voting disk in either an Oracle ASM disk group or in some other storage device.

• You can run this command on any node in the cluster.

Example

Example 1

To replace a voting disk that is located within Oracle ASM:

$ crsctl replace votedisk +diskgroup1

Example 2

To replace a voting disk that is located on a shared file system:

$ crsctl replace votedisk /mnt/nfs/disk1 /mnt/nfs/disk2

Syntax

crsctl request dhcp -clientid clientid [-port port]

Parameters

-clientid clientid

-port port

Example

The crsctl request dhcp command returns output similar to the following:

$ crsctl request dhcp -clientid stmjk0462clr-stmjk01-vip

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

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
  

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

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

Syntax

crsctl setperm serverpool server_pool_name {-u acl_string | -x acl_string |
-o user_name | -g group_name}

Parameters

server_pool_name

{-u | -x | -o | -g}

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

Usage Notes

• The server_pool_name parameter is required

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

• While you can use this command in either environment, it is only useful in the Oracle RAC environment

Example

To grant read, write, and execute permissions on a server pool for user Scott Tiger:

crsctl setperm serverpool sp3 -u user:scott.tiger:rwx

Syntax

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

Usage Notes

• You can choose to start the Oracle Clusterware stack on all servers in the cluster, on 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.

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

Example

To start the Oracle Clusterware stack on two named servers run the following command as root:

# crsctl start cluster -n node1 node2

Syntax

crsctl start crs

Usage Notes

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

Example

To start Oracle High Availability Services on the local server, run the following command as root:

# crsctl start crs

Syntax

crsctl start ip -A {IP_name | IP_address}/netmask/interface_name

Parameters

{IP_name | IP_address}

netmask

interface_name

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

Syntax

crsctl start testdns [-address address [-port port]] [-once] [-v]

Parameters

-address address

-port port

-once

-v

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

Syntax

crsctl status ip -A {IP_name | IP_address}

Parameters

{IP_name | IP_address}

Example

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

CRS-10003: IP address 192.168.29.220 could be reached from current node

Syntax

crsctl status server [-p | -v | -f]

crsctl status server { server_name [...] | -w "filter"} [-g | -p | -v | -f]

Parameters

server_name [...]

-w "filter"

-g | -p | -v | -f

Example

Example 1

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

NAME=node1
STATE=ONLINE

NAME=node2
STATE=ONLINE

Example 2

To display the full configuration of a specific server, enter a command similar to the following:

$ crsctl status server node2 -f
NAME=node2
STATE=ONLINE
ACTIVE_POOLS=Generic ora.orcl
STATE_DETAILS=

Syntax

crsctl status serverpool [-p | -v | -f]

crsctl status serverpool [server_pool_name [...]] [-w] [-g | -p | -v | -f]

Parameters

[server_pool_name [...]

[-g | -p | -v | -f]

Usage Notes

• The server_pool_name parameter or a filter is required

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

• While you can use this command in either environment, it is only useful in the Oracle RAC environment

Examples

Example 1

To display the full configuration of the server pool sp1:

$ crsctl status serverpool sp1 -f 
NAME=spl
IMPORTANCE=1
MIN_SIZE=0
MAX_SIZE=-1
SERVER_NAMES=node3 node4 node5
PARENT_POOLS=Generic
EXCLUSIVE_POOLS=
ACL=owner:oracle:rwx,pgrp:oinstall:rwx,other::r--
ACTIVE_SERVERS=node3 node4

Example 2

To display all the server pools and the servers associated with them, use the following command:

$ crsctl status serverpool
NAME=Free
ACTIVE_SERVERS=

NAME=Generic
ACTIVE_SERVERS=node1 node2

NAME=ora.orcl
ACTIVE_SERVERS=node1 node2

NAME=sp1
ACTIVE_SERVERS=node3 node4

Example 3

To find a server pool that meets certain criteria, use the following command:

$ crsctl status serverpool -w "MAX_SIZE > 1"
NAME=sp2
ACTIVE_SERVERS=node3 node4

Syntax

crsctl status testdns [-server DNS_server_address] [-port port] [-v]

Parameters

-server DNS_server_address

-port port

-v

Example

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

CRS-10024: DNS server returned 192.168.28.74 for name
stmjk07-vip.stmjk0462.foo.com

Syntax

crsctl stop cluster [-all | -n server_name [...]] [-f]

Usage Notes

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

Syntax

crsctl stop crs [-f]

Usage Notes

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

• In Oracle Clusterware 11g release 2 (11.2.0.3), when you run this command in Solaris Sparc and Solaris X64 environments, drivers remain loaded on shutdown and subsequent startup. This does not happen in Linux environments.

Example

To stop Oracle High Availability Services on the local server:

# crsctl stop crs

Syntax

crsctl stop ip -A {IP_name | IP_address}/interface_name

Parameters

{IP_name | IP_address}

interface_name

Example

To stop an IP on the local server, run the command similar to the following:

$ crsctl stop ip -A MyIP.domain.com/eth0

Syntax

crsctl stop testdns [-address address [-port port]] [-domain GNS_domain] [-v]

Parameters

-address address

-port port

[-domain GNS_domain]

-v

Example

The crsctl stop testdns command returns output similar to the following:

CRS-10032: successfully stopped the DNS listening daemon running on port 53 on
local node

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 11g release 2 (11.2), 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 11g release 2 (11.2) if you installed Oracle Clusterware 11g release 2 (11.2) on that server.

Example

To unpin two nodes:

$ crsctl unpin css -n node1 node4

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

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

Syntax

crsctl check has

Usage Notes

Example

The crsctl check has command returns output similar to the following:

CRS-4638: Oracle High Availability Services is online

Syntax

crsctl config has

Usage Notes

Example

The crsctl config has command returns output similar to the following:

CRS-4622 Oracle High Availability Services autostart is enabled.

Syntax

crsctl disable has

Usage Notes

Example

The crsctl disable has command returns output similar to the following:

CRS-4621 Oracle High Availability Services autostart is disabled.

Syntax

crsctl enable has

Usage Notes

Example

The crsctl enable has command returns output similar to the following:

CRS-4622 Oracle High Availability Services autostart is enabled.

Syntax

crsctl query has releaseversion

Usage Notes

Example

The crsctl query has releaseversion command returns output similar to the following:

Oracle High Availability Services release version on the local node is [11.2.0.0.2]

Syntax

crsctl query has softwareversion

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

The crsctl query has softwareversion command returns output similar to the following:

Oracle High Availability Services version on the local node is [11.2.0.2.0]

Syntax

crsctl start has

Usage Notes

Example

To start Oracle High Availability Services on the local server:

# crsctl start has

Syntax

crsctl stop has [-f]

Usage Notes

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

  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 option 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

Syntax

crsctl set log {[crs | css | evm "component_name=log_level, [...]"] | 
[all=log_level]}

You can also set log levels for the agents of specific resources, as follows:

crsctl set log res "resource_name=log_level, [...]"

Usage Notes

• You can set log levels for various components of the three modules, CRS, CSS, and EVM. If you choose the all option, then you can set log levels for all components of one module with one command. Use the crsctl lsmodules command to obtain a list of components for each module.

• Enter a comma-delimited list of component name-log level pairs enclosed in double quotation marks ("").

  Note:

  Separate component name-log level pairs with an equals sign (=) in Oracle Clusterware 11g release 2 (11.2). 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.

• To set log levels for resources, specify the name of a particular resource, or a comma-delimited list of resource name-log level pairs enclosed in double quotation marks ("").

Examples

To set log levels for the CRSRTI and CRSCOMM components of the CRS module: