Go to main content

Administering an Oracle® Solaris Cluster 4.4 Configuration

Exit Print View

Updated: November 2019

How to Remove a Node From the Cluster Software Configuration

Perform this procedure to remove a node from the global cluster.

The phys-schost# prompt reflects a global-cluster prompt. Perform this procedure on a global cluster.

This procedure provides the long forms of the Oracle Solaris Cluster commands. Most commands also have short forms. Except for the long and short forms of the command names, the commands are identical.

  1. Ensure that you have removed the node from all resource groups, device groups, and quorum device configurations and put it into maintenance state before you continue with this procedure.
  2. Assume the root role or a role that provides solaris.cluster.modify authorization on the node that you want to remove.

    Perform all steps in this procedure from a node of the global cluster.

  3. Boot the global-cluster node that you want to remove into noncluster mode.

    For a zone-cluster node, follow the instructions in How to Remove a Node From a Zone Cluster before you perform this step.

    • On SPARC based systems, run the following command.

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

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

      For more information about GRUB based booting, see About Run Level Booting in Booting and Shutting Down Oracle Solaris 11.4 Systems.

    2. In the boot parameters screen, use the arrow keys to select the kernel entry and type e to edit the entry.
    3. Add -x to the command to specify 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 -x
    4. Press the Enter key 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.

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

  4. Delete the node from the cluster.
    1. Run the following command from an active node:
      phys-schost# clnode clear -F nodename

      If you have resource groups that are have rg_system=true, you must change them to rg_system=false so that the clnode clear -F command will succeed. After you run clnode clear -F, reset the resource groups back to rg_system=true.

    2. Run the following command from the node you want to remove:
      phys-schost# clnode remove -F

      Note -  If the node to be removed is not available or can no longer be booted, run the following command on any active cluster node.
      # clnode clear -F node-to-be-removed

      Verify the node removal by running clnode status nodename.

    If you are removing the last node in the cluster, the node must be in noncluster mode with no active nodes left in the cluster.

  5. From another cluster node, verify the node removal.
    phys-schost# clnode status nodename
  6. Complete the node removal.
Example 67  Removing a Node From the Cluster Software Configuration

This example shows how to remove a node (phys-schost-2) from a cluster. The clnode remove command is run in noncluster mode from the node you want to remove from the cluster (phys-schost-2).

Remove the node from the cluster:
phys-schost-2# clnode remove
phys-schost-1# clnode clear -F phys-schost-2
Verify node removal:
phys-schost-1# clnode status
-- Cluster Nodes --
                 Node name         Status
                 ---------         ------
Cluster node:    phys-schost-1    Online

See Also

To uninstall Oracle Solaris Cluster software from the removed node, see How to Uninstall Oracle Solaris Cluster Software From a Cluster Node in Installing and Configuring an Oracle Solaris Cluster 4.4 Environment.

For hardware procedures, see the Managing Hardware With Oracle Solaris Cluster 4.4.

For a comprehensive list of tasks for removing a cluster node, see Table 15, Task Map: Removing a Node.

To add a node to an existing cluster, see How to Add a Node to an Existing Cluster or Zone Cluster.