home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / V56A6_2.ZIP / MULTINET.DOC < prev    next >
Text File  |  1993-02-06  |  21KB  |  468 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                    ██┐    ██┐ ████████┐ ████████┐ ███████┐
  13.                    ██│    ██│ └██┌──██│ └██┌──██│ ██┌────┘
  14.                     ██┐  ██┌┘  ███████│  ███████│ ███████┐
  15.                      ██┐██┌┘   ██┌──██│  ██┌──██│ └────██│
  16.                       ███┌┘   ████████│ ████████│ ███████│
  17.                       └──┘    └───────┘ └───────┘ └──────┘
  18.                                       *
  19.  
  20.                              The Virtual BBS/NET
  21.                                 Version 5.6x
  22.  
  23.               Copyright (C) Roland De Graaf 1990, 1991, 1992, 1993
  24.  
  25.                               4246 Elisabeth Ave.
  26.                               Holland, MI 49424
  27.  
  28.                                       *
  29.    -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  30.                         Multi-Network Documentation
  31.    -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  32.           Edited By:   UT Prof   aka Richard Shell 1@2103 VirtualNet
  33.    -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  34.  
  35.            -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  36.                                 TABLE OF CONTENTS
  37.            -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  38.  
  39.  
  40.            (1) -   THE VBBS MULTINET ENGINE
  41.                    1.1 - Overview
  42.                    1.2 - The Multinetwork Master List
  43.                    1.3 - The Multinet Mail Tosser
  44.                    1.4 - Network-specific Interfaces
  45.  
  46.            (2) -   CONFIGURATION
  47.                    2.1 - VConfig
  48.                    2.2 - Answer.net Configuration
  49.  
  50.            (3) -   STARTING YOUR OWN NETWORK
  51.                    3.1 - Considerations for Wide-Area Networks
  52.                    3.2 - Local Networks
  53.  
  54.            (4) -   TECHNICAL NOTES
  55.                    4.1 - Net.0 File
  56.                    4.2 - Net.x Files
  57.                    4.3 - <database filename>.NET Files
  58.                    4.4 - The MultiNet Tosser Functions & Email Gating
  59.  
  60.            -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  61.                            (1) - THE VBBS MULTINET ENGINE
  62.            -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  63.  
  64.            1.1 - Overview
  65.  
  66.              VBBS is the first BBS program to incorporate a true
  67.              multinet engine within the BBS itself, capable of seamlessly
  68.              integrating up to 999 networks and providing automatic gating
  69.              of e-mail between different networks. The multinet engine
  70.              works through the interraction of four components: the
  71.              multinetwork master list which identifies the networks,
  72.              the multinet mail tosser which processes e-mail and posts,
  73.              specific network utilities used for interfacing with each
  74.              basic type of network, and the front end mailer which
  75.              identifies incoming network calls.
  76.  
  77.  
  78.            1.2 - The Multinetwork Master List
  79.  
  80.              The master list of allowable networks is a file named NET.0,
  81.              and is located in the VBBS 'Data' subdirectory.
  82.  
  83.              This master list is the only way for VBBS to identify the
  84.              origin and destination of posts and e-mail, so it is a
  85.              requirement that major networks be listed in the NET.0 file.
  86.              For small local networks, open slots configureable by the
  87.              sysop have been made available in the NET.0 file for use with
  88.              the VBBS, WWIV, and FIDO interface utilities. Please refer to
  89.              the Local Network section below for specific details.
  90.  
  91.              New major networks are added to the official NET.0 file on a
  92.              regular basis. Please see the NET.0 Inclusion section below.
  93.  
  94.              For reasons of security, the NET.0 file comes in encrypted
  95.              form and may not be edited. Attempts to do so are considered
  96.              hacking and appropriate legal action may be taken against
  97.              those involved. It should be stressed that contamination of
  98.              the master listing could result in network-wide failure and
  99.              disruption of the normal flow of information through various
  100.              networks.
  101.  
  102.              To view the network entries in the NET.0 file, simply choose
  103.              option 7, Network Configuration, on the VConfig menu.
  104.  
  105.            1.3 - The Multinet Mail Tosser
  106.  
  107.             The multinet mail tosser is built directly into VBBS.
  108.             No external mail tossers from third parties are needed,
  109.             although VBBS can be configured to use them if desired.
  110.  
  111.             The tosser handles this process of distributing email
  112.             and posts to the appropriate "pending" files for each
  113.             network you are connected to. The tosser also handles
  114.             the importation of incoming email and posts to the BBS,
  115.             and the gating of posts between networks.
  116.  
  117.             Mail tosser operation is completely automatic and requires
  118.             no special attention. Tossing may also, however, be invoked
  119.             by command line switches or batch files called by external
  120.             events to add flexibility. Please refer to the individual
  121.             documentation for each network-specific interface for
  122.             details on syntax and how this is accomplished. Such
  123.             documentation is included in the zip file for each interface
  124.             utility.
  125.  
  126.  
  127.           1.4 - Network-specific Interfaces
  128.  
  129.             As of this moment, four basic network interface types
  130.             may be used in conjunction with the VBBS multinet engine.
  131.             These are as follows:
  132.  
  133.             VNET.EXE     for VirtualNET-type networks (type 1)
  134.             VWW4.EXE     for WWIVnet-type networks    (type 2)
  135.             VUUCP.EXE    for UUCP-type networks       (type 3)
  136.             VFIDO.EXE    for FIDO-type networks       (type 4)
  137.  
  138.             These utilities may be downloaded from any VBBS support
  139.             board and are accompanied by specific installation
  140.             instructions.
  141.  
  142.             Please note that these utilities are not crippled in
  143.             any manner, however, you should register VBBS within sixty
  144.             (60) days to avoid an interruption of service. Failure to
  145.             register will inactivate all interface utilities automatically,
  146.             with the exception of VNET.EXE, after the 60-day period.
  147.             To avoid any inconveniences, please register VBBS as soon as
  148.             possible.
  149.  
  150.            -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  151.                               (2) - CONFIGURATION
  152.            -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  153.  
  154.            2.1 - VConfig
  155.  
  156.            The multinet configuration is done by running option 7, Network
  157.            Configuration, in VConfig. From the net configuration menu, you
  158.            simply choose which network you want to add, and enter the
  159.            appropriate information. It is very important to remember after
  160.            running option 7 to select option 3, Database Configuration,
  161.            and run the Sort Databases and Compile Network functions found
  162.            there.
  163.  
  164.            For specific installation details, please refer to the main
  165.            VBBS560.DOC, and the DOC files that accompany each network
  166.            interface utility, ie. VWW4, VUUCP, and VFIDO.
  167.  
  168.            2.2 - Answer.net Configuration
  169.  
  170.            ANSWER.NET, an ordinary ascii text file, should be created
  171.            and placed in your VBBS 'Data' subdirectory if you are to
  172.            interface with other networks successfully. You must have
  173.            answer.net set up properly for VBBS to be able to correctly
  174.            identify incoming network calls. In many cases, the incoming
  175.            network call will use a macro to identify itself. The
  176.            answer.net file is used by the multinet engine to
  177.            acknowledge the network macro, identify the network, and call
  178.            up the proper network interface utility after connecting.
  179.  
  180.            Note that VirtualNET type networks do NOT need to be configured
  181.            in ANSWER.NET since type 1 networks are automatic. However,
  182.            to detect types 2 through 4, you must "program" ANSWER.NET to
  183.            be able to identify the incoming network from the string it
  184.            sends.
  185.  
  186.            ANSWER.NET uses only three simple one-character commands: ">",
  187.            "!", and "?".
  188.  
  189.            ">"     Sends a string. For example, >HELLO would transmit
  190.                    HELLO
  191.  
  192.            "!"     Waits up to 2 seconds for a byte to come in
  193.  
  194.            "?"     Compares received byte to ascii code values
  195.                    and calls up the appropriate network interface driver
  196.  
  197.           Here are some examples:
  198.  
  199.           ?78=2
  200.           If received byte was 78 ("N"), then answer network #2 (WWIVnet)
  201.           N N N N is the string that WWIVNet sends.
  202.  
  203.           ?76=3
  204.           If recevied byte was 76 ("L"), then answer network #3 (WWIVLInk).
  205.           L L L L must be the string that WWIVLink sends and must be set
  206.           up by your Link server using a macro.
  207.  
  208.           Here is an example ANSWER.NET, for a VBBS that is on WWIVnet
  209.           only which you may use:
  210.           !
  211.           ?78=2
  212.           ?32=2
  213.  
  214.           Here is an example you may use if you are on both WWIVnet and
  215.           WWIVLink:
  216.           !
  217.           ?78=2
  218.           ?32=2
  219.           ?76=3
  220.  
  221.           Here is an example for a VBBS on USEnet:
  222.           >UUCP
  223.           !
  224.           ?85=5
  225.  
  226.           Here is an example for a VBBS on USEnet, WWIVnet, and WWIVLink
  227.           which may be used:
  228.           >UUCP
  229.           !
  230.           ?78=2
  231.           ?32=2
  232.           ?76=3
  233.           ?85=5
  234.  
  235.            -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  236.                         (3) - STARTING YOUR OWN NETWORK
  237.            -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  238.  
  239.           3.1 - Considerations for Wide-Area Networks
  240.  
  241.            Because of VBBS' uniquely-designed multinet engine, starting
  242.            your own new network is easier than ever before whether you
  243.            are a business or an advanced system operator.  Here are just
  244.            a few things to consider if you are contemplating this:
  245.  
  246.            A) You will need to decide on what type of network software
  247.               you want to use for your new network:
  248.  
  249.               VirtualNET type
  250.               WWIVnet type
  251.               FIDO type
  252.               UUCP type
  253.  
  254.               While the multinet engine will easily handle any type above,
  255.               remember that the simplest network to run operationally is a
  256.               VirtualNET type network. This requires no special setup of
  257.               the answer.net file or macro setup on the part of the server,
  258.               has support for update utilities, and other advantages.
  259.  
  260.            B) You will need to select a name for your network.
  261.  
  262.            C) You will be responsible for maintaining your network, such
  263.               as producing its bbslist or nodelist, establishing
  264.               connections, nominating ACs, etc.
  265.  
  266.            D) You should have the following thought out in advance:
  267.  
  268.               Network Policy and Goals
  269.               Network Application
  270.               Advertising
  271.               Administration
  272.  
  273.            E) Update utilities
  274.  
  275.               Update utilities let you, as network coordinator send out
  276.               BBSLISTs and SUBSLISTs for the maintenance of your network.
  277.               Custom update utilities for VirtualNET type networks are
  278.               available from the VBBS author. For more information on how
  279.               to start a VirtualNET type network, please refer to the
  280.               LOCALNET.DOC file.
  281.  
  282.            F) Inclusion in NET.0
  283.  
  284.               Inclusion in the NET.0 file implies that your network will
  285.               be national/international in nature with 1) a substantial
  286.               number of subscribing nodes 2) in diverse geographical areas
  287.               3) with a reasonable volume of message traffic.
  288.  
  289.               Networks which feel they will meet these criteria should
  290.               send requests for inclusion on the NET.0 master list directly
  291.               to 1@1 VirtualNET.
  292.  
  293.               The requesting sysop will receive a questionnaire to complete
  294.               and return. The information provided will be reviewed and
  295.               approved by the Virtual MultiNetwork Committee (VMC) in
  296.               light of the guidelines above.
  297.  
  298.               There is no charge for inclusion in the NET.0 file. The only
  299.               constraints are: 1) the request for inclusion be made by
  300.               a registered VBBS system operator, and 2) only one inclusion
  301.               per system operator is allowed.
  302.  
  303.  
  304.           3.2 - Local Networks
  305.  
  306.               In many cases the network you wish to start or join will
  307.               be restricted to your own locale, or be too small for
  308.               inclusion on the national NET.0 master list. In this case
  309.               the sysop wishing to start/join a network may use one of the
  310.               sysop configureable open slots available on the NET.0 list.
  311.  
  312.               A total of 2 configureable slots are available on the
  313.               NET.0 master list. They are slots 15 and 19, and you can
  314.               configure the network names and network type.
  315.               To set-up the name and type for slot 15:
  316.               Create a text file called LOCALNET.15 in your main VBBS dir.
  317.               The first line of the file should contain the network name.
  318.               The second line the network type (1 to 4).
  319.               Example:
  320.               MyNetwork
  321.               4
  322.  
  323.               Setting up slot 19 works the same way except you would
  324.               create a LOCALNET.19 instead.
  325.               
  326.               Please refer to the LOCALNET.DOC for detailed instructions
  327.               on setting up your network.
  328.  
  329.            -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  330.                             (4) - TECHNICAL NOTES
  331.            -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  332.  
  333.           4.1 -  NET.0 File
  334.  
  335.               The NET.0 file is a master list of networks. Each
  336.               network is defined by Proper Name ("VirtualNET",
  337.               "WWIVNet", "USENet",etc.) and by Network Protocol
  338.               (VNET, VWW4. VUUCP, VFIDO,etc.), and by Network ID.
  339.               Each network has a unique ID number. IDs begin at
  340.               1 and go up sequentially. Slot 0 is earmarked for
  341.               special use by the author. This file is encrypted
  342.               and may only be edited by the VBBS author.
  343.  
  344.  
  345.           4.2 - NET.x Files
  346.  
  347.               These are the configuration files for each network and
  348.               are located in the Data subdirectory. The .x refers to
  349.               the network ID number as defined in the NET.0 file.
  350.               These are simple ascii files in this format:
  351.               <parametername>=<parameter data>
  352.  
  353.               A NET.2 file for WWIVNet, for example, might look like
  354.               this:
  355.                           systemid=2067
  356.                           netdir=c:\wwiv\data
  357.                           mode=net
  358.  
  359.               where systemid is the WWIV node number, netdir is where
  360.               the network files are located, and mode is either
  361.               "net" or "link" which instructs VWW4 of the mode to run in.
  362.  
  363.               A NET.1 file for VirtualNET, might look like this:
  364.  
  365.                           systemid=2103
  366.                           netdir=c:\vbbs\net
  367.                           server=1
  368.                           client=2112 $1-512-340-2265
  369.                           client=2115 +381-0031 /25
  370.  
  371.               where $,+, /,!, and ^ are optional modifiers indicating
  372.               long distance phone numbers, local phone numbers, threshold,
  373.               macro, and password.
  374.  
  375.               Note that VConfig is used to edit these NET.x files, but
  376.               they could be edited manually.
  377.  
  378.           4.3 - <database filename>.NET Files
  379.  
  380.               These are located in the DB subdirectory and show the
  381.               networks a database (message base,sub) is connected to.
  382.               These are ascii files that store the sub identifications.
  383.               In addition to the .NET file, .QSC, .BIN, and .DAT files
  384.               are generated when a database is configured. For example,
  385.               the x.NET file for VBBS Forum, a sub gated to WWIVNet, might
  386.               look like this:
  387.                               1=302
  388.                               2=5275
  389.               This is translated as:
  390.               network ID 1 (VirtualNET) sub number 302
  391.               network ID 2 (WWIVNet) subtype 5275
  392.  
  393.               If this sub were being gated to other networks, additional
  394.               lines would be added with the appropriate information.
  395.  
  396.               Note here also that the sub identification can be a number
  397.               or a string. This depends only on the net interface's
  398.               interpretation of the data.
  399.  
  400.           4.4 - The MultiNet Tosser Functions & Email Gating
  401.  
  402.               The multinet tosser ensures that all gated messages go to the
  403.               proper place. An example of the mechanics are as follows:
  404.  
  405.               When a user posts, two copies are written. One goes to the
  406.               database itself, and the other goes to SPOOL.NET which is
  407.               a temporary file fond in the Data subdirectory. After
  408.               the user logs off, the tosser analyzes SPOOL.NET and
  409.               distributes the posts to PENDING.x files, where .x is the
  410.               network ID. VBBS then checks for PENDING.x files that
  411.               might exist and calls up the proper network interface
  412.               handler for each PENDING.x file. The net interface program
  413.               reads its own PENDING.x file and packs up the messages.
  414.  
  415.               When a net interface program receives a message, it also
  416.               needs to write two copies, one to LOCAL.NET which VBBS
  417.               unpacks to the databases, and one to either VALIDATE.x
  418.               if validation is turned on for the sub, or to
  419.               DISTRIB.NET.  DISTRIB.NET is similar to SPOOL.NET except
  420.               that messages in DISTRIB.NET are redistributed to all
  421.               networks except the one it came in on. (SPOOL.NET is
  422.               distributed to all networks).
  423.  
  424.               The multinet mail tosser also handles gating of email.
  425.               That is, you can send & receive email to a user on a network
  426.               of which you are not actually a member.
  427.  
  428.               For example, let's say you wanted to send an email
  429.               to someone on FIDOnet, but you're not actually on FIDOnet,
  430.               but you are a member of VirtualNET.
  431.  
  432.               Your first step is to find a VirtualNET system
  433.               that is also on FIDOnet. (Multinetworked)
  434.  
  435.               Once that is accomplished, email the sysop of that board
  436.               and ask if you may use his system to gate email
  437.               into the other network. (It's always good to ask first.)
  438.  
  439.               If permission is granted, manually create a text file
  440.               in your DATA directory, the filename should be GATEWAY.x
  441.               where x is equal to the network id of the network you
  442.               want to have a gateway to. In this example, since are target
  443.               network is FIDOnet (Network ID = 4), we would create a
  444.               GATEWAY.4 file in the DATA Directory. We will put one
  445.               line of ASCII text into this file:
  446.  
  447.               @<system address>*<network number>
  448.  
  449.               <system address> is the node address of our gateway system.
  450.               <network number> is the TRANSPORT NETWORK which will be used
  451.                                to gate the mail.
  452.  
  453.               For example, if I wanted my FIDOnet gateway to be
  454.               @440 VirtualNET, I would make GATEWAY.4, with the line:
  455.               @440*1
  456.  
  457.               Another example: I want to email USEnet thru TechNET
  458.               (Network ID = 8) system @1000. I would create a GATEWAY.5
  459.               file (Network ID = 5 for USEnet), containing the line:
  460.               @1000*8
  461.  
  462.               It should be noted that the TRANSPORT NETWORK must
  463.               be of VirtualNET type. An email may, however, pass
  464.               thru several gateways (no limit), if needed, to get
  465.               it where you want it to go. This opens up some very
  466.               powerful possibilities.
  467. 
  468.