How to Remove a Node From the Cluster Software Configuration

Language:

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.

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.

Assume a role that provides solaris.cluster.modify RBAC authorization on the node that you want to remove.
Perform all steps in this procedure from a node of the global cluster.
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 Booting a System in Booting and Shutting Down Oracle Solaris 11.2 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.

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.

From another cluster node, verify the node removal.
```
phys-schost# clnode status nodename
```

Complete the node removal.
- If you intend to uninstall the Oracle Solaris Cluster software from the removed node, proceed to How to Uninstall Oracle Solaris Cluster Software From a Cluster Node. You could also choose to remove the node from the cluster and uninstall the Oracle Solaris Cluster software at the same time. Change to a directory that does not contain any Oracle Solaris Cluster files and type scinstall -r.
- If you do not intend to uninstall the Oracle Solaris Cluster software from the removed node, you can physically remove the node from the cluster by removing the hardware connections as described in Oracle Solaris Cluster 4.2 Hardware Administration Manual .

Example 8-2 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.

For hardware procedures, see the Oracle Solaris Cluster 4.2 Hardware Administration Manual .

For a comprehensive list of tasks for removing a cluster node, see Table 8–2.

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