Kuidas käivitada oma ADAMANT-sõlme Ubuntul

ADAMANT kasutab blockchain-süsteemis üksmeele saavutamiseks õiglast dPoS-i. Kui soovite lisateavet õiglase dPoSi ja oma sõlme käitamise eeliste kohta, lugege lehte DPoS Explained - Simply.

Selles juhendis selgitatakse teile, kuidas installida, käivitada ja värskendada ADAMANT-i sõlmi Ubuntu 16 või 18. Võite proovida ka teisi Linuxi-ühilduvaid süsteeme, kuid neid pole veel testitud. Kui soovite käitada ADAMANT-sõlme Windowsis või Macis Dockeri abil, tutvuge selle juhendiga.

Märkus. Vaja on põhilisi IT ja Linuxi teadmisi.

Eelnõud

Teil on vaja eelinstalleeritud Ubuntu-ühilduvat VM-i (virtuaalmasin), versiooni 16.04 LTS või 18.

Ubuntu saamise viisid:

  • Mis tahes pilveteenus, näiteks: DigitalOcean, OVH, Hetzner, Scaleway, ArubaCloud. Peaaegu kõik need pakkujad võimaldavad teil virtuaalse masina kohe luua.
  • VM-i rakendus Windowsis või Macis (VMWare, VirtualBox või midagi muud), kus Ubuntu pilt on installitud.
  • Ubuntu-ühilduv arvuti.

Nõuded virtuaalmasinale:

  • 1 GB RAM (soovitatav on 2 GB RAM).
  • 10 GB kettaruumi (sõltub praegusest ploki kõrgusest).

ADAMANT-sõlme installimise kaks võimalust

ADAMANT-sõlme installimiseks on kaks viisi, esimene viis nõuab ainult valmiskäivituse skripti ja sobib esmakordseks kasutamiseks. Teine viis nõuab kontrolli kogu protsessi üle ja sobib kogenud kasutajatele.

Kui olete esmakordne taimer, toimige järgmiselt

Pärast sisselogimist peate tegema ainult lihtsa bashi skripti:

bash -c "$ (vidin -O - https://adamant.im/install_node.sh)"

Kui olete teatistega nõus, tippige „jah“ või katkestage installimine. Pärast seda peate määrama andmebaasi kasutaja jaoks uue parooli ja uue süsteemikasutaja parooli.

Märkus. Paroolimärgid pole sisestuse ajal nähtavad.

Nüüd peate ainult 7–15 minutit ootama ja see on kõik tehtud.

Teie sõlm töötab ja on konfigureeritud. Saate kontrollida, kas teie sõlm on ühendatud ADAMANTi plokiahelaga.

Kui olete kogenud kasutaja, toimige järgmiselt

1) Käivitage oma Ubuntu terminal

Esiteks käivitage oma VM Ubuntu abil või käivitage see SSH-kliendi abil, nagu PuTTy või Bitvise for Windows. Kui kasutate GNU / Linuxit või OS X-i, tippige ssh root @ IP_adress.

Märkus. Vaja on administraatori õigusi.

2) Täiendage oma süsteemi, sisestades järgmise käsu:

sudo apt update && sudo apt upgrade -y

Kui teilt küsitakse, nagu allpool toodud pildil, vajutage vaikeseadete kinnitamiseks sisestusklahvi. See võib võtta mõni minut.

3) Eeltingimuste installimine. Paigaldage python, git jne:

sudo apt install -y python build-essential curl automake autoconf libtool git

4) Installige PostgreSQL (versioon 11.1)

Lisage hoidla ja selle võti:

sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt/` lsb_release -cs`-pgdg main "> /etc/apt/sources.list.d/pgdg.list' && wget -q https://www.postgresql.org/media/keys/ACCC4CF8.asc -O - | sudo apt-key lisa -

Uuendage paketiloendit ja installige postgresql:

sudo apt update && sudo apt install -y postgresql postgresql-hozzájár libpq-dev

Järgmised paar käsku loovad DB kasutaja (e.k. adamant) ja DB pealkirjaga adamant_main.

CD / tmp
su postgres -c psql
CREATE ROLE muutumatu sisselogimise parool 'HardPass111';

