- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 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) 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! . 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 .