Перепродажа ПО ISPsystem через BILLmanager

Материал из ISPWiki

Перейти к: навигация, поиск

В данной статье рассматривается процедура настройки биллинговой системы для перепродажи программного обеспечения компании ISPsystem. Для перепродажи ПО ISPsystem необходим BILLmanager версии 4.0.40 или выше.

Содержание

Перепродажа лицензий как самостоятельных услуг

Настройка тарифных планов

1. В модуле Возможности необходимо выбрать "Программное обеспечение ISPsystem" и активировать его, нажав кнопку "Вкл.".
2. В модуле Типы продуктов выберите тип "Software", нажмите кнопку "Изменить" и поставьте флаг "Требуется сервер".
3. В модуле Серверы создайте новый сервер. Нажмите кнопку "Создать" и укажите следующие параметры:

  • Панель управления - BILLmanager(cpbillmgr) или BILLmanager5 (cpbillmgr5)
  • Пользователь укажите имя пользователя, которому доступен заказ лицензий на my.ispsystem.com (пользователь должен иметь полный доступ ко всем функциям на my.ispsystem.com).
  • IP-адрес - api.ispsystem.com

4. После добавления сервера выберите его в списке, нажмите кнопку "Изменить" и во вкладке "Конфигурация" проверьте, есть ли там строки вида:

 Preset 5-ISPmanager Lite
 Preset 9-ISPmanager Pro

5.Перейдите в раздел "Продукты" -> Тарифы , нажмите кнопку "Создать" и добавьте новый тариф.

 Рассмотрим вариант для перепродажи ISPmanager Lite (С поддержкой)
 Тип продукта - Software
 Внутреннее имя - 5-ISPmanager Lite (берется из конфигурации сервера, для интеграции с BILLmanager5 указывается ID тарифного плана)
 Тип учета - По заказанному периоду
 Соглашение - Обязательно необходимо указать соглашение, иначе при заказе возникнет ошибка.

6. Выберите созданный тариф, нажмите кнопку Серверы и активируйте сервер обработки, созданный в пункте 3, нажав кнопку "Вкл".

7. Для созданного тарифа необходимо создать периоды. Для этого в модуле Тарифные планы нажмите кнопку "Периоды" и укажите необходимые данные.

Настройка периодов заказа

Обращаем ваше внимание, что периоды заказа должны строго соответствовать тем, которые есть в ISPsystem, либо некоторые могут быть пропущены. Но те, которых нет в ISPsystem, работать не будут.

 ISPmanager Lite и ISPmanager Pro:
   триал - 14 дней
   1 месяц
   3 месяца
   1 год
   вечная
 ISPmanager Lite (без поддержки) и ISPmanager Pro (без поддержки):
   триал - 14 дней
   1 месяц
   вечная

Дополнительная информация

  • После того, как все будет настроено, в cron необходимо добавить задание
 */5 * * * *	/usr/local/ispmgr/sbin/cpbillmgr checkevent
  • Начиная с версии 4.0.50 добавлена поддержка использования периодов без строгого соответствия. Например, чтобы при покупке в вашем биллинге лицензии на месяц, в биллинге ISPsystem покупалась вечная лицензия.

Для этого необходимо создать файл конфигурации [путь до папки с BILLmanager(по умолчанию /usr/local/ispmgr)]/etc/cpbillmgr.conf

Если интеграция настроена с BILLmanager 5, то файл конфигурации - /usr/local/ispmgr/etc/cpbillmgr5.conf

Формат файла:

 Period[Пробел][Код периода в вашем биллинге][Пробел][Код периода в биллинге ISPsystem][перевод строки]

Пример:

 Period 269 1
 Period 270 12
 Period 271 0


Коды периодов в биллинге ISPsystem можно посмотреть в статье Заказ лицензий ПО ISPsystem с использованием BILLmanager API

  • Начиная с версии 4.0.77.1 добавлена поддержка повторного использования лицензий. Т.е. при удалении лицензии в Вашем биллинге, она будет остановлена, а наименование изменено на free.lic. В последствии, если в вашем биллинге будет заказана лицензии подходящего тарифного плана, данная лицензия будет использована повторно.

Важно! Повторно используются только лицензий, у который в наименовании указано free.lic, а IP адрес равен 0.0.0.0. Это сделано во избежании использования лицензий, которые для этого не предназначены.

Для этого в файле конфигурации (cpbillmgr.conf) нужно приписать опцию:

Option ReUseLicense

А так же указать для каждого тарифного плана, для которого будет использоваться повторное использование лицензий строку:

ReusePrice код_тарифа

где код_тарифа - код тарифного плана или дополнения в вашем BILLmanager. Либо

ReusePrice ALL

для включения для всех тарифных планов

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

Option UseExistingOnUpgrade

Если же BILLmanager не нашел подходящей лицензии для использования будет заказана новая лицензия (в первом случае) или изменен тариф имеющийся (второй случай).

  • Внимание: лицензии со 100% скидкой не продлеваются автоматически.

Механизм с выделением из пула свободных лицензий не работает при продлении лицензии, только при заказе новой лицензии.

Перепродажа лицензий, в качестве дополнений к тарифным планам

Начиная с версии 4.0.74 (рекомендуется использование версии не ниже 4.0.74.6) добавлена возможность автоматической продажи лицензий ISPsystem в качестве дополнений к тарифным планам других услуг. Для настройки дополнения подходят все встроенные типы услуг для которых определен IP адрес

Общие настройки

В первую очередь необходимо выполнить шаги с 1 по 4 раздела "Настройка тарифных планов" первой части статьи. После этого, если это еще не сделано, необходимо настроить тарифные планы для основных услуг. После этого можно приступать к настройке дополнений к тарифным планам.

Настройка дополнений к тарифным планам

Автоматическая обработка заказа лицензий поддерживается для дополнений имеющих тип с внутренним именем 'panel', 'vdsmgr', 'ispmgr', 'dnsmgr', 'ipmgr', 'vmmgr', 'billmgr', 'ifxmgr'. В настройках такого дополнения нужно выбрать сервер, который будет производить автоматическую обработку заказа лицензий.

Дополнение к тарифному плану может иметь тип значения "Перечисление" или "Логический". В первом случае для определения необходимо для заказа программного продукта будет использовано внутреннее имя элемента перечисления, во втором, внутреннее имя типа, к которому относится дополнение.

После выполнения данной настройки автоматическое выделение лицензий будет происходить в двух случаях: дополнение определяется стандартным перечислением со с внутренними именами 'Lite' и 'Prof' либо же со внутренними имена содержащими код тарифа в стороннем биллинге, а так же периоды заказ услуги совпадают с периодами заказа лицензий ISPsystem.

В противном случае требуется дополнительная настройка через файл конфигурации cpbillmgr.conf (каталог /usr/local/ispmgr/etc/).

Внимание!

Если перепродажа производится через BILLmanager 5 (в качестве главного сервера выступает BILLmanager 5), то:

  • Внутреннее имя Lite будет означать заказ ISPmanager 5 Lite, в не ISPmanager 4 Lite.

Если перепродажа производится через BILLmanager 4 (в качестве главного сервера выступает BILLmanager 4), то:

  • Внутреннее имя Lite будет означать заказ ISPmanager 4 Lite
  • Внутреннее имя Lite5 будет означать заказ ISPmanager 5 Lite

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

Для продажи лицензий в качестве дополнений, если тип лицензии задан не перечислением, либо же если внутреннее имя элемента перечисления не содержит код тарифа в стороннем биллинге, требуется редактирование файла конфигурации модуля cpbillmgr - /usr/local/ispmgr/etc/cpbillmgr.conf

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

Соответствие тарифов задается в виде:

Price внутреннее_имя код_тарифа_в_стороннем_биллинге

Соответствие периодов задается как:

Period код_периода_в_локальном_биллинге код_периода_в_стороннем_биллинге код_тарифа_в_стороннем_биллинге

Начиная с версии 4.0.77.18 добавлена возможность указания периода тарифа с стороннем биллинге для любого периода в локальном:

Period ALL код_периода_в_стороннем_биллинге код_тарифа_в_стороннем_биллинге

Например рассмотрим следующую конфигурацию:

  1. Есть тариф виртуального сервера с периодами заказа 1, 3, 6 и 12 месяцев, с кодами 10, 11, 12 и 13 соответственно.
  2. Для тарифа в качестве дополнения настроено стандартное перечисление с панелью ISPmanager (настройки перечисления стандартны), а так же в качестве опции можно заказать IPmanager 5 (тип дополнения имеет внутреннее имя ipmgr, а тип значения логический).
  3. Требуется для периода заказа виртуального сервера в 1 месяц заказывать лицензию на 1 месяц, а для всех остальных вечную лицензию.

Тогда часть файла cpbillmgr.conf для этого тарифа будет выглядеть следующим образом:

Price ipmgr 2891 	# соответствие тарифа для IPmanager 5
Period 10 8 7 		# соответствие периода в 1 месяц для ISPmanager Lite
Period 10 16 11 	# соответствие периода в 1 месяц для ISPmanager Pro
Period 10 1815 2891 	# соответствие периода в 1 месяц для IPmanager 5
Period 11 9 7 		# соответствие периода в 3 месяца для ISPmanager Lite
Period 11 17 11 	# соответствие периода в 3 месяца для ISPmanager Pro
Period 11 1817 2891 	# соответствие периода в 3 месяца для IPmanager 5
Period 12 9 7 		# соответствие периода в 6 месяцев для ISPmanager Lite
Period 12 17 11 	# соответствие периода в 6 месяцев для ISPmanager Pro
Period 12 1817 2891 	# соответствие периода в 6 месяцев для IPmanager 5
Period 13 9 7 		# соответствие периода в 12 месяцев для ISPmanager Lite
Period 13 17 11 	# соответствие периода в 12 месяцев для ISPmanager Pro
Period 13 1817 2891 	# соответствие периода в 12 месяцев для IPmanager 5

задавать соответствие для тарифов ISPmanager нет необходимости, так как они заданы по умолчанию (при необходимости их можно переопределить).

Дополнительная информация

Привязка уже имеющихся лицензий к услугам

Для привязки лицензий, которые уже имеются на аккаунта, через который осуществляется интеграция с удаленным биллингом, к виртуальным или выделенным серверам можно выполнить следующую команду:

/usr/local/ispmgr/sbin/cpbillmgr fixchilds

Алгоритм выполнения этой команды следующий:

  1. Модуль получает с удаленного BILLmanager весь список заказанных лицензий
  2. Модуль строит список услуг виртуальных и выделенных серверов, для которых требуется, но еще не привязана лицензия
  3. Если в списке лицензий полученных на первом шаге уже присутствует лицензию нужного типа с IP аналогичным основному IP адресу услуги, то производит привязку данной лицензии к услуге
  4. В противном случае модуль производит заказ необходимой лицензии

Если вы не хотите, чтобы для остановленных услуг при выполнении фикса заказывались лицензии, предварительно добавьте в файл конфигурации модуля (cpbillmgr.log) строку

Option NoFixSuspended

Продление лицензий привязанных к услугам

Процесс продления лицензий производится независимо от процесса продления основных услуг по необходимости. Т.е. например имеется следующая настройка:

  1. Тарифный план виртуального сервера с оплатой по периодам.
  2. Настроено автоматическое выделение лицензий с периодом в 1 месяц.
  3. Клиент производит оплату виртуального сервера на 1 год (с оплатой за лицензию так же за 1 год), например 2013-01-01.
  4. Клиент получает виртуальный сервер активный до 2014-01-01 и лицензию активную до 2013-02-01.
  5. 2013-01-31, если услуга заказанная клиентом, все еще активна, лицензия продлевается на очередной месяц, если же до этой даты клиент отказался от сервера, проделния лицензии не происходит.

Операции производимые с лицензиями при изменении статуса услуги

Все операции с основной услугой, так же выполняются и с лицензией. Т.е. при остановке основной услуги, лицензия приостанавливается (если эта функция вам доступна), при включении основной услуги, лицензия так же активируется и т.д.

Процесс обработки лицензий при интеграции с VDSmanager

Заказ лицензии для ISPmanager установленного на VDS происходит после полного создания виртуального сервера.

Процесс обработки лицензий при интеграции с VMmanager

Заказ лицензии для ISPmanager, который будет установленного на VDS, происходит во время установки на сервер операционной системы. Это сделано для того, чтобы в ходе установки операционной системы, установка ISPmanager или нужной панели, так же прошла успешно.

Формирование имени лицензии

Лицензии будет иметь наименование следующего вида Item #КОД_ОСНОВНОЙ_УСЛУГИ addon НАИМЕНОВАНИЕ_ОСНОВНОЙ_УСЛУГИ

FAQ

Q: Пытаюсь заказать ISPmanager Lite лицензию. Возникает ошибка The license with this IP address already exists. Но на аккаунте имеется только ISPmanager Pro

A:

  • Если ISPmanager Pro лицензия не Вечная, то заказать ISPmanager Lite не получится
  • Если ISPmanager Pro лицензия вечная, то получится заказать ISPmanager Lite только спустя 3 месяца.
Была ли эта информация полезной? Да | Нет
Личные инструменты