ブロックログを設定する手順

このマニュアルでは、海外ギルドオペレーター制作のツールを組み合わせてブロックログを表示させるプログラムとなっております。
最終更新日：2021/1/30 23:43
🎉 ∞ お知らせ
このツールは海外ギルドオペレーター制作のCNCLI By AndrewWestberg、logmonitor by Guild Operators、Guild LiveView、BLOCK LOG for CNToolsを組み合わせたツールとなっております。カスタマイズするにあたり、開発者のAHLNET(AHL)にご協力頂きました。ありがとうございます。
🏁 0. 前提条件
稼働ノード
BPノード限定
稼働要件
４つのサービス(プログラム)をsystemd × tmuxにて常駐させます。
ブロックチェーン同期用DBを新しく設置します(sqlite3)
日本語マニュアルのフォルダ構成に合わせて作成されています。
vrf.skey と vrf.vkeyが必要です。
ハードウェア最小構成
オペレーティング・システム: 64-bit Linux (Ubuntu 20.04 LTS)
プロセッサー: 1.6GHz以上(ステークプールまたはリレーの場合は2Ghz以上)の2つ以上のコアを備えたIntelまたはAMD x86プロセッサー
メモリ：8GB  
SSD：50GB以上
インストール及びダウンロードツール内容
CNCLI (依存プログラム含む)　(コミュニティ製Cardano CLI)
sqlite3 (データベースソフト)
logmonitor.sh (ノードログ抽出プログラム)
block.sh　(ブロックログ表示ブログラム)
cncli.sh　(CNCLI操作用プログラム)
cntools.config (設定ファイル)
cntools.library　(ライブラリファイル)
env (設定ファイル)
gLiveView.sh (ノード監視ツール)
すでに導入済みの方は、1月30日以前から導入済みの方はこちらから
ファイルアップデートをお願いします。
🏁 1. CNCLIをインストールする
​AndrewWestbergさんによって開発されたCNCLIはプールのブロック生成スケジュールを算出ツールを開発し、Shelley期におけるSPOに革命をもたらしました。
RUST環境を準備します
mkdir $HOME/.cargo && mkdir $HOME/.cargo/bin
chown -R $USER $HOME/.cargo
touch $HOME/.profile
chown $USER $HOME/.profile
rustupをインストールします-デフォルトのインストールを続行します（オプション1）
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
1) Proceed with installation (default) 1を入力してEnter
source $HOME/.cargo/env
rustup install stable
rustup default stable
rustup update
依存関係をインストールし、cncliをビルドします
source $HOME/.cargo/env
sudo apt-get update -y
sudo apt-get install automake build-essential pkg-config libffi-dev libgmp-dev libssl-dev libtinfo-dev libsystemd-dev zlib1g-dev make g++ tmux git jq wget libncursesw5 libtool autoconf -y
cd $HOME/git
git clone https://github.com/AndrewWestberg/cncli
cd cncli
git checkout v1.4.0
cargo install --path . --force
CNCLIのバージョンを確認します。
cncli --version
1-1. CNCLI更新手順
以下は最新版がリリースされた場合に実行してください
cncli旧バージョンからの更新手順
サービスを止める
sudo systemctl stop cnode-cncli-sync.service
sudo systemctl stop cnode-cncli-validate.service
sudo systemctl stop cnode-cncli-leaderlog.service
rustup update
cd $HOME/git/cncli
git fetch --all --prune
git checkout v1.4.0
cargo install --path . --force
cncli --version
sudo systemctl start cnode-cncli-sync.service
tmux a -t cncli
#cncliの更新がある場合は、以下メッセージが出ますので「y」を入力してEnter
A new version is available, do you want to upgrade? (yes/no): y
​
###同じ画面内で以下コマンドを入力しcncliを再起動
cd $NOHE_HOME/scripts
./cncli.sh sync
cncli.shのバージョンアップ確認があれば「Yes」を選択
再度実行し、sync 100%になることを確認する。
残りのサービスを開始する
sudo systemctl start cnode-cncli-validate.service
sudo systemctl start cnode-cncli-leaderlog.service
🏁 2. sqlite3をインストールする
sudo apt install sqlite3
sqlite3 --version
3.31.1以上のバージョンがインストールされたらOKです。
🏁 3. 各種ファイルをダウンロードする
依存関係のあるプログラムをダウンロードします。
海外のギルドオペレーターによって開発された革新的な各種ツールです。
cd $NODE_HOME
mkdir scripts
cd $NODE_HOME/scripts
wget -N https://raw.githubusercontent.com/cardano-community/guild-operators/master/scripts/cnode-helper-scripts/cncli.sh
wget -N https://raw.githubusercontent.com/cardano-community/guild-operators/master/scripts/cnode-helper-scripts/cntools.config
wget -N https://raw.githubusercontent.com/cardano-community/guild-operators/master/scripts/cnode-helper-scripts/cntools.library
wget -N https://raw.githubusercontent.com/cardano-community/guild-operators/master/scripts/cnode-helper-scripts/env
wget -N https://raw.githubusercontent.com/cardano-community/guild-operators/master/scripts/cnode-helper-scripts/logMonitor.sh
wget -N https://raw.githubusercontent.com/cardano-community/guild-operators/master/scripts/cnode-helper-scripts/gLiveView.sh
wget -N https://raw.githubusercontent.com/btbf/coincashew/master/guild-tools/blocks.sh
3-1.パーミッションを設定する
chmod 755 cncli.sh
chmod 755 logMonitor.sh
chmod 755 gLiveView.sh
chmod 755 blocks.sh
cd ../
chmod 400 vrf.vkey
3-2.設定ファイルを編集する
envファイルを編集します
cd scripts
nano env
ファイル内上部にある設定値を変更します。
先頭の # を外し、ご自身の環境に合わせuser_nameパスやファイル名、ポート番号を設定します。
下記以外の#がついている項目はそのままで良いです。
CCLI="/usr/local/bin/cardano-cli"
CNODE_HOME=/home/<user_name>/cardano-my-node
CNODE_PORT=6000
CONFIG="${CNODE_HOME}/mainnet-config.json"
SOCKET="${CNODE_HOME}/db/socket"
BLOCKLOG_TZ="Asia/Tokyo"　　
　　
POOL_FOLDER="${CNODE_HOME}"
POOL_ID_FILENAME="stakepoolid.txt"
cncli.shファイルを編集します。
nano cncli.sh
ファイル内の設定値を変更します。
先頭の # を外し、ご自身の環境に合わせてプールIDやファイル名を設定します。
POOL_ID="<Pool-ID>"
POOL_VRF_SKEY="${CNODE_HOME}/vrf.skey"
POOL_VRF_VKEY="${CNODE_HOME}/vrf.vkey"
🏁 4.サービスファイル4種類を作成・登録します。
cd $NODE_HOME
mkdir service
cd service
cncli
validate
leaderlog
logmonitor
cncli
cat > $NODE_HOME/service/cnode-cncli-sync.service << EOF 
# file: /etc/systemd/system/cnode-cncli-sync.service
​
[Unit]
Description=Cardano Node - CNCLI sync
BindsTo=cnode-cncli-sync.service
After=cnode-cncli-sync.service
​
[Service]
Type=oneshot
RemainAfterExit=yes
Restart=on-failure
RestartSec=20
User=$(whoami)
WorkingDirectory=$NODE_HOME
ExecStart=/usr/bin/tmux new -d -s cncli
ExecStartPost=/usr/bin/tmux send-keys -t cncli $NODE_HOME/scripts/cncli.sh Space sync Enter
ExecStop=/usr/bin/tmux kill-session -t cncli
KillSignal=SIGINT
RestartKillSignal=SIGINT
SuccessExitStatus=143
StandardOutput=syslog
StandardError=syslog
SyslogIdentifier=cnode-cncli-sync
TimeoutStopSec=5
​
[Install]
WantedBy=cnode-cncli-sync.service
EOF
validate
cat > $NODE_HOME/service/cnode-cncli-validate.service << EOF 
# file: /etc/systemd/system/cnode-cncli-validate.service
​
[Unit]
Description=Cardano Node - CNCLI validate
BindsTo=cnode-cncli-validate.service
After=cnode-cncli-validate.service
​
[Service]
Type=oneshot
RemainAfterExit=yes
Restart=on-failure
RestartSec=20
User=$(whoami)
WorkingDirectory=$NODE_HOME
ExecStart=/usr/bin/tmux new -d -s validate
ExecStartPost=/usr/bin/tmux send-keys -t validate $NODE_HOME/scripts/cncli.sh Space validate Enter
ExecStop=/usr/bin/tmux kill-session -t validate
KillSignal=SIGINT
RestartKillSignal=SIGINT
SuccessExitStatus=143
StandardOutput=syslog
StandardError=syslog
SyslogIdentifier=cnode-cncli-validate
TimeoutStopSec=5
​
[Install]
WantedBy=cnode-cncli-validate.service
EOF
leaderlog
cat > $NODE_HOME/service/cnode-cncli-leaderlog.service << EOF 
# file: /etc/systemd/system/cnode-cncli-leaderlog.service
​
[Unit]
Description=Cardano Node - CNCLI Leaderlog
BindsTo=cnode-cncli-leaderlog.service
After=cnode-cncli-leaderlog.service
​
[Service]
Type=oneshot
RemainAfterExit=yes
Restart=on-failure
RestartSec=20
User=$(whoami)
WorkingDirectory=$NODE_HOME
ExecStart=/usr/bin/tmux new -d -s leaderlog
ExecStartPost=/usr/bin/tmux send-keys -t leaderlog $NODE_HOME/scripts/cncli.sh Space leaderlog Enter
ExecStop=/usr/bin/tmux kill-session -t leaderlog
KillSignal=SIGINT
RestartKillSignal=SIGINT
SuccessExitStatus=143
StandardOutput=syslog
StandardError=syslog
SyslogIdentifier=cnode-cncli-leaderlog
TimeoutStopSec=5
​
[Install]
WantedBy=cnode-cncli-leaderlog.service
EOF
logmonitor
cat > $NODE_HOME/service/cnode-logmonitor.service << EOF 
# file: /etc/systemd/system/cnode-logmonitor.service
​
[Unit]
Description=Cardano Node - CNCLI Leaderlog
BindsTo=cnode-logmonitor.service
After=cnode-logmonitor.service
​
[Service]
Type=oneshot
RemainAfterExit=yes
Restart=on-failure
RestartSec=20
User=$(whoami)
WorkingDirectory=$NODE_HOME
ExecStart=/usr/bin/tmux new -d -s logmonitor
ExecStartPost=/usr/bin/tmux send-keys -t logmonitor $NODE_HOME/scripts/logMonitor.sh Enter
ExecStop=/usr/bin/tmux kill-session -t logmonitor
KillSignal=SIGINT
RestartKillSignal=SIGINT
SuccessExitStatus=143
StandardOutput=syslog
StandardError=syslog
SyslogIdentifier=cnode-logmonitor
TimeoutStopSec=5
​
[Install]
WantedBy=cnode-logmonitor.service
EOF
4-1サービスファイルをシステムフォルダにコピーして権限を付与します。
1行づつコマンドに貼り付けてください
sudo cp $NODE_HOME/service/cnode-cncli-sync.service /etc/systemd/system/cnode-cncli-sync.service
sudo cp $NODE_HOME/service/cnode-cncli-validate.service /etc/systemd/system/cnode-cncli-validate.service
sudo cp $NODE_HOME/service/cnode-cncli-leaderlog.service /etc/systemd/system/cnode-cncli-leaderlog.service
sudo cp $NODE_HOME/service/cnode-logmonitor.service /etc/systemd/system/cnode-logmonitor.service
sudo chmod 644 /etc/systemd/system/cnode-cncli-sync.service
sudo chmod 644 /etc/systemd/system/cnode-cncli-validate.service
sudo chmod 644 /etc/systemd/system/cnode-cncli-leaderlog.service
sudo chmod 644 /etc/systemd/system/cnode-logmonitor.service
4-2サービスファイルを有効化します
sudo systemctl daemon-reload
sudo systemctl enable cnode-cncli-sync.service
sudo systemctl enable cnode-cncli-validate.service
sudo systemctl enable cnode-cncli-leaderlog.service
sudo systemctl enable cnode-logmonitor.service
4-3.ログファイルを作成するように設定する
cd $NODE_HOME
nano mainnet-config.json
defaultScribesを下記のように書き換える
"defaultScribes": [
  [
    "FileSK",
    "logs/node.json"
  ],
  [
    "StdoutSK",
    "stdout"
  ]
],
setupScribesを下記のように書き換える
 "setupScribes": [
  {
    "scFormat": "ScJson",
    "scKind": "FileSK",
    "scName": "logs/node.json"
  },
  {
    "scFormat": "ScText",
    "scKind": "StdoutSK",
    "scName": "stdout",
    "scRotation": null
  }
]
Ctrl+Oでファイルを保存し、Ctrl+Xで閉じる
ノードを再起動する
sudo systemctl reload-or-restart cardano-node
🏁 5.ブロックチェーンとDBを同期する
cncli-syncサービスを開始し、ログ画面を表示します
sudo systemctl start cnode-cncli-sync.service
tmux a -t cncli
「100.00% synced」になるまで待ちます。
100%になったら、Ctrl+bを押した後に d を押し元の画面に戻ります(バックグラウンド実行に切り替え)
🏁 6.過去のブロック生成実績をDBに登録します。
cd $NODE_HOME/scripts
./cncli.sh init
🏁 7.残りのサービスをスタートします
1行づつコマンドに貼り付けてください
sudo systemctl start cnode-cncli-validate.service
sudo systemctl start cnode-cncli-leaderlog.service
sudo systemctl start cnode-logmonitor.service
tmux起動確認
tmux ls
5つの画面がバックグラウンドで起動中であればOKです
cnode  
cncli
leaderlog
logmonitor
validate
●各種サービスをストップする方法
sudo systemctl stop cnode-cncli-sync.service
sudo systemctl stop cnode-cncli-validate.service
sudo systemctl stop cnode-cncli-leaderlog.service
sudo systemctl stop cnode-logmonitor.service
●各種サービスを再起動する方法
sudo systemctl reload-or-restart cnode-cncli-sync.service
sudo systemctl reload-or-restart cnode-cncli-validate.service
sudo systemctl reload-or-restart cnode-cncli-leaderlog.service
sudo systemctl reload-or-restart cnode-logmonitor.service
7-1.　3プログラムのログ画面を確認します。
validate
leaderlog
logmonitor
validate
こちらのプログラムは生成したブロックが、ブロックチェーン上に記録されているか照合するためのプログラムです
tmux a -t validate
以下表示なら正常です。
~ CNCLI Block Validation started ~
Ctrl+b d でバックグラウンド実行に切り替えます(デタッチ)
leaderlog
こちらのプログラムはスロットリーダーを自動的に算出するプログラムです。
次エポックの1.5日前になると自動的に次エポックのスロットリーダーが算出されます。
tmux a -t leaderlog
以下の表示なら正常です。
スケジュール予定がある場合、表示されるまでに5分ほどかかります。
~ CNCLI Leaderlog started ~
Shelley transition epoch found: 208
Ctrl+b d でバックグラウンド実行に切り替えます(デタッチ)
logmonitor
こちらのプログラムはプールのノードログからブロック生成結果を抽出します。
tmux a -t logmonitor
以下の表示なら正常です。
~~ LOG MONITOR STARTED ~~
monitoring logs/node.json for traces
Ctrl+b d でバックグラウンド実行に切り替えます(デタッチ)
🏁 8.ブロックログを表示する
このツールでは上記で設定してきたプログラムを組み合わせ、割り当てられたスロットリーダーに対してのブロック生成結果をデータベースに格納し、確認することができます。
cd $NODE_HOME/scripts
./blocks.sh
ブロックステータス:
Leader   - ブロック生成予定スロット  
Ideal     - アクティブステーク（シグマ）に基づいて割り当てられたブロック数の期待値/理想値  
Luck      - 期待値における実際に割り当てられたスロットリーダー数のパーセンテージ  
Adopted   - ブロック生成成功  
Confirmed - 生成したブロックのうち確実にオンチェーンであることが検証されたブロック  set in 'cncli.sh' for 'CONFIRM_BLOCK_CNT'  
Missed    - スロットでスケジュールされているが、 cncli DB には記録されておらず他のプールがこのスロットのためにブロックを作った可能性  
Ghosted   - ブロックは作成されましたが「Orpah(孤立ブロック)」となっております。 スロットバトル・ハイトバトルで敗北したか、ブロック伝播の問題で有効なブロックになっていません  
Stolen    - 別のプールに有効なブロックが登録されているため、IOHK OBFT NODEによってブロックが生成された可能性  
Invalid   - プールはブロックの作成に失敗しました。base64でエンコードされたエラーメッセージ。次のコードでデコードできます 'echo  | base64 -d | jq -r' 
メニュー項目が文字化けする場合は、システム文字コードが「UTF-8」であることを確認してください。
echo $LANG
🏁 9.gLiveViewでブロック生成サマリを確認する
cd $NODE_HOME/scripts
./gLiveView.sh
スクリプトへのパスを通し、任意の単語で起動出来るようにする。
echo alias blocks="$NODE_HOME/scripts/blocks.sh" >> $HOME/.bashrc
echo alias glive="$NODE_HOME/scripts/gLiveView.sh" >> $HOME/.bashrc
source $HOME/.bashrc
単語を入力するだけで、どこからでも起動できます。
blocks・・・blocks.sh
glive・・・gLiveView.sh
🏁 10. 1月30日以前から導入済みの方はこちら
10-1.各種サービスをストップする
sudo systemctl stop cnode-cncli-sync.service
#[パスワードを入力する]
sudo systemctl stop cnode-cncli-validate.service
sudo systemctl stop cnode-cncli-leaderlog.service
sudo systemctl stop cnode-logmonitor.service
10-2.各種ファイルをアップデートする
cd $NODE_HOME/scripts
wget -N https://raw.githubusercontent.com/cardano-community/guild-operators/master/scripts/cnode-helper-scripts/cncli.sh
wget -N https://raw.githubusercontent.com/cardano-community/guild-operators/master/scripts/cnode-helper-scripts/cntools.config
wget -N https://raw.githubusercontent.com/cardano-community/guild-operators/master/scripts/cnode-helper-scripts/cntools.library
wget -N https://raw.githubusercontent.com/cardano-community/guild-operators/master/scripts/cnode-helper-scripts/env
wget -N https://raw.githubusercontent.com/cardano-community/guild-operators/master/scripts/cnode-helper-scripts/logMonitor.sh
wget -N https://raw.githubusercontent.com/btbf/coincashew/master/guild-tools/blocks.sh
10-3.各種ファイルを編集する
envファイルを編集します
cd scripts
nano env
ファイル内上部にある設定値を変更します。
先頭の # を外し、ご自身の環境に合わせuser_nameパスやファイル名、ポート番号を設定します。
下記以外の#がついている項目はそのままで良いです。
CCLI="/usr/local/bin/cardano-cli"
CNODE_HOME=/home/<user_name>/cardano-my-node
CNODE_PORT=6000
CONFIG="${CNODE_HOME}/mainnet-config.json"
SOCKET="${CNODE_HOME}/db/socket"
BLOCKLOG_TZ="Asia/Tokyo"　　
　　
POOL_FOLDER="${CNODE_HOME}"
POOL_ID_FILENAME="stakepoolid.txt"
cncli.shファイルを編集します。
nano cncli.sh
ファイル内の設定値を変更します。
先頭の # を外し、ご自身の環境に合わせてプールIDやファイル名を設定します。
POOL_ID="<Pool-ID>"
POOL_VRF_SKEY="${CNODE_HOME}/vrf.skey"
POOL_VRF_VKEY="${CNODE_HOME}/vrf.vkey"
10-4.サービスをスタートする
sudo systemctl start cnode-cncli-sync.service
sudo systemctl start cnode-cncli-validate.service
sudo systemctl start cnode-cncli-leaderlog.service
sudo systemctl start cnode-logmonitor.service
10-5. 起動確認する
cd $NODE_HOME/scripts
./blocks.sh
​3プログラムのログ画面も合わせてご確認ください。
前
外部リレーノードのセットアップ(翻訳中)
最終更新 18 hours ago
ブロックログを設定する手順

