[pve-devel] [PATCH docs 1/7] system-requirements: revise subchapter and provide more details

[Alexander Zeidler]

Signed-off-by: Alexander Zeidler <a.zeidler at proxmox.com>
---
 pve-system-requirements.adoc | 29 ++++++++++++++++++++---------
 1 file changed, 20 insertions(+), 9 deletions(-)

diff --git a/pve-system-requirements.adoc b/pve-system-requirements.adoc
index 8a982a8..82d9be5 100644
--- a/pve-system-requirements.adoc
+++ b/pve-system-requirements.adoc
@@ -1,3 +1,4 @@
+[[system_requirements]]
 System Requirements
 -------------------
 ifdef::wiki[]
@@ -6,7 +7,8 @@ endif::wiki[]
 
 We recommend using high quality server hardware, when running {pve} in
 production. To further decrease the impact of a failed host, you can run {pve} in
-a cluster with highly available (HA) virtual machines and containers.
+a cluster with xref:chapter_ha_manager[highly available (HA)] virtual
+machines and containers.
 
 {pve} can use local storage (DAS), SAN, NAS, and distributed storage like Ceph
 RBD. For details see xref:chapter_storage[chapter storage].
@@ -26,7 +28,9 @@ used in production.
 
 * Hard drive
 
-* One network card (NIC)
+* One network card (NIC), used for fetching system updates and access
+via xref:chapter_gui[web interface], `ssh` or
+link:api-viewer/index.html[{pve} API]
 
 
 [[install_recommended_requirements]]
@@ -39,15 +43,22 @@ Recommended System Requirements
   guests. For Ceph and ZFS, additional memory is required; approximately 1GB of
   memory for every TB of used storage.
 
-* Fast and redundant storage, best results are achieved with SSDs.
+* Fast and redundant storage, best results are achieved with SSDs. Do
+  not use SD cards or USB flash drives, as these have a lower
+  durability and performance.
 
-* OS storage: Use a hardware RAID with battery protected write cache (``BBU'')
-  or non-RAID with ZFS (optional SSD for ZIL).
+* OS storage:
+** An HBA with a redundant xref:chapter_zfs[ZFS] RAID level. If not
+   using fast enterprise SSDs with power-loss protection, optionally
+   add one for use as xref:sysadmin_zfs_add_cache_and_log_dev[SLOG].
+** Or a hardware RAID controller with battery-backed write cache (BBU)
+   and not ZFS, as the combination can lead to data loss.
 
 * VM storage:
-** For local storage, use either a hardware RAID with battery backed write cache
-  (BBU) or non-RAID for ZFS and Ceph. Neither ZFS nor Ceph are compatible with a
-  hardware RAID controller.
+** For local storage, the same recommendations apply as for OS
+   storage. However, if a hardware RAID controller is used, in
+   addition to ZFS, xref:chapter_pveceph[Ceph] is also incompatible
+   with it.
 ** Shared and distributed storage is possible.
 ** SSDs with Power-Loss-Protection (PLP) are recommended for good performance.
   Using consumer SSDs is discouraged.
@@ -75,7 +86,7 @@ browsers:
 
 * Firefox, a release from the current year, or the latest Extended Support Release
 * Chrome, a release from the current year
-* Microsoft's currently supported version of Edge
+* Edge, Microsoft's currently supported release
 * Safari, a release from the current year
 
 When accessed from a mobile device, {pve} will show a lightweight, touch-based
-- 
2.39.5