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