HOWTO install EasyMiNT from scratch on Aranym/AFROS basis

This has be done on a Linux (mandrake 9.2) system, and Aranym release 0.8.7-beta. The following notes describe step by step how to have a complete easymint setup (based on aranym/emutos/afros) from scratch on a linux box. This HOWTO requires :
If you have already installed this system, the following link explains
HOWTO upgrade Aranym/AFROS on your EasyAraMint system.

Nota: AFAIK, there's nothing specific to linux in the following, so this should work for any other machine too.
Nota2: in my system, my config file and the disk images are located on the /home/arnaud/ara/ directory. In the following, please replace this path by your path.

Last Changes:
2004-02-16: update to aranym 0.8.7beta, AFROS-20040206 and EM_152
2004-01-14: update to aranym 0.8.5beta and AFROS-20040107, set _MCH to 0x500000.
 2003-11-29 : big cleanup thanks to new releases (AFROS-20031127 and EM_151).
2003-11-26 : add bigger disk image (20MB/500MB).
2003-11-25 : some fixes, add step 9, add step 10, add bigger disk image (20MB/300MB).
2003-11-20 : created

  1. get aranym and its afros disk image
  2. create an empty disk image
  3. Aranym config file
  4. Download EasyMiNT
  5. Setup the empty GEM partition
  6. running easymint (first pass)
  7. fix the temporary mint setup
  8. running easymint (2nd pass)
  9. how-to open bash ?
  10. how-to shutdown ?
  11. how-to make easymint.cnf the default configuration file
STEP 1 - get aranym and its afros disk image
 
Download and install the Aranym binary (RPM is cool) : http://aranym.sf.net
Download its AFROS disk image  (afros-20040206.zip or newer) : http://aranym.sf.net/afros.html, and uncompress this archive. Copy the file disk.img to /home/arnaud/ara/ (replace this path by your path!), and copy the file etos512k.img to /usr/share/aranym/ directory.

STEP 2 - Create an empty disk image

Easymint required a LNX partition. I've created an empty 220MB disk image with 2 partitions: a 20MB GEM partition for the system (boot, mint, xaaes...) and a 200MB LNX partition for the sparemint stuff.

You can download it here : hd-20-200.tar.bz2 (1.210 bytes)

This disk image is enought if you don't install so much easymint packages. If you want to install all except the X11 packages (what i do here), you'll need a bigger disk image, for example a 320MB disk with 2 partitions (a 20MB GEM partition and a 300MB LNX partition).

You can download it here : hd-20-300.tar.bz2 (1.317 bytes)

You want (need) a bigger one ? Here is a 520MB disk image with 2 partitions (a 20MB GEM partition and a 500MB LNX partition) :

You can download it here : hd-20-500.tar.bz2 (1.457 bytes)

Theses files may be extracted using the following command:
$ tar -xvjf hd-20-300.tar.bz2

STEP 3 - Aranym config file

Uncompress the file above (for example hd-20-300.tar.bz2). This archive contains the disk image (em-20-300.hd) and the aranym configuration file (easymint.cnf).

On my system, the directory /home/arnaud/ara/ contains the following files:
You'll need to change the disk image pathes on the easymint.cnf file, as well as the I=/home/arnaud line to deal with your setup. Just run your favorite text editor and change this.

Your easymint directory (/home/arnaud/easymint_152 in my setup) should be accessible thru this I: drive.


STEP 4 - Download EasyMiNT

Download easymint installer and the wanted packages : http://easymint.atariforge.net or http://atari.st-katharina-apotheke.de

On my system, the Easymint packages are located in the /home/arnaud/easymint_152 directory. I've unzipped the easymint downloaded files as described in the easymint docu. Here is my /home/arnaud/easymint_152 directory content (i've downloaded all but the X11 package) :

.:
total 2944
drwxr-xr-x    2 arnaud   arnaud       4096 fév  9 21:27 CZECH/
drwxr-xr-x    6 arnaud   arnaud       4096 fév  9 21:27 DOC/
-rwxr-xr-x    1 arnaud   arnaud       6004 fév  9 21:27 DULEZITE.TXT*
-rwxr-xr-x    1 arnaud   arnaud     179668 fév  9 21:27 EASYMINT.PRG*
-rwxr-xr-x    1 arnaud   arnaud      28738 fév  9 21:28 EASYMINT.RSC*
-rwxr-xr-x    1 arnaud   arnaud    1301237 fév  9 21:27 EASYMINT.ZIP*
drwxr-xr-x    2 arnaud   arnaud       4096 fév  9 21:18 ENGLISH/
-rwxr-xr-x    1 arnaud   arnaud       5852 fév  9 21:27 IMPORTAN.TXT*
-rwxr-xr-x    1 arnaud   arnaud       5437 fév  9 21:27 LANGUAGE.LNG*
drwxr-xr-x    2 arnaud   arnaud       4096 fév  9 21:18 PAKETE/
-rwxr-xr-x    1 arnaud   arnaud       9957 fév  9 21:18 PK*
drwxr-xr-x    2 arnaud   arnaud       4096 fév  9 21:27 POLISH/
-rwxr-xr-x    1 arnaud   arnaud    1329832 fév  9 21:27 ROOTFS.TGZ*
-rwxr-xr-x    1 arnaud   arnaud      76901 fév  9 21:27 UNZIP.TTP*
-rwxr-xr-x    1 arnaud   arnaud       6055 fév  9 21:27 WAZNE.TXT*
-rwxr-xr-x    1 arnaud   arnaud       6303 fév  9 21:27 WICHTIG.TXT*

