Sun Cluster Software Installation Guide for Solaris OS

ProcedureHow to Unconfigure Sun Cluster Software to Correct Installation Problems

Perform this procedure if the installed node cannot join the cluster or if you need to correct configuration information. For example, perform this procedure on all nodes to reconfigure the transport adapters or the private-network address.


Note –

If the node has already joined the cluster and is no longer in installation mode, as described in Step 2 of How to Verify the Quorum Configuration and Installation Mode, do not perform this procedure. Instead, go to How to Uninstall Sun Cluster Software From a Cluster Node in Sun Cluster System Administration Guide for Solaris OS.


Before You Begin

Attempt to rerun cluster configuration of the node by using the scinstall utility. You can correct certain cluster node configuration failures by repeating Sun Cluster software configuration on the node.

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

    If you are unconfiguring a single-node cluster, skip to Step 2.

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

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


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

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

      You can also 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 a node that you intend to unconfigure, become superuser.

  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)
        +----------------------------------------------------------------------+
        | 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.97 (639K lower / 1047488K 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 -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/multiboot -x
        
      4. Press Enter to accept the change and return to the boot parameters screen.

        The screen displays the edited command.


        GNU GRUB version 0.97 (639K lower / 1047488K upper memory)
        +----------------------------------------------------------------------+
        | root (hd0,0,a)                                                       |
        | kernel /platform/i86pc/multiboot -x                                  |
        | 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 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 Sun Cluster packages.


    phys-schost# cd /
    
  6. Remove the node from the cluster configuration.


    phys-schost# /usr/cluster/bin/clnode remove
    

    The node is removed from the cluster configuration but Sun Cluster software is not removed from the node.

    See the clnode(1CL) man page for more information.

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

  8. (Optional) Uninstall Sun Cluster framework and data service software packages.


    Note –

    If you do not need to remove or reinstall Sun Cluster software, you can skip this step.


    This step also removes the Sun Cluster entry from the Sun Java Enterprise System (Java ES) product registry. If the Java ES product registry contains a record that Sun Cluster software is installed, the Java ES installer will show the Sun Cluster component grayed out and will not permit reinstallation.

    1. Start the uninstall program.

      Run the following command, where ver is the version of the Java ES distribution from which you installed Sun Cluster software.


      phys-schost# /var/sadm/prod/SUNWentsysver/uninstall
      
    2. Follow the onscreen instructions to select the Sun Cluster components to uninstall.


      Note –

      If Sun Cluster Geographic Edition software is installed, you must uninstall it as well.


      For more information about using the uninstall program, see Chapter 8, Uninstalling, in Sun Java Enterprise System 5 Update 1 Installation Guide for UNIX. Sun Java Enterprise System 5 Update 1 Installation Guide for UNIX

Next Steps

To reinstall or reconfigure Sun Cluster software on the node, refer to Table 2–1. This table lists all installation tasks and the order in which to perform the tasks.

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 Sun ClusterHardware Administration Collection manual for your storage array.