Миграция с VMmanager 5 на VMmanager 6

Миграция позволяет перенести управление виртуальными машинами (ВМ) из панели VMmanager 5 KVM в платформу VMmanager 6. Миграция включает перенос:

адресного пространства — используемых IP-адресов, пулов и сетей;
учётных записей пользователей;
ограничений доступа к ВМ;
пользователей BILLmanager, если была настроена интеграция.

Для мигрируемых ВМ платформа создаст временный кластер с ограниченной функциональностью. После миграции вы можете перенести ВМ из этого кластера в другие кластеры платформы.

Обратите внимание!

В статье описана миграция из панели управления VMmanager 5 KVM. Если вы используете VMmanager 5 OVZ, ВМ можно перенести вручную по инструкции из статьи Перенос OVZ-контейнера в LXD-кластер

Ограничения миграции

Вы можете перенести в VMmanager 6 любой кластер из VMmanager 5. Дальнейшая миграция ВМ в кластеры VMmanager 6 имеет ограничения в текущей версии платформы:

Ограничение	Возможное решение
для узлов кластера с QEMU версии ниже 2.0.0 недоступна "живая" миграция ВМ	выключить ВМ перед миграцией
изменение типа хранилища может привести к временной недоступности ВМ	не менять тип хранилища при миграции
у ВМ не должно быть сетевых интерфейсов, подключённых к NAT	изменить сетевую конфигурацию ВМ
к каждому сетевому мосту узла кластера должно быть подключено не более одного интерфейса ВМ	удалить интерфейс ВМ или подключить его к свободному сетевому мосту
у ВМ не должно быть созданных снимков (snapshot)	удалить снимки перед миграцией
у ВМ не должно быть подключённых ISO-образов	отключить ISO-образы перед миграцией
диск ВМ должен находиться в локальном хранилище — файловом или LVM	возможность миграции появится в следующих версиях платформы

Миграция ВМ возможна в кластеры с сетевой настройкой "Коммутация" или IP-fabric.

Для миграции лицензия на панель управления VMmanager 5 должна быть активной.

Tребования к сетевым настройкам

У каждого сервера должно быть уникальное имя хоста (hostname).

Разрешите подключения на порты:

между сервером с панелью управления VMmanager 5 и платформой VMmanager 6:
- 22/tcp — SSH;
- 5900-6900/tcp — QEMU VNC, SPICE;
- 6514/tcp — сервис управления виртуальными машинами libvirt;
- 49152-49261/tcp — сервисы миграции libvirt;
- 443/tcp — HTTPS;
между узлами кластера VMmanager 5 и узлами кластера VMmanager 6:
- 22/tcp — SSH;
- 49152-49261/tcp — сервисы миграции libvirt;
- 443/tcp — HTTPS;
между узлами кластера VMmanager 5 и платформой VMmanager 6:
- 22/tcp — SSH;
- 5900-6900/tcp — QEMU VNC, SPICE;
- 6514/tcp — сервис управления виртуальными машинами libvirt;
- 49152-49261/tcp — сервисы миграции libvirt;
- 443/tcp — HTTPS.

Если у VMmanager 5 настроена интеграция с IPmanager 5 или BILLmanager, платформа VMmanager 6 должна иметь доступ к портам IPmanager5 или BILLmanager:

22/tcp — SSH;
443/tcp — HTTPS;
3306/tcp, 3306/udp - cервер MySQL IPmanager или BILLmanager;

Если BILLmanager находится за сервисом защиты от DDoS, в настройках миграции необходимо указать IP-адрес сервера BILLmanager с открытыми портами 22/tcp и 443/tcp. При миграции в BILLmanager изменяются идентификаторы услуг и пользователей, и VMmanager 6 может создавать большое количество запросов в BILLmanager, что может привести к блокировке таких запросов защитой от DDoS.

Порт 22/tcp должен быть доступен для всех узлов кластера и при необходимости для публичной сети.

Если доступ к QEMU VNC, SPICE осуществляется только через сервер с VMmanager, диапазон портов 5900-6900/tcp должен быть открыт для сети, объединяющей узлы кластера.

