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

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

Инструкция по установке экземпляра программного продукта «Виртуальный центр коммутации мобильной связи vMSC»

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

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

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

Оглавление

1. Подготовка среды выполнения. 3

2. Получение дистрибутива ПО.. 4

3. Сборка ПО из исходного кода (для варианта 2). 5

4. Первоначальная настройка. 6

5. Проверка установки.. 7

6. Устранение возможных проблем при установке. 8

1. Подготовка среды выполнения

1.1. Требования к аппаратному и программному обеспечению

Перед установкой ПО vMSC необходимо убедиться, что целевая система соответствует следующим минимальным требованиям:

1.2. Установка зависимостей

Для корректной работы ПО vMSC требуются следующие системные библиотеки и инструменты.

Обязательные зависимости:

Транзитивные зависимости (устанавливаются автоматически):

Рекомендуемые инструменты для разработки и отладки:

1.3. Порядок установки зависимостей в различных ОС

Для дистрибутивов на базе Debian/Ubuntu:

text

sudo apt update

sudo apt install -y g++ cmake make pkg-config libosmocore-dev libosmogsm-dev libtalloc-dev git wireshark valgrind

Для дистрибутивов на базе RHEL/CentOS:

text

sudo yum install -y epel-release

sudo yum install -y gcc-c++ cmake make pkgconfig libosmocore-devel libosmogsm-devel libtalloc-devel git wireshark valgrind

Для дистрибутивов на базе Fedora:

text

sudo dnf install -y gcc-c++ cmake make pkgconfig libosmocore-devel libosmogsm-devel libtalloc-devel git wireshark valgrind

2. Получение дистрибутива ПО

2.1. Вариант 1: получение предварительно скомпилированного исполняемого файла

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

После получения файла необходимо:

text

chmod +x /путь/к/vmsc

text

/путь/к/vmsc --help

2.2. Вариант 2: получение исходного кода из репозитория

Исходный код ПО vMSC хранится в системе контроля версий git. Доступ к репозиторию предоставляется по запросу. Для получения доступа и ссылки на репозиторий необходимо обратиться к [указать контактное лицо или роль, например: "разработчику", "администратору", "куратору проекта", "владельцу репозитория"].

После получения ссылки на репозиторий:

text

git clone <ссылка_на_репозиторий> vmsc

text

cd vmsc

3. Сборка ПО из исходного кода (для варианта 2)

3.1. Подготовка к сборке

Убедиться, что все зависимости установлены (см. раздел 1.2). Проверить наличие необходимых библиотек:

text

pkg-config --modversion libosmocore

pkg-config --modversion libosmogsm

pkg-config --modversion talloc

3.2. Процесс сборки

text

mkdir -p build

cd build

text

cmake ..

text

make -j$(nproc)

Флаг -j$(nproc) запускает параллельную компиляцию на всех доступных ядрах процессора для ускорения сборки.

3.3. Проверка результата сборки

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

text

./vmsc --help

При успешной сборке будет отображена справка по доступным командам и параметрам.

4. Первоначальная настройка

4.1. Структура директорий после установки

Рекомендуется следующая структура директорий для размещения ПО и конфигурационных файлов:

text

/opt/vmsc/

├── bin/

│   └── vmsc                 # Исполняемый файл

├── conf/

│   ├── vmsc.conf             # Основная конфигурация

│   ├── vmsc_interfaces.conf  # Конфигурация интерфейсов

│   ├── vmsc_vlr.conf         # Будет создана автоматически

│   └── vmsc_cic.conf         # Будет создана автоматически

├── scripts/

│   └── run_vmsc.sh           # Скрипт запуска

└── traces/                   # Директория для PCAP-файлов (при необходимости)

4.2. Размещение конфигурационных файлов

Конфигурационные файлы поставляются вместе с исходным кодом или могут быть предоставлены отдельно. Их необходимо скопировать в директорию conf/ и отредактировать в соответствии с требованиями тестовой среды.

Пример копирования (если используется сборка из исходного кода):

text

cp ../*.conf /opt/vmsc/conf/

cp ../run_vmsc.sh /opt/vmsc/scripts/

chmod +x /opt/vmsc/scripts/run_vmsc.sh

4.3. Настройка переменных окружения (опционально)

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

text

export PATH=/opt/vmsc/bin:$PATH

Для постоянного добавления следует внести соответствующую строку в файл ~/.bashrc или ~/.profile.

5. Проверка установки

5.1. Проверка версии и доступных команд

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

text

/opt/vmsc/bin/vmsc --help

5.2. Проверка загрузки конфигурации

Выполнить команду для просмотра текущей конфигурации:

text

/opt/vmsc/bin/vmsc --show-interfaces

При корректной настройке будет отображена конфигурация интерфейсов из файла vmsc_interfaces.conf.

5.3. Пробная отправка сообщения (опционально)

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

text

/opt/vmsc/bin/vmsc --send-udp --use-m3ua --show-encapsulation

6. Устранение возможных проблем при установке