mirror of
https://github.com/QubesOS/qubes-doc.git
synced 2024-12-25 15:29:29 -05:00
Remove deprecated content and redundancy in headings
This commit is contained in:
parent
9e084d0b89
commit
b37e821906
@ -13,8 +13,9 @@ If you suspect your [TemplateVM] is broken, misconfigured, or compromised, you c
|
||||
|
||||
The procedure varies by Qubes version; see the appropriate section below.
|
||||
|
||||
Automated Reinstallation Method (R3.1+)
|
||||
----------------------------
|
||||
|
||||
Automatic Method
|
||||
----------------
|
||||
|
||||
First, copy any files that you wish to keep from the TemplateVM's `/home` and `/rw` folders to a safe storage location.
|
||||
Then, in a dom0 terminal, run:
|
||||
@ -39,8 +40,8 @@ For example:
|
||||
**Note:** VMs that are using the reinstalled template will not be affected until they are restarted.
|
||||
|
||||
|
||||
Manual Reinstallation Method (R3.1+)
|
||||
----------------------------
|
||||
Manual Method
|
||||
-------------
|
||||
|
||||
In what follows, the term "target TemplateVM" refers to whichever TemplateVM you want to reinstall.
|
||||
If you want to reinstall more than one TemplateVM, repeat these instructions for each one.
|
||||
@ -82,55 +83,5 @@ If you want to reinstall more than one TemplateVM, repeat these instructions for
|
||||
command `qvm-remove <vm-name>` in dom0.
|
||||
|
||||
|
||||
Manual Reinstallation Method (R3.0 or earlier)
|
||||
----------------------------
|
||||
|
||||
If you're using Qubes 3.0 or older, you should use the manual reinstallation method.
|
||||
You can also use this method on later Qubes versions if, for any reason, you want to reinstall a template manually.
|
||||
|
||||
In what follows, the term "target TemplateVM" refers to whichever TemplateVM you want to reinstall.
|
||||
If you want to reinstall more than one TemplateVM, repeat these instructions for each one.
|
||||
|
||||
1. (Optional) Clone the existing target TemplateVM.
|
||||
|
||||
This can be a good idea if you've customized the existing template and want to keep your customizations.
|
||||
On the other hand, if you suspect that this template is broken, misconfigured, or compromised, you may want to remove it without cloning it.
|
||||
|
||||
2. Create a temporary dummy template:
|
||||
|
||||
mkdir /var/lib/qubes/vm-templates/dummy
|
||||
touch /var/lib/qubes/vm-templates/dummy/{root.img,private.img}
|
||||
qvm-add-template dummy
|
||||
|
||||
3. Temporarily change all VMs based on the target TemplateVM to the new dummy template, or remove them.
|
||||
|
||||
This can be a good idea if you have user data in these VMs that you want to keep.
|
||||
On the other hand, if you suspect that these VMs (or the templates on which they are based) are broken, misconfigured, or compromised, you may want to remove them instead.
|
||||
You can do this in Qubes Manager by right-clicking on the VM and clicking **Remove VM**, or you can use the command `qvm-remove <vm-name>` in dom0.
|
||||
|
||||
Using a dummy template as a temporary template is preferable to using another real TemplateVM because you can't accidentally boot any VMs from the dummy template.
|
||||
(There is no OS in the dummy template, so the boot will fail.)
|
||||
|
||||
4. Uninstall the target TemplateVM from dom0:
|
||||
|
||||
$ sudo yum remove <template-package-name>
|
||||
|
||||
For example, to uninstall the `whonix-gw` template:
|
||||
|
||||
$ sudo yum remove qubes-template-whonix-gw
|
||||
|
||||
5. Reinstall the target TemplateVM in dom0:
|
||||
|
||||
$ sudo qubes-dom0-update --enablerepo=<optional-additional-repo> \
|
||||
<template-package-name>
|
||||
|
||||
For example, to install the `whonix-gw` template:
|
||||
|
||||
$ sudo qubes-dom0-update --enablerepo=qubes-templates-community \
|
||||
qubes-template-whonix-gw
|
||||
|
||||
6. If you temporarily changed all VMs based on the target TemplateVM to the dummy template in step 3, change them back to the new target TemplateVM now.
|
||||
If you instead removed all VMs based on the old target TemplateVM, you can recreate your desired VMs from the newly reinstalled target TemplateVM now.
|
||||
|
||||
[TemplateVM]: /doc/templates/
|
||||
|
||||
|
Loading…
Reference in New Issue
Block a user