home *** CD-ROM | disk | FTP | other *** search
/ PC World 1999 August / PCWorld_1999-08_cd.bin / doc / HOWTO / mini / Netrom-Node < prev    next >
Text File  |  1998-10-24  |  11KB  |  355 lines
  1.   Netrom-Node mini-Howto
  2.   Karl Larsen,  k5di@yahoo.com
  3.   v1.10, 19 October 1998
  4.  
  5.   This document describes how to setup the ax25-utilities package for
  6.   Amateur Radio such that it makes Netrom Nodes for the Node program and
  7.   the BBS software from John-Paul Roubelat, F6FBB. The DOS G8BPQ Switch
  8.   makes a bbs node and many features, it was expected that the Linux
  9.   ax25-utils would have a similar capability. This was not the case.
  10.   Help came from John Ackerman, N8UR who put a message on the Linux-Ham
  11.   SIG that he had done the BBS node and the info was on his web site!
  12.   When the information was tried it didn't work properly but much was
  13.   learned about the technique. Help from Tomi Manninen, OH2BNS did the
  14.   trick. Nodes for the BBS and the Node and the DX Cluster were made and
  15.   work fine.
  16.   ______________________________________________________________________
  17.  
  18.   Table of Contents
  19.  
  20.  
  21.   1. Introduction
  22.  
  23.   2. How to Begin
  24.  
  25.   3. Some Details of the AX.25 Utilities
  26.  
  27.   4. Setting Up Netrom
  28.  
  29.   5. Setting Up FBB and DXNet:
  30.  
  31.  
  32.  
  33.   ______________________________________________________________________
  34.  
  35.   1.  Introduction
  36.  
  37.   It is possible, using just the ax25-util's to generate node listings
  38.   for the Node application and the FBB BBS and the DXNet DX Cluster.
  39.   This is done by changing the configuration files for Netrom and making
  40.   a Netrom entry for each application. At present there is a kernel
  41.   imposed limit of 4 Netrom entries. The new kernels are expected to
  42.   drop this limit.
  43.  
  44.   Now users look for CRUCES:K5DI-4 and LCBBS:K5DI-3 and LCDX:K5DI-5 on
  45.   the many nodes here in New Mexico, Texas and Arizona and are connected
  46.   like magic. They no longer need to remember anything.
  47.  
  48.  
  49.  
  50.   2.  How to Begin
  51.  
  52.   Obtain and read the AX25-HOWTO:
  53.  
  54.   ftp:/sunsite.unc.edu/pub/Linux/docs/HOWTO/AX25-HOWTO/
  55.  
  56.   Using the AX25-HOWTO set up the normal Amateur Radio ax.25 and Netrom
  57.   system and make certain it is operating properly.  When the software
  58.   "CALL" can be used to make either a ax25 or Netrom connection to a
  59.   distant node, the system is ready to change to one using node listings
  60.   like the BPQ Switch.
  61.  
  62.   3.  Some Details of the AX.25 Utilities
  63.  
  64.   Below is a list of all the applications and files that are needed to
  65.   set up a working ax.25 system. The Applications are all in the
  66.   /usr/sbin/ directory and the Configuration files are in the /etc/ax25/
  67.   directory. Note: Kissattach is used only if you have TNC's in the Kiss
  68.   Mode.
  69.  
  70.  
  71.   ╖  kissattach             Application
  72.  
  73.   ╖  call                   Application
  74.  
  75.   ╖  ax25d                          Application
  76.  
  77.   ╖  ax25d.conf             Configuration file
  78.  
  79.   ╖  axspawn                        Application
  80.  
  81.   ╖  axspawn.conf           Configuration file
  82.  
  83.   ╖  axports                        Configuration file
  84.  
  85.   There are several names that a ax25-util user must invent.  Since this
  86.   paper uses the files of k5di, a listing of those names can be made.
  87.  
  88.  
  89.  
  90.  
  91.        Name            Call-sign       Alias           Other
  92.  
  93.        ax0             k5di-9                          ax25 9600 baud
  94.        ax1             k5di-10                         ax25 1200 baud
  95.        Netrom          k5di-1          #CRUCE          Real Netrom
  96.        netnod          k5di-4          CRUCES          Node node-list
  97.        netbbs          k5di-3          LCBBS           BBS  node-list
  98.        netdx           k5di-5          LCDX            DX-Cluster
  99.  
  100.  
  101.  
  102.  
  103.   It's a good idea to make a list like this on paper before you start to
  104.   change things. It is easy to put the wrong name in a control file.
  105.  
  106.   Kissattach is an application that connects the kernel to the TNC, sets
  107.   the tcp/ip address up, sets the speed of the connection, and is given
  108.   the serial port to use.
  109.  
  110.   Axports is a file that defines the name of the ax.25 ports and tells
  111.   kissattach what call-sign, baud-rate and window size to use.  Below is
  112.   an example of a 2 TNC system.
  113.  
  114.  
  115.  
  116.        # /etc/ax25/axports
  117.        # Be very careful with the speed setting. This is the speed in
  118.        # bits/second that data passes from the computer to the TNC, and has
  119.        # nothing to do with the radio baud rate!
  120.        #
  121.        # The format of this file is:
  122.        #
  123.        # name call-sign speed paclen window description
  124.        #
  125.        ax0     K5DI-9          9600    255     3       445.1 (9600 bps)
  126.        ax1     K5DI-10         9600    255     1       145.07 (1200 bps)
  127.  
  128.  
  129.  
  130.  
  131.   AX25D is the application that reads the ax25d.conf Configuration file
  132.   and answers calls made to the system. Below is a sample ax25d.conf
  133.   that has no Netrom defined. In fact all it will do is answer calls to
  134.   k5di-9 and k5di-10. When it answers it starts the node application and
  135.   logs the caller in.
  136.  
  137.  
  138.  
  139.        # /etc/ax25/ax25d.conf
  140.        #
  141.        #  AX25D Configuration File.
  142.        #
  143.        # AX.25 ports begin with a '['.
  144.        #
  145.        [k5di-4 VIA ax0]
  146.        default  * *    *   *   *    0 - root   /usr/sbin/node  node
  147.        [k5di-4 VIA ax1]
  148.        default  * *    *   *   *     0 - root  /usr/sbin/node  node
  149.        #
  150.  
  151.  
  152.  
  153.  
  154.   The next step is to get ax25d to answer a call to the alias CRUCES as
  155.   well as the call-sign. This is easy to do and is shown below:
  156.  
  157.  
  158.  
  159.        # /etc/ax25/ax25d.conf
  160.        #
  161.        #  AX25D Configuration File.
  162.        #
  163.        # AX.25 ports begin with a '['.
  164.        #
  165.        [CRUCES VIA ax0]
  166.        default  * *    *   *   *    0 - root   /usr/sbin/node  node
  167.        [k5di-4 VIA ax0]
  168.        default  * *    *   *   *    0 - root   /usr/sbin/node  node
  169.        [CRUCES VIA ax1]
  170.        default  * *    *   *   *    0 - root   /usr/sbin/node  node
  171.        [k5di-4 VIA ax1]
  172.        default  * *    *   *   *     0 - root  /usr/sbin/node  node
  173.        #
  174.  
  175.  
  176.  
  177.  
  178.   If you have trouble, as root kill ax25d if it is running and then at
  179.   the prompt type ax25d &. As ax25d loads the ax25d.conf file it will
  180.   print out any errors it finds. This print out is very accurate and
  181.   tells you which row in the file is wrong.
  182.  
  183.   A connect from any adjacent node to k5di-4 or CRUCES will connect to
  184.   the k5di node. But Netrom is not transmitting a node listing for
  185.   CRUCES or k5di-4. This is done by changing some Netrom Configuration
  186.   files.
  187.  
  188.  
  189.  
  190.   4.  Setting Up Netrom
  191.  
  192.   Netrom has applications and files that control it's function and to
  193.   achieve the G8BPQ look and function we must use these in ways never
  194.   intended. Below is a list of these components of Netrom:
  195.  
  196.  
  197.   ╖  nrattach        Application
  198.  
  199.   ╖  netromd         Application
  200.  
  201.   ╖  nrports         Configuration File
  202.  
  203.   ╖  nrbroadcast     Configuration File
  204.  
  205.      Nrattach is the application that works with the kernel and
  206.      establishes the ports and tcp-ip used by Netrom. To use nrattach
  207.      you place it in your startup file and the example looks like this:
  208.  
  209.  
  210.  
  211.  
  212.        /usr/sbin/nrattach -i 44.30.2.5 netrom
  213.        /usr/sbin/nrattach -i 44.30.2.5 netnod
  214.  
  215.  
  216.  
  217.  
  218.   Nrattach gets some of it's information from a configuration file
  219.   called nrports. This file is shown below:
  220.  
  221.  
  222.  
  223.        # /etc/ax25/nrports
  224.        #
  225.        # The format of this file is:
  226.        #
  227.        # name call-sign alias paclen description
  228.        #
  229.        netrom          K5DI-1  #CRUCE   235    Switch
  230.        netnod          K5DI-4  CRUCES   235    Real Node
  231.  
  232.  
  233.  
  234.  
  235.   There is no change to the nrbroadcast file so the remaining changes
  236.   will be made to the ax25d.conf file. In this file you normally put the
  237.   real netrom application called k5di-1, but since a call to k5di-1 or
  238.   #CRUCE gets undesirable results, leave that entry out of ax25d.conf
  239.   and a user will get just a "busy" when calling.
  240.  
  241.   Instead put in the netnod and that will allow ax25d to answer a call
  242.   to CRUCES. This is shown in the example below:
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.   # /etc/ax25/ax25d.conf
  266.   #
  267.   #  AX25D Configuration File.
  268.   #
  269.   # AX.25 ports begin with a '['.
  270.   #
  271.   [CRUCES VIA ax0]
  272.   default  * *    *   *   *    0 - root   /usr/sbin/node  node
  273.   [k5di-4 VIA ax0]
  274.   default  * *    *   *   *    0 - root   /usr/sbin/node  node
  275.   [CRUCES VIA ax1]
  276.   default  * *    *   *   *    0 - root   /usr/sbin/node  node
  277.   [k5di-4 VIA ax1]
  278.   default  * *    *   *   *     0 - root  /usr/sbin/node  node
  279.   #
  280.   # NET/ROM ports begin with a '<'.
  281.   #
  282.   <netnod>
  283.   default         * *     *   *   *   * -  root   /usr/sbin/node node
  284.   #
  285.  
  286.  
  287.  
  288.  
  289.   With these changes netrom node broadcasts will include the node
  290.   K5DI-4:CRUCES and K5DI-1:#CRUCE. By testing it was determined that a
  291.   call from any node to k5di-1 or #CRUCE got a busy, and a call to
  292.   k5di-4 or CRUCES connected to the node on this system.
  293.  
  294.  
  295.   5.  Setting Up FBB and DXNet:
  296.  
  297.  
  298.   The FBB packet BBS and DXNet Linux software are written to answer
  299.   calls to a call-sign defined in the configuration files. In these
  300.   examples the FBB call-sign is k5di-3 and the DXNet is k5di-5.
  301.  
  302.   Since calls to k5di-3 and k5di-5 are answered by other software, ax25d
  303.   is not used and these calls should NEVER be found in a ax25d.conf
  304.   file. But the nrports file needs to have the information added and 2
  305.   more nrattach lines are added to the start file. The nrattach lines (4
  306.   each) and the file "nrports" are shown below:
  307.  
  308.  
  309.  
  310.        /usr/sbin/nrattach -i 44.30.2.5 netrom
  311.        /usr/sbin/nrattach -i 44.30.2.5 netbbs
  312.        /usr/sbin/nrattach -i 44.30.2.5 netnod
  313.        /usr/sbin/nrattach -i 44.30.2.5 netdx
  314.  
  315.        # /etc/ax25/nrports
  316.        #
  317.        # The format of this file is:
  318.        #
  319.        # name call-sign alias paclen description
  320.        #
  321.        netrom          K5DI-1  #CRUCE   235    Switch
  322.        netnod          K5DI-4  CRUCES   235    Real Node
  323.        netbbs          K5DI-3  LCBBS    235    FBB BBS
  324.        netdx           K5DI-5  LCDX     235    DXNet DX Cluster
  325.  
  326.  
  327.  
  328.  
  329.   These changes will make the node listings wanted but a call to LCBBS
  330.   will not work yet. Recall that FBB answers a call to k5di-3 but not
  331.   the alias. To achieve this a change to the
  332.   /usr/local/fbb/system/port.sys file is required. Before these changes
  333.   port.sys had a listing for the name "netrom". With these changes
  334.   replace "netrom" with "netbbs". That section of port.sys is shown
  335.   below:
  336.  
  337.  
  338.        #TNC NbCh Com MultCh Pacln Maxfr NbFwd MxBloc M/P-Fwd Mode  Freq
  339.         0   0    0   0      0     0     0     0      00/01   ----  File-fwd.
  340.         1   8    1   ax0    250   4     1     10     30/60   XUWY  UHF port
  341.         2   2    1   ax1    250   4     1     10     00/60   XUWY  VHF port
  342.         3   6    1 netbbs   250   4     4     10     30/60   XUWY  BPQ look
  343.         4   8    2   0      250   5     4     1000    5/15   TUWY  Telnet
  344.        #
  345.  
  346.  
  347.  
  348.  
  349.   A similar change is made to the "dxnet.cfg" file where netrom is
  350.   replaced with netdx. When these changes are made and a few hours have
  351.   passed to let Netrom send node lists, any nearby node will have nodes
  352.   listed to your Netrom for CRUCES and LCBBS and LCDX, and they will all
  353.   work just as they do when using the G8BPQ Switch under DOS.
  354.  
  355.