home *** CD-ROM | disk | FTP | other *** search
/ BURKS 2 / BURKS_AUG97.ISO / BURKS / LINUX / HOWTO / mini / tia.txt < prev    next >
Text File  |  1997-07-07  |  13KB  |  331 lines
  1. Global Linux-TIA HOWTO
  2.  
  3. version 2.0T (updated 12/16/95) by Irish
  4.  
  5. This document will describe how to get your Linux box to connect to a
  6. generic site via TIA, The Internet Adaptor. I take no responsibility for
  7. your use of this information, but corrections are welcome. 
  8.  
  9. I will not attempt to describe all that can be done over this connection
  10. once established, but I will refer you to other documents or sites that
  11. will contain the relevant information. 
  12.  
  13. That done, let's do it!
  14.  
  15.  
  16.  
  17.    1.0 What is TIA? 
  18.  
  19.    The Intenet Adaptor was written by the fine folks at marketplace.com. It is
  20.    used to simulate a SLIP connection from a shell account. It costs $25 for a
  21.    single user license, site licenses are available. It works with any client
  22.    OS that uses standard TCP/IP and SLIP networking, and clients.
  23.  
  24.    1.1 How does TIA work?
  25.  
  26.    It is important to understand how TIA works in general, to be aware of its
  27.    limitations. First, you do not need to install TIA on your machine. It 
  28.    runs on your remote host only. What you need is the TCP/IP and SLIP 
  29.    protocols installed in your kernel (more on that in a bit), and some clients.
  30.  
  31.    Here's what happens: you send network requests from your machine to your
  32.    remote host over the SLIP link. TIA grabs them and sends them out to the Net
  33.    at large. Then, incoming data is sent back from the Net to your account on 
  34.    the remote host, where TIA grabs it and sends it back over the SLIP link 
  35.    to your machine. So, to the Net it appears as if you are working out of 
  36.    your account on the remote host, but to you it looks like you are really 
  37.    connected right to the Net.
  38.  
  39.    As you can see, this can confuse stuff that is incoming from the Net. For
  40.    example, talk doesn't work via TIA, because the incoming talk request 
  41.    tries to start the remote hosts talk daemon, not yours.
  42.  
  43.    The other big difference between TIA and real SLIP is you are NOT assigned
  44.    your own IP address; remember, you are only converting a dialup account to a
  45.    SLIP connection.
  46.  
  47.    1.2 What about Term?
  48.  
  49.    What about it? My opinion; Using Term is like using a crank to start 
  50.    your car, a lot of work and completely unnessesary. Of course, if you 
  51.    don't have root access to your machine for one reason or another, and 
  52.    you can't persuade someone who does to install SLIP and dip, then you 
  53.    won't have much choice. If you really want to know more about Term, read 
  54.    the HOWTO on Sunsite. 
  55.  
  56.    1.3 What about SLiRP?
  57.  
  58.    This is new, and it's free because it's GPLed. TIA isn't free, but it's 
  59.    real cheap, real stable, and well supported and documented. Go ahead and 
  60.    try it if you wish. I have heard that the following information works for 
  61.    SLiRP with only minor modifications, but please don't mail me with 
  62.    questions because I really don't know anything about it. Don't get me 
  63.    wrong, obviously I have nothing against free software, but TIA is what 
  64.    I know and use. Besides, for me TIA is free, because the Admin here 
  65.    purchased a site license. Maybe you can convince yours, it's worth it, 
  66.    for you and them. 
  67.  
  68.  
  69. Enough already! How do I set it up?
  70.  
  71.    2.0 Preparing your Linux machine
  72.  
  73.    In a nutshell, here's what's required. I'll explain each of these in detail.
  74.  
  75.       -> Compile your kernel to include SLIP and TCP/IP 
  76.       -> Edit some files in /etc 
  77.       -> Install and configure dip 
  78.    You will also need to get the TIA binary appropriate for your remote host 
  79.    and install it. All of the relevant info for this is available at TIAs home 
  80.    site. 
  81.  
  82.    NOTENOTENOTE: TIA 2.0.5 is out now. It supports, among other things,
  83.    CSLIP and PPP. There are very few changes required to use CSLIP, and they
  84.    are noted below. A PPP HOWTO will be forthcoming soon, as well as
  85.    documentation on some new features. Watch this space!
  86.  
  87. That's it! Let's get started.
  88.  
  89.    2.1 Compiling your kernel
  90.  
  91.    If you have never done this, you should. And you should read the FAQ 
  92.    first, but don't worry, it's easy. If you want, you can e-mail me and 
  93.    I'll help.
  94.  
  95.    I'll assume that you have here, for the sake of brevity. When you 'make 
  96.    config', look for "Network Devices". Say 'y', of course, then say 'y' to 
  97.    SLIP and TCP/IP, (Tia 2.0.5 users: say 'y' to CSLIP instead/also) and 'n' 
  98.    to everything else, unless you have ethercards or need some other protocol 
  99.    for something else. If you don't do this, it won't work! Finish compiling 
  100.    and installing the new kernel, then,
  101.  
  102.    2.2 Edit some files in /etc
  103.  
  104.    These files will set up your routes to your remote host. /etc is the 
  105.    directory for system configurations. Replace everything in double quotes 
  106.    with the appropriate values, naturally (but don't include the quotes - 
  107.    they are there for reference). There are three files you need to edit, 
  108.    they are:
  109.  
  110.       /etc/hosts: 
  111.  
  112.       127.0.0.1       localhost
  113.       192.0.2.1       "your.hostname.domain"
  114.       "XXX.XXX.XX.XX" "remote.hostname.domain remote"  #<-- Note the abbreviation.
  115.               
  116.  
  117.       /etc/host.conf: 
  118.  
  119.       order hosts, bind
  120.       multi on
  121.               
  122.  
  123.       /etc/resolv.conf: 
  124.  
  125.       domain "yourdomainhere"         
  126.       nameserver "XXX.XXX.XX.XX"      #<- Usually the same as in /etc/hosts
  127.               
  128.  
  129.       To use an NNTPserver, put this line in your /etc/profile:
  130.  
  131.       export NNTPSERVER="remote.hosts.nntpservername"
  132.  
  133.    2.3.1 Dip
  134.  
  135.    Dip is what you will use to dial up the remote host, start TIA, and 
  136.    convert the line to SLIP. It comes in the "N" set of Slackware, along 
  137.    with a bunch of clients and utilities, some of which you may want to 
  138.    install also =). It is also available at Sunsite in an individual tar file.
  139.  
  140.    Once you have it installed, you will need to have a dip script, Here's 
  141.    a sample, just plug in the appropriate stuff where the double quotes 
  142.    are (but don't include the quotes, they are there for reference).
  143.  
  144.    ----------CUT HERE--------------------------------
  145.  
  146.    main:
  147.      get $local "your.hostname.domain"
  148.      get $remote "remote.hostname.domain"
  149.      port cua"?"                   #<-- Your port here
  150.      speed 38400                   #<--You may be able to use 57400 in newer 
  151.      reset                         # kernels
  152.      init AT "string of commands"  #<--don't use spaces in your AT command string 
  153.      wait OK 5
  154.  
  155.    # This will redial. If it doesn't work, play with the wait time (listen 
  156.    # to your modem). If it still doesn't work, mail me.
  157.    # See also; the note at the bottom of the script re: error codes.
  158.  
  159.    dial:
  160.      dial "phonenumber"
  161.      print Dialing...
  162.      if $errlvl != 0 goto error
  163.      wait BUSY 20                  #<--You may need to change this wait time  
  164.      if $errlvl == 0 goto dial     #   to suit your modem
  165.  
  166.    login:
  167.      print Connected and Logging in...
  168.      wait ==> 60                   #<-- This wait and send get me past my 
  169.      send 4\n                      #<-- hosts Annex. Change for your site!
  170.      wait ogin: 60
  171.      if $errlvl != 0 goto login_error1
  172.      send "LOGIN"\n
  173.      wait assword: 60
  174.      if $errlvl != 0 goto login_error2
  175.      send "PASSWORD"\n
  176.  
  177.    loggedin:
  178.      wait "SYSTEM PROMPT" 60
  179.      if $errlvl != 0 goto shell_error
  180.      send tia\n
  181.      wait software. 60
  182.      if $errlvl != 0 goto tia_error
  183.      print Starting TIA...
  184.      get $mtu 296          #<--Tia recommends 1500, but this is faster 
  185.      default               #interactively. Ftp may be slower, so adjust to taste.
  186.  
  187.    done:
  188.      print CONNECTED to $remote with address $rmtip
  189.      mode SLIP
  190.    # TIA 2.0.5 users: change the above line to 
  191.    # mode CSLIP
  192.      goto exit
  193.  
  194.    error:
  195.      print Dialing Error
  196.  
  197.    login_error1:
  198.      print No Login
  199.  
  200.    login_error2:
  201.      print No Password prompt
  202.  
  203.    shell_error:
  204.      print No shell prompt
  205.  
  206.    tia_error:
  207.      There was a problem starting TIA
  208.  
  209.    exit:
  210.      \r            #<--This will error out with the -v flag, but work when 
  211.                    #run normally (ends dip at a local prompt).
  212.  
  213.    -------------CUT HERE-----------------------------
  214.  
  215.    2.3.2 Dip notes
  216.  
  217.    Newer versions of dip don't return modem status codes (BUSY, NO
  218.    CONNECT, etc.), they use numbers instead. Here's a table:
  219.  
  220.       0