distrib/notes/macppc/prep

   1 .\"     $NetBSD: prep,v 1.43 2009/04/23 01:56:49 snj Exp $
   2 .
   3 .Ss2 Prepare yourself
   4 .
   5 Take a deep breath.
   6 .Pp
   7 Good.
   8 Now, make sure you are reading the PostScript or HTML version of this
   9 document, as the
  10 .Pa \&.txt No and Pa \&.more
  11 versions lack important formatting information that will prevent you from
  12 following the twisted path documented below.
  13 OK, good.
  14 Now, print out this document.
  15 .Pp
  16 While it's printing, get some coffee, relax a bit, and mentally prepare
  17 yourself for something that promises to be confusing, frustrating, and
  18 annoying.
  19 If you assume the worst, you'll be pleasantly surprised when
  20 everything works easier than you expected.
  21 Also, forget everything you've been told about installing
  22 .Nx*M .
  23 That's right, flush your knowledge cache -- some of it is almost
  24 certainly dirty.
  25 .Pp
  26 Some of this document assumes familiarity with
  27 .Tn MacOS ,
  28 e.g. how to download BinHex files and extract things with StuffIt Expander.
  29 If you've never heard of those terms before, it is possible to
  30 install
  31 .Nx*M
  32 without booting or knowing how to use
  33 .Tn MacOS ,
  34 but depending on your model it may be almost as painful as learning a
  35 little
  36 .Tn MacOS .
  37 See the FAQ for more help:
  38 .Lk http://www.NetBSD.org/ports/macppc/faq.html#macos-newbie
  39 .Pp
  40 It's done printing?  Fine, time to get started.
  41 .Pp
  42 The recommended installation procedure is as follows:
  43 .(enum
  44 Go to the
  45 .Nx*M
  46 model support page and look up your model information and issues (I can't
  47 stress this enough times).
  48 .Lk http://www.NetBSD.org/ports/macppc/models.html
  49 .Pp
  50 .It
  51 Spend about 15 minutes and read through this document from this point onward.
  52 There will be many pages of instructions that apply to Open Firmware versions
  53 that you do not have.  Throw them out.  Do not read them \(em at best you
  54 will be confused, at worst you may damage your system, requiring repairs.
  55 .Pp
  56 .It
  57 Now create your bootable media and media for the distribution sets.
  58 .Pp
  59 .It
  60 Prepare your machine, depending on the instructions for your model
  61 (for example: partition your drive, download and run System Disk, or hook
  62 up a serial console).
  63 .Pp
  64 .It
  65 Boot into Open Firmware and verify that it has the version of Open
  66 Firmware you think it does.
  67 Also make sure that the other variables are set correctly.
  68 .Pp
  69 .It
  70 Figure out the correct boot command and boot your machine from the
  71 bootable media you just created.
  72 If you're having trouble, be sure to read the section on
  73 .Sx "Common Problems and Error Messages"
  74 .Pp
  75 .It
  76 Celebrate!
  77 The worst is over, but you've still got some work to do.
  78 Take a break, maybe more coffee, maybe a quick walk around the block,
  79 whatever turns your fancy.
  80 .Pp
  81 .It
  82 Now use the installer to install the distribution sets onto your system
  83 and do some initial configuration.
  84 .Pp
  85 .It
  86 Figure out how to boot from the installed partition.
  87 Boot into
  88 .Nx
  89 for the first time.
  90 .Pp
  91 .It
  92 You may then boot into Open Firmware and set it to always boot your
  93 favorite operating system.
  94 .Pp
  95 .It
  96 Configure to your preferences, install your favorite packages, and have
  97 fun with your new
  98 .Nx*M
  99 machine!
 100 .enum)
 101 .Pp
 102 .(Note
 103 You really actually truly do need to follow the procedure listed in this
 104 document in the order that we describe.
 105 These systems are rather tricky to boot for the novice and expert alike.
 106 Once you cross off the sections that don't apply to you,
 107 it will make more sense.
 108 .Note)
 109 .(Note
 110 If the instructions in a subsection below do not apply to
 111 .Em all
 112 versions of Open Firmware.
 113 There will be a line listing which versions of
 114 Open Firmware they apply to, such as:
 115 .br
 116 (Open Firmware 1.0.5, Open Firmware 1.1.22, Open Firmware 2.0.x, Open
 117 Firmware 2.4, Open Firmware 3)
 118 .Note)
 119 If you do not have an Open Firmware 3 system, skip down to
 120 .Sx "Preparing your Open Firmware 1.x or 2.x System for NetBSD"
 121 .
 122 .Ss "Preparing your Open Firmware 3 System for NetBSD"
 123 .
 124 .ds OF_VERSION_12 0
 125 .ds OF_VERSION_3 1
 126 .so prep.OPENFIRMWARE -----------------------------------------------
 127 .br_ne 7P
 128 .
 129 .Ss "Preparing your Open Firmware 1.x or 2.x System for NetBSD"
 130 .
 131 .rm OF_VERSION_12
 132 .rm OF_VERSION_3
 133 .ds OF_VERSION_12 1
 134 .ds OF_VERSION_3 0
 135 .so prep.OPENFIRMWARE -----------------------------------------------
 136 .br_ne 7P
 137 .rm OF_VERSION_12
 138 .rm OF_VERSION_3