mirror of
https://github.com/QubesOS/qubes-doc.git
synced 2024-12-23 22:39:27 -05:00
Merge branch 'template-switch'
This commit is contained in:
commit
b02cf80683
@ -218,40 +218,57 @@ Please see [How to Reinstall a Template](/doc/reinstall-template/).
|
||||
|
||||
## Switching
|
||||
|
||||
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
|
||||
When you install a new template or
|
||||
[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:
|
||||
|
||||
1. Make the new template the default template.
|
||||
1. **Make the new 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 template from the
|
||||
drop-down list. Press OK.
|
||||
|
||||
```
|
||||
Applications Menu -> System Tools -> Qubes Global Settings -> Default template
|
||||
```
|
||||
2. **Base your [disposable templates](/doc/glossary/#disposable-template) on
|
||||
the new template.**
|
||||
|
||||
2. If your keyboard or mouse is connected through `sys-usb`, switch `sys-usb`
|
||||
to the new template. (Note that this is a single command to ensure that
|
||||
`sys-usb` restarts. If it does not, you will not be able to use your USB
|
||||
keyboard or mouse.)
|
||||
- If your only keyboard and mouse are *not* connected through a [USB
|
||||
qube](/doc/usb-qubes/), or that USB qube is *not* a disposable, then shut
|
||||
down all disposables. In the App Menu, go to Qubes Tools, then click on
|
||||
Qube Manager. In the Qube Manager, find your disposable template(s). (By
|
||||
default, they end in `-dvm`.) Right click, hover over Template, then click
|
||||
on the new template. Repeat for each disposable template.
|
||||
|
||||
```
|
||||
[user@dom0 ~]$ qvm-shutdown --wait sys-usb; qvm-prefs sys-usb template <NEW_TEMPLATE>; qvm-start sys-usb
|
||||
```
|
||||
- If your only keyboard or mouse *are* connected through a USB qube, and
|
||||
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 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
|
||||
template.
|
||||
With substitutions, your command should look similar to this example.
|
||||
(Warning: This is just an example. Do not attempt to use it.)
|
||||
|
||||
```
|
||||
[user@dom0 ~]$ qvm-create -l red -t <NEW_TEMPLATE> <NEW_DISPOSABLE_TEMPLATE>
|
||||
[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>
|
||||
```
|
||||
```
|
||||
qvm-shutdown --wait --all; qvm-prefs fedora-01-dvm template fedora-02; qvm-start sys-usb
|
||||
```
|
||||
|
||||
3. **Base your app qubes on the new template.** In the Qube Manager, click on
|
||||
the Template heading to sort by template. Select all the qubes based on the
|
||||
old template by clicking on the first one, holding shift, then clicking on
|
||||
the last one. With multiple qubes selected, right-click on any of them,
|
||||
hover your cursor over Template, then click on the new template.
|
||||
|
||||
## Advanced
|
||||
|
||||
|
Loading…
Reference in New Issue
Block a user