How to Unconfigure Oracle Solaris Cluster Software to Correct Installation Problems

Language:

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 Oracle Solaris Cluster Software From a Cluster Node in Oracle Solaris Cluster 4.3 System Administration Guide.

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 Oracle Solaris Cluster software configuration on the node.

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, assume the root role.
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 an Existing Cluster or Zone Cluster in Oracle Solaris Cluster 4.3 System Administration Guide for procedures.

On a node that you intend to unconfigure, assume the root role.

Shut down the node.
```
phys-schost# shutdown -g0 -y -i0
```

Reboot the node into noncluster mode.
- SPARC:
```
ok boot -x
```
- x86:
  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.3 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 multiboot command to specify that the system boot into noncluster mode.
  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.
Change to a directory, such as the root (/) directory, that does not contain any files that are delivered by the Oracle Solaris Cluster packages.
```
phys-schost# cd /
```

Remove the node from the cluster configuration.
- To unconfigure the node but leave Oracle Solaris Cluster software installed, run the following command:
```
phys-schost# /usr/cluster/bin/clnode remove
```
  The node is removed from the cluster configuration but Oracle Solaris Cluster software is not removed from the node.
  
  See the clnode(1CL) man page for more information.
- To unconfigure the node and also remove Oracle Solaris Cluster software, run the following command:
```
phys-schost# /usr/cluster/bin/scinstall -r [-b BE-name]
```
  –r
  
  Removes cluster configuration information and uninstalls Oracle Solaris Cluster framework and data-service software from the cluster node. You can then reinstall the node or remove the node from the cluster.
  
  –b BE-name
  
  Specifies the name of a new boot environment, which is where you boot into after the uninstall process completes. Specifying a name is optional. If you do not specify a name for the boot environment, one is automatically generated.
  
  See the scinstall(1M) man page for more information.
Repeat Step 2 through Step 6 for each additional node to unconfigure.

Troubleshooting

If the cluster node that you are removing is at least partially configured with the cluster, running the clnode remove command might exit with errors such as Node is still enabled. If such errors occur, add the –F option to the clnode remove command.

Next Steps

Before you reinstall or reconfigure Oracle Solaris Cluster software on the node, refer to Figure 3, Table 3, Task Map: Installing the Software. 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 Oracle Solaris Cluster Hardware Administration Manual and the removal procedure in the Oracle Solaris Cluster manual for your storage array.