test

Open HA Cluster Installation Guide

Chapter 4 Uninstalling Software From the Cluster

This chapter provides procedures for uninstalling an Open HA Cluster configuration. The following procedures are in this chapter:

Uninstalling the Software

This section provides procedures to uninstall Open HA Cluster 2009.06 software from a cluster.

ProcedureHow to Uninstall Open HA Cluster Software

Perform this procedure to uninstall Open HA Cluster 2009.06 software from the node. If the node is a configured member of a cluster, this procedure also removes the node from the cluster configuration.

Note –

Do not use the pkg uninstall command to remove Open HA Cluster 2009.06 software from cluster nodes. Use only the scinstall -r command to ensure that all cluster packages, including any that were installed by explicit command, and any cluster configuration information is completely removed from the node.

  1. Add to the cluster's node-authentication list each node that you intend to unconfigure.

    If you are removing software from a node that is not a configured member of a cluster, skip to Step 2.

    1. On an active cluster member other than the node that you are unconfiguring, become superuser.

      Alternatively, if your user account is assigned the Primary Administrator profile, execute commands as non-root through a profile shell, or prefix the command with the pfexec command.

    2. Specify the name of the node to add to the authentication list.

      • To add a single node, use the following command:


        phys-schost# /usr/cluster/bin/claccess allow -h nodename
        -h nodename

        Specifies the name of the node to add to the authentication list.

      • To add all nodes, use the following command:


        phys-schost# /usr/cluster/bin/claccess allow-all

      For more information, see the claccess(1CL) man page.

      You can alternatively use the clsetup utility to perform this task. See How to Add a Node to the Authorized Node List in Sun Cluster System Administration Guide for Solaris OS for procedures.

  2. On the node that you intend to unconfigure, become superuser.

    Alternatively, if your user account is assigned the Primary Administrator profile, execute commands as non-root through a profile shell, or prefix the command with the pfexec command.

  3. Shut down the node.


    phys-schost# shutdown -g0 -y -i0

  4. Reboot the node into noncluster mode.

    • On SPARC based systems, perform the following command:


      ok boot -x

    • On x86 based systems, perform the following commands:

      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.97 (639K lower / 1047488K upper memory)
+----------------------------------------------------------------------+
| OpenSolaris 2009.06                                                  |
| OHAC-2009-06                                                         |
|                                                                      |
+----------------------------------------------------------------------+
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.97 (639K lower / 1047488K upper memory)
+----------------------------------------------------------------------+
|…                                                                   |
| kernel /platform/i86pc/kernel/$ISADIR/unix -B $ZFS-BOOTFS,console=gr>|
|…                                                                   |
+----------------------------------------------------------------------+
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 -x 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/kernel/$ISADIR/unix \
-B $ZFS-BOOTFS,console=graphics -x

      4. Press Enter to accept the change and return to the boot parameters screen.

        The screen displays the edited command.

      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 add the -x option to the kernel boot parameter command.

  5. Change to a directory, such as the root (/) directory, that does not contain any files that are delivered by the Open HA Cluster packages.


    phys-schost# cd /

  6. Remove the node from the cluster configuration.


    phys-schost# /usr/cluster/bin/scinstall -r

    The node is removed from the cluster configuration and Open HA Cluster software is removed from the node. For more information, see the scinstall(1M) man page.

  7. Repeat Step 2 through Step 6 for any additional node to unconfigure.

Next Steps

To physically remove the node from the cluster, see How to Remove an Interconnect Component in Sun Cluster 3.1 - 3.2 Hardware Administration Manual for Solaris OS and the removal procedure in the appropriate Sun Cluster Hardware Administration Collection manual for your storage array.

ProcedureHow to Remove Quorum Server Software

Before You Begin

Before you uninstall Quorum Server software, ensure that you have completed the following tasks:

  1. Become superuser on the quorum server host computer to uninstall.

    Alternatively, if your user account is assigned the Primary Administrator profile, execute commands as non-root through a profile shell, or prefix the command with the pfexec command.

  2. Uninstall the quorum-server software.


    quorumserver# /usr/bin/pkg uninstall ha-cluster-quorum-server-full

  3. (Optional) Clean up or remove the quorum server directories.

    By default, this directory is /var/scqsd.