コンテンツにスキップ

ノードアップデートマニュアル

このガイドは ノードバージョン10.2.1に対応しています。
最終更新日：2025年3月26日　　

バージョン対応表

  • 各依存関係もバージョンアップしてますのでよくお読みになって進めてください
Node CLI GHC Cabal CNCLI
10.2.1 10.4.0.0 9.10.1 3.12.1.0 6.5.1

■アップデートパターンDB再構築有無

バージョン DB再構築有無 設定ファイル更新有無 トポロジーファイル更新有無
9.0.0~9.2.1→10.2.1 あり 更新あり 更新なし
10.1.4→10.2.1 なし 更新なし 更新なし
  • 作業前にブロック生成スケジュールを確認し余裕のある作業をお願いします
  • 複数行のコードをコードボックスのコピーボタンを使用してコマンドラインに貼り付ける場合は、最後の行が自動実行されないため確認の上Enterを押してコードを実行してください。
主な変更点と新機能および検証結果

cardano-node v10.2.1

  • トポロジーファイルにLedgerピアスナップショットパスが追加
  • ローカルルートピアグループ設定にdiffusionModeを追加
  • 新トレーシングシステムをデフォルトで有効化。旧システムを利用する場合はconfigファイルに"UseTraceDispatcher": falseを追加する

cardano-cli v10.4.0.0

  • cardano-cli conway transaction signの実行結果にTxIDを返す

検証結果

■検証環境 Ubuntu22.04 / PreProd-Testnet / cardano-node 10.2.1 / cardano-cli 10.4.0.0 / SJG-TOOL 3.9.3

検証項目 結果
ソースコートビルド ✅
ブロック生成 ✅
リソース監視 ✅
報酬出金 ✅
ウォレット送金 ✅
KES更新 ✅
ガバナンス投票 ✅

1.依存環境アップデート

1-1. システムアップデート

システムアップデート 

sudo apt update -y && sudo apt upgrade -y

1-2. 依存関係バージョン確認

cabalバージョン確認 

cabal --version

正常戻り値 cabal-install version 3.12.1.0

GHCバージョン確認 

ghc --version

正常戻り値 The Glorious Glasgow Haskell Compilation System, version 9.10.1

libsodiumコミット確認 

cd $HOME/git/libsodium
git branch --contains | grep -m1 HEAD | cut -c 21-28

正常戻り値 dbb48cce

secp256k1バージョン確認 

cd $HOME/git/secp256k1
git branch --contains | grep -m1 HEAD | cut -c 21-27

正常戻り値 acf5c55

Blstバージョン確認
インストール済みバージョン 

cat /usr/local/lib/pkgconfig/libblst.pc | grep Version

正常戻り値 Version 0.3.11

各アプリのバージョン(戻り値)が異なる場合
cabal 3.8.1.0以下の場合

cabal 3.8.1.0以下の場合のみ実行 cabalバージョンアップ 

ghcup upgrade
ghcup install cabal 3.12.1.0
ghcup set cabal 3.12.1.0
cabalバージョン確認 
cabal --version

戻り値 cabal-install version 3.12.1.0
compiled using version 3.12.1.0 of the Cabal library

GHC 8.10.7以下の場合

GHC 8.10.7以下の場合のみ実行 

ghcup upgrade
ghcup install ghc 9.10.1
ghcup set ghc 9.10.1

ghc --version

戻り値
The Glorious Glasgow Haskell Compilation System, version 9.10.1

libsodiumコミット値が違う場合 
cd ~/git/libsodium
git fetch --all --prune
git checkout dbb48cc
./autogen.sh
./configure
make
make check
sudo make install

makeコマンド実行後半に出現する warning は無視して大丈夫です。

secp256k1コミット値が違うまたは戻り値が無い場合 
cd $HOME/git/secp256k1/
git fetch --all --prune --recurse-submodules --tags
git checkout acf5c55
./autogen.sh
./configure --prefix=/usr --enable-module-schnorrsig --enable-experimental
make
make check
戻り値確認 
Testsuite summary for libsecp256k1 0.3.2
============================================================================
# TOTAL: 3
# PASS:  3
# SKIP:  0
# XFAIL: 0
# FAIL:  0
# XPASS: 0
# ERROR: 0
============================================================================

