# 6. Встановлення компонентів за допомогою скрипта автоматизації встановлення

Скрипт автоматизації встановлення призначений для інсталяції необхідного програмного забезпечення на всі локальні компоненти системи «Трембіта», які попередньо сконфігуровані відповідно до розділу 5 даної інструкції.

# 6.1. Початкове налаштування робочої станції адміністратора

#### 6.1.1. Завантаження на робочу станцію адміністратора скрипта автоматизації встановлення

<span lang="UK">Скрипт автоматизованого встановлення можна завантажити за посиланням</span>

<span lang="UK"> </span><span lang="UK">[https://portal.trembita.gov.ua/media/website-media/trembita\_installation1\_12\_6.zip](https://portal.trembita.gov.ua/media/website-media/trembita_installation1_12_6.zip)</span><span lang="RU">.</span>

<span lang="UK">Після завантаження необхідно розархівувати завантажений архів до домашньої директорії</span><span lang="RU"> (/</span>home<span lang="RU">/**&lt;**</span>**username**<span lang="RU">**&gt;**)</span><span lang="UK">.</span>

---

#### 6.1.2. <span lang="UK">Завантаження файлу ліцензії та якоря конфігурації для роботи шлюзу безпечного обміну</span>

<span lang="UK">Для роботи шлюзу безпечного обміну в промисловому середовищі необхідні діюча ліцензія та якір конфігурації для промислового середовища. ШБО не працюватиме без даних файлів. </span>

<span lang="UK">Файли ліцензії (файл *member.live.license.lic*) та якоря конфігурації (файл *configuration anchor*) для промислового середовища можна знайти в Особистому кабінеті Каталогу системи «Трембіта» розділ «Адміністрування», вкладка «Матеріали».</span><span lang="UK"> З даними файлами необхідно виконати наступні дії:</span>

<span lang="UK">1. </span><span lang="UK">Завантажити файл ліцензії промислового середовища *member.live.license.lic* на робочу станцію адміністратора та перейменувати його на *license.lic*;</span>

<span lang="UK">2. </span><span lang="UK">Завантажити файл якоря конфігурації промислового середовища на робочу станцію адміністратора та перейменувати його на *configuration-anchor.xml*;</span>

<span lang="UK"><span lang="UK">3. Перемістити файли *license.lic* та c*onfiguration-anchor.xml* до директорії ~*/trembita\_installation/sec\_serv\_config/* робочої станції адміністратора.</span></span>

<div id="bkmrk--12" style="mso-element: comment-list;"><div style="mso-element: comment;"><div class="msocomtxt" id="bkmrk--13" language="JavaScript" onmouseout="msoCommentHide('_com_1')" onmouseover="msoCommentShow('_anchor_1','_com_1')"></div></div></div>

# 6.2 Початкове налаштування шлюзу безпечного обміну, серверу аналізу журналів подій, серверу баз даних та архівування

<span lang="UK" style="mso-bidi-font-size: 12.0pt; line-height: 150%; font-family: 'Tahoma',sans-serif;">Віртуальні машини (або фізичні комп’ютери), на які будуть встановлені ШБО, сервер аналізу журналу подій та сервері бази даних повинні бути попередньо сконфігуровані відповідно до [розділу ](https://docs.trembita.gov.ua/books/instrukciia-zi-vstanovlennia-lokalnix-komponentiv-sistemi-trembita-v-promislovomu-seredovishhi-za-dopomogoiu-skripta-avtomatizaciyi/page/5-peredumovi-do-vikonannia-vstanovlennia)</span>[](https://docs.trembita.gov.ua/books/instrukciia-zi-vstanovlennia-lokalnix-komponentiv-sistemi-trembita-v-promislovomu-seredovishhi-za-dopomogoiu-skripta-avtomatizaciyi/page/5-peredumovi-do-vikonannia-vstanovlennia)<span lang="UK" style="mso-bidi-font-size: 12.0pt; line-height: 150%; font-family: 'Tahoma',sans-serif;">[5](https://docs.trembita.gov.ua/books/instrukciia-zi-vstanovlennia-lokalnix-komponentiv-sistemi-trembita-v-promislovomu-seredovishhi-za-dopomogoiu-skripta-avtomatizaciyi/page/5-peredumovi-do-vikonannia-vstanovlennia)</span><span lang="UK" style="mso-bidi-font-size: 12.0pt; line-height: 150%; font-family: 'Tahoma',sans-serif;"> даної інструкції.</span>

# 6.3 Запуск скрипта

<span lang="UK">Важливо!</span><span lang="UK"> Результат роботи скрипта відмінити неможливо, тому перед його виконанням необхідно зробити резервну копію (снапшот) віртуальних машин, на яких буде запущено скрипт та на які будуть встановлюватися локальні компоненти.</span>

<span lang="UK">Для запуску скрипта автоматизації встановлення Адміністратору локальних компонентів (системному адміністратору) необхідно:</span>

<span lang="UK">1. Відкрити консоль (термінал) робочої станції адміністратора. Це можна зробити за допомогою натиснення комбінації клавіш «Ctrl+Alt+T».</span>

<span lang="UK">![](https://docs.trembita.gov.ua/uploads/images/gallery/2024-09/NqguiCfl3HBAQKqt-embedded-image-54hv6r52.png)</span>

<span lang="UK">2. Перейти в директорію /home/&lt;username&gt; за допомогою виконання наступної команди:</span>

```
cd /home/<username>
```

<span lang="UK">де **&lt;**</span>**username&gt;** <span lang="UK">–</span><span lang="UK"> ім’я користувача з роллю Адміністратор локальних компонентів (системний адміністратор).</span>

<span lang="UK">3. Послідовно виконати наступні команди:</span>

```
cd trembita_installation1_12_6/trembita_installation/
sudo python3 run.py
```

# 6.4. Робота скрипта

<span lang="UK">Скрипт під час своєї роботи автоматично здійснює конфігурування та налаштування необхідного програмного забезпечення для всіх компонентів промислового середовища системи «Трембіта». Скрипт не перевіряє налаштування мережевої інфраструктури і результати його роботи неможливо відмінити.</span>

<span lang="UK">Після запуску скрипта на виконання користувачеві буде відображено наступне повідомлення:</span>

<span lang="UK">![](https://docs.trembita.gov.ua/uploads/images/gallery/2024-09/7JrFbufMo1654rFc-embedded-image-bew1c0ox.png)</span>

<span lang="UK">Після натискання клавіші «Enter», користувачеві буде запропоновано ввести вихідні параметри, необхідні для конфігурації компонентів учасника системи (один параметр на рядок):</span>

<span lang="UK">1. Для конфігурації робочої станції адміністратора:</span>

<span lang="UK">- </span><span lang="UK">IP-адресу робочої станції;</span>

<span lang="UK">- </span><span lang="UK">пароль користувача uxpadmin (цей користувач створюється в процесі роботи скрипта і виконує в подальшому роль Адміністратора вебсервісів).</span>

<span lang="UK">2. Для конфігурації серверу аналізу журналів подій:</span>

<span lang="UK">- </span><span lang="UK">локальну IP-адресу сервера аналізу журналів подій;</span>

<span lang="UK">- </span><span lang="UK">логін адміністратора ОС серверу аналізу журналів подій, для доступу за допомогою SSH;</span>

<span lang="UK">- </span><span lang="UK">пароль адміністратора ОС серверу аналізу журналів подій, для доступу за допомогою SSH;</span>

<span lang="UK">- </span><span lang="UK">пароль для web-користувача «admin» на graylog (цей користувач створюється в процесі роботи скрипту).</span>

<span lang="UK">Нижче наведено приклад заповнення деяких вихідних даних:</span>

![](https://docs.trembita.gov.ua/uploads/images/gallery/2024-09/LGOmcSKU95gdqGag-embedded-image-vycs0utp.png)

<span lang="UK">3. Для конфігурації серверу баз даних та архівування:</span>

<span lang="UK">- </span><span lang="UK">локальну IP-адресу сервера баз даних та архівування;</span>

<span lang="UK">- </span><span lang="UK">логін адміністратора ОС сервера баз даних та архівування, для доступу за допомогою SSH;</span>

<span lang="UK">- </span><span lang="UK">пароль адміністратора ОС сервера баз даних та архівування, для доступу за допомогою SSH;</span>

<span lang="UK">- </span><span lang="UK">пароль користувача uxpadmin (цей користувач засобу перевірки повідомлень створюється в процесі роботи скрипту і виконує в подальшому роль Відповідального за аналіз транзакцій).</span>

<span lang="UK">4. Для конфігурації шлюзу безпечного обміну:</span>

<span lang="UK">- </span><span lang="UK">локальну IP-адресу</span> <span lang="UK">ШБО;</span>

<span lang="UK">- </span><span lang="UK">логін адміністратора ОС</span> <span lang="UK">ШБО, для доступу за допомогою SSH;</span>

<span lang="UK">- </span><span lang="UK">пароль адміністратора ОС</span> <span lang="UK">ШБО, для доступу за допомогою SSH;</span>

<span lang="UK">- </span><span lang="UK">пароль для користувача uxpadmin (</span><span lang="RU">цей </span><span lang="UK">користувач створюється в процесі роботи скрипту</span> <span lang="UK">і використовується для входу користувача з роллю Адміністратор вебсервісів);</span>

<span lang="UK">- </span><span lang="UK">URL-адресу CMP сервера КНЕДП, який видав електронну печатку організації для роботи шлюзу. </span>

<span lang="UK">5. Для встановлення системи моніторингу Zabbix необхідно ввести «Так» (або «yes»):</span>

<span lang="UK">![](https://docs.trembita.gov.ua/uploads/images/gallery/2024-09/ZuEt18lETFukzl6h-embedded-image-i4shz8l1.png)</span>

<span lang="UK">6. Для конфігурації серверу моніторингу </span>Zabbix <span lang="UK">необхідно вести:</span>

<span lang="UK">- </span><span lang="UK">IP-адресу віртуальної машини для серверу Zabbix;</span>

<span lang="UK">- </span><span lang="UK">логін адміністратора ОС для доступу за допомогою SSH;</span>

<span lang="UK">- </span><span lang="UK">пароль адміністратора ОС серверу Zabbix для доступу за допомогою SSH.</span>

<span lang="UK">Нижче наведено приклад заповнення деяких вихідних даних:</span>

<span lang="UK">![](https://docs.trembita.gov.ua/uploads/images/gallery/2024-09/ugnH6GKX9q5Mpst5-embedded-image-19witiwm.png)</span>

<span lang="UK">Після заповнення всіх даних необхідно ввести «yes»:</span>

<span lang="UK">![](https://docs.trembita.gov.ua/uploads/images/gallery/2024-09/vivvLqGtzC9TbNeJ-embedded-image-gciy75az.png)</span>

<span lang="UK">та очікувати завершення роботи скрипта.</span>

<span lang="UK">Після того, як скрипт завершить роботу, у директорії /trembita\_installation буде створено файл results.txt, в якому містяться усі логіни для всіх компонентів промислового середовища системи «Трембіта»:</span>

<span lang="UK">![](https://docs.trembita.gov.ua/uploads/images/gallery/2024-09/I8es5AWpKW5Nwbda-embedded-image-oxkyzbf2.png)</span>

<span lang="UK">Після закінчення встановлення локальних компонентів, необхідно виконати початкову конфігурацію та налаштування локальних компонентів згідно розділів 7-10 даної інструкції, а також налаштувати локальний моніторинг ШБО згідно розділу 11 даної інструкції. </span>

# 6.5 Можливі помилки під час виконання скрипта

<span lang="UK">Під час роботи скрипта можуть статися помилки. Нижче наведено приклади виводу помилок та шляхи їх виправлення:</span>

<table border="1" cellpadding="0" cellspacing="0" class="MsoTableGrid" id="bkmrk-%D0%A2%D0%B5%D0%BA%D1%81%D1%82-%D0%BF%D0%BE%D0%BC%D0%B8%D0%BB%D0%BA%D0%B8-%D0%A8%D0%BB%D1%8F%D1%85%D0%B8-" style="width: 959px; border-collapse: collapse; border: none;" width="661"><thead><tr style="mso-yfti-irow: 0; mso-yfti-firstrow: yes; height: 21.75pt;"><td style="width: 239.646px;" valign="top"><span lang="UK">Текст помилки</span>

</td><td style="width: 599.688px;" valign="top"><span lang="UK">Шляхи виправлення</span>

</td></tr></thead><tbody><tr style="mso-yfti-irow: 1; height: 27.5pt;"><td style="width: 239.646px;" valign="top"><span lang="UK">Не вистачає привілеїв.</span>

</td><td style="width: 599.688px;" valign="top"><span lang="UK">Команда python3 run.py повинна запускатися з привілеями sudo чи від імені користувача root</span>

</td></tr><tr style="mso-yfti-irow: 2; height: 47.25pt;"><td style="width: 239.646px;" valign="top"><span lang="UK">УВАГА! Не можу підключитися до сервера!</span>

</td><td style="width: 599.688px;" valign="top"><span lang="UK">Логін, пароль чи IP-адреса помилкові, скрипт не може встановити SSH-сесію з сервером. Перевірити та вказати правильний логін, пароль та IP-адресу відповідного компоненту</span>

</td></tr><tr style="mso-yfti-irow: 3; height: 47.25pt;"><td style="width: 239.646px;" valign="top">Server OS version FAIL!!!!

</td><td style="width: 599.688px;" valign="top"><span lang="UK">Версія операційної системи відрізняється від Ubuntu 18.04, встановлення не може бути продовжене. Необхідно встановити операційну систему </span><span lang="UK">Ubuntu Server 18.04.4 LTS 64bit</span>

</td></tr><tr style="mso-yfti-irow: 4; mso-yfti-lastrow: yes; height: 30.65pt;"><td style="width: 239.646px;" valign="top">Playbook for server fail!

</td><td style="width: 599.688px;" valign="top"><span lang="UK">Сталася непередбачувана помилка під час встановлення, збережіть дані з терміналу для подальшого аналізу.</span>

</td></tr></tbody></table>

# 6.6. Додавання додаткових облікових записів користувачів

#### 6.6.1. Додавання облікового запису користувача на Робочій станції адміністратора

<p class="callout warning">**<span lang="UK">Важливо!</span>**<span lang="UK"> В промисловому середовищі системи «Трембіта» доступ до її локальних компонентів має здійснюватися з використанням веббраузеру </span>Mozilla Firefox<span lang="UK"> або SSH виключно через Робочу станцію адміністратора відповідно до рольової моделі, [наведеної на рисунку 3.1](https://docs.trembita.gov.ua/link/177#bkmrk-%D0%A0%D0%B8%D1%81%D1%83%D0%BD%D0%BE%D0%BA-3.1-%E2%80%93-%D0%A0%D0%BE%D0%BB%D1%8C%D0%BE%D0%B2) даної інструкції.</span></p>

<span lang="UK">Для того, щоб створити новий обліковий запис користувача, що зможе авторизуватися на Робочій станції адміністратора, необхідно в командній консолі даної робочої станції:</span>

<span lang="UK">1. Виконати команду:</span>

```
sudo uxp-ua-add-admin-user.sh <username>
```

<span lang="UK">де **&lt;username&gt;** </span><span lang="UK">–</span> <span lang="UK">логін створюваного користувача латиницею.</span>

<span lang="UK">2. Ввести пароль нового користувача двічі.</span>

---

#### 6.6.2. Додавання додаткового облікового запису Адміністратора вебсервісів


<p class="callout warning">**Важливо!** В разі, якщо виникає необхідність роботи з вебінтерфейсом ШБО у декількох співробітників Учасника системи "Трембіта", кожен з них обов'язково повинен мати власний обліковий запис!</p>

<span lang="UK">Шлюз безпечного обміну використовує локальних користувачів і групи операційної системи для контролю доступу до вебінтерфейсу адміністрування шлюзу безпечного обміну.</span>

<span lang="UK">Обліковий запис, що використовується для входу в вебінтерфейс адміністрування шлюзу безпечного обміну – це обліковий запис Адміністратора вебсервісів (за замовчуванням з логіном uxpadmin).</span>

<span lang="UK">Для створення додаткового Адміністратора вебсервісів, Адміністратору локальних компонентів (системному адміністраторові) необхідно:</span>

<span lang="UK">1. Послідовно виконати наступні команди:</span>

```
sudo useradd -M -N <username>
sudo chsh -s /bin/false <username>
sudo passwd <username>
```

де **&lt;username&gt;** - логін створюваного користувача латиницею.

2\. Ввести пароль нового користувача двічі.

---

#### 6.6.3. Додавання додаткового облікового запису Відповідального за управління ключами

<span lang="UK">У випадку, коли локальні компоненти системи «Трембіта» адмініструє Оператор, уповноваженому співробітнику Суб’єкта електронної взаємодії, що відповідає за встановлення інформаційної взаємодії та управління особистими ключами електронної печатки (Відповідальному за управління ключами), потрібно надати доступ до функціоналу ШБО.</span>

<span lang="UK">Для цього потрібно створити обліковий запис Відповідального за управління ключами, який буде використовуватись для входу в вебінтерфейс адміністрування ШБО, шляхом послідовного виконання наступних команд:</span>

```
sudo useradd -M -N <security-officer>
sudo adduser <security-officer> uxp-security-officer
sudo chsh -s /bin/false <security-officer>
sudo passwd <security-officer>
```

де **&lt;security-officer&gt;** - логін створюваного користувача латиницею.

Після виконання цих команд необхідно ввести пароль нового користувача двічі.


<div id="bkmrk--5" style="mso-element: comment-list;"><div style="mso-element: comment;"><div class="msocomtxt" id="bkmrk--6" language="JavaScript" onmouseout="msoCommentHide('_com_1')" onmouseover="msoCommentShow('_anchor_1','_com_1')"></div></div></div>