1. Preparation
2. Installation
   

   Default
   Custom

3. Booting Up!
4. Mac-On-Linux
5. Engineers' Notes

1. Insert the Mac OS Software Install CD.
   
   
2. Restart your computer.
   
   
3. Hold the "C" key until you have booted from the Mac OS Software Install CD (you will see a repetition of CDs as the background image).
   
   
4. Double-click on the Install CD. Double-click on the Utilities folder. Double-click the utility Drive Setup*. You are going to create a minimum of two partitions: one for Mac OS and the other for Linux. While a reduced Mac OS can be installed on a very small partition, it is suggested that you provide at least 1 GB. A minimum of 500 MB is required for the Home/Office installation, but 2 GB is preferred.
   
   
5. Select the drive you wish to partition.
   
   
6. Select Initialize.
   
   
7. Select Custom Setup.
   
   
8. Where the pull-down menu displays "Partitioning Scheme" select 2 partitions.
   
   
9. Where the pull-down menu displays "Mac OS Extended", select "Mac OS Standard" instead** for the first partition. Select the second (bottom) partition and then select "unallocated" from the pull-down menu.
   
   
10. Select Ok.
    
    
11. Select Initialize.
    
    
12. Quit the Drive Setup utility.
    
    
13. Double click on Mac OS Installer and install Mac OS according to the onscreen instructions.
    
    

1. Reboot your Mac into the newly installed Mac OS.
   
   
2. Once Mac OS is booted, insert the Yellow Dog Linux Install CD into your CD-ROM drive.
   
   
3. Double click the CD icon and then the folder "install".
   
   
4. Double click the file called "BootX_Installer.hqx" or drag it onto Stuffit Expander. Select a location on your drive to save the installer.
   
   
5. Double click "BootX_Installer".
   
   
6. If your computer's hard drive is called "Macintosh HD" the installer will automatically run using the graphical installer.
   
   
7. If your drive name is NOT "Macintosh HD", you will need to specify the Linux RAM Disk from BootX Options after the restart.
   
   
   1. At the BootX window, select Options.
      
      
   2. From the System Folder, choose "ramdisk-x11.image.gz" if you prefer to use a graphical installer with a mouse. Or choose "ramdisk-text.image.gz" if you are running on an older machine (or a machine with less than 64 MB RAM) as the text-based installer has the same procedures but will function faster. You will use the TAB, ARROW, and RETURN keys for navigation.
      
      
   3. Select Ok to get back to the main BootX window.
      
      
8. When the BootX Installer is complete, select Restart.
   
   
9. When prompted by the BootX, select Linux to Install YDL.
   
   

1. Insert the Yellow Dog Linux Install CD.
   
   
2. Restart your computer.
   
   
3. Hold the "C" key until you have booted from the Yellow Dog Linux Install CD.
   
   
4. Press RETURN for the GUI installer; or type
   
   

   install

   for the non-graphical, text-based* installer.
   
   
5. Proceed to the next section, "Select Default Language".
   
   

1. Select the drive on which you wish to install YDL. If you have only one drive, only one will appear on this screen.
   
   
2. Select Edit.
   
   
3. Using the arrow keys or your mouse, scroll to the bottom of the list.
   
   If you have an installed Macintosh operating system on this drive, you will note one or more Standard partitions as designated by the Filesystem type "hfs". It is often the case that the names assigned to your Mac OS drives will appear as "untitled" on this screen. Your partition map should look something like this:
   
   

   /dev/hda7	untitled	hfs	xx GB (your Mac OS 9.x partition)
   /dev/hda8	untitled	free	xx GB (future home of YDL)

   
   From the Mac OS Install CD, you created "unallocated" space which is now displayed as "free". It is from this free space that you will create your new Linux partitions. In essence, you are subdividing the second partition created while using the Mac OS Drive Setup program.
   
   
4. Select Add. You are now creating a partition on which the Installer may place a bootloader. While OldWorld ROM systems may not currently use this partition, we recommend you install it anyway as future upgrades may offer an OldWorld ROM bootloader.
   
   

   10 MB

