Меню Рубрики

Установка billmanager на сервер

Установка и обновление BILLmanager

Содержание

Общая информация

Системные требования

Версии поддерживаемых операционных систем для BILLmanager:

Установку рекомендуется производить на «чистый сервер». Это значит, что должна быть выполнена только установка операционной системы без установки и настройки дополнительных сервисов.

Лицензирование

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

При наличии активной лицензии на программный продукт, она будет активирована автоматически, если сервер имеет внешний ip адрес, который совпадает с ip адресом лицензии. В противном случае (например на серверах с серым ip адресом), следует перед началом установки выполнить команду:

При наличии вечной лицензии на программный продукт, имеет значение срок получения обновлений для этой вечной лицензии. Если в момент установки панели управления для вечной лицензии истек срок получения обновлений, то установка последней актуальной версии приведет к тому, что не пройдет проверка лицензии. Запускать установку в этом случае необходимо с параметром —release 5.50. Где 5.50 — последняя доступная версия для вечной лицензии.

Установка

Установка и обновление BILLmanager производится с использованием репозитория операционной системы.

При установке отключается служба SELinux. Эта служба мешает корректной работе панели управления.

Чтобы начать установку выполните следующее:

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

2. Установите wget (если не установлена). Для Debian с помощью команды:

Для CentOS с помощью команды:

3. Загрузите скрипт установки:

Чтобы установить определенную версию панели управления, необходимо запустить install.sh с параметром —release, например:

Установщик предложит выбрать уровень стабильности: beta или stable и подключит соответствующий репозиторий ISPsystem. В дополнение подключит другие необходимые репозитории (EPEL для CentOS) и обновит кеш пакетов. Из списка предложенных вариантов выберите необходимую версию BILLmanager. Скрипт установит панель управления и необходимое программное обеспечение из репозитория системы. Установка на CentOS 7.1, выглядит примерно так

После окончания установки панель управления BILLmanager доступна по следующему адресу:

Внимание. Если на вашем сервере был занят 443 порт, то биллинг можно открыть по Url: https:// :1500/billmgr

Обновление

Автоматическое обновление можно активировать в настройках системы.

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

При обновлении в ручном режиме стоит учитывать, что каждая версия продукта имеет отдельный репозитарий, имя которого равно имени версии. Также есть репозитарии beta5 и stable5, которые содержат все версии продукта. От того, какой репозиторий подключен в системе, будет зависеть до какой версии будет обновлен программный продукт.

Первоначальная настройка

Первоначальная настройка описана в отдельной статье.

Переход между версиями

Для перехода на более расширенную версию продукта можно использовать скрипт /usr/local/mgr5/sbin/billmgr-upgrade.sh

Параметром ему передаётся имя версии на которую перейти:

источник

Процесс установки

Панель управления может быть установлена на виртуальный сервер (VPS), который соответствует системным требованиям. В статье описан процесс установки BILLmanager.

Мы не рекомендуем устанавливать BILLmanager на один сервер с ISPmanager. После установки ISPmanager Nginx занимает на сервере 443 порт для работы сайтов. BILLmanager также использует 443 порт для работы платёжных модулей. Также могут возникать проблемы с установкой APS-скриптов и работой встроенного shell-клиента в ISPmanager.

Активация лицензии

Описание существующих типов лицензий см. в статье Лицензирование.

Бесплатную лицензию необходимо активировать через личный кабинет ISPsystem после установки BILLmanager на сервер. Предварительный заказ не требуется.

Коммерческая лицензия должна быть приобретена до начала установки продукта. В процессе покупки указывается внешний IP-адрес сервера, на котором панель управления будет функционировать.

Если сервер не находится за NAT и IP-адрес лицензии есть на его сетевом интерфейсе, то при установке BILLmanager активация произойдет автоматически. Подробнее про IP-адрес, указанный в лицензии, см. в статье IP-адрес лицензии.

