StealthOS/subiquity
StealthOS
/
subiquity
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Merge pull request #1847 from rkratky/FR-5738_spellcheck 

Fix spelling mistakes to pass spellcheck
This commit is contained in:
Dan Bungert 2023-10-23 13:46:50 -06:00 committed by GitHub
parent 3cd76f11e7 1c4f2e4e6f
commit 4f1b2ccca2
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
13 changed files with 256 additions and 197 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

80
doc/.custom_wordlist.txt Normal file
View File

@ -0,0 +1,80 @@
Autoinstall
Autoinstalls
Btrfs
DHCP
EFI
Esc
ESP
ESPs
GPT
GUID
GiB
GiB
Libera
LPAR
LTS
LUKS
LV
LVM
LinuxONE
MiB
NIC
Netplan
NoCloud
OEM
OpenSSH
Petitboot
PgDown
PgUp
POST
PPA
PReP
SSD
Seagate
Subiquity
UEFI
URI
Zdev
amd
authorized-keys
autoinstall
autoinstaller
autoinstalls
bootable
bootloader
bootloaders
codecs
config
curtin
debconf
debian-installer
el
flavor
geoip
globbing
hostname
iSCSI
init
md
oem
passwd
ppc
pre
preseed
preseeded
preseeding
preseeds
pw
realname
rootfs
rsyslog
subvolume
subvolumes
superset
traceback
tty
ubuntu
udev
unformatted
VLAN
webhook

35
doc/.wordlist.txt
View File

@ -1,37 +1,38 @@
addons
API API
APIs APIs
balancer
Charmhub
CLI CLI
dropdown Charmhub
Diátaxis Diátaxis
EBS EBS
EKS EKS
favicon
Grafana Grafana
IAM IAM
installable
JSON JSON
Jira
Juju Juju
Kubernetes
Kubeflow Kubeflow
Kubernetes
Makefile Makefile
MyST MyST
namespace
namespaces
NodePort NodePort
observability
OLM OLM
Permalink Permalink
ReadMe
reST
reStructuredText
RTD RTD
subdirectories ReadMe
subtree
subfolders
UI UI
Jira
VM VM
YAML YAML
addons
balancer
dropdown
favicon
installable
namespace
namespaces
observability
reST
reStructuredText
subdirectories
subfolders
subtree

12
doc/explanation/configure-storage.rst
View File

@ -81,9 +81,9 @@ Logical Volume Manager (LVM)
.. image:: figures/configure-storage-lvm.png .. image:: figures/configure-storage-lvm.png
:alt: :alt:
The LVM is a system of managing logical volumes, or filesystems, that is much The LVM is a system of managing logical volumes, or file systems, that is much
more advanced and flexible than the traditional method of partitioning a disk more advanced and flexible than the traditional method of partitioning a disk
into one or more segments and formatting that partition with a filesystem. It into one or more segments and formatting that partition with a file system. It
can be used to combine several disks into one larger pool of storage but it can be used to combine several disks into one larger pool of storage but it
offers advantages even in a single disk system, such as snapshots and easy offers advantages even in a single disk system, such as snapshots and easy
resizing of logical volumes. resizing of logical volumes.
@ -113,7 +113,7 @@ but this can be changed later.
On amd64 and arm64 systems, multiple disks can be selected as boot devices, On amd64 and arm64 systems, multiple disks can be selected as boot devices,
which means a system can be configured so that it will continue to boot after which means a system can be configured so that it will continue to boot after
a failure of any one drive (assuming the root filesystem is placed on a RAID). a failure of any one drive (assuming the root file system is placed on a RAID).
The bootloader will be installed to each of these drives, and the operating The bootloader will be installed to each of these drives, and the operating
system configured to install new versions of GRUB to each drive as it is system configured to install new versions of GRUB to each drive as it is
updated. updated.
@ -151,8 +151,8 @@ operating system. One of the ESPs must be mounted at ``/boot/efi``.
Supported arm64 servers boot using UEFI, and are configured the same way as an Supported arm64 servers boot using UEFI, and are configured the same way as an
UEFI-booting amd64 system. UEFI-booting amd64 system.
ppc64el systems also load their bootloader (Petitboot, a small linux kernel) ppc64el systems also load their bootloader (Petitboot, a small Linux kernel)
from a "PReP" partition with a special flag, so in most ways they are similar from a PReP (PowerPC Reference Platform) partition with a special flag, so in most ways they are similar
to a UEFI system. The installer only supports one PReP partition at this time. to a UEFI system. The installer only supports one PReP partition at this time.
Limitations and workarounds Limitations and workarounds
@ -173,4 +173,4 @@ with desired parameters, and then select these partitions or devices as mount
points in the installer. Any changes you make while the installer is running points in the installer. Any changes you make while the installer is running
but before altering the storage configuration will reflected in the installer. but before altering the storage configuration will reflected in the installer.
The installer cannot yet configure iSCSI mounts or btrfs subvolumes. The installer cannot yet configure iSCSI mounts or BTRFS subvolumes.

24
doc/explanation/operate-server-installer.rst
View File

