Playbook to update bootnodes.txt
This commit is contained in:
parent
6bdd6170b5
commit
5cfa9cbe2f
|
@ -5,6 +5,7 @@ group_vars/backup
|
||||||
group_vars/hf-spec-change
|
group_vars/hf-spec-change
|
||||||
group_vars/upd-parity-version
|
group_vars/upd-parity-version
|
||||||
group_vars/upd-scripts-validator
|
group_vars/upd-scripts-validator
|
||||||
|
group_vars/upd-bootnodes-txt
|
||||||
hosts
|
hosts
|
||||||
|
|
||||||
logs/*.err
|
logs/*.err
|
||||||
|
|
|
@ -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.
|
|
@ -0,0 +1,5 @@
|
||||||
|
---
|
||||||
|
# bootnode | moc | validator | explorer | netstat
|
||||||
|
poa_role: "validator"
|
||||||
|
MAIN_REPO_FETCH: "poanetwork"
|
||||||
|
GENESIS_BRANCH: "sokol"
|
|
@ -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
|
|
@ -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
|
Loading…
Reference in New Issue