PASS:3であることを確認する

インストールコマンドを必ず実行する 

sudo make install

Blst 0.3.10以下または「No such file or directory」の場合 
cd $HOME/git/blst
git fetch --all --prune --recurse-submodules --tags
git checkout tags/v0.3.11
./build.sh

cd $HOME/git
git clone https://github.com/supranational/blst
cd blst
git checkout v0.3.11
./build.sh

設定ファイル作成

このボックスはすべてコピーして実行してください
cat > libblst.pc << EOF
prefix=/usr/local
exec_prefix=\${prefix}
libdir=\${exec_prefix}/lib
includedir=\${prefix}/include

Name: libblst
Description: Multilingual BLS12-381 signature library
URL: https://github.com/supranational/blst
Version: 0.3.11
Cflags: -I\${includedir}
Libs: -L\${libdir} -lblst
EOF

設定ファイルコピー

このボックスは1行ずつコピーして実行してください

sudo cp libblst.pc /usr/local/lib/pkgconfig/
sudo cp bindings/blst_aux.h bindings/blst.h bindings/blst.hpp  /usr/local/include/
sudo cp libblst.a /usr/local/lib
sudo chmod u=rw,go=r /usr/local/{lib/{libblst.a,pkgconfig/libblst.pc},include/{blst.{h,hpp},blst_aux.h}}

バージョン確認 

cat /usr/local/lib/pkgconfig/libblst.pc | grep Version

Version 0.3.11

1-3.CNCLIバージョン確認(BPのみ)

CNCLIバージョン確認 

cncli --version

以下の戻り値ならOK
cncli 6.5.1

cncli v6.5.0以下だった場合(クリックして開く)

CNCLIをアップデートする

cd $HOME
cncli_release="$(curl -s https://api.github.com/repos/cardano-community/cncli/releases/latest | jq -r '.tag_name' | sed -e "s/^.\{1\}//")"

curl -sLJ https://github.com/cardano-community/cncli/releases/download/v${cncli_release}/cncli-${cncli_release}-ubuntu22-x86_64-unknown-linux-musl.tar.gz -o $HOME/cncli-${cncli_release}-x86_64-unknown-linux-musl.tar.gz

tar xzvf $HOME/cncli-${cncli_release}-x86_64-unknown-linux-musl.tar.gz -C $HOME/.cargo/bin/

rm $HOME/cncli-${cncli_release}-x86_64-unknown-linux-musl.tar.gz

バージョン確認 

cncli --version

cncli v6.5.1になったことを確認する

2.ノードアップデート

バイナリファイルインストール方法の違いについて

  • ビルド済みバイナリ・・・IntersectMBOリポジトリソースコードからビルドされたバイナリファイルをダウンロードします。ビルド不要のためビルド時間を短縮できます。

  • ソースコードからビルド・・・ご自身のサーバーでソースコードからビルドしてバイナリファイルを作成します。検証目的やソースコードからビルドしたい場合に利用できます。ビルドに30分前後かかります。Raspberry Piを使用してプールを構築する場合は、ARM用コンパイラでコンパイルする必要があります。

2-1.バイナリダウンロード

現在インストール中のノードバージョンを控える 

current_node=$(cardano-node version | grep cardano-node)
echo $current_node

旧バイナリを削除する 

rm -rf $HOME/git/cardano-node-old/

バイナリファイルをダウンロードする 

mkdir $HOME/git/cardano-node2
cd $HOME/git/cardano-node2
wget -q https://github.com/IntersectMBO/cardano-node/releases/download/10.2.1/cardano-node-10.2.1-linux.tar.gz

解凍する 

tar zxvf cardano-node-10.2.1-linux.tar.gz ./bin/cardano-node ./bin/cardano-cli

バージョン確認

$(find $HOME/git/cardano-node2 -type f -name "cardano-cli") version  
$(find $HOME/git/cardano-node2 -type f -name "cardano-node") version
以下の戻り値を確認する

cardano-cli 10.4.0.0 - linux-x86_64 - ghc-8.10
git rev 52b708f37cd3dc92a188717deae2a6a60117f696

