Configuring Replicator from a Template File (4286448)

Exporting Configuration Settings

To export the Replicator configuration for a farm,

1. Run the following command to export the current farm settings:

Export-ReplicatorSettings -FileName "C:\filenameofyourchoice.xml"

The powershell command is available only form the Management console. For more information on the command, see the Metalogix Replicator Command-line Reference Guide.

This exports Replicator settings for the entire farm to the filename you chose. No passwords are saved in the file and you must later add passwords before importing this file.

Restoring Configuration Settings to a Farm

To restore the complete configuration settings to a farm, do the following:

1. Edit the exported configuration file in a text editor.
2. Search the file for the following lines and add the appropriate passwords.

   <Setting name="Password" value="" />

3. Save the configuration file.
4. Open the replicator management shell as an administrator.
5. Run the following command to import Replicator settings for this farm:

Import-ReplicatorSettings –FileName "<path><file>.xml"

<file> represents the name of the configuration file. For more information on the repadm command, see the Metalogix Replicator Command-line Reference.

After the command completes, your farm will have the same Replicator configuration that is described in the configuration file. The Import-ReplicatorSettings command has additional options to only import web application, group, connection, and map family settings. For more information about these options, see the Metalogix Replicator Command-line Reference.

Importing Configuration Settings as a Template

To configure Replicator identically for several different farms, you can use an exported settings file as a template. To do this:

1. Edit an exported configuration file in a text editor.
2. Remove any settings from the configuration file that
   • Are not applicable for the farms you are configuring.
   • You want to use the Replicator default settings for.

In most cases, you should remove the following lines from the file to use the default settings on the farm you are importing configuration for.

<WebAppSettings>
…
<Setting name="RemapDomainName" value="" />
…
<Setting name="CachePath" … />
<Setting name="PackageDataPath" … />
…
</WebAppSettings>

1. Replace any farm-specific values with a word like FARMNAME. This word will be replaced with the name of the farm, as seen on the About Metalogix Replicator page in Central Administration, during the import process.
2. Search the file for the following lines and add the appropriate passwords.

   <Setting name="Password" value="" />

3. Save the configuration file.
4. Copy the configuration file to a server running the SharePoint Web Application service in a farm. This will be the server where you will install Replicator.
5. Edit the copied configuration file with any additional user accounts and their passwords required for the current farm.
6. On the same server, install Replicator and run the Replicator Configuration Wizard.
7. Open the Replicator Management Shell.
8. In the command window, run the following command to import settings for this farm:

Import-ReplicatorSettings –FileName <file> -UseFarmAsTemplate "<farmname>"

<file> represents the name of the configuration file and <farmname> represents the word you used in the configuration file to be replaced by the name of the farm. For more information on the command, see the Metalogix Replicator Command-line Reference.

For example, run:

Import-ReplicatorSettings –FileName c:\ReplicatorSettings.xml -UseFarmAsTemplate "FARMNAME"

1. Create any required connections from the other web applications in your Replication Network to the newly imported web application.
2. Repeat steps 6 through 8 for each farm where you want to apply these settings.

After the command completes, your farm will have the same Replicator configuration that is described in the configuration file. The Import-ReplicatorSettings command has additional options to only import web application, group, connection, and map family settings. For more information about these options, see the Metalogix Replicator Command-line Reference.