\"      $NetBSD: upgrade,v 1.28 2009/04/23 01:56:48 snj Exp $
\"
\" Copyright (c) 1999-2002 The NetBSD Foundation, Inc.
\" All rights reserved.
\"
\" Redistribution and use in source and binary forms, with or without
\" modification, are permitted provided that the following conditions
\" are met:
\" 1. Redistributions of source code must retain the above copyright
\"    notice, this list of conditions and the following disclaimer.
\" 2. Redistributions in binary form must reproduce the above copyright
\"    notice, this list of conditions and the following disclaimer in the
\"    documentation and/or other materials provided with the distribution.
\"
\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
\" POSSIBILITY OF SUCH DAMAGE.
\"
The upgrade path to
Nx \*V
documented here is by binary sets.
Pp
To do the upgrade, you must have the
Nx
kernel on
Tn AmigaDOS
and you must transfer the miniroot file system
Pa miniroot.fs
onto the swap partition of the
Nx
hard disk.
You must also have at least the
Sy base
binary distribution set available.
Finally, you must have sufficient disk space available to install the new
binaries.
Since the old binaries are being overwritten in place, you only need
space for the new binaries, which weren't previously on the system.  This is
typically not more than a few megabytes.
Pp
Since upgrading involves replacing the kernel and most of the system
binaries, it has the potential to cause data loss.
You are strongly advised to BACK UP ANY IMPORTANT DATA ON YOUR DISK,
whether on the
Nx
partition or on another operating system's partition, before
beginning the upgrade process.
Pp
To upgrade your system, begin by transferring the miniroot file system
onto the hard disk partition used by
Nx
for swapping, as described in the "Preparing
your System for
Nx
Installation" section above.
Pp
Now boot up
Nx ,
with bootblocks installed
(Note
This description is for V40 (OS 3.1) ROMs.
For older ROMs, there might be small differences.
Check your
Tn AmigaDOS
documentation to learn about the exact procedure.
Booting using bootblocks doesn't work at all on some systems, and may
require a mountable file system on others.
Note)
Pp
Reboot your machine, holding down both mouse buttons if you
have a 2-button mouse, the outer mouse buttons if you have
a 3-button mouse.
On the DraCo, press the left mouse button instead,
when the boot screen prompts you for it.
Pp
From the boot menu, select
Ic Boot Options .
Select the swap partition with the miniroot, and then
Ic ok .
Select
Ic Boot
now.
The machine will boot the bootblock, which will prompt you for a command line.
You have a few seconds to change the default.
Entering an empty line will accept the
default.
Pp
The bootblock uses command lines of the form:
br
Ar \ \ \ \ file Op Ar options
br
where
Ar file
is the kernel file name on the partition where the
boot block is on, and
Ar options
may contain the same as described in the INSTALL section.
Pp
For installing, use
Dl Ic "netbsd -b"
Pp
If you machine has a split memory space, like, e.g., DraCo
machines, use this instead:
Pp
Dl Ic "netbsd -bn2"
Pp