Using Ansible

An Ansible playbook can be used to configure and manage a full node.

Prerequisites¶

Install Ansible on your local machine with Python3.x. The setup doesn’t run on Python 2.x.
- To install Ansible with Python 3.x, you can use pip. If you do not have pip on your machine, follow the steps outlined here. Run pip3 install ansible to install Ansible.
Check the Polygon PoS Ansible repository for requirements.
You also need to ensure that Go is not installed in your environment. You will run into issues if you attempt to set up your full node through Ansible with Go installed as Ansible requires specific packages of Go.
You will also need to make sure that your VM / Machine does not have any previous setups for Polygon Validator or Heimdall or Bor. You will need to delete them as your setup will run into issues.

Full node setup¶

Ensure you have access to the remote machine or VM on which the full node is being set up.

Refer to https://github.com/maticnetwork/node-ansible#setup for more details.
Clone the https://github.com/maticnetwork/node-ansible repository.
Navigate into the node-ansible folder: cd node-ansible
Edit the inventory.yml file and insert your IP(s) in the sentry->hosts section.

Refer to https://github.com/maticnetwork/node-ansible#inventory for more details.
Check if the remote machine is reachable by running: ansible sentry -m ping
To test if the correct machine is configured, run the following command:

# Mainnet:
ansible-playbook playbooks/network.yml --extra-var="bor_version=v1.0.0 heimdall_version=v1.0.3 network=mainnet node_type=sentry" --list-hosts

# Testnet:
ansible-playbook playbooks/network.yml --extra-var="bor_version=v1.1.0 heimdall_version=v1.0.3 network=amoy node_type=sentry" --list-hosts

Figure: Full node testnet

Next, set up the full node with this command:

# Mainnet:
ansible-playbook playbooks/network.yml --extra-var="bor_version=v1.1.0 heimdall_version=v1.0.3 network=mainnet node_type=sentry"

# Testnet:
ansible-playbook playbooks/network.yml --extra-var="bor_version=v1.0.0 heimdall_version=v1.0.3 network=amoy node_type=sentry"

In case you run into any issues, delete and clean the whole setup using:
```
ansible-playbook playbooks/clean.yml
```
Once you initiate the Ansible playbook, log in to the remote machine.
Please ensure that the value of seeds and bootnodes mentioned below is the same value as mentioned in Heimdall and Bor config.toml files. If not, change the values accordingly.

Amoy testnet seeds

The Heimdall and Bor seeds don’t need to be configured manually for Amoy testnet since they’ve already been included at genesis.

Heimdall seed nodes:

moniker=<enter unique identifier>

# Mainnet:
seeds="1500161dd491b67fb1ac81868952be49e2509c9f@52.78.36.216:26656,dd4a3f1750af5765266231b9d8ac764599921736@3.36.224.80:26656,8ea4f592ad6cc38d7532aff418d1fb97052463af@34.240.245.39:26656,e772e1fb8c3492a9570a377a5eafdb1dc53cd778@54.194.245.5:26656,6726b826df45ac8e9afb4bdb2469c7771bd797f1@52.209.21.164:26656"

Bootnodes:

# Mainnet:
bootnode ["enode://b8f1cc9c5d4403703fbf377116469667d2b1823c0daf16b7250aa576bacf399e42c3930ccfcb02c5df6879565a2b8931335565f0e8d3f8e72385ecf4a4bf160a@3.36.224.80:30303", "enode://8729e0c825f3d9cad382555f3e46dcff21af323e89025a0e6312df541f4a9e73abfa562d64906f5e59c51fe6f0501b3e61b07979606c56329c020ed739910759@54.194.245.5:30303"]

To check if Heimdall is synced
- On the remote machine/VM, run curl localhost:26657/status
- In the output, catching_up value should be false
Once Heimdall is synced, run:
- sudo service bor start

If you’ve reached this point, you have successfully set up a full node with Ansible.

Note

If Bor presents an error of permission to data, run this command to make the Bor user the owner of the Bor files:

sudo chown bor /var/lib/bor

Logs¶

Logs can be managed by the journalctl linux tool. Here is a tutorial for advanced usage: How To Use Journalctl to View and Manipulate Systemd Logs.

Check Heimdall node logs¶

journalctl -u heimdalld.service -f

Check Bor node logs¶

journalctl -u bor.service -f