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/01 22:05] – [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 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 9: | 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. | 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. You only need to do this once: | + | To start using his repo, you need tell your machine to trust the repo: |
| < | < | ||
| Line 16: | Line 20: | ||
| </ | </ | ||
| - | Then you need to add a line to your ''/ | + | Then you need to add the repo for your OS: |
| - | + | ||
| - | Raspberry Pi OS stable (bullseye, 32 bit armv7/armhf AND arm64, released 2020): | + | |
| < | < | ||
| - | deb https:// | + | # Ubuntu 22.04 LTS amd64 |
| - | </code> | + | sudo sh -c 'echo "deb https:// |
| - | For Ubuntu 22.04 LTS (Jammy Jellyfish, amd64, released April 2022) amd64: | + | # Raspberry Pi OS 12 - ' |
| - | < | + | sudo sh -c 'echo "deb https:// |
| - | deb https:// | + | |
| - | </code> | + | |
| + | # Raspberry Pi OS 11 - ' | ||
| + | sudo sh -c 'echo "deb https:// | ||
| - | For Debian | + | # Debian 13 amd64 |
| + | sudo sh -c 'echo "deb https:// | ||
| - | < | + | # Debian 12 amd64 |
| - | deb https:// | + | sudo sh -c 'echo "deb https:// |
| </ | </ | ||
| - | For Debian Stable (12, released June 2023) amd64: | + | ===== Installation ===== |
| - | < | + | **Do this once, only.** |
| - | deb https:// | + | |
| - | </ | + | |
| - | + | ||
| - | You can add the line like this example, for Raspberry Pi: | + | |
| - | + | ||
| - | Raspberry Pi | + | |
| - | < | + | |
| - | sudo sh -c 'echo "deb https:// | + | |
| - | </ | + | |
| - | + | ||
| - | ===== Installation ===== | + | |
| 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 55: | Line 47: | ||
| < | < | ||
| sudo apt update | sudo apt update | ||
| - | sudo apt install | + | sudo apt install linbpq |
| </ | </ | ||
| Line 61: | Line 53: | ||
| ===== 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 | ||
| </ | </ | ||
| - | When you have updated the config, restart LinBPQ: | + | Whenever |
| < | < | ||
| Line 85: | Line 78: | ||
| 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) | ||
| - | ==== BPQ Chat ==== | ||
| - | |||
| - | If you get "No APPLCALL for Chat APPL" in the BPQ logs, and " | ||
| ===== Accessing the node ===== | ===== Accessing the node ===== | ||
| Line 103: | Line 93: | ||
| Username and password as per your config file. | Username and password as per your config file. | ||
| + | |||
| + | ===== Enabling BPQ Chat ===== | ||
| + | |||
| + | If you get "No APPLCALL for Chat APPL" in the BPQ logs, and " | ||
| ===== Updating ===== | ===== Updating ===== | ||
| Line 112: | Line 106: | ||
| 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 ===== | ||
| + | |||
| + | This document superseded [[packet: | ||
packet/linbpq-apt-installation.txt · Last modified: 2024/04/29 20:13 by 2e0itb