distrib/notes/common/upgrade

   1 .\"     $NetBSD: upgrade,v 1.27 2009/04/23 01:56:49 snj Exp $
   2 .\"
   3 .\" Copyright (c) 1999-2004 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 .
  29 .Pp
  30 The easiest way to upgrade to
  31 .Nx
  32 \*V
  33 is with binaries, and that is the method documented here.
  34 .Pp
  35 .ie \n[atari] \{\
  36 To do the upgrade, you must first boot the system as described in the
  37 .Sx Booting the installer
  38 section.
  39 .\}
  40 .el \{\
  41 .ie \n[mac68k]:\n[macppc]:\n[sparc]:\n[sparc64] \{\
  42 To do the upgrade, you must boot the install kernel using one of
  43 the methods described above.
  44 .\}
  45 .el \{\
  46 .ie \n[pmax] \{\
  47 To do the upgrade, you must install new bootblocks and boot off
  48 the
  49 .Ic install
  50 kernel as described in the
  51 .Sx Installing from an existing system
  52 section.
  53 .\}
  54 .el \{\
  55 .ie \n[x68k] \{\
  56 As noted above, you must have the
  57 .Pa loadbsd.x
  58 utility and the installation kernel you chose, or the
  59 boot floppies available to do the upgrade.
  60 .\}
  61 .el \{\
  62 To do the upgrade, you must have one form of boot media available.
  63 .\}\}\}\}
  64 You must also have at least the
  65 .Sy base
  66 and
  67 .Sy kern
  68 binary distribution sets available.
  69 Finally, you must have sufficient disk space available to install the
  70 new binaries.
  71 Since files already installed on the system are overwritten in place,
  72 you only need additional free space for files which weren't previously
  73 installed or to account for growth of the sets between releases.
  74 If you have a few megabytes free on each of your root
  75 .Pq Pa /
  76 and
  77 .Pa /usr
  78 partitions, you should have enough space.
  79 .Pp
  80 Since upgrading involves replacing the kernel, boot blocks,
  81 and most of the system binaries, it has the
  82 potential to cause data loss.
  83 You are strongly advised to
  84 .Em back up
  85 any important data on the
  86 .Nx
  87 partition or on
  88 another operating system's partition on your disk
  89 before beginning the upgrade process.
  90 .if \n[macppc] \{\
  91 Since installation of the bootloader will prevent
  92 .Tn Mac OS
  93 from using the disk and will prevent Open Firmware 3 machines from
  94 booting, there is an option to bypass this step.
  95 Make sure you know whether or not to install the bootloader.
  96 .\}
  97 .Pp
  98 The upgrade procedure
  99 is similar to an installation, but without the hard disk partitioning.
 100 .Ic sysinst
 101 will attempt to merge the settings stored in your
 102 .Pa /etc
 103 directory with the new version of
 104 .Nx .
 105 Also, file systems are checked before unpacking the sets.
 106 Fetching the binary
 107 sets is done in the same manner as the installation procedure;
 108 refer to the installation part of the document for help.
 109 .Pp
 110 After a new kernel has been copied to your hard disk, your
 111 machine is a complete
 112 .Nx
 113 \*V
 114 system.
 115 However, that doesn't mean that you're finished with the upgrade process.
 116 You will probably want to update the set of device
 117 nodes you have in
 118 .Pa /dev .
 119 If you've changed the contents of
 120 .Pa /dev
 121 by hand, you will need to be careful about this, but if
 122 not, you can just cd into
 123 .Pa /dev ,
 124 and run the command:
 125 .Pp
 126 .Dl # Ic "sh MAKEDEV all"
 127 .Pp
 128 Finally, you will want to delete old binaries that were part
 129 of the version of
 130 .Nx
 131 that you upgraded from and have since been removed from the
 132 .Nx
 133 distribution.