Uninstalling Components - Topics

Topics How To Troubleshoot FAQ
Table of Contents

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 below. 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:

  • 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 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 wont 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 step-by-step instructions.

Consider the following prior to uninstalling any component:

  • Verify that the CommServe is running (except when uninstalling the CommServe software).
  • Verify that no jobs are in progress or scheduled to occur while the software is being uninstalled. If jobs are scheduled, either perform the uninstall at another time or disable the jobs on the client computer using the CommCell Console.

  • Verify that the CommCell Console and Process Manager window are closed.

  • If components were not installed in the default location, you will have to manually delete the directory/folders once the uninstall is complete.

  • When uninstalling software, you may need to remove additional components and drivers if any had been installed.
  • If the Authentication for Agent Installs feature has been enabled on the CommCell, users must have Agent Management capabilities to uninstall agents. During the uninstall, users will be prompted for their account information to continue with the uninstall. If the user is not authorized, the uninstall process will abort. For more information, see Authentication for Agent Installs.
  • If uninstalling a component from the command line using an uninstall shortcut in the <software_installation_directory>\Uninstall folder, the command should not be run with the <software_installation_directory>\Uninstall folder open in the command. Instead, the command should be run with the uninstall package included in the command.

    For example, the correct command would appear as follows:

    <software_installation_directory>\Uninstall\<uninstall_package>

Uninstalling Components Using the CommCell Console

Software packages can be uninstalled from client computers and MediaAgents in your CommCell using the CommCell Console interface. The Uninstall Software utility allows you to quickly see a list of the software packages installed on the selected computer, from which you can then select the components to uninstall. With this, you can easily manage removing software components from client computers and MediaAgents in your CommCell without having to directly access each computer. 

Specific permissions must be granted to the user group(s) whose user members will be administering this feature. This feature is restricted to only those users belonging to a user group assigned with Administrative Management capabilities for the CommCell or Client computer within the CommCell. For more information, see Capabilities and Permitted Actions.

For step-by-step instructions for using this tool, see Uninstall Components Using the CommCell Console.

Job Status

When you use the CommCell Console to uninstall the software, it will be displayed as a single administration job in the Job Controller. The Job Controller will also display the progress and status of the job, while the Event Viewer will contain status details of the operations involved. For specific details of the job, such as the reason for a client installation failure, if any, you can view the job details.

For step-by-step instructions, see View Job Detail.

Verification of Software Installation

Once software has been removed from the selected client or MediaAgent computer, you can easily verify the remaining software packages installed on the clients right from the CommCell Browser.

