Uninstall Components

Select the desired topic:

• Overview
• Uninstalling Windows Components
• Uninstalling NetWare Components
  • Uninstalling the Linux NetWare File System iDataAgent
• Uninstalling Unix and Macintosh Components
• Other Considerations
  • Uninstalling MediaAgents
  • Uninstalling SAN Components
  • Uninstalling ContinuousDataReplicator
  • Uninstalling the Quick Recovery Agent with Recovery Points
  • Deconfiguring NAS Components
  • Deconfiguring Virtual Machines and Modules
  • Removing QSnap/OFH Drivers Manually
  • Removing the CVSPT2K Driver for Serverless Data Manager
  • Removing Additional Components
• How To

See also:

• Deconfigure Agents
• Delete the Agent
• Troubleshooting - Uninstall Failure

Overview

Once you have uninstalled a component, you will no longer be able to perform data protection operations. The protected data, however, is still available on the media for the length of time expressed in the Retention Time defined in the associated Storage Policy Copy. If desired, you can browse the backup data from another active client within the same CommCell or perform data recovery operations from the component to another active client within the same CommCell. You cannot, however, restore the data to the component's original host computer because the necessary software is no longer present.
You will have to Reinstall the component software to the original computer in order to perform data recovery operations on such data. If you want to browse backup data from a client computer whose component software has been removed, simply follow the standard browse procedures. (See Browse Data for more information.)
Once you have uninstalled the component software, the corresponding icon in the CommCell Browser will appear dimmed. While this icon exists, most components can still perform data recovery operations. If you delete this icon, all of the component's data is irretrievably lost. Removing a component is a two-phase process: First, you need to uninstall the component software from the client computer hosting the software. If you are unable to uninstall the component from a computer using the recommended procedures, you can use the Deconfigure Agents feature to release the license and clean up entries from the CommServe database. However, files and registry entries relating to the component will not be removed from its host computer. Next, you must delete the component icon from the CommCell Browser. Once you decide that you won’t need to browse and/or restore the data after an uninstall or deconfigure, you can manually delete the component from the CommCell Browser. Doing so invalidates the corresponding backup data which may also release backup media to the system. See Delete the Agent for more information.

Uninstalling Windows Components

You can uninstall Windows components as you would any other applications by using the Add/Remove Programs utility in the Windows Control Panel.

This section provides information specific to uninstalling components from a Windows computer.

Components on Windows

The following table lists all the Windows components and their corresponding title within the Control Panel's Add/Remove Programs utility. Note that all Windows components are dependent on the Windows File System iDataAgent. You cannot uninstall the File System iDataAgent before uninstalling the other components.

Uninstalling NetWare Components

You can uninstall NetWare components by inserting the component software CD-ROM for the appropriate Windows platform into the Novell client computer CD-ROM drive, or by mapping the CD-ROM drive running the component software on another computer.

The following NetWare components may be removed using the uninstall procedure:

• NetWare File System iDataAgent software
• NetWare MediaAgent software
• NDS iDataAgent software
• Novell GroupWise iDataAgent software
• DataMigrator for NetWare Agent software

Uninstalling the Linux NetWare File System iDataAgent

You can uninstall the Linux NetWare File System iDataAgent as you would any other Unix component. See Uninstalling Unix and Macintosh Components below for more information.

Uninstalling Unix and Macintosh Components

This section provides information specific to uninstalling components from a Unix or Macintosh computer.

Components on Unix

You can uninstall Unix components by using the cvpkgrm utility. For more information on this procedure, see Uninstalling a Component from a Unix computer.

Before uninstalling the QSnap driver on a Unix computer, you must unmount and DeConfigure all QSnap devices. See DeConfigure a CXBF Device in Volume Explorer for more information.

Since the component software depends upon the Base software, you must uninstall the component software first. When uninstalling a component on a Unix or Macintosh computer, the following sequence must be used:

1. Uninstall all application components
2. Uninstall the File System iDataAgent (Unix and Macintosh)
3. Uninstall the MediaAgent (if one exists)
4. Uninstall the Base software

The following table lists all the Unix components and their corresponding titles within the uninstall program's selection menu:

Other Considerations

The following sections describe the steps and considerations for removing other components and drivers from Windows and Unix computers.

Uninstalling MediaAgents

The MediaAgent uninstall software performs the following tasks:

• Cleans up all the information about the MediaAgent in the CommServe database.
• Deconfigure the libraries and drives.
• Releases the license associated with the following: – MediaAgent – Libraries or stand-alone drives attached to the MediaAgent
• Remove the files and registry entries from the computer hosting the MediaAgent.

If you are unable to uninstall a MediaAgent using the recommended procedure, you can use the Deconfigure feature to release the license and clean up entries from the CommServe database. However, the files and registry entries relating to the MediaAgent will not be removed from its host computer.

Uninstalling SAN Components

When SAN components are installed, additional components may be automatically installed as well. When uninstalling, the following sequence must be used for any components that had been installed:

1. Uninstall Recovery Director
2. Uninstall Enablers (SnapView, VSS)
3. Uninstall the Agent or iDataAgent
4. Uninstall QSnap
5. Uninstall File System iDataAgent

Agents associated with Snapshot Volume Units (SVU), such as Quick Recovery Agent, ProxyHost, Image Level ProxyHost, or Serverless Data Manager, cannot be uninstalled until all SVUs are deleted or the associations are removed from the SVU prior to uninstalling the Recovery Director iDataAgent. See Create/Edit/Delete a Snapshot Volume Unit (SVU) for more information.

Uninstalling ContinuousDataReplicator

ContinuousDataReplicator is uninstalled from at least two computers; the server from which you replicated data (source machine) and the computer to which you replicated data (destination machine.) You may choose to perform additional uninstalls based on the Replication Scenario used in your particular environment.

Prior to uninstalling the software, you can delete the source machine, destination machine, and any replication sets used in your Replication Scenario. Consider the following before deleting these components.

• Replication sets can be deleted if the replication pairs are in any of the following states:
  • Aborted
  • New Pair
  • Failed
• Deleting the source or destination machine will remove all of the following from that machine:
  • replication pairs
  • consistency recovery points
  • Quick Recovery points
  • mounted snapshots
  • shared snapshots
  • job history

For more information on deleting components, see Delete the Agent.

Uninstalling the Quick Recovery Agent with Recovery Points

Recovery Points are not automatically deleted from the database or the Registry when you uninstall the Quick Recovery Agent software.

If you have created Recovery Points and they still exist when you uninstall the Quick Recovery Agent, the Quick Recovery Agent software uninstall will succeed, but you will need to manually remove the Recovery Points from the database by deleting the Quick Recovery Agent icon (and its associated data) from the Browser window. However, the accompanying Snapshots will still remain in the Registry.

To work around this issue, you can:

• Manually delete the Recovery Points from the Browser window prior to uninstalling the Quick Recovery Agent, and then delete the Quick Recovery Agent icon from the Browser window after the Quick Recovery Agent has been uninstalled.

  OR

• Uninstall QSnap after uninstalling the Quick Recovery Agent.

Deconfiguring NAS Components

NAS components are installed automatically with the MediaAgent software. Individual NAS clients must be deconfigured from the MediaAgent computer prior to uninstalling the File System iDataAgent or MediaAgent software.

The following sequence must be used when uninstalling NAS components:

1. Deconfigure all NAS clients
2. Uninstall any application components that may be installed
3. Uninstall any application Agents or iDataAgents that may be installed
4. Uninstall the File System iDataAgent (if installed)
5. Uninstall the MediaAgent

Consider the following when uninstalling NAS components:

• You cannot uninstall a Windows File System iDataAgent from a MediaAgent if the MediaAgent is in the Data Path of a Storage Policy associated with an EMC Centera or NAS NDMP subclient.

Deconfiguring Virtual Machines and Modules (HP-UX, Linux, and Solaris)

The component software allows you to Deconfigure virtual machines completely. It also allows you to Deconfigure individual modules for the virtual machines.

To Deconfigure a virtual machine, the virtual machine must be Deconfigured from all of the physical machines (hosts) on which it has been configured. This means that, within a clustered environment, each virtual machine must be Deconfigured from at least two hosts. To do this, follow the sequence outlined in Components on Unix.

