Skip Navigation Links
Exit Print View
| Oracle Solaris Cluster System Administration Guide Oracle Solaris Cluster 4.1

Search Scope:

- This Document
- Entire Library

## Administering the SCSI Protocol Settings for Storage Devices

Oracle Solaris Cluster software installation automatically assigns SCSI reservations to all storage devices. Use the following procedures to check the settings of devices and, if necessary, to override the setting for a device.

- How to Display the Default Global SCSI Protocol Settings for All Storage Devices

- How to Display the SCSI Protocol of a Single Storage Device

- How to Change the Default Global Fencing Protocol Settings for All Storage Devices

- How to Change the Fencing Protocol for a Single Storage Device

## How to Display the Default Global SCSI Protocol Settings for All Storage Devices

The `phys-schost#` prompt reflects a global-cluster prompt. Perform this procedure on a global cluster.

This procedure provides the long forms of the Oracle Solaris Cluster commands. Most commands also have short forms. Except for the long and short forms of the command names, the commands are identical.

1. Assume a role that provides `solaris.cluster.read` RBAC authorization.
2. From any node, display the current global default SCSI protocol setting.

       # cluster show -t global

   For more information, see the `cluster`(1CL) man page.

Example 5-18 Displaying the Default Global SCSI Protocol Settings for All Storage Devices

The following example displays the SCSI protocol settings for all storage devices on the cluster.

    # cluster show -t global

    === Cluster ===

    Cluster Name:                                   racerxx
      clusterid:                                      0x4FES2C888
      installmode:                                    disabled
      heartbeat_timeout:                              10000
      heartbeat_quantum:                              1000
      private_netaddr:                                172.16.0.0
      private_netmask:                                255.255.111.0
      max_nodes:                                      64
      max_privatenets:                                10
      udp_session_timeout:                            480
      concentrate_load:                               False
      global_fencing:                                 prefer3
      Node List:                                      phys-racerxx-1, phys-racerxx-2

## How to Display the SCSI Protocol of a Single Storage Device

The `phys-schost#` prompt reflects a global-cluster prompt. Perform this procedure on a global cluster.

This procedure provides the long forms of the Oracle Solaris Cluster commands. Most commands also have short forms. Except for the long and short forms of the command names, the commands are identical.

1. Assume a role that provides `solaris.cluster.read` RBAC authorization.
2. From any node, display the SCSI protocol setting of the storage device.

       # cldevice show device

   device

     The name of the device path or a device name.

   For more information, see the `cldevice`(1CL)man page.

Example 5-19 Displaying the SCSI Protocol of a Single Device

The following example displays the SCSI protocol for the device `/dev/rdsk/c4t8d0`.

    # cldevice show /dev/rdsk/c4t8d0

    === DID Device Instances ===

    DID Device Name:                                /dev/did/rdsk/d3
      Full Device Path:                               phappy1:/dev/rdsk/c4t8d0
      Full Device Path:                               phappy2:/dev/rdsk/c4t8d0
      Replication:                                    none
      default_fencing:                                global

## How to Change the Default Global Fencing Protocol Settings for All Storage Devices

You can turn fencing on or off globally for all storage devices connected to a cluster. The default fencing setting of a single storage device overrides the global setting when the device's default fencing is set to `pathcount`, `prefer3`, or `nofencing`. If the default fencing setting of a storage device is set to `global`, the storage device will use the global setting. For example, if a storage device has the default setting `pathcount`, the setting will not change if you use this procedure to change the global SCSI protocol settings to `prefer3`. You must use the How to Change the Fencing Protocol for a Single Storage Device procedure to change the default setting of a single device.

| Caution - If fencing is turned off under the wrong circumstances, your data can be vulnerable to corruption during application failover. Examine this data corruption possibility carefully when you are considering turning fencing off. Fencing can be turned off if the shared storage device does not support the SCSI protocol or if you want to allow access to the cluster's storage from hosts outside the cluster.