Если сервер находится за NAT или у лицензии не указан IP-адрес или IP-адреса лицензии нет на сетевом интерфейсе сервера, то выполните активацию по ключу. Подробнее см. в статье Активация лицензии по ключу.

Установка

Помимо BILLmanager, скрипт установит на сервер дополнительное программное обеспечение, необходимое для работы панели управления:

  • сервер баз данных — MariaDB;
  • веб-сервер — ihttpd;
  • платформа для JavaScript — Node.js.

При установке отключается служба SELinux. Эта служба мешает корректной работе панели управления.

Перед началом установки убедитесь, что на сервере установлена утилита загрузки wget.

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

Загрузите скрипт установки:

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

Для установки определённой версии панели управления запустите install.sh с параметром —release, например:

Для бессрочной лицензии важен срок получения обновлений. Если на момент установки панели управления для бессрочной лицензии истёк срок получения обновлений , то при установке актуальной версии проверка лицензии не пройдёт. Выполните установку с параметром —release 5.100, где 5.100 — последняя доступная версия для бессрочной лицензии.

Бессрочные лицензии больше не продаются.

Для дальнейшей настройки BILLmanager необходима авторизация в web-интерфейсе.

источник

Как установить Billmanager на виртуальный сервер

Для установки биллинга Billmanager мы рекомендуем использовать операционную систему CentOS 7.

Читайте также:  Установка lifecam hd 3000

1. Для начала нужно установить программу wget

2. Далее скачиваем файл установки с сервера производителя ПО

3. Запускаем скрипт установки. В ходе установки нужно будет выбрать между стабильной и бета-версией. И между Billmanager и Billmanager Corporate. Мы рекомендуем стабильную версию и простую версию Billmanager, так как с нее можно перейти на старшую версию, а со старшей на младшую уже нельзя.

Далее на экране будут параметры доступа к панели управления: по ip-адресу сервера и по техническому домену.

4. Заходите по одному из адресов и выбирайте регистрацию по ознакомительной лицензии. Указывайте свой адрес электронной почты, на которую будет зарегистрирована лицензия и куда придет код активации.

5. Подтверждайте адрес электронной почты в первом письме.

6. Далее вам придет уже письмо с номером лицензии.

7. Вводите этот код на странице регистрации и принимайте лицензионное соглашение.

8. Настраивайте часовой пояс и расположение.

9. После этого вы попадаете на начальный экран настройки. Вам необходимы “Первоначальные настройки”

10. Выбирайте статус лица, от которого будут оказываться услуги.

11. В зависимости от типа лица вводите необходимые данные.

Все! Установка и первоначальная настройка биллинга billmanager закончена.

источник

Установка BILLmanager

Материал из ISPWiki

Инструкция по установке программного продукта BILLmanager

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

Процедура установки стандартна и похожа на установку других продуктов ISPsystem.

Перед установкой необходимо получить активную лицензию на IP-адрес сервера с активным интернет-подключением.

Процедура установки включает в себя следующие действия:

Войдите в командную оболочку на вашем сервере как администратор системы root и запустите любую из команд:

То есть скачайте скрипт инсталляции, после чего запустите его командой:

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

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

Мастер установки сообщит о версии операционной системе и программном продукте. Подтвердите установку для продолжения:

На следующем шаге необходимо указать пароль администратора (логин: admin) для входа в BILLmanager:

Инсталлятор определит список пакетов для установки. Это может занять некоторое время, так как производится обновление кэша пакетного менеджера/скачивание-установка дерева портов (в зависимости от используемой операционной системы):

На следующем шаге мастер установки отобразит окно выбора типа установки. Мы рекомендуем выбрать установку по умолчанию — «Install most popular software»:

Инсталлятор также позволяет выбрать другие типы установки, например, версию Apache и MySQL (если репозиторий системы предоставляет такую возможность), однако установка по умолчанию, как правило, наиболее оптимальна. Также в случае установки на сервер, где уже установлен MySQL-сервер с паролем root, будет запрошен этот пароль для создания базы данных.

После выбора типа инсталляции начнется установка, которая будет сообщаться изменением информации об устанавливаемом пакете:

Установка займет некоторое время, и после ее успешного завершения Мастер установки BILLmanager сообщит вам об этом:

Доступ и дальнейшая настройка осуществляется по адресу https://ip-адрес_сервера/manager/billmgr

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

Теперь вы можете перейти к Первоначальной настройке биллинговой системы.

Технические подробности (ручная установка)

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

BILLmanager использует для своей работы веб-сервер Apache с поддержкой SSL (mod_ssl) для доступа через https-протокол и MySQL-сервер (версии 5.0 или выше) с включенной поддержкой формата InnoDB для хранения данных. Вопросы по их настройке в данном руководстве не рассматриваются.

  • Для работы Apache с BILLmanager необходимо добавить в конфигурационный файл Apache:

источник

Документация BILLmanager

Администратор панели управления BILLmanager — сотрудник провайдера услуг, который имеет доступ ко всем функциям биллинговой системы. Он выполняет установку BILLmanager на сервер и его дальнейшую настройку.

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

Структура документации состоит из нескольких разделов:

Описание BILLmanager — содержит общие сведения о программном продукте BILLmanager.

Установка и обновление — содержит всю информацию, необходимую для установки. Также, раздел описывает процесс выбора режима обновления продукта.

Первоначальная настройка — подробно описывает параметры BILLmanager, которые рекомендуется настроить в первую очередь.

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

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

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

Перепродажа — объясняет каким образом администратор биллинговой системы может наладить перепродажу услуг другого провайдера.

Читайте также:  Установка подземной дренажной емкости

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

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

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

Центр поддержки — поможет провайдеру настроить и запустить центр поддержки клиентов через систему письменных запросов.

Система уведомлений — содержит информацию о том, какие виды уведомлений существуют в биллинговой системе, а также описывает алгоритм их отправки.

BILLmanager 6. Описание интерфейсa — описывает личный кабинет клиента в BILLmanager 6.

Как настроить интерфейс — описывает процесс перехода на новый клиентский интерфейс и его настройку.

Полезные ссылки

FAQ — часто задаваемые вопросы по работе программных продуктов ISPsystem.

источник

Настройка адреса BILLmanager

По умолчанию BILLmanager работает через встроенный веб сервер ihttpd и доступен по адресу https://ip:1500/billmgr

В этой статье описано как настроить адрес BILLmanager, то есть сделать, чтобы панель управления открывалась по адресу my.domain.com

Существует два варианта настройки настройки адреса BILLmanager:

  • Настройка ihttpd
  • Настройка связки nginx + ihttpd

Настройка ihttpd

Если на сервере с BILLmanager не планируется запуск никаких веб приложения, то перевешиваем веб сервер ihttpd на 443 и 80 порт.

Файл конфигурации ihttpd настраивается следующим образом:

Данная настройка означает, что ihttpd будет принимать соединения на 80 и 443 порту. Причем при запросе на 80 порт будет выполнен редирект на 443 порт.

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

По умолчанию по адресу https://10.10.10.10 будет открываться COREmanager. Чтобы это изменить создается индексная страница. Создается файл /usr/local/mgr5/bin/index с содержимым — billmgr. После этого по адресу https://10.10.10.10 будет открываться BILLmanager.

На этом настройка завершена. Осталось направить A запись домена my.domain.com на адрес 10.10.10.10. После чего BILLmanager будет доступен по адресу https://my.domain.com

Настройка nginx + ihttpd

Если на сервере вместе с BILLmanager также установлен ISPmanager, то устанавливать Nginx нужно через ISPmanager. В ISPmanager Lite это можно сделать в разделе «Возможности». В ISPmanager Business Nginx установлен по-умолчанию.

Если на сервере не установлен ISPmanager, то устанавливать Nginx будем вручную.

Установка nginx на CentOS

Установка nginx на Debian

В файл конфигурации nginx (/etc/nginx/nginx.conf) добавляется:

Если вы используете BILLmanager 6, то следует добавить также ещё одну секцию:

ForwardedSecret — набор букв и цифр, которые представляют собой ключ, используемый при проверке аутентификации по ограниченному списку IP-адресов, в случае использования nginx. Требуется для защиты от несанкционированных попыток аутентификации.

Обратите внимание, секретная фраза, указанная в файле конфигурации nginx (директива proxy_set_header X-Forwarded-Secret) должна совпадать с фразой, указанной в файле конфигурации BILLmanager (директива ForwardedSecret).

После редактирвоания файла конфигурации BILLmanager необходимо перезапустить панель управления командой

Если необходимо сделать, чтобы по http://my.domain.com (не httpS) тоже открывался BILLmanager и производился редирект на https, то добавляется дополнительно в файл конфигурации nginx:

После редактирования конфигурации требуется перезапуск nginx

Чтобы не получилось циклической переадресации в файле конфигурации ihttpd (/usr/local/mgr5/etc/ihttpd.conf) убирается redirect. В итоге файл конфигурации ihttpd имеет вид:

Создаем индексный файл. Создаем файл /usr/local/mgr5/bin/index с содержимым — billmgr.

источник

Как работать с API BILLmanager

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

В нашей работе мы используем биллинг BILLmanager. У него есть свой API, с помощью которого можно масштабировать серверы на гибких тарифах, получать информацию о платежах, списаниях со счёта и т.д. На сайте разработчиков биллинга есть обширная документация по взаимодействию через API с описанием всех функций и параметров панели управления.

Документация по API BILLmanager достаточна сложна в освоении. Но есть простой инструмент, вывод которого отображает параметры для любой функции. Если вы хотите стать гуру в работе с API — изучите документацию. Если для вас главное выполнить задачу и получить результат в короткий срок — подойдёт наш инструмент.

Начало работы
Зарегистрируйтесь в BILLmanager или залогиньтесь в существующем аккаунте — для использования API необходима действующая учётная запись.

Инструкции по работе с инструментом API Billmanager:

Где взять список параметров API

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

При нажатии на иконку откроется форма, в которой можно указать, какое именно нужно действие.
Как видно на скриншоте ниже, мы получили всё необходимое для вызова списка VDS.

Если выделить нужный сервер и выбрать в форме Действие «Удалить», получим вызов для удаления именно выбранного сервера(-ов).

Чтобы получить список VDS, достаточно скопировать в браузер строчку:

authinfo=USER:PASS — логин (почта) и пароль для входа соответственно.
func=vds — вызов функции и ее аргументов.
out=json — формат вывода. Их несколько, но мы рекомендуем JSONdata , именно он отображает только запрашиваемые элементы:

Читайте также:  Установка почтового ящика в яндексе

Или человекоудобный out=print:

Меняем USER:PASS на свой логин и пароль, вставляем получившуюся ссылку в браузер или используем системную утилиту curl

В ответ получим большой JSON-документ, в котором отображается не только информация для отрисовки интерфейса самого биллинга — кнопки, фильтры, предупреждения, оповещения, но и все данные о серверах, расположенных под аккаунтом: IP-адрес, имя, ID VDS в биллинге. Так как нам нужен именно список VDS, обращаем внимание на блок elem:

Список получен. В будущем ID VDS понадобятся для взаимодействия с услугами посредством API.

Если пароль или логин(почта) введены неверно, то в выводе команды мы увидим текст ошибки в блоке param:

В форме можно посмотреть значения параметров VDS или внести и сохранить изменения. Для получения соответствующего вызова API есть переключатели:

  • Пункт Чтение покажет, как вывести текущие параметры сервера на экран — вернёт JSON-запрос с текущими параметрами VDS.
  • Пункт Запись покажет, список параметров, используемых функцией vds.edit. При этом все ручные изменения полей и «ползунков» отобразятся в ее выводе.

