Sun Cluster 3.0-3.1 With StorEdge A1000 Array, Netra st A1000 Array, or StorEdge A3500 System Manual

Maintaining Storage Arrays

The maintenance procedures in FRUs That Do Not Require Sun Cluster Maintenance Procedures are performed the same as in a noncluster environment. Table 1–3 lists the procedures that require cluster-specific steps.


Note –

When you upgrade firmware on a storage device or on an enclosure, redefine the stripe size of a LUN, or perform other LUN operations, a device ID might change unexpectedly. When you perform a check of the device ID configuration by running the scdidadm -c command, the following error message appears on your console if the device ID changed unexpectedly.


device id for nodename:/dev/rdsk/cXtYdZsN does not match physical 
device's id for ddecimalnumber, device may have been replaced.

To fix device IDs that report this error, run the scdidadm -R command for each affected device.


Table 1–3 Task Map: Maintaining a Storage Array or Storage System

Task 

Information 

Remove a storage array or storage system 

How to Remove a Storage Array

Replace a storage array or storage system 

Replacing a storage array or storage system, requires first removing the storage array or storage system, then adding a new storage array or storage system to the configuration. 

How to Add a Storage Array to an Existing Cluster

How to Remove a Storage Array

Replace a failed controller module or restore an offline controller module 

How to Replace a Failed Controller or Restore an Offline Controller

Upgrade controller module firmware and NVSRAM file 

How to Upgrade Controller Module Firmware

Add a disk drive 

How to Add a Disk Drive

Replace a disk drive 

How to Replace a Disk Drive

Remove a disk drive 

How to Remove a Disk Drive

Upgrade disk drive firmware 

How to Upgrade Disk Drive Firmware

Replace a host adapter 

How to Replace a Host Adapter

FRUs That Do Not Require Sun Cluster Maintenance Procedures

Each storage device has a different set of FRUs that do not require cluster-specific procedures. Choose among the following storage devices:

Sun StorEdge A1000 Array and Netra st A1000 Array FRUs

The following is a list of administrative tasks that require no cluster-specific procedures. See the Sun StorEdge A1000 and D1000 Installation, Operations, and Service Manual and the Netra st A1000/D1000 Installation and Maintenance Manual for these procedures.

Replacing a storage array-to-host SCSI cable requires no cluster-specific procedures. See the Sun StorEdge RAID Manager User’s Guide and the Sun StorEdge RAID Manager Release Notes for these procedures.

Sun StorEdge A3500 System FRUs

With the exception of one item, the following is a list of administrative tasks that require no cluster-specific procedures. Shut down the cluster, and then see the Sun StorEdge A3500/A3500FC Controller Module Guide, the Sun StorEdge A1000 and D1000 Installation, Operations, and Service Manual, and the Sun StorEdge Expansion Cabinet Installation and Service Manual for the following procedures. See the Sun Cluster system administration documentation for procedures about how to shut down a cluster. For a list of Sun Cluster documentation, see Related Documentation.

The following is a list of administrative tasks that require no cluster-specific procedures. See the Sun StorEdge A3500/A3500FC Controller Module Guide, the Sun StorEdge RAID Manager User’s Guide, the Sun StorEdge RAID Manager Release Notes, the Sun StorEdge FC-100 Hub Installation and Service Manual, and the documentation that shipped with your FC hub or FC switch for the following procedures.

ProcedureHow to Remove a Storage Array


Caution – Caution –

This procedure removes all data that is on the storage array or storage system you are removing.


Before You Begin

This procedure relies on the following prerequisites and assumptions.

