CommCell Migration

Basic Advanced Troubleshooting  

Table of contents

Overview

Migration Components

What is Migrated

What is Not Migrated

Prerequisites

General Requirements

Migration Requirements

Permanent Migration

Export Metadata from the Source CommCell

Import Metadata on the Destination CommCell

Temporary Migration

Export Metadata from the Source CommCell

Import Metadata on the Destination CommCell

View Admin Job History

Post Migration Considerations

Overview

CommCell Migration provides the facility to move Clients or MediaAgents from one CommCell to another for performing cross server restores or on a permanent basis to allow backups to continue in a new CommCell.

Migration Components

What is Migrated

The following components are available for migration:

  1. Client computers and the Agents installed on the Client can be migrated to another CommCell. You can select the individual Agents, Backupsets, and Subclients for migration.
  2. Client Group definitions are migrated but not the associations and the clients associated to the Client group.
    Note that the client group definition is migrated. The actual clients within the group are not migrated unless they are selected for migration.
  3. Subclient policies, schedule policies, users and user groups, media location and alerts associated with the CommCell.
  4. Client configurations such as holidays, operation window, activity control, and schedules can be migrated.
  5. Metadata records associated with the backup data secured by Data Protection operations from the Agents. This includes the following:
  1. MediaAgent details, excluding the library configurations can be migrated to another CommCell. After the migration you will have to manually configure the libraries on the destination CommCell.

What is Not Migrated

The following components associated with a source CommCell are not migrated:

Prerequisites

General requirements

Migration Requirements

Permanent Migration

When computers are relocated or for load balancing, some clients may have to be attached to another CommCell. This process requires permanent migration of the metadata records associated with these clients. The following steps describe the process involved in migrating the metadata of an entire CommCell to another CommCell:

Export Metadata from the Source CommCell

When performing CommCell Migration you will first need to export the metadata associated with the source CommCell. The export operation is performed on the source CommCell, allowing you to select entities that you wish to export from a source CommCell to the specified export location.

Follow the steps given below to export an entire CommCell:

1. From the CommCell Browser, right-click the CommServe, click All Tasks, click CommCell Migration and select Export To Folder.
2. From the General tab on the Export Options dialog box, provide the export location in the Export Folder field. Select Use local for a local path. Select Use Network for a network location. If you select a UNC path, provide the access credentials to access the export location. Click User Name/Password to provide the user details. Select Use Other CS Host to specify other CommServe along with its local path as a host for migration. Select a database from Export entities from list to export metadata.
3. Select the following components for migration from Select Associations.
  • Client(s) that you wish to export. For a client, you can select the individual components such as Agents, Backupsets, and/or, Subclients.
  • Client Computer Groups to select a client group definition for export.
  • MediaAgent that you wish to export. If you select Do Not Select MediaAgents option, the MediaAgents of the selected source clients will not be migrated.
  • Desired CommCell configurations such as Subclient Policies, Schedule Policies, Users and User Groups, Alerts, and Location.

If you select Automatically Select Complete Cluster option, all the physical and the virtual nodes of the selected source cluster will be exported.

4. Click Advanced to view and select the advanced export options from Select Export Options dialog box.
5. From the Job Initiation tab on the Export Options dialog box, select Immediate run the export immediately. Alternatively, you can schedule the export job for a later time.
6. Click OK to export the metadata.  

Import Metadata on the Destination CommCell

The metadata associated with the source CommCell can now be imported into the destination CommCell. The import will use the import entries that you have defined for the destination CommCell.

Follow the steps given below to import metadata of a source CommCell to the destination CommCell:

1. From the CommCell Browser, right-click the CommServe, click All Tasks, click CommCell Migration and select Import From Folder.
2. From the Import Wizard, provide the import location in the Import Folder field. Select Use local for a local path. Select Use Network for a network location. If you select a UNC path, provide the access credentials to access the import location. Click User Name/Password to provide the user details. Click Next.
3. From Select CommCell to Import window, select a CommCell to import and click Next.
4. From the Specify Target Libraries for Imported Media and Future Backups window, provide the media mapping options to import data from the source CommCell. Select the library, MediaAgent, drive pool, and spare group on the destination CommCell for importing data and click Next.

  • You need to map the MediaAgent in order to associate the media. The MediaAgent should have a compatible media library to map and import the metadata from source on to the destination CommCell.
  • Ensure that you copy the disk libraries to the appropriate computer specified during the import operation.
  • The CV_MAGNETIC folder must have read-write access in the destination CommCell. For example, if you make copies of the CV_MAGNETIC folder using a disc, ensure that the contents are copied to a computer, so that it can be accessed during a restore operation.
5. From the Specify Target Libraries and Mount Path Details for Imported Disk Data window, you can view the default MediaAgent, Device Name and Mount Path on the Source CommCell for importing metadata.

The Mount Path and Library on the destination CommCell are displayed by default in this window. If you wish to change the destination mount path, click Edit to provide the destination Library Name and MediaAgent Name for importing metadata. Verify the mount path mapping on the Source Mount Path Mapping window and click Next.

If you are mapping the Source Mount path for the first time, the MediaAgent, Device Name, destination library and Mount Paths will appear in Blue.

6. From the Specify new Locations for Dedupe Database window, specify the target MediaAgent and target SIDB access path on the destination CommCell for importing data and click Next. The SIDB needs be copied on to the destination CommCell. Otherwise, it cannot be pruned.

If you use the Global Dedup Policy as the storage policy, then the mapping path in the Specify new Locations for Dedupe Database window will appear in Italics.

For more information on SIDB/SILO configuration and mapping on the destination CommCell, see SIDB/SILO configuration.

7. From the Client Name Mapping window, specify a new name for the client if required. If nothing is specified the old name will be used. Click Next.

  • Migrated clients can be deconfigured from original CommServe module, before renaming the client in the migrated setup.
  • If a firewall is configured for the migrated client, then you need to uninstall and reinstall the client on the destination CommCell after the migration.
8. From the Import Options window, select the Consume license(s) option to consume the license on the destination CommCell after the import is completed click Next.

  • Ensure that you have a license available on the destination CommCell.
  • The destination client will be enabled once all data has been migrated. If you choose not to consume a license during this operation, the client data will be migrated, but the destination client will not be enabled.
9. From the Import Options window, review the selected import options and click Next.
10. From the Job Initiation window, select Immediate to start the import process. Alternatively, you can schedule the import job for a later time.
11. Click Finish to complete the import operation.  
12. From the Control Panel, Click Name Management Wizard to change the CommServe Name.

You can also right click the client in the destination CommCell. From the Client Computer Properties dialog box, click Name Change to change the CommServe host name.

13. From the Name Management Wizard, select Update CommServe for clients. Click Next to Proceed.
14. Select the old CommServe hostname from which you wish to migrate the clients to the current CommServe and click Next to proceed.
15. Select the clients that you wish to update with this change from the list and click Finish to complete the migration process.

Temporary Migration

The following section describes the process of performing a temporary migration of a CommCell. You may be need to perform a temporary migration in any of the following cases:

The clients and configuration settings that are temporarily migrated exist in the source CommCell and destination CommCell. The properties and associations of clients and configurations in the destination CommCell exist as in the source CommCell.

Export Metadata from the Source CommCell

When performing CommCell Migration you will first need to export the metadata associated with the source CommCell. The export operation is performed on the source CommCell, allowing you to select entities that you wish to export from a source CommCell to the specified export location.

Follow the steps given below to temporarily export the metadata from a source CommCell on to a destination CommCell:

1. From the CommCell Browser, right-click the CommServe, click All Tasks, click CommCell Migration and select Export To Folder.

  • Make sure to specify only the names of clients that you wish to temporarily migrate during the Export process.
2. From the General tab on the Export Options dialog box, provide the export location in the Export Folder field. Select Use local for a local path. Select Use Network for a network location. If you select a UNC path, provide the access credentials to access the export location. Click User Name/Password to provide the user details. Select Use Other CS Host to specify other CommServe along with its local path as a host for migration. Select a database from Export entities from list to export metadata.
3. Select the following components for migration from Select Associations.
  • Client(s) that you wish to export. For a client, you can select the individual components such as Agents, Backupsets, and/or, Subclients.
  • Client Computer Groups to select a client group definition for export.
  • MediaAgent that you wish to export. If you select Do Not Select MediaAgents option, the MediaAgents of the selected source clients will not be migrated.
  • Desired CommCell configurations such as Subclient Policies, Schedule Policies, Users and User Groups, Alerts, and Location.

