qubes-doc/user/downloading-installing-upgrading/upgrade/upgrade-to-r3_2.md
Andrew David Wong a18174dc5e
Fix capitalization; update terms (QubesOS/qubes-issues#6769)
Thank you to @unman for the initial sentence case pass.
2021-07-09 05:10:44 -07:00

6.0 KiB

lang layout permalink redirect_from ref title
en doc /doc/upgrade-to-r3.2/
/en/doc/upgrade-to-r3.2/
/doc/UpgradeToR3.2/
/doc/UpgradeToR3.2rc1/
161 Upgrading to R3.2

Before attempting either an in-place upgrade or a clean installation, we strongly recommend that users back up their systems.

Current Qubes R3.1 systems can be upgraded in-place to the latest R3.2 by following the procedure below.

Upgrading dom0

  1. Close Qubes Manager (right click on its tray icon -> Exit)

  2. Open a terminal in Dom0. (E.g., Start -> System Settings -> Konsole.)

  3. Install qubes-release package carrying R3.2 repository information.

    sudo qubes-dom0-update --releasever=3.2 qubes-release
    

    If you made any manual changes to repository definitions, new definitions will be installed as /etc/yum.repos.d/qubes-dom0.repo.rpmnew (you'll see a message about it during package installation). In such a case, you need to manually apply the changes to /etc/yum.repos.d/qubes-dom0.repo or simply replace it with .rpmnew file.

    If you are using Debian-based VM as UpdateVM (sys-firewall by default), you need to download few more packages manually, but do not install them yet:

    sudo qubes-dom0-update systemd-compat-libs perl-libwww-perl perl-Term-ANSIColor perl-Term-Cap gdk-pixbuf2-xlib speexdsp qubes-mgmt-salt-admin-tools lvm2
    (...)
    Transaction Summary
    ===============================================================
    Install     16 Packages (+ 31 Dependent packages)
    Upgrade      4 Packages (+200 Dependent packages)
    
    Total download size: 173 M
    Is this ok [y/d/N]: n
    Exiting on user command
    Your transaction was saved, rerun it with:
      yum load-transaction /tmp/yum_save_tx.....
    
  4. Upgrade dom0 to R3.2:

    sudo qubes-dom0-update
    

    You may wish to disable the screensaver "Lock screen" feature for this step, as during the update XScreensaver may encounter an "Authentication failed" issue, requiring a hard reboot. Alternatively, you may simply move the mouse regularly.

  5. If the previous step completed successfully, your qubes-core-dom0 version should be 3.2.3 or higher. This can be verified with the command yum info qubes-core-dom0. If it's not, repeat the previous step with the --clean option.

  6. Update configuration files.

    Some of configuration files were saved with .rpmnew extension as the actual files were modified. During upgrade, you'll see information about such cases, like:

    warning: /etc/salt/minion.d/f_defaults.conf created as /etc/salt/minion.d/f_defaults.conf.rpmnew
    

    This will happen for every configuration you have modified manually and for a few that has been modified by Qubes scripts. If you are not sure what to do about them, below is a list of commands to deal with few common cases (either keep the old one, or replace with the new one):

    rm -f /etc/group.rpmnew
    rm -f /etc/shadow.rpmnew
    rm -f /etc/qubes/guid.conf.rpmnew
    mv -f /etc/nsswitch.conf{.rpmnew,}
    mv -f /etc/pam.d/postlogin{.rpmnew,}
    mv -f /etc/salt/minion.d/f_defaults.conf{.rpmnew,}
    mv -f /etc/dracut.conf{.rpmnew,}
    
  7. Reboot dom0.

Please note that if you use Anti Evil Maid, it won't be able to unseal the passphrase the first time the system boots after performing this in-place upgrade procedure since the Xen, kernel, and initramfs binaries will have changed. Once the system boots up again, you can reseal your Anti Evil Maid passphrase to the new configuration. Please consult the Anti Evil Maid documentation for instructions on how to do that.

At first login after upgrade you may got a message like this:

Your saved session type 'kde-plasma' is not valid any more. Please select a new one, otherwise 'default' will be used.

This is result of upgrade KDE4 (kde-plasma) to KDE5 (plasma). Simply choose your favorite desktop environment and continue.

Upgrade all Template and Standalone VM(s)

By default, in Qubes R3.1, there are few templates and no standalones. However, users are free to create standalones More information on using multiple templates, as well as standalones, can be found here. The steps described in this section should be repeated in all the user's Template and Standalone VMs.

Upgrade Fedora templates:

Note: This will only upgrade your Fedora template from Qubes 3.1 to Qubes 3.2. This will not upgrade your Fedora template from Fedora 23 to Fedora 24. In order to do that, please see the Fedora 23 template upgrade instructions.

  1. Open a terminal in the template (or standalone). (E.g., use Qubes VM Manager's right-click menu, choose "Run Command in VM," and type gnome-terminal there.)

  2. Install the qubes-upgrade-vm package:

    sudo dnf install --refresh qubes-upgrade-vm
    
  3. Proceed with a normal upgrade in the template:

    sudo dnf upgrade --refresh
    
  4. Add new packages (only needed in default template):

    sudo dnf install qubes-mgmt-salt-vm-connector
    
  5. Shut down the template.

Upgrade Debian (and Whonix) templates:

  1. Open a terminal in the template (or standalone). (E.g., use Qubes VM Manager's right-click menu, choose "Run Command in VM," and type gnome-terminal there.)

  2. Update repository definition:

    sudo cp /etc/apt/sources.list.d/qubes-r3.list /etc/apt/sources.list.d/qubes-r3-upgrade.list
    sudo sed -i 's/r3.1/r3.2/' /etc/apt/sources.list.d/qubes-r3-upgrade.list
    
  3. Proceed with a normal update in the template:

    sudo apt-get update
    sudo apt-get dist-upgrade
    
  4. Add new packages (only needed in default template):

    sudo apt-get install qubes-mgmt-salt-vm-connector
    
  5. Remove unnecessary now file:

    sudo rm -f /etc/apt/sources.list.d/qubes-r3-upgrade.list
    
  6. Shut down the template.