Призначення чек-листа

Цей чек-лист — покроковий контрольний список для безпечного оновлення програмного забезпечення валідатора Solana. Він охоплює період від створення резервних копій до повного відновлення участі в консенсусі. Чек-лист не замінює офіційну документацію, а структурує її у практичну послідовність дій, щоб мінімізувати простої та ризик втрати делегованого стейку.

Етапи оновлення

Резервне копіювання конфігурації та ключів

  • Зупиніть сервіс валідатора (systemctl stop agave-validator) до будь-яких змін файлів.
  • Створіть повну копію каталогу з конфігурацією (зазвичай ~/solana/validator-keypair.json та ~/solana/identity.json).
  • Збережіть копію на окремому фізичному носії або віддаленому сервері, який не залежить від поточної ноди.
  • Перевірте цілісність скопійованих файлів: розмір та формат мають збігатися з оригіналами.
  • Зафіксуйте поточну версію клієнта (команда agave-validator --version) і хеш останнього коміту репозиторію.

Тестування оновлення на тестовій ноді

  • Розгорніть паралельну ноду на тестовій мережі (testnet або devnet) з тією самою конфігурацією апаратного забезпечення та ОС.
  • Застосуйте плановане оновлення на тестовій ноді.
  • Переконайтеся, що нода стартує без критичних помилок у логах (journalctl -u agave-validator).
  • Перевірте, чи тестова нода досягає консенсусу та синхронізується з мережею.
  • Якщо тестове оновлення виявить проблеми сумісності — залишіть продакшн-ноду на поточній версії та дочекайтеся виправлення.

Застосування оновлення на продакшн-ноду

  • Перевірте офіційні канали спільноти (GitHub, Discord) на предмет відомих проблем із новою версією.
  • Оновіть бінарні файли через перевірений механізм (agave-install update або збірка з перевіреного тегу репозиторію).
  • Перевірте хеш та підпис оновлених бінарних файлів.
  • Запустіть валідатор і негайно контролюйте логи перших хвилин роботи.
  • Якщо протягом перших 60 секунд з'являються критичні помилки — зупиніть ноду та відкотіть до резервної копії бінарних файлів.

Перевірка синхронізації та консенсусу

  • Переконайтеся, що слот валідатора просувається вперед (команда solana slot показує зростання).
  • Перевірте відстань до найвищого слота мережі — вона має бути в межах прийнятного вікна (зазвичай не більше кількох слотів).
  • Перевірте статус голосування: валідатор має відправляти голоси кожні кілька слотів (solana validators або моніторинг панелі).
  • Переконайтеся, що делегований стейк не зменшився через пропущені слоти (перевірте епоху та баланс).
  • Зафіксуйте нову версію клієнта та час завершення оновлення у власному логі операцій.

Критерії успішного оновлення

  • Валідатор працює без перезапусків протягом щонайменше однієї повної епохи після оновлення.
  • Відстань до найвищого слота мережі стабільно знаходиться в межах норми і не зростає.
  • Голосування валідатора фіксується в кожному слоті без пропусків.
  • Логи не містять помилок рівня ERROR або CRITICAL, пов'язаних із консенсусом, банкоматом (bank) або мережевою синхронізацією.
  • Делегований стейк зберігається або зростає — немає штрафів за пропущені слоти.

Обмеження чек-листа

  • Чек-лист стосується виключно процесу оновлення програмного забезпечення валідатора. Підготовку сервера (налаштування ОС, дисків, мережі, фаєрвола) дивіться в окремому Чек-листі підготовки сервера валідатора.
  • Фінансову оцінку доцільності оновлення (витрати на простої, поріг беззбитковості) розраховуйте за допомогою Калькулятора беззбитковості валідатора.
  • Чек-лист не охоплює оновлення сторонніх інструментів: моніторингу, автоматизації, інфраструктурних скриптів.
  • Він не замінює перевірку сумісності з конкретними версіями ОС, залежностями або кастомними патчами, якщо ви їх використовуєте.
  • У разі форк-оновлень або екстрених хард-форків послідовність дій може відрізнятися — орієнтуйтеся на офіційні оголошення.

Версія ресурсу

Ресурс «Чек-лист оновлення валідатора»: статична версія 1.0. Сторінка містить готовий текстовий чек-лист і готова до практичного використання без очікування окремого інтерактивного інструмента. Остання редакційна перевірка: 2 серпня 2026 року.

Джерела