Home | History | Annotate | Line # | Download | only in x68k
upgrade revision 1.13
 $NetBSD: upgrade,v 1.13 2000/10/29 14:08:12 lukem Exp $

Copyright (c) 1999, 2000 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.

. .so ../common/upgrade

p Upgrading procedure using the c script installer is much more complicated than that with c sysinst installer. When the installer comes up, you will be presented with a welcome message and a prompt asking whether you are going to c install .Nx or c upgrade an exisiting system. Select c upgrade to start.

p .(enum You will be presented with some information about the upgrade process and a warning message, and will be asked if you wish to proceed with the upgrade process. If you answer negatively, the upgrade process will stop, and your disk will not be modified. If you answer affirmatively, the upgrade process will begin, and your disk will be modified. You may press .Key CONTROL-C to stop the upgrade process at any time. However, if you press it at an inopportune moment, your system may be left in an inconsistent (and possibly unusable) state. t You will be asked if you wish to upgrade your file systems to the new file system format. If you do, reply affirmatively. If you don't have your file systems upgraded now, you should probably do it manually after the install process is complete, by using c "fsck -c 2" . Read the .Xr fsck 8 manual page for more details. Note that this step is only important when upgrading from a pre .Nx 1.0 release. t The upgrade program will then check your root file system, and, if you approved, will upgrade it to the new file system format. It will then mount your root file system on

a /mnt . t If your file systems are being upgraded, the upgrade script will copy the new .Xr fsck 8 program to your hard disk and upgrade your remaining file systems. t The upgrade program will then automatically replace the boot blocks on your disk with newer versions, and mount all of your file systems under .pa /mnt . (In other words, your

a / (root) partition will be mounted on

a /mnt , your

a /usr partition on

a /mnt/usr , etc.) t If you don't already have the .Nx distribution sets on your disk, look in the installation section for information on how to transfer them to your disk. t If you don't have the disk space to copy all of the distribution onto the hard drive, you can install a kernel on the hard drive as detailed a few paragraphs below, then boot off the hard drive. Now you can copy and install distribution sets incrementally from your lone floppy drive.

p Once the distribution sets are transferred to your disk, continue here. (Obviously, if the .Nx distribution sets are already on your disk, because you've transferred them before starting the upgrade process, you don't need to transfer them again now!) t After the software has been transferred to the machine (or mounted, in the case of upgrading via NFS or CD-ROM), change into the directory containing the

a base.tgz distribution set. Once you are there, run the c Set_tmp_dir command, and press .Key return at the prompt to select the default answer for the temporary directory's path name. (It should be the path name of the directory that you're in.) t Run the command c "Extract kern" to upgrade the kernel. t Run the command c "Extract base" to upgrade the base distribution. t Repeat the above two steps for all of the sets you wish to upgrade. (For each, change into the directory containing the set, run c Set_tmp_dir and accept the default path name, then run the c "Extract <setname>" command.) t If you were previously using the security distribution set, you .Em must upgrade to the new version, or you will not be able to log in when the upgrade process is complete. Similarly, if you were not previously using the security set, you must .Em not upgrade to the new version. t When you are done upgrading all of the distribution sets you wish to upgrade, issue the command c Cleanup . It will clean up the installation, by remaking some system databases. When it is complete, all you have to do is to .Xr reboot 8 your system. .enum)

p .Em Your system has now been upgraded to .Nx \*V .

p After a new kernel has been copied to your hard disk, your machine is a complete .Nx \*V system. However, that doesn't mean that you're finished with the upgrade process. There are several things that you should do, or might have to do, to insure that the system works properly.

p First, if you did not upgrade your file systems to the new file system format during the upgrade process, and you are upgrading from a pre .Nx 1.0, you may want to do so now, with c "fsck -c 2" . If you are unsure about the process, it's suggested that you read the .Xr fsck 8 manual page.

p Second, you will probably want to get the etc distribution, extract it, and compare its contents with those in your

a /etc directory. You will probably want to replace some of your system configuration files, or incorporate some of the changes in the new versions into yours.

p Third, you will probably want to update the set of device nodes you have in

a /dev . If you've changed the contents of

a /dev by hand, you will need to be careful about this, but if not, you can just c cd into

a /dev , and run the command c "sh MAKEDEV all" .

p Fourth, you must deal with certain changes in the formats of some of the configuration files. The most notable change is that the .Sq options given to many of the file systems in

a /etc/fstab or by hand have changed, and some of the file systems have changed names. .Em Important: any instances of .Sy ufs .Em in

a /etc/fstab .Em must be changed to .Sy ffs . To find out what the new options are, it's suggested that you read the manual page for the file system's mount commands, for example .Xr mount_nfs 8 for NFS. .(Note The information for mounts of type .Em ffs , i.e. Fast File System, is contained in the .Xr mount 8 man page. .Note)

p Finally, you will want to delete old binaries that were part of the version of .Nx that you upgraded from and have since been removed from the .Nx distribution. If you are upgrading from a pre .Nx 1.0, you might also want to recompile any locally-built binaries, to take advantage of the shared libraries. (Note that any new binaries that you build will be dynamically linked, and therefore take advantage of the shared libraries, by default. For information on how to make statically linked binaries, see the .Xr cc 1 and .Xr ld 1 manual pages.)