Differences

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

--- packet:linbpq-apt-installation [2023/10/01 22:08] – [Preparation] m0lte
+++ packet:linbpq-apt-installation [2024/04/29 20:13] (current) – link to the config docs 2e0itb
@@ Line 2: / Line 2: @@
 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 =====
@@ Line 16: / Line 20: @@
 </code>
-Then you need to add the repo:
+Then you need to add the repo for your OS:
 <code>
@@ Line 22: / Line 26: @@
 sudo sh -c 'echo "deb https://online-amateur-radio-club-m0ouk.github.io/oarc-packages jammy main" >> /etc/apt/sources.list'
-# Raspberry Pi
+# Raspberry Pi OS 12 - 'Bookworm'
+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'
 sudo sh -c 'echo "deb https://online-amateur-radio-club-m0ouk.github.io/oarc-packages bullseye main" >> /etc/apt/sources.list'
@@ Line 33: / Line 40: @@
 ===== Installation =====
+**Do this once, only.**
 After following the above steps, to install LinBPQ, run the below commands:
@@ Line 38: / Line 47: @@
 <code>
 sudo apt update
-sudo apt install -y linbpq
+sudo apt install linbpq
 </code>
@@ Line 44: / Line 53: @@
 ===== Configuration =====
-A default config file will be placed at /opt/oarc/bpq/bpq32.cfg and linked to /etc/bpq32.cfg for editing convenience. If you replace /etc/bpq32.cfg entirely, you will have broken the link, so if you plan to replace it, replace it at /opt/oarc/bpq/bpq32.cfg.
+A default config file will need to 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 simple config file suitable for a basic node with a single KISS modem with the package in `/usr/share/doc/linbpq/examples/bpq32.cfg`, taken from: https://gist.github.com/M0LTE/52824537b3fe21d19baf9a66eda4db86
 <code>
-wget -q https://gist.githubusercontent.com/M0LTE/52824537b3fe21d19baf9a66eda4db86/raw/fde7d76562bc26306543c4f7ea10ea55f509ac57/bpq32.cfg
+sudo cp /usr/share/doc/linbpq/examples/bpq32.cfg /etc/bpq32.cfg
 # edit as required, then:
-sudo mv bpq32.cfg /opt/oarc/bpq/bpq32.cfg
+sudo chown linbpq: /etc/bpq32.cfg
+sudo chmod 664 /etc/bpq32.cfg
 </code>
-When you have updated the config, restart LinBPQ:
+Whenever you have updated the [[https://www.cantab.net/users/john.wiseman/Documents/BPQCFGFile.html|config]], restart LinBPQ:
 <code>
@@ Line 68: / Line 78: @@
 Show its logs:
 <code>
-journalctl -u linbpq
+journalctl -ru linbpq
 </code>
 (use arrows / page up/down to navigate, press q to quit)
-==== BPQ Chat ====
-If you get "No APPLCALL for Chat APPL" in the BPQ logs, and "Sorry, Application CHAT is not running" when you issue CHAT at the node prompt, ensure that the ApplNum in /opt/oarc/bpq/chatconfig.cfg is set to the number of the APPLICATION in /opt/oarc/bpq/bpq32.cfg. You can also do this in Chat Mgmt in the BPQ web interface.
 ===== Accessing the node =====
@@ Line 86: / Line 93: @@
 Username and password as per your config file.
+===== Enabling BPQ Chat =====
+If you get "No APPLCALL for Chat APPL" in the BPQ logs, and "Sorry, Application CHAT is not running" when you issue CHAT at the node prompt, ensure that the ApplNum in /opt/oarc/bpq/chatconfig.cfg is set to the number of the APPLICATION in /opt/oarc/bpq/bpq32.cfg. You can also do this in Chat Mgmt in the BPQ web interface.
 ===== Updating =====
@@ Line 95: / Line 106: @@
 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]].