Uninstalling Components

Topics | How To | Troubleshoot | Related Topics


Overview

Uninstalling Windows Components

Uninstalling NetWare Components

Uninstalling Unix and Macintosh Components

Uninstalling Components from a Cluster

Component-Specific Considerations

Uninstalling the Data Classification Enabler

Uninstalling the Content Indexing Engine

Uninstalling the MSI Package Using SMS - Lotus Notes Client Add-In


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. See Reinstalling Uninstalled Agents for more information.

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 as depicted in the CommCell Browser image on the right. 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.

General Uninstall Considerations

Removing a component is a two-phase process:

Consider the following prior to uninstalling any component:


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. (To uninstall an application in Windows Vista, click Uninstall a Program under Programs in the Control Panel.)

Uninstall Sequence

The following sequence is recommended when uninstalling components from a Windows computer:

  1. Uninstall all application components
  2. Uninstall the File System iDataAgent (if installed)/SRM Windows File System Agent (see Uninstalling the Windows File System iDataAgent for more information)
  3. Uninstall the MediaAgent (if one exists)
  4. Uninstall the CommCell Console (if one exists)
  5. Uninstall the CommServe
  6. Uninstall the Base software
Note that the Base software cannot be uninstalled if there are any other components installed on the 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.

Component Component Title in Control Panel - Add/Remove Programs
1-Touch (Windows) CommVault 1-Touch
Active Directory iDataAgent CommVault Active Directory iDataAgent
Books Online CommVault Books Online
CommCell Console CommVault CommCell Console
CommCell Explorer CommVault CommCell Explorer
CommServe CommVault CommServe
ContinuousDataReplicator CommVault ContinuousDataReplicator
Data Classification Enabler CommVault Data Classification Enabler
DB2 iDataAgent CommVault DB2 iDataAgent
Exchange Compliance Archiver Agent CommVault Compliance Archiver Agent for Exchange
Exchange Mailbox Archiver Agent CommVault DataArchiver Agent for Exchange
Exchange Public Folder Archiver Agent CommVault DataArchiver Agent for Exchange Public Folder
Domino Mailbox Archiver Agent CommVault Domino Mailbox Archiver Agent
File Archiver Agent CommVault DataArchiver Agent for File System
File Archiver for NetWare CommVault File Archiver for NetWare
File Share Archiver Client CommVault DataArchiver for Network Storage Client
SharePoint Archiver Agent CommVault DataArchiver for SharePoint
Image Level iDataAgent CommVault Image Level iDataAgent
Image Level ProxyHost iDataAgent CommVault Image Level ProxyHost iDataAgent
Lotus Notes/Domino Server iDataAgents CommVault Lotus Notes Database iDataAgent
CommVault Lotus Notes Document iDataAgent
MediaAgent CommVault MediaAgent
Media Explorer (Windows) CommVault Media Explorer
Microsoft Data Protection Manager iDataAgent CommVault Data Protection Manager iDataAgent
Microsoft Exchange Server iDataAgent CommVault Exchange Mailbox iDataAgent
CommVault Exchange Public Folder iDataAgent
CommVault Exchange Web Folder iDataAgent
CommVault Exchange Database iDataAgent
Microsoft SharePoint Server iDataAgent CommVault SharePoint iDataAgent
Microsoft SQL Server iDataAgent CommVault SQL Server iDataAgent
Microsoft Windows File System iDataAgent CommVault File System iDataAgent
NAS NDMP iDataAgents CommVault NAS iDataAgent
NDMP Remote Server CommVault NDMP Remote Server
NDMP Restore Enabler CommVault File System NDMP Restore Enabler
ONTAP Enabler CommVault SnapVault ONTAP Enabler
Oracle iDataAgent CommVault Oracle Directory iDataAgent
OSSV Enabler CommVault SnapVault Open Systems Enabler
Outlook Add-In CommVault DataArchiver Outlook Add-In
OWA Proxy Enabler CommVault OWA Proxy Enabler
ProxyHost iDataAgent CommVault ProxyHost iDataAgent
Recovery Director CommVault Recovery Director
Quick Recovery Agent CommVault Quick Recovery Agent
QSnap CommVault Qsnap
SAP iDataAgents CommVault SAP for Oracle iDataAgent
SnapView Enabler CommVault SnapView Enabler for Quick Recovery
SNMP Enabler CommVault CommServe SNMP Enabler
Virtual Server iDataAgent CommVault Virtual Server iDataAgent
VSS Enabler CommVault VSS Enabler for Quick Recovery
Web Proxy Agent for Exchange CommVault DataArchiver WebProxy Agent for Exchange
Workstation Backup Agent CommVault Workstation Backup Agent
SRM Server CommVault SRM Server
SRM Exchange Agent CommVault SRM Exchange Agent
SRM NetWare Agent CommVault SRM NetWare Agent
SRM Network Attached Storage Agent CommVault SRM NAS Agent
SRM Oracle Agent CommVault SRM Oracle Agent
SRM SharePoint Agent CommVault SRM SharePoint Agent
SRM SQL Agent CommVault SRM SQL Agent
SRM Windows File System Agent CommVault SRM Windows File System Agent

