config_echomail_nodes
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
config_echomail_nodes [2016/06/05 23:22] – edits avon | config_echomail_nodes [2023/01/03 01:49] (current) – [Page 4 of 6 - BinkP] upload/download limits added avon | ||
---|---|---|---|
Line 4: | Line 4: | ||
This section of the Mystic BBS Configuration System allows you to add/remove Echomail nodes and configure how they are set up. | This section of the Mystic BBS Configuration System allows you to add/remove Echomail nodes and configure how they are set up. | ||
+ | |||
+ | ===== EchoMail Node Settings ===== | ||
From the opening screen you can see EchoMail Node that have already been created. | From the opening screen you can see EchoMail Node that have already been created. | ||
- | | + | ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ |
- | | + | |
- | | + | ─────────────────────────────────────────────────────────────────────────── |
- | | + | |
- | | + | |
- | | + | |
- | Press / for command list | + | |
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | | ||
+ | ─────────────────────────────────────────────────────────────────────────── | ||
+ | Press / for command list | ||
+ | | ||
The / key reveals a command list menu. | The / key reveals a command list menu. | ||
- | | + | I Insert |
- | C Copy | + | |
- | D Delete | + | |
- | E Exports | + | |
+ | F FileBone Exports | ||
+ | R Reset Stats | ||
+ | 1 Send AreaFix | ||
+ | 2 Send FileFix | ||
+ | 3 Netmail SysOp | ||
+ | | ||
- | This menu allows you to add or remove EchoMail Nodes from the system. You can also copy an existing EchoMail Node and paste (or move) the copied nodes to elsewhere on the list. The ' | + | This menu allows you to add or remove EchoMail Nodes from the system. |
- | Pressing the Enter key on an existing EchoMail Node (or a new EchoMail node) reveals | + | You can copy an existing EchoMail Node and paste (or move) the copied nodes to elsewhere on the list. |
- | In this example an EchoMail Node has been set up for the fsxNet HUB (21:1/100) to send/ | + | |
- | ==== EchoMail Node Settings ==== | + | The ' |
- | Description │ fsxNet HUB Zone │ 21 | + | The ' |
- | | + | |
- | | + | |
- | Export Type │ Crash Point │ 0 | + | |
- | AllFix PW │ ******* | + | |
- | PKT Password │ | + | |
- | | + | |
- | Route Info │ 21:* | + | |
- | Max PKT Size │ 512 | + | |
- | Max ARC Size │ 2048 | + | |
- | Use FileBox │ No | + | |
- | FileBox │ | + | |
- | TIC Password │ ******* | + | |
- | There are a number options | + | The 'Reset Stats' option lets you reset the Echomail Node stats that Mystic tracks when traffic is sent to / received from the node. |
- | == Description == | + | The next three options allow you to quickly and easily contact an EchoMail node to communicate with the SysOp or to add/remove message and file bases or anything else the Area/ |
- | Define | + | * 'Send Areafix' |
+ | * 'Send Filefix' | ||
+ | * ' | ||
- | == Active == | + | If you want these options to work correctly for you it pays to set up the next section with the correct information and ensure you complete all the fields you need to. |
- | A simple yes/now setting - unless you set this to ' | + | Pressing the Enter key on an existing EchoMail Node (or a new EchoMail node) reveals the following screen. |
+ | In this example an EchoMail Node has been set up for the fsxNet HUB (21: | ||
- | == Archive Type == | + | ==== Page 1 of 6 - General ==== |
- | Leave this blank if you wish to send raw uncompressed message packets | + | ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Node ID 1 (21: |
+ | | ||
+ | | ||
+ | SysOp Name │ Paul Hayton | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | Route Info │ 21:* | ||
+ | | ||
+ | Max PKT Size │ 512 | ||
+ | Max ARC Size │ 2048 | ||
+ | Use Filebox | ||
+ | | ||
+ | Crash Limiter | ||
+ | │ Page 1 of 6 | ||
+ | | ||
- | == Export Type == | + | There are a number options you can set on page 1. |
- | There are several options you can set here. These determine how Mystic will treat the messages it is creating to send to this EchoMail Node. Should it send them as soon as it can, wait for the EchoMail Node to poll your system to collect Echomail and/or Netmail etc. | + | === Active === |
- | The options | + | A simple yes/now setting - unless you set this to ' |
- | * Crash - High priority. Send messages to echonode ASAP next outbound / inbound connection occurs | + | === Description === |
- | * Direct - Messages can only be sent direct to this echonode and not routed elsewhere | + | |
- | * Hold - Hold all messages for echonode to collect when they next poll your Mystic BBS | + | |
- | * Normal - Regular priority traffic | + | |
- | == AllFix PW == | + | Define the name of the system you are connecting with. |
- | This is the password you would set if the EchoMail Node system you are setting up, was to send your Mystic BBS a Allfix or Filefix netmail. Mystic would check the password sent in the netmail addressed to it from this system matched the password set here before acting on the inbound netmail request. | + | === SysOp Name === |
- | == PKT Password == | + | Define the name of the system operator running this system. You can set an alias s/he uses or their real name. |
- | This is an optional password you can set so that messages sent to/from this EchoMail Node contain an additional layer of security when transferring them between your Mystic system and this EchoMail Node. | + | === Address === |
- | If set, MUTIL will not toss (import) messages in to your Mystic BBS that do not have a matching password contained in the message packets it has received from this system. Likewise any messages you send to this EchoMail Node will also be sent with this password added to every message packet. | + | Set the Network Zone, Net, Node and Point (not often used) of this EchoMail Node. e.g. 21:1/100 |
- | Set if you need to, but otherwise leave blank. It's usually enough to just set a session password in your ' | + | === Domain === |
- | == Session Type == | + | Set the Domain Name of Network. It's best to keep it lowercase and check you spell it correctly. e.g. fsxnet |
+ | |||
+ | === Session Type === | ||
There are three options to choose from: | There are three options to choose from: | ||
* Binkp - Fidpoll will send/ | * Binkp - Fidpoll will send/ | ||
- | * FTP - Fidopoll | + | * FTP - MIS POLL will send/ |
- | * Directory - Fidopoll | + | * Directory - MIS POLL will send bundles to/from locally configured inbound and outbound directories instead of using BINKP or FTP. |
- | Depending on the option you choose here, the ' | + | Depending on the option you choose here, pages 4, 5, or 6 of the configuration |
+ | |||
+ | === Archive Type === | ||
+ | |||
+ | Leave this blank if you wish to send raw uncompressed message packets (.PKT) files. Otherwise | ||
+ | |||
+ | === Export Type === | ||
+ | |||
+ | There are several options you can set here. These determine how Mystic | ||
+ | |||
+ | The options are: | ||
+ | |||
+ | * Crash - High priority. Send messages to echonode ASAP next outbound / inbound connection occurs | ||
+ | * Direct - Messages can only be sent direct to this echonode and not routed elsewhere | ||
+ | * Hold - Hold all messages for echonode to collect when they next poll your Mystic BBS | ||
+ | * Normal - Regular priority traffic | ||
- | == Route Info == | + | === Route Info === |
Routing info is defined in the format of addresses separated by spaces and uses an asterisk (*) as a wildcard. | Routing info is defined in the format of addresses separated by spaces and uses an asterisk (*) as a wildcard. | ||
Line 118: | Line 157: | ||
NetMail message bases do not need to be linked to any Echomail nodes in order for Mystic to attempt exporting. | NetMail message bases do not need to be linked to any Echomail nodes in order for Mystic to attempt exporting. | ||
- | Mystic, when routing | + | === Netmail |
- | the Route Info. | + | |
- | If there is no direct match, Mystic | + | Netmail |
- | == Max PKT Size == | + | If no route is found from the Route string then Mystic will now attempt to automatically route Netmail based on some basic address logic: |
+ | |||
+ | * First it will look for a direct address match in Echomail Nodes and if one is found it will route directly to the node. | ||
+ | |||
+ | * If there is no direct match then Mystic will perform some logic to select the best node that it can find. If your system gets a Netmail for 1:123/123.1 and there is no direct match, Mystic will look for a 1:123/123 node. If there isn't one, then it will look for a 1:123 node with priority given to the 1:123/1 if exists. | ||
+ | |||
+ | * If a node is still not found then Mystic will look for a zone match, and finally if no zone match is found then the Netmail will fail to route. | ||
+ | |||
+ | To further expand on the automatic Netmail routing logic, Mystic will now perform a FidoNet fuzzy zone match when auto routing Netmail. | ||
+ | |||
+ | To reiterate: For almost everyone, there is never a need touch the Route field in your Echomail node editor. | ||
+ | |||
+ | This system allows for Netmail to work automatically without any knowledge of routing being required for most people while still allowing full control for power users. | ||
+ | |||
+ | === Uplink === | ||
+ | |||
+ | This flag can either be set to Yes or No for each Echomail Node. It works in tandem with MIS POLL UPLINK and is similar to the MIS POLL FORCED command, but instead will only force a poll of Echomail Nodes with the Uplink flag set to Yes. | ||
+ | |||
+ | === Max PKT Size === | ||
Define the maximum file size (KB) of each packet Mystic creates. Set this to 0 is you do not want to set any limit. | Define the maximum file size (KB) of each packet Mystic creates. Set this to 0 is you do not want to set any limit. | ||
- | == Max ARC Size == | + | === Max ARC Size === |
Define the maximum bundle/ | Define the maximum bundle/ | ||
- | == Use Filebox == | + | === Use Filebox |
- | A Filebox is a directory you can place any file in to that will be sent to your EchoMail Node when you next poll it using Fidopoll | + | A Filebox is a directory you can place any file in to that will be sent to your EchoMail Node when you next poll it using MIS POLL or it polls your Mystic BBS. |
There are three options for this setting | There are three options for this setting | ||
* No - Don't enable this feature | * No - Don't enable this feature | ||
- | * Any - Send files to EchoMail Node if you Fidopoll | + | * Yes- Send files to EchoMail Node if you MIS POLL it or if it polls your Mystic BBS |
* Hold - Only send files to the EchoMail Node if it polls your Mystic BBS | * Hold - Only send files to the EchoMail Node if it polls your Mystic BBS | ||
+ | // | ||
+ | Note: When you first select Yes as an option Mystic will prompt you if you wish to generate a default filebox. | ||
+ | Do not do this until after entering your Zone, Net, Node, Point and Domain details first.// | ||
- | == Filebox == | + | If you say YES to this question Mystic pops up with a dialogue box similar to this: |
+ | |||
+ | █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Info ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄ | ||
+ | █ █ | ||
+ | █ Create: c: | ||
+ | █ █ | ||
+ | █ YES NO █ | ||
+ | ▀▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█ | ||
+ | |||
+ | You can override this suggestion by answering NO and filling out our preferred file path in the next input field below. Or answer YES to have Mystic auto create the directory for you. | ||
+ | |||
+ | Be sure to check the Filebox status is set to what you want it to be once doing this. | ||
+ | |||
+ | === Filebox | ||
Defines the drive and directory pathway that is associated with the Filebox to be used with this EchoMail Node. If the directory does not exist then Mystic will offer to create it. | Defines the drive and directory pathway that is associated with the Filebox to be used with this EchoMail Node. If the directory does not exist then Mystic will offer to create it. | ||
- | == TIC Password == | + | === Crash Limiter === |
+ | |||
+ | This feature is still being developed. The idea is that when MIS POLL sends files via BINKP it will skip queueing any files for sending larger than this value. It forces EchoMail nodes to poll and collect these files vs a HUB system spending time transferring large files to them. The value is defined in kilobytes. | ||
+ | |||
+ | At present there is no logic built in to this feature. That means if you set say a value of 1000 Mystic will send .TIC files that accompany a hatched file to an EchoMail node but if the actual hatched file is larger than 1000kb it will not send at the same time. This can cause issues for the receiving EchoMail node. | ||
+ | |||
+ | Keep an eye on this section of the Wiki and we'll update it as the feature evolves ;-) | ||
+ | |||
+ | ==== Page 2 of 6 - Security ==== | ||
+ | |||
+ | ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Node ID 1 (21: | ||
+ | | ||
+ | FIX Password | ||
+ | TIC Password | ||
+ | | ||
+ | | ||
+ | | ||
+ | │ | ||
+ | │ | ||
+ | │ | ||
+ | │ | ||
+ | │ | ||
+ | │ | ||
+ | │ | ||
+ | │ | ||
+ | │ Page 2 of 6 | ||
+ | |||
+ | |||
+ | |||
+ | === PKT Password === | ||
+ | |||
+ | This is an optional password you can set so that messages sent to/from this EchoMail Node contain an additional layer of security when transferring them between your Mystic system and this EchoMail Node. | ||
+ | |||
+ | If set, MUTIL will not toss (import) messages in to your Mystic BBS that do not have a matching password contained in the message packets it has received from this system. Likewise any messages you send to this EchoMail Node will also be sent with this password added to every message packet. | ||
+ | |||
+ | Set if you need to, but otherwise leave blank. It's usually enough to just set a session password in your ' | ||
+ | |||
+ | === FIX Password === | ||
+ | |||
+ | This is the password you would set if the EchoMail Node system you are setting up, was to send your Mystic BBS a Allfix or Filefix netmail. Mystic would check the password sent in the netmail addressed to it from this system matched the password set here before acting on the inbound netmail request. | ||
+ | |||
+ | === TIC Password === | ||
This is the password that your Mystic BBS will use to check against .TIC files that are sent to it from this EchoMail Node. | This is the password that your Mystic BBS will use to check against .TIC files that are sent to it from this EchoMail Node. | ||
Line 153: | Line 266: | ||
Without this password set your Mystic BBS will ignore the files it receives and/or move them in to the BAD directory defined in the [FileToss] stanza of your MUTIL .ini file | Without this password set your Mystic BBS will ignore the files it receives and/or move them in to the BAD directory defined in the [FileToss] stanza of your MUTIL .ini file | ||
- | == Zone == | + | === Encryption Key === |
- | Set the Network Zone of this EchoMail Node. | + | Echomail nodes now have an " |
- | == Net == | + | This is done in a way that is completely transparent to unsupporting systems, meaning that you can still route netmail through systems and they will not harm the encrypted netmails! |
- | Set the Network Net of this EchoMail Node | + | The other echomail node must of course have the same key configured for your node in order to decrypt the netmail when it arrives. |
- | == Node == | + | When routing Netmail, Mystic will intelligently re-encrypt the message between routing points when possible. |
- | Set the Network Node of this EchoMail Node | + | === Security Level === |
- | == Point == | + | You can set ACS rules for this EchoMail node. Refer to discussion info in the Echomail Node Security section below. |
- | Set the Network Point of this EchoMail Node (often not used) | + | === Access Flags === |
- | == Domain == | + | You can set access flags for this EchoMail Node. Refer to discussion info in the Echomail Node Security section below. |
- | Set the Domain Name of Network e.g. fsxnet | + | === Echomail Node Security ==== |
- | ==== Session Options ==== | + | Echomail node security is here! The easiest way to think about how this system works is to relate an Echomail node to the way security works for a user in your BBS. Each node will have a security |
- | These options change depending on the 'Session Type' set earlier. | + | Different functions throughout |
- | === BinkP === | + | Hatch File EACS: g2|s255|fH|u10 |
+ | The above would say that any echomail node that is a member of Echomail group 2, OR any node that has a security level of 255 OR any Echomail node that has flag H can hatch files to that file base. The Echomail node with the ID of #10 can also hatch. | ||
- | | + | The following commands are available within EACS: |
- | + | ||
- | Host │ ipv4.agency.bbs.geek:24556 | + | s< |
- | Password | + | equal to < |
- | | + | g< |
- | | + | to < |
- | CRAM-MD5 | + | f< |
- | Hide AKAs │ Yes | + | |
- | + | u< | |
- | | + | |
+ | shown in echomail node editor). | ||
+ | |||
+ | Just like user ACS, Echomail ACS can also use parenthesis and boolean evaulation. | ||
+ | |||
+ | Echomail ACS has been activated for message base subscribing/ | ||
+ | |||
+ | Hubs can still manually link a base to a node regardless of security, so for example if you wanted to force nodes to always carry a specific echo area, you would give them the base and then set the "List EACS" to an access they do not have (or even use % which is " | ||
+ | |||
+ | This is a very powerful system for managing an Echomail network, and EACS strings will be added to various functions in the future as seen fit. | ||
+ | |||
+ | ==== Page 3 of 6 - Groups ==== | ||
+ | |||
+ | Echo Group 01 │ fsxNet | ||
+ | Echo Group 02 | ||
+ | Echo Group 03 | ||
+ | Echo Group 04 | ||
+ | Echo Group 05 | ||
+ | Echo Group 06 | ||
+ | Echo Group 07 │ None | ||
+ | Echo Group 08 │ None | ||
+ | Echo Group 09 │ None | ||
+ | Echo Group 10 │ None | ||
+ | Echo Group 11 │ None | ||
+ | Echo Group 12 │ None | ||
+ | Echo Group 13 │ None | ||
+ | Echo Group 14 │ None | ||
+ | Echo Group 15 │ None Page 3 of 6 | ||
| | ||
- | A Binkp session has the following options you should set: | + | Define which EchoMail groups this EchoMail node is a member of. |
- | == Host == | + | ==== Page 4 of 6 - BinkP==== |
- | == Password | + | BINKP Hostname │ net1.fsxnet.nz |
+ | IP Type │ IPV4 2: | ||
+ | | ||
+ | Password | ||
+ | Time Out │ 30 5:FTP | ||
+ | Block Size │ 16384 6:Dir Toss | ||
+ | | ||
+ | Hide AKAs │ Yes | ||
+ | | ||
+ | | ||
+ | | ||
+ | │ | ||
+ | │ | ||
+ | │ | ||
+ | │ Page 4 of 6 | ||
+ | |||
+ | A Binkp section has the following options you should look at and in most cases set up: | ||
- | == Timeout | + | === BINKP Hostname === |
- | == BlockSize == | + | Set the DNS hostname (and port if required) for the EchoMail Node you will poll using MIS POLL. |
- | == CRAM-MD5 | + | === IP Type === |
- | == Hide AKAs == | + | Do you wish to use IPV4 or IPV6 when using MIS POLL to connect to this system? Or do you wish to set a preferred connection type and then a fallback type? e.g. IPV6 + IPV4 or IPV4 + IPV6 |
- | === FTP === | + | === Server Type === |
+ | |||
+ | There are four possible options for this setting: | ||
+ | |||
+ | * Normal | ||
+ | * Direct SSL : Connect with a direct SSL connection | ||
+ | * StartTLS (If Available) : Use TLS when available | ||
+ | * StartTLS (Required) | ||
+ | |||
+ | The StartTLS Required option will refuse to authenticate with any server that does not offer the opportunistic TLS upgrading. These features require that CryptLib is present and detected by Mystic. | ||
+ | |||
+ | === Password === | ||
+ | |||
+ | Set the session password your Mystic BBS will send to this EchoMail Node when you poll it using MIS POLL or it connects to your Mystic BinkP server and attempts to send your system Echomail, Netmail and/or other files. | ||
+ | |||
+ | This password is case sensitive. Be warned some non-Mystic systems have issues with this. Best advice keep everything UPPERCASE and limited to no more than 8 characters to avoid hassles. | ||
+ | |||
+ | === Timeout === | ||
+ | |||
+ | Inactivity timeout time in seconds before a BinkP session is halted. Leave as default unless you know what you are doing. | ||
+ | |||
+ | === BlockSize === | ||
+ | |||
+ | Data blocksize in bytes. Leave as default unless you know what you are doing. | ||
+ | |||
+ | === CRAM-MD5 === | ||
+ | |||
+ | Use MD5 hashing when connecting as a client? This hides session passwords so they are not sent in plain text. It's a good idea to use this. | ||
+ | |||
+ | === Hide AKAs === | ||
+ | |||
+ | Hide alternative network addresses during a BinkP handshake. When your system polls this EchoMail Node will it only show the network address you have set up for the same Zone this EchoMail Node has in common with or it will show all your defined EchoMail addresses? | ||
+ | |||
+ | === Escape Mode === | ||
+ | |||
+ | Mystic' | ||
+ | |||
+ | This setting determines how Mystic will escape special characters in filenames and defaults to the Auto setting. | ||
+ | |||
+ | When set to **Auto**, Mystic will automatically try to determine the escape mode by using the VERSION frame sent by the mailer. | ||
+ | |||
+ | When set to **Legacy**, Mystic will use the \## format of file escaping which is used in some legacy mailers such as Argus, Internet Rex, and older versions of Mystic. | ||
+ | |||
+ | When set to **Modern**, Mystic will use the \x## format which is preferred or even required by some newer mailers such as BinkD, Radius, and BinkIT. | ||
+ | |||
+ | It is highly recommended to always keep these set to AUTO unless there is a very specific reason not to. The escape mode will be logged after authentication if the loglevel is set to Verbose or higher. | ||
+ | |||
+ | === Upload Limit === | ||
+ | |||
+ | Set the upload speed limit: (Used when you send files to this node) | ||
+ | |||
+ | BINKP has the ability to limit the bandwidth used when sending or receiving files. | ||
+ | |||
+ | === Download Limit === | ||
+ | |||
+ | Set the download speed limit: (Used when you receive files from this node). This setting overrides MIS POLL/BINKP settings if enabled. | ||
+ | |||
+ | ==== Page 5 of 6 - FTP ==== | ||
+ | |||
+ | FTP Hostname | ||
+ | | ||
+ | | ||
+ | | ||
+ | Out Directory | ||
+ | In Directory | ||
+ | │ | ||
+ | │ | ||
+ | │ | ||
+ | │ | ||
+ | │ | ||
+ | │ | ||
+ | │ | ||
+ | │ | ||
+ | │ Page 5 of 6 | ||
+ | |||
A FTP session has the following options you should set: | A FTP session has the following options you should set: | ||
- | Placeholder text | + | === FTP Hostname === |
- | === Directory === | + | Set the DNS hostname (and port if required) for the EchoMail Node you will poll using Fidopoll. |
+ | |||
+ | === Login === | ||
+ | |||
+ | Set the username to pass to the FTP server when connecting to it. | ||
+ | |||
+ | === Password === | ||
+ | |||
+ | Set the password to pass to the FTP server when connecting to it | ||
+ | |||
+ | === Passive === | ||
+ | |||
+ | Is this to be an active or passive FTP session? | ||
+ | |||
+ | === Out Directory === | ||
+ | |||
+ | Set the directory you wish Mystic to send message packets / files from. | ||
+ | |||
+ | === In Directory === | ||
+ | |||
+ | Set the directory you wish Mystic to look for incoming message packets / files it receives. | ||
+ | |||
+ | ==== Page 6 of 6 - Dir Toss ==== | ||
+ | |||
+ | | ||
+ | | ||
+ | │ | ||
+ | │ | ||
+ | │ | ||
+ | │ 6:DIR TOSS | ||
+ | │ | ||
+ | │ | ||
+ | │ | ||
+ | │ | ||
+ | │ | ||
+ | │ | ||
+ | │ | ||
+ | │ | ||
+ | │ Page 6 of 6 | ||
+ | | ||
A Directory session has the following options you should set: | A Directory session has the following options you should set: | ||
- | Placeholder text | + | == Outbound Dir == |
+ | |||
+ | Set the directory you wish Mystic to place message packets / files in to that will be in turn processed by another system that is receiving them. | ||
+ | |||
+ | == Inbound Dir == | ||
+ | Set the directory you wish Mystic to look for inbound message packets / files from another system that has sent them to your BBS. | ||
config_echomail_nodes.txt · Last modified: 2023/01/03 01:49 by avon