Руководство пользователя по установке АСР 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.013 - 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 и новее.
  • 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

 

Для более детального разбора настроек и конфигурирования БД под конкретные аппаратные ресурсы и нагрузку обратитесь в службу технической поддержки через систему 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
max_input_vars = 2500

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

systemctl restart httpd

Установка python-simplejson

Для установки пакета 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

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

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

Во избежание данной проблемы рекомендуется ограничить диапазон выдаваемых портов. Для этого необходимо добавить в конфигурационный файл /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

Ссылки на репозитории индивидуальны для каждого обладателя лицензии на АСР 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 (for 'safe' mode only)
  dbhost = 127.0.0.1
  dbuser = billing
  dbpass = billing
  dbname = billing

где <<dbuser>> и <<dbpass>> - реквизиты доступа созданного пользователя БД;

<<dbhost>> и <<dbname>> - 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, модуль инвентаризации, время действия, максимальное количество пользователей АСР и пр. При изменении любых из указанных параметров, связанных с реконфигурацией АСР, требуется повторное проведение активации нового ключа, содержащего скорректированные параметры.

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

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