Sun Cluster System Administration Guide for Solaris OS

Administering the SCSI Protocol Settings for Storage Devices

Sun 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.

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

This procedure provides the long forms of the Sun Cluster commands. Most commands also have short forms. Except for the long and short forms of the command names, the commands are identical. For a list of the commands and their short forms, see Appendix A, Sun Cluster Object-Oriented Commands.

  1. Become superuser or 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–33 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
  installmode:                                    disabled
  heartbeat_timeout:                              10000
  heartbeat_quantum:                              1000
  private_netaddr:                                172.16.0.0
  private_netmask:                                255.255.248.0
  max_nodes:                                      64
  max_privatenets:                                10
  global_fencing:                                 scsi3
  Node List:                                      phys-racerxx-1, phys-racerxx-2

ProcedureHow to Display the SCSI Protocol of a Single Storage Device

This procedure provides the long forms of the Sun Cluster commands. Most commands also have short forms. Except for the long and short forms of the command names, the commands are identical. For a list of the commands and their short forms, see Appendix A, Sun Cluster Object-Oriented Commands.

  1. Become superuser or 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–34 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

ProcedureHow to Change the Default Global SCSI Protocol Settings for All Storage Devices

The default fencing setting of a single storage device overrides the global setting when the device's default fencing is set to pathcount or scsi3. 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 scsi3. You must use the How to Change the SCSI Protocol for a Single Storage Device procedure to change the default setting of a single device.

To change the default fencing setting for a quorum device you must unconfigure the device, change the setting, and reconfigure the quorum device.

This procedure provides the long forms of the Sun Cluster commands. Most commands also have short forms. Except for the long and short forms of the command names, the commands are identical. For a list of the commands and their short forms, see Appendix A, Sun Cluster Object-Oriented Commands.

  1. Become superuser or assume a role that provides solaris.cluster.modify RBAC authorization.

  2. Set the SCSI protocol for all storage devices that are not quorum devices.


    cluster set -p global_fencing={scsi3 | pathcount}
    -p global_fencing

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

    scsi3

    Uses the SCSI-3 protocol.

    pathcount

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


Example 5–35 Setting the Default Global SCSI Protocol Settings for All Storage Devices

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


# cluster set -p global_fencing=scsi3

ProcedureHow to Change the SCSI Protocol for a Single Storage Device

To change the default fencing setting for a quorum device you must unconfigure the device.

This procedure provides the long forms of the Sun Cluster commands. Most commands also have short forms. Except for the long and short forms of the command names, the commands are identical. For a list of the commands and their short forms, see Appendix A, Sun Cluster Object-Oriented Commands.

  1. Become superuser or assume a role that provides solaris.cluster.modify RBAC authorization.

  2. Set the SCSI protocol of the storage device.


    # cldevice set -p default_fencing ={pathcount | scsi3 | global} device
    
    -p

    Modifies the device properties.

    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.

    device

    Specifies the name of the device path or device name.

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


Example 5–36 Setting the SCSI Protocol of a Single Device

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


# cldevice set -p default_fencing=scsi3 5