このページは英語からの機械翻訳を使用しており、誤りや不明瞭な表現が含まれている可能性があります。最も正確な情報については、オリジナルの英語版をご覧ください。頻繁な更新のため、一部のコンテンツはオリジナルの英語になっている可能性があります。Crowdinでの取り組みに参加して、このページの翻訳改善にご協力ください。 (Crowdin translation page, Contributing guide)

コンセンサス・ノードの設置

ダウンロード

ダウンロード](../../downloads/downloads.md) ページから kcn の最新版をダウンロードできます。

インストール

Linuxアーカイブ・ディストリビューション

アーカイブファイルは実行バイナリとコンフィギュレーションファイルで構成され、以下のような構造になっている。

注：ファイル構造やファイル名を変更しないでください。これを変更すると、ノードが正しく機能しなくなる可能性があります。


- bin
  |- kcn
  |- kcnd
- conf
  |- kcnd.conf

ファイル名	ファイルの説明
bin/kcn	CN実行ファイル
bin/kcnd	CN開始/終了スクリプトファイル
conf/kcnd.conf	CN設定ファイル

インストールとは、ダウンロードしたパッケージをインストールしたい場所に解凍することである。


$ tar zxf kcn-vX.X.X-linux-amd64.tar.gz

あるいは


$ tar zxf kcn-baobab-vX.X.X-linux-amd64.tar.gz

注: kcn と kcnd をグローバルに実行するには、環境変数 $PATH に kcn-linux-amd64/bin のパスを追加することを推奨する。一例を挙げよう、


$ export PATH=$PATH:~/downloaded/path/kcn-linux-amd64/bin

他のセクションは、変数にパスが追加されていることを前提としている。

RPM Distribution (RHEL/CentOS/Fedora)

ダウンロードしたRPMファイルは、以下のyumコマンドでインストールできる。


$ yum install kcnd-vX.X.X.el7.x86_64.rpm

あるいは


$ yum install kcnd-baobab-vX.X.X.el7.x86_64.rpm

Kaia Yum Repoからインストールする

あるいは、Kaia Yum repoからkcndをインストールして実行することもできる：


sudo curl -o /etc/yum.repos.d/kaia.repo https://packages.kaia.io/config/rhel/7/kaia.repo && sudo yum install kcnd

設置場所

インストールされるファイルは以下の通り。

ファイル名	所在地
kcn	/usr/bin/kcn
kcnd.conf	/etc/kcnd/conf/kcnd.conf

構成

CNのコンフィギュレーションは、データディレクトリを作成し、コンフィギュレーションファイル kcnd.conf でいくつかの値を設定することである。

CNデータディレクトリを作成する。
ノードキーのインストール
kcnd.confでCNを設定する。

CNデータディレクトリの作成

カイア・ブロックチェーンのデータサイズが常に増加しているという事実を考慮すると、十分な大きさのストレージを使用することをお勧めします。希望のパスにディレクトリを作成する必要があるかもしれません。


$ mkdir -p /var/kcnd/data

ノードキーのインストール

CNを操作するには、nodekeyが必要である。 KCNのバイナリをお持ちでない場合は、新しいバイナリを作成します。もしあれば、CNデータディレクトリにnodekeyを置く必要がある。 nodekeyの作成方法は'インストールする前に'のセクションで説明されている。以下のコマンドラインはnodekeyをCN dataディレクトリにコピーする。


$ cp nodekey /var/kcnd/data

設定ファイルの更新

設定ファイルの場所

アーカイブディストリビューションの場合、config ディレクトリの場所のデフォルトは $INSTALL_PATH/kcn-linux-amd64/conf/ です。
パッケージ配布の場合、configディレクトリのデフォルトは /etc/kcnd/conf/ です。

データディレクトリの追加

設定ファイル kcnd.conf のデータディレクトリ環境変数 $DATA_DIR を更新する必要がある。


...
DATA_DIR=/var/kcnd/data
...

リワードベースの設定

カイア・ネットワークのコンセンサスに参加する報酬として、CNオペレーターはKAIAを受け取る。このため、設定ファイルkcnd.confにアドレスを設定する必要がある。

