Deconfigure and Reconfigure Components - Getting Started

Table of Contents

Overview

When you are unable to uninstall a component using the common procedures, you can use the Release a License feature to clean up these components from the CommServe database. This operation, previously known as deconfiguration, does not remove the backup data and registry entries relevant to the component from the host computer. As such, the data is still available for data recovery operations.

It is always recommended that you uninstall components using the common procedures. Releasing a license should be used only when you are unable to uninstall a component. See Uninstall Components for more information.

You can also use this feature when you no longer require a license on a client computer, such as cases where the computer is being retired. The released license can be used later for another computer.

On the other hand, a component whose license was released can be reconfigured. This operation re-enables (or consumes) the license for the deconfigured component.

Support

This feature is supported by all Agents.

The following CommCell entities can be deconfigured:

  • Client
  • Agent
  • MediaAgent
  • Instance

Deconfiguration Sequence

Deconfigure operations vary based on the targeted CommCell entities.

When deconfiguring a client computer with multiple applications, you must take into account that all Agents installed on the client must be first deconfigured. For this reason, we recommend that you use the following deconfiguration sequence:

  1. Application-related Agents (Backup and Recovery Agents, Archiver Agents, ContinuousDataReplicator, etc.)

  2. File System iDataAgents

  3. Client

For NAS iDataAgents, the sequence shown above does not apply. The license for a NAS client can be released without reference to other components.

Releasing a License (Deconfiguration)

Use the following steps to release the license for a client, MediaAgent, Agent or File Archiver instance.

To release license for a MediaAgent, ensure that all the storage policies or copies associated with the configured libraries (or drive pools) in the MediaAgent are deleted or re-associated to another MediaAgent.

  1. From the CommCell Browser, navigate to the CommCell entity from which you want to release a license.
  2. Right-click the name of the CommCell entity, and then click All Tasks | Release License.

    If you are releasing the license for a client/MediaAgent, click All Tasks | Release License for Client/MediaAgent. Then, from the Licenses Consumed pane, select the license to release, click Add and then click OK.

  3. Click Yes to confirm you want to release the license or No to abort.

    If the license is successfully released, the entity is dimmed and available for deletion.

    If the license is not released, a number of popup messages appears. In some cases, the message requests that you take some corrective action. For example, the message might advise you to ensure that there are no jobs running on the agent. In such a case, click OK and take the appropriate action. Then repeat the process.

Deconfiguring Clients

When the license for a client is released, the following will occur:

  • All functionality associated with the client will be unavailable.
  • The related files and registry entries associated with the client will not be removed from the computer.
  • To permanently delete all data and job history, delete the client in the CommCell Console.
  • For NAS iDataAgents, which do not have a software install or uninstall procedure, releasing the license for the NAS client is the same as uninstalling other Agents. After releasing the license, the following occurs:
    • The backup data is still available on the media for the retention period defined in the associated Storage Policy copy. You can browse the backup data or perform restore operations from the client to another active client of the same type within the same CommCell. However, you cannot, restore the data to the original NAS File Server, because the Client is no longer present.
    • The corresponding client icon in the CommCell Browser will appear dimmed. While this icon exists, the Client can still perform restore operations. If you delete this icon, all of the Client’s data is irretrievably lost.
  • All backup and restore job schedules (independent and those part of a schedule policy) that are related to the specific CommCell entity will continue to be displayed in the Schedule Details dialog box after the license for the entity has been released. However, only restore jobs can be performed or scheduled. Also, you will not be able to run, edit, or perform a Run Immediately operation on the schedule unless the CommCell entity is reconfigured.

Deconfiguring Agents

When the license for an agent is released, the following will occur:

  • The Agent License will be recaptured, allowing it to be reused.
  • Related files and registry entries associated with the Agent will not be removed from the computer.
  • To permanently delete all data and job history, delete the Agent in the CommCell Console.
  • All backups associated with the Agent whose license was released will be available for restore.
  • All backup and restore job schedules (independent and those part of a schedule policy) that are related to the specific CommCell entity will continue to be displayed in the Schedule Details dialog box after the license for the entity has been released. However, only restore jobs can be performed or scheduled. Also, you will not be able to run, edit, or perform a Run Immediately operation on the schedule unless the CommCell entity is reconfigured.

