Date: Thu, 5 Feb 2015 16:31:50 +0000 (UTC) From: Glen Barber <gjb@FreeBSD.org> To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-stable@freebsd.org, svn-src-stable-10@freebsd.org Subject: svn commit: r278269 - stable/10/release/doc/en_US.ISO8859-1/errata Message-ID: <201502051631.t15GVoWT011974@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: gjb Date: Thu Feb 5 16:31:49 2015 New Revision: 278269 URL: https://svnweb.freebsd.org/changeset/base/278269 Log: 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 Modified: stable/10/release/doc/en_US.ISO8859-1/errata/article.xml Modified: stable/10/release/doc/en_US.ISO8859-1/errata/article.xml ============================================================================== --- stable/10/release/doc/en_US.ISO8859-1/errata/article.xml Thu Feb 5 16:29:26 2015 (r278268) +++ stable/10/release/doc/en_US.ISO8859-1/errata/article.xml Thu Feb 5 16:31:49 2015 (r278269) @@ -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>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201502051631.t15GVoWT011974>