If you select Automatically Select Complete Cluster option, all the physical and the virtual nodes of the selected source cluster will be exported.

4. Click Advanced to view and select the advanced export options from Select Export Options dialog box.
5. From the Job Initiation tab on the Export Options dialog box, select Immediate run the export immediately. Alternatively, you can schedule the export job for a later time.
6. Click OK to export the metadata.  

Import Metadata on the Destination CommCell

The metadata associated with the client in a source CommCell can now be temporarily imported on to the destination CommCell. The import will use the import entries that you have defined for the destination CommCell.

Follow the steps given below to temporarily import metadata of a source CommCell on to the destination CommCell:

1. From the CommCell Browser, right-click the CommServe, click All Tasks, click CommCell Migration and select Import From Folder.
2. From the Import Wizard, provide the import location in the Import Folder field. Select Use local for a local path. Select Use Network for a network location. If you select a UNC path, provide the access credentials to access the import location. Click User Name/Password to provide the user details. Click Next.
3. From Select CommCell to Import window, select a CommCell to import and click Next.
4. From the Source Mediatype Mapping window, provide the media mapping options to import data from the source CommCell. Select the library, MediaAgent, drive pool, and spare group on the destination CommCell for importing data and click Next.

  • You need to map the MediaAgent in order to associate the media. The MediaAgent should have a compatible media library to map and import the metadata from source on to the destination CommCell.
  • Ensure that you copy the disk libraries to the appropriate computer specified during the import operation.
  • The CV_MAGNETIC folder must have read-write access in the destination CommCell. For example, if you make copies of the CV_MAGNETIC folder using a disc, ensure that the contents are copied to a computer, so that it can be accessed during a restore operation.
5. From the Source MountPath Mapping window, you can view the default MediaAgent, Device Name and Mount Path on the Source CommCell for importing metadata.

The Mount Path and Library on the destination CommCell are displayed by default in this window. If you wish to change the destination mount path, click Edit to provide the destination Library Name and MediaAgent Name for importing metadata. Verify the mount path mapping on the Source Mount Path Mapping window and click Next.

If you are mapping the Source Mount path for the first time, the MediaAgent, Device Name, destination library and Mount Paths will appear in Blue.

6. From the Shared Library Device Mapping window, click Edit to provide the Target MediaAgent and Device Path for importing metadata.

Verify the device mapping on the Shared Library Device Mapping window and click Next.

7. From the Dedupe Database Mapping window, specify the target MediaAgent and target single instance (SIDB) access path on the destination CommCell for importing data and click Next.
8. From the Client Name Mapping window, specify a new name for the client if required. If nothing is specified the old name will be used. Click Next.

  • In the case of temporary migration, it is recommended to use the old names and mapping for continuous replication from source CommCell.
9. From the Import Options window, review the selected import options and click Next.
10. From the Import Options window for client import and datapath options, review the selected import options and click Next.
11. From the Job Initiation window, select Immediate to start the import process. Alternatively, you can schedule the import job for a later time.
12. Click Finish to complete the import operation.  
13. From the Control Panel, Click Name Management Wizard to change the CommServe Name.

You can also right click the client in the destination CommCell. From the Client Computer Properties dialog box, click Name Change to change the CommServe host name.

14. From the Name Management Wizard, select Update CommServe for clients. Click Next to Proceed.
15. Select the old CommServe hostname from which you wish to migrate the clients to the current CommServe and click Next to proceed.
16. Select the clients that you wish to update with this change from the list and click Finish to complete the migration process.

View Admin Job History

You can view the CommCell Migration job history from the Admin Job History window. Once a migration job is completed, it may be useful to view specific historical information about the job, such as the following:

  1. From the CommCell Browser, right-click the CommCell whose migration history you want to view, click View, and then click View Admin Job History.
  2. For the source CommCell, select the CommCell Export as job type from the Admin Job History filter window to view the export history.
  3. For the destination CommCell, select the CommCell Import as job type from the Admin Job History filter window to view the Import history.
  4. Select the desired filter options such as time range, job status, number of jobs etc.
  5. Click OK.

Post Migration considerations

Back to Top