Maintaining Storage Systems

This section contains the procedures about how to maintain a storage system in a Sun Cluster environment.

Some maintenance procedures in Table 1–3 are performed in the same way as in a noncluster environment. This section references these procedures, but this section does not contain these procedures. Table 1–3 lists the procedures about how to maintain a storage system.

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.

StorEdge A3500FC System FRUs

With the exception of one instruction, 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.

• Replacing a power cord that connects to the cabinet power distribution unit (see the Sun StorEdge Expansion Cabinet Installation and Service Manual).

• Replacing a power cord to a storage array (see the Sun StorEdge A1000 and D1000 Installation, Operations, and Service Manual).

• Replacing the power supply housing.

• Replacing the battery unit.

• Replacing a DC-power or battery harness.

• Replacing a controller module assembly.

• Replacing a controller module power cord.

• Replacing a controller module card cage.

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.

• Replacing a storage array-to-host SCSI cable.

• Replacing a controller module fan canister.

• Replacing the power supply fan canister.

• Replacing a SCSI cable from the controller module to the storage array.

• Replacing a storage array-to-host or storage array–to-hub fiber-optic cable.

• Replacing an FC hub (see the Sun StorEdge FC-100 Hub Installation and Service Manual).

• Replacing an FC hub gigabit interface converters (GBIC) or Small Form-Factor Pluggable (SFP) that connects cables to the host or hub.

• Replacing a GBIC or an SFP on a node.

• Replacing an FC switch.

How to Remove a Storage System

Use this procedure to remove a storage system from a running cluster.

This procedure removes all data that is on the storage system you remove.

Steps

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

2. Halt all activity to the controller module.

   For instructions, see the Sun StorEdge RAID Manager User’s Guide and your operating system documentation.

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

   • If no, proceed to Step 4.

   • 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 from VERITAS Volume Manager control before you can delete the LUNs.

     # vxdisk offline cNtXdY # vxdisk rm cNtXdY

4. Disconnect all cables from the storage system. Remove the hardware from your cluster.

5. From one node, delete the LUN.

   For the procedure about how to delete a LUN, see the Sun StorEdge RAID Manager User’s Guide.

6. Remove the paths to the LUNs you are deleting.

   # rm /dev/rdsk/cNtXdY* # rm /dev/dsk/cNtXdY* # rm /dev/osa/dev/dsk/cNtXdY* # rm /dev/osa/dev/rdsk/cNtXdY*

7. Use the lad command to determine the alternate paths to the LUNs 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, with this configuration.

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

   The alternate paths would be the following.

   /dev/osa/dev/dsk/c1t4d1* /dev/osa/dev/rdsk/c1t4d1*

8. Remove the alternate paths to the LUNs you are deleting.

   # rm /dev/osa/dev/dsk/cNtXdY* # rm /dev/osa/dev/rdsk/cNtXdY*

9. On all nodes, remove references to the storage system.

   # scdidadm -C

10. Are you are removing the last StorEdge A3500FC controller module from a hub or FC switch in your cluster?

    • If no, proceed to Step 12.

    • If yes, remove the hub or FC switch hardware and cables from your cluster.

      ---

      Note –

      If you are using your StorEdge A3500FC storage array in a SAN-configured cluster, you must keep two FC switches configured in parallel. This configuration maintains cluster availability. See SAN Solutions in a Sun Cluster Environment in Sun Cluster 3.0-3.1 Hardware Administration Manual for Solaris OS for more information.

      ---

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 there are no other parallel SCSI devices connected to the nodes, you can delete the contents of the nvramrc script and, at the OpenBoot PROM, set setenv use-nvramrc? false.

    ---

12. Remove any unused host adapter from nodes that were attached to the 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.

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

13. Switch the cluster back online.

    # scswitch -Z

14. Are you removing the last storage system from your cluster?

    • If no, you are finished with this procedure.

    • If yes, remove software packages. For the procedure about how to remove software packages, see the documentation that shipped with your storage system.

How to Replace a Failed Controller or Restore an Offline Controller

Use this procedure to replace a controller, or to restore an offline controller.

For conceptual information on SCSI reservations and failure fencing, see your Sun Cluster concepts documentation.

If you want to create a SAN by using two FC switches and Sun SAN software, see SAN Solutions in a Sun Cluster Environment in Sun Cluster 3.0-3.1 Hardware Administration Manual for Solaris OS for more information. .

Steps

1. 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 –

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

2. Restart the RAID Manager daemon.

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

3. Do you have a failed controller?

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

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

4. 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 on 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.

5. On one node that is connected to the 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

