NetBSD/distrib/notes/pc532/upgrade

.\"	$NetBSD: upgrade,v 1.9 1999/01/25 23:34:23 garbled Exp $
.\"
.\" Copyright (c) 1999 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.
.\" 3. All advertising materials mentioning features or use of this software
.\"    must display the following acknowledgement:
.\"        This product includes software developed by the NetBSD
.\"        Foundation, Inc. and its contributors.
.\" 4. Neither the name of The NetBSD Foundation nor the names of its
.\"    contributors may be used to endorse or promote products derived
.\"    from this software without specific prior written permission.
.\"
.\" 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 to NetBSD \*V is a binary upgrade; it can be quite difficult
to advance to a later version by recompiling from source due primarily
to interdependencies in the various components.
.Pp
To do the upgrade, you must have at least base.tgz on disk and
a copy of the proper netbsd.default.  It will require quite a bit
of disk space to do the upgrade.
.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
NetBSD partition or on another operating system's partition, before
beginning the upgrade process.
.Pp
To upgrade your system, follow the following instructions:
.Bl -bullet
.It
Assuming you have space, load the .tgz files onto disk
some place.  Then boot the floppy-144.fs image via the
method you use.  Under the install system, extract the
\&.tgz files as mentioned below or read the i386 INSTALL
notes for how to use sysinst.
.It
Extract the .tgz files.
For example, to extract base.tgz:
.Dl Ic cd / 
.Dl Ic pax -zrvpe -f /gz.files/base.tgz
.It
Extract all the .tgz files you want.  You should carefully
work at upgrading /etc.  There may be changes to file formats
depending on what version of NetBSD/pc532 you are running.
.It
.Em Be careful if you are not running with security.
The \*V distribution does contain support for password encryption.
If you are upgrading from 1.0, it would be reasonable to save a
copy of master.passwd and remove all passwords until after you
upgrade.  (NetBSD-1.0 did not ship with password encryption.)
.It
Place netbsd.default in / as the file netbsd.
.It
Reboot.  (Remember, detbsd.default is a 9600 console line
kernel.  Read the last part of the new installation part of
these notes to find out how to change your default speed.)
.It
After reboot, you should make sure you check your new file systems.
.El