Uninstalling the Software

This section provides procedures to uninstall or remove certain software products from a global cluster.

How to Unconfigure Oracle Solaris 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 Oracle Solaris Cluster Software From a Cluster Node in Oracle Solaris Cluster 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, 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 Oracle Solaris Cluster System Administration Guide for procedures.
On a node that you intend to unconfigure, become superuser.
Shut down the node.
```
phys-schost# shutdown -g0 -y -i0
```

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:

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.

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.

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

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.-

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.
```
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.
Repeat Step 2 through Step 6 for each additional node to unconfigure.
(Optional) Uninstall Oracle Solaris Cluster framework and data service software packages.
Note - If you do not need to remove or reinstall Oracle Solaris Cluster software, you can skip this step.

This step also removes the Oracle Solaris Cluster entry from the installer program product registry. If the product registry contains a record that Oracle Solaris Cluster software is installed, the installer program will show the Oracle Solaris 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 Oracle Solaris Cluster software.
```
phys-schost# /var/sadm/prod/SUNWentsysver/uninstall
```
2. Follow the onscreen instructions to select the Oracle Solaris Cluster components to uninstall.
  Note - If Oracle Solaris 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.

Troubleshooting

If the uninstall program does not exist on the node, package installation might not have fully completed. Remove the /var/sadm/install/productregistry file, then use the pkgrm command to manually remove all Oracle Solaris Cluster packages.

Next Steps

To reinstall or reconfigure Oracle Solaris 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 Oracle Solaris Cluster 3.3 Hardware Administration Manual and the removal procedure in the Oracle Solaris ClusterHardware Administration Collection manual for your storage array.

How to Remove Oracle Solaris Cluster Information From a JumpStart Install Server

Perform this procedure to remove Oracle Solaris Cluster information from a JumpStart install server that was used to install and configure a cluster. You can remove information for one or more individual nodes or for one or more entire clusters. For more information about the JumpStart feature, see Solaris 10 10/09 Installation Guide: Custom JumpStart and Advanced Installations.

Become superuser on the JumpStart install server.
Change to the JumpStart directory that you used to install Oracle Solaris Cluster software.
```
installserver# cd jumpstart-dir
```
Remove from the rules file any entries that were created by the scinstall command that contain the name of a node that you want to remove.
The Oracle Solaris Cluster entries reference autostinstall.class or autoscinstall.finish or both. Entries appear similar to the following, where release is the version of Oracle Solaris Cluster software:
```
hostname phys-schost-1  -  autoscinstall.d/release/autoscinstall.class  \ 
autoscinstall.d/release/autoscinstall.finish
```
Regenerate the rules.ok file.
Run the check command that is located in the jumpstart-dir/ directory to regenerate the rules.ok file.
```
installserver# ./check
```
Remove from the appropriate clusters/clustername/ directory the symbolic link for each node that you want to remove.
- To remove the symbolic link for one or more nodes in a cluster, remove the link that is named for each node to remove.
```
installserver# rm -f autoscinstall.d/clusters/clustername/nodename
```
- To remove the symbolic links for an entire cluster, recursively remove the directory that is named for the cluster to remove.
```
installserver# rm -rf autoscinstall.d/clusters/clustername
```
- To remove the symbolic links for all clusters, recursively remove the clusters/ directory.
```
installserver# rm -rf autoscinstall.d/clusters
```
Remove from the autoscinstall.d/ directory the node configuration directory that is named for each node that you want to remove.
If you are removing information for an entire cluster, remove the directory for each node in the cluster.
- To remove information for one or more nodes in a cluster, recursively remove the directory for each node.
```
installserver# rm -rf autoscinstall.d/nodes/nodename
```
- To remove all entries for all clusters, recursively remove the autoscinstall.d directory.
```
installserver# rm -rf autoscinstall.d
```
Remove the .autoscinstall.log.3 file.
```
installserver# rm .autoscinstall.log.3
```
(Optional) If you used a flash archive to JumpStart install the cluster, remove the flash archive if you no longer need the file.
```
installserver# rm filename.flar
```

Next Steps

If you intend to use custom JumpStart to reinstall a cluster from which you removed information for one or more nodes that were removed from that cluster, you must rerun interactive scinstall to update the cluster node list. See How to Install Solaris and Oracle Solaris Cluster Software (JumpStart).

How to Uninstall SunPlex Manager Software

Use this procedure to uninstall SunPlex Manager software that was installed by the installer utility up to and including the Sun Java Enterprise System 2005Q4 distribution or by any other installation method.

To remove Oracle Solaris Cluster Manager software that was installed with the Sun Java Enterprise System 5 or compatible distribution of the installer utility, instead use the uninstall utility to remove these packages. For more information, see Chapter 8, Uninstalling, in Sun Java Enterprise System 5 Update 1 Installation Guide for UNIX.

Note - Do not uninstall SunPlex Manager or Oracle Solaris Cluster Manager or its shared components if you intend to use the graphical user interface (GUI) to Oracle Solaris Cluster Geographic Edition software or to Oracle Solaris Cluster features that are available through the GUI. These features include the data-service configuration wizards or system resource monitoring.

However, if you use the command-line interface to administer these features, it is safe to uninstall SunPlex Manager or Oracle Solaris Cluster Manager software.

Perform this procedure on each node in the cluster to uninstall SunPlex Manager software and related Sun Java Enterprise System shared components.

Note - SunPlex Manager software must be installed on all cluster nodes or on none.

Become superuser on a cluster node.

Remove the SunPlex Manager software packages.

phys-schost# pkgrm SUNWscspm SUNWscspmu SUNWscspmr

(Optional) Remove Oracle Java Web Console software packages, if you have no other need for them.
```
phys-schost# pkgrm SUNWmctag SUNWmconr SUNWmcon SUNWmcos SUNWmcosx
```
(Optional) If you removed Oracle Java Web Console packages, remove Apache Tomcat and Java Studio Enterprise Web Application Framework (Java ATO) software packages, if you have no other need for them.
Remove the packages listed below for each additional product that you want to uninstall, in the order that the set of packages is listed.
```
phys-schost# pkgrm packages
```
Product

Package Names

Apache Tomcat

SUNWtcatu

Java ATO

SUNWjato SUNWjatodmo SUNWjatodoc

How to Remove Quorum Server Software

Before You Begin

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

On each cluster that uses the quorum server, remove the quorum server as a quorum device. Perform the steps in How to Remove a Quorum Device in Oracle Solaris Cluster System Administration Guide.

In normal operation, this step also removes the quorum server information on the quorum-server host. If communications between the cluster and the quorum -server host computer are down during this step, you must clean up the invalid quorum server information on the quorum-server host computer. Perform the steps in Cleaning Up Stale Quorum Server Cluster Information in Oracle Solaris Cluster System Administration Guide.
On each quorum-server host computer, stop the quorum server by following the steps in How to Stop a Quorum Server in Oracle Solaris Cluster System Administration Guide.

(Optional) To use the interactive graphical interface, ensure that the display environment of the host server to uninstall is set to display the GUI.
```
% xhost +
% setenv DISPLAY nodename:0.0
```
Become superuser on the quorum server host computer to uninstall.
Navigate to the directory where the uninstaller is located.
```
quorumserver# cd /var/sadm/prod/SUNWentsysver
```
ver

The version that is installed on your system.
Start the uninstallation wizard.
```
quorumserver# ./uninstall
```
Follow instructions on the screen to uninstall the Quorum Server software from the quorum-server host computer.
After removal is finished, you can view any available log. See Chapter 8, Uninstalling, in Sun Java Enterprise System 5 Update 1 Installation Guide for UNIX for additional information about using the uninstall program.
(Optional) Clean up or remove the quorum server directories.
By default, this directory is /var/scqsd.

How to Unconfigure a Zone Cluster

Perform this procedure to remove a zone cluster.

Become superuser on a node of the global cluster.
You perform all steps of this procedure from a node of the global cluster.

Take offline each resource group in the zone cluster and disable its resources.

Note - The following steps are performed from a global-cluster node. To instead perform these steps from a node of the zone cluster, log in to the zone-cluster node and omit “-Z zonecluster” from each command.

Take each resource offline.

phys-schost# clresource offline -Z zonecluster resource-group

List all enabled resources in the zone cluster.

phys-schost# clresource show -Z zonecluster -p Enabled
=== Resources ===

Resource:                                       resource
  Enabled{nodename1}:                               True
  Enabled{nodename2}:                               True
…

Identify those resources that depend on other resources.

phys-schost# clresource show -Z zonecluster -p resource_dependencies
=== Resources ===

Resource:                                       node
  Resource_dependencies:                           node
…

You must disable dependent resources first before you disable the resources that they depend on.

Disable each enabled resource in the cluster.
```
phys-schost# clresource disable -Z zonecluster resource
```
See the clresource(1CL) man page for more information.

Verify that all resources are disabled.

phys-schost# clresource show -Z zonecluster -p Enabled
=== Resources ===

Resource:                                       resource
  Enabled{nodename1}:                               False
  Enabled{nodename2}:                               False
…

Move each resource group to the unmanaged state.

phys-schost# clresourcegroup unmanage -Z zonecluster resource-group

Verify that all resources on all nodes are Offline and that all resource groups are in the Unmanaged state.
```
phys-schost# cluster status -Z zonecluster -t resource,resourcegroup
```
Delete all resource groups and their resources from the zone cluster.
```
phys-schost# clresourcegroup delete -F -Z zonecluster +
```

Halt the zone cluster.

phys-schost# clzonecluster halt zoneclustername

Uninstall the zone cluster.

phys-schost# clzonecluster uninstall zoneclustername

Unconfigure the zone cluster.

phys-schost# clzonecluster delete zoneclustername

Skip Navigation Links
Exit Print View
	Oracle Solaris Cluster Software Installation Guide Oracle Solaris Cluster