Оглавление

Upgrade Options

Using a single server for the SSD does not provide redundancy. Therefore, upgrading to a new version without interrupting traffic is not possible.
There are two ways to upgrade.

The first option is to stop traffic and update PostgreSQL and all ecss packages on the working SSD, then activate the service and start traffic. The advantage of this option is a simple upgrade process. The disadvantage is a longer traffic interruption.

The second option is to perform a complete fresh installation of the OS on a separate host (physical or virtual), and then install the SSD using temporary IP addresses. During the installation, you will also need to copy the databases (Mnesia + PostgreSQL) from the old host to the new one. Once the new SSD is installed, the temporary IP addresses are replaced with those of the old SSD (at this point, the old SSD is disabled) and the MSR files are configured. After this, the new SSD begins serving traffic. The advantage of this option is minimal traffic interruption. The disadvantage is a more complex and time-consuming update procedure.

Select the appropriate option.

Подсказка

ECSS-10 version 3.17 supports two licensing types: file-based licenses (with or without a token) and ELM licenses. Depending on the licensing type, different commands will be executed during the update.

You can check which type is used on your SWS using the following command:

Блок кода

title	in CoCon

/cluster/storage/ds1/licence/list-licence

When using a file license, the output will be:

Блок кода

title	file license

/cluster/storage/ds1/licence/list-licence
┌──┬───────────────────┬────────────┬──────┬───────────────────┬────────────────────┬────────────┐
│Id│Creation date(UTC) │   SSW ID   │Active│    Description    │Expiration date(UTC)│ Time left  │
├──┼───────────────────┼────────────┼──────┼───────────────────┼────────────────────┼────────────┤
│1 │31.10.2025 14:16:00│ECSS 010070 │*     │Eltex SC softswitc │31.12.2026 23:59:59 │224d 21h 31m│
│0 │                   │ECSS DEFAULT│      │Default licence    │                    │            │
└──┴───────────────────┴────────────┴──────┴───────────────────┴────────────────────┴────────────┘

When using an ELM license, the output will be:

Блок кода

title	ELM лицензия

/cluster/storage/ds1/licence/list-licence                  
┌──┬───────────────────┬────────────┬──────┬────────────────┬────────────────────┬────────────┐
│Id│Creation date(UTC) │   SSW ID   │Active│  Description   │Expiration date(UTC)│ Time left  │
├──┼───────────────────┼────────────┼──────┼────────────────┼────────────────────┼────────────┤
│1 │02.12.2025 13:51:39│ECSS2000000 │*     │ECSS ELM License│02.12.2026 13:51:39 │364d 11h 47m│
│0 │01.01.1990 00:00:00│ECSS DEFAULT│      │Default licence │                    │            │
└──┴───────────────────┴────────────┴──────┴────────────────┴────────────────────┴────────────┘

Предупреждение

title	Внимание

Before performing the update procedure, perform a full backup.

If you need the latest billing data, you need to finalize the current CDR and download the CDR files to a remote server:

Без форматирования
/domain/test_domain/cdr/make_finalize_cdr Created file(s): cdr_20260522_11_51_16_1_c.csv

Якорь
Первый вариант
Первый вариант
First option

Предупреждение
title Внимание
Perform a full backup

You need to mask all nodes on the server and disable node autostart:

Блок кода

title	на ecss1

sudo systemctl mask --now ecss-ds ecss-mycelium ecss-mediator ecss-core ecss-pa-sip ecss-sorm

Информация

When the attached command is executed, a notification will be displayed.

Без форматирования

Warning: The unit file, source configuration file or drop-ins of ecss-ds.service changed on disk. Run 'systemctl daemon-reload' to reload units.
Warning: The unit file, source configuration file or drop-ins of ecss-mycelium.service changed on disk. Run 'systemctl daemon-reload' to reload units.
Warning: The unit file, source configuration file or drop-ins of ecss-mediator.service changed on disk. Run 'systemctl daemon-reload' to reload units.
Warning: The unit file, source configuration file or drop-ins of ecss-core.service changed on disk. Run 'systemctl daemon-reload' to reload units.
Warning: The unit file, source configuration file or drop-ins of ecss-pa-sip.service changed on disk. Run 'systemctl daemon-reload' to reload units.

These messages are not errors. Continue with the procedure.

Update the ssw repository:

Блок кода

title	на ecss1

sudo sh -c "echo deb [arch=amd64]  http://archive.eltex.org/ssw/jammy/3.18 stable main extras external > /etc/apt/sources.list.d/eltex-ecss10-stable.list"

Perform package update:

Блок кода

title	на ecss1

sudo apt update

Примечание

If you see this system message:

Без форматирования
W: http://archive.eltex.org/ssw/jammy/3.18/dists/unstable/InRelease: Key is stored in legacy trusted.gpg keyring (/etc/apt/trusted.gpg), see the DEPRECATION section in apt-key(8) for details.

Run the following command:

Блок кода

title	на обоих хостах

sudo cp /etc/apt/trusted.gpg /etc/apt/trusted.gpg.d

Updating PostgreSQL:

Turn off the Docker container:

Блок кода

title	на ecss2

sudo docker compose -f /srv/ecss/ecss-postgres-bdr-ssw/docker-compose.container.yml down

Без форматирования

title	Пример:

sudo docker compose -f /srv/ecss/ecss-postgres-bdr-ssw/docker-compose.container.yml down
[+] down 2/2
 ✔ Container ecss-postgres-bdr-ssw-postgres-container-1 Removed                                                                                                                           
 ✔ Network ecss-postgres-bdr-ssw_default                Removed

Remove the old deb package, since the upgrade option is not supported:

Блок кода

title	на ecss2

sudo apt remove ecss-postgres-bdr-ssw

Предупреждение

title	!!Важно!!

Run remove, not purge, because remove preserves the volumes directory with our database tables.

Без форматирования

title	Пример:

sudo apt remove ecss-postgres-bdr-ssw
Reading package lists... Done
. . .
The following packages will be REMOVED:
  ecss-postgres-bdr-ssw
. . .
Do you want to continue? [Д/н] y
Deleting ecss-postgres-bdr-ssw (17.1.0.59+ssw) …

Установить новый deb-пакет:

Блок кода

title	на ecss2

sudo apt install ecss-postgres-bdr-ssw

Предупреждение

title	!!IMPORTANT!!

During installation, you will be asked the same questions as during the initial installation:

The answers must exactly match those specified in the procedure, otherwise an attempt will be made to create a new database and the installation will fail.

Информация

Question

Reply

Example

The current IP address of the network interface.

10.0.10.41 (select)

Image Added

Install on a cluster?

Select <Yes> if the package is installed on a cluster node.

No (select)

Image Added

Блок кода

title	If the installation is successful, at the stage of raising replication we will see:

sudo apt install ecss-postgres-bdr-ssw
. . .
==================
 Create databases 
==================
Database ecss_storekeeper_db already exists, skipping...
Database web_conf already exists, skipping...
Extension btree_gist already exists, skipping...
Extension bdr already exists, skipping...

===================================
 Creating Postgres Exporter Schema 
===================================
Node IP: localhost
psql:/srv/ecss/ecss-postgres-bdr-ssw/schema.sql:1: NOTICE:  schema "postgres_exporter" already exists, skipping
CREATE SCHEMA
GRANT
CREATE FUNCTION
CREATE VIEW
GRANT
CREATE FUNCTION
CREATE VIEW
GRANT
psql:/srv/ecss/ecss-postgres-bdr-ssw/schema.sql:28: NOTICE:  extension "pg_stat_statements" already exists, skipping
CREATE EXTENSION
CREATE FUNCTION
CREATE VIEW
GRANT
. . .
=======================================================
=======================================================
 ecss-postgres-bdr-ssw successfully installed/updated! 
=======================================================
=======================================================


┏┓┏┓┏┓┏┳┓┏┓┳┓┏┓┏┓  ┳┓┳┓┳┓  ┏┓┏┓┓ ┏
┃┃┃┃┗┓ ┃ ┃┓┣┫┣ ┗┓  ┣┫┃┃┣┫  ┗┓┗┓┃┃┃
┣┛┗┛┗┛ ┻ ┗┛┛┗┗┛┗┛  ┻┛┻┛┛┗  ┗┛┗┛┗┻┛

After installation, check that the new image has been pulled in and Docker has started by running the command:

Блок кода

title	на ecss2

sudo docker ps

Блок кода

title	example:

sudo docker ps
CONTAINER ID   IMAGE                                           COMMAND                  CREATED              STATUS              PORTS                                         NAMES
bf73743d3e09   git.eltex.loc:4567/ecss/ecss-postgresbdr:3.18   "/docker-entrypoint.…"   About a minute ago   Up About a minute   0.0.0.0:5439->5432/tcp, [::]:5439->5432/tcp   ecss-postgres-bdr-ssw-postgres-container-1

Updating the ecss-dns-env package:
Блок кода
title на ecss1
sudo apt install ecss-dns-env
After the update, you need to update the configuration by running the command. The answers to the questions are similar to the installation procedure:
Блок кода
title на ecss1
sudo dpkg-reconfigure ecss-dns-env
Update the ecss-user package:
Подсказка
When updating, you need to apply new configuration files (confirm with -Y).
Блок кода
title на ecss1
sudo apt install ecss-user
Update the ecss-utils package:
Блок кода
title на ecss1
sudo apt install ecss-utils

Раскрыть

title	В случае использования ELM лицензирования

Установить пакет License Provider:

Блок кода

title	на ecss2

sudo apt install ecss-license-provider

При установке пакета ecss-license-provider будут заданы вопросы:

Вопросы

Ответы

Примеры

Адрес для соединения с License Provider:
License Provider listen ip:

0.0.0.0 (значение по умолчанию)

Image Added

Порт для соединения c License Provider:
License Provider listen port:

4321 (значение по умолчанию)

Image Added

Выберите уровень логирования:
Log level:

info (значение по умолчанию),
возможные варианты: debug, error, info

Image Added

Ключ-имя кластера резервирования:
License Provider cluster key:

указать уникальное имя
ecss-lm-cluster (значение по умолчанию)

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

Image Added

Какие службы должны быть перезапущены?

ecss-license-provider.service (значение по умолчанию)

Image Added

Данные сохраняются в файле /etc/ecss/ecss-license-provider/config.env:

Без форматирования
ECSS_LM_HOST=0.0.0.0 ECSS_LM_PORT=4321 ECSS_LM_LOG_LEVEL=info RELEASE_COOKIE=ecss-abf-lm-cluster

Конфигурация License Provider (LP)

Сервис ecss-license-provider использует два конфигурационных файла: /etc/ecss/ecss-license-provider/config.env и /etc/ecss/ecss-license-provider/config.yaml.

В файл config.env информация сохраняется в момент установки пакета ecss-license-provider.

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

Блок кода

title	информация в файле после установки

elm_addresses: []
licenses: []
ecss_nodes: []

Для заполнения данных полей откройте файл конфигурации ecss-elm-adapter используемого в версии 3.17 /etc/ecss/ecss-elm-adapter/config.env:

Блок кода

title	на ecss2

сat /etc/ecss/ecss-elm-adapter/config.env 
ELM_HOST=elm.eltex-co.ru
ELM_PORT=8099
ECSS_PRODUCT_ID=ECSS2000000
ECSS_LICENSE_KEY=ssw987654
LOG_LEVEL=info
LICENCE_FAIL_TIMER_SECONDS=10
LICENCE_PULL_TIMER_SECONDS=360

В поле elm_adresses нужно прописать список серверов ELM, к которым мы хотим подключаться для получения лицензий. Первый адрес в списке используется как основной. Дополнительные строки с адресами работают как резерв.
пример:
- "elm.eltex-co.ru:8099"
- "192.168.111.22:8099"
- "elm-3.eltex.loc:8099"

Дальше задаются сами лицензии в поле licenses.

