symbol-network
symbol-network 命令一覧
Google 翻訳
これは Symbol node が動作する環境なら動きます
docker
docker-compose
node.js
以上が入っていれば良いです
まずは symbol-network の ｲﾝｽﾄｰﾙ
sudo npm install -g symbol-network
network 作成用の ﾃﾞｨﾚｸﾄﾘ を作成し そこに入る
mkdir newnetwork
cd newnetwork
では始めましょう
1つ目の コマンド symbol-network init --ready
symbol-network init --ready
新しい network を作りますか？と聞いています "y" で
bootstrap
testnet
mainnet
既に持っている custom-network-preset.yml
この4つから選べます 今回は testnet を選びます
ここは私が持っている domain dusan.gqを使用する事にしましょうか
建てる node の host名の先頭にnewnetworkが付きます
node の host名の付け方を決めます ここは[enter]で
すると node の host名がnewnetwork-dual-001となります
複数の node を作成した場合は 更に
002 003と振られます
この作業が終わるとkey-store.ymlと言う file が作成されますが
これを使用する作業をする際の password を設定します
作成する network type を決めます
これはおそらく mainnet と testnet では 若干設定が違う（importance 反映にかかる時間とか）ので
これを選択します
testnetを選びますか
これなんですが 良く判りません
とりあえず ここはnewnetwork-1とでも入れて置きます
この作業の後に出来るcustom-network-preset.ymlの 1行目と
この後の作業で作成される voting node の target/preset.yml の中が
networkDescription: newnetwork-1となるんですが...
まぁ次行きましょう
generation hash ですね
https://symbolnodes.org/nodes_testnet/
これですこれ ｼﾞｪﾈﾚｰｼｮﾝ ﾊｯｼｭ って言うやつです
これが同じ node 同士が繋がって それぞれ network を作っているんですね
現在の testnet nodeList 上には
49D6E1CE276A85B70EAFE52349A...（現 testnet "sainet"）
7FCCD304802016BEBBCD342A332...（旧 testnet）
8CB80B906770AF80B08FA3D901E...（だいさん作成の dainet）
を見る事が出来ます
そうです これらは 別々の network なんです
ここは[enter]します 勝手に生成してくれます
今回生成された ｼﾞｪﾈﾚｰｼｮﾝ ﾊｯｼｭ は
C6F3463BE66AFB4847DD925EE8F15D1897CB9430E9408D21E91C22B28536726Eです
ここを含めて6つの質問には[enter]しときましょう
この質問の中に
Enter the basename for the network aliases
Enter the alias for the Network Currency
がありますが この2つの質問に[enter] でsymbol.xymになります ここで好きな通貨名を入れる事も出来ます
faucet の account を作成します "y" にします [enter] で "y" が入力されます
ここから後の4つの質問には[enter]をします
この中に出てくるDo you want to distribute coin xym to different accounts on the nemesis block?なんですが
もしかしたら ﾒｲﾝ通貨の他に ｻﾌﾞ通貨を作れるんじゃないか？と思っていますが
やった事無いので判りません
なにやら file が作成された様な ﾒｯｾｰｼﾞ が表示されます
この時点でcustom-network-preset.ymlが作成されました
ここからは node 作成に入ります
今回は voting dual1つだけ作成しましょう
voting dualを選択して[enter]します
voting dual を何個作りますか？って聞いて来ます
どうやら3つ作成出来るみたいですが 1つで充分です "1" を入力[enter]
What's the initial xym balance for the Voting Dual nodes?
voting dual node の main account に付与する通貨枚数を入れます[enter]で 300万枚が入ります
The nick name of the these nodes
voting dual node の名前を入れます ここは[enter]します
これで voting node の host が "newnetwork-dual-001" になります
例えば ここの名前を "a" と入れると
voting node の host が "newnetwork-a-001" になる筈です（試してません）
え〜 ここは よく判りませんでした ちゃんと説明出来ませんすいません
「あなたの Rest Gateway の HTTP ﾌﾟﾛﾄｺﾙ を選んで下さい」って書いてありますね
ここはHttpAndHttpsを選んどきますか
ここですね？今回は voting node 1つだけ作るんですけど
複数の node を作成する時は その都度聞いて来るので それぞれの node で選択出来るんですが
どういう事かは私には よく判ってません
Do you want to create 1 nodes of type Voting Dual each with balance of 3000000?って聞いて来るんですが
これは 「300万 xym が入った voting node を1つ作成します いいですか？」つまり確認ですね
[enter]します
「もっと node を作成しますか？」って聞いて来ますが
今回は voting dual node 1つでもう必要十分なので "n" です
network-input.ymlが作成されましたとの ﾒｯｾｰｼﾞが表示されます
ここでやっとこさ 1つ目の ｺﾏﾝﾄﾞは終了です
さて 作業 ﾃﾞｨﾚｸﾄﾘの内容を見てみましょうか
3つ file が出来てますね
①custom-network-preset.yml
network の性格がこの中に入ってます
長いので上の方だけ見せます
②network-input.yml
作成した node の情報...みたいですね
③key-store.yml
各 ｱﾄﾞﾚｽ の秘密鍵が格納されています これは暗号化されていて symbol-bootstrap decrypt命令と 今回作った password で復号出来ます
2つ目の コマンド symbol-network expandNodes
symbol-network expandNodes
ﾒｯｾｰｼﾞ を直訳してみると
パスワードが設定されています
network.ymlが保存されました。
network-input.ymlを再確認してください。ホスト名やフレンドリー名など、ノードのプロパティを調整することができます。
また、以下の命令を実行することもできます。
$ symbol-network displayResolvedNetworkPreset
この命令は使用するネットワークプリセットを表示します。custom-network-preset.yml を更新することで調整可能です。
調整に満足したら以下の命令を実行して下さい
$ symbol-network generateNemesis
定義した初期ノードに基づき、nemesis ノードを生成します。ノードはブロック1から完全にリンクされ、資金が供給されるようになります!
何が起こったかと言いますとnetwork.ymlと言う file が作成されます
file の中身は こうです
1つだけ作成した voting dual node の事が書かれているのだけは判ります
node の customPreset らしき物も見えますね
ﾒｯｾｰｼﾞ に出ていたsymbol-network displayResolvedNetworkPreset 実行してみました
長いので冒頭と末尾を見せます
ほぼほぼcustom-network-preset.ymlの内容と同じみたいですって言うか
それを表示してるみたいです
この file を編集する事で network-properties 言わば network の性格ですね
これの変更が出来ます
例えば
10行目に voting node になる為の必要枚数が ここに記述されてますが
ここを
minVoterBalance: 3000000000000
から
minVoterBalance: 10000000000
に変更すると
voting node の最低限必要な枚数が 10,000枚になります
custom-network-preset.ymlの変更したい部分があれば この時点で変更出来ると言う事です
3つ目の コマンド symbol-network generateNemesis
symbol-network generateNemesis
この ｺﾏﾝﾄﾞ で nemesis block の情報が格納されたnemesis-seedと
起動可能な node が入っているnemesis-targetが作成されました
ｺﾏﾝﾄﾞ で表示された 一番下の ﾒｯｾｰｼﾞ を見てみましょう
Once your network is running, other people can join your new network by sharing with them the 'custom-network-preset.yml' file and 'nemesis-seed' folder.
と書かれてます
つまりこれ
custom-network-preset.ymlとnemesis-seedを
他の ｻｰﾊﾞの作業 ﾃﾞｨﾚｸﾄﾘ に送って そこで config又はstartで
この network に繋げる事が出来るんです
複数 node による network が出来上がるんです
この2つがあれば 出来るんです
とりあえず置いといて
起動してみましょう
symbol-bootstrap start -t nemesis-target --noPassword --detached --healthCheck --report --pullImages
いろいろ ﾒｯｾｰｼﾞ が出てきますが ちょっとだけ待つと
こうなります
ちょっと node の状態を見てみましょう
curl localhost:3000/node/info|jq
とcurl localhost:3000/chain/info|jqですね
もう block が進んでいるのが判ると思います 今は 3 block ですね
で 判る人は気付いたと思いますが この node
先程作成した voting node じゃありません ただの dual node です
そして
このままだと block は進みますが finalize は全く進みません
あらかじめ domain "newnetwork-dual-001.dusan.gq" を作っておいたので
ﾌﾞﾗｳｻﾞ でhttp://newnetwork-dual-001.dusan.gq:100を見てみましょう
faucet ですね
じゃあhttp://newnetwork-dual-001.dusan.gq:90行ってみましょう
...あ〜 上手く表示されませんね
まぁここは だいさんの記事で 最新の symbol-explorer の構築方法があるので
放っときます
faucet も別に建てる事は出来ますのでこれも放置しましょう
名残り惜しいですが 今動いている node を止めます
symbol-bootstrap stop -t nemesis-target
これで今動いていた node は停止しました explorer と faucet も止まりました
4つ目の コマンド symbol-network configureNodes
symbol-network configureNodes
最初に psaaword を聞いて来るんですが これは
この命令で ①の ｺﾏﾝﾝﾄﾞ の時に作った voting node の password を新規に作成します
voting node の作業では こちらの password を使用します
次に聞いて来るのが symbol-network の password です これまでにも何度も入力して来た password ですね
この ｺﾏﾝﾄﾞ で ｺﾏﾝﾄﾞ②で作成されたnetwork.ymlに追記がされます
赤枠の部分が追記された部分です
また 新たにnodesﾃﾞｨﾚｸﾄﾘが出来ました
入ってみます
cd nodes
ls
cd node-001
ls
これが①の ｺﾏﾝﾄﾞ で作成した newnetwork-dual-001の本体です
この node を起動すると voting が機能するので
finalize が進みます
あと 気付いたと思いますが
custom-network-preset.ymlとnemesis-seedが ここにもありますね
custom-preset.ymlの内容
これはもう
symbol-bootstrap run -dで起動出来ます
では voting node newnetwork-dual-001起動しましょう
symbol-bootstrap run -d
curl localhost:3000/node/info|jq
とcurl localhost:3000/chain/info|jqで node の状態を見てみます
"host": "newnetwork-dual-001.dusan.gq"
"friendlyName": "newnetwork-dual-001"
これです これが 最初の ｺﾏﾝﾄﾞ① で作った voting node なんです
これが起動している事で finalaize が進みます
ちなみに block は 1 から やり直しになります
別の ｻｰﾊﾞ から network に参加する
ここで 別の ｻｰﾊﾞに ﾛｸﾞｲﾝ して
作業 ﾃﾞｨﾚｸﾄﾘnewnetworkを作成
ﾃﾞｨﾚｸﾄﾘnewnetworkに とりあえず scp ｺﾏﾝﾄﾞ で
custom-network-preset.ymlとnemesis-seedを転送します
node を 開始します
とりあえず host/friendlyName 等の設定は無しのまま起動してみましょう
symbol-bootstrap start -p custom-network-preset.yml -a dual -d
起動しました
これで peer に繋がって来れば 成功です
繋がっています
お互いの node が peer で繋がっている事が判ります
preset を symbol-bootstrap に組み込む
これは どちらの ｻｰﾊﾞ でも構いません
custom-network-preset.ymlとnemesis-seedが あれば出来ます
①付けたい preset名を付けた ﾃﾞｨﾚｸﾄﾘを作成する
ここでは preset名をnewnetとして作業します
mkdir newnet
②この ﾃﾞｨﾚｸﾄﾘnewnetに
custom-network-preset.ymlとnemesis-seedを ｺﾋﾟｰして
ﾃﾞｨﾚｸﾄﾘ 内に入ります
cp custom-network-preset.yml newnet/
cp -r nemesis-seed newnet/
cd newnet
③custom-network-preset.ymlの名前を network.ymlに変更する
mv custom-network-preset.yml network.yml
④network.ymlを編集する
vi network.yml
487行目のnemesisSeedFolder: nemesis-seedを注釈化する
赤線の部分を
の様に変更 保存する
⑤nemesis-seedの名前をseedに変更する
mv nemesis-seed seed
⑥seedの ﾊﾟｰﾐｯｼｮﾝ を変更する
このままだと symbol-bootstrap の本体に入れると seedの内容が読めなくなるので
これを変更します
chmod -R 777 seed
⑦階層を1つ登って symbol-bootstrap の本体へ ﾃﾞｨﾚｸﾄﾘ を ｺﾋﾟｰ する
cd ../
sudo cp -r newnet /usr/lib/node_modules/symbol-bootstrap/presets/
以上で preset の追加作業は完了です
これで
symbol-bootstrap config -p newnet -a dual
または
symbol-bootstrap start -p newnet -a dual.....
の書き方で newnetwork の node を作成出来る様になりました
これも又 newnetﾃﾞｨﾚｸﾄﾘを 他の ｻｰﾊﾞに転送して
sudo cp -r newnet /usr/lib/node_modules/symbol-bootstrap/presets/
とする事で その ｻｰﾊﾞ上でも -p newnetが有効になります
※symbol-bootstrap の preset 部分は/usr/local/lib/node_modules/symbol-bootstrap/presets/
に存在する ｹｰｽ もあります
-----俺様用しおり ここまで書いた-----
めりー🎅くりすます🎄