- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -  
Disclaimer: 
 
The programs contained on the following diskette are Public Domain.  The 
Toronto Atari Federation (TAF) takes no responsibility for any of the  
Programs or any problems encountered while using them.  (Use at your 
own risk.) 
 
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -  
	MINT - X Windows - SLIP/PPP - Chimera - Telnet - FTP  
        		  Version 1.1 (BETA)   		  95/04/23 
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -  
 
Before you run the installation procedure, please read the following 
instructions CAREFULLY. 
 
Requirements: 
------------ 
(1) 4M RAM 
(2) 10M (Min) SEPARATE Hard Disk Partition (other than your boot 
    partition) 
(3) An Internet Service Provider with PPP - SLIP acceptable but 
    untested. 
(3) Mono Graphics mode (ST High, Falcon, TT High) 
(4) ST UNZIP Program, TOS/GEM based text-editor (recommend: VI.TTP) 
 
Recommendations: 
--------------- 
(1) 14.4 Modem - Appropriate Modem RTS/CTS patch 
(2) A Boot manager (SuberBoot, XBoot, etc.) 
(3) Recent version of ADHI (or other Hard Disk Driver)
    (Tested: AHDI 6.061, ICD 6.4.2) 
(4) Knowledge of UNIX, VI editor:  Not essential but useful. 
 
Testing: 
------- 
This system has been tested on the following system. 
	1040 STe	- 4M RAM, SyQuest 44, ST High 
	TT030   	- 12M RAM, SCSI drive (external), TT High 
	Falcon		- 4M RAM, Internal HD, ST High 
	
On all machines ADHI 6.061 was used and we connected to two different 
Internet Providers with a dynamic PPP connection (Internex Online and  
the University of Waterloo). 
 
Backup: 
------ 
It's always a good idea to backup your HD regularly.  While we 
performed this procedure several times without incidents we would 
feel more conformable if you have a backup of your system.  At 
the very least make a backup of the Partition you will be overwriting 
with the MINT environment.  
 
Also If you already have any MINT programs in your AUTO folder copy  
them to another sub-directory (not c:\mint) as this installation 
procedure will copy MINTNP.PRX into your AUTO folder. 
 
Note: 
ST_UNZIP.TTP - is meant to be any generic UNZIP program.  (For our 
testing we used ZIPJR.TTP.) 
 
 
Installation: 
------------ 
(1) Backup your system (Last Warning!) 
 
(2) You need to run ST_UNZIP.TTP.  Please, copy ST_UNZIP to your C:\.  
 
(3) Copy the file INSTALL.ZIP from the Disk 1 (720K disks) or Disk 3 
    (1.44M disks) to C:\. 
    Start up ST_UNZIP and at the TTP prompt enter: -x -r C:\INSTALL.ZIP.  
    The program will copy the following files to C:\ on your hard drive. 
 
	c:\auto\mintnp.prx	c:\gzip.ttp 
	c:\mint\minix.xfs	c:\minit.ttp 
	c:\mint\oslip.xif	c:\mint.cnf 
	c:\mint\plip.xif	c:\mkdir.ttp 
	c:\mint\slip.xif	c:\setup 
	c:\mint\sockdrv.xdd	c:\setup144
				c:\tar.ttp 
        			c:\tcsh.ttp 
 
(4) When completed, you can delete the files INSTALL.ZIP and 
    ST_UNZIP.TTP from C:\.  Then go to the AUTO folder and rename the 
    program  MINTNP.PRX to MINTNP.PRG.  Reboot (Read the NOTES below 
    first). 
     
    Notes: If you don't already use a boot manager we would recommend 
	   you setup one before rebooting. This will make it MUCH easier to  
	   control whether you boot into TOS or MINT in the future. 
           
           If you're using a Boot Manager setup a configuration to 
	   startup the program C:\AUTO\MINTNP.PRG.  (If you have the 
           modem patch program make sure it loads before MINTNP.)  
           Other than a modem patch and Mint itself, NO other TSRs, 
           screen accelerators, etc need be loaded.  You will be using 
           the MINT parition almost exclusively under X windows 
           (although you still have access to all your other 
           paritions) and a disk cache is built into the file system 
           driver so you do not need another one.  It doesn't hurt but 
           it takes up unecessary memory.
 
