Настоящая эксплуатационная документация подготовлена для обеспечения эффективной и безопасной эксплуатации экземпляра программного обеспечения vMSC (virtual Mobile Switching Center), предоставленного для проведения экспертной оценки.

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

В рамках экспертной оценки представленный экземпляр ПО демонстрирует:

Полнофункциональную реализацию VMSCв соответствии со стандартами

3GPP

Современные интерфейсы управления и мониторинга

Готовность к промышленной эксплуатации в телекоммуникационных сетях

Документация построена по принципу "от простого к сложному" — от базовых проверок работоспособности до продвинутых процедур диагностики и восстановления. Все команды и процедуры проверены на тестовом стенде и готовы к применению.

Особое внимание уделено безопасности — все чувствительные данные (пароли, ключи доступа) в документации заменены на шаблоны, фактические значения предоставляются отдельно уполномоченным лицам.

Документ является динамическим — по мере накопления эксплуатационного опыта и выхода обновлений ПО он будет дополняться и актуализироваться.

Технические характеристики экземпляра

Конфигурация ВМ

text

Имя ВМ: vMSC-prod-01 vCPU: 8 ядер

RAM: 32 ГБ

Диск: 500 ГБ (SSD)

ОС: Ubuntu Server 20.04 LTS

Ядро: 5.4.0-xx-generic

Сетевые настройки

text

Основной интерфейс (eth0): IP: 192.168.100.50/24 Gateway: 192.168.100.1

DNS: 8.8.8.8, 8.8.4.4

Служебный интерфейс (eth1):

IP: 10.0.100.50/24 (для backup/management)

Установленные компоненты

text

Основное ПО:

vMSC-module: v1.8.3

- S7-module: v3.2.0

Вспомогательное ПО:

OpenS7 2.4.57

S7 Stack 1.6.0

SCTP Tools 1.0.18

Java Runtime 11.0.12

Доступ к системе

Учетные записи

text

Административный доступ: Логин: admin

Пароль: [выдается отдельно]

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

Операторский доступ: Логин: operator

Пароль: [выдается отдельно]

Уровень: только мониторинг и базовые операции

Технический доступ (SSH): Логин: root

Пароль: [выдается отдельно] Порт: 4422 (нестандартный)

Интерфейсы управления

2.2.1. Консольный интерфейс (CLI)

bash

# Подключение через SSH

ssh -p 4422 root@192.168.100.50

# Запуск CLI VMSC

cd /opt/vMSC/bin

./vMSC-cli

Веб-интерфейс

text

URL: https://192.168.100.50:8443/admin

Логин: admin

Интерфейс доступен только из внутренней сети

API интерфейсы

text

REST API: https://192.168.100.50:8443/api/v1 SOAP API: https://192.168.100.50:8443/soap Документация: /opt/vMSC/docs/api/index.html

Стартовые процедуры

Проверка состояния системы

bash

# Проверка статуса сервисов systemctl status vMSC

# Проверка сетевых соединений

ss -tlnp | grep -E '3868|3869|389|4422' netstat -sctp

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

df -h / /opt/vMSC

Запуск/остановка сервисов

bash

# Полный запуск

systemctl start vMSC

# Полная остановка systemctl stop S7-server

# Перезапуск

systemctl restart vMSC

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

bash

# Тест vMSC-интерфейса

/opt/vMSC/bin/test-vMSC.sh

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

Утренняя проверка

bash

# 1. Проверка логов ошибок

grep -i error /var/log/vMSC/vMSC.log | tail -20

# 2. Проверка доступности сервисов

curl -k https://localhost:8443/health

# 3. Проверка дискового пространства

/opt/vMSC/scripts/check-disk-space.sh

# 4. Проверка сетевых интерфейсов

/opt/vMSC/scripts/check-interfaces.sh

# 5. Проверка количества активных сессий

/opt/vMSC/scripts/active-sessions.sh