Порядок миграции

Импорт адресного пространства

Для управления адресным пространством VMmanager 5 и VMmanager 6 используют разное ПО:

VMmanager 5 — панель управления IPmanager 5;
VMmanager 6 — встроенный модуль IPmanager 6.

При миграции вы можете импортировать адресное пространство из IPmanager 5 в IPmanager 6.

IPmanager 6 поддерживает режим эмуляции API IPmanager 5. Если вы используете другие программные продукты, которым требуется интеграция с IPmanager 5 (например, BILLmanager, DCImanager 5, ISPmanager), вы сможете перенастроить их на работу с IPmanager 6.

Пример управления адресным пространством

Импорт кластера VMmanager 5

Чтобы импортировать кластер VMmanager 5, сервис миграции:

Подключается к VMmanager 5 и получает информацию о сущностях, созданных в панели управления — ВМ, пользователях, настройках кластера.
Блокирует работу VMmanager 5.
Создаёт резервную копию платформы VMmanager 6.
Импортирует информацию о настройках VMmanager 5 в VMmanager 6.
Если в VMmanager 5 была настроена интеграция с BILLmanager:
1. Подключается к BILLmanager.
2. Меняет тип обработчика услуг на VMmanager 6.
3. Добавляет в VMmanager 6 пользователей BILLmanager с услугами VMmanager 5.

Перенос пользователей VMmanager 5

Если в настройках пользователя VMmanager 5 был указан e-mail, то в VMmanager 6 будет создана учётная запись с этим e-mail.

Если e-mail в настройках пользователя VMmanager 5 не указан, то в VMmanager 6 будет создана учётная запись вида username@vm5.imported, где username — имя пользователя VMmanager 5.

Подготовка к миграции

VMmanager 5

Создайте резервную копию ВМ и панели управления. Подробнее см. в статье Управление планами резервного копирования документации VMmanager 5.
Разрешите доступ к серверу по SSH-ключу:
1. В файле /etc/ssh/sshd_config укажите параметр
```
PubkeyAuthentication yes
```
2. Перезапустите службу sshd:
```
systemctl restart sshd
```
Определите используемое количество ядер CPU на узлах кластера:
```
dmidecode --type processor | grep -i "core enabled"
```

VMmanager 6

Убедитесь, что лицензия VMmanager 6 содержит достаточное количество ядер CPU для подключения всех узлов кластера из VMmanager 5. При необходимости приобретите лицензию, поддерживающую большее количество ядер.
Если платформа не установлена:
1. Убедитесь, что сервер для VMmanager 6 удовлетворяет системным требованиям.
2. Установите VMmanager 6 по инструкции.
3. Выполните начальную настройку платформы.

BILLmanager

Создайте сотрудника для настройки интеграции. При создании включите опцию Полный доступ. Подробнее см. в статье документации BILLmanager Сотрудники, отделы, права доступа.
Создайте обработчик VMmanager 6 и тарифные планы для услуг виртуальных серверов.
Создайте резервную копию BILLmanager. Подробнее см. в статье Резервное копирование документации BILLmanager.
Сформируйте ключ для авторизации:
1. Подключитесь к серверу с BILLmanager по SSH с правами суперпользователя.
2. Выполните команду:
```
/usr/local/mgr5/sbin/mgrctl -m billmgr session.newkey user='<integration_user>' key='<secret_key>'
```
  Пояснения к команде
  
  <integration_user> — имя пользователя для настройки интеграции
  <secret_key> — ключ для авторизации — случайная комбинация длиной не менее 16 символов
3. Сохраните значение ключа.

IPmanager 5

