
* How to Install AmiTCP/IP

  You should not install the current version on top of older
  version.  If your disk space allows, leave the old version on the
  disk and delete it when you have the new version up and running. The
  installation script will copy your old configuration from old
  version directory.
  
  Extract first the distribution archives (AmiTCP_xxx_xx.lha) to some
  directory in your hard disk (e.g. WORK:).

* Configuration Information
  
  Before you proceed, you should get the following information from
  your network administration (if you don't have the information, you
  have to reinstall AmiTCP/IP afterwards):
  
  * Internet protocol address for your computer. This is a 32 bit
    integer represented as a series of decimal numbers separated by
    dots. For example, 130.233.161.40 is a legal internet
    address. Your IP address can also be dynamic, i.e., different each
    time you connect to the IP network.

  * If you have a point-to-point connection to the network, you need
    to know your destination IP address, that is the IP address of
    the host you are connected. SLIP, CSLIP and PPP are examples of
    point-to-point connections. Generally you can use the IP address
    of your default gateway as the destination address, if no specific
    destination address is given.
  
  * Netmask for your network. This specifies how many bits of your
    internet address are used to specify the network address. Netmask
    is like 255.255.255.0. If your network is not sub-netted, then you
    do not have to supply this value (a default computed from the IP
    address is used).
  
  * Address of the default gateway. If your host do not know any route
    to a host it resorts to the default gateway. If you have only one
    point-to-point connection, you can use the host you are connected
    to as the default gateway.
  
  * Your host name. Host name is a more convenient way than the internet
    address to refer your computer. This is like `Amiga1'. If your IP
    address is dynamic, then you do not need to supply this.
  
  * Domain name of your site. For example, "hut.fi" is the domain name
    for the Helsinki University of Technology in Finland. The part
    after the first dot in your full host name is usually (but not
    always) your domain name. If you are not going to use Domain Name
    Servers, then you do not have to supply a domain either.
  
  * Addresses of the Domain Name Servers which will be used to
    translate host names to the corresponding internet addresses. A
    local database must be used instead if there is no name server on
    your domain.
  
    If you have an access to a Unix machine in your network, you can
    probably find a list of domains and name server addresses in the
    file `/etc/resolv.conf'. Also, if there is no name server, you can
    copy the file `/etc/hosts' to the `AmiTCP:db/hosts'.

  Next you should obtain a SANA-II compatible device driver for your
  network adapter. The SANA-II drivers are usually installed into
  directory `DEVS:networks'. We have included a few freely
  distributable drivers with the AmiTCP/IP. You can use the SLIP or
  CSLIP drivers with a serial interface. See the file doc/slip.doc for
  more info on the provided SLIP drivers.

  AmiTCP/IP uses a mnemonic name of SANA-II device driver to access
  it. The name and parameter mapping is specified in the configuration
  file `AmiTCP:db/interfaces'. You might also have to make a
  configuration file for your device driver. The installation script
  can create configuration files for the SLIP, CSLIP and GGBus+ ISA
  Ethernet interfaces. Configuration files are usually stored into the
  directory `ENV:Sana2/'.
  
  You may start the installation by double-clicking the
  `Install_AmiTCP'-icon.

