Name | Description | Examples | Attributes | See Also
The SUNW.asm_diskgroup resource type represents the single instance ASM disk group in a Sun Cluster configuration.
The SUNW.asm_diskgroup resource type can be used when using Oracle Cluster Ready Services (CRS) or not.
The SUNW.asm_diskgroup resource type is a failover or multiple-master resource type. A single resource of this type can run on multiple nodes concurrently, but does not use network load balancing.
Each SUNW.asm_diskgroup resource represents a single instance ASM disk group. Each single instance ASM disk group is uniquely identified by the value of the asm_diskgroups extension property on the node where the instance is running.
The ASM disk group resource should only be mounted if the ASM instance is available on the same cluster node. Additionally, ASM disk groups should be mounted if any required storage resources are enabled on the cluster node. To ensure that these requirement are met, configure the ASM disk group resource as follows:
Create a strong positive affinity between the ASM disk group resource group and the following resource groups:
The single instance or clustered ASM resource group
Any resource group that contains storage resources for Oracle files
Create an offline-restart dependency between the Oracle clustered ASM instance proxy resource and the following resources:
The single instance or clustered ASM instance resource
Any storage resources for Oracle files that you are using
Create these dependencies and affinities when you configure clustered ASM instance resources for the Sun Cluster Support for Oracle data service or Sun Cluster Support for Oracle RAC data service. For more information on configuring resources for Oracle database instances, see Sun Cluster Data Service for Oracle Guide for Solaris OS or 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 :
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:
To register this resource type, use the clresourcetype(1CL) command.
To create instances of this resource type, use the clresource(1CL) command.
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:
SOFT
Any time
LB_WEIGHTED
At creation
"”
Any time
60
300
60
300
60
300
””
Any time
””
Anytime
10
2
Anytime
3600
370
Anytime
FALSE
At creation
60
300
60
300
60
300
3600
60
ANYTIME
60
300
60
300
The extension properties of the SUNW.scalable_asm_instance_proxy resource type are as follows.
This property specifies the Oracle single instance ASM disk group. If required, more than one single instance ASM disk group can be specified as a comma separated list.
String array
Not applicable
When disabled
Provides control over the processes that are monitored through the Process Monitor Facility (PMF). This property denotes the level to which the forked child processes are monitored. Omitting this property or setting this property to the default value is the same as omitting the -Coption for pmfadm(1M). All child processes and their descendents are monitored
Optional
-1
All debug messages and function Begin/End messages
All SQL*Plus and srvmgr messages that the ASM disk group resource issues are written to the log file /var/opt/SUNWscor/oracle_asm/message_log.${RESOURCE}.
This property indicates the level to which debug messages for the Oracle ASM disk group resources are logged. When the debug level is increased, more debug messages are written to the system log /var/adm/messages as follows:
0 |
No debug messages |
1 |
Function Begin and End messages |
2 |
All debug messages and function Begin/End messages |
Integer
0–2
0
Any time
Allows the resources to fail over. If this property is set to False, failover of the resource is disabled. You can use this property to prevent the application resource from initiating a failover of the resource group.
Use the Failover_mode property instead of the Failover_enabled extension property because Failover_mode better controls failover behavior. For more information, see the descriptions of the LOG_ONLY and RESTART_ONLY values for Failover_mode in r_properties(5).
You can specify a different value of the debug_level extension property for each node that can master the resource.
Optional
True
When disabled
Specifies the level, or type, of diagnostic messages that are logged by GDS. You can specify None, Info, or Err for this property. When you specify None, diagnostic messages are not logged by GDS. When you specify Info, both information and error messages are logged. When you specify Err, only error messages are logged.
Optional
Info
Any time
This property specifies whether an application uses the network.
Optional
False
At creation
This property specifies the number of PMF restart allowed for the fault monitor.
4
Any time
This property specifies the number of PMF restart allowed for the fault monitor.
2
Any time
Specifies the command that periodically checks the health of the single instance ASM.
Required
"/opt/SUNWscor/oracle_asm/bin/asm_control probe -R %RS_NAME -G %RG_NAME -T %RT_NAME"
None
This property specifies the timeout value, in seconds, for the probe command.
Optional
30 seconds
Any time
Specifies the command that starts the single instance ASM.
Required
"/opt/SUNWscor/oracle_asm/bin/asm_control start -R %RS_NAME -G %RG_NAME -T %RT_NAME"
Any time
Specifies the command that starts the single instance ASM.
Required
"/opt/SUNWscor/oracle_asm/bin/asm_control start -R %RS_NAME -G %RG_NAME -T %RT_NAME"
None
Specifies the command that stops the single instance ASM.
Required
"/opt/SUNWscor/oracle_asm/bin/asm_control stop -R %RS_NAME -G %RG_NAME -T %RT_NAME"
None
Specifies the command that stops the single instance ASM.
Optional
15
When disabled
Specifies the command that stops the single instance ASM.
Optional
15
When disabled
Specifies the absolute path to the command that validates the application, although currently not used.
Optional
15
When disabled
This example shows the commands for performing the following operations to create a scalable_asm_instance_proxy resource on a two-node cluster:
Creating the asm-inst-rg resource group
Registering the SUNW.scalable_asm_instance_proxy resource type
Setting the resource group affinity
Adding the asm-inst-rs resource to the asm-inst-rg resource group
Setting the asm_diskgroups extension property
The example makes the following assumptions:
The bash shell is used.
A resource group that is named asm-inst-rg exists and contains a resource of type SUNW.scalable_asm_instance that is named asm-inst-rs.
phys-schost-1# clresourcetype register SUNW.asm_diskgroup\ phys-schost-1# clresourcegroup create -S asm-inst-rg phys-schost-1# clresourcgroup set -p rg_affinities=++asm-inst-rg asm-dg-rg\ phys-schost-1# clresource create -g asm-dg-rg \ -t SUNW.asm_diskgroup \ -p resource_dependencies_offline_restart=asm-instance-rs \ -d asm-dd-rs \ phys-schost-1# clresourcegroup online -M asm-dg-rg phys-schost-1# clresource enable asm-dg-rs |
This example shows the commands for performing the following operations to create a scalable multi-master asm_diskgroup resource on a two-node cluster:
Creating the asm-dg-rg resource group
Registering the SUNW.asm_diskgroup resource type
Setting the resource group affinity
Adding the asm-dg-rs resource to the asm-dg-rg resource group
Setting the asm_diskgroups extension property for two ASM disk groups
The example makes the following assumptions:
The bash shell is used.
A resource group that is named asm-inst-rg exists and contains a resource of type SUNW.scalable_asm_instance_proxy that is named asm-inst-rs.
A resource group that is named scal-mp-rg exists and contains a resource of type SUNW.ScalMountPoint that is named scal-mp-rs.
phys-schost-1# clresourcetype register SUNW.asm_diskgroup\ phys-schost-1# clresourcegroup create -S asm-dg-rg phys-schost-1# clresourcgroup set -p rg_affinities=++asm-inst-rg asm-dg-rg\ phys-schost-1# clresource create -g asm-dg-rg \ -t SUNW.asm_diskgroup \ -p asm_diskgroups=dg1,dg2 \\ -p resource_dependencies_offline_restart=asm-instance-rs, qfs-mp-rs \ -d asm-dg-rs \ phys-schost-1# clresourcegroup online -M asm-dg-rg phys-schost-1# clresource enable asm-dg-rs |
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE |
ATTRIBUTE VALUE |
---|---|
Availability |
SUNWscor |
Sun Cluster Data Service for Oracle RAC Guide for Solaris OS, Sun Cluster Data Service for Oracle Guide for Solaris OS Sun Cluster Data Services Planning and Administration Guide for Solaris OS
Name | Description | Examples | Attributes | See Also