5. Select Ok. You must now tell the Installer how to format this partition.
6. Select Boot Loader and then Ok.
   
   
7. Select Add. You are now creating the swap partition. Swap ("virtual memory") is drive space that Linux uses to temporarily place data that is not needed in RAM. Linux is highly efficient with swap and uses it wisely. Enter a minimum of 64 and a maximum of 256. 128 is a good number for most systems:
   
   

   128 MB

8. Select Ok. You must now tell the Installer how to format this partition.
   
   
9. Select Linux swap and then Ok.
   
   
10. Select Add. You are now creating the root partition. The root partition is where the vast majority of the operating system and applications can be located. It is simplest to select Max and allow the Installer to allocate all remaining space on the drive. If you are an advanced Linux user, you may create additional partitions as required.
    
    
11. Otherwise, select Max.
    
    
12. Select Ok. Record the location and name of each partition as you may need them later. You must now tell the Installer how to format this partition.
    
    
13. Select Linux and then Ok.
    
    Your partition map should now look something like this:
    
    

    /dev/hda7	untitled	hfs	xx GB (your Mac OS 9.x partition)
    /dev/hda8	untitled	hfs	10 MB (boot)
    /dev/hda9	swap	linux-swap	256 MB (swap)
    /dev/hda10	untitled	ext2	2+ GB (root)

    
    
14. Select Save.
    
    
15. Select Ok. Your drive partitions will be formatted and mount points automatically determined.

Home/Office is recommended for anyone new to Linux as the most essential desktop graphical applications are included: Authoring/Publishing, Dialup Workstation, Games, GNOME, KDE, Mac-On-Linux, Netatalk, Utilities, X Games, X Window System.

Development Workstation is for geeks: Authoring/Publishing, DOS/Windows Connectivity, Development, Dialup Workstation, Emacs, Graphics Manipulation, Kernel Development, Mail/WWW/News Tools, Mac-On-Linux, Multimedia Support, Netatalk, Networked Workstation, Utilities, GNOME, KDE, X Authoring/Publishing, X Development, X Window System.

Internet Server (without X): Anonymous FTP Server, Dialup Workstation, DNS Name Server, Mail/WWW/News Tools, Netatalk, Networked Workstation, Network Server, News Server, Utilities, Web Server.

LAN/WAN Server (without X): Dialup Workstation, IPX/Netware(tm) Connectivity, Mail/WWW/News Tools, Netatalk, Network Management Workstation, Network Server, Networked Workstation, NFS Server, Printer Support, SMB (Samba) Server, SQL Server, Utilities, Web Server.

Everything installs everything (caffeine not included). For this option, you must have at least 2 GB free space in your "root" partition. If you created additional partitions, you must have a generous "root" partition and 2 GB free in /usr/.

Add User:
You must add a minimum of one user account. You may add as many accounts as you deem necessary. As you may also add, delete, and modify accounts following installation, it is not necessary to do this now.

Monitor Setup: The YDL Installer will automatically detect the video card and install the necessary components to support it. When setting your Monitor Selection, it is recommended that you select the Simple option. Select the monitor that is closest to that which you have. iBooks and iMacs are listed first and simple to configure. If you have a monitor, the model number is often printed on the front of the monitor housing, as in "NEC E0-710" or on the label on the very back, above where the power and video cables connect.

Select Desired Resolutions: Select only the highest setting that your monitor will support and you feel comfortable using. Turn off all other display resolutions, even those less than the preferred setting. For instance, the iBook will not support resolutions greater than 800x600. When X launches, it defaults to this setting, therefore, you may render your X Windows unusable if you choose an unsupported setting.

Select a Color Depth: We recommend 16 bits for thousands of colors. This setting will produce an array of pleasing colors that run faster than a higher setting.

Graphical Login: The graphical login prompts for username and password in a graphical environment. It also recalls your settings from the previous time you logged in. A text login prompts for username and password at a command line (white text on a black background) and is used primarily for servers. However, if your monitor was not found in the monitors list, and you are uncertain that it will function, the text mode is safer.

