Sun Cluster System Administration Guide for Solaris OS

ProcedureHow to Apply a Rebooting Patch (Cluster)

With this procedure, you must first the cluster and boot each node to single-user mode by using the boot -sx or shtudown -g -y -i0 command, before applying the patch.

  1. Before applying the patch, check the Sun Cluster product web site for any special preinstallation or postinstallation instructions.

  2. Become superuser on any node in the cluster.

  3. Shut down the cluster.


    # cluster shutdown -y -g grace-period message
    
    -y

    Specifies to answer yes to the confirmation prompt.

    -g grace-period

    Specifies, in seconds, the amount of time to wait before shutting down. Default grace period is 60 seconds.

    message

    Specifies the warning message to broadcast. Use quotes if message contains multiple words.

  4. Boot each node into noncluster, single-user mode.

    On the console of each node, run the following commands.

    • On SPARC based systems, run the following command.


      ok boot -sx
      
    • On x86 based systems, run the following commands.


      phys-schost# shutdown -g -y -i0
      
      Press any key to continue
    1. In the GRUB menu, use the arrow keys to select the appropriate Solaris entry and type e to edit its commands.

      The GRUB menu appears similar to the following:


      GNU GRUB version 0.95 (631K lower / 2095488K upper memory)
      +-------------------------------------------------------------------------+
      | Solaris 10 /sol_10_x86                                                  |
      | Solaris failsafe                                                        |
      |                                                                         |
      +-------------------------------------------------------------------------+
      Use the ^ and v keys to select which entry is highlighted.
      Press enter to boot the selected OS, 'e' to edit the
      commands before booting, or 'c' for a command-line.

      For more information about GRUB based booting, see Booting an x86 Based System by Using GRUB (Task Map) in System Administration Guide: Basic Administration.

    2. In the boot parameters screen, use the arrow keys to select the kernel entry and type e to edit the entry.

      The GRUB boot parameters screen appears similar to the following:


      GNU GRUB version 0.95 (615K lower / 2095552K upper memory)
      +----------------------------------------------------------------------+
      | root (hd0,0,a)                                                       |
      | kernel /platform/i86pc/multiboot                                     |
      | module /platform/i86pc/boot_archive                                  |
      +----------------------------------------------------------------------+
      Use the ^ and v keys to select which entry is highlighted.
      Press 'b' to boot, 'e' to edit the selected command in the
      boot sequence, 'c' for a command-line, 'o' to open a new line
      after ('O' for before) the selected line, 'd' to remove the
      selected line, or escape to go back to the main menu.
    3. Add -sx to the command to specify that the system boot into noncluster mode.


      [ Minimal BASH-like line editing is supported. For the first word, TAB
      lists possible command completions. Anywhere else TAB lists the possible
      completions of a device/filename. ESC at any time exits. ]
      
      grub edit> kernel /platform/i86pc/multiboot -sx
    4. Press the Enter key to accept the change and return to the boot parameters screen.

      The screen displays the edited command.


      GNU GRUB version 0.95 (615K lower / 2095552K upper memory)
      +----------------------------------------------------------------------+
      | root (hd0,0,a)                                                       |
      | kernel /platform/i86pc/multiboot -sx                                  |
      | module /platform/i86pc/boot_archive                                  |
      +----------------------------------------------------------------------+
      Use the ^ and v keys to select which entry is highlighted.
      Press 'b' to boot, 'e' to edit the selected command in the
      boot sequence, 'c' for a command-line, 'o' to open a new line
      after ('O' for before) the selected line, 'd' to remove the
      selected line, or escape to go back to the main menu.-
    5. Type b to boot the node into noncluster mode.


      Note –

      This change to the kernel boot parameter command does not persist over the system boot. The next time you reboot the node, it will boot into cluster mode. To boot into noncluster mode instead, perform these steps to again to add the -sx option to the kernel boot parameter command.


  5. Apply the software or firmware patch.

    On one node at a time, run the following command.


    # patchadd -M patch-dir patch-id
    
    patch-dir

    Specifies the directory location of the patch.

    patch-id

    Specifies the patch number of a given patch.


    Note –

    Always defer to the instructions in the patch directory that supersede procedures in this chapter.


  6. Verify that the patch has been installed successfully on each node.


    # showrev -p | grep patch-id
    
  7. After applying the patch to all nodes, reboot the nodes into the cluster.

    On each node, run the following command.


    # reboot
    
  8. Check to see if you need to commit the patch software by using the scversions command.


    # /usr/cluster/bin/scversions
    

    You will see one of the following results:


    Upgrade commit is needed.
    
    Upgrade commit is NOT needed. All versions match.
  9. If a commit is needed, commit the patch software.


    # scversions -c
    

    Note –

    Running scversions will cause one or more CMM reconfigurations, depending on the situation.


  10. Verify that the patch works, and that the nodes and cluster are operating normally.


Example 10–2 Applying a Rebooting Patch (Cluster)

The following example shows the application of a rebooting Sun Cluster patch to a cluster.


# cluster shutdown -g0 -y
...

Boot the cluster in noncluster, single-user mode.


...
# patchadd -M /var/tmp/patches 234567-05
(Apply patch to other cluster nodes)
...
# showrev -p | grep 234567-05
# reboot
# scversions
Upgrade commit is needed.
# scversions -c

See Also

If you need to back out a patch, see Changing a Sun Cluster Patch.