Remove trailing whitespace.

This commit is contained in:
Alfred Perlstein 2003-06-17 15:35:16 +00:00
parent 99ea6a90d3
commit db7a3f3bbb
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=17344

View file

@ -10,27 +10,27 @@
<article> <article>
<articleinfo> <articleinfo>
<title>FreeBSD Jumpstart Guide</title> <title>FreeBSD Jumpstart Guide</title>
<authorgroup> <authorgroup>
<author> <author>
<firstname>Alfred</firstname> <firstname>Alfred</firstname>
<surname>Perlstein</surname> <surname>Perlstein</surname>
<affiliation> <affiliation>
<address><email>alfred@FreeBSD.org</email></address> <address><email>alfred@FreeBSD.org</email></address>
</affiliation> </affiliation>
</author> </author>
</authorgroup> </authorgroup>
<pubdate>$FreeBSD$</pubdate> <pubdate>$FreeBSD$</pubdate>
<abstract> <abstract>
<para>This article details the method used to allow machines to install <para>This article details the method used to allow machines to install
FreeBSD using the Intel PXE method of booting a machine over a network. FreeBSD using the Intel PXE method of booting a machine over a network.
</para> </para>
</abstract> </abstract>
</articleinfo> </articleinfo>
<sect1 id="introduction"> <sect1 id="introduction">
<title>Introduction</title> <title>Introduction</title>
@ -41,16 +41,16 @@
</warning> </warning>
<para>Terminology:</para> <para>Terminology:</para>
<informaltable frame="none"> <informaltable frame="none">
<tgroup cols="2"> <tgroup cols="2">
<tbody> <tbody>
<row> <row>
<entry>Server</entry> <entry>Server</entry>
<entry>The machine offering netboot and install options.</entry> <entry>The machine offering netboot and install options.</entry>
</row> </row>
<row> <row>
<entry>Client</entry> <entry>Client</entry>
<entry>The machine that will have FreeBSD installed on it.</entry> <entry>The machine that will have FreeBSD installed on it.</entry>
@ -62,8 +62,8 @@
<para>Requires: <para>Requires:
Clients supporting the Intel PXE netboot option, an Ethernet connection. Clients supporting the Intel PXE netboot option, an Ethernet connection.
</para> </para>
<para>Please let me know if you come across anything you have problems with <para>Please let me know if you come across anything you have problems with
or suggestions for additional documentation.</para> or suggestions for additional documentation.</para>
<para>If you would like someone to train/implement a specific netinstall system <para>If you would like someone to train/implement a specific netinstall system
@ -79,11 +79,11 @@
<procedure> <procedure>
<step> <step>
<para>Install DHCP: Install <filename role="package">net/isc-dhcp3</filename> you can use this config file <para>Install DHCP: Install <filename role="package">net/isc-dhcp3</filename> you can use this config file
<ulink url="dhcpd.conf"> <ulink url="dhcpd.conf">
<filename>dhcpd.conf</filename></ulink>, stick it in /usr/local/etc/</para> <filename>dhcpd.conf</filename></ulink>, stick it in /usr/local/etc/</para>
</step> </step>
<step> <step>
<para>Enable tftp:</para> <para>Enable tftp:</para>
@ -91,17 +91,17 @@
<step> <step>
<para>Make a directory <filename>/usr/tftpboot</filename></para> <para>Make a directory <filename>/usr/tftpboot</filename></para>
</step> </step>
<step> <step>
<para>Add this line to your <para>Add this line to your
<filename>/etc/inetd.conf</filename>:</para> <filename>/etc/inetd.conf</filename>:</para>
<programlisting>tftp dgram udp wait nobody /usr/libexec/tftpd tftpd /usr/tftpboot</programlisting> <programlisting>tftp dgram udp wait nobody /usr/libexec/tftpd tftpd /usr/tftpboot</programlisting>
</step> </step>
</procedure> </procedure>
</step> </step>
<step> <step>
<para>Enable NFS:</para> <para>Enable NFS:</para>
@ -111,7 +111,7 @@
<programlisting>nfs_server_enable="YES"</programlisting> <programlisting>nfs_server_enable="YES"</programlisting>
</step> </step>
<step> <step>
<para>Add this to <filename>/etc/exports</filename>:</para> <para>Add this to <filename>/etc/exports</filename>:</para>
@ -119,44 +119,44 @@
</step> </step>
</procedure> </procedure>
</step> </step>
<step> <step>
<para>Reboot to enable the new services or start them <para>Reboot to enable the new services or start them
manually.</para> manually.</para>
</step> </step>
</procedure> </procedure>
</sect1> </sect1>
<sect1 id="bootstrap-config"> <sect1 id="bootstrap-config">
<title>Bootstrap Setup</title> <title>Bootstrap Setup</title>
<procedure> <procedure>
<step> <step>
<para>Download bootfiles: Download the <para>Download bootfiles: Download the
<ulink url="ftp://ftp.FreeBSD.org/pub/FreeBSD/snapshots/i386/kern.flp"> <ulink url="ftp://ftp.FreeBSD.org/pub/FreeBSD/snapshots/i386/kern.flp">
kern.flp</ulink> and kern.flp</ulink> and
<ulink url="ftp://ftp.FreeBSD.org/pub/FreeBSD/snapshots/i386/mfsroot.flp"> <ulink url="ftp://ftp.FreeBSD.org/pub/FreeBSD/snapshots/i386/mfsroot.flp">
mfsroot.flp</ulink> floppy images.</para> mfsroot.flp</ulink> floppy images.</para>
</step> </step>
<step> <step>
<para>Setup tftp/pxe-boot directory:</para> <para>Setup tftp/pxe-boot directory:</para>
<procedure> <procedure>
<step> <step>
<para>Put pxeboot in the boot directory:</para> <para>Put pxeboot in the boot directory:</para>
<screen>&prompt.root; <userinput>rm -rf /usr/obj/*</userinput> <screen>&prompt.root; <userinput>rm -rf /usr/obj/*</userinput>
&prompt.root; <userinput>cd /usr/src/sys/boot</userinput> &prompt.root; <userinput>cd /usr/src/sys/boot</userinput>
&prompt.root; <userinput>make</userinput> &prompt.root; <userinput>make</userinput>
&prompt.root; <userinput>cp /usr/src/sys/boot/i386/pxeldr/pxeboot /usr/tftpboot</userinput></screen> &prompt.root; <userinput>cp /usr/src/sys/boot/i386/pxeldr/pxeboot /usr/tftpboot</userinput></screen>
</step> </step>
<step> <step>
<para>Using the vndevice mount the <filename>kern.flp</filename> <para>Using the vndevice mount the <filename>kern.flp</filename>
file and copy its contents to file and copy its contents to
<filename>/usr/tftpboot</filename>:</para> <filename>/usr/tftpboot</filename>:</para>
<screen>&prompt.root; <userinput>vnconfig vn0 kern.flp</userinput> # associate a vndevice with the file <screen>&prompt.root; <userinput>vnconfig vn0 kern.flp</userinput> # associate a vndevice with the file
&prompt.root; <userinput>mount /dev/vn0 /mnt</userinput> # mount it &prompt.root; <userinput>mount /dev/vn0 /mnt</userinput> # mount it
&prompt.root; <userinput>cp -R /mnt /usr/tftpboot</userinput> # copy the contents to /usr/tftpboot &prompt.root; <userinput>cp -R /mnt /usr/tftpboot</userinput> # copy the contents to /usr/tftpboot
@ -165,20 +165,20 @@
</step> </step>
</procedure> </procedure>
</step> </step>
<step> <step>
<para>Compile a custom kernel for the clients (particularly to avoid <para>Compile a custom kernel for the clients (particularly to avoid
the device config screen at boot) and stick it in the device config screen at boot) and stick it in
<filename>/usr/tftpboot</filename>.</para> <filename>/usr/tftpboot</filename>.</para>
</step> </step>
<step> <step>
<para>Make a special <filename>loader.rc</filename> to and install it <para>Make a special <filename>loader.rc</filename> to and install it
in <filename>/usr/tftpboot/boot/loader.rc</filename> so that it in <filename>/usr/tftpboot/boot/loader.rc</filename> so that it
does not prompt for the second disk, here is does not prompt for the second disk, here is
<ulink url="loader.rc">mine</ulink>.</para> <ulink url="loader.rc">mine</ulink>.</para>
</step> </step>
<step> <step>
<para>Extract the installer and helper utilities from the mfsroot disk <para>Extract the installer and helper utilities from the mfsroot disk
and uncompress them, put them in <filename>/usr/tftpboot</filename> and uncompress them, put them in <filename>/usr/tftpboot</filename>
@ -192,18 +192,18 @@
&prompt.root; <userinput>cd /usr/tftpboot</userinput> # get into the pxeboot directory &prompt.root; <userinput>cd /usr/tftpboot</userinput> # get into the pxeboot directory
&prompt.root; <userinput>gunzip mfsroot.gz</userinput> # uncompress the mfsroot</screen> &prompt.root; <userinput>gunzip mfsroot.gz</userinput> # uncompress the mfsroot</screen>
</step> </step>
<step> <step>
<para>Make your sysinstall script <filename>install.cfg</filename>, you <para>Make your sysinstall script <filename>install.cfg</filename>, you
can use can use
<ulink url="install.cfg">mine</ulink> <ulink url="install.cfg">mine</ulink>
as a template, but you must edit it.</para> as a template, but you must edit it.</para>
</step> </step>
<step> <step>
<para>Copy the sysinstall script into the extracted and uncompressed <para>Copy the sysinstall script into the extracted and uncompressed
mfsroot image:</para> mfsroot image:</para>
<screen>&prompt.root; <userinput>cd /usr/tftpboot</userinput> <screen>&prompt.root; <userinput>cd /usr/tftpboot</userinput>
&prompt.root; <userinput>vnconfig vn0 mfsroot</userinput> &prompt.root; <userinput>vnconfig vn0 mfsroot</userinput>
&prompt.root; <userinput>mount /dev/vn0 /mnt</userinput> &prompt.root; <userinput>mount /dev/vn0 /mnt</userinput>
@ -213,10 +213,10 @@
</step> </step>
</procedure> </procedure>
</sect1> </sect1>
<sect1 id="install-setup"> <sect1 id="install-setup">
<title>Install Setup</title> <title>Install Setup</title>
<procedure> <procedure>
<step> <step>
<para>Put the install files in an NFS accessible location on the <para>Put the install files in an NFS accessible location on the
@ -233,49 +233,49 @@ LAYOUT.TXT catpages crypto manpages
README.TXT cdrom.inf dict mfsroot.flp README.TXT cdrom.inf dict mfsroot.flp
RELNOTES.TXT compat1x doc packages</screen> RELNOTES.TXT compat1x doc packages</screen>
</step> </step>
<step> <step>
<para>Copy the compressed packages into the packages/All directory <para>Copy the compressed packages into the packages/All directory
under <filename>nfs</filename>.</para> under <filename>nfs</filename>.</para>
</step> </step>
<step> <step>
<para>Make sure you have an <filename>INDEX</filename> file prepared <para>Make sure you have an <filename>INDEX</filename> file prepared
in the packages directory. You can make your own in the packages directory. You can make your own
<filename>INDEX</filename> entries like so:</para> <filename>INDEX</filename> entries like so:</para>
<programlisting>alfred-1.0||/|Alfred install bootstrap||alfred@FreeBSD.org||||</programlisting> <programlisting>alfred-1.0||/|Alfred install bootstrap||alfred@FreeBSD.org||||</programlisting>
<para>Then you can install custom packages, particularly your own <para>Then you can install custom packages, particularly your own
custom post-install package.</para> custom post-install package.</para>
</step> </step>
</procedure> </procedure>
</sect1> </sect1>
<sect1 id="custom-postinst-package"> <sect1 id="custom-postinst-package">
<title>Custom Post-Install Package</title> <title>Custom Post-Install Package</title>
<para>You can use the script <ulink url="pkgmaker.sh"><filename>pkgmaker.sh <para>You can use the script <ulink url="pkgmaker.sh"><filename>pkgmaker.sh
</filename></ulink> to create a </filename></ulink> to create a
custom package for post install, the idea is to have it install and custom package for post install, the idea is to have it install and
configure any special things you may need done. configure any special things you may need done.
<filename>pkgmaker</filename> is run in the directory above the package <filename>pkgmaker</filename> is run in the directory above the package
you wish to create with the single argument of the package (ie mypkg) you wish to create with the single argument of the package (ie mypkg)
which will then create a mypkg.tgz for you to include in your sysinstall which will then create a mypkg.tgz for you to include in your sysinstall
package.</para> package.</para>
<para>Inside your custom package dir you will want a file called <para>Inside your custom package dir you will want a file called
<filename>PLIST</filename> which contains all the files that you wish to <filename>PLIST</filename> which contains all the files that you wish to
install and be incorporated into your package.</para> install and be incorporated into your package.</para>
<para>You will also want files called <para>You will also want files called
<ulink url="pre"><filename>pre</filename></ulink> and <ulink url="pre"><filename>pre</filename></ulink> and
<ulink url="post"><filename>post</filename></ulink> <ulink url="post"><filename>post</filename></ulink>
in the directory, these are shell scripts in the directory, these are shell scripts
that you want to execute before and after your package is that you want to execute before and after your package is
installed.</para> installed.</para>
<para>Since this package is in your <filename>install.cfg</filename> file <para>Since this package is in your <filename>install.cfg</filename> file
it should be run and do the final configuration for you.</para> it should be run and do the final configuration for you.</para>
</sect1> </sect1>
</article> </article>