Using uninstallvcs

Before removing VCS from any system in the cluster, shut down applications such as the Java Console or any VCS enterprise agents that depend on VCS.

The uninstallvcs program does not remove shared packages such as VRTSllt, VRTSgab, and VRTSweb if they are also used as a part of other VERITAS software programs.

The uninstallvcs program does not automatically uninstall VCS enterprise agents. For some agents, the program offers uninstallation if proper package dependencies on VRTSvcs are found.

  To uninstall VCS

1. If you can execute commands as root on the remote systems in the cluster using ssh or remsh, uninstallvcs can be run on one system to uninstall VCS on all systems in the cluster. If you cannot execute commands as root on remote systems in the cluster using ssh or remsh, uninstallvcs must be run on each system in the cluster.
2. Enter the command to start uninstallvcs:
     # cd /opt/VRTSvcs/install
     # ./uninstallvcs

   The script begins with a copyright notice followed by a description of the cluster and a prompt to proceed uninstalling software:

   
     VCS configuration files exist on this system with the following
     information:
   
       Cluster Name: VCScluster2
       Cluster ID Number: 7
       Systems: north south
       Service Groups: ClusterService groupA groupB
   
     Do you want to uninstall VCS from these systems? [y,n,q] (y) 

   Enter "Y" to uninstall VCS on these systems. If you enter "N" or if no VCS configuration files are found on the local system, the utility prompts you for a list of systems to uninstall.

   ---

     Note    Before removing VCS from fewer than all systems in a cluster, make sure that no service groups are running on the systems from which VCS is uninstalled. You must also reconfigure VCS on the remaining systems. Refer to Adding and Removing Cluster Systems for instructions on how to remove systems from a cluster.

   ---

3. The uninstallvcs utility continues by verifying communication between systems and checking the installations on each system to determine the packages to be uninstalled. If packages, such as enterprise agents, are found to be dependent on a VCS package, you are prompted on whether you want them removed.

   Enter "Y" if you wish to remove the designated package.

4. After the utility verifies that uninstallation can proceed, it displays the following message:
     uninstallvcs is now ready to uninstall VCS packages.
     All VCS processes that are currently running will be stopped.
   
     Are you sure you want to uninstall VCS packages? [y,n,q] (y) 

   If you press Enter, uninstallation continues by stopping processes and unloading kernel modules:

   
     Stopping VCS processes on north:
   
      Checking VRTSweb process ........................ not running
      Checking had process ................................ running
      Stopping had ........................................... Done
      Checking hashadow process ....................... not running
      Checking CmdServer process .......................... running
      Killing CmdServer ...................................... Done
      Checking notifier process ........................... running
      Killing notifier ....................................... Done
      Checking gab driver ....................... gab module loaded
      Stopping gab driver .................................... Done
      Unloading gab module on north  ......................... Done
      Checking llt driver ....................... llt module loaded
      Stopping llt driver .................................... Done
      Unloading llt module on north  ......................... Done

   The utility performs the same actions on the other systems in the cluster.

5. After stopping processes on each system, the script removes the packages:
   Uninstalling Cluster Server 4.0 on all systems simultaneously:
     Uninstalling VRTSvcsw 4.1 on north ......... Done 1 of 30 steps
     Uninstalling VRTSvcsw 4.1 on south ......... Done 2 of 30 steps
     Uninstalling VRTSweb 4.1 on north .......... Done 3 of 30 steps
     Uninstalling VRTSweb 4.1 on south .......... Done 4 of 30 steps
     .
     .
     .
     Uninstalling VRTSvcsag 4.1 on north ....... Done 23 of 30 steps
     Uninstalling VRTSvcsag 4.1 on south ....... Done 24 of 30 steps
     Uninstalling VRTSvcs 4.1 on north ......... Done 25 of 30 steps
     Uninstalling VRTSvcs 4.1 on south ......... Done 26 of 30 steps
     Uninstalling VRTSgab 4.1 on north ......... Done 27 of 30 steps
     Uninstalling VRTSgab 4.1 on south ......... Done 28 of 30 steps
     Uninstalling VRTSllt 4.1 on north ......... Done 29 of 30 steps
     Uninstalling VRTSllt 4.1 on south ......... Done 30 of 30 steps
   Cluster Server package uninstall completed successfully.
6. After all packages are successfully removed, the utility indicates the location of summary and log files:
     Uninstallation of Cluster Server has completed successfully.
      The uninstallation summary is saved at:
           /opt/VRTS/install/logs/uninstallvcsdate_time.summary
      The uninstallvcs log is saved at:
           /opt/VRTS/install/logs/uninstallvcsdate_time.log

Uninstalling VERITAS Infrastructure Packages

Several packages, referred to as infrastructure packages, are used by multiple VERITAS products. These packages are not removed when uninstalling a single VERITAS product. If you remove all VERITAS products from a system and want to ensure that there are no remaining VERITAS packages, run the uninstallinfr script.

This script removes the VRTSvlic licensing package, the VRTScpi, and VRTSperl packages required for product installation. The VERITAS Enterprise Administrator packages, VRTSob and VRTSobgui, are also removed.

Running uninstallvcs from the VCS 4.1 Disc

If you need to uninstall VCS after an incomplete installation, or if the uninstallvcs utility is not available in /opt/VRTSvcs/install, you may need to use the uninstallvcs utility on the VCS 4.1 software disc.