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

Интеграция с WHMCS

WHMCS — биллинговая система для продажи услуг различных типов. С помощью WHMCS вы сможете продавать виртуальные серверы клиентам в автоматическом режиме. Основные возможности биллинговой системы:

  • регистрация клиентов и учёт их финансовых средств;
  • создание тарифов на услуги;
  • приём платежей от клиентов;
  • автоматическое управление услугами: открытие, остановка, продление.

Настройка интеграции происходит на стороне WHMCS. В статье подробно описан этот процесс.

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

Работа модуля интеграции не тестировалась с WHMCS версии 7.8.3 и выше.

Установка модуля


Для установки модуля интеграции с VMmanager перейдите в корневой каталог установки WHMCS. Скачайте и распакуйте файлы модуля интеграции:

cd /var/www/html/whmcs/
curl -O http://download.ispsystem.com/extras/whmcs/7/vmmanager6.tar.gz
tar -xzvf vmmanager6.tar.gz

После распаковки файлов перейдите в интерфейс WHMCS и активируйте загруженный модуль: SetupAddon Modules → модуль ISPsystem global module → Activate.

Настройка интеграции


Для подключения к VMmanager нажмите SetupProducts/ServicesServers → Add New Server.

Блок Servers

Укажите следующие параметры:

  • Name — имя подключения к VMmanager;
  • Hostname — доменное имя сервера с VMmanager;
  • IP address — адрес для подключения к серверу. 

Вы можете не указывать Hostname или IP address. Чтобы настроить интеграцию, нужен только один из этих параметров. 

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

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

Блок Server Details

Укажите следующие параметры:

  • Type — тип сервера. Укажите "VMmanager 6";
  • Username — email пользователя в подключаемом VMmanager. Используйте учётную запись первого пользователя, созданного после установки VMmanager. От имени указанной учётной записи WHMCS будет управлять серверами в VMmanager;
  • Password — пароль учётной записи.

Настройка тарифного плана


Для настройки тарифа нажмите SetupProduct/ServicesProduct/ServicesCreate a New Product.

Основные настройки

Укажите следующие параметры:

  • Product type — выберите Server/VPS;
  • Product Name — произвольное название тарифа;
  • Module — выберите "VMmanager 6".

Нажмите Continue, чтобы создать тариф и перейти к его расширенной настройке. 

Вкладка Module Settings


Укажите следующие параметры:

  • Module Name — используемый модуль интеграции. Выберите VMmanager 6;
  • Server Group — группа серверов услуг;
  • Cluster ID — ID кластера. Отображается на вкладке Кластеры в VMmanager;
  • Source type — тип источника в VMmanager: шаблон операционной системы (ОС) или подготовленный образ диска виртуальной машины (ВМ);
  • Source ID — ID источника. Отображается в VMmanager: 
    • для ОС на вкладке Шаблоны → Операционные системы
    • для образов на вкладке Шаблоны → Пользовательские образы;
  • vCPU count — количество процессоров для ВМ;
  • RAM — количество оперативной памяти для ВМ в МиБ;
  • Disk size — размер жёсткого диска в МиБ;
  • Network bandwith — ограничение пропускной способности сетевого интерфейса ВМ в Мбит/с;
  • IP pool ID — ID пула IP-адресов, из которого будет выделен адрес для ВМ. Отображается в VMmanager на вкладке Сети → Пулы IP-адресов;
  • Recipe ID — ID рецепта или скрипта, который будет запущен после установки ОС. Отображается в VMmanager на вкладке Скрипты;
  • Dont wait the OS install — опция отключения ожидания установки ОС для активации заказа;
  • Add IPv6 Subnet — опция выделения IPv6-подсети для виртуального сервера.

Настраиваемые опции

Опции тарифного плана в WHMCS — дополнительные ресурсы, которые клиент может заказать за отдельную плату. Биллинг этих ресурсов выполняется отдельно от основной услуги. Количество дополнительных ресурсов клиент определяет самостоятельно на форме заказа услуги.

Настраиваемые опции тарифа объединяются в группы. Каждая группа опций может быть подключена к нескольким продуктам. Рекомендуем для каждого подключения к платформе VMmanager использовать отдельную группу опций.

Для управления группами опций перейдите в раздел SetupProducts/ServicesConfigurable Options. Вы можете добавить в тарифный план на виртуальные серверы следующие опции:

  • os — cписок шаблонов ОС, доступных для установки. Должен иметь вид: id_шаблона|Название_шаблона_отображаемое_пользователю. Например, 1|CentOS 7. id шаблонов отображаются в VMmanager на вкладке Шаблоны → Операционные системы. Тип опции: Dropdown;
  • cpu_number — минимальное и максимальное количество процессоров для ВМ. Тип опции: Quantily;
  • ram_mib — минимальное и максимальное количество оперативной памяти для ВМ в МиБ. Тип опции: Quantily;
  • ipv4_number — минимальное и максимальное количество IP-адресов для ВМ. Тип опции: Quantily;
  • hdd_mib — минимальное и максимальное количество дискового пространства в МиБ. Тип опции: Quantily;
  • network_bandwidth_mbitps — минимальное и максимальное значение пропускной способности сетевого интерфейса ВМ в Мбит/с. Тип опции: Quantily.

Подробнее о создании опций см. в официальной документации WHMCS.

Настройка опций тарифного плана