Убедитесь, что IPmanager 5 использует СУБД MySQL или MariaDB. Если IPmanager 5 использует СУБД SQLite, перейдите на использование СУБД MySQL. Подробнее см. в статье Использование MySQL в качестве СУБД документации IPmanager.
Обратите внимание!
Рекомендуемая версия MySQL/MariaDB – не ниже 5.5.x. Для более ранних версий успешный импорт ВМ не гарантируется.
Убедитесь, что cервер MySQL доступен со стороны VMmanager 6 — проверьте открыты ли в настройках файрвола порты 3306/TCP, 3306/UDP и возможно ли удалённое подключение к БД:
1. Подключитесь к серверу IPmanager 5 по SSH.
2. Проверьте текущие настройки файрволла:
```
firewall-cmd --list-all
```
3. Откройте порты 3306/TCP, 3306/UDP:
```
firewall-cmd --permanent --add-port=3306/tcp
firewall-cmd --permanent --add-port=3306/udp
```
4. Перезапустите сервис файрволла:
```
service firewalld restart
```
5. Откройте конфигурационный файл MySQL /etc/my.cnf. В раздел [mysqld] добавьте параметр bind-address=xxx.xxx.xx.x и закомментируйте строку с параметром skip-networking.
  Пояснения
  xxx.xxx.xx.x — IP-адрес сервера с IPmanager 5
6. Подключитесь к сервису mysql:
```
mysql -u root
```
```
use mysql;
```
7. Разрешите пользователю удалённое подключение к MySQL:
```
GRANT ALL PRIVILEGES ON <DB_NAME> . * TO '<DB_USER>'@'<REMOTE_IP>' IDENTIFIED BY '<DB_PASSWORD>';
```
  Пояснения
  
  <DB_NAME> — имя базы данных
  <DB_USER> — имя пользователя, которому разрешено удалённое подключение
  <REMOTE_IP> — IP-адрес сервера, с которого будет удалённое подключение
  <DB_PASSWORD> — пароль пользователя, которому разрешено удалённое подключение
```
FLUSH PRIVILEGES;
```

Миграция

Миграция IP-адресов

Перейдите в → Миграция → Мигрировать IP-адреса из IPmanager 5 .
Укажите настройки подключения к IPmanager 5:
Обратите внимание!
Настройки подключения указаны в конфигурационном файле IPmanager /usr/local/mgr5/etc/ipmgr.conf:
- Адрес сервера с IPmanager — параметр DBHost;
- Имя базы данных — параметр DBName;
- Логин пользователя для интеграции — параметр DBUser;
- Пароль — параметр DBPassword.
1. Адрес сервера с IPmanager — IP-адрес БД IPmanager 5;
2. Имя базы данных — имя БД IPmanager 5;
3. Логин пользователя для интеграции — имя пользователя БД IPmanager 5;
4. Пароль — пароль пользователя БД IPmanager 5.
Нажмите Мигрировать IP.

Как перенести отдельные блоки IP-адресов

Создайте на сервере с IPmanager 5 пользователя для интеграции. Пользователю должны быть доступны все типы адресов, которые нужно перенести. Подробнее о типах адресов см. в статье Управление группами IP-адресов документации IPmanager.
Подключитесь к серверу с VMmanager 6 по SSH.
Перейдите в контейнер vm_ipmgr_1:
```
docker exec -it vm_ipmgr_1 bash
```
Перейдите в директорию /opt/ispsystem/ipmgr/:
```
cd /opt/ispsystem/ipmgr/
```
Запустите импорт:
```
bin/mgr5import --dbhost <db_ip> --dbname <db_name> --dbuser <db_user> --dbpassword <db_pass> --user <ipmgr_user>
```
Пояснения к команде

<db_ip> — IP-адрес БД IPmanager 5
<db_name> — имя БД IPmanager 5
<db_user> — имя пользователя БД IPmanager 5
<db_pass> — пароль пользователя БД IPmanager 5
<ipmgr_user> — имя пользователя IPmanager 5, созданного для интеграции
Обратите внимание!
Вы можете не использовать параметр --user. В этом случае VMmanager 6 выполнит импорт всей БД IPmanager 5 и создаст пулы IP-адресов вида USERNAME_GROUPNAME, где USERNAME — имя пользователя IPmanager, GROUPNAME — имя группы адресов IPmanager.

Необязательные параметры команды

--noip — не конвертировать IP-адреса.
--nohistory — не конвертировать историю IP-адресов.
--debug — вывод лога команды в stdout.

