README for SourceMage PPC 0.9.1-test1 Install CD
------------------------------------------

Please note that the iso is a test release, and hence may contain bugs.
Please report bugs at <javierlopezbaeza@hotmail.com> or file a bug in bugzilla
(bugs.sourcemage.org), describing your hardware and symptoms.

1) What's new since 0.8.1?

* Using a 2.6.5-rc3-ben10 kenel and glibc-2.3.3 
* Better keymap selection
* Works better  

2) Hardware Issues

* This CD should boot on New World machine exclusively (due to the use of
  yaboot only). 

* Everything is compiled for 740 cpus (i.e. G3, G4 and G5 apple models), so
  don't bother trying if you have an earlier model. 

3) Installation

VERY IMPORTANT:
           
     *don't select elvis editor during this installation (use nano, or jed)
     *go to "reconfigure bootloader" section before reboot, then edit correctly the yaboot.conf file.

          Normally, ofboot and bootstrap partition numbers are equal (use mac-fdisk in a shell available during installation to determine the partition number). 

          My yaboot.conf:

          boot=/dev/hda9 #change to your bootstrap partition eg: /dev/hda2
          ofboot=hd:9    #change to your ofboot partition eg: hd:2
          enablecdboot
          enableofboot
          device=hd: #OpenFirmware device path to the disk containing kernel images

          delay=20
          timeout=50
       
          install=/usr/lib/yaboot/yaboot #not /usr/local/lib/yaboot/yaboot
          magicboot=/usr/lib/yaboot/ofboot #not /usr/local/lib/yaboot/yaboot
       
          defaultos=linux
          default=linux
       
          image=hd:12,/boot/vmlinux #hd:12 where the kernel image is located 
          label=mage
          root=/dev/hda12 #/dev/hda12 path to  the root ( / ) partition 
          read-only

          macos=hd:14
       
4) After installation

login:root
passwd:
sorcery update
sorcery rebuild

5) Known problems

*don't use the option combreloc (doesn't work)

*configuration of coreutils may fail if you select tiny flag in sorcery-->option-->optimize architecture 

*gcc-3.3.3 compilation error if you enable java support

*util-linux compilation error if you don't change the patch in /var/lib/sorcery/codex/stable/utils/util-linux by this patch  http://www.ece.cmu.edu/~rholzer/cryptoloop/util-linux-2.12-kernel-2.6.patch (edit BUILD file in this spell and modify the line  patch -p1.... to use util-linux-2.12-kernel-2.6.patch)

*before casting openssh:
edit /var/lib/sorcery/codex/stable/crypto/openssh/BUILD and add this lines before ./configure line:
        
        export LIBS="-lresolv"
	sed -i "s:-lcrypto:/usr/lib/libcrypto.a:g" configure 

*if you do a scribe update(updating grimoire), you can have problems with a few spells:
       
       glibc spell(can break your system on ppc)
       binutils spell(version: 2.15)
       util-linux spell(the patch problem)
       openssh spell(edit BUILD file)
       
       
6) Credits

* Thanks to Benoît Papillault for the x86 cd creation scripts and Kevin 'Unet' Dahan for the 0.8.1-ppc iso.

July 5, 2004
Javier 'de_Moya' Lopez Baeza
<JavierLopezBaeza@hotmail.com>

.