Home | History | Annotate | Line # | Download | only in pmax
upgrade revision 1.2.2.1 
      1 It may be possible to easily upgrade your existing NetBSD/pmax system
      2 using the upgrade program in the miniroot.
      3 
      4 	NOTE: this has not been tested and should be done with caution,
      5 	after backing up your system.
      6 
      7 If you wish to upgrade your system by this method, simply select
      8 the `upgrade' option once the miniroot has booted.  The upgrade program
      9 with then guide you through the procedure.  The upgrade program will:
     10 
     11 	* Enable the network based on your system's current
     12 	  network configuration.
     13 
     14 	* Mount your existing filesystems.
     15 
     16 	* Extract binary sets from the media of your choice.
     17 
     18 	* Fixup your system's existing /etc/fstab, changing the
     19 	  occurrences of `ufs' to `ffs' and let you edit the
     20 	  resulting file.
     21 
     22 	* Make new device nodes in your root filesystem.
     23 
     24 	* Copy a new kernel onto your root partition.
     25 	  NOTE: the existing kernel WILL NOT be backed up; doing
     26 	  so would be pointless, since older NetBSD kernels will
     27 	  not work correctly with all NetBSD _VER executables.
     28 
     29 	* Install a new boot block.
     30 
     31 	* Check your filesystems for integrity.
     32 
     33 While using the miniroot's upgrade program is the preferred method
     34 of upgrading your system, it is possible to upgrade your system
     35 manually.  To do this, follow the following procedure:
     36 
     37 	* Place _at least_ the `base' binary set in a filesystem
     38 	  accessible to the target machine.  A local filesystem
     39 	  is preferred, since there may be incompatibilities
     40 	  between the NetBSD _VER kernel and older route(8)
     41 	  binaries.
     42 
     43 	* Back up your pre-existing kernel and copy the _VER
     44 	  kernel into your root partition.
     45 
     46 	* Reboot with the _VER kernel into single-user mode.
     47 
     48 	* Check all filesystems:
     49 
     50 		/sbin/fsck -p
     51 
     52 	* Mount all local filesystems:
     53 
     54 		/sbin/mount -a -t nonfs
     55 
     56 	* If you keep /usr or /usr/share on an NFS server, you
     57 	  will want to mount those filesystems as well.  To do
     58 	  this, you will need to enable the network:
     59 
     60 		sh /etc/netstart
     61 
     62 	  NOTE: the route(8) commands may fail due to potential
     63 	  incompatibilities between route(8) and the NetBSD _VER
     64 	  kernel.  Once you have enabled the network, mount the
     65 	  NFS filesystems.  If you use amd(8), you may or may not
     66 	  have to mount these filesystems manually.  Your mileage
     67 	  may vary.
     68 
     69 	* Make sure you are in the root filesystem and extract
     70 	  the `base' binary set:
     71 
     72 		cd /
     73 		tar --unlink -zxvpf /path/to/base13.tar.gz
     74 
     75 	  NOTE: the `--unlink' option is _very_ important!
     76 
     77 	* Sync the filesystems:
     78 
     79 		sync
     80 
     81 	* At this point you may extract any other binary sets
     82 	  you may have placed on local filesystems, or you may
     83 	  wish to extract additional sets at a later time.
     84 	  To extract these sets, use the following commands:
     85 
     86 		cd /
     87 		tar --unlink -zxvpf <path to set>
     88 
     89 NOTE: you SHOULD NOT extract the `etc' set if upgrading.  Instead, you
     90 should extract that set into another area and carefully merge the changes
     91 by hand.
     92