cardano-node 10.2.1 - linux-x86_64 - ghc-8.10
git rev 52b708f37cd3dc92a188717deae2a6a60117f696

ノードをストップする 

sudo systemctl stop cardano-node

2-2.バイナリインストール

バイナリーファイルをシステムフォルダーへコピーする

sudo cp $(find $HOME/git/cardano-node2 -type f -name "cardano-cli") /usr/local/bin/cardano-cli

sudo cp $(find $HOME/git/cardano-node2 -type f -name "cardano-node") /usr/local/bin/cardano-node

システムに反映されたノードバージョンを確認する

cardano-cli version
cardano-node version

以下の戻り値を確認する

cardano-cli 10.4.0.0 - linux-x86_64 - ghc-8.10
git rev 52b708f37cd3dc92a188717deae2a6a60117f696

cardano-node 10.2.1 - linux-x86_64 - ghc-8.10
git rev 52b708f37cd3dc92a188717deae2a6a60117f696

2-1.ソースコードダウンロード

現在インストール中のノードバージョンを控える 

current_node=$(cardano-node version | grep cardano-node)
echo $current_node

新しいTMUXセッションを開く

tmux new -s build

アップデート作業中にSSHが中断した場合は、tmux a -t buildで再開できます。

旧ビルドを削除する 

rm -rf $HOME/git/cardano-node-old/

ソースコードをダウンロードする 

cd $HOME/git
git clone https://github.com/IntersectMBO/cardano-node.git cardano-node2
cd cardano-node2/

2-2.ソースコードからビルド

cabal clean
cabal update

git fetch --all --recurse-submodules --tags
git checkout tags/10.2.1
cabal configure --with-compiler=ghc-9.10.1

cabal build all cardano-cli

ヒント

  • ビルド完了までに数十分ほどかかります。
  • SSH接続が途中で切断された場合、再度接続してtmux a -t buildで再開してください。
  • ビルド中にデタッチ(Ctrl+B D)してバックグラウンド処理へ切り替えられます。

バージョン確認

$(./scripts/bin-path.sh cardano-cli) version  
$(./scripts/bin-path.sh cardano-node) version

以下の戻り値を確認する

cardano-cli 10.4.0.0 - linux-x86_64 - ghc-9.10
git rev 52b708f37cd3dc92a188717deae2a6a60117f696

cardano-node 10.2.1 - linux-x86_64 - ghc-9.10
git rev 52b708f37cd3dc92a188717deae2a6a60117f696

ビルド用TMUXセッションを終了する 

exit

ノードをストップする 

sudo systemctl stop cardano-node

バイナリーファイルをシステムフォルダーへコピーする

cd $HOME/git/cardano-node2
sudo cp $(./scripts/bin-path.sh cardano-cli) /usr/local/bin/cardano-cli

cd $HOME/git/cardano-node2
sudo cp $(./scripts/bin-path.sh cardano-node) /usr/local/bin/cardano-node

システムに反映されたノードバージョンを確認する

cardano-cli version
cardano-node version

以下の戻り値を確認する

cardano-cli 10.4.0.0 - linux-x86_64 - ghc-9.10
git rev 52b708f37cd3dc92a188717deae2a6a60117f696

cardano-node 10.2.1 - linux-x86_64 - ghc-9.10
git rev 52b708f37cd3dc92a188717deae2a6a60117f696

2-3.設定ファイル更新

既存ファイルバックアップ 

mkdir -p $NODE_HOME/backup
cp $NODE_HOME/${NODE_CONFIG}-config.json $NODE_HOME/backup/${NODE_CONFIG}-config.json

新ファイルダウンロード

BPとリレーで実行するコマンドが異なるので、対象サーバーごとにタブを切り替えてください

cd $NODE_HOME
wget --no-use-server-timestamps -q https://book.play.dev.cardano.org/environments/${NODE_CONFIG}/config.json -O ${NODE_CONFIG}-config.json

cd $NODE_HOME
wget --no-use-server-timestamps -q https://book.play.dev.cardano.org/environments/${NODE_CONFIG}/config-bp.json -O ${NODE_CONFIG}-config.json

