Installing and Configuring Migration Agent on Source Server

Installing Migration Agent

To install Migration Agent:

1. Download Migration Agent installation file using download link published at http://www.parallels.com/download/plesk/utilities/.
2. Run the installation file and follow the installation wizard instructions:
   1. When the first screen of the installation wizard appears, click Next>.

      This starts the Plesk Migration Agent installation, it is installed to the C:\Program Files\Parallels\Plesk Migrator Agent\ directory.

   2. Click Finish after the installation wizard installs Migration Agent files to your server.

Once you have installed Migration Agent, it starts automatically with the default settings.

Configuring Migration Agent

Changing Migration Agent configuration includes the following:

• Changing parameters of the Migration Agent connection with Migration Manager (port, Migration Agent URI and channel type).

  This can be done using either Migration Agent interface or Migration Agent configuration file.

• Changing location of migration dumps on source server.

  This is necessary if, for example, there is not enough disk space on the disk where Migration Agent is installed.

To change the connection parameters using Migration Agent GUI:

1. Run the WINAgentMng.exe file.

   The Migration Agent window opens.

   

   If Migration Agent was installed in the default location, you can access it by clicking Start > Programs > Parallels > Plesk > Plesk Migration Agent, or browsing to C:\Program Files\Parallels\Plesk Migration Agent\WINAgentMng.exe.

2. Click Stop.

   This makes changing Migration Agent settings available.

   

3. Enter the desirable value next to Port to change the port number.
4. To change Migration Agent URI and channel type:
   1. Click Advanced.

      The advanced options window opens.

      

   2. Enter desirable name next to URI to change Migration Agent URI, .
   3. Select an appropriate item in the Channel Type menu to set up a channel type.
   4. Click OK.

      This applies the changes made to advanced options and closes the advanced options window.

5. Click Start.

   This applies changes made to the port number and starts Migration Agent with new settings.

Editing Migration Agent Configuration File

You can edit the Migration Agent configuration settings manually. For the changes to take effect after manual editing, restart Migration Agent.

To change the connection parameters by editing configuration file:

1. Open for editing the <migration-agent-installation-directory>\WINAgentMng.exe.config file and locate the "/configuration/appSettings" element.

   By default, Migration Agent is installed in C:\Program Files\Parallels\PleskMigrationAgent.

   Warning: It is strongly recommended that you do not change anything beyond the contents of the <appSettings> node, as doing this will most probably crash PPP Migration Manager and make migrations impossible.

2. To change port number, enter a desired value in the <add key="Port" value="6489" /> string instead of 6489.

   For example, if you want port 7788 to be used, this string should be <add key="Port" value="7788" />.

3. To change Migration Agent URI, enter a desired value in the <add key="ObjectUri" value="WinAgentURI" /> string instead of WinAgentURI.

   For example, if you want "MigrationAgent325" to be used as the Migration URI, this string should be <add key="ObjectUri" value="MigrationAgent325" />.

4. To change channel type, enter a desired value in the <add key="ChannelType" value="HTTP" /> instead of HTTP.

   For example, if you want to use TCP, this string should be <add key="ChannelType" value="TCP" />.

5. To change the Migration Agent's IP address, enter the IP address value in the string <add key="IPAddress" value="" />.

   This will enable PPP Migration Manager to connect to Migration Agent through the specified IP address only. Type 0.0.0.0 or remove the string from the file altogether to enable PPP Migration Manager to connect to Migration Agent through any IP address available on the source server.

6. Save file.
7. Restart Migration Agent.

To change dumps location:

1. Open for editing the <migration-agent-installation-directory>\WINAgentMng.exe.config file and locate the "/configuration/appSettings" element.

   By default, Migration Agent is installed in C:\Program Files\Parallels\PleskMigrationAgent.

   Warning: It is strongly recommended that you do not change anything beyond the contents of the <appSettings> node, as doing this will most probably crash PPP Migration Manager and make migrations impossible.

2. Add the full path (starting with the drive root) to folder where the file should be stored into the <add key="DumpDirectory" value="" /> string.

   For example, if you want the migration dump to be stored in folder H:\Store\Plesk_migration, this string should be <add key="DumpDirectory" value="H:\Store\Plesk_migration" />. If such directory does not exist on disk H, it will be created.

3. Save file.
4. Restart Migration Agent.

Default content of the configuration file

<?xml version="1.0" encoding="utf-8"?>

<configuration>

  <startup>

    <supportedRuntime version="v2.0.50727" />

    <supportedRuntime version="v1.1.4322" />

  </startup>

  <system.runtime.remoting>

    <customErrors mode="off" />

    <application name="Parallels Foreign Migration Agent" />

  </system.runtime.remoting>

  <runtime>

    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">

      <probing privatePath="BackupUtils" />

    </assemblyBinding>

  </runtime>

  <appSettings>

    <add key="Port" value="6489" />

    <add key="ObjectUri" value="WinAgentURI" />

    <add key="ChannelType" value="HTTP" />

    <add key="IPAddress" value="" />

    <add key="DumpDirectory" value="" />

    <add key="UseWebserver" value="false" />

    <add key="WebServerPort" value="6490" />

    <add key="LogUseDefaultCulture" value="false" />

  </appSettings>

</configuration>