distrib/notes/sparc64/install

   1 .\"     $NetBSD: install,v 1.30 2008/09/07 05:09:47 tsutsui Exp $
   2 .\"
   3 .\" Copyright (c) 1999-2002 The NetBSD Foundation, Inc.
   4 .\" All rights reserved.
   5 .\"
   6 .\" Redistribution and use in source and binary forms, with or without
   7 .\" modification, are permitted provided that the following conditions
   8 .\" are met:
   9 .\" 1. Redistributions of source code must retain the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer.
  11 .\" 2. Redistributions in binary form must reproduce the above copyright
  12 .\"    notice, this list of conditions and the following disclaimer in the
  13 .\"    documentation and/or other materials provided with the distribution.
  14 .\"
  15 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
  16 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
  17 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  18 .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
  19 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  20 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  21 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  22 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  23 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  24 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  25 .\" POSSIBILITY OF SUCH DAMAGE.
  26 .\"
  27 .
  28 Installing
  29 .Nx
  30 is a relatively complex process, but if you have
  31 this document in hand it shouldn't be too much trouble.
  32 .Pp
  33 There are several ways to install
  34 .Nx
  35 onto a disk.
  36 The easiest way in terms of preliminary setup is to install from CD-ROM.
  37 If you don't have access to a CD-ROM or CD-ROM burner, you
  38 can use a miniroot image that can be booted off your local disk's swap
  39 partition.
  40 Alternatively, if your UltraSPARC is hooked up in a network
  41 you can find a server and arrange for a diskless setup which is a convenient
  42 way to install on a machine whose disk does not currently hold a usable
  43 operating system (see the section
  44 .Sx Installing NetBSD by using a diskless setup
  45 below).
  46 .Pp
  47 If you have problems with these or you are installing
  48 .Nx
  49 onto the same disk as
  50 .Tn Solaris ,
  51 see the section below on
  52 .Sx "Manual Installation of NetBSD using Solaris"
  53 .
  54 .Ss2 Installing NetBSD from CD-ROM
  55 .
  56 Installing from CD-ROM is the least painful way to install
  57 .Nx .
  58 Simply insert the CD-ROM in the drive, power up the computer, and type:
  59 .(disp
  60 .No ok Ic "boot cdrom"
  61 .disp)
  62 .Pp
  63 This Open Firmware boot command will cause the
  64 .Nx
  65 kernel contained in the CD-ROM to be booted.
  66 After the initial probe messages you'll be
  67 asked to start the install or upgrade procedure.
  68 Proceed to the section
  69 .Sx "Running the sysinst installation program"
  70 below.
  71 .
  72 .Ss2 Installing NetBSD by using the NetBSD miniroot
  73 .
  74 The miniroot is a self-contained
  75 .Nx
  76 file system holding all utilities
  77 necessary to install
  78 .Nx
  79 on a local disk.
  80 It is distributed as a plain
  81 file designed to be transferred to a raw disk partition from which it can
  82 be booted using the appropriate OpenFirmware command.
  83 Usually, the miniroot will be loaded into the swap partition of a disk.
  84 If needed, you can use any other unused partition,
  85 but remember that the partition will then not
  86 available during the installation process.
  87 .Pp
  88 Loading the miniroot onto your raw partition is simple using the
  89 .Xr dd 1
  90 command.  Just remember to first uncompress the miniroot image and boot
  91 your OS with the
  92 .Li -s
  93 flag so that it runs
  94 .Dq "single-user"
  95 and does not attempt to start swapping.
  96 .(disp
  97 .No ok Ic "boot -s"
  98 .disp)
  99 .Pp
 100 On
 101 .Tn Solaris
 102 you use a command like:
 103 .(disp
 104 .No # Ic "gunzip miniroot.fs.gz"
 105 .No # Ic "dd if=miniroot.fs of=/dev/rdsk/c0t0d0s1 bs=4k"
 106 .disp)
 107 On
 108 .Nx
 109 the command is:
 110 .(disp
 111 .No # Ic "gunzip miniroot.fs.gz"
 112 .No # Ic "dd if=miniroot.fs of=/dev/rsd0b bs=4k"
 113 .disp)
 114 Replace
 115 .Li /dev/rdsk/c0t0d0s1
 116 or
 117 .Li /dev/rsd0b
 118 with your swap partition.
 119 .Pp
 120 After transferring the miniroot to disk, bring the system down by:
 121 .(disp
 122 .No # Ic halt
 123 .disp)
 124 Then boot the miniroot by typing the appropriate command at the
 125 OpenFirmware prompt:
 126 .(disp
 127 .No ok Ic "boot disk:b netbsd"
 128 .disp)
 129 If you've loaded the miniroot onto some other disk than
 130 .Li sd0
 131 use the correct
 132 .Pa devalias ,
 133 such as
 134 .(disp
 135 .No ok Ic "boot disk1:b netbsd"
 136 .disp)
 137 This Open Firmware boot command will cause the
 138 .Nx
 139 kernel contained in the
 140 miniroot image to be booted.
 141 After the initial probe messages you'll be
 142 asked to start the install or upgrade procedure.
 143 Proceed to the section
 144 .Sx "Running the sysinst installation program"
 145 below.
 146 .
 147 .Ss2 Installing NetBSD by using a NetBSD kernel on a Solaris partition
 148 .
 149 This procedure is very straightforward.  You will be putting the
 150 .Nx
 151 installation kernel (kernel with a RAM disk installer) on your
 152 .Tn Solaris
 153 partition and telling Open Firmware to boot the
 154 .Nx
 155 kernel.
 156 .Pp
 157 CAVEAT: this method is a bit fragile.  Depending on physical partition layout,
 158 partition size, and parameters used to create the filesystem of your
 159 .Tn Solaris
 160 root partition, bugs in the bootloader might be triggered and cause this
 161 method to fail.
 162 .Pp
 163 First, copy the
 164 .Pa netbsd-INSTALL.gz
 165 kernel and bootloader to the root level of your hard drive and halt your
 166 system
 167 .(disp
 168 .No # Ic "cp binary/kernel/netbsd-INSTALL.gz /"
 169 .No # Ic "cp installation/misc/ofwboot /"
 170 .No # Ic "halt"
 171 .disp)
 172 At the Open Firmware prompt, boot
 173 .Nx .
 174 .(disp
 175 .No ok Ic "boot disk:a /ofwboot -a"
 176 .disp)
 177 The
 178 .Li -a
 179 flag is needed so that the bootloader will ask you to find your
 180 installation kernel.
 181 .(disp
 182 Rebooting with command: boot disk:a /ofwboot -a
 183 Boot device: /pci@1f,4000/scsi@3/disk@0,0:a  File and args: /ofwboot -a
 184 .No Enter filename [/ofwboot]: Ic "\*[Lt]return\*[Gt]
 185 \*[Gt]\*[Gt] NetBSD/sparc64 OpenFirmware Boot, Revision 1.7
 186 \*[Gt]\*[Gt] (autobuild@tgm.netbsd.org, Thu May 20 16:29:20 UTC 2004)
 187 .No Boot: Ic netbsd-INSTALL.gz
 188 .disp)
 189 After the initial probe messages you'll be
 190 asked to start the install or upgrade procedure.
 191 Proceed to the section
 192 .Sx "Running the sysinst installation program"
 193 below.
 194 .
 195 .Ss2 Installing NetBSD by using a netboot setup
 196 .
 197 .so ../common/netboot
 198 .Pp
 199 Now, netboot your system from the server by entering the appropriate
 200 .Ic boot
 201 command at the Open Firmware prompt.
 202 .(disp
 203 .No ok Ic "boot net netbsd"
 204 .disp)
 205 After the initial probe messages you'll be
 206 asked to start the install or upgrade procedure.
 207 Proceed to the section
 208 .Sx "Running the sysinst installation program"
 209 below.
 210 .
 211 .so ../common/sysinst
 212 .Pp
 213 Skip down to the section on
 214 .Sx "Booting NetBSD for the first time"
 215 .
 216 .Ss2 Manual Installation of NetBSD using Solaris
 217 .
 218 (Adapted from Murray Stokely's \*[Lt]murray@osd.bsdi.com\*[Gt] instructions)
 219 .Pp
 220 You can use
 221 .Tn Solaris
 222 to prepare the
 223 .Nx
 224 user-friendly installer or to perform a full manual installation of
 225 .Nx .
 226 If you want to use the user-friendly miniroot installer or RAM disk
 227 installation kernel, follow the sections
 228 .Sx "Installing NetBSD by using the NetBSD miniroot"
 229 or
 230 .Sx "Installing NetBSD by using a NetBSD kernel on a Solaris partition" .
 231 .Pp
 232 Manual installation from Solaris 10 is not possible because NetBSD
 233 cannot use the resulting UFS file system.  It is possible to install
 234 Solaris 10 and NetBSD on the same disk.  To do so, partition the disk
 235 with the Solaris format command, then boot NetBSD and perform a manual
 236 installation.  Be careful not to write a NetBSD disklabel.  Use the
 237 disklabel command to read the partition size, as constructed from the
 238 Solaris disklabel.  By default the NetBSD newfs command writes a NetBSD
 239 disklabel.  Avoid this by using the -F and -s arguments to newfs.
 240 .Pp
 241 .(bullet
 242 .To 2 "Preparing the disk in Solaris"
 243 .Em "Preparing the disk in Solaris"
 244 .Pp
 245 The first step is to format and label the disk that you would like to
 246 use with
 247 .Nx .
 248 This can be accomplished with the
 249 .Xr format 1M
 250 command in Solaris, which allows you to partition a disk and write a
 251 disklabel.  It also is used to perform a low-level format on SCSI drives.
 252 You will want to create a root partition and a swap partition.
 253 Depending on your preferences, you may also wish to create separate
 254 .Pa /usr No or Pa /var
 255 partitions.
 256 .Pp
 257 .(disp
 258 .No #  Ic "/usr/sbin/format"
 259 Searching for disks...
 260 Mode sense page(3) reports nsect value as 280, adjusting it to 218
 261 done
 262
 263 c0t1d0: configured with capacity of 16.95GB
 264
 265 AVAILABLE DISK SELECTIONS:
 266        0. c0t0d0 \*[Lt]SUN4.2G cyl 3880 alt 2 hd 16 sec 135\*[Gt]
 267           /pci@1f,4000/scsi@3/sd@0,0
 268        1. c0t1d0 \*[Lt]IBM-DXHS18Y-0430 cyl 8152 alt 2 hd 20 sec 218\*[Gt]
 269           /pci@1f,4000/scsi@3/sd@1,0
 270 .No "Specify disk (enter its number):" Ic 1
 271 selecting c0t1d0
 272 [disk formatted]
 273 .No "Disk not labeled.  Label it now?" Ic y
 274
 275 .No "format\*[Gt]" Ic format
 276 Ready to format.  Formatting cannot be interrupted
 277 and takes 114 minutes (estimated). Continue? y
 278 Beginning format. The current time is Sat May 29 22:15:13 2004
 279
 280 Formatting...
 281 done
 282 Verifying media...
 283         pass 0 - pattern = 0xc6dec6de
 284    8151/19/208
 285         pass 1 - pattern = 0x6db6db6d
 286    8151/19/208
 287
 288 Total of 0 defective blocks repaired.
 289 .No "format\*[Gt]" Ic partition
 290 .No "partition\*[Gt]" Ic print
 291 Current partition table (original):
 292 Total disk cylinders available: 8152 + 2 (reserved cylinders)
 293
 294 Part      Tag    Flag     Cylinders        Size            Blocks
 295   0       root    wm       0 -   60      129.86MB    (61/0/0)     265960
 296   1       swap    wu      61 -  121      129.86MB    (61/0/0)     265960
 297   2     backup    wu       0 - 8151       16.95GB    (8152/0/0) 35542720
 298   3 unassigned    wm       0               0         (0/0/0)           0
 299   4 unassigned    wm       0               0         (0/0/0)           0
 300   5 unassigned    wm       0               0         (0/0/0)           0
 301   6        usr    wm     122 - 8151       16.69GB    (8030/0/0) 35010800
 302   7 unassigned    wm       0               0         (0/0/0)           0
 303
 304 .No "partition\*[Gt]" Ic label
 305 .No "Ready to label disk, continue?" Ic y
 306 .No "partition\*[Gt]" Ic quit
 307 .No "format\*[Gt]" Ic quit
 308 .disp)
 309 .Pp
 310 After your disk has been labeled you need to create file systems on
 311 your slices.
 312 The Solaris
 313 .Xr newfs 1M
 314 command will create ffs file systems that can be used by
 315 .Nx .
 316 .(disp
 317 .No # Ic "/usr/sbin/newfs /dev/dsk/c0t1d0s0"
 318 .No # Ic "/usr/sbin/newfs /dev/dsk/c0t1d0s6"
 319 .disp)
 320 .
 321 .It
 322 .To 2 "Installing NetBSD Software from Solaris"
 323 .Em "Installing NetBSD Software from Solaris"
 324 .Pp
 325 You should now mount your
 326 .Nx
 327 root and
 328 .Pa /usr
 329 partitions under Solaris so that you can populate the file systems with
 330 .Nx
 331 binaries.
 332 .(disp
 333 .No # Ic "/usr/sbin/mount /dev/dsk/c0t1d0s0 /mnt"
 334 .No # Ic "mkdir /mnt/usr"
 335 .No # Ic "/usr/sbin/mount /dev/dsk/c0t1d0s6 /mnt/usr"
 336 .disp)
 337 .Pp
 338 Now extract the distribution file sets
 339 .(disp
 340 .No # Ic "cd ~/netbsd/binary/sets"
 341 .No # Ic "gunzip *.tar.gz"
 342 .No # Ic "echo ~/netbsd/binary/sets/*.tar | (cd /mnt; xargs -n1 pax -rpe -f )"
 343 .disp)
 344 .Pp
 345 Now you should copy the
 346 .Nx
 347 second stage bootloader into your new root partition and install the
 348 bootblocks using Solaris's
 349 .Xr installboot 1M
 350 command.
 351 .(disp
 352 .No # Ic "cp ~/netbsd/installation/misc/ofwboot /mnt"
 353 .No # Ic "/usr/sbin/installboot ~/netbsd/installation/misc/bootblk /dev/rdsk/c0t1d0s0"
 354 .disp)
 355 .
 356 .It
 357 .To 2 "Creating NetBSD Device Nodes under Solaris"
 358 .Em "Creating NetBSD Device Nodes under Solaris"
 359 .Pp
 360 This is not a necessary step.  If your
 361 .Pa /dev
 362 directory is empty,
 363 .Xr init 8
 364 will create a RAM disk with all of the
 365 essential device nodes each time the system boots.  If you want to create
 366 the device nodes on disk, you will need to use the Solaris
 367 .Xr mknod 1M
 368 command.  Look in
 369 .Pa /dev/MAKEDEV
 370 for the correct names, major and minor numbers, ownership, and
 371 permissions.
 372 .
 373 .It
 374 .To 2 "Configuring the NetBSD system from Solaris"
 375 .Em "Configuring the NetBSD system from Solaris"
 376 .Pp
 377 To save effort, you may want to use your favorite Solaris editor
 378 to configure some of the files in
 379 .Pa /etc
 380 before booting into
 381 .Nx
 382 the first time.  In particular, you should look at
 383 .Pa /etc/fstab ,
 384 .Pa /etc/rc.conf ,
 385 .Pa /etc/resolv.conf ,
 386 and
 387 .Pa /etc/hosts .
 388 See the section below on
 389 .Sx "Post installation steps"
 390 before
 391 .Sx "Booting NetBSD for the first time" .
 392 .bullet)
 393 .
 394 .Ss Booting NetBSD for the first time
 395 .
 396 .Pp
 397 Now it is time to boot
 398 .Nx
 399 for the first time.
 400 You will boot from your disk using similar syntax as described above in
 401 .Sx "Setting up Open Firmware"
 402 and
 403 .Sx "Determining how to boot from an SBUS or PCI card" .
 404 To boot from your first disk, type:
 405 .(disp
 406 .No ok Ic "boot disk"
 407 .disp)