Märgin! Mõelge uue parooli asemel „HardPass111”.

LOE ANDMEBAASI adamant_main;

Psql-ist väljumiseks tippige \ q

\ q

5) Looge uus OS-i kasutaja

Võite valida mis tahes kasutajanime, see näidis loob kasutaja püsimatuks ja annab talle vajalikud õigused valida.

adduser adamant

Seejärel tippige parool ja kinnitage. Te ei pea täiendavaid lünki täitma.

sudo usermod -G sudo adamant
ülitähtis

6) Installige Nov.js nvm kaudu

Kui logite sisse korrektseks, saate installida nodejs.

wget -qO- https://raw.githubusercontent.com/creationix/nvm/v0.33.11/install.sh | bash

Seejärel logige välja ja logige uuesti sisse

väljumine
ülitähtis

Nodejs v10.9 installimiseks tippige järgmine tekst

nvm i 10,9

7) Installige PM2 - sõlmeprotsesside haldur:

npm install -g pm2

8) Installige ADAMANT-sõlme

Seejärel kloonige ADAMANT-i hoidla ja installige järgmised sõltuvused:

git kloon https://github.com/Adamant-im/adamant
cd adamant
npm i

9) Muutke ADAMANTi konfiguratsioone

nano config.json

Kui nano-redaktorit pole installitud, installige see käsuga

sudo apt install nano

Muutke DB mandaati. Praegu peame vastavalt järgmisele näitele muutma ainult DB parooli (selles proovis “HardPass111”, muutke oma parool).

Kui soovite brauseris juurdepääsu mõnele API käsule, muutke api / juurdepääs / avalik väärtuseks tõene.

Muutke consoleLogLevel veaks, et näha, kas kõik on korras.

Muudatuste salvestamiseks vajutage F2, y, Enter.

10) Laadige alla ADAMANT Blockchaini andmebaasi pilt

See pole kohustuslik. Ausalt öeldes, kui soovite tõesti detsentraliseerimist toetada, peaksite selle sammu vahele jätma.

See säästab aega sõlmede sünkroonimisel, kuid peate pilti täielikult usaldama. Kui jätate selle sammu vahele, kontrollib teie sõlm kõiki tehinguid, mis võtab aega (mitu päeva). Kuid see tõestab plokiahela järjepidevust.

Kui soovite siiski jätkata, peaksite ADAMANT-i sõlme peatama:

pm2 peatu kordamatu

Järgmine laadige pilt alla

vidin https://explorer.adamant.im/db_backup.sql.gz

https://explorer.adamant.im/db_backup.sql.gz on ADAMANT-i meeskonna uusim igapäevane pilt.

Paki pildi lahti:

gunzip db_backup.sql.gz

Kust db_backup.sql.gz alla laaditakse pildifaili nimi.

Lõpuks laadige pilt sõlme andmebaasi:

psql adamant_main 

Märkus. Te ei tohi käitada ühtegi varem registreeritud sõlme. Vastasel juhul peaksite looma uue adamant_main andmebaasi, kasutades dropdb ja loodudb käske.

Lõpuks on see kõik tehtud ja saate edasi minna.

Rakenduste jaoks API lubamine

Kui te 9. toimingus API ei lubanud, saate seda igal ajal teha.

API võimaldab ADAMANT-i Messengerirakendustel teie sõlmpunktidega ühenduse luua ning sõnumeid saata ja hankida.

Detsentraliseerimise toetamine on väga oluline. Mida rohkem sõlme on, seda anonüümsemaks ja turvalisemaks muutub sõnumivahetuse infrastruktuur.

Kui käivitate oma anonüümsuse kaitsmiseks sõlme, peate lubama API. Pärast seda saate sõnumsiderakenduse jaotises „Seaded” valida sõlme.

Rakenduste API lubamiseks käivitage järgmine käsk

nano config.json

Avaliku parameetri muutmine api / juurdepääsu alajaotuses.

Muudatuste salvestamiseks vajutage F2, y, Enter.

Kui teie sõlm juba töötab, taaskäivitage see:

pm2 taaskäivitage kindlalt

Et kontrollida, kas API on lubatud, avage brauseris järgmine link (teie sõlm peaks olema aktiivne):

