Skip to content

chainlayer/quicksync-playbooks

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

quicksync-playbooks

Playbooks to install a terrad node with Chainlayer Quicksync

Prerequisites

  • on your local machine install ansible
  • make sure you have ssh-key access to the target machine with either root or a user with sudo rights
  • Terra Columbus 4 is heavy on the memory requirements, add at least 12Gb or preferable 16Gb to your server

Usage

git clone https://github.com/chainlayer/quicksync-playbooks.git
# edit group_vars/terra.yml file
vim group_vars/terra.yml
# edit ansible-hosts.yml file
vim ansible-hosts.yml
cd quicksync-playbooks
./quicksync

Troubleshooting

Cancelled downloads

If for whatever reason the download is cancelled, you can resume it manually (assuming default variables):

sudo su - terrauser
cd /home/terrauser
aria2c --continue -x 5 https://get.quicksync.io/columbus-4-pruned.DATE.TIME.tar.lz4
cd .terrad
tar -I lz4 -xf /home/terrauser/columbus-4-pruned.DATE.TIME.tar.lz4
exit
# enable and start terrad with sudo
sudo systemctl enable terrad
sudo systemctl start terrad

Feedback during downloads

Downloading the blockchain using the quicksync option can take a long time! Ansible will not give you any feedback unfortunately. You can check if aria2c is still working by checking top on the host or checking the aria.log file in the download dir for progress

Disk space needed

You need enough harddisk space to store the download as well as the unpacked chain, lz4's compression rate is roughly 30% so you would need at least 2,4 time the download size in disk space. A variable called cl_download_dir can be used to specify a different download directory, that way you could add a temporary second disk for the download and remove it afterwards.

A word on idempotency

Normally Ansible playbooks are idempotent meaning you can run them multiple times with the same result. This playbook should be idempotent as well however running it a second time will download the whole quicksync another time and is therefore not recommended.

About

Playbooks to use with Chainlayer Quicksync

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages