svn commit: r46484 - head/en_US.ISO8859-1/articles/releng
Eitan Adler
eadler at FreeBSD.org
Mon Apr 6 05:30:43 UTC 2015
Author: eadler
Date: Mon Apr 6 05:30:41 2015
New Revision: 46484
URL: https://svnweb.freebsd.org/changeset/doc/46484
Log:
releng: strip some old things
There is a two year old warning that this document is partly outdated
and that re@ is working on updating it.
I don't see many substantive commits updating this doc, so just do a
drive-by and remove the obviously wrong and outdated things.
- sysinstall has been replaced (and so scripting it is meaningless)
- cross building is possible
- drop support for disk2 and on
- remove empty sections, such as the one on cd-rom replication
Modified:
head/en_US.ISO8859-1/articles/releng/article.xml
Modified: head/en_US.ISO8859-1/articles/releng/article.xml
==============================================================================
--- head/en_US.ISO8859-1/articles/releng/article.xml Mon Apr 6 05:16:09 2015 (r46483)
+++ head/en_US.ISO8859-1/articles/releng/article.xml Mon Apr 6 05:30:41 2015 (r46484)
@@ -5,14 +5,6 @@
<article xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
<info><title>&os; Release Engineering</title>
-
-
-
- <confgroup>
- <confdates>November 2001</confdates>
- <conftitle>BSDCon Europe</conftitle>
- </confgroup>
-
<authorgroup>
<author><personname><firstname>Murray</firstname><surname>Stokely</surname></personname><personblurb>
<para>I've been involved in the development of &os; based products
@@ -746,64 +738,6 @@
command:</para>
<screen>/stage/cdrom&prompt.root; <userinput>find . -type f | sed -e 's/^\.\///' | sort > filename.txt</userinput></screen>
-
- <para>The specific requirements of each CD are outlined below.</para>
-
- <sect3>
- <title>Disc 1</title>
-
- <para>The first disc is almost completely created by
- <command>make
- release</command>. The only changes
- that should be made to the <filename>disc1</filename> directory are the addition of
- a <filename>tools</filename> directory, and as many popular
- third party software packages as will fit on the disc. The
- <filename>tools</filename> directory contains software that allow users to create
- installation floppies from other operating systems. This disc
- should be made bootable so that users of modern PCs do not
- need to create installation floppy disks.</para>
-
- <para>If a custom kernel of &os; is to be included, then
- &man.sysinstall.8; and &man.release.7; must be updated to
- include installation instructions. The relevant code is contained
- in <filename>src/release</filename> and <filename>src/usr.sbin/sysinstall</filename>.
- Specifically, the file <filename>src/release/Makefile</filename>, and
- <filename>dist.c</filename>, <filename>dist.h</filename>,
- <filename>menus.c</filename>, <filename>install.c</filename>, and
- <filename>Makefile</filename> will need to be updated under
- <filename>src/usr.sbin/sysinstall</filename>. Optionally, you may choose
- to update <filename>sysinstall.8</filename>.</para>
-
- </sect3>
-
- <sect3>
- <title>Disc 2</title>
-
- <para>The second disc is also largely created by <command>make
- release</command>. This disc contains a <quote>live
- filesystem</quote> that can be used from &man.sysinstall.8; to
- troubleshoot a &os; installation. This disc should be
- bootable and should also contain a compressed copy of the CVS
- repository in the <filename>CVSROOT</filename> directory and
- commercial software demos in the <filename>commerce</filename>
- directory.</para>
- </sect3>
-
- <sect3>
- <title>Multi-volume support</title>
-
- <para><application>Sysinstall</application> supports multiple
- volume package installations. This requires that each disc
- have an <filename>INDEX</filename> file containing all of the
- packages on all volumes of a set, along with an extra field
- that indicates which volume that particular package is on.
- Each volume in the set must also have the
- <literal>CD_VOLUME</literal> variable set in the
- <filename>cdrom.inf</filename> file so that sysinstall can
- tell which volume is which. When a user attempts to install a
- package that is not on the current disc, sysinstall will
- prompt the user to insert the appropriate one.</para>
- </sect3>
</sect2>
</sect1>
@@ -882,13 +816,6 @@
time, for example make it relative to GMT.</para>
</sect2>
- <sect2 xml:id="dist-cdrom">
- <title>CD-ROM Replication</title>
-
- <para>Coming soon: Tips for sending &os; ISOs to a replicator
- and quality assurance measures to be taken.</para>
- </sect2>
-
</sect1>
<!-- Extensibility -->
@@ -907,25 +834,8 @@
certainly encourage innovation in the form of advanced
installation and administration tools, for example, but we cannot
be expected to answer questions about it.</para>
-
- <sect2>
- <title>Scripting <command>sysinstall</command></title>
-
- <para>The &os; system installation and configuration tool,
- &man.sysinstall.8;, can be scripted to provide automated installs
- for large sites. This functionality can be used in conjunction
- with &intel; PXE
- <footnote>
- <simpara>
- <uri xlink:href="&url.books.handbook;/network-pxe-nfs.html">&url.books.handbook;/network-pxe-nfs.html</uri>
- </simpara>
- </footnote>
- to bootstrap systems from the network.
- </para>
- </sect2>
</sect1>
-<!-- Lessons Learned -->
<sect1 xml:id="lessons-learned">
<title>Lessons Learned from &os; 4.4</title>
@@ -968,33 +878,12 @@
using multiple processors in speeding up the <command>make
release</command> process. If multiple disks are used for
different hierarchies in the &man.chroot.2;
- environment, then the CVS checkout of the <filename>ports</filename> and <filename>doc</filename> trees
+ environment, then the subversion checkout of the <filename>ports</filename> and <filename>doc</filename> trees
can be happening simultaneously as the <command>make
world</command> on another disk. Using a
<acronym>RAID</acronym> solution (hardware or software) can
significantly decrease the overall build time.</para>
</listitem>
-
- <listitem>
- <para><emphasis>Cross-building releases</emphasis> - Building
- IA-64 or Alpha release on x86 hardware? <command>make
- TARGET=ia64 release</command>.
- </para>
- </listitem>
-
- <listitem>
- <para><emphasis>Regression Testing</emphasis> - We need better
- automated correctness testing for &os;.</para>
- </listitem>
-
- <listitem>
- <para><emphasis>Installation Tools</emphasis> - Our installation
- program has long since outlived its intended life span.
- Several projects are under development to provide a more
- advanced installation mechanism. The libh project was one
- such project that aimed to provide an intelligent new package
- framework and GUI installation program.</para>
- </listitem>
</itemizedlist>
</sect1>
More information about the svn-doc-all
mailing list