                 Installation document for TNET 4.0
                     07/17/92 revised 04/12/93
               by Michael Temari (temari@temari.ae.ge.com)


OBTAINING TNET

obtain the compress tar file of TNET (tnet4.tar.Z)
- can be anonymous ftped from ???
- I can ftp it to you or
- I can mail it uuencoded in several parts :-(


login as root


PUT TNET DISTRIBUTION ON SYSTEM

uncompress the TNET compressed tar file
- compress -d tnet4.tar.Z    or    uncompress tnet4.tar.Z

make a directory for the TNET distribution
- mkdir /usr/TNET4 (or whatever you want)

change to the TNET directory
- cd /usr/TNET4

untar the TNET tar file
- tar xvf /usr/tmp/tnet4.tar (or where ever it is)


INSTALLATION STEPS (see Makefile for details)

1. Install the patches in the os_patches directory
   (I recommend all of them)

2. In the TNET directory type: make TNET
   (this will compile all of TNET)

3. In the TNET directory type: make INSTALL

4. Modify configuration files located in tnetdir

5. Add the tnet bin directory (currently /etc/tnet/bin) to PATH 

NOTES:
On my system ALL programs compile clean with the ack compiler

In Makefile change tnetdir to where you want TNET to run (currently /etc/tnet)
  also must be changed in other files (do a grep looking for /etc/tnet)

In lib/inet/Makefile you can change OPTS to what your system needs
  NETWORKED will enable name server lookup if /etc/tnet/resolve.conf exists



CONFIGURATION FILES

modify configuration files to suit your needs:

startup
 contains a shell script to bring up the TNET kernel
 in this file you need:
 o start tnet: tnet your-host-ip-address &
 o set host name: hostname -S
 o change ip values(if needed): ip ttl value
 o change tcp values(if needed): tcp [mss | window] value
 o attach devices: attach ...
 o add routes: route add ...

tnet.hst
 contains your machines host name on line 1 and domain name on line 2
 the TNET kernel is notified of your name with the hostname -S command

tnet.cfg (inetd.conf will take its place when finished)
 contains server startup information for the TNET kernel(soon to become inetd)
 in this file you can start either internal or external servers
 o start internal echo server: echo
 o start internal discard server: discard
 o start external servers: server tcp port-number program-to-run

hosts
 contains ip address and host names
 when gethostbyname is called it checks this file to find the ip address
 if the inet library is not compiled with the -DNETWORKED option

resolv.conf
 contains name server information
 when the inet library is compiled with the -DNETWORKED option the
 call to gethostbyname will attempt to resolve the address by querying
 the name servers contained in this file
 o to list a name server: nameserver ip-address
 o to setup domain search names: search domain-name [domain-name ...]

smtp.cfg
 contains mail relay hosts information
 this file is read by the smtp program and for each entry which consists
 of uucp-host-name mail-relay-host all mail in the spool directory
 destined for the uucp-host-name will be forwarded via smtp to the
 mail-relay-host

dial-up
 contains sample dial script for attach command
 o to send a string: send white-space string
 o to wait: wait white-space seconds
 o to wait for a string: wait white-space seconds white-space string
 [NOTE: white-spaces refers to space or tab]
 [NOTE: escaped characters work (i.e. \r for return, \n for newline, ...)]
 [NOTE: the dial script is the last parameter to the attach slip command]


Hope this helps,

Michael Temari                                 temari@temari.ae.ge.com
