Uninstalling Commvault Remotely Using the CommCell Console

You can uninstall Commvault packages from remote client or MediaAgent computers by using the CommCell Console.

Before You Begin

• Verify user permissions:

  • To uninstall from the CommCell Console, you must be a CommCell user with Install Package/Update permissions on the clients where the software will be uninstalled.

    For information on assigning user permissions, see Associating Entities and Roles to a User.

  • If the Authentication for Agent Installs feature is enabled, users must have Install Client permissions at the CommCell level. During the uninstallation, the program prompts for the user account credentials to validate the operation.

• For a successful uninstallation, you must review some preparation tasks for the software package that you want to uninstall. For more information, see Prepare to Uninstall Commvault from Client and MediaAgent Computers.

• Determine whether you want to save the selections you make during the uninstallation in a script so that you can run it later from the command-line interface.

Procedure

1. Use one of the following ways to access the uninstallation options:

   • To uninstall from a single client:

     From the CommCell Console browser, expand Client Computers, right-click the Client, and then click All Tasks > Add/Remove Software > Uninstall Software.

   • To uninstall from multiple clients:

     1. From the CommCell Console ribbon, on the Tools tab, click Add/Remove Software > Uninstall Software.

     2. In the Uninstall Software Options dialog box, select the clients from where you want to uninstall the software.

2. On the Uninstall Software tab of the Uninstall Software Options dialog box, complete the following steps :

   1. Select the packages that you want to uninstall.

      Important: If you select the File System Core, all Commvault packages will be uninstalled. Commvault packages are dependent on the File System Core.

   2. If you want to perform the uninstallation even when the client is unreachable, select the Force Uninstall if remote client is unreachable check box.

      The client information will be removed from the CommServe database, and the licenses used by the client will be released.

   3. If you want to configure advanced options, such as controlling the running time of the job, click Advanced, and in the Advanced Options for Remove Software dialog box, click Help for more information.

3. Choose whether you want to schedule the uninstallation job.

   By default, the job is configured to run immediately. To schedule the job, complete the following steps:

   1. On the Job Initiation tab, click Schedule and then click Configure.

   2. In the Schedule Details dialog box, provide the schedule details and click OK.

4. Choose whether to save the installation as a script:

   • To run the uninstallation job, click OK.

     Tip: When the job starts, you can track the progress of the job from the Job Controller window (CommCell Console ribbon > Home tab > Job Controller).

   • To save the installation as a script, complete the following steps:

     1. Click Save as Script.

     2. In the Save as Script dialog box, from the Client list, select the client computer where you want to save the script.

        The client computer must be able to establish connections with the computers where you plan to uninstall the software.

     3. In the File Path box, specify the file name and location where you want to save the script.

     4. If the user who is logged on the CommCell Console does not have sufficient privileges to perform the Save as Script operation, click Use a different user account and enter the name and password of a user account with sufficient privileges.

     5. Click OK.

        The script is saved as an .xml file and .bat file on the client you selected. If a file with the same name exists in the specified location, the .xml file is created with a timestamp. The .bat file overwrites any existing .bat file.

        To run the script from the command-line interface, see Running the Remote Uninstallation Script from the Command Line.

        Note

        If you uninstalled all packages from a client, the client is displayed as unavailable in the CommCell Console browser.

What to Do Next

• If the CommServe server could not connect to a client, and if you enabled the option to force the uninstallation job, you must uninstall the packages locally from the client to complete the uninstallation process. Based on the client's operating system, select the appropriate procedure:

  • Uninstalling Commvault Locally from Windows Clients

  • Uninstalling Commvault Locally from UNIX and Linux Clients

  • Uninstalling Commvault Locally from a Macintosh Client

• You can continue to browse the client data and perform out-of-place restores. However, if you no longer need the client data, you can delete the client from the CommCell Console. For instructions, see Deleting a Client Computer.