distrib/notes/amiga/upgrade

   1 .\"     $NetBSD: upgrade,v 1.27 2008/09/07 05:08:42 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 The upgrade path to
  28 .Nx \*V
  29 documented here is by binary sets.
  30 .Pp
  31 To do the upgrade, you must have the
  32 .Nx
  33 kernel on
  34 .Tn AmigaDOS
  35 and you must transfer the miniroot file system
  36 .Pa miniroot.fs
  37 onto the swap partition of the
  38 .Nx
  39 hard disk.
  40 You must also have at least the
  41 .Sy base
  42 binary distribution set available.
  43 Finally, you must have sufficient disk space available to install the new
  44 binaries.
  45 Since the old binaries are being overwritten in place, you only need
  46 space for the new binaries, which weren't previously on the system.  This is
  47 typically not more than a few megabytes.
  48 .Pp
  49 Since upgrading involves replacing the kernel and most of the system
  50 binaries, it has the potential to cause data loss.
  51 You are strongly advised to BACK UP ANY IMPORTANT DATA ON YOUR DISK,
  52 whether on the
  53 .Nx
  54 partition or on another operating system's partition, before
  55 beginning the upgrade process.
  56 .Pp
  57 To upgrade your system, begin by transferring the miniroot file system
  58 onto the hard disk partition used by
  59 .Nx
  60 for swapping, as described in the "Preparing
  61 your System for
  62 .Nx
  63 Installation" section above.
  64 .Pp
  65 Now boot up
  66 .Nx ,
  67 with bootblocks installed
  68 .(Note
  69 This description is for V40 (OS 3.1) ROMs.
  70 For older ROMs, there might be small differences.
  71 Check your
  72 .Tn AmigaDOS
  73 documentation to learn about the exact procedure.
  74 Booting using bootblocks doesn't work at all on some systems, and may
  75 require a mountable file system on others.
  76 .Note)
  77 .Pp
  78 Reboot your machine, holding down both mouse buttons if you
  79 have a 2-button mouse, the outer mouse buttons if you have
  80 a 3-button mouse.
  81 On the DraCo, press the left mouse button instead,
  82 when the boot screen prompts you for it.
  83 .Pp
  84 From the boot menu, select
  85 .Ic Boot Options .
  86 Select the swap partition with the miniroot, and then
  87 .Ic ok .
  88 Select
  89 .Ic Boot
  90 now.
  91 The machine will boot the bootblock, which will prompt you for a command line.
  92 You have a few seconds to change the default.
  93 Entering an empty line will accept the
  94 default.
  95 .Pp
  96 The bootblock uses command lines of the form:
  97 .br
  98 .Ar \ \ \ \ file Op Ar options
  99 .br
 100 where
 101 .Ar file
 102 is the kernel file name on the partition where the
 103 boot block is on, and
 104 .Ar options
 105 may contain the same as described in the INSTALL section.
 106 .Pp
 107 For installing, use
 108 .Dl Ic "netbsd -b"
 109 .Pp
 110 If you machine has a split memory space, like, e.g., DraCo
 111 machines, use this instead:
 112 .Pp
 113 .Dl Ic "netbsd -bn2"
 114 .Pp
 115 .
 116 .Ss2 Once your kernel boots
 117 .
 118 You should see the screen clear and some information about
 119 your system as the kernel configures the hardware.
 120 Note which hard disk device is configured that contains your root
 121 .Pq Pa /
 122 and swap partitions.
 123 When prompted for the root device, type
 124 .Li sd0b
 125 (replacing
 126 .Sq Li 0
 127 with the disk number that
 128 .Nx
 129 used for
 130 your root/swap device).
 131 When prompted for a dump device, answer
 132 .Sq Ic none
 133 for the upgrade.
 134 (For a normal boot, you would tell it one of the swap devices).
 135 When prompted for the root file system type, confirm
 136 .Sq Ic generic ,
 137 which will auto-detect it.
 138 .Pp
 139 You will be presented with some information about the upgrade
 140 process and a warning message, and will be asked if you wish
 141 to proceed with the upgrade process.
 142 If you answer negatively, the upgrade process will stop, and your disk will
 143 not be modified.
 144 If you answer affirmatively, the upgrade process will begin,
 145 and your disk will be modified.
 146 You may press
 147 .Key CONTROL-C
 148 to stop the upgrade process at any time.
 149 However, if you press it at an inopportune moment, your system
 150 may be left in an inconsistent (and possibly unusable) state.
 151 .Pp
 152 You will now be greeted and reminded of the fact that this is a
 153 potentially dangerous procedure and that you should not upgrade the
 154 .Sy etc
 155 set.
 156 .Pp
 157 When you decide to proceed, you will be prompted to enter your root disk.
 158 After you've done this, it will be checked
 159 automatically to make sure that the file system is in a sane
 160 state before making any modifications.
 161 After this is done, you will be asked if you want to configure your network.
 162 .Pp
 163 You are now allowed to edit your fstab, but normally you don't have to.
 164 Note that the upgrade-kit uses its own copy of the fstab.
 165 Whatever you do here
 166 .Em won't
 167 affect your actual fstab.
 168 After you are satisfied with your fstab, the upgrade-kit will check
 169 all file systems mentioned in it.
 170 When they're ok, they will be mounted.
 171 .Pp
 172 You will now be asked if your sets are stored on a normally
 173 mounted file system.
 174 You should answer
 175 .Sq Ic y
 176 to this question if
 177 you have the sets stored on a file system that was present in the fstab.
 178 The actions you should take for the set extraction
 179 are pretty logical (we think).
 180 .Pp
 181 After you have extracted the sets, the upgrade kit will proceed
 182 with setting the timezone and installing the kernel and bootcode.
 183 This is all exactly the same as described in the installation
 184 section.
 185 .Pp
 186 .Em Your system has now been upgraded to
 187 .Nx \*V .
 188 .Pp
 189 After a new kernel has been copied to your hard disk, your
 190 machine is a complete
 191 .Nx \*V
 192 system.
 193 However, that doesn't mean that you're finished with the upgrade process.
 194 There are several things that you should do, or might have to
 195 do, to insure that the system works properly.
 196 .Pp
 197 You will probably want to get the
 198 .Sy etc
 199 distribution,
 200 extract it, and compare its contents with those in your
 201 .Pa /etc
 202 directory.
 203 You will probably want to replace some of your
 204 system configuration files, or incorporate some of the changes
 205 in the new versions into yours.
 206 .Pp
 207 You will want to delete old binaries that were part
 208 of the version of
 209 .Nx
 210 that you upgraded from and have since
 211 been removed from the
 212 .Nx
 213 distribution.