id может быть любой, главное чтоб был уникальный у каждой лицензии. Влияет только на адрес лицензии на самом License Provider (например 0, 1, 2, 3).
kind. Для SSW поддерживается только SSW (заглавными буквами).
type выбирается как elm, если запрашивать данную лицензию нужно с ELM-сервера. Если нужно использовать файловую лицензию SSW, то тип выбирается как ecss_license.
- при elm типе необходимо задать поля license_key и product_id для идентификации лицензии.
- при ecss_license типе задается поле license, содержащее ключ статичной лицензии.

Примечание
Параметры license_key = ECSS_LICENSE_KEY и product_id = ECSS_PRODUCT_ID должны быть согласованы с данными, ранее загруженными на ELM-сервере.

Блок ecss_nodes.

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

id - идентификатор сервиса. В случае с SSW должен совпадать с ECSS_ID лицензируемого SSW.
kind - тип лицензируемого сервиса. По аналогии с блоком лицензий, поддерживаются типы SSW и AUP. Для SSW поддерживается только SSW.
license_id - идентификатор лицензии, которая будет отправляться на данный сервис. Соответствует идентификаторам лицензии из блока licenses.

Примечание

Два SSW с разными ECSS_ID не могут получить одну и ту же лицензию, конфигурация с таким распределением будет помечена некорректной.
Кроме того, два SSW с одинаковыми ECSS_ID не смогут одновременно получать одну и ту же лицензию с одного License Provider, поэтому крайне важно корректно устанавливать свой ECSS_ID и делать его уникальным как минимум в зоне видимости используемого License Provider.

Подсказка

Формат ECSS_ID:
Начинается и заканчивается обязательно латинской буквой или цифрой, в теле же могут использоваться точки и тире.

Без форматирования
[A-Za-z0-9][A-Za-z0-9.-][A-Za-z0-9]

Блок кода

title	Пример: файла config.yaml на основе данных из файла /etc/ecss/ecss-elm-adapter/config.env

elm_addresses:
 - "elm.eltex-co.ru:8099"
licenses:
 - id: 0
   kind: SSW
   type: elm
   license_key: "ssw987654"
   product_id: "ECSS2000000"
ecss_nodes:
 - id: eltex1.test
   kind: ssw
   license_id: 0

Выполнить перезагрузку сервиса ecss-license-provider.service для обновления конфигурации из файла /etc/ecss/ecss-license-provider/config.yaml следующей командой:

Блок кода

title	если кластер, то на обоих хостах

sudo systemctl restart ecss-license-provider.service

Выполните обновление пакета ecss-node:

Блок кода

title	на ecss1

sudo apt install ecss-node

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

Вопросы ecss-node

Ответы для ecss1

Пример

Cookie для ноды core:

ecss-core (значение по умолчанию)

Подсказка
Рекомендуется заменить на уникальное значение

Image Added

Cookie для ноды ds:

ecss-ds (значение по умолчанию)

Подсказка
Рекомендуется заменить на уникальное значение

Image Added

Cookie для ноды mediator:

ecss-mediator (значение по умолчанию)

Подсказка
Рекомендуется заменить на уникальное значение

Image Added

Cookie для ноды pa-sip:

ecss-pa-sip (значение по умолчанию)

Подсказка
Рекомендуется заменить на уникальное значение

Image Added

Cookie для ноды mycelium:

ecss-mycelium (значение по умолчанию)

Подсказка
Рекомендуется заменить на уникальное значение

Image Added

Cookie для ноды sorm:

ecss-sorm (значение по умолчанию)

Подсказка
Рекомендуется заменить на уникальное значение

Image Added

Использовать текущую версию файла настройки?

No (значение по умолчанию)

Image Added

Подсказка
При обновлении нужно применить новые конфигурационные файлы (подтверждением -Y).

Включите ноды.
Включить сервисы ssw следующими командами:

Блок кода

title	на ecss1

sudo systemctl unmask ecss-ds ecss-mycelium ecss-mediator ecss-core ecss-pa-sip ecss-sorm

Блок кода

title	на ecss1

sudo systemctl enable ecss-ds ecss-mycelium ecss-mediator ecss-core ecss-pa-sip ecss-sorm

Запуск SSW на ecss1. Запустите следующие сервисы:
ecss-mycelium

Блок кода

title	на ecss1

sudo systemctl start ecss-mycelium

ecss-ds

Блок кода

title	на ecss1

sudo systemctl start ecss-ds

ecss-core

Блок кода

title	на ecss1

sudo systemctl start ecss-core

ecss-mediator

Блок кода

title	на ecss1

sudo systemctl start ecss-mediator

Подсказка

Если лицензия поддерживает СОРМ3, то запустить также сервис ecss-sorm.

Блок кода

title	на ecss1

sudo systemctl start ecss-sorm

Предупреждение
Пока не следует запускать PA-SIP!

Проверьте статус сервисов, для этого выполните в CoCon команду system-status:

Без форматирования

title	выполняется в CoCon

/system-status 
Checking...
┌─┬───────────────┬────────────────────────┬───────────────┬────────────┬──────┐
│ │     Node      │        Release         │ Erlang nodes  │Mnesia nodes│Uptime│
├─┼───────────────┼────────────────────────┼───────────────┼────────────┼──────┤
│ │core1@ecss1    │ecss-core-3.18.0.271    │core1@ecss1    │not running │14m 4s│
│ │ds1@ecss1      │ecss-ds-3.18.0.271      │ds1@ecss1      │ds1@ecss1   │14m 4s│
│ │md1@ecss1      │ecss-mediator-3.18.0.271│md1@ecss1      │md1@ecss1   │14m 4s│
│ │mycelium1@ecss1│ecss-mycelium-3.18.0.271│mycelium1@ecss1│not running │14m 4s│
│ │sorm1@ecss1    │ecss-sorm-3.18.0.271    │sorm1@ecss1    │not running │14m 5s│
└─┴───────────────┴────────────────────────┴───────────────┴────────────┴──────┘

All services are started.

  Active media resource selected list specific:
┌─────────────┬───────────┬────────────┬───────────┬───────────┐
│    Node     │    MSR    │    MSR     │ Cc-status │ Cc-uptime │
│             │           │  version   │           │           │
├─────────────┼───────────┼────────────┼───────────┼───────────┤
│ core1@ecss1 │ msr.ecss1 │ 3.17.1.1.7 │ connected │ 00:43:03  │
└─────────────┴───────────┴────────────┴───────────┴───────────┘

Режимы лицензирования.

Раскрыть

title	В случае использования файлового лицензирования

Информация

title	В случае использования файлового лицензирования

Никаких дополнительных действий выполнять не требуется.

Без форматирования

/cluster/storage/ds1/licence/list-licence
┌──┬───────────────────┬────────────────┬──────┬────────────────────────────────────────────┬────────────────────┬────────────┐
│Id│Creation date(UTC) │     SSW ID     │Active│                Description                 │Expiration date(UTC)│ Time left  │
├──┼───────────────────┼────────────────┼──────┼────────────────────────────────────────────┼────────────────────┼────────────┤
│1 │31.10.2025 14:16:00│ECSS 010070     │*     │Eltex SC softswitch                         │31.12.2026 23:59:59 │224d 21h 31m│
│0 │                   │ECSS DEFAULT    │      │Default licence                             │                    │            │
└──┴───────────────────┴────────────────┴──────┴────────────────────────────────────────────┴────────────────────┴────────────┘

Раскрыть

title	В случае использования ELM лицензирования

Выполнить конфигурацию подключения SSW к License Provider следующей командой в CoCon, (в примере License Provider установлен на хосте ecss1, IPadd хостов 10.0.10.41. Значение порта из файла /etc/ecss/ecss-license-provider/config.env по умолчанию 4321):

Блок кода

title	выполняется в CoCon

