Импорт данных: общие сведения
Импорт данных — это перенос данных из одной панели в другую. В ispmanager доступен импорт пользователей и их данных из панелей:
- ispmanager 4 lite
- ispmanager 5 lite
- ispmanager 6 lite, pro, host, business
- cPanel
- Plesk
Мастер импорта:
- позволяет пошагово настроить импорт данных
- проверяет наличие требуемого ПО, настроек и доступов на сервере-приемнике и при необходимости позволяет добавить их в процессе импорта (доступно для ispmanager 6, ispmanager business 6)
- формирует предварительный отчет со списком сущностей, которые не могут быть импортированы или будут импортированы с изменениями, и списком устанавливаемого ПО
- после запуска импорта генерирует журнал со списком сущностей и информацией о статусе их импорта
Возможности импорта: администратор vs пользователь
| Администратор | Пользователь |
|---|---|
| Может импортировать данные принадлежащих ему пользователей | Может импортировать только собственные данные |
| Может использовать rsync или резервную копию | Может использовать только резервную копию |
| Может устанавливать необходимое ПО, увеличивать лимиты и включать необходимые доступы для пользователей в процессе импорта | Не может устанавливать необходимое ПО, увеличивать лимиты и включать доступы в процессе импорта |
| Импортированные пользователи будут созданы в панели автоматически, их лимиты будут сохранены | Лимиты импортированного пользователя применены не будут. Владельцем импортированных данных будет пользователь, под которым выполняется импорт |
Импорт через rsync
Технология rsync позволяет импортировать пользователей без использования резервных копий. Этот способ экономит дисковое пространство, так как требует ровно столько места, сколько занимает импортируемый пользователь и его данные.
Импорт через rsync недоступен из панели Plesk.
✅ — сущность будет импортирована автоматически, ❌ — сущность не будет импортирована автоматически
При необходимости настройте нужные сущности вручную после импорта.
| Сущность | Импорт из ispmanager | Импорт из cPanel |
|---|---|---|
| Пользователи | ||
| Имя и пароль пользователя | ✅ | ✅ |
| Квоты пользователя | ✅ | ✅ |
| Доступ пользователя к shell и SSL | ✅ | ✅ |
| Сайты | ||
| Сайт как сущность | ✅ | ✅ |
Файлы пользователя из директории /home/ИМЯ_ПОЛЬЗОВАТЕЛЯ | ✅ | ✅ |
| Редиректы сайта | ✅ | ❌ |
| Страницы ошибок сайта | ✅ | ❌ |
| Домены | ||
| Доменные имена | ✅ | ✅ |
| DNS-записи | ✅ | ✅ |
| Почта | ||
| Почтовые домены | ✅ | ✅ |
| Почтовые ящики и письма | ✅ | ✅ |
| Автоответчик | ❌ | ❌ |
| Сортировщик | ❌ | ❌ |
| Перенаправления почты | ✅ | ❌ |
| Базы данных | ||
Базы данных, пользователи баз данных и дампы MySQL Подробнее Базы данных Percona будут перенесены, если на сервере-источнике установлена СУБД Percona. В противном случае база данных будет перенесена в MySQL. | ✅ | ✅ |
| Пароль пользователя баз данных | ✅ | ❌ Подробнее Чтобы авторизоваться в phpMyAdmin, укажите пароль пользователя БД из cPanel вручную. Для автоматической авторизации из раздела Базы данных введите и сохраните пароль в форме пользователя БД. |
| Базы данных удаленных профилей сервера MySQL | ❌ | ❌ |
| Базы данных PostgreSQL | ✅ | ❌ |
| PHP | ||
| Версии PHP для сайтов | ✅ | ✅ |
| Режимы обработки PHP | ✅ | ✅ |
| SSL | ||
| SSL-сертификаты | ✅ | ✅ |
| CSR-запросы | ✅ | ✅ |
| Служебные данные Let’s Encrypt | ✅ | ❌ Подробнее После импорта сертификаты Let's Encrypt продолжат свою работу, но не будут продлеваться автоматически. Перевыпустите их сразу после переноса или позднее, когда срок действия подойдет к концу. |
| Прочее | ||
| Задания планировщика | ✅ | ✅ |
| FTP-пользователи | ✅ | ✅ |
Ручные правки в конфигурационных файлах веб-серверов Подробнее Конфигурационные файлы с ручными правками импортируются, если на сервере-источнике и сервере-приемнике установлен один и тот же веб-сервер или на одном из них установлен Apache, а на втором — LiteSpeed. В остальных случаях для импортированных сайтов будут сгенерированы стандартные конфигурационные файлы на основе шаблона. | ✅ | ❌ |
Импорт из резервной копии
Импорт из резервной копии требует предварительного создания резервной копии пользователя в панели-источнике. Исключение — импорт с подключением к удаленной панели: в этом случае резервная копия создается автоматически во время импорта.
Импорт из резервной копии доступен из следующих источников и для следующих панелей:
| С локального компьютера | Из локального архива или каталога | По URL | Из удаленной панели управления | |
|---|---|---|---|---|
| ispmanager 4 | ❌ | ✅ | ❌ | ❌ |
| ispmanager 5, 6 | ✅ | ✅ | ✅ | ✅ |
| ispmanager business 6 | ✅ | ✅ | ✅ | ✅ |
| cPanel | ✅ | ✅ | ✅ | ❌ |
| Plesk | ✅ | ✅ | ✅ | ❌ |
✅ — сущность будет импортирована автоматически, ❌ — сущность не будет импортирована автоматически
При необходимости настройте нужные сущности вручную после импорта.
| Сущность | Импорт из ispmanager | Импорт из cPanel | Импорт из Plesk |
|---|---|---|---|
| Пользователи | |||
| Имя и пароль пользователя | ✅ | ✅ | ✅ |
| Квоты пользователя | ✅ | ✅ | ✅ |
| Доступ пользователя к shell и SSL | ✅ | ✅ | ✅ |
| Сайты | |||
| Сайт как сущность | ✅ | ✅ | ✅ |
| Файлы пользователя из директории /home/имя_пользователя | ✅ | ✅ | ✅ |
| Редиректы сайта | ✅ | ❌ | ❌ |
| Страницы ошибок сайта | ✅ | ❌ | ❌ |
| Домены | |||
| Доменные имена | ✅ | ✅ | ✅ |
| DNS-записи | ✅ | ✅ | ✅ |
| Почта | |||
| Почтовые домены | ✅ | ✅ | ✅ |
| Почтовые ящики и письма | ✅ | ✅ | ✅ |
| Автоответчик | ❌ | ❌ | ✅ |
| Сортировщик | ❌ | ❌ | ❌ |
| Перенаправления почты | ✅ | ❌ | ✅ |
| Базы данных | |||
Базы данных, пользователи баз данных и дампы MySQL Подробнее Базы данных Percona будут перенесены, если на сервере-источнике установлена СУБД Percona. В противном случае база данных будет перенесена в MySQL. | ✅ | ✅ | ✅ |
| Пароль пользователя баз данных | ✅ | ❌ Подробнее Чтобы авторизоваться в phpMyAdmin, укажите пароль пользователя БД из cPanel вручную. Для автоматической авторизации из раздела Базы данных введите и сохраните пароль в форме пользователя БД. | ✅ |
| Базы данных удаленных профилей сервера MySQL | ❌ | ❌ | ❌ |
| Базы данных PostgreSQL | ✅ | ❌ | ❌ |
| PHP | |||
| Версии PHP для сайтов | ✅ | ✅ | ✅ |
| Режимы обработки PHP | ✅ | ✅ | ✅ |
| SSL | |||
| SSL-сертификаты | ✅ | ✅ | ✅ |
| CSR-запросы | ❌ | ❌ | ❌ |
| Служебные данные Let’s Encrypt | ✅ | ❌ Подробнее После импорта сертификаты Let's Encrypt продолжат свою работу, но не будут продлеваться автоматически. Перевыпустите их сразу после переноса или позднее, когда срок действия подойдет к концу. | ❌ |
| Прочее | |||
| Задания планировщика | ✅ | ✅ | ✅ |
| FTP-пользователи | ✅ | ✅ | ✅ |
| Ручные правки в конфигурационных файлах веб-серверов | ❌ | ❌ | ❌ |
Отмена импорта
Запущенный импорт можно отменить. При этом:
- сущности импортируемого в данный момент пользователя будут импортированы
- если выполняется импорт файлов или баз данных, импорт будет завершен немедленно
- уже импортированные файлы не будут удалены
- если устанавливается пакет или обновляется панель, установка и обновление не будут прерваны, чтобы избежать конфликтов пакетов
Журнал импорта данных
Журнал импорта содержит поля:
Тип — тип сущности
Возможные значения- Домен
- SSL-сертификат
- CSR-запрос
- Сайт
- Почтовый домен
- Почтовый ящик
- FTP-пользователь
- Задание планировщика
- База данных
- Пользователь базы данных
- Файлы
- Файлы почтового ящика
- Файлы сайта
- Имя — имя сущности
Статус — статус импорта сущности
Возможные значения- Успешно — сущность импортирована без ошибок
- Ожидает — сущность ожидает импорта
- Выполняется — выполняется импорт сущности
- Пропущено — импорт сущности пропущен, если сущность существует
- Предупреждение — сущность была импортирована, но с изменениями, например, изменен обработчик, версия PHP или СУБД
- Ошибка — ошибка импорта сущности
- Детали — описание причин пропусков, предупреждений и ошибок импорта сущности
Для данных доступны фильтрация и поиск.
Устаревший механизм импорта
Устаревший механизм импорта доступен параллельно с новым по URL:
https://<domain_or_ip>:<port>/ispmgr#/form?func=backup2.superlist.importhttps://<domain_or_ip>:<port>/ispmgr#/form?func=backup2.list.importИнструкции для устаревшего импорта перенесены в Базу знаний.
Изменение директорий сущностей при импорте в ispmanager
| cPanel | Plesk | ispmanager | |
|---|---|---|---|
| Домашняя директория пользователя | /home/ИМЯ_ПОЛЬЗОВАТЕЛЯ | /var/www/vhosts/ДОМЕН/ | /var/www/ИМЯ_ПОЛЬЗОВАТЕЛЯ/data |
| Директория почтового ящика | /home/ИМЯ_ПОЛЬЗОВАТЕЛЯ/mail/ПОЧТОВЫЙ_ДОМЕН/ПОЧТОВЫЙ_ЯЩИК | /var/qmail/mailnames/ДОМЕН/ПОЧТОВЫЙ_ЯЩИК/Maildir | /var/www/ИМЯ_ПОЛЬЗОВАТЕЛЯ/data/email/ПОЧТОВЫЙ_ДОМЕН/ПОЧТОВЫЙ_ЯЩИК/.maildir |
| Директория основного сайта | /home/ИМЯ_ПОЛЬЗОВАТЕЛЯ/public_html | /var/www/vhosts/ДОМЕН/httpdocs/ | /var/www/ИМЯ_ПОЛЬЗОВАТЕЛЯ/data/www/ДОМЕН |
| Директории дополнительных сайтов |
| /var/www/vhosts/ДОМЕН/ПОДДОМЕН.ДОМЕН/httpdocs/ |
|
| Путь к SSL-сертификатам | /home/ИМЯ_ПОЛЬЗОВАТЕЛЯ/ssl/certs | /usr/local/psa/var/certificates/ | /var/www/httpd-cert/ИМЯ_ПОЛЬЗОВАТЕЛЯ |
| Путь к почтовому клиенту | https://ДОМЕН_ИЛИ_IP:2096/webmail | https://webmail.ДОМЕН | https://ДОМЕН_ИЛИ_IP:1501/roundcube |
Технические подробности импорта данных
Расчет дискового пространства при импорте
К объему дискового пространства, требуемого для импорта, прибавляется значение параметра UsermoveDiskSizeDelta. Параметр хранится в основном конфигурационном файле панели. Значение по умолчанию — 200 Мб.
Если суммарный объем импортируемых файлов немного превосходит объем свободного пространства на диске, объем импорта можно уменьшить, уменьшив значение параметра UsermoveDiskSizeDelta.
Предположим, объем импортируемых данных составляет 550 Мб. Объем требуемого пространства: 550 Мб + 200 Мб = 750 Мб. На диске свободно 700 Мб.
Чтобы выполнить импорт, укажите значение параметра UsermoveDiskSizeDelta в 150 Мб.
Загрузка архива при импорте из резервной копии
При загрузке резервной копии на сервер (кроме копии из удаленной панели управления) выбранный архив будет загружен в хранилище (по умолчанию — /usr/local/mgr5/var/backup/) в виде пользовательского архива. Существующий пользовательский архив будет перезаписан.
Выбор режима и версии PHP для сайта
Выбор режима
При импорте сайта на сервере-приемнике выполняется поиск режима PHP, который использовался сайтом на сервере-источнике:
- Если режим PHP установлен на сервере-приемнике и доступен пользователю, то он остается для импортируемого сайта без изменения
- Если режим PHP не установлен или не доступен пользователю, будет выбран первый из доступных пользователю режимов PHP
- Если нет ни одного доступного режима PHP, сайт будет импортирован без обработчика PHP
Выбор версии
При импорте сайта на сервере-приемнике выполняется поиск версии PHP, которая использовалась сайтом на сервере-источнике:
- Если версия PHP найдена, то она остается для импортируемого сайта без изменения.
- Если версия PHP для используемого режима PHP не найдена, будет выбрана последняя версия в рамках той же мажорной версии PHP. Например, если для импортируемого сайта на сервере-источнике используется версия PHP 7.1, а на сервере-приемнике есть версии PHP 7.3 и 7.4, то будет выбрана версия PHP 7.4. Если подходящая мажорная версия PHP не найдена, сайт будет импортирован с версией PHP по умолчанию.
- Для сайта, для которого на сервере-источнике используется нативная версия PHP, на сервере-приемнике выбирается подходящая по номеру альтернативная версия PHP. Например, если на сервере-источнике нативная версия PHP — 7.2, для импортируемого сайта на сервере-приемнике будет выбрана альтернативная версия PHP 7.2, а при ее отсутствии — подходящая мажорная версия. Если подходящая альтернативная версия PHP не найдена, сайт будет импортирован с версией PHP, нативной для серврера-приемника.
Служебный файл
Во время настройки импорта его параметры сохраняются в XML-файл с названием вида usermove_params.3DzhkJ в директории /usr/local/mgr5/tmp/usermove/. При запуске импорта файл передается утилите usermovectl, которая устанавливает программное обеспечение, обновляет панель, увеличивает лимиты пользователей и запускает импорт.
После завершения импорта файл удаляется. Если импорт был настроен, но не запущен, файл будет удален через 3 дня.
Логирование импорта данных
/usr/local/mgr5/var/ispmgr.log— лог обработки импортируемых сущностей/usr/local/mgr5/var/usermovectl.log— лог утилиты usermovectl/usr/local/mgr5/var/usermove.log— основной лог импорта через rsync/usr/local/mgr5/var/backup2_import.log— основной лог импорта из резервной копии (при загрузке архива с локального компьютера/из локального каталога/по URL)/usr/local/mgr5/var/restore2.log— лог запуска восстановления из импортированной резервной копии (кроме ispmanager 4)/usr/local/mgr5/var/backup2_cpanel_conv.log— лог конвертации сущностей пользователя при импорте из cPanel/usr/local/mgr5/var/backup2_plesk_conv.log— лог конвертации сущностей пользователя при импорте из Plesk
База данных
Параметры импорта записываются в таблицы внутренней базы данных ispmanager:
- usermove — таблица импортов. Содержит поля:
- begin_time — дата и время запуска импорта
- status — статус импорта, может иметь значения:
- 0 — завершен
- 1 — прерван
- 2 — завершается по прерыванию
- 3 — выполняется
- users — ссылка на таблицу users, содержащая ID пользователя, запустившего импорт
- usermove_journal — таблица журналов импортов. Содержит поля:
- import_id — ссылка на таблицу usermove, содержащая ID импорта
- user_name — имя пользователя, которому принадлежит сущность
- type — тип сущности
- object_name — имя сущности
- status — статус импорта сущности, возможные значения:
- 0 — импортировано успешно
- 1 — ожидает импорта
- 2 — импортируется
- 3 — пропущена
- 4 — импортировано с предупреждениями
- 5 — ошибка, сущность не импортирована
- details — предупреждения и ошибки импорта