Вы можете проверить выполнение команды по лог-файлу /var/log/ipmgr5_import.log в контейнере vm_ipmgr_1 на сервере с VMmanager.
Пример вывода команды
Выйдите из контейнера:
```
exit
```

Чтобы VMmanager 5 и BILLmanager могли работать с IPmanager 6:

Если требуется доступ только к определённому пулу IP-адресов, создайте в VMmanager 6 пул с суффиксом public. Например, VM5_public.
Создайте в VMmanager 6 учётную запись администратора с именем ipmgr5@example.com.
Обратите внимание!
ipmgr5@example.com — не пример, а точное имя, которое нужно указать при создании учётной записи.
В VMmanager 5 и BILLmanager:
1. Перейдите в Интеграция → IPmanager.
2. Укажите настройки для интеграции:
  1. URL — https://domain.com/api/ipmgr5/v3/ipmgr
    Пояснения к URL
    domain.com — доменное имя или IP-адрес сервера с VMmanager.
  2. Имя пользователя:
    - чтобы панель управления имела доступ только к определённому пулу IP-адресов, укажите pool_XXX;
      Пояснения
      XXX — префикс пула в VMmanager. Например, для пула VM5_public укажите имя пользователя pool_VM5.
    - чтобы панель управления имела доступ ко всему адресному пространству, укажите произвольное имя пользователя.
  3. Пароль — пароль пользователя ipmgr5@example.com.
  4. В секции Синхронизация списка IP-адресов оставьте пустыми поля Логин администратора и Пароль администратора.
3. Нажмите Ok.

Если у VMmanager 6 настроена интеграция с DNSmanager 6, то после создания адресного пространства необходимо синхронизировать PTR-записи с DNS-сервером. Для этого:

Удалите модуль "Интеграция с DNSmanager 6": Настройки → Модули → Интеграция с DNSmanager 6 → Удалить модуль → Удалить модуль .
Повторно установите и настройте модуль интеграции. Подробнее см. в статье Модуль "Интеграция с DNSmanager 6".

Проверить выполнение синхронизации вы можете по лог-файлу /var/log/dns_proxy_integration.log в контейнере vm_dns_proxy_1 на сервере с VMmanager.

Миграция виртуальных машин

Обратите внимание!

Вы можете перенести виртуальные машины из нескольких экземпляров VMmanager 5 в один экземпляр VMmanager 6. Для ВМ из каждого экземпляра VMmanager 5 будет создан отдельный временый кластер.

Перейдите в → Миграция → Мигрировать виртуальные машины из VMmanager 5.
Укажите настройки миграции:
1. Название временного кластера, который будет создан в VMmanager 6.
2. SSH-адрес сервера VMmanager 5.
3. Имя пользователя SSH для подключения к серверу с VMmanager 5.
4. SSH-порт.
Скопируйте Публичный ssh-ключ и добавьте его в файл ~/.ssh/authorized_keys на сервере с VMmanager 5.
Укажите настройки подключения к BILLmanager, если у VMmanager 5 настроена интеграция:
1. Адрес сервера BILLmanager 5 — IP-адрес или доменное имя сервера.
2. Логин администратора панели — введите имя сотрудника для интеграции, созданного при подготовке BILLmanager.
3. Временный ключ, созданный при подготовке BILLmanager.
4. Название обработчика VMmanager 5.
Нажмите Мигрировать VMmanager 5.

Если миграция завершилась с ошибкой вида

{
  "error": {
    "code": 1111,
    "msg": "Handler throw uncaught exception",
    "value": "vm/import/cluster Can not load a vm5_data file"
  }
}

проверьте доступно ли SSH-подключение из контейнера vm_box сервера с VMmanager 6 на основной узел VMmanager 5.

IP-адрес основного узла VMmanager 5 указан в параметре MainIp конфигурационного файла /usr/local/mgr5/etc/vmmgr.conf на сервере с VMmanager 5.

Перенос ВМ из временного кластера

Для ВМ из VMmanager 5 создаётся временный кластер с типом VM5 KVM и сетевой настройкой "Коммутация". Доступные операции с ВМ во временном кластере:

запуск;
остановка;
перезагрузка;
подключение по VNC и SPICE;
удаление;
миграция на другой узел кластера;
миграция в другой кластер, если конфигурация ВМ соответствует требованиям.

Чтобы на мигрируемых ВМ были доступны все функции, перенесите их в другие кластеры платформы.

Если ВМ не удовлетворяет требованиям для переноса в кластер VMmanager 6, рядом с её названием отображается ссылка Миграция в кластер VM6 недоступна. Чтобы получить подробную информацию, нажмите на ссылку.

Если у ВМ есть сетевые интерфейсы, подключённые к NAT

Если у ВМ есть сетевые интерфейсы, подключённые к NAT, измените сетевую конфигурацию ВМ:

Подключитесь к узлу временного кластера по SSH.

Выведите список виртуальных сетей на узле:

virsh net-list

Пример ответа

 Name                 State      Autostart     Persistent

----------------------------------------------------------
 default              active     yes           yes
 DefaultBridge        active     yes           yes
 NAT_192.168.168.1    active     yes           yes

Определите какая сеть относится к NAT. Для этого для каждой сети выполните команду:
```
virsh net-dumpxml <network> | grep 'forward mode'
```
Пояснения к команде
<network> — имя сети
Примеры ответов:
Сеть типа NAT
```
<forward mode='nat'>
```
Сеть типа bridge
```
<forward mode='open'/>
```
Изучите файл конфигурации ВМ:
```
virsh dumpxml <VM_domain>
```
Пояснения к команде
<VM_domain> — доменное имя ВМ
Отредактируйте конфигурацию libvirt:
```
virsh edit <VM_domain>
```
Пояснения к команде
<VM_domain> — доменное имя ВМ
В файле нужно заменить строку вида
```
<source network='<nat_network>' bridge='<virt_interface>'/>
```
Пояснения

<nat_network> — имя сети типа NAT
<virt_interface> — имя виртуального интерфейса

на строку вида
```
<source network='<bridge_network>'/>
```
Пояснения
<bridge_network> — имя сети типа bridge
Подключитесь к серверу с платформой по SSH.
Удалите записи об интерфейсах из БД:
В связи с поэтапным переходом платформы на использование СУБД PostgreSQL, разные экземпляры VMmanager могут использовать разные СУБД:
- VMmanager Hosting — MySQL;
- VMmanager Infrastructure:
  для новых установок на ОС Astra Linux, начиная с версии VMmanager 2023.06.1 — PostgreSQL;
  в остальных случаях — MySQL.
Чтобы определить тип СУБД, выполните на сервере с платформой команду:
docker ps --filter name=pgsql
Пример ответа
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 3213c5dc94d0 postgres:12 "docker-entrypoint.s…" 5 days ago Up 4 days 5432/tcp pgsql
Если вывод команды содержит информацию о контейнере, платформа использует PostgreSQL, если ответ пустой — MySQL.
MySQL
```
docker exec -it mysql bash -c "mysql isp -p\$MYSQL_ROOT_PASSWORD" 
```
PostgreSQL
```
docker exec -it pgsql bash -c "psql -d isp"
```
```
DELETE FROM vm_host_interfaces WHERE host = <VM_id> AND node_bridge IS NULL ;
```
Пояснения к команде
<VM_id> — id ВМ

Вмешательство в базу данных предполагает потенциальный риск. Мы не рекомендуем вносить ручные правки в базу, поскольку это может нарушить корректную работу платформы.
Инструкции по внесению изменений в БД следует выполнять только после резервного копирования платформы.
```
\q
```
Перезапустите ВМ.

Если у ВМ есть снимки (snapshots)

Если у ВМ есть снимки (snapshots), удалите их:

Подключитесь к узлу временного кластера по SSH.
Проверьте, что снимки подключены:
```
virsh snapshot-list <VM_domain>
```
Пояснения к команде
<VM_domain> — доменное имя ВМ
Подключитесь к серверу с платформой по SSH.
Удалите записи о снимках из БД:
В связи с поэтапным переходом платформы на использование СУБД PostgreSQL, разные экземпляры VMmanager могут использовать разные СУБД:
- VMmanager Hosting — MySQL;
- VMmanager Infrastructure:
  для новых установок на ОС Astra Linux, начиная с версии VMmanager 2023.06.1 — PostgreSQL;
  в остальных случаях — MySQL.
