Як запустити вузол (ноду) на Quai Network?

Тут ми будемо встановлювати ноду Quai Network (go-quai). Цей гайд орієнтований для Linux та MacOS.

Встановлюємо залежності

Щоб запустити екземпляр go-quai, вам потрібно буде встановити кілька залежностей. Ви можете встановити залежності за допомогою свого улюбленого менеджера пакетів (apt, brew тощо). Для запуску вузла потрібні такі залежності:

sudo apt update

sudo apt install snapd

Інсталяція Linux Snap

Для Linux:

sudo snap install go — classic

Для MacOS:

brew install go

Інсталяція Git & Make

Для Linux:

sudo apt install git make

Для MacOS:

brew install git make

Інсталяція go-quai

Тепер, коли ви встановили базові залежності, ми можемо продовжити та клонувати репозиторій go-quai.

Щоб клонувати репозиторій go-quai і перейти до нього, виконайте такі команди:

git clone https://github.com/dominant-strategies/go-quai cd go-quai

Ця команда встановлює головну гілку на вашу локальну машину. Ви можете знайти останній випуск на сторінці go-quai. Щоб переглянути останню версію:

git checkout put-latest-release-here

Конфігурація вузла

Після того, як ви успішно встановили go-quai, вам потрібно буде налаштувати свій вузол. network.env.dist— файл конфігурації вузла. Скопіюйте шаблонний файл, network.env, щоб ми могли створити власну конфігурацію.

cp network.env.dist network.env

У файлі network.envміститься ряд важливих параметрів, які ми налаштуємо для правильного запуску нашого вузла. Наведені нижче змінні потрібно правильно встановити.

• COINBASE: адреса на яку виплачуються винагороди за майнінг. Зауважте, що на шард (Prime, Region та Zone) можлива одна адреса coinbase.
• NETWORK: мережа (testnet, devnet тощо), у якій працює ваш вузол.

Цей файл також містить низку додаткових параметрів, які не розглядатимуться в цій статті.

Відкрийте конфігураційний файл у вашому улюбленому текстовому редакторі або IDE.

• vim
• nano
• Visual Studio Code

nano network.env

Якщо ви хочете майнити, замініть фіктивні адреси coinbase своїми власними для ланцюжків, які ви збираєтеся майнити. Якщо ви цього не зробите, ваші винагороди за майнінг не будуть надіслані на ваші адреси.

Встановіть NETWORKтаку, яку ви плануєте запустити. Доступні параметри мережі можна знайти на сторінки характеристик мережі.

Тепер, коли ми створили джерело, нам потрібно вирішити, який тип вузла запустити. Як описано на сторінці огляду вузла, користувачі можуть вибрати глобальний вузол або базовий вузол залежно від індивідуального варіанта використання та апаратного забезпечення.

Запустити глобальний вузол

Щоб запустити повний вузол (Global Node):

make go-quai

Глобальні вузли (Global Node) перевіряють усі ланцюги в мережі Quai. Щоб запустити Global Node:

make run-all

Вимоги до апаратного забезпечення для запуску глобального вузла під час Iron Age Testnet:

Запустити базовий вузол (Base Node) (рекомендовано)

Базові вузли запускають те, що називається «шардом» мережі Quai. Шард — це підмножина мережі, яка перевіряє Prime, один Region і один Zone ланцюг. Індекси регіонів і зон мають індекс 0 і варіюються від 0 до 2.

Щоб розкрутити вузол шарду, виберіть регіон і індекс зони та запустіть:

make run -slice REGION=0 ZONE=0

Оператори вузлів повинні самостійно вибирати шард. Надання початкової пропозиції щодо географічної організації прискорить мінімізацію затримки.

Вимоги до апаратного забезпечення для запуску базового вузла для Iron Age:

Запуск вузла призведе до запуску всіх екземплярів go-quai у фоновому режимі та створення каталогу під назвою nodelogs. Logs з вузла будуть передаватись до конкретного контекстного .logфайлу всередині журналів. Щоб переглянути logs:

tail -f nodelogs/prime.log

OR

tail -f nodelogs/region-2.log

OR

tail -f nodelogs/zone-0–0.log

Перевірка вихідних даних журналів вузла — найкращий спосіб переконатися, що повний вузол працює правильно. Ви також можете легко переглядати журнали вузлів у своїй улюбленій IDE, ми рекомендуємо використовувати цей метод.

Результати правильно запущеного вузла мають виглядати так:

Щоб зупинити виведення журналу на термінал, ви можете використовувати CTRL+C.

Залежно від того, що зараз робить ваш вузол, ваші журнали можуть виглядати не зовсім так, як вище.

Зупинку вашого вузла слід робити щоразу, коли ви вносите зміни у свій конфігураційний файл або перед вимиканням машини. Команда для зупинки:

make stop

Це призведе до знищення всіх екземплярів go-quaiна вашій машині. Іноді це може тривати кілька секунд.

Якщо ви використовуєте майнер, запустити make stopне вийде. Ви повинні завершити процес майнера перед зупинкою вузла.

Переконайтеся, що ваш вузол працює належним чином, має вирішальне значення як для функціональності будь-якої залежної інфраструктури, так і для мережі в цілому.

Оновлення

Ініціювання процесу оновлення вузла під час роботи вузла або менеджера може спричинити проблеми. Перед оновленням обов’язково зупиніть усі процеси.

Щоб оновити вузол, спершу вимкніть усі екземпляри go-quai за допомогою наведеної вище команди зупинки.

Після зупинки вузла ви повинні виконати оновлення:

git pull && git fetch — all

і перебудуйте джерело за допомогою:

make go-quai

Після оновлення ви можете безпечно перезапустити вузол і продовжити роботу.

Очищення

Скидання вузла та очищення бази даних призведе до видалення будь-якого стану, який ви синхронізували. Це необоротна дія, і будь-які команди, зазначені нижче, слід використовувати з обережністю.

Виникають ситуації, коли нам потрібно повністю очистити ваш вузол від синхронізованого стану або виконати повне скидання у разі проблеми чи помилки. Повне скидання вузла передбачає зупинку вузла, очищення поточних журналів вузлів і видалення всіх синхронізованих станів.

Нагадування: скидання вашого вузла не можна скасовувати, і його слід робити, лише якщо ви розумієте наслідки видалення всіх синхронізованих станів.

Для машин Linux ми видалимо nodelogsкаталог і базовий .quaiкаталог, який містить увесь синхронізований стан. Для цього виконайте таку команду:

rm -rf nodelogs ~/.quai

Для машин MacOS ми використаємо іншу команду для видалення тих самих каталогів:

rm -rf nodelogs ~/Library/Quai

Після виконання однієї з двох наведених вище команд вузол повністю скинуто та готовий до перезапуску.