Steps
  1. Migrate any Oracle Real Application Clusters tables, data services, or volumes off the storage array or storage system.

  2. Is one of the LUNs in the storage array a quorum device? This storage array is the storage array that you are removing.


    Note –

    Your storage array or storage system might not support LUNs as quorum devices. To determine if this restriction applies to your storage array or storage system, see Restrictions and Requirements.



    # scstat -q
    
    • If no, proceed to Step 3.

    • If yes, relocate that quorum device to another suitable storage array.

      For procedures about how to add and remove quorum devices, see your Sun Cluster system administration documentation. For a list of Sun Cluster documentation, see Related Documentation.

  3. Halt all activity to the controller module.

    For instructions, see your storage device documentation and your operating system documentation.

  4. Does a volume manager manage any of the LUNs on the controller module you are removing?

    • If no, proceed to Step 10.

    • If yes, remove the LUN from any diskset or disk group. For more information, see your Solstice DiskSuite/Solaris Volume Manager or VERITAS Volume Manager documentation.

      You must completely remove LUNs that were managed by VERITAS Volume Manager from VERITAS Volume Manager control before you can delete the LUNs.


      # vxdisk offline cNtXdY
      # vxdisk rm cNtXdY
      
  5. Delete the LUN.

    For the procedure about how to delete a LUN, see your storage device's documentation.

  6. Remove the paths to the LUNs you deleted in Step 5.


    # rm /dev/rdsk/cNtXdY*
    # rm /dev/dsk/cNtXdY*
    
    # rm /dev/osa/dev/dsk/cNtXdY*
    # rm /dev/osa/dev/rdsk/cNtXdY*
    
  7. On all nodes, remove references to the storage array.


    # scdidadm -C
    
  8. (StorEdge A3500 Only) Use the lad command to determine the alternate paths to the LUN you are deleting.

    The RAID Manager software creates two paths to the LUN in the /dev/osa/dev/rdsk directory. Substitute the cNtXdY number from the other controller module in the storage array to determine the alternate path.

    For example:


    # lad
    c0t5d0 1T93600714 LUNS: 0 1
    c1t4d0 1T93500595 LUNS: 2

    Therefore, the alternate paths are as follows:


    /dev/osa/dev/dsk/c1t4d1*
    /dev/osa/dev/rdsk/c1t4d1*
  9. (StorEdge A3500 Only) Remove the alternate paths to the LUNs you deleted in Step 5.


    # rm /dev/osa/dev/dsk/cNtXdY*
    # rm /dev/osa/dev/rdsk/cNtXdY*
    
  10. Disconnect all cables from the storage array and storage system. Remove the hardware from your cluster.

  11. If you plan to remove a host adapter that has an entry in the nvramrc script, delete the references to the host adapters in the nvramrc script.


    Note –

    If no other parallel SCSI devices are connected to the nodes, you can delete the contents of the nvramrc script. At the OpenBoot PROM, set setenv use-nvramrc? to false.


  12. Remove any unused host adapter from nodes that were attached to the storage array or storage system.

    1. Shut down and power off Node A, from which you are removing a host adapter.

      For the procedure about how to shut down and power off a node, see your Sun Cluster system administration documentation. For a list of Sun Cluster documentation, see Related Documentation.

    2. Remove the host adapter from Node A.

      For the procedure about how to remove a host adapter, see the documentation that shipped with your node hardware.

    3. Perform a reconfiguration boot to create the new Solaris device files and links.

    4. Repeat Step a through Step c for Node B that was attached to the storage array or storage system.

  13. Return resource groups to their primary nodes.


    # scswitch -Z
    
  14. Are you removing the last storage array or storage system from your cluster?

    • If no, you are finished with this procedure.

    • If yes, proceed to Step 15.

  15. Remove RAID Manager patches, then remove RAID Manager software packages.


    Caution – Caution –

    If you improperly remove RAID Manager packages, the next reboot of the node fails. Before you remove RAID Manager software packages, see the Sun StorEdge RAID Manager Release Notes.


    For the procedure about how to remove software packages, see the documentation that shipped with your storage array or storage system.

ProcedureHow to Replace a Failed Controller or Restore an Offline Controller

This procedure assumes that your cluster is operational. For conceptual information about SCSI reservations and failure fencing, see your Sun Cluster concepts documentation. For a list of Sun Cluster documentation, see Related Documentation.

Steps
  1. (StorEdge A1000 Only) Is one of the LUNs in the storage array a quorum device?


    Note –

    Your storage array or storage system might not support LUNs as quorum devices. To determine if this restriction applies to your storage array or storage system, see Restrictions and Requirements.



    # scstat -q
    
    • If no, proceed to Step 2.

    • If yes, relocate that quorum device to another suitable storage array.

      For procedures about how to add and remove quorum devices, see your Sun Cluster system administration documentation. For a list of Sun Cluster documentation, see Related Documentation.

  2. (StorEdge A3500 Only) On both nodes, to prevent LUNs from automatic assignment to the controller that is being brought online, set the System_LunReDistribution parameter in the /etc/raid/rmparams file to false.


    Caution – Caution –

    You must set the System_LunReDistribution parameter in the /etc/raid/rmparams file to false so that no LUNs are assigned to the controller being brought online. After you verify in Step 6 that the controller has the correct SCSI reservation state, you can balance LUNs between both controllers.


    For the procedure about how to modify the rmparams file, see the Sun StorEdge RAID Manager Installation and Support Guide.

  3. Restart the RAID Manager daemon.


    # /etc/init.d/amdemon stop
    # /etc/init.d/amdemon start
    
  4. Do you have a failed controller?

    • If your controller module is offline, but does not have a failed controller, proceed to Step 5.

    • If you have a failed controller, replace the failed controller with a new controller. Do not bring the controller online.

      For the procedure about how to replace controllers, see the Sun StorEdge A3500/A3500FC Controller Module Guide and the Sun StorEdge RAID Manager Installation and Support Guide for additional considerations.

  5. On one node, use the RAID Manager GUI's Recovery application to restore the controller online.


    Note –

    You must use the RAID Manager GUI's Recovery application to bring the controller online. Do not use the Redundant Disk Array Controller Utility (rdacutil) because this utility ignores the value of the System_LunReDistribution parameter in the /etc/raid/rmparams file.


    For information about the Recovery application, see the Sun StorEdge RAID Manager User’s Guide. If you have problems with bringing the controller online, see the Sun StorEdge RAID Manager Installation and Support Guide.

  6. On one node that is connected to the storage array or storage system, verify that the controller has the correct SCSI reservation state.

    Run the scdidadm(1M) repair option (-R) on LUN 0 of the controller you want to bring online.


    # scdidadm -R /dev/dsk/cNtXdY
    
  7. (StorEdge A3500 Only) Set the controller to active/active mode. Assign LUNs to the controller.

    For more information about controller modes, see the Sun StorEdge RAID Manager Installation and Support Guide and the Sun StorEdge RAID Manager User’s Guide.

  8. (StorEdge A3500 Only) Reset the System_LunReDistribution parameter in the /etc/raid/rmparams file to true.

    For the procedure about how to change the rmparams file, see the Sun StorEdge RAID Manager Installation and Support Guide.

  9. (StorEdge A3500 Only) Restart the RAID Manager daemon.


    # /etc/init.d/amdemon stop
    # /etc/init.d/amdemon start
    

ProcedureHow to Upgrade Controller Module Firmware

Use either the online or the offline method to upgrade your NVSRAM firmware. The method that you choose depends on your firmware.

Before You Begin

This procedure assumes that your cluster is operational

Steps
  1. Are you upgrading the NVSRAM firmware file?

    • If you are not upgrading the NVSRAM file, you can use the online method.

      Upgrade the firmware by using the online method, as described in the Sun StorEdge RAID Manager User’s Guide. No special steps are required for a cluster environment.

    • If you are upgrading the NVSRAM file, you must use an offline method. Use one of the following procedures.

      • If the data on your controller module is mirrored on another controller module, use the procedure in Step 2.

      • If the data on your controller module is not mirrored on another controller module, use the procedure in Step 3.

  2. Use this step if you are upgrading the NVSRAM and other firmware files on a controller module. This controller module must have mirrored data.

    1. Halt all activity to the controller module.

      For more information, see your Solstice DiskSuite/Solaris Volume Manager or VERITAS Volume Manager documentation.

    2. Update the firmware files by using the offline method, as described in the Sun StorEdge RAID Manager User’s Guide.

    3. Restore all activity to the controller module.

      For more information, see your Solstice DiskSuite/Solaris Volume Manager or VERITAS Volume Manager documentation.

      This step completes the firmware upgrade.

  3. Use this step if you are upgrading the NVSRAM and other firmware files on a controller module. This controller module must not have mirrored data.

    1. Shut down the entire cluster.

      For the procedure about how to shut down a cluster, see your Sun Cluster system administration documentation.

    2. Boot one node that is attached to the controller module into noncluster mode.

      For the procedure about how to boot a node in noncluster mode, see your Sun Cluster system administration documentation. For a list of Sun Cluster documentation, see Related Documentation.

    3. Update the firmware files by using the offline method, as described in the Sun StorEdge RAID Manager User’s Guide.

    4. Boot both nodes into cluster mode.

      For more information about how to boot nodes, see your Sun Cluster system administration documentation. For a list of Sun Cluster documentation, see Related Documentation.

      This step completes the firmware upgrade.

