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
This commit is contained in:
Eitan Adler
parent
80199da248
commit
85dbbb5ddd
Notes:
svn2git
2020-12-08 03:00:23 +00:00
svn path=/head/; revision=46484
1 changed files with 1 additions and 112 deletions
|
|
@ -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>
|
||||
|
|
|
|||
Loading…
Reference in a new issue