Чтобы определить тип СУБД, выполните на сервере с платформой команду:
docker ps --filter name=pgsql
Пример ответа
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 3213c5dc94d0 postgres:12 "docker-entrypoint.s…" 5 days ago Up 4 days 5432/tcp pgsql
Если вывод команды содержит информацию о контейнере, платформа использует PostgreSQL, если ответ пустой — MySQL.
MySQL
```
docker exec -it mysql bash -c "mysql isp -p\$MYSQL_ROOT_PASSWORD" 
```
PostgreSQL
```
docker exec -it pgsql bash -c "psql -d isp"
```
```
DELETE FROM vm_snapshot WHERE host = <VM_id> ;
```
```
UPDATE vm_host SET vm5_data=json_replace(vm5_data,'$.snapshot',json_array()) WHERE id= <VM_id> ;
```
Пояснения к командам
<VM_id> — id ВМ

Вмешательство в базу данных предполагает потенциальный риск. Мы не рекомендуем вносить ручные правки в базу, поскольку это может нарушить корректную работу платформы.
Инструкции по внесению изменений в БД следует выполнять только после резервного копирования платформы.
```
\q
```

Если к ВМ подключены ISO-образы

Если к ВМ подключены ISO-образы, отключите их:

Подключитесь к узлу временного кластера по SSH.
Изучите файл конфигурации ВМ:
```
virsh dumpxml <VM_domain>
```
Пояснения к команде
<VM_domain> — доменное имя ВМ
Раздел с описанием ISO-образа имеет вид:
Пример описания
```
<disk type='file' device='cdrom'>
<driver name='qemu' type='raw'/>
<source file='/nfsshare/iso/tQVJGvq2bYQNWdvD2xB14xB1J111v11'/>
<backingStore/>
<target dev='hda' bus='ide'/>
<readonly/>
<boot order='2'/>
<alias name='ide0-0-0'/>
<address type='drive' controller='0' bus='0' target='0' unit='0'/>
</disk>
```
Сохраните имя устройства из параметра target dev. В примере выше это hda.
Отредактируйте конфигурацию libvirt:
```
virsh edit <VM_domain>
```
Пояснения к команде
<VM_domain> — доменное имя ВМ
Из файла нужно удалить разделы с описанием ISO-образов.
Подключитесь к серверу с платформой по SSH.
Удалите записи об ISO-образах из БД:

Вмешательство в базу данных предполагает потенциальный риск. Мы не рекомендуем вносить ручные правки в базу, поскольку это может нарушить корректную работу платформы.
Перед внесением изменений в БД создайте резервную копию платформы.
В связи с поэтапным переходом платформы на использование СУБД PostgreSQL, разные экземпляры VMmanager могут использовать разные СУБД:
- VMmanager Hosting — MySQL;
- VMmanager Infrastructure:
  для новых установок на ОС Astra Linux, начиная с версии VMmanager 2023.06.1 — PostgreSQL;
  в остальных случаях — MySQL.
Чтобы определить тип СУБД, выполните на сервере с платформой команду:
docker ps --filter name=pgsql
Пример ответа
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 3213c5dc94d0 postgres:12 "docker-entrypoint.s…" 5 days ago Up 4 days 5432/tcp pgsql
Если вывод команды содержит информацию о контейнере, платформа использует PostgreSQL, если ответ пустой — MySQL.
MySQL
```
docker exec -it mysql bash -c "mysql isp -p\$MYSQL_ROOT_PASSWORD" 
```
PostgreSQL
```
docker exec -it pgsql bash -c "psql -d isp"
```
```
DELETE FROM vm_disk WHERE host = <VM_id> AND target_dev = <device_name> ;
```
Пояснения к команде

