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*.
   
   
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 or 3 partitions. If you are to install YDL + Mac OS 9, select 2. And if you are to install YDL + Mac OS 9 + Mac OS X, select 3 partitions.
   
   
9. If you are Select the first (top) partition and where the pull-down menu displays "Mac OS Extended", select "unallocated". Select the second (bottom) partition and then "Mac OS Standard" **. If you are to install Mac OS X, the 3rd and last partition should be formatted as "Mac OS Extended".
   
   
10. Select Ok.
    
    
11. Select Initialize.
    
    
12. Quit the Drive Setup utility.
    
    
13. Double click on Mac OS Installer.
    
    
14. Rename the 2nd partition to "Mac OS 9". If you are to install Mac OS X, the 3rd partition may be renamed "Mac OS X".
    
    
15. Install Mac OS 9 and/or Mac OS X according to the on-screen 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-text

   
   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	free	xx GB (future home of YDL)
   /dev/hda8	untitled	hfs	xx GB (your Mac OS 9.x partition)

   
   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. You are subdividing a partition created from use of the Mac OS Drive Setup program.
   
   
4. Select Add. You are now creating a partition on which the Installer may place a 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	10 MB (boot)
    /dev/hda8	swap	linux-swap	256 MB (swap)
    /dev/hda9	untitled	ext2	2+ GB (root)
    /dev/hda10	untitled	hfs	xx GB (your Mac OS 9.x partition)

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

The Base (without X) installation is recommended for experts who want to minimize the required disk space. Do not select this option unless you have a very good reason for doing so.

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 are 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	free	xx GB (future home of YDL)
   /dev/hda8	untitled	hfs	xx GB (your Mac OS 9.x partition)

   
   *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	10 MB (boot)
    /dev/hda8	swap	linux-swap	256 MB (swap)
    /dev/hda9	untitled	ext2	2+ GB (root)
    /dev/hda10	untitled	hfs	xx GB (your Mac OS 9.x partition)

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

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.

startx [ENTER]

/usr/lib/yi/dexter.py [ENTER]
(select a different monitor setting)

pico /etc/inittab [ENTER]

reboot [ENTER]

molvconfig [ENTER]

pico /etc/molrc [ENTER]

startmol [ENTER]

• If yaboot fails to execute after installing YDL 2.1
  After install, reboot and hold the "c" key. Once you get to boot options, type the following:
  
  

  cd-linux root=/dev/<linux root partition> [ENTER]

  (where <linux root partition> may be, for example, hda7 or sda6, but without the < and >) Then:
  
  

  /usr/sbin/ybin [ENTER]

• 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 [ENTER]
  (you may also try 'linux novideo')

  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.
  
  
• iBook2 (2001): The CD eject button does not work. You need to manually eject the cd:
  
  

  eject /dev/cdrom [ENTER]

  If the text console is corrupted, use "video=aty128fb:vmode:14" at boot.
  
  
• PowerBook 3400: The penguin logo at boot is pixelated. This does not affect X nor text mode.
  
  
• PowerBook G3 (1998): On the dual-scan LCD model, the following video argument needs to be added to the BootX kernel arguments field:
  
  

  video=atyfb:vmode:10 [ENTER]

  
  
  
• G4 (PCI): DVD Decoder card, if present, can cause install to fail. Power-down your computer and disconnect the decoder card.
  
  
• Video cards: nVidia GeForce2 and ATI Radion cards are supported via the VGA port only. The Apple Display Connector (ADC) on these cards are not supported at this time. The nVidia GeForce3 is also not supported at this time.
  
  
• Reiserfs: Reiserfs as shipped with YDL 2.1 is missing some endian-safe patches. We will make an updated kernel available for those interested in using Reiserfs.
  
  
• Release notes: For other YDL 2.1 related notes, see the "RELEASE_NOTES" file on the Install CD-ROM.