poa-devops/docs/Update-scripts-validator.md

Update scripts on validator nodes

ONLY FOR VALIDATOR NODES

0. this guide assumes that you're running this playbook from the same machine you used to make initial deployment of your node. So that you already have python and ansible installed, and you have the correct ssh keypair to root-access the node.

1. clone this repository if you haven't done so before

git clone https://github.com/poanetwork/poa-devops.git
cd poa-devops

or pull the latest changes

cd poa-devops
git pull origin master

2. create group_vars/all file:

cp group_vars/upd-scripts-validator.example group_vars/all

NOTE: by default playbook assumes that you are updating your SOKOL validator node. If you are updating CORE validator node, in group_vars/all change SCRIPTS_VALIDATOR_BRANCH to "core" as shown below:

SCRIPTS_VALIDATOR_BRANCH: "core"

3. create/edit hosts file:

echo "" > hosts

and put your node's ip address (assuming it's 192.0.2.1) there with the following header:

[upd-scripts-validator]
192.0.2.1

NOTE: if you're updating an existing file, make sure you remove other tags [...] and ips.

4. run the playbook:

ansible-playbook -i hosts site.yml

5. connect to the node

ssh root@192.0.2.1

switch to the home folder:

cd /home/validator

and check the update time of poa-scripts-validator folder (should be about the time you started the playbook)

ls -lh
# a long list should appear here, look for poa-scripts-validator in the rightmost column and check the date and time on the same row

also check that backup was created:

ls -lh backups-scripts-validator/
# look for a file named similar to poa-scripts-validator-20180202-184912.json Numbers represent date and time in UTC when the playbook was started

6. wait 2 hours and check that balance of your payout key gets updated