Это устаревшая инструкция. FreeBSD 11 не поддерживается с 30.09.2021.
Cписок поддерживаемых ОС и инструкций по установке смотрите по ссылке.
Для обеспечения функционирования АСР в штатном режиме (с использованием всех функций, предоставляемых ПО) необходима установка и настройка следующих программных компонентов:
Компоненты АСР:
Компоненты OC:
СУБД MySQL
Веб-сервер (apache) с поддержкой версии PHP в зависимости от номера сборки:
Python 3.Х.
OpenSSL
Библиотеки PHP:
Перед началом установки должны быть открыты следующие сетевые порты 80 (443), 1502 (1503), 3306, 34012, 34100 и порты, указанные в файлах конфигурации агентов АСР, а также в настройках агентов АСР в веб-интерфейсе.
Установку БД MySQL под FreeBSD 11 производится через pkg:
pkg install -y mysql56-server
Разрешаем запуск демона mysql:
echo 'mysql_enable="YES"' /etc/rc.conf
Настраиваем MySQL. Для этого создаем файл my.cnf в рабочей директории.
vim /var/db/mysql/my.cnf
В разделе клиента определяем следующие опции:
[client]
default-character-set = utf8
В разделе сервера добавляем следующие опции:
[mysqld]
character-set-server = utf8
character-sets-dir = /usr/share/mysql/charsets
skip-character-set-client-handshake
skip-name-resolve
innodb_file_per_table=ON
sql_mode = 'NO_AUTO_VALUE_ON_ZERO,ERROR_FOR_DIVISION_BY_ZERO,NO_ZERO_IN_DATE,NO_ENGINE_SUBSTITUTION,STRICT_ALL_TABLES'
innodb_stats_on_metadata = 0
group_concat_max_len = 1000000000
enforce-gtid-consistency = OFF
gtid-mode = OFF
log_bin_trust_function_creators = 1;
Для корректной работы c СУБД MySQL версии 5.7 в конфигурационном файле требуется добавить опции:
[mysqld]
sql_mode=STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION,NO_AUTO_CREATE_USER
validate_password = OFF
Запуск БД MySQL осуществляется следующим образом:
service mysql-server start
Если после установки БД и изменения конфигурационного файла my.cnf она не запускается, и в логе ошибок вы видите записи типа:
[ERROR] Plugin 'InnoDB' init function returned error.
[ERROR] Plugin 'InnoDB' registration as a STORAGE ENGINE failed.
[ERROR] Unknown/unsupported storage engine: InnoDB
[ERROR] Aborting
Это означает, что некоторые настройки innodb, могут быть произведены только до первоначального запуска системы. В этом случае вам необходимо удалить следующие файлы:
rm -rf /var/db/mysql/*-bin.*
rm -rf /var/db/mysql/ib_logfile*
rm -f /var/db/mysql/ibdata1
После этого запустить БД заново, воспользовавшись скриптом запуска, в результате чего структура БД будет вновь создана с новыми параметрами.
Для корректной работы веб-интерфейса системы необходимо установить и настроить пакеты:
Устанавливаем Apache:
pkg install -y apache24
Разрешаем запуск демона apache24:
echo 'apache24_enable="YES"' /etc/rc.conf
Устанавливаем интерпретатор PHP с необходимыми расширениями:
pkg install -y php72 mod_php72 php72-extensions php72-json php72-gd php72-iconv php72-mbstring php72-soap php72-sockets php72-bcmath mod_php72 php72-mysqli
Отредактируйте основной конфигурационный файл /usr/local/etc/apache24/httpd.conf в соответствии с нижеприведенной инструкцией:
Раскомментировать директиву ServerName
.
В блоке добавить директиву AddType application/x-httpd-php .php
:
<IfModule mime_module>
...
AddType application/x-httpd-php .php
...
</IfModule>
``
В блоке IfModule dir_module
добавить index.php.
<IfModule dir_module>
DirectoryIndex index.html index.php
</IfModule>
``
В блоке Directory "/usr/local/www/apache24/data"
необходимо изменить директиву:
AllowOverride None на AllowOverride All
``
Настройка HTTPS опциональна, шаг можно пропустить. Для повышения безопасности при работе с веб-интерфейсом LANBilling допускается вместо открытого протокола http использовать соединение по шифрованному каналу (SSL) посредством протокола https. Поддержка ssl в apache обеспечивается модулем mod_ssl.so, поставляемым вместе с основным пакетом.
В случае если веб-сервер некорректно обрабатывает php-файлы (при обращении к адресу происходит скачивание файла), тогда в файл конфигурации httpd.conf необходимо добавить запись
<FilesMatch "\.php$">
SetHandler application/x-httpd-php
</FilesMatch>
Для корректной работы веб-интерфейса рекомендуется установить следующие параметры в файле php.ini. Копируем файл с конфигурациями.
cp /usr/local/etc/php.ini-production /usr/local/etc/php.ini
Вносим изменения в /usr/local/etc/php.ini:
date.timezone = Europe/Moscow
Данный параметр задается в соответствии с локальным часовым поясом:
max_execution_time = 3600
default_socket_timeout = 3600
memory_limit = 1024M
session.gc_probability = 0
После всех изменений перезапустите apache2:
service apache24 restart
Для установки пакетов python-simplejson необходимо воспользоваться командой:
pkg install py37-simplejson-3.17
В процессе эксплуатации может возникнуть ситуация когда, например, модуль ядра АСР совершает попытку дважды подключиться к одному и тому же порту. В результате все процессы будут блокированы.
Во избежание данной проблемы рекомендуется ограничить диапазон выдаваемых портов.
Для того чтобы применить ограничение портов на исходящие соединения необходимо воспользоваться командами:
sysctl net.inet.ip.portrange.first=35000
sysctl net.inet.ip.portrange.last=60999
sysctl net.inet.ip.portrange.randomized=0
Дистрибутив LANBilling для ОС FreeBSD поставляется в виде бинарного FreeBSD 11 пакета txz.
Начиная со сборки 018 изменился порядок именования дистрибутивов LANBilling 2.0:
lbcore-2.0.18.1-1.freebsd11.amd64.txz - пример пакета ядра АСР (релиз), где:
lbcore-2.0.18.0-2.20160322gitd3a12a87.freebsd11.amd64.txz (hotfix), где:
Установка пакетов выполняется следующим образом:
pkg add lb*.txz
В результате установки данных пакетов все запускаемые и сопутствующие файлы будут находиться в:
/usr/local/billing/ /etc/billing.conf* /usr/local/etc/rc.d/
Каждый компонент LANBilling имеет свой конфигурационный файл. Для ядра системы это /etc/billing.conf, для всех сетевых клиентов это файлы /etc/billing.conf.Имя_Клиента, например для клиента RADIUS — /etc/billing.conf.LBarcd.
Для каждого агента есть базовый пример файла конфигурации sample.
Копируем конфигурационный файл:
cp /etc/billing.conf.sample /etc/billing.conf
cp /etc/billing.conf.LBucd.sample /etc/billing.conf.LBucd
cp /etc/billing.conf.LBarcd.sample /etc/billing.conf.LBarcd
После установки LBcore необходимо скопировать каталог веб-интерфейса в соответствии с конфигурацией apache:
cp -r /usr/local/billing/phpclient/admin /usr/local/www/apache24/data/
Для удобства можно просто создать символьную ссылку на директорию, в таком случае копировать интерфейс при установке или обновлениях не нужно:
ln -s /usr/local/billing/phpclient/admin /usr/local/www/apache24/data/admin
Административный интерфейс 3.0 может быть использован как отдельно, так и совместно с версией 2.0. .
Для функционирования интерфейса необходим пакет php56-curl.
pkg install -y php72-curl
Для использования административного интерфейса 3.0 необходимы две библиотеки : lbweb-common и lbweb-admin. Установка пакетов возможна при помощи команд:
pkg add lbweb-common_X.Y.Z-Z.txz
pkg add lbweb-admin_X.Y.Z-Z.txz
После установки необходимо произвести первичную сериализацию конфигурационного файла.
Выполнить сериализацию файла конфигурации
/usr/local/sbin/lbwebcfg -y admin /usr/local/etc/lanbilling/phpclient/admin/
Настройка веб-сервера Apache:
cp /usr/local/etc/lanbilling/phpclient/apache2/lbweb-admin.apache2.sample /usr/local/etc/apache24/Includes/lbweb-admin.conf
Для применения настроек перезапустить веб-сервер.
service apache24 restart
Интерфейс доступен по адресу: http://{URL}/lbweb-admin/.
Клиентский кабинет 3.0 может быть использован как отдельно, так и совместно с версией 2.0.
Для функционирования кабинета необходим пакет php56-curl.
pkg install -y php72-curl
Для использования клиентского кабинета необходим пакет lbweb-client. Установка возможна при помощи команды:
pkg add lbweb-client_X.Y.Z-Z.txz
После установки необходимо произвести первичную сериализацию конфигурационного файла:
/usr/local/sbin/lbwebcfg -y client /usr/local/etc/lanbilling/phpclient/client/
Настройка веб-сервера Apache:
cp /usr/local/etc/lanbilling/phpclient/apache2/lbweb-client.apache2.sample /usr/local/etc/apache24/Includes/lbweb-client.conf
Для применения настроек перезапустить веб-сервер:
service apache24 restart
Интерфейс доступен по адресу: http://{URL}/lbweb-client/.
Данный клиентский кабинет не является актуальным, рекомендуем импользовать личный кабинет пользователя 3.0
Для работы личного кабинета необходимо скопировать каталог client2 в соответствии с конфигурацией apache:
cp -r /usr/local/billing/phpclient/client2 /usr/local/www/apache24/data/
Или создать символьную ссылку на директорию, в таком случае копировать интерфейс при установке или обновлениях не нужно:
ln -s /usr/local/billing/phpclient/client2 /usr/local/www/apache24/data/client2
Необходимо дать права на запись для пользователя под которым запущен apache директориям:
client2/client/runtime
client2/client/public/assets
Далее, необходимо указать в файле /etc/httpd/conf/httpd.conf для подключения папки в defaultHost через алиас (для apache) следующее:
Apache 2.2
Alias /client/ /usr/local/www/apache22/data/client2/client/public/
<Directory /usr/local/www/apache22/data/client2/client/public/>
Options FollowSymLinks
AllowOverride All
Order allow,deny
allow from all
</Directory>
Apache 2.4
Alias /client/ /usr/local/www/apache24/data/client2/client/public/
<Directory /usr/local/www/apache24/data/client2/client/public/>
Options FollowSymLinks
AllowOverride All
Require all granted
</Directory>
После этого следует перезапустить httpd.
Личный кабинет будет доступен по ссылке http://SERVER_IP_ADDR/client.
Взаимодействие модулей LANBilling 2.0 происходит через базы данных. Всего существуют два режима работы:
Для настройки основной БД необходимо на сервере АСР.
Запусть MySQL с правами root-пользователя:
mysql -u root -p
``
Создать пустую базу данных billing (как пример) и пользователя с правами администратора:
CREATE DATABASE billing DEFAULT CHARSET utf8;
GRANT ALL ON billing.* TO 'billing'@'127.0.0.1' IDENTIFIED BY 'billing';
GRANT ALL ON billing.* TO 'billing'@'localhost' IDENTIFIED BY 'billing';
``
Применить скрипты для создания структуры БД billing:
mysql -u root -p -A billing < /usr/local/billing/mysql/create.sql
``
В конфигурационном файле /etc/billing.conf прописать доступ к созданной БД в формате mysql://db_login:db_pass@db_ip/db_name:
#Database address
database = mysql://billing:billing@127.0.0.1/billing
``
Расшифровка:
Для загрузки каталога телефонных кодов, если они необходимы, используется команда:
mysql -u root -p -A billing < /usr/local/billing/mysql/catalog.sql
Для того чтобы загрузить справочник КЛАДР необходимо воспользоваться командой:
mysql -u root -p -A billing < /usr/local/billing/mysql/claddr.sql
Кабельный агент может работать (хранить статистику) как в основной (main-режим) так и отдельной (safe-режим) базе данных.
При использовании отдельной БД необходимо:
Запусть MySQL с правами root-пользователя;
mysql -u root -p
``
Создать пустую базу данных billing_safe (как пример) и пользователя с правами администратора;
CREATE DATABASE billing_safe DEFAULT CHARSET utf8;
GRANT ALL ON billing_safe.* TO 'billing'@'127.0.0.1' IDENTIFIED BY 'billing';
GRANT ALL ON billing_safe.* TO 'billing'@'localhost' IDENTIFIED BY 'billing';
``
Применить скрипт для создания структуры БД billing_safe;
Для сборок 2.0.19 — 2.0.20
mysql -u root -p -A billing_safe < /usr/local/billing/mysql/lbucd_safe.sql
Для сборки 2.0.21
mysql -u root -p -A billing_safe < /usr/local/billing/mysql/lbucd/create.sql
В сборках LBucd 2.0.23 от 01.12.2017 и новее скрипты работы со структурой таблиц БД кабельного агента имеют префикс “ucd_”. Таким образом команда для формирования структуры БД будет иметь вид:
mysql -uroot -p billing_safe < /usr/local/billing/mysql/lbucd/ucd_create.sql
В конфигурационном файле /etc/billing.conf.LBucd прописать следующие параметры:
Доступ к созданной БД:
# Local DB access parameters
stat_database = mysql://billing:billing@127.0.0.1/stat_db
асшифровка:
billing и billing — реквизиты доступа созданного пользователя БД;
127.0.0.1 и stat_db — xoст сервера (например 127.0.0.1 или localhost), на котором создана БД, и название БД billing_safe.
Доступ к ядру АСР в формате login:pass@ip:port:
# Access to LBcore server
server = admin@127.0.0.1:1502
асшифровка:
login и pass — реквизиты доступа администратора АСР;
ip и port — IP-адрес и порт сервера, на котором установлена АСР.
Режим работы модуля LBucd;
# Agent mode
# main: detail statistics stored in main DB
# safe: detail statistics stored in local DB
type = safe
Идентификатор Netflow-агента из административного интерфейса.
# System id. (Must be unique)
sysid = 0
Пример настройки для работы в автономном (SAFE) режиме:
dbhost = 127.0.0.1
dbuser = billing
dbpass = billing
dbname = billing_safe
server = admin@10.140.10.250:1502
type = safe
sysid = 2
RADIUS-агент работает только с отдельной базой данных (safe-режим). Для настройки необходимо:
Запусть MySQL;
mysql -u root -p
``
Создать пустую базу данных radius (как пример) и пользователя с правами администратора;
CREATE DATABASE radius DEFAULT CHARSET utf8;
GRANT ALL ON radius.* TO 'billing'@'127.0.0.1' IDENTIFIED BY 'billing';
GRANT ALL ON radius.* TO 'billing'@'localhost' IDENTIFIED BY 'billing';
``
Применить скрипты для создания структуры БД radius;
mysql -u root -p radius < /usr/local/billing/mysql/lbarcd/create.sql
``
В сборках LBarcd 2.0.21.1-2.0.23 от 09.10.2017 скрипты работы со структурой таблиц БД RADIUS-агента имеют префикс “rad_”. Таким образом команда для формирования структуры БД будет иметь вид:
mysql -uroot -p radius < /usr/local/billing/mysql/lbarcd/rad_create.sql
``
В конфигурационном файле /etc/billing.conf.LBarcd прописать следующие параметры.
Доступ к созданной БД в формате mysql://db_login:db_pass@db_host/db_name:
#Database address
database = mysql://billing:billing@127.0.0.1/radius
асшифровка:
db_login и db_pass — реквизиты доступа созданного пользователя БД;
db_ip и db_name — хост сервера (например 127.0.0.1 или localhost), на котором создана БД, и название БД RADIUS.
Доступ к ядру АСР в формате login:pass@ip:port:
# Access to LBcore server
server = admin@10.140.10.250:1502
login и pass — реквизиты доступа администратора АСР;
ip и port — IP-адрес и порт сервера, на котором установлена АСР.
Идентификатор RADIUS-агента из административного интерфейса:
# Agent ID. (Must be unique)
sysid = 1
Пример настройки агента LBarcd для работы в автономном (SAFE) режиме.
database = mysql://billing:billing@127.0.0.1/radius
server = admin@10.140.10.250:1502
sysid = 1
RADIUS-агент может работать на том же сервере что и ядро АСР, либо отдельно — на другом сервере. После создания пустой БД для RADIUS-агента, при первом старте, происходит синхронизация структуры БД и необходимых данных из основной БД, с которой работает ядро АСР.
Версии СУБД (MySQL), на которых настраивются БД для АСР и RADIUS-агента, должны совпадать.
В зависимости от объема данных синхронизация может занимать продолжительное время (до 20 мин). Об успешности синхронизации можно судить по логам (файл /usr/local/billing/lbarcd.log) работы агента в режиме debug. Журналирование событий в режиме debug требует большого количества дискового пространства и рекомендуется только при возникновении ошибок.
Для настройки в конфигурационном файле /etc/billing.conf.LBarcd необходимо изменить параметр log_level:
# Log verbosity level: error, warning, info, verbose, debug
log_level = debug
При успешном завершении синхронизации в логах будут сообщения вида “Synchronize with LBserver complete”.
Разрешаем запуск демона LBcore и установленных агентов:
echo ' lbcore_enable="YES"' /etc/rc.conf
echo ' lbucd_enable="YES"' /etc/rc.conf
echo ' lbarcd_enable="YES"' /etc/rc.conf
На основе поставляемых в дистрибутивах примеров sample создаются файлы запуска:
/usr/local/etc/rc.d/lbcore
cp /usr/local/etc/rc.d/LBucd.init.sample /usr/local/etc/rc.d/LBucd.init
cp /usr/local/etc/rc.d/LBarcd.init.sample /usr/local/etc/rc.d/LBarcd.init
Запуск всех модулей осуществляется путем старта соответствующих скриптов запуска:
/usr/local/etc/rc.d/LBcore start
/usr/local/etc/rc.d/LBucd.init start
/usr/local/etc/rc.d/LBarcd.init start
После запуска этих компонентов, в списке процессов должны присутствовать все установленные модули. Проконтролировать это можно командой: ”ps ax | grep LB”. По каждому из агентов и серверу системы LANBilling ведутся логи, находящиеся по умолчанию в директории/usr/local/billing и имеющие одноименные названия с запускаемыми файлами.
На этом этапе установка серверной части системы завершена, и, если все сконфигурировано правильно, то, запустив браузер Internet Explorer или Firefox и набрав в адресной строке IP-адрес веб-сервера и затем через слеш admin (например, так: http://SERVER_IP_ADDR/admin, где SERVER_IP_ADDR— ip-адрес вашего сервера), в окне браузера отобразится окно авторизации к административному интерфейсу управления LANBilling. По умолчанию доступ осуществляется под логином: admin и не заданным паролем.
В случае успешной установки apache с SSL при наборе в браузере https://SERVER_IP_ADDR/admin появится окно с информацией о сертификате, после подтверждения, которого пользователем отобразится административный интерфейс.
Важным условием запуска системы является тот факт, что на момент создания сетевых агентов должна быть осуществлена физическая связь между сетевыми агентами и центральным хранилищем. А также между php-интерфейсом, сервером LBcore и центральной базы данных. Сервер LBcore и веб-интерфейс должны быть установлены на одной машине.
Также следует настроить скрипты блокировки услуги:
по умолчанию, в /etc/billing.conf отключен запуск всех внешних скриптов. Для настройки запуска скриптов по событиям установки/снятия блокировки и др. необходимо раскоментировать соответствующую скрипту запись в billing.conf и поместить скрипт с указанным именем в/usr/local/billing. Примеры скриптов находятся в /usr/local/billing/scripts. При этом, в случае обновления АСР, обновляются скипты только в папке scripts, остальные скрипты (скопированные в /usr/local/billing) остаются нетронутыми.
Мы преднамеренно не предоставляем программы, автоматизирующие процесс установки, в виду того, что в процессе установки пакетов, часто возникают различные ошибки, с которыми логика инсталлятора не в состоянии справиться, кроме того, большинство администраторов предпочитают контролировать все модификации системы, которые происходят в процессе установки нового ПО, такого как, например, LANBilling.
С версии LANBilling 2.0.33 путь к лог-файлам по-умолчанию находится в /var/log/billing/. Для версий 2.0.32 и младше: /usr/local/billing/.
Пример настройки ротации и архивирования логов для утилиты logrotate находится в файле /etc/lanbilling/lbrotate.conf.
Чтобы активировать функционал необходимо:
Убедится в наличии установленной утилиты logrotate в системе, в случае отсутствия, установить соответствующий пакет. По умолчанию logrotate прописывается в cron.daily и запускается, каждый день в 03:01;
Скопировать файл lbrotate.conf
cp /etc/lanbilling/lbrotate.conf /usr/local/etc/logrotate.d/
``
Описание структуры файла и параметров можно найти в мануалах:
Заказчик, после приобретения АСР, получает лицензионный ключ, который всегда доступен в Helpdesk. Доступ к системе Helpdesk осуществляется с адреса client.lanbilling.ru.
Для активации лицензии необходимо, чтобы на сервере ядра АСР был открыт доступ к серверу активации лицензии и по порту 34100.
После получения лицензионного ключа для запуска модулей АСР требуется провести активацию лицензии через сервер активации, расположенный в домене lanbilling.ru. Для этого необходимо: войти в административный интерфейс под атрибутами администратора и в разделе"Опции" выбрать пункт “Общие”, раздел “Активация”, “Получить лицензионный ключ”. Затем ввести ключ активации и название компании в соответствующие разделы формы активации лицензии и нажать кнопку “Активировать”.
Название компании, должно совпадать с названием компании определенным в разделе “Опции” пункт меню “Реквизиты оператора” поле “Имя компании с формой собственности:”.
При положительном ответе сервера активации продукт готов к эксплуатации.
Существующие клиенты, уже имеющие регистрацию в LANBilling HelpDesk, при обновлении АСР до версии 2.0 размещают запрос на получение лицензии с темой “Лицензионный ключ для версии 2.0”, после чего получают Лицензионный ключ указанный в системе HelpDesk.
Лицензия содержит информацию, по которой определяется ряд рабочих параметров АСР: агентская схема телефонии, интеграция с Fidelio, модуль Email Connector, модуль инвентаризации, время действия, максимальное количество пользователей АСР и пр. При изменении любых из указанных параметров, связанных с реконфигурацией АСР, требуется повторное проведение активации нового ключа, содержащего скорректированные параметры.
Механизм активации учитывает возможность назначения тех или иных параметров функционирования АСР в процессе активации. В том случае, если набор ключевых параметров изменяется после проведения активации АСР, модуль контроля лицензионности копии вернет эти параметры к первоначальному значению.
Есть вопросы по документации? Пожалуйста, напишите их