Ansible role for Nimbus Eth2 beacon node on Windows https://github.com/status-im/nimbus-eth2
Go to file
Jakub Sokołowski bd60f4f07f
build: fix wrong slash in log file path
Signed-off-by: Jakub Sokołowski <jakub@status.im>
2021-10-16 11:39:15 +02:00
defaults change log folder to be logs, move build logs there 2021-10-04 20:38:38 +02:00
handlers add Consul service definition for beacon node 2021-06-19 01:46:41 +02:00
meta use dist-validators role to deploy validators 2021-07-16 15:10:54 +02:00
tasks build: fix wrong slash in log file path 2021-10-16 11:39:15 +02:00
templates rpc.sh: add --show-error flag to curl 2021-10-05 12:21:56 +02:00
README.md readme: add example of winsw wrapper usage 2021-09-29 19:38:23 +02:00

README.md

Description

This role provisions a Nimbus installation that can act as an ETH2 network bootstrap node.

Ports

The service exposes three ports by default:

  • 9000 - LibP2P peering port. Must ALWAYS be public.
  • 9200 - JSON RPC port. Must NEVER be public.
  • 9900 - Prometheus metrics port. Should not be public.

Configuration

Minimum configuration would include.

beacon_node_network: 'testnet0'
# Infura Web Sockets URLs
beacon_node_web3_urls: ['wss://mainnet.infura.io/ws/v3/123qwe123qwe123qwe']

The order of Web Socket URLs matters. First is the default, the rest are fallbacks.

It might be useful to increase the log verbosity level:

beacon_node_log_level: DEBUG

Management

The services are managed using WinSW.

admin@windows-01 MINGW64 .../nimbus/beacon-node-prater-stable                                                                                                                                                                                                                                         
$ ./beacon-node-prater-stable.exe status                                                                                                                                                                                                                                                              
Started                                                                                                                                                                                                                                                                                               
                                                                                                                                                                                                                                                                                                      
admin@windows-01 MINGW64 .../nimbus/beacon-node-prater-stable                                                                                                                                                                                                                                         
$ ./beacon-node-prater-stable.exe restart                                                                                                                                                                                                                                                             
2021-09-29 17:33:27,563 INFO  - Stopping service 'Beacon Node prater (unstable) (beacon-node-prater-stable)'...                                                                                                                                                                                       
2021-09-29 17:33:27,825 INFO  - Starting service 'Beacon Node prater (unstable) (beacon-node-prater-stable)'...                                                                                                                                                                                       
2021-09-29 17:33:28,366 INFO  - Service 'Beacon Node prater (unstable) (beacon-node-prater-stable)' restarted successfully.  

The scheduled tasks that trigger beacon node builds can be checked with Get-ScheduledTask:

PS C:\Users\admin> Get-ScheduledTask -TaskName 'build-beacon-node*' | ft State,TaskName,Description,Date                                                                                                                                                                                              
                                                                                                         
State TaskName                          Description                                  Date                                                                                                                                                                                                             
----- --------                          -----------                                  ----                                                                                                                                                                                                             
Ready build-beacon-node-prater-stable   Daily rebuild of Nimbus beacon node binaries 2021-09-29T13:00:00                                                                                                                                                                                              
Ready build-beacon-node-prater-testing  Daily rebuild of Nimbus beacon node binaries 2021-09-29T17:00:00                                                                                                                                                                                              
Ready build-beacon-node-prater-unstable Daily rebuild of Nimbus beacon node binaries 2021-09-29T15:00:00

The logs for scheduled tasks running builds can be looked up using Get-WinEvent:

PS C:\Users\nimbus\beacon-node-prater-stable> Get-WinEvent -LogName Microsoft-Windows-TaskScheduler/Operational | Select -First 4 | ft -Property TimeCreated,Message

TimeCreated           Message
-----------           -------
6/17/2021 11:09:46 AM Task Scheduler did not launch task "\build-beacon-node-prater-unstable"  because instance "{afe16e96-be8d-40b8-a398-b3be6513de88}"  of the same task is already running.
6/17/2021 11:09:46 AM Task Scheduler launched "{72498e41-91ee-4318-95f4-54daca2acf2f}"  instance of task "\build-beacon-node-prater-unstable"  for user "System" .
6/17/2021 11:09:46 AM Task Scheduler queued instance "{72498e41-91ee-4318-95f4-54daca2acf2f}"  of task "\build-beacon-node-prater-unstable".
6/17/2021 11:06:55 AM Task Scheduler successfully finished "{747c0708-0908-4514-a4b4-c6e71d6132c0}" instance of the "\build-beacon-node-prater-stable" task for user "NT AUTHORITY\SYSTEM".

Known Issues

  • The WinSW wrapper fails to grant Log On As Service right. (winsw#840)
  • The --log-file flag has no effect on windows. (nimbus-eth2#2326