fixup! Add automatic installer and upgrader.
This commit is contained in:
parent
5bde899212
commit
a1f7b508a1
|
@ -0,0 +1,121 @@
|
||||||
|
.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
|
|
@ -183,6 +183,8 @@ src = no
|
||||||
system = yes
|
system = yes
|
||||||
.Ed
|
.Ed
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
|
.Xr autoinstall.conf 5 ,
|
||||||
|
.Xr autoupgrade.conf 5 ,
|
||||||
.Xr upgrade 7 ,
|
.Xr upgrade 7 ,
|
||||||
.Xr sysupgrade 8 ,
|
.Xr sysupgrade 8 ,
|
||||||
.Xr tix 8
|
.Xr tix 8
|
||||||
|
|
|
@ -20,5 +20,6 @@ must be run as root with stdin, stdout and stderr all pointing to the terminal.
|
||||||
It is intended to be run from a live environment and not from an actual
|
It is intended to be run from a live environment and not from an actual
|
||||||
installation.
|
installation.
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
|
.Xr autoinstall.conf 5 ,
|
||||||
.Xr installation 7 ,
|
.Xr installation 7 ,
|
||||||
.Xr sysupgrade 8
|
.Xr sysupgrade 8
|
||||||
|
|
|
@ -1425,7 +1425,7 @@ int main(void)
|
||||||
!access_or_die("/etc/sshd_config", F_OK);
|
!access_or_die("/etc/sshd_config", F_OK);
|
||||||
while ( true )
|
while ( true )
|
||||||
{
|
{
|
||||||
prompt(input, sizeof(input), "enable_ssh",
|
prompt(input, sizeof(input), "enable_sshd",
|
||||||
"Enable ssh server? (yes/no)",
|
"Enable ssh server? (yes/no)",
|
||||||
might_want_sshd ? "yes" : "no");
|
might_want_sshd ? "yes" : "no");
|
||||||
if ( strcasecmp(input, "no") == 0 )
|
if ( strcasecmp(input, "no") == 0 )
|
||||||
|
@ -1478,7 +1478,7 @@ int main(void)
|
||||||
bool enable_sshd_password = false;
|
bool enable_sshd_password = false;
|
||||||
while ( true )
|
while ( true )
|
||||||
{
|
{
|
||||||
prompt(input, sizeof(input), "enable_ssh_password",
|
prompt(input, sizeof(input), "enable_sshd_password",
|
||||||
"Enable sshd password authentication? (yes/no)", "no");
|
"Enable sshd password authentication? (yes/no)", "no");
|
||||||
if ( strcasecmp(input, "no") == 0 )
|
if ( strcasecmp(input, "no") == 0 )
|
||||||
break;
|
break;
|
||||||
|
@ -1496,7 +1496,7 @@ int main(void)
|
||||||
}
|
}
|
||||||
while ( enable_sshd_password )
|
while ( enable_sshd_password )
|
||||||
{
|
{
|
||||||
prompt(input, sizeof(input), "enable_ssh_root_password",
|
prompt(input, sizeof(input), "enable_sshd_root_password",
|
||||||
"Enable sshd password authentication for root? (yes/no)",
|
"Enable sshd password authentication for root? (yes/no)",
|
||||||
"no");
|
"no");
|
||||||
if ( strcasecmp(input, "no") == 0 )
|
if ( strcasecmp(input, "no") == 0 )
|
||||||
|
|
|
@ -22,5 +22,6 @@ must be run as root with stdin, stdout and stderr all pointing to the terminal.
|
||||||
It is intended to be run from a live environment and not from an actual
|
It is intended to be run from a live environment and not from an actual
|
||||||
installation.
|
installation.
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
|
.Xr autoupgrade.conf 5 ,
|
||||||
.Xr upgrade 7 ,
|
.Xr upgrade 7 ,
|
||||||
.Xr sysinstall 8
|
.Xr sysinstall 8
|
||||||
|
|
Loading…
Reference in New Issue