Установка BILLmanager
Материал из ISPWiki
Инструкция по установке программного продукта BILLmanager
Установку рекомендуется производить на чистый сервер (операционная система в минимальной конфигурации), инсталлятор программного продукта автоматически скачает и установит необходимое программное обеспечение из репозитория/портов дистрибутива операционной системы.
Процедура инсталляции стандартна и похожа на установку других продуктов ISPsystem.
Перед установкой необходимо иметь активную лицензию на IP-адрес сервера с активным интернет-подключением.
Данное руководство по установке подробно рассматривает процедуру инсталляции, которая состоит из следующих действий:
Войдите в командную оболочку на вашем сервере как администратор системы root и запустите любую из команд:
fetch "http://download.ispsystem.com/install.sh" wget "http://download.ispsystem.com/install.sh" curl -o install.sh "http://download.ispsystem.com/install.sh"
То есть скачайте скрипт инсталляции, после чего запустите его командой:
sh install.sh
Инсталляционный скрипт install.sh имеет следующие ключи, которые можно использовать в случае, если автоматически параметры не были распознаны корректно:
--os OS Принудительное указание операционной системы. --arch ARCH Принудительное указание архитектуры (i386, i686). --ip IP Принудительное указание IP-адреса лицензии.
Скрипт инсталляции выведет список лицензий для вашего IP-адреса, выберите программный продукт вводом соответствующей цифры, после чего установка продолжится:
Мастер инсталляции сообщит о версии операционной системе и программном продукте, подтвердите установку для продолжения:
На следующем шаге необходимо указать пароль администратора (логин: admin) для входа в BILLmanager:
Инсталлятор определит список пакетов для установки, это может занять некоторое время, так как производится обновление кэша пакетного менеджера/скачивание-установка дерева портов (в зависимости от используемой операционной системы):
На следующем шаге мастер инсталляции отобразит окно выбора типа инсталляции. Мы рекомендуем выбрать установку по умолчанию - "Install most popular software":
Инсталлятор также позволяет выбрать другие типы установки, например, версию Apache и MySQL (в случае, если репозиторий системы предоставляет такую возможность), однако установка по умолчанию, как правило, наиболее оптимальна. Также в случае установки на сервер, где уже установлен MySQL-сервер с паролем root, будет запрошен этот пароль для создания базы данных.
После выбора типа инсталляции начнется установка, которая будет сообщаться изменением информации об устанавливаемом пакете:
Установка займет некоторое время, и после успешного завершения установки мастер инсталляции BILLmanager сообщит вам об этом:
Дальнейший доступ и настройка осуществляется по адресу https://ip-адрес_сервера/manager/billmgr
Имя пользователя: admin
Пароль: заданный при инсталляции
Технические подробности (ручная установка)
В некоторых случаях опытные пользователи нашего программного продукта могут произвести инсталляцию вручную или дополнительную настройку, например, при установке на не поддерживаемую операционную систему.
BILLmanager использует для своей работы Web-сервер Apache с поддержкой SSL (mod_ssl) для доступа через https-протокол и MySQL-сервер (версии 5.0 или выше) с включенной поддержкой формата InnoDB для хранения данных. Вопросы по их настройке в данном руководстве не рассматриваются.
- Для работы apache с BILLmanager необходимо добавить в конфигурационный файл apache:
Include /usr/local/ispmgr/etc/ispmgr.inc
и сделать символическую ссылку mod_ispmgr.so в каталоге /usr/local/ispmgr/lib/apache на модуль соответствующий версии. Помимо этого, ваш apache сервер должен быть настроен для работы по протоколу https.
- Для работы MySQL, в файле конфигурации BillManager (/usr/local/ispmgr/etc/billmgr.conf) необходимо указать параметры для подключения к БД:
DBHost <hostname> // по умолчанию localhost DBName <name> // имя базы, по умолчанию billmgr. // База должна существовать или у пользователя должно быть достаточно прав для ее создания DBUser <user> // имя пользователя для подключения к БД, по умолчанию root DBPassword <pass> // пароль пользователя <user> DBSocket <socket> // путь до mysql UNIX socket, по умолчанию он пустой
- Адрес для исходящих сообщений (см. также Шаблоны сообщений)
FromEmail notify@example.com // адрес который используется в поле from: при отправке email-сообщений
- Для того, чтобы задать пользователю admin пароль, необходимо выполнить:
/usr/local/ispmgr/sbin/mgrctl -m billmgr usrparam passwd=<пароль> recordlimit=100 sok=ok
- Теперь вы можете продолжить настройку BILLmanager, используя web-интерфейс
https://<ip>/manager/billmgr User name: admin Password: <pass>
