ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ

«ЭРИКССОНСОФТ»

Эксплуатационная документация программного продукта

«Программа модуля пакетного ядра сети vEPC»

Правообладатель программы:

ООО «ЭрикссонСофт», ИНН 9718246399

Брянская обл., 2026

Оглавление

Введение. 3

1. Запуск и останов программного обеспечения. 4

1.1 Запуск программы.. 4

1.2 Останов программы.. 4

1.3 Перезапуск программы.. 5

2. Консоль управления. 7

2.1 Доступ к консоли. 7

2.2 Команды мониторинга состояния. 7

2.3 Команды управления. 8

2.4 Команды трассировки. 9

3. Конфигурирование программы.. 11

3.1 Файлы конфигурации. 11

3.2 Параметры конфигурации. 11

3.3 Примеры конфигурационных файлов. 11

3.4 Изменение конфигурации в процессе эксплуатации. 12

4. Мониторинг и сбор диагностической информации. 13

4.1 Журнал событий. 13

4.2 Трассировка сетевого трафика. 13

4.3 Мониторинг использования ресурсов. 14

4.4 Сбор диагностического пакета. 14

5. Типовые эксплуатационные процедуры.. 16

5.1 Ежедневные операции. 16

5.2 Еженедельные операции. 16

5.3 Ежемесячные операции. 17

5.4 Действия в нештатных ситуациях. 17

6. Взаимодействие со смежными системами. 19

6.1 Проверка доступности. 19

6.2 Отправка тестовых сообщений. 19

6.3 Мониторинг с внешних систем.. 19

Приложение А. Быстрый справочник команд. 20

Приложение Б. Расположение файлов. 21

Введение

Настоящий документ содержит руководство по эксплуатации виртуального сетевого элемента vEPC, объединяющего функции MME (Mobility Management Entity) и SGSN (Serving GPRS Support Node). Документ предназначен для администраторов и операторов, осуществляющих повседневное управление, мониторинг и обслуживание программного обеспечения в процессе эксплуатации.

Эксплуатация программного обеспечения включает в себя совокупность процессов и процедур, направленных на обеспечение его непрерывного и корректного функционирования в соответствии с предъявляемыми требованиями. В документе рассматриваются вопросы запуска и останова программы, мониторинга состояния, управления конфигурацией, сбора диагностической информации, а также типовые операции, выполняемые в процессе эксплуатации.

Целевая аудитория

Документ предназначен для:

Необходимая квалификация

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

1. Запуск и останов программного обеспечения

1.1 Запуск программы

Запуск в интерактивном режиме:

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

bash

./vepc

или, если программа установлена в системную директорию:

bash

vepc

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

Параметры командной строки:

Текущая версия программы не поддерживает параметры командной строки. Все настройки производятся через конфигурационные файлы и интерактивную консоль.

Запуск с правами root:

Для прослушивания портов с номерами менее 1024 (по умолчанию 2123 и 36412) требуются права root. Запуск производится командой:

bash

sudo ./vepc

Запуск в фоновом режиме:

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

bash

nohup ./vepc > /dev/null 2>&1 &

Однако следует учитывать, что при таком запуске консоль управления будет недоступна. Для управления программой в фоновом режиме рекомендуется использовать Docker-контейнер или разработать скрипт-обертку с перенаправлением ввода/вывода.

1.2 Останов программы

Штатная остановка:

Для штатной остановки программы в консоли управления введите команду:

text

stop

После ввода команды программа выполняет следующие действия:

Принудительная остановка:

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

bash

kill -TERM <PID>

bash

kill -9 <PID>  # только в крайнем случае

Для определения идентификатора процесса (PID) используйте команду:

bash

ps aux | grep vepc

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

1.3 Перезапуск программы

Перезапуск из консоли управления:

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

text

restart

Программа последовательно выполняет:

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

Полный перезапуск процесса:

Для полного перезапуска процесса (например, после обновления исполняемого файла) выполните:

text

stop

Затем запустите программу заново.

2. Консоль управления

2.1 Доступ к консоли

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

text

[vEPC] Команды: status / logs / state / show / set <key> <value> / restart / stop

>

2.2 Команды мониторинга состояния

Команда status

Отображает текущее состояние компонентов программы:

text

> status

MME: Running | SGSN: Running | PLMN: 250-20

Поля вывода:

Команда logs

Выводит сохраненные записи журнала событий:

text

> logs

[2025-01-15 14:30:22] [MAIN] vEPC запущен

