Home | History | Annotate | Line # | Download | only in amiga
upgrade revision 1.2.2.3
      1      1.2  chopps The upgrade to NetBSD 1.1 is a binary upgrade; it would be prohibitive
      2      1.2  chopps to make users upgrade by compiling and installing the 1.1 sources, and
      3      1.2  chopps it would be very difficult to even compile a set of instructions that
      4      1.2  chopps allowed them to do so.  Because of the various changes to the system,
      5      1.2  chopps the largest being the 64-bit file size support and shared libraries,
      6      1.2  chopps it is impractical to upgrade by recompiling from the sources and
      7      1.2  chopps installing.
      8      1.2  chopps 
      9  1.2.2.1  chopps To do the upgrade, you must have the NetBSD kernel on AmigaDOS and
     10  1.2.2.1  chopps you must transfer the upgrade filesystem upgr-11.fs onto the swap
     11  1.2.2.1  chopps partition of the NetBSD hard disk.  You must also have at least the
     12  1.2.2.1  chopps "base11" binary distribution set available, so that you can upgrade
     13  1.2.2.1  chopps with it, using one of the upgrade methods described above.  Finally,
     14  1.2.2.1  chopps you must have sufficient disk space available to install the new
     15  1.2.2.1  chopps binaries.  Since the old binaries are being overwritten in place,
     16  1.2.2.1  chopps you only need space for the new binaries, which weren't previously
     17  1.2.2.1  chopps on the system.  If you have a few megabytes free on each of your
     18  1.2.2.1  chopps root and /usr partitions, you should have enough space.
     19      1.2  chopps 
     20      1.2  chopps Since upgrading involves replacing the kernel, and most of the system
     21      1.2  chopps binaries, it has the potential to cause data loss.  You are strongly
     22      1.2  chopps advised to BACK UP ANY IMPORTANT DATA ON YOUR DISK, whether on the
     23      1.2  chopps NetBSD partition or on another operating system's partition, before
     24      1.2  chopps beginning the upgrade process.
     25      1.2  chopps 
     26      1.2  chopps To upgrade your system, follow the following instructions:
     27      1.2  chopps 
     28  1.2.2.1  chopps 	Transfer the upgrade miniroot filesystem onto the hard disk
     29  1.2.2.1  chopps 	partition used by NetBSD for swapping, as described in the
     30  1.2.2.1  chopps 	"Preparing your System for NetBSD Installation" section above.
     31  1.2.2.1  chopps 
     32  1.2.2.1  chopps 	Now boot up NetBSD using the 1.1 kernel using the loadbsd
     33  1.2.2.1  chopps 	command:
     34  1.2.2.1  chopps 
     35  1.2.2.1  chopps 		loadbsd -b netbsd
     36  1.2.2.1  chopps 
     37  1.2.2.1  chopps 	You should see the screen clear and some information about
     38  1.2.2.1  chopps 	your system as the kernel configures the hardware.  Note which
     39  1.2.2.1  chopps 	hard disk device is configured that contains your root and
     40  1.2.2.1  chopps 	swap partition.  When prompted for the root device, type
     41  1.2.2.1  chopps 	'sd0*' (replacing 0 with the disk number that NetBSD used for
     42  1.2.2.1  chopps 	your root/swap device).  The '*' character indicates that the
     43  1.2.2.1  chopps 	root filesystem is contained on the swap partition.
     44  1.2.2.1  chopps 	When you reach the prompt asking you for a shell name, just
     45  1.2.2.1  chopps 	hit return.
     46      1.2  chopps 
     47      1.2  chopps 	You will be presented with some information about the upgrade
     48      1.2  chopps 	process and a warning message, and will be asked if you wish
     49      1.2  chopps 	to proceed with the upgrade process.  If you answer
     50      1.2  chopps 	negatively, the upgrade process will stop, and your disk will
     51      1.2  chopps 	not be modified.  If you answer affirmatively, the upgrade
     52      1.2  chopps 	process will begin, and your disk will be modified.  You may
     53      1.2  chopps 	hit Control-C to stop the upgrade process at any time.
     54      1.2  chopps 	However, if you hit it at an inopportune moment, your system
     55      1.2  chopps 	may be left in an inconsistent (and possibly unusable) state.
     56      1.2  chopps 
     57      1.2  chopps 	You will be asked if you wish to upgrade your file systems to
     58      1.2  chopps 	the new file system format.  If you do, reply affirmatively.
     59      1.2  chopps 	If you don't have your file systems upgraded now, you should
     60      1.2  chopps 	probably do it manually after the install process is complete,
     61      1.2  chopps 	by using "fsck -c 2". Read the fsck(8) manual page for more
     62      1.2  chopps 	details.
     63      1.2  chopps 
     64      1.2  chopps 	The upgrade program will then check your root file system,
     65      1.2  chopps 	and, if you approved, will upgrade it to the new file system
     66      1.2  chopps 	format.  It will then mount your root file system on /mnt.
     67      1.2  chopps 
     68      1.2  chopps 	If your file systems are being upgraded, the upgrade script
     69      1.2  chopps 	will copy the new fsck(8) program to your hard disk and
     70      1.2  chopps 	upgrade your remaining file systems.
     71      1.2  chopps 
     72      1.2  chopps 	The upgrade program will then mount all of your file systems
     73      1.2  chopps 	under /mnt.  (In other words, your root partition will be
     74      1.2  chopps 	mounted on /mnt, your /usr partition on /mnt/usr, etc.)
     75      1.2  chopps 
     76      1.2  chopps 	If you don't already have the NetBSD distribution sets on your
     77      1.2  chopps 	disk, look in the installation section for information on how
     78      1.2  chopps 	to transfer them to your disk.
     79      1.2  chopps 
     80      1.2  chopps 	Once the distribution sets are transferred to your disk,
     81      1.2  chopps 	continue here.  (Obviously, if the NetBSD distribution sets
     82      1.2  chopps 	are already on your disk, because you've transferred them
     83      1.2  chopps 	before starting the upgrade process, you don't need to
     84      1.2  chopps 	transfer them again now!)
     85      1.2  chopps 
     86      1.2  chopps 	After the software has been transferred to the machine (or
     87      1.2  chopps 	mounted, in the case of upgrading via NFS), change into the
     88      1.2  chopps 	directory containing the "base11" distribution set.  Once you
     89      1.2  chopps 	are there, run the "Set_tmp_dir" command, and hit return at
     90      1.2  chopps 	the prompt to select the default answer for the temporary
     91      1.2  chopps 	directory's path name.  (It should be the path name of the
     92      1.2  chopps 	directory that you're in.)
     93      1.2  chopps 
     94      1.2  chopps 	Run the command "Extract base11" to upgrade the base
     95      1.2  chopps 	distribution.
     96      1.2  chopps 
     97      1.2  chopps 	Repeat the above two steps for all of the sets you wish to
     98      1.2  chopps 	upgrade.  (For each, change into the directory containing the
     99      1.2  chopps 	set, run "Set_tmp_dir" and accept the default path name, then
    100      1.2  chopps 	run the "Extract <setname>" command.)
    101      1.2  chopps 
    102      1.2  chopps 	If you were previously using the security distribution set,
    103      1.2  chopps 	you MUST upgrade to the new version, or you will not be able
    104      1.2  chopps 	to log in when the upgrade process is complete.  Similarly, if
    105      1.2  chopps 	you were not previously using the security set, you must NOT
    106      1.2  chopps 	upgrade to the new version.
    107      1.2  chopps 
    108      1.2  chopps 	When you are done upgrading all of the distribution sets you
    109      1.2  chopps 	wish to upgrade, issue the command "Cleanup".  It will clean
    110      1.2  chopps 	up the installation, by remaking some system databases.  When
    111      1.2  chopps 	it is complete, you should use "halt" to halt the system.
    112      1.2  chopps 
    113  1.2.2.2  chopps 	You will probably also want to copy the release "netbsd" kernel
    114  1.2.2.2  chopps 	image to your root at some point.
    115  1.2.2.2  chopps 	
    116      1.2  chopps Your system has now been upgraded to NetBSD 1.1.
    117      1.2  chopps 
    118      1.2  chopps After a new kernel has been copied to your hard disk, your
    119      1.2  chopps 	machine is a complete NetBSD 1.1 system.  However, that
    120      1.2  chopps 	doesn't mean that you're finished with the upgrade process.
    121      1.2  chopps 	There are several things that you should do, or might have to
    122      1.2  chopps 	do, to insure that the system works properly.
    123      1.2  chopps 
    124      1.2  chopps 	First, if you did not upgrade your file systems to the new
    125      1.2  chopps 	file system format during the upgrade process, you may want to
    126      1.2  chopps 	do so now, with "fsck -c 2".  If you are unsure about the
    127      1.2  chopps 	process, it's suggested that you read the fsck(8) manual page.
    128      1.2  chopps 
    129      1.2  chopps 	Second, you will probably want to get the etc11 distribution,
    130      1.2  chopps 	extract it, and compare its contents with those in your /etc/
    131      1.2  chopps 	directory.  You will probably want to replace some of your
    132      1.2  chopps 	system configuration files, or incorporate some of the changes
    133      1.2  chopps 	in the new versions into yours.
    134      1.2  chopps 
    135      1.2  chopps 	Third, you will probably want to update the set of device
    136      1.2  chopps 	nodes you have in /dev.  If you've changed the contents of
    137      1.2  chopps 	/dev by hand, you will need to be careful about this, but if
    138      1.2  chopps 	not, you can just cd into /dev, and run the command "sh
    139      1.2  chopps 	MAKEDEV all".
    140      1.2  chopps 
    141      1.2  chopps 	Fourth, you must deal with certain changes in the formats of
    142      1.2  chopps 	some of the configuration files.  The most notable change is
    143      1.2  chopps 	that the "options" given to many of the file systems in
    144      1.2  chopps 	/etc/fstab or by hand have changed, and some of the file
    145      1.2  chopps 	systems have changed names.  To find out what the new options
    146      1.2  chopps 	are, it's suggested that you read the manual page for the
    147      1.2  chopps 	file systems' mount commands, for example mount_nfs(8) for
    148      1.2  chopps 	NFS.  (Note that the information for mounts of type "ufs",
    149      1.2  chopps 	i.e. Fast File Systems, are contained in the mount(8) man
    150      1.2  chopps 	page.)
    151      1.2  chopps 
    152      1.2  chopps 	Finally, you will want to delete old binaries that were part
    153      1.2  chopps 	of the version of NetBSD that you upgraded from and have since
    154      1.2  chopps 	been removed from the NetBSD distribution.  You might also
    155      1.2  chopps 	want to recompile any locally-built binaries, to take
    156      1.2  chopps 	advantage of the shared libraries.  (Note that any new
    157      1.2  chopps 	binaries that you build will be dynamically linked, and
    158      1.2  chopps 	therefore take advantage of the shared libraries, by default.
    159      1.2  chopps 	For information on how to make statically linked binaries,
    160      1.2  chopps 	see the cc(1) and ld(1) manual pages.)
    161