home *** CD-ROM | disk | FTP | other *** search
/ BURKS 2 / BURKS_AUG97.ISO / BURKS / LINUX / HOWTO / mini / toknring.txt < prev    next >
Text File  |  1997-07-07  |  18KB  |  428 lines
  1. Token-Ring HOWTO
  2. Mike Eckhoff (meckhoff@zaphod.wayne.esu1.k12.ne.us)
  3. 7/5/95 - Rev 3
  4. To make reading/printing of this document easier, be sure that your margins
  5. are set to ".3" and you are using a proportional font like Courier.
  6.  
  7. The Ethernet-HOWTO file mentions the Token Ring driver that is being worked
  8. on.  This howto is designed to help you install the kernel patch and also try
  9. to point out some things to look for.  I suggest that you at least browse
  10. through all of this document before attempting to install any part of the
  11. Token ing driver for Linux.
  12.  
  13. Special Thanks to Mark Swanson, Peter De Schrijver, David Morris and everyone 
  14.     else I may have missed who made this driver possible.
  15.  
  16. Also thanks to:
  17.  Larry Sanders (lsanders@iadfw.net) 
  18.  
  19.   ...who corrected me in a few places.
  20.  
  21. Copyright and other Jazz
  22. ------------------------
  23.  
  24.     We do not guarantee that this howto will be accurate for your system.
  25.     Several people have used it and had very good results in installing
  26.     Linux on a Token Ring network.
  27.  
  28.     USE THIS HOWTO AT YOUR OWN RISK!!! ... We are not responsible for 
  29.     any problems caused by using this howto.
  30.  
  31.     If you have any problems with the driver that are not talked about
  32.     in this howto, feel free to email me at...
  33.         meckhoff@zaphod.wayne.esu1.k12.ne.us
  34.  
  35.     This document is copyright (c) 1995 by Michael Eckhoff.  You may 
  36.     make copies of this document in whole or in part, in any medium 
  37.     physical or electronic, as long as the copyright notice is 
  38.     retained on all copies.  Commercial redistribution is allowed and
  39.     encouraged; however, please notify me so that I can make sure that
  40.     you have the most current information available.
  41.  
  42.  
  43.  
  44. INDEX
  45. -----
  46.  
  47.     I.    Hardware Requirements
  48.     II.    Software Needed
  49.     III.    Installation and Setup
  50.     IV.    NetTools Installation
  51.     V.    Known Problems
  52.     VI.    Questions
  53.  
  54.  
  55. ----
  56.  
  57. I.  HARDWARE REQUIREMENTS
  58.  
  59.        Make sure that you have a Token Ring card that is supported by this
  60.        driver.  Currently the only cards that are supported are those that
  61.        use the Tropic chipset.  
  62.        Cards that I personally know to work are:
  63.  
  64.           IBM Token Ring 16/4 adapter /A
  65.           IBM Token Ring adapter /A
  66.           IBM Token Ring adapter II (4 Megabit only)
  67.               IBM 16/4 ISA Token Ring card (16bit)
  68.               IBM 16/4 ISA Token Ring card (8bit)
  69.               3Com TokenLink Adapter (IBM and 3Com mode)
  70.           HyperRing Classic 16/4
  71.  
  72.     Please note that IBM makes a DMA/busmaster adapter for ISA with
  73.     the name:
  74.  
  75.           Token-Ring Network 16/4 Adapter II
  76.  
  77.     which will *NOT* work.  Do not confuse this card with the IBM
  78.     Token Ring adapter II (4mbit) which does.
  79.  
  80.       If you find another card that works please email me the brand and type 
  81.       of card so that I may add it to my list.  
  82.                             - meckhoff@zaphod.wayne.esu1.k12.ne.us.
  83.  
  84.  
  85. II. SOFTWARE NEEDED.
  86.  
  87.     NOTE:  The 1.3.x Linux kernels include the Token Ring driver.
  88.         If you are using this kernel, you can skip to the
  89.         NetTools section.
  90.     
  91.     This assumes you already have Linux up and running.
  92.  
  93.     Obtain the Token Ring patch from:
  94.              ftp://linux3.cc.kuleuven.ac.be/pub/Linux/TokenRing/
  95.  
  96.     It will have a filename like TokenRing.patch-1.2.0.gz.  If you are
  97.     not running at least kernel version 1.2.0, you probably should be.  I 
  98.     have tested this patch on kernels 1.2.0 - 1.2.10 without any problems.  
  99.     If you cannot upgrade your kernel to version 1.2.x, try installing 
  100.     this patch anyway.  If it works, great!  If not, there are some 
  101.     older versions of the patch on this site that you may want to try.
  102.     I have ran the kernel with other versions of the patch since 1.1.5?.
  103.  
  104.     Obtain the NetTools patches from:
  105.       ftp://linux3.cc.kuleuven.ac.be/pub/Linux/TokenRing/
  106.                         Nettools-1.1.95-TR.diff.gz
  107.  
  108.      Create a directory for the patches(such as /usr/src/patches) and place
  109.      the patches there.
  110.   
  111.        mkdir /usr/src/patches             central directory for patch storage
  112.        mkdir /usr/src/patches/token       place TokenRing patch here
  113.        mkdir /usr/src/patches/nettools    place Nettools patch here
  114.  
  115.  
  116.     Obtain the NetTools source from your normal Linux source provider,
  117.     or from:
  118.           ftp://tsx-11.mit.edu/pub/linux/packages/net/PROGRAMS/NetTools/
  119.           net-tools-1.2.0.tar.gz
  120.  
  121.  
  122. III.  INSTALLATION AND SETUP
  123.  
  124. 1.  Install the TokenRing card into the system and configure it for the settings
  125.     that you want to use.  It is a good idea to see if you can use the card
  126.     through DOS before trying to use it through Linux.  If it works in DOS,
  127.     chances are, it will work in Linux with the same settings.
  128.  
  129. 2.  Make a backup of your linux directory.  This is very important in case you 
  130.     need to totally remove the source of the patch from your kernel and go 
  131.     back to your original code.
  132.  
  133.       cd /usr/src
  134.       tar cvzhf linuxbak.tar.gz linux
  135.  
  136. 3.  Uncompress the TokenRing patch.
  137.  
  138.        cd /usr/src/patches/token
  139.        gzip -d TokenRing.patch-1.2.0.gz
  140.  
  141. 5.  Modify your kernel with the TokenRing patch.
  142.  
  143.       cd /usr/src/linux
  144.       patch -p1 < /usr/src/patches/token/TokenRing.patch-1.2.0
  145.                     -or-
  146.       patch -p1 < <directory-of-patchfile>/TokenRing.patch-1.2.0
  147.  
  148. 6.  Search your kernel for any rejects from the patch and make changes as 
  149.     necessary.
  150.  
  151.       find . -name \*.rej -print
  152.  
  153. 7.  Search your kernel for the orig files and remove them.
  154.  
  155.       find . -name \*.orig -print | xargs rm
  156.  
  157. 8.  Configure your kernel and remake.
  158.         NOTE:  Make sure your swap space is active if you have one.
  159.     cd /usr/src/linux
  160.     make config
  161.         (The patch should have added two lines to your config.in file for the 
  162.          following options)
  163.  
  164.            Token Ring support (CONFIG_TR) [y]
  165.  
  166.               (and further down the list...)
  167.  
  168.            IBM Tropic chipset based adaptor support (CONFIG_IBMTR) [y]
  169.  
  170.     make dep
  171.     make clean
  172.     make zImage
  173.  
  174. 9.  Setup LILO.
  175.     First rename your /vmlinuz kernel to vmlinuz.old then copy the kernel to
  176.     /vmlinuz
  177.       On my system this would consist of copying
  178.         /usr/src/linux/arch/i386/boot/zImage to /vmlinuz and editing
  179.         /etc/lilo.conf to boot that kernel.
  180.     Now from the prompt run 'lilo'.
  181.  
  182. 10. If you have not already ran 'netconfig' on your system, do so now.  Setup
  183.     your machine just as if it were on Ethernet.
  184.  
  185. 11. Edit your /etc/rc.d/rc.inet1 scripts to point to the tr0 device rather 
  186.     then the eth0 device.  
  187.  
  188.     You should have a line that looks like
  189.  
  190.       /sbin/ifconfig eth0 ${IPADDR} broadcast ${BROADCAST} netmask ${NETMASK}
  191.  
  192.     Change this line to read
  193.  
  194.       /sbin/ifconfig tr0 ${IPADDR} broadcast ${BROADCAST} netmask ${NETMASK}
  195.  
  196. 12.  You should now be able to reboot your system and use the Token Ring
  197.      card in your computer.
  198.  
  199. IV.  NETTOOLS INSTALLATION
  200.  
  201.       The NetTools package contains a lot of the basic utils that you
  202.       will use to communicate with network devices.  This includes
  203.       programs like arp, rarp, route, ifconfig and netstat.  
  204.       Since these programs do not know about Token Ring by default, 
  205.       you will need to add the NetTools patch so these utilities can 
  206.       work more efficiently with the Token Ring driver.
  207.  
  208.     NOTICE:  The current version of NetTools is 1.2.0.  The patch for
  209.     1.1.95 seems to work just fine with this version.
  210.  
  211. 1.  Copy and Untar the NetTools source into your source directory.
  212.     NOTE:  The copy of net-tools-1.2.0.tar.gz that I used did untar
  213.      into the net directory under /usr/src/net directory.
  214.  
  215.       cp net-tools-1.2.0.tar.gz  /usr/src/net-tools-1.2.0.tar.gz
  216.       tar -zxvof net-tools-1.2.0.tar.gz 
  217.  
  218. 4.  Uncompress and install the patch file to net-tools.
  219.  
  220.       cd /usr/src/patches/nettools
  221.       gzip -d Nettools-1.1.95-TR.diff.gz
  222.       cd /usr/src/net
  223.       patch -p1 < /usr/src/patches/nettools/Nettools-1.1.95-TR.diff
  224.  
  225. 5.  Make the net-tools files.
  226.  
  227.       make install
  228.  
  229. V.  KNOWN PROBLEMS
  230.  
  231.     I personally have had very few problems with this driver.  It has
  232.     been working perfectly for me for quite some time. 
  233.  
  234.     One of the main problems with this driver, according to Peter De
  235.     Schrijver is Source Routing.
  236.  
  237. ~From: Peter de Schrijver <Peter.DeSchrijver@linux.cc.kuleuven.ac.be>
  238.  
  239. Main