документация:установка_компонентов_по []

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
===== Установка компонентов ПО =====

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

**Системные требования к установке Комплекса**

Комплекс поддерживается ОС Linux Ubuntu 20.04 LTS. Требования к ОЗУ, ЦП, объему диска зависят от требований к количеству измерительных каналов и скорости сбора данных в системе мониторинга. Программные модули Комплекса устанавливаются в независимые программные контейнеры. Взаимодействие контейнеров между собой организовано по протоколу TCP. Для создания контейнеров используются программы пакета Docker IO.

**Технические требования к серверу для установки Комплекса**

//**Расчет объема диска сервера** //

Для установки ОС, служебной информации на сервере и модулей Комплекса необходимо выделить 60 Гб.

//**Расчет объема диска для данных, поступающих с измерительных каналов Комплекса** //

На основании требований к системе мониторинга необходимо определить количество каналов, работающих в системе, интервал опроса каналов (в секундах) и срок хранения (в годах), например, датчик ИН-Д3 имеет 3 измерительных канала (X,Y,t (температура)). Формула расчета объема данных:

К – количество каналов;

Т – период опроса в секундах;

ПХ – период хранения (год);

Б – байты;

МБ – мегабайты.

Б = (К*4)*(86400/Т)*(ПХ*365).

Пример расчета необходимого места на диске для 7-ми датчиков ИН-Д3, опрос 1 раз в 300 секунд, срок хранения данных 2 года. 7 датчиков по 3 канала X, Y, t (итого 21 канал).

86 400 – количество секунд в сутках.

(21*4)*(86400/300)*(2*365) = 17 660 160 Б (16,8 МБ).

**//ВАЖНО!//**

**//Количество каналов состоит не только из количества физических измерительных каналов датчиков в соответствии с документацией на систему мониторинга конкретного объекта, но и из виртуальных каналов, которые вычисляются на основании поступивших данных с измерительных каналов датчиков в соответствии с требованиями к контролю параметров объекта мониторинга.// **

в) Для служебных данных Комплекса, таких как "Журнал событий" и "Журнал сейсмических событий", необходимо выделить не менее 10 Гб. Подобного рода данные оцениваются ориентировочно, исходя из специфики объекта мониторинга.

**//ВАЖНО!//**

//**Если включен чек-бокс "Сохранять исходные значения" в настройках каналов или датчиков Комплекса, объем выделенного дискового пространства необходимо умножить на 2.**//

**//Рекомендация:// ** при создании диска использовать тип тома LVM, что позволит при необходимости расширить том.

//**Расчет нагрузки ОЗУ и ЦП сервера** //

Выбор объема ОЗУ и типа ЦП для работы Системы Мониторинга зависит от выбранных функциональных возможностей и количества измерительных каналов Комплекса. Минимальные требования к ЦП и ОЗУ:

- 4 Ядра с частотой не менее 3 ГГц;

- 4 Гб оперативной памяти.

**Настройка системы Ubuntu 20.04 LTS**

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

Настройте сеть через консоль на сервера Ubuntu 20.04 LTS, отредактировав файл конфигурации netplan, находящийся в директории ''/etc/netplan/''.

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

<code>
# vim /etc/netplan/00-installer-config.yaml

</code>

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

- ''addresses'' — ip-адрес который будет назначен вашей сетевой карте;
- ''gateway4'' — ip-адрес вашего роутера;

- ''nameservers'' — DNS-серверы;
- ''search'' — домен, в котором будет произведен поиск.

**//ВАЖНО!//**

//**Обратите внимание на пробелы! Использование табуляции запрещено! В строке в качестве разделителей допускаются только пробелы! Если у вас после сохранения файла появилась ошибка типа: ** //''**Error while loading /etc/netplan/00-installer-config.yaml**'' //**, то файл отредактирован неправильно с точки зрения синтаксиса.** //

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

<code>
 network:
  ethernets:
   enp0s3:
    addresses:
     - 192.168.0.105/24
    gateway4: 192.168.0.1
    nameservers:
     addresses: [192.168.0.1, 8.8.4.4]
    optional: true
  version: 2
  renderer: networkd

</code>

//**Настройка дискового пространства** //

Существует два способа настройки хранилища в Ubuntu Server.

