From Fedora Project Wiki

(some polish)
No edit summary
 
(7 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{QA/Test_Case
{{QA/Test_Case
|description= Install Fedora CoreOS on bare metal machine. For the sake of the testing the freshly-oven-baked changes, we would be using the <code>next</code> image.  
|description=Install Fedora CoreOS on bare metal machine using the `next` image.  
|setup=
|setup=
# Download and verify the latest [https://getfedora.org/coreos/download?tab=metal_virtualized&stream=next FCOS <b>next</b> image for bare metal]. Choose your preferred installation source (ISO for an optical or USB drive, PXE for a network install or Raw for a direct disk copy to a hard drive.)
# Download and verify the latest [https://getfedora.org/coreos/download?tab=metal_virtualized&stream=next FCOS '''next''' image for bare metal machines]. Choose your preferred installation source (''ISO'' for an optical or USB drive or ''PXE'' for a network install).
# Familiarize yourself with FCOS [https://docs.fedoraproject.org/en-US/fedora-coreos/getting-started/#_provisioning_philosophy provisioning philosophy], i.e. the role of an Ignition config file during system installation.


|actions=
|actions=
# Follow [https://docs.fedoraproject.org/en-US/fedora-coreos/bare-metal/ Installing CoreOS on Bare Metal] documentation to install FCOS to a bare metal machine.
# [https://docs.fedoraproject.org/en-US/fedora-coreos/producing-ign/ Create an Ignition config]. You can use the simplest example available which includes your SSH key.
#* '''FIXME:''' Raw installation instructions are not available in the linked documentation. Furthermore, it's not clear what "Raw (4k Native)" download option exactly means.
# Follow the documentation for [https://docs.fedoraproject.org/en-US/fedora-coreos/bare-metal/ installing CoreOS on Bare Metal] (using `next` instead of `stable` in the instructions).
# You should be able to see the IP address printed at the login prompt of the serial console.
# SSH into the machine using `ssh username@ipaddress` (replace ''username'' and ''ipaddress'' with actual values).


|results=
|results=
The following must be true to consider this a successful test run:
# The system runs on a bare metal machine according to the instructions.
# Confirm that you can SSH successfully into the machine according to the instructions (and the contents of your Ignition file).
# You can read the IP address of the machine from the serial console.
# Verify that the linked documentation works without a hitch and all steps are understandable.
# You can connect to the machine via SSH.
# The linked documentation is clear, all steps are understandable, and nothing important is missing from it.
 
|optional=
# Follow the documentation in [https://docs.fedoraproject.org/en-US/fedora-coreos/authentication/#_using_password_authentication this section] to add a password to your configuration. Then try to log into the machine on the serial console using that password.
# Follow the documentation in [https://docs.fedoraproject.org/en-US/fedora-coreos/authentication/#_enabling_ssh_password_authentication this section] to enable SSH password authentication. Then try to log into the machine over SSH using a username and password.


|optional=If you see some issues, investigate the logs in journal, make sure the services are running.
}}
}}
[[Category:CoreOS Test Cases]]

Latest revision as of 14:03, 26 April 2021

Description

Install Fedora CoreOS on bare metal machine using the next image.

Setup

  1. Download and verify the latest FCOS next image for bare metal machines. Choose your preferred installation source (ISO for an optical or USB drive or PXE for a network install).
  2. Familiarize yourself with FCOS provisioning philosophy, i.e. the role of an Ignition config file during system installation.

How to test

  1. Create an Ignition config. You can use the simplest example available which includes your SSH key.
  2. Follow the documentation for installing CoreOS on Bare Metal (using next instead of stable in the instructions).
  3. You should be able to see the IP address printed at the login prompt of the serial console.
  4. SSH into the machine using ssh username@ipaddress (replace username and ipaddress with actual values).

Expected Results

  1. The system runs on a bare metal machine according to the instructions.
  2. You can read the IP address of the machine from the serial console.
  3. You can connect to the machine via SSH.
  4. The linked documentation is clear, all steps are understandable, and nothing important is missing from it.

Optional

  1. Follow the documentation in this section to add a password to your configuration. Then try to log into the machine on the serial console using that password.
  2. Follow the documentation in this section to enable SSH password authentication. Then try to log into the machine over SSH using a username and password.