Uninstalling Components - How To

Table of Contents

Uninstall Components Using the CommCell Console

Required Capability: See Capabilities and Permitted Actions

To enable offline archiving on a subclient:

  1. From the CommCell Browser, right-click the desired Client Computer or MediaAgent, and click All Tasks > Add/Remove Software > Uninstall Software from the shortcut menus.
  2. From the Uninstall Software dialog box, select the components to uninstall from the client computer or MediaAgent.
  3. Verify the selections you made; you will not be prompted with a confirmation window for the removal of the software package selected. 
  4. Click Uninstall.

Uninstall Components from a Windows Computer

Before You Begin

To uninstall components from a Windows computer:

  1. Log on to the client computer as local Administrator or as a member of the Administrators group on that computer.
  2. Open the Add/Remove Programs icon in the system’s Control Panel.

    For Windows Vista/Windows 2008, click Uninstall a Program under Programs in the Control Panel.

  3. Select the component to be uninstalled and then click Remove.

    • If you are uninstalling components from a Microsoft Windows Vista or Microsoft Windows Server 2008 platform, a message is displayed asking if you would like to stop services prior to continuing the uninstall. Select Do Not Close Applications if this message appears.
    • If you are uninstalling from a computer that uses Multi Instancing, you will see the Instance number to which each component was installed; be sure to select the correct instance of the component you want to remove.
    • If you are uninstalling Workstation Backup Agent, note that the uninstallation will proceed silently. So perform the following before uninstalling the agent:
      • Ensure that there are no active jobs for this agent.
      • Delete the Replication Set.

  4. Click Yes to confirm.

    • If you are uninstalling the CommServe, observe the following:
      • Make sure all other platforms are uninstalled before continuing.
      • You will need to provide the SQL password for the System Administrator account before continuing.

  5. Select the desired language and click Next to continue.

    If you are not uninstalling a MediaAgent, skip to Step 8.

  6. Click Yes to delete any configured storage policies.

    When you uninstall a MediaAgent without deleting a Storage Policy, you can re-install the MediaAgent in a new directory or on a new computer without losing the data.

  7. Type Confirm to confirm the removal of the MediaAgent software and then click OK.
  8. Click Yes to delete the folder containing your log files, job control files and program files.
  9. Click Yes to delete the install folder.

    • You will be prompted to delete the install folder only if the component you are uninstalling is the last component remaining on the computer.
    • If you are uninstalling the CommServe, the uninstall program does not delete the <install directory>/base folder. These folders are only removed when your host machine is restarted. If you do not want to restart your host system, then manually delete these folders.

  10. Click OK.

    This completes the software uninstall procedure.

Post-Uninstall Considerations

  • Once all components have been uninstalled, you must uninstall the Base software. The Base software can be uninstalled by repeating this procedure. Note that the Base software cannot be uninstalled until all other components have been uninstalled.

Uninstall Components from a UNIX or Macintosh Computer

Before You Begin

To uninstall components from a Unix or Macintosh computer:

  1. Log on to the client computer as root.
  2. At a command prompt, enter the following:

    cvpkgrm

    Press ENTER.

  3. If you are uninstalling from a computer that uses Multi Instancing, select the instance from which you want to remove a component.

    For computers that do not use Multi Instancing, you will not see this menu. Proceed to Step 4.

  4. Select a component to uninstall from the menu and follow the on-screen prompts for removing the component software.

    Once a component is removed, the menu will be redisplayed. You can select another component to remove or exit the uninstall program.

    Once the last component has been removed from a computer, the uninstall program will automatically exit.

  5.  Optionally, you can select an option All the above Module(s) to uninstall all installed components.

Uninstall Considerations

If you just uninstalled any Linux version of the Unix File System iDataAgent, Oracle iDataAgent, Oracle RAC iDataAgent, or Unix MediaAgent that had been installed using a package management system, be sure to run the appropriate additional command to uninstall the software completely.

  • For software that had been installed using the RPM package management system, run the following commands:
    • To get the list of installed RPM package management system files:

      rpm -qa

    • To uninstall the RPM package management system files:

      rpm -e <pkgfile>

      where

      <pkgfile> is the name of the RPM package management system file

      For example:

      rpm -e rely_version1.rpm

  • For software that had been installed using the APT package management system, run the following command:

    dpkg -e <pkgfile>

    where

    <pkgfile> is the name of the APT package management system file

    For example:

    dpkg -e rely_version2.deb

