Документация VMmanager 6 (администратор)

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

ISPSystem

В статье рассматривается перенос виртуальных машин из 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, настройте подключение в панели управления:

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

Чтобы VMmanager 5 имел доступ только к определённому пулу IP-адресов, создайте в VMmanager 6 пул с суффиксом public. Например, VM5_public.

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

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

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

  2. В VMmanager 5:
    1. Перейдите в ИнтеграцияIPmanager.
    2. Укажите настройки для интеграции:
      1. URLhttps://${domain.com}/api/ipmgr5/v3/ipmgr

        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.

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


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

Если вы используете для продажи виртуальных машин BILLmanager, то перед переносом необходимо выполнить настройку биллинговой системы: отключить соответствующие услуги, переключить для них обработчик услуг и после переноса вновь включить услуги в BILLmanager. Подробнее см. раздел ниже Настройка биллинговой системы.

Вы можете перенести виртуальные машины из нескольких экземпляров 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.
Спасибо за ваш отзыв!
Была ли полезна статья?
Уточните, почему:

статья не соответствует названию

статью сложно понять

в статье нет ответа на мой вопрос

рекомендации из статьи не помогли

другая причина

Расскажите, что вам не понравилось в статье: