5
0
mirror of git://git.proxmox.com/git/pve-docs.git synced 2025-01-07 17:17:48 +03:00
Commit Graph

187 Commits

Author SHA1 Message Date
Fabian Grünbichler
2a249c843d fix 'vpus' typo
Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>
2023-12-22 10:35:18 +01:00
Fabian Grünbichler
5afa9371b0 fix #5087: qm: formatting of start/shutdown order list
drop the stray '*' and reflow.

Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>
2023-11-29 14:41:22 +01:00
Thomas Lamprecht
e2b3622a89 consistently use web UI and web interface wording
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2023-11-22 08:49:28 +01:00
Markus Frank
4005a5fafe add VNC clipboard documentation
Signed-off-by: Markus Frank <m.frank@proxmox.com>
Reviewed-by: Dominik Csapak <d.csapak@proxmox.com>
Tested-by: Dominik Csapak <d.csapak@proxmox.com>
2023-11-21 14:28:53 +01:00
Noel Ullreich
42dfa5e964 Consistency: change mainboard to motherboard
To be consistent, replaced all instances of mainboard/main board with
motherboard.

Signed-off-by: Noel Ullreich <n.ullreich@proxmox.com>
2023-11-17 10:54:24 +01:00
Noel Ullreich
9632a85d3a Consistency of passthrough/pass-through
Fix consistency issues as well as grammatical mistakes with the spelling
of passthough/pass-through/pass through in the pve docs

Signed-off-by: Noel Ullreich <n.ullreich@proxmox.com>
2023-11-17 10:54:24 +01:00
Thomas Lamprecht
ff0c3ed1f9 qm: add headings and references for machine-version sections
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2023-11-12 18:59:30 +01:00
Fiona Ebner
cecc8064dc qm: add section about machine types
expanding from the two currently existing sentences. In the first one, a
typo VMs -> VM's is fixed. In the second one, "one wants to" is changed
to "you want to", because the sentence already starts with "You can" and
it's active voice.

Adds information about the machine version, rationale behind the
defaults for it and what to do for deprecated versions.

Signed-off-by: Fiona Ebner <f.ebner@proxmox.com>
2023-11-12 18:59:30 +01:00
Noel Ullreich
9dbab4f895 qemu: update the PCI(e) docs
A little update to the PCI(e) docs. The PCI wiki article has been
reworked as well, in line with changes from this patch.

Along some minor grammar fixes added:
 * how to check if kernel modules are being loaded
 * how to check which drivers to blacklist
 * how to add softdeps for module loading
 * where to find kernel params

Signed-off-by: Noel Ullreich <n.ullreich@proxmox.com>
 [ TL: squash in dropping two trailing whitespace errors ]
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2023-10-18 18:51:14 +02:00
Alexander Zeidler
16b31cc9a6 sysadmin: add section 'Firmware Updates' and references
Firmware updates are important, their existence should not be checked
only when there are already noticeable problems.

Signed-off-by: Alexander Zeidler <a.zeidler@proxmox.com>
Reviewed-by: Dominik Csapak <d.csapak@proxmox.com>
2023-09-21 15:08:40 +02:00
Thomas Lamprecht
4657b9ff3d qm: slightly reposition mapping screenshots
to avoid that they are adjacent providing very little space for the
text flow floating besides it.

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2023-06-21 17:46:19 +02:00
Dominik Csapak
481a0ee4e1 resource mapping: add screenshots
of the panel with some data + the edit windows

Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>
2023-06-21 17:46:19 +02:00
Dominik Csapak
bd0cc33df2 use correct heading level for resource mapping
otherwise it's a subchapter under hibernation

Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>
2023-06-21 17:46:19 +02:00
Thomas Lamprecht
2157032d7c qm: move out known vCPU list to actual appendix
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2023-06-21 17:46:19 +02:00
Fiona Ebner
85e53bbf11 qm: move AMD and Intel CPU types list to the end of the chapter
to avoid cluttering up the CPU type section too much.

Signed-off-by: Fiona Ebner <f.ebner@proxmox.com>
2023-06-20 11:36:32 +02:00
Fiona Ebner
a36da5e70e qm: improve list of Intel/AMD CPU types in QEMU section
Signed-off-by: Fiona Ebner <f.ebner@proxmox.com>
2023-06-20 11:36:32 +02:00
Fiona Ebner
c85a1f5ae4 qm: improve wording/style and fix typos in QEMU CPU Types section
Signed-off-by: Fiona Ebner <f.ebner@proxmox.com>
2023-06-20 11:36:32 +02:00
Fiona Ebner
57bb28ef95 qm: fix typos and improve wording in CPU Types section
Signed-off-by: Fiona Ebner <f.ebner@proxmox.com>
2023-06-20 11:36:32 +02:00
Alexandre Derumier
41379e9a77 qemu: add cpu models documentation
add doc for differents cpu models including
new x86-64-vX models

Signed-off-by: Alexandre Derumier <aderumier@odiso.com>
2023-06-20 11:30:10 +02:00
Thomas Lamprecht
d772991e62 qm mappings: stylistic fixes
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2023-06-19 08:41:02 +02:00
Dominik Csapak
e2a867b28e qemu: add documentation about cluster device mapping
explain why someone would want it, how to configure and which privileges
are necessary

Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>
2023-06-16 16:26:51 +02:00
Christoph Heiss
266dd87d5d Revert "qm: freeze-fs-on-backup: remove reference to GUI"
This reverts commit 0025e84319.
The option is now also exposed in the GUI.

Signed-off-by: Christoph Heiss <c.heiss@proxmox.com>
2023-06-07 18:28:26 +02:00
Fiona Ebner
c35063c208 fix #4641: qm: fix typo
Signed-off-by: Fiona Ebner <f.ebner@proxmox.com>
2023-04-03 09:05:59 +02:00
Friedrich Weber
0025e84319 qm: freeze-fs-on-backup: remove reference to GUI
The config option is currently not exposed in the GUI.

Signed-off-by: Friedrich Weber <f.weber@proxmox.com>
2023-03-22 12:12:24 +01:00
Thomas Lamprecht
80df0d2e37 qm: qga: add references and increase visibility of fsfreeze note
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2023-03-21 12:31:45 +01:00
Christoph Heiss
62bf5d754e qm: Add section explaining fs-freeze/-thaw QGA option
Signed-off-by: Christoph Heiss <c.heiss@proxmox.com>
 [ T: resolve trivial merge conflict due to context additions ]
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2023-03-21 11:51:36 +01:00
Fiona Ebner
95117b6cdf qm: guest trim: add note mentioning issue with ext4
It is rather unexpected and seems worth mentioning. Reported in the
community forum [0] and the explanation found by Alwin [1].

[0]: https://forum.proxmox.com/threads/123819/
[1]: https://serverfault.com/questions/1113127/fstrim-is-very-slow-on-xfs-and-always-return-same-value-unlike-ext4/1113129#1113129

Signed-off-by: Fiona Ebner <f.ebner@proxmox.com>
2023-03-11 17:58:05 +01:00
Fiona Ebner
e3d91783eb qm: emulated devices: make recommendation for virtio devices more visible
Signed-off-by: Fiona Ebner <f.ebner@proxmox.com>
2023-02-24 16:27:51 +01:00
Fiona Ebner
0677f4cc12 qm: emulated devices: mention that virtio devices are better maintained
Signed-off-by: Fiona Ebner <f.ebner@proxmox.com>
2023-02-24 16:27:51 +01:00
Fiona Ebner
741fa47825 qm: hard disk controllers: recommend VirtIO controllers
Quoting from [0]:
> In general, I advise against using AHCI in production as better
> performance (and dev support) can be achieved through virtio.

[0]: https://lists.nongnu.org/archive/html/qemu-devel/2023-02/msg03915.html

Signed-off-by: Fiona Ebner <f.ebner@proxmox.com>
2023-02-24 16:27:51 +01:00
Fiona Ebner
a89ded0bf5 qm: hard disk controllers: reword and update section
Most importantly, mention that VirtIO SCSI single in combination with
IO thread is the new recommendation and default. The controller type
used for the QEMU commandline is still the same (but one for each
disk), so information about when OSes started supporting it should be
accurate.

Signed-off-by: Fiona Ebner <f.ebner@proxmox.com>
2023-02-24 16:27:51 +01:00
Noel Ullreich
58e695ca6a qm: fix two grammar issues
Fixed two small grammar errors in the qm chapter. Rephrased a
sentence before the fixed sentence so that it would be more legible.

Signed-off-by: Noel Ullreich <n.ullreich@proxmox.com>
 [ T: resolve context merge conflict on current master ]
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2023-01-16 16:52:13 +01:00
Thomas Lamprecht
afb9056593 qm: IO-Thread: rework and add a bit more context
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2022-12-21 14:48:29 +01:00
Fiona Ebner
bcb4e590fb qm: IO thread: mention that setting can also help with hangs
See https://bugzilla.kernel.org/show_bug.cgi?id=199727

Reported-by: Roland Kletzing <devzero@web.de>
Signed-off-by: Fiona Ebner <f.ebner@proxmox.com>
2022-12-21 14:08:27 +01:00
Fiona Ebner
4c7a47cf0e qm: IO thread: be more precise about how QEMU handles IO
Reported in the community forum[0].

The setting can already help with a single disk. Without the option,
there is not one IO thread as the old wording suggested, but IO is
handled in the main event loop or vCPU threads (see the kvm man page).

[0]: https://forum.proxmox.com/threads/118390/post-518532

Signed-off-by: Fiona Ebner <f.ebner@proxmox.com>
2022-12-21 14:08:27 +01:00
Fiona Ebner
c730e973b7 tree-wide: switch to offical spelling of QEMU
Signed-off-by: Fiona Ebner <f.ebner@proxmox.com>
2022-12-20 09:35:58 +01:00
Thomas Lamprecht
00dc358b51 qm: use monospace for mtu=1
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2022-11-18 13:11:35 +01:00
Daniel Tschlatscher
750d4f04c6 qm: add documentation for vm network MTU setting
Signed-off-by: Daniel Tschlatscher <d.tschlatscher@proxmox.com>
2022-11-18 13:10:29 +01:00
Wolfgang Bumiller
acb4a8998f Merge branch 'taskset' into taskset-merged 2022-11-10 10:11:15 +01:00
Daniel Bowder
1e6b30b556 fix #3593: add affinity to docs
Added affinity to the resource limiting info in qm.adoc.
Added affinity to the qemu conf spec in qm.conf.5-opts.adoc.

Signed-off-by: Daniel Bowder <daniel@bowdernet.com>
2022-11-10 10:11:09 +01:00
Thomas Lamprecht
d646626235 qm: avoid using "e.g."
favor "for example", "such as" or "like", as our technical writing
guide forbids using "e.g." in the docs where possible.

Also do some small fixes in the vicinity while at it.

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2022-11-08 19:01:13 +01:00
Thomas Lamprecht
277808347e qm: rework migration sections, drop mentioning outdated limitations
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2022-11-08 18:53:47 +01:00
Fiona Ebner
48219c581f pct/qm: update cpuunits default
which is 100 on hosts running cgroup v2. Still mention the old default
relevant for hosts with legacy cgroups.

Also reword the sentence with "gets in regards to other VMs running"
which sounded a bit off.

Signed-off-by: Fiona Ebner <f.ebner@proxmox.com>
2022-10-19 08:05:54 +02:00
Fiona Ebner
b90b797f86 qm: resource limits: update systemd setting name for cpuunits
As mentioned in man 5 systemd.resource-control, the CPUShares setting
was replaced by CPUWeight and is deprecated.

Signed-off-by: Fiona Ebner <f.ebner@proxmox.com>
2022-10-19 08:05:54 +02:00
Fabian Ebner
10a2a4aa2e close #4031: vm: import: simplify example for creating VM from existing disk
Now that the import-from feature is available.

Signed-off-by: Fabian Ebner <f.ebner@proxmox.com>
2022-06-17 17:17:49 +02:00
Fabian Ebner
95d115146b vm: import: avoid using deprecated bootdisk option
Signed-off-by: Fabian Ebner <f.ebner@proxmox.com>
2022-06-17 17:17:49 +02:00
Thomas Lamprecht
e039fe3cd9 qm: add very basic VirGL docs
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2022-04-28 21:18:37 +02:00
Fabian Ebner
8e0e0bcf35 VM live migration: mention that CPU vendor should be the same
Signed-off-by: Fabian Ebner <f.ebner@proxmox.com>
2021-11-17 15:33:02 +01:00
Aaron Lauterer
32e8b5b25b qm: adjust code blocks
adjusts the code block style where the older(?) way was used to be
consistent and more easy to distinguish as code block

Signed-off-by: Aaron Lauterer <a.lauterer@proxmox.com>
2021-11-15 15:51:49 +01:00
Aaron Lauterer
66aecccb57 qm: pct: mention move-disk for storage and reassign
Signed-off-by: Aaron Lauterer <a.lauterer@proxmox.com>
2021-11-15 15:51:49 +01:00