Ispmanager 6 lite, pro, host

/
/
/
Data import: general information

Data import: general information

Data import is the process of data transfer from one panel to another. In ispmanager users and their data can be imported from the following panels:

  • ispmanager 4 lite
  • ispmanager 5 lite
  • ispmanager 6 lite, pro, host, business
  • cPanel
  • Plesk

Import Wizard:

  • allows to set up data import step by step
  • checks the availability of the required software, settings and access on the receiving server and, if necessary, allows adding them during the import process (available in ispmanager 6 and ispmanager business 6)
  • generates a preliminary report with a list of entities that cannot be imported or will be imported with changes and a list of software to be installed
  • after starting the import, generates an import log with a list of entities and information about their import status

Import opportunities: Administrator vs. User

AdministratorUser
Can import data of users the administrator ownsCan only import their own data
Can use rsync or a backup copyCan use a backup copy only
Can install the required software, increase limits and enable the necessary access for users during the import processCan not install the required software, increase limits and enable access during the import process
Imported users will be created in the panel automatically, their limits will be preserved and appliedThe imported users' limits will not be applied. The user performing the import will become the owner of the imported data.

Import via rsync

The rsync technology allows importing users without using backups. This method saves disk space as it requires exactly as much space as occupied by the imported user and their data.

Import via rsync is not available from Plesk.

Import of entities

✅ — the entity will be imported automatically, ❌ — the entity will NOT be imported automatically

If necessary, configure the required entities manually after import.

EntityImport from ispmanagerImport from cPanel
Users
Username and password

✅

✅

User quotas

✅

✅

User access to shell and SSL

✅

✅

Sites
Site as an entity

✅

✅

User files from the /home/username directory

✅

✅

Site redirects

✅

❌

Site error pages

✅

❌

Domains
Domain names

✅

✅

DNS records

✅

✅

Mail
Mail domains

✅

✅

Mailboxes and emails

✅

✅

Autoresponder

❌

❌

Email filters

❌

❌

Mail redirects

✅

❌

Databases

Databases, database users and MySQL dumps

Details

Percona databases will be migrated if the source server has Percona DBMS installed. Otherwise, the database will be migrated to MySQL.

✅

✅

Database user password

✅

❌

Details

To log in to phpMyAdmin, enter the database user password from cPanel manually. For automatic authorization from the Databases section, enter and save the password in the database user form.

Databases of MySQL server remote profiles

❌

❌

PostgreSQL databases

✅

❌

PHP
PHP versions for sites

✅

✅

PHP handling modes

✅

✅

SSL
SSL certificates

✅

✅

CSR requests

✅

✅

Let's Encrypt service data

✔️

❌

Details

Once imported, Let's Encrypt certificates will continue to work, but will not be automatically renewed. Reissue them immediately after the transfer or closer to the expiration date.

Other
CRON jobs

✅

✅

FTP users

✅

✅

Manual edits to web server configuration files

❌

❌

Import from a backup copy

Import from backup requires a user backup to be created in the source panel. The exception is importing with a connection to a remote panel: in this case, a backup is created automatically during import.

Import from backup is available from the following sources and for the following panels:

 From a local computerFrom a local archive or catalogVia URLFrom a remote control panel
ispmanager 4

❌

✅

❌

❌

ispmanager 5, 6

✅

✅

✅

✅

ispmanager business 6

✅

✅

✅

✅

cPanel

✅

✅

✅

❌

Plesk

✅

✅

✅

❌

Import of entities

✅ — the entity will be imported automatically, ❌ — the entity will NOT be imported automatically

If necessary, configure the required entities manually after import.

EntityImport from ispmanagerImport from cPanelImport from Plesk
Users 
Username and password

✅

✅

✅

User quotas

✅

✅

✅

User access to shell and SSL

✅

✅

✅

Sites 
Site as an entity

✅

✅

✅

User files from the /home/username directory

✅

✅

✅

Site redirects

✅

❌

❌

Site error pages

✅

❌

❌

Domains 
Domain names

✅

✅

✅

DNS records

✅

✅

✅

Mail 
Mail domains

✅

✅

✅

Mailboxes and emails

✅

✅

✅

Autoresponder

❌

❌

✅

Email filters

❌

❌

❌

Mail redirects

✅

❌

✅

Databases 

Databases, database users and MySQL dumps

Details

Percona databases will be migrated if the source server has Percona DBMS installed. Otherwise, the database will be migrated to MySQL.

✅

✅

✅

Database user password

✅

❌

Details

To log in to phpMyAdmin, enter the database user password from cPanel manually.  For automatic authorization from the Databases section, enter and save the password in the database user form.

✅

Databases of MySQL server remote profiles

❌

❌

❌

PostgreSQL databases

✅

❌

❌

PHP 
PHP versions for sites

✅

✅

✅

PHP handling modes

✅

✅

✅

SSL 
SSL certificates

✅

✅

✅

CSR requests

❌

❌

❌

Let's Encrypt service data

✅

❌

Details

Once imported, Let's Encrypt certificates will continue to work, but will not be automatically renewed. Reissue them immediately after the transfer or closer to the expiration date.

❌

Other 
CRON jobs

✅

✅

✅

FTP users

✅

✅

✅

Manual edits to web server configuration files

❌

❌

❌

Cancelling the import

