Support / KnowledgeBase

 
Search the KnowledgeBase Search

Using the Plesk Migration Manager

  • Applies to: (dv) 4.0, DV

  • Difficulty: Medium

  • Time needed: 90 minutes

  • Tools needed: SSH, root

 
  • Applies to: DV, DV 4.0
    • Difficulty: Medium
    • Time Needed: 90+
    • Tools Required: SSH, root

Introduction

This article walks you through using Plesk's built-in Migration Manager, so you can easily migrate your websites from one DV server to another.

You may also be able to use the Migration Manager to move sites from other hosting companies - if they use Control Panel software such as Plesk, cPanel, Ensim, or Hsphere.

Parallels instructions:

NOTE:

Be sure to cancel your previous server after your sites are fully migrated to your new DV server. You can do this from the AccountCenter. See Close a service or account.

move_to_mt_560x240

CloudTech Can Help!


(mt) Media Temple offers assisted site migrations via CloudTech, our premium services product. To learn more, please click here.


Getting started

There are a few things you will need before you can migrate to your new DV server 4.0:

  • A domain name or IP address that resolves to your old server.
  • The root password for your old server. If you are migrating from another (mt) Media Temple DV server, see DV:Enable root access.
  • A shared IP (as opposed to exclusive) available on your new server. See DV 4.0:Plesk shared and exclusive IPs for details.
  • Your IP address should also be set to shared on old server. See DV:Plesk shared and exclusive IPs.
  • If sub-domains in Plesk have unique FTP users, you will encounter PMM failures with the following message:

<execution-result status="error"><message code="InternalDtdValidationFailed" severity="error"><context>void plesk::validateSchema(plesk::tXmlDocument&, const std::string&)</context><file>./xml_parse.cpp</file><line>412</line><text>Failed validation of the document with its internal DTD. The errors are: Element 'ftpusers': This element is not expected. Expected is ( sites )..</text></message></execution-result>

The obvious work around to allow complete migration is to log into Plesk on the DV 3.5, edit the sub-domains that have unique FTP users, and set them to "Use the FTP user account of the main domain". Once all of the sub-domains have been set to use the parent domain's FTP user account, the failed PMM migration will need to be removed from the PMM page, and the migration started over. The new PMM migration should be able to complete (assuming all sub-domain FTP users are set to use the "main domain's" FTP user).

NOTE:

It is important to know that the Plesk Migration Manager does not transfer all of your high-level server settings. It merely moves over client data, which includes domains, and any mailboxes or databases that were created under those domains. Custom firewall rules, PHP settings, Apache settings, etc. will not be copied.

Additionally, contacts and spam filter settings for email users using the Horde Webmail client are not copied over.

  • You must have a new IP address on your new server. You cannot use the same IP(s) that you had previously.

Instructions

Order the server

Order your new DV server from the AccountCenter. See Managing/Ordering Servers for details.

  • The new server cannot have the same primary domain as your current DV server at the time it is ordered; this can be changed later if desired.
    • Don't use a subdomain of a domain that is currently on your old server. We suggest using a temporary primary domain, such as new-example.com.
  • Once your migration is complete and the old server closed, you can rename the new server to whatever you want. See this article for more information: Changing your primary domain.

Lower your TTL

Please lower your TTL so that your DNS change to the new server goes smoothly.

Set up the new server

Please follow the instructions in Plesk first-time setup to configure the basic settings for your new server. You don't need to create a Subscription or Customer on the new server.

Start New Migration

1. Log into the Plesk Control Panel.

2. If you are in Power User mode, click on the Server tab.

If you are using Service Provider view, select Tools & Settings.

241_p115_tools_settings 

3. Under the Tools & Resources section, click on Migration Manager.



4. Now, click Start New Migration



5. Fill in the details for your old server, and enter your migration preferences. Then, click Next

TIP:

Use rsync transport: Select rsync - it's faster and requires less free space on your old server.



  • Data source: Transfer data from another server.
  • Source host name or IP address: This should be the IP address for your old server, or a domain that resolves to your old server. Leave the small box with "22" alone.
  • Username: root
  • Password: The root password for your old server.
  • Temporary Files Location: Leave as default.
  • Transfer the following data: You can transfer everything, or only selected data.
  • Use rsync transport: Select rsync - it's faster and requires less free space on your old server.

