Git-Mirrors/qubes-doc
1
0
Fork 0
mirror of https://github.com/QubesOS/qubes-doc.git synced 2025-02-02 09:34:58 -05:00
Code Issues Packages Projects Releases Wiki Activity

Update template switching instructions

Browse Source 
https://forum.qubes-os.org/t/17031
This commit is contained in:
Andrew David Wong 2023-02-26 12:10:27 -08:00
parent f38ae00800
commit c055f21f68
No known key found for this signature in database
GPG Key ID: 8CE137352A019A17
1 changed files with 43 additions and 25 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

68
user/templates/templates.md
View File

@ -218,40 +218,58 @@ Please see [How to Reinstall a Template](/doc/reinstall-template/).
## Switching ## Switching
When you install a new template or upgrade a clone of a template, it is When you install a new template or
recommended that you switch everything that was set to the old template to the [upgrade](/doc/how-to-update/#upgrading-to-avoid-eol) a template, it is
recommended that you switch everything that was using the old template to the
new template: new template:
1. Make the new template the default template. 1. Make the new or upgraded template the default template. In the App Menu, go
to Qubes Tools, then click on Qubes Global Settings. In the Qube Defaults
section, next to Template, select the new or upgraded template from the
drop-down list. Press OK.
``` 2. Base your [disposable templates](/doc/glossary/#disposable-template) on the
Applications Menu -> System Tools -> Qubes Global Settings -> Default template new template. In the App Menu, go to Qubes Tools, then click on Qube
``` Manager. In the Qube Manager, find your disposable templates. (By default,
they end in `-dvm`.) Right click, then click on Settings. Next to Template,
select your new or upgraded template from the drop-down list. Press OK.
2. If your keyboard or mouse is connected through `sys-usb`, switch `sys-usb` - If you receive an error message because there are running
to the new template. (Note that this is a single command to ensure that [disposables](/doc/glossary/#disposable) based on this disposable
`sys-usb` restarts. If it does not, you will not be able to use your USB template, and your only keyboard and mouse are *not* connected through a
keyboard or mouse.) [USB qube](/doc/usb-qubes/), or that USB qube is *not* a disposable, then
shut down all disposables based on the disposable template and try again.
``` - If your only keyboard or mouse *are* connected through a USB qube, and
[user@dom0 ~]$ qvm-shutdown --wait sys-usb; qvm-prefs sys-usb template <NEW_TEMPLATE>; qvm-start sys-usb that USB qube *is* a disposable, then you will have to enter a special
``` command that shuts down all of your qubes, switches the USB qube's
disposable template to the new template, then starts the USB qube again.
In order to avoid being locked out of your system, you must be very
careful to enter this command without typos and with the correct
substitutions.
3. Base app qubes on the new template. In the App Menu, click on Terminal Emulator. Type the command below,
substituting `<SYS_USB_DISPOSABLE_TEMPLATE>` with the name of the
disposable template on which `sys-usb` is based, `<NEW_TEMPLATE>` with the
name of the new or upgraded template, and `<USB_QUBE>` with the name of
your USB qube. Other than these substitutions, make sure to enter the
command exactly as written.
``` ```
Applications Menu -> System Tools -> Qubes Template Manager qvm-shutdown --wait --all; qvm-prefs <SYS_USB_DISPOSABLE_TEMPLATE> template <NEW_TEMPLATE>; qvm-start <USB_QUBE>
``` ```
4. Base the [disposable template](/doc/glossary/#disposable-template) on the new With substitutions, your command should look similar to this example.
template. (Warning: This is just an example. Do not attempt to use it.)
``` ```
[user@dom0 ~]$ qvm-create -l red -t <NEW_TEMPLATE> <NEW_DISPOSABLE_TEMPLATE> qvm-shutdown --wait --all; qvm-prefs fedora-01-dvm template fedora-02; qvm-start sys-usb
[user@dom0 ~]$ qvm-prefs <NEW_DISPOSABLE_TEMPLATE> template_for_dispvms True ```
[user@dom0 ~]$ qvm-features <NEW_DISPOSABLE_TEMPLATE> appmenus-dispvm 1
[user@dom0 ~]$ qubes-prefs default-dispvm <NEW_DISPOSABLE_TEMPLATE> 3. Base your app qubes on the new template. In the App Menu, go to Qubes Tools,
``` then click on Qubes Template Manager. Select all the templates based on the
old template (shown in the Current column). Next to "Change all selected
to," select the new or upgraded template from the drop-down list. Press OK.
## Advanced ## Advanced