Injection Mapping Files

Description

Injection Mapping files are used to define which source computer contains the user state for a given target computer so that the injection can be fully automated without any administrator intervention required.

Mapping File Structure

Mapping files are XML files with this structure:

<?xml version="1.0" encoding="utf-8"?>
<MappingFile xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://tranxition.com/schemas/mappingfile/2011/5">
  <Mappings>
  <ComputerMapping>
  <SourceComputer>CONTOSO-hr-XP</SourceComputer>
  <TargetComputer>CONTOSO-hr-W8</TargetComputer>
  </ComputerMapping>
  </Mappings>
  <PersonalityRoot>\\MyServer\MigrationManager\Personalities</PersonalityRoot>
</MappingFile>

Each source/target computer pairing is defined in a <ComputerMapping> element with each source and target computer only occurring once in the file.

Creating Mapping Files Using the Injection Mapping Tool

Mapping files can be created with any tool that can create XML files, but the easiest way to create them is to use the Injection Mapping Tool that is provided with Migration Manager:

Creating a New Mapping File

To create a new Mapping File, follow these steps:

  1. Start the Injection Mapping Tool
  2. Click the Browse button to display the folder browser
  3. Select the location where the personalities are located and click the OK button
  4. The tool now reads all of the available personalities and populates the Source column with the names of the computers user state have been extracted from
  5. Enter the corresponding target computer names in the Target column
  6. Click the Save button to save the Mapping File
Note
The mapping file should contain just the base name of the computer, not the fully qualified DNS name.

Adding Source Computers to a Mapping File

Once a Mapping File has been created, additional source computers from subsequent extractions can be added to the file using these steps:

  1. Start the Injection Mapping Tool
  2. Click the Open button to display the Open Mapping File dialog and open the mapping file in question
  3. Click the Refresh button to add all new source computers (i.e. source computers that aren’t already in the Mapping File) to the file.
  4. Enter the target computer names for the new source computers
  5. Click the Save button to save the Mapping File

Importing Source and Target Computers

If you already have the source and target computer information available from another source and can make that available as a CSV file, that file can be imported into the Mapping Tool.

The CSV file must have the following format:

<source computer>,<target computer>

With a single source/target computer pair on each line in the file.

A CSV file can be imported to create a new mapping file or imported into an existing mapping file using these steps:

  1. Start the Injection Mapping Tool
  2. If you want to import into an existing Mapping File, open the file
  3. Click the Import button display the Import CSV File dialog
  4. Select the CSV file to import and click the Open button to add all source systems from the CSV file that aren’t already in the Mapping File
  5. Click the Save button to save the Mapping File