Install - image

Introduction

This is a full generic installation of X-Amiga. It should be manually configured to suit your system.

The generic configuration:

• Set up to boot from first partition on first hard drive: /dev/hda1
• 800x600x24 display
• No kernel sound module selected
• No kernel network module selected
• User password: x-amiga
• Of course, no ROM or OS included!

Requirements:

• A computer running Linux
• GRUB installed on your OS
• A blank partition
• Amiga-specific files: at least an Amiga ROM

Provided your hard drive partition matches, and GRUB is set up properly, it should boot and run without any further modification. The configuration information here is mainly to enable all the other features.

Step-by-step...

1. Copy the image file to a blank, formatted partition (minimum 45MB required) and untar it:

   tar xvf xamiga-[release].tbz2

2. To change the default hard drive, three files need to be changed:

   /boot/grub/grub.conf
/etc/fstab
/etc/mtab

3. The display resolution for E-UAE is set in:

   /usr/bin/startxa

   And the framebuffer resolution is set in:

   /boot/grub/grub.conf

   Note: the splash image is specially generated during installation.


4. To change the system password (assuming you've mounted the partition at /mnt/xamiga):

   chroot /mnt/xamiga /bin/sh
passwd xamiga
enter new password]
exit

5. Kernel modules, for example, for a sound card or network card, are listed in:

   /etc/init.d/modules

   Note: module names (only!) must be on new lines.
   If this file is left blank, the emulation will still work, but sound and networking will be disabled.


6. To configure sound card levels (assuming you've mounted the partition at /mnt/xamiga, and that you know the module for your sound card):

   chroot /mnt/xamiga /bin/sh
modprobe [snd_card]
amixer set Master 31 unmute
amixer set PCM 15 unmute
alsactl store
exit

   Or, for greater choice:

   chroot /mnt/xamiga /bin/sh
modprobe [snd_card]
alsamixer ('Esc' to exit)
alsactl store
exit

7. To install GRUB (assuming that GRUB is already installed on your computer, that you've mounted the partition at /mnt/xamiga, and that GRUB is to be installed in the MBR of /dev/hda):
   Important: only do this if the install partition is on a different hard drive! If it's on the same hard drive, you only need to change the GRUB configuration (normally /boot/grub/grub.conf or /boot/grub/menu.lst)
   

   grub-install --root-directory=/mnt/xamiga /dev/hda

8. The system init script is at:

   /etc/init.d/rcS

   Check this file for options to enable extra features at boot time.


9. The E-UAE configuration file is at:

   /home/xamiga/.uaerc

10. Amiga files can be copied to:

    /amiga/ROM
/amiga/OS
/amiga/ADF

Back