6. Set the controller to active/active mode. Assign LUNs to the controller.

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

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

8. Restart the RAID Manager daemon.

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

How to Upgrade Controller Module Firmware in a Running Cluster

Use this procedure to upgrade firmware in a controller module in a running cluster. Use either the online or the offline method to upgrade your NVSRAM firmware. The method that you choose depends on your firmware.

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.

   3. Update the firmware files using the offline method, as described in the 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.

      This step completes the firmware upgrade.

How to Add a Disk Drive in a Running Cluster

Use this procedure to add a disk drive to a storage array that is in a running cluster.

If the disk drive that you are adding was previously owned by another controller module, reformat the disk drive. Reformat the disk drive to wipe clean the old DacStore information before adding the disk drive to this storage array.

Steps

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

   For the procedure about how to install a disk drive, see the Sun StorEdge D1000 Storage Guide.

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

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

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

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

5. Repeat Step 1 through Step 4 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.

How to Replace a Failed Disk Drive in a Running Cluster

Use this procedure to replace a failed disk drive in a running cluster.

Steps

1. Does replacing the disk drive affects 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 the Sun StorEdge D1000 Storage Guide.

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.

How to Remove a Disk Drive From a Running Cluster

Use this procedure to remove a disk drive from a running cluster.

Steps

1. Remove the logical unit number (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.

2. Remove the disk drive from the storage array.

   For the procedure about how to remove a disk drive, see the Sun StorEdge D1000 Storage Guide.

   ---

   Caution –

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

   ---

How to Upgrade Disk Drive Firmware in a Running Cluster

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.

How to Replace a Host Adapter

Use this procedure to replace a failed host adapter in a running cluster. This procedure defines Node A as the node with the failed host adapter that you are replacing.

Before You Begin

This procedure relies on the following prerequisites and assumptions.

• Except for the failed host adapter, your cluster is operational and all nodes are powered on.

• Your nodes are not configured with dynamic reconfiguration functionality.

  If your nodes are configured for dynamic reconfiguration and you are using two entirely separate hardware paths to your shared data, see the Sun Cluster Hardware Administration Manual for Solaris OS and skip steps that instruct you to shut down the cluster.

  You cannot replace a single, dual-port HBA that has quorum configured on that storage path by using DR. Follow all steps in the procedure. For the details on the risks and limitations of this configuration, see Configuring Cluster Nodes With a Single, Dual-Port HBA in Sun Cluster 3.0-3.1 Hardware Administration Manual for Solaris OS.

  Exceptions to this restriction include three-node or larger cluster configurations where no storage device has a quorum device configured.

Steps

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

   Record this information because you use this information in Step 12 of this procedure to return resource groups and device groups to Node A.

   # scstat

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

   # scswitch -S -h nodename

3. Halt all I/O activity on the affected controller module.

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

4. Shut down Node A.

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

5. Power off Node A.

6. Replace the failed host adapter.

   For the procedure about how to remove and add host adapters, see the documentation that shipped with your nodes.

7. Do you need to upgrade the node's host adapter firmware?

   • If yes, boot Node A into noncluster mode. Proceed to Step 8.

     For more information about how to boot nodes, see your Sun Cluster system administration documentation.

   • If no, proceed to Step 9.

8. Upgrade the host adapter firmware on Node A.

   PatchPro is a patch-management tool that eases the selection and download of patches required for installation or maintenance of Sun Cluster software. PatchPro provides an Interactive Mode tool especially for Sun Cluster. The Interactive Tool makes the installation of patches easier. PatchPro's Expert Mode tool helps you to maintain your configuration with the latest set of patches. Expert Mode is especially useful for obtaining all of the latest patches, not just the high availability and security patches.

   To access the PatchPro tool for Sun Cluster software, go to http://www.sun.com/PatchPro/, click Sun Cluster, then choose either Interactive Mode or Expert Mode. Follow the instructions in the PatchPro tool to describe your cluster configuration and download the patches.

   For third-party firmware patches, see the SunSolve^SM Online site at http://sunsolve.ebay.sun.com.

9. Boot Node A into cluster mode.

   For more information about how to boot nodes, see your Sun Cluster system administration documentation.

10. Restart I/O activity on the affected controller module.

    For instructions, see the Sun StorEdge RAID Manager User's Guide and your operating system documentation.

11. Rebalance LUNs that are running on the affected controller module.

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

12. Return the resource groups and device groups you identified in Step 1 to Node A.

    # scswitch -z -g resource-group -h nodename # scswitch -z -D device-group-name -h nodename

    For more information, see your Sun Cluster system administration documentation.