| diskless.8 (117087) | diskless.8 (124355) |
|---|---|
| 1.\" Copyright (c) 1994 Gordon W. Ross, Theo de Raadt | 1.\" Copyright (c) 1994 Gordon W. Ross, Theo de Raadt |
| 2.\" Updated by Luigi Rizzo | 2.\" Updated by Luigi Rizzo, Robert Watson |
| 3.\" All rights reserved. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 1. Redistributions of source code must retain the above copyright 9.\" notice, this list of conditions and the following disclaimer. 10.\" 2. Redistributions in binary form must reproduce the above copyright --- 8 unchanged lines hidden (view full) --- 19.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 20.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 21.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 22.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 23.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 24.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 25.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 26.\" | 3.\" All rights reserved. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 1. Redistributions of source code must retain the above copyright 9.\" notice, this list of conditions and the following disclaimer. 10.\" 2. Redistributions in binary form must reproduce the above copyright --- 8 unchanged lines hidden (view full) --- 19.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 20.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 21.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 22.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 23.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 24.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 25.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 26.\" |
| 27.\" $FreeBSD: head/share/man/man8/diskless.8 117087 2003-06-30 21:47:06Z brooks $ | 27.\" $FreeBSD: head/share/man/man8/diskless.8 124355 2004-01-10 22:38:54Z rwatson $ |
| 28.\" | 28.\" |
| 29.Dd December 23, 2002 | 29.Dd January 10, 2004 |
| 30.Dt DISKLESS 8 31.Os 32.Sh NAME 33.Nm diskless 34.Nd booting a system over the network 35.Sh DESCRIPTION 36The ability to boot a machine over the network is useful for 37.Em diskless --- 86 unchanged lines hidden (view full) --- 124.Nm 125machine, which may not be what you want to have happen. 126.Bd -literal -offset indent 127cd /usr/src/sys/i386/boot 128make clean; make; make install 129cp /boot/pxeboot /tftpdir/ 130.Ed 131.Pp | 30.Dt DISKLESS 8 31.Os 32.Sh NAME 33.Nm diskless 34.Nd booting a system over the network 35.Sh DESCRIPTION 36The ability to boot a machine over the network is useful for 37.Em diskless --- 86 unchanged lines hidden (view full) --- 124.Nm 125machine, which may not be what you want to have happen. 126.Bd -literal -offset indent 127cd /usr/src/sys/i386/boot 128make clean; make; make install 129cp /boot/pxeboot /tftpdir/ 130.Ed 131.Pp |
| 132In phase 3, the kernel again uses | 132In phase 3, the kernel acquires IP networking configuration in one 133of two ways, and then proceeds to mount the root file system and start 134operation. 135If the phase 2 loader supporst passing network configuration to the 136kernel using the kernel environment, then the kernel will configure 137the network interface using that information. 138Otherwise, it must use |
| 133.Tn DHCP 134or 135.Tn BOOTP 136to acquire | 139.Tn DHCP 140or 141.Tn BOOTP 142to acquire |
| 137configuration information, and proceeds to mount the 138root file system and start operation. | 143configuration information. |
| 139The boot 140scripts recognize a 141.Nm 142startup and perform 143the actions found in 144.Pa /etc/rc.d/initdiskless 145and 146.Pa /etc/rc.d/diskless . --- 249 unchanged lines hidden (view full) --- 396files. 397.It 398The kernel for the 399.Nm 400clients, which will be loaded using 401.Tn NFS 402or 403.Tn TFTP , | 144The boot 145scripts recognize a 146.Nm 147startup and perform 148the actions found in 149.Pa /etc/rc.d/initdiskless 150and 151.Pa /etc/rc.d/diskless . --- 249 unchanged lines hidden (view full) --- 401files. 402.It 403The kernel for the 404.Nm 405clients, which will be loaded using 406.Tn NFS 407or 408.Tn TFTP , |
| 404should be built with at least the following options: | 409must include support for the NFS client: |
| 405.Pp | 410.Pp |
| 411.D1 Cd "options NFSCLIENT" 412.D1 Cd "options NFS_ROOT" 413.Pp 414If you are using a boot mechanism that does not pass network configuration 415to the kernel using the kernel environment, you will also need to include 416the following options: 417.Pp |
|
| 406.D1 Cd "options BOOTP" 407.D1 Cd "options BOOTP_NFSROOT" 408.D1 Cd "options BOOTP_COMPAT" 409.Pp | 418.D1 Cd "options BOOTP" 419.D1 Cd "options BOOTP_NFSROOT" 420.D1 Cd "options BOOTP_COMPAT" 421.Pp |
| 410In the devices section add: | 422NOTE: The PXE environment does not require these uptions. |
| 411.Pp | 423.Pp |
| 424The diskless booting environment relies on memory-backed file systems to 425support temporary local storage in the event that the root file system 426is mounted read-only; as such, it is necessary to add the following 427to the device section of the kernel configuration: 428.Pp |
|
| 412.D1 Cd "device md" 413.Pp 414If you use the firewall, remember to default to 415.Dq open , 416or your kernel 417will not be able to send/receive the 418.Tn BOOTP 419packets. --- 31 unchanged lines hidden --- | 429.D1 Cd "device md" 430.Pp 431If you use the firewall, remember to default to 432.Dq open , 433or your kernel 434will not be able to send/receive the 435.Tn BOOTP 436packets. --- 31 unchanged lines hidden --- |