<VM_id> — id ВМ
<device_name> — имя устройства
Проверьте наличие основного диска у ВМ:
```
SELECT id,is_main FROM vm_disk WHERE host = <VM_id>;
```
Если ответ для всех дисков содержит NULL, укажите один из дисков как основной:
```
UPDATE vm_disk SET is_main = 1 WHERE host = <VM_id> AND id = <disk_id>;
```
Пояснения к командам

<VM_id> — id ВМ
<disk_id> — id диска
Выйдите из консоли СУБД:
```
\q
```
Перезапустите ВМ.

Если на узле VMmanager 5 установлена ОС CentOS 6

Если на узле VMmanager 5 установлена ОС CentOS 6, после миграции у узла будет статус "Недоступен", а статусы ВМ не будут отображаться. ВМ в таком состоянии невозможно перенести через интерфейс платформы.

Эта проблема связана с тем, что служба мониторинга gomon, используемая в платформе, не поддерживает установку на ОС CentOS 6. Чтобы перенести ВМ с такого узла:

В интерфейсе платформы остановите все ВМ на этом узле.
Подключитесь к узлу по SSH.

Проверьте статус ВМ:

virsh list --all

Пример вывода

 Id    Name                          State
-----------------------------------------------
 606   2689_halloween_rubellite      running
 609   2690_shadow_almandite         running
 657   1776_olive_wascoite           running
 -     2112_minikube                 shut off
 -     2115_alabaster_siberite       shut off

Если вывод команды содержит ВМ со статусом, отличным от shut off, остановите эти ВМ:
```
virsh shutdown <VM_domain>
```
Пояснения к команде
<VM_domain> — имя ВМ в формате <id ВМ>_<название ВМ>. Например, 1776_olive_wascoite
Подключитесь к серверу с платформой по SSH.
Измените статус всех ВМ на "Остановлена":
1. Откройте консоль СУБД:
  В связи с поэтапным переходом платформы на использование СУБД PostgreSQL, разные экземпляры VMmanager могут использовать разные СУБД:
  VMmanager Hosting — MySQL;
  VMmanager Infrastructure:
  для новых установок на ОС Astra Linux, начиная с версии VMmanager 2023.06.1 — PostgreSQL;
  в остальных случаях — MySQL.
  
  Чтобы определить тип СУБД, выполните на сервере с платформой команду:
  docker ps --filter name=pgsql
  Пример ответа
  CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 3213c5dc94d0 postgres:12 "docker-entrypoint.s…" 5 days ago Up 4 days 5432/tcp pgsql
  Если вывод команды содержит информацию о контейнере, платформа использует PostgreSQL, если ответ пустой — MySQL.
  MySQL
```
docker exec -it mysql bash -c "mysql isp -p\$MYSQL_ROOT_PASSWORD"
```
  PostgreSQL
```
docker exec -it pgsql bash -c "psql -d isp"
```
2. Выполните команду:
```
UPDATE vm_host SET state='stopped' WHERE node=<node_id>;
```
  Пояснения к команде
  <node_id> — id узла
3. Выйдите из консоли СУБД:
```
\q
```
Выполните миграцию ВМ через интерфейс платформы. В параметрах миграции отключите опцию Сжимать диск VM перед миграцией.

Если у ВМ модель добавления IP-адресов "Нет автоматизации"

Для корректного переноса ВМ с ОС Windows установите на узле временного кластера утилиту libguestfs-winsupport.

Платформа взаимодействует с ВМ через программу QEMU Guest Agent. Например, QEMU Guest Agent нужен, чтобы VMmanager мог изменить пароль или запустить скрипт на ВМ. Если QEMU Guest Agent на ВМ не установлен или не отвечает, в столбце Состояние у ВМ отображается сообщение Проблема с Guest Agent. Чтобы установить QEMU Guest Agent на ВМ, нажмите на Проблема с Guest Agent → Установить GA и перезапустить ВМ. Вы можете установить QEMU Guest Agent вручную. Подробнее см. в статье Как проверить и восстановить работу QEMU Guest Agent?

Перенос ВМ без отключения ("живая" миграция) возможен, если:

на узле кластера VMmanager 5 установлен QEMU версии 2.0.0 и выше;
версия libvirt на узле кластера VMmanager 6 не ниже версии libvirt на узле кластера VMmanager 5.

В остальных случаях ВМ необходимо отключить перед переносом.

Чтобы перенести ВМ из временного кластера:

Выделите нужные ВМ → еще... → Мигрировать.
Укажите параметры миграции:
1. Отключите опцию Сжимать диск VM перед миграцией, если сжатие диска не требуется. Опция доступна только для выключенных ВМ.
2. Отключите опцию Учитывать фильтры распределения, если использование фильтров не требуется. Подробнее о фильтрах распределения см. в статье Управление серверами кластера.
3. Выберите кластер для миграции.
4. Выберите узел для миграции.
5. Выберите Доступные хранилища на узле, в которых будут размещены диски ВМ. Диски одной ВМ могут быть размещены в разных хранилищах.
6. Изучите информацию в разделе Резюме по VM. Раздел содержит информацию о том, все ли диски распределены и требуется ли для ВМ перезагрузка.
Нажмите Мигрировать (Мигрировать и перезагрузить).

Действия после миграции

После переноса ВМ временный кластер можно удалить. Свободные узлы из временного кластера могут быть подключены к другим кластерам платформы. Перед подключением рекомендуем переустановить ОС на этих узлах.

Перенос услуг в BILLmanager

Если у VMmanager 5 была настроена интеграция с BILLmanager, то сервис миграции:

Изменит тип обработчика услуг с VMmanager 5 на VMmanager 6.
Добавит к его названию префикс _imported.

Новый обработчик создаётся для управления ВМ во временном кластере. Заказ новых услуг через этот обработчик недоступен. После переноса ВМ в другие кластеры платформы переключите услуги на тарифные планы с другим обработчиком VMmanager 6.

Для ручного переноса услуг на новый обработчик:

Подключите для тарифных планов VMmanager 5 обработчик услуг VMmanager 6. Для этого:
1. Перейдите в Продукты → Тарифные планы → выберите тариф, с которого была продана услуга виртуального сервера для VMmanager 5 → кнопка Обработчики.
2. Включите обработчик VMmanager 6.
Отключите виртуальные машины из BILLmanager:
1. Перейдите в Товары/Услуги → Виртуальные серверы → выберите все услуги виртуальных серверов VMmanager 5 (зажмите CTRL) → кнопка Изменить.
2. Нажмите кнопку Выкл.
3. Подтвердите выключение при помощи кнопки Ok.
Перенесите услуги виртуальных серверов на тарифные планы с обработчиком VMmanager 6:
1. Перейдите в Товары/Услуги → Виртуальные серверы → выберите все услуги виртуальных серверов VMmanager 5 (зажмите CTRL) → кнопка Изменить.
2. Укажите в поле Модуль обработки обработчик услуг VMmanager 6.
3. Нажмите Ok.
Включите услуги в BILLmanager.
Удалите сотрудника, созданного для интеграции.

Возможные проблемы

Возможные проблемы при миграции описаны в статье базы знаний Возможные проблемы при миграции с VMmanager 5.

Повторная миграция

Если первый запуск миграции завершился с ошибкой, вы можете выполнить миграцию повторно. Если при первой миграции было импортировано адресное пространство, для повторной миграции удалять его не нужно.

Для миграции услуг из BILLmanager повторно сформируйте ключ для авторизации.

Отмена миграции

Вы можете вернуть управление ВМ в VMmanager 5 после миграции. Отмена миграции возможна, только если ВМ после миграции не были удалены или перенесены в другие кластеры.

Чтобы отменить миграцию:

Восстановите состояние VMmanager 6 из резервной копии. Подробнее см. в статье Резервное копирование платформы.
Если вы изменяли настройки BILLmanager, восстановите состояние панели управления из резервной копии. Подробнее см. в статье Резервное копирование документации BILLmanager.
Разблокируйте VMmanager 5:
1. Подключитесь к серверу с VMmanager 5 по SSH:
2. Выполните команду:
```
/usr/local/mgr5/sbin/mgrctl -m vmmgr -u
```