Установить LANBilling на Debian 8

Это устаревшая инструкция. Debian 8 не поддерживается с 01.07.2020.

Cписок поддерживаемых ОС и инструкций по установке смотрите по ссылке.


1. Системные требования к аппаратно-программной части

Для обеспечения функционирования АСР в штатном режиме (с использованием всех функций, предоставляемых ПО) необходима установка и настройка следующих программных компонентов:

Компоненты АСР:

  • пакет LBcore;
  • набор необходимых сетевых агентов.

Компоненты OC:

  • СУБД MySQL

    • 5.1.x — для релизов LANBilling 2.0.001 — 2.0.014. Начиная с релиза 2.0.015, поддержка версии прекращается.
    • 5.5.x — поддерживается релизами LANBilling 2.0.014 и новее.
    • 5.6.x — поддерживается релизами LANBilling 2.0.18 и новее.
    • 5.7.x — поддерживается с релиза 2.0.27 от 24.10.2018.
  • веб сервер (apache) с поддержкой версии PHP в зависимости от номера сборки:

    • 5.3.x — для релизов LANBilling 2.0.001 — 2.0.19.*. Начиная с релиза 2.0.20, поддержка версии прекращается.
    • 5.4.x — поддерживается с релиза LANBilling 2.0.014 и новее.
    • 5.5.x — поддерживается с релиза LANBilling 2.0.18 и новее.
    • 5.6.x — поддерживается с релиза LANBilling 2.0.20 и новее.
    • 7.x — поддерживается с релиза LANBilling 2.0.29 и новее.
  • Python 2.6.x или 2.7.x.

Библиотеки PHP:

  • mysql;
  • libjpeg;
  • libpng;
  • gd;
  • iconv;
  • soap;
  • multibyte strings;
  • sockets;
  • ghostscript (требуется для генерации шаблонов в pdf формате);
  • pdftk (библиотека для “склейки” pdf документов в один файл).

Перед началом установки должны быть открыты следующие сетевые порты 80 (443), 1502 (1503), 3306, 34012, 34100 и порты, указанные в файлах конфигурации агентов АСР, а также в настройках агентов АСР в веб-интерфейсе.

2. Установка необходимых для работы LANBilling сервисов

Установка MySQL-сервера

apt-get install mysql-server

В debian при установке сервера mysql выполняется post script который запрашивает новый пароль для пользователя root сервера mysql.

Конфигурация MySQL-сервера

Конфигурационный файл расположен в директории /etc/mysql/my.cnf.

В разделе клиента необходимо определить следующие опции:

[client]
default-character-set = utf8
character-sets-dir = /usr/share/mysql/charsets

В разделе сервера добавляем следующие опции:

