diff options
author | gjb <gjb@FreeBSD.org> | 2015-02-05 16:31:49 +0000 |
---|---|---|
committer | gjb <gjb@FreeBSD.org> | 2015-02-05 16:31:49 +0000 |
commit | 8800e37beca3e347399e302e260f61685527d702 (patch) | |
tree | 11a970a9e885c46bfd350c901b97d643a017a9f8 /release | |
parent | 47d966effe5e1f81502961bf2c65ee9fb9823486 (diff) | |
download | FreeBSD-src-8800e37beca3e347399e302e260f61685527d702.zip FreeBSD-src-8800e37beca3e347399e302e260f61685527d702.tar.gz |
Reapply 'Open Issues' to the 10.1-RELEASE errata page,
which was only added to releng/10.1, not stable/10.
Sponsored by: The FreeBSD Foundation
Diffstat (limited to 'release')
-rw-r--r-- | release/doc/en_US.ISO8859-1/errata/article.xml | 93 |
1 files changed, 93 insertions, 0 deletions
diff --git a/release/doc/en_US.ISO8859-1/errata/article.xml b/release/doc/en_US.ISO8859-1/errata/article.xml index 5d1736c..d122cb5 100644 --- a/release/doc/en_US.ISO8859-1/errata/article.xml +++ b/release/doc/en_US.ISO8859-1/errata/article.xml @@ -119,6 +119,99 @@ boot</screen> instability may be present on virtual machines running on other hypervisors, such as Xen or KVM.</para> </listitem> + + <listitem> + <para>&os;/&arch.i386; 10.1-RELEASE configured with + a multi-disk ZFS dataset (mirror, raidz1, raidz2, raidz3) + may crash during boot when the ZFS pool mount is attempted + while booting an unmodified <literal>GENERIC</literal> + kernel.</para> + + <para>As described in <filename>/usr/src/UPDATING</filename> + entry <literal>20121223</literal>, rebuilding the kernel + with <literal>options KSTACK_PAGES=4</literal> has been + observed to resolve the boot-time crash. This, however, is + not an ideal solution for inclusion in the + <literal>GENERIC</literal> kernel configuration, as + increasing <literal>KSTACK_PAGES</literal> implicitly + decreases available usermode threads in an environment that + is already resource-starved.</para> + + <para>Taking into account the heavy resource requirements of + ZFS, in addition to the &arch.i386;-specific tuning + requirements for general workloads, using ZFS with the + &os;/&arch.i386; <literal>GENERIC</literal> kernel + is strongly discouraged.</para> + + <warning> + <para>It is extremely important to take note that, by + default, &man.freebsd-update.8; will install the + <literal>GENERIC</literal> kernel configuration, and + as such, &man.freebsd-update.8; consumers are strongly + encouraged to avoid &os;-provided kernel binary upgrades + with such configurations.</para> + </warning> + + <note> + <para>Although there is slight change in how the crash + manifests on &os;/&arch.i386; between 10.0-RELEASE and + 10.1-RELEASE, and given the date of the + <filename>/usr/src/UPDATING</filename> entry, there is no + evidence suggesting this is a regression between + &os; 10.0-RELEASE and &os; 10.1-RELEASE + directly.</para> + </note> + </listitem> + + <listitem> + <para>Due to an incompatibility between &man.bsdconfig.8; + and &man.pkg.8; version 1.3, packages included on the + &os; dvd installer will not be recognized by + &man.bsdconfig.8;.</para> + + <para>To install packages from the <literal>dvd1.iso</literal> + installer, create the <filename + class="directory">/dist</filename> target directory, and + manually mount the <literal>dvd1.iso</literal> + <acronym>ISO</acronym>:</para> + + <screen>&prompt.root; mkdir -p /dist +&prompt.root; mount -t cd9660 /dev/<replaceable>cd0</replaceable> /dist</screen> + + <note> + <para>Be sure to use the correct <filename + class="directory">/dev</filename> device path for the + <literal>dvd1.iso</literal> <acronym>ISO</acronym> + installer.</para> + </note> + + <para>Next, set <envar>REPOS_DIR</envar> to the path of the + <filename class="directory">repos/</filename> directory + within the installer so &man.pkg.8; will use the correct + repository metadata.</para> + + <para>If using &man.sh.1;:</para> + + <screen>&prompt.root; export REPOS_DIR=/dist/packages/repos</screen> + + <para>If using &man.csh.1;:</para> + + <screen>&prompt.root; setenv REPOS_DIR /dist/packages/repos</screen> + + <note> + <para>Keep in mind that <envar>REPOS_DIR</envar> will need + to be set again after the current shell session is + terminated, if continuing to use the packages provided on + the <literal>dvd1.iso</literal> installer.</para> + </note> + + <para>Finally, bootstrap &man.pkg.8; from the + <acronym>ISO</acronym>, and install required + packages:</para> + + <screen>&prompt.root; pkg bootstrap +&prompt.root; pkg install <replaceable>xorg-server</replaceable> <replaceable>xorg</replaceable> <replaceable>gnome2</replaceable> [...]</screen> + </listitem> </itemizedlist> </sect1> |