To change the default fencing setting for a quorum device, you must unconfigure the device, change the fencing setting, and reconfigure the quorum device. If you plan to turn fencing off and back on regularly for devices that include quorum devices, consider configuring quorum through a quorum server service to eliminate interruptions in quorum operation.

The `phys-schost#` prompt reflects a global-cluster prompt. Perform this procedure on a global cluster.

This procedure provides the long forms of the Oracle Solaris Cluster commands. Most commands also have short forms. Except for the long and short forms of the command names, the commands are identical.

1. Assume a role that provides `solaris.cluster.modify` RBAC authorization.
2. Set the fencing protocol for all storage devices that are not quorum devices.

       cluster set -p global_fencing={pathcount | prefer3 | nofencing | nofencing-noscrub}

   `-p global_fencing`

     Sets the current global default fencing algorithm for all shared devices.

   `prefer3`

     Uses the SCSI-3 protocol for devices with more than two paths.

   `pathcount`

     Determines the fencing protocol by the number of DID paths that are attached to the shared device. The pathcount setting is used for quorum devices.

   `nofencing`

     Turns fencing off by setting the fencing status for all storage devices.

   `nofencing-noscrub`

     Scrubbing the device ensures that the device is cleared of all persistent SCSI reservation information and allows access to the storage from systems outside the cluster. Use the `nofencing-noscrub` option only for storage devices that have severe problems with SCSI reservations.

Example 5-20 Setting the Default Global Fencing Protocol Settings for All Storage Devices

The following example sets the fencing protocol for all storage devices on the cluster to the SCSI-3 protocol.

    # cluster set -p global_fencing=prefer3

## How to Change the Fencing Protocol for a Single Storage Device

You can also set the fencing protocol for a single storage device.

Note - To change the default fencing setting for a quorum device, you must unconfigure the device, change the fencing setting, and reconfigure the quorum device. If you plan to turn fencing off and back on regularly for devices that include quorum devices, consider configuring quorum through a quorum server service to eliminate interruptions in quorum operation.

The `phys-schost#` prompt reflects a global-cluster prompt. Perform this procedure on a global cluster.

This procedure provides the long forms of the Oracle Solaris Cluster commands. Most commands also have short forms. Except for the long and short forms of the command names, the commands are identical.

| Caution - If fencing is turned off under the wrong circumstances, your data can be vulnerable to corruption during application failover. Examine this data corruption possibility carefully when you are considering turning fencing off. Fencing can be turned off if the shared storage device does not support the SCSI protocol or if you want to allow access to the cluster's storage from hosts outside the cluster.

1. Assume a role that provides `solaris.cluster.modify` RBAC authorization.
2. Set the fencing protocol of the storage device.

       cldevice set -p default_fencing ={pathcount | \
       scsi3 | global | nofencing | nofencing-noscrub} device

   `-p default_fencing`

     Modifies the default_fencing property of the device.

   `pathcount`

     Determines the fencing protocol by the number of DID paths that are attached to the shared device.

   `scsi3`

     Uses the SCSI-3 protocol.

   `global`

     Uses the global default fencing setting. The global setting is used for non-quorum devices.

   ``

     Turns fencing off by setting the fencing status for the specified DID instance.

   `nofencing-noscrub`

     Scrubbing the device ensures that the device is cleared of all persistent SCSI reservation information and allows access to the storage device from systems outside the cluster. Use the `nofencing-noscrub` option only for storage devices that have severe problems with SCSI reservations.

   device

     Specifies the name of the device path or device name.

   For more information, see the `cluster`(1CL) man page.

Example 5-21 Setting the Fencing Protocol of a Single Device

The following example sets the device d5, specified by device number, to the SCSI-3 protocol.

    # cldevice set -p default_fencing=prefer3 d5

The following example turns default fencing off for the d11 device.

    #cldevice set -p default_fencing=nofencing d11

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