http: // : 36666 / api / blokeerib / getHeight

Peaksite muutma väärtuse väärtuseks 80.211.177.181 oma sõlme IP-ks ja protokolliks (vajadusel). Näiteks http://80.211.177.181:36666/api/blocks/getHeight

Kas teie sõlme on õigesti installitud

ADAMANTi ülesehituse ja õigesti konfigureerimise kontrollimiseks käivitage järgmine käsk:

sõlme app.js

Tavaliselt näete vigu ja märkusi.

Kui olete veendunud, et protsess töötab õigesti, vajutage käsureale naasmiseks klahve CTRL + C.

ADAMANT-sõlme käitamine

ADAMANT-sõlme käivitamiseks kasutage pm2. See paneb protsessi tagaplaanile. Kui protsess ebaõnnestub, taastatakse see automaatselt.

pm2 algus - nimi adamant app.js
CD

Pärast protsessi käivitamist saab selle käitusaja oleku ja logi asukoha saada järgmise käsu väljastamise teel:

pm2 näita nõmedat

Kasutage seda igal ajal, kui soovite oma Node olekut näha. See peaks olema võrgus.

ADAMANT-i sõlme peatamine

Kui peate tegema muudatusi, nt. sõlme värskendamiseks kasutage selle peatamiseks neid juhiseid.

ADAMANTi peatamiseks pärast selle alustamist pm2-ga väljastage järgmine käsk:

pm2 peatu kordamatu

Sõlme ühenduse kinnitamine

Selleks, et kontrollida, kas sõlm on õigesti ühendatud Messengeri blokeeringusüsteemiga, järgige seda linki https://explorer.adamant.im/networkMonitor.

Leidke oma sõlm sõlmede loendist Sõlmed IP-aadressi järgi. Pange tähele, et teie sõlme ilmumine loendisse võib võtta mitu minutit.

Kui olete just sõlme installinud, kuid see pole veel sünkroonitud, tähistatakse selle kõrgust numbriga 1. Sõlme sünkroonimine võib sõltuvalt teie ühendusest ja protsessorist võtta kuni 1 päev või rohkem.

Oma sõlme kõrguse kontrollimiseks toimige järgmiselt.

curl -k -X GET http: // localhost: 36666 / api / blocks / getHeight

Kui sünkroonimine on lõpule jõudnud, on kõrgus sama mis teiste sõlmede puhul.

Automaatkäivitage ADAMANT-i sõlm süsteemi taaskäivitusel

Kuna on tavaline, et VPS-i pakkuja võib teie masina taaskäivitada, on hea mõte lisada ADAMANT-i sõlmeprotsess crontabisse. Kui eelistate aga VPS-i käsitsi juhtida, pole see samm vajalik.

Käitage kindlasti käske vankumatu kasutaja all:

ülitähtis

Järgmisena avage crontabi redigeerija:

crontab -e

Toimetaja valik sõltub teist. Minu jaoks eelistan nanot.

Lisage stringi lõppu:

@reboot cd / home / adamant / adamant && pm2 start - name adamant app.js

Redigeerijast väljumiseks vajutage Ctrl + x, faili salvestamise kinnitamiseks y, muudatuste salvestamiseks sisestusklahvi.

See selleks.

Teie ADAMANT-sõlme värskendamine

Esiteks kontrollige oma sõlme peatamiseks jaotist ADAMANT-i sõlme peatamine.

Valige oma kindel kasutaja.

ülitähtis
cd adamant

Salvestage konfiguratsioonifail, värskendage oma ADAMANT-sõlme ja lõpuks muutke konfiguratsioonisõlme versiooni:

mv config.json config3.json && git pull && mv config3.json config.json && nano config.json

Kui config.json avaneb, peaksite muutma versiooni arvu ajakohaseks.

Muudatuste salvestamiseks vajutage F2, y, Enter.

Värskenda sõltuvusi:

npm värskendus

Nüüd saate ADAMANT-i sõlme taaskäivitada:

pm2 taaskäivitage kindlalt

Mis järgmiseks?

Võite saada Blockchaini delegaadiks, hakata sepistama ja saada auhindu. Kui olete huvitatud, vaadake järgmist artiklit - Kuidas saada ADAMANT-delegaadiks.