1-28-97              **************************************       1-28-97
                     |                                    |
                     | KGMD STEP BY STEP, EASY TO INSTALL |
                     |             K.ELLIS                |
                     |                                    |
                     ************************************** 

=-=- FIRST -=-=

(1) Get KEMD.ZIP, unzip it, then very carefully read all the texts BEFORE
    proceeding.
(2) Get INSTFLPY.ZOO.
(3) Get the whole folder BASIC.
(4) Get the whole folder NET.

*Note* if the link from my page is too slow to get the files with
CAB/Lynx, try the direct Ftp address. Or try the ftp  nic.funet.fi

(5) Put all these files in one folder, called KEMD for instance.

Thus it will be like:

any GEMDOS (atari) partition\KEMD\basic.aaa
                                  basic.ab
                                  basic.ax
                                  net.aa
                                  net.ab
                                  net.ax
                                  instflpy.zoo
		  
(6) Now on C drive, or your boot drive, create a folder called multitos.
    (Leave it empty for now)

(7) Unzoo the file INSTFLPY.ZOO in the folder KEMD with -e as parameter.
    (-e is to expand the archive).

(8) Replace the files from the KEMD.ZIP into the main folder KEMD.
    Thus the files, SETUP, MINT.CNF, KGMD.TXT and README.NOW.

(9) Make sure your boot was clean, meaning no extra auto programs or 
    accessories loaded at boot time.

(10) Run the program KGMDINST.TOS by double clicking on it.
    (A few questions will be asked)

=-=- Questions Asked -=-=

This is self explained, so no need to spend an hour on it.

(*1) Hostname is just the name of your machine, call it whatever 
     you like, "Falcon" or "Station1" for instance ... You choose..

=-=- Next -=-=

(1) Copy the correct MINT.PRG depending the machine you have from 
    minix/boot to your boot partition (usually C) /auto.

(2) Copy the content of the minix/boot/multitos folder into the 
    /usr/multitos folder.

(3) Rename the file MINTKGMD.CNF into MINT.CNF in the /usr/multitos 
    folder.

**NOTE** When I say MINIX, I mean the partition that KEMD would have 
         created during the installation.

(4) Now you can Reboot.

(5) Check that MINT.PRG is at the end, in the auto folder.
    (use autosort.prg to resort your auto folder if you need)

=-=- OPTIONAL: Installing an AES -=-=

(1) Copy the AES on C. (to be more practical).

(2) Edit the file C:\MULTITOS\MINT.CNF
    Add the lines SETENV AESDIR c:\your aes folder path. 
     (not the executable, just the path.)
    Add all the other setenv that you know, for instance if you use the 
    excellent desktop THING, you should add the line:
    setenv THINGDIR path of THING directory (not the executable again, 
    just the directory where THING.APP is located)

(3) You should add on to the line setenv PATH \bin;\usr\ucb these paths 
    more, ;\sbin;\etc;\usr\sbin;\usr\local\sbin;\usr\local\bin

(4) You might also want to remove the drive A from U drive by adding the 
    line: ren u:\a u:\.a
    This will rename the drive a into .a , therefore U drive will not 
    ask for a floppy everytime you open U drive.

(5) Change the line cd u:\ by cd c:\
    and the line INIT has to be with regular partitions, not the minix 
    one. For instance INIT=c:\multitos\init.prg instead of the u path.

**NOTE**: save the files MINT.CNF with the standard IBM/ATARI standard
(CR+LF). (from now on, for every UNIX files, you have to save the files
without the CR, so find the option in your text editor where you can 
save in LF only(unix standard))

(6) Edit the CNF file of your AES to set it up correctly, like some paths etc.

(7) reboot with mint

(8) edit the passwd file with vi editor: type vi /etc/passwd to do that.

**NOTE** vi is a tricky text editor the first times you use it. 

(9) In this file change all the names tcsh or sh to bash. Bash would 
    be easier to load the AES (windows style vs text based) the first 
    couple of times. 

(10) Reboot again in Mint. (the changes you made will be effective that 
     way)

(11) To load the AES, be on the CONSOLE (alt F10), login as root and 
     type the path+aes.sys (actually it could be any aes, n_aes.sys or 
     gem.sys or whatever the aes you use)

**NOTE** The aes is only loadable from the CONSOLE(alt f10).

**NOTE** Your atari is separated into Virtual consoles and one main 
         CONSOLE. The V.consoles are accessible by typing alt f1 to 
         alt f9. The CONSOLE is on alt f10.
         
         If you didn't edit the /etc/ttytab file yet, you only have 2 
         V.consoles available + the CONSOLE. You can change that to add 
         more. Copy the driver you want from 
         minix partition/boot/multitos into the bootdrive/multitos, for 
         instance PPP requires the drivers socket.xdd and slip.xif. The 
         driver minix.xdd being previously copied should stay there also.

** TIP **

If you want to load the AES directly launchable from the login prompt 
in the console, add the following line in the file /etc/passwd.
gem::0:0:The AES:/home/root:/full path of the aes with the executable. 

