Basechain Jump Start

A Basechain node with all historical state from the genesis block onwards takes up around 500GB of disk space, it's not practical to sync a new node from the genesis block (it would take forever). New nodes can be spun up using one of the jump start archives that we provide, these contain recent state, so a node can sync up with the chain in a few hours.

We provide two kinds of jump starts, a full size one, and a minimal one. The full size jump start contains a lot of historical data, you would generally only need it if you wanted to index all the historical state. If you just want to spin up a new validator node, or a sentry node, then you're better off using the minimal jump start, which only contains recent state.

Follow the instructions below to launch a Basechain node from a jump start archive.

#Hardware Requirements

The minimum hardware requirements are as follows: 4 CPU, 32 GB RAM, NVMe SSD. Example: AWS i3.xlarge.

#Download the Latest Basechain Stable Build

wget https://downloads.zeknd.xyz/zeknd/linux/stable/basechain
chmod +x basechain

#Download the Jump Start Archive

There are two available locations where you can download it from, USA or Singapore. Choose the location closest to you. The Singapore location is automatically replicated from the USA location so it might be a while before it becomes available when we update the archive.

In each location, there are two different archives. One is full and another is the smaller image that has no historical app state.

#United States

• Minimal jump start:

  • Archive: http://zeknd-share.s3-website.us-east-2.amazonaws.com/plasma-jump-start-min.tar.gz

  • MD5: http://zeknd-share.s3-website.us-east-2.amazonaws.com/plasma-jump-start-min.tar.gz.md5sum

  • [OPTIONAL] Receipts DB (not necessary for most new nodes)

    • Archive: http://zeknd-share.s3-website.us-east-2.amazonaws.com/plasma-jump-start-min-receipts_db.tar.gz

    • MD5: http://zeknd-share.s3-website.us-east-2.amazonaws.com/plasma-jump-start-min-receipts_db.tar.gz.md5sum

• Full jump start:

  • Archive: http://zeknd-share.s3-website.us-east-2.amazonaws.com/plasma-jump-start.tar.gz

  • MD5: http://zeknd-share.s3-website.us-east-2.amazonaws.com/plasma-jump-start.tar.gz.md5sum

#Singapore

• Minimal jump start:

  • Archive: http://zeknd-share-sg.s3-website.ap-southeast-1.amazonaws.com/plasma-jump-start-min.tar.gz

  • MD5: http://zeknd-share-sg.s3-website.ap-southeast-1.amazonaws.com/plasma-jump-start-min.tar.gz.md5sum

  • [OPTIONAL] Receipts DB (not necessary for most new nodes)

    • Archive: http://zeknd-share-sg.s3-website.ap-southeast-1.amazonaws.com/plasma-jump-start-min-receipts_db.tar.gz

    • MD5: http://zeknd-share-sg.s3-website.ap-southeast-1.amazonaws.com/plasma-jump-start-min-receipts_db.tar.gz.md5sum

• Full jump start:

  • Archive: http://zeknd-share-sg.s3-website.ap-southeast-1.amazonaws.com/plasma-jump-start.tar.gz

  • MD5: http://zeknd-share-sg.s3-website.ap-southeast-1.amazonaws.com/plasma-jump-start.tar.gz.md5sum

#Extract the Archive

tar xfvz plasma-jump-start.tar.gz

#Generate the Unique Config

mkdir blank
cd blank
cp ../zeknd-jump-start/zeknd.yml .
../basechain init
cp chaindata/config/{priv_validator.json,node_key.json} ../zeknd-jump-start/chaindata/config/
cd ../zeknd-jump-start

#Start the Node

../basechain run --persistent-peers tcp://1f3dde151c0268fce847078e6143c820fe05e556@18.117.58.75:46656

#Finally

The non-validator node will now sync with the validator nodes. Status can be queried at http://localhost:46658/rpc/status

#Run zeknd as a service on Ubuntu 16.04 (Optional)

Create /etc/systemd/system/zeknd.service

[Unit]
Description=zeknd
After=network.target

[Service]
Type=simple
User=<user that runs zeknd>
WorkingDirectory=<working directory of zeknd>
ExecStart=<path to zeknd>/basechain run --persistent-peers tcp://1f3dde151c0268fce847078e6143c820fe05e556@18.117.58.75:46656
Restart=always
RestartSec=2
StartLimitInterval=0
LimitNOFILE=500000
StandardOutput=syslog
StandardError=syslog

[Install]
WantedBy=multi-user.target

#Reload the Config

systemctl daemon-reload

#Run zeknd on Boot

systemctl enable zeknd.service

#To start/stop/restart the Service

systemctl (start/stop/restart) zeknd.service

#Inspect the Logs (Method 1)

tail -f /var/log/syslog

#Inspect the Logs (method 2)

sudo journalctl -u zeknd.service -f

#The Open Files Limit

When using systemd, the open files limit is taken care of by the LimitNOFILE directive. It will not, however, be applied when running zeknd manually.

#The system-wide Limit

Add the following lines to the /etc/sysctl.conf file:

fs.file-max=500000

To activate it immediately:

sudo sysctl -p

To check whether it is active:

cat /proc/sys/fs/file-max

#For a Specific User

Add the following lines to the /etc/security/limits.conf file:

username        hard nofile 500000
username        soft nofile 500000

Note: The user needs to re-login to have it active

To check whether it is active:

# check soft limit
ulimit -Sn

# check hard limit
ulimit -Hn