mirror of
https://github.com/QubesOS/qubes-doc.git
synced 2024-12-23 22:39:27 -05:00
187 lines
6.1 KiB
Markdown
187 lines
6.1 KiB
Markdown
---
|
|
lang: en
|
|
layout: doc
|
|
permalink: /doc/upgrade/3.2/
|
|
redirect_from:
|
|
- /doc/upgrade-to-r3.2/
|
|
- /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.
|