[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

Параметр innodb_file_per_table обязательно должен присутствовать в конфигурационном файле и иметь значение ON.

Для корректной работы 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-серверу к соответствующим библиотекам.

chown -R mysql:mysql /var/lib/mysql/

Запуск БД MySQL осуществляется командой:

systemctl start mysql

Если после установки БД и изменения конфигурационного файла 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/lib/mysql/*-bin.*
rm -rf /var/lib/mysql/ib_logfile*
rm -f /var/lib/mysql/ibdata1

После этого запустить БД заново, воспользовавшись init-скриптом для запуска. В результате чего структура БД будет вновь создана с новыми параметрами. Mysql для Debian при установке пакета автоматически включается в загрузку.

Следует обратить внимание на то, что местонахождение сокета mysql.sock различное при различных вариантах установки БД. При установке БД из «исходников» — это /tmp, а при установке из DEB пакета — это /var/lib/mysql. В связи с тем, что различные библиотеки компилируются статически с сетевым агентом, а не привязываются динамически, то местонахождение сокета задается собранной статически библиотекой, использующей его в директории /tmp. Соответственно, если после установки БД из пакета сокет находится в директории /var/lib/mysql, то в ряде случаев необходимо сделать «мягкую» ссылку в директории /tmp на /var/lib/mysql/mysql.sock:

ln –s /var/lib/mysql/mysql.sock /tmp/mysql.sock

Установка веб-сервера

Для корректной работы веб-интерфейса системы необходимо установить и настроить пакеты:

  • apache;
  • php;
  • php-gd;
  • php-mysql;
  • php-gmp;
  • php-curl;
  • php-mcrypt.

Устанавливаем следующие пакеты:

apt-get install apache2-mpm-prefork php5 php-soap php5-gd libtiff5 libpng3 php5-mysql php5-common php5-gmp php5-curl php5-mcrypt

Эти пакеты необходимо установить, если планируется работа с административным или клиентским интерфейсами 3.0.

  • php5-gmp;
  • php5-curl;
  • php5-mcrypt.

Конфигурация apache2

Отредактируйте основной конфигурационный файл apache2 (/etc/apache2/apache2.conf).

По умолчанию путь к DocumentRoot определён в /var/www/html/. Если требуется изменить данный путь или другие параметры редактируем VirtualHost default:

vi /etc/apache2/sites-available/default

Настройка HTTPS опциональна, шаг можно пропустить. Для повышения безопасности при работе с веб-интерфейсом LANBilling допускается вместо открытого протокола http использовать соединение по шифрованному каналу (SSL) посредством протокола https. Поддержка ssl в apache обеспечивается модулем mod_ssl.so, поставляемым вместе с основным пакетом. В Debian включить данный модуль можно командой a2enmod ssl. После подключения модуля потребуется перезагрузка apache. Для манипуляции с сертификатами необходимо установить пакет openssl.

apt-get install openssl

Для конфигурации apache по протоколу https в Debian необходимо в файле конфигурации /etc/apache2/conf.d/ssl.conf в разделе  раскомментировать директиву mDocumentRootи ServerName.

Завершить настройку и перезапустить веб-сервер необходимо с помощью команд:

a2enmod ssl
a2ensite default-ssl
service apache2 restart

Конфигурация PHP

Для корректной работы веб-интерфейса рекомендуется установить следующие параметры в файле /etc/php5/apache2/php.ini.

date.timezone = Europe/Moscow

Данный параметр задается в соответствии с локальным часовым поясом (для Москвы).

max_execution_time = 3600
default_socket_timeout = 3600
memory_limit = 1024M
session.gc_probability = 0
max_input_vars = 2500

После всех изменений перезапустите apache2:

systemctl restart apache2

Устанока python-simplejson

Для установки пакетов python-simplejson необходимо воспользоваться командой:

apt-get install python-simplejson

Настройка портов для исходящих соединений

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

Во избежание данной проблемы рекомендуется ограничить диапазон выдаваемых портов. Для этого необходимо добавить в конфигурационный файл /etc/sysctl.conf строку:

net.ipv4.ip_local_port_range = 35000 60999

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

sysctl net.ipv4.ip_local_port_range='35000 60999'

3. Установка LANBilling

Установка модулей АСР

Дистрибутив LANBilling для операционной системы Debian распространяется в виде готовых пакетов для пакетных менеджеров.

Все пакеты LANBilling определены по одному и тому же правилу, разберем на примере пакета ядра для CentOS:

LBcore-2.0base-006-CentOS6_x86_64-20130521.rpm, где:

  • LBcore — обозначение ядра или клиентов LBarcd, LBucd, LBusbox, LBhotel, LBinet, LBircd, LBtv, LBphone;
  • 0base-006 — версия системы LANBilling;
  • CentOS6_x86_64 — версия и её битность;
  • 20130521 — дата данной сборки.

Начиная со сборки 018 изменился порядок именования дистрибутивов LANBilling 2.0:

lbcore-2.0.18.0-1.el5.x86_64.rpm - пример пакета ядра АСР (релиз), где:

  • lbcore — наименование модуля;
  • 2.0 — версия релиза;
  • 18 — номер релиза;
  • 0 — порядковый номер прохождения полного тестирования (начиная с 0);
  • -1 — версия пакета (означает, что пакет с этой версией модуля собран первый раз)
  • el5.x86_64 — платформа, на которой собран пакет (в данном случае CentOS 5 x64).

lbcore-2.0.18.0-2.20150903git2c17585e.el6.x86_64.rpm - пример пакета ядра АСР (hotfix), где:

  • lbcore — наименование модуля;
  • 2.0 — версия релиза;
  • 18 — номер релиза;
  • 0 — порядковый номер прохождения полного тестирования (начиная с 0);
  • -2 — версия пакета (означает, что пакет с этой версией модуля собран повторно);
  • 20150903 — дата сборки пакета;
  • git2c17585e — номер ревизии модуля;
  • el6.x86_64 — платформа, на которой собран пакет (в данном случае CentOS 6 x64).

Установка пакетов выполняется следующим образом:

dpkg -i LB*.deb или dpkg -i lb*.deb

В результате установки данных пакетов все запускаемые и сопутствующие файлы будут находиться в:

/usr/local/billing/
/etc/billing.conf*
/etc/init.d/

Установка административного интерфейса {3.2}

После установки LBcore необходимо скопировать каталог веб-интерфейса в соответствии с конфигурацией apache:

cp -rp /usr/local/billing/phpclient/admin  /var/www/html/

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

ln -s /usr/local/billing/phpclient/admin /var/www/html/admin

Установка административного интерфейса 3.0

Административный интерфейс 3.0 может быть использован как отдельно, так и совместно с прошлой версией.

Для работы интерфейса необходимо установить пакет php-gmp:

apt-get install php5-gmp

Для административного интерфейса 3.1 версия PHP должна быть не ниже 5.6

В релизе 3.0.9 были добавлены новые зависимости системного окружения. Поэтому дополнительно необходимо установить пакеты php5-curl и php5-mcrypt:

apt-get install php5-curl php5-mcrypt

Для использования интерфейса необходимы две библиотеки: lbweb-common и lbweb-admin. Установка пакетов возможна при помощи команд:

dpkg -i lbweb-common_X.Y.Z-Z_all.deb
dpkg -i lbweb-admin_X.Y.Z-Z_all.deb

Если IP-адрес и порт сервера, на котором установлена LANBilling, отличны от 127.0.0.1:1502, тогда необходимо выполнить следующие действия.

  1. В директории etc/lanbilling/phpclient/admin необходимо переименовать admin.ini.sample в admin.ini и отредактировать этот файл в соответствии с настройками АСР. Параметры “host” и “port” — IP-адрес и порт сервера АСР.

    cp /etc/lanbilling/phpclient/admin/admin.ini.sample /etc/lanbilling/phpclient/admin/admin.ini
    

    ``

  2. Применить настройки конфигурационного файла командой:

    /usr/local/sbin/lbwebcfg -y admin /etc/lanbilling/phpclient/admin
    

    ``

Настройка веб-сервера Apache:

cp /etc/lanbilling/phpclient/apache2/lbweb-admin.apache2.sample /etc/apache2/sites-available/lbweb-admin.conf
a2ensite lbweb-admin.conf

Для применения настроек перезапустить веб-сервер:

systemctl restart apache2

Интерфейс доступен по адресу: http://{URL}/lbweb-admin/.

Установка личного кабинета пользователя 3.0

Клиентский кабинет 3.0 может быть использован как отдельно, так и совместно с версией 2.0.

Для работы клиентского кабинета 3.0 необходимы дополнительные пакеты.

apt-get install php5-curl php5-mcrypt

Для работы клиентского кабинета 3.1 версия PHP должна быть не ниже 5.6.

Для использования клиентского кабинете необходимы две библиотеки: lbweb-common и lbweb-client. Установка пакетов возможна при помощи команд:

dpkg -i lbweb-common_X.Y.Z-Z_all.deb
dpkg -i lbweb-client_X.Y.Z-Z_all.deb

Настройка веб-сервера Apache:

cp /etc/lanbilling/phpclient/apache2/lbweb-client.apache2.sample /etc/apache2/sites-available/lbweb-client.conf
a2ensite lbweb-client.conf
a2enmod rewrite

Для применения настроек перезапустить веб-сервер.

systemctl restart apache2

Интерфейс доступен по адресу: http://{URL}/lbweb-client/.

Установка личного кабинета пользователя

Этот клиентский кабинет не является актуальным, рекомендуем импользовать личный кабинет пользователя 3.0

Для работы личного кабинета необходимо скопировать каталог client2 в соответствии с конфигурацией apache:

cp -r /usr/local/billing/phpclient/client2  /var/www/html/

Или создать символьную ссылку на директорию, в таком случае копировать интерфейс при установке или обновлениях не нужно:

ln -s /usr/local/billing/phpclient/client2 /var/www/html/client

Необходимо дать права на запись для пользователя под которым запущен apache директориям:

client2/client/runtime
client2/client/public/assets

Далее, необходимо указать в файле /etc/httpd/conf/httpd.conf для подключения папки в defaultHost через алиас (для apache) следующее:

  • Apache 2.2:

    Alias /client/ /var/www/html/client/client/public/
    <Directory /var/www/html/client/client/public/>
    	Options FollowSymLinks
    	AllowOverride All
    	Order allow,deny
    	allow from all
    </Directory>
    
    
    
  • Apache 2.4:

    Alias /client/ /usr/local/billing/phpclient/client2/client/public/
    <Directory /usr/local/billing/phpclient/client2/client/public/>
    	Options FollowSymLinks
    	AllowOverride All
    	Require all granted
    </Directory>
    
    
    

После этого следует перезапустить httpd.

Личный кабинет будет доступен по ссылке http://SERVER_IP_ADDR/client.

Каждый компонент LANBilling имеет свой конфигурационный файл. Для ядра системы это /etc/billing.conf, для всех сетевых клиентов это файлы /etc/billing.conf.Имя_Клиента, например для клиента RADIUS — /etc/billing.conf.LBarcd.

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

4. Создание структуры БД LANBilling

Взаимодействие модулей LANBilling 2.0 происходит через базы данных. Всего существуют два режима работы:

  • main-режим — используя основную базу данных;
  • автономный safe-режим — используя отдельную (чаще всего локальную) базу данных.

Для настройки основной БД необходимо на сервере АСР:

  1. Запусть MySQL с правами root-пользователя;

    mysql -u root -p
    

    ``

  2. Создать пустую базу данных 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';
    

    ``

  3. Применить скрипты для создания структуры БД billing;

    mysql -u root -p -A billing < /usr/local/billing/mysql/create.sql
    

    ``

  4. В конфигурационном файле /etc/billing.conf прописать доступ к созданной БД в формате mysql://db_login:db_pass@db_ip/db_name;

    #Database address
    database = mysql://billing:billing@127.0.0.1/billing
    

    ``

    Расшифровка:

    • db_login и db_pass — реквизиты доступа созданного пользователя БД;
    • db_ip и db_name — хост сервера (например 127.0.0.1 или localhost), на котором создана БД, и название БД.

Для загрузки каталога телефонных кодов, если они необходимы, используется команда:

mysql -u root -p -A billing < /usr/local/billing/mysql/catalog.sql

Для того чтобы загрузить справочник КЛАДР, необходимо воспользоваться командой:

mysql -u root -p -A billing < /usr/local/billing/mysql/claddr.sql

5. Первоначальная настройка модуля LBucd (Netflow)

Кабельный агент может работать (хранить статистику) как в основной (main-режим) так и отдельной (safe-режим) базе данных.

При использовании отдельной БД необходимо:

  1. Запусть MySQL с правами root-пользователя;

    mysql -u root -p
    

    ``

  2. Создать пустую базу данных 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';
    

    ``

  3. Применить скрипт для создания структуры БД 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
      
      
      
  4. В конфигурационном файле /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
      
      
      

image

Пример настройки для работы в автономном (SAFE) режиме:

dbhost = 127.0.0.1
dbuser = billing
dbpass = billing
dbname = billing_safe
server = admin@10.140.10.250:1502
type = safe
sysid = 2

6. Первоначальная настройка агента RADIUS

RADIUS-агент работает только с отдельной базой данных (safe-режим). Для настройки необходимо:

  1. Запусть MySQL;

    mysql -u root -p
    

    ``

  2. Создать пустую базу данных 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';
    

    ``

  3. Применить скрипты для создания структуры БД 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
    

    ``

  4. В конфигурационном файле /etc/billing.conf.LBarcd прописать следующие параметры:

    • Доступ к созданной БД в формате mysql://db_login:db_pass@db_ip/db_name;

      #Database address
      database = mysql://billing:billing@127.0.0.1/radius
      
      
      асшифровка:
      db_login и db_pass — реквизиты доступа созданного пользователя БД;
      db_ip и db_name — IP-адрес сервера (например 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
      
      
      

image

Пример настройки агента 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”.

7. Запуск системы

Запуск всех модулей осуществляется следующими командами:

systemctl restart mysql
systemctl restart apache2
systemctl enable lbcore.service
systemctl start lbcore
systemctl enable lbarcd.service
systemctl start lbarcd

Посмотреть статус работы ядра теперь можно выполнив команду:

  • Первый вариант:

    ps ax | grep LBcore
    
    
    
  • Второй вариант:

    systemctl status lbcore
    
    
     случае запуска через механизм systemd, ядро системы при сбоях будет перезапущено автоматически.
    
    

После запуска этих компонентов, в списке процессов должны присутствовать все запущенные модули. Проконтролировать это можно командой:

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.

8. Настройка ротации лог-файлов

С версии LANBilling 2.0.33 путь к лог-файлам по-умолчанию находится в /var/log/billing/. Для версий 2.0.32 и младше: /usr/local/billing/.

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

/etc/lanbilling/lbrotate.conf

Чтобы активировать функционал необходимо:

  1. Убедится в наличии установленной утилиты logrotate в системе, в случае отсутствия, установить соответствующий пакет. По умолчанию logrotate прописывается в cron.daily и запускается, каждый день в 03:01;

  2. Скопировать файл lbrotate.conf.

    cp /etc/lanbilling/lbrotate.conf /etc/logrotate.d/
    

    ``

Описание структуры файла и параметров можно найти в мануалах:

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

Заказчик, после приобретения АСР, получает лицензионный ключ, который всегда доступен в системе Helpdesk. Доступ к системе Helpdesk осуществляется с адреса https://client.lanbilling.ru.

Для активации лицензии необходимо, чтобы на сервере ядра АСР был открыт доступ к серверу активации лицензии и по порту 34100.

  • Сервер: lic.lanbilling.ru
  • Порт: 34100

После получения Лицензионного ключа для запуска модулей АСР требуется провести активацию лицензии через сервер активации, расположенный в домене lanbilling.ru. Для этого необходимо: войти в административный веб-интерфейс системы под атрибутами администратора и в разделе “Опции” выбрать пункт “Общие”, раздел “Активация”, “Получить лицензионный ключ”. Затем ввести ключ активации и название компании в соответствующие разделы формы активации лицензии и нажать кнопку “Активировать”.

Название компании, должно совпадать с названием компании определенным в разделе “Опции” пункт меню “Реквизиты оператора” поле “Имя компании с формой собственности:”.

image

При положительном ответе сервера активации продукт готов к эксплуатации.

Существующие клиенты, уже имеющие регистрацию в LANBilling HelpDesk, при обновлении АСР до версии 2.0 размещают запрос на получение лицензии с темой “Лицензионный ключ для версии 2.0”, после чего получают Лицензионный ключ указанный в системе HelpDesk.

Лицензия содержит информацию, по которой определяется ряд рабочих параметров АСР: агентская схема телефонии, интеграция с Fidelio, модуль Email Connector, модуль инвентаризации, время действия, максимальное количество пользователей АСР и пр. При изменении любых из указанных параметров, связанных с реконфигурацией АСР, требуется повторное проведение активации нового ключа, содержащего скорректированные параметры.

Механизм активации учитывает возможность назначения тех или иных параметров функционирования АСР в процессе активации. В том случае, если набор ключевых параметров изменяется после проведения активации АСР, модуль контроля лицензионности копии вернет эти параметры к первоначальному значению.