(include un Cheat-Sheet per l'avvio rapido - alla fine della guida)
Non dimenticare di leggere:
Come registrare un nodo Delegato RIPAEX [https://steemit.com/news/@ripaex/registering-your-ripa-delegate]
in quanto vi servirà la "passphrase" per portare a buon fine questa installazione
Come votare o annullare un voto ad un nodo Delegato sulla rete RIPAEX
[https://steemit.com/news/@ripaex/how-to-vote-and-un-vote-a-ripa-delegate]
Impostare la seconda "passphrase" al più presto possibile in quanto il nodo deterrà la vostra prima passphrase
e se hackerato, le vostre monete saranno esposte al pericolo di furto.
Requisiti minimi per far girare un nodo RIPA:
Providers raccomandati per il vostro VPS:
Per questa guida, utilizzeremo il servizio offerto da Digital Ocean, dal quale riceverai anche
10 dollari di credito quanto ti registrerai (i costi standard sono 5 dollari, 1 GB ram, 25GG SSd e !TB di traffico)
Bene o male tutti i provider hanno comunque prezzi similari.
1 Creare un server per il Vostro Nodo RIPAEX
Prima di tutto si creerà una droplet attraverso l'interfaccia grafica di Digital Ocean scegliendo
la distribuzione Linux - Ubuntu 16.04.2 x64
Si sceglie poi il piano di pagamento, 5 usd per mese dovrebbe essere più che sufficente (1GB RAM, 1 CPU)
Come luogo di storage sceglieremo New York #3 (va bene qualsiasi luogo, evitando Singapore e Bangalore per problemi legati alla latenza di rete)
Ora finalizzeremo e creeremo un droplet nominando l'host, pertanto cliccate su CREATE
Quando il processo sarà completato, riceverete per email tutte le informazioni necessarie (username, password e l'indirizzo IP)
username: root
password: xxx (sent in email)
IP: xxx.xxx.xxx.xxx (sent in email)
SSH port: 22 (this is default)
2 Connettiti al tuo server via SSH
Windows: puoi utilizzare uno dei qualsiasi client SSH. Per il nostro esempio utilizzeremo Putty
(un client open source che puoi scaricare da qui: https://www.putty.org/
MAC OS: apri il Terminal (per farlo partire apri la cartella Applicazioni - > Utility -> clicca su Terminal).
Linux: dipende dalla distribuzione, ad ogni modo ci si arriva normalmente premendo la combinazione di tasti "CTRL+ALT+T".
Per i terminali Linux/MAC Os ci si connette digitando:
ssh user@"server-ip"
ad esempio un comando potrebbe essere
Utilizzando Putty su windows, la prima cosa da farlo è lanciarlo e inserire i dati come di seguito:
Sotto HOST NAME(or IP ADDRESS) va inserito l'indirizzo IP fornito dal provider (vedi email inviata dal provider)
Poi si deve cliccare su OPEN.
Per velocizzare futuri collegamenti vai sotto Default Settings e salva questo IP, la prossima volta basterà andare di nuovo
sotto Default settings e cliccare su Load. Puoi dare a questo salvataggio un nome che meglio identifichi il server ad esempio
"RIPA_MAINNET", in modo da recuperare velocemente l'accesso in futuro.
ATTENZIONE: alla prima connessione vi apparirà un messaggio di pericolo (rsa2 key fingerprint).
Cliccate su "YES" e continuate. In futuro non apparirà più.
La linea di comando ora vi chiederà sotto quale username volete collegarvi, digitate: root
e premete ENTER.
Successivamente dovrete inserire la password che vi è stata inviata dal vostro provider e successivamente premerete ENTER.
(attenzione il cursore non si muove mentre digitate la password)
Come sicurezza alcuni provider chiedono di effettuare il cambio della password al primo collegamento, in questo caso inserite
per prima la vostra password (ricevuta dal provider) e poi sceglietene una nuova di almeno o piu di 16 caratteri contenente numeri
e caratteri speciali, per aumentarne la sicurezza.
Scrivetevi la nuova password per l'utente root o rischierete di ritrovarvi nell'impossibilità di accedere al vostro stesso server.
A questo punto se cambiate la password dovete digitare exit e poi rientrare nel server come appena spiegato qui al punto 2.
A questo punto, dopo essersi connessi ed aver cambiato la password per l'utente root, è il
momento di creare un nuovo utente che abbia privilegi Sudo (ovvero la possibilità di lanciare programmi con privilegi di sicurezza di un altro utente)
Passi per aggiungere un nuovo utente:
adduser "yourusername" (senza apici)
nel nostro esempio: addusere ripa
Digitare due volte quando richiesto una nuova password per l'utente.
Digitare 6 volte ENTER per accettare i valori di default.
Adesso che avete creato con successo il vostro utente "ripa" (o con un nome da voi scelto)
sarà necessario assegnare i privilegi Sudo all'utente.
Come aggiungere i privilegi Sudo:
usermode -a -G sudo "your username" (senza apici)
nel nostro esempio: usermod -a -G sudo ripa
Ora sarà necessario disconnettersi e riaccedere con l'utente appena creato. Per disconnettersi digitare: exit e premere ENTER
La sessione di Putty verrà terminata.
Aspetta la chiusura di Putty e poi riavvia.
Connettetevi al server utilizzando il nuovo utente appena registrato invece di quello "root".
Scrivete la username e premete ENTER, poi digitate la password di questo utente.
Per i Terminali Linux/MAC Os potete connettervi attraverso questo comando:
ssh yourusername@"server ip" (senza apici)
esempio:
ssh [email protected]
Scaricare il RIPA Commander:
wget https://raw.githubusercontent.com/RipaEx/ripa-commander/master/RIPA_commander_mainnet.sh -O ~/RIPA_commander_mainnet.sh
Rendilo eseguibile:
chmod 700 ~/RIPA_commander_mainnet.sh
Esegui il file:
./RIPA_commander_mainnet.sh
Adesso lo scrypt di installazione del RIPA COMMANDER si aprirà ed inizierà a fare un check delle dipendenze ed eventuali update di cui ha bisogno.
Premete quindi ENTER ed aspettate pazientemente la fine del processo senza interromperlo.
[vedrete la scritta: Installing prerequisites ...] non interrompete il processo.
Quando il processo sarà terminato vi chiedrà di riavviare, digitate quindi:
sudo reboot
Apparirà un messaggio di "PuTTY Fatal Error", ignoratelo ... vi sta solo dicendo che avete perso la connessione col server.
Cliccate su OK.
Riaprite PuTTY, collegatevi con il vostro utente e lanciate il seguente comando:
./RIPA_commander_mainnet.sh
Inserite la password se richiesta. Entrerete nel menu RIPA.
Ci sono varie opzioni e siccome è la prima volta , inseriremo 1 e premeremo enter per
eseguire l'installazione di RIPA. Adesso l'installazione del Nodo RIPA inizierà, non interrompetela,
e aspettate in quanto ci metterà qualche minuto per completare l'installazione.
Dopo l'installazione del nodo, vi sarà chiesto di settare la passphrase del vostro delegato (è la password che utilizzate per accedere al portafolgio del vostro delegato)
Premete ENTER, inserite la passphrase, se non volete impostarla, premete N e poi ENTER.
Se avete premuto ENTER e scelto l'opzione Y, vi verrà chiesto di inserire la passphrase - inseritela (o copiatela da dove l'avete già scritta)
e premete ENTER per salvarla. Se vorrete cambiarla in futuro sarà possibile scegliendo l'opzione 5 nel RIPA Command.
Adesso vi sarà richiesto se volete salvarla nel vostro file config - premete ENTER - il vostro nodo RIPA ora si attiverà - premete ENTER per ritornare al RIPA Command Center.
Dopo aver terminato l'installazione, sarai rimandato al RIPA command menu. Per sincronizzare dallo snapshot, si utilizzerà il comando 4. Rebuild Database.
Apparirà un messaggio:
Would you like to download the latest snapshot? (Y/N)
Digita Y e ENTER per scaricare l'ultima snapshot ufficiale della blockchain.
Poi ti sarà chiesto:
Would you like to restore the snapshot now? (Y/N)
Premi Y e ENTER e verrà installata la snapshot appena scaricata.
Il processo impiegherà alcuni minuti. Dopo un prompt vi dirà "Current snapshot has been restored"
e il vostro nodo RIPA partirà. Premete ENTER per tornare al menu.
Dovresti vedere un messaggio, ogni 8 secondi, come questo: New block received".
Quando vedi questo messaggio il tuo nodo sarà sincronizzato. Premi quindi CTRL + C per chiudere la finestra di Log e ritornare al RIPA commander menu.
Puoi verificare se il tuo nodo sta funzionando correttamente digitando S + ENTER (attento che il RIPA commander center è "CASE SENSITIVE" quindi le lettere devono essere maiuscole e le minuscole non funzioneranno).
Controlla il log del nodo RIPA premendo L + ENTER - per uscire e ritonare al RIPA command center.
Puoi fermare il nodo RIPA con K + ENTER - il nodo sarà fermato.
Se lo vuoi far ripartire A + ENTER - il nodo riparitrà.
Se il nodo per qualche motivo è "impallato" sarà sufficente utilizzare il commando R + ENTER - chiuderà e farà ripartire il nodo.
0 + ENTER invece vi farà uscire dal RIPA commander center e ritornare alla directory home proponendovi il solito promt di Linux.
Gioca un po' con i comandi in modo da familiarizzarti con loro. Ricorda che puoi sempre entrare nel RIPA commander digitando:
./RIPA_commander_mainnet.sh
Ricorda che devi essere nella directory home, all quale arrivi semplicemente digitando: cd ~
Foglio riepilogativo dei comandi rapidi:
(molti comandi possono essere lanciati anche senza l'uso del RIPA Commander)
Sii sicuro di essere nella directory del ripa-node digitando:
cd ~/ripa-node
Digitato questo comando ti sarà possibile eseguire vari comandi:
Far ripartire il tuo nodo RIPA: forever restart app.js
Log in tempo reale del tuo nodo RIPA: tail -f ./logs/ripa.log
Terminare il nodo RIPA : forever stopall
Vedere i processi "forever" del RIPA node: forever list
Aggiornare il RIPA node: git pull
Dopo aver effettuato l'aggiornamento il nodo deve essere riavviato: forever restart app.js
Avviso: Preciso che non ho affiliazioni con il team RipaEx e non ricopro alcuna posizione nel progetto, questo per trasparenza.
La guida è tradotta dall'articolo in inglese apparso su steemit ->
https://steemit.com/news/@ripaex/how-set-up-a-node-for-ripaex
