Uninstall Components from a Unix or Macintosh Computer


Click on a link below to go to a specific section of the component uninstallation:

Overview

The following sections describe the steps in uninstalling a component from a Unix or Macintosh computer in clustered and non-clustered environments.

Before You Begin

Consider the following before you uninstall a component from your computer:
  • Application Agents, such as Oracle, Informix, etc., must be uninstalled first.
  • Once all the Application Agents are uninstalled, the Unix File System iDataAgent, OES File System iDataAgent, or Macintosh File System iDataAgent must be uninstalled.
  • Once all the components have been uninstalled, the Base package (cvpkgrm) must be removed.
  • 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.

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

Consider the following for deconfiguring virtual machines in clustered environments:

  • Clustered environments pertain only to HP-UX, Linux, and Solaris clients.
  • You will need to deconfigure the Unix File System iDataAgent from each virtual machine first before uninstalling it from the physical nodes.
  • You will then need to uninstall the Unix File System iDataAgent and Base software (cvpkgrm) from the client computer hosting the software. You can uninstall the Base software from your client computer by entering the cvpkgrm command from a command line and then completing the directives in the resulting script. This script deletes the appropriate files and executables, and it removes the registry entries from the system.
  • To deconfigure a virtual machine completely, 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.

Consider the following for MediaAgent uninstalls:

  • 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.
  • Ensure that you remove the NDMP Remote Server software, if the software has been installed along with the MediaAgent.
  • If you have a QR Policy configured using the specific MediaAgent, deconfigure the QR Policy before uninstalling the MediaAgent.

Consider the following for NDMP Remote Server (NRS) uninstalls:

  • Ensure that all NAS clients have been deconfigured, or, for NAS NDMP iDataAgents, that they are using storage policies for either NAS attached libraries or for NRS attached libraries on another MediaAgent than this one. For more information on deconfiguring a NAS client, see Deconfiguring Agents.

Consider the following for Quick Recovery Agent uninstalls:

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

Consider the following for OES File System uninstalls:

  • All components on the virtual servers must be uninstalled prior to uninstalling any components from the physical server.

Consider the following for Unix component uninstalls:

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

Uninstall Procedure

1. Read the Before You Begin section before continuing with the uninstall procedure.
2. Log on to the client computer as root.
3. At a command prompt, enter the following:

cvpkgrm

Press ENTER.

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

NOTES

  • For computers that do not use Multi Instancing, you will not see this menu. Proceed to the next step.

 

 
5. Select a component 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.)

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.

NOTES

  • The list of components displayed in the menu will depend on the modules installed on the computer and may appear different than the example shown.
  • 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.
 

Deconfigure Virtual Machines or Modules

Follow this procedure to deconfigure virtual machines or modules:
  1. Read the Before You Begin section before continuing with the uninstall procedure.
  2. Execute the cvpkgrm command on the appropriate host machine.

    Press ENTER.

  3. 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.)
  4. Once a module is removed, the menu will be redisplayed. You can select another module to remove or exit the uninstall program.
  5. 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.
  6. If all of the required deconfiguration is now completed, you can now uninstall the client software as discussed in Uninstall Procedure.
  7. Repeat Steps 3 through 5 for any remaining hosts you would like to deconfigure.
  8. Once all hosts have been deconfigured, the uninstall procedure is complete.