This article provides best practices and use cases for troubleshooting issues with a Plesk for Linux migration. Each section of this article contains cross-references to the relevant Plesk Knowledgebase (KB) articles for that particular stage of the migration process.
Helpful information relating to Plesk for Windows can be found in the following KB article:
- 213930805 Plesk for Windows: Migration Best Practices and Usecases
If you prefer to let Plesk professionals handle the migration or upgrade job for you please check out Plesk professional services options on our website: https://www.plesk.com/professional-services/
Table of contents
- Server preparation prerequisites
- Migrating between different versions of Plesk
- Manual migration hints and tips
- Connectivity issues
- Error revealed
Migration & Transfer Manager
Since Plesk 12.5 the new Plesk Migrator was implemented.
For more information refer to Migration Guide .
Refer to the articles below:
- 213407929 How must a Plesk server be prepared for migration?
- 213902145 Migration between Redhat and Debian
- 213400309 Is it possible to migrate from Plesk for Windows to Plesk for Linux and vice versa?
If a manual transfer is required (for mail content, a complete server after a crash, database moving, etc.), refer to the following sources:
- 213927465 How to restore a Plesk installation on the new server after a disaster
- 213396689 How to restore Plesk from the hard disk drive if the Operating System is broken and the HDD with the old OS and Plesk is mounted in the new system
Sometimes, migrating to another server is not possible due to connectivity problems between servers. Please refer to the following articles to check whether this is the case:
- 8495 Migration does not start: “Error: No migration agents found. Data migration is not available”
Periodically, an error may occur within the log files or Plesk user interface messages. In these cases, the following articles may be useful:
213909985 Cannot create domain in Plesk: There are no available resources of this type (domains) left. Requested: 1; available: 0.
Failed deployment of domain domain.tld
Execution of /opt/psa/admin/plib/api-cli/domain.php --create domain.tld -owner admin -do-not-apply-skeleton -notify false -guid b55020df-b7a3-4ecc-824e-2bdfb9dab685 -creation-date 2011-09-17 -ignore-nonexistent-options failed with return code 1.
An error occurred during domain creation: There are no available resources of this type (domains) left. Requested: 1; available: 0.
213958885 Restore is too slow. CLI Gate interface usage: transfer closed with outstanding read data remaining
INFO: FailedDomainDeployment[8b8adf25-291f-4e3b-8624-63c3a4989bba]: Failed deployment of domain domain.tld [./domain_deploy.cpp:410]
void plesk::tDomainDeployer::operator()(plesk::XmlNode) const
ExecCliGate::GateError[a0116883-7cd4-42c8-8f90-08c786e41318]: Error during CLI Gate interface usage: transfer closed with outstanding read data remaining [./cmd_exec.cpp:192]
213395649 Plesk Backup Manager loads a long time and then fails with error Nginx 504 Gateway Time Out
2014/01/07 16:49:33 [error] 3235#0: *1483 upstream timed out (110: Connection timed out) while reading response header from upstream, client: 184.108.40.206, server: , request: "GET /plesk/server/backup/local-repository/ HTTP/1.1", upstream: "fastcgi://unix:/var/run/sw-engine.sock", host: "220.127.116.11:8443", referrer: "https://18.104.22.168:8443/admin/server/tools?context=tools"
213906685 Insufficient disk space on the source server to store temporary files for transfer.
Insufficient disk space on the source server to store temporary files for transfer. Available: 16868 MB. Required: 109833 MB. Please free disk space on the source server.
213958125 Migrating to Plesk 12 on Centos 7 shows warning: python is not supported
python is not supported
213954625 Migration fails with error "Specified key was too long; max key length is 1000 bytes"
Runtime error during db: (1, '', 'ERROR 1071 (42000) at line 323: Specified key was too long; max key length is 1000 bytes\
213391589 When using the PMM to migrate Plesk data from FreeBSD, I receive this error after selecting the accounts to transfer:
readResponse|handle 1|(14) data[Error: unable to connect to database: Can't connect to local MySQL server through socket$
213408649 Subscription migration fails with error "Assertion failed: files.size() == 1"
Assertion failed: files.size() == 1
1253 I get this error during migration from Plesk server: "Illegal mix of collations"
Illegal mix of collations
113550 Plesk migration from source server with OpenSUSE fails with RsyncContent.pm errors
== STDERR ====================
Cannot request remote agent status using command line /var/cache/20110902132102493/PleskX.pl: Assertion ((svtype)((_svi)->sv_flags & 0xff)) == SVt_IV || ((svtype)((_svi)->sv_flags & 0xff)) >= SVt_PVIV failed: file "op.c", line 4161 at RsyncContent.pm line 260.
Compilation failed in require at Packer.pm line 10.
BEGIN failed--compilation aborted at Packer.pm line 10.
Compilation failed in require at StopWatchPacker.pm line 8.
BEGIN failed--compilation aborted at StopWatchPacker.pm line 8.
Compilation failed in require at PleskX.pm line 135.
BEGIN failed--compilation aborted at PleskX.pm line 135.
Compilation failed in require at /var/cache/20110902132102493/PleskX.pl line 8.
BEGIN failed--compilation aborted at /var/cache/20110902132102493/PleskX.pl line 8.
115598 Default value of MySQL global variable "wait_timeout" on Source or/and Destination server can interrupt migration with error "MySQL server gone away"
MySQL server gone away
213410469 Domain is not created because of existing DNS records in psa database
Unable to set domain name: Unable to create the domain domain.tld because a DNS record pointing to the host domain.tld already exists.