mirror of
https://github.com/QubesOS/qubes-doc.git
synced 2024-10-01 01:25:40 -04:00
R3.1 release notes and upgrade instruction
This commit is contained in:
Marek Marczykowski-Górecki
parent
ed0942c7a5
commit
79fb0fe2ea
96
installing/upgrade-to-r3.1.md
Normal file
96
installing/upgrade-to-r3.1.md
Normal file
@ -0,0 +1,96 @@
|
|||||||
|
---
|
||||||
|
layout: doc
|
||||||
|
title: Upgrading to R3.1
|
||||||
|
permalink: /doc/upgrade-to-r3.1/
|
||||||
|
redirect_from:
|
||||||
|
- /en/doc/upgrade-to-r3.1/
|
||||||
|
- /doc/UpgradeToR3.1/
|
||||||
|
- /doc/UpgradeToR3.1rc1/
|
||||||
|
---
|
||||||
|
|
||||||
|
Upgrading Qubes R3.0 to R3.1
|
||||||
|
======================================
|
||||||
|
|
||||||
|
Current Qubes R3.1 (R3.1) systems can be upgraded in-place to the latest R3.1
|
||||||
|
by following the procedure below.
|
||||||
|
|
||||||
|
**Before attempting either an in-place upgrade or a clean installation, we
|
||||||
|
strongly recommend that users back up the system by using the built-in [backup
|
||||||
|
tool](/doc/backup-restore/).**
|
||||||
|
|
||||||
|
Upgrade all Template and Standalone VM(s)
|
||||||
|
-----------------------------------------
|
||||||
|
|
||||||
|
By default, in Qubes R3.0, there is only one Template VM, however users are
|
||||||
|
free to create more Template VMs for special purposes, as well as Standalone
|
||||||
|
VMs. More information on using multiple Template VMs, as well as Standalone
|
||||||
|
VMs, can be found [here](/doc/software-update-vm/). The steps described in this
|
||||||
|
section should be repeated in **all** user's Template and Standalone VMs.
|
||||||
|
|
||||||
|
### Upgrade Fedora template:
|
||||||
|
|
||||||
|
1. Open terminal in the template VM (or standalone VM). E.g. use the Qubes
|
||||||
|
Manager's right-click menu and choose Run Command in VM and type
|
||||||
|
`gnome-terminal` there.
|
||||||
|
2. Install `qubes-upgrade-vm` package:
|
||||||
|
|
||||||
|
sudo yum install qubes-upgrade-vm
|
||||||
|
|
||||||
|
3. Proceed with normal update in the template:
|
||||||
|
|
||||||
|
sudo yum update
|
||||||
|
|
||||||
|
4. Shutdown the template VM.
|
||||||
|
|
||||||
|
### Upgrade Debian template:
|
||||||
|
|
||||||
|
1. Open terminal in the template VM (or standalone VM). E.g. use the Qubes
|
||||||
|
Manager's right-click menu and 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.0/r3.1/' /etc/apt/sources.list.d/qubes-r3-upgrade.list
|
||||||
|
|
||||||
|
3. Proceed with normal update in the template:
|
||||||
|
|
||||||
|
sudo apt-get update
|
||||||
|
sudo apt-get dist-upgrade
|
||||||
|
|
||||||
|
There will be some error messages during the process, but our tests does
|
||||||
|
not revealed any negative consequences.
|
||||||
|
|
||||||
|
4. Shutdown the template VM.
|
||||||
|
|
||||||
|
Upgrading dom0
|
||||||
|
--------------
|
||||||
|
|
||||||
|
Be sure to do steps described in this section after *all* your template and
|
||||||
|
standalone VMs got updated as described in the section above. Also make sure
|
||||||
|
you haven't shutdown any of: netvm, firewallvm - you will not be able to start
|
||||||
|
them again.
|
||||||
|
|
||||||
|
1. Open terminal in Dom0. E.g. Start-\>System Settings-\>Konsole.
|
||||||
|
2. Upgrade dom0 to R3.1:
|
||||||
|
|
||||||
|
sudo qubes-dom0-update --releasever=3.1
|
||||||
|
|
||||||
|
3. If above step completed successfully you should have `qubes-core-dom0` at
|
||||||
|
least 3.1.4. If not, repeat above step with additional `--clean` option.
|
||||||
|
|
||||||
|
4. Reboot the system.
|
||||||
|
|
||||||
|
It may happen that the system hang during the reboot. Hard reset the system
|
||||||
|
in such case, all the filesystems are unmounted at this stage.
|
||||||
|
|
||||||
|
Please note that if you use Anti Evil Maid, then it won't be able to unseal the
|
||||||
|
passphrase this time, because the Xen, kernel, and initramfs binaries have
|
||||||
|
changed. Once the system boots up again, you could reseal your Anti Evil Maid's
|
||||||
|
passphrase to the new configuration. Please consult Anti Evil Maid
|
||||||
|
documentation for explanation on how to do that.
|
||||||
|
|
||||||
|
Now, when you have dom0 upgraded, you can install new templates from Qubes R3.1
|
||||||
|
repositories. Especially Fedora 23 - default Qubes R3.1 template:
|
||||||
|
|
||||||
|
sudo qubes-dom0-update qubes-template-fedora-23
|
||||||
|
|
||||||
74
releases/3.1/release-notes.md
Normal file
74
releases/3.1/release-notes.md
Normal file
@ -0,0 +1,74 @@
|
|||||||
|
---
|
||||||
|
layout: doc
|
||||||
|
title: Qubes R3.1 release notes
|
||||||
|
permalink: /doc/releases/3.1/release-notes/
|
||||||
|
---
|
||||||
|
|
||||||
|
Qubes R3.1 release notes
|
||||||
|
========================
|
||||||
|
|
||||||
|
*this page is a draft for yet unreleased version*
|
||||||
|
|
||||||
|
New features since 3.0
|
||||||
|
----------------------
|
||||||
|
|
||||||
|
* Management Stack based of Salt Stack in dom0 - [documentation][salt-doc]
|
||||||
|
* Out of the box Whonix setup
|
||||||
|
* UEFI support
|
||||||
|
* LIVE edition (still alpha, not part of R3.0-rc1)
|
||||||
|
* Updated GPU drivers in dom0
|
||||||
|
* Colorful window application icons (instead of just colorful lock icon)
|
||||||
|
* PV Grub support ([documentation][pvgrub-doc])
|
||||||
|
* Out of the box USB VM setup, including [handling USB mouse][input-proxy]
|
||||||
|
* Xen upgraded to 4.6, for better hardware support (especially Skylake platform)
|
||||||
|
* Improve updates proxy flexibility - especially repositories served over HTTPS
|
||||||
|
|
||||||
|
You can get detailed description in [completed github issues][github-release-notes]
|
||||||
|
|
||||||
|
Known issues
|
||||||
|
------------
|
||||||
|
|
||||||
|
* Windows Tools: `qvm-block` does not work
|
||||||
|
|
||||||
|
* Some icons in the Qubes Manager application might not be drawn correctly when using the Xfce4 environment in Dom0. If this bothers you, please use the KDE environment instead.
|
||||||
|
|
||||||
|
* For other known issues take a look at [our tickets](https://github.com/QubesOS/qubes-issues/issues?q=is%3Aopen+is%3Aissue+milestone%3A%22Release+3.1%22+label%3Abug)
|
||||||
|
|
||||||
|
It is advised to install updates just after system installation to apply bug fixes for (some of) the above problems.
|
||||||
|
|
||||||
|
Downloads
|
||||||
|
---------
|
||||||
|
|
||||||
|
See [Qubes Downloads](/downloads/).
|
||||||
|
|
||||||
|
Installation instructions
|
||||||
|
-------------------------
|
||||||
|
|
||||||
|
See [Installation Guide](/doc/installation-guide/).
|
||||||
|
|
||||||
|
Upgrading
|
||||||
|
---------
|
||||||
|
|
||||||
|
### From R3.0
|
||||||
|
|
||||||
|
The easiest and safest way to upgrade to Qubes R3.1 is to install it from
|
||||||
|
scratch and use [qubes backup and restore tools](/doc/backup-restore/) for
|
||||||
|
migrating of all of the user VMs.
|
||||||
|
|
||||||
|
Users of Qubes R3.0 can upgrade using [experimental
|
||||||
|
procedure](/doc/upgrade-to-r3.1/).
|
||||||
|
|
||||||
|
### From R2 or earlier
|
||||||
|
|
||||||
|
When upgrading from earlier versions the easiest and safest way is to install
|
||||||
|
it from scratch and use [qubes backup and restore tools](/doc/backup-restore/)
|
||||||
|
for migrating of all of the user VMs.
|
||||||
|
|
||||||
|
Alternatively you can [upgrade to R3.0
|
||||||
|
using](/doc/releases/3.0/release-notes/#upgrading) first, then follow the
|
||||||
|
instructions above. This will be time consuming process.
|
||||||
|
|
||||||
|
[salt-doc]: /doc/salt/
|
||||||
|
[pvgrub-doc]: /doc/managing-vm-kernel/#tocAnchor-1-3
|
||||||
|
[input-proxy]: https://github.com/QubesOS/qubes-app-linux-input-proxy/blob/master/README.md
|
||||||
|
[github-release-notes]: https://github.com/QubesOS/qubes-issues/issues?q=is%3Aissue+sort%3Aupdated-desc+milestone%3A%22Release+3.1%22+label%3Arelease-notes+is%3Aclosed
|
||||||
Loading…
Reference in New Issue
Block a user