Deconfiguring File Archiver Instances

Releasing the license is supported only for the File Archiver for Windows Agent. All instance types can be deconfigured: Local File System, FPolicy, Celerra, and Network File Share.

When releasing the license, the following will occur:

  • The license is released if the instance being deconfigured is the last instance to use that license. The license will be consumed again when a new Instance is created or if the instance is reconfigured.
  • All archived data associated with the instance will be available for recovery. However, functionality related to issuing an archive job will not be available.
  • The related files and registry entries associated with the instances will not be removed from the computer. For example, the subclients associated with the instance will be hidden and can be re-displayed if the instance is reconfigured.
  • To permanently delete all data and job history, delete the instance in the CommCell Console.
  • All backup and restore job schedules (independent and those part of a schedule policy) that are related to the specific CommCell entity will continue to be displayed in the Schedule Details dialog box after the license for the entity has been released. However, only restore jobs can be performed or scheduled. Also, you will not be able to run, edit, or perform a Run Immediately operation on the schedule unless the CommCell entity is reconfigured.

Reconfiguring Components

You can activate a CommCell entity whose license has been released. This operation will again consume a license for the selected entity, enabling all common operations such as the back up of data.

Use the steps below to reconfigure a client, MediaAgent, Agent or File Archiver instance:

  1. From the CommCell Browser, navigate to the CommCell entity from which you want to release a license.
  2. Right-click the name of the CommCell entity, and then click All Tasks | Reconfigure.

    The entity will become active without giving any warning popup message. If needed, press F5 to refresh the CommCell Browser.

Suspending Use of a Client Computer Temporarily

Releasing the license for a client should not be used to briefly suspend the use of the client. Instead, if you need to temporarily make a client enter a suspend mode, follow the steps below:

  • This procedure does not require a user to uninstall client software; therefore, no licenses are released during this process.
  • Any scheduled jobs associated with the suspended client will cause job failures when initiated. This is normal behavior. Once client activity is re-enabled, these scheduled jobs will no longer cause job failures.

  1. Create a new scratch pool that does not contain any media, and name it No_Media. Note that a scratch pool with no media associations does not harm any existing configurations, nor does it misuse media. See Create New Scratch Pool for step by step instructions.
  2. Create a storage policy (standard), name it No_Backups, and point it to the No_Media scratch pool. See Creating a New Storage Policy for step by step instructions.
  3. Disable operations for the client that you are temporarily suspending. See Enabling/Disabling Operations for step by step instructions.
  4. Verify that the jobs are not queued by clearing the Queue jobs if activity is disabled option. This will reduce the number of queued jobs in the Job Controller. See Queuing Jobs for Disabled Operations for more information.
  5. Re-point all the client's subclients to the No_Backups storage policy. When a user changes the storage policy association of a subclient, retention cycles are set to zero (0), therefore, only the retention days must be exceeded for data to be aged. In this case, the data in the storage policy to which the client's subclients were originally pointing to will age accordingly.
  6. To resume client activity, enable operations for the client, and point the subclients back to their original storage policy.

Hiding Deconfigured Clients

You have the option of hiding all clients whose license has been released. This is useful to manage and maintain a clear view of the structure of all active client computers in the CommCell Browser instead of viewing a mix of clients.

  1. From the Home tab of the CommCell Console toolbar, click Control Panel.
  2. Under the Tools section, click User Preferences.
  3. From the User Preferences dialog box, click the Client Computer Filter tab.
  4. Clear the Show Unlicensed with software (Restore only Clients) and Show Unlicensed without software check boxes.
  5. Click OK.

Reinstalling Deconfigured Agents

If you want to reinstall an unlicensed Agent, you must first uninstall the agent software from the computer. See Uninstall Components for more information.

Once the agent has been uninstalled, you may then reinstall the agent software. See Reinstalling Uninstalled Agents for more information.