User Tools

Site Tools


packet-linbpq

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
Last revisionBoth sides next revision
packet-linbpq [2023/01/05 11:09] m0ukfpacket-linbpq [2023/03/26 21:10] – [Problems] ei5iyb
Line 1: Line 1:
-====== Installing LinBPQ ======+====== Installing LinBPQ on a Raspberry Pi ======
  
 +This is a document which describes the general case of installing and configuring LinBPQ on a Pi - this is probably not the instructions to establish a node specific to the OARC national packet project network.
  
 ===== Assumptions ===== ===== Assumptions =====
Line 14: Line 15:
 When you issue the following commands, a script will be download, that script create a folder called linbpq and download and install a pi version of linbpq. I personally run it from my home folder - so it is installed in /home/pi/linbpq When you issue the following commands, a script will be download, that script create a folder called linbpq and download and install a pi version of linbpq. I personally run it from my home folder - so it is installed in /home/pi/linbpq
  
- +<code> 
-wget http://www.cantab.net/users/john.wiseman/Downloads/installLinBPQ\\ +wget http://www.cantab.net/users/john.wiseman/Downloads/installLinBPQ 
-chmod +x installLinBPQ\\ +chmod +x installLinBPQ 
-./installLinBPQ\\ +./installLinBPQ 
 +</code> 
 +    
 Congratulations you now have linpbq! Congratulations you now have linpbq!
  
Line 35: Line 37:
  
  
-wget http://www.prinmath.com/ham/bpq-config \\ +   wget http://www.prinmath.com/ham/bpq-config 
-chmod a+x bpq-config\\ +   chmod a+x bpq-config 
-\\+
  
 To launch the tool type:\\ To launch the tool type:\\
  
-sudo ./bpq-config\\ +   sudo ./bpq-config 
-\\+
 The script will make appropriate changes to your pi, just select the default options: \\ The script will make appropriate changes to your pi, just select the default options: \\
  
Line 55: Line 57:
 5. Reboot\\ 5. Reboot\\
 {{:screenshot_2023-01-05_at_10.12.16.png?400|}}\\ {{:screenshot_2023-01-05_at_10.12.16.png?400|}}\\
-6. Once your pi has reset, reconnect to, nagivate to the linbpq folder and relaunch the configuration tool: sudo ./bpq-config\\+6. Once your pi has reset, reconnect to, nagivate to the linbpq folder and relaunch the configuration tool: <code>sudo ./bpq-config</code>
 7. Select Quick Install - this will create a basic configuration that you can then change\\ 7. Select Quick Install - this will create a basic configuration that you can then change\\
 {{::screenshot_2023-01-05_at_10.20.06.png?400|}}\\ {{::screenshot_2023-01-05_at_10.20.06.png?400|}}\\
Line 69: Line 71:
 11. You will then be sent to the main menu, if you run the config tool again in future you will be brought here. Select option 5 to enable bpq on boot. \\ 11. You will then be sent to the main menu, if you run the config tool again in future you will be brought here. Select option 5 to enable bpq on boot. \\
 {{::screenshot_2023-01-05_at_10.26.40.png?400|}}\\ {{::screenshot_2023-01-05_at_10.26.40.png?400|}}\\
-12. Click finish. Your bpq instance is setup! Why not visit the web interface! http://yourpiIP/8008+12. Click finish. Your bpq instance is setup! Why not visit the web interface! http://yourpiIP:8008
 ===== Connecting LinBPQ to your TNC ===== ===== Connecting LinBPQ to your TNC =====
 1. Find out which port your TNC is connected to:  1. Find out which port your TNC is connected to: 
Line 79: Line 81:
 2. Run the command **sudo nano bpq32.cfg** to open the configuration file\\ 2. Run the command **sudo nano bpq32.cfg** to open the configuration file\\
 3. Spend a few minutes looking over this file. The tool we used has added a load of comments telling you what everything does.\\ 3. Spend a few minutes looking over this file. The tool we used has added a load of comments telling you what everything does.\\
-4. Navigate to the section starts *******Port 1*******\\+4. Navigate to the section that starts *******Port 1*******\\
 5. Change the COMPORT and SPEED to the correct values - in the case of a NinoTNC you would change: 5. Change the COMPORT and SPEED to the correct values - in the case of a NinoTNC you would change:
 \\  \\ 
Line 92: Line 94:
 6. To save your changes - Press Ctrl + X to exit the text editor. The bottom of the screen will ask if you want to save changes. Press 'Y' then enter.\\ 6. To save your changes - Press Ctrl + X to exit the text editor. The bottom of the screen will ask if you want to save changes. Press 'Y' then enter.\\
 7. To load in changes restart linbpq with the following command: **sudo systemctl restart bpq.service**\\ 7. To load in changes restart linbpq with the following command: **sudo systemctl restart bpq.service**\\
-8. If you want to check if linbpq has started type**sudo systemctl status bpq.service** The first 3 lines of the output should look like this - If it says "active (running) on the third line, you are good to go!+8. If you want to check if linbpq has started type **sudo systemctl status bpq.service** The first 3 lines of the output should look like this - If it says "active (running) on the third line, you are good to go!
 \\ \\
      bpq.service - BPQ      bpq.service - BPQ
Line 100: Line 102:
  
 ===== What Next? Access your node ===== ===== What Next? Access your node =====
-Download a telnet client - Putty for Windows, "telnet" for pi/linux or TelNet Lite from the Mac OS App Shop\\ 
-Setup a connection to your pi, using port 8010\\ 
-You'll be prompted for your username and password [set above]\\ 
-Once connected you can type ? followed by enter to get commands\\ 
-Type BBS to access the BBS/Mailbox system\\ 
-Type ? for help\\  
-If you have a second tnc, if might be fun to send yourself a message. Use the command 'S callsign' and follow the prompts eg 's M0UKF' 
  
  
 +You can access your node via radio and over your home network [and potentially the internet] via a telnet client.
 +
 +It's better to use a dedicated telnet client but linbpq does provide a web based one. You can access it by clicking "Terminal" on your nodes webpage - located at http://piIPAddress:8080 - if you take this route skip steps 1 & 2\\
 +
 +
 +
 +  - Download a telnet client - Putty for Windows, "telnet" for pi/linux or TelNet Lite from the Mac OS App Shop\\
 +  - Setup a connection to your pi, enter your pi IP address as prompted and port 8010\\
 +  - Hit connect and you'll be prompted for your username and password [set above]\\
 +  - Once connected you can type ? followed by enter to get commands\\
 +  - Type BBS to access the BBS/Mailbox system\\
 +  - Type ? for help\\ 
 +  - If you have a second tnc, if might be fun to send yourself a message. Use the command 's callsign' and follow the prompts eg 's M0UKF'
 +
 +You can also access your node via G8BPQ's desktop application QtTermTCP. Enable an FBBPORT inside your Telnet port config, and set up a host in QtTermTCP, pointing at that port.
 +
 +===== Problems =====
 +
 +=== I installed and ran bpq.service but I get in my /var/log/syslog: ===
 +
 +<code>
 +/home/pi/linbpq/pilinbpq: error while loading shared libraries: libconfig.so.9: cannot open shared object file: No such file or directory
 +</code>
  
 +Run:
 +<code>
 +sudo apt install libconfig9
 +</code>
packet-linbpq.txt · Last modified: 2023/04/03 22:10 by m0lte