инструкция Настройка микросервиса ioCollector для новой скважины.md

This commit is contained in:
Никита Фролов 2025-02-05 09:19:53 +05:00
parent 6bdb4e77a8
commit a769cd0580

View File

@ -0,0 +1,101 @@
# Настройка микросервиса ioCollector для новой скважины
Процесс настройки микросервиса ioCollector для новой скважины прост и состоит из редактирования текстового файла конфигурации и перезапуска микросервиса.
## 1. Подключиться к рабочему серверу по ssh:
Для этого в терминале windows набрать команду:
```
ssh wellworkover.autodrilling.ru -l asb
```
При первом подключении ssh клиент спросит доверяете ли вы ключу сервера:
```
The authenticity of host 'wellworkover.autodrilling.ru (45.143.92.55)' can't be established.
ED25519 key fingerprint is SHA256:Zp3Ym1Q7k3xlzJPK7E+a+osmyhAbJjg2knueg2p8npY.
This key is not known by any other names.
Are you sure you want to continue connecting (yes/no/[fingerprint])?
```
Чтобы ответить утвердительно введите `yes`.
Далее сервер спросит пароль пользователя `asb` введите `ASB2020!`.
При успешном подключении вы увидите строку приветствия:
```
asb@wellworkover:~$
```
1.1 Ваша версия widows может не содержать встроенного клиента ssh ("Клиент OpenSSH"). Тогда при вводе команды вам будет выдана соответствующая ошибка.
Для установки на win 11 см. https://ip-calculator.ru/blog/ask/kak-ustanovit-klient-openssh-v-windows-11/
Для установки на win 10 см. https://winitpro.ru/index.php/2020/01/22/vstroennyj-ssh-klient-windows/
## 2. Резервное копирование файла конфигурации
Для копирования файла конфигурации микросервиса ioCollector выполните команду из домашней директории (`/home/asb` после подключения вы попадаете в нее):
```
cp docker/collector/appsettings.json backup/appsettings.json
```
2.1 Проверяем, что все успешно скопировалось командой:
```
ls -la backup/
```
В выводе команды находим строчку с файлом конфигурации
```
...
-rw-r--r-- 1 asb asb 21099 Feb 4 14:12 appsettings.json
```
У него должно быть текущее время (и дата) сервера.
2.2
В случае необходимости восстановления старого файла скопировать его обратно можно той же командой `cp` но аргументы поменять местами:
```
cp backup/appsettings.json docker/collector/appsettings.json
```
## 3. Редактирование файла конфигурации
Открываем файл настроек в редакторе nano(вы можете использовать любой удобный для вас редактор):
```
nano docker/collector/appsettings.json
```
В секции настроек `Collector` меняем значения параметров `DataWellWorkoverUrlParameters` и `MessageUrlParameters` на новый guid.
Новый GUID можно сгенерировать на сайте https://guidgenerator.com или любом другом.
Значения `DataWellWorkoverUrlParameters` и `MessageUrlParameters` должны быть одинаковыми.
После редактирования записать изменения на диск сочетанием клавиш: `ctrl + o`.
Выйти из редактора сочетанием клавиш: `ctrl + x`.
## 4. Перезапустить микросервисы ioCollector и io
Для этого перейдите в директорию с конфигурацией оркестратора контейнеров
```
cd docker
```
Перезапустить контейнеры микросервисов
```
sudo docker compose restart iocollector io
```
Сервер может потребовать ввести пароль от пользователя `asb` (пароль `ASB2020!`).
После успешного выполнения этой команды, от ssh следует отключиться: команда `exit`.
## 5. назначить телеметрию новой скважине
Для этого в "админке" на странице [телеметрии](https://wellworkover.autodrilling.ru/admin/telemetry/viewer) находим по UID новую телеметрию и запоминаем её ID.
После этого на странице редактирования [скважин](https://wellworkover.autodrilling.ru/admin/well) задаем для новой скважины телеметрию нужным ID.
Данные должны начать поступать сразу.