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

101 lines
5.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Настройка микросервиса 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.
Данные должны начать поступать сразу.