suzanne.soy/qubes-doc
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Factor out template switching instructions

Browse Source
This commit is contained in:
Andrew David Wong 2018-08-24 23:59:25 -05:00
parent c3f74c9508
commit c2051b8daf
No known key found for this signature in database
GPG Key ID: 8CE137352A019A17
4 changed files with 60 additions and 85 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

46
managing-os/templates.md
View File

@ -24,8 +24,8 @@ In particular, some template "flavors" are available in source code form only.
Take a look at the [Qubes Builder documentation](/doc/qubes-builder/) for instructions on how to compile them. Take a look at the [Qubes Builder documentation](/doc/qubes-builder/) for instructions on how to compile them.
How to install, uninstall, and reinstall How to install, uninstall, reinstall, and switch
---------------------------------------- ------------------------------------------------
### How to install ### How to install
@ -50,6 +50,48 @@ If this doesn't work, you can [remove it manually](/doc/remove-vm-manually/).
To reinstall a currently installed TemplateVM, see [here](/doc/reinstall-template/). To reinstall a currently installed TemplateVM, see [here](/doc/reinstall-template/).
### How to switch templates (3.2)
When you install a new template or upgrade a clone of a template, it is recommended that you switch everything that was set to the old template to the new template:
1. Make the new template the default template:
Qubes Manager --> Global settings --> Default template
2. Base AppVMs on the new template.
In Qubes Manager, for each VM that is currently based on `old-template` that you would like to base on `new-template`, enter its VM settings and change the Template selection:
Qubes Manager --> (Select a VM) --> VM settings --> Template
3. Base the [DispVM](/doc/dispvm/) template on the new template.
If you have set the new template as your default template:
[user@dom0 ~]$ qvm-create-default-dvm --default-template
Otherwise:
[user@dom0 ~]$ qvm-create-default-dvm new-template
### How to switch templates (4.0)
When you install a new template or upgrade a clone of a template, it is recommended that you switch everything that was set to the old template to the new template:
1. Make the new template the default template:
Applications Menu --> System Tools --> Qubes Global Settings --> Default template
2. Base AppVMs on the new template.
In Qubes Manager, for each VM that is currently based on `old-template` that you would like to base on `new-template`, enter its VM settings and change the Template selection:
Applications Menu --> (select a VM) --> VM settings --> Template
3. Base the [DispVM](/doc/dispvm/) template on the new template.
[user@dom0 ~]$ qvm-create -l red -t new-template new-template-dvm
[user@dom0 ~]$ qvm-prefs new-template-dvm template_for_dispvms True
[user@dom0 ~]$ qvm-features new-template-dvm appmenus-dispvm 1
[user@dom0 ~]$ qubes-prefs default-dispvm new-template-dvm
Invisible Things Lab (ITL) Supported templates Invisible Things Lab (ITL) Supported templates
----------------------- -----------------------

5
managing-os/templates/debian/upgrade-8-to-9.md
View File

@ -74,7 +74,10 @@ any template based on the standard Debian 8 template.
[user@dom0 ~]$ qvm-trim-template debian-9 [user@dom0 ~]$ qvm-trim-template debian-9
8. (Optional) Remove the old default template. 8. (Recommended) [Switch everything that was set to the old template to the new
template.](/doc/templates/#how-to-switch-templates-32)
9. (Optional) Remove the old default template.
[user@dom0 ~]$ sudo yum remove qubes-template-debian-8 [user@dom0 ~]$ sudo yum remove qubes-template-debian-8

47
managing-os/templates/fedora/upgrade-26-to-27.md
View File

@ -135,28 +135,8 @@ should be entered (`@dom0` or `@fedora-27`).
[user@dom0 ~]$ qvm-trim-template fedora-27 [user@dom0 ~]$ qvm-trim-template fedora-27
7. (Recommended) Switch everything that was set to the old template to the new 7. (Recommended) [Switch everything that was set to the old template to the new
template, e.g.: template.][switching-3.2]
1. Make the new template the default template:
Qubes Manager --> Global settings --> Default template
2. Base AppVMs on the new template. In Qubes Manager, for each VM that is
currently based on `fedora-26` that you would like to base on
`fedora-27`, enter its VM settings and change the Template selection:
Qubes Manager --> (Select a VM) --> VM settings --> Template
3. Base the [DispVM] template on the new template.
If you have set the new template as your default template:
[user@dom0 ~]$ qvm-create-default-dvm --default-template
Otherwise:
[user@dom0 ~]$ qvm-create-default-dvm fedora-27
8. (Optional) Remove the old template. (Make sure to type `fedora-26`, not 8. (Optional) Remove the old template. (Make sure to type `fedora-26`, not
`fedora-27`.) `fedora-27`.)
@ -311,25 +291,8 @@ should be entered (`@dom0` or `@fedora-27`).
[user@dom0 ~]$ sudo losetup -d $dev [user@dom0 ~]$ sudo losetup -d $dev
[user@dom0 ~]$ rm /var/tmp/template-upgrade-cache.img [user@dom0 ~]$ rm /var/tmp/template-upgrade-cache.img
7. (Recommended) Switch everything that was set to the old template to the new 7. (Recommended) [Switch everything that was set to the old template to the new
template, e.g.: template.][switching-4.0]
1. Make the new template the default template:
Applications Menu --> System Tools --> Qubes Global Settings --> Default template
2. Base AppVMs on the new template. In Qubes Manager, for each VM that is
currently based on `fedora-26` that you would like to base on
`fedora-27`, enter its VM settings and change the Template selection:
Applications Menu --> (select a VM) --> VM settings --> Template
3. Base the [DispVM] template on the new template.
[user@dom0 ~]$ qvm-create -l red -t fedora-27 fedora-27-dvm
[user@dom0 ~]$ qvm-prefs fedora-27-dvm template_for_dispvms True
[user@dom0 ~]$ qvm-features fedora-27-dvm appmenus-dispvm 1
[user@dom0 ~]$ qubes-prefs default-dispvm fedora-27-dvm
8. (Optional) Remove the old template. (Make sure to type `fedora-26`, not 8. (Optional) Remove the old template. (Make sure to type `fedora-26`, not
`fedora-27`.) `fedora-27`.)
@ -393,5 +356,7 @@ In this case, you have several options:
[resize-disk-image]: /doc/resize-disk-image/ [resize-disk-image]: /doc/resize-disk-image/
[Additional Information]: #additional-information [Additional Information]: #additional-information
[Compacting the Upgraded Template]: #compacting-the-upgraded-template [Compacting the Upgraded Template]: #compacting-the-upgraded-template
[switching-3.2]: /doc/templates/#how-to-switch-templates-32
[switching-4.0]: /doc/templates/#how-to-switch-templates-40
[DispVM]: /doc/dispvm/ [DispVM]: /doc/dispvm/

47
managing-os/templates/fedora/upgrade-27-to-28.md
View File

@ -154,28 +154,8 @@ should be entered (`@dom0` or `@fedora-28`).
[user@dom0 ~]$ qvm-trim-template fedora-28 [user@dom0 ~]$ qvm-trim-template fedora-28
7. (Recommended) Switch everything that was set to the old template to the new 7. (Recommended) [Switch everything that was set to the old template to the new
template, e.g.: template.][switching-3.2]
1. Make the new template the default template:
Qubes Manager --> Global settings --> Default template
2. Base AppVMs on the new template. In Qubes Manager, for each VM that is
currently based on `fedora-27` that you would like to base on
`fedora-28`, enter its VM settings and change the Template selection:
Qubes Manager --> (Select a VM) --> VM settings --> Template
3. Base the [DispVM] template on the new template.
If you have set the new template as your default template:
[user@dom0 ~]$ qvm-create-default-dvm --default-template
Otherwise:
[user@dom0 ~]$ qvm-create-default-dvm fedora-28
8. (Optional) Remove the old template. (Make sure to type `fedora-27`, not 8. (Optional) Remove the old template. (Make sure to type `fedora-27`, not
`fedora-28`.) `fedora-28`.)
@ -330,25 +310,8 @@ should be entered (`@dom0` or `@fedora-28`).
[user@dom0 ~]$ sudo losetup -d $dev [user@dom0 ~]$ sudo losetup -d $dev
[user@dom0 ~]$ rm /var/tmp/template-upgrade-cache.img [user@dom0 ~]$ rm /var/tmp/template-upgrade-cache.img
7. (Recommended) Switch everything that was set to the old template to the new 7. (Recommended) [Switch everything that was set to the old template to the new
template, e.g.: template.][switching-4.0]
1. Make the new template the default template:
Applications Menu --> System Tools --> Qubes Global Settings --> Default template
2. Base AppVMs on the new template. In Qubes Manager, for each VM that is
currently based on `fedora-27` that you would like to base on
`fedora-28`, enter its VM settings and change the Template selection:
Applications Menu --> (select a VM) --> VM settings --> Template
3. Base the [DispVM] template on the new template.
[user@dom0 ~]$ qvm-create -l red -t fedora-28 fedora-28-dvm
[user@dom0 ~]$ qvm-prefs fedora-28-dvm template_for_dispvms True
[user@dom0 ~]$ qvm-features fedora-28-dvm appmenus-dispvm 1
[user@dom0 ~]$ qubes-prefs default-dispvm fedora-28-dvm
8. (Optional) Remove the old template. (Make sure to type `fedora-27`, not 8. (Optional) Remove the old template. (Make sure to type `fedora-27`, not
`fedora-28`.) `fedora-28`.)
@ -412,5 +375,7 @@ In this case, you have several options:
[resize-disk-image]: /doc/resize-disk-image/ [resize-disk-image]: /doc/resize-disk-image/
[Additional Information]: #additional-information [Additional Information]: #additional-information
[Compacting the Upgraded Template]: #compacting-the-upgraded-template [Compacting the Upgraded Template]: #compacting-the-upgraded-template
[switching-3.2]: /doc/templates/#how-to-switch-templates-32
[switching-4.0]: /doc/templates/#how-to-switch-templates-40
[DispVM]: /doc/dispvm/ [DispVM]: /doc/dispvm/