Sun Cluster Software Installation Guide for Solaris OS

Uninstalling the Software

This section provides the following procedures to uninstall or remove Sun Cluster software:

ProcedureHow to Uninstall Sun 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 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 Sun Cluster Software From a Cluster Node” in Adding and Removing a Cluster Node in Sun Cluster System Administration Guide for Solaris OS.


Before You Begin

Attempt to reinstall the node. You can correct certain failed installations by repeating Sun Cluster software installation on the node.

Steps
  1. Add to the cluster's node-authentication list the node that you intend to uninstall.

    If you are uninstalling a single-node cluster, skip to Step 2.

    1. Become superuser on an active cluster member other than the node that you are uninstalling.

    2. Specify the name of the node to add to the authentication list.


      # /usr/cluster/bin/scconf -a -T node=nodename
      
      -a

      Add

      -T

      Specifies authentication options

      node=nodename

      Specifies the name of the node to add to the authentication list

      You can also use the scsetup(1M) utility to perform this task. See How to Add a Node to the Authorized Node List in Sun Cluster System Administration Guide for Solaris OS for procedures.

  2. Become superuser on the node that you intend to uninstall.

  3. Shut down the node that you intend to uninstall.


    # shutdown -g0 -y -i0
    
  4. Reboot the node into noncluster mode.

    • On SPARC based systems, do the following:


      ok boot -x
      
    • On x86 based systems, do the following:


                          <<< Current Boot Parameters >>>
      Boot path: /pci@0,0/pci-ide@7,1/ata@1/cmdk@0,0:b
      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
      
  5. Change to a directory, such as the root (/) directory, that does not contain any files that are delivered by the Sun Cluster packages.


    # cd /
    
  6. Uninstall Sun Cluster software from the node.


    # /usr/cluster/bin/scinstall -r
    

    See the scinstall(1M) man page for more information.

  7. Reinstall and reconfigure Sun Cluster software on the node.

    Refer to Table 2–1 for the list of all installation tasks and the order in which to perform the tasks.

ProcedureHow to Uninstall the SUNWscrdt Package

Perform this procedure on each node in the cluster.

Before You Begin

Verify that no applications are using the RSMRDT driver before performing this procedure.

Steps
  1. Become superuser on the node to which you want to uninstall the SUNWscrdt package.

  2. Uninstall the SUNWscrdt package.


    # pkgrm SUNWscrdt
    

ProcedureHow to Unload the RSMRDT Driver Manually

If the driver remains loaded in memory after completing How to Uninstall the SUNWscrdt Package, perform this procedure to unload the driver manually.

Steps
  1. Start the adb utility.


    # adb -kw
    
  2. Set the kernel variable clifrsmrdt_modunload_ok to 1.


    physmem NNNN 
    clifrsmrdt_modunload_ok/W 1
    
  3. Exit the adb utility by pressing Control-D.

  4. Find the clif_rsmrdt and rsmrdt module IDs.


    # modinfo | grep rdt
    
  5. Unload the clif_rsmrdt module.

    You must unload the clif_rsmrdt module before you unload the rsmrdt module.


    # modunload -i clif_rsmrdt_id
    
    clif_rsmrdt_id

    Specifies the numeric ID for the module being unloaded

  6. Unload the rsmrdt module.


    # modunload -i rsmrdt_id
    
    rsmrdt_id

    Specifies the numeric ID for the module being unloaded

  7. Verify that the module was successfully unloaded.


    # modinfo | grep rdt
    

Example 2–5 Unloading the RSMRDT Driver

The following example shows the console output after the RSMRDT driver is manually unloaded.


# adb -kw
physmem fc54
clifrsmrdt_modunload_ok/W 1
clifrsmrdt_modunload_ok: 0x0 = 0x1
^D
# modinfo | grep rsm
 88 f064a5cb 974 - 1 rsmops (RSMOPS module 1.1)
 93 f08e07d4 b95 - 1 clif_rsmrdt (CLUSTER-RSMRDT Interface module)
 94 f0d3d000 13db0 194 1 rsmrdt (Reliable Datagram Transport dri)
# modunload -i 93
# modunload -i 94
# modinfo | grep rsm
 88 f064a5cb 974 - 1 rsmops (RSMOPS module 1.1)
#

Troubleshooting

If the modunload command fails, applications are probably still using the driver. Terminate the applications before you run modunload again.