./CZECH:
total 40
-rwxr-xr-x    1 arnaud   arnaud      26774 fév  9 21:27 EASYMINT.RSC*
-rwxr-xr-x    1 arnaud   arnaud       4093 fév  9 21:27 FAQ_CZ.TXT*
-rwxr-xr-x    1 arnaud   arnaud       4902 fév  9 21:27 LANGUAGE.LNG*

./DOC:
total 56
drwxr-xr-x    2 arnaud   arnaud       4096 fév  9 21:27 CZECH/
drwxr-xr-x    2 arnaud   arnaud       4096 fév  9 21:27 DEUTSCH/
-rwxr-xr-x    1 arnaud   arnaud       9957 fév  9 21:18 EM_IN_GU.ZIP*
drwxr-xr-x    2 arnaud   arnaud       4096 fév  9 21:27 ENGLISH/
-rwxr-xr-x    1 arnaud   arnaud       4502 fév  9 21:18 FAQ_GER.TXT*
-rwxr-xr-x    1 arnaud   arnaud       6803 fév  9 21:18 NEWS.TXT*
-rwxr-xr-x    1 arnaud   arnaud       9957 fév  9 21:18 PK*
drwxr-xr-x    2 arnaud   arnaud       4096 fév  9 21:27 POLISH/

./DOC/CZECH:
total 4
-rwxr-xr-x    1 arnaud   arnaud       4093 fév  9 21:27 FAQ_CZ.TXT*

./DOC/DEUTSCH:
total 28
-rwxr-xr-x    1 arnaud   arnaud       9957 fév  9 21:27 EM_IN_GU.ZIP*
-rwxr-xr-x    1 arnaud   arnaud       4502 fév  9 21:27 FAQ_GER.TXT*
-rwxr-xr-x    1 arnaud   arnaud       6867 fév  9 21:27 NEWS.TXT*

./DOC/ENGLISH:
total 20
-rwxr-xr-x    1 arnaud   arnaud       4085 fév  9 21:27 FAQ_ENG.TXT*
-rwxr-xr-x    1 arnaud   arnaud       5829 fév  9 21:27 NEWS_E.TXT*
-rwxr-xr-x    1 arnaud   arnaud       4120 fév  9 21:27 QUICKGUI.TXT*

./DOC/POLISH:
total 8
-rwxr-xr-x    1 arnaud   arnaud       4357 fév  9 21:27 FAQ_PL.TXT*

./ENGLISH:
total 60
-rwxr-xr-x    1 arnaud   arnaud      28738 fév  9 21:27 EASYMINT.RSC*
-rwxr-xr-x    1 arnaud   arnaud       4085 fév  9 21:18 FAQ_ENG.TXT*
-rwxr-xr-x    1 arnaud   arnaud       5031 fév  9 21:27 LANGUAGE.LNG*
-rwxr-xr-x    1 arnaud   arnaud       5763 fév  9 21:18 NEWS_E.TXT*
-rwxr-xr-x    1 arnaud   arnaud       4120 fév  9 21:18 QUICKGUI.TXT*

./PAKETE:
total 75156
-rwxr-xr-x    1 arnaud   arnaud        461 fév  9 21:27 BASIC.LST*
-rwxr-xr-x    1 arnaud   arnaud    5324800 fév  9 21:18 BASIC.TAR*
-rwxr-xr-x    1 arnaud   arnaud       1069 fév  9 21:27 DEVEL.LST*
-rwxr-xr-x    1 arnaud   arnaud   24760320 fév  9 21:18 devel.tar*
-rwxr-xr-x    1 arnaud   arnaud        634 fév  9 21:27 LIBS.LST*
-rwxr-xr-x    1 arnaud   arnaud   15585280 fév  9 21:18 libs.tar*
-rwxr-xr-x    1 arnaud   arnaud        637 fév  9 21:27 NET.LST*
-rwxr-xr-x    1 arnaud   arnaud   10997760 fév  9 21:18 net.tar*
-rwxr-xr-x    1 arnaud   arnaud        684 fév  9 21:27 STANDARD.LST*
-rwxr-xr-x    1 arnaud   arnaud   20162560 fév  9 21:18 standard.tar*
-rwxr-xr-x    1 arnaud   arnaud        636 fév  9 21:27 X11.LST*

