Jakub Sokołowski
5c408f8ce4
Something goes wrong when parsing and GRN definition is treated as target. Signed-off-by: Jakub Sokołowski <jakub@status.im> |
||
---|---|---|
.. | ||
Makefile | ||
README.md | ||
service.template |
README.md
Status Bootnode
This folder contains setup for running your own Status Bootnode. It uses Systemd for managing the Status Bootnode service.
The steps it takes are:
- Builds
bootnode
- Generates & saves a private key
- Generates
systemd
service - Starts the service
Usage
To simply configure and start the service run make
.
In order to manage the new statusd
service you use other Makefile
targets:
make info
- Info about servicemake enode
- Get enode addressmake start
- Start the servicemake stop
- Stop the servicemake status
- Check service statusmake enable
- Enable the servicemake disable
- Disable the servicemake logs
- Read the service logsmake clean
- Stop service and remove it
All the above commands are just wrappers around the systemctl
and journalctl
commands.
Settings
All settings are passed through environment variables:
SERVICE_NAME
- Name of thesystemd
service to be created. (Default:statusd
)LISTEN_PORT
- Bootnode TCP & UDP port, by default it's30301
but you might want to use443
.DATA_PATH
- Location of Bootnode storage and keys. (Default:/var/tmp/status-go-boot
)KEY_PATH
- Location of Bootnode private key file. (Default:/var/tmp/status-go-boot/nodekey
)LOG_LEVEL
- Set level of log messages to show. (Values:0-9
, Default:3
)`
System Service
By default this Makefile
configures the Bootnode as a systemd user service. This is done to simplify the proces and remove the need for sudo
. The disadvantage of this solution is that the service is stopped when the user logs out.
In order to make your service a system service use sudo make
.
Known Issues
No journal files were opened due to insufficient permissions.
fromsystemctl
- To see logs of a user systemd service you need to be a member of
systemd-journal
group. - Use:
bash usermod -a -G systemd-journal ${USER}
- To see logs of a user systemd service you need to be a member of