From Fedora Project Wiki

(swap order in Optional, sounds more natural)
m (not just version can differ)
(5 intermediate revisions by 2 users not shown)
Line 9: Line 9:
$ sudo rpm-ostree status
$ sudo rpm-ostree status
State: idle
State: idle
AutomaticUpdates: disabled
Deployments:
Deployments:
● ostree://fedora:fedora/x86_64/coreos/stable
● ostree://fedora:fedora/x86_64/coreos/stable
                   Version: 31.20200505.3.0 (2020-05-19T13:39:46Z)
                   Version: 32.20201018.3.0 (2020-11-02T20:54:53Z)
                     Commit: 01f074cc6cd88d8d2b43f821da692f2367c101eb4377802cb35092bde0ef02f7
                     Commit: a6f3e91ad6e0b8e132769c1694ed9b747a339c04e4e6256fce3afd81c85e1f1f
               GPGSignature: Valid signature by 7D22D5867F2A4236474BF7B850CB390B3C3359C4
               GPGSignature: Valid signature by 97A1AE57C3A2372CCA3A4ABA6C13026D12C944D0
</pre>
</pre>
The heavy dot ● shows the currently booted tree (if you see multiple deployments available). The current tree should show `fedora/x86_64/coreos/stable`. The version may differ from the above output.
The black circle ● shows the currently booted tree (if you see multiple deployments available). The current tree should show `fedora/x86_64/coreos/stable`. The rest of the lines may differ from the above output.
<li> Follow the [https://docs.fedoraproject.org/en-US/fedora-coreos/update-streams/ Update Streams] documentation to switch your system to the `next` stream.
<li> Follow the [https://docs.fedoraproject.org/en-US/fedora-coreos/update-streams/ Update Streams] documentation to switch your system to the `next` stream.
<ul><li> A package difference should be displayed during the switch operation for you to review.
<ul><li> A package difference should be displayed during the switch operation for you to review.
Line 27: Line 26:
Deployments:
Deployments:
● ostree://fedora:fedora/x86_64/coreos/next
● ostree://fedora:fedora/x86_64/coreos/next
                   Version: 32.20200517.1.0 (2020-05-19T09:23:58Z)
                  Version: 33.20201104.1.0 (2020-11-05T14:20:13Z)
                     Commit: 7c23c4735fb3c541586f0a4d3ca956ef93ef7d76f00a19bccf51460bafa7ee97
                    Commit: f7bff56c9710b5fedb22d50651bcd875856bb83510f7115e10d21167bd9a3b75
               GPGSignature: Valid signature by 7D22D5867F2A4236474BF7B850CB390B3C3359C4
              GPGSignature: Valid signature by 963A2BEB02009608FE67EA4249FD77499570FF31
 
  ostree://fedora:fedora/x86_64/coreos/stable
                   Version: 32.20201018.3.0 (2020-11-02T20:54:53Z)
                     Commit: a6f3e91ad6e0b8e132769c1694ed9b747a339c04e4e6256fce3afd81c85e1f1f
               GPGSignature: Valid signature by 97A1AE57C3A2372CCA3A4ABA6C13026D12C944D0
</pre>
</pre>
The current tree should show `fedora/x86_64/coreos/next`. The version may differ from the above output.
The current tree should show `fedora/x86_64/coreos/next`. The rest of the lines may differ from the above output.
</ol>
</ol>



Revision as of 12:14, 9 November 2020

Description

This tests whether an existing Fedora CoreOS instance running on the stable stream can switch to the next stream.

Setup

  1. Have access to a (or install a new) FCOS instance running the stable stream.

How to test

  1. Verify that your FCOS system is running on stable:
    $ sudo rpm-ostree status
    State: idle
    Deployments:
    ● ostree://fedora:fedora/x86_64/coreos/stable
                       Version: 32.20201018.3.0 (2020-11-02T20:54:53Z)
                        Commit: a6f3e91ad6e0b8e132769c1694ed9b747a339c04e4e6256fce3afd81c85e1f1f
                  GPGSignature: Valid signature by 97A1AE57C3A2372CCA3A4ABA6C13026D12C944D0
    

    The black circle ● shows the currently booted tree (if you see multiple deployments available). The current tree should show fedora/x86_64/coreos/stable. The rest of the lines may differ from the above output.

  2. Follow the Update Streams documentation to switch your system to the next stream.
    • A package difference should be displayed during the switch operation for you to review.
  3. Reboot
  4. Verify that your system is now running on the next stream:
    $ sudo rpm-ostree status
    State: idle
    Deployments:
    ● ostree://fedora:fedora/x86_64/coreos/next
                       Version: 33.20201104.1.0 (2020-11-05T14:20:13Z)
                        Commit: f7bff56c9710b5fedb22d50651bcd875856bb83510f7115e10d21167bd9a3b75
                  GPGSignature: Valid signature by 963A2BEB02009608FE67EA4249FD77499570FF31
    
      ostree://fedora:fedora/x86_64/coreos/stable
                       Version: 32.20201018.3.0 (2020-11-02T20:54:53Z)
                        Commit: a6f3e91ad6e0b8e132769c1694ed9b747a339c04e4e6256fce3afd81c85e1f1f
                  GPGSignature: Valid signature by 97A1AE57C3A2372CCA3A4ABA6C13026D12C944D0
    

    The current tree should show fedora/x86_64/coreos/next. The rest of the lines may differ from the above output.

Expected Results

  1. The system successfully reboots and runs on the next stream.
  2. The system is functional (you can connect the same way as before, your services are running as before).
  3. The linked documentation is clear, all steps are understandable, and nothing important is missing from it.

Optional

  1. Before switching to the next stream, try for example creating containers or configuring a service and verify that the changes are successfully carried over after switching.
  2. After switching to the next stream, attempt both a temporary and a permanent manual rollback. After each rollback, verify that your system booted with the correct filesystem tree using sudo rpm-ostree status.