Skip Navigation Links
Exit Print View
| Oracle Solaris Cluster Data Services Reference Manual Oracle Solaris Cluster 4.1

Search Scope:

- This Document
- Entire Library

### SUNW.asm_diskgroup

### , asm_diskgroup

- resource type implementation for the Oracle Automated Storage Management (ASM) disk group managed by Oracle Solaris Cluster

## Description

The `SUNW.asm_diskgroup` resource type represents the ASM disk group in an Oracle Solaris Cluster configuration.

Note - 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 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 ASM disk group 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 Oracle Solaris Cluster Support for Oracle data service or Oracle Solaris Cluster Support for Oracle RAC data service. For more information on configuring resources for Oracle database instances, see Oracle Solaris Cluster Data Service for Oracle Guide or Oracle Solaris Cluster Data Service for Oracle Real Application Clusters Guide.

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

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

  - To register this resource type, use the `clresourcetype`(1CL) command.

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

`Failover_mode`
  Default

    SOFT

  Tunable

    Any time

`Load_balancing_policy`
  Default

    LB_WEIGHTED

  Tunable

    At creation

`Load_balancing_weights`
  Default

    ””

  Tunable

    Any time

`Monitor_check_timeout`
  Minimum

    60

  Default

    300

`Monitor_start_timeout`
  Minimum

    60

  Default

    300

`Monitor_stop_timeout`
  Minimum

    60

  Default

    300

`Network_resources_used`
  Default

    ””

  Default

    Any time

`Port_list`
  Default

    ””

  Tunable

    Anytime

`Retry_count`
  Maximum

    10

  Default

    2

  Tunable

    Anytime

`Retry_Interval`
  Maximum

    3600

  Default

    370

  Tunable

    Anytime

`Scalable`
  Default

    FALSE

  Tunable

    At creation

`Start_timeout`
  Minimum

    60

  Default

    300

`Stop_timeout`
  Minimum

    60

  Default

    300

`Through_probe_interval`
  Minimum

    3600

  Default

    60

  Tunable

    ANYTIME

`Update_timeout`
  Minimum

    60

  Default

    300

`Validate_timeout`
  Minimum

    60

  Default

    300

### Extension Properties

The extension properties of the `SUNW.asm_diskgroups` resource type are as follows.

`asm_diskgroups`

  This property specifies the Oracle ASM disk group. If required, more than one ASM disk group can be specified as a comma separated list.

  Data Type

    String array

  Range

    Not applicable

  Default

    “”

  Tunable

    When disabled

`Child_mon_level`(integer)

  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 `-C`option for `pmfadm`(1M). All child processes and their descendents are monitored.

  Category

    Optional

  Default

    -1

  Tunable

    When disabled

`debug_level`

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

  You can specify a different value of the `debug_level` extension property for each node that can master the resource.

  Data Type

    Integer

  Range

    0–2

  Default

    0

  Tunable

    Any time

`Failover_Enabled`(boolean)

  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.

  Note - 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).

  Category

    Optional

  Default

    True

  Tunable

    When disabled

`Log_level`

  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.

  Category

    Optional

  Default

    Info

  Tunable

    Any time

`Network_aware`(boolean)

  This property specifies whether an application uses the network.

  Category

    Optional

  Default

    `False`

  Tunable

    At creation

`Monitor_retry_count`

  This property specifies the number of PMF restart allowed for the fault monitor.

  Default

    4

  Tunable

    Any time

`Monitor_retry_interval`

  This property specifies the number of PMF restart allowed for the fault monitor.

  Default

    2

  Tunable

    Any time

`probe_command`(string)

  Specifies the command that periodically checks the health of the single instance ASM.

  Category

    Required

  Default

    `"/opt/SUNWscor/oracle_asm/bin/asm_control probe -R %RS_NAME -G %RG_NAME -T %RT_NAME"`

  Tunable

    None

`Probe_timeout`(integer)

  This property specifies the timeout value, in seconds, for the probe command.

  Category

    Optional

  Default

    30 seconds

  Tunable

    Any time

`Start_command`(string)

  Specifies the command that mounts the ASM diskgroup.

  Category

    Required

  Default

    `"/opt/SUNWscor/oracle_asm/bin/asm_control start -R %RS_NAME -G %RG_NAME -T %RT_NAME"`

  Tunable

    None

`Stop_command`(string)

  Specifies the command that dismounts the ASM diskgroup.

  Category

    Required

  Default

    `"/opt/SUNWscor/oracle_asm/bin/asm_control stop -R %RS_NAME -G %RG_NAME -T %RT_NAME"`

  Tunable

    None

`Stop_signal`(integer)

  Specifies the command that send stop signal to the ASM diskgroup.

  Category

    Optional

  Default

    `15`

  Tunable

    When disabled

`Validate_command`(string)

  Specifies the absolute path to the command that validates the application, although currently not used.

  Category

    Optional

  Default

    `NULL`

  Tunable

    When disabled

## Examples

Example 1 Creating a Failover `asm_diskgroup` Resource

This example shows the commands for performing the following operations to create a failover `asm_diskgroup` resource on a two-node cluster:

1. Creating the `asm-dg-rg` resource group

2. Registering the `SUNW.asm_diskgroup` resource type

3. Setting the resource group affinity

4. Adding the `asm_dg-rs` resource to the `asm-dg-rg` resource group

5. 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 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 \
    -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

Example 2 Creating a Scalable `asm_diskgroup` Resource

This example shows the commands for performing the following operations to create a scalable multi-master `asm_diskgroup` resource on a two-node cluster:

1. Creating the `asm-dg-rg` resource group

2. Registering the `SUNW.asm_diskgroup` resource type

3. Setting the resource group affinity

4. Adding the `asm-dg-rs` resource to the `asm-dg-rg` resource group

5. 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 `qfs-mp-rs`.

    phys-schost-1# clresourcetype register SUNW.asm_diskgroup
    phys-schost-1# clresourcegroup create -g 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 Also

Oracle Solaris Cluster Data Services Planning and Administration Guide, Oracle Solaris Cluster Data Service for Oracle Guide, Oracle Solaris Cluster Data Service for Oracle Real Application Clusters Guide

Copyright © 2000, 2012, Oracle and/or its affiliates. All rights reserved. Legal Notices |