A running import can be cancelled. In this case:

  • entities of the currently imported user will be imported
  • if files or databases are being imported, the import will be stopped immediately
  • files that have already been imported will not be deleted
  • if a package is being installed or the panel is being updated, the installation and update will not be interrupted to avoid package conflicts

Data import log

The import log contains the following fields:

  • Type — entity type

    Possible values
    • Domain
    • SSL certificate
    • CSR request
    • Website
    • Mail domain
    • Mailbox
    • FTP user
    • CRON job
    • Database
    • Database user
    • Files
    • Mailbox files
    • Website files
  • Name — entity name

  • Status — entity import status

    Possible values
    • Successful — the entity was imported without errors
    • Pending — the entity is waiting to be imported
    • In progress — the entity is being imported
    • Skipped — the entity import was skipped if the entity exists
    • Warning — the entity was imported with changes, e.g. a handler, PHP version, or DBMS change
    • Error — the entity import failed
  • Details — description of the reasons why the entity was skipped, warnings and errors that occurred during the import

The log supports data search and filtering.

Outdated import mechanism

The outdated import mechanism is still available at URL:

https://DOMAIN_OR_IP:PORT/ispmgr#/form?func=backup2.superlist.import
https://DOMAIN_OR_IP:PORT/ispmgr#/form?func=backup2.list.import

Instructions for outdated import have been moved to the Knowledge Base.

Change of entity directories after import to ispmanager

 cPanelPleskispmanager
User home directory/home/USERNAME/var/www/vhosts/DOMAIN//var/www/USERNAME/data
Mailbox directory/home/USERNAME/mail/MAIL_DOMAIN/MAILBOX/var/qmail/mailnames/DOMAIN/MAILBOX/Maildir/var/www/USERNAME/data/email/MAIL_DOMAIN/MAILBOX/.maildir
Main site directory​/home/USERNAME/public_html/var/www/vhosts/DOMAIN/httpdocs//var/www/USERNAME/data/www/DOMAIN
Additional sites directory
  • /home/USERNAME/public_html/SUBDOMAIN
  • /home/USERNAME/SUBDOMAIN
/var/www/vhosts/DOMAIN/SUBDOMAIN.DOMAIN/httpdocs/
  • /var/www/USERNAME/data/www/DOMAIN/SUBDOMAIN
  • /var/www/USERNAME/data/www/SUBDOMAIN.DOMAIN
Path to SSL certificates/home/USERNAME/ssl/certs/usr/local/psa/var/certificates//var/www/httpd-cert/USERNAME
Path to mail clienthttps://DOMAIN_OR_IP:2096/webmailhttps://webmail.DOMAINhttps://DOMAIN_OR_IP:1501/roundcube

Data import technical details

Calculating required disk space

The UsermoveDiskSizeDelta parameter value is added to the amount of disk space required for import. The parameter is stored in the main configuration file of the panel. The default value is 200 MB.

If the total size of the imported data slightly exceeds the amount of free disk space, this size can be reduced by decreasing the value of the UsermoveDiskSizeDelta parameter.

Example

The size of imported data is 550 MB. The required space is: 550 MB + 200 MB = 750 MB. There is 700 MB free disk space on the server.

To perform the import, set the UsermoveDiskSizeDelta parameter value to150 MB.

Loading an archive when importing from a backup copy

When loading a backup to the server (except for copies from a remote control panel), the selected archive will be uploaded to the storage (by default, /usr/local/mgr5/var/backup/) as a user archive. The existing user archive will be overwritten.

Service file

When configuring an import, its parameters are saved to an XML file with a name like usermove_params.3DzhkJ in the /usr/local/mgr5/tmp/usermove/ directory. When the import is launched, the file is passed to the usermovectl utility, which installs the software, updates the panel, increases user limits, and launches the import.

After the import is complete, the file is deleted. If the import was configured but not launched, the file will be deleted after 3 days.

Data import logging

  • /usr/local/mgr5/var/ispmgr.log — imported entities processing log
  • /usr/local/mgr5/var/usermovectl.log — usermovectl utility log
  • /usr/local/mgr5/var/usermove.log — main log of import via rsync
  • /usr/local/mgr5/var/backup2_import.log — main log of import from a backup (when loading an archive from a local computer/from a local directory/from URL)
  • /usr/local/mgr5/var/restore2.log — log of launches of data restoration from an imported backup (except ispmanager 4)
  • /usr/local/mgr5/var/backup2_cpanel_conv.log — log of user entity conversion when importing from cPanel
  • /usr/local/mgr5/var/backup2_plesk_conv.log — log of user entity conversion when importing from Plesk

Database

Import parameters are written to the tables of the internal ispmanager database:

  • usermove — imports table. Contains the following fields:
    • begin_time — date and time the import started
    • status — import status, possible values are:
      • 0 — completed
      • 1 — suspended
      • 2 — shutting down
      • 3 — in progress
    • users — a link to the users table containing the ID of the user that ran the import
  • usermove_journal — import log table. Contains the following fields:
    • import_id — a link to the usermove table containing the ID of the import
    • user_name — username of the user that owns the entity
    • type — entity type
    • object_name — entity name
    • status — entity import status, possible values are:
      • 0 — imported successfully
      • 1 — pending import
      • 2 — import in progress
      • 3 — skipped
      • 4 — imported with warnings
      • 5 — error, the entity is not imported
    • details — warnings and import errors

In this article