1.Управляемая конфигурация хранилища: Система создаст раздел хранилища автоматически, устанавливая значения по умолчанию. Этот метод полезен для начинающих пользователей сервера Ubuntu.

2.Пользовательский макет хранилища: Пользователь должен определить раздел хранилища сам. Это лучший метод для сервера Ubuntu, позволяющий пользователю настроить хранилища в соответствии со своими требованиями.

Необходимо создать раздел LVM, для этого нужно использовать пользовательский макет хранилища. Перейдите к опции "Пользовательский макет хранилища" и нажмите клавишу пробел, чтобы выбрать ее. Теперь выберите опцию "Готово" и нажмите клавишу "Ввод".

Появится окно конфигурации хранилища. Выбрать разделы "ФАЙЛОВАЯ СИСТЕМА", "ДОСТУПНЫЕ УСТРОЙСТВА" и "ИСПОЛЬЗУЕМЫЕ УСТРОЙСТВА". В разделе “ДОСТУПНЫЕ УСТРОЙСТВА” найти необходимые устройства. Доступное устройство /dev/sda.

Создать раздел LVM на этом диске. В системе Linux нужно создать минимальный (''/boot'') загрузочный, swap и (/) корневой раздел. Среди этих разделов ''/boot'' и ''swap'' должны быть вне LVM. Сначала создать эти два раздела, прежде чем создавать LVM.

   * Выберите доступное устройство (например: ''/dev/sda''), нажав клавиши со стрелками вверх и вниз, а затем нажмите клавишу “Ввод”. Появится всплывающая опция.  * Выберите опцию “Добавить раздел GPT” и нажмите клавишу “"Ввод". Теперь появятся параметры для управления разделом GPT.

  * При добавлении раздела GPT в раздел ''/dev/sda''  укажите размер (например, 500 м) для загрузочного раздела в поле ввода "Размер".  * В раскрывающемся меню Формат выберите формат раздела ''- ext4''.  * В раскрывающемся меню "Mount" выберите ''/boot''.  * Выберите опцию "Создать" и нажмите клавишу "Ввод".

Загрузочный раздел будет создан и доступен в разделе ФАЙЛОВАЯ СИСТЕМА окна Конфигурации хранилища.

Далее создайте раздел подкачки, выполнив следующие действия:

  * Выберите устройство хранения, снова нажав клавиши со стрелками вверх и вниз и нажав клавишу “Ввод”.

  * Выберите опцию "Добавить раздел GPT" и нажмите клавишу "Ввод". Появятся опции для создания нового раздела GPT.

  * При добавлении раздела GPT в раздел ''/dev/sda''  укажите размер (например: 8G) раздела подкачки в поле ввода размера.  * Выберите "Swap" в раскрывающемся меню "Format".

  * Выберите опцию "Создать" и нажмите клавишу "Ввод".

Затем создайте неформатированное хранилище перед созданием раздела LVM:

  * Выберите устройство хранения, снова нажав клавиши со стрелками вверх и вниз, а затем нажмите клавишу "Ввод".

  * Выберите опцию "Добавить раздел GPT" и нажмите клавишу "Ввод". Появятся опции для создания нового раздела GPT.

  * При добавлении раздела GPT в раздел ''/dev/sda''  укажите размер раздела LVM (надо указать полный размер оставшегося размера диска) в поле ввода размера.  * В раскрывающемся меню "Формат" выберите опцию оставить диск неформатированным (не форматировать диск).

  * Выберите опцию "Создать" и нажмите клавишу "Ввод".

Чтобы создать раздел LVM, сначала необходимо создать группу томов (VG).

Создание группы томов LVM (VG):

  * В разделе "ДОСТУПНЫЕ УСТРОЙСТВА" выберите опцию "Создать группу томов (LVM) " и нажмите клавишу "Ввод". Появится опция "Создать группу томов LVM".

  * По умолчанию система укажет (''vg0'') для имени группы томов. Измените его в поле ввода имени или сохраните по умолчанию.  * Выберите опцию раздела в разделе "Устройства" и нажмите клавишу пробела, чтобы включить ее.

  * Выберите опцию "Создать" и нажмите клавишу "Ввод".

Группа томов (''vg0'') теперь будет доступна в разделе "ДОСТУПНЫЕ УСТРОЙСТВА". Далее необходимо создать раздел LVM отсюда.