/system/licence/manager/set --hosts [https://10.0.10.41:4321]

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

Блок кода

title	выполняется в CoCon

/system/licence/manager/show-status
┌───────────────────────┬───────┬─────┐
│         Host          │Current│Alive│
├───────────────────────┼───────┼─────┤
│https://10.0.10.41:4321│*      │true │
└───────────────────────┴───────┴─────┘

Хост должен иметь статус alive=true. И быть «current».

Current - отображает к какому хосту подключён SSW. Если есть подключение, указывается *, если нет - ничего не указано.
Alive - отображает статус доступности хоста (healthcheck).

Информация

title	Подключение к License Manager

Отсутствие подключения к License Provider \ ELM будет равноценно отсутствию доступа к токену, что приведёт к критическим авариям, переходу в аварийный режим по истечении которого, если связь не будет восстановлена, система перейдёт на Default-лицензию.

Данное поведение применимо только при работе в elm-режиме.

Если статус к одному из хостов License Provider показан current, можно посылать запрос на загрузку лицензии на SSW командой:

Блок кода

title	выполняется в CoCon

/cluster/storage/ds1/licence/request

Блок кода

title	type=elm

/cluster/storage/ds1/licence/request      
Licence received      
[*******                                                               ] 6s 2ms   
Success: Licence parameters applied

Блок кода

title	type=elm

/cluster/storage/ds1/licence/list-licence 
┌──┬───────────────────┬────────────┬──────┬────────────────┬────────────────────┬────────────────────┬─────────┐
│Id│Creation date(UTC) │   SSW ID   │Active│  Description   │Comm. Exp. Date(UTC)│Expiration date(UTC)│Time left│
├──┼───────────────────┼────────────┼──────┼────────────────┼────────────────────┼────────────────────┼─────────┤
│1 │14.04.2026 11:18:34│ECSS2000000 │*     │ECSS ELM License│09.04.2027 16:26:34 │06.06.2026 10:49:12 │1d 6h 59m│
│0 │01.01.1990 00:00:00│ECSS DEFAULT│      │Default licence │                    │                    │         │
└──┴───────────────────┴────────────┴──────┴────────────────┴────────────────────┴────────────────────┴─────────┘

Обновление пакета ecss-restfs.
Подсказка
Принять все новые конфигурационные файлы, выбирая Y.
Блок кода
title на ecss1
sudo apt install ecss-restfs

Обновление пакета ecss-media-server.

Предупреждение

Media Server анализирует конфигурацию в файлах находящихся в директории /etc/ecss/ecss-media-server/. В версии 3.17 реализована новая функция контроля приоритетности кодеков. Если по какой то причине в нескольких файлах присутствует секция "codec", в которой несколько раз прописывается один и тот же кодек, то после обновления возникнет конфликт, и Media Server работать не будет.

Поэтому в конфигурационных файлах одного Media Server не должно быть конфликтов по приоритетам кодеков (запись об одном кодеке должна быть одна и не повторяться в других файлах). Решение, на какие именно фалы требуется сконфигурировать, остается на усмотрение администратора системы.

Выполните обновление:

Подсказка
Принять все новые конфигурационные файлы, выбирая Y.

Блок кода

title	на ecss1

sudo apt install ecss-media-server

Актуализируйте конфигурацию:

Блок кода

title	на ecss1

sudo dpkg-reconfigure ecss-media-server

Обновление пакета ecss-media-resources:
Блок кода
title на ecss1
sudo apt install ecss-media-resources
Обновление пакета ecss-web-conf
Блок кода
title на ecss1
sudo apt install ecss-web-conf

Раскрыть

title	Обновление пакетов опциональных сервисов

Обновление пакета ecss-teleconference-ui

Блок кода

title	на ecss1

sudo apt install ecss-teleconference-ui

Обновление пакета ecss-crm-server

Блок кода

title	на ecss1

sudo apt install ecss-crm-server

Обновление пакета ecss-cc-ui

Блок кода

title	на ecss1

sudo apt install ecss-cc-ui

Обновление пакета ecss-call-api

Блок кода

title	на ecss1

sudo apt install ecss-call-api

Обновление пакета ecss-peeper-client

Блок кода

title	на ecss1

sudo apt install ecss-peeper-client

Запустите ecss-pa-sip :

Блок кода

title	на ecss1

sudo systemctl start ecss-pa-sip

Проверьте статус сервисов командой /system-status :

Блок кода

title	выполняется в CoCon

/system-status 
Checking...
┌─┬───────────────┬────────────────────────┬───────────────┬────────────┬───────┐
│ │     Node      │        Release         │ Erlang nodes  │Mnesia nodes│Uptime │
├─┼───────────────┼────────────────────────┼───────────────┼────────────┼───────┤
│ │core1@ecss1    │ecss-core-3.18.0.271    │core1@ecss1    │not running │54m 27s│
│ │ds1@ecss1      │ecss-ds-3.18.0.271      │ds1@ecss1      │ds1@ecss1   │54m 27s│
│ │md1@ecss1      │ecss-mediator-3.18.0.271│md1@ecss1      │md1@ecss1   │54m 27s│
│ │mycelium1@ecss1│ecss-mycelium-3.18.0.271│mycelium1@ecss1│not running │54m 27s│
│ │sip1@ecss1     │ecss-pa-sip-3.18.0.271  │sip1@ecss1     │sip1@ecss1  │54m 27s│
│ │sorm1@ecss1    │ecss-sorm-3.18.0.271    │sorm1@ecss1    │not running │54m 27s│
└─┴───────────────┴────────────────────────┴───────────────┴────────────┴───────┘

All services are started.

  Active media resource selected list specific:
┌─────────────┬───────────┬──────────┬───────────┬───────────┐
│    Node     │    MSR    │   MSR    │ Cc-status │ Cc-uptime │
│             │           │ version  │           │           │
├─────────────┼───────────┼──────────┼───────────┼───────────┤
│ core1@ecss1 │ msr.ecss1 │ 3.18.0.7 │ connected │ 00:01:17  │
└─────────────┴───────────┴──────────┴───────────┴───────────┘

Выполните проверку переезда активных регистраций на обновленный хост. Для этого выполните контроль зарегистрированных абонентов на SSW. Выполните команду в CoCon:

Блок кода

title	выполняется в CoCon

/domain/test_domain/sip/user/registered sip *            
450 make users list ...
[**********************************************************************] 28mks    
450 users information read ...
[**********************************************************************] 1ms      
Executed on the sip1@ecss1
┌───────────────┐
│ elements: 436 │
└───────────────┘

После выполнения обновления проверьте работу всех сервисов SSW.

Якорь
Второй вариант
Второй вариант
Второй вариант

Исходные данные
На момент установки использовать временные IP адреса (в примере 10.0.10.51/10.0.20.51). На последних шагах временные адреса будут заменены на реальные IP адреса SSW версии 3.17 (в примере 10.0.10.41/10.0.20.41).

Раскрыть

title	Информация

Информация

icon	false

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

Требуется интеграция программного коммутатора 5 класса ECSS-10 (SSW) на 1 физическом сервере с поддержкой SIP со следующими параметрами на нагрузку:

Максимальное количество абонентов – 15000 (MUL — Max user limit);
Максимальное количество одновременных соединений — 2000 (MCL — Max call limit);
Резервирование системы не требуется;
Количество сетевых интерфейсов ethernet — 4.

По техническому заданию требуется определить аппаратную платформу.

Include A Shared Block

shared-block-key	hw_ssw
page	Руководство по инсталляции и начальному конфигурированию

Include A Shared Block

shared-block-key	vm_ssw
page	Руководство по инсталляции и начальному конфигурированию

Раскрыть

title	Пример составления аппаратных требований:

Устройство	Требуемый ресурс		Серия аппаратного продукта
Устройство	MCL	MUL	Серия аппаратного продукта
Сервер 1	2500	15000	Heavy

После определения по требованиям проекта составляем предварительную сетевую карту.

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

Имя сервера (хоста)	Роль	Интерфейс	Адрес	Порт
Статические адреса программного коммутатора
ecss1	Адрес сервера	net.10 (mgm)	10.0.10.51/24	-
ecss1	Адрес протокольного адаптера	net.20 (voip)	10.0.20.51/24	-
ecss1	Адрес шлюза	net.10 (mgm)	10.0.10.1	-
ecss1	Адреса DNS-серверов	net.10 (mgm)	10.0.10.1, 8.8.8.8	-
Внутренние адреса программного коммутатора
ecss1	Адрес ядра (ecss-core)	lo	127.0.0.1/24	5000
ecss1	Адрес медиасервера (ecss-media-server (MSR))	lo	127.0.0.1/24	5040

Включение в сеть

Топологию включения сервера в сеть для обеспечения резервирования рекомендуется делать с использованием 2-х коммутаторов.

draw.io Diagram

border	true

diagramName	сеть
simpleViewer	false
width	600
links	auto
tbstyle	top
lbox	true
diagramWidth	1966
revision	1

Рисунок 1 — Схема организации связи

Вариант 1. Схема active-backup

Коммутаторы связаны между собой в erps-кольцо.

Все 4 физических сетевых интерфейса объединяются в 1 агрегированный линк (bond). Агрегация портов сервера настраивается в режиме active-backup, т.е. в работе всегда находится только 1 сетевой интерфейс. Сетевые интерфейсы сервера попарно включены в коммутаторы, на которых агрегация портов (port-channel) также настраивается в режиме active-backup.

Например, eth1 и eth2 включаются в первый коммутатор, а eth3 и eth4 — во второй.

Вариант 2. Схема LACP

Коммутаторы связаны между собой в стек. Стек должен логически работать как один коммутатор, способный обеспечивать агрегацию портов в режиме LACP между разными физическими коммутаторами. Пример — коммутаторы MES3124 со специализированной прошивкой.

Все 4 физических сетевых интерфейса также объединяются в 1 агрегированный линк (bond). Агрегация портов сервера настраивается в режиме 802.3ad. Создаются агрегированные группы сетевых карт с одинаковой скоростью и дуплексом. При таком объединении передача задействует все каналы в активной агрегации согласно стандарту IEEE 802.3ad. Выбор, через какой интерфейс отправлять пакет, определяется политикой. По умолчанию это XOR-политика, можно использовать «xmit_hash» политику. Подробнее в разделе Приложение Е. Netplan.

Требования:

Поддержка Ethtool в драйвере для получения информации о скорости и дуплексе на каждом сетевом интерфейсе;
Поддержка на коммутаторе стандарта IEEE 802.3ad;

Сетевые интерфейсы сервера также попарно включены в коммутаторы, на которых агрегация портов (port-channel) настраивается в режиме LACP. Например, eth1 и eth2 включаются в первый коммутатор (port-channel 1), а eth3 и eth4 — во второй (port-channel 2).

Установка ОС

Раскрыть

title	Подготовительный этап

Установка SSW ECSS10 состоит из 2-х основных частей :

Подготовительной - Установка ОС Ubuntu 22.04, обновлений пакетов OC Ubuntu , "оптимизация" ОС, установка дополнительных пакетов программ, подготовка сетевых интерфейсов, /etc/hosts, ssh-keygen
Установка приложений Eltex ECSS10

Подготовительный этап

В этом разделе приведено описание инсталляции операционной системы, а также необходимых и дополнительных пакетов. Система ECSS-10 версии 3.17 работает под управлением ОС Ubuntu 22.04.

Предварительные требования

Установочный загрузочный носитель с дистрибутивом операционной системы;
Подготовленный сервер с обновленным BIOS, ILO (если есть), подключенная сеть для доступа в сеть Интернет;
Выставленный первый приоритет загрузки с установочного носителя — USB Flash или CD/DVD в BIOS;
Достаточный объем дискового пространства и памяти в соответствии с проектом.

Якорь

	inst_os
	inst_os

Установка ОС

Для установки ОС необходимо выполнить следующее:

После загрузки с установочного носителя выбрать "Install Ubuntu Server".
Выбрать язык системы и раскладку клавиатуры.
Настроить сетевой интерфейс для подключения к сети Интернет:
Создать партиции на диске в соответствии с таблицей 1
Настроить имена сервера и пользователя
Установить OpenSSH server
Перезагрузить успешно установленную ОС

Раскрыть

title	Установка ОС Ubuntu Server 22.04

Include A Shared Block

shared-block-key	Установка ОС Ubuntu Server 22.04
page	Установка ОС Ubuntu Server 22.04

Якорь

	df
	df

Таблица 1 — Вариант размещения информации в файловой системе на физических носителях для серверов

1	Загрузочный раздел операционной системы (создается автоматически)	boot	raid 1:hdd1,hdd2	boot	/boot	ext4	1 Gb	Первичный
2	Корневой раздел операционной системы	root	raid 1:hdd1,hdd2	root	/	ext4	30 Gb	Логический
3	Информация локальных баз данных	mnesia	raid 1:hdd1, hdd2	mnesia	/var/lib/ecss	ext4	10 Gb	Логический
4	Распределенная БД для хранения медиаресурсов	glusterfs	raid 1:hdd1, hdd2 или hdd3	glusterfs	/var/lib/ecss/restfs	ext4	Max Gb	Логический
5	Журналы функционирования подсистем ОС	log	raid 1:hdd1,hdd2 или hdd3	log	/var/log	ext4	20 Gb	Логический
6	Журналы функционирования подсистем ECSS	ecss_log	raid 1:hdd1,hdd2 или hdd3	ecss_log	/var/log/ecss	ext4	20 Gb	Логический
7	Базы данных	ecss_db	raid 1:hdd1,hdd2 или hdd3	ecss_db	/srv/ecss/ecss-postgres-bdr-ssw/	ext4	100–400 Gb*	Логический
8	Файлы пользователя	home	raid 1:hdd1,hdd2 или hdd3	home	/home	ext4	10 Gb	Логический

Примечание
* Рекомендуемое значение для серий Light, Light+, Midi — 100 Gb. Рекомендуемое значение для серии Heavy — 200 Gb, Super Heavy — 400 Gb.

Для работы системы необходимо как минимум 256 Gb свободного пространства.

На серверах системы необходимо настроить параметр "hostname".

На всех серверах системы желательно указать одинаковое имя пользователя (любое, кроме ssw). Лицензия ECSS-10 привязывается к ключу eToken/ruToken и к имени компьютера (hostname). Системный пользователь ssw создается при инсталляции пакета ecss-user.

Подсказка
Если используется один сервер, рекомендуемое значение hostname — ecss1;

Раскрыть

title	Настройка сети

Настройка сети

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

Рекомендуется разделять трафик, используемый в разных целях. Например, трафик управления и трафик VoIP. Для этого создаются 2 или более vlan. При небольшой нагрузке для простоты можно обойтись и одним vlan, но это будет в будущем доставлять неудобства при снятии дампов трафика и его анализе. В соответствии с техническим заданием на vlan настраиваются IP-адреса самого хоста, шлюзы, DNS и маршрутизация в другие сети.

В данном примере согласно ТЗ будем использовать адреса:

10.0.10.51/24 — для управления, vlan 10;
10.0.20.51/24 — для VoIP.

Внутри серверной платформы существует адресная структура и используются внутренние адреса для взаимодействия между подсистемами (нодами) в кластере. Например, внутренний адрес для кластера на одном сервере 127.0.0.1, при этом ядро (ecss-core) взаимодействует с сервером обработки мультимедиа-данных (ecss-media-server). Их взаимодействие происходит с использованием одного и того же адреса, но у каждой программной части свой транспортный порт: ecss-core — 5000, ecss-msr — 5040.

Для всех нод кластера определяется единый адрес для обращения к базе данных, например адрес 127.0.0.1. Таким образом, выполняется условие единообразия, при котором все ноды кластера имеют полностью одинаковые данные о текущем состоянии динамических составляющих программного коммутатора (например, история вызовов).

Подготовка сетевых интерфейсов системы

Согласно ТЗ, система имеет 4 сетевых интерфейса. Информацию об их состоянии можно посмотреть с помощью команды ifconfig или ip a:

eth0: flags=6211<UP,BROADCAST,RUNNING,SLAVE,MULTICAST> mtu 1500
ether 36:10:28:73:63:01 txqueuelen 1000 (Ethernet)

eth1: flags=6211<UP,BROADCAST,RUNNING,SLAVE,MULTICAST> mtu 1500
ether 36:10:28:73:63:01 txqueuelen 1000 (Ethernet)

eth2: flags=6211<UP,BROADCAST,RUNNING,SLAVE,MULTICAST> mtu 1500
ether be:77:ea:52:4d:39 txqueuelen 1000 (Ethernet)

eth3: flags=6211<UP,BROADCAST,RUNNING,SLAVE,MULTICAST> mtu 1500
ether be:77:ea:52:4d:39 txqueuelen 1000 (Ethernet)

lo: flags=73<UP,LOOPBACK,RUNNING> mtu 65536
inet 127.0.0.1 netmask 255.0.0.0

Сначала настраиваются сетевые интерфейсы. В Ubuntu 22 для их настройки используется утилита netplan.

Данная утилита позволяет настроить сетевую конфигурацию и затем загрузить ее в систему с помощью сетевого менеджера networkd или NetworkManager.

Блок кода

language	bash

sudo nano /etc/netplan/ecss_netplan.yaml

Примечание
Все остальные файлы из этого каталога необходимо переместить в другое место или удалить.

В конфигурациях для каждого хоста в первую очередь мы объявляем секцию ethernets, в которой описываются существующие в системе ethernet-интерфейсы, используемые в дальнейшем. Для каждого интерфейса необходимо отключить использование динамического распределения адресов (DHCP).

Далее настраиваются vlan, на которых опционально определяются шлюзы для связи с внешним миром и адреса DNS-серверов, а также непосредственно IP-адреса для каждого интерфейса.

Предупреждение

title	ВАЖНО

Обратите внимание, что во время редактирования netplan необходимо соблюдать правила разметки YAML:

Обязательное наличие минимум двух пробелов перед каждой строкой (кроме network);
Каждая подсекция дополнительно сдвигается на 2 пробела:

→ Секция |network

→ Подсекция |_'_'bonds:

→ Подсекция описания секции bonds |_'_'_'_'bonded_one:

→ и т.д. |_'_'_'_'...

Перед знаком ":" нет пробела, после — один пробел;
Перед знаком "-" количество пробелов такое, как будто начинается новый подраздел, после — один пробел.

Пример настройки файла ecss_netplan.yaml для варианта включения active-backup

Без форматирования

# Netplan для хоста ecss1 программного коммутатора
# Обратите внимание на обязательное наличие минимум двух пробелов в каждой строке и секции (кроме строки секции network)

network:
  version: 2 # Версия netplan
  renderer: networkd # Исполнитель конфигураций netplan
  ethernets: # Раздел описания интерфейсов ethernet
    enp0s3: # Название интерфейса ВМ к интернет
        dhcp4: no # Отключаем на интерфейсах динамическое распределение IP-адреса
        dhcp6: no
        addresses: [192.168.56.51/24]
    enp0s8: # Название интерфейса для SSW
        dhcp4: no # Отключаем на интерфейсах динамическое распределение IP-адреса
        dhcp6: no
  vlans:
    net.10: # Интерфейс управления
        id: 10
        link: enp0s3
        addresses: [10.0.10.51/24]
    net.20: # Интерфейс для VoIP
        id: 20
        link: enp0s8
        addresses: [10.0.20.51/24]

Следующие настройки bonds обязательны для сервера ECSS, чтобы схема работала верно:

mode: active-backup - задаёт режим работы, когда один из линков выбирается активным, а остальные остаются в резерве;
primary-reselect-policy: failure - указывает, что выбирать новый активный линк следует только тогда, когда текущий активный линк переходит в состоянии аварии. Это позволяет избежать лишних переключений;
gratuitous-arp: 5 - при смене активного линка в сторону коммутатора отправляются пять запросов gratuitous ARP, чтобы обновить на нём таблицу коммутации. Способствует более быстрому переключению;
all-slaves-active: true - заставляет принимать входящие кадры на backup интерфейсах. Таким образом балансировка трафика на MESе не мешает работе. Данные в сторону сервера идут со всех линков, а сервер отправляет данные только с active линка;
mii-monitor-interval: 100 - активирует мониторинг линков через интерфейс MII и указывает интервал опроса в 100мс;
up-delay: 1000 - указывает считать поднявшийся интерфейс доступным для работы не сразу, а сделать задержку в одну секунду после того, как интерфейс поднялся. Необходимо для того, чтобы избежать лишних переключений в случае, когда порт «прыгает» несколько раз из состояния «включено» в состояние «выключено» и обратно.

Предупреждение

language	bash

Также рекомендуется проверить отсутствие в каталоге /etc/netplan/ еще каких либо файлов, если другие файлы присутствуют , то их нужно переместить в другой каталог или удалить, в противном случае возможна некорректная настройка сетевых интерфейсов и некорректная работа SSW.

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

Блок кода

language	bash

sudo netplan apply

На серверах системы необходимо настроить параметр "hostname".

На всех серверах системы желательно указать одинаковое имя пользователя (любое, кроме ssw). Лицензия ECSS-10 привязывается к ключу eToken/ruToken и к имени компьютера (hostname), поэтому необходимо использовать стандартные значения. Системный пользователь ssw создается при инсталляции пакета ecss-user.

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

Указать имя хоста: ecss1 в файле /etc/hostname:

Блок кода
sudo nano /etc/hostname

Указать реальный Ipadd и имя хоста используемое в настоящий момент (для примера 10.0.10.51 ecss1) в файле /etc/hosts:

Блок кода
127.0.0.1 localhost # Адрес локальной петли, используется некоторыми сервисами ecss 10.0.10.51 ecss1 # Адрес хоста

"Оптимизация" операционной системы

Выставить параметры ОС в режим производительности

Используем утилиту cpufrequtils.

Блок кода

language	bash

sudo apt install cpufrequtils

по умолчанию после установки Ubuntu используется режим "ondemand" - "по запросу" (производительность CPU по запросу приложений, экономит электроэнергию, но снижает производительность):

Блок кода
cat /etc/init.d/cpufrequtils \| grep GOVERNOR=

в выходном сообщении системы режим работы по умолчанию после установки - "ondemand" :

Без форматирования
GOVERNOR="ondemand"

Установить режим результативности/производительности - в файле /etc/init.d/cpufrequtils значение "ondemand" заменить на "performance"

Блок кода

language	bash

sudo sed -i 's/GOVERNOR="ondemand"/GOVERNOR="performance"/g' /etc/init.d/cpufrequtils

Перезапустить утилиту:

Блок кода

language	bash

sudo /etc/init.d/cpufrequtils restart

Затем выполнить команду:

Блок кода

language	bash

sudo systemctl daemon-reload

Отключить SWAP

Ubuntu сервер SSW работает в реальном масштабе времени , поэтому все необходимые данные должны находится в оперативной памяти, использование файла подкачки (swap-файл - /swap. img) может привести к увеличению времени обработки вызовов приложения SSW ECSS10 , что недопустимо. Swap - отключаем.
Выполнить последовательно три команды:

Отключение Swap:

Блок кода

language	bash

sudo swapoff -a

Удалить файл swap.img.

Блок кода

language	bash

sudo rm /swap.img

Закомментировать строку - /swap.img none swap sw 0 0 - в файле /etc/fstab - выполнив команду "sudo nano /etc/fstab"

привести её к виду # /swap.img none swap sw 0 0

либо удалить эту строчку (/swap.img none swap sw 0 0)

Блок кода

language	bash

sudo nano /etc/fstab

Для проверки выполните команду free -h:

Блок кода

language	bash

free -h

Размер Swap равен 0 — значит, он выключен

Без форматирования

language	bash

free -h
              total        used        free      shared  buff/cache   available
Mem:           3,9G        110M        3,2G        820K        535M        3,5G
Swap:            0B          0B          0B

Установка часового пояса

При инсталляции Ubuntu-22 не предлагается установить часовой пояс (по умолчанию — UTC). Его нужно установить вручную (для корректной работы системы тарификации, работ по расписанию и т. д.), например:

Блок кода

language	bash

sudo timedatectl set-timezone Asia/Novosibirsk

Улучшение работы высоконагруженных серверов

Улучшить работу высоконагруженных серверов можно увеличив лимит открытых файлов.

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

Проверить текущий лимит командой:

Блок кода
ulimit -a

результат :

Без форматирования

eltex@ecss1:~$ ulimit -a
core file size          (blocks, -c) 0
data seg size           (kbytes, -d) unlimited
scheduling priority             (-e) 0
file size               (blocks, -f) unlimited
pending signals                 (-i) 15515
max locked memory       (kbytes, -l) 65536
max memory size         (kbytes, -m) unlimited
open files                      (-n) 1024
pipe size            (512 bytes, -p) 8
POSIX message queues     (bytes, -q) 819200
real-time priority              (-r) 0
stack size              (kbytes, -s) 8192
cpu time               (seconds, -t) unlimited
max user processes              (-u) 15515
virtual memory          (kbytes, -v) unlimited
file locks                      (-x) unlimited

Данного лимита (open files 1024 ) недостаточно для нормальной работы высоконагруженных серверов.

Установить лимит открытых файлов для каждого пользователя:

Блок кода
sudo sed -i '55i\* soft nproc 65536\n* hard nproc 131072\n* soft nofile 65536\n* hard nofile 131072\nroot - memlock unlimited' /etc/security/limits.conf

Раскрыть

title	Результат:

# /etc/security/limits.conf
#
#Each line describes a limit for a user in the form:
#
#<domain> <type> <item> <value>
#
#Where:
#<domain> can be:
# - a user name
# - a group name, with @group syntax
# - the wildcard *, for default entry
# - the wildcard %, can be also used with %group syntax,
# for maxlogin limit
# - NOTE: group and wildcard limits are not applied to root.
# To apply a limit to the root user, <domain> must be
# the literal username root.
#
#<type> can have the two values:
# - "soft" for enforcing the soft limits
# - "hard" for enforcing hard limits
#
#<item> can be one of the following:
# - core - limits the core file size (KB)
# - data - max data size (KB)
# - fsize - maximum filesize (KB)
# - memlock - max locked-in-memory address space (KB)
# - nofile - max number of open files
# - rss - max resident set size (KB)
# - stack - max stack size (KB)
# - cpu - max CPU time (MIN)
# - nproc - max number of processes
# - as - address space limit (KB)
# - maxlogins - max number of logins for this user
# - maxsyslogins - max number of logins on the system
# - priority - the priority to run user process with
# - locks - max number of file locks the user can hold
# - sigpending - max number of pending signals
# - msgqueue - max memory used by POSIX message queues (bytes)
# - nice - max nice priority allowed to raise to values: [-20, 19]
# - rtprio - max realtime priority
# - chroot - change root to directory (Debian-specific)
#
#<domain> <type> <item> <value>
#

#* soft core 0
#root hard core 100000
#* hard rss 10000
#@student hard nproc 20
#@faculty soft nproc 20
#@faculty hard nproc 50
#ftp hard nproc 0
#ftp - chroot /ftp
#@student - maxlogins 4
* soft nproc 65536
* hard nproc 131072
* soft nofile 65536
* hard nofile 131072
root - memlock unlimited

# End of file

Предупреждение

title	ВАЖНО

Установку пакетов требуется делать НЕ из-под пользователя ssw.

Обновление программного обеспечения операционной системы

Для установки системы ECSS-10 необходимо добавить репозиторий ELTEX:

Блок кода

language	bash
title	на новом ssw

sudo sh -c "echo 'deb [arch=amd64] http://archive.eltex.org/ssw/jammy/3.18 stable main extras external' > /etc/apt/sources.list.d/eltex-ecss10-stable.list"

Далее необходимо выполнить импорт ключа командой:

Блок кода

language	bash
title	на новом ssw

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 33CB2B750F8BB6A5

Перед началом установки необходимо обновить ОС:

Блок кода

language	bash
title	на новом ssw

sudo apt update

Примечание

Если вы видите такое сообщение системы:

Без форматирования
W: http://archive.eltex.org/ssw/jammy/3.18/dists/stable/InRelease: Key is stored in legacy trusted.gpg keyring (/etc/apt/trusted.gpg), see the DEPRECATION section in apt-key(8) for details.

Выполните следующую команду:

Блок кода

title	на новом ssw

sudo cp /etc/apt/trusted.gpg /etc/apt/trusted.gpg.d

Блок кода

language	bash
title	на новом ssw

sudo apt upgrade

Установка и настройка программного обеспечения

Предупреждение

title	установка пакетов deb

  ┌ версия ПО ECSS. Сейчас в заявке на сертификацию она заявлена как 3.

  | Мы её менять не будем до следующей сертификации или
  │ выпуска принципиально новой версии системы.
  │
  │     ┌ версия System Release. Общая версия для всех компонент входящих в конкретный релиз.

  |     | Меняем её централизовано, когда
  │     │ принимаем решение о выпуске нового релиза. Релизы между собой обычно не совместимы.
┌─┴┐ ┌──┴─┐
ECSS.SysRel.SubMaj.SubMin
            └──┬─┘ └──┬─┘
               │      └ версия Subsystem minor. Минорную версию подсистемы устанавливает разработчик подсистемы.

               |        Минорную версию
               │        меняем при добавлении патча. Как правило, минорные версии в рамках одной мажорной версии 
               │        совместимы между собой и отличаются в рамках конкретных патчей.
               │
               └ версия Subsystem major. Мажорная версия устанавливается разработчиком подсистемы.

                 Мажорную версию подсистемы необходимо менять при внесении в подсистему существенных изменений.

Утилита установки пакетов APT анализирует версию пакета слева направо, для примера мы имеем пакет 14.14.7.7 ,
в репозитории находятся пакеты
14.14.7.8
14.14.7.9
14.14.8.1
14.14.20 -14.14.28
то при выполнении команды sudo apt install имя пакета → будет автоматически проверен и установлен пакет 14.14.28 , так как он самый последний, анализ будет выполнен по 3-й позиции (major), анализ по 4-й (minor) выполнен не будет (аналогичным образом будет выполнятся команда sudo apt upgrade).

В случае если для конкретной ситуации требуется перейти с версии 14.14.7.7 на версию 14.14.7.9 , стандартная команда → sudo apt upgrade , нам не поможет, так как будет выбран самый новый пакет, в данной ситуации нам необходимо в явном виде указать какую версию пакета мы хотим установить, в данном примере мы должны выбрать команду → sudo apt install имя пакета=14.14.7.9 . Обычно это необходимо для тестирования определенного патча, для стандартных обновлений достаточно выбора привычной команды установки /обновления пакета

Якорь

	Доп_пакеты
	Доп_пакеты

Устанавливаем все предложенные пакеты:

Блок кода

language	bash

sudo apt install ntp ntpdate tcpdump vlan dnsmasq aptitude atop ethtool htop iotop mc minicom mtr-tiny nmap pptpd pv screen ssh tftpd vim sngrep tshark cpanminus gnuplot libgraph-easy-perl debconf-utils wget rsync ncdu

Раскрыть

language	bash
title	Пакеты ПО которые рекомендуется установить для работы

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

Блок кода

language	bash

sudo apt install ntp tcpdump vlan dnsmasq

ntp	NTP-сервер
tcpdump	сниффер пакетов
vlan	управление VLAN
dnsmasq	легковесный DNS/DHCP-сервер

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

Блок кода

language	bash

sudo apt install aptitude atop ethtool htop mc screen ssh tftpd sngrep tshark gnuplot libgraph-easy-perl debconf-utils iotop ncdu

aptitude	установка программ из репозиториев, рекомендуется использовать вместо программы apt/apt-get
atop	мониторинг загрузки хоста с функцией периодического сохранения информации в файлы
ethtool	просмотр статистики сетевых интерфейсов
htop	мониторинг процессов
mc	файловый менеджер
screen	мультиплексор терминалов
ssh	сервер и клиент SSH
tftpd	TFTP-сервер
sngrep	трассировка sip
tshark	консольный аналог wireshark
gnuplot	вывод графиков статистики
libgraph-easy-perl	Perl-модуль для преобразования или рендеринга графиков (в ASCII, HTML, SVG или через Graphviz)
debconf-utils	набор утилит для работы с базой debconf
iotop	инструмент для мониторинга использования ввода-вывода (IO) на диске в реальном времени в Linux
ncdu	утилита для поиска больших директорий в системе Linux

Примечание
Данное программное обеспечение не требуется для работы системы ECSS-10, однако может упростить сервисное обслуживание системы и её отдельных компонентов со стороны инженеров эксплуатации и техподдержки.

Примечание

Перед началом установки пакетов ecss , нужно убедиться в соответствии полосы пропускания СПД необходимым требованиям.
Для этого выполнить команду sudo ethtool <имя интерфейса> для всех физических интерфейсов.

Раскрыть

title	Пример:

sudo ethtool net.20
Settings for net.20:
Supported ports: [ TP ]
Supported link modes: 10baseT/Half 10baseT/Full
100baseT/Half 100baseT/Full
1000baseT/Full
Supported pause frame use: No
Supports auto-negotiation: Yes
Supported FEC modes: Not reported
Advertised link modes: 10baseT/Half 10baseT/Full
100baseT/Half 100baseT/Full
1000baseT/Full
Advertised pause frame use: No
Advertised auto-negotiation: Yes
Advertised FEC modes: Not reported
Speed: 1000Mb/s
Duplex: Full
Auto-negotiation: on
Port: Twisted Pair
PHYAD: 0
Transceiver: internal
MDI-X: off (auto)
Link detected: yes

Проверить значение следующих параметров:
Advertised auto-negotiation: Yes
Speed: 1000Mb/s (не менее)
Duplex: Full

Настройка пакета ecss-dns-env

Выполнить следующую команду:

Блок кода
sudo apt install -y ecss-dns-env

Настройщик предложит выбрать разделы для настройки по вопросам ниже. Нужно выбрать broker. (для примера 10.0.10.51)

Вопрос ecss-dns-env	Ответы для ecss1
[Primary broker] Введите адрес ([Primary broker] Enter ip)	10.0.10.51 (необходимо ввести)	Image Added
[Secondary broker] Введите адрес ([Secondary broker] Enter ip)	10.0.10.51 (необходимо ввести)	Image Added

Предупреждение

title	ВАЖНО

В случае последующей коррекции IP-адресов следует использовать команду:

Блок кода

language	bash

sudo dpkg-reconfigure ecss-dns-env

Установка Postgres

Предупреждение

title	Примечание

Перед установкой ecss-postgres-bdr-ssw в системе, в apt sources, должен быть добавлен docker для этого выполнить следующие команды:

Блок кода

title	на новом ssw

sudo install -m 0755 -d /etc/apt/keyrings

Блок кода

title	на новом ssw

sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc

Блок кода

title	на новом ssw

sudo chmod a+r /etc/apt/keyrings/docker.asc

Блок кода

title	на новом ssw

sudo sh -c "echo 'deb [arch=amd64 signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu   jammy stable' >> /etc/apt/sources.list.d/docker.list"

Блок кода

language	bash
title	на новом ssw

sudo apt update && sudo apt upgrade

Установка пакета ecss-postgres-bdr-ssw

Выполнить установку пакета ecss-postgres-bdr-ssw:

Блок кода

language	bash
title	на новом ssw

sudo apt install ecss-postgres-bdr-ssw

При конфигурации пакета ecss-postgres-bdr-ssw будут заданы вопросы:

Вопросы ecss-postgres-bdr-ssw	Ответы для ecss1	Пример
Текущий IP-адрес сетевого интерфейса (Выбрать адрес ранее используемый MySQL).	Выбрать из списка IP-адрес для работы с Postgres	Image Added
Установка в кластере?	No (необходимо выбрать)	Image Added

Без форматирования

title	Результат:

. . .
==================
 Create databases 
==================
CREATE DATABASE
CREATE DATABASE
CREATE EXTENSION
CREATE EXTENSION
===================================
 Creating Postgres Exporter Schema 
===================================
Node IP: localhost
CREATE SCHEMA
GRANT
CREATE FUNCTION
CREATE VIEW
GRANT
CREATE FUNCTION
CREATE VIEW
GRANT
CREATE EXTENSION
CREATE FUNCTION
CREATE VIEW
GRANT
=======================================================
=======================================================
 ecss-postgres-bdr-ssw successfully installed/updated! 
=======================================================
=======================================================
┏┓┏┓┏┓┏┳┓┏┓┳┓┏┓┏┓  ┳┓┳┓┳┓  ┏┓┏┓┓ ┏
┃┃┃┃┗┓ ┃ ┃┓┣┫┣ ┗┓  ┣┫┃┃┣┫  ┗┓┗┓┃┃┃
┣┛┗┛┗┛ ┻ ┗┛┛┗┗┛┗┛  ┻┛┻┛┛┗  ┗┛┗┛┗┻┛

Раскрыть

title	В случае использования файлового лицензирования

Информация

title	В случае использования файлового лицензирования

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

Раскрыть

title	В случае использования ELM лицензирования

Установить пакет License Provider:

Блок кода

title	на ecss2

sudo apt install ecss-license-provider

При установке пакета ecss-license-provider будут заданы вопросы:

Вопросы

Ответы

Примеры

Адрес для соединения с License Provider:
License Provider listen ip:

0.0.0.0 (значение по умолчанию)

Image Added

Порт для соединения c License Provider:
License Provider listen port:

4321 (значение по умолчанию)

Image Added

Выберите уровень логирования:
Log level:

info (значение по умолчанию),
возможные варианты: debug, error, info

Image Added

Ключ-имя кластера резервирования:
License Provider cluster key:

указать уникальное имя
ecss-lm-cluster (значение по умолчанию)

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

Image Added

Данные сохраняются в файле /etc/ecss/ecss-license-provider/config.env:

Без форматирования
ECSS_LM_HOST=0.0.0.0 ECSS_LM_PORT=4321 ECSS_LM_LOG_LEVEL=info RELEASE_COOKIE=ecss-abf-lm-cluster

Конфигурация License Provider (LP)

Сервис ecss-license-provider использует два конфигурационных файла: /etc/ecss/ecss-license-provider/config.env и /etc/ecss/ecss-license-provider/config.yaml.

В файл config.env информация сохраняется в момент установки пакета ecss-license-provider.

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

Блок кода

title	информация в файле после установки

elm_addresses: []
licenses: []
ecss_nodes: []

Для заполнения данных полей откройте файл конфигурации ecss-elm-adapter используемого в версии 3.17 ssw /etc/ecss/ecss-elm-adapter/config.env:

Блок кода

title	на ecss2

сat /etc/ecss/ecss-elm-adapter/config.env 
ELM_HOST=elm.eltex-co.ru
ELM_PORT=8099
ECSS_PRODUCT_ID=ECSS2000000
ECSS_LICENSE_KEY=ssw987654
LOG_LEVEL=info
LICENCE_FAIL_TIMER_SECONDS=10
LICENCE_PULL_TIMER_SECONDS=360

В поле elm_adresses нужно прописать список серверов ELM, к которым мы хотим подключаться для получения лицензий. Первый адрес в списке используется как основной. Дополнительные строки с адресами работают как резерв.
пример:
- "elm.eltex-co.ru:8099"
- "192.168.111.22:8099"
- "elm-3.eltex.loc:8099"

Дальше задаются сами лицензии в поле licenses.

id может быть любой, главное чтоб был уникальный у каждой лицензии. Влияет только на адрес лицензии на самом License Provider (например 0, 1, 2, 3).
kind. Для SSW поддерживается только SSW (заглавными буквами).
type выбирается как elm, если запрашивать данную лицензию нужно с ELM-сервера. Если нужно использовать файловую лицензию SSW, то тип выбирается как ecss_license.
- при elm типе необходимо задать поля license_key и product_id для идентификации лицензии.
- при ecss_license типе задается поле license, содержащее ключ статичной лицензии.

Примечание
Параметры license_key = ECSS_LICENSE_KEY и product_id = ECSS_PRODUCT_ID должны быть согласованы с данными, ранее загруженными на ELM-сервере.

Блок ecss_nodes.

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

id - идентификатор сервиса. В случае с SSW должен совпадать с ECSS_ID лицензируемого SSW.
kind - тип лицензируемого сервиса. По аналогии с блоком лицензий, поддерживаются типы SSW и AUP. Для SSW поддерживается только SSW.
license_id - идентификатор лицензии, которая будет отправляться на данный сервис. Соответствует идентификаторам лицензии из блока licenses.

Примечание

Два SSW с разными ECSS_ID не могут получить одну и ту же лицензию, конфигурация с таким распределением будет помечена некорректной.
Кроме того, два SSW с одинаковыми ECSS_ID не смогут одновременно получать одну и ту же лицензию с одного License Provider, поэтому крайне важно корректно устанавливать свой ECSS_ID и делать его уникальным как минимум в зоне видимости используемого License Provider.

Примечание
ECSS_ID указанный в файле /etc/ecss/ecss-license-provider/config.yaml, должен совпадать с ECSS_ID ( идентификатор ECSS-узла) которое указываем при установке пакета ecss-node

Предупреждение
При обновлении, имя нового ECSS-узла (ECSS_ID) нужно обязательно указывать отличное от имени старого ECSS-узла. В противном случае при их совпадении сервис ecss-mycelium не активируется.

Подсказка

Формат ECSS_ID:
Начинается и заканчивается обязательно латинской буквой или цифрой, в теле же могут использоваться точки и тире.

Без форматирования
[A-Za-z0-9][A-Za-z0-9.-][A-Za-z0-9]

Блок кода

title	Пример: файла config.yaml на основе данных из файла /etc/ecss/ecss-elm-adapter/config.env

elm_addresses:
 - "elm.eltex-co.ru:8099"
licenses:
 - id: 0
   kind: SSW
   type: elm
   license_key: "ssw987654"
   product_id: "ECSS2000000"
ecss_nodes:
 - id: test.update
   kind: ssw
   license_id: 0

Выполнить перезагрузку сервиса ecss-license-provider.service для обновления конфигурации из файла /etc/ecss/ecss-license-provider/config.yaml следующей командой:

Блок кода

title	если кластер, то на обоих хостах

sudo systemctl restart ecss-license-provider.service

Установка ecss-node

Установка обязательного пакета ecss-node включает в себя установку и первоначальную настройку основных подсистем.

Примечание
В системе уже должен быть установлен пакет ecss-postgres-bdr-ssw

Для установки пакета ecss-node выполните команду:

Блок кода

language	bash
title	на новом ssw

sudo apt install -y ecss-node

Во время установки пакета создается пользователь ssw, от имени которого запускаются все сервисы ecss*. Создаются необходимые каталоги, выполняется настройка DNS, идет настройка SSL-сертификатов.

Подсказка
При установке также будет установлен пакет ecss-user

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

Вопросы ecss-user

Ответы для ecss1

Пример

Хотите ли вы использовать стандартные настройки?

Yes (значение по умолчанию)

Image Added

Вопросы ecss-node

Ответы для ecss1

Пример

Якорь

	Идентификатор ECSS-узла
	Идентификатор ECSS-узла

Идентификатор ECSS-узла в формате DNS (Настройка имени кластера): (любое уникальное имя, в примере test.update)

Предупреждение
При обновлении, имя нового ECSS-узла нужно обязательно указывать отличное от имени старого ECSS-узла. В противном случае при их совпадении сервис ecss-mycelium не активируется.

Примечание
Идентификатор ECSS-узла должен совпадать с ECSS_ID указанном в файле конфигурации провайдера лицензий - /etc/ecss/ecss-license-provider/config.yaml.

test.update (необходимо ввести)

Подсказка

Формат ECSS_ID:
Начинается и заканчивается обязательно латинской буквой или цифрой, в теле же могут использоваться точки и тире.

Без форматирования
[A-Za-z0-9][A-Za-z0-9.-][A-Za-z0-9]

Image Added

Хотите ли вы использовать стандартные настройки?

Yes (значение по умолчанию)

Image Added

Вопросы ecss-user

Ответы для ecss1

Пример

Максимальный размер несжатого дампа в байтах.

8G (значение по умолчанию)

Image Added

Максимальный размер сжатого дампа в байтах.

2G (значение по умолчанию)

Image Added

Максимальный размер, который может занять каталог /var/lib/systemd/coredump:

default (значение по умолчанию)

Image Added

Минимальный объем свободного дискового пространства в байтах.

30G (значение по умолчанию)

Image Added

Сохраните в безопасное место и удалите файл /etc/ecss/ssl/ecss10root.key!

Ok (значение по умолчанию)

Image Added

Cookie для ноды core:

ecss-core (необходимо ввести)

Image Added

Cookie для ноды ds:

ecss-ds (необходимо ввести)

Image Added

Cookie для ноды mediator:

ecss-mediator (необходимо ввести)

Image Added

Cookie для ноды pa-sip:

ecss-pa-sip (необходимо ввести)

Image Added

Cookie для ноды mycelium:

ecss-mycelium (необходимо ввести)

Image Added

Cookie для ноды sorm:

ecss-sorm (необходимо ввести)

Image Added

Проверить информацию о состоянии синхронизации c NTP, используется команда ntpq –p . Если использовать дополнительный ключ –n, вместо имени сервера будет указан IP-адрес:

Без форматирования

ntpq -p
     remote           refid      st t when poll reach   delay   offset  jitter
==============================================================================
*185.125.190.56  17.253.28.253    2 u   45   64    1   83.893   +0.470   2.177

Остановить сервисы:

Блок кода

title	на новом ssw

sudo systemctl stop ecss-core ecss-pa-sip ecss-ds ecss-mediator ecss-mycelium

Создать backup для oasys (скопировать БД Mnesia со старого на новый ecss1), выполнить следующие команды:

Блок кода

title	на новом ssw

cd /var/lib/ecss/oasys/

Блок кода

title	на новом ssw

sudo rsync -a <Ваш_пользователь>@<IP_add_старого_сервера>:/var/lib/ecss/oasys/Mnesia.ds1@ecss1/ Mnesia.ds1@ecss1/

Блок кода

title	на новом ssw

sudo rsync -a <Ваш_пользователь>@<IP_add_старого_сервера>:/var/lib/ecss/oasys/Mnesia.md1@ecss1/ Mnesia.md1@ecss1/

Блок кода

title	на новом ssw

cd ~

Перезапустить сервисы SSW:

Блок кода

title	на новом ssw

sudo systemctl restart ecss-core ecss-pa-sip ecss-ds ecss-mediator ecss-mycelium

Если лицензия поддерживает СОРМ3, то запустить также сервис ecss-sorm.

Блок кода

title	на новом ssw

sudo systemctl start ecss-sorm

Проверить статус сервисов, для этого выполнить в CoCon команду system-status:

Без форматирования

title	выполняется в CoCon

/system-status 
Checking...
┌─┬───────────────┬─────────────────────────┬───────────────┬────────────┬──────┐
│ │     Node      │         Release         │ Erlang nodes  │Mnesia nodes│Uptime│
├─┼───────────────┼─────────────────────────┼───────────────┼────────────┼──────┤
│ │core1@ecss1    │ecss-core-3.18.0.271     │core1@ecss1    │not running │3m 55s│
│ │ds1@ecss1      │ecss-ds-3.18.0.271       │ds1@ecss1      │ds1@ecss1   │4m 40s│
│ │md1@ecss1      │ecss-mediator-3.18.0.271 │md1@ecss1      │md1@ecss1   │3m 50s│
│ │mycelium1@ecss1│ecss-mycelium-3.18.0.271 │mycelium1@ecss1│not running │5m 28s│
│ │sip1@ecss1     │ecss-pa-sip-3.18.0.271   │sip1@ecss1     │sip1@ecss1  │3m 45s│
│ │sorm1@ecss1    │ecss-sorm-3.18.0.271     │sorm1@ecss1    │not running │1m 55s│
└─┴───────────────┴─────────────────────────┴───────────────┴────────────┴──────┘

Режимы лицензирования.

Лицензирование с использованием файловой лицензии

Раскрыть

title	В случае использования файлового лицензирования

Информация

title	В случае использования файлового лицензирования

Никаких дополнительных действий выполнять не требуется.

Без форматирования

/cluster/storage/ds1/licence/list-licence
┌──┬───────────────────┬────────────────┬──────┬────────────────────────────────────────────┬────────────────────┬────────────┐
│Id│Creation date(UTC) │     SSW ID     │Active│                Description                 │Expiration date(UTC)│ Time left  │
├──┼───────────────────┼────────────────┼──────┼────────────────────────────────────────────┼────────────────────┼────────────┤
│1 │31.10.2025 14:16:00│ECSS 010070     │*     │Eltex SC softswitch                         │31.12.2026 23:59:59 │224d 21h 31m│
│0 │                   │ECSS DEFAULT    │      │Default licence                             │                    │            │
└──┴───────────────────┴────────────────┴──────┴────────────────────────────────────────────┴────────────────────┴────────────┘

Лицензирование с использованием ELM сервиса

Раскрыть

title	В случае использования ELM лицензирования

Выполнить конфигурацию подключения SSW к License Provider следующей командой в CoCon, (в примере License Provider установлен на хосте ecss1, IPadd хостов 10.0.10.51. Значение порта из файла /etc/ecss/ecss-license-provider/config.env по умолчанию 4321):

Блок кода

title	выполняется в CoCon

/system/licence/manager/set --hosts [https://10.0.10.51:4321]

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

Блок кода

title	выполняется в CoCon

/system/licence/manager/show-status
┌───────────────────────┬───────┬─────┐
│         Host          │Current│Alive│
├───────────────────────┼───────┼─────┤
│https://10.0.10.51:4321│*      │true │
└───────────────────────┴───────┴─────┘

Хост должен иметь статус alive=true. И быть «current».

Current - отображает к какому хосту подключён SSW. Если есть подключение, указывается *, если нет - ничего не указано.
Alive - отображает статус доступности хоста (healthcheck).

Информация

title	Подключение к License Manager

Отсутствие подключения к License Provider \ ELM будет равноценно отсутствию доступа к токену, что приведёт к критическим авариям, переходу в аварийный режим по истечении которого, если связь не будет восстановлена, система перейдёт на Default-лицензию.

Данное поведение применимо только при работе в elm-режиме.

Если статус к одному из хостов License Provider показан current, можно посылать запрос на загрузку лицензии на SSW командой:

Блок кода

title	выполняется в CoCon

/cluster/storage/ds1/licence/request

Блок кода

title	type=elm

/cluster/storage/ds1/licence/request      
Licence received      
[*******                                                               ] 6s 2ms   
Success: Licence parameters applied

Блок кода

title	type=elm

/cluster/storage/ds1/licence/list-licence 
┌──┬───────────────────┬────────────┬──────┬────────────────┬────────────────────┬────────────────────┬─────────┐
│Id│Creation date(UTC) │   SSW ID   │Active│  Description   │Comm. Exp. Date(UTC)│Expiration date(UTC)│Time left│
├──┼───────────────────┼────────────┼──────┼────────────────┼────────────────────┼────────────────────┼─────────┤
│1 │14.04.2026 11:18:34│ECSS2000000 │*     │ECSS ELM License│09.04.2027 16:26:34 │06.06.2026 10:49:12 │1d 6h 59m│
│0 │01.01.1990 00:00:00│ECSS DEFAULT│      │Default licence │                    │                    │         │
└──┴───────────────────┴────────────┴──────┴────────────────┴────────────────────┴────────────────────┴─────────┘

Установка пакетов ecss-restfs, ecss-media-server, ecss-web-conf

Далее устанавливаются пакеты ecss-restf затем ecss-media-server, ecss-media-resources, , ecss-web-conf и другие в любом порядке:

ecss-restfs

Блок кода

language	bash
title	на новом ssw

sudo apt install -y ecss-restfs

Установка ecss-restfs.

При установке пакета ecss-restfs будет предложено задать параметры конфигурации. Ответы на вопросы приведены ниже. Также инсталлятор предложит установить и настроить пакет Text2speech от Yandex.

Вопросы ecss-restfs	Ответы
Использование функции TTS (Use TTS service)	No (значение по умолчанию)
Настройка телефонной книги (Configure phone book)	No (значение по умолчанию)
Настроить сервис определения речи (Configure speech recognition service)	No (значение по умолчанию)
Ничего не выбирать	Ok

после установки пакета ecss-restfs проверьте наличие wav файлов автоинформатора в директории /var/lib/ecss/restfs/system/sounds/ командой :

Блок кода

language	bash

ll /var/lib/ecss/restfs/system/sounds/

наличие wav-файлов в указанной выше директории говорит о корректности установки пакета ecss-restfs

Информация

Отсутствия wav файлов в указанной выше директории, директории свидетельствует о проблеме при установке пакета ecss-restfs. Для ее решения выполните команду:

Блок кода
sudo apt --fix-broken install

и повторите команду проверки:

Блок кода
ll /var/lib/ecss/restfs/system/sounds/

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

Блок кода
wget http://ecss1:9990/system/sounds/ai_you.wav

Блок кода

language	bash

wget http://ecss1:9990/system/sounds/ai_you.wav
--2026-04-18 17:43:29--  http://ecss1:9990/system/sounds/ai_you.wav
Resolving ecss1 (ecss1)... 127.0.1.1, 10.0.10.51
Connecting to ecss1 (ecss1)|127.0.1.1|:9990... connected.
HTTP request sent, awaiting response... 200 OK
Length: 11670 (11K) [audio/x-wav]
Saving to: ‘ai_you.wav’

ai_you.wav                                  100%[========================================================================================>]  11,40K  --.-KB/s    in 0s      

2026-04-18 17:43:29 (301 MB/s) - ‘ai_you.wav’ saved [11670/11670]

проверочный файл можно удалить

Блок кода

language	bash

rm ai_you.wav

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

Блок кода

title	на новом ecss1

sudo rsync -a <ваш_пользователь>@<IP_add_старого_ecss1>:/var/lib/ecss/restfs/domain/ /var/lib/ecss/restfs/domain/

Блок кода

title	Пример:

abf@ecss1:/var/lib/ecss/restfs/domain$ ls -la /var/lib/ecss/restfs/domain
итого 8
drwxr-xr-x 2 www-data www-data 4096 апр 22 18:21 .
drwxr-xr-x 7 www-data www-data 4096 мая 28 15:07 ..

abf@ecss1:/var/lib/ecss/restfs/domain$ sudo rsync -a abf@10.0.10.10:/var/lib/ecss/restfs/domain/ /var/lib/ecss/restfs/domain/

abf@ecss1:/var/lib/ecss/restfs/domain$ ls -la test_domain/records/2026_05_28
итого 610
drwxrwxrwx 2 www-data www-data  4096 мая 28 14:56 .
drwxrwxrwx 3 www-data www-data  4096 мая 28 14:27 ..
-rw-r--r-- 1 www-data www-data 71892 мая 28 14:27 2026-05-28_14-27-02_t_42009-42007.pcm
-rw-rw-rw- 1 www-data www-data    86 мая 28 14:27 2026-05-28_14-27-02_t_42009-42007.pcm.meta
-rw-r--r-- 1 www-data www-data 71892 мая 28 14:31 2026-05-28_14-31-19_o_42007-42009.pcm
-rw-rw-rw- 1 www-data www-data    86 мая 28 14:31 2026-05-28_14-31-19_o_42007-42009.pcm.meta
-rw-r--r-- 1 www-data www-data 63904 мая 28 14:55 2026-05-28_14-55-24_o_42007-42009.pcm
-rw-rw-rw- 1 www-data www-data    86 мая 28 14:55 2026-05-28_14-55-24_o_42007-42009.pcm.meta
-rw-r--r-- 1 www-data www-data 39940 мая 28 14:55 2026-05-28_14-55-31_o_42007-42009.pcm
-rw-rw-rw- 1 www-data www-data    86 мая 28 14:55 2026-05-28_14-55-31_o_42007-42009.pcm.meta
-rw-r--r-- 1 www-data www-data 15976 мая 28 14:55 2026-05-28_14-55-37_o_42007-42009.pcm
-rw-rw-rw- 1 www-data www-data    86 мая 28 14:55 2026-05-28_14-55-37_o_42007-42009.pcm.meta
-rw-r--r-- 1 www-data www-data 79880 мая 28 14:55 2026-05-28_14-55-48_o_42007-42009.pcm
-rw-rw-rw- 1 www-data www-data    86 мая 28 14:55 2026-05-28_14-55-48_o_42007-42009.pcm.meta
-rw-r--r-- 1 www-data www-data 55916 мая 28 14:56 2026-05-28_14-55-59_o_42007-42009.pcm
-rw-rw-rw- 1 www-data www-data    86 мая 28 14:55 2026-05-28_14-55-59_o_42007-42009.pcm.meta
-rw-r--r-- 1 www-data www-data 47928 мая 28 14:56 2026-05-28_14-56-04_o_42007-42009.pcm
-rw-rw-rw- 1 www-data www-data    86 мая 28 14:56 2026-05-28_14-56-04_o_42007-42009.pcm.meta
-rw-r--r-- 1 www-data www-data 31952 мая 28 14:56 2026-05-28_14-56-28_t_42009-42007.pcm
-rw-rw-rw- 1 www-data www-data    86 мая 28 14:56 2026-05-28_14-56-28_t_42009-42007.pcm.meta
-rw-r--r-- 1 www-data www-data 31952 мая 28 14:56 2026-05-28_14-56-37_t_42009-42007.pcm
-rw-rw-rw- 1 www-data www-data    86 мая 28 14:56 2026-05-28_14-56-37_t_42009-42007.pcm.meta
-rw-r--r-- 1 www-data www-data 95856 мая 28 14:56 2026-05-28_14-56-42_t_42009-42007.pcm
-rw-rw-rw- 1 www-data www-data    86 мая 28 14:56 2026-05-28_14-56-42_t_42009-42007.pcm.meta

ecss-media-server

Блок кода

language	bash
title	на новом ssw

sudo apt install -y ecss-media-server

Для медиасервера (ecss-media-server/MSR) можно выполнить начальную настройку с записью параметров в файл конфигурации,
для этого нужно провести конфигурацию transport bind-addr,mcc bind-addres:
Укажите IP-адреса старого SSW версии 3.17 (в примере 10.0.20.41).

Вопросы ecss-media-server	Ответы для ecss1
[ MSR SIP ] Введите bind-ip адрес (Enter)	10.0.20.41 (необходимо ввести)
[MSR Control-Channel] Введите bind-ip-адрес	10.0.20.41 (необходимо ввести)

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

Блок кода
cat /etc/ecss/ecss-media-server/config.xml

Внутри лежит конфигурация для msr: config.xml, в директории conf.d лежит конфигурация default.xml.

По своей сути default.xml — это дополнение config.xml, которое определяет секцию аккаунтов. Это сделано для того, чтобы после обновлений пакета данная конфигурация оставалась неизменной. Вид config.xml представлен здесь: файл конфигурации.

Блок кода

<?xml version="1.0" encoding="utf-8"?>
<config date="09:24:23 03.12.2025">
  <general log-level="3" log-rotate="yes" max-calls="2148" max-vid-calls="100" max-in-group="512" load-sensor="media" load-delta="10" calls-delta="100" spool-dir-size="100M" log-name="msr.log" log-path="/var/log/ecss/media-server" use-srtp="disabled" enable-ice-transport="no" ice-update="no" aggressive-ice="yes" stun-server="" suspicious-mode="no"/>
  <transport bind-addr="10.0.20.41" port="5040" transport="udp+tcp"/>
  <!-- By default configured public TURN-server -->
  <turn-server use-turn="no" host="numb.viagenie.ca" user="webrtc@live.com" password="muazkh"/>
  <media mixer-clock-rate="8000" use-vad="no" cng-level="0" jb-size="60" rtcp-timeout="0" rtp-timeout="350" udp-src-check="no" cn-multiplier="3" port-start="12000" port-range="4496" tias-in-sdp="no" thread-cnt="2" vid-enc-threads="2" vid-dec-threads="2" video-conf-layout="evenly" keyframe-interval="1000" vid-decode-delay="100" silent-codec-switch="yes" silence-threshold="-30" dtmf-flash-disable="no" video-dscp="0" other-dscp="0" dummy-video-src="/usr/share/ecss-media-server/video/dummy_video.yuv" video-enc-width="640" video-enc-height="360" finalsilence="1000" rtcp-stat-dump="yes" dtmf-tg-fpc-loop="10" dtmf-tg-fit="1" dtmf-tg-fot="2" dtmf-tg-volume="12288"/>
  <codec pcma="1" pcmu="2" ilbc="0" gsm="0" g722="3" g726="0" g729="0" speex="0" l16="0" g7221="0" opus="0" h264="1" h263-1998="2" t38="1" tel-event-pt="0"/>
  <accounts>
    <!-- <dynamic msr_name="msr.name"
            realm="sip:127.0.0.1:5000"
            dtmf_mode="rfc+inband+info"
            auth_name="user"
            auth_password="password" /> -->
  </accounts>
  <pbyte>
    <mcc bind-addr="10.0.20.41" port="5700"/>
  </pbyte>
  <conf_dir path="/etc/ecss/ecss-media-server/conf.d"/>
  <metrics enable="yes" use-pushgateway="yes" pushgateway-addr="127.0.0.1:9091" push-interval="5" port="8100" msr_name="msr2"/>
  <rtp>
    <auto addr-v4=""/>
  </rtp>
</config>

по умолчанию , после инсталляции ECSS-10 активизирует только кодеки - pcma, pcmu, g722, h264, h263-1998, t38. Остальные имеют статус =0 = выкл. Если хотите активизировать остальные кодеки, в редакторе nano измените приоритет с 0 на цифру приоритета (уровень приоритета не должен повторятся для сервиса audio/video/fax)
sudo nano /etc/ecss/ecss-media-server/config.xml

Подсказка

language	bash

чтобы активизировать все кодеки
строчку -
<codec pcma="1" pcmu="2" ilbc="0" gsm="0" g722="3" g726="0" g729="0" speex="0" l16="0" g7221="0" opus="0" h264="1" h263-1998="2" t38="1" tel-event-pt="0"/>
привести к виду -
<codec pcma="1" pcmu="2" ilbc="6" gsm="4" g722="3" g726="11" g729="5" speex="7" l16="8" g7221="9" opus="10" h264="1" h263-1998="2" t38="1" tel-event-pt="0"/>

Предупреждение
Недопустимо указывать у разных кодеков одинаковый приоритет, для примера g722="5" g729="5". В этом случае они будут работать некорректно/игнорироваться. За исключением "0" - выключено.

Рассмотрим секцию аккаунтов (файл default.xml):

Блок кода

language	bash

cat /etc/ecss/ecss-media-server/conf.d/default.xml

Проверить корректность данных.

Блок кода

title	Настройка msr для ecss1(/etc/ecss/ecss-media-server/conf.d/default.xml)

<?xml version="1.0"?>
<config>
    <accounts>
        <dynamic msr_name="msr.ecss1" realm="sip:10.0.20.41:5000" dtmf_mode="rfc+inband+info" auth_name="user" auth_password="password">
            <via dynamic-ifaces="no">
                <iface name="net.20" ip="10.0.20.41"/>
            </via>
        </dynamic>
    </accounts>
</config>

В ней указаны текущие настройки, согласно которым происходит регистрация msr на core.

Основными параметрами здесь являются: msr_name и realm:

msr_name — параметр, определяющий название msr. (рекомендуется задавать название msr. и к какому хосту он принадлежит, например msr.ecss1);
realm — определяет адрес для регистрации на ядре. Точка входа по умолчанию: порт 5000, адрес: 127.0.0.1.

После изменения конфигурации файлов /etc/ecss/ecss-media-server/config.xml и /etc/ecss/ecss-media-server/conf.d/default.xml необходимо выполнить перезапуск сервиса ecss-media-server, чтобы изменения вступили в силу, следующей командой:

Блок кода
sudo systemctl restart ecss-media-server

Подсказка

Вы увидите сообщение:

Информация
Job for ecss-media-server.service failed because the control process exited with error code. See "systemctl status ecss-media-server.service" and "journalctl -xeu ecss-media-server.service" for details.

Мы указали рабочие IP адреса для media сервиса, а они пока закреплены за старым ecss1. После переключения IP адресов сервис запустится автоматически.

ecss-web-conf

Блок кода

title	на новом ssw

sudo apt install ecss-web-conf

Web-конфигуратор позволяет сделать управление системой более наглядным и комфортным. Установка web-конфигуратора не является обязательной, но рекомендуется.
Также при установке пакета ecss-web-conf автоматически устанавливается пакет ecss-subscriber-portal-ui. Приложение "Портал абонента" системы ECSS-10 позволяет абонентам системы самостоятельно управлять услугами, просматривать информацию по совершенным вызовам, активным конференциям, а также настраивать собственные IVR-скрипты для входящих вызовов. Описание работы веб-конфигуратора приведено в разделе "Портал абонента".

Вопросы ecss-web-conf	Ответы для ecss1	Пример
Хотите ли вы использовать стандартные настройки?	Yes (значение по умолчанию)	Image Added

Проверьте возможность подключения к веб-интерфейсу http://10.0.10.51, пользователь/пароль — admin/password. В настоящий момент не все функции будут доступны, но веб-интерфейс должен работать, а вход в систему — быть успешным.

Отключение SSW версии 3.17

Для отключения старого SSW версии 3.17 выполнить следующие команды:
Отключение сервисов

Блок кода

title	на старом SSW

sudo systemctl mask --now ecss-ds ecss-mycelium ecss-mediator ecss-core ecss-pa-sip ecss-sorm

Копирование БД Postgres

Скопировать БД Postgres со старого ecss1, для этого выполнить команду:

Блок кода

title	на старом SSW

sudo tar -Pcvf /tmp/postgres.tar /srv/ecss/ecss-postgres-bdr-ssw/volumes/

Скопировать postgres.tar на новый сервер, выполнив команду:

Блок кода

title	на старом SSW

 scp /tmp/postgres.tar <ваш_пользователь>@<IP_адрес_новый_ecss1>:/tmp/postgres.tar

Остановить docker БД Postgres командой:

Блок кода

title	на новом ssw

sudo docker compose -f /srv/ecss/ecss-postgres-bdr-ssw/docker-compose.container.yml stop

Очистить подкаталог /srv/ecss/ecss-postgres-bdr-ssw/volumes:

Блок кода

title	на новом ssw_ecss1

sudo rm -R /srv/ecss/ecss-postgres-bdr-ssw/volumes/*

Распаковать БД Postgres на новом сервере ecss1.

Блок кода

title	на новом ssw_ecss1

sudo tar xvf /tmp/postgres.tar -C /

Запустить docker БД Postgres командой:

Блок кода

title	на новом ssw

sudo docker compose -f /srv/ecss/ecss-postgres-bdr-ssw/docker-compose.container.yml start

Замена IP адресов на старом ecss1

Изменить IP адреса 10.0.10.41/10.0.20.41 на неиспользуемые на сети (для примера на 10.0.10.61/10.0.20.61):

Блок кода

title	на старом SSW

sudo nano /etc/netplan/ecss.yaml

Раскрыть

title	Было:

Блок кода

title	Было:

network:
  version: 2
  renderer: networkd
  ethernets:
    enp0s3: # Название интерфейса ВМ к интернет
        dhcp4: yes
        dhcp6: no
    enp0s8: # Название интерфейса для SSW
        dhcp4: no # Отключаем на интерфейсах динамическое распределение IP-адреса
        dhcp6: no
        addresses: [192.168.56.41/24]
  vlans:
    net.10: # Интерфейс управления
        id: 10
        link: enp0s8
        addresses: [10.0.10.41/24]
        nameservers:
          addresses: [127.0.0.1, 8.8.8.8] # Адреса серверов DNS
    net.20: # Интерфейс для VoIP
        id: 20
        link: enp0s8
        addresses: [10.0.20.41/24]
        routes:
        - to: 10.0.20.128/25
          via: 10.0.20.35

Раскрыть

title	Стало:

Блок кода

title	Стало:

network:
  version: 2
  renderer: networkd
  ethernets:
    enp0s3: # Название интерфейса ВМ к интернет
        dhcp4: yes
        dhcp6: no
    enp0s8: # Название интерфейса для SSW
        dhcp4: no # Отключаем на интерфейсах динамическое распределение IP-адреса
        dhcp6: no
        addresses: [192.168.56.61/24]
  vlans:
    net.10: # Интерфейс управления
        id: 10
        link: enp0s8
        addresses: [10.0.10.61/24]
        nameservers:
          addresses: [127.0.0.1, 8.8.8.8] # Адреса серверов DNS
    net.20: # Интерфейс для VoIP
        id: 20
        link: enp0s8
        addresses: [10.0.20.61/24]
        routes:
        - to: 10.0.20.128/25
          via: 10.0.20.35

Блок кода

title	на старом SSW

sudo netplan apply

Переключение нового SSW на рабочие IP адреса

После освобождения рабочих IP адресов со старого SSW можно подключить их к новому SSW. Выполнить команду:

Блок кода

title	на новом ssw

sudo nano /etc/netplan/ecss.yaml

Изменить IP адреса 10.0.10.51/10.0.20.51 на используемые на сети для SSW (в примере 10.0.10.41/10.0.20.41):

Раскрыть

title	Было:

Блок кода

title	Было:

network:
  version: 2
  renderer: networkd
  ethernets:
    enp0s3: # Название интерфейса ВМ к интернет
        dhcp4: yes
        dhcp6: no
    enp0s8: # Название интерфейса для SSW
        dhcp4: no # Отключаем на интерфейсах динамическое распределение IP-адреса
        dhcp6: no
        addresses: [192.168.56.51/24]
  vlans:
    net.10: # Интерфейс управления
        id: 10
        link: enp0s8
        addresses: [10.0.10.51/24]
        nameservers:
          addresses: [127.0.0.1, 8.8.8.8] # Адреса серверов DNS
    net.20: # Интерфейс для VoIP
        id: 20
        link: enp0s8
        addresses: [10.0.20.51/24]
        routes:
        - to: 10.0.20.128/25
          via: 10.0.20.35

Раскрыть

title	Стало:

Блок кода

title	Стало:

network:
  version: 2
  renderer: networkd
  ethernets:
    enp0s3: # Название интерфейса ВМ к интернет
        dhcp4: yes
        dhcp6: no
    enp0s8: # Название интерфейса для SSW
        dhcp4: no # Отключаем на интерфейсах динамическое распределение IP-адреса
        dhcp6: no
        addresses: [192.168.56.41/24]
  vlans:
    net.10: # Интерфейс управления
        id: 10
        link: enp0s8
        addresses: [10.0.10.41/24]
        nameservers:
          addresses: [127.0.0.1, 8.8.8.8] # Адреса серверов DNS
    net.20: # Интерфейс для VoIP
        id: 20
        link: enp0s8
        addresses: [10.0.20.41/24]
        routes:
        - to: 10.0.20.128/25
          via: 10.0.20.35

Блок кода

title	на новом ssw

sudo netplan apply

Обновить IP адрес в файле /etc/hosts:

Блок кода

title	на новом ssw

sudo nano /etc/hosts

Обновить IP адрес в файле /etc/dnsmasq.d/ecss-broker:

Блок кода

title	на новом ssw

sudo dpkg-reconfigure ecss-dns-env

Блок кода

title	выполняется в CoCon

/system/licence/manager/set --hosts [https://10.0.10.41:4321]

Блок кода

title	на новом ssw

sudo systemctl restart ecss-ds ecss-mycelium ecss-mediator ecss-core ecss-pa-sip ecss-media-server

После выполнения обновления проверьте работу всех сервисов SSW.

Дерево страниц

Сравнение версий

Старая версия 1

Новая версия 2

Ключ

Upgrade Options

Якорь
Первый вариант
Первый вариант
First option

Якорь
Второй вариант
Второй вариант
Второй вариант

Установка ОС

Подготовительный этап

Предварительные требования

Подготовка сетевых интерфейсов системы

"Оптимизация" операционной системы

Выставить параметры ОС в режим производительности

Отключить SWAP

Установка часового пояса

Улучшение работы высоконагруженных серверов

Обновление программного обеспечения операционной системы

Установка и настройка программного обеспечения

Настройка пакета ecss-dns-env

Установка Postgres

Установка ecss-node

Режимы лицензирования.

Лицензирование с использованием файловой лицензии

Лицензирование с использованием ELM сервиса

Установка пакетов ecss-restfs, ecss-media-server, ecss-web-conf

ecss-restfs

ecss-media-server

ecss-web-conf

Отключение SSW версии 3.17

Для отключения старого SSW версии 3.17 выполнить следующие команды:
Отключение сервисов

Копирование БД Postgres

Замена IP адресов на старом ecss1

Переключение нового SSW на рабочие IP адреса

Дерево страниц

История страницы

Сравнение версий

Старая версия 1

Новая версия 2

Ключ

Upgrade Options

ЯкорьПервый вариантПервый вариантFirst option

ЯкорьВторой вариантВторой вариантВторой вариант

Установка ОС

Подготовительный этап

Предварительные требования

Подготовка сетевых интерфейсов системы

"Оптимизация" операционной системы

Выставить параметры ОС в режим производительности

Отключить SWAP

Установка часового пояса

Улучшение работы высоконагруженных серверов

Обновление программного обеспечения операционной системы

Установка и настройка программного обеспечения

Настройка пакета ecss-dns-env

Установка Postgres

Установка ecss-node

Режимы лицензирования.

Лицензирование с использованием файловой лицензии

Лицензирование с использованием ELM сервиса

Установка пакетов ecss-restfs, ecss-media-server, ecss-web-conf

ecss-restfs

ecss-media-server

ecss-web-conf

Отключение SSW версии 3.17

Для отключения старого SSW версии 3.17 выполнить следующие команды:Отключение сервисов

Копирование БД Postgres

Замена IP адресов на старом ecss1

Переключение нового SSW на рабочие IP адреса

Якорь
Первый вариант
Первый вариант
First option

Якорь
Второй вариант
Второй вариант
Второй вариант

Для отключения старого SSW версии 3.17 выполнить следующие команды:
Отключение сервисов