Creates bare-metal-install-server; replaces bare-metal-install. (#476)

- Revises majority of figures. - Revises User Manager to Manage User - Revise all other submenus per release: clear-29180-0502-live-server.iso Signed-off-by: Michael Vincerra <michael.vincerra@intel.com> Revises para under Install CL| on your target system. Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2026-08-23 16:05:58 +00:00 · 2019-05-09 13:40:30 -07:00
parent 00cd2b705c
commit 5b20941aeb
81 changed files with 875 additions and 99 deletions
@@ -0,0 +1,855 @@
+.. _bare-metal-install-server:
+
+Install |CL-ATTR| on bare metal with live server
+################################################
+
+These instructions guide you through installing |CL-ATTR| on bare metal from a bootable USB drive using a live server image.
+
+.. contents::
+   :local:
+   :depth: 1
+
+System requirements
+*******************
+
+Assure that your target system supports the installation:
+
+* :ref:`system-requirements`
+* :ref:`compatibility-check`
+
+Download the latest |CL| live server image
+******************************************
+
+Get the latest |CL| installer image from the `downloads page`_. Look for the
+:file:`clear-[version number]-live-server.iso` file.
+
+#. Follow your OS instructions to create a bootable USB drive.
+
+   * :ref:`bootable-usb`
+
+#. After downloading the image, verify and decompress the file per your OS.
+
+Install |CL| on your target system
+**********************************
+
+Ensure that your system is configured to boot UEFI. The installation method
+described below requires a wired Internet connection with DHCP.
+
+.. note::
+
+   Alternatively, you can install |CL| over a wireless connection by first
+   using `nmtui`. Follow the `nmtui` instructions shown in Figure 2.
+
+Follow these steps to install |CL| on the target system:
+
+#. Insert the USB drive into an available USB slot.
+
+#. Power on the system.
+
+#. Open the system BIOS setup menu by pressing the :kbd:`F2` key.
+   Your BIOS setup menu entry point may vary.
+
+#. In the setup menu, enable the UEFI boot and set the USB drive as the first
+   option in the device boot order.
+
+#. Save these settings and exit.
+
+#. Reboot the target system.
+
+#. This action launches the |CL| installer boot menu, shown in figure 1.
+
+   .. figure:: figures/bare-metal-install-server-01.png
+      :scale: 100%
+      :alt: Clear Linux OS Installer boot menu
+
+      Figure 1: Clear Linux OS Installer boot menu
+
+#. With :guilabel:`Clear Linux OS` highlighted, select :kbd:`Enter`.
+
+Launch the |CL| Installer
+*************************
+
+#. At the :guilabel:`login` prompt, enter :command:`root`.
+
+#. Follow the onscreen instructions, shown in Figure 2, and
+   enter a temporary password.
+
+   .. figure:: figures/bare-metal-install-server-02.png
+      :scale: 100%
+      :alt: root login
+
+      Figure 2: root login
+
+#. At the :guilabel:`root` prompt, enter :command:`clr-installer` and
+   press :kbd:`Enter`.
+
+   .. figure:: figures/bare-metal-install-server-03.png
+      :scale: 100%
+      :alt: clr-installer command
+
+      Figure 3: clr-installer command
+
+Minimum installation requirements
+*********************************
+
+To fulfill minimum installation requirements, complete the
+`Required options`_. While not required, we encourage you to apply the
+`Recommended options`_. `Advanced options`_ are optional.
+
+.. note::
+
+   * The :kbd:`Install` button is **only highlighted after** you complete
+     `Required options`_.
+
+Main Menu
+*********
+The |CL| Installer Main Menu appears as shown in Figure 4.
+
+.. figure:: figures/bare-metal-install-server-04.png
+   :scale: 100%
+   :alt: Clear Linux OS Installer
+
+   Figure 4: Clear Linux OS Installer
+
+The |CL| Installer Main Menu has two tabs: :guilabel:`[R] Required options`
+and :guilabel:`[A] Advanced options`. Navigate between tabs using the arrow
+these shortcut keys:
+
+* :kbd:`Shift+A` for :guilabel:`[A] Advanced options`
+* :kbd:`Shift+R` for :guilabel:`[R] Required options`
+
+To meet the minimum requirements, enter your choices in the
+:guilabel:`Required options`. After confirmation, your selections appear
+beside the :guilabel:`>>` chevron, below the menu options.
+
+Navigation
+**********
+
+* Select :kbd:`Tab` or :kbd:`Up/Down` arrows to highlight your choice.
+
+* Select :kbd:`Enter` or :kbd:`Spacebar` to confirm your choice.
+
+* Select :kbd:`Cancel` or :kbd:`Esc` to cancel your choice.
+
+Required options
+****************
+
+Choose Timezone
+===============
+
+#. From the Main Menu, navigate to :guilabel:`Choose Timezone`.
+   `UTC` is the default.
+
+#. Select :kbd:`Enter`.
+
+#. In :guilabel:`Select System Timezone`, use :kbd:`Up/Down` arrows
+   navigate to the desired timezone.
+
+.. todo: User need only select Enter; can only select Confirm with mouse.
+
+#. Press :kbd:`Enter` to confirm.
+
+   .. figure:: figures/bare-metal-install-server-05.png
+      :scale: 100%
+      :alt: Select System Timezone
+
+      Figure 5: Select System Timezone
+
+Choose Language
+===============
+
+#. From the Main Menu, navigate to :guilabel:`Choose Language`.
+
+#. Select :kbd:`Enter`.
+
+#. In :guilabel:`Select System Language`, navigate to your desired language.
+
+#. Press :kbd:`Enter` to confirm.
+
+   .. figure:: figures/bare-metal-install-server-06.png
+      :scale: 100%
+      :alt: Select System Language
+
+      Figure 6: Select System Language
+
+Configure the Keyboard
+======================
+
+#. From the Main Menu, select :guilabel:`Configure the Keyboard`.
+
+#. Select :kbd:`Enter`.
+
+#. In :guilabel:`Select Keyboard`, navigate to the desired option.
+
+#. Select :kbd:`Enter` to :kbd:`Confirm`.
+
+#. Optional: In :guilabel:`Test keyboard`, type text to assure
+   that the keys map to your keyboard.
+
+   .. figure:: figures/bare-metal-install-server-07.png
+      :scale: 100%
+      :alt: Select Keyboard menu
+
+      Figure 7: Select Keyboard menu
+
+Configure Installation Media
+============================
+
+#. From the Main Menu, select :guilabel:`Configure Installation Media`.
+
+#. Choose an installation method:
+   * `Safe Installation`_
+   * `Destructive Installation`_
+   * `Advanced Configuration`_
+
+
+   .. figure:: figures/bare-metal-install-server-08.png
+      :scale: 100%
+      :alt: Select Installation Media
+
+      Figure 8: Select Installation Media
+
+#. Select :guilabel:`Rescan Media` to show available installation targets.
+
+.. todo: Revise below section to match the dev-gui-00
+
+Safe Installation
+-----------------
+
+Use this method to safely install |CL| on media with available space, or
+alongside existing partitions, and accept the `Default partition schema`_.
+If enough free space exists, safe installation is allowed. See also
+`Troubleshooting`_ below.
+
+Destructive Installation
+------------------------
+
+Use this method to destroy the contents of the target device, install |CL|
+on it, and accept the `Default partition schema`_.
+
+.. note::
+
+   From the :guilabel:`Select Installation Media` menu, select
+   :guilabel:`Enable Encryption` to encrypt the root filesystem for either
+   option above. See also `Disk encryption`_ for more information.
+
+Advanced Configuration
+----------------------
+
+Use this method to manually configure partitions. These must meet
+`Default partition schema`_. You may also choose `Disk encryption`_ during
+configuration of each partition.
+
+.. note::
+
+   `Advanced Configuration` is available in the installer versions 1.2.0 and
+   above.
+
+#. From :guilabel:`Select Installation Media`, shown in Figure 8 above,
+   select :guilabel:`Advanced Configuration`.
+
+#. In :guilabel:`Advanced Configuration`, navigate to :file:`/dev/sda`
+   and then press :kbd:`Enter`.
+
+   .. figure:: figures/bare-metal-install-server-09.png
+      :scale: 100%
+      :alt: Advanced configuration menu
+
+      Figure 9: Advanced configuration menu
+
+#. Choose a partition method:
+
+   * :guilabel:`Auto Partition` Select this option to accept the
+     `Default partition schema`_.
+
+     #. Navigate to and press :guilabel:`Confirm`.
+
+     #. Continue with installation configuration. Jump to `Telemetry`_.
+
+   * `Manual Partition`_ Continue below.
+
+Manual Partition
+----------------
+
+We provide a simple example below.
+
+#. Navigate to the unallocated media (e.g.,`/dev/sda`) until highlighted, as
+   shown in Figure 9.
+
+#. Press :guilabel:`Enter` to edit the partition.
+
+#. The :guilabel:`Partition Setup` menu appears, shown in Figure 10.
+
+   .. note::
+
+      After adding the first partition, select :guilabel:`Free Space` to add another partition.
+
+root partition
+--------------
+
+#. We configure the `root` partition as shown in Figure 10.
+   Configuration of the `root` partition varies.
+
+   .. figure:: figures/bare-metal-install-server-10.png
+      :scale: 100%
+      :alt: root partition
+
+      Figure 10: root partition
+
+#. Navigate to :guilabel:`Add` and press :guilabel:`Enter`.
+
+boot partition
+--------------
+
+#. We configure the `boot` partition as shown in Figure 11.
+
+   .. figure:: figures/bare-metal-install-server-11.png
+      :scale: 100%
+      :alt: boot partition
+
+      Figure 11: boot partition
+
+#. Navigate to :guilabel:`Add` and press :guilabel:`Enter`.
+
+swap partition
+--------------
+
+#. In the :guilabel:`File System` pulldown menu, select `swap`, and
+   enter a label. We enter the minimum required size (e.g., 256M).
+
+   .. figure:: figures/bare-metal-install-server-12.png
+      :scale: 100%
+      :alt: swap partition
+
+      Figure 12: swap partition
+
+#. Navigate to :guilabel:`Add` and press :guilabel:`Enter`.
+
+#. Next, navigate to :guilabel:`Confirm` and press :guilabel:`Enter`,
+   shown in Figure 13.
+
+   Manual partitioning is complete.
+
+   .. figure:: figures/bare-metal-install-server-13.png
+      :scale: 100%
+      :alt: Final configuration of disk partitions
+
+      Figure 13: Final configuration of disk partitions
+
+#. You may skip to the `Telemetry`_ section below.
+
+Disk encryption
+===============
+
+For greater security, disk encryption is supported using LUKS for the
+any partition except `/boot` on |CL|. To encrypt the root partition, see the
+example below. Encryption is optional.
+
+Encryption Passphrase
+---------------------
+
+|CL| uses a single passphrase for encrypted partitions. Additional keys may
+be configured post-installation using the ``cryptsetup`` tool.
+
+#. Optional: Select :guilabel:`[X] Encrypt` to encrypt the root partition,
+   as shown in Figure 14.
+
+   .. figure:: figures/bare-metal-install-server-14.png
+      :scale: 100%
+      :alt: Encrypt partition
+
+      Figure 14: Encrypt partition
+
+#. The :guilabel:`Encryption Passphrase` dialogue appears.
+
+   .. note::
+
+      Minimum length is 8 characters. Maximum length is 94 characters.
+
+   .. figure:: figures/bare-metal-install-server-15.png
+      :scale: 100%
+      :alt: Encryption Passphrase
+
+      Figure 15: Encryption Passphrase
+
+#. Enter the same passphrase in the first and second field.
+
+#. Navigate to :guilabel:`Confirm` and press :kbd:`Enter`.
+
+   .. note::
+
+      :guilabel:`Confirm` is only highlighted if passphrases match.
+
+Telemetry
+=========
+
+:ref:`telem-guide` is a |CL| feature that reports failures and crashes to
+the |CL| development team for improvements. For more detailed information,
+visit our :ref:`telemetry-about` page.
+
+Select your desired option on whether to participate in `telemetry`.
+
+#. In the Main Menu, navigate to :guilabel:`Telemetry` and select
+   :kbd:`Enter`.
+
+#. Select :kbd:`Tab` to highlight your choice.
+
+#. Select :kbd:`Enter` to confirm.
+
+   .. figure:: figures/bare-metal-install-server-16.png
+      :scale: 100%
+      :alt: Enable Telemetry
+
+      Figure 16: Enable Telemetry
+
+Recommended options
+*******************
+
+After you complete the `Required options`_, we highly recommend completing
+these selected `Advanced options`_ at minimum:
+
+* `Manage User`_ Assign a new user with administrative rights
+* `Assign Hostname`_ Simplify your development environment
+
+Skip to finish installation
+===========================
+
+After selecting values for all :guilabel:`Required options`, you may skip
+to `Finish installation`_.
+
+Otherwise, continue below. In the Main Menu, select
+:guilabel:`Advanced options` for additional configuration.
+
+Advanced options
+****************
+
+Configure Network Interfaces
+============================
+
+By default, |CL| is configured to automatically detect the host network
+interface using DHCP. However, if you want to use a static IP address or if
+you do not have a DHCP server on your network, follow these instructions to
+manually configure the network interface. Otherwise, default network
+interface settings are automatically applied.
+
+.. note::
+
+   If DHCP is available, no user selection may be required.
+
+#. Navigate to :guilabel:`Configure Network Interfaces` and
+   select :kbd:`Enter`.
+
+#. Navigate to the network :guilabel:`interface` you wish to change.
+
+#. When the desired :guilabel:`interface` is highlighted, select
+   :guilabel:`Enter` to edit.
+
+   .. note:: Multiple network interfaces may appear.
+
+   .. figure:: figures/bare-metal-install-server-17.png
+      :scale: 100%
+      :alt: Configure Network Interfaces
+
+      Figure 17: Configure Network Interfaces
+
+#. Notice :guilabel:`Automatic / dhcp` is selected by default (at bottom).
+
+   Optional: Navigate to the checkbox :guilabel:`Automatic / dhcp` and select
+   :kbd:`Spacebar` to deselect.
+
+   .. figure:: figures/bare-metal-install-server-18.png
+      :scale: 100%
+      :alt: Network interface configuration
+
+      Figure 18: Network interface configuration
+
+#. Navigate to the appropriate fields and assign the desired
+   network configuration.
+
+#. To save settings, navigate to :guilabel:`Confirm` and select
+   :kbd:`Enter`.
+
+   .. note::
+
+      To revert to previous settings, navigate to the :guilabel:`Cancel`
+      and select :kbd:`Enter`.
+
+#. Upon confirming network configuration, the :guilabel:`Testing Networking`
+   dialogue appears. Assure the result shows success. If a failure occurs,
+   your changes will not be saved.
+
+#. Upon confirmation, you are returned to :guilabel:`Network interface`
+   settings.
+
+#. Navigate to and select :guilabel:`Main Menu`.
+
+Optional: Skip to `Finish installation`_.
+
+Proxy
+=====
+
+|CL| automatically attempts to detect proxy settings, as described in
+`Autoproxy`_. If you need to manually assign proxy settings, follow this
+instruction.
+
+#. From the Advanced options menu, navigate to :guilabel:`Proxy`, and
+   select :kbd:`Enter`.
+
+#. Navigate to the field :guilabel:`HTTPS Proxy`.
+
+   .. figure:: figures/bare-metal-install-server-19.png
+      :scale: 100%
+      :alt: Configure the network proxy
+
+      Figure 19: Configure the network proxy
+
+#. Enter the desired proxy address and port using conventional syntax,
+   such as: \http://address:port.
+
+#. Navigate to :guilabel:`Confirm` and select :kbd:`Enter`.
+
+#. To revert to previous settings, navigate to :guilabel:`Cancel`
+   and select :guilabel:`Cancel`.
+
+Optional: Skip to `Finish installation`_.
+
+Test Network Settings
+=====================
+
+To manually assure network connectivity before installing |CL|,
+select :guilabel:`Test Network Settings` and select :guilabel:`Enter`.
+
+A progress bar appears as shown in Figure 20.
+
+.. figure:: figures/bare-metal-install-server-20.png
+   :scale: 100%
+   :alt: Testing Networking dialogue
+
+   Figure 20: Testing Networking dialogue
+
+.. note::
+
+   Any changes made to network settings are automatically tested
+   during configuration.
+
+Optional: Skip to `Finish installation`_.
+
+Bundle Selection
+================
+
+#. On the Advanced menu, select :guilabel:`Bundle Selection`
+
+#. Navigate to the desired bundle using :kbd:`Tab` or :kbd:`Up/Down` arrows.
+
+#. Select :kbd:`Spacebar` to select the checkbox for each desired bundle.
+
+   .. figure:: figures/bare-metal-install-server-21.png
+      :scale: 100%
+      :alt: Bundle Selection
+
+      Figure 21: Bundle Selection
+
+#. Optional: To start developing with |CL|, we recommend
+   adding :file:`os-clr-on-clr`.
+
+#. Navigate to and select :kbd:`Confirm`.
+
+   You are returned to the :guilabel:`Advanced options` menu.
+
+Optional: Skip to `Finish installation`_.
+
+Manage User
+===========
+
+Add New User
+------------
+
+#. In Advanced Options, select :guilabel:`Manage User`.
+
+#. Select :guilabel:`Add New User` as shown in Figure 22.
+
+   .. figure:: figures/bare-metal-install-server-22.png
+      :scale: 100%
+      :alt: Add New User, User Name
+
+      Figure 22: Add New User
+
+#. Optional: Enter a :guilabel:`User Name`.
+
+   .. note:
+
+      The User Name must be alphanumeric and can include spaces, commas, or hyphens. Maximum length is 64 characters.
+
+   .. figure:: figures/bare-metal-install-server-23.png
+      :scale: 100%
+      :alt: User Name
+
+      Figure 23: User Name
+
+#. Enter a :guilabel:`Login`.
+
+   .. note::
+
+      The User Login must be alphanumeric and can include hyphens and underscores. Maximum length is 31 characters.
+
+#. Enter a :guilabel:`Password`.
+
+   .. note:
+
+      Minimum length is 8 characters. Maximum length is 255 characters.
+
+#. In :guilabel:`Confirm`, enter the same password.
+
+#. Optional: Navigate to the :guilabel:`Administrative` checkbox and select
+   :kbd:`Spacebar` to assign administrative rights to the user.
+
+   .. note::
+
+      Selecting this option enables sudo privileges for the user.
+
+#. Select :kbd:`Confirm`.
+
+   .. note::
+
+      If desired, select :guilabel:`Reset` to reset the form.
+
+#. In :guilabel:`Manage User`, navigate to :guilabel:`Confirm`.
+
+#. With :guilabel:`Confirm` highlighted, select :kbd:`Enter`.
+
+Modify / Delete User
+--------------------
+
+#. In :guilabel:`Manage User`, navigate to the user you wish
+   to modify until highlighted, as shown in Figure 24.
+
+#. Select :kbd:`Enter` to modify the user.
+
+   .. figure:: figures/bare-metal-install-server-24.png
+      :scale: 100%
+      :alt: Modify User
+
+      Figure 24: Modify User
+
+#. Modify user details as desired.
+
+#. Navigate to :kbd:`Confirm` until highlighted.
+
+   .. note::
+
+      Optional: Select :guilabel:`Reset` to rest the form.
+
+#. Select :guilabel:`Confirm` to save the changes you made.
+
+#. Optional: In :guilabel:`Modify User`, to delete the user, navigate to
+   the :guilabel:`Delete` button and select :kbd:`Enter`.
+
+   .. figure:: figures/bare-metal-install-server-25.png
+      :scale: 100%
+      :alt: Delete User
+
+      Figure 25: Delete User
+
+You are returned to :guilabel:`Manage User`.
+
+#. Navigate to :kbd:`Confirm` until highlighted.
+
+#. Select :guilabel:`Enter` to complete :guilabel:`Manage User` options.
+
+Optional: Skip to `Finish installation`_.
+
+Kernel Command Line
+===================
+
+For advanced users, |CL| provides the ability to add or remove kernel
+arguments. If you want to append a new argument, enter the argument here.
+This argument will be used every time you install or update a
+new kernel.
+
+#. In Advanced Options, select :guilabel:`Tab` to highlight
+   :guilabel:`Kernel Command Line`.
+
+#. Select :kbd:`Enter`.
+
+   .. figure:: figures/bare-metal-install-server-26.png
+      :scale: 100%
+      :alt: kernel command line
+
+      Figure 26: kernel command line
+
+#. Choose from the following options.
+
+   * To add arguments, enter the argument in :guilabel:`Add Extra Arguments`.
+
+   * To remove an argument, enter the argument in
+     :guilabel:`Remove Arguments`.
+
+#. Select :kbd:`Confirm`.
+
+Optional: Skip to `Finish installation`_.
+
+Kernel Selection
+================
+
+#. Select a kernel option. By default, the latest kernel release is
+   selected. Native kernel is shown in Figure 27.
+
+#. To select a different kernel, navigate to it using :guilabel:`Tab`.
+
+   .. figure:: figures/bare-metal-install-server-27.png
+      :scale: 100%
+      :alt: Kernel selection
+
+      Figure 27: Kernel selection
+
+#. Select :kbd:`Spacebar` to select the desired option.
+
+#. Navigate to :kbd:`Confirm` and select :kbd:`Enter`.
+
+Optional: Skip to `Finish installation`_.
+
+Swupd Mirror
+============
+
+If you have your own custom mirror of |CL|, you can add its URL.
+
+#. In Advanced Options, select :guilabel:`Swupd Mirror`.
+
+#. To add a local swupd mirror, enter a valid URL in :guilabel:`Mirror URL:`
+
+#. Select :kbd:`Confirm`.
+
+   .. figure:: figures/bare-metal-install-server-28.png
+      :scale: 100%
+      :alt: Swupd Mirror
+
+      Figure 28: Swupd Mirror
+
+Optional: Skip to `Finish installation`_.
+
+Assign Hostname
+===============
+
+#. In Advanced Options, select :guilabel:`Assign Hostname`.
+
+#. In :guilabel:`Hostname`, enter the hostname only (excluding the domain).
+
+   .. note::
+
+      Hostname does not allow empty spaces. Hostname must start with an
+      alphanumeric character but may also contain hyphens. Maximum length of
+      63 characters.
+
+   .. figure:: figures/bare-metal-install-server-29.png
+      :scale: 100%
+      :alt: Assign Hostname
+
+      Figure 29: Assign Hostname
+
+#. Navigate to :kbd:`Confirm` until highlighted.
+
+#. Select :kbd:`Confirm`.
+
+Optional: Skip to `Finish installation`_.
+
+Automatic OS Updates
+====================
+
+Automatical OS updates are enabled by default. In the rare case that you
+need to disable automatic software updates, follow the onscreen instructions,
+shown in Figure 30.
+
+#. In Advanced Options, select :guilabel:`Automatic OS Updates`.
+
+#. Select the desired option.
+
+   .. figure:: figures/bare-metal-install-server-30.png
+      :scale: 100%
+      :alt: Automatic OS Updates
+
+      Figure 30: Automatic OS Updates
+
+You are returned to the :guilabel:`Main Menu`.
+
+Save Configuration Settings
+===========================
+
+#. In Advanced Options, select :guilabel:`Save Configuration Settings`.
+
+#. A dialogue box shows the installation configuration was saved to
+   :file:`clr-installer.yaml`
+
+   .. figure:: figures/bare-metal-install-server-31.png
+      :scale: 100%
+      :alt: Automatic OS Updates
+
+      Figure 31: Automatic OS Updates
+
+#. Use the :file:`clr-installer.yaml` file to install |CL|, with the same
+   configuration, on multiple targets.
+
+Finish installation
+*******************
+
+#. When you are satisfied with your installation configuration, navigate to
+   :guilabel:`Install` and select :kbd:`Enter`.
+
+   .. figure:: figures/bare-metal-install-server-32.png
+      :scale: 100%
+      :alt: Select Install
+
+      Figure 32: Select Install
+
+#. Select :guilabel:`reboot`.
+
+   .. note::
+
+      If you do not assign an administrative user, upon rebooting,
+      enter `root` and set the root password immediately.
+
+#. When the system reboots, remove any installation media present.
+
+Default partition schema
+========================
+
+To add partitions manually, see `Advanced configuration`_ below, and create
+partitions per requirements in Table 1.
+
+.. list-table:: **Table 1. Disk Partition Setup**
+   :widths: 33, 33, 33
+   :header-rows: 1
+
+   * - FileSystem
+     - Mount Point
+     - Minimum size
+   * - ``VFAT``
+     - /boot
+     - 150M
+   * - ``swap``
+     -
+     - 256MB
+   * - ``root``
+     - /
+     - *Size depends upon use case/desired bundles.*
+
+Troubleshooting
+***************
+
+For Configure Installation Media
+================================
+
+If a warning message appears that no media or space is available after
+entering :guilabel:`Configure Installation Media`:
+
+- Verify that target media has enough free space.
+
+- Confirm the USB is properly connected to and mounted on target media.
+
+- Review the size of existing partitions on the target media:
+
+  - Linux\* OS: :command:`lsblk -a`
+  - Windows\* OS:  :command:`diskpart`, then :command:`list disk`
+  - macOS\* platform: :command:`diskutil list`
+
+.. _Autoproxy: https://clearlinux.org/features/autoproxy
+.. _downloads page: https://clearlinux.org/downloads
@@ -1,79 +0,0 @@
-.. _bare-metal-install:
-
-Install |CL-ATTR| on bare metal
-###############################
-
-These instructions guide you through the installation of |CL-ATTR|
-on bare metal using a bootable USB drive.
-
-.. contents::
-   :local:
-   :depth: 1
-
-System requirements
-*******************
-
-Assure that your target system supports the installation:
-
-* :ref:`system-requirements`
-* :ref:`compatibility-check`
-
-Download the latest |CL| installer image
-****************************************
-
-Get the latest |CL| installer image from the `downloads page`_. See Figure 1.
-Look for the :file:`clear-[version number]-installer.img.xz` file.
-
-.. figure:: figures/bare-metal-install-1.png
-   :scale: 50%
-   :alt: Visit Downloads
-
-   Figure 1: Visit Downloads
-
-#. Follow your OS instructions to create a bootable USB drive.
-
-   * :ref:`bootable-usb`
-
-#. After downloading the image, verify and decompress the file per your OS.
-
-Install |CL| on your target system
-**********************************
-
-We formatted the previously created USB drive as a UEFI boot device. Our
-target system has a hard drive installed containing a single primary
-partition. The target system needs a wired Internet connection with DHCP.
-
-Follow these steps to install |CL| on the target system:
-
-#. Insert the USB drive into an available USB slot.
-
-#. Power on the system.
-
-#. Open the system BIOS setup menu by pressing the :kbd:`F2` key.
-   Your BIOS setup menu entry point may vary.
-
-#. In the setup menu, enable the UEFI boot and set the USB drive as the first
-   option in the device boot order.
-
-#. Save these settings and exit.
-
-#. Reboot the target system.
-
-#. This action launches the |CL| installer boot menu, shown in figure 2.
-
-   .. figure:: figures/bare-metal-install-2.png
-      :scale: 100%
-      :alt: Clear Linux OS Installer boot menu
-
-      Figure 2: Clear Linux OS Installer boot menu
-
-#. With :guilabel:`Clear Linux OS` highlighted, select :kbd:`Enter`.
-
-Your system will display the |CL| Installer.
-
-.. include:: ../bare-metal-install-beta/bare-metal-install-beta.rst
-   :start-after: incl-bare-metal-beta-start:
-
-
-.. _Autoproxy: https://clearlinux.org/features/autoproxy
-.. _downloads page: https://clearlinux.org/downloads
@@ -24,7 +24,7 @@ Install |CL|
 .. toctree::
   :maxdepth: 1

-   bare-metal-install/bare-metal-install
+   bare-metal-install-server/bare-metal-install-server
   virtual-machine-install/virtual-machine-install
   live-image
   bare-metal-install-beta/bare-metal-install-beta
@@ -167,7 +167,7 @@ and infrastructure can be stateless.

 The |CL| `downloads page`_ offers a live image that can be deployed as
 a PXE boot server if one doesn't already exist in your environment. Also see
-documentation on how to :ref:`bare-metal-install`.
+documentation on how to :ref:`bare-metal-install-server`.

 Cloud Instances or Virtual Machines
 -----------------------------------
@@ -181,7 +181,7 @@ The :command:`telemctl journal` command gives you access to features and options
 Set up a backend server to collect telemetry records
 ====================================================

-For this example, start with a clean installation of |CL| on a new system using the :ref:`bare-metal-install` getting started guide and:
+For this example, start with a clean installation of |CL| on a new system using the :ref:`bare-metal-install-server` getting started guide and:

 #. Join the :guilabel:`Stability Enhancement Program` to install and
   enable the telemetrics components.
@@ -42,7 +42,7 @@ Release notes
 Prerequisites
 *************

-* |CL| installed on host system. :ref:`Install <bare-metal-install>`
+* |CL| installed on host system. :ref:`Install <bare-metal-install-server>`
 * `containers-basic` bundle
 * `cloud-native-basic` bundle

@@ -26,7 +26,7 @@ Prerequisites

 This tutorial assumes you have installed |CL| on your host system.
 For detailed instructions on installing |CL| on a bare metal system, follow
-the :ref:`bare metal installation instructions<bare-metal-install>`.
+the :ref:`bare metal installation instructions<bare-metal-install-server>`.

 Before you install any new packages, update |CL| with the following command:

@@ -14,7 +14,7 @@ Before you begin

 This tutorial assumes you have installed |CL| on your host system.
 For detailed instructions on installing |CL| on a bare metal system, visit
-our :ref:`bare metal installation tutorial<bare-metal-install>`.
+our :ref:`bare metal installation tutorial<bare-metal-install-server>`.

 Install Flatpak on your host system
 ===================================
@@ -21,7 +21,7 @@ libraries to deploy architecture-based optimizations to your application code.
 Install and configure a |CL| host on bare metal
 ***********************************************

-First, follow our guide to :ref:`bare-metal-install`.
+First, follow our guide to :ref:`bare-metal-install-server`.

 Once the bare metal installation and initial configuration are complete,
 add the `desktop-dev` bundle to the system.
@@ -15,7 +15,7 @@ edge devices with accelerators.
 This tutorial demonstrates how to:

 * Set up the Intel® edge device with |CL-ATTR|
-* Install the OpenVINO™ toolkit and Amazon Web Services\* (AWS\*) 
+* Install the OpenVINO™ toolkit and Amazon Web Services\* (AWS\*)
  Greengrass\* software stacks
 * Use AWS Greengrass\* and AWS Lambda\* to deploy the FaaS samples from the cloud

@@ -58,7 +58,7 @@ Install the OS on the edge device
 *********************************

 Start with a clean installation of |CL| on a new system, using the
-:ref:`bare-metal-install`, found in :ref:`get-started`.
+:ref:`bare-metal-install-server`, found in :ref:`get-started`.

 Create user accounts
 ====================
@@ -14,7 +14,7 @@ Prerequisites
 *************

 Before following this tutorial, you should follow the
-:ref:`bare-metal-install` to ensure you have installed |CL|.
+:ref:`bare-metal-install-server` to ensure you have installed |CL|.

 Before you install any new packages, update |CL| with the following command:

@@ -13,7 +13,7 @@ Prerequisites

 This tutorial assumes you have installed |CL| on your host system.
 For detailed instructions on installing |CL| on a bare metal system, follow
-the :ref:`bare metal installation tutorial<bare-metal-install>`.
+the :ref:`bare metal installation tutorial<bare-metal-install-server>`.

 If you have Clear Containers installed on your |CL| system, then follow the
 :ref:`migrate Clear Containers to Kata Containers tutorial<kata_migration>`.
@@ -26,9 +26,9 @@ Prerequisites

 This tutorial assumes you have already installed |CL|. For detailed
 instructions on installing |CL| on a bare metal system, follow the
-:ref:`bare metal installation tutorial<bare-metal-install>`. Learn about the
-benefits of having an up-to-date system for cloud orchestration on the
-:ref:`swupd-about` page.
+:ref:`bare metal installation tutorial<bare-metal-install-server>`.
+Learn about the benefits of having an up-to-date system for cloud
+orchestration on the :ref:`swupd-about` page.

 Before you install any new packages, update |CL| with the following command:

@@ -15,7 +15,7 @@ Prerequisites

 This tutorial assumes you have installed |CL| on your host system. For detailed
 instructions on installing |CL| on a bare metal system, follow the
-:ref:`bare metal installation tutorial<bare-metal-install>`.
+:ref:`bare metal installation tutorial<bare-metal-install-server>`.

 Before you install any new packages, update |CL| with the following command:

@@ -11,7 +11,7 @@ Prerequisites
 *************

 This tutorial assumes you have installed |CL| on your host system. For
-detailed instructions, follow the steps in :ref:`bare-metal-install`.
+detailed instructions, follow the steps in :ref:`bare-metal-install-server`.

 Before you install any new packages, update |CL| with the following command:

@@ -20,7 +20,7 @@ Prerequisites

 This tutorial assumes you have installed |CL| on your host system.
 For detailed instructions on installing |CL| on a bare metal system, visit
-the :ref:`bare metal installation tutorial<bare-metal-install>`.
+the :ref:`bare metal installation tutorial<bare-metal-install-server>`.

 Before you install any new packages, update |CL| with the following command:

@@ -11,7 +11,7 @@ tutorial installs MariaDB\*, which is a drop-in replacement for MySQL\*.
 In order to create a web server using |CL| as the host OS, your host system
 must be running |CL|. This tutorial assumes you have installed |CL| on your
 host system. For detailed instructions on installing |CL| on a bare metal system,
-visit the :ref:`bare metal installation tutorial<bare-metal-install>`.
+visit the :ref:`bare metal installation tutorial<bare-metal-install-server>`.

 This tutorial covers:

@@ -12,8 +12,8 @@ can add the WordPress components needed to host a WordPress website on your syst
 Before you begin
 ****************

-This tutorial assumes you have successfully completed :ref:`bare-metal-install`
-and that you have :ref:`web-server-install`.
+This tutorial assumes you have successfully completed
+:ref:`bare-metal-install-server` and that you have :ref:`web-server-install`.

 Create a WordPress server
 *************************