Мониторинг в реальном времени

bash

# Просмотр логов в реальном времени

tail -f /var/log/vMSC/vMSC.log

# Мониторинг системных ресурсов

htop

iftop -i eth0

Резервное копирование

bash

# Ручное создание бэкапа

/opt/vMSC/scripts/backup.sh --full

# Проверка существующих бэкапов

ls -la /backup/vMSC/

/opt/vMSC/scripts/verify-backup.sh

# Автоматическое резервное копирование (ежедневно в 02:00)

systemctl status vMSC-backup.timer

Управление

Просмотр конфигурации и состояния

bash

./vmsc # Все секции конфига

./vmsc --show-interfaces # Интерфейсы и таблица GT

./vmsc --show-vlr # Таблица подписчиков VLR (читает vmsc_vlr.conf)

./vmsc --show-gt-route # Таблица маршрутизации GT

./vmsc --show-alarms # Диагностика аварий и состояния

./vmsc --show-subscriber # Параметры абонента (IMSI, MSISDN, msc_gt)

./vmsc --show-subscribers # Таблица всех абонентов из [subscriber-N]

./vmsc --show-identity # Идентификация узла (MCC, MNC, LAC, Cell ID)

./vmsc --show-m3ua # Параметры M3UA: OPC/DPC/NI/SI/SLS

./vmsc --show-encapsulation # Цепочка инкапсуляции сообщения

Генерация и отправка сообщений

A-интерфейс (MSC ↔ BSC, BSSMAP + DTAP)

