This file contains instructions on how to install "root.tar.gz" and
"usr.tar.gz" on Minix filesystems on hard disk partitions under
Linux/68k 0.9.x using an Amiga or Atari.

These two gzipped tar files contain executables and data files which
together comprise a "usable" Linux filesystem space.

They include gcc-2.5.8, libc-4.5.21, ld.so-1.4.3, util-linux-1.1, the
GNU shellutils, GNU fileutils, and GNU textutils.  It also includes
the programs from procps-0.08, but they (and the /proc filesystem)
won't work in Linux 0.07pl3.

You need:

1) A hard disk partition at least 2.5M in size on a disk accessible
   from Linux/68k for the "root.tar.gz" files.
2) A hard disk partition at least 7.0M in size on a disk accessible
   from Linux/68k for the "usr.tar.gz" files.
3) A "tar" program executable for Linux (tar.gz can be found in
   tsx-11.mit.edu:/pub/linux/680x0/tools).  This file should be
   gunzipped and placed on a partition accessible from Linux/68k.
   Ensure that the "tar" file is executable (protect tar +e).
4) The "filesys" ramdisk root image for Linux/68k.

Before installing, gunzip the two files and place them on an AmigaDOS
partition accessible from Linux/68k.

You should probably also extract "etc/fstab" in AmigaDOS and edit it:

  tar xf root.tar etc/fstab

When you edit the etc/fstab file, you should change the partitions
mentioned there for / and /usr to the partitions you are installing
the root and usr filesystems on.   Remember that /dev/sda is the first
SCSI disk found on your system (lower SCSI target number) and that the
partitions are numbered as they appear from left to right in
HDToolBox.  Thus /dev/sda1 is the first partition on your lowest
numbered disk.

Determine the size, in 1K blocks of the partitions you are installing
on.  This can be determined using HDToolBox.  Remember that two 512
byte SCSI sectors make 1 1K block.  Note this for later, when you
create the filesystems.

When you are ready to install:

Boot linux/68k using the "filesys" ramdisk image.

If you have not already created a Minix filesystem on your intended
partition, do so using "mkfs" (note that mkfs requires the size of the
partition in 1K blocks).  Create a /mnt2 directory.  Mount your new
Minix root partition on /mnt, and mount your AmigaDOS partition with
"root.tar", "usr.tar" and "tar" on /mnt2.

create the root partition
# /etc/mkfs /dev/sd?? <size>
create the usr partition
# /etc/mkfs /dev/sd?? <size>
mount the root partition
# /etc/mount /dev/sd?? /mnt
mount the AmigaDOS partition
# /etc/mount -t affs /dev/sd?? /mnt2
change directory to the (hard disk) root directory and untar
# cd /mnt
# /mnt2/path/to/tar xvf /mnt2/path/to/root.tar
[...]
make sure everything is saved to disk
# sync
mount the /usr partition
# mount /dev/sd?? /mnt/usr
change directory to the /mnt/usr directory and untar
# cd /mnt/usr
# /mnt2/path/to/tar xvf /mnt2/path/to/usr.tar
[...]
make sure everything is saved to disk
# sync
unmount all filesystems
# /etc/umount -a
# /etc/umount /mnt

After this, you can reboot, and boot from the new root partition:

amigados> bootstrap root=/dev/sd?? ro
                                   ^^  boot with the root read-only

Assuming everything works correctly you should be able to login as
root (no password required).  If certain things fail, you may get a
single-user shell instead of a login prompt.  At this point the file
system will be read-only, so to change the files you'll probably have
to reboot and boot up with the file-system read-write (boot without
the "ro" parameter).

At this point, you can make any further changes you feel are
necessary.  The only editor available is "ed", so if you don't know
how to use this editor, find out before booting!  A man page for "ed"
is available in:

tsx-11.mit.edu:/pub/linux/packages/utils/util-linux-1.1.src.tar.gz.

To reboot, you can use the "/sbin/shutdown" command to shutdown Linux
gracefully.  You can give it the "now" option to shutdown right away,
without a delay.  Once it gives you the message that you can safely
shutdown the machine, you can use C-A-A to reboot back to AmigaDOS.