If all software packages are uninstalled from the client or MediaAgent computer, it will become a deconfigured component. A deconfigured client is easily visible from the CommCell Browser; the client or MediaAgent icon represents a deconfigured component. For more information, see Deconfiguring Agents.

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/Windows 2008, 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) NetApp, Inc. 1-Touch
Active Directory iDataAgent NetApp, Inc. Active Directory iDataAgent
Books Online NetApp, Inc. Books Online
CommCell Console NetApp, Inc. CommCell Console
CommServe NetApp, Inc. CommServe
ContinuousDataReplicator NetApp, Inc. ContinuousDataReplicator
Data Classification Enabler NetApp, Inc. Data Classification Enabler
DB2 iDataAgent NetApp, Inc. DB2 iDataAgent
Exchange Compliance Archiver Agent NetApp, Inc. Exchange Compliance Archiver
Exchange Mailbox Archiver Agent NetApp, Inc. Exchange Mailbox Archiver
Exchange Public Folder Archiver Agent NetApp, Inc. Exchange Public Folder Archiver
External Data Connector  
Domino Mailbox Archiver Agent NetApp, Inc. Domino Mailbox Archiver Agent
File Archiver Agent NetApp, Inc. File Archiver for Windows
File Archiver for NetWare NetApp, Inc. File Archiver for NetWare
SharePoint Archiver Agent NetApp, Inc. SharePoint Archiver
Image Level iDataAgent NetApp, Inc. Image Level iDataAgent
Image Level ProxyHost iDataAgent NetApp, Inc. Image Level ProxyHost iDataAgent
Lotus Notes/Domino Server iDataAgents NetApp, Inc. Lotus Notes Database iDataAgent
NetApp, Inc. Lotus Notes Document iDataAgent
MediaAgent NetApp, Inc. MediaAgent
Microsoft Exchange Server iDataAgent NetApp, Inc. Exchange Mailbox iDataAgent
NetApp, Inc. Exchange Public Folder iDataAgent
NetApp, Inc. Exchange Database iDataAgent
Microsoft SharePoint Server iDataAgent NetApp, Inc. SharePoint iDataAgent
Microsoft SQL Server iDataAgent NetApp, Inc. SQL Server iDataAgent
Microsoft Windows File System iDataAgent NetApp, Inc. File System iDataAgent
NAS NDMP iDataAgents NetApp, Inc. NAS iDataAgent
ONTAP Enabler NetApp, Inc. SnapVault ONTAP Enabler
Oracle iDataAgent NetApp, Inc. Oracle Directory iDataAgent
OSSV Enabler NetApp, Inc. SnapVault Open Systems Enabler
Outlook Add-In NetApp, Inc. Outlook Add-In
OWA Proxy Enabler NetApp, Inc. OWA Proxy Enabler
PostgreSQL iDataAgent NetApp, Inc. PostgreSQL iDataAgent
ProxyHost iDataAgent NetApp, Inc. ProxyHost iDataAgent
Recovery Director NetApp, Inc. Recovery Director
Quick Recovery Agent NetApp, Inc. Quick Recovery Agent
QSnap NetApp, Inc. Qsnap
SAP iDataAgents NetApp, Inc. SAP for Oracle iDataAgent
SnapView Enabler NetApp, Inc. SnapView Enabler for Quick Recovery
SNMP Enabler NetApp, Inc. CommServe SNMP Enabler
Virtual Server iDataAgent NetApp, Inc. Virtual Server iDataAgent
VSS Enabler NetApp, Inc. VSS Enabler for Quick Recovery
Web Proxy Agent for Exchange NetApp, Inc. Exchange WebProxy Archiver Agent
Workstation Backup Agent NetApp, Inc. Workstation Backup Agent
SRM Exchange Agent NetApp, Inc. SRM Exchange Agent
SRM NetWare Agent NetApp, Inc. SRM NetWare Agent
SRM Network Attached Storage Agent NetApp, Inc. SRM NAS Agent
SRM Oracle Agent NetApp, Inc. SRM Oracle Agent
SRM SharePoint Agent NetApp, Inc. SRM SharePoint Agent
SRM SQL Agent NetApp, Inc. SRM SQL Agent
SRM Virtual Server Agent NetApp, Inc. SRM Virtual Server Agent
SRM Windows File System Agent NetApp, Inc. SRM Windows File System Agent

Uninstalling NetWare Components

You can uninstall the OES File System, Novell Directory Service, and Novell GroupWise agents 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
ContinuousDataReplicator CVGxCDR
DB2 iDataAgent CVGxDB2
Documentum iDataAgent CVGxDctmIDA
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
MySQL Database iDataAgent CVGxMySQL
NAS NDMP iDataAgents CVGxNAS
OES File System iDataAgent CVGxOES
Oracle iDataAgent CVGxOrIDA
PostgreSQL iDataAgent CVGxPostGres
ProxyHost iDataAgent CVGxProxyIDA
Recovery Director iDataAgent CVGxRD
Resource Pack CVGxRP
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

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:

  • Removing the CommServe stops the entire CommCell from functioning. Do not remove the CommServe software unless you wish to remove the entire data management system. Once you remove the CommServe software, the system can no longer provide services for data protection operations.
  • In order to completely remove the CommServe software from the computer, the Base package must be uninstalled after the CommServe software has been uninstalled.

    Note that the Base package cannot be uninstalled if the CommServe software remains installed on the computer.

  • The CommServe software can only be removed by a user that is a member of the local Administrators group.
  • If you have configured your CommServe and MediaAgent for firewall support, make sure you deconfigure ports you have designated for firewall use.
  • Make sure that you have uninstalled any remotely installed MediaAgents, agents, or client computers prior to removing the CommServe.
  • Close any open user connection to the CommServe database through either SQL Analyzer, Enterprise Manager, isql, osql, or any other. The CommServe Uninstaller may not be able to delete the CommServe database.

CommServe cannot be uninstalled silently.

Uninstalling the MediaAgent

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.

