SUNW.crs_framework(5) (Sun Cluster Reference Manual for Solaris OS)

Sun Cluster Reference Manual for Solaris OS

SUNW.crs_framework(5)

NAME | DESCRIPTION | EXAMPLES | ATTRIBUTES | SEE ALSO

NAME

SUNW.crs_framework, crs_framework– resource type implementation that coordinates shutdown of Oracle Cluster Ready Services (CRS)

DESCRIPTION

The SUNW.crs_framework resource type coordinates the shutdown of Oracle Cluster Ready Services (CRS) and Sun Cluster resources in a configuration of Sun Cluster Support for Oracle Real Application Clusters (RAC). This resource type enables Sun Cluster and Oracle CRS to interoperate by enabling Sun Cluster to stop Oracle CRS.

Note –

This resource type does not enable Oracle CRS to be started by using Sun Cluster administration commands. Oracle CRS can be started only by using Oracle commands or by booting a node.

The CRS voting disk and Oracle cluster registry (OCR) files might reside on storage that is represented by resources of type SUNW.ScalDeviceGroup or SUNW.ScalMountPoint. In this situation, Oracle CRS must be stopped before resources of type SUNW.ScalDeviceGroup or SUNW.ScalMountPoint are brought offline. A resource of type SUNW.crs_framework ensures that this requirement is met by stopping Oracle CRS processes on a node in the following situations:

When a resource of type SUNW.ScalDeviceGroup or SUNW.ScalMountPoint is brought offline on the node by. The CRS processes must be stopped for the following reasons:
- To ensure that the resource of type SUNW.ScalDeviceGroup or SUNW.ScalMountPoint is stopped correctly
- To prevent failure of the database or a node if a resource of type SUNW.ScalDeviceGroup or SUNW.ScalMountPoint is brought offline while CRS or RAC processes are accessing storage
When a node is shut down. If the CRS processes are not stopped, the node fails to shut down.

The SUNW.crs_framework resource type is a single instance resource type. Only one resource of this type can be created in the cluster.

To ensure that Sun Cluster stops resources in the correct order, configure a resource of type SUNW.crs_framework as follows:

Ensure that any resource group that contains a resource of type SUNW.ScalDeviceGroup or SUNW.ScalMountPoint declares strong positive affinity for the resource group that is to contain the SUNW.crs_framework resource.
Set an offline-restart dependency by the SUNW.crs_framework resource on any resources that represent storage for the CRS voting disk and OCR files. These resources are of type SUNW.ScalDeviceGroup or SUNW.ScalMountPoint. Limit the scope of each dependency to only the node where the SUNW.ScalDeviceGroup resource or SUNW.ScalMountPoint resource is running.
Set a strong dependency by the resource of type SUNW.crs_framework on a resource of type SUNW.rac_framework.

Create these dependencies and affinities when you configure database resources for the Sun Cluster Support for Oracle RAC data service. For more information, see “Configuring Resources for Oracle RAC Database Instances” in Sun Cluster Data Service for Oracle RAC Guide for Solaris OS.

To register this resource type and create instances of this resource type, use one of the following means:

Sun Cluster Manager
The clsetup(1CL) utility, specifying the option for configuring Sun Cluster Support for Oracle Real Application Clusters
The following sequence of Sun Cluster maintenance commands:
1. To register this resource type, use the clresourcetype(1CL) command.
2. To create instances of this resource type, use the clresource(1CL) command.

Standard Properties

For a description of all standard resource properties, see the r_properties(5) man page.

Standard resource properties are overridden for this resource type as follows:

Monitor_start_timeout

Minimum: 60
Default: 300

Monitor_stop_timeout

Minimum: 60
Default: 300

Start_timeout

Minimum: 60
Default: 300

Stop_timeout

Minimum: 60
Default: 1200

Update_timeout

Minimum: 60
Default: 300

Validate_timeout

Minimum: 60
Default: 300

Extension Properties

The SUNW.crs_framework resource type has no extension properties.

EXAMPLES

Example 1 Creating a `SUNW.crs_framework` Resource

This example registers the SUNW.crs_framework resource type and creates an instance of the SUNW.crs_framework resource type that is named crs_framework-rs. The example makes the following assumptions:

The C shell is used.
A resource group that is named crs-framework-rg exists.
The following resources exist:
- A resource of type SUNW.rac_framework that is named rac_framework-rs, which represents the RAC framework
- A resource of type SUNW.ScalDeviceGroup that is named db-storage-rs, which represents the scalable device group that stores the CRS voting disk and OCR files

phys-schost-1# clresourcetype register SUNW.crs_framework
phys-schost-1# clresource create -g crs-framework-rg \
-t SUNW.crs_framework \
-p resource_dependencies=rac_framework-rs \
-p resource_dependencies_offline_restart=db-storage-rs\{local_node\} \
crs_framework-rs

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	`SUNWscucm`