Skip to content

Latest commit

 

History

History
137 lines (90 loc) · 3.36 KB

advanced-lvl.2.md

File metadata and controls

137 lines (90 loc) · 3.36 KB
Raw

⚡ ADV: Linux terminal install

Installing Voi testnet node

{% hint style="info" %} This guide will help you install non-archival, catch-up node that you can use for development, account management or participation {% endhint %}

Overview

  • Install Algorand node binaries
  • Switch network to testnet Voi
  • Enable anonymous telemetry
  • Do a fast catch-up

Step 1 : Install any type of official binaries for Algorand node

This this is advanced level guide and it assumes you already have an Algorand mainnet/testnet node installed on Linux/Ubuntu. You can try some of the guides here:

{% embed url="https://d13.co/set-up-algorand-participation-node-on-oracle-cloud-free/" %}

{% embed url="https://developer.algorand.org/docs/run-a-node/setup/install/" %}

Step 2 : Switch network to Voi

Stop your node either with

goal node stop

or

systemctl stop algorand

Add Voi relays to node's config.json

algocfg set -p DNSBootstrapID -v "<network>.voi.network"
algocfg set -p EnableCatchupFromArchiveServers -v true

Note: You can use these commands as provided, no need to replace <network>.

Your /var/lib/algorand/config.json should look like :

{
        "DNSBootstrapID": "<network>.voi.network",
        "EnableCatchupFromArchiveServers": true
}

Overwrite /var/lib/algorand/genesis.json file with Voi genesis

You can also do it with this command:

sudo curl -s -o /var/lib/algorand/genesis.json https://testnet-api.voi.nodly.io/genesis

Or you can download the genesis.json here as well.

Step 3 : Enable telemetry

{% hint style="info" %} Telemetry server does not process/store your node IP address. {% endhint %}

Enabling telemetry is optional for normal participation but required if you want to prove your node's performance. You can name your node but it is not required. 

# name you node
diagcfg telemetry name -n "turbo.voi"
# enable telemetry
diagcfg telemetry enable

Confirm telemetry is configured:

root@alab:~# diagcfg telemetry status 

Remote logging is enabled. 
Node = Lab, Guid = 12455678-7434-4423-91ee-0a3500ec5680

{% hint style="warning" %} If you enable telemetry on a working node you need to restart it {% endhint %}

Step 4 : Fast catch-up

{% hint style="info" %} This will sync your non-archival node in minutes {% endhint %}

Start your node either with

goal node start

or

systemctl start algorand

Do the fast catch-up

sudo apt install -y jq 
goal node catchup $(curl -s https://testnet-api.voi.nodly.io/v2/status|jq -r '.["last-catchpoint"]')

Step 5 : Watch your node syncing

You can now watch how you node syncs with this comman (ctrl-c to stop):

watch goal node status

You node is synced once Sync Time: reads 0.0s

Peer2Peer relay discovery (TBA)

{% hint style="info" %} P2P relay discovery allows connection to fully permissionless network without centrally managed relays. Watch this place for P2P setup info. {% endhint %}