Welcome to the EOS Jungle4.0 Testnet [manual node installation]

Chain ID: 73e4385a2708e6d7048834fbc1079f2fabb17b3c125b146af438971e90716c4d
Based on tag: v2.0.13

Please join out Jungle testnet Telegram channel
Network Monitor: https://monitor4.jungletestnet.io/

! This repo is for manual installation. Please use our auto installer script for auto installation:
https://github.com/EOS-Jungle-Testnet/Node-Auto-installation

To start a Jungle 4 node you need install EOSIO software. You can compile from sources or install from precompiled binaries:

1. Installing EOSIO

1.1 EOSIO - Installing from sources

A. Create folder, download sources, compile and install:

mkdir /opt/EOSIO  
cd /opt/EOSIO  

git clone https://github.com/eosio/eos --recursive    
cd eos  

git checkout v2.0.13  
git submodule update --init --recursive   

./scripts/eosio_build.sh -P -y
./scripts/eosio_install.sh

B. Copy binaries to keep old versions and make sym link to latest:

mkdir /opt/bin
mkdir /opt/bin/v2.0.13
cp /opt/EOSIO/eos/build/programs/nodeos/nodeos /opt/bin/v2.0.13/
cp /opt/EOSIO/eos/build/programs/cleos/cleos /opt/bin/v2.0.13/
cp /opt/EOSIO/eos/build/programs/keosd/keosd /opt/bin/v2.0.13/
ln -sf /opt/bin/v2.0.13 /opt/bin/bin

So /opt/bin/bin will point to latest binaries

1.2 EOSIO - installing from precompiled binaries

A. Download the latest version of EOSIO for your OS from:
https://github.com/EOSIO/eos/releases/tag/v2.0.13
For example, for ubuntu 18.04 you need to download deb eosio_2.0.13-1-ubuntu-18.04_amd64.deb
To install it you can use apt:

apt install ./eosio_2.0.13-1-ubuntu-18.04_amd64.deb

It will download all dependencies and install EOSIO to /usr/opt/eosio/v2.0.13
B. Copy binaries to keep old versions and make sym link to latest:

 mkdir /opt/bin
 mkdir /opt/bin/v2.0.13
 cp /usr/opt/eosio/2.1.0/bin/nodeos /opt/bin/v2.0.13/
 cp /usr/opt/eosio/2.1.0/bin/cleos /opt/bin/v2.0.13/
 cp /usr/opt/eosio/2.1.0/bin/keosd /opt/bin/v2.0.13/
 ln -sf /opt/bin/v2.0.13 /opt/bin/bin

So /opt/bin/bin will be point to latest binaries

2. Update EOSIO software to new version

2.1 Update sources

cd /opt/EOSIO/eos
git checkout -f
git branch -f
git pull
git checkout v2.0.13   
git submodule update --init --recursive   

./scripts/eosio_build.sh -P -y
./scripts/eosio_uninstall.sh
./scripts/eosio_install.sh

mkdir /opt/bin/v2.0.13
cp /opt/EOSIO/eos/build/programs/nodeos/nodeos /opt/bin/v2.0.13/
cp /opt/EOSIO/eos/build/programs/cleos/cleos /opt/bin/v2.0.13/
cp /opt/EOSIO/eos/build/programs/keosd/keosd /opt/bin/v2.0.13/
ln -sf /opt/bin/v2.0.13-rc2 /opt/bin/bin

2.3 Update binaries

To upgrade precompiled installation pleasse folow the same steps as in 1.2 (Installation from precompiled)

3. Install Jungle4.0 Testnet node [manual]

Check our auto installer script: https://github.com/EOS-Jungle-Testnet/Node-Auto-installation

    mkdir /opt/Jungle4Testnet
    cd /opt/Jungle4Testnet
    git clone https://github.com/EOS-Jungle-Testnet/Node-Manual-Installation.git ./

In case you use a different data-dir folders -> edit all paths in files cleos.sh, start.sh, stop.sh, config.ini, Wallet/start_wallet.sh, Wallet/stop_wallet.sh
Choose your producer name (12 symbols length only, a-z 1-5 alowed only) and create own EOS key pair
you can create key pair using cleos command
./cleos.sh create key
or using Scatter or here.
If non BP node: use the same config, just comment out rows with producer-name and signature-provider
Edit config.ini:
- server address: p2p-server-address = ENRT_YOUR_NODE_EXTERNAL_IP_ADDRESS:9876
- if BP: your producer name: producer-name = YOUR_BP_NAME
- if BP: add producer keypair for signing blocks (this pub key should be used in regproducer action):
  signature-provider = YOUR_PUB_KEY_HERE=KEY:YOUR_PRIV_KEY_HERE
- replace p2p-peer-address list with fresh generated on monitor site: http://monitor4.jungletestnet.io/#p2p
- Check chain-state-db-size-mb value in config, it should be not bigger than you have RAM:
  chain-state-db-size-mb = 16384
Open TCP Ports (8888, 9876) for inbound traffic on your firewall/router

Start wallet, run

cd /opt/Jungle4Testnet
./Wallet/start_wallet.sh

First run should be with --delete-all-blocks and --genesis-json

./start.sh --delete-all-blocks --genesis-json genesis.json

Check logs stderr.txt if node is running ok.

Create your wallet file
```
./cleos.sh wallet create --file pass.tx
```
Your password will be in pass.txt it will be used when unlock wallet
Unlock your wallet
```
./cleos.sh wallet unlock  
```
enter the wallet password.
Import your key
```
./cleos.sh wallet import
```
Enter your private key
Check if you can access you node using link http://you_server:8888/v1/chain/get_info (Example)
If you would like to run a BP node you need register your node at Jungle4.0 Testnet monitor
http://monitor4.jungletestnet.io/#register
- In registartion form - PIN is your password to node information updates
  After registration is complete - personal intallation script will be created for you. Skip this step in case of manual installation.

==============================================================================================

4.1 Restore/Start from Backup

Download latest block and state archive for your OS from https://backup.cryptolions.io/Jungle/

   wget  https://backup.cryptolions.io/Jungle//ubuntu18/blocks-latest.tar.gz
   wget https://backup.cryptolions.io/Jungle/o/ubuntu18/state-latest.tar.gz

After downloaded extract their

   tar xzvf blocks-latest.tar.gz -C .
   tar xzvf state-latest.tar.gz -C .

You got two folders block and state.
Ater that go to NODE folder, and remove files from folder blocks and state

   cd /opt/Jungle4Testnet
   rm blocks/*
   rm state/*

After that go where you extracted archive and move file from folder

   mv ~/blocks/* /opt/Jungle4Testnet/blocks/
   mv ~/state/* /opt/Jungle4Testnet/state/

After files moved start your NODE

   ./start.sh

4.2 Restore/Start from Snapshots

Download latest snapshot from http://backup.cryptolions.io/Jungle/snapshots/ to snapshots folder in your NODE directory

   cd /opt/Jungle4Testnet/snapshots/
   wget http://backup.cryptolions.io/Jungle/snapshots/latest-snapshot.bin

after it downloaded run start.sh script with option --snapshot and snapshot file path

   cd /opt/Jungle4Testnet
   ./start.sh --snapshot /opt/Jungle4Testnet/snapshots/latest-snapshot.bin

5. Usefull Information

Jungle 4.0 Faucet - get free EOS Jungle tokens:

https://monitor4.jungletestnet.io/#faucet

Other Tools/Examples

In scripts folder you can find scripts examples: how to register bp, stake, vote, claimrewards, etc
Vote using monitor (prepare Cleos command or use scatter)
Create account:
https://monitor4.jungletestnet.io/#account
Cleos commands:

Send EOS

./cleos.sh transfer <your account> <receiver account> "1.0000 EOS" "test memo text"

Get Balance

./cleos.sh get currency balance eosio.token <account name>

Create account

./cleos.sh system newaccount --stake-net "10.0000 EOS" --stake-cpu "10.0000 EOS" --buy-ram-bytes 4096 <your accountr> <new account> <pkey1> <pkey2>

List registered producers (-l )

./cleos.sh get table eosio eosio producers -l 100

List your last action (use -h to get help, do not work now, works with history node only)

./cleos.sh get actions <account name>

List staked/delegated

./cleos.sh system listbw <account>

Jungle4 History nodes

Hyperion History
https://jungle4.cryptolions.io/v2/docs/

State History endpoint

Block Explorers
https://jungle4.cryptolions.io/v2/explore

Backups

Full(blocks and states):

Ubuntu 18
Snapshot:
Snapshots

by: CryptoLions.io

Keybase account: cryptolions

EOS-Jungle-Testnet / Node-Manual-Installation

readme