TroisiÚme jour de test sur le réseau testnet unifié de Shelley / Jormungandr
Un dĂ©but amusant, parfois un peu chaotique. Un bonne ambiance sur le channel Telegram pour rĂ©gler les derniers paramĂštres et finalement, voilĂ : câest pas bien compliquĂ© dâavoir un noeud Jormungandr !!
Si vous avez du mal Ă me croire, pourquoi ne pas tenter lâaventure vous mĂȘme ?!
Warning n°1: Ce petit document sâadresse Ă ceux qui connaissent au moins les commandes linux suivantes.
ls / cd / mkdir / rm / rm -r
Si vous ne les connaissez pas, il nâest jamais trop tard !! En tout cas, soyez Ă lâaise avec la navigation dâun dossier Ă un autre. Quand on a pas un Ă©cran, sur les serveurs web par exemple, câest plutĂŽt pratique !
Warning n° 2: Je me suis simplifiĂ© grandement la chose en travaillant sur un serveur web avec IP fixe. Si jamais vous ĂȘtes derriĂšre un routeur, une box ou autre Ă la maison, ça risque dâĂȘtre une autre histoireâŠ
Installer Jormungandr sur une distro Linux classique (Ubuntu par example).
Si vous en utilisez une autre que vous bidouillez tous les jours, il y a de fortes chances pour que ce document ne vous soit pas utile de toute façonâŠ
Avant toute chose, il vous faut installer Rust sur votre machine.
curl https://sh.rustup.rs -sSf | sh
Suivez les instructions jusquâau bout. Surtout Ă la fin, quand ça vous parle de bien copier le chemin {$HOME} etc âŠ
Pour ĂȘtre sĂ»r que vous nâaurez pas de problĂšmes de compilation un peu plus loin, je vous recommande dâinstaller ce qui suit en tapant :
sudo apt-get install build-essential pkg-config git curl libssl-dev
Ensuite, il vous faut récupérer Jormungandr
git clone --recurse-submodules https://github.com/input-output-hk/jormungandr
cd jormungandr
VĂ©rifier que vous ĂȘtes bien sur la derniĂšre branche de dĂ©veloppement
git checkout master
git pull
Installer Jormungandr et Jcli, son interface de commande
cargo install --path jormungandr
cargo install --path jcli
Si jamais vous nâen ĂȘtes pas Ă votre premiĂšre installation de Jormungandr, ou vous nâĂȘtes plus trop sĂ»rs de vous, vous pouvez faire les commandes suivantes en remplacement des deux derniĂšres commandes citĂ©es plus haut :
cargo install --path jormungandr --force
cargo install --path jcli --force
Une fois que cela est fait, le plus dur est derriĂšre vous - ou presque !
Bravo, vous avez désormais installé les deux composantes majeures qui vous permettront de vous connecter à Shelley. Maintenant, les choses sérieuses: le testnet
Si vous avez suivi les commandes prĂ©cĂ©dentes Ă la lettre, vous ĂȘtes toujours dans le dossier â/jormungandrâ.
Sortez en, en tapant :
cd ../
CrĂ©ez un dossier, soyons originaux, appelĂ© âtestnetâ
mkdir testnet
Rentrez dans ce nouveau dossier
cd testnet
Nous allons opĂ©rer Ă partir dâici maintenant et crĂ©ez un fichier config.yaml pour votre noeud Jormungandr.
Attention !! Pour des raison dâĂ©dition sur le forum, les espaces ne sont pas bien intĂ©grĂ©s en dĂ©but de ligne, et le fichier .yaml a besoin de ces espaces pour ĂȘtre fonctionnel. Pour cette raison, copiez ce qui suit et remplacez tous les " ° " par un espace (les espaces internes Ă la ligne sont ok - nây touchez pas), avant de tout rentrer dans votre terminal pour effectuer la commande.
Remarques:
UTILISATEUR : Câest votre nom dâutilisateur ( celui avec lequel vous vous connectez sur votre machine). Moi câest psychomb. Et vous ? ( vous pouvez le connaĂźtre en tapant whoami
)
X.X.X.X : Câest lâadresse IP de votre machine.
Remplacez ces deux valeurs dans ce qui suit par les votres !
cat > ~/testnet/config.yaml << EOL
log:
°°format: âplainâ
°°level: âinfoâ
°°output: âstderrâ
p2p:
°°listen_address: â/ip4/0.0.0.0/tcp/3100â
°°public_address: â/ip4/X.X.X.X/tcp/3100â
°°topics_of_interest:
°°°°blocks: âhighâ
°°°°messages: âhighâ
°°trusted_peers:
°°°°- â/ip4/163.172.195.51/tcp/4444â
°°°°- â/ip4/68.183.155.37/tcp/3100â
°°°°- â/ip4/3.123.177.192/tcp/3000â
°°°°- â/ip4/3.123.155.47/tcp/3000â
°°°°- â/ip4/3.115.57.216/tcp/3000â
°°°°- â/ip4/3.112.185.217/tcp/3000â
°°°°- â/ip4/18.139.40.4/tcp/3000â
°°°°- â/ip4/18.140.134.230/tcp/3000â
rest:
°°listen: â127.0.0.1:3101â
storage: â/home/UTILISATEUR/testnet/storageâ
Appuyez maintenant sur la touche âEnterâ et tapez les trois lettres suivantes en majuscules: EOL
Appuyez sur âEnterâ
Ca y est vous avez un fichier config.yaml créé et prĂȘt Ă tourner.
Pour le vérifier, tapez dans le terminal
cat config.yaml
Il devrait sâafficher.
Vous pouvez maintenant lancer le noeud jormungandr en suivant la commande:
jormungandr --config /home/UTILISATEUR/testnet/config.yaml --genesis-block-hash adbdd5ede31637f6c9bad5c271eec0bc3d0cb9efb86a5b913bb55cba549d0770
Si jamais vous souhaitez que le noeud continue de tourner aprÚs avoir fermé votre session sur votre serveur, vous pouvez taper:
nohup jormungandr --config /home/UTILISATEUR/testnet/config.yaml --genesis-block-hash adbdd5ede31637f6c9bad5c271eec0bc3d0cb9efb86a5b913bb55cba549d0770
Un fichier log sera créé: nohup.out
Si vous souhaitez quâaucun fichier log ne soit conservĂ©, pour Ă©viter par exemple la crĂ©ation dâun log trop volumineux, tapez plutĂŽt:
nohup jormungandr --config /home/UTILISATEUR/testnet/config.yaml --genesis-block-hash adbdd5ede31637f6c9bad5c271eec0bc3d0cb9efb86a5b913bb55cba549d0770 >& /dev/null &
Comment vérifier que votre noeud tourne bien ?
Tapez à intervalles plus ou moins réguliers la commande suivante :
jcli rest v0 node stats get -h http://127.0.0.1:3101/api
Cela vous affichera les infos du dernier bloc. Ces derniÚres doivent changer, vous indiquant que les blocks sont bien téléchargés au fur et à mesure. Si le lastBlockHeight
ne change pas par exemple, il y a un souci !
Comment arrĂȘter mon noeud Jormungandr si jamais je lâai lancĂ© avec la commande nohup
?
Bonne question ! Ăvidemment, si on a plus le processus qui tourne dans le terminal (câĂ©tait le but quand mĂȘme), alors on ne peut plus le stopper comme une brute avec un petit CTRL+C ⊠Câest ballot.
Tapez plutĂŽt :
jcli rest v0 shutdown get -h http://127.0.0.1:3101/api
Et voilà . Terminé.
Amusez vous bien. Câest tout pour ce soir. Dâautres tutos viendront sur la crĂ©ation dâadresses, les transactions, la dĂ©lĂ©gation Ă un pool et enfin la crĂ©ation de votre propre stake-pool !