@ -10,15 +10,15 @@ step-by-step guide through the screens of the installer, you can use our
Get the installer Get the installer
================= =================
Installer images are made (approximately) daily and are available from Installer images are created (approximately) daily and are available from the
https://cdimage.ubuntu.com/ubuntu-server/daily-live/current/. These are not `Ubuntu release <https://cdimage.ubuntu.com/ubuntu-server/daily-live/current/>`_ page. These are not
tested as extensively as the images from release day, but they contain the tested as extensively as the images from release day, but they contain the
latest packages and installer, so fewer updates will be required during or latest packages and installer, so fewer updates are required during or
after installation. after installation.
You can download the server installer for amd64 from You can download the server installer for amd64 from the
https://ubuntu.com/download/server and other architectures from `Ubuntu Server <https://ubuntu.com/download/server>`_ page and other architectures from the
http://cdimage.ubuntu.com/releases/20.04/release/. `release directory <http://cdimage.ubuntu.com/releases/20.04/release/>`_.
Installer UI navigation Installer UI navigation
======================= =======================
@ -30,8 +30,8 @@ and :kbd:`space` or :kbd:`Enter` keys and a little typing.
:kbd:`Home` / :kbd:`End` / :kbd:`Page Up` / :kbd:`Page Down` can be used to :kbd:`Home` / :kbd:`End` / :kbd:`Page Up` / :kbd:`Page Down` can be used to
navigate through long lists more quickly in the usual way. navigate through long lists more quickly in the usual way.
Running the installer over serial Running the installer over a serial port
================================= ========================================
By default, the installer runs on the first virtual terminal, ``tty1``. This By default, the installer runs on the first virtual terminal, ``tty1``. This
is what is displayed on any connected monitor by default. However, servers do is what is displayed on any connected monitor by default. However, servers do
@ -42,10 +42,10 @@ the serial port. To do this, the kernel command line needs to
specified on it -- a common value is ``console=ttyS0`` but this is not specified on it -- a common value is ``console=ttyS0`` but this is not
something that can be generically documented. something that can be generically documented.
When running on serial, the installer starts in a basic mode that uses only When running on a serial port, the installer starts in a basic mode that uses only
the ASCII character set and black and white colours. If you are connecting from the ASCII character set and black and white colours. If you are connecting from
a terminal emulator such as gnome-terminal that supports Unicode and rich a terminal emulator, such as gnome-terminal, that supports Unicode and rich
colours you can switch to "rich mode" which uses Unicode, colours and supports colours, you can switch to "rich mode" which uses Unicode and colours, and supports
many languages. many languages.
.. _connect-via-ssh: .. _connect-via-ssh:
@ -88,7 +88,7 @@ There are some global keys you can press at any time:
==================================== ============================================= ==================================== =============================================
Key Action Key Action
==================================== ============================================= ==================================== =============================================
:kbd:`ESC` Go back :kbd:`Esc` Go back
:kbd:`F1` Open help menu :kbd:`F1` Open help menu
:kbd:`Control` + :kbd:`Z`, :kbd:`F2` Switch to shell :kbd:`Control` + :kbd:`Z`, :kbd:`F2` Switch to shell
:kbd:`Control` + :kbd:`L`, :kbd:`F3` Redraw screen :kbd:`Control` + :kbd:`L`, :kbd:`F3` Redraw screen

10
doc/howto/autoinstall-quickstart-s390x.rst
View File

@ -26,8 +26,8 @@ Mount the ISO
mkdir -p ~/iso mkdir -p ~/iso
sudo mount -r ~/Downloads/ubuntu-|ubuntu-latest-version|-live-server-s390x.iso ~/iso sudo mount -r ~/Downloads/ubuntu-|ubuntu-latest-version|-live-server-s390x.iso ~/iso
Write your autoinstall config Write your autoinstall configuration
============================= ====================================
Create a cloud-init configuration: Create a cloud-init configuration:
@ -46,10 +46,10 @@ Create a cloud-init configuration:
EOF EOF
touch meta-data touch meta-data
The crypted password is ``ubuntu``. The encrypted password is ``ubuntu``.
Serve the cloud-init config over HTTP Serve the cloud-init configuration over HTTP
===================================== ============================================
Leave this running in one terminal window: Leave this running in one terminal window:

36
doc/howto/autoinstall-quickstart.rst
View File

@ -17,7 +17,7 @@ Providing the autoinstall data over the network
=============================================== ===============================================
This method is the one that generalises most easily to doing an entirely This method is the one that generalises most easily to doing an entirely
network-based install, where a machine netboots and then is automatically network-based installation where a machine boots over a network and then is automatically
installed. installed.
Download the ISO Download the ISO
@ -37,10 +37,10 @@ Where you should change `<release-number>` to match the number of the LTS or
release you have downloaded (e.g., `22.04.3` for Jammy or `23.04` for the Lunar release you have downloaded (e.g., `22.04.3` for Jammy or `23.04` for the Lunar
interim release). interim release).
Write your autoinstall config Write your autoinstall configuration
----------------------------- ------------------------------------
This means creating cloud-init config as follows: This means creating cloud-init configuration as follows:
.. code-block:: bash .. code-block:: bash
@ -57,10 +57,10 @@ This means creating cloud-init config as follows:
EOF EOF
touch meta-data touch meta-data
The crypted password is just "ubuntu". The encrypted password is ``ubuntu``.
Serve the cloud-init config over HTTP Serve the cloud-init configuration over HTTP
------------------------------------- --------------------------------------------
Leave this running in one terminal window: Leave this running in one terminal window:
@ -76,8 +76,8 @@ Create a target disk
truncate -s 10G image.img truncate -s 10G image.img
Run the install! Run the installation
---------------- --------------------
As before, you will need to change `<release-number>` in the following command As before, you will need to change `<release-number>` in the following command
to match the release ISO you downloaded. to match the release ISO you downloaded.
@ -91,8 +91,8 @@ to match the release ISO you downloaded.
-initrd /mnt/casper/initrd \ -initrd /mnt/casper/initrd \
-append 'autoinstall ds=nocloud-net;s=http://_gateway:3003/' -append 'autoinstall ds=nocloud-net;s=http://_gateway:3003/'
This will boot, download the config from the server (set up in the previous This will boot, download the configuration from the server (set up in the previous
step) and run the install. The installer reboots at the end but the step) and run the installation. The installer reboots at the end but the
``-no-reboot`` flag to ``kvm`` means that ``kvm`` will exit when this happens. ``-no-reboot`` flag to ``kvm`` means that ``kvm`` will exit when this happens.
It should take about 5 minutes. It should take about 5 minutes.
@ -107,8 +107,8 @@ Boot the installed system
This will boot into the freshly installed system and you should be able to log This will boot into the freshly installed system and you should be able to log
in as ``ubuntu/ubuntu``. in as ``ubuntu/ubuntu``.
Using another volume to provide the autoinstall config Using another volume to provide the autoinstall configuration
====================================================== =============================================================
This is the method to use when you want to create media that you can just plug This is the method to use when you want to create media that you can just plug
into a system to have it be installed. into a system to have it be installed.
@ -137,7 +137,7 @@ Create your user-data and meta-data files
EOF EOF
touch meta-data touch meta-data
The crypted password is just ``ubuntu``. The encrypted password is ``ubuntu``.
Create an ISO to use as a cloud-init data source Create an ISO to use as a cloud-init data source
------------------------------------------------ ------------------------------------------------
@ -154,8 +154,8 @@ Create a target disk
truncate -s 10G image.img truncate -s 10G image.img
Run the install! Run the installation
---------------- --------------------
As before, you will need to change `<release-number>` in the following command As before, you will need to change `<release-number>` in the following command
to match the release ISO you downloaded. to match the release ISO you downloaded.
@ -167,8 +167,8 @@ to match the release ISO you downloaded.
-drive file=~/seed.iso,format=raw,cache=none,if=virtio \ -drive file=~/seed.iso,format=raw,cache=none,if=virtio \
-cdrom ~/Downloads/ubuntu-<release-number>-live-server-amd64.iso -cdrom ~/Downloads/ubuntu-<release-number>-live-server-amd64.iso
This will boot and run the install. Unless you interrupt boot to add This boots the system and runs the installation. Unless you interrupt boot to add
'autoinstall' to the kernel command line, the installer will prompt for ``autoinstall`` to the kernel command line, the installer prompts for
confirmation before touching the disk. confirmation before touching the disk.
The installer reboots at the end but the ``-no-reboot`` flag to ``kvm`` means The installer reboots at the end but the ``-no-reboot`` flag to ``kvm`` means