ProcedureHow to Add a Disk Drive

Adding a disk drive enables you to increase your storage space after a storage array has been added to your cluster.


Caution – Caution –

If the disk drive that you are adding was previously owned by another controller module, reformat the disk drive to wipe clean the old DacStore information before adding the disk drive to this storage array. If any old DacStore information remains, it can cause aberrant behavior including the appearance of ghost disks or LUNs in the RAID Manager interfaces.


Before You Begin

This procedure relies on the following prerequisites and assumptions.

Steps
  1. Verify that the new disk drive is formatted.

    For information about how to move drives between storage arrays, see the Sun StorEdge RAID Manager Release Notes.

  2. Install the new disk drive to the storage array.

    For the procedure about how to install a disk drive, see your storage documentation. For a list of storage documentation, see Related Documentation.

  3. Enable the disk drive to spin up approximately 30 seconds.

  4. Run Health Check to ensure that the new disk drive is not defective.

    For instructions about how to run Recovery Guru and Health Check, see the Sun StorEdge RAID Manager User’s Guide.

  5. Fail the new drive, then revive the drive to update DacStore on the drive.

    For the procedure about how to fail and revive drives, see the Sun StorEdge RAID Manager User’s Guide.

  6. Repeat Step 1 through Step 5 for each disk drive you are adding.

See Also

To create LUNs for the new drives, see How to Create a LUN for more information.

ProcedureHow to Replace a Disk Drive

Removing a disk drive enables you to reduce or reallocate your existing storage pool. You might want to perform this procedure if a disk has failed or is behaving in an unreliable manner.

For conceptual information about quorum, quorum devices, global devices, and device IDs, see your Sun Cluster concepts documentation. For a list of Sun Cluster documentation, see Related Documentation.

Before You Begin

This procedure relies on the following prerequisites and assumptions.

Steps
  1. Does replacing the disk drive affect any LUN's availability?

    • If no, proceed to Step 2.

    • If yes, remove the LUNs from volume management control. For more information, see your Solstice DiskSuite/Solaris Volume Manager or VERITAS Volume Manager documentation.

  2. Replace the disk drive in the storage array.

    For the procedure about how to replace a disk drive, see your storage documentation. For a list of storage documentation, see Related Documentation.

  3. Run Health Check to ensure that the new disk drive is not defective.

    For the procedure about how to run Recovery Guru and Health Check, see the Sun StorEdge RAID Manager User’s Guide.

  4. Does the failed drive belong to a drive group?

    • If the drive does not belong to a device group, proceed to Step 5.

    • If the drive is part of a device group, reconstruction is started automatically. If reconstruction does not start automatically for any reason, then select Reconstruct from the Manual Recovery application. Do not select Revive. When reconstruction is complete, skip to Step 6.

  5. Fail the new drive, then revive the drive to update DacStore on the drive.

    For the procedure about how to fail and revive drives, see the Sun StorEdge RAID Manager User’s Guide.

  6. If you removed LUNs from volume management control in Step 1, return the LUNs to volume management control.

    For more information, see your Solstice DiskSuite/Solaris Volume Manager or VERITAS Volume Manager documentation.

ProcedureHow to Remove a Disk Drive

Removing a disk drive enables you to reduce or reallocate your existing storage pool. You might want to perform this procedure in the following scenarios.

For conceptual information about quorum, quorum devices, global devices, and device IDs, see your Sun Cluster concepts documentation.

Before You Begin

This procedure relies on the following prerequisites and assumptions.

