xref: /netbsd-src/distrib/notes/sun3/upgrade (revision b51ce847d3ce802476ee10e98be8f2618e6b4c2c)
1It is possible to easily upgrade your existing NetBSD/sun3 system
2using the upgrade program in the miniroot.  If you wish to upgrade
3your system by this method, simply select the `upgrade' option once
4the miniroot has booted.  The upgrade program with then guide you
5through the procedure.  The upgrade program will:
6
7	* Enable the network based on your system's current
8	  network configuration.
9
10	* Mount your existing filesystems.
11
12	* Extract binary sets from the media of your choice.
13
14	* Make new device nodes in your root filesystem.
15
16	* Copy a new kernel onto your root partition.
17	  NOTE: the existing kernel WILL NOT be backed up; doing
18	  so would be pointless, since older kernels may not be
19	  capable of running NetBSD _VER executables.
20
21	* Install a new boot block.
22
23	* Check your filesystems for integrity.
24
25While using the miniroot's upgrade program is the preferred method
26of upgrading your system, it is possible to upgrade your system
27manually.  To do this, follow the following procedure:
28
29	* Place _at least_ the `base' binary set in a filesystem
30	  accessible to the target machine.  A local filesystem
31	  is preferred, since the NFS subsystem in the NetBSD _VER
32	  kernel may be incompatible with your old binaries.
33
34	* Back up your pre-existing kernel and copy the _VER
35	  kernel into your root partition.
36
37	* Reboot with the _VER kernel into single-user mode.
38	  (Otherwise you can not install the boot block.)
39
40	* Check all filesystems:
41
42		/sbin/fsck -pf
43
44	* Mount all local filesystems:
45
46		/sbin/mount -a -t nonfs
47
48	* If you keep /usr or /usr/share on an NFS server, you
49	  will want to mount those filesystems as well.  To do
50	  this, you will need to enable the network:
51
52		sh /etc/netstart
53
54	* Run the update(8) daemon, to ensure that new programs
55	  are actually stored on disk.
56
57		update
58
59	* Make sure you are in the root filesystem and extract
60	  the `base' binary set:
61
62		cd /
63		tar --unlink -zxvpf /path/to/base.tar.gz
64
65	  NOTE: the `--unlink' option is _very_ important!
66
67	* Install a new boot block:
68	  (assuming root is on /dev/rsd0a)
69
70		cd /usr/mdec
71		cp -p ./ufsboot /mnt/ufsboot
72		sync ; sleep 1 ; sync
73		./installboot -v /ufsboot bootxx /dev/rsd0a
74
75	* Sync the filesystems:
76
77		sync
78
79	* At this point you may extract any other binary sets
80	  you may have placed on local filesystems, or you may
81	  wish to extract additional sets at a later time.
82	  To extract these sets, use the following commands:
83
84		cd /
85		tar --unlink -zxvpf <path to set>
86
87NOTE: you SHOULD NOT extract the `etc' set if upgrading.  Instead, you
88should extract that set into another area and carefully merge the changes
89by hand.
90