Thus, typing gem at the prompt as login it will load the aes 
automatically without even asking for a password.

**NOTE** The AES user is considered as root and has the same power and
         privilege.


=-=- OPTIONAL: How to setup PPP -=-=

(1) From the folder /etc/ppp/samples, copy the file home-dot-ppprc into 
    /home/root and rename it as .ppprc

(2) Copy the file chat-script also into the folder /home/root and rename 
    it .chat-script.
(3) you have to change the protection of this file, type:
    chmod 600 .chat-script

=-= Edit the file .ppprc to fit your setup =-=

(A) You should change the modem port:

-If you have your modem in the modem 1 port then the port would be from 
now on /dev/ttya

-If you have your modem in the modem 2 port then the port would be from 
now on /dev/ttyb

(B) Adjust the speed of your modem. 

(C) You need to call your internet provider and ask them for the MTU 
    and MRU for your PPP account. Most of the time it will be 1500 or 
    1006. And most of the time MTU=MRU. 

    If nothing else is added in this file, the default values would be 
    MTU=MRU=1500. 

If you have a provider with values=1006 like me, you have to add the 
lines in the .ppprc file:
MTU 1006
MRU 1006

**NOTE* The MTU value is not necessary the same if you connect as 
SLIP or PPP. So if you asked the MTU to your provider for SLIP, it 
could be a different number with PPP, ask them again, 
but now ask for PPP !!! ;)
 

=-= Edit the file /home/root/.chat-script =-=

(A) change the atd by your regular command that you type to connect to 
    your provider. 
    (For me it's ATDT354900 for instance)
    (This number is a telephone number by the way.. Just to make sure...)	

(B) Now the tricky part, try to know the login sequence and how to 
    engage the PPP protocol.

For me, I have to type my login name with a P in front of the login name
to set the protocol to PPP, but some providers expect you to type PPP 
for protocol. Just use a terminal program, dial the telephone number and
see how the provider login sequence works.

**TIP** 

Don't enter the whole line expected. For instance, if your provider 
says login or password, don't use the whole name, just cut the start, 
otherwise it could not login correctly..

for instance:
ogin: your login name
ssword: your password	
rotocol: PPP
 
 or another example, 

ame: your login name
key: your key
rotocol?: PPP

 or without the protocol line if it asks you to login as Plogin like 
 I said.

For example, mine is:

ogin: Pkellis              <- even if my login name is only kellis,
                              the P means that it will start the 
                              session with PPP protocol
ssword: my password


=-= Setting up resolv.conf =-=

(A) rename the file /etc/resolv.conf.sample as /etc/resolv.conf.
    In this file should go the domain name and their DNS number. 
    you have to ask your provider for this.

For instance, mine is: domain primenet.com
                       nameserver 198.68.32.10

**NOTE** You can NOT invent or create this number yourself! 
         You have to ask your provider. 

(B) Rename the file /etc/domainname.sample to domainname.

(C) Edit it and replace your domainname. it should be at the end of your 
    email address most of the time.

for me it should be primenet.com

if your email address is joe@aol.com, then you should put aol.com as 
domainname.

(D) Do a symbolic link from the V.console between /usr/etc/inetd and 
   /etc/inetd  by typing: ln -s /usr/etc/inetd /etc/inetd

(E) Now, edit your /etc/rc.net.
The two lines with ifconf and route add must be edited into that:
  
  ifconfig lo0 addr 127.0.0.0 up
  route add 127.0.0.1 lo0

leave the rest like it is.
( for some reason, KGMD switched the 2 addresses)

=-= Checking to see if PPPD is working =-=

(*) (re)boot into mint, 

(A) login as root in a V.console ( alt F1 for instance).

(B) Type pppd

(C) See if the modem connects or not.. (pppd is a program, the dialer
    for PPP actually.)

(D) if it connects, look into the CONSOLE (alt F10) to see the log 
    sequence. If it is successful, it should give you 2 different 
    addresses, local and remote..:)

**NOTE**: The log file for the PPP connection is in /var/log, like 
that you can trace the history of your PPP connection.

(E) Edit the file /etc/hosts

It should be:  127.0.0.0 localhost loopback lo0 loghost
               127.0.0.1 hostname

(the hostname being the hostname you took before, Falcon for me or 
Station1 or whatever you took, see (**NOTE**)) so replace the hostname
there by the one you chose.


=-=- How do I know if my setup works? -=-=

1) try to ftp from the Vconsole 1 (alt f1).

to do that, type: ftp ftp.cnam.fr  and see if it does anything..

login : anonymous
password: your email address.

(A) if that works you can go into the directory /pub/Atari and get cool 
    software for the internet, irc II, gopher, lynx Aftp in GEM, etc etc..

