.\" /usr/share/man/man1/dphys3.7(.gz)
.\" author Neil Franklin, last modification 2006.11.16
.\" copyright ETH Zuerich Physics Departement
.\"   use under either modified/non-advertising BSD or GPL license

.TH DPHYS3 7 "2006.11.16" "dphys3 Installation Tools"

.SH NAME

dphys3 \- automatically install an Debian 3.1 (sarge) system

.SH SYNOPSIS

.B dphys3kernel
[options]
.PP
.B dphys3preseed
[options]
.PP
.B dphys3boot
[options]
.PP
.B dphys3root
[options]
.PP
.B dphys3cd
[options]
.PP
.B dphys3pxe
[options]

.SH DESCRIPTION

dphys3 is an system for automatically installing an Debian 3.1 (sarge) system.
For this it consists of multiple commands:
.PP
\fBdphys3kernel\fP compiles an custom kernel and its modules and generates
floppy images containing them. This is facultative, only if you want an own
custom kernel.
.PP
\fBdphys3preseed\fP then takes above or the standard debian versions and
generates floppy images containing an custom drivers subset and an automatic
(no user interaction) installation. This is the central component and required.
.PP
\fBdphys3boot\fP then takes an boot floppy image and installs it onto an
floppy. This is facultative, only if you want an set of boot+root floppies.
.PP
\fBdphys3root\fP then takes an root floppy image and installs it onto an
floppy. This is facultative, only if you want an set of boot+root floppies.
.PP
\fBdphys3cd\fP alternatively takes both boot and root floppy imagesm, packs
them into an El Torito bootable CD image, and burns that to CD. This is
facultative, only if you want an boot CD.
.PP
\fBdphys3pxe\fP alternatively takes the same boot and root floppy images and
extracts the kernel and initrd and uploads them onto an TFTP/PXE boot server.
This is facultative, only if you want an boot server.

.SH OPTIONS

See the individual commands man pages.

.SH CONFIG

The config files \fI/etc/dphys3\fP (sitewide), \fI~/.dphys3\fP (personal) and
\fI./dphys3\fP (particular project) allow the admin and users to set up the
working environment for all dphys3 commands.
.PP
These config files are sh script fragments full of assignments, which are
sourced, in above row, later config files assignments overriding earlier ones.
Standard sh syntax rules apply.
.PP
Identical assignments are allways used identically, so can be set once for all
commands. Which assignments are relevant for which command can be seen in this
table:
.PP
.nf
Assignment   dphys3- -kernel  -preseed  -boot  -root  -cd  -pxe

CONF_DEBSERVER          1         3
CONF_SOURCEDIR          1         1
CONF_UPLOAD_SERVER      2         2
CONF_UPLOAD_GROUP       2         2
CONF_DISKSVERSION       2         2+4     4      4     4     4
CONF_OWNSERVER                    1+4     4      4     4     4
CONF_* (all others)               5
CONF_FLOPPY_DRV                           6      6
CONF_CD_DRV                                            6
CONF_PXE_SERVER                                              6
CONF_PXE_GROUP                                               6

1 = only used if compiling own custom root and boot floppy images
2 = only used if -u uploading for later -d downloading
3 = only used if using the standard Debian root and boot floppy images
4 = only used if downloading previously uploaded stuff
5 = only used for setting up options, only those which are wanted
6 = only used if using this type of install media
.fi
.PP
For the meaning and settings of the above assignments read see the individual
commands man pages. For the "5" assignments for the installation process see
the \fIdphys3preseed\fP(1) man page, as that is the central component, and
these must be set before running that.

.SH FILES

.TP
.B /etc/dphys3
normal style site config
.TP
.B ~/.dphys3
users personal config
.TP
.B ./dphys3
individual projects config

.SH EXAMPLES

See the individual commands man pages.

.SH SEE ALSO

\fIdphys3boot\fP(1), \fIdphys3cd\fP(1), \fIdphys3kernel\fP(1),
\fIdphys3preseed\fP(1), \fIdphys3pxe\fP(1), \fIdphys3root\fP(1)

.SH AUTHOR

franklin@phys.ethz.ch, http://www.phys.ethz.ch/~franklin/