Identity Management Service › Connectors Guide › Connecting to Endpoints › CA Access Control Connector › How to Migrate Data

How to Migrate Data

This section applies to Identity Management only.

CA IAM Connector Server comes with a tool that helps you migrate account templates and their associations to objects in the new connector. If Identity Management already manages ACF2 endpoints using the plugin connector, you can use the existing ACF2 data with the new connector.

This tool migrates the following data:

• Account templates

  The migrated account templates have the same name as the old account templates.

• Associations between account templates and endpoints, roles, and accounts

You cannot use this tool to migrate endpoint objects. Before you can migrate other data, acquire and explore the endpoints with the new connector.

1. Before you migrate data, set up the connector without correlating, using the steps in How to Connect to ACF2.
2. Create two migration mapping files.
3. Migrate the data
4. Repair migration errors
5. Correlate the data.

Create Two Migration Mapping Files

The migration tool works with two mapping files:

• (Required) A file that specifies which old endpoints are migrated to which new endpoints.

  The endpoint mapping file uses the following format:

  OldEndpointName=NewEndpointName
  

• (Optional) A file that specifies any custom attributes that you plan to manage.

  The custom attribute mapping file uses the following format:

  from-custom-attribute=to-endpoint-attribute
  

  The mapping file has the same format and contents as the schema_map.txt used in Provisioning Manager and Provisioning Server. You can use schema.txt as the mapping configuration file for the migration.

Follow these steps:

1. Set up any custom attributes in the new endpoint in Identity Management.
2. Prepare the endpoint mapping file. Only the old endpoints that are specified in this mapping file are migrated.

   When you run the mapping tool, use the –c option to specify the path to the mapping file.

3. Prepare the mapping file for any custom attributes, if necessary.

   When you run the mapping tool, use the –m option to specify the path to the mapping file.

Example: Endpoint mapping file

In the example below, the administrator chooses to keep the endpoint name the same:

MFTSS.org.com=MFTSS.org.com

Example: Custom attribute mapping file

CustomAttribute001=VSE-IES-Dflt-Usercat
CustomAttribute002=VSE-IES-Fld1