Sun Cluster System Administration Guide for Solaris OS

How to Apply a Rebooting Patch (Node)

Apply the patch to one node in the cluster at a time to keep the cluster itself operational during the patch process. With this procedure, you must first shut down the node and boot it to single-user mode using the boot -sx or b -sxcommand, before applying the patch.

  1. Before applying the patch, check the Sun Cluster product web page for any special pre- or post-installation instructions.

  2. Become superuser on the node to which you are applying the patch.

  3. List the resource groups and device groups on the node being patched.


    # scrgadm -pv
    # scstat
    

  4. Switch all resource groups, resources, and device groups from the node being patched to other cluster members.


    # scswitch -S -h node[,...]
    

    -S

    Evacuates all device groups and resource groups from the specified node.

    -h node[,...]

    Specifies the node from which you are switching the resource groups and device groups.

  5. Shut down the node.


    # shutdown -g0 [-y] [-i0]

  6. Boot the node in non-cluster, single-user mode.

    • SPARC:


      ok boot -sx
      

    • x86:


                            <<< Current Boot Parameters >>>
      Boot path: /pci@0,0/pci8086,2545@3/pci8086,1460@1d/pci8086,341a@7,1/
      sd@0,0:a
      Boot args:
      
      Type    b [file-name] [boot-flags] <ENTER>  to boot with options
      or      i <ENTER>                           to enter boot interpreter
      or      <ENTER>                             to boot with defaults
      
                        <<< timeout in 5 seconds >>>
      Select (b)oot or (i)nterpreter: b -sx
      

  7. Apply the patch.


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


  8. Reboot the node into the cluster.


    # reboot
    

  9. Verify that the patch has been installed successfully.


    # showrev -p | grep patch-id
    

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

  11. Repeat Step 2 through Step 10 for all remaining cluster nodes.

  12. Switch resource groups, resources, and device groups as needed.

    After rebooting all the nodes, the last node rebooted will not have the resource groups and device groups online.


    # scswitch -z -D  device-group[,...]-h node[,...]
    # scswitch -z -g  resource-group[,...]-h nod[,...]e
    

    -z

    Specifies the change in mastery of a resource group or device group.

    -h node[,...]

    Specifies the nodes to which you are switching the resource groups and device groups.

    -D

    Switches the specified device groups to the nodes identified by the -h option.

    -g

    Switches the specified resource groups to the nodes identified by the -h option. If -h is not specified, the resource groups are taken offline.

Example—Applying a Rebooting Patch (Node)

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


# scrgadm -pv
...
RG Name: schost-sa-1
...
# scstat
...
Device Group Name:											dg-schost-1
...
# scswitch -S -h phys-schost-2
# shutdown -g0 -y -i0
...

Boot the node in non-cluster, single-user mode.


...
# patchadd -M /tmp/patches 234567-05
...
# reboot
...
# showrev -p | grep 234567-05
# scswitch -z -D dg-schost-1 -h phys-schost-1
# scswitch -z -g schost-sa-1 -h phys-schost-1

Where to Go From Here

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