Consider the following prior to uninstalling the MediaAgent software:

  • Before deconfiguring/uninstalling the MediaAgent, you need to manually copy the content available in the deduplication database to the new MediaAgent which you want to host the deduplication database. For more information on changing the MediaAgent hosting the deduplication database, see Deduplication Database Move.
  • Verify that the CommServe computer is accessible and all services on the CommServe and the MediaAgent in which you wish to perform the uninstall are running.
  • If you have a QR Policy configured using the specific MediaAgent, deconfigure the QR Policy before uninstalling 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.
  • If you are uninstalling a Solaris MediaAgent from a UNIX machine, you must first remove the WA SCSI Driver. To do this, remove the CVGxWA package first before you uninstall the MediaAgent.

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:

  • CommServe
  • CommCell Console
  • MediaAgent
  • File Archiver for Windows Agent
  • File Archiver for UNIX Agent
  • Exchange Compliance Archiver Agent
  • Exchange Mailbox Archiver Agent
  • Exchange Public Folder Archiver Agent
  • Domino Mailbox Archiver Agent
  • SharePoint Archiver Agent
  • Data Classification Enabler
  • QuickRecovery Agent
  • ContinuousDataReplicator
  • 1-Touch for Windows
  • Workstation Backup Agent
  • SRM Components

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:

  • Delete the replication set before uninstalling the 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:

  • Ensure that all NAS clients have been deconfigured, or, for NAS NDMP iDataAgents, that they are using storage policies for either NAS attached libraries on another MediaAgent than this one. For more information on deconfiguring a NAS client, see Deconfiguring Agents.
  • 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 NAS NDMP subclients.

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:

  • Once you uninstall the Quick Recovery Agent software, the system can no longer recover the Quick Recovery volumes you have created for that client. Re-install the Agent if you want to recover these previously created volumes.

  • 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.

Removing QSnap Drivers Manually from the 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 the 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

  • Before uninstalling the Exchange Migration Archiver Agents or Outlook Add-In, verify that the Microsoft Outlook application window is closed. In the event that an Outlook Add-In session is still active during uninstall of the Exchange Migration Archiver Agent, the Outlook Add-In's search capability will continue to function however no data will be recovered.
  • Once you uninstall the Exchange Migration Archiver Agent software, the system can no longer provide archive and recovery operations for the client from which the Agent has been removed.
  • Unlike other components, Exchange Compliance Archiver does not give a destination client to retrieve data. If this component is uninstalled, cross-machine retrieval cannot be run.

File Archiver Agents

  • Before uninstalling the File Archiver for Windows Agent, keep in mind that any unrecovered stub files cannot be deleted after uninstalling the agent unless the Microsoft command-line tool to Delete File and Reparse Points (i.e., DELRP.exe) is used to delete them. Refer to www.microsoft.com for more information on the use of this tool.
  • If the File Archiver for UNIX software is uninstalled from a Linux computer, you must subsequently unmount and remount the affected XFS file system(s) without the DMAPI option specified.

SharePoint Archiver Agent

  • After uninstalling SharePoint Archiver, two columns (i.e., Archived and CommVault Stub) are not automatically removed.  These columns are created in Document and Picture Libraries during archive operations using SharePoint Archiver. To remove these columns, use the CleanSPDA tool.

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 Supported Configuration 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.

  • Replication sets can be deleted if the replication pairs are in any of the following states:
    • Stopped
    • New Pair
  • Deleting the source machine will remove job history from that machine.

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.

Uninstalling SRM NAS Components

The following sequence must be used when uninstalling SRM proxy clients:

  1. Uninstall any SRM Updates applied to the filer to be uninstalled.
  2. Deconfigure any SRM NAS clients that were added using the proxy client.
  3. Uninstall the SRM NAS proxy client.

Uninstalling CommNet Components

The following sequence must be used when uninstalling CommNet components:

  1. Uninstall CommNet Server SNMP Enabler

    After uninstalling the SNMP Enabler, stop the NetApp Monitor Service from the Process Manager.

  2. Uninstall CommNet Server
  3. Uninstall CommNet Browser

Uninstall the Search Engine

When uninstalling the Search Engine, first delete the Search Engine from the CommCell console.

  1. In the CommCell console, click Storage Resources > Search Engines.
  2. Right-click the Search Engine you want to uninstall and click Delete.
  3. Click Yes to confirm the operation.
  4. Uninstall the Search Engine software on the client computer as follows:
    If you want to... Then...
    uninstall software from the CommCell console
    1. From the CommCell browser, click Client Computers.
    2. Right-click the client where you want to uninstall software.
    3. Point to All Tasks > Add/Remove Software and then click Uninstall Software.
    4. In the Uninstall Software tab, select the software you want to uninstall.

      You can select Uninstall All to uninstall all the software packages on the client computer.

    5. Click OK.

      You can track the progress of the job from the Job Controller or Event Viewer.

    uninstall software on the physical client computer
    • Follow the procedures to uninstall software for the client's operating system.

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\SnapProtect\Galaxy\Instance001\InstalledPackages\LotusNotesDMClient]

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"

Uninstalling All the Windows Components Simultaneously

If you wish to uninstall all Windows components from a computer simultaneously, you can use the qUninstallAll utility. The utility is available in the Software Store.

When executed, the utility launches the uninstall options for all the software components installed on the computer for a complete removal.

The qUninstallAll utility can also uninstall all components from the computer silently; that is, when executed with a specified parameter, all components will be uninstalled with no user intervention required.

See Uninstall All Windows Components using QUninstallAll.exe for step-by-step instructions.