Uninstalling NetWare Components

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

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

Uninstalling the OES File System iDataAgent

You can uninstall the OES 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

You can uninstall Unix components by using the cvpkgrm utility.

Uninstall Sequence

When uninstalling a component on a Unix or Macintosh computer, the following sequence must be used:

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

Since the component software depends upon the Base software, you must uninstall the component software first.

Components on Unix

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

Component Component Title in Uninstall Program's Selection Menu
Base Module CVGxBase
1-Touch (Unix) CVGx1Touch
CommCell Console (Macintosh) CVGxGUI
DB2 iDataAgent CVGxDB2
File Archiver Agent CVGxFSDM
File System iDataAgent (Unix and Macintosh) CVGxIDA
Copy Manager Agent CVGxCM
Informix iDataAgent CVGxIFIDA
Image Level iDataAgent CVGxImgIDA
Image Level ProxyHost iDataAgent CVGxImgProxyIDA
Lotus Notes/Domino Server iDataAgents CVGxLndbIDA
MediaAgent
WA Drivers (Installed with Solaris MediaAgents)
CVGxMA
CVGxWA
Media Explorer (Unix) CVGxMediaExplorer
MySQL Database iDataAgent CVGxMySQL
NAS NDMP iDataAgents CVGxNAS
NDMP Remote Server Agent CVGxNRS
OES File System iDataAgent CVGxOES
Oracle iDataAgent CVGxOrIDA
ProxyHost iDataAgent CVGxProxyIDA
Recovery Director iDataAgent CVGxRD
QSnap CVGxCXBF
Quick Recovery Agent CVGxQRA
SAP for Oracle iDataAgent CVGxOrSAP
SAP for MAXDB iDataAgent CVGxSAPMAXDB
Sybase iDataAgent CVGxSybIDA
SRM UNIX File System Agent SRMFileSystemAgent

Uninstalling Components from a Cluster

The following sections provide general guidelines for uninstalling components from a Windows, NetWare, or Unix cluster.

All Clusters

Windows Clusters

NetWare Clusters

Unix Clusters


Component-Specific Considerations

The following sections provide additional steps and considerations for uninstalling specific components from the computer.

If you are uninstalling a component in a clustered environment, see Uninstalling Components from a Cluster for additional cluster-specific considerations.

Uninstalling the CommServe

Consider the following prior to uninstalling the CommServe:

Uninstalling the MediaAgent

The MediaAgent uninstall software performs the following tasks:

Consider the following prior to uninstalling the MediaAgent software:

Uninstalling Media Explorer

Consider the following when uninstalling Media Explorer:

For the procedure on NetWare, see Uninstall Media Explorer from a NetWare Computer.

Uninstalling Backup and Recovery Agents

Consider the following prior to uninstalling a Backup and Recovery Agent:

Uninstalling the Windows File System iDataAgent

Most Windows components are dependent on the Windows File System iDataAgent and must be uninstalled prior to uninstalling the File System iDataAgent.

The following components are not dependent of the File System iDataAgent and can be uninstalled independent of it:

Uninstalling the Virtual Server iDataAgent

If uninstalling the Virtual Server iDataAgent from a Windows Server 2008 Core Edition cluster, perform the following steps:

  1. Using the command prompt, navigate to the Base folder.
  2. Execute the following command:

    "<base_folder_location>\QUnInstaller.exe" VirtualServerAgent /CalledFromARPChange

  3. Select the cluster group to be removed.