(5) You should boot into the MINT environment and arrive at a pound(#)  
    prompt. (Note: There will be NO visible cursor.)  The next step is 
    to run a shell script called setup.  The setup script expects one 
    parameter which is the drive letter you are selecting to make into a  
    MINT partition.  After it setups that partition, for MINT, the 
    script will prompt you to insert diskettes 2 through 7 (720K) or
    disks 2 and 3 (1.44M) at the appropriate times.  These 
    diskettes will copy on the rest of the X-Windows environment. 
     
    LAST WARNING - this will erase all information currently stored on  
    the partition you select.  Be careful to enter the correct drive 
    letter.   
 
    To run the setup script at the pound(#) prompt enter the following 
    command:  (Note: the leading # is to represent the prompt you see  
    on your screen. Don't type it in!) 
 
	    	# source setup f     (if you have the 7 720K disks)
	   OR
	        # source setup144 f  (if you have the 3 1.44M disks)
 
    In this example drive f would be setup as a MINT partition.  (Note 
    partition f will now only be accessible via MINT.  Don't try to copy 
    files to or from this drive while using GEM/TOS - you will 
    however be able to access this partition in a limited way from 
    MultiTOS since it runs over MINT.) 
     
(7) After Disk 7 (720K) or Disk 3 (1.44M) the pound(#) prompt reappears,
    enter the command 'exit'.   
     
    If the message "Fatal MINT error: adjust debug level and hit a key.."  
    appears.  Ignore it and reboot to GEM/TOS.  This is where having a 
    Boot Manager is extremely useful.  
  
 
(8) Using your GEM ASCII editor modify the C:\MINT.CNF file.  Remove the 
    pound(#) signs from the start of the following lines: 
 
... 
#setenv PATH .,\bin,\usr\bin,\usr\local\bin, ... ,\usr\local\bin\X11 
... 
#setenv SHELL \bin\sh 
... 
#sln f:\usr\bin u:\bin 
#sln f:\etc u:\etc 
#sln f:\usr u:\usr 
#sln f:\home u:\home 
#sln f:\tmp u:\tmp 
#sln f:\var u:\var 
... 
#exec \usr\bin\X11\kbd 
#exec \usr\bin\X11\pty 
#exec \usr\bin\X11\pty     <--- Don't remove the # on this line. 
#INIT=\usr\bin\X11\xinit 
... 
 
(9) Go back to the following lines and chance the f: reference to the 
    drive letter your MINT partition is located on: 
 
... 
sln f:\usr\bin u:\bin 
sln f:\etc u:\etc 
sln f:\usr u:\usr 
sln f:\home u:\home 
sln f:\tmp u:\tmp 
sln f:\var u:\var 
... 
 
(10) Finally place a pound(#) sign at the start of each of these line.  
 
... 
cd \c 
setenv PATH .,\c 
setenv SHELL \c\tcsh 
INIT=c:\tcsh.ttp 
... 
 
(11) That's it, save the ASCII file back to C:\MINT.CNF.  Then reboot 
     into MINT.   
 
Congrats: 
--------      
You have completed the installation.  After you reboot MINT will startup 
and then X-Windows will start.  On the way to starting up X-Windows 
you'll see the message:  'Couldn't open RGB_DB '/usr/lib/X11/rgb' 

This is normal, ignore the message.  X-Windows should startup (you will 
see a X cursor on the screen).  After a moment the Virtual Window Icon will 
appear in the lower right hand corner.   The Virtual Window application
allows you to have a 1280 by 800 (almost TT High) resolution screen on 
the smaller screen of ST High. 
 
Also you'll see the date and time and the words "homer syslogd: 
restart".  What we have done, to start, is spooled system message to 
the console.   This is to help you configure your PPP connection.  
Once you have your PPP connection setup correctly edit the file 
/etc/syslog.conf and change the references /dev/console to /dev/null. 
 
Your UNIX Environment: 
-------------------- 
The installation procedure setup a mini-UNIX like environment on your 
system.  Here is a directory tree of what the system looks like: 
/ 
	/etc	 
		/ppp 
	/home 
		/docs 
			/chimera 
			/minix.fs 
			/mint 
			/mintnet 
			/network 
	/tmp 
	/usr 
		/bin 
			/X11 
				/fvwm.modules 
		/etc 
		/lib 
			/X11 
				/Chimera 
				/app-defaults 
				/bitmaps 
					/100dpi 
					/75dpi 
					/Speedo 
					/misc 
				/fonts 
		/local 
			/bin 
				/X11 
		/spool 
			/locks 
		/ucb 

From within MINT you can access your other drive partitions by changing 
directory to the drive letter.  For example cd /c or cd /d.  Just using 
cd with no parameters will return you to the /home directory.  We've 
also setup an alias called dir which is the UNIX command ls -F. 
 
 
Using X-Windows: 
--------------- 
We could write books, each, how to use the MINT(UNIX), tcsh, X-Windows, 
PPP, Chimera, FTP, and Telnet.  But we assume for most users they'll 
just want to use this environment to connect to the World Wide Web(WWW).  
If you want to learn more about UNIX, X-Windows, etc. check out your 
favorite Computer Book Store. 
 
On our system there are two menus available.  The Xwindows Menu contains  
the following options: 
 
	Xvt [tcsh]	This will startup a window with a tcsh shell. 
       			From there you can configure the entire MINT 
			environment.  (To close this window type exit)  
	WEB Browser*	This will startup Chimera, a WWW browser.  The  
			default startup page is TAF's Home Page. 
  	FTP archives*	This is a list of popular Atari FTP sites.  If 
        	     	you choose one a FTP window will open and the 
                     	system will attempt to connect to that FTP site. 
	Telnet*		Selecting this will open a Telnet window from 
      			there you can connect to any Internet system. 
	FTP*		Like FTP Archives this starts up a FTP Window 
      			only it doesn't connect to a particular service. 
	Connect		This will uses your /usr/ucb/ppp144 (select modem) 
       			and /usr/ucb/chatfile (for PPP) to connect to 
     			your Internet provider. 
	Disconnect	This will close down your session with your Internet 
       			provider. 
 
* indicates you must be connected to an Internet provider to fully be 
able to use this feature. 
 
The second menu contains the following options.  (We're not going to go 
into any depth on these): 
 
	Move		Move a Window 
	Resize		ReSize a Window 
  	Raise		Move a Window to the top 
	Lower		Move a Window down 
	(DE)Inconify	Changes a Window to an Icon or an Icon to a Window 
	(UN)Maximize	Maximize the select Window or UnMaxizes it. 
	(UN)Maximize	Ignore for now 
         Vertically 
   	Delete		Closes a Window 
 	Refresh Screen	Refresh the Screen.  Use this to cleanup the console 
       			messages, etc when debugging the PPP setup. 
	Exit Fvwm	Exit from the X-Windows environment. 
   	Modules	 	Ignore for now. 
 
So how do you get these menus?  The Xwindows Menu will appear When you 
select the left mouse button and hold it down.  The Windows Ops Menu appears 
when you hold down the right mouse button. 
 
To select one of the options.  Move the cursor to the desired option 
(while holding down the button) and release the button when the cursor is on 
the desired option. 

The file which controls what your menus look like and how big your 
virtual screen is is called /home/.fvwmrc  - it is the window manager 
configuration file.  For those of you unfamiliar with Unix, the file 
does exist even though you won't see it when you do an 'ls' or 'dir' 
in the /home directory.  This is because filenames that begin with a 
period are hidden files - they exist but only show up in directories 
if you add the -a flag to your ls or dir command.   You can edit this 
file by typing 'vi .fvwmrc' when you're in the /home directory.  MAKE 
SURE you have read the Appendix on using vi first if you are not 
familiar with it! The .fvwmrc file is well commented - it is up to you 
to figure out changes you want to make.
 
Getting Started: 
--------------- 
To use the Internet tools (FTP, Telnet and Chimera) you are going to 
need to connect to an Internet provider.  (We recommend you use a 
provider with a dynamic PPP connection). 
 
Your system is currently setup to connect, via Modem 1, using PPP for 
Internex (a local Toronto Internet Provider).  Of course the username
and password provided in the scripts will not work as they are bogus 
but the scripts do provide an easy example to follow.
 
If you are using a serial port other than modem 1 (eg:  Falcon uses 
Modem 2, TT you have several choices) you need to start up an Xvt Window 
and edit the file /usr/ucb/ppp144.  At the end of the first (and only) 
line in this file you will see /dev/modem1 - you can change it to one 
of the following values:

/dev/modem1 - ST, STe standard modem port, Mega STe, TT Modem1 port
/dev/modem2 - Falcon stardard modem port, Mega STe, TT Modem2 port
/dev/serial1 - TT Serial1 port
/dev/serial2 - Mega STe, TT Serial2 port

---------------------------------------------------------------------- 
Aside: 
 
HINT:  Wondering why we choose tcsh as our shell?  tcsh has the ability 
to complete the file name whenever you hit the tab key (if you've 
specified enough information).  So at the /home prompt you could type in  
cd /usr/ucb/pp  (and then hit TAB).  The system will fill in the rest 
of the file name.  You can do as you work down sub-directories.  Try the 
following: 
		cd /us (TAB) l (TAB) X (TAB) b (TAB) 1 (TAB) <Enter> 
If you issue the command dir you should be in the directory 
		/usr/lib/X11/bitmaps/100dpi 
 
----------------------------------------------------------------------- 
 
IMPORTANT NOTE:  UNIX is a CASE sensitive environment.  So you MUST 
enter the file/directory name ExAcTlY as shown. 
 
----------------------------------------------------------------------- 
 
To edit a file we recommend using vi.  If you're not familiar with vi 
check out Appendix A.  vi ppp144 and find /dev/modem1. Change modem1 
to the appropriate serial port you want to use.  Then save the file. 
 
Next you need to setup the chatfile (found in /usr/ucb).  If you happen 
to be connecting to Internex Online.  All you need to change is userid 
to your Internex Id and password to your Internex password.  The capital 
P before userid is to indicate to IO you want to connect as a PPP 
terminal. 
 
Otherwise you should consult the PPP documentation.  The chatfile works 
by you giving it a command and telling it what to do when it gets a 
certain result.  For example if you issue ATDT123-4567 and get a NO 
CARRIER message what should it do?  This is where the system log 
appearing on your console will be extremely useful in debugging this 
chatfile.  The chatfile which is used when you choose 'Connect' from
the menu is /usr/ucb/chatfile.  The documenatation on how to set up
a chatfile is in /home/docs/network.

(We hope to better document this section in future releases) 
 
To configure the baud rate and flow control edit the file /etc/ppp/options. 
We have set up 19200 as the default baud rate but if you're running 
on a Megat STe, Falcon, TT, or modeified/accelrated ST you may want to
increase this - NOTE: MiNT so far only recognizes up to 38400 baud, I 
am trying to fix this.

To configure the domain and nameserver edit the files: /etc/resolv.conf.  
Your Internet Providercan provide this information - ie they will 
give you an IP address for your nameserver and their domain name when 
you ask to have a PPP account.  The example file format is very clear:

domain _DOMAIN_NAME_
nameserver _IP_ADDRESS_
 
 
 
Currently Only Partial documentation: 
------------------------------------- 
 
FTP - File Transfer Program 
--- 
At the ftp prompt enter the command: 
	open ftp.host.name.etc 
Now when you get a file it will be stored on your Hard Drive directly 
 
To sign on as anonymous enter either anonymous or ftp at the userid 
prompt and for your password enter your Internet E-Mail address. 
 
To exit ftp enter the command quit. 
 
Telnet 
------ 
Allows you to connect to computers around the world.  At the prompt 
enter: 
	open shell.io.org 
Then sign on using a userid you have on that system. 
 
To exit Telnet enter quit at the Telnet prompt. 
 
Chimera 
------- 
 
Is a World Wide Web Browser.  Once connected you can connect to URL's ,
FTP and Gopher sites.  We've include a few of our favorites to start.  
When you startup Chimera a local version of the TAF home page appears 
(you can start Chimera without being connected to see this page).  From 
the TAF page you can get to numerous Atari Related pages. 
 
WWW browser works on the idea of presenting text and graphics with 
certain keywords underline.  The underlined words are Hypertext points 
which when clicked upon will send a request across the Internet and a
HTML (HyperText Markup Language) file is sent from that site to your
Computer.  The WWW Browser then displays the HTML file.  (An example
is the TAF page you see).  From that page you cn then go to other
pages and so on..
 
If you know of a specific page you want to go to click on the Open
button and type in the URl address.

The Home Button will return you to your Home Page.  Currently set
to the TAF page included in these diskettes.

Back returns you to the previous page you just came from.

Source will allow you to see the original HTML file.

Reload request the same page again.

File is to save a copy of the HTML file.

BookMark is a place where you can store your favourite URl's
so that you don't have to remember the URL or how you got there.
We've included some of our favs.

To exit Chimera, click on the Quit button.
 
All these buttons are explained in the Help screen.

When you're completed using the net you should choose the Disconnect 
option on the Xwindows pull down menu. 
 
 
				Appendix A 
				========== 
 
When you first startup you Xvt window you should issue the command 
resize.  This will help vi size the window correctly in X-Windows. 
 
Working with vi: 
--------------- 
 
When you use vi your in one of two states: 
	(1) Command Mode 
	(2) Edit mode (to return to Command mode hit escape) 
 
All commands in vi are issued with a single key.  Some maybe proceed 
with a number to repeat the command the number of times specified. When 
you startup vi you're in the command mode.  Some of the commands you can 
issue in command mode are:  (remember UNIX systems are CASE sensitive) 
 
/	search - after you hit / enter the work/phrase you're looking for 
:	followed by a q  and enter will quit vi if no changes have been 
	made.  If you've changed the file and down want to save your 
	changes enter q! <enter>.  To save the file you enter a w.  If you 
	want to save the file and quit enter a wq after the :. 
ZZ	Will save the file and quit from vi.  
dd	Delete the line the cursor is currently located on 
x	Delete the character the cursor is currently located on 
h	move the cursor one character to the left (or use the left arrow) 
j	move the cursor up one line (or use the up arrow) 
k	move the cursor down one line (or use the down arrow) 
l	move the cursor right one character (or use the right arrow) 
G	Go to end of file 
#G	go to line # (1G goes to line 1 or top of the file) 
^f	forward one page (^ = control - i.e. control-f) 
^b	back one page (^ = control - i.e. control-b) 
w	forward one word 
b	back one word 
y	yank a line (#y - yank # of lines) 
p	put the yanked line after the cursor 
P	put the yanked line before the cursor 
u	undo the last command 
 
The following command mode keys take you into Edit mode.  If you want to  
return to Command mode (like to save a file) you must hit the Escape 
(esc) key. 
i	Insert following the character your cus 
I	Insert before the cursor 
o	open a line below the cursor 
O	open a line above the cursor 
 
 
				Appendix B 
				========== 
					 
Documentation of the Included Programs 
-------------------------------------- 
 
Most of the Document files for MINT, MINTnet, PPP, etc can be found in 
the sub-directory /home/docs  
 
THANK-YOU's 
----------- 
 
From Sam, Stephen and all the TAF go out to: 
 
John Kilburg, Theo Jannsen, S N Henson, Eric Smith, Kay Roemer,
Paul Mackerras, Andreas Schwab who have written and ported such great 
software of which this is a collection and many others who added their 
small fix/patches/upgrades to MiNT.
 
TAF would also like to give a special thanks to: 
 
Sam Mesbah		- for compiling all these program and developing the 	
			  installation procedure and offering it to TAF  
			  members.  A further thanks on your presentations  
			  at ACE '95.  If it wasn't for Sam a lot of us would 
			  be still trying to put this system together. 
 

Stephen Christian
schrist@io.org
ST VP of TAF 1995