Установка, настройка и мониторинг ноды Zcash

Я много работаю с криптовалютами, поэтому решил написать цикл статей по этому поводу. Сегодня я расскажу, как установить и настроить ноду Zcash, а так же сделать ее мониторинг с помощью Zabbix. Информация уникальная и в рунете практически нет ничего на эту тему, так что я решил поделиться.

Цели статьи

1. Установить ноду криптовалюты zcash на свой сервер.
2. Настроить удаленную работу через rpc ноды с авторизацией.
3. Сделать мониторинг ноды с помощью zabbix.

Введение

Я настраивал и работал с нодами всех популярных и не очень криптовалют. Участвовал в запуске нескольких криптобирж. У меня накопился большой опыт работы с ними. Информация эта очень узкая и специфичная. Почитать чей-то опыт практически негде, даже в англоязычном интернете.

Я все изучал и настраивал сам. За основу брал только официальную документацию. В работе нод много нюансов, которые нужно учитывать. Постараюсь поделиться основной информацией, которая у меня есть.

Я уже писал статью про настройку нод криптовалют, а так же их мониторинг, но это все частично устарело, особенно установка. Надо все обновить. В этот раз будет по каждой ноде отдельная статья, чтобы не мешать все в кучу.

Системные требования zcash

Системные требования zcash, которые указаны в документации:

• 64-х битный процессор.
• 5G оперативной памяти.
• 25 Gb диск

Нода zcash нормально запускается на виртуальной машине с 2 CPU, 4 Gb памяти и ssd диском. На момент написания статьи, блокчейн занимал 25 Gb. Места под него должно быть не меньше. С учетом того, что блокчейн постоянно растет, надо делать запас.

Установка ноды zcash

Ставится zcash не сложно, но и не сказать, что просто, так как готовые пакеты есть только под Debian. Я обычно под ноды использую Ubuntu, поэтому собирать буду из исходников. Хотя пакет от Debian скорее всего подойдет и под Ubuntu, но я не люблю экспериментов. Из исходников точно заработает так, как надо.

Для начала установим необходимые для сборки zcash зависимости.

# apt install build-essential pkg-config libc6-dev m4 g++-multilib autoconf libtool ncurses-dev unzip git python python-zmq zlib1g-dev wget curl bsdmainutils automake

Копируем к себе репозиторий.

# git clone https://github.com/zcash/zcash.git

Выбираем ветку с последней версией.

# cd zcash/
# git checkout v2.1.0-1

Запускаем скрипт, который скачивает необходимые для сборки файлы. Качать будет много, порядка 1,7 Gb.

# ./zcutil/fetch-params.sh

После этого запускаем сборку.

# ./zcutil/build.sh -j$(nproc)

Установим скомпилированные бинарники в систему:

# cd src
# install -sv zcashd zcash-cli /usr/local/bin/
# install -sv zcash-gtest zcash-tx /usr/local/bin/

Обновление ноды zcash обычно выглядит так:

1. Скачиваем и компилируем новые исходники.
2. Останавливаем ноду, заменяем старые исходники.
3. Запускаем ноду.

Если не было больших изменений, приводящих к переиндексации или полному обновлению блокчейна, то все пройдет быстро. В том случае, если нода запустит индексацию блокчейна, то простой может быть значительный, на некоторых нодах до нескольких часов.

Когда нода в работе, обновление надо обязательно предварительно тестировать и смотреть, к чему оно приводит. В проде я обычно держу 2 ноды - основную и резервную. На резервной тестируется обновление. Если все ОК, она становится основной, а рабочая уходит в резерв. И так каждый раз ротируется при обновлении.

Настройка и удаленный доступ

Теперь создадим фай конфигурации ноды zcash в директории ~/.zcash.

# mkdir ~/.zcash
# mcedit ~/.zcash/zcash.conf

rpcuser=username
rpcpassword=password
addnode=mainnet.z.cash
rpcbind=0.0.0.0
rpcallowip=0.0.0.0/0

Я для теста разрешил слушать все ip адреса сервера и подключаться отовсюду. Чаще всего это не нужно. Ограничивайте доступ к ноде списком только своих доверенных адресов. Я всегда это делаю, если нода поддерживает такую возможность. Например, parity для ноды ethereum не имеет таких настроек. Дополнительно я всегда ограничиваю доступ к ноде на уровне iptables. Настоятельно рекомендую это делать.

В общем случае ноду лучше запускать не от пользователя root. Более того, некоторые ноды невозможно запустить под рутом, они хотят отдельного пользователя. У меня обычно нода это виртуальная машина, где кроме самой ноды ничего нет. В этом случае нет принципиальной разницы с точки зрения безопасности, от root она работает или нет.

Запуск и проверка работы

Мы установили и настроили ноду zcash. Теперь запускаем ее. Она поддерживает работу как в виде обычного приложения в консоли, так и в режиме демона. Первый раз можете запустить ее прямо в консоли, чтобы тут же увидеть результат работы.

# zcashd

Нода сразу же начинает качать блоки, что видно в ее интерфейсе. Вообще, zcash одна из немногих нод, где все очень наглядно и понятно. Не надо выискивать информацию о блоках, трафике где-то в логах или в запросах к ноде. Все очень наглядно.

В принципе, можно запускать ноду в этом режиме в screen, тогда можно очень быстро и просто посмотреть ее статус. В таком виде ее можно и в автозапуск добавить. Но надежнее запускать ноды zcash как демон. Она поддерживает такой режим.