新しいアカウントを作る方法はいろいろあるが、kcnもその機能を提供している。ヘルプメッセージは以下のコマンドで確認できる。


$ kcn account new --help

この手順の一例は以下の通り。 First of all, you need to create a new account which the reward KLAY will be sent to.


$ kcn account new --datadir ~/kcnd_home
INFO[03/15,09:04:43 +09] [17] Setting connection type                   nodetype=cn conntype=-0
INFO[03/15,09:04:43 +09] [17] Maximum peer count                        KAIA=25 LES=0 total=25
INFO[03/15,09:04:43 +09] [17] SBN is disabled.
Your new account is locked with a password. Please give a password. Do not forget this password.
Passphrase:
Repeat passphrase:
Address: {d13f7da0032b1204f77029dc1ecbf4dae2f04241}

その結果、あなたが定義したパスに関連するキーストアが作成される。次に、作成したアドレスをkcnd.confファイルに以下のように記述する必要がある。


...
REWARDBASE="d13f7da0032b1204f77029dc1ecbf4dae2f04241"
...

作成したキーストアとパスワードはかなり重要なので、管理には十分注意すること。 kcnd.confの詳細については、設定ファイルのセクションを参照してください。

(オプション）Chaindata Snapshotのダウンロード

ジェネシス・ブロックからの同期には時間がかかる。 Chaindata Snapshot](../../../misc/operation/chaindata-snapshot.md) を使用して、Full Sync プロセスをスキップすることができます。

CNの起動

CNスタート/ストップ

以下の systemctl コマンドでKaiaサービスを開始/停止できる。

注：これにはroot権限が必要です。

スタート


$ systemctl start kcnd.service

ストップ


$ systemctl stop kcnd.service

ステータス


$ systemctl status kcnd.service

トラブルシューティング

以下のエラーが発生した場合、


Failed to start kcnd.service: Unit not found.

以下のコマンドでsystemd managerのコンフィギュレーションをリロードする。


$ systemctl daemon-reload

BLS公開鍵情報のエクスポート

ネットワークがRandaoハードフォークを起動した場合、または起動する予定がある場合、各CNメンテナはBLS公開鍵情報をKIP-113スマートコントラクトに提出しなければならない。

BLSの公開鍵情報はnodekeyから計算できる。これを取り出すには、まずノードを起動する。次にコマンドを使う：


$ kcn account bls-info --datadir /var/kcnd/data

その結果、bls-publicinfo-NODEID.jsonファイルが作成される。

コアセルのテスト

Core Cellが正常にインストールされ、期待通りに動作していることを確認します。

プロセス状況

ステータスコマンド systemctl と kcnd を使って CN のプロセスのステータスをチェックすることができる。

systemctl

systemctlはRPMと一緒にインストールされ、以下のようにCNの状態をチェックすることができる。


$ systemctl status kcnd.service
● kcnd.service - (null)
   Loaded: loaded (/etc/rc.d/init.d/kcnd; bad; vendor preset: disabled)
   Active: active (running) since Wed 2019-01-09 11:42:39 UTC; 1 months 4 days ago
     Docs: man:systemd-sysv-generator(8)
  Process: 29636 ExecStart=/etc/rc.d/init.d/kcnd start (code=exited, status=0/SUCCESS)
 Main PID: 29641 (kcn)
   CGroup: /system.slice/kcnd.service
           └─29641 /usr/local/bin/kcn --networkid 1000 --datadir /kcnd_home --port 32323 --srvtype fasthttp --metrics --prometheus --verbosity 3 --txpool.global...
Jan 09 11:42:39 ip-10-11-2-101.ap-northeast-2.compute.internal systemd[1]: Starting (null)...
Jan 09 11:42:39 ip-10-11-2-101.ap-northeast-2.compute.internal kcnd[29636]: Starting kcnd: [  OK  ]
Jan 09 11:42:39 ip-10-11-2-101.ap-northeast-2.compute.internal systemd[1]: Started (null).

上記の例では、Active: active (running) のように現在のステータスを確認することができる。

kcnd

kcndはパッケージと一緒にインストールされ、CNの状態は以下のように確認できる。


$ kcnd status
kcnd is running

過去ログ

ログは kcnd.conf ファイルの LOG_DIR フィールドで定義されたパスにある kcnd.out ファイルに保存される。ノードが正常に動作している場合、各ブロックが1秒間に以下のように作成されることがわかる。

例


$ tail kcnd.out
INFO[02/13,07:02:24 Z] [35] Commit new mining work                    number=11572924 txs=0 elapsed=488.336µs
INFO[02/13,07:02:25 Z] [5] Imported new chain segment                blocks=1 txs=0 mgas=0.000     elapsed=1.800ms   mgasps=0.000       number=11572924 hash=f46d09…ffb2dc cache=1.59mB
INFO[02/13,07:02:25 Z] [35] Commit new mining work                    number=11572925 txs=0 elapsed=460.485µs
INFO[02/13,07:02:25 Z] [35] 🔗 block reached canonical chain           number=11572919 hash=01e889…524f02
INFO[02/13,07:02:26 Z] [14] Committed                                 address=0x1d4E05BB72677cB8fa576149c945b57d13F855e4 hash=1fabd3…af66fe number=11572925
INFO[02/13,07:02:26 Z] [5] Imported new chain segment                blocks=1 txs=0 mgas=0.000     elapsed=1.777ms   mgasps=0.000       number=11572925 hash=1fabd3…af66fe cache=1.59mB
INFO[02/13,07:02:26 Z] [35] Commit new mining work                    number=11572926 txs=0 elapsed=458.665µs
INFO[02/13,07:02:27 Z] [14] Committed                                 address=0x1d4E05BB72677cB8fa576149c945b57d13F855e4 hash=60b9aa…94f648 number=11572926
INFO[02/13,07:02:27 Z] [5] Imported new chain segment                blocks=1 txs=0 mgas=0.000     elapsed=1.783ms   mgasps=0.000       number=11572926 hash=60b9aa…94f648 cache=1.59mB
INFO[02/13,07:02:27 Z] [35] Commit new mining work                    number=11572927 txs=0 elapsed=483.436µs

kcnコンソール

KaiaはCLIクライアントkcn consoleを提供している。しかし、CNは、セキュリティ上の理由から、クライアントのRPCインターフェースを無効にすることができる。クライアントを使うもう一つの方法は、IPC（プロセス間通信）を介してプロセスに接続することである。

IPC ファイル klay.ipc は CN の DATA_DIR パスにある。

以下のコマンドを実行し、結果を確認してください。


$ ken attach --datadir /var/kend/data
カイアJavaScriptコンソールへようこそ！
インスタンス：Kaia/vX.X.X/XXXX-XXXX/goX.X.X
 datadir：/var/kend/data
 modules: admin:1.0 debug:1.0 governance:1.0 istanbul:1.0 klay:1.0 miner:1.0 net:1.0 personal:1.0 rpc:1.0 txpool:1.0
>

使用可能なコマンドはAPIドキュメントで確認できます。

CNのステータスをチェックするのに便利なAPI：

kaia.blockNumber (最新のブロック番号を取得する)
net.peerCount (現在接続されているKaiaノードの数を取得する)

klay.blockNumber

最新のブロック番号を取得し、ノードタイプに基づいてブロックが正しく作成（CNの場合）または伝播（CNおよびPNの場合）されているかどうかを確認できます。


> klay.blockNumber
11573819

ネットピアカウント


> net.peerCount
14

上記のコマンドラインは、ノードのタイプに応じて異なる値を返す。

CN：接続されたCNの数＋接続されたPNの数。
PN：接続CN数＋接続PN数＋接続EN数。

ダウンロード​

インストール​

Linuxアーカイブ・ディストリビューション​

RPM Distribution (RHEL/CentOS/Fedora) ​

Kaia Yum Repoからインストールする​

設置場所​

構成​

CNデータディレクトリの作成​

ノードキーのインストール​

設定ファイルの更新​

データディレクトリの追加 ​

リワードベースの設定​

(オプション）Chaindata Snapshotのダウンロード​

CNの起動​

CNスタート/ストップ ​

トラブルシューティング​

BLS公開鍵情報のエクスポート​

コアセルのテスト​

プロセス状況​

systemctl ​

kcnd ​

過去ログ​

kcnコンソール​

klay.blockNumber ​

ネットピアカウント ​