🎉 ∞ お知らせ

🏁 0. 前提条件

稼働ノード

稼働要件

ハードウェア最小構成

インストール及びダウンロードツール内容

🏁 1. CNCLIをインストールする

1-1. CNCLI更新手順

🏁 2. sqlite3をインストールする

🏁 3. 各種ファイルをダウンロードする

3-1.パーミッションを設定する

3-2.設定ファイルを編集する

🏁 4.サービスファイル4種類を作成・登録します。

4-1サービスファイルをシステムフォルダにコピーして権限を付与します。

4-2サービスファイルを有効化します

4-3.ログファイルを作成するように設定する

🏁 5.ブロックチェーンとDBを同期する

🏁 6.過去のブロック生成実績をDBに登録します。

🏁 7.残りのサービスをスタートします

●各種サービスをストップする方法

●各種サービスを再起動する方法

7-1. 3プログラムのログ画面を確認します。

🏁 8.ブロックログを表示する

🏁 9.gLiveViewでブロック生成サマリを確認する

🏁 10. 1月30日以前から導入済みの方はこちら

10-1.各種サービスをストップする

10-2.各種ファイルをアップデートする

10-3.各種ファイルを編集する

10-4.サービスをスタートする

10-5. 起動確認する

7-1.　3プログラムのログ画面を確認します。
