CRUX PPC 1.3.1 Install Guide Copyright (c) 2001-2003 by Per Lidén Copyright (c) 2003-2004 by Giulivo Navigante ------------------------------------------------------------------------ Supported hardware ------------------ * Packages on the official CRUX PPC ISO image are compiled with optimizations for PPC 750 processor (PowerPC G3). * The kernel used during the installation, i.e. when booting from the CRUX PPC ISO image, was compiled with the following options: Disk controllers - IDE (Generic PCI IDE chipset, Builtin PowerMac IDE support, HPT34x HPT36x/HPT37x chipset support, PROMISE PDC202 from 46 to 77, IDE Raid controllers Promise and HighPoint 370) - SCSI (7000FASST, ACARD, Adaptec AHA1542, Adaptec AIC79xx support, Adaptec AHA1740, Adaptec AIC7xxx, AdvanSys, AM53/79C974 PCI, Generic NCR5380/53c400, AMI MegaRAID2 support, NCR53c406a, Symbios 53c416, Tekram DC390(T) and Am53/79C974 SCSI support, PowerMac internal and external SCSI support, SYM53C8XX Version 2) - SATA (ServerWorks Frodo / Apple K2 SATA support, Promise SATA support, VIA SATA support) USB support - USB device filesystem - EHCI HCD (USB 2.0) support - OHCI (Compaq, iMacs, ...) support - USB Human Interface Device (full HID) support - HID input layer support RAID 0,1,4,5 and LVM Installation ------------ 1. Download the CRUX PPC ISO image (crux-X.X.X.iso). To ensure the download was successful you should examine its checksum using md5sum. Run md5sum crux-X.X.X.iso and compare the output with the file crux-X.X.X.md5sum, which can be found in the same directory as the ISO image on the ftp-site. If the checksums match, the download was successful and you can continue with burning the ISO image on a CD. 2. The ISO image is bootable, just insert the newly burned CD into cdrom and reboot your computer. Hold down C key during the boot and wait for the yaboot loader. 3. Login as root (no password required). 4. Create (if necessary) and format the partition(s) on which you want CRUX PPC to be installed. You must create the Apple_Bootstrap partition (800k) called "bootstrap" to install yaboot loader. The name of other partition(s) is not relevant, but the swap partition must be called "swap" mac-fdisk /dev/discs/disc?/disc (to create partitions) mke2fs -j /dev/discs/disc?/part? (to format an ext3 partition) mkswap /dev/discs/disc?/part? (to format a swap partition) The amount of disk space you need, depends on how many packages you choose to install. I recommend you to at least have a 1G root partition (CRUX PPC will use 200-500M depending on your configuration). Using ext2/ext3 is recommended, but there is the support for ReiserFS and JFS too if you need it. It's also highly recommended to separate the system from user data, i.e. use a separate partition for /home (and eventually /var), that will make your life easier the day you will need to upgrade/reinstall/remove your system. 5. Mount the partition you want this distribution being installed on, e.g.: mount /dev/discs/disc?/part? /mnt If you want the installation on more than one partition, then mount these partitions as well. E.g. if you want to have a different partition for /var, then do like this: mkdir /mnt/var mount /dev/discs/disc?/part? /mnt/var NOTE: This installation guide assumes that you use /mnt as the mount point for your new root partition. You can of course use something else, just remember to replace all further references to /mnt with your mount point. 6. Activate your swap partition(s) using the swapon command, i.e.: swapon /dev/discs/disc?/part? 7. Run the "setup" script to start the package installation. /usr/bin/setup The script will ask you where you mounted your new root partition and which packages you want to install. Just select the packages you want and nothing else will be installed. However, I recommend to at least install all packages marked as "base". When the setup script has installed the selected packages an installation log will be displayed. Make sure the last line in the log says "0 error(s)". If in a later stage you need some additional packages you can just mount the CRUX PPC CD-ROM and use pkgadd to install them. NOTE: There is no package dependency checking. 8. Now it's time to compile your kernel and do basic system configuration. The kernel compilation requires that you "chroot" into your new CRUX PPC installation. mount -t devfs devfs /mnt/dev mount -t proc proc /mnt/proc chroot /mnt 9. Edit /etc/fstab to configure your filesystem(s). 10. Edit /etc/rc.conf to configure keyboard, services, and timezone. 11. Edit /etc/rc.d/net, /etc/hosts and /etc/resolv.conf to configure your network (ip-address/gateway/hostname/domain/dns). 12. Change the root password (use passwd with no arguments). 13. Go to /usr/src/linux-X.X.X, configure and compile a new kernel. make menuconfig make dep make vmlinux make modules make modules_install cp vmlinux System.map /boot Remember at least to enable the following kernel options: Code maturity level options ---> [*] Prompt for development and/or incomplete code/drivers File systems ---> [*] /dev file system support [*] Automatically mount at boot The following kernel options should NOT be modified: Macintosh device drivers ---> [*] Apple Desktop Bus (ADB) support [*] Use input layer for ADB devices [ ] Support for ADB raw keycodes The .config file found in kernel source's tree is the one that Ben uses, if you want another one .config, my .config file can be loaded from: /crux/giulivo-2.4.24-ben1.config 14. Edit /etc/yaboot.conf to boot the kernel you have just compiled, run "mkofboot -v" to setting up the bootstrap partition and "ybin -v" to install the bootloader. mkofboot is for initial setup only. 15. Remove the CRUX PPC CD-ROM from your drive and reboot from harddisk. ------------------------------------------------------------------------ CRUX PPC 1.3.1 Install Guide Copyright (c) 2001-2003 by Per Lidén Copyright (c) 2003-2004 by Giulivo Navigante