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

@@ -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.
+Данные должны начать поступать сразу.