Removing QSnap/OFH Drivers Manually

If you choose to manually remove a SAN component (instead of using the Add/Remove Programs utility in the Windows Control Panel or the cvpkgrm utility in Unix), you must also manually remove the QSnap or Open File Handler (OFH) driver(s). Failure to do so will result in a system crash when the computer is rebooted.

NOTE:

• When removing components, remember that Image Level ProxyHost can function only if the following are also present: OFH or QSnap, the Image Level iDataAgent, and the File System iDataAgent.

The following sections describe steps and considerations for manually removing QSnap/OFH drivers from Windows and Unix computers.

NOTE:

• Remember that OFH runs only on Windows; QSnap runs on both Windows and Unix.

Windows

Remove the following after manually removing a dependent Agent, and prior to rebooting the machine:

• In C:\<Windows directory>\system32\drivers:
  • for OFH, delete QSnap.sys
  • for QSnap, delete QSnap2.sys

  WARNING:

  Using Registry Editor incorrectly can cause serious problems that may require a reinstall of the operating system. Neither Microsoft nor CommVault Systems can guarantee that problems resulting from the incorrect use of Registry Editor can be solved. Use Registry Editor at your own risk. Contact your software provider if you have any questions about these registry keys.

• In the registry:
  • to delete the OFH driver, go to HKEY_LOCAL_MACHINE -> SYSTEM -> CurrentControlSet -> Services -> QSnap and delete the entire QSnap key.
  • to delete the QSnap driver, go to HKEY_LOCAL_MACHINE -> SYSTEM -> CurrentControlSet -> Services -> QSnap2 and delete the entire QSnap2 key.
• In the registry, go to HKEY_LOCAL_MACHINE -> SYSTEM -> CurrentControlSet -> Control -> Class -> {71A27CDD-812A-11D0-BEC7-08002BE2092F} and delete the entire UpperFilters key.

Unix

To manually uninstall the Unix QSnap (CXBF) driver:

1. Unmount all CXBF devices or quit applications that are using raw CXBF devices.
2. Use the command line utility in /usr/sbin/cvsnap to invoke the cvsnap command.
3. Type the show command to see all CXBF devices.
4. Defunct and delete all devices (e.g.: cvsnap>defunct device=c1t0d5s0 and cvsnap>delete device=c1t0d5s0); perform both operations for one device before moving to the next one. If you get an error message that says a device is busy, return to step 1.
5. After defuncting and deleting all CXBF devices, quit cvsnap. (Type q and press Enter.)
6. Execute the following commands: rm /usr/sbin/cxbf-bootscript1.rc and rm /usr/sbin/cxbf-bootscript2.rc.
7. Remove all CXBF device entries from /etc/devlink.tab.
8. Execute the following commands: rm /usr/kernel/drv/sparcv9/cxbf and rm /usr/kernel/drv/cxbf.conf.
9. Execute the following command: rem_drv.conf. If you get an error message, return to step 1. If it still fails, then reboot after step 10 to unload the CXBF driver from the system.
10. Execute the following commands: rm /usr/sbin/cvsnap and rm /etc/galaxy/.*.

Removing the CVSPT2K Driver for Serverless Data Manager

For information on removing the CVSPT2K driver for the Serverless Data Manager iDataAgent (SDM), see The CVSPT2K Driver for Windows.

Removing Additional Components

When uninstalling software, you may need to remove the following additional components and drivers if any had been installed:

• CommServe SNMP Enabler
• Content Indexing Enabler
• DataMigrator WebProxy Agent for Exchange
• File System NDMP Restore Enabler
• NDMP Remote Enabler
• Open File Handler
• QSnap
• SnapView Enabler for Quick Recovery
• SnapVault ONTAP Enabler
• SnapVault Open Systems Enabler
• VSS Enabler for Quick Recovery

You can remove these components as you would any other application by using either the Add/Remove Programs utility on a Windows computer or the cvpkgrm utility on a Unix computer.

How To

The following links provide procedures for uninstalling a component from a computer in clustered and non-clustered environments:

• Uninstall Components from a Windows Computer
• Uninstall Components from a NetWare Computer
• Uninstall Components from a Unix or Macintosh Computer

Back to Top