Uninstall Using BackupUninstall Application on a Macintosh Computer

You can uninstall components using the BackupUninstall application.

For this uninstall method  to work, BackupUninstall application has to be added to the Mac login items so that the application is launched and run in the background each time the user logs in. This is done automatically by  the  SnapProtect Installer.

Once this is done, from the /Applications directory you can drag and drop the Process Manager link on to the Trash icon or control-click the Process Manager link and select Move to Trash from the menu.

  1. Log on to the computer with an administrator account.
  2. Navigate to the /Applications directory and control-click Process Manager.
  3. Click Move to Trash.

    This screen appears if you have multiple instances configured on the computer. Select the instance to uninstall, and then click OK.

  4. In the Name and Password boxes, type the user name and password for the administrator account,  and then click OK.

  5. Click OK.

Deconfigure Virtual UNIX Machines or Modules

Before You Begin

To deconfigure virtual machines or modules:

  1. Execute the cvpkgrm command on the appropriate host machine.

    Press ENTER.

  2. Select a module to uninstall from the menu and follow the on-screen prompts for removing the component software. (For a complete list of Unix components, see Components on Unix.)
  3. Once a module is removed, the menu will be redisplayed. You can select another module to remove or exit the uninstall program.
  4. The modules on this host for the virtual machine are now deconfigured. Return to Step 1 to deconfigure other host(s) for the virtual machine.
  5. If all of the required deconfiguration is now completed, you can now uninstall the client software as discussed in Uninstall Components from a Unix Computer.
  6. Repeat Steps 3 through 5 for any remaining hosts you would like to deconfigure.
  7. Once all hosts have been deconfigured, the uninstall procedure is complete.

Remove QSnap Drivers Manually from the Windows Computers

Before You Begin

To manually remove QSnap (CXBF) drivers from Windows computers:

  1. Remove the following after manually removing a dependent Agent, and prior to rebooting the machine:
    • In C:\WINNT\system32\drivers (Windows 2000) or C:\WINDOWS\system32\drivers (Windows 2003), delete the appropriate driver file for your operating system:

      QsnpWNET

      QsnpXP

      QsnpW2K

      Using Registry Editor incorrectly can cause serious problems that may require a reinstall of the operating system. Microsoft does not guarantee that problems resulting from the incorrect use of Registry Editor can be solved. Use Registry Editor at your own risk. You must also understand how to restore the registry if a problem occurs. For information about how to backup and restore the registry, refer to the appropriate Registry Help Topic provided in Regedit.exe or Regedt32.exe.

    • In the registry, go to HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services and delete the appropriate registry key for your operating system:

      QsnpWNET

      QsnpXP

      QsnpW2K

    • In the registry, go to HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Class\{71A27CDD-812A-11D0-BEC7-08002BE2092F} and remove qsnap from the value data for the UpperFilters key.

Remove QSnap Drivers Manually from the UNIX Computers

Before You Begin

AIX:

To manually remove QSnap (CXBF) drivers from AIX computers:

  1. Unmount all CXBF devices or quit applications that are using raw CXBF devices.
  2. Use the command line utility in /sbin/cvsnap to invoke the cvsnap command.
  3. Type the show_filters command to see all CXBF devices.
  4. Stop and delete all devices (e.g.: cvsnap>stop_filter minor=1 and cvsnap>delete_filter minor=1); 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 stopping and deleting all CXBF devices, quit cvsnap. (Type quit and press Enter.)
  6. Execute the following commands: rm /sbin/cxbf-bootscript1.rc and rm /sbin/cxbf-bootscript2.rc.
  7. Remove all CXBF device entries from /etc/filesystems and replace them with original entries which were commented.
  8. Execute the following commands: rm /usr/lib/drivers/cxbf and rm /etc/cxbfdd.conf.
  9. Execute the following command: rmdev -dl cxbf0. 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 /sbin/cvsnap and rm /etc/galaxy/.*.

Linux:

