readme: Add usage section

xmrpm
Matt Smith 4 years ago
parent 3ca64f164d
commit 3994d18259
Signed by untrusted user: asymptotically
GPG Key ID: D0EAC8943FB1B2C1

@ -8,6 +8,70 @@ Part of a project funded by the Wownero community. Thank you :)
See the [WFS Proposal][] for more info.
## Usage
### Setup
1. Install ansible if you don't have it already.
You can do this in a virtualenv if you don't want to install it system-wide.
```bash
python -m venv virtualenv
pip install -r requirements.txt
```
2. Configure the inventory.
Modify `inventory.ini` with the connection details of your server.
3. Run the playbook.
```bash
ansible-playbook -i inventory.ini site.yaml
```
4. Enjoy your daemon!
### Further Configuration
The P2P and RPC listening ports can be configured with the variables
`wownerod_p2p_port` and `wownerod_rpc_port` respectively.
You can set them for a single host in your inventory like this:
```ini
daemon.example.com wownerod_p2p_port=12345 wownerod_rpc_port=12346
```
Or you can set them for all hosts:
```ini
[all]
daemon.example.com
daemon2.example.com
[all:vars]
wownerod_p2p_port=12345
wownerod_rpc_port=12346
```
### Upgrading `wownerod`
Edit `wownerod_remote_url`, `wownerod_remote_hash`, and
`wownero_version` in `roles/wownerod/defaults/main.yaml` to point to a
newer `wownerod` binary and re-run the playbook. It is recommended to
test the update on a single host first before deploying to the rest of
the pool.
Will be updated to use the official release binaries in the future,
but they currently do not support distros with an older version of
glibc (e.g. Debian Stable) so a binary built on Debian 10 is provided.
### HA Notice
The RPC server works great when behind HAProxy, nginx, or a DNS
solution like Constellix. However you'll need to extend the playbook
yourself for that.
## License
Released under the terms of the [Unlicense][].

Loading…
Cancel
Save