add docs how to create a systemd unit for babelweb2

Signed-off-by: Marek Küthe <m.k@mk16.de>
This commit is contained in:
Marek Küthe 2023-01-08 16:23:37 +01:00
parent 08de6a67bb
commit 12b2485b7a
No known key found for this signature in database
GPG Key ID: 7E869146699108C7
1 changed files with 41 additions and 0 deletions

View File

@ -21,3 +21,44 @@ Now you have an executable program `babelweb2`.
By default, the web interface runs on port 8080. You can also specify a different endpoint with the `-http` parameter. By default, the web interface runs on port 8080. You can also specify a different endpoint with the `-http` parameter.
babelweb2 uses the local configuration interface of babeld. This must have been activated beforehand. babeld assumes that this is active on `[::1]:33123`. Alternatively, you can specify the endpoint with the `-node=` flag. babelweb2 uses the local configuration interface of babeld. This must have been activated beforehand. babeld assumes that this is active on `[::1]:33123`. Alternatively, you can specify the endpoint with the `-node=` flag.
## Install as Systemd Unit
In order to install babelweb2 as a systemd unit, we must first install the necessary files into the system. For this we can execute the following commands in the babelweb2 git directory:
```
sudo cp babelweb2 /usr/local/bin
sudo mkdir -p /usr/share/babelweb2/
sudo cp -r ./static/ /usr/share/babelweb2/
```
After that we create the unit file `/etc/systemd/system/babelweb2.service`:
```
[Unit]
Description=Yet Another Monitoring Tool for the Babel routing daemon
Documentation=https://github.com/Vivena/babelweb2
[Service]
LimitNOFILE=1048576
LimitNPROC=512
User=nobody
EnvironmentFile=/etc/default/babelweb2
ExecStart=/usr/local/bin/babelweb2 -http $PORT -static $STATIC_DIR
ExecReload=/bin/kill -SIGUSR1 $MAINPID
Restart=on-failure
[Install]
WantedBy=multi-user.target
```
After that you can reload the units:
```
systemctl daemon-reload
```
For babelweb2 to work, we still need to specify the arguments. For this we can create an environment file `/etc/default/babelweb2`:
```
PORT=:<port>
STATIC_DIR=/usr/share/babelweb2/static/
```
Here we replace `<port>` with the port on which the Babelweb2 interface should be available. The default is 8080, but you can also use 33124, for example.