設定ファイルを書き換える

sed -i ${NODE_CONFIG}-config.json \
    -e '2i \  "SnapshotInterval": 86400,' \
    -e 's!"AlonzoGenesisFile": "alonzo-genesis.json"!"AlonzoGenesisFile": "'${NODE_CONFIG}'-alonzo-genesis.json"!' \
    -e 's!"ByronGenesisFile": "byron-genesis.json"!"ByronGenesisFile": "'${NODE_CONFIG}'-byron-genesis.json"!' \
    -e 's!"ShelleyGenesisFile": "shelley-genesis.json"!"ShelleyGenesisFile": "'${NODE_CONFIG}'-shelley-genesis.json"!' \
    -e 's!"ConwayGenesisFile": "conway-genesis.json"!"ConwayGenesisFile": "'${NODE_CONFIG}'-conway-genesis.json"!' \
    -e 's!"TraceBlockFetchDecisions": false!"TraceBlockFetchDecisions": true!' \
    -e 's!"rpKeepFilesNum": 10!"rpKeepFilesNum": 30!' \
    -e 's!"rpMaxAgeHours": 24!"rpMaxAgeHours": 48!' \
    -e '/"defaultScribes": \[/a\    \[\n      "FileSK",\n      "'${NODE_HOME}'/logs/node.json"\n    \],' \
    -e '/"setupScribes": \[/a\    \{\n      "scFormat": "ScJson",\n      "scKind": "FileSK",\n      "scName": "'${NODE_HOME}'/logs/node.json"\n    \},' \
    -e "s/127.0.0.1/0.0.0.0/g"
9.2.1以下からのアップデートの場合はこちらも実施

DB更新

Mithirlインストール 

cd $HOME/git
mithril_release="$(curl -s https://api.github.com/repos/input-output-hk/mithril/releases/latest | jq -r '.tag_name')"
wget https://github.com/input-output-hk/mithril/releases/download/${mithril_release}/mithril-${mithril_release}-linux-x64.tar.gz -O mithril.tar.gz

設定 

tar zxvf mithril.tar.gz mithril-client
sudo cp mithril-client /usr/local/bin/mithril-client
パーミッション設定 
sudo chmod +x /usr/local/bin/mithril-client

DLファイル削除 

rm mithril.tar.gz mithril-client

バージョン確認 

mithril-client -V

Mithril Githubのリリースノート内にあるmithril-client-cliのバージョンをご確認ください。

スナップショット復元

作業用TMUX起動 

tmux new -s mithril

変数セット 

