122 lines
3.4 KiB
Groff
122 lines
3.4 KiB
Groff
.Dd April 9, 2023
|
|
.Dt AUTOINSTALL.CONF 5
|
|
.Os
|
|
.Sh NAME
|
|
.Nm autoinstall.conf
|
|
.Nd automatic installation configuration
|
|
.Sh SYNOPSIS
|
|
.Nm /etc/autoinstall.conf
|
|
.Sh DESCRIPTION
|
|
.Nm
|
|
configures
|
|
.Xr sysinstall 8
|
|
to do an automatic operating system
|
|
.Xr installation 7 .
|
|
.Pp
|
|
The system administrator can automate operating system installations by
|
|
following
|
|
.Xr release-iso-modification 7
|
|
to embed the
|
|
.Pa /etc/autoinstall.conf
|
|
file into the release cdrom filesystem.
|
|
Existing installations can similarly be automatically upgraded using
|
|
.Xr autoupgrade.conf 5 .
|
|
.Pp
|
|
Each line is formatted as
|
|
.Ar question Ns = Ns Ar answer
|
|
which provides an
|
|
.Ar answer
|
|
to a
|
|
.Ar question
|
|
asked during installation.
|
|
Alternatively
|
|
.Ar question Ns += Ns Ar answer
|
|
appends to an existing answer (if any) separated by a space, and
|
|
.Ar question Ns ++= Ns Ar answer
|
|
appends another line to an existing answer (if any).
|
|
Empty lines and lines starting with
|
|
.Sq #
|
|
are comments and are ignored.
|
|
Otherwise whitespace is significant.
|
|
The empty answer accepts the default answer (if any) and is different from no
|
|
answer, which makes
|
|
.Xr sysinstall 8
|
|
ask the question normally.
|
|
Installations can be made fully non-interactive using
|
|
.Sy accept_defaults .
|
|
.Pp
|
|
The questions in chronological order are as follows:
|
|
.Bl -tag -width "12345678"
|
|
.It Sy accept_defaults Ns "=" Ns Oo Sy no "|" yes Oc ( default Sy no )
|
|
Accept the default answer (if any) to questions that were not
|
|
configured in
|
|
.Nm .
|
|
This feature makes installations entirely automated even if unexpected questions
|
|
are asked, although the essential questions must be answered.
|
|
.It Sy countdown Ns "=" Ns Ar seconds No ( default Li 10 )
|
|
Count down for this many
|
|
.Ar seconds
|
|
with a warning that an automated installation is about to happen.
|
|
The countdown happens if the
|
|
.Sy ready
|
|
question is answered and either the
|
|
.Sy disked
|
|
or
|
|
.Sy confirm_install
|
|
questions are answered.
|
|
.It Sy ignore_missing_programs Ns "=" Ns Oo Sy no "|" yes Oc ( default Sy no )
|
|
Ignore if the installer environment does not have the needed ports installed.
|
|
This situation ordinarily does not happen.
|
|
ready
|
|
.It Sy ready Ns "=" Ns Ar affirmation
|
|
A human readable positive affirmation of your choice that you're ready to
|
|
install, useful for fully automated installations.
|
|
Not answering this question is useful for semi-automated installations where one
|
|
would acknowledge the installation before it's begun.
|
|
It also provides the opportunity to escape to a shell before installing.
|
|
.It Sy kblayout Ns "=" Ns Oo Sy default "|" Ar layout Oc ( default Sy default )
|
|
Switch to this keyboard
|
|
.Ar layout
|
|
using
|
|
.Xr chkblayout 1 .
|
|
The choice is set as the system default in
|
|
.Xr kblayout 5 .
|
|
.It Sy videomode Ns "=" Ns Oo Sy no "|" Sy yes "|" Ar WIDTH Ns x Ns Ar HEIGHT Ns x Ns Ar BPP Oc ( default Sy yes )
|
|
Interactively select a graphics resolution using
|
|
.Xr chvideomode 1
|
|
or non-interactively set it to the specified resolution.
|
|
The choice is set as the system default in
|
|
.Xr videomode 5 .
|
|
.El
|
|
.Sh FILES
|
|
.Bl -tag -width "/etc/autoinstall.conf" -compact
|
|
.It Pa /etc/autoinstall.conf
|
|
Automatic installation configuration.
|
|
.El
|
|
.Sh EXAMPLES
|
|
.Bd -literal
|
|
accept_defaults=yes
|
|
ready=Automatically
|
|
kblayout=us
|
|
videomode=1280x720x32
|
|
grub=yes
|
|
grub_password=no
|
|
disked++=mktable mbr
|
|
disked++=mkpart
|
|
disked++=0%
|
|
disked++=100%
|
|
disked++=ext2
|
|
disked++=/
|
|
confirm_install=yes
|
|
hostname=dragon
|
|
password_hash_root=
|
|
finally=reboot
|
|
.Ed
|
|
.Sh SEE ALSO
|
|
.Xr autoupgrade.conf 5 ,
|
|
.Xr upgrade.conf 5 ,
|
|
.Xr release-iso-modification 7 ,
|
|
.Xr upgrade 7 ,
|
|
.Xr sysupgrade 8 ,
|
|
.Xr tix 8
|