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

В статье рассматривается перенос виртуальных машин из VMmanager 5 в VMmanager 6.

VMmanager 6 не поддерживает работу с IPmanager 5. Поэтому при переносе необходимо экспортировать адресное пространство в IPmanager 6. Это встроенный модуль VMmanager 6, который поддерживает режим эмуляции API IPmanager 5. И если в вашей инфраструктуре есть другие программные продукты, которым необходима интеграция с IPmanager 5, то они также могут быть подключены к VMmanager 6 (IPmanager 6). Например, DCImanager 5 и ISPmanager 5/ISPmanager 6.

Схематичное изображение инфраструктуры до и после миграции

Чтобы перенести конфигурацию панели управления VMmanager 5 в платформу VMmanager 6:

1. Установите и выполните начальную настройку VMmanager 6.
2. Экспортируйте информацию об адресном пространстве из IPmanager 5.
3. Перенесите виртуальные машины из VMmanager 5 в VMmanager 6.
4. Измените настройки биллинговой системы.

Установка и настройка VMmanager 6

1. Убедитесь, что сервер для VMmanager 6 удовлетворяет системным требованиям.
2. Установите VMmanager 6 по инструкции.
3. Выполните начальную настройку платформы.

Перенос адресного пространства

Для управления IP-адресами платформа VMmanager использует встроенный модуль IPmanager 6. Чтобы перенести настройки используемого адресного пространства в этот модуль:

1. Убедитесь, что IPmanager 5 использует СУБД MySQL. Если IPmanager 5 использует СУБД SQLite, перейдите на использование СУБД MySQL. Подробнее см. в статье Использование MySQL в качестве СУБД.
2. Убедитесь, что 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

   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;

3. Импортируйте IP-адреса. Из интерфейса VMmanager 6 доступна миграция всех IP-адресов БД IPmanager 5.

   1. Перейдите в → Миграция → Импортировать IP-адреса из IPmanager5.

   2. Введите данные для подключения.

       Пояснения

      • Адрес сервера с IPmanager — IP-адрес БД IPmanager 5;
      • Имя базы данных — имя БД IPmanager 5. Значение по умолчанию — ipmgr;
      • Логин пользователя для интеграции — имя пользователя БД IPmanager 5. Значение по умолчанию — root;
      • Пароль — пароль пользователя БД IPmanager 5.
   3. Нажмите Импортировать IP.

      

      Пример настроек импорта

      
      

      Для переноса отдельных блоков IP-адресов необходимо создать пользователя IPmanager 5 и с сервера VMmanager 6 выполнить команду.

       Пояснения

      1. Создайте на сервере с IPmanager 5 пользователя для интеграции. Пользователю должны быть доступны все типы адресов, которые нужно перенести. Подробнее о типах адресов см. в статье Управление группами IP-адресов.

      2. Подключитесь к серверу с VMmanager 6 по SSH и выполните команду:

         docker exec -it dci_ipmgr_1 /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. Значение по умолчанию — ipmgr.

         <db_user> — имя пользователя БД IPmanager 5. Значение по умолчанию — root.

         <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.

         

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

   
   

Чтобы VMmanager 5 мог работать с IPmanager 6, настройте подключение в панели управления:

1. Создайте в VMmanager 6 учётную запись администратора с именем ipmgr5@example.com.

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

   ipmgr5@example.com — не пример, а точное имя, которое нужно указать при создании учётной записи.

2. В VMmanager 5:
   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.
   3. Нажмите Ok.

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

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

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

Перенос виртуальных машин

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

Перенос ВМ из нескольких экземпляров VMmanager 5 в кластеры VMmanager 6

Если вы используете VMmanager 5 KVM, перенесите ВМ по инструкции из статьи Как импортировать ВМ в VMmanager?

Если вы используете VMmanager 5 OVZ, перенесите ВМ по инструкции из статьи Как перенести OVZ-контейнер в LXD-кластер?

Настройка биллинговой системы

Если вы используете BILLmanager в качестве биллинговой системы:

1. Измените настройки интеграции с IPmanager. Для этого:
   1. Перейдите в Интеграция → IPmanager → кнопка Изменить.
   2. Укажите настройки для интеграции:
      1. URL — IP-адрес сервера с VMmanager 6.
      2. Имя пользователя — учётная запись администратора VMmanager 6 — ipmgr5@example.com.
      3. Пароль — пароль к учётной записи администратора VMmanager 6.
         
   3. Нажмите ОК.
2. Заведите в VMmanager 6 пользователей, виртуальные машины которых нужно перенести. Email пользователей берётся из BILLmanager.
3. Подключите для тарифных планов VMmanager 5 обработчик услуг VMmanager 6. Для этого:
   1. Перейдите в Продукты → Тарифные планы → выберите тариф, с которого была продана услуга виртуального сервера для VMmanager 5 → кнопка Обработчики.
   2. Включите обработчик VMmanager 6.
4. Отключите виртуальные машины из BILLmanager:
   1. Перейдите в Товары/Услуги → Виртуальные серверы → выберите все услуги виртуальных серверов VMmanager 5 (зажмите CTRL) → кнопка Изменить.
   2. Нажмите кнопку Выкл.
   3. Подтвердите выключение при помощи кнопки Ok.
5. Перенесите услуги виртуальных серверов на тарифные планы с обработчиком VMmanager 6:
   1. Перейдите в Товары/Услуги → Виртуальные серверы → выберите все услуги виртуальных серверов VMmanager 5 (зажмите CTRL) → кнопка Изменить.
   2. Укажите в поле Модуль обработки обработчик услуг VMmanager 6. 
   3. Нажмите Ok.
6. Выполните перенос виртуальных машин по инструкциям из раздела выше Перенос виртуальных машин.
7. Укажите имя пользователя и ID услуги из VMmanager 6 для каждого виртуального сервера.
8. Включите услуги в BILLmanager.