diff --git a/инструкция Настройка микросервиса ioCollector для новой скважины.md b/инструкция Настройка микросервиса ioCollector для новой скважины.md new file mode 100644 index 00000000..7f6d8dff --- /dev/null +++ b/инструкция Настройка микросервиса 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. +Данные должны начать поступать сразу. \ No newline at end of file