4
doc/howto/report-bugs.rst
View File

@ -3,7 +3,7 @@
How to report a problem How to report a problem
*********************** ***********************
We always hope, of course, that every install with the server installer We always hope, of course, that every installation with the server installer
succeeds. But reality doesn't always work that way and there will sometimes be succeeds. But reality doesn't always work that way and there will sometimes be
failures of various kinds. This section explains the most useful way to report failures of various kinds. This section explains the most useful way to report
any failures so that we can fix the bugs causing them, and we'll keep the topic any failures so that we can fix the bugs causing them, and we'll keep the topic
@ -22,7 +22,7 @@ Crash reports
A failure will result in a crash report being generated which bundles up all A failure will result in a crash report being generated which bundles up all
the information we need to fully diagnose a failure. These live in the information we need to fully diagnose a failure. These live in
``/var/crash`` in the installer environment, and for Ubuntu 19.10 and newer ``/var/crash`` in the installer environment, and for Ubuntu 19.10 and newer
this is persisted to the install media by default (if there is space). this is persisted to the installation media by default (if there is space).
When an error occurs you are presented with a dialog that allows you to upload When an error occurs you are presented with a dialog that allows you to upload
the report to the error tracker and offers options for continuing. Uploads to the report to the error tracker and offers options for continuing. Uploads to

20
doc/index.rst
View File

@ -3,24 +3,6 @@
Ubuntu Installation documentation Ubuntu Installation documentation
################################# #################################
A single sentence that says what the product is, succinctly and memorably
consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et
dolore magna aliqua.
A paragraph of one to three short sentences, that describe what the product
does. Urna cursus eget nunc scelerisque viverra mauris in. Nibh mauris cursus
mattis molestie a iaculis at vestibulum rhoncus est pellentesque elit. Diam
phasellus vestibulum lorem sed.
A third paragraph of similar length, this time explaining what need the product
meets. Dui ut ornare lectus sit amet est. Nunc sed augue lacus viverra vitae
congue eu consequat ac libero id faucibus nisl tincidunt eget nullam.
Finally, a paragraph that describes whom the product is useful for. Nunc non
blandit massa enim nec dui nunc mattis enim. Ornare arcu odio ut sem nulla
pharetra diam porttitor leo a diam sollicitudin tempor id eu. Ipsum dolor sit
amet consectetur adipiscing elit pellentesque habitant.
----- -----
.. grid:: 1 1 2 2 .. grid:: 1 1 2 2
@ -67,7 +49,7 @@ warmly welcomes community projects, contributions, suggestions, fixes and
constructive feedback. constructive feedback.
* Read our `Code of Conduct`_. * Read our `Code of Conduct`_.
* IRC: `Libera.Chat`_, the *#ubuntu-server* channel. * IRC: `Libera.Chat`_, the :spellexception:`#ubuntu-server` channel.
* Discourse: `Ubuntu Foundations`_. * Discourse: `Ubuntu Foundations`_.
* Contribute: See `CONTRIBUTING.md`_ on GitHub. * Contribute: See `CONTRIBUTING.md`_ on GitHub.

45
doc/intro-to-autoinstall.rst
View File