(B) if it doesn't work, you'll have to mess with the files more..:(

(2) try to type:  finger your email address and see what it says..


*=-=- Troubleshooting -=-=*

(P) The modem won't even dial

(A1) reboot again without hsmodem and see if it's better.
     if HSmodem was the problem then you need to find the good order
     in the auto folder.

(A2) try to see if the modem itself is well configured..
     By typing at&v in a terminal program like ConNect or Stalker, it 
     should give you all the information about your modem. Check with 
     your modem manual.

(P) Everything is fine but I can not use ConNect or stalker with mint..:(
    what should I do?

(A) Well, the ports are redirected with mint from the boot 
    partition:\multitos\mint.cnf file, with the command ren modem2 ttyb 
    for instance. Let say that conNect really wants to see the modem2 
    available to be able to work, then just don't use the command ren 
    that will rename it totally, but replace it by sln instead, like 
    that it will create a link between modem2 and ttyb, thus keeping 
    the modem2 available and ttyb that mintnet needs.

(P) KGMDINST.TOS locks up when creating a minix partition

(A1) If it locks up in the middle, I've found that it seems to trash
     the partition. Though this is not the case all the time. If it is,
     It has to be rebuilt (ICD's ICDFMT.PRG for instance)

(A2) If you are creating a minix partition over an already exhisting 
     minix partition and it gives you /minix/: permission denied, then
     you will also have to rebuild the partition before attempting to
     install again. (This will be listed with it displays the partition
     contents to you)

***NOTE*** Rebuilding the partition.  I use ICD PRO's ICDFMT.PRG to do 
this myself. Basically, you have to find a way to turn it back into a
GEM/BGM partition (with completely rebuilding the FAT, etc) 


=-=- UPGRADE -=-=

Now, Mintnet should be installed... but only version 0.7.
You might need to upgrade it. (recommended actually)

(1) Replace the file PPPD in the folder /usr/etc by the new one given 
    with this doc.. (pppd = dialer)

(2) Replace the new slip and socket files given with this doc 
    in the folder c:/multitos .

Here you go, mintnet 1.01 is installed now. :)


=-=- MISC -=-=

***NOTE*** 
If you want to use CAB or the other STIK prg, just get GLUESTIK and 
install it. Programs like Duftp or Aftp don't require Gluestik, by the 
way.

** TIP **
If you want to bypass the filesystem check at bootup to gain speed, 
you can do it by adding the line: touch /etc/fastboot in the 
file /etc/rc.local and reboot twice (or if you can create a null file 
fastboot in the folder /etc then you just need to reboot once, but still
the line touch in /etc/local.rc is needed.)

*NOTE* The command touch filename, create an empty file like mkdir 
would create a folder.

At the boot up sequence, the system looks for a file called fastboot 
in the folder /etc. If it finds it, it will bybass a lot of tests.

**NOTE** the mint.cnf given with the KEMD package is only meant to be used 
by the INSTALL.TOS prg..
**NOTE** on a machine <4 meg of RAM, try to avoid things like NVDI and 
big accessories.

=-=- A few commands in the UNIX world -=-=

- The TAB key is an automatic completion.
if you type for instance cd /etc/ali [press TAB key]
It will complete the ali by aliases. Try it you'll understand. 
-cd to change directory.
cd .. to go up in the tree.
cd / will go at the root of your unix partition..
so for instance if you are in the directory u:/usr/local/bin/ and you 
want to go in the directory u:/bin just instead of having to go up in 
the tree by typing cd .. cd .. etc, just type cd /bin
test it you'll understand...

-ls to display what's in the folder.
like the command dir under MSDOS.

-cp is to copy a file, just use it like that: 
cp path+filename source path+filename destination
for instance: cp text.txt /usr/local/text.txt

-mv is to move files, used like cp.

-chmod xxx filename is to change the protection level of a certain file or folder

-ln -s path\file1 path\file2  is used to make a symbolic link.
It will copy the file at the other path without taking the same 
amount of hard drive space :) thus you can have a 1 meg prg linked 
everywhere on your hard drive and still take a very small amount of disk space..
Very useful.

-free to see the memory (RAM) and the block of free RAM.

-ps to see the prg installed (the PID,STATUS, Size, time, name etc..

-kill pid will terminate/kill/exit the prg associated with the pid read 
with ps. for instance kill 68 , if 68 is the PID associated with the 
control panel then it will close this accessory.

-top to see the presently running programs in real time.

-rm filename to delete a file.

-rm -r folder to delete a folder.

-vi filename to call the vi text editor with the filename as file to edit
or create.

-gunzip filename.tgz to unzip a tgz file. The result would be 
filename.tar

-tar -xvf filename.tar to untar the tar archive..Thus to have the 
original files.

**NOTE** For the other commands you should open the /bin folder and see what are 
the prg and try them or with --help as parameter. For instance ls is 
more powerful then we could imagine, type ls --help to see the help 
associated with it.. For the other commands, a unix manual would also 
be helpful.

Any comments to kellis@primenet.com

Personnal thanks to the author of KGMD, SWE, LP, Matrixx and the others on
IRC.