[2025-01-15 14:30:22] [MME] MME запущен (MCC=250, MNC=20)

[2025-01-15 14:30:22] [SGSN] SGSN запущен (MCC=250, MNC=20)

[2025-01-15 14:30:22] [GTP] GTP-C сервер запущен на UDP 2123

[2025-01-15 14:30:22] [S1AP] S1AP сервер запущен на SCTP 36412

[2025-01-15 14:30:27] [MME] MME: ожидание Initial UE Message...

[2025-01-15 14:30:27] [SGSN] SGSN: ожидание GTP-C сообщений...

Количество сохраняемых в памяти записей ограничено (определяется реализацией). Полный журнал доступен в файле logs/vepc.log.

Команда state

Отображает текущее состояние сохраненных контекстов абонентов:

text

> state

PDP контексты (SGSN): 2

TEID=1001 IMSI=250201234567890

TEID=1002 IMSI=250209876543210

UE контексты (MME): 1

IMSI=250201234567890 GUTI=1234-5678-90AB

Вывод содержит:

Команда show

Отображает текущие значения параметров конфигурации:

text

> show

[MAIN] Текущие значения конфигурации:

gtp-c-port = 2123

mcc = 250

mme-ip = 127.0.0.1

mnc = 20

s1ap-port = 36412

sgsn-ip = 127.0.0.1

2.3 Команды управления

Команда set

Изменяет параметр конфигурации в реальном времени:

text

set <ключ> <значение>

Примеры:

text

set mcc 250

set mnc 20

set gtp-c-port 2123

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

text

[MAIN] Установлено mcc = 250

Важно: Изменения, внесенные командой set, применяются немедленно, но не сохраняются в конфигурационные файлы. После перезапуска программы будут загружены значения из файлов. Для постоянного сохранения изменений необходимо отредактировать соответствующий файл конфигурации.

Команда restart

Выполняет перезапуск всех рабочих потоков:

text

restart

Процесс перезапуска отражается в журнале:

text

[MAIN] Перезапуск потоков...

[MAIN] vEPC запущен

Команда stop

Останавливает программу:

text

stop

После ввода команды программа завершает работу.

2.4 Команды трассировки

Команда trace start

Активирует трассировку сетевого трафика:

text

trace start [интерфейс]

Параметры:

Примеры:

text

trace start gtp-c

trace start all

При успешном запуске трассировки создается файл в директории traces/:

text

[MAIN] Трассировка GTP-C запущена, файл: traces/gtp-c_20250115_143022.pcap

Команда trace stop

Останавливает трассировку:

text

trace stop [интерфейс]

Примеры:

text

trace stop gtp-c

trace stop

Команда trace status

Отображает статус активных трассировок:

text

trace status

Пример вывода:

text

Активные трассировки:

  GTP-C: файл traces/gtp-c_20250115_143022.pcap, размер 1.2 МБ

  S1AP: файл traces/s1ap_20250115_143025.pcap, размер 0.8 МБ

Команда trace config

Настраивает параметры трассировки:

text

trace config <интерфейс> <параметр> <значение>

Параметры:

Примеры:

text

trace config gtp-c max-size 200

trace config gtp-c max-files 10

trace config s1ap filter-ip 192.168.1.100

3. Конфигурирование программы

3.1 Файлы конфигурации

Программа использует два файла конфигурации, которые загружаются при запуске и перезапуске:

Файлы должны находиться в родительской директории относительно исполняемого файла. При запуске из директории build/ программа ожидает файлы в корневой директории проекта.

Формат файлов конфигурации:

3.2 Параметры конфигурации

Параметры MME (файл vmme.conf):

Параметры SGSN (файл vsgsn.conf):

3.3 Примеры конфигурационных файлов

Пример файла vmme.conf:

text

# MME Configuration

mcc=250

mnc=20

mme-ip=192.168.1.10

s1ap-port=36412

Пример файла vsgsn.conf:

text

# SGSN Configuration

mcc=250

mnc=20

sgsn-ip=192.168.1.10

gtp-c-port=2123

3.4 Изменение конфигурации в процессе эксплуатации

Временное изменение:

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

text

set mcc 250

set mnc 20

Изменения применяются немедленно, но после перезапуска программы будут утеряны.

Постоянное изменение:

Для постоянного изменения параметра:

Изменение с перезапуском:

Для применения изменений, требующих перезапуска потоков:

4. Мониторинг и сбор диагностической информации

4.1 Журнал событий

Программа ведет журнал событий в двух формах:

Консольный вывод:

Файл журнала:

Просмотр файла журнала:

bash

tail -f logs/vepc.log  # просмотр в реальном времени

cat logs/vepc.log       # вывод всего файла

less logs/vepc.log      # просмотр с прокруткой

4.2 Трассировка сетевого трафика

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

Запуск трассировки:

text

trace start gtp-c

Сбор трафика:

После запуска трассировки все входящие и исходящие пакеты по указанному протоколу сохраняются в pcap-файл.

Остановка трассировки:

text

trace stop gtp-c

Анализ собранных данных:

Сохраненные файлы находятся в директории traces/:

bash

ls -la traces/

Для анализа используйте Wireshark:

bash

wireshark traces/gtp-c_20250115_143022.pcap

или tcpdump:

bash

tcpdump -r traces/gtp-c_20250115_143022.pcap -vv

4.3 Мониторинг использования ресурсов

Для мониторинга потребления ресурсов используйте стандартные средства операционной системы.

Процессор и память:

bash

top -p $(pgrep vepc)

bash

ps -o pid,%cpu,%mem,cmd -p $(pgrep vepc)

Сетевые порты:

Проверка, что программа слушает ожидаемые порты:

bash

netstat -tulpn | grep vepc

Ожидаемый вывод:

text

udp   0.0.0.0:2123    0.0.0.0:*    PID/vepc

sctp  0.0.0.0:36412   0.0.0.0:*    PID/vepc

Открытые файлы:

bash

lsof -p $(pgrep vepc)

4.4 Сбор диагностического пакета

При возникновении инцидента, требующего обращения в техническую поддержку, соберите следующий диагностический пакет:

bash

md5sum vepc

bash

cp logs/vepc.log vepc.log

bash

cp ../vmme.conf .

cp ../vsgsn.conf .

bash

tar -czf traces.tar.gz traces/

bash

uname -a

cat /etc/os-release

dpkg -l | grep libsctp  # для Debian/Ubuntu

5. Типовые эксплуатационные процедуры

5.1 Ежедневные операции

Проверка работоспособности:

При входе в систему выполните:

bash

cd /путь/к/vepc/build

sudo ./vepc

text

status

text

logs

text

state

Мониторинг ошибок:

Периодически проверяйте файл журнала на наличие сообщений об ошибках:

bash

grep -i error logs/vepc.log

grep -i fail logs/vepc.log

5.2 Еженедельные операции

Анализ тенденций:

Оцените динамику количества активных контекстов:

text

state

Сравните с показателями предыдущих периодов.

Проверка дискового пространства:

Убедитесь, что достаточно свободного места для файлов журнала и трассировки:

bash

df -h .

du -sh logs/

du -sh traces/

Очистка старых файлов:

При необходимости удалите старые файлы трассировки:

bash

find traces/ -name "*.pcap" -mtime +7 -delete

5.3 Ежемесячные операции

Анализ производительности:

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

bash

sa -u | grep vepc

Проверка актуальности версии:

Сверьте текущую версию с последней доступной версией программного обеспечения.

Резервное копирование конфигурации:

Создайте резервную копию конфигурационных файлов:

bash

tar -czf vepc-config-$(date +%Y%m%d).tar.gz ../vmme.conf ../vsgsn.conf

5.4 Действия в нештатных ситуациях

Программа не отвечает на команды:

bash

kill -TERM $(pgrep vepc)

bash

kill -9 $(pgrep vepc)

Потеря связи с сетевыми интерфейсами:

bash

ip link show

bash

iptables -L

bash

netstat -tulpn | grep vepc

Корректировка времени:

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

6. Взаимодействие со смежными системами

6.1 Проверка доступности

Для проверки доступности GTP-C порта используйте:

bash

echo -n "test" | nc -u <IP_vepc> 2123

Для SCTP порта используйте специализированные утилиты или библиотеки.

6.2 Отправка тестовых сообщений

Отправка UDP-сообщения на GTP-C порт:

bash

echo -n "test" | nc -u 127.0.0.1 2123

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

text

[GTP] Получено сообщение длиной 4 байт от 127.0.0.1

6.3 Мониторинг с внешних систем

Для интеграции с внешними системами мониторинга используйте анализ файла журнала:

bash

tail -f logs/vepc.log | while read line; do

  if echo "$line" | grep -q "ERROR"; then

    # Отправка alert во внешнюю систему

  fi

done

Приложение А. Быстрый справочник команд

Приложение Б. Расположение файлов