Создание корневого (/) раздела LVM:

  * Выберите созданную группу (''vg0'').  * Выберите опцию "Создать логический том" и нажмите клавишу "Ввод". Появятся параметры для создания нового логического тома.

  * В разделе "Добавление логического тома" в ''vg0''  введите имя тома (например, ''lv-root'') в поле ввода имени.  * Укажите размер для корневого раздела в поле ввода "Размер".

  * В раскрывающемся меню "Формат" выберите формат раздела ''– ext4''.  * Выберите опцию "Создать" и нажмите клавишу "Ввод".

Будет создан корневой (/) раздел, доступный в разделе "ФАЙЛОВАЯ СИСТЕМА" окна Конфигурации хранилища.

Выберите опцию "Готово" и нажмите клавишу "Ввод". Система попросит подтвердить форматирование данных, поскольку после создания и форматирования раздела на этом устройстве старые данные будут удалены.

Выберите "Продолжить" и нажмите клавишу "Ввод", чтобы подтвердить действие.

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

Установите временную зону на сервере.

Для установки текущего часового пояса системы введите ''timedatectl''  без аргументов:

''# timedatectl''

Выходные данные ниже показывают, что часовой пояс системы установлен на "UTC":

<code>
               Local time: Wed 2021-08-25 08:18:36 UTC
           Universal time: Wed 2021-08-25 08:18:36 UTC
                 RTC time: Wed 2021-08-25 08:18:37
                Time zone: Europe/Moscow (MSK, +0300)
System clock synchronized: yes
              NTP service: active
          RTC in local TZ: no

</code>

Чтобы вывести список всех доступных часовых поясов:

<code>
#timedatectl list-timezones

</code>

Как только вы определите, какой часовой пояс соответствует вашему местоположению, введите в качестве пользователя ''sudo''  следующую команду:

<code>
# sudo timedatectl set-timezone your_time_zone  

</code>

==== Установка и обновление компонентов Комплекса ====

**Протокол удаленного доступа для установки**

Установка программы для удаленного доступа к серверу осуществляется по протоколу SSH ''# apt install -y openssh-server''.

**Подготовка сервера для установки программы **

Для установки подключитесь к серверу Комплекса по SSH протоколу или локально через консоль.

Введите команды:

Обновление системы

<code>
# apt update

</code>

Программа для связи с репозиторием

<code>
# apt install -y git

</code>

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

<code>
# apt install -y docker.io

# apt install -y docker-compose

</code>

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

//**Настройка сервера для хранения резервных копий**//

Резервные копии данных могут храниться как на внешнем хранилище (типа NAS), подключенном по технологии SABMA, NFS, ISCSI и т.д., так и на локальном носителе (HDD, SSD), подключенном к серверу Комплекса.

Подключенное внешнее или локальное хранилище необходимо смонтировать в каталог ''/opt/monitoring/backups''.

//**Ручное резервное копирование**//

Для работы с резервными копиями подключитесь к серверу Комплекса по SSH протоколу или локально через консоль.
Необходимо войти в каталог ''# cd/opt/monitoring/'' и ввести команды:

- Просмотр списка резервных копий:

''# ./backup_ctl.sh list''

В списке указывается:

- размер файла;

- дата копии;

- наименование файла;

- признак копии (ежедневная, недельная, месячная), если копирование выполняется в автоматическом режиме;

- общий размер всех файлов.

Пример списка резервных копий:

''38G     2023-11-08_183928_daily-2023-11-08''

''2,8G    2025-02-04_180234_04.02.2025''

''643M   2025-02-04_190122_daily-2025-02-04''

''50G     total''

''SUCCESS''

- Создание резервной копии:

''./backup_ctl.sh backup [name]'',

где ''[name]'' – наименование файла резервной копии.

- Восстановление Системы из резервных копий:

''./backup_ctl.sh restore [ID]'',

где ''[ID]'' – ID файла резервной копии.

Пример:

''./backup_ctl.sh restore 2025-02-04_190122_daily-2025-02-04''

**Загрузка установочных файлов на сервер Комплекса**

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

<code>
# git clone -b latest http://deploy:7PCh5SJnTiXQJBmB9wmi@dev.system-it.pro/monitoring/monitoring.git

