Skip to content

Commit

Permalink
bare-metal: use CLI instead of kargs for ISO path
Browse files Browse the repository at this point in the history
I find using the CLI more elegant. Plus, you get better progress
reporting. Plus it introduces them to the live ISO in a more natural way
(I didn't spell it out, but users can infer from the output that they've
just booted into a working FCOS instance and they can play around as
they want).
  • Loading branch information
jlebon authored and dustymabe committed Jan 15, 2020
1 parent 3766be4 commit 482e0c1
Showing 1 changed file with 12 additions and 10 deletions.
22 changes: 12 additions & 10 deletions modules/ROOT/pages/bare-metal.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ This guide provides instructions to install Fedora CoreOS to bare metal. Two opt
== Prerequisite

Before installing FCOS, you must have an Ignition configuration file. If you do not have one, see xref:producing-ign.adoc[Producing an Ignition File].
Before installing FCOS, you must have an Ignition configuration file and host it somewhere (e.g. using `python3 -m http.server`). If you do not have one, see xref:producing-ign.adoc[Producing an Ignition File].

== Installing from ISO

Expand All @@ -18,15 +18,17 @@ To install FCOS onto bare metal with an ISO, follow these steps:
+
NOTE: You can install in either legacy boot (BIOS) mode or in UEFI mode, regardless of what mode the OS will use once installed.
+
. Burn the ISO to disk and boot it.
. From the boot menu, press `<TAB>` (isolinux) or `e` (grub) to edit the kernel command line.
. Add the following parameters to the kernel command line:
* `coreos.inst.install_dev=/dev/sda`
* `coreos.inst.stream=stable`
* `coreos.inst.ignition_url=http://example.com/config.ign`
. Press `<ENTER>` (isolinux) or `<CTRL-x>` (grub) to start the installation.

Once the installation is complete, the machine reboots. After rebooting, the first boot process begins. It is at this time that Ignition ingests the configuration file and provisions the system as specified.
. Burn the ISO to disk and boot it on the target system. The ISO is capable of bringing up a fully functioning FCOS system purely from memory (i.e. without using any disk storage). Once booted, you will have access to a bash command prompt.
. You can now fetch your Ignition config and run `coreos-installer`:
[source, bash]
----
curl -LO http://example.com/example.ign
sudo coreos-installer install /dev/sda --ignition example.ign
----

Once the installation is complete, you can simply `sudo reboot`. After rebooting, the first boot process begins. It is at this time that Ignition ingests the configuration file and provisions the system as specified.

TIP: Check out `coreos-installer install --help` for more options on how to install Fedora CoreOS.

== Installing from PXE

Expand Down

0 comments on commit 482e0c1

Please sign in to comment.