Actually use the new Debian upgrade page

This commit is contained in:
unman 2019-08-22 16:30:06 +00:00
parent f1b593aeee
commit ba0ba6a86b
No known key found for this signature in database
GPG Key ID: BB52274595B71262
2 changed files with 32 additions and 21 deletions

View File

@ -70,15 +70,20 @@ You should overwrite this file.
`sudo apt-get autoremove`
6. Compact the template.
6. (optional) Clean cached packages from /var/cache/apt
```
$ sudo apt-get clean
```
7. Shutdown the new TemplateVM via dom0 command line or the Qube Manager.
7. Compact the template.
8. (Recommended) [Switch everything that was set to the old template to the new template.][switch]
8. Shutdown the new TemplateVM via dom0 command line or the Qube Manager.
9. (Optional) Change the default template to use the new template.
9. (Recommended) [Switch everything that was set to the old template to the new template.][switch]
10. (Optional) Remove the old template using dom0 command line or the Qube Manager.
10. (Optional) Change the global default template to use the new template.
11. (Optional) Remove the old template using dom0 command line or the Qube Manager.
Compacting the Upgraded Template
@ -103,6 +108,8 @@ You should disable this by opening a terminal in the template and running:
$ sudo systemctl disable apt-daily.{service,timer}`.
```
Look [here][jessie] for notes specific to updating a jessie template.
Relevant Discussions
--------------------
* [User apt commands blocked on startup][2621]
@ -112,3 +119,4 @@ Relevant Discussions
[switch]: /doc/templates/#how-to-switch-templates)
[release]: https://www.debian.org/releases/buster/amd64/release-notes/ch-upgrading.en.html
[switch]: /doc/templates/#how-to-switch-templates
[jessie]: /doc/template/debian/upgrade-8-to-9/

View File

@ -20,14 +20,9 @@ Updates for these templates are provided by ITL and are signed by this key:
Key fingerprint = 2D43 E932 54EE EA7C B31B 6A77 5E58 18AB 47FD 92FA
uid Qubes OS Debian Packages Signing Key
The key is already installed when you install (signed) template package. You
can also obtain the key from [git
repository](https://github.com/QubesOS/qubes-core-agent-linux/blob/master/misc/qubes-archive-keyring.gpg),
which is also integrity-protected using signed git tags.
The key is already installed when you install (signed) template package.
You can also obtain the key from [git repository][git] which is also integrity-protected using signed git tags.
If you want a debian-minimal template, this can be built using [Qubes-builder](https://www.qubes-os.org/doc/qubes-builder/),by selecting a +minimal flavour in setup, and then
make qubes-vm && make template
Installing
----------
@ -47,7 +42,15 @@ Debian 9 (stretch) - oldstable:
[user@dom0 ~]$ sudo qubes-dom0-update qubes-template-debian-9
A Debian-10 template is currently available from the testing repository.
Debian-10 templates are currently available from the testing repository.
Debian 10 (buster) - minimal:
[user@dom0 ~]$ sudo qubes-dom0-update --enablerepo=qubes-templates-itl-testing qubes-template-debian-10-minimal
Because this template was built *before* buster became stable, it cannot be updated without [manually accepting the change in status][5149].
Also, to install additional Qubes packages you will have to enable the qubes-testing repository.
Debian 10 (buster) - stable:
@ -56,13 +59,10 @@ Debian 10 (buster) - stable:
Because this template was built *before* buster became stable, it cannot be updated without [manually accepting the change in status][5149].
Upgrading
---------
To upgrade your Debian TemplateVM, please consult the guide that corresponds to your situation:
* [Upgrading the Debian 8 Template to Debian 9](/doc/template/debian/upgrade-8-to-9/)
To upgrade an existing Debian TemplateVM, please consult [this guide][Upgrading]
Known issues
@ -106,7 +106,8 @@ The lesson is that you should carefully look at what is being installed to your
By default, templates in 4.0 only have a loopback interface.
Some packages will throw an error on installation in this situation. For example, Samba expects to be configured using a network interface post installation.
Some packages will throw an error on installation in this situation.
For example, Samba expects to be configured using a network interface post installation.
One solution is to add a dummy interface to allow the package to install correctly:
@ -119,7 +120,7 @@ One solution is to add a dummy interface to allow the package to install correct
Contributing
----------------
If you want to help in improving the template, feel free to [contribute](/wiki/ContributingHowto).
If you want to help in improving the template, feel free to [contribute]
More information
@ -127,6 +128,8 @@ More information
* [Debian wiki](https://wiki.debian.org/Qubes)
[stretch]: /doc/template/debian/upgrade-8-to-9/
[Upgrading]: /doc/template/debian/upgrade
[5149]: https://github.com/QubesOS/qubes-issues/issues/5149
[git]: https://github.com/QubesOS/qubes-core-agent-linux/blob/master/misc/qubes-archive-keyring.gpg
[builder]: /doc/qubes-builder/
[contribute]: /doc/contributing/