@ -11,15 +11,15 @@ This format is supported in the following installers:
* Ubuntu Server, version 20.04 and later * Ubuntu Server, version 20.04 and later
* Ubuntu Desktop, version 23.04 and later * Ubuntu Desktop, version 23.04 and later
Autoinstallation lets you answer all those configuration questions ahead of Automatic installation lets you answer all those configuration questions ahead of
time with an *autoinstall config* and lets the installation process run without time with an *autoinstall configuration* and lets the installation process run without
any interaction. any interaction.
Differences from debian-installer preseeding Differences from :spellexception:`debian-installer` preseeding
============================================ ============================================
*preseeds* are the way to automate an installer based on debian-installer *preseeds* are the way to automate an installer based on :spellexception:`debian-installer`
(also known as d-i). (also known as d-i).
Autoinstalls differ from preseeds in the following ways: Autoinstalls differ from preseeds in the following ways:
@ -38,23 +38,22 @@ Providing the autoinstall configuration
======================================= =======================================
There are 2 ways to provide the autoinstall configuration: There are 2 ways to provide the autoinstall configuration:
* Provide :external+cloud-init:ref:`#cloud-config * Provide :external+cloud-init:ref:`#cloud-config user data <user_data_formats-cloud_config>` containing ``autoinstall:``
user-data<user_data_formats-cloud_config>` containing ``autoinstall:``
configuration directives to cloud-init at boot time configuration directives to cloud-init at boot time
* Directly on the install media * Directly on the installation media
Autoinstall by way of cloud-config Autoinstall by way of cloud-:spellexception:`config`
---------------------------------- ----------------------------------
The suggested way of providing autoinstall config to the Ubuntu installer is The suggested way of providing autoinstall configuration to the Ubuntu installer is
via cloud-init. This allows the configuration to be applied to the installer via cloud-init. This allows the configuration to be applied to the installer
without having to modify the install media. without having to modify the installation media.
The autoinstall config is provided via cloud-init configuration, which is The autoinstall configuration is provided via cloud-init configuration, which is
almost endlessly flexible. In most scenarios the easiest way will be to provide almost endlessly flexible. In most scenarios the easiest way will be to provide
user data via the :external+cloud-init:ref:`datasource_nocloud` data source. user data via the :external+cloud-init:ref:`datasource_nocloud` data source.
When providing autoinstall via cloud-init, the autoinstall config is provided When providing autoinstall via cloud-init, the autoinstall configuration is provided
as :external+cloud-init:ref:`user_data_formats-cloud_config`. This as :external+cloud-init:ref:`user_data_formats-cloud_config`. This
means we need a :code:`#cloud-config` header. The autoinstall directives are means we need a :code:`#cloud-config` header. The autoinstall directives are
placed under a top level :code:`autoinstall:` key, like so: placed under a top level :code:`autoinstall:` key, like so:
@ -69,16 +68,16 @@ placed under a top level :code:`autoinstall:` key, like so:
.. note:: .. note::
:external+cloud-init:ref:`user_data_formats-cloud_config` files must contain :external+cloud-init:ref:`user_data_formats-cloud_config` files must contain
the ``#cloud-config`` header to be recognized as a valid cloud config data the ``#cloud-config`` header to be recognised as a valid cloud configuration data
file. file.
Autoinstall on the install media Autoinstall on the installation media
-------------------------------- -------------------------------------
Another option for supplying autoinstall to the Ubuntu installer is to place a Another option for supplying autoinstall to the Ubuntu installer is to place a
file named :code:`autoinstall.yaml` on the install media itself. file named :code:`autoinstall.yaml` on the installation media itself.
There are two potential locations that subiquity will check for the There are two potential locations that Subiquity will check for the
:code:`autoinstall.yaml` file: :code:`autoinstall.yaml` file:
* At the root of the "CD-ROM". When you write the installation ISO to a USB * At the root of the "CD-ROM". When you write the installation ISO to a USB
@ -117,14 +116,14 @@ autoinstall file in the following order and pick the first existing one:
1. Kernel command line 1. Kernel command line
2. Root of the installation system 2. Root of the installation system
3. Cloud Config 3. Cloud-:spellexception:`config`
4. Root of the CD-ROM (ISO) 4. Root of the CD-ROM (ISO)
Cloud-init and autoinstall interaction Cloud-init and autoinstall interaction
====================================== ======================================
Cloud-init runs in both the ephemeral system (during install) and in the target Cloud-init runs in both the ephemeral system (during installation) and in the target
system during first boot. Cloud-init then becomes inert for every subsequent system during first boot. Cloud-init then becomes inert for every subsequent
reboot. reboot.
@ -141,7 +140,7 @@ being installed, they must appear under a :ref:`ai-user-data` section under
#cloud-config #cloud-config
# cloud-init directives may optionally be specified here. # cloud-init directives may optionally be specified here.
# These directives affect the ephemeral system performing the install. # These directives affect the ephemeral system performing the installation.
autoinstall: autoinstall:
# autoinstall directives must be specified here, not directly at the # autoinstall directives must be specified here, not directly at the
@ -174,11 +173,11 @@ To bypass this prompt, arrange for the argument :code:`autoinstall` to be
present on the kernel command line. present on the kernel command line.
Creating an autoinstall config Creating an autoinstall configuration
============================== =====================================
When any system is installed using the Ubuntu installer, an autoinstall file When any system is installed using the Ubuntu installer, an autoinstall file
for repeating the install is created at for repeating the installation is created at
:code:`/var/log/installer/autoinstall-user-data`. :code:`/var/log/installer/autoinstall-user-data`.

113
doc/reference/autoinstall-reference.rst
View File

