BPQ Configuration Updates, new terminal command language.

This commit is contained in:
Hibby 2024-07-16 23:37:32 +01:00
parent 777eb2c250
commit 44bb4e6665
No known key found for this signature in database
2 changed files with 35 additions and 12 deletions

View File

@ -8,26 +8,36 @@ If you have not already done so, set up the repo [as shown here](../repo.md).
To install LinBPQ from the repo, run the below commands: To install LinBPQ from the repo, run the below commands:
``` !!! note "Terminal Commands"
sudo apt update sudo apt update
sudo apt install linbpq sudo apt install linbpq
```
## Pre-Configure ## Pre-Configure
``` We need to prepare the system and get configuration files in place. This must be
run on the command line, it's simply the fastest way.
Copy these three lines, one-at-a-time into your terminal and hit enter after
each one.
!!!note "Terminal Commands"
sudo cp /usr/share/doc/linbpq/examples/bpq32.cfg /etc/bpq32.cfg sudo cp /usr/share/doc/linbpq/examples/bpq32.cfg /etc/bpq32.cfg
sudo nano /etc/bpq32.cfg
sudo chown :linbpq /etc/bpq32.cfg sudo chown :linbpq /etc/bpq32.cfg
sudo chmod 644 /etc/bpq32.cfg sudo chmod 644 /etc/bpq32.cfg
```
!!! note !!! tip
Without a config file installed to `/etc/bpq32.cfg`, BPQ from the repo will not start. If you are looking to use a config file in a different location, remove or modify `ConditionPathExists=/etc/bpq32.cfg` in `/usr/lib/systemd/system/linbpq.service` Without a config file installed to `/etc/bpq32.cfg`, BPQ from the repo will not start. If you are looking to use a config file in a different location, remove or modify `ConditionPathExists=/etc/bpq32.cfg` in `/usr/lib/systemd/system/linbpq.service`
## Configure ## Configure
The configuration file I ship in the repo, there are hopefully some obvious fields to fill out. Once all the below holes are filled, you should be able to log in either with [QtTermTCP](../clients/qtttcp.md) or in your web browser at [localhost:8008](http://127.0.0.1:8008)), assuming you're on the same computer as the node. The configuration file I ship in the repo, there are hopefully some obvious fields to fill out.
You can find the configuration file at `/etc/bpq32.cfg` and use something like
Featherpad to edit it. To learn more about editing text in Linux, see
[here](linux.md/#editing-text-as-root).
| Field | Example | Purpose | Field | Example | Purpose
| ----- | ------- | ------- | ----- | ------- | -------
@ -94,3 +104,16 @@ ENDPORT
``` ```
`USER` is the key configuration to change here - change `username` to your desired administrator username, `xxxxxxx` to the password and `m0aaa` to the callsign of the administrator. `USER` is the key configuration to change here - change `username` to your desired administrator username, `xxxxxxx` to the password and `m0aaa` to the callsign of the administrator.
## Startup
Head back to the terminal and run
!!! note "Terminal Command"
sudo systemctl start linbpq
This will tell the system you want to start the `linbpq` service. Navigate to
[http://127.0.0.1:8008](http://127.0.0.1:8008) if you are on the systme you've
performed the install on and you should see a webpage like below:
![bpq welcome page](../static/img/bpq_login.png))

BIN
docs/static/img/bpq_login.png vendored Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 123 KiB