packet:linbpq-apt-installation
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
packet:linbpq-apt-installation [2023/10/02 10:17] – [Configuration] m0lte | packet:linbpq-apt-installation [2024/06/18 23:55] (current) – Adding the script mm0rfn | ||
---|---|---|---|
Line 2: | Line 2: | ||
This process is suitable for Debian-based operating systems, e.g. Debian, Raspberry Pi OS, Ubuntu. | This process is suitable for Debian-based operating systems, e.g. Debian, Raspberry Pi OS, Ubuntu. | ||
+ | |||
+ | This page and the package it refers to are NOT the first party documentation or packaging for LinBPQ. | ||
+ | |||
+ | **This process is only fully tested for a clean installation where BPQ has not been manually installed in the past using some other means. There are some high level instructions at the bottom of this page. If you aren't sure, stop and seek help.** | ||
===== Preparation ===== | ===== Preparation ===== | ||
Line 8: | Line 12: | ||
Our very own Hibby MM0RFN, also a Debian maintainer, has kindly packaged and is maintaining various Linux packet radio software, among them LinBPQ. | Our very own Hibby MM0RFN, also a Debian maintainer, has kindly packaged and is maintaining various Linux packet radio software, among them LinBPQ. | ||
+ | |||
+ | There are two ways of installing the repo: script or manually line. | ||
+ | |||
+ | ==== Script ==== | ||
+ | |||
+ | The script requires dowloaded, set to executable and run and is a little simpler than the manual setup - thanks to John M5ET for writing it! | ||
+ | |||
+ | I strongly recommend you read through it **before** running it - it should look similar to the manual method below. | ||
+ | **General computer security advice is to not blindly run scripts you downloaded from the internet!** | ||
+ | |||
+ | Download the script from: [[https:// | ||
+ | |||
+ | Lines you can run in the command line are: | ||
+ | |||
+ | < | ||
+ | cd /tmp | ||
+ | wget https:// | ||
+ | chmod +x / | ||
+ | sudo bash / | ||
+ | </ | ||
+ | |||
+ | ==== Manually ==== | ||
To start using his repo, you need tell your machine to trust the repo: | To start using his repo, you need tell your machine to trust the repo: | ||
Line 22: | Line 48: | ||
sudo sh -c 'echo "deb https:// | sudo sh -c 'echo "deb https:// | ||
- | # Raspberry Pi | + | # Ubuntu 24.04 LTS amd64 |
+ | sudo sh -c 'echo "deb https:// | ||
+ | |||
+ | # Raspberry Pi OS 12 - ' | ||
+ | sudo sh -c 'echo "deb https:// | ||
+ | |||
+ | # Raspberry Pi OS 11 - ' | ||
sudo sh -c 'echo "deb https:// | sudo sh -c 'echo "deb https:// | ||
Line 33: | Line 65: | ||
===== Installation ===== | ===== Installation ===== | ||
- | |||
- | **Do this once, only.** | ||
After following the above steps, to install LinBPQ, run the below commands: | After following the above steps, to install LinBPQ, run the below commands: | ||
Line 40: | Line 70: | ||
< | < | ||
sudo apt update | sudo apt update | ||
- | sudo apt install | + | sudo apt install linbpq |
</ | </ | ||
LinBPQ runs as a background service and requires a config file - see the next sections for details. | LinBPQ runs as a background service and requires a config file - see the next sections for details. | ||
+ | |||
===== Configuration ===== | ===== Configuration ===== | ||
- | A default config file will be placed at / | + | A default config file will need to be placed at '' |
- | Simple | + | We ship a simple |
< | < | ||
- | wget -q https://gist.githubusercontent.com/M0LTE/52824537b3fe21d19baf9a66eda4db86/raw/fde7d76562bc26306543c4f7ea10ea55f509ac57/bpq32.cfg | + | sudo cp /usr/share/doc/linbpq/examples/ |
# edit as required, then: | # edit as required, then: | ||
- | sudo mv bpq32.cfg /opt/ | + | sudo chown linbpq: /etc/bpq32.cfg |
+ | sudo chmod 664 /etc/bpq32.cfg | ||
</ | </ | ||
- | If you fully replace | + | Whenever |
- | + | ||
- | < | + | |
- | chown linbpq: | + | |
- | </code> | + | |
- | + | ||
- | Whenever you have updated the config, restart LinBPQ: | + | |
< | < | ||
Line 76: | Line 102: | ||
Show its logs: | Show its logs: | ||
< | < | ||
- | journalctl -u linbpq | + | journalctl -ru linbpq |
</ | </ | ||
(use arrows / page up/down to navigate, press q to quit) | (use arrows / page up/down to navigate, press q to quit) | ||
Line 104: | Line 130: | ||
sudo apt upgrade | sudo apt upgrade | ||
</ | </ | ||
+ | |||
+ | ===== Migrating from a manual install to the apt repo ===== | ||
+ | |||
+ | - stop existing bpq running | ||
+ | - back everything up! | ||
+ | - make note of locations of files - we're particularly interested in bpq32.cfg and the working files. This will be the directory holding chatconfig.cfg, | ||
+ | - install from apt, then '' | ||
+ | - copy bpq32.cfg from wherever it is - to where it needs to be '' | ||
+ | - copy working files and folders from where they are to / | ||
+ | - start new install with '' | ||
===== References ===== | ===== References ===== | ||
This document superseded [[packet: | This document superseded [[packet: |
packet/linbpq-apt-installation.1696241821.txt.gz · Last modified: 2023/10/02 10:17 by m0lte