Рассмотрим изменение доменного имени VDS. Для этого в браузере перейдём во вкладку Товары → Виртуальные серверы , выберем нужный и кликнем по кнопке Изменить . Далее нажмём кнопку API и выберем пункт Запись .

В нашем примере за доменное имя отвечает параметр domain . Таким образом, в предложенном запросе, в пункте domain= меняем имя на нужное и выполняем запрос:

Если в результате выполнения скрипта последует ответ ОК, то доменное имя VDS будет изменено. В случае ошибки API вернёт её текст.

Работа с циклами
Удалить VDS, добавить памяти или ядер процессора можно и без использования API Billmanager. Но если возникла потребность заказать 10, 100 VDS или массово изменить параметры серверов — процесс может затянуться на несколько часов. В программировании для подобных случаев, где совершается множество однотипных действий, принято использовать циклы.

Например, нам требуется купить 32 сервера VDS-KVM-Старт. Переходим в Виртуальные серверы — Заказать , выбираем в следующей форме тариф. Кликаем по инструменту API , в поле Действие для объекта выбираем Запись :

В появившейся форме будет набор всех указанных параметров для заказа VDS через API Billmanager:

Чтобы сразу оплатить VDS с лицевого счета, минуя корзину, меняем skipbasket=off на skipbasket=on.

Чтобы не вводить эти URL каждый раз в браузере, мы можем использовать curl и цикл for :

В этом примере цикл будет выполнен 32 раза, и имя каждой VDS будет иметь порядковый номер от 1 до 32. Весь процесс займёт около минуты вместо пары часов.

Чтобы работать с API Billmanager было ещё удобнее, можно использовать готовые скрипты на различных языках программирования. Так процедура будет выглядеть на PHP:

Как масштабировать серверы на гибких тарифах

Для масштабируемых тарифов через API можно изменить количество ядер процессора и оперативной памяти:

Где перечисляются параметры сервера. Описание параметров находятся в выводе API:

В примере выше значение addon_41222 указано 4 — это значит, что количество оперативной памяти будет равным четырём гигабайтам. Если параметры процессоров, ОЗУ или количество IP-адресов будут изменены, то потребуется перезагрузка сервера. В качестве подтверждения установите галочку или выставите параметр reboot со значением on. Изменить размер диска с клиентской учетной записи невозможно, так как перед этим требуется изменить его размер в VMmanager. Такие права есть только у сотрудников технической поддержки.

Имея статус реселлера, вы можете удалить все VDS, к которым имеете доступ.

При удалении VDS вы будете работать со списками и массивами данных — для этого удобнее использовать терминал (консоль), в частности системную утилиту curl :

Потребуется указать лишь ID сервера, в выводе выше это 8037665.

Если все данные введены верно, то в результате out=json будет:

Или пробел при использовании out=JSONdata.

Если вместо ok вы видите error , значит возникла ошибка. Например, при неправильно указанном введенном пароле будет Invalid username or password , или пустые поля при отсутствии VDS в активных услугах и корзине.

Для удаления VDS без статуса реселлера понадобится позвонить в техническую поддержку с проверенного номера телефона или подтвердить свои права на аккаунт по смс. Ввели эти ограничения в целях безопасности: если пароль будет скомпрометирован и доступ к Личному кабинету получат посторонние лица, они не смогут удалить ваши VDS.

Как сменить сервера имён домена

Использовать API можно не только для работы с VDS, но и при работе с другими услугами в биллинге. Рассмотрим смену серверов имён домена.

Для этого используется функция domain.ns. Требуется указать ID домена (elid) и серверы имён, начиная с ns0.

Таким образом, всё, что можно сделать через браузер можно осуществить и через API Billmanager. Часто это будет быстрее, а благодаря возможностям инструмента API проще и нагляднее.

источник

Добавить комментарий

Adblock
detector