Руководство пользователя по установке АСР LANBilling CentOS (7.x)

CentOS 7.x (x86_64) поддерживается, начиная с релиза LANBilling 2.0 013.


  1. Системные требования к аппаратно-программной части
  2. Установка необходимых для работы АСР LANBilling сервисов
  3. Установка АСР LANBilling
  4. Создание структуры БД АСР LANBilling
  5. Первоначальная настройка модуля LBucd (Netflow)
  6. Первоначальная настройка модуля LBarcd (RADIUS)
  7. Запуск системы
  8. Активация лицензии

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

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

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

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

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

  • СУБД MySQL
    • 5.1.x - для релизов LANBilling 013 - 014. Начиная с релиза 015, поддержка версии прекращается.
    • 5.5.x - для релизов LANBilling 014 и выше.
    • 5.6.x - для релизов LANBilling 018 и выше.
    • 5.7.x - для релиза LANBilling 027 от 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;
    • bcmath;
    • ghostscript (требуется для генерации шаблонов в pdf формате);
    • pdftk (библиотека для "склейки" pdf документов в один файл).

    Обязательные предварительные настройки ОС

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

    Для работоспособности web-сервера обязательно нужно отключить SELinux. Для этого в конфигурационном файле /etc/selinux/config требуется изменить значение параметра «SELINUX» на «disabled» и перезагрузить операционную систему. Без этого действия модули АСР не смогут в полной мере взаимодействовать друг с другом.

    SELINUX=disabled
    

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

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

    Устанавливаем MySQL сервер:

    wget http://repo.mysql.com/mysql-community-release-el7-5.noarch.rpm
    rpm -ivh mysql-community-release-el7-5.noarch.rpm
    yum-config-manager --disable mysql57-community 
    yum-config-manager --enable mysql56-community
    yum install mysql-server
    mysql_install_db
    

    Определяем пароль root пользователя:

    mysqladmin -u root password 'ваш_пароль_для_root_пользователя_mysql'
    

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

    Начиная с версии MySQL 5.5 поддержка InnoDB включена по умолчанию.

    Конфигурационный файл в CentOS7 расположен в /etc/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
    
    

    Примечание: Для корректной работы 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

     

    Для более детального разбора настроек и конфигурирования БД под конкретные аппаратные ресурсы и нагрузку обратитесь в службу технической поддержки через систему HelpDesk. Для подбора оптимальных параметров можно также воспользоваться статьей или знанием 115, которое доступно в личном кабинете.

    Дополнительно необходимо открыть доступ MySQL-серверу к соответствующим библиотекам.

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

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

    systemctl start mysqld
    

    Для автоматического запуска MySQL выполняем команду:

    systemctl enable mysqld
    

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

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

    • apache;
    • php;
    • php-bcmath;
    • php-gd;
    • php-mysql.

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

    rpm -Uvh https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
    rpm -Uvh https://mirror.webtatic.com/yum/el7/webtatic-release.rpm
    

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

    yum install httpd php56w php56w-soap libtiff libpng php56w-gd php56w-mysql php56w-mbstring php56w-xml php56w-bcmath php56w-mcrypt php-gmp
    

    Для формирования отчетов в формате pdf потребуется так же установка ghostscript:

    yum install ghostscript
    

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

    В CentOS7 закоментируйте welcome-страницу (/etc/httpd/conf.d/welcome.conf) и отредактируйте основной конфигурационный файл apache2 в CentOS7 - /etc/httpd/conf/httpd.conf:

    • раскомментировать директиву ServerName;
    • закомментировать строку: #AddDefaultCharset UTF-8.

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

    systemctl enable httpd
    

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

    yum install openssl mod_ssl
    

    Для работы сервера по протоколу HTTPS требуется SSL сертификат.

    После получения сертификата необходимо отредактировать конфигурационный файл /etc/httpd/conf.d/ssl.conf.

    vi /etc/httpd/conf.d/ssl.conf
    

    1. Требуется раскомментировать директиву DocumentRoot.

    DocumentRoot "/var/www/html"
    

    2. Раскомментировать директиву ServerName и установить необходимое имя сервера. Порт обязательно 443. Пример:

    ServerName www.srv.world:443
    

    3. Изменить значение параметра SSLProtocol.

    SSLProtocol -All +TLSv1 +TLSv1.1 +TLSv1.2
    

    4. В параметре SSLCertificateFile указать полный путь до файла-сертификата SSL. Пример:

    SSLCertificateFile /etc/pki/tls/certs/server.crt
    

    5. В параметре SSLCertificateKeyFile указать полный путь до ключа к файлу-сертификата SSL. Пример:

    SSLCertificateKeyFile /etc/pki/tls/certs/server.key
    

    6. Перезагрузить WEB-сервер.

    systemctl restart httpd
    

    Следующие два шага необходимо выполнить только если используется сервис firewall.

    7. Требуется разрешить HTTPS-соединения. Это можно сделать командой:

    firewall-cmd --add-service=https --permanent 
    

    8. И перезапустить firewall.

    firewall-cmd --reload 
    

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

    Для корректной работы web-интерфейса рекомендуется установить следующие параметры в файле php.ini (/etc/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 httpd
    

    Установка python-simplejson и xerces-c

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

    wget http://dl.fedoraproject.org/pub/epel/7/x86_64/Packages/e/epel-release-7-11.noarch.rpm
    rpm -ivh epel-release-7-11.noarch.rpm 
    

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

    yum install -y python-simplejson xerces-c
    

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

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

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

    net.ipv4.ip_local_port_range = 35000 60999
    

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

    sysctl net.ipv4.ip_local_port_range='35000 60999'
    

    3. Установка АСР LANBilling

    Скачивание пакетов модулей АСР


    Скачать пакеты модулей и ядра АСР можно двумя способами:

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

    Важно: для работы с репозиториями требуется утилита yum-utils. Установить утилиту можно с помощью команды:

    yum install yum-utils

    Важно: Установка библиотеки необходимой для работы LBcore

    yum install xerces-c

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

    Страница настройки репозиториев

    Подключение репозиториев происходит командами следующего вида:

      yum-config-manager --add-repo <url-ссылка на репозиторий>
    

    Репозитории "release builds" содержат релизные сборки ядра и агентов АСР. "hotfix builds" -- еженедельные "пятничные" сборки.

    Для того чтобы скачать установочные пакеты интересующих модулей без подключения репозиториев, необходимо перейти на вкладку "Загрузки" и выбрать версию АСР.

    Страница загрузки пакетов АСР вручную

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

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

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

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

    • Lbcore — обозначение ядра или клиентов LBarcd, LBucd, LBusbox, LBhotel, LBinet, LBircd, LBtv, LBphone;
    • 2.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).

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

    rpm -ivh LB*.rpm или rpm -ivh lb*.rpm
    

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

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

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

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

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

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

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

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

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

    Важно: административный интерфейс 3.0 доступен только для сборок 2.0.20.1 и новее.

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

    yum install php56w-mcrypt
    

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

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

    rpm -ivh lbweb-common-X.Y.Z-Z.el7.centos.noarch.rpm
    rpm -ivh lbweb-admin-X.Y.Z-Z.el7.centos.noarch.rpm
    

    где X.Y.Z-Z - версия релиза.

    Если 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
    

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

    cp /etc/lanbilling/phpclient/apache2/lbweb-admin.apache2.sample /etc/httpd/conf.d/lbweb-admin.conf
    

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

    systemctl restart httpd
    

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


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

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

    Важно: клиентский кабинет 3.0 доступен только для сборок 2.0.23.1 и новее.

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

    yum install php56w-mcrypt
    

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

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

    rpm -ivh lbweb-common_X.Y.Z-Z.el7.centos.noarch.rpm
    rpm -ivh lbweb-client_X.Y.Z-Z.el7.centos.noarch.rpm
    

    где X.Y.Z-Z - версия релиза.

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

    cp /etc/lanbilling/phpclient/apache2/lbweb-client.apache2.sample /etc/httpd/conf.d/lbweb-client.conf
    

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

    systemctl restart httpd
    

    Интерфейс доступен по адресу: 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@10.140.10.250: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
    

    6. Первоначальная настройка модуля LBarcd (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
    

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

    Для настройки в конфигурационном файле /etc/billing.conf.LBarcd необходимо изменить параметр <<log_level>>:

      # Log verbosity level: error, warning, info, verbose, debug
      log_level = debug
    

    При успешном завершении синхронизации в логах будут сообщения вида "Synchronize with LBserver complete".

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


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

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

    systemctl start lbcore
    systemctl start lbarcd
    systemctl start lbucd
    

    После запуска этих компонентов, в списке процессов должны присутствовать все установленные модули. Проконтролировать это можно командой: "ps ax | grep LB". По каждому из агентов и серверу системы АСР LANBilling ведется логирование, находящиеся по умолчанию в директории /usr/local/billing и имеющие одноименные названия с запускаемыми файлами. Для удобства использования рекомендуется настроить ротацию логов АСР.

    На этом этапе установка серверной части системы завершена, и, если все сконфигурировано правильно, то, запустив браузер Firefox или Internet Explorer и набрав в адресной строке IP-адрес web-сервера и затем через слеш admin (например, так: http://SERVER_IP_ADDR/admin, где SERVER_IP_ADDR — ip-адрес вашего сервера), в окне браузера отобразится окно авторизации к административному интерфейсу управления АСР LANBilling. По умолчанию доступ осуществляется под логином: admin и не заданным паролем.

    В случае успешной установки apache с SSL при наборе в браузере https://SERVER_IP_ADDR/admin появится окно с информацией о сертификате, после подтверждения, которого пользователем отобразится административный интерфейс.

    Важным условием запуска системы является тот факт, что на момент создания сетевых агентов должна быть осуществлена физическая связь между сетевыми агентами и центральным хранилищем. А также между php-интерфейсом, сервером LBcore и центральной базы данных. Сервер LBcore и web-интерфейс должны быть установлены на одной машине. На серверах не должны быть заблокированы порты: 3306, 34007 и 34010, т.к. они используются при установлении соединения с БД и агентов с сервером.

    Также следует настроить скрипты блокировки услуги.

    По умолчанию, в /etc/billing.conf отключен запуск всех внешних скриптов. Для настройки запуска скриптов по событиям установки/снятия блокировки и др. необходимо раскоментировать соответствующую скрипту запись в billing.conf и поместить скрипт с указанным именем в /usr/local/billing. Примеры скриптов находятся в /usr/local/billing/scripts. При этом, в случае обновления АСР, обновляются скипты только в папке scripts, остальные скрипты (скопированные в /usr/local/billing) не меняются.

    Мы преднамеренно не предоставляем программы, автоматизирующие процесс установки, в виду того, что в процессе установки пакетов, часто возникают различные ошибки, с которыми логика инсталлятора не в состоянии справиться, кроме того, большинство администраторов предпочитают контролировать все модификации системы, которые происходят в процессе установки нового ПО, такого как, например, LANBilling.



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

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

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

    Сервер: lic.lanbilling.ru

    Порт: 34100

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

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

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

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

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

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

    Назад к документации