distrib/notes/amiga/prep

   1 .\"     $NetBSD: prep,v 1.27 2008/09/06 21:38:13 tsutsui Exp $
   2 .
   3 You will need an
   4 .Tn AmigaDOS
   5 hard drive prep tool to prepare your hard
   6 drives for use with
   7 .Nx*M .
   8 HDToolBox is provided with the
   9 system software and on floppy installation disks since Release 2.0
  10 of
  11 .Tn AmigaDOS ,
  12 so we will provide instructions for its use.
  13 .Pp
  14 Note that
  15 .Nx
  16 can't currently be installed on disks with a sector
  17 size other than 512 bytes (e.g.,
  18 .Dq 640 MB
  19 90mm M-O media).
  20 You can, however, mount ADOSFS partitions on such M-O's.
  21 .
  22 .Ss2 Preparing your hard disk with HDToolBox
  23 .
  24 .Pp
  25 A full explanation of HDToolBox can be found with your
  26 .Tn AmigaDOS
  27 manuals and is beyond the scope of this document.
  28 .Pp
  29 The first time you partition a drive, you need to set its drive
  30 type so that you have working geometry parameters.
  31 To do this you enter the
  32 .Dq Change drive type
  33 menu, and either use
  34 .Dq read parameters from drive
  35 or set them manually.
  36 .Pp
  37 Note that you will be modifying your HD's.
  38 If you mess something up here you could lose everything on all the
  39 drives that you configure.
  40 It is therefore advised that you:
  41 .(enum -offset indent
  42 Write down your current configurations.
  43 Do this by examining each partition on the drive and the
  44 drives parameters (from Change drive type.)
  45 .It
  46 Back up the partitions you are keeping.
  47 .enum)
  48 .Pp
  49 What you need to do now is partition your drives, creating at least
  50 root and swap partitions.
  51 .Pp
  52 This should be done as the HDToolBox manual describes.
  53 One thing to note is that if you are not using a Commodore controller you
  54 will need to specify the device your SCSI controller uses, e.g.,
  55 if you have a Warp Engine you would:
  56 .(tag From\ cli -offset indent
  57 .It From cli
  58 .Dl Ic "hdtoolbox warpdrive.device"
  59 .It From wb
  60 Set the tooltype
  61 .Pp
  62 .Dl Ic "SCSI_DEVICE_NAME=warpdrive.device"
  63 .tag)
  64 .Pp
  65 The important things you need to do above and beyond normal
  66 partitioning include (from Partition Drive section):
  67 .(enum
  68 Marking all
  69 .Nx
  70 partitions as non-bootable, with
  71 two exceptions: the root partition
  72 .Pq Pa /
  73 if you want to boot
  74 .Nx
  75 directly, or the swap partition if you want
  76 to boot the installation miniroot directly.
  77 .It
  78 Changing the file system parameters of the partitions to
  79 .Nx
  80 ones.
  81 This must be done from the partitioning section and
  82 .Dq Advanced options
  83 must
  84 be enabled.
  85 .enum)
  86 .Pp
  87 To make the needed changes:
  88 .Pp
  89 .(enum -compact -offset indent
  90 Click the
  91 .Dq Adv. Options
  92 button
  93 .It
  94 Click the
  95 .Dq Change file system
  96 button
  97 .It
  98 Choose
  99 .Dq Custom File System
 100 .It
 101 Turn off
 102 .Dq Automount
 103 if on.
 104 .It
 105 Set the dostype to one of these three choices:
 106 .(disp
 107 root partition  : 0x4e425207    (NBR\\007)
 108 swap partition  : 0x4e425301    (NBS\\001)
 109 other partitions: 0x4e425507    (NBU\\007)
 110 .disp)
 111 .Pp
 112 Here
 113 .Sq Li other
 114 refers to other partitions you will
 115 format for reading and writing under
 116 .Nx
 117 (e.g.,
 118 .Pa /usr )
 119 .Pp
 120 Make sure you press
 121 .Key RETURN
 122 to enter this value as some versions of HDToolBox will forget your entry
 123 if you don't.
 124 .It
 125 Turn custom boot code off
 126 .It
 127 Set Reserved Blocks start and end to 0.
 128 .It
 129 Click Ok.
 130 .enum)
 131 .Pp
 132 On the root
 133 .Pq Pa /
 134 (and, for installation, swap) partition:
 135 .Pp
 136 .(enum -compact -offset indent
 137 Turn custom boot code on
 138 .It
 139 Set Reserved Blocks start and end to 0.
 140 .It
 141 Set Number of Custom Boot Blocks to 16.
 142 .It
 143 Set Automount This Partition on
 144 .It
 145 Click Ok.
 146 .Pp
 147 Mask and maxtransfer are not used with
 148 .Nx .
 149 .enum)
 150 .(tag Caveat:
 151 .It Em Caveat:
 152 The swap (for installation) and the root partition (if you plan to
 153 use the bootblocks)
 154 .Em "must be within the first"
 155 4 gigabytes of the disk!
 156 The reason for the former is that xstreamtodev uses trackdisk.device
 157 compatible I/O-calls, the reason for the latter is that the bootblock
 158 gets a 32bit partition offset from the operating system.
 159 .tag)
 160 .Pp
 161 Once this is done
 162 .Nx*M
 163 will be able to recognize your
 164 disks and which partitions it should use.
 165 .
 166 .Ss2 Transferring the miniroot file system
 167 .
 168 The
 169 .Nx*M
 170 installation or upgrade now uses a
 171 .Em miniroot
 172 file system which is installed on the partition used by
 173 .Nx
 174 for swapping.
 175 This removes the requirement of using a floppy disk for the
 176 file system used by the installation or upgrade process.
 177 It also allows more utilities to be present on the file system
 178 than would be available when using an 880 KB floppy disk.
 179 .Pp
 180 Once the hard disk has been prepared for
 181 .Nx ,
 182 the miniroot file system
 183 .Pq Pa miniroot.fs
 184 is transferred to the swap
 185 partition configured during the hard disk prep (or the existing
 186 swap partition in the case of an upgrade).
 187 The xstreamtodev utility provided in the
 188 .Pa \*M/installation/misc
 189 directory can
 190 be used on
 191 .Tn AmigaDOS
 192 to transfer the file system for either a new
 193 installation or an upgrade.
 194 The file system can also be transferred on an existing
 195 .Nx
 196 system for an update by using dd.
 197 This should only be done after booting
 198 .Nx
 199 into single-user mode.
 200 It may also be possible to shutdown to single-user, providing that
 201 the single-user mode processes are not using the swap partition.
 202 .Pp
 203 On
 204 .Tn AmigaDOS ,
 205 run the command:
 206 .Pp
 207 .Dl Ic "xstreamtodev --input=miniroot.fs --rdb-name=\*[Lt]swap partition\*[Gt]"
 208 .Pp
 209 where \*[Lt]swap partition\*[Gt] is the name you gave to the
 210 .Nx
 211 partition to be used for swapping.
 212 If
 213 .Ic xstreamtodev
 214 is unable
 215 to determine the SCSI driver device name or the unit number
 216 of the specified partition, you may also need to include the
 217 option
 218 .Pp
 219 .Dl Ic --device=\*[Lt]driver.name\*[Gt]
 220 .Pp
 221 and/or
 222 .Pp
 223 .Dl Ic --unit=\*[Lt]SCSI unit number\*[Gt]
 224 .Pp
 225 To transfer the miniroot using
 226 .Nx ,
 227 you should be booted up
 228 in single user mode on the current
 229 .Nx
 230 system, or use the
 231 .Ic shutdown now
 232 command to shutdown to single-user mode.
 233 Then copy the miniroot using
 234 .Ic dd :
 235 .Pp
 236 .Dl Ic "dd if=miniroot.fs of=/dev/rsd0b"
 237 .Pp
 238 where
 239 .Li /dev/rsd0b
 240 should be the device path of the swap partition
 241 your system is configured to use.
 242 Once the file is copied, reboot back to
 243 .Tn AmigaDOS
 244 to boot the upgrade kernel.
 245 .(tag Caveat:
 246 .It Em Caveat:
 247 Once you have started installation, if you abort it
 248 and want to retry you must reinstall the
 249 .Pa miniroot.fs
 250 on the swap partition.
 251 .tag)