2023-07-06 19:36:48 +00:00
|
|
|
.. _tutorial_intro-to-autoinstall:
|
|
|
|
|
2023-07-07 15:56:22 +00:00
|
|
|
Introduction to autoinstall
|
2024-04-05 11:27:14 +00:00
|
|
|
===========================
|
2023-07-06 19:36:48 +00:00
|
|
|
|
2023-07-07 15:56:22 +00:00
|
|
|
Automatic Ubuntu installation is performed with the autoinstall format.
|
|
|
|
You might also know this feature as "unattended", "hands-off" or "preseeded"
|
2023-07-06 19:36:48 +00:00
|
|
|
installation.
|
|
|
|
|
|
|
|
This format is supported in the following installers:
|
|
|
|
* Ubuntu Server, version 20.04 and later
|
|
|
|
* Ubuntu Desktop, version 23.04 and later
|
|
|
|
|
2024-04-05 11:27:14 +00:00
|
|
|
Automatic installation lets you answer all configuration questions ahead of
|
2023-10-22 15:50:03 +00:00
|
|
|
time with an *autoinstall configuration* and lets the installation process run without
|
2023-07-06 19:36:48 +00:00
|
|
|
any interaction.
|
|
|
|
|
2024-04-05 11:27:14 +00:00
|
|
|
For more details on the relationship between autoinstall and cloud-init, as well as their respective functions, go to:
|
|
|
|
|
|
|
|
* :ref:`Cloud-init and autoinstall interaction <cloudinit-autoinstall-interaction>`
|
|
|
|
* :ref:`Providing autoinstall configuration <providing-autoinstall>`
|
|
|
|
|
2023-07-06 19:36:48 +00:00
|
|
|
|
2023-11-02 16:14:00 +00:00
|
|
|
Differences from `debian-installer` preseeding
|
2024-04-05 11:27:14 +00:00
|
|
|
----------------------------------------------
|
2023-07-06 19:36:48 +00:00
|
|
|
|
2023-11-02 16:14:00 +00:00
|
|
|
*preseeds* are the way to automate an installer based on `debian-installer`
|
2023-07-06 19:36:48 +00:00
|
|
|
(also known as d-i).
|
|
|
|
|
|
|
|
Autoinstalls differ from preseeds in the following ways:
|
2023-07-07 15:56:22 +00:00
|
|
|
* The format is different: autoinstalls use YAML instead of the preseed
|
2023-07-13 22:02:21 +00:00
|
|
|
debconf-set-selections.
|
2023-07-07 15:56:22 +00:00
|
|
|
* When the answer to a question is not present in a preseed, d-i stops and
|
|
|
|
asks the user for input. By comparison, if there is any autoinstall
|
|
|
|
configuration at all, the autoinstall takes the default for any
|
|
|
|
unanswered question (and fails if there is no default).
|
|
|
|
* You can designate particular sections in the autoinstall configuration as
|
2023-07-07 20:16:31 +00:00
|
|
|
"interactive", which means the installer will still stop and ask about
|
|
|
|
those.
|
2023-07-06 19:36:48 +00:00
|
|
|
|
|
|
|
|
|
|
|
Error handling
|
2024-04-05 11:27:14 +00:00
|
|
|
--------------
|
2023-07-06 19:36:48 +00:00
|
|
|
|
|
|
|
Progress through the installer is reported via the :ref:`ai-reporting` system,
|
|
|
|
including errors. In addition, when a fatal error occurs, the
|
|
|
|
:ref:`ai-error-commands` are executed and the traceback printed to the console.
|
|
|
|
The server then just waits.
|