# zcashd --daemon

Нода запускается в виде службы. За ее состоянием можно следить по логу - ~/zcash/debug.log. Для автозапуска достаточно добавить в cron:

# crontab -e

@reboot zcashd -daemon

Состояние ноды можно проверить через консоль с помощью zcash-cli.

# zcash-cli getinfo
{
  "version": 2010051,
  "protocolversion": 170009,
  "walletversion": 60000,
  "balance": 0.00000000,
  "blocks": 368,
  "timeoffset": 0,
  "connections": 1,
  "proxy": "",
  "difficulty": 824.4417744689738,
  "testnet": false,
  "keypoololdest": 1579797402,
  "keypoolsize": 101,
  "paytxfee": 0.00000000,
  "relayfee": 0.00000100,
  "errors": ""
} 

Корректно остановить работу ноды zcash можно командой:

# zcash-cli stop

Теперь попробуем выполнить удаленный запрос о состоянии ноды через rpc. Для этого идем на любой другой linux сервер, где есть curl. Главное, проверить работу с сервера приложений, где будет крутиться софт для работы с нодой. В консоли выполняем команду:

# curl --data-binary '{"jsonrpc":"1.0","id":"curltext","method":"getblockchaininfo","params":[]}' -H 'content-type:text/plain;' http://username:password@10.20.1.18:8232/

8232 - дефолтный порт, который слушает нода, если вы его явно не указывали в конфигурационном файле. Следите за правильностью набора пользователя или пароля. Если укажете неправильно, в ответ ничего не получите, что несколько сбивает с толку. Информация об этом будет в debug.log, но там ее так много, что трудно заметить то, что надо.

В ответ на запрос получите информацию о состоянии ноды в json формате.

Читается в консоли не очень, зато удобно парсить данные, в том числе для системы мониторинга. Об этом будет рассказано далее. Полное описание api для удаленных запросов можно посмотреть в документации - https://zcash.readthedocs.io/en/latest/rtd_pages/zig.html.

Мониторинг работы ноды zcash

Расскажу, как я мониторю работу ноды. Для этого использую Zabbix.

Если у вас еще нет своего сервера для мониторинга, то рекомендую материалы на эту тему. Для тех, кто предпочитает систему CentOS:

1. Установка CentOS 8.
2. Настройка CentOS 8.
3. Установка и настройка zabbix сервера.

То же самое на Debian 10, если предпочитаете его:

1. Установка Debian 10.
2. Базовая настройка Debian.
3. Установка и настройка zabbix на debian.

Здесь я не буду останавливаться на заббиксе подробно. Для этого у меня есть отдельные статьи. Расскажу сразу суть - что и как мониторю.

В одной из недавних версий у Zabbix появились http агенты, с помощью которых можно отправлять post запросы. Это очень упростило многие задачи по мониторингу. То, что я раньше делал с помощью скриптов и curl теперь можно делать прямо в шаблоне и свободно переносить с сервера на сервер в виде экспорта и импорта шаблона.

Что я мониторю в ноде zcash:

1. Работу самой службы zcashd на сервере.
2. Состояние блокчена и разницу между headers и blocks. Первое это количество блоков в блокчейне, а второе - номер блока, который синхронизирован на твоей ноде.
3. Состояние сети блокчейна, активна или нет.

И соответственно триггеры:

1. Служба zcashd не работает.
2. Нода начинает отставать, разница между headers и blocks превышает 50 или 100 блоков.
3. Сеть блокчейна неактивна.

Теперь как это реализовано. В конце будет готовый шаблон.

Таймаут можно побольше ставить, часто 3 секунды не хватает. Этот итем собирает вот такие данные:

Дальше делаем зависимые элементы, для данных из headers и blocks.

И в предобработке выделяем нужный нам JSONPATH.

По аналогии то же самое делается для blocks. Потом делаем простой триггер с их сравнением.

В данном случае разница в 9 блоков была просьба программистов. Я не знаю, какая именно разница критична для работы.

Дальше берется состояние network запросом:

# curl --data-binary '{"jsonrpc":"1.0","id":"curltext","method":"getnetworkinfo","params":[]}' -H 'content-type:text/plain;' http://username:password@10.20.1.18:8232/

Делается итем по аналогии с blockchaininfo. И для него зависимый элемент и триггер на наличие слова true в данных из JSONPATH по пути $.result.networks[:1].reachable.

Вот итоговый список итемов и триггеров.

Готовый шаблон с этими элементами - zabbix-zcash.xml. Импорт делался с версии сервера 4.4 В шаблоне нет графиков. Обычно все это смотрится в Latest Data.

На этом по установке, настройке и мониторингу ноды zcash у меня все.

Заключение

Это первая статья из цикла. Я планирую пройтись по всем основным и популярным нодам - bitcoin, bitcoin cash, ethereum, litecoin, dash, cardano, destream, tron, neo, ripple xrp и др.

Если у вас есть желание каким-то образом использовать ноды, открыть криптобиржу или что-то связанное с блокчейном, можете обращаться ко мне. У меня большой практический опыт работы с ними - установка, обслуживание, обновление, мониторинг. Могу подобрать площадку для размещения, запланировать ресурсы, рассчитать затраты на размещение и т.д.

Помогла статья? Подписывайся на telegram канал автора