To manually remove QSnap (CXBF) drivers from Linux computers:

  1. Unmount all CXBF devices or quit applications that are using raw CXBF devices.
  2. Use the command line utility in /sbin/cvsnap to invoke the cvsnap command.
  3. Type the show_filters command to see all CXBF devices.
  4. Stop and delete all devices (e.g.: cvsnap>stop bfminor=1 and cvsnap>delete bfminor=1); 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 stopping and deleting all CXBF devices, quit cvsnap. (Type quit and press Enter.)
  6. Execute the following commands: rm /sbin/cxbf-bootscript1.rc and rm /sbin/cxbf-bootscript2.rc.
  7. Remove all CXBF device entries from /etc/fstab.
  8. Execute the following commands: rm /lib/modules/2.6.18-92.e15/extra/cxbf.ko.
  9. Execute the following command: rmmod cxbf. 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 /sbin/cvsnap and rm /etc/galaxy/.*.

Solaris:

To manually remove QSnap (CXBF) drivers from Solaris computers:

  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>defunt 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 /usr/kernel/drv/cxbf.conf.
  9. Execute the following command: rem_drv cxbf. 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/.*.

Deconfigure a CXBF Device in Volume Explorer

Use the following procedure to deconfigure CXBF devices using Volume Explorer.

Before You Begin

  • If a CXBF device on AIX was configured using Volume Explorer (where the CXBF device was added to /etc/filesystems), be sure to mount the CXBF device before you deconfigure it. If an unmounted CXBF device on AIX is deconfigured using Volume Explorer, the /etc/filesystems system file will be out of synchronization with the actual file system configuration.

    If /etc/filesystems and the actual file system configuration get out of synchronization, a manual edit of /etc/filesystems is required to correct the inconsistencies. Remove the cxbf entry and uncomment the original entry (that is, remove "*Galaxy" from the beginning of each line).

  • If you encounter errors while configuring or deconfiguring CXBF devices on the client, go to /cvd.log on the client for more detailed information concerning the error.

Required Capability: See Capabilities and Permitted Actions

To deconfigure a CXBF device:

  1. From the Tools menu in the CommCell Console, select Control Panel; or (if applicable), go to the Subclient Properties (Content) tab for your agent.
  2. Click or double-click Volume Explorer and then click Yes at the warning prompt.
  3. Select the host connected to the volume you want to configure.
  4. Right-click the volume and select Deconfigure cxbf device.
  5. Click Ok to deconfigure the cxbf device.

Uninstall All Windows Components Using QUninstallAll.exe

Before You Begin

  • You must have a valid user account on the Cloud Services website. To create an account, see Getting Access to the Cloud Services Web Site.
  • To run this utility, you must be an administrator or use the Run as administrator option available when you right-click QUninstallAll.exe.

Procedure

  1. Go to the Software Store page on the Cloud Services Access website.

    On the Software Store page, the software media items are displayed.

  2. On the left side of the page, under the Category filter, click Tools and then Uninstall.

    Tip: Type "uninstall" in the search field and then press Enter.

  3. Click the Download button next to the version of the quick uninstall utility you need.
  4. Once you download the qUninstallAll utility from the Software Store, copy it to a local directory on the computer where you want to uninstall the software.
  5. Double-click the utility to extract the files.

    By default, the files are extracted into the cvtoolquninstallall folder.

  6. Use one of the following uninstall methods:

    Interactive Uninstallation

    Double-click QUninstallAll.exe and follow the on-screen prompts to continue with the uninstall.

    Silent Uninstallation

    Run the following command to remove all components from the computer:

    QUninstallAll.exe /q

    Silent Uninstallation of a Specific Instance

    If the computer has multiple SnapProtect instances, run the following command to remove all components from a specific instance:

    QUninstallAll.exe /q /inst instance_name

    The instance name must be in the following format: Instancennnn. For example, Instance0001.

Uninstall Software from CommCell Console from the Client Level

To uninstall software from CommCell Console from the client level:

  1. From the CommCell Browser, right-click the client, and click All Tasks > Add/Remove Software > Uninstall Software.

     This will launch the Uninstall Software Options dialog box.

  2. In the Uninstall Software tab, select the software packages you want to uninstall or select Uninstall All to uninstall all the software packages.

    Enable the Force Uninstall if remote client is unreachable option so that if any client computer scheduled for uninstall is unreachable, the license will still be released from the CommServe database.

  3. Initiate the job to run immediately, or schedule it from the Job Initiation tab.
  4. Click OK.

