Различия

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

--- документация:инструкция_по_установке [2024/01/20 05:35] – adm0001
+++ документация:инструкция_по_установке [2024/01/24 15:00] (текущий) – удалено adm0001
@@ Строка 1: / Строка 1: @@
-===== Инструкция по установке =====
-==== Установка системного программного обеспечения ====
-**Системные требования к установке Комплекса**
-Комплекс поддерживается ОС 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 канал).
-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.
-.Управляемая конфигурация хранилища: Система создаст раздел хранилища автоматически, устанавливая значения по умолчанию. Этот метод полезен для начинающих пользователей сервера Ubuntu.
-.Пользовательский макет хранилища: Пользователь должен определить раздел хранилища сам. Это лучший метод для сервера 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''.
-**Загрузка установочных файлов на сервер Комплекса**
-Запуск команды для загрузки программы установки на сервер:
-<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 по московскому времени.