test

Sun Cluster 2.2 System Administration Guide

11.5.1 How to Change a SPARCstorage Array World Wide Name Using a Maintenance System

This procedure describes how to change a SPARCstorage Array controller and replace its WWN with the WWN of the failed controller. This procedure enables you to replace a SPARCstorage Array controller without taking down any nodes in the cluster.

This procedure makes use of a "maintenance system," which can be any Sun Microsystems architecture capable of supporting a SPARCstorage Array. The presence of a maintenance system enables you to complete this procedure without taking down any nodes in the cluster.

This system should be loaded with the same version of the Solaris Operating Environment (2.6 or 7) as the cluster nodes, and should have all applicable patches. It also should have available a CD-ROM drive, a Fibre Channel SBus Card (FC/S), and a Fibre Channel Optical Module (FC/OM). The system should have the proper FCODE and hardware revisions. Alternately, you can boot the maintenance system over the net.

Note -

If a "maintenance system" is not available, use one of the cluster nodes for this purpose by following the steps in this procedure.

These are the high-level steps to change a SPARCstorage Array World Wide Name (WWN) using a maintenance system:

These are the detailed steps to change a SPARCstorage Array World Wide Name by using a maintenance system.

  1. If the failed SPARCstorage Array controller is the quorum controller, select a new quorum controller by using the scconf(1M) command.

    Refer to the scconf(1M) man page for more information.

  2. Determine the WWN of the broken SPARCstorage Array.

    • If the SPARCstorage Array is powered down, use the following instructions to obtain the WWN.

      The WWN is composed of 12 hexadecimal digits. The digits are shown as part of the device path component. They are the last 12 digits following the characters pln@a0, excluding the comma. Use the ls(1) command on a cluster node connected to the SSA to identify the current WWN.

    # ls -l /dev/rdsk/cNt0d0s0
...SUNW,pln@a0000000,7412bf ...

    In this example, the WWN for the SPARCstorage Array being replaced is 0000007412bf. The variable N in the device name represents the controller number for the broken SPARCstorage Array. The string "t0d0s0" is just an example. Use a device name that you know exists on the SPARCstorage Array, or use /dev/rdsk/cN* to match all devices.

    • If the SPARCstorage Array is up and running, you can obtain the WWN by using the luxadm(1M) command.

      When you run luxadm(1M) with the display option and specify a controller, all the information about the SPARCstorage Array is displayed. The serial number reported by luxadm(1M) is the WWN.

    # /usr/sbin/luxadm display cN

  3. Detach the optical cable from the faulty SPARCstorage Array Controller.

  4. Replace the faulty controller.

    Use the instructions in your SPARCstorage Array service manual to perform this step.

    If the SPARCstorage Array has not failed entirely or is being swapped for a reason other than controller failure, prepare for the swap by performing the steps described in "11.4 Administering SPARCstorage Array Trays", for each tray in the SPARCstorage Array.

    If the SPARCstorage Array controller has failed entirely, your volume manager has already prepared for the swap.

  5. Attach the optical cable from the maintenance system to the new controller.

  6. Enter the OpenBoot PROM on the maintenance system and boot it with "mini-unix."

    Do this from the distribution CD (or its network equivalent) to put the maintenance system into single-user mode and to obtain an in-memory version of the device structure that contains the new SPARCstorage Array WWN.

    <#0> ok boot cdrom -s

 or

 <#0> ok boot netqe1 -s

    Use "mini-unix" to avoid making any permanent device information changes.

  7. Run the luxadm download command to set the WWN. 

    # /usr/sbin/luxadm -s -w WWN download cN

    WWN is the 12-digit WWN of the replaced controller and N is the controller number from cNtXdX in the device name. You should have obtained the WWN in Step 2.

    Note -

    The leading zeros must be entered as part of the WWN to make a total of 12 digits.

    Caution - Caution -

    Do not interrupt the download process. Wait for the shell prompt after completion of the luxadm(1M)command.

  8. After the prompt is redisplayed, reset the SSA.

    The new address should appear in the window on the SPARCstorage Array.

  9. Shut down the maintenance system.

  10. Reattach the SPARCstorage Array controller to the cluster nodes.

  11. Verify the SPARCstorage Array firmware level from the cluster node.

    Use the luxadm(1M) command to determine the current version of the firmware. Specify the controller number (N in the example) to the luxadm(1M) command. 

    # /usr/sbin/luxadm display cN
    Note -

    If the Solaris system detects an old version of firmware on your system, it displays a message on the console and in /var/adm/messages similar to the following: 


    NOTICE: pln0: Old SSA firmware has been detected (Ver:3.11) : 
Expected (Ver:3.12) - Please upgrade

  12. (Optional) To upgrade the controller's firmware, follow these steps.

    1. Download the proper firmware. Refer to the README file in the firmware patch for details.

      # /usr/sbin/ssaadm download -f path/ssafirmware cN

      where path is the path to the directory where the firmware is stored and N is the controller number. For example: 

      # /usr/sbin/ssaadm download -f /usr/lib/firmware/ssa/ssafirmware cN

    2. Reset the SPARCstorage Array by pressing the SYS OK button on the unit.

      There will be a short delay while the unit reboots.

    3. Verify the firmware level again (using Step 11). If the firmware level or WWN is still incorrect, repeat Step 12 using a different controller.

  13. Begin volume manager recovery.

    Refer to "11.4 Administering SPARCstorage Array Trays". Wait until the SPARCstorage Array is online for all nodes, and all nodes can see all the disks.