Automated Migration › Automating OS Migration › Build—Prepare for Migration › Create a Mapping Between Old and New Computer Names

Create a Mapping Between Old and New Computer Names

You must create a mapping between old and new computer names in the following scenarios:

• (optional) To change the computer name after migrating to the new OS, in the case of wipe and reload migration.
• To map the old and new computer names, in the case of machine replacement migration.

The mapping, which is contained in a file, can include either all computers in your IT environment or computers in a particular migration job. In either case, you must create two mapping files; one for Unicenter Desktop DNA and another for automated migration. The following procedure provides the steps for creating the two mapping files.

Note: The computer names included in the machine mapping file must not contain special or localized characters. Allowed characters for computer names are alphabets and numbers only. The hyphen (-) sign is allowed, but it must not be the first or last character. If there are any other special or localized characters in the machine mapping file, the migration job validation will fail.

To create a mapping between old and new computer names

1. Open a spreadsheet application (Microsoft Excel, for example).

   Note: You can create and maintain the mapping information in a text editor such as, Notepad also. However, a spreadsheet application helps you creating and editing the information quickly.

2. Specify the details of the old and new computers. If you are using a spreadsheet application, specify the details given in the following format in separate columns (without commas). Use the following format depending on the migration type:

   Wipe and Reload:

   Source_name,Source_MAC_ID,Destination_name,Source_MAC_ID
   

   Note: As wipe and reload migration is performed on existing computers, the MAC ID must be same for source and destination. Mapping information is optional for wipe and reload migrations and you can even specify a partial list of computers. Computers that are not part of the mapping file retain the old computer name after migration.

   Machine Replacement:

   Source_name,Source_MAC_ID,Destination_name,Destination_MAC_ID
   

   Note: Mapping information is mandatory for machine replacement migrations. The mapping file must contain all the computers that are part of automated migration. Otherwise, the migration job creation will fail.

3. Save the file in .csv format.

   Use this file for automated migration job. You specify the path to this mapping file while creating the migration job.

4. Remove the MAC ID columns from the spreadsheet. Swap the source and destination computer name columns because Unicenter Desktop DNA requires the mapping information in the following format:

   destination_name,source_name
   

5. Click Save As and save the file in .csv format.
6. Rename the .csv file to .txt as Unicenter Desktop DNA requires the map file in .txt format.

   Use the .txt map file for Unicenter Desktop DNA. You specify the path to this mapping file while creating the migration solution package.

   Note: The file name in the path is case-sensitive. If the case does not match with the actual file name, the Apply procedure will fail with an error "DNA file not found."

More information:

Create a Migration Job

Create Migration Solution Packages to Store and Apply DNA