@ -4,14 +4,14 @@ Autoinstall configuration reference manual
****************************************** ******************************************
The autoinstall file is YAML. At top level it must be a mapping containing the The autoinstall file is YAML. At top level it must be a mapping containing the
keys described in this document. Unrecognized keys are ignored. keys described in this document. Unrecognised keys are ignored.
.. _ai-schema: .. _ai-schema:
Schema Schema
====== ======
Autoinstall configs are Autoinstall configurations are
:doc:`validated against a JSON schema<autoinstall-schema>` before they are :doc:`validated against a JSON schema<autoinstall-schema>` before they are
used. used.
@ -20,10 +20,10 @@ used.
Command lists Command lists
============= =============
Several config keys are lists of commands to be executed. Each command can be Several configuration keys are lists of commands to be executed. Each command can be
a string (in which case it is executed via ``sh -c``) or a list, in which case a string (in which case it is executed via ``sh -c``) or a list, in which case
it is executed directly. Any command exiting with a non-zero return code is it is executed directly. Any command exiting with a non-zero return code is
considered an error and aborts the install (except for error-commands, where considered an error and aborts the installation (except for error-commands, where
it is ignored). it is ignored).
.. _ai-top-level-keys: .. _ai-top-level-keys:
@ -39,7 +39,7 @@ version
* **type:** integer * **type:** integer
* **default:** no default * **default:** no default
A future-proofing config file version field. Currently this must be "1". A future-proofing configuration file version field. Currently this must be "1".
.. _ai-interactive-sections: .. _ai-interactive-sections:
@ -49,7 +49,7 @@ interactive-sections
* **type:** list of strings * **type:** list of strings
* **default:** [] * **default:** []
A list of config keys to still show in the UI. So for example: A list of configuration keys to still show in the UI. For example:
.. code-block:: yaml .. code-block:: yaml
@ -60,15 +60,15 @@ A list of config keys to still show in the UI. So for example:
username: ubuntu username: ubuntu
password: $crypted_pass password: $crypted_pass
Would stop on the network screen and allow the user to change the defaults. If This example stops on the network screen and allows the user to change the defaults. If
a value is provided for an interactive section it is used as the default. a value is provided for an interactive section, it is used as the default.
You can use the special section name of "\*" to indicate that the installer You can use the special section name of ``*`` to indicate that the installer
should ask all the usual questions -- in this case, the :file:`autoinstall.yaml` should ask all the usual questions -- in this case, the :file:`autoinstall.yaml`
file is not really an "autoinstall" file at all, instead just a way to change file is not really an "autoinstall" file at all, instead just a way to change
the defaults in the UI. the defaults in the UI.
Not all config keys correspond to screens in the UI. This documentation Not all configuration keys correspond to screens in the UI. This documentation
indicates if a given section can be interactive or not. indicates if a given section can be interactive or not.
If there are any interactive sections at all, the :ref:`ai-reporting` key is If there are any interactive sections at all, the :ref:`ai-reporting` key is
@ -85,9 +85,9 @@ early-commands
A list of shell commands to invoke as soon as the installer starts, in A list of shell commands to invoke as soon as the installer starts, in
particular before probing for block and network devices. The autoinstall particular before probing for block and network devices. The autoinstall
config is available at :file:`/autoinstall.yaml` (irrespective of how it was configuration is available at :file:`/autoinstall.yaml` (irrespective of how it was
provided) and the file will be re-read after the ``early-commands`` have run to provided) and the file will be re-read after the ``early-commands`` have run to
allow them to alter the config if necessary. allow them to alter the configuration if necessary.
.. _ai-locale: .. _ai-locale:
@ -143,7 +143,7 @@ The layout of any attached keyboard. Often systems being automatically
installed will not have a keyboard at all in which case the value used here installed will not have a keyboard at all in which case the value used here
does not matter. does not matter.
The mapping's keys correspond to settings in the :file:`/etc/default/keyboard` The mapping keys correspond to settings in the :file:`/etc/default/keyboard`
configuration file. See the :manualpage:`keyboard(5) manual page <man5/keyboard.5.html>` configuration file. See the :manualpage:`keyboard(5) manual page <man5/keyboard.5.html>`
for more details. for more details.
@ -206,24 +206,24 @@ id
* **type:** string * **type:** string
* **default:** identifier of the first available source. * **default:** identifier of the first available source.
Identifier of the source to install (e.g., ``"ubuntu-server-minimal"``). Identifier of the source to install (e.g., ``ubuntu-server-minimal``).
.. _ai-network: .. _ai-network:
network network
------- -------
* **type:** netplan-format mapping, see below * **type:** Netplan-format mapping, see below
* **default:** DHCP on interfaces named ``eth*`` or ``en*`` * **default:** DHCP on interfaces named ``eth*`` or ``en*``
* **can be interactive:** yes * **can be interactive:** yes
`Netplan-formatted <https://netplan.io/reference>`_ network configuration. `Netplan-formatted <https://netplan.io/reference>`_ network configuration.
This will be applied during installation as well as in the installed system. This will be applied during installation as well as in the installed system.
The default is to interpret the config for the install media, which runs The default is to interpret the configuration for the installation media, which runs
DHCPv4 on any interface with a name matching "``eth*``" or "``en*``" but then DHCP version 4 on any interface with a name matching ``eth*`` or ``en*`` but then
disables any interface that does not receive an address. disables any interface that does not receive an address.
For example, to run DHCPv6 on a particular NIC: For example, to run DHCP version 6 on a specific network interface:
.. code-block:: yaml .. code-block:: yaml
@ -234,8 +234,7 @@ For example, to run DHCPv6 on a particular NIC:
dhcp6: true dhcp6: true
Note that in the 20.04 GA release of Subiquity, the behaviour is slightly Note that in the 20.04 GA release of Subiquity, the behaviour is slightly
different and requires you to write this with an extra ``network:`` key, like different and requires you to write this with an extra ``network:`` key:
so:
.. code-block:: yaml .. code-block:: yaml
@ -270,7 +269,7 @@ apt
* **default:** see below * **default:** see below
* **can be interactive:** yes * **can be interactive:** yes
APT configuration, used both during the install and once booted into the target APT configuration, used both during the installation and once booted into the target
system. system.
This section historically used the same format as curtin, This section historically used the same format as curtin,
@ -280,7 +279,7 @@ Nonetheless, some key differences with the format supported by curtin have been
- Subiquity supports an alternative format for the ``primary`` section, - Subiquity supports an alternative format for the ``primary`` section,
allowing configuration of a list of candidate primary mirrors. During allowing configuration of a list of candidate primary mirrors. During
installation, Subiquity will automatically test the specified mirrors and installation, Subiquity will automatically test the specified mirrors and
select the first one that seems usable. This new behavior is only activated select the first one that seems usable. This new behaviour is only activated
when the ``primary`` section is wrapped in the ``mirror-selection`` section. when the ``primary`` section is wrapped in the ``mirror-selection`` section.
- The ``fallback`` key controls what Subiquity should do if no primary mirror - The ``fallback`` key controls what Subiquity should do if no primary mirror
@ -323,7 +322,7 @@ can be expressed in two different ways:
* The special value ``country-mirror`` * The special value ``country-mirror``
* A mapping with the following keys: * A mapping with the following keys:
* ``uri``: The URI of the mirror to use, e.g., "http://fr.archive.ubuntu.com/ubuntu" * ``uri``: The URI of the mirror to use, e.g., ``http://fr.archive.ubuntu.com/ubuntu``
* ``arches``: An optional list of architectures supported by the mirror. By * ``arches``: An optional list of architectures supported by the mirror. By
default, this list contains the current CPU architecture. default, this list contains the current CPU architecture.
@ -353,7 +352,7 @@ Subiquity then sets the mirror URI to ``http://CC.archive.ubuntu.com/ubuntu``
(or similar for ports) where ``CC`` is the country code returned by the lookup. (or similar for ports) where ``CC`` is the country code returned by the lookup.
If this section is not interactive, the request is timed out after 10 seconds. If this section is not interactive, the request is timed out after 10 seconds.
If the legacy behavior (i.e., without mirror-selection) is in use, the geoip If the legacy behaviour (i.e., without mirror-selection) is in use, the geoip
request is made if the mirror to be used is the default, and its URI ends up request is made if the mirror to be used is the default, and its URI ends up
getting replaced by the proper country mirror URI. getting replaced by the proper country mirror URI.
@ -368,7 +367,7 @@ If you just want to specify a mirror, you can use a configuration like this:
- country-mirror - country-mirror
- uri: http://archive.ubuntu.com/ubuntu - uri: http://archive.ubuntu.com/ubuntu
To add a ppa: To add a PPA:
.. code-block:: yaml .. code-block:: yaml
@ -383,8 +382,8 @@ storage
------- -------
* **type:** mapping, see below * **type:** mapping, see below
* **default:** use "lvm" layout in a single disk system, no default in a * **default:** use the ``lvm`` layout on single-disk systems; there is no default for
multiple disk system multiple-disk systems
* **can be interactive:** yes * **can be interactive:** yes
Storage configuration is a complex topic and the description of the desired Storage configuration is a complex topic and the description of the desired
@ -394,7 +393,7 @@ supports "layouts"; simple ways of expressing common configurations.
Supported layouts Supported layouts
~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~
The three supported layouts at the time of writing are "lvm", "direct", and "zfs". The three supported layouts at the time of writing are ``lvm``, ``direct`` and ``zfs``.
.. code-block:: yaml .. code-block:: yaml
@ -428,7 +427,7 @@ supply a match spec (see below) to indicate which disk to use:
.. note:: .. note::
Match spec -- using "``match: {}``" will match an arbitrary disk Match spec -- using "``match: {}``" will match an arbitrary disk
When using the "lvm" layout, LUKS encryption can be enabled by supplying a When using the ``lvm`` layout, LUKS encryption can be enabled by supplying a
password. password.
.. code-block:: yaml .. code-block:: yaml
@ -444,9 +443,9 @@ The default is to use the ``lvm`` layout.
Sizing-policy Sizing-policy
~~~~~~~~~~~~~ ~~~~~~~~~~~~~
The lvm layout will, by default, attempt to leave room for snapshots and The ``lvm`` layout, by default, attempts to leave room for snapshots and
further expansion. A sizing-policy key may be supplied to control this further expansion. A sizing-policy key may be supplied to control this
behavior. behaviour.
* **type:** string (enumeration) * **type:** string (enumeration)
* **default:** scaled * **default:** scaled
@ -459,10 +458,10 @@ Supported values are:
The scaling system is currently as follows: The scaling system is currently as follows:
* Less than 10 GiB: use all remaining space for root filesystem * Less than 10 GiB: use all remaining space for root file system
* Between 10--20 GiB: 10 GiB root filesystem * Between 10--20 GiB: 10 GiB root file system
* Between 20--200 GiB: use half of remaining space for root filesystem * Between 20--200 GiB: use half of remaining space for root file system
* Greater than 200 GiB: 100 GiB root filesystem * Greater than 200 GiB: 100 GiB root file system
Example with no size scaling and a passphrase: Example with no size scaling and a passphrase:
@ -474,20 +473,20 @@ Example with no size scaling and a passphrase:
sizing-policy: all sizing-policy: all
password: LUKS_PASSPHRASE password: LUKS_PASSPHRASE
Action-based config Action-based configuration
~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~
For full flexibility, the installer allows storage configuration to be done For full flexibility, the installer allows storage configuration to be done
using a syntax which is a superset of that supported by curtin, as described in using a syntax which is a superset of that supported by curtin, as described in
`the curtin documentation <https://curtin.readthedocs.io/en/latest/topics/storage.html>`_. `the curtin documentation <https://curtin.readthedocs.io/en/latest/topics/storage.html>`_.
If the "layout" feature is used to configure the disks, the "config" section If the ``layout`` feature is used to configure the disks, the ``config`` section
will not be used. is not used.
As well as putting the list of actions under the 'config' key, the As well as putting the list of actions under the ``config`` key, the
`grub <https://curtin.readthedocs.io/en/latest/topics/config.html#grub>`_ and `grub <https://curtin.readthedocs.io/en/latest/topics/config.html#grub>`_ and
`swap <https://curtin.readthedocs.io/en/latest/topics/config.html#swap>`_ `swap <https://curtin.readthedocs.io/en/latest/topics/config.html#swap>`_
curtin config items can be put here. So a storage section might look like: curtin configuration items can be put here. So a storage section might look like:
.. code-block:: yaml .. code-block:: yaml
@ -513,7 +512,7 @@ Curtin supported identifying disks by serial (e.g.
server installer supports this as well. The installer additionally supports a server installer supports this as well. The installer additionally supports a
''match spec'' on a disk action that supports more flexible matching. ''match spec'' on a disk action that supports more flexible matching.
The actions in the storage config are processed in the order they are in the The actions in the storage configuration are processed in the order they are in the
autoinstall file. Any disk action is assigned a matching disk -- chosen autoinstall file. Any disk action is assigned a matching disk -- chosen
arbitrarily from the set of unassigned disks if there is more than one, and arbitrarily from the set of unassigned disks if there is more than one, and
causing the installation to fail if there is no unassigned matching disk. causing the installation to fail if there is no unassigned matching disk.
@ -540,7 +539,7 @@ A match spec supports the following keys:
A special sort of key is ``install-media: true``, which will take the disk the A special sort of key is ``install-media: true``, which will take the disk the
installer was loaded from (the ``ssd`` and ``size`` selectors will never return installer was loaded from (the ``ssd`` and ``size`` selectors will never return
this disk). If installing to the install media, care obviously needs to be taken this disk). If installing to the installation media, care obviously needs to be taken
to not overwrite the installer itself! to not overwrite the installer itself!
So for example, to match an arbitrary disk it is simply: So for example, to match an arbitrary disk it is simply:
@ -574,7 +573,7 @@ Partition/logical volume extensions
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The size of a partition or logical volume in curtin is specified as a number of The size of a partition or logical volume in curtin is specified as a number of
bytes. The autoinstall config is more flexible: bytes. The autoinstall configuration is more flexible:
* You can specify the size using the "1G", "512M" syntax supported in the * You can specify the size using the "1G", "512M" syntax supported in the
installer UI. installer UI.
@ -607,7 +606,7 @@ identity
* **default:** no default * **default:** no default
* **can be interactive:** yes * **can be interactive:** yes
Configure the initial user for the system. This is the only config key that Configure the initial user for the system. This is the only configuration key that
must be present (unless the :ref:`user-data section <ai-user-data>` is present, must be present (unless the :ref:`user-data section <ai-user-data>` is present,
in which case it is optional). in which case it is optional).
@ -634,11 +633,11 @@ password
The password for the new user, encrypted. This is required for use with The password for the new user, encrypted. This is required for use with
``sudo``, even if SSH access is configured. ``sudo``, even if SSH access is configured.
The crypted password string must conform to what the The encrypted password string must conform to what the
``passwd`` command requires. See the :manualpage:`passwd(1) manual page <man1/passwd.1.html>` ``passwd`` command requires. See the :manualpage:`passwd(1) manual page <man1/passwd.1.html>`
for details. Quote the password hash to ensure correct treatment of any special characters. for details. Quote the password hash to ensure correct treatment of any special characters.
Several tools can generate the crypted password, such as ``mkpasswd`` from the Several tools can generate the encrypted password, such as ``mkpasswd`` from the
``whois`` package, or ``openssl passwd``. ``whois`` package, or ``openssl passwd``.
Example: Example:
@ -711,7 +710,7 @@ install-server
Whether to install OpenSSH server in the target system. Whether to install OpenSSH server in the target system.
authorized-keys :spellexception:`authorized-keys`
~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~
* **type:** list of strings * **type:** list of strings
@ -807,7 +806,7 @@ debconf-selections
------------------ ------------------
* **type:** string * **type:** string
* **default:** no config * **default:** no configuration
* **can be interactive:** no * **can be interactive:** no
The installer will update the target with debconf set-selection values. Users The installer will update the target with debconf set-selection values. Users
@ -837,7 +836,7 @@ kernel
* **can be interactive:** no * **can be interactive:** no
Which kernel gets installed. Either the name of the package or the name of the Which kernel gets installed. Either the name of the package or the name of the
flavor must be specified. flavour must be specified.
package package
~~~~~~~ ~~~~~~~
@ -851,7 +850,7 @@ flavor
* **type:** string * **type:** string
The flavor of the kernel, e.g., ``generic`` or ``hwe``. The ``flavor`` of the kernel, e.g., ``generic`` or ``hwe``.
.. _ai-timezone: .. _ai-timezone:
@ -875,7 +874,7 @@ updates
* **can be interactive:** no * **can be interactive:** no
The type of updates that will be downloaded and installed after the system The type of updates that will be downloaded and installed after the system
install. Supported values are: installation. Supported values are:
* ``security`` -> download and install updates from the -security pocket * ``security`` -> download and install updates from the -security pocket
* ``all`` -> also download and install updates from the -updates pocket * ``all`` -> also download and install updates from the -updates pocket
@ -904,7 +903,7 @@ late-commands
* **default:** no commands * **default:** no commands
* **can be interactive:** no * **can be interactive:** no
Shell commands to run after the install has completed successfully and any Shell commands to run after the installation has completed successfully and any
updates and packages installed, just before the system reboots. They are run in updates and packages installed, just before the system reboots. They are run in
the installer environment with the installed system mounted at ``/target``. You the installer environment with the installed system mounted at ``/target``. You
can run ``curtin in-target -- $shell_command`` (with the version of Subiquity can run ``curtin in-target -- $shell_command`` (with the version of Subiquity
@ -922,7 +921,7 @@ error-commands
* **default:** no commands * **default:** no commands
* **can be interactive:** no * **can be interactive:** no
Shell commands to run after the install has failed. They are run in the Shell commands to run after the installation has failed. They are run in the
installer environment, and the target system (or as much of it as the installer installer environment, and the target system (or as much of it as the installer
managed to configure) will be mounted at ``/target``. Logs will be available managed to configure) will be mounted at ``/target``. Logs will be available
at :file:`/var/log/installer` in the live session. at :file:`/var/log/installer` in the live session.
@ -940,10 +939,10 @@ reporting
The installer supports reporting progress to a variety of destinations. Note The installer supports reporting progress to a variety of destinations. Note
that this section is ignored if there are any :ref:`interactive sections <ai-interactive-sections>`; it only applies to fully automated installs. that this section is ignored if there are any :ref:`interactive sections <ai-interactive-sections>`; it only applies to fully automated installs.
The config, and indeed the implementation, is 90% the same as The configuration, and indeed the implementation, is 90% the same as
`that used by curtin <https://curtin.readthedocs.io/en/latest/topics/reporting.html>`_. `that used by curtin <https://curtin.readthedocs.io/en/latest/topics/reporting.html>`_.
Each key in the ``reporting`` mapping in the config defines a destination, Each key in the ``reporting`` mapping in the configuration defines a destination,
where the ``type`` sub-key is one of: where the ``type`` sub-key is one of:
**The rsyslog reporter does not yet exist** **The rsyslog reporter does not yet exist**
@ -952,7 +951,7 @@ where the ``type`` sub-key is one of:
console. There is no other configuration. console. There is no other configuration.
* **rsyslog**: report progress via rsyslog. The **destination** key specifies * **rsyslog**: report progress via rsyslog. The **destination** key specifies
where to send output. where to send output.
* **webhook**: report progress via POSTing JSON reports to a URL. Accepts the * **webhook**: report progress by sending JSON reports to a URL using POST requests. Accepts the
same `configuration as curtin <https://curtin.readthedocs.io/en/latest/topics/reporting.html#webhook-reporter>`_. same `configuration as curtin <https://curtin.readthedocs.io/en/latest/topics/reporting.html#webhook-reporter>`_.
* **none**: do not report progress. Only useful to inhibit the default output. * **none**: do not report progress. Only useful to inhibit the default output.

12
doc/reference/autoinstall-schema.rst
View File

@ -3,15 +3,15 @@
Autoinstall schema Autoinstall schema
****************** ******************
The server installer validates the provided autoinstall config against a The server installer validates the provided autoinstall configuration against a
:ref:`JSON schema<autoinstall_JSON_schema>`. :ref:`JSON schema<autoinstall_JSON_schema>`.
How the config is validated How the configuration is validated
=========================== ==================================
Although the schema is presented below as a single document, and if you want Although the schema is presented below as a single document, and if you want
to pre-validate your config you should validate it against this document, the to pre-validate your configuration you should validate it against this document, the
config is not actually validated against this document at run time. What configuration is not actually validated against this document at run time. What
happens instead is that some sections are loaded, validated, and applied happens instead is that some sections are loaded, validated, and applied
first, before all other sections are validated. In detail: first, before all other sections are validated. In detail:
@ -19,7 +19,7 @@ first, before all other sections are validated. In detail:
2. The error commands are loaded and validated. 2. The error commands are loaded and validated.
3. The early commands are loaded and validated. 3. The early commands are loaded and validated.
4. The early commands, if any, are run. 4. The early commands, if any, are run.
5. The config is reloaded, and now all sections are loaded and validated. 5. The configuration is reloaded, and now all sections are loaded and validated.
This is so that validation errors in most sections can be reported via the This is so that validation errors in most sections can be reported via the
reporting and error-commands configuration, as all other errors are. reporting and error-commands configuration, as all other errors are.

46
doc/tutorial/basic-server-installation.rst
View File

@ -18,7 +18,7 @@ System requirements
------------------- -------------------
Ubuntu Server Edition provides a common, minimalist base for a variety of Ubuntu Server Edition provides a common, minimalist base for a variety of
server applications, such as file/print services, web hosting, email hosting, server applications, such as file or print services, web hosting, email hosting,
etc. This version supports four 64-bit architectures: etc. This version supports four 64-bit architectures:
* amd64 (Intel/AMD 64-bit) * amd64 (Intel/AMD 64-bit)
@ -32,8 +32,8 @@ The recommended system requirements are:
* RAM: 1 gigabyte or more * RAM: 1 gigabyte or more
* Disk: a minimum of 2.5 gigabytes * Disk: a minimum of 2.5 gigabytes
Perform a system back up Perform a system backup
------------------------ -----------------------
Before installing Ubuntu Server Edition you should make sure all data on the Before installing Ubuntu Server Edition you should make sure all data on the
system is backed up. system is backed up.
@ -50,8 +50,8 @@ use, but they also perform destructive actions.
Download the server ISO Download the server ISO
----------------------- -----------------------
You can obtain the amd64 server download from https://releases.ubuntu.com/. You can obtain the amd64 server download from `releases.ubuntu.com <https://releases.ubuntu.com/>`_.
Select the version you wish to install and select the "server install image" Select the version you wish to install and select the "Server install image"
download. Note that the server download includes the installer. download. Note that the server download includes the installer.
There are platform-specific how-to guides for installations on: There are platform-specific how-to guides for installations on:
@ -73,7 +73,7 @@ are also available).
Perform the installation Perform the installation
======================== ========================
Now that you have prepared your install medium, you are ready to install. Now that you have prepared your installation medium, you are ready to install.
Boot the installer Boot the installer
------------------ ------------------
@ -83,17 +83,16 @@ Plug the USB stick into the system to be installed and start it.
Most computers will automatically boot from USB or DVD, though in some cases Most computers will automatically boot from USB or DVD, though in some cases
this is disabled to improve boot times. If you don't see the boot message and this is disabled to improve boot times. If you don't see the boot message and
the "Welcome" screen which should appear after it, you will need to set your the "Welcome" screen which should appear after it, you will need to set your
computer to boot from the install media. computer to boot from the installation media.
There should be an on-screen message when the computer starts, telling you what There should be an on-screen message when the computer starts, telling you what
key to press for settings or a boot menu. Depending on the manufacturer, this key to press for settings or a boot menu. Depending on the manufacturer, this
could be :kbd:`Escape`, :kbd:`F2`, :kbd:`F10` or :kbd:`F12`. Restart your could be :kbd:`Escape`, :kbd:`F2`, :kbd:`F10` or :kbd:`F12`. Restart your
computer and hold down this key until the boot menu appears, then select the computer and hold down this key until the boot menu appears, then select the
drive with the Ubuntu install media. drive with the Ubuntu installation media.
If you are still having problems, check out the If you are still having problems, see the
`Ubuntu Community documentation on booting from `Ubuntu Community documentation on booting from CD/DVD <https://help.ubuntu.com/community/BootFromCD>`_.
CD/DVD <https://help.ubuntu.com/community/BootFromCD>`_.
After a few moments, the installer will start in its language selection screen. After a few moments, the installer will start in its language selection screen.
@ -103,21 +102,20 @@ After a few moments, the installer will start in its language selection screen.
Using the installer Using the installer
------------------- -------------------
The installer is designed to be easy to use and have sensible defaults so for The installer is designed to be easy to use and have sensible defaults, so for
a first install you can mostly just accept the defaults for the most a first installation you can accept the defaults:
straightforward install:
* Choose your language * Choose your language.
* Update the installer (if offered) * Update the installer (if offered).
* Select your keyboard layout * Select your keyboard layout.
* Do not configure networking (the installer attempts to configure wired * Do not configure networking (the installer attempts to configure wired
network interfaces via DHCP, but you can continue without networking if this network interfaces via DHCP, but you can continue without networking if this
fails) fails).
* Do not configure a proxy or custom mirror unless you have to in your network * Do not configure a proxy or custom mirror unless you have to in your network.
* For storage, leave "use an entire disk" checked, and choose a disk to install * For storage, leave "use an entire disk" checked, and choose a disk to install
to, then select "Done" on the configuration screen and confirm the install to, then select "Done" on the configuration screen and confirm the installation.
* Enter a username, hostname and password * Enter a username, hostname and password.
* On the SSH and snap screens, select "Done" * On the SSH and snap screens, select "Done".
* You will now see log messages as the install is completed * You now see log messages as the installation is completed.
* Select restart when this is complete, and log in using the username and * Select restart when this is complete, and log in using the username and
password provided password provided.

16
doc/tutorial/screen-by-screen.rst
View File

@ -72,8 +72,8 @@ Zdev (s390x only)
This screen is only shown on s390x and allows z-specific configuration of This screen is only shown on s390x and allows z-specific configuration of
devices. devices.
The list of devices can be long. :kbd:`Home` / :kbd:`End` / :kbd:`PageUp` The list of devices can be long. :kbd:`Home` / :kbd:`End` / :kbd:`PgUp`
/ :kbd:`PageDown` can be used to navigate through the list more quickly. / :kbd:`PgDown` can be used to navigate through the list more quickly.
Network Network
======= =======
@ -81,10 +81,10 @@ Network
.. image:: figures/sbs-network.png .. image:: figures/sbs-network.png
:alt: :alt:
This screen allows the configuration of the network. Ubuntu Server uses NetPlan This screen allows the configuration of the network. Ubuntu Server uses Netplan
to configure networking and the UI of the installer can configure a subset of to configure networking and the UI of the installer can configure a subset of
NetPlan's capabilities. In particular it can configure DHCP or static Netplan capabilities. In particular, it can configure DHCP or static
addressing, VLANs and bonds. addressing, VLAN and bonds.
If networking is present (defined as "at least one interface has a default If networking is present (defined as "at least one interface has a default
route") then the installer will install updates from the archive at the end of route") then the installer will install updates from the archive at the end of
@ -121,7 +121,7 @@ Storage configuration is a complicated topic and :ref:`has its own page for docu
.. image:: figures/sbs-confirm-storage.png .. image:: figures/sbs-confirm-storage.png
:alt: :alt:
Once the storage configuration is confirmed, the install begins in the Once the storage configuration is confirmed, the installation begins in the
background. background.
Identity Identity
@ -140,7 +140,7 @@ SSH
.. image:: figures/sbs-ssh.png .. image:: figures/sbs-ssh.png
:alt: :alt:
A default Ubuntu install has no open ports. It is very common to administer A default Ubuntu installation has no open ports. It is very common to administer
servers via SSH so the installer allows it to be installed with the click of a servers via SSH so the installer allows it to be installed with the click of a
button. button.
@ -165,7 +165,7 @@ Installation logs
:alt: :alt:
The final screen of the installer shows the progress of the installer and The final screen of the installer shows the progress of the installer and
allows viewing of the full log file. Once the install has completed and allows viewing of the full log file. Once the installation has completed and
security updates installed, the installer waits for confirmation before security updates installed, the installer waits for confirmation before
restarting. restarting.