xref: /web-master/fbsd_upgrade.txt (revision 849d1f19)
1     1. Track -STABLE: cd /usr/src && cvsup stable-supfile
2
3     2. Read and understand /usr/src/UPDATING.
4
5     3. Run mergemaster; this should be done by experienced
6        personnel only.
7
8     4. If mergemaster did not update /dev, run
9
10        cd /dev && sh MAKDEV all
11
12     5. Ensure that /etc/make.conf does not build unnecessary stuff
13        (such as Fortran, Objective C, sendmail, profiling libraries)
14
15     6. Verify that fsck_y_enable="YES" is defined in /etc/rc.conf.
16        Otherwise, fsck might wait for console input and halt the
17        boot process.
18
19     7. Verify that the kernel config file is up to date and that
20        no new requirements were added which have not been met
21        yet (refer to UPDATING).
22
23        Constraints:
24
25        pair1, 11, 12: SMP/APIC_IO can be set; firewall optional.
26        pair2: SMP/APIC_IO MUST NOT be set; firewall MUST be set.
27
28        Ensure that SMP and APIC_IO are only set, if the machine has
29        multiple processors.  A SMP kernel will not boot on an UP
30        machine. "sysctl hw.ncpu" will tell you the number of CPUs.
31
32     8. Clean up:
33
34        rm -rf /usr/obj
35
36     9. nohup make buildworld -jX &
37
38        where X is <number of cpus + 1>
39
40    10. make buildkernel installkernel KERNCONF=NEWPB1
41
42        Adapt kernel config name as necessary.
43
44    11. Take a snapshot of the running processes/services:
45
46        ps ax > /root/pslist-old
47
48    12. Reboot.
49
50    13. make installworld
51
52    14. Reboot.
53
54    15. Compare the current process list with the saved one.  Ensure
55        that all services which ran before are running now.
56