Uživatelské nástroje

Nástroje pro tento web


instalace:instalacni_postup_new

Toto je starší verze dokumentu!


Instalační manuál nodu ELA Blockchain ®

Instalační postup:

  1. Je doporučeno vytvořit uživatele pod kterým to ElA blockchain poběží. Uživatel musí mít sudo práva!
    • Nejjednoduší postup pokud jste přihlášeni pod rootem:
      • apt install sudo
      • adduser vasuser
      • adduser vasuser sudo
  2. Login na vytvořeného uživatele buď přímo na PC nebo pomocí ssh (vzdálený přístup)
    • S default ssh portem 22:
      • „ssh vasuser@vaseIP“ nebo „ssh vasuser@blockchain.vaseDomena“
    • Jiný port:
      • „ssh vasuser@vaseIP -pVasPort“ nebo „ssh vasuser@blockchain.vaseDomena -pVasPort“
    • Příklad:
      • ssh ela@blockchain.elachain.cz -p10222
  3. Je potřeba dostat instalační .deb balíček na node. Například můžeme uvést dvě možnosti.
    1. Stáhneme archiv obsahující balíček přímo z https://eu-de.git.cloud.ibm.com/vodsedalek/ela-preq-package-packaged.git
    2. Přímo pomocí gitu. Nejprve ověříme zda je git nainstalovaný a následně uděláme clone repository:
  4. Přes příkaz sha256sum elachain-preq.deb si můžete ověřit integritu balíčku. Hash tohoto balíčku je: 86d5356583b5dc6d98d61d66cc1b40cd82105e08a4530487ec59316d516b0a9a
  5. Spustit instalační balíček pomocí sudo apt install ./elachain-preq.deb (ve složce kde se balíček nachází)
  6. Po dokončení instalace spustit příkaz node_config (bez suda - v tomto případě je důležité pod kterým uživatelem se příkaz spouští)
  7. Během procesu proběhne stažení Docker images a následně budete požádáni o dodání .install-env souboru do složky /usr/local/NODE_CONTROL
    1. jedna z možností je například pomocí nějakého SCP klienta (WinSCP)
    2. nebo můžeme přímo příkazem scp .install-env vasuser@vaseIP:/usr/local/NODE_CONTROL
    3. nebo si soubor .install-env otevřeme a jeho obsah zkopírujeme do nově vytvořeného souboru se stejným jménem na našem serveru, pak ho uložíme
  8. Následuje několik dotazů y/n.
    • Nejprve pro vytvoření konfigurace apache. Ve většině případu je žádoucí volit „y“. Volbu 'n' volte pokud máte dostatek zkušeností s konfigurací apache serveru a nutně vyžadujete specifickou konfiguraci.
    • Potom je dotaz na vygenerování ssl certifikátu pro Vámi zvolenou doménu. Pokud chcete vygenerovat free ssl certifikát pomocí Let's Encrypt zvolte 'y'. Při generování cerifikátu postupujte dle výpisu nástroje Let's Encrypt. Pokud máte nebo chcete použít jiný ssl certifikát nakopírujte certifikáty dle výpisu konfiguračního scriptu. Pokud vlastníte certifikáty v jiném formátu, je na Vás upravit konfiguraci apache serveru.
      • V případě neúspěšného vygenerování SSL cerifikátu se nepodaří spustit apache server. Certifikát je možné zkusit znovu vygenerovat pomocí následujících příkazů:
        • sudo certbot certonly --standalone -d blockchain.vaseDomena
        • Následně je ještě třeba provést restart apache serveru pomocí sudo systemctl restart apache2
    • Následující dotaz se týká instalace logDNA služby, která nám úmožný vzdálený přístup k logům. Tu potvrdíte znovu zadáním „y“.
      • Instalace logdna služby je možná i později samostatně zavoláním setLogDNA
  9. Po dokončení node_config je vhodné počítač restartovat nebo alepsoň provést relogin uživatele.
    • Vzdáleně: sudo reboot
  10. Po restartu spustíte příkaz install-ela-node, který provede stažení potřebných věcí z našich git repository a zároveň stáhne základní docker images.
  11. Generování cryptografie uzlu - v tomto kroku si vygenerujete potřebné certifikáty pro provoz nodu
    • Nejprve je nutné spusti potřebné certifikační autority pomocí příkazu manage-ela-cas start
    • Samotné vygenerování certifikátu se provede příkazem manage-ela-cas generate, který nám defaultně vygeneruje certifikáty pro 2 peery. Příkaz je možné upravit pro generování specifického počtu peerů manage-ela-cas generate -p NumberOfPeers, doporučujeme ale vygenerovat certifikáty pro 2 peery a případně pak jednoho vypnout
    • Následné je nutné z vygenerovaných certifikátu vytvořit adresářovou strukturu vhodnou pro další použití. To provedete příkazem manage-ela-cas createCryptoConfig
    • Část těchto certifikátu potřebujeme pro zavedení vašeho nodu do sítě (pouze root certifikáty certifikačních autorit, čímž nezískáváme žádnou kontrolu nad vašimi certifikačními autoritami). Archiv obsahující pouze potřebné certifikáty můžete vygenerovat jednoduše pomocí příkazu manage-ela-cas createOrgMSPArchive
    • Vygenerovaný archiv blockchain.vaseDomenaMSP.tar.gz se nachází v adresáří /var/elachain/ca . Tento archiv nám musíte dodat, abychom mohli závést váš node do sítě.
    • Pro pokračování v instalaci je třeba vypnout certifikační autority: manage-ela-cas down
    • Po naší odpovědi o úspěšném zavedení nodu sítě, je možné pokračovat v instalaci.
  12. Aktualizace certifikátů pro připojení k ordering service - po zavedení nodu do sítě si můžete aktualizovat dostupné certifikáty pro přípojení k ordering service pomocí příkazu update-ela-node gitOnly
  13. *VOLITELNÉ* V tomto bodě můžeme zvolit, jaké peery se budou připojovat do sítě a používání monitorovací služby Telegraf. Příkazem bootstrap-ela-network configure vyvoláme menu, kde můžeme zaškrtnout konkrétní peery.
    • Doporučujeme zde nechat oba dva (pokud jeden vypade, node bude stále funkční), pokud ale máte slabší HW, můžete zvolit pouze peer0. Pokud byste se v budoucnu rozhodli spustit i peer1, bude pak potřeba ho ručně připojit do kanálů.
    • Po dokončení výběru se Vám ještě zobrazí „y/n“, jestli chcete povolit nebo zakázat Telegraf. Jeho povolením nám umožníte sledovat využití systémových prostředků a sledování množství metrik HFC. Tyto data nám mohou pomoci s případnou diagnostikou i při zlepšování naší služby. Oceníme tedy její povolení.
    • Pokud tento krok přeskočíte, defaultně se připojí oba dva peery a Telegraf bude zapnutý.
  14. Následně je již možné spustit script pro první spuštění nodu bootstrap-ela-network init
  15. Aplikaci a gateway spustíte pomocí manage-ela-app start. Pří prvotním spouštění se provádí také bootstraping aplikace, který potřebuje běžící gateway
  16. Tím je proces dokončen. Při výpisu docker containers pomocí docker ps, by měly být vidět následující kontejnery:

gateway.blockchain.vaseDomena
couchdb-gateway.blockchain.vaseDomena
apps-notarius
apps-admin
apps-admin-mongo
ebs-peer0.blockchain.vaseDomena-notarius_cc-"version"
ebs-peer0.blockchain.vaseDomena-admin_cc-"version"
ebs-peer1.blockchain.vaseDomena-notarius_cc-"version"
ebs-peer1.blockchain.vaseDomena-admin_cc-"version"
cli
peer0.blockchain.vaseDomena
peer1.blockchain.vaseDomena
gtw-ca.blockchain.vaseDomena
couchdb0
couchdb1
monitoring-telegraf

Pokud zároveň běží správně i apache server, dostanete se na adrese „blockchain.vaseDomena“ na aplikaci běžící na Vašem nodu.
Admin aplikaci potom naleznete pod adresou „https://blockchain.vaseDomena/admin“.

instalace/instalacni_postup_new.1647264601.txt.gz · Poslední úprava: 2022/03/14 14:30 autor: kozak