Articles in this section

How to migrate from a Linux server with custom hosting to Plesk?

Gilson Siqueira
Updated
kb: how-to ext: migrator Plesk Obsidian for Linux ABT: Group B

Question

How to migrate from a Linux server with custom hosting to Plesk?

Answer

In case of migration from the following platforms, consider contacting Plesk Professional Services for assistance on a paid basis:

  • HDE Controller 6
  • H-Sphere
  • Interworx
  • ISPmanager 4 Pro / 5 Business
  • PPA (Plesk Automation or Parallels Plesk Automation)
  • WebControl Panel

Otherwise, follow the instructions below.

Note: Migrating from servers with custom hosting can only be done via the command line, and not via the Plesk interface. It is not possible to automatically generate a hosting description file.

If you have administrative access to the source server
  1. Log in to the destination Plesk server via SSH.
  2. Install Plesk Migrator if it is not installed yet.

  3. Prepare the hosting description file. Name the file hosting-description.[yaml/json] (depending on the chosen format) and place it in the following directory:

    CONFIG_TEXT: /usr/local/psa/admin/sbin/modules/panel-migrator

    The file must contain the list of clients, subscriptions, addon domains, mailboxes, etc., to be transferred from the source server. Sample hosting description files can be found here.

  4. Prepare the migrator configuration file. Name the file config.ini and place it in the same directory:

    CONFIG_TEXT: /usr/local/psa/admin/sbin/modules/panel-migrator

    The file must include the configuration and access information for the source server. A sample configuration file can be found here.

  5. Generate the migration list:

    CONFIG_TEXT: /usr/local/psa/admin/sbin/modules/panel-migrator/plesk-migrator generate-migration-list

    The resulting file will be named migration-list and placed in the /usr/local/psa/var/modules/panel-migrator/sessions/migration-session/ directory. This file contains the list of objects (customers, domains, etc.) to be migrated.

  6. Edit the migration-list file manually if needed (e.g., remove domains you do not want to migrate).

  7. (Optional) Validate the hosting description file:

    CONFIG_TEXT: /usr/local/psa/admin/sbin/modules/panel-migrator/plesk-migrator validate

  8. Start the migration:

    CONFIG_TEXT: /usr/local/psa/admin/sbin/modules/panel-migrator/plesk-migrator transfer-accounts

  9. (Optional) Perform an additional content sync (rsync) to catch changes made during migration:

    CONFIG_TEXT: /usr/local/psa/admin/sbin/modules/panel-migrator/plesk-migrator copy-content

  10. (Recommended) Check the operability of the migrated objects:

    CONFIG_TEXT: /usr/local/psa/admin/sbin/modules/panel-migrator/plesk-migrator test-all

If you do NOT have administrative access to the source server
  1. Log in to the destination Plesk server via SSH.
  2. Install Plesk Migrator if it is not installed yet.
  3. Manually copy web and mail content from the source server to the destination. You can place this content in a temporary directory on the destination server (e.g., /root/migration_temp/).
  4. Create dumps of the databases on the source server and manually copy them to the destination server.

  5. Prepare the hosting description file (hosting-description.yaml) in the following directory:

    CONFIG_TEXT: /usr/local/psa/admin/sbin/modules/panel-migrator

    Crucial Step: When defining the component paths in this file, you must specify the local paths on the destination server where you copied the data in Step 3 (e.g., /root/migration_temp/domain.com/httpdocs).

    Find sample hosting description files here.

  6. Prepare the configuration file (config.ini) in the same directory.

    Note: Since you are migrating from local data, the configuration will differ slightly. Refer to documentation for "Migrating from local storage" if applicable, or ensure the config points to the local filesystem driver.

  7. Generate the migration list:

    CONFIG_TEXT: /usr/local/psa/admin/sbin/modules/panel-migrator/plesk-migrator generate-migration-list

  8. Edit the migration-list file to remove unwanted domains or re-assign plans.

  9. (Optional) Validate the hosting description file:

    CONFIG_TEXT: /usr/local/psa/admin/sbin/modules/panel-migrator/plesk-migrator validate

  10. Start the migration (import):

    CONFIG_TEXT: /usr/local/psa/admin/sbin/modules/panel-migrator/plesk-migrator transfer-accounts

Was this article helpful?

Comments

0 comments

Please sign in to leave a comment.