</code>

Проверка компонентов:

<code>
# /opt/monitoring/deploy.sh ensure_req

</code>

Начальные настройки Комплекса, сгенерированные автоматически:

<code>
# /opt/monitoring/deploy.sh config

</code>

**Настройка параметров Комплекса**

Перед установкой компонентов Комплекса необходимо сделать персональные настройки. Основные настройки касаются Временной зоны, Паролей, Ключей доступа, Доступ к внешним источникам данных (например, доступ к базе данных) и параметры системы сбора и хранения данных. Настройки нужно сделать как для сервера, так и для устанавливаемых контейнеров.

Настройка контейнеров: Для изменения настроек в контейнерах в системе используются два файла //.env//  и //docker-compose.override.yml.//

//**Настройка файла .env** //

Переменные, сгенерированные автоматически в файле //.env//  (при необходимости изменить):

<code>
LORA_API_JWT_SECRET=default

LORA_AS_API_PASSWORD=admin

POSTGRES_PASSWORD=default

CLICKHOUSE_PASSWORD=default

WEB_DEFAULT_PASSWORD=default

</code>

# секунд

<code>
STORE_BUFF_PERIOD=30

TZ=Asia/Yekaterinburg

PHP_TZ=Asia/Yekaterinburg

LORA_NET_ID=

SENTRY_URL=http://ID@example.com:9000/3

</code>

//**Настройка файла docker-compose.override.yml** //

По умолчанию файл //docker-compose.override.yml//  не используется. Чтобы его подключить, необходимо файл //docker-compose.override-dev.yml//  переименовать в файл //docker-compose.override.yml//. Основная задача файла настроек //docker-compose.override.yml//  – открыть доступ к контейнерам для внешних систем или подключить дополнительные параметры.

**Запуск установки программного комплекса GGS**

Введите команды:

<code>
# docker login -u user -p default dev.system-it.pro:5000

# /opt/monitoring/deploy.sh upgrade

</code>

Программа будет установлена.

**Завершение установки**

После установки откройте браузер, в адресной строке введите IP-адрес сервера Комплекса.

Для входа по умолчанию используется:

- имя пользователя: __admin@example.com__;

- пароль в соответствии с установкой в файле ///opt/monitoring/.env//, параметр ''WEB_DEFAULT_PASSWORD=[пароль]''.

==== Лицензирование ====

Лицензия на устройства ограничивает максимально возможное количество подключаемых устройств для всех ОМ системы.

Лицензирование предусмотрено для подключения измерительных устройств к ОМ по шинам LoRaWAN, XNB, АН-Д3(TCP), Modbus(TCP), OPC-Клиент. Устройства, подключенные к шинам Комплексный вычислитель и REST API(JSON), не лицензируются.

Для подключения лицензии:

  * Сообщите Поставщику программного обеспечения Комплекса о том, что Вам необходимо увеличить количество подключаемых устройств.

  * Подключитесь к серверу по протоколу SSH.

  * Перейдите в каталог ''/opt/monitoring/'', для чего в консоли введите следующую команду:

<code>
#cd /opt/monitoring/

</code>

  * Инициализируйте ключ сервера, для чего в консоли введите следующую команду:

<code>
#./license installation-key

</code>

  * Полученный ключ передайте Поставщику. На основании него Поставщик создаст обновленную лицензию.

Пример лицензионного ключа:

''eyJ12XAiOгJKV1QiLCJhbGciOiJSUzI1NiK8''
  * Активируйте полученный лицензионный ключ, для чего в консоли введите следующую команду:

<code>
#./license set-license-key eyJ12XAiOгJKV1QiLCJhbGciOiJSUzI1NiK8

</code>

Для проверки активации лицензии в web-приложении необходимо перейти на страницу «Управление настройками объекта», где будет указана обновленная информация:

  * Лимит устройств – максимально возможное количество подключаемых устройств.

  * Подключено устройств – текущее количество подключенных устройств.

==== Техническая поддержка ====

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

  * адрес: г. Москва, пр-д Старопетровский, д.7, стр .23;

  * телефон: +7-800-333-01-40;

  * e-mail: info@ntpgorizont.ru. 5.2

Режим работы техподдержки: рабочие дни с 9-00 до 18-00 по московскому времени.