This step may take a few minutes to complete while your new server checks your old server's settings.

6. If you see the message IP address not found, please visit Plesk shared and exclusive IPs and set your IP address to Shared on this server. 


If your screen looks like this, you need to set one of your IP addresses to Shared.


7. Select a shared IP from the dropdown menu. If you have a more complex IP setup, you may need to create an IP mapping file (which you can upload by clicking on the Upload IP Mapping File link). Click Next.



8. You will be returned to the migration list, and you should see a progress bar for the migration status. You can click Refresh to refresh the page.


It's fine to navigate away from this page and log out of Plesk while the migration is running.

9. In a few minutes or a few hours, depending on how much data needs to be transferred, your migration will finish, and you will see the final status of the migration in the Progress section.


It's normal for a migration to show Completed with errors. Usually, these errors reflect simple checks on lesser-used system services or resources that are issued out of an abundance of caution. However, we suggest double-checking such errors via the Migration Log to ensure that they are benign.

10. Click on the IP address or domain name under the Source hostname column to view details for the migration. 


Click on the blue link to view details related to your migration.


11. From here, you can download a log file for the migration. Click on the link to do so. We recommend NOT removing the temporary files from the migration until you've confirmed that everything is okay. So, you can uncheck that box. 


Download or view the log file for additional information. It's a plain text file that can be opened with TextEdit or Notepad.


12. Look at your server and make sure that all of your clients, domains, email addresses, etc. moved over correctly. Here's a short list of what you should be looking for:

Older versions of Plesk: DV 3.5 and earlier New DV server
domain Subscription main domain
email user email user
FTP domain user FTP domain user
Client Customer/Subscriber

TIP:

Use the Site Preview link shown next to your domain in the Control Panel to test your domains before switching DNS.

13. You should be all set! If any errors came up, please continue with the Troubleshooting section below. You may also want to read these articles to learn how to transfer your email clients from Horde to AtMail:

It's also a good idea to turn off the private nameserver service named at this stage unless you plan to run your own nameservers. This service is known to be quite a resource hog.

Troubleshooting

In general, if your migration fails for some reason, you will have to:

  1. Fix the problem.
  2. Delete the stalled migration from your migration list on the new server.
  3. Start over with a fresh migration attempt.

Unique FTP users

If sub-domains in Plesk have unique FTP users, you will encounter Plesk Migration Manager failures with the following message:

<execution-result status="error"><message code="InternalDtdValidationFailed" severity="error"><context>void plesk::validateSchema(plesk::tXmlDocument&, const std::string&)</context><file>./xml_parse.cpp</file><line>412</line><text>Failed validation of the document with its internal DTD. The errors are: Element 'ftpusers': This element is not expected. Expected is ( sites )..</text></message></execution-result>

To work around this issue, you will need to change the FTP settings for your subdomains on your old server.

  1. Log into Plesk on your DV 3.5.
  2. Find all of your subdomains that have unique FTP users, and set them to "Use the FTP user account of the main domain."
  3. Now, start over with a new migration.

Migration log

If your migration error log contains many copies of the following error:

Filename: task-9618.log

<message code="ExecCliGate::InternalServerError" severity="error"><context>void plesk::CliExec::analyzeResponse()</context><file>./cmd_exec.cpp</file><line>179</line><text>Internal server error: <cli><failure>MySQL query failed: Unknown column 'object_name' in 'field list'</failure></cli></text></message>

And contains the following summary:

Filename: task-9618.log

Stderr is
Mailing list support is not installed or not properly configured.

This means that the Horde mailing lists for your server didn't migrate properly. This is normal when migrating from an older version of Plesk. See this Parallels forum discussion:

Apache error

If you see the following error in Plesk:

  • Error: New files of configuration for Apache web server were not built due to errors in configuration templates. The detailed error message was e-mailed to you, so please check the e-mail, fix the errors, and click here to retry generating configuration.

