Установка 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 использует для своей работы веб-сервер 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, используя веб-интерфейс

https://<ip>/manager/billmgr
User name: admin
Password: <pass>