Steps
  1. Is the logical unit number (LUN) that is associated with the disk drive a quorum device? This disk drive is the disk drive that you are removing.


    Note –

    Your storage array or storage system might not support LUNs as quorum devices. To determine if this restriction applies to your storage array or storage system, see Restrictions and Requirements.



    # scstat -q
    
    • If no, proceed to Step 2.

    • If yes, relocate that quorum device to another suitable storage array.

      For procedures about how to add and remove quorum devices, see your Sun Cluster system administration documentation.

  2. Remove the LUN that is associated with the disk drive you are removing.

    For the procedure about how to remove a LUN, see How to Delete a LUN.

  3. Remove the disk drive from the storage array.

    For the procedure about how to remove a disk drive, see your storage documentation. For a list of storage documentation, see Related Documentation.


    Caution – Caution –

    After you remove the disk drive, install a dummy drive to maintain proper cooling.


How to Upgrade Disk Drive Firmware


Caution – Caution –

You must be a Sun service provider to perform disk drive firmware updates. If you need to upgrade drive firmware, contact your Sun service provider.


ProcedureHow to Replace a Host Adapter


Note –

Several steps in this procedure require you to halt I/O activity. To halt I/O activity, take the controller module offline by using the RAID Manager GUI's manual recovery procedure in the Sun StorEdge RAID Manager User’s Guide.


Before You Begin

This procedure relies on the following prerequisites and assumptions.

Steps
  1. Determine the resource groups and device groups that are running on Node A.


    # scstat
    

    Record this information because you will use it in Step 23of this procedure to return resource groups and device groups to this node.

  2. Move all resource groups and device groups off Node A.


    # scswitch -s -h from-node
    
  3. Without powering off the node, shut down Node A.

    For the procedure about how to shut down and power off a node, see your Sun Cluster system administration documentation. For a list of Sun Cluster documentation, see Related Documentation.

  4. From Node B, halt I/O activity to SCSI bus A.

    For instructions, see the Sun StorEdge RAID Manager User’s Guide.

  5. From the controller module end of the SCSI cable, disconnect the SCSI bus A cable. This cable connects the controller module to Node A. Afterward, replace this cable with a differential SCSI terminator.

  6. Restart I/O activity on SCSI bus A.

    For instructions, see the Sun StorEdge RAID Manager User’s Guide.

  7. Does servicing the failed host adapter affect SCSI bus B?

  8. From Node B, halt I/O activity to the controller module on SCSI bus B.

    For instructions, see the Sun StorEdge RAID Manager User’s Guide.

  9. From the controller module end of the SCSI cable, disconnect the SCSI bus B cable. This cable connects the controller module to Node A. Afterward, replace this cable with a differential SCSI terminator.

  10. Restart I/O activity on SCSI bus B.

    For instructions, see the Sun StorEdge RAID Manager User’s Guide.

  11. Power off Node A.

  12. Replace Node A's host adapter.

    For the procedure about how to replace a host adapter, see the documentation that shipped with your node hardware.

  13. Power on Node A. Do not enable the node to boot. If necessary, halt the system.

  14. From Node B, halt I/O activity to the controller module on SCSI bus A.

    For instructions, see the Sun StorEdge RAID Manager User’s Guide.

  15. Remove the differential SCSI terminator from SCSI bus A. Afterward, reinstall the SCSI cable to connect the controller module to Node A.

  16. Restart I/O activity on SCSI bus A.

    For instructions, see the Sun StorEdge RAID Manager User’s Guide.

  17. Did you install a differential SCSI terminator to SCSI bus B in Step 9?

    • If no, skip to Step 20.

    • If yes, halt I/O activity on SCSI bus B, then continue with Step 18.

  18. Remove the differential SCSI terminator from SCSI bus B. Afterward, reinstall the SCSI cable to connect the controller module to Node A.

  19. Restart I/O activity on SCSI bus B.

    For instructions, see the Sun StorEdge RAID Manager User’s Guide.

  20. Bring the controller module online.

    For instructions, see the Sun StorEdge RAID Manager User’s Guide.

  21. Rebalance all logical unit numbers (LUNs).

    For instructions, see the Sun StorEdge RAID Manager User’s Guide.

  22. Boot Node A into cluster mode.

  23. (Optional) Return resource groups and device groups to Node A.