(no commit message)
[ikiwiki.git] / issues24 / index.mdwn
1 # DragonFly Release 2.4
2
3 ## Possible Upgrade Issues
4
5 * The kernel is unable to find the root and stops at the mountroot prompt.
6   Due to the upgrade the drive may have changed names.
7  * Hit scroll-lock on the console, scroll up and locate the root drive.
8  * For BOOT+HAMMER try specifying: "hammer:xxxs1d", where xxx is the drive.
9  * For UFS try specifying: "ufs:xxxs1a", where xxx is the drive.
10  * Once you get the system up you may have to remount / read-write, then
11    fix /etc/fstab and adjust /boot/loader.conf as necessary to specify
12    the root mount using vfs.root.mountfrom="hammer:serno/SERIALNUMBER.s1d"
13    (for example).
14  * We recommend specifying mount points by serial number, using
15    /dev/serno/SERIALNUMBER.s1PARTITION as necessary.  Also remember
16    you may have a device specification in your /etc/rc.conf (for the dump device),
17    and of course the root mount specification in /boot/loader.conf.
18
19 * Your kernel and world are out of sync.
20  * ttys and ptys may not work properly in this case, you may have
21    trouble getting a root prompt.
22  * Try booting into single user mode and complete the installation.
23  * Or boot the CD and re-upgrade.
24
25 * HAMMER-only installation fails with BTX errors or is unable to load
26   the loader, or kernel.
27  * An algorithmic bug in the loader's HAMMER implementation causes the
28    loader to improperly parse file data in some cases.
29  * All we can recommend here is to switch to a BOOT+HAMMER installation,
30    which is fully supported and actually considerably easier to manage.
31    An existing installation can be adjusted by stealing 256MB from your
32    swap partition to create a UFS boot partition, naming it 'a'.  Then
33    copy the HAMMER /boot into it (directly, not as a subdirectory called 'boot').
34    Of course we'd prefer a completely clean install so the partitions are
35    well ordered but stealing an 'a' partition from swap space will work
36    if you can't afford to blow away the current drive.
37
38 * You have an AHCI SATA controller but the new AHCI driver is having
39   problems detecting your drives.
40  * There is a boot menu option to disable the AHCI driver, which will
41    cause the kernel to fall back to the NATA driver.  Setting
42    hint.ahci.disabled=1 in /boot/loader.conf will accomplish the same
43    thing.
44
45 * The installer errors out while trying to install a disklabel.
46  * Known issue.  We blew the partition cleaning dd.  Basically the
47    installer wants to install a disklabel64 but there is a standard
48    disklabel already installed.  For safety reasons the disklabel
49    program refuses to blow away the old label.
50  * You can blow away the whole disk or the slice from the emergency
51    shell prompt (alt f3? alt f4?) and then start the installation over
52    again.
53  * dd if=/dev/zero of=/dev/RAWDISK bs=32k count=4 **This will blow
54    away the whole disk**.  You can try it on just the slice, aka
55    RAWDISKs1 but it is fairly dangerous to do so be careful.
56
57 ## Installer Issues
58
59 * When installing w/ VMWare we recommend selecting a SCSI disk controller
60   and using the CD ISO, not the DVD ISO.
61
62 * When installing w/ VirtualBox we recommend defaults but select a hard
63   disk size at least 3G and use the CD ISO, not the DVD ISO.
64
65 * VirtualBox (and maybe VMWare too) do not implement the hard disk
66   synchronize_cache command so a panic or hard shutdown may corrupt
67   the filesystem.  Because of this and also the fact that most
68   user-specified hard drives are not the 200GB minimum recommended
69   for HAMMER, we recommend that you install UFS on the virtual
70   hard drive and not HAMMER.
71
72 * **GUI ISO** installs a bad /boot/beastie.4th file which will
73   cause a HAMMER install on the HD boot to fail.  You can fix
74   this by booting from the DVD again, logging in as root,
75   mounting /dev/ad0s1a /mnt  (or da0s1a or whatever the hard
76   drive winds up being), and editing /mnt/beastie.4th.  Please
77   remove the /boot prefix from the two include lines near the
78   top.  They should read:  'include screen.4th' and 'include frames.4th'.
79
80 * **When to install UFS** - A HAMMER setup (actually BOOT+HAMMER) is
81   the default installation but users with hard drives less then 50GB should
82   probably select a UFS install instead of HAMMER.  HAMMER is designed
83   for larger hard drives, not tiny little hard drives or small virtual drives.
84   Users who insist on using HAMMER on a small drive anyway should at least
85   'chflags nohistory /usr/obj /var/crash'.
86
87 ## Known Issues in 2.4.0 (fixed in 2.4.1 unless otherwise specified)
88
89 * Issues with kqueue and SIGIO not working properly on pipes
90   have been fixed.  This issue affected numerous programs
91   including postfix, dovecot, and others, which use pipes and
92   kqueue for I/O notification.
93 * 64-bit kernels were unable to probe USB mass storage devices.
94 * cdrecord sometimes paniced after burning completed.
95 * Kernel failed to finish CAM probes during boot.
96   (Note that some drivers may still register their CAM busses too
97   late, and this problem has not yet been tracked down).
98 * Manual pages specified with relative paths which include a
99   directory component did not work.
100 * Misc. setuid/setgid issues with exec and [f]chdir, operations
101   sometimes failed.
102 * Added support for VIA Nano and VIA C7
103 * Added support for probing OpenBSD slices
104 * Misc manual page improvements.
105
106 People can checkout the release branch and compile up a new kernel
107 at any time, or wait for the incremental release.
108
109 ## IRC Help
110
111 There are usually DragonFly users and developers on EFNet in the
112  #dragonflybsd channel who can help you if you have questions or
113 problems.