Secure Copy 5.x and up - What is a 'map file' and how is it used? (SL317)

A map file is a text file that creates a mapping between source and target groups and users. Using a map file allows administrators greater flexibility in the way that local groups/users are migrated, either from one computer to another, to an NT domain, or to Active Directory.

Note: Map files cannot be used to create mappings for domain groups.

Map files are most commonly used when local group/user accounts include the source computer's name.

For example, you need to migrate data from Server1 to Server2. Permission entries on the data include the local groups LocalGroup1_Server1 and LocalGroup2_Server1.

If the data is copied using the Migrate Local Groups option, the data is copied to Server2, but the access control lists for the data would still reference LocalGroup1_Server1 and LocalGroup2_Server1.

Using a Map file provides a means of modifying the behavior of the local group migration so that once the job completes, the access control lists for the data would reference LocalGroup1_Server2 and LocalGroup2_Server2.

You must create a map file before the job is run. Specify the path to the map file in the Migrate Local Groups menu in Secure Copy

To create a map file, create a text file with each name mapping on a new line as shown below: