This is an old revision of the document!
Table of Contents
BPQ for Beginners
Configuring your node for mail
First steps
First you will need to edit your Config File either on the UI or within a terminal to enable LinMail, add a mail user name and password and allocate an application, shown in red text below:
- Enable LinMail by inserting ‘LINMAIL’ either before the first port, or after the last port but before 'APPLICATIONS'
- Add the BBS ‘APPLICATION’. This takes the form;
- APPLICATION n,CMD,New Command,Call,Alias,Quality,L2Alias
- Add a BBS username and password
- <example required>
Once done, save your edit and restart BPQ
<sudo systemctl restart bpq>
You should now see an extended top menu on the main page. Including links for ‘MailMgmt’ and ‘WebMail’
Mail Management
Status
Main configuration
Many boxes to complete and lots of checks to get right. Let's try to take these one at a time.
- BBS Call: Your node callsign
- SYSOP Call: Your callsign.
- H Route: Your node's 'address'; the # indicates the county, followed by country and continent codes a.. separated by a dot.
- Redirect msgs to BBS Call to SYSOP Call: Self explanatory (I think)
- BBS APPL No: The SSID of your BBS; by convention usually 1
- Streams: Maximum number of simultaneous contacts. 32 is good enough
Now the check boxes
Mostly self explnanatory but beware of the double negatives
Ignore the rest until you get to **WP Params**
WP Destinations is where you would list stations you wish to receive any WP Updates generated by your node Housekeeping (more of which later)
Message Filters
TBH - not really sure of these. We need an edit…
Initial description which can be fully completed at a later date
Users
Example of a node and a BBS - descriptions as required
Messages
Screensnip & description
Forwarding
The complex bit - lots of work here
Templates
There are several scenarios that could be true. Pick the one that best matches your install right now and it should tell you how to set up forwarding rules.
Lonely BBS
You are the only BBS you can see. There may be other packet stations around but you are in a little network island of your own.
Set yourself up as a user in mail and configure the account as a BBS. Everyone else will create and read mail on your node. It won't go anywhere so no forwarding rules are required.
This scenario is missing from the table below because no mail is forwarded.
One other BBS
Most likely if you have just set up. You can see one BBS that's already running and doing network magic, you just want in. This is also the case if there are several BBSs but you only care about one Big BBS that can do all the collation and distribution.
Create a user for that BBS. Set them up as a BBS in their settings. In the forwarding table set “WW” as the only rule for floods and personals.
They do the same for you and all mail specifically for you is delivered via an implicit AT match.
Just your region
Several people have set up in your region. There may be a gateway to the wider network, but that's not you.
Create a user for every BBS you can see directly. Set them up as a BBS in their settings.
Set WW as the only rule for floods for all your neighbour BBSs. Mail to any one of them specifically will be picked up as an implicit AT rule for that BBS and go there directly.
If there is a hidden BBS you can't see but you know exists, add the full HA for that BBS to the personals rules for next best BBS you can see. This means knowing the BBSs in your area and how best to reach them.
If there is a gateway node, set them up with a WW rule in personals. Anything not explicitly or implicitly handled above means it goes to the wider world. If you can't see the gateway, add the WW rule to the next-best BBS you can see.
Gateway to the world
You're region is self contained except for one node that can see out of your region and that node is you.
The node outside your region gets WW in floods and personal.
The nodes inside your region get set up with your region address [e.g. #77.gbr.euro] in floods. Personals are handled by implicit or explicit rules as in the section above.
Your region gets through traffic
Your region has two or more links to other regions and they are managed by different nodes.
Set yourself up as the next best scenario above. Then add the other known regions to the next-best node you can see. This can be tricky because it might be the next city over or it might be the next continent over. This is expert level stuff and may be expanded on later.
Templates and scenarios
One other BBS | Just your region | Gateway to the world | Through Traffic | |
A personal is sent to you | The Big BBS delivers it to you | One of your neighbours passes it to you | One of your neighbours passes it to you | One of your neighbours passes it to you. |
You send a personal mail within your region | It goes to the only other BBS you know about. WW matches every HA rule | If you can see the BBS, an implicit AT rule will forward it that way. If you can't see it, then explicit HA rules will forward it to the next-best BBS you can see | You pass it into your region because those implicit or explicit rules match more specifically than the WW rule for outside the region | Forwarded by implicit or explicit rules |
You send a mail outside your region | The Big BBS handles it | You pass it to the gateway node or the next-best in that direction | You pass it to the BBS outside your region because the regional rules don't match so you are left with the catch-all WW rule | |
A personal arrives for your region but not for you | N/A. Something went wrong | Your implicit AT or explicit personals rules should route it correctly | Your implicit AT or explicit personals rules should route it correctly | TBD |
A flood arrives for your region | Accept and enjoy. It won't go back out from you because the only path is the one it arrived on | You will try to forward it to every node you can see. BID rules will prevent nodes from accepting mail they already have | Same as just your region except you won't pass it out of the region because the explicit regional personal rules match better than the WW rule for the out-of-region node | TBD |
A WW flood arrives | Same as regional flood | Same as regional flood | Same are regional flood but this time it will go out of the region if needed | TBD |
Welcome Messages & Prompts
Mostly self explanatory