This likely means that you had some domain-level Apache configuration files that were migrated from your previous server. Check in your /var/www/vhosts/example.com/conf/ folder for each domain. If you see any vhost.conf files, rename them, then click the link in Plesk to try again. You may not receive the email mentioned in the error.

See this Parallels forum discussion for more information: http://forum.parallels.com/printthread.php?t=105566.

Business model warning

If you see the following warning in Plesk:

  • Parallels Plesk Panel 10 employs a new business model. The essential business objects were automatically converted during the upgrade: clients were converted to customers, domains to subscriptions, and so on. However, several extra steps are required to complete switching to the new model. The steps depend on the way you used a previous version of Plesk to organize your business, so they cannot be performed in a fully automatic manner. Please complete switching to the Panel 10 business model.

This means that some of your Clients weren't properly converted into Customers. This is common when migrating from an older Plesk server with the default "My Domains" Client. To resolve this error:

  1. Click on the link in the error.
  2. Click on the Selective Transition of Customers tab. See Figure 15:

    Plesk10_migrationerrors_business_customers
    Figure 15: Click on Selective Transition of Customers.

  3. Click on the check box to select all of the Clients from your old server. Then, click the Apply Transition Scheme button. Select Subscription inherits from the Client, or another option if desired. See Figure 16:

    Plesk10_migrationerrors_business_trans
    Figure 16: Choose the resource allocation for your new Subscription(s).

  4. Check the box next to the description, then click Yes. See Figure 17:

    Plesk10_migrationerrors_business_confirm
    Figure 17: Check the box and click Yes.

That's it. Your Subscriber/Customer setup should now be similar to your Client setup on your old server.

Running out of space

Make sure you have the rsync box checked in your migration settings! Otherwise, you won't be able to migrate from a server that has over 50% disk space used (at least, not all at once).

Error: No migration agents found.

You may get the following error in Plesk: No migration agents found. Data migration is not available.

This error is caused by having a root .bashrc file with custom elements in it. In earlier DV server 3.5 servers, (mt) Media Temple automatically included some shortcuts in the .bashrc file. These need to be deleted from the file (along with any other custom elements you may have added).

You can locate your .bashrc file in /root/, also accessible via ~/.

Your file should contain ONLY THE FOLLOWING information (delete everything else):

Filename: .bashrc

# .bashrc

# User specific aliases and functions

alias rm='rm -i'
alias cp='cp -i'
alias mv='mv -i'

# Source global definitions
if [ -f /etc/bashrc ]; then
. /etc/bashrc
fi

Please see http://kb.parallels.com/8495 for additional information on this error.

Migration settings errors

  • Host xxx.xxx.xxx.xxx is not accessible
    • Make sure the domain name or IP address that you typed in does resolve to your old server.
    • Make sure that your username is root and that you have the correct root password. (This is not the same as your admin password.) See DV:Enable root access for details.
    • There may be a network error.
    • Or, just start over with a new migration attempt.
  • Cannot migrate because the username or account name is invalid
    • Make sure you have not created any users on your new server already that have the same name as a user on your old server. Delete duplicate accounts from the new server, then try again.

Migrating from DV server 3.0

If you performed the PHP5 upgrade to your DV server 3.0, you will need to reverse those steps by following this article: DV:Revert manual settings for PHP 5.

Migrating from DV server 2.0

The DV server 2.0 information has not yet been tested. Feel free to update this section with your results if you migrate from DV server 2.0 to 4.0

  • Note that your system paths have changed. Paths are no longer like /home/httpd/vhosts/example.com/. Paths are now like /var/www/vhosts/example.com/. This may affect some of your site settings, such as session save paths.

SSH

If you can't connect to your new server with SSH, you may need to reset your SSH known hosts file. See SSH known hosts warning for details.

Change DNS settings

Now, you can point your domains to your new server. If you host DNS with (mt) Media Temple, see (mt):Point to another server. If you host DNS elsewhere, update your DNS records to use your new IP address(es).

Double-check migration accuracy, cancel old service

Once you have fully tested your new server, and have confirmed that your DNS changes have propagated, you can close your old DV server. See Close a service or account.

You now have the option to update the primary domain of your new server, if desired.

 

Continue