From owner-freebsd-doc@FreeBSD.ORG Tue Sep 13 07:40:12 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 2EFC61065673 for ; Tue, 13 Sep 2011 07:40:12 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 0BA2F8FC1C for ; Tue, 13 Sep 2011 07:40:12 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id p8D7eCfQ075974 for ; Tue, 13 Sep 2011 07:40:12 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id p8D7eBOx075973; Tue, 13 Sep 2011 07:40:11 GMT (envelope-from gnats) Resent-Date: Tue, 13 Sep 2011 07:40:11 GMT Resent-Message-Id: <201109130740.p8D7eBOx075973@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Craig Rodrigues Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 863F9106566B; Tue, 13 Sep 2011 07:37:06 +0000 (UTC) (envelope-from rodrigc@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 74EBE8FC12; Tue, 13 Sep 2011 07:37:06 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id p8D7b6xW075091; Tue, 13 Sep 2011 07:37:06 GMT (envelope-from rodrigc@freefall.freebsd.org) Received: (from rodrigc@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id p8D7b68d075090; Tue, 13 Sep 2011 00:37:06 -0700 (PDT) (envelope-from rodrigc) Message-Id: <201109130737.p8D7b68d075090@freefall.freebsd.org> Date: Tue, 13 Sep 2011 00:37:06 -0700 (PDT) From: Craig Rodrigues To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Alfred Perlstein Subject: docs/160698: Remove outdated FreeBSD Jumpstart guide X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Craig Rodrigues List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 13 Sep 2011 07:40:12 -0000 >Number: 160698 >Category: docs >Synopsis: Remove outdated FreeBSD Jumpstart guide >Confidential: no >Severity: non-critical >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Tue Sep 13 07:40:11 UTC 2011 >Closed-Date: >Last-Modified: >Originator: Craig Rodrigues >Release: FreeBSD 8.2-STABLE i386 >Organization: >Environment: System: FreeBSD freefall.freebsd.org 8.2-STABLE FreeBSD 8.2-STABLE #4 r220774: Mon Apr 18 13:56:14 UTC 2011 simon@freefall.freebsd.org:/usr/obj/usr/src/sys/FREEFALL i386 >Description: Remove the FreeBSD Jumpstart article from docs. This article was written over 10 years ago, and the information has gotten stale. Some of the steps in this article no longer work. For example, the FreeBSD Release team no longer produces installation floppy images in the FreeBSD release. I talked with Alfred, and he agreed that the information in this article is outdated and should probably be removed. This article has been superceded by a new section in the FreeBSD Handbook. This section will be visible here: http://www.freebsd.org/doc/handbook/network-pxe-nfs.html At the moment, a draft version is visible here: http://people.freebsd.org/~rodrigc/doc/doc/en_US.ISO8859-1/books/handbook/network-pxe-nfs.html >How-To-Repeat: >Fix: Index: en_US.ISO8859-1/articles/Makefile =================================================================== RCS file: /home/dcvs/doc/en_US.ISO8859-1/articles/Makefile,v retrieving revision 1.63 diff -u -u -r1.63 Makefile --- en_US.ISO8859-1/articles/Makefile 20 Jul 2011 17:50:26 -0000 1.63 +++ en_US.ISO8859-1/articles/Makefile 13 Sep 2011 07:24:18 -0000 @@ -47,7 +47,6 @@ SUBDIR+= portbuild SUBDIR+= pr-guidelines SUBDIR+= problem-reports -SUBDIR+= pxe SUBDIR+= rc-scripting SUBDIR+= relaydelay SUBDIR+= releng Index: en_US.ISO8859-1/articles/pxe/Makefile =================================================================== RCS file: en_US.ISO8859-1/articles/pxe/Makefile diff -N en_US.ISO8859-1/articles/pxe/Makefile --- en_US.ISO8859-1/articles/pxe/Makefile 6 Apr 2004 16:10:07 -0000 1.5 +++ /dev/null 1 Jan 1970 00:00:00 -0000 @@ -1,28 +0,0 @@ -# -# $FreeBSD: doc/en_US.ISO8859-1/articles/pxe/Makefile,v 1.5 2004/04/06 16:10:07 phantom Exp $ -# -# Article: FreeBSD PXE Jumpstart Guide - -DOC?= article - -FORMATS?= html - -INSTALL_COMPRESSED?=gz -INSTALL_ONLY_COMPRESSED?= - -EXTRAS= dhcpd.conf -EXTRAS+= install.cfg -EXTRAS+= loader.rc -EXTRAS+= pkgmaker.sh -EXTRAS+= post -EXTRAS+= pre - -SRCS= article.sgml - -afterinstall: -.for entry in ${EXTRAS} - ${INSTALL_DOCS} ${.CURDIR}/${entry} ${DESTDIR} -.endfor - -DOC_PREFIX?= ${.CURDIR}/../../.. -.include "${DOC_PREFIX}/share/mk/doc.project.mk" Index: en_US.ISO8859-1/articles/pxe/article.sgml =================================================================== RCS file: en_US.ISO8859-1/articles/pxe/article.sgml diff -N en_US.ISO8859-1/articles/pxe/article.sgml --- en_US.ISO8859-1/articles/pxe/article.sgml 29 Aug 2006 19:45:44 -0000 1.27 +++ /dev/null 1 Jan 1970 00:00:00 -0000 @@ -1,285 +0,0 @@ - -%articles.ent; -]> - -
- - FreeBSD Jumpstart Guide - - - - Alfred - Perlstein - - -
alfred@FreeBSD.org
- - - - - $FreeBSD: doc/en_US.ISO8859-1/articles/pxe/article.sgml,v 1.27 2006/08/29 19:45:44 blackend Exp $ - - - &tm-attrib.freebsd; - &tm-attrib.intel; - &tm-attrib.general; - - - - This article details the method used to allow machines to install - FreeBSD using the &intel; PXE method of booting a machine over a network. - - - - - - Introduction - - - This procedure will make the Server both insecure and dangerous, - it is best to just keep the Server on its own hub and not in any way - accessible by any machines other than the Clients. - - - Terminology: - - - - - - - Server - The machine offering netboot and install options. - - - - Client - The machine that will have FreeBSD installed on it. - - - - - - Requires: - Clients supporting the &intel; PXE netboot option, an Ethernet connection. - - - Please let me know if you come across anything you have problems with - or suggestions for additional documentation. - - If you would like someone to train/implement a specific netinstall system - for you, please send email so that we can discuss terms. - - I would also like to thank &a.ps; and &a.jhb; for doing most of the - programming work on pxeboot, the interface to the &intel; PXE (netboot) - system. - - - - Server Configuration - - - - Install DHCP: Install net/isc-dhcp3-server you can use this config file - - dhcpd.conf, stick it in /usr/local/etc/. - - - - Enable tftp: - - - - Make a directory /usr/tftpboot - - - - Add this line to your - /etc/inetd.conf: - -tftp dgram udp wait nobody /usr/libexec/tftpd tftpd /usr/tftpboot - - - - - - - Enable NFS: - - - - Add this to /etc/rc.conf: - - nfs_server_enable="YES" - - - - Add this to /etc/exports: - - /usr -alldirs -ro - - - - - - Reboot to enable the new services or start them - manually. - - - - - - Bootstrap Setup - - - - Download bootfiles: Download the - - kern.flp and - - mfsroot.flp floppy images. - - - - Set up tftp/pxe-boot directory: - - - - Put pxeboot in the boot directory: - - &prompt.root; rm -rf /usr/obj/* -&prompt.root; cd /usr/src/sys/boot -&prompt.root; make -&prompt.root; cp /usr/src/sys/boot/i386/pxeldr/pxeboot /usr/tftpboot - - - - Using the vndevice mount the kern.flp - file and copy its contents to - /usr/tftpboot: - - &prompt.root; mdconfig -a -t vnode -f kern.flp -u 0 # (vnconfig vn0 kern.flp) associate a vndevice with the file -&prompt.root; mount /dev/md0 /mnt # (mount /dev/vn0 /mnt) mount it -&prompt.root; cp -R /mnt /usr/tftpboot # copy the contents to /usr/tftpboot -&prompt.root; umount /mnt # unmount it -&prompt.root; vnconfig -u vn0 # disassociate the vndevice from the file - - - - - - Compile a custom kernel for the clients (particularly to avoid - the device config screen at boot) and stick it in - /usr/tftpboot. - - - - Make a special loader.rc to and install it - in /usr/tftpboot/boot/loader.rc so that it - does not prompt for the second disk, here is - mine. - - - - Extract the installer and helper utilities from the mfsroot disk - and uncompress them, put them in /usr/tftpboot - as well: - - &prompt.root; vnconfig vn0 mfsroot.flp # associate a vndevice with the file -&prompt.root; mount /dev/vn0 /mnt # mount it -&prompt.root; cp /mnt/mfsroot.gz /usr/tftpboot # copy the contents to /usr/tftpboot -&prompt.root; umount /mnt # unmount it -&prompt.root; vnconfig -u vn0 # disassociate the vndevice from the file -&prompt.root; cd /usr/tftpboot # get into the pxeboot directory -&prompt.root; gunzip mfsroot.gz # uncompress the mfsroot - - - - Make your sysinstall script install.cfg, you - can use - mine - as a template, but you must edit it. - - - - Copy the sysinstall script into the extracted and uncompressed - mfsroot image: - - &prompt.root; cd /usr/tftpboot -&prompt.root; vnconfig vn0 mfsroot -&prompt.root; mount /dev/vn0 /mnt -&prompt.root; cp install.cfg /mnt -&prompt.root; umount /mnt -&prompt.root; vnconfig -u vn0 - - - - - - Install Setup - - - - Put the install files in an NFS accessible location on the - Server. Make a directory corresponding the 'nfs' directive in the - install.cfg file and mirror the FreeBSD - install files there, you will want it to look somewhat like - this: - - ABOUT.TXT TROUBLE.TXT compat20 floppies ports -ERRATA.TXT UPGRADE.TXT compat21 games proflibs -HARDWARE.TXT XF86336 compat22 info src -INSTALL.TXT bin compat3x kern.flp -LAYOUT.TXT catpages crypto manpages -README.TXT cdrom.inf dict mfsroot.flp -RELNOTES.TXT compat1x doc packages - - - - Copy the compressed packages into the packages/All directory - under nfs. - - - - Make sure you have an INDEX file prepared - in the packages directory. You can make your own - INDEX entries like so: - - alfred-1.0||/|Alfred install bootstrap||alfred@FreeBSD.org|||| - - Then you can install custom packages, particularly your own - custom post-install package. - - - - - - Custom Post-Install Package - - You can use the script pkgmaker.sh - to create a - custom package for post install, the idea is to have it install and - configure any special things you may need done. - pkgmaker is run in the directory above the package - you wish to create with the single argument of the package (i.e., mypkg) - which will then create a mypkg.tgz for you to include in your sysinstall - package. - - Inside your custom package dir you will want a file called - PLIST which contains all the files that you wish to - install and be incorporated into your package. - - You will also want files called - pre and - post - in the directory, these are shell scripts - that you want to execute before and after your package is - installed. - - Since this package is in your install.cfg file - it should be run and do the final configuration for you. - -
Index: en_US.ISO8859-1/articles/pxe/dhcpd.conf =================================================================== RCS file: en_US.ISO8859-1/articles/pxe/dhcpd.conf diff -N en_US.ISO8859-1/articles/pxe/dhcpd.conf --- en_US.ISO8859-1/articles/pxe/dhcpd.conf 17 Jun 2003 15:09:51 -0000 1.2 +++ /dev/null 1 Jan 1970 00:00:00 -0000 @@ -1,23 +0,0 @@ - -# $Wintelcom: src/freebsd/pxe/doc/dhcpd.conf,v 1.2 2000/09/24 09:18:14 bright Exp $ -# $FreeBSD: doc/en_US.ISO8859-1/articles/pxe/dhcpd.conf,v 1.2 2003/06/17 15:09:51 alfred Exp $ - -option subnet-mask 255.255.255.0; -option routers 10.8.253.254; -filename "pxeboot"; - -ddns-update-style none; - -option domain-name "google.com"; -option broadcast-address 10.8.253.255; -option domain-name-servers 10.8.0.7; -server-name "DHCPserver"; -server-identifier 10.8.253.201; - -default-lease-time 7200; -max-lease-time 7200; - -subnet 10.8.253.0 netmask 255.255.255.0 { - next-server 10.8.253.201; - range 10.8.253.29 10.8.253.200; -} Index: en_US.ISO8859-1/articles/pxe/install.cfg =================================================================== RCS file: en_US.ISO8859-1/articles/pxe/install.cfg diff -N en_US.ISO8859-1/articles/pxe/install.cfg --- en_US.ISO8859-1/articles/pxe/install.cfg 23 Nov 2003 18:50:32 -0000 1.2 +++ /dev/null 1 Jan 1970 00:00:00 -0000 @@ -1,209 +0,0 @@ - -# $Wintelcom: src/freebsd/pxe/doc/install.cfg,v 1.1 2000/07/14 12:42:05 bright Exp $ -# $FreeBSD: doc/en_US.ISO8859-1/articles/pxe/install.cfg,v 1.2 2003/11/23 18:50:32 ceri Exp $ - -# This is the installation configuration file for our rackmounted FreeBSD -# cluster machines - -# Turn on extra debugging. -debug=YES - -# Ok, this ought to turn off ALL prompting, don't complain to me that you -# lost a machine because you netbooted it on the same subnet as this -# box -nonInteractive=YES -noWarn=YES -tryDHCP=YES - -################################ -# My host specific data -hostname=booter -domainname=mydomain.com -# DHCP does this for us -#nameserver=10.0.0.1 -#defaultrouter=10.0.0.1 -#ipaddr=DHCP -#netmask=255.255.255.0 -################################ - -################################ -# Which installation device to use -nfs=x.x.x.x:/usr/releng4 -netDev=fxp0 -tryDHCP=YES -mediaSetNFS -################################ - -################################ -# Select which distributions we want. -dists= bin doc games manpages catpages proflibs dict info des compat1x compat20 compat21 compat22 compat3x crypto -distSetCustom -################################ - -################################ -# Now set the parameters for the partition editor on sd0. -disk=ad0 -partition=all -bootManager=standard -diskPartitionEditor -#diskPartitionWrite -################################ - -################################ -# All sizes are expressed in 512 byte blocks! -# -# A 96MB root partition, followed by a 0.5G swap partition, followed by -# a 1G /var, and a /usr using all the remaining space on the disk -# -ad0s1-1=ufs 1999999 / -ad0s1-2=swap 6485760 none -ad0s1-3=ufs 2097152 /var -ad0s1-4=ufs 0 /usr -# Let's do it! -diskLabelEditor -#diskLabelCommit - -# OK, everything is set. Do it! -installCommit - -package=XFree86-3.3.6 -packageAdd - -#package=XFree86-aoutlibs-3.3.3 -#packageAdd - -package=XFree86-contrib-3.3.6 -packageAdd - -package=arpwatch-2.1.a4 -packageAdd - -package=bash-2.04 -packageAdd - -package=bison-1.28 -packageAdd - -package=bzip2-1.0.0 -packageAdd - -package=ctags-3.5.2 -packageAdd - -package=dvips2ascii-1.3 -packageAdd - -package=electricfence-2.0.5 -packageAdd - -package=emacs-20.6 -packageAdd - -package=enscript-letter-1.6.1 -packageAdd - -package=fping-1.20 -packageAdd - -package=gawk-3.0.4 -packageAdd - -package=gdbm-1.8.0 -packageAdd - -package=gettext-0.10.35 -packageAdd - -package=gmake-3.79 -packageAdd - -package=ispell-3.1.20c -packageAdd - -package=less-352 -packageAdd - -package=libgnugetopt-1.1 -packageAdd - -package=libtool-1.3.4 -packageAdd - -package=linux_base-6.1 -packageAdd - -package=linux_devtools-6.1 -packageAdd - -package=lmbench-1.1 -packageAdd - -package=m4-1.4 -packageAdd - -package=mprof-3.0 -packageAdd - -package=mtr-0.42 -packageAdd - -package=nmap-2.53 -packageAdd - -package=pine-4.21 -packageAdd - -package=portscanner-1.0 -packageAdd - -package=portsentry-1.0 -packageAdd - -package=python-1.5.2 -packageAdd - -package=rpm-2.5.6 -packageAdd - -package=rsaref-2.0 -packageAdd - -package=rsync-2.4.3 -packageAdd - -package=screen-3.9.5 -packageAdd - -package=stlport-3.01 -packageAdd - -package=tcsh-6.09.00 -packageAdd - -package=tk-8.0.5 -packageAdd - -package=vim-lite-5.6.70 -packageAdd - -package=wget-1.5.3 -packageAdd - -package=word2x-0.005 -packageAdd - -package=zip-2.3 -packageAdd - -package=zsh-3.0.7 -packageAdd - -# -# this last package is special. It is used to configure the machine. -# it installs several files (like /root/.rhosts) and its installation -# script tweaks several options in /etc/rc.conf -# -package=mypkg-1.0 -packageAdd - -shutdown Index: en_US.ISO8859-1/articles/pxe/loader.rc =================================================================== RCS file: en_US.ISO8859-1/articles/pxe/loader.rc diff -N en_US.ISO8859-1/articles/pxe/loader.rc --- en_US.ISO8859-1/articles/pxe/loader.rc 17 Jun 2003 08:21:40 -0000 1.1 +++ /dev/null 1 Jan 1970 00:00:00 -0000 @@ -1,11 +0,0 @@ -\ $Wintelcom: src/freebsd/pxe/doc/loader.rc,v 1.1 2000/07/15 07:20:37 bright Exp $ -\ $FreeBSD: doc/en_US.ISO8859-1/articles/pxe/loader.rc,v 1.1 2003/06/17 08:21:40 alfred Exp $ -echo Loading Kernel... -load /kernel -echo Loading mfsroot... -load -t mfs_root /mfsroot -echo booting... -echo \007\007 -echo initializing h0h0magic... -set vfs.root.mountfrom="ufs:/dev/md0c" -boot Index: en_US.ISO8859-1/articles/pxe/pkgmaker.sh =================================================================== RCS file: en_US.ISO8859-1/articles/pxe/pkgmaker.sh diff -N en_US.ISO8859-1/articles/pxe/pkgmaker.sh --- en_US.ISO8859-1/articles/pxe/pkgmaker.sh 17 Jun 2003 08:21:40 -0000 1.1 +++ /dev/null 1 Jan 1970 00:00:00 -0000 @@ -1,9 +0,0 @@ -#!/bin/sh - -# $Wintelcom: src/freebsd/pxe/doc/pkgmaker.sh,v 1.1 2000/07/14 12:42:05 bright Exp $ -# $FreeBSD: doc/en_US.ISO8859-1/articles/pxe/pkgmaker.sh,v 1.1 2003/06/17 08:21:40 alfred Exp $ - -PKGNAME=${1} -PKGDIR=`pwd`/${PKGNAME}/ - -pkg_create -i ${PKGDIR}pre -I ${PKGDIR}post -f ${PKGDIR}PLIST -s ${PKGDIR} -p / -d ${PKGDIR}DESCR -c ${PKGDIR}COMMENT ${PKGNAME}.tgz Index: en_US.ISO8859-1/articles/pxe/post =================================================================== RCS file: en_US.ISO8859-1/articles/pxe/post diff -N en_US.ISO8859-1/articles/pxe/post --- en_US.ISO8859-1/articles/pxe/post 5 Nov 2003 10:59:34 -0000 1.2 +++ /dev/null 1 Jan 1970 00:00:00 -0000 @@ -1,36 +0,0 @@ -#!/bin/sh - -# $Wintelcom: src/freebsd/pxe/doc/post,v 1.1 2000/07/14 12:42:05 bright Exp $ -# $FreeBSD: doc/en_US.ISO8859-1/articles/pxe/post,v 1.2 2003/11/05 10:59:34 ceri Exp $ - -echo post-install - -set PATH=/bin:/usr/local/bin:/sbin:/usr/sbin:/usr/bin:/usr/bin/X11 -export PATH - -# do timezone -cp /usr/share/zoneinfo/America/Los_Angeles /etc/localtime - -conf="/etc/rc.conf.local" - -rm $conf - -echo 'sendmail_enable="NO"' >> $conf -echo 'dumpdev="/dev/ad0s1b"' >> $conf -echo 'sshd_enable="YES"' >> $conf -echo 'linux_enable="YES"' >> $conf - -# set up IP address and hostname -if=`ifconfig fxp1 inet | grep '[ ]*inet' | sed 's/[ ]*//'` -echo "ifconfig_fxp1=\"${if}\"" >> $conf -name=`echo $if | sed 's/[ ][ ]*/ /g' | cut -f2 -d" " | cut -f4 -d.` -echo "hostname=\"suyy${name}\"" >> $conf - -echo "network_interfaces=\"fxp0 fxp1 lo0\"" >> $conf - -# set up gateway, parse netstat output -gw=`netstat -rn | grep '^default' | sed 's/[ ][ ]*/ /g' | cut -f2 -d" "` -echo "defaultrouter=\"${gw}\"" >> $conf - -pwd_mkdb -p /etc/master.passwd -exit 0 Index: en_US.ISO8859-1/articles/pxe/pre =================================================================== RCS file: en_US.ISO8859-1/articles/pxe/pre diff -N en_US.ISO8859-1/articles/pxe/pre --- en_US.ISO8859-1/articles/pxe/pre 17 Jun 2003 15:34:24 -0000 1.1 +++ /dev/null 1 Jan 1970 00:00:00 -0000 @@ -1,7 +0,0 @@ -#!/bin/sh - -# $Wintelcom: src/freebsd/pxe/doc/pre,v 1.1 2000/07/14 12:42:05 bright Exp $ -# $FreeBSD: doc/en_US.ISO8859-1/articles/pxe/pre,v 1.1 2003/06/17 15:34:24 alfred Exp $ - -echo pre-install -exit 0 >Release-Note: >Audit-Trail: >Unformatted: