Registering/Upgrading/Unregistering Custom Migration Agent in POA

To register custom migration agent in POA, do the following:

  1. Upload the agent.tar and agent.manifest files to the POA management node and place them both in one directory (it is strongly recommended to create separate directory for each custom agent).
  2. Log in to POA MN via SSH or RDP (in case of Win MN).

Execute the following command:

$ $PLESK_ROOT/bin/mm_ctl -f $PLESK_ROOT/etc/pleskd.props agent registerCustom <agent-path>

Where $PLESK_ROOT is a path to the directory where POA is installed, and <agent-path> is the absolute path (without ending slash/backslash) to the directory with agent.tar and agent.manifest files.

To upgrade custom migration agent registered earlier, do the following:

  1. Upload the agent.tar and agent.manifest files to the POA management node and place them both in one directory (it is strongly recommended to create separate directory for each custom agent version).
  2. Log in to POA MN via SSH or RDP (in case of Win MN).
  3. Execute the following command:

    $ $PLESK_ROOT/bin/mm_ctl -f $PLESK_ROOT/etc/pleskd.props agent upgradeCustom <agent_id> <agent-path>

Where $PLESK_ROOT is a path to the the directory where POA is installed, the <agent_id> is the agent identifier obtained during agent registration (can be seen in POA PCP at Top > System Director > Migration Manager > Agents as internal ID) and the <agent-path> is the absolute path (without ending slash/backslash) to the directory with agent.tar and agent.manifest files.

To unregister custom migration agent registered earlier, do the following:

  1. Log in to POA MN via SSH or RDP (in case of Win MN).
  2. Execute the following command:

    $ $PLESK_ROOT/bin/mm_ctl -f $PLESK_ROOT/etc/pleskd.props agent upgradeCustom <agent_id>

Where $PLESK_ROOT is a path to the directory where POA is installed, the <agent_id> is the agent identifier obtained during agent registration (can be seen in POA PCP at Top > System Director > Migration Manager > Agents as internal ID) and the <agent-path> is the absolute path (without ending slash/backslash) to directory with agent.tar and agent.manifest files.

Note: Internal identifiers are hidden by default. To make them visible in POA PCP go to Top > System Director > Migration Manager > Settings > Control Panel settings and set Show internal identifiers option to Visible.