Differences

This shows you the differences between two versions of the page.

--- packet:linbpq-apt-installation [2024/01/15 22:28] – [Configuration] m0lte
+++ packet:linbpq-apt-installation [2025/03/21 11:59] (current) – mm0rfn
@@ Line 4: / Line 4: @@
 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 =====
@@ Line 10: / Line 13: @@
 Our very own Hibby MM0RFN, also a Debian maintainer, has kindly packaged and is maintaining various Linux packet radio software, among them LinBPQ.
-To start using his repo, you need tell your machine to trust the repo:
+There are two ways of installing the repo: script or manually line.
-<code>
+==== Option 1: Script ====
-wget -q https://online-amateur-radio-club-m0ouk.github.io/oarc-packages/hibby.key
-sudo mv hibby.key /etc/apt/trusted.gpg.d/hibby.asc
-</code>
-Then you need to add the repo for your OS:
+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://guide.hibbian.org/static/files/setup.sh]]
+Lines you can run in the command line are:
 <code>
-# Ubuntu 22.04 LTS amd64
+cd /tmp
-sudo sh -c 'echo "deb https://online-amateur-radio-club-m0ouk.github.io/oarc-packages jammy main" >> /etc/apt/sources.list'
+wget https://guide.hibbian.org/static/files/setup.sh
+chmod +x /tmp/setup.sh
+sudo bash /tmp/setup.sh
+</code>
-# Raspberry Pi OS 12 - 'Bookworm'
+==== Option 2: Manually ====
-sudo sh -c 'echo "deb https://online-amateur-radio-club-m0ouk.github.io/oarc-packages bookworm main" >> /etc/apt/sources.list'
-# Raspberry Pi OS 11 - 'Bullseye'
+To manually install, you need to download the repo .deb for your OS and install it:
-sudo sh -c 'echo "deb https://online-amateur-radio-club-m0ouk.github.io/oarc-packages bullseye main" >> /etc/apt/sources.list'
-# Debian 13 amd64
+* Bullseye: <http://repo.hibbian.org/packetrepo/pool/main/h/hibbian-archive-keyring/hibbian-archive-keyring_20240924~packetrepo11+3_all.deb>\\
-sudo sh -c 'echo "deb https://online-amateur-radio-club-m0ouk.github.io/oarc-packages testing main" >> /etc/apt/sources.list'
+* Bookworm: <http://repo.hibbian.org/packetrepo/pool/main/h/hibbian-archive-keyring/hibbian-archive-keyring_20240924~packetrepo11+3_all.deb>\\
+* Trixie: <http://repo.hibbian.org/packetrepo/pool/main/h/hibbian-archive-keyring/hibbian-archive-keyring_20240924~packetrepo~TRIXIE+3_all.deb>\\
-# Debian 12 amd64
+it should be a case of, for example:
-sudo sh -c 'echo "deb https://online-amateur-radio-club-m0ouk.github.io/oarc-packages bookworm main" >> /etc/apt/sources.list'
+<code>
+wget http://repo.hibbian.org/packetrepo/pool/main/h/hibbian-archive-keyring/hibbian-archive-keyring_20240924~packetrepo~TRIXIE+3_all.deb
+sudo apt install ./hibbian-archive-keyring_20240924~packetrepo~TRIXIE+3_all.deb
 </code>
 ===== Installation =====
-**Do this once, only.**
 After following the above steps, to install LinBPQ, run the below commands:
@@ Line 48: / Line 58: @@
 LinBPQ runs as a background service and requires a config file - see the next sections for details.
 ===== Configuration =====
-A default config file will be placed at /etc/bpq32.cfg for editing.
+A default config file will be placed at ''/etc/bpq32.cfg'' before bpq will start.
-Simple config file suitable for a basic node with a single KISS modem, e.g. NinoTNC: https://gist.github.com/M0LTE/52824537b3fe21d19baf9a66eda4db86
+We ship a backup config file suitable for a basic node with a single KISS modem with the package in `/usr/share/doc/linbpq/examples/bpq32.cfg`, so don't worry about getting it wrong!
-<code>
+Whenever you have updated the [[https://www.cantab.net/users/john.wiseman/Documents/BPQCFGFile.html|config]], restart LinBPQ:
-wget -q https://gist.githubusercontent.com/M0LTE/52824537b3fe21d19baf9a66eda4db86/raw/fde7d76562bc26306543c4f7ea10ea55f509ac57/bpq32.cfg
-# edit as required, then:
-sudo mv bpq32.cfg /etc/bpq32.cfg
-</code>
-If you fully replace the config file, as opposed to editing the existing one, ensure it has the correct ownership after you do so:
-<code>
-sudo chown :linbpq /etc/bpq32.cfg
-sudo chmod 644 /etc/bpq32.cfg
-</code>
-Whenever you have updated the config, restart LinBPQ:
 <code>
@@ Line 109: / Line 107: @@
 sudo apt upgrade
 </code>
+===== 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, axipcache.cfg, BPQNODES.dat, DIRMES.SYS. If you're using the plain binary of bpq I think it just puts all that stuff beside it.
+  - install from apt, then ''sudo systemctl stop linbpq''
+  - copy bpq32.cfg from wherever it is - to where it needs to be ''sudo cp bpq32.cfg /etc/bpq32.cfg'' and update owner ''sudo chown root:linbpq /etc/bpq32.cfg''
+  - copy working files and folders from where they are to /opt/oarc/bpq/ - as an example, ''sudo cp -rf /home/pi/bpq/ /opt/oarc/bpq/'' and update owner - ''sudo chown -R linbpq:linbpq /opt/oarc/bpq/''
+  - start new install with ''sudo systemctl start linbpq'' and see if anything explodes
 ===== References =====
 This document superseded [[packet:linbpq_pc_installation]] and [[packet:linbpq_pi_installation]].