diff --git a/managing-os/templates.md b/managing-os/templates.md index 6d19ace7..9a678fd6 100644 --- a/managing-os/templates.md +++ b/managing-os/templates.md @@ -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. -How to install, uninstall, and reinstall ----------------------------------------- +How to install, uninstall, reinstall, and switch +------------------------------------------------ ### 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/). +### 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 ----------------------- diff --git a/managing-os/templates/debian/upgrade-8-to-9.md b/managing-os/templates/debian/upgrade-8-to-9.md index 7f81df0b..aa12b564 100644 --- a/managing-os/templates/debian/upgrade-8-to-9.md +++ b/managing-os/templates/debian/upgrade-8-to-9.md @@ -74,7 +74,10 @@ any template based on the standard Debian 8 template. [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 diff --git a/managing-os/templates/fedora/upgrade-26-to-27.md b/managing-os/templates/fedora/upgrade-26-to-27.md index f03c75a3..e75a1eb3 100644 --- a/managing-os/templates/fedora/upgrade-26-to-27.md +++ b/managing-os/templates/fedora/upgrade-26-to-27.md @@ -135,28 +135,8 @@ should be entered (`@dom0` or `@fedora-27`). [user@dom0 ~]$ qvm-trim-template fedora-27 - 7. (Recommended) Switch everything that was set to the old template to the new - template, e.g.: - - 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 + 7. (Recommended) [Switch everything that was set to the old template to the new + template.][switching-3.2] 8. (Optional) Remove the old template. (Make sure to type `fedora-26`, not `fedora-27`.) @@ -311,25 +291,8 @@ should be entered (`@dom0` or `@fedora-27`). [user@dom0 ~]$ sudo losetup -d $dev [user@dom0 ~]$ rm /var/tmp/template-upgrade-cache.img - 7. (Recommended) Switch everything that was set to the old template to the new - template, e.g.: - - 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 + 7. (Recommended) [Switch everything that was set to the old template to the new + template.][switching-4.0] 8. (Optional) Remove the old template. (Make sure to type `fedora-26`, not `fedora-27`.) @@ -393,5 +356,7 @@ In this case, you have several options: [resize-disk-image]: /doc/resize-disk-image/ [Additional Information]: #additional-information [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/ diff --git a/managing-os/templates/fedora/upgrade-27-to-28.md b/managing-os/templates/fedora/upgrade-27-to-28.md index 1ae8b103..b1ad0c78 100644 --- a/managing-os/templates/fedora/upgrade-27-to-28.md +++ b/managing-os/templates/fedora/upgrade-27-to-28.md @@ -154,28 +154,8 @@ should be entered (`@dom0` or `@fedora-28`). [user@dom0 ~]$ qvm-trim-template fedora-28 - 7. (Recommended) Switch everything that was set to the old template to the new - template, e.g.: - - 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 + 7. (Recommended) [Switch everything that was set to the old template to the new + template.][switching-3.2] 8. (Optional) Remove the old template. (Make sure to type `fedora-27`, not `fedora-28`.) @@ -330,25 +310,8 @@ should be entered (`@dom0` or `@fedora-28`). [user@dom0 ~]$ sudo losetup -d $dev [user@dom0 ~]$ rm /var/tmp/template-upgrade-cache.img - 7. (Recommended) Switch everything that was set to the old template to the new - template, e.g.: - - 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 + 7. (Recommended) [Switch everything that was set to the old template to the new + template.][switching-4.0] 8. (Optional) Remove the old template. (Make sure to type `fedora-27`, not `fedora-28`.) @@ -412,5 +375,7 @@ In this case, you have several options: [resize-disk-image]: /doc/resize-disk-image/ [Additional Information]: #additional-information [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/