Playbook to update bootnodes.txt

.gitignore

@@ -5,6 +5,7 @@ group_vars/backup
 group_vars/hf-spec-change
 group_vars/upd-parity-version
 group_vars/upd-scripts-validator
+group_vars/upd-bootnodes-txt
 hosts
 
 logs/*.err

docs/Update-bootnodes-txt.md

@@ -0,0 +1,93 @@
+## Update bootnodes.txt
+
+0. this guide assumes that you're running this playbook from the same machine that 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.
+
+### Running the update
+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-bootnodes-txt.example group_vars/all
+```
+and change the following variables:
+* `poa_role` - role of the node on the network (one of `bootnode`, `validator`, `moc`, `explorer`)
+* `GENESIS_BRANCH` - either `"sokol"` for testnet or `"core"` for mainnet
+
+don't change other options
+
+3. create/edit `hosts` file and put your node's ip address (assuming it's 192.0.2.1) there with the following header:
+```
+[upd-bootnodes-txt]
+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 upd-bootnodes-txt.yml
+```
+
+### Verifying the update
+0. playbook run should be completed without errors
+
+1. open network statistic webpage:
+  - for sokol test network: https://sokol-netstat.poa.network
+  - for core main network: https://core-netstat.poa.network
+
+check that your node is "green" and is catching new blocks. It may take 2-3 minutes to fully start and reconnect. Check how many peers you have.
+
+### Rollback to the previous version (in case of problems)
+**NOTE**: if you get any errors please consult the POA Team first, probably you have a minor issue and don't need to rollback
+
+1. connect to the node:
+```
+ssh root@192.0.2.1
+```
+
+2. switch to your home folder (replace `bootnode` with correct role name):
+```
+cd /home/bootnode
+```
+
+3. stop services:
+```
+systemctl stop poa-netstats
+systemctl stop poa-parity
+```
+
+4. locate the backup folder:
+```
+ls backups-bootnodes.txt
+```
+it contains folders labeled by the time backup was created in format`<year><month><day>T<hour><minute><second>`, e.g.
+```
+# ls backups-bootnodes.txt
+20180208T152105 20180209T214517
+```
+copy the version number that corresponds to this day. In the following examples we assume that it's `20180209T214517`.
+
+5. restore previous versions of these files from backup (note dots `.` at the end of each line here, they are important):
+```
+cp -a backups-bootnodes.txt/20180209T214517/bootnodes.txt .
+```
+
+6. restart services
+```
+systemctl restart poa-parity
+systemctl restart poa-netstats
+```
+
+7. open network statistic webpage:
+  - for sokol test network: https://sokol-netstat.poa.network
+  - for core main network: https://core-netstat.poa.network
+
+check that your node is "green" and is catching new blocks. It may take 2-3 minutes to fully start and reconnect.

group_vars/upd-bootnodes-txt.example

@@ -0,0 +1,5 @@
+---
+# bootnode | moc | validator | explorer | netstat
+poa_role: "validator"
+MAIN_REPO_FETCH: "poanetwork"
+GENESIS_BRANCH: "sokol"

roles/upd-bootnodes-txt/tasks/main.yml

@@ -0,0 +1,38 @@
+---
+- name: Check that node role is correct
+  stat:
+    path: "{{ home }}"
+  register: role_home_folder
+  failed_when: not role_home_folder.stat.exists
+
+- name: Check that the netstats service is installed
+  stat:
+    path: /etc/systemd/system/poa-netstats.service
+  register: netstats_service_file
+
+- name: Shutdown poa-netstats service
+  service: name=poa-netstats state=stopped
+  when: netstats_service_file.stat.exists
+
+- name: Shutdown poa-parity service
+  service: name=poa-parity state=stopped
+
+- name: Create directory for bootnodes.txt backups
+  file: path="{{ backups_folder }}" state=directory
+
+- name: Backup bootnodes.txt
+  command: cp -a {{ home }}/bootnodes.txt {{ backups_folder }}/bootnodes.txt
+
+- name: Download new bootnodes.txt
+  get_url:
+    url: "https://raw.githubusercontent.com/{{ MAIN_REPO_FETCH }}/poa-chain-spec/{{ GENESIS_BRANCH }}/bootnodes.txt"
+    dest: "{{ home }}/bootnodes.txt"
+    mode: "0644"
+    force: "yes"
+
+- name: Launch poa-parity service
+  service: name=poa-parity state=started
+
+- name: Launch poa-netstats service
+  service: name=poa-netstats state=started
+  when: netstats_service_file.stat.exists

upd-bootnodes-txt.yml

@@ -0,0 +1,10 @@
+- hosts: upd-bootnodes-txt
+  vars:
+    date: "{{ ansible_date_time.iso8601_basic_short }}"
+    home: "/home/{{ poa_role }}"
+    backups_folder: "{{ home }}/backups-bootnodes.txt/{{ date }}"
+  user: ubuntu
+  become: true
+  become_user: root
+  roles:
+    - upd-bootnodes-txt