Set Up a Node Using Ansible

​

Prerequisites

• Three machines:
  • Local machine (runs Ansible playbook)
  • Remote Sentry node
  • Remote Validator node
• Local machine:
  • Ansible installed
  • Python 3.x installed
• Remote machines:
  • Go must not be installed
  • Your local machine’s SSH public key added for Ansible access

​

Overview: Sequence of Actions

​

Set Up the Sentry Node

1. Clone the node-ansible repository:
   git clone https://github.com/shibaone/node-ansible
   cd node-ansible
   
2. Add IPs to inventory.yml:
   # add your instance ips here
   134.209.100.175 # Example IP for sentry/validator node
   
3. Check remote sentry machine is reachable:
   ansible sentry -m ping
   
   Output should include "ping": "pong".
4. Test run of sentry node setup:
   ansible-playbook playbooks/network.yml --extra-var="bor_version=v1.x.x-bone heimdall_version=v1.x.x-bone network=shibarium node_type=sentry" --list-hosts
   
5. Run the sentry node setup with sudo:
   ansible-playbook -l sentry playbooks/network.yml --extra-var="bor_version=v1.x.x-bone heimdall_version=v1.x.x-bone network_version=shibarium node_type=sentry/sentry heimdall_network=shibarium" --ask-become-pass
   
6. If you need to start over:
   ansible-playbook -l sentry playbooks/clean.yml
   

​

Set Up the Validator Node

1. Check remote validator machine is reachable:
   ansible validator -m ping
   
2. Test run of validator node setup:
   ansible-playbook playbooks/network.yml --extra-var="bor_version=v1.x.x-bone heimdall_version=v1.x.x-bone network=shibarium node_type=sentry" --list-hosts
   
3. Run the validator node setup with sudo:
   ansible-playbook -l validator playbooks/network.yml --extra-var="bor_version=v1.x.x-bone heimdall_version=v1.0.3-bone network_version=shibarium node_type=sentry/validator heimdall_network=shibarium" --ask-become-pass
   
4. If you need to start over:
   ansible-playbook -l validator playbooks/clean.yml
   

​

Configure the Sentry Node

• Edit Heimdall config:
  vi /var/lib/heimdall/config/config.toml
  
  • moniker = "my-full-node"
  • pex = true
  • private_peer_ids = node ID of validator Heimdall
  • seeds (for Shibarium only): node ID, IP, port
• Check sync status:
  curl localhost:26657https://shib-io.openstatus.dev/
  
  • catching_up: true means syncing, false means fully synced
• Start Bor service:
  sudo service bor start
  journalctl -u bor.service -f
  

​

Configure the Validator Node

• Edit Heimdall config:
  vi /var/lib/heimdall/config/config.toml
  
  • moniker = "my-validator-node"
  • pex = false
  • Comment out private_peer_ids
  • Add persistent_peers as sentry node: persistent_peers = "sentryNodeID@sentryIP:26656"
  • prometheus = true
• Edit heimdall-config.toml:
  vi /var/lib/heimdall/config/heimdall-config.toml
  
  • eth_rpc_url = "<your Ethereum mainnet RPC URL>"
• Edit Bor config:
  vi /var/lib/bor/config.toml
  
  • trusted-nodes = ["enode://sentryEnodeID@sentryIP:30303"]

​

Set the Owner and Signer Key

heimdallcli generate-validatorkey ETHEREUM_PRIVATE_KEY
mv ./priv_validator_key.json /var/lib/heimdall/config/

heimdallcli generate-keystore ETHEREUM_PRIVATE_KEY
mv ./UTC-<time>-<address> /var/lib/bor/data/keystore/

vi /var/lib/bor/password.txt

[accounts]
allow-insecure-unlock = true
password = "/var/lib/bor/password.txt"
unlock = ["0xYourEthereumAddress"]

​

Start the Validator Node

• Start Heimdall service:
  sudo service heimdalld start
  journalctl -u heimdalld.service -f
  curl localhost:26657https://shib-io.openstatus.dev/
  
  Wait for catching_up: false before starting Bor.
• Start Bor service:
  sudo service bor start
  journalctl -u bor.service -f