mirror of
https://github.com/QubesOS/qubes-doc.git
synced 2024-12-29 01:06:24 -05:00
3806ecf338
Those are redundant, and yaml parser strips them in fact. By removing them, loading and saving yaml file without any change indeed produce the same output. This is useful for prepare_for_translation.py script (which adds lang and ref tags) - to produce only change that indeed was made.
186 lines
6.0 KiB
Markdown
186 lines
6.0 KiB
Markdown
---
|
|
lang: en
|
|
layout: doc
|
|
permalink: /doc/upgrade-to-r3.2/
|
|
redirect_from:
|
|
- /en/doc/upgrade-to-r3.2/
|
|
- /doc/UpgradeToR3.2/
|
|
- /doc/UpgradeToR3.2rc1/
|
|
ref: 161
|
|
title: Upgrading to R3.2
|
|
---
|
|
|
|
**Before attempting either an in-place upgrade or a clean installation, we
|
|
strongly recommend that users [back up their systems](/doc/backup-restore/).**
|
|
|
|
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](/doc/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](/doc/anti-evil-maid) 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](/doc/software-update-vm/). 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](/doc/templates/fedora/#upgrading).
|
|
|
|
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.
|