* About User and Group Databases

  AmiTCP/IP gives some user management support. For each user, there
  is one line of information in the file `AmiTCP:db/passwd', which is
  currently used by `finger', `ls' and other commands.  This line is
  separated to 7 parts with vertical bars (`|'):

username|password|uid|gid|gecos|home directory|shell

  The `gecos' part contains real name, office, office phone and home
  phome numbers separated with commas (',').  You can print them with
  finger. Markus Peuhkuri has following entry in the example `passwd'
  file:

puhuri|*|17681|100|Markus Peuhkuri,G218,4512462,4521992|users:puhuri|shell

  Markus has username puhuri. As the password field contains `*', his
  password is disabled (so he can not log into your machine even if
  the remote login is installed). His numeric identifier, UID, is
  17681, and his default group number, GID, is 100, `users'. The UID
  and GID must be numbers between 0 - 65535. After his real name there
  is his office room at HUT, is work phone and his home phone.  His
  home directory is `users:puhuri', finger searches his `.plan' and
  `.project' files from that directory. Last field is his login shell,
  AmiTCP/IP does not currently use that for anything (the SHELL
  environment variable is set, however).

  You can add and remove users simply editing your `passwd' file with
  text editors (Emacs, Ed, Edit). Make sure that finger can parse the
  changed file and finger each user that you have changed.

  The passwd file format is mostly compatible with MultiUser by Geert
  Uytterhoeven and with AS225r2 beta from Commodore. But,
  unfortunately, the password encryption methods are different. So,
  you could use an MuFS or AS225r2 password file as a template, but
  you should remove all the password fields, and then use "passwd"
  command to set the passwords again.

  The group file, `AmiTCP:db/group' has similar format.

* If There are Problems with Installation 
  
  Here is an example of the required information:

	The default user name (and login name):	joe
	joe user id:				100
	joe group id:				100
	Real name for the joe:			Joe the User
	joe home directory:			SYS:
	joe shell:				shell
	<in this point joe password is prompted>
	Dynamic connection:			no
	Name of your computer:	 		slip-2
	Your domain part: 			hut.fi
	Aliases for it: 			amy
	Interface type:				CSLIP
	Specific network interface:		rhcslip
	Your Internet address: 			130.233.161.50
	Destination address (the gateway):	130.233.161.254
	Netmask of used in your network:	255.255.252.0
	Serial device driver to be used:	serial.device
	Unit number for the serial.device:	0
	Serial line baud rate:			9600
	CSLIP MTU:				1500
	Additional rhslip options:		CTS/RTS, EOF-mode
	Address of the default gateway: 	130.233.161.254
	Addresses of nameservers: 		130.233.224.1
						130.233.224.13  
						128.214.4.29
	Domain names to search:			hut.fi
						cs.hut.fi
	AmiTCP/IP started at system startup:	no
	Let installer modify s:user-startup:	yes
	Start inetd at AmiTCP/IP startup:	yes

  From above information Install_AmiTCP creates/modifies following files:
   
  `AmiTCP:bin/startnet' (lines beginning with `;' are comments):

	.key IPADDRESS
	.bra {
	.ket }
	.def IPADDRESS 130.233.161.50
	
	; log in
	echo
	echo login: joe
	AmiTCP:bin/login -f joe
	AmiTCP:bin/umask 022
	AmiTCP:AmiTCP
	WaitForPort AMITCP
	; Configure loop-back device
	AmiTCP:bin/ifconfig lo0 localhost
	; Assure that ENV:Sana2 exists
	if not exists ENV:Sana2
	  makedir ENV:Sana2
	endif
	; Create cslip0 configuration file
	echo "serial.device 0 9600 0.0.0.0 MTU=1500 7WIRE EOFMODE" >ENV:Sana2/cslip0.config
	; Configure cslip0
	AmiTCP:bin/ifconfig cslip0 {IPADDRESS} 130.233.161.254 netmask 255.255.252.0
	; Add IP address entry for this host 
	rx "address AMITCP; 'ADD HOST {IPADDRESS} slip-2.hut.fi  amy'"
	; Add route to this host
	AmiTCP:bin/route add {IPADDRESS} localhost
	; Add route to the default gateway
	AmiTCP:bin/route add default 130.233.161.254
	setenv HOSTNAME `AmiTCP:bin/hostname`
	Assign TCP: Exists > NIL:
	IF Warn
	  Mount TCP: from AmiTCP:devs/Inet-Mountlist
	EndIf
	; Start the internet `super server'
	run AmiTCP:bin/inetd

  `Amitcp:db/resolv.conf' (lines beginning with `;' are comments):

	; Name servers
	NAMESERVER 130.233.224.1
	NAMESERVER 130.233.224.13
	NAMESERVER 128.214.4.29
	; Domain names
	DOMAIN hut.fi
	DOMAIN cs.hut.fi

  `S:user-startup' will contain following lines:
  
	;BEGIN AmiTCP/IP
	assign AmiTCP: HardDisk:AmiTCP-4.0
	path AmiTCP:bin add
	Assign APIPE: Exists > NIL:
	IF Warn
	  Mount APIPE: from AmiTCP:devs/APipe-Mountlist
	EndIf
	;END AmiTCP/IP

  Following line was added to the db/passwd:

	joe|WexZI/fvHxNdo|100|100|Joe the User|SYS:|shell


* What Happens in the Installation?
  
  You can run the Install_AmiTCP with "pretend" mode (selected at the
  beginning) to try it out without really installing the AmiTCP.

EOF