The Virtual Server iDataAgent is uninstalled from the selected cluster.

Uninstalling the Workstation Backup Agent

Consider the following prior to uninstalling the Workstation Backup Agent:

Uninstalling 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 prior to uninstalling NAS components:

Uninstalling SAN Components

SAN components consist of the Image Level iDataAgent, Image Level ProxyHost iDataAgent, ProxyHost iDataAgent, Quick Recovery Agent, Recovery Director, and QSnap.

When SAN components are installed, additional drivers and enablers 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 (if installed)
  2. Uninstall Enablers (SnapView, VSS, etc.)
  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, or Image Level ProxyHost 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 the Quick Recovery Agent

Consider the following prior to uninstalling the Quick Recovery Agent:

Removing QSnap Drivers Manually from Windows Computers

If manually removing a SAN component instead of using the Add/Remove Programs utility in the Windows Control Panel or the cvpkgrm utility in Unix, the QSnap driver must be manually removed as well. Failure to do so will result in a system crash when the computer is rebooted.

Note that for Image Level ProxyHost to function, QSnap, the Image Level iDataAgent, and File System iDataAgent are needed.

See Remove QSnap Drivers Manually from Windows Computers for step-by-step instructions.

Removing QSnap Drivers Manually from Unix Computers

If manually removing a SAN component instead of using the the cvpkgrm utility in Unix, the QSnap driver must be manually removed as well. Failure to do so will result in a system crash when the computer is rebooted.

Note that for Image Level ProxyHost to function, QSnap, the Image Level iDataAgent, and File System iDataAgent are needed.

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.

See Remove QSnap Drivers Manually from Unix Computers for step-by-step instructions.

Uninstalling Archive Management Agents

Consider the following prior to uninstalling an Archive Management Agent:

Exchange Archiver Agents

File Archiver Agents

SharePoint Archiver Agent

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, it is recommended that you delete all replication sets used in your Replication Scenario before deleting the source machine and destination machine. Consider the following before deleting these components.

See Delete the Agent for step-by-step instructions on deleting components.

Uninstalling SRM Components

The following sequence must be used when uninstalling SRM components:

  1. Uninstall any SRM Updates applied to the component(s) to be uninstalled
  2. Uninstall all SRM Agents
  3. Uninstall the SRM Server

Uninstall the SRM Agent

If the SRM Server is not communicating with a client when the SRM Agent software is uninstalled, the uninstall will work, but the SRM server will still think that the client exists. As a result, subsequent installs of the same SRM Agent software to this client may fail. In some cases, even if the agent install succeeds, the server would experience trouble in communicating to the client causing job failures.

This failure can be avoided by uninstalling the Client manually in the CommCell Console after the SRM Agent software has been uninstalled. For step-by-step instructions, see Delete a Client Computer.


Uninstalling the Data Classification Enabler


Uninstalling the Content Indexing Engine

After uninstalling the Content Indexing Engine software, delete the specific Content indexing Engine from the CommCell Console from Storage Resources | Content Indexing Engines | <uninstalled content indexing engine name>.


Uninstalling the MSI Package Using SMS - Lotus Notes Client Add-In

To uninstall the Lotus Notes Client Add-In set up a batch file that contains the following uninstall command and then run it as a scheduled task on remote Lotus Notes clients:

msiexec.exe /x {ProductCode_GUID} /qn /L*v "%TEMP%\LotusNotes_DM_Client_Uninstall.log"

To locate the ProductCode GUID, navigate to the following location:

[SOFTWARE\Simpana\Galaxy\Instance001\InstalledPackages\LotusNotesDMCleint]

Note that the /L*v "%TEMP%\LotusNotes_DM_Client_Uninstall.log" portion of the above command line is optional and is only used for generating a detailed log file of the uninstallation process.

In the event that the uninstallation process does not complete successfully, add the following to the end of the above command, to bypass QUninstaller.exe, which may leave unused registry entries under "HKEY_LOCAL_MACHINE\SOFTWARE\CommVault Systems\...":

EXECUTEGALAXYUNINSTALLER="FALSE"


Back to Top