```bash

./vmsc --send-lu-request --send-udp --use-m3ua # Location Update Request

./vmsc --send-bssmap-reset --send-udp --use-m3ua # BSSMAP Reset

./vmsc --send-dtap-mm-null --send-udp --use-m3ua # MM NULL (heartbeat)

./vmsc --send-bssmap-ho-complete --send-udp --use-m3ua # BSSMAP HO Complete

./vmsc --send-dtap-auth-req --send-udp --use-m3ua # Authentication Request (MM 0x12)

./vmsc --send-dtap-auth-resp --send-udp --use-m3ua # Authentication Response (MM 0x14)

./vmsc --send-dtap-id-req --send-udp --use-m3ua # Identity Request (MM 0x18)

./vmsc --send-dtap-id-resp --send-udp --use-m3ua # Identity Response (MM 0x19)

./vmsc --send-bssmap-cipher --send-udp --use-m3ua # Ciphering Mode Command

./vmsc --send-dtap-cipher-compl --send-udp --use-m3ua # Ciphering Mode Complete (RR 0x32)

./vmsc --send-dtap-lu-accept --send-udp --use-m3ua # LU Accept (MM 0x02)

./vmsc --send-dtap-lu-reject --send-udp --use-m3ua # LU Reject (MM 0x04)

./vmsc --send-dtap-cm-srv-req --send-udp --use-m3ua # CM Service Request (MM 0x24)

./vmsc --send-dtap-cm-srv-acc --send-udp --use-m3ua # CM Service Accept (MM 0x21)

./vmsc --send-dtap-cc-setup-mo --send-udp --use-m3ua # CC Setup (MO, MS→MSC)

./vmsc --send-dtap-cc-alerting --send-udp --use-m3ua # CC Alerting (0x01)

./vmsc --send-dtap-cc-disconnect --send-udp --use-m3ua # CC Disconnect (0x25)

./vmsc --send-dtap-cc-release --send-udp --use-m3ua # CC Release (0x2D)

./vmsc --send-dtap-cc-rel-compl --send-udp --use-m3ua # CC Release Complete (0x2A)

RR сообщения (управление радиоресурсом)

bash

./vmsc --send-rr-channel-req --send-udp --use-m3ua # Channel Request (RR 0x23)

./vmsc --send-rr-immediate-assign --send-udp --use-m3ua # Immediate Assignment (RR 0x3F)

./vmsc --send-rr-paging-req1 --send-udp --use-m3ua # Paging Request Type 1 (RR 0x39)

./vmsc --send-rr-assignment-cmd --send-udp --use-m3ua # Assignment Command (RR 0x2E)

./vmsc --send-rr-assignment-compl --send-udp --use-m3ua # Assignment Complete (RR 0x29)

./vmsc --send-rr-channel-release --send-udp --use-m3ua # Channel Release (RR 0x0D)

./vmsc --send-rr-handover-compl --send-udp --use-m3ua # Handover Complete (RR 0x2C)

SMS (P42, реализовано в v1.0)

bash

./vmsc --send-sms-rp-data-mo --sms-msg-ref 1 --send-udp --use-m3ua # SMS RP-DATA (MO)

./vmsc --send-sms-rp-data-mt --sms-msg-ref 2 --send-udp --use-m3ua # SMS RP-DATA (MT)

./vmsc --send-sms-rp-ack --sms-msg-ref 3 --send-udp --use-m3ua # SMS RP-ACK

./vmsc --send-sms-rp-error --sms-msg-ref 4 --rp-cause 27 --send-udp --use-m3ua # SMS RP-ERROR

./vmsc --send-sms-rp-smma --sms-msg-ref 5 --send-udp --use-m3ua # SMS RP-SMMA

SI 16-20 (P41, реализовано в v1.0)

bash

./vmsc --send-si-bicc --si-billing-id 42 --send-udp --use-m3ua # SI 16 BiCC

./vmsc --send-si-dup --send-udp --use-m3ua # SI 17 DUP

./vmsc --send-si-tup --send-udp --use-m3ua # SI 18 TUP

./vmsc --send-si-isomap --send-udp --use-m3ua # SI 19 ISOMAP

./vmsc --send-si-ituup --send-udp --use-m3ua # SI 20 ITUUP

C-интерфейс (MSC ↔ HLR, MAP)

bash

./vmsc --send-map-sai --send-udp --use-m3ua # SendAuthenticationInfo

./vmsc --send-map-ul --send-udp --use-m3ua # UpdateLocation

./vmsc --send-map-cl --send-udp --use-m3ua # CancelLocation

./vmsc --send-map-isd --send-udp --use-m3ua # InsertSubscriberData

./vmsc --send-map-check-imei --send-udp --use-m3ua # CheckIMEI (F-interface)

ISUP-интерфейс (MSC ↔ PSTN, **SI=5**)

bash

./vmsc --send-isup-iam --cic 1 --send-udp --use-m3ua # IAM (Initial Address Message)

./vmsc --send-isup-acm --cic 1 --send-udp --use-m3ua # ACM (Address Complete)

./vmsc --send-isup-anm --cic 1 --send-udp --use-m3ua # ANM (Answer)

./vmsc --send-isup-rel --cic 1 --send-udp --use-m3ua # REL (Release)

./vmsc --send-isup-blo --cic 1 --send-udp --use-m3ua # BLO (Block Circuit)

./vmsc --send-isup-ubl --cic 1 --send-udp --use-m3ua # UBL (Unblock Circuit)

TCAP диалоги (для многошаговых операций)

bash

./vmsc --send-map-sai-end --dtid 0xABCD --send-udp --use-m3ua # Return Result

./vmsc --send-tcap-continue --otid 0x1 --dtid 0xABCD --send-udp --use-m3ua

./vmsc --send-tcap-abort --dtid 0xABCD --send-udp --use-m3ua # Abort

Управление конфигурацией

bash

./vmsc --opc 999 --dpc 888 --ni 2 --save-config # Override + сохранить

./vmsc --config base.conf --config lab.conf # Стекирование конфигов

./build/run_vmsc.sh # Быстрый запуск

Диагностика и устранение неисправностей

Типовые проблемы и решения

Проблема: VMSC не отвечает на S7-запросы

bash

# Диагностика:

Проверить статус сервиса: systemctl status vMSC

Проверить порты: netstat -tlnp | grep 3868

Проверить журнал: tail -100 /var/log/vMSC/S7.log

Проверить сеть: ping 192.168.100.50

# Решение:

systemctl restart vMSC

iptables -L -n | grep 3868 # Проверка firewall

Проблема: Переполнение диска

bash

# Диагностика:

df -h

du -sh /var/log/vMSC/*

# Решение:

/opt/vMSC/scripts/cleanup-logs.sh journalctl --vacuum-size=100M

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

bash

# Создать диагностический пакет

/opt/vMSC/scripts/gather-diag.sh --full

# Содержимое diag-пакета:

# - Конфигурационные файлы

# - Последние 1000 строк логов

# - Статус системных служб

# - Сетевые настройки

# - Информация о дисках и памяти

Мониторинг и метрики

Ключевые метрики для мониторинга

text

Производительность:

vMSC_transactions_per_second

vMSC_response_time_ms

S7_messages_sent

S7_messages_received

Ресурсы:

system_cpu_usage_percent

system_memory_usage_mb

disk_usage_percent

network_traffic_mbps

Абоненты:

active_subscribers_count

authentication_success_rate

registration_success_rate

roaming_subscribers_count

Пороговые значения для оповещений

text

Критические (alarm):

CPU > 90% более 5 минут

Память > 95%

Диск > 90%

Успешность аутентификации < 95%

Предупреждения (warning):

CPU > 80% более 10 минут

Память > 85%

Диск > 80%

Время ответа > 500 мс

Панели мониторинга

text

Grafana Dashboards:

VMSC Overview: http://192.168.100.50:3000/d/vMSC-overview

Performance Metrics: http://192.168.100.50:3000/d/vMSC-performance

Subscriber Analytics: http://192.168.100.50:3000/d/vMSC-subscribers

Доступ: grafana/grafana (логин/пароль)

Резервное копирование и восстановление

Расписание бэкапов

text

Ежедневно:

02:00 - Полный бэкап (удерживается 7 дней)

12:00 - Инкрементальный бэкап (удерживается 30 дней)

Еженедельно:

Воскресенье 03:00 - Полный бэкап (удерживается 4 недели)

Ежемесячно:

Первое число 04:00 - Архивный бэкап (удерживается 12 месяцев)

Процедура восстановления

bash

# 1. Остановить сервисы

systemctl stop vMSC

# 2. Восстановить из бэкапа

/opt/vMSC/scripts/restore.sh --backup=/backup/vMSC/full_20231201.tar.gz

# 3. Запустить сервисы

systemctl start vMSC

# 4. Проверить восстановление

/opt/vMSC/scripts/verify-restore.sh

Безопасность

Журналирование безопасности

bash

# Просмотр журналов безопасности

grep -i "failed\|denied\|unauthorized" /var/log/auth.log journalctl -u ssh --since "today"

# Мониторинг попыток входа

lastb | head -20

Приложение A: Быстрый старт

Проверка работоспособности за 5 минут

bash

# 1. Проверка сервисов

systemctl is-active vMSC

# 2. Проверка портов

nc -z localhost 3868 # S7

nc -z localhost 389 # LDAP

# 3. Тестовая аутентификация

curl -X POST https://localhost:8443/api/v1/auth/test \

-H "Content-Type: application/json" \

-d '{"imsi":"250010001000001"}'

# 4. Проверка логов

tail -5 /var/log/vMSC/vMSC.log

Экстренные команды

bash

# Аварийная остановка

/opt/vMSC/scripts/emergency-stop.sh

# Аварийный запуск

/opt/vMSC/scripts/emergency-start.sh

# Сброс до заводских настроек

/opt/vMSC/scripts/factory-reset.sh # ТОЛЬКО В КРИТИЧЕСКИХ СЛУЧАЯХ