home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Amiga Shareware Floppies / ma51.dms / ma51.adf / AmiTCP_demo_40.lha / AmiTCP-4.0 / HowToInstall < prev    next >
Encoding:
Text File  |  1994-10-24  |  8.5 KB  |  228 lines
  1.  
  2. * How to Install AmiTCP/IP
  3.  
  4.   You should not install the current version on top of older
  5.   version.  If your disk space allows, leave the old version on the
  6.   disk and delete it when you have the new version up and running. The
  7.   installation script will copy your old configuration from old
  8.   version directory.
  9.   
  10.   Extract first the distribution archives (AmiTCP_xxx_xx.lha) to some
  11.   directory in your hard disk (e.g. WORK:).
  12.  
  13. * Configuration Information
  14.   
  15.   Before you proceed, you should get the following information from
  16.   your network administration (if you don't have the information, you
  17.   have to reinstall AmiTCP/IP afterwards):
  18.   
  19.   * Internet protocol address for your computer. This is a 32 bit
  20.     integer represented as a series of decimal numbers separated by
  21.     dots. For example, 130.233.161.40 is a legal internet
  22.     address. Your IP address can also be dynamic, i.e., different each
  23.     time you connect to the IP network.
  24.  
  25.   * If you have a point-to-point connection to the network, you need
  26.     to know your destination IP address, that is the IP address of
  27.     the host you are connected. SLIP, CSLIP and PPP are examples of
  28.     point-to-point connections. Generally you can use the IP address
  29.     of your default gateway as the destination address, if no specific
  30.     destination address is given.
  31.   
  32.   * Netmask for your network. This specifies how many bits of your
  33.     internet address are used to specify the network address. Netmask
  34.     is like 255.255.255.0. If your network is not sub-netted, then you
  35.     do not have to supply this value (a default computed from the IP
  36.     address is used).
  37.   
  38.   * Address of the default gateway. If your host do not know any route
  39.     to a host it resorts to the default gateway. If you have only one
  40.     point-to-point connection, you can use the host you are connected
  41.     to as the default gateway.
  42.   
  43.   * Your host name. Host name is a more convenient way than the internet
  44.     address to refer your computer. This is like `Amiga1'. If your IP
  45.     address is dynamic, then you do not need to supply this.
  46.   
  47.   * Domain name of your site. For example, "hut.fi" is the domain name
  48.     for the Helsinki University of Technology in Finland. The part
  49.     after the first dot in your full host name is usually (but not
  50.     always) your domain name. If you are not going to use Domain Name
  51.     Servers, then you do not have to supply a domain either.
  52.   
  53.   * Addresses of the Domain Name Servers which will be used to
  54.     translate host names to the corresponding internet addresses. A
  55.     local database must be used instead if there is no name server on
  56.     your domain.
  57.   
  58.     If you have an access to a Unix machine in your network, you can
  59.     probably find a list of domains and name server addresses in the
  60.     file `/etc/resolv.conf'. Also, if there is no name server, you can
  61.     copy the file `/etc/hosts' to the `AmiTCP:db/hosts'.
  62.  
  63.   Next you should obtain a SANA-II compatible device driver for your
  64.   network adapter. The SANA-II drivers are usually installed into
  65.   directory `DEVS:networks'. We have included a few freely
  66.   distributable drivers with the AmiTCP/IP. You can use the SLIP or
  67.   CSLIP drivers with a serial interface. See the file doc/slip.doc for
  68.   more info on the provided SLIP drivers.
  69.  
  70.   AmiTCP/IP uses a mnemonic name of SANA-II device driver to access
  71.   it. The name and parameter mapping is specified in the configuration
  72.   file `AmiTCP:db/interfaces'. You might also have to make a
  73.   configuration file for your device driver. The installation script
  74.   can create configuration files for the SLIP, CSLIP and GGBus+ ISA
  75.   Ethernet interfaces. Configuration files are usually stored into the
  76.   directory `ENV:Sana2/'.
  77.   
  78.   You may start the installation by double-clicking the
  79.   `Install_AmiTCP'-icon.
  80.  
  81. * About User and Group Databases
  82.  
  83.   AmiTCP/IP gives some user management support. For each user, there
  84.   is one line of information in the file `AmiTCP:db/passwd', which is
  85.   currently used by `finger', `ls' and other commands.  This line is
  86.   separated to 7 parts with vertical bars (`|'):
  87.  
  88. username|password|uid|gid|gecos|home directory|shell
  89.  
  90.   The `gecos' part contains real name, office, office phone and home
  91.   phome numbers separated with commas (',').  You can print them with
  92.   finger. Markus Peuhkuri has following entry in the example `passwd'
  93.   file:
  94.  
  95. puhuri|*|17681|100|Markus Peuhkuri,G218,4512462,4521992|users:puhuri|shell
  96.  
  97.   Markus has username puhuri. As the password field contains `*', his
  98.   password is disabled (so he can not log into your machine even if
  99.   the remote login is installed). His numeric identifier, UID, is
  100.   17681, and his default group number, GID, is 100, `users'. The UID
  101.   and GID must be numbers between 0 - 65535. After his real name there
  102.   is his office room at HUT, is work phone and his home phone.  His
  103.   home directory is `users:puhuri', finger searches his `.plan' and
  104.   `.project' files from that directory. Last field is his login shell,
  105.   AmiTCP/IP does not currently use that for anything (the SHELL
  106.   environment variable is set, however).
  107.  
  108.   You can add and remove users simply editing your `passwd' file with
  109.   text editors (Emacs, Ed, Edit). Make sure that finger can parse the
  110.   changed file and finger each user that you have changed.
  111.  
  112.   The passwd file format is mostly compatible with MultiUser by Geert
  113.   Uytterhoeven and with AS225r2 beta from Commodore. But,
  114.   unfortunately, the password encryption methods are different. So,
  115.   you could use an MuFS or AS225r2 password file as a template, but
  116.   you should remove all the password fields, and then use "passwd"
  117.   command to set the passwords again.
  118.  
  119.   The group file, `AmiTCP:db/group' has similar format.
  120.  
  121. * If There are Problems with Installation 
  122.   
  123.   Here is an example of the required information:
  124.  
  125.     The default user name (and login name):    joe
  126.     joe user id:                100
  127.     joe group id:                100
  128.     Real name for the joe:            Joe the User
  129.     joe home directory:            SYS:
  130.     joe shell:                shell
  131.     <in this point joe password is prompted>
  132.     Dynamic connection:            no
  133.     Name of your computer:             slip-2
  134.     Your domain part:             hut.fi
  135.     Aliases for it:             amy
  136.     Interface type:                CSLIP
  137.     Specific network interface:        rhcslip
  138.     Your Internet address:             130.233.161.50
  139.     Destination address (the gateway):    130.233.161.254
  140.     Netmask of used in your network:    255.255.252.0
  141.     Serial device driver to be used:    serial.device
  142.     Unit number for the serial.device:    0
  143.     Serial line baud rate:            9600
  144.     CSLIP MTU:                1500
  145.     Additional rhslip options:        CTS/RTS, EOF-mode
  146.     Address of the default gateway:     130.233.161.254
  147.     Addresses of nameservers:         130.233.224.1
  148.                         130.233.224.13  
  149.                         128.214.4.29
  150.     Domain names to search:            hut.fi
  151.                         cs.hut.fi
  152.     AmiTCP/IP started at system startup:    no
  153.     Let installer modify s:user-startup:    yes
  154.     Start inetd at AmiTCP/IP startup:    yes
  155.  
  156.   From above information Install_AmiTCP creates/modifies following files:
  157.    
  158.   `AmiTCP:bin/startnet' (lines beginning with `;' are comments):
  159.  
  160.     .key IPADDRESS
  161.     .bra {
  162.     .ket }
  163.     .def IPADDRESS 130.233.161.50
  164.     
  165.     ; log in
  166.     echo
  167.     echo login: joe
  168.     AmiTCP:bin/login -f joe
  169.     AmiTCP:bin/umask 022
  170.     AmiTCP:AmiTCP
  171.     WaitForPort AMITCP
  172.     ; Configure loop-back device
  173.     AmiTCP:bin/ifconfig lo0 localhost
  174.     ; Assure that ENV:Sana2 exists
  175.     if not exists ENV:Sana2
  176.       makedir ENV:Sana2
  177.     endif
  178.     ; Create cslip0 configuration file
  179.     echo "serial.device 0 9600 0.0.0.0 MTU=1500 7WIRE EOFMODE" >ENV:Sana2/cslip0.config
  180.     ; Configure cslip0
  181.     AmiTCP:bin/ifconfig cslip0 {IPADDRESS} 130.233.161.254 netmask 255.255.252.0
  182.     ; Add IP address entry for this host 
  183.     rx "address AMITCP; 'ADD HOST {IPADDRESS} slip-2.hut.fi  amy'"
  184.     ; Add route to this host
  185.     AmiTCP:bin/route add {IPADDRESS} localhost
  186.     ; Add route to the default gateway
  187.     AmiTCP:bin/route add default 130.233.161.254
  188.     setenv HOSTNAME `AmiTCP:bin/hostname`
  189.     Assign TCP: Exists > NIL:
  190.     IF Warn
  191.       Mount TCP: from AmiTCP:devs/Inet-Mountlist
  192.     EndIf
  193.     ; Start the internet `super server'
  194.     run AmiTCP:bin/inetd
  195.  
  196.   `Amitcp:db/resolv.conf' (lines beginning with `;' are comments):
  197.  
  198.     ; Name servers
  199.     NAMESERVER 130.233.224.1
  200.     NAMESERVER 130.233.224.13
  201.     NAMESERVER 128.214.4.29
  202.     ; Domain names
  203.     DOMAIN hut.fi
  204.     DOMAIN cs.hut.fi
  205.  
  206.   `S:user-startup' will contain following lines:
  207.   
  208.     ;BEGIN AmiTCP/IP
  209.     assign AmiTCP: HardDisk:AmiTCP-4.0
  210.     path AmiTCP:bin add
  211.     Assign APIPE: Exists > NIL:
  212.     IF Warn
  213.       Mount APIPE: from AmiTCP:devs/APipe-Mountlist
  214.     EndIf
  215.     ;END AmiTCP/IP
  216.  
  217.   Following line was added to the db/passwd:
  218.  
  219.     joe|WexZI/fvHxNdo|100|100|Joe the User|SYS:|shell
  220.  
  221.  
  222. * What Happens in the Installation?
  223.   
  224.   You can run the Install_AmiTCP with "pretend" mode (selected at the
  225.   beginning) to try it out without really installing the AmiTCP.
  226.  
  227. EOF
  228.