1. Select the drive on which you wish to install YDL. If you have only one drive, only one will appear on this screen.
   
   
2. Select Edit.
   
   
3. Using the arrow keys or your mouse, scroll to the bottom of the list.
   
   If you have an installed Macintosh operating system on this drive, you will note one or more Standard partitions as designated by the Filesystem type "hfs". It is often the case that the names assigned to your Mac OS drives will appear as "untitled" on this screen. Your partition map should look something like this:
   
   

   /dev/hda1*	Macintosh	none	xxx KB (do NOT delete)
   /dev/hda2	Macintosh	none	xxx KB (do NOT delete)
   /dev/hda3	Macintosh	none	xxx KB (do NOT delete)
   /dev/hda4	Macintosh	none	xxx KB (do NOT delete)
   /dev/hda5	Macintosh	none	xxx KB (do NOT delete)
   /dev/hda6	Macintosh	none	xxx KB (do NOT delete)
   /dev/hda6	Macintosh	none	xxx KB (do NOT delete)
   /dev/hda7	untitled	hfs	xx GB (your Mac OS 9.x partition)
   /dev/hda8	untitled	free	xx GB (future home of YDL)

   
   *hda 1-6 were created by Apple's drive setup tool and must NOT be altered. Please note that you may have as few as 5 of these small partitions or as many as 8 depending upon the computer you use and what Apple Drive Toolkit determined was appropriate.
   
   From the Mac OS Install CD, you created "unallocated" space which is now displayed as "free". It is from this free space that you will create your new Linux partitions. In essence, you are subdividing the second partition created while using the Mac OS Drive Setup program.
   
   
4. Select Add. You are now creating a partition on which the Installer may place a bootloader. While OldWorld ROM systems may not currently use this partition, we recommend you install it anyway as future upgrades may offer an OldWorld ROM bootloader.
   
   

   10 MB

5. Select Ok. You must now tell the Installer how to format this partition.
6. Select Boot Loader and then Ok.
   
   
7. Select Add. You are now creating the swap partition. Swap ("virtual memory") is drive space that Linux uses to temporarily place data that is not needed in RAM. Linux is highly efficient with swap and uses it wisely. Enter a minimum of 64 and a maximum of 256. 128 is a good number for most systems:
   
   

   128 MB

8. Select Ok. You must now tell the Installer how to format this partition.
   
   
9. Select Linux swap and then Ok.
   
   
10. Select Add. You are now creating the root partition. The root partition is where the vast majority of the operating system and applications can be located. It is simplest to select Max and allow the Installer to allocate all remaining space on the drive. If you are an advanced Linux user, you may create additional partitions as required.
    
    
11. Otherwise, select Max.
    
    
12. Select Ok. Record the location and name of each partition as you may need them later. You must now tell the Installer how to format this partition.
    
    
13. Select Linux and then Ok.
    
    Your partition map should now look something like this:
    
    

    /dev/hda1	Macintosh	none	xxx KB (do NOT delete)
    /dev/hda2	Macintosh	none	xxx KB (do NOT delete)
    /dev/hda3	Macintosh	none	xxx KB (do NOT delete)
    /dev/hda4	Macintosh	none	xxx KB (do NOT delete)
    /dev/hda5	Macintosh	none	xxx KB (do NOT delete)
    /dev/hda6	Macintosh	none	xxx KB (do NOT delete)
    /dev/hda6	Macintosh	none	xxx KB (do NOT delete)
    /dev/hda7	untitled	hfs	xx GB (your Mac OS 9.x partition)
    /dev/hda8	untitled	hfs	10 MB (boot)
    /dev/hda9	swap	linux-swap	256 MB (swap)
    /dev/hda10	untitled	ext2	2+ GB (root)

    
    
14. Select Save.
    
    
15. Select Ok. Your drive partitions will now be formatted.

Home/Office is recommended for anyone new to Linux as the most essential desktop graphical applications are included: Authoring/Publishing, Dialup Workstation, Games, GNOME, KDE, Mac-On-Linux, Netatalk, Utilities, X Games, X Window System.

Development Workstation is for geeks: Authoring/Publishing, DOS/Windows Connectivity, Development, Dialup Workstation, Emacs, Graphics Manipulation, Kernel Development, Mail/WWW/News Tools, Mac-On-Linux, Multimedia Support, Netatalk, Networked Workstation, Utilities, GNOME, KDE, X Authoring/Publishing, X Development, X Window System.

Internet Server (without X): Anonymous FTP Server, Dialup Workstation, DNS Name Server, Mail/WWW/News Tools, Netatalk, Networked Workstation, Network Server, News Server, Utilities, Web Server.

LAN/WAN Server (without X): Dialup Workstation, IPX/Netware(tm) Connectivity, Mail/WWW/News Tools, Netatalk, Network Management Workstation, Network Server, Networked Workstation, NFS Server, Printer Support, SMB (Samba) Server, SQL Server, Utilities, Web Server.

Everything installs everything (caffeine not included). For this option, you must have at least 2 GB free space in your "root" partition. If you created additional partitions, you must have a generous "root" partition and 2 GB free in /usr/.

Add User:
You must add a minimum of one user account. You may add as many accounts as you deem necessary. As you may also add, delete, and modify accounts following installation, it is not necessary to do this now.

Monitor Setup: The YDL Installer will automatically detect the video card and install the necessary components to support it. When setting your Monitor Selection, it is recommended that you select the Simple option. Select the monitor that is closest to that which you have. iBooks and iMacs are listed first and simple to configure. If you have a monitor, the model number is often printed on the front of the monitor housing, as in "NEC E0-710" or on the label on the very back, above where the power and video cables connect.

Select Desired Resolutions: Select only the highest setting that your monitor will support and you feel comfortable using. Turn off all other display resolutions, even those less than the preferred setting. For instance, the iBook will not support resolutions greater than 800x600. When X launches, it defaults to this setting, therefore, you may render your X Windows unusable if you choose an unsupported setting.

Select a Color Depth: We recommend 16 bits for thousands of colors. This setting will produce an array of pleasing colors that run faster than a higher setting.

Graphical Login: The graphical login prompts for username and password in a graphical environment. It also recalls your settings from the previous time you logged in. A text login prompts for username and password at a command line (white text on a black background) and is used primarily for servers. However, if your monitor was not found in the monitors list, and you are uncertain that it will function, the text mode is safer.

1. Press the power button
   
   
2. You are greeted by the familiar Macintosh chime
   
   
3. BootX vs yaboot
   
   
   • BootX: If you have a OldWorld ROM system, and are using BootX. Your Macintosh will boot into Mac OS and display the BootX Control Panel. While BootX will default either into Mac OS or Linux, depending upon how you have set the preferences during installation, you may manually select either Mac OS or Linux using the TAB key or the mouse. To stop the time-out feature of BootX, simply press the TAB key.
     
     
   • You must now point BootX to the root partition where the Linux kernel is stored. Press the Options button and then uncheck the "Use Specified RAM Disk" option. Select OK. Enter the root partition number (provided during installation; example: hda8) in the empty field following /dev/.
     
     
   • BootX can be used to switch between booting into the Mac OS or into Linux as a dual-boot system. Use the tab key to select either Mac OS or Linux and then save your preferences.
     
     
   • yaboot: If you have a NewWorld ROM system, the Installer will have installed the 'yaboot' bootloader. yaboot will present a list in the upper left corner of your screen, offering "M" for Mac OS, "L" for Linux, and "C" for CDROM. Note "M" will not be presented if Mac OS was not available at the time of YDL installation. While you may choose either of the three by pressing the corresponding key, yaboot will time-out and default to the system that you designated during installation.
   
   
4. When presented with the "Welcome to Yellow Dog Linux" white text on a black background, you will notice a "boot:" prompt. You may press the TAB key to view the various kernel options or just wait for this boot sequence to time-out and auto-boot the default (denoted with an *) kernel, typically labeled "linux". If you choose to try a different kernel, linux-novideo for instance, you may do so by typing that name verbatim and then pressing the return key. This should be done only by advanced users who are experimenting with home-grown kernels or in an effort to boot with a non-supported video card.
   
   
5. A penguin icon will appear in the upper left corner of your screen (or two if your system has two processors) followed by a stream of text messages stating whether or not particular applications have successfully loaded. This is analogous to the Mac OS Extensions loading during startup.
   
   
6. Text vs graphical login
   
   
   • If you chose the text login during installation, you will be presented with a "login:" prompt. Enter your username and password accordingly. You may then launch the GUI by typing

     startx

     and press RETURN.
     
     
   • If you chose the graphical login during installation, you will be presented with a place to enter your username (Login). Then enter your password. Choose your preferred default window manager (we recommend KDE as this book speaks only to KDE users) or just press the "Go!" button to default to KDE. If you have mis-entered your username or password, you may press the "Clear" button to start over. You may also restart the X server, switch to "console mode" (text only, no graphics), or shutdown the system.

mkdir /mnt/macos

mount /dev/xxxx /mnt/macos -thfs

cp /mnt/macos/System Folder/"Mac OS ROM" /usr/lib/mol/rom/rom.nw

hpmount /dev/xxxx

hpcd "System Folder"
hpcopy -r "Mac OS ROM" /usr/lib/mol/rom/rom.nw
hpumount

molvconfig

pico /etc/molrc

startmol

• ZIP Drives: If you have a ZIP drive, place a ZIP disk in the drive during installation.
  
  
• GUI-Screen blanking: During long installs, your screen may 'blank out', or even display illegible video. If this occurs, do not panic, the X screensaver is active.
  
  
• GUI-Hard drive partitioning: You need a formatted drive, to start with as the partitioner cannot low level drives. During the partitioning process on slower machines, the screen may not update while performing a cpu intensive task. The screen will update when the drive is done formatting.
  
  
• GUI-Windows: During installation, it is possible to move a window into a position where you cannot easily click the buttons. Should this occur, simply click and hold on the upper title bar of the window or hold the OPTION (ALT) key and click anywhere in the body of the window, and then move the Window back again.
  
  
• Network Install: Network installs are not supported at this time.
  
  
• LDAP: LDAP authentication is not supported at this time.
  
  
• LCD: The Apple LCD display (with the Apple Display Connector (ADC)) will function if at the yaboot prompt (after you have chosen "L" for Linux; "Welcome to Yellow Dog Linux") you enter:

  linux video=aty128fb:vmode:14

  This is necessary if you are working with a Cube or G4 with an ADC video card and Apple LCD display. In addition, under Linux, the buttons on the front of the LCD display are disabled.
  
  
• Xconfigurator does not generate a correct XFree86 config for Apple 15" ADC LCD. For updates please visit the Support Pages.
  
  
• iBook: Require the text mode installer. Sound is not supported and at the time of this writing, we do not offer a solution.
  
  
• iBook2 (2001): The CD eject button does not work. You need to manually eject the cd:

  eject /dev/cdrom

  If the text console is corrupted, use "video=aty128fb:vmode:14" at boot.
  
  
• iMac (2001): X does not run properly. pico /etc/X11/XF86Config and modify 'Driver "r128"' to 'Driver "fbdev"'.
  
  
• PowerBook 3400: The penguin logo at boot is pixelated. This does not affect X nor text mode.
  
  
• G4 (AGP): Gigabit ethernet is not supported.
  
  
• G4 (PCI): DVD Decoder card, if present, can cause install to fail. Power-down your computer and disconnect the decoder card.
  
  
• G4 Cube: Audio is not supported. ATI Cube's are not supported with accelerated video.
  
  
• Titanium PowerBook G4: Xconfigurator does not generate a correct XFree86 config. For updates please visit the Support Pages.
  
  
• Video cards: Nvidia GeForce2 and ATI Radion cards are not supported: the text-based Installer and post-installation text (console) mode work fine, but you will not obtain a quality graphical display at the time of this writing.