Описание
Реляционная СУБД, используемая в проекте SoftWLC для хранения данных, необходимых для работы системы управления. Используется версия 15.1 Distrib 10.6.17-MariaDB. MariaDB является форком MySQL и имеет множество сходств с этой системой управления базами данных. MariaDB имеет поддержку новых типов данных, улучшенную производительность и масштабируемость, а также множество других дополнительных возможностей. Кроме того, MariaDB поддерживает большинство функциональности MySQL и обеспечивает возможность миграции баз данных из MySQL без изменений в самих данных.
В проекте используются следующие базы данных:
| База данных | Описание | Пакет для создания/обновления |
|---|---|---|
| eltex_ems | Хранит данные о доменной структуре, дереве объектов, пользователях EMS, конфигурационные данные EMS и др. | eltex-ems-db |
| eltex_alert | Хранит журнал событий EMS и устройств. | eltex-ems-db |
| wireless | Хранит настройки SSID. База создается/обновляется при установке пакета . | eltex-ems-db |
| eltex_auth_service | Хранит данные о пользователях ЛК, конструктора порталов и NBI. | eltex-auth-service-db |
| radius | Хранит данные о пользователях Wi-Fi, их учетные записи, настройки и аккаунттинг. | eltex-radius-db |
| ELTEX_PORTAL | Хранит данные о виртуальных порталах, используемых в проекте. | eltex-portal |
| eltex_doors | Хранит JWT-токены, сгенерированные сервисом. | eltex-doors |
| eltex_bruce | Хранит данные о планировщике отчетов eltex-bruce | eltex-ems-db |
| eltex_jobs | Хранит данные о выполненных отчетах eltex-jobs | eltex-ems-db |
| eltex_ngw | Хранит данные об отправленных сообщениях СМС и email | eltex-ems-db |
| eltex_jerry | Хранит данные индивидуальных конфигураций ОТТ | eltex-ems-db |
| eltex_ont | Хранит данные об устройствах ONT | eltex-ems-db |
| eltex_ott | Хранит настройки OTT - черные списки, профили, настройки ESR, параметры xauth | eltex-ems-db |
| eltex_pcrf | Хранит данные PCRF - списки доступа пользователей и приложений, сессии пользователей, назначеные сервисы и сценарии, а также CoA логи | eltex-ems-db |
| eltex_sorm2 | Хранит параметры профилей и привязок SORM2 | eltex-ems-db |
| eltex_wifi_customer_cab | Хранит данные и настройки Личного Кабинета | eltex-ems-db |
| Syslog | Хранит данные Syslog | eltex-ems-db |
Управление сервисом
| Действие | Команда | Ответ |
|---|---|---|
| Проверка состояния | service mariadb status | Сервис работает mariadb start/running, process <pid> Сервис не работает mariadb stop/waiting |
| Запуск сервиса | service mariadb start | Сервис запустился mariadb start/running, process <pid> Сервис уже работает start: Job is already running: mariadb |
| Остановка сервиса | service mariadb stop | Сервис успешно остановлен mariadb stop/waiting |
| Перезапуск сервиса | service mariadb restart | Сервис успешно перезапущен mariadb stop/waiting mariadb start/running, process <pid> |
Конфигурация
Настройка MariaDB осуществляется при помощи конфигурационных файлов /etc/mysql/mariadb.cnf (дефолтный файл, устанавливается вместе с пакетом mariadb-server) и /etc/mysql/conf.d/eltex-ems.cnf (содержит дополнительную конфигурацию, важную для работы системы управления, устанавливается вместе с пакетом eltex-ems-db).
Количество коннектов
В зависимости от предполагаемого количества используемых точек доступа, необходимо указать максимальное количество коннектов к БД. За это отвечает параметр max_connections. По умолчанию он прописан в файле /etc/mysql/mariadb.conf.d/50-server.cnf , но закомментирован. Раскомментируйте его и пропишите необходимое значение, например так:
max_connections = 500
Это значение можно выбрать из таблицы Расчет количества коннектов к БД (нижняя строка таблицы)
Объем памяти
MyISAM используется в БД eltex_alert и syslog. InnoDB во всех остальных БД, включая высоконагруженную таблицу radius.radacct
После установки БД необходимо сконфигурировать объем памяти, выделяемый для служб MyISAM и InnoDB (/etc/mysql/conf.d/eltex-ems.cnf параметры key_buffer_size и innodb_buffer_pool_size соответственно).
Рекомендации по настройке:
При установке БД на выделенном хосте, рекомендуемый объем памяти 30-40% от общей RAM для каждой из служб.
При установке всех сервисов на один хост объем памяти, выделяемый для каждой из служб, рассчитывается исходя из того, что основному Java приложению (eltex-ems), веб-серверу tomcat6, NBI, ЛК, eltex-apb, так же требуются большие объемы виртуальной памяти. Настраиваются отдельно для каждой из служб в соответствующих конфигурационных файлах.
Объем памяти, выделяемый для службы InnoDB, может быть 2-3 раза больше, чем для MyISAM в том случае, если не планируется собирать syslog с большого количества устройств.
Например, при установке всех служб SoftWLC на один хост, выделены следующие объемы:
Для сервера на 16G:
key_buffer_size = 2G innodb_buffer_pool_size = 4G
Для сервера на 64G:
key_buffer_size=8G innodb_buffer_pool_size=24G
После изменения конфигурационных файлов требуется перезапуск MariaDB командой:
service mariadb restart
Параметры key_buffer_size и innodb_buffer_pool_size могут быть изменены в любое время на основании показателей производительности машины. Смена значений влияет на скорость обработки данных во время работы службы MariaDB и не может привести к потере уже сохраненных данных или смене структуры хранения их в файловой системе.
Дополнительные учетные записи пользователей баз данных
Сбор rsyslog
Для сбора логов с серверов DHCP и RADIUS в базе данных должна быть создана учетная запись пользователя rsyslog.
Команды:
CREATE USER 'rsyslog'@'HOST' identified by 'root'; GRANT ALL on Syslog.* TO 'rsyslog'@'HOST' identified by 'root';
HOST – адрес серверов RADIUS или DHCP в сети управления. Для каждого сервера должна быть создана отдельная запись.
Проверка репликации из GUI EMS
Для того чтобы сервер EMS имел возможность проверить состояние репликации, нужны дополнительные учетные записи, создать их можно из консоли MariaDB командами:
GRANT ALL PRIVILEGES ON *.* TO 'root'@'HOST' IDENTIFIED BY 'root'; FLUSH PRIVILEGES;
где HOST – адрес серверов EMS в сети VRRP. Для каждого сервера должна быть создана отдельная запись.
Расчет количества коннектов к БД в зависимости от нагруженности серверов
| до 50 ТД | от 50 до 200 ТД | от 200 до 500 ТД | от 500 до 4 тыс. ТД | ||
Количество коннектов на сервисах SoftWLC (эти настройки указываются в конфигурационных файлах сервисов для подключения к БД) | |||||
| nbi (суммарное) | 16 | 38 | 78 | 156 | |
| Количество подключений сервиса к каждой БД | radius | 4 | 12 | 24 | 48 |
| ems | 4 | 10 | 22 | 48 | |
| wireless | 4 | 10 | 22 | 48 | |
| logs | 2 | 4 | 6 | 8 | |
| eltex_auth_service | 2 | 2 | 4 | 4 | |
| ems (суммарное) | 20 | 40 | 92 | 186 | |
| Количество подключений сервиса к каждой БД | event | 4 | 8 | 16 | 32 |
| tree | 4 | 8 | 20 | 40 | |
| syslog | 2 | 4 | 4 | 4 | |
| radius | 4 | 8 | 20 | 40 | |
| wireless | 3 | 6 | 14 | 30 | |
| PCRF (суммарное) | 6 | 12 | 24 | 48 | |
| Количество подключений сервиса к каждой БД | radius | 2 | 4 | 8 | 16 |
| sql.ems | 2 | 4 | 8 | 16 | |
| sql.wireless | 2 | 4 | 8 | 16 | |
| radius | 5 | 10 | 15 | 32 | |
| eltex-portal | 10 | 10 | 15 | 32 | |
| eltex-portal-constructor | 10 | 10 | 10 | 10 | |
| rsyslog-mysql | 2 | 4 | 6 | 10 | |
| репликация | 2 | 2 | 2 | 2 | |
| резерв | 8 | 8 | 8 | 8 | |
| Суммарное количество коннектов на MariaDB (количество коннектов, которое нужно прописать в настройках БД) | 78 | 130 | 234 | 449 | |
Анализ работы сервера MariaDB c помощью MySQLTuner
MySQLTuner — это perl-скрипт, который анализирует статистику работы MySQL и выдает свои рекомендации по оптимизации настроек MySQL-сервера.
Для корректного анализа и сбора статистики сервер MySQL должен проработать некоторое время без смены параметров конфигурации и без перезагрузок, по рекомендации самого MySQLTuner не менее 24 часов.
Для запуска скрипта выполните команду:
/usr/lib/eltex-ems-db/tools/mysqltuner.pl --user root --pass root
После запуска скрипт произведет анализ и выдаст следующую информацию:
Особое внимание стоит уделить строкам, помеченным символами [!!]
Докеризация сервиса
Имеется возможность запустить сервис mysql в Docker-контейнере. Для этого необходимо создать файл с настройками docker-compose.yml и .env следующего содержания:
version: "3"
services:
eltex-mariadb:
container_name: eltex-mariadb
image: ${ELTEX_HUB}/eltex-mariadb:${SWLC_VERSION}
restart: unless-stopped
env_file:
- environment/eltex-mariadb.env
environment:
# Настройки таймзоны
- TZ=${TZ}
volumes:
- ./volumes/mysql/datadir:/var/lib/mysql
TZ=Europe/Moscow MYSQL_ROOT_USER=root MYSQL_ROOT_PASSWORD=root MYSQL_USER=javauser MYSQL_PASSWORD=javapassword ANSWER_SOFTWLC_ROOT_DOMAIN=root ANSWER_SOFTWLC_SERVICE_USER_PASSWORD=softwlc ANSWER_AUTH_SERVICE_ADMIN_USER=admin ANSWER_AUTH_SERVICE_ADMIN_PASSWORD=password ANSWER_EMS_LANG=1 ANSWER_EMS_ACCESS_TYPE_DOMAIN=1 ANSWER_SOFTWLC_BACKUP_DB=1
Для переноса данных из Deb решения в Docker можно воспользоваться следующей инструкцией.
Запустить контейнер можно командой:
docker compose up -d