Uninstall the Outlook Add-In

Before You Begin

Procedure

  1. Log on to the Outlook client computer as local Administrator or as a member of the Administrators group on that computer.
  2. Open the Add/Remove Programs icon in the system’s Control Panel.

    For Windows Vista, click Uninstall a Program under Programs in the Control Panel.

  3. Select NetApp, Inc. DataArchiver Outlook Add-In.
  4. Click Remove to uninstall the application.
  5. Click Yes to confirm the uninstall of the application.

    This completes the Outlook Add-In software uninstall.

Delete the Agent

Before You Begin

You can perform agent operations as long as the agent is installed and appears enabled in the CommCell Browser. However, if you have no need to run jobs on the agent data of a client computer, you may want to delete the agent that resides on that computer. Once you have uninstalled or DeConfigured the agent, the corresponding icon in the CommCell Browser is grayed out. While this icon exists, you can recover data from the agent to another client. If you delete this icon, all of the agent's data is irretrievably lost.

NOTES

  • You cannot delete an agent while operations for that agent are running.
  • NAS clients do not use this procedure; for NAS, see Uninstalling Components.

Deleting the agent is a two-phase process.

  • You need to uninstall or DeConfigure the agent software from the client computer. Doing so frees an agent license, thereby allowing you to install it on some other computer whose data you do want to secure.
  • After you delete the client software, you can either leave the corresponding data intact for appropriate action, or you can remove the data immediately. If you choose to remove the data immediately, you must delete the agent from the CommCell Browser.

Required Capability: See Capabilities and Permitted Actions

To delete an agent:

  1. From the CommCell Browser, right-click the icon of the agent that you want to delete, and then click Delete. (The agent software must first have been uninstalled/DeConfigured or the delete option on the shortcut menu will not appear.)
  2. A warning message prompts you with the following: This operation will permanently delete the data backed up from this level and it cannot be restored. Click Ok to continue with the deletion operation. (Clicking No will abort the operation.)
  3. From the Confirmation Text dialog box, enter the confirmation text string, erase and reuse media. Click Ok. The agent icon and the data that corresponds to the selected agent will be deleted. Consequently, you will not be able to browse or recover this data.

Delete a Client Computer

Before You Begin

  • Before deleting the client computer for most agents, remove the base client software.
  • In order to remove the base client software, there must be no agents installed on the client computer.

Required Capability: Capabilities and Permitted Actions

To delete a client computer:

  1. From the CommCell Browser, right-click the <Client Computer> that you want to delete, and then click All Tasks | Delete.

    If the Delete command is not available, then you have not successfully deleted the base client software from the client computer. Right-click the <Client Computer> and then click All Tasks | Release License for Client.

    Click Yes to confirm the license release. The client icon in the CommCell Browser is displayed as deconfigured (or grayed out). After this, you can proceed to delete the client.

  2. A confirmation message appears. Click Yes to delete the client computer.

    If you click Yes, the backup data that corresponds to the selected client computer is deleted. Consequently, you will not be able to browse or restore this data. The client computer icon is removed from the CommCell Browser.

Delete a Pseudo-Client

Before You Begin

  • For NAS clients, the client must first be deconfigured before you can delete it. For more information, see Deconfiguring Agents.

Required Capability: Capabilities and Permitted Actions

To delete a pseudo-client:

  1. From the CommCell Browser, right-click the icon of the pseudo-client that you want to delete, click All Tasks and then click Delete from the short-cut menu.

    For a NAS client, if the Delete command is not shown, you have not deconfigured the client, and the Deconfigure command will be shown instead; refer to Deconfiguring Agents. (There is no base client software for a NAS Client.)

  2. A confirmation message is displayed. Click OK, type the supplied phrase in the Enter Confirmation Text dialog box, and click OK. The pseudo-client icon should be removed from the view.

Delete a Client Computer Group

Required Capability: Capabilities and Permitted Actions

To delete a client computer group:

  1. From the CommCell Browser, right-click the icon of the client computer group that you want to delete, click All Tasks and then click Delete from the short-cut menu.
  2. A confirmation message appears. Click Yes to delete the client computer group or click No to cancel the deletion.

    If you click Yes, the client computer group is deleted. However, the clients of the group are still available.