export NETWORK=mainnet
export AGGREGATOR_ENDPOINT=https://aggregator.release-mainnet.api.mithril.network/aggregator
export GENESIS_VERIFICATION_KEY=$(wget -q -O - https://raw.githubusercontent.com/input-output-hk/mithril/main/mithril-infra/configuration/release-mainnet/genesis.vkey)
export SNAPSHOT_DIGEST=latest

旧dbをバックアップしたい方はこちら

空き容量に関しての注意事項

DBをバックアップする場合、サーバーディスクの空き容量をご確認ください。 安定稼働のためには250GB以上の空き容量が必要です。 

df -h /usr | awk '{print $4}'
Availが250GB以上あることを確認してください。

dbをリネームする 

mv $NODE_HOME/db/ $NODE_HOME/backup/db9/

ノードバージョンアップ後の作業

稼働に問題がないことが確認でき次第削除することをお勧めします。 

rm -rf $NODE_HOME/backup/db9/

既存DB削除 

rm -rf $NODE_HOME/db

最新スナップショットDL 

mithril-client cardano-db download --download-dir $NODE_HOME latest

スナップショットダウンロード～解凍まで自動的に行われます。1/5～5/5が終了するまで待ちましょう

DBスナップショットDL/解答完了メッセージ

5/5 - Verifying the cardano db signature…
Cardano db 'xxxxx' has been unpacked and successfully checked against Mithril multi-signature contained in the certificate.
('xxxxx'は作業時期によって変わります。下の文字列は無視して大丈夫です)

tmux作業ウィンドウを終了する 

exit

2-4.サーバー再起動

作業フォルダリネーム

前バージョンで使用していたバイナリフォルダをリネームし、バックアップとして保持します。最新バージョンを構築したフォルダをcardano-nodeとして使用します。

cd $HOME/git
mv cardano-node/ cardano-node-old/
mv cardano-node2/ cardano-node/

サーバーを再起動する 

sudo reboot

SSH接続してノード同期状況を確認する 

sudo journalctl --unit=cardano-node --follow

ノードログメッセージ確認

以下のメッセージがログに含まれている場合に同期状況を判断できます。

メッセージ ステータス
Chain extended, new tip: xxxxxxxx at slot xxxxxx チェーン同期成功
GenesisReadFileError ジェネシスファイルエラー
InvalidYaml 設定ファイルエラー
Invalid option 起動オプションエラー
Invalid argument 起動コマンドエラー
Address in use ノード起動ポートが競合しています

3. 依存関係作業

3-1.リレー/BP共通

gLiveView更新 

sed -i $NODE_HOME/scripts/env \
    -e '1,40s!UPDATE_CHECK="N"!UPDATE_CHECK="Y"!'

gliveを起動する 

glive

更新メッセージが表示されたらyesを入力してenter

env script update(s) detected, do you want to download the latest version? (yes/no): yes

gLiveView.sh更新完了のメッセージが表示されたら再度enter

gLiveView.sh update successfully applied!
press any key to proceed ..

更新フラグを切り替える 

sed -i $NODE_HOME/scripts/env \
    -e '1,40s!UPDATE_CHECK="Y"!UPDATE_CHECK="N"!'

gliveバージョン確認 

glive

Koios gLiveView v1.30.4

3-2.BPサービス確認

ブロック生成ステータス通知またはSPO Block Notifyを未導入(更新)していない方

10-4.サービスファイル作成・登録を再実行してください。（エイリアス設定は不要です）

SPO Block Notify移行マニュアルから新規導入または更新を実施してください。

BPノードが完全に同期した後、サービス起動状態を確認する

  • cnclilog
  • leaderlog
  • validate
  • logmonitor
  • blocknotify(SPO Block Notifyを導入している場合)
cnclilogでMissing eta_v for block xxxxxx エラーが出る場合の対処法

cncliを再同期してください

sudo systemctl stop cnode-cncli-sync.service

rm $NODE_HOME/guild-db/cncli/*

sudo systemctl restart cnode-cncli-sync.service

cnclilog
100% sync'dになるまでお待ち下さい

4. エアギャップアップデート

SFTP機能ソフト導入

R-loginの転送機能が遅いので、大容量ファイルをダウン・アップロードする場合は、SFTP接続可能なソフトを使用すると効率的です。（FileZilaなど）
ファイル転送に便利なSFTP機能ソフトの導入手順はこちら

4-1.バイナリファイルコピー

リレーサーバーで以下を実行する

sudo cp $(find $HOME/git/cardano-node -type f -name "cardano-cli") ~/cardano-cli

リレーサーバーで以下を実行する

cd $HOME/git/cardano-node
sudo cp $(./scripts/bin-path.sh cardano-cli) ~/cardano-cli

SFTP機能ソフト(Filezillaなど)で転送元サーバーに接続し、以下をダウンロードする

  • /home/usr/cardano-cli

をローカルパソコンにダウンロードします
(エアギャップUbuntuとの共有フォルダ)


エアギャップマシンにファイルを入れる

  • $HOME/git/cardano-node2/ にcardano-cliを入れる
    (cardano-node2が無ければ作成する)

4-2.インストール

エアギャップマシンで以下を実行する

cardano-cliをシステムフォルダへコピーする 

sudo cp $(find $HOME/git/cardano-node2 -type f -name "cardano-cli") /usr/local/bin/cardano-cli

4-3.バージョン確認

cardano-cli version

以下の戻り値を確認する

cardano-cli 10.1.1.0 - linux-x86_64 - ghc-8.10
git rev 1f63dbf2ab39e0b32bf6901dc203866d3e37de08

確認

エアギャップではcardano-nodeは使用しないため転送してもしなくてもOKです。