SUNW.crs_framework

, crs_framework

- resource type implementation that coordinates shutdown of Oracle Clusterware

Description

The SUNW.crs_framework resource type coordinates the shutdown of Oracle Clusterware and Oracle Solaris Cluster resources in a configuration of Oracle Solaris Cluster Support for Oracle Real Application Clusters (Oracle RAC). This resource type enables Oracle Solaris Cluster and Oracle Clusterware to inter-operate by enabling Oracle Solaris Cluster to stop Oracle Clusterware.

The Oracle Clusterware 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 Clusterware 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 Clusterware 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 Oracle Clusterware 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 Oracle Clusterware or Oracle RAC processes are accessing storage

• When a node is shut down. If the Oracle Clusterware 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 Oracle Solaris 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 Oracle Clusterware 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 Oracle Solaris Cluster Support for Oracle RAC data service.

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

• The clsetup(1CL) utility, specifying the option for configuring Oracle Solaris Cluster Support for Oracle Real Application Clusters

• The following sequence of Oracle Solaris 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 Oracle RAC framework

  • A resource of type SUNW.ScalDeviceGroup that is named db-storage-rs, which represents the scalable device group that stores the Oracle Clusterware 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:

See Also

clresource(1CL), clresourcetype(1CL), clsetup(1CL), attributes(5), SUNW.rac_framework(5), SUNW.ScalDeviceGroup(5), SUNW.ScalMountPoint(5)