Oracle® Solaris Cluster System Administration Guide

Exit Print View

Updated: October 2015

How to Uninstall Oracle Solaris Cluster Software From a Cluster Node

Perform this procedure to unconfigure Oracle Solaris Cluster software from a global-cluster node before you disconnect it from a fully established cluster configuration. You can use this procedure to uninstall software from the last remaining node of a cluster.

Note -  To uninstall Oracle Solaris Cluster software from a node that has not yet joined the cluster or is still in installation mode, do not perform this procedure. Instead, go to How to Unconfigure Oracle Solaris Cluster Software to Correct Installation Problems in Oracle Solaris Cluster Software Installation Guide .

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 correctly completed all prerequisite tasks in the task map to remove a cluster node.

    See Table 8–2.

    Ensure that you have removed the node from the cluster configuration by using clnode remove before you continue with this procedure. Other steps might include adding the node you plan to uninstall to the cluster's node–authentication list, uninstalling a zone cluster, and so on.

    Note -  To unconfigure the node but leave Oracle Solaris Cluster software installed on the node, do not proceed further after you run the clnode remove command.
  2. Assume the root role on the node to uninstall.
  3. If your node has a dedicated partition for the global devices namespace, reboot the global-cluster node into noncluster mode.
    • On a SPARC based system, run the following command.

      # shutdown -g0 -y -i0 ok boot -x
    • On an x86 based system, run the following commands.

      # shutdown -g0 -y -i0
      <<< Current Boot Parameters >>>
      Boot path: /pci@0,0/pci8086,2545@3/pci8086,1460@1d/pci8086,341a@7,1/
      Boot args:
      Type    b [file-name] [boot-flags] <ENTER>  to boot with options
      or      i <ENTER>                           to enter boot interpreter
      or      <ENTER>                             to boot with defaults
      <<< timeout in 5 seconds >>>
      Select (b)oot or (i)nterpreter: b -x
  4. In the /etc/vfstab file, remove all globally mounted file-system entries except the /global/.devices global mounts.
  5. 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 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 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.
  6. 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 /
  7. To unconfigure the node and remove Oracle Solaris Cluster software, run the following command.
    phys-schost# scinstall -r [-b bename]

    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 bootenvironmentname

    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.

  8. If you intend to reinstall the Oracle Solaris Cluster software on this node after the uninstall completes, reboot the node to boot into the new boot environment.
  9. If you do not intend to reinstall the Oracle Solaris Cluster software on this cluster, disconnect the transport cables and the transport switch, if any, from the other cluster devices.
    1. If the uninstalled node is connected to a storage device that uses a parallel SCSI interface, install a SCSI terminator to the open SCSI connector of the storage device after you disconnect the transport cables.

      If the uninstalled node is connected to a storage device that uses Fibre Channel interfaces, no termination is necessary.

    2. Follow the documentation that shipped with your host adapter and server for disconnection procedures.

    Tip  -  For more information about migrating a global-devices namespace to a lofi, see Migrating the Global-Devices Namespace.