home *** CD-ROM | disk | FTP | other *** search
/ Caldera Network Desktop 1.0 / caldera-network-desktop-1.0.bin / doc / HOWTO / mini / TIA < prev    next >
Text File  |  1996-01-01  |  13KB  |  330 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 = OK 
  221.       1 = CONNECT 
  222.       2 = ERROR 
  223.       3 = BUSY 
  224.       4 = NO CARRIER
  225.  
  226.    This would make your dial section look like this:
  227.  
  228.    dial:
  229.      dial "phonenumber"
  230.      print Dialing...
  231.      if $errlvl != 0 goto error
  232.      wait 1 20     
  233.      if $errlvl != 1 goto dial
  234.  
  235.    Thanks to Lee Olds (lee@eskimo.com) for that bit. 
  236.  
  237.    \n = newline, \r = carriage return. You may require one or the other (or 
  238.    both) in the appropriate places. If the ones provided don't work, experiment.
  239.  
  240.    After editing this file, rename it, say, remote.dip and put it in /root. 
  241.    Then, as root, run 'dip remote'. Use the -v flag the first time to debug 
  242.    it ('dip -v remote'), this will show you all the steps dip takes.
  243.  
  244.    Dip will only run as root, but there is a way to make it run from a user 
  245.    account. For now, if you need this info, ask. I may include it in this 
  246.    file later if enough people want it.
  247.  
  248.    If dip errors out right away, try removing the comments from the script.
  249.  
  250.  
  251.  
  252.    3.0 Now what?
  253.  
  254.    Hey, if all went well, you are now connected to the Net! Try a 'telnet 
  255.    remote' (remember that abbreviation in your hosts file?). You should get 
  256.    the remotes telnet login prompt. Go on, try it! You can now telnet/FTP/etc.
  257.    anywhere on the Net from your local machine. How? Your machine is using 
  258.    the remote as a nameserver to resolve addresses (resolv.conf). Experiment,
  259.    find out what works and what doesn't.
  260.  
  261.    You will not be able to use services that are not provided already on your
  262.    remote host! For example, if your server doesn't allow telnets, chances 
  263.    are you can't do it either. Why? Because TIA is only re-directing what 
  264.    is already available.
  265.  
  266.    3.1 News and Mail
  267.  
  268.    I have found a News Reader that is fairly simple to install and use. It 
  269.    is a true NNTP newsreader, which means no local news transport is required 
  270.    to make it work (you don't have install Cnews or INN). It does require 
  271.    that you have access to an NNTPserver, naturally, but most ISPs have this.
  272.    If you are able to use MSWIN apps like WinVN with your provider, this will 
  273.    work too. It is text based, but has color and mouse support, and runs 
  274.    fine in an rxvt window.  SLRN is still beta, but I have been using it 
  275.    exclusively for a while now, without any problems. 
  276.  
  277.    I am still looking for a good Mail Reader of the SMTP/POP3 variety, that 
  278.    will work no matter what state the local mail transport is in (from 
  279.    non-existent to fully functional). It doesn't have to be X based, but 
  280.    that would be a plus. If you have any suggestions, please send tham along 
  281.    to me. I am aware of things like popclient, but this seems a little 
  282.    clumsy to me, and I'd like to find a mail reader that at least handles 
  283.    the retreival chores.
  284.  
  285.    3.2 Mosaic/Netscape
  286.  
  287.    Obviously, you will need to have X running for this to work, but it's 
  288.    a simple matter of FTPing the binary, unpacking it, and installing it. 
  289.  
  290.    3.3 Remote X
  291.  
  292.    You can run remote X applications via TIA. The TIA-X HOWTO is 
  293.    available at the places listed below.
  294.  
  295.  
  296.    4.0 Misc.
  297.  
  298.    If I've left anything out, or you still have questions, I read my mail 
  299.    daily. This information gets updated fairly regularly, so keep checking 
  300.    back every so often (I'll change the version numbers). Naturally, the 
  301.    more you contribute, the more info will be included here, so don't 
  302.    hesitate to tell me about whatever you have to offer.
  303.  
  304.    If you would like some help, or are having trouble with your setup, I'll 
  305.    help but you must send me the following info: 
  306.    1. A copy of your three /etc files. 
  307.    2. A copy of your script output, run with the -v flag (please remove 
  308.    your password from this!)
  309.  
  310.    Even if you don't have anything to contribute, but used this info
  311.    sucsessfully, PLEASE MAIL ME. I want to know how useful this really is.
  312.  
  313.    4.1 References
  314.  
  315.    Sunsite is the FTP site sunsite.unc.edu, a veritable plethora of everything
  316.    Linux, including almost every FAQ, HOWTO, and README written.
  317.  
  318.    Marketplace.com is the home of TIA, the only place it is available.
  319.  
  320.    The homesite of the newsreader SLRN is space.mit.edu, in /pub/davis
  321.  
  322.    I am Irish, irish@eskimo.com, available for comment on Linux almost
  323.    everyday, when I'm not petting my cat or hugging my kid.
  324.  
  325.    This HOWTO is available in the following places: 
  326.       http://www.eskimo.com/~irish 
  327.       ftp://ftp.eskimo.com/u/i/irish 
  328.       ftp://sunsite.unc.edu/pub/Linux/docs/HOWTO/mini/TIA 
  329.  
  330.