./POLISH:
total 40
-rwxr-xr-x    1 arnaud   arnaud      28818 fév  9 21:27 EASYMINT.RSC*
-rwxr-xr-x    1 arnaud   arnaud       5237 fév  9 21:27 LANGUAGE.LNG*



STEP 5 - Setup the empty GEM partition

This 20MB partition is empty. We'll copy there the AFROS disk content.

In the easymint.cnf file, IDE0 (drives C: and D:) is the empty disk and IDE1 (drive E:) is AFROS. It's time to run aranym:

$ cd /home/arnaud/ara
$ aranym -c easymint.cnf

Here, you should see the hi-rez (black & white) EmuTOS desktop. C: is the empty GEM partition, D: is the empty LNX partition, and E: is the AFROS disk image.

Open the E: drive, and copy all the files in E: to the C: drive.

view screen snapshot (snap000.png - 13781 bytes)

Now, the C: drive contain a copy of the AFROS disk image. You can reboot aranym (by pressing CTRL+ALT+SUPP for example).

STEP 6 - running easymint (first pass)

Now, you should have a great freemint/xaaes/teradesk desktop instead of the minimalist EmuTOS desktop.

Open the I: drive (it's the HostFS drive), and look for your easymint installer. When you've found it, run easymint.prg.

view screen snapshot (snap001.png - 14776 bytes)

The default option are the good ones. Please, don't check the "XaAES installation" button. A much more recent version of XaAES is already installed in your c:/xaaes directory.

At the end, Easymint announce that the computer will reboot:

Press OK, let Aranym reboots. You'll see that the reboot fails, so press the CTRL while booting to have the pretty EmuTOS desktop. Here, we'll have to fix some stuff in order to have the boot process working again.

STEP 7 - fix the temporary mint setup

Open qed, and edit the file c:\mint\mint.cnf. At the end of the file, add the following line (with a carriage return at the end):
GEM=/c/xaaes/xaaes.prg
Then, copy moose.xdd (the mouse driver for XaAES) from c:\mint.old to c:\mint.

To retreive freemint 1.16 :
Now, reboot aranym (for example by pressing [CTRL][ALT][DEL] keys). Here you should have the xaaes/teradesk environment on the screen.

STEP 8 - running easymint (2nd pass)

run once more easymint.prg.

Easymint will create the EXT2 partition on the d: drive. You have to confirm that's really what you want.

Then, a formular will be opened so that you can choose the packages to be installed. Install at least the BASIC.TAR package (read the easymint documentation for details).

Next formular: system startup: choose XaAES, and type /c/xaaes/xaaes.prg in XaAES settings area, or use the fileselector (in this case, change the filter from "xaaes.tos" to "*", and select the file xaaes.prg). The editable field seems to have some refresh bugs. You may press the left or right arrow to refresh the editable field content.

To choose the TIMEZONE, the default filter of the fileselector is empty. You have to chose "*" as filter if you want to select a timezone.

view screen snapshot (snap003.png - 19040 bytes)

At the end, easymint will reboot. At this moment, the installation is completed.

STEP 9 - how-to run bash ?

Run U:\opt\toswin2\toswin2.app. Then, open the menubar "Datei/TOS-Programm Starten". Select the file U:\bin\bash and valide the fileselector. Toswin2 will then ask for parameters: leave the parameter line empty, and validate.

You now have bash running in a GEM window :)

We may do things more properly:
edit the file c:\xaaes\xa_setup.scl and change the line "string tosrun = aes + tw\tw-call.app" to "string tosrun = /opt/toswin2/toswin2.app".
This string will be taken into account after the next boot.
With this config, all your TOS application will be executed on a GEM window thanks to toswin2.

STEP 10 - how-to shutdown ?

To cleanly end your session, you have to shutdown before killing aranym. On the TeraDesk menu, select File/Quit, and clic on the "Shutdown" button.

Note that will shutdown your aranym system... and restart it (seems to be a bug). While EmuTOS is booting, press SHIFT+PAUSE keys to kill aranym.

STEP 11 - how-to make easymint.cnf the default configuration file

You like this easymint.cnf configuration, and you like it to be default one. Just copy (and rename) your easymint.cnf to ~/.aranym/config : this is the default config file loaded by aranym.

Then, you just have to type "aranym" to run your EasyAraMint system.



URI: http://arnaud.bercegeay.free.fr/ezaramint/index.html
(c)2003-2004 Arnaud BERCEGEAY <bercegeay (at) atari (dot) org>