From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from firstgate.proxmox.com (firstgate.proxmox.com [212.224.123.68]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits)) (No client certificate requested) by lists.proxmox.com (Postfix) with ESMTPS id B0DF76FD5E for ; Wed, 1 Sep 2021 16:16:31 +0200 (CEST) Received: from firstgate.proxmox.com (localhost [127.0.0.1]) by firstgate.proxmox.com (Proxmox) with ESMTP id A6DD98358 for ; Wed, 1 Sep 2021 16:16:31 +0200 (CEST) Received: from proxmox-new.maurer-it.com (proxmox-new.maurer-it.com [94.136.29.106]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits)) (No client certificate requested) by firstgate.proxmox.com (Proxmox) with ESMTPS id 14E7C834F for ; Wed, 1 Sep 2021 16:16:31 +0200 (CEST) Received: from proxmox-new.maurer-it.com (localhost.localdomain [127.0.0.1]) by proxmox-new.maurer-it.com (Proxmox) with ESMTP id DE3CD444AD for ; Wed, 1 Sep 2021 16:16:30 +0200 (CEST) From: Dylan Whyte To: pve-devel@lists.proxmox.com Date: Wed, 1 Sep 2021 16:16:15 +0200 Message-Id: <20210901141615.1832385-4-d.whyte@proxmox.com> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20210901141615.1832385-1-d.whyte@proxmox.com> References: <20210901141615.1832385-1-d.whyte@proxmox.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-SPAM-LEVEL: Spam detection results: 0 AWL 0.543 Adjusted score from AWL reputation of From: address BAYES_00 -1.9 Bayes spam probability is 0 to 1% KAM_DMARC_STATUS 0.01 Test Rule for DKIM or SPF Failure with Strict Alignment SPF_HELO_NONE 0.001 SPF: HELO does not publish an SPF Record SPF_PASS -0.001 SPF: sender matches SPF record Subject: [pve-devel] [PATCH v3 pve-docs 4/4] pvenode/wake-on-lan: language fix-up X-BeenThere: pve-devel@lists.proxmox.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Proxmox VE development discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 01 Sep 2021 14:16:31 -0000 minor corrections to the introduction and wake-on-lan section of "Proxmox VE Node Management" also expand introduction, based on new content Signed-off-by: Dylan Whyte --- changes from v1: * New patch. May as well do some fix-up while I'm here! changes from v2: * unchanged pvenode.adoc | 28 +++++++++++++++------------- 1 file changed, 15 insertions(+), 13 deletions(-) diff --git a/pvenode.adoc b/pvenode.adoc index 1600e43..e036d93 100644 --- a/pvenode.adoc +++ b/pvenode.adoc @@ -24,11 +24,13 @@ ifdef::wiki[] endif::wiki[] endif::manvolnum[] -The {PVE} node management tool (`pvenode`) allows to control node specific +The {PVE} node management tool (`pvenode`) allows you to control node specific settings and resources. -Currently `pvenode` allows to set a node's description and to manage -the node's SSL certificates used for the API and the web GUI through `pveproxy`. +Currently `pvenode` allows you to set a node's description, run various +bulk operations on the node's guests, view the node's task history, and +manage the node's SSL certificates, which are used for the API and the web GUI +through `pveproxy`. ifdef::manvolnum[] include::output-format.adoc[] @@ -43,7 +45,7 @@ Examples Both files need to be PEM encoded. `certificate.key` contains the private key and `certificate.crt` contains the whole certificate chain. -.Setup ACME account and order a certificate for local node. +.Setup ACME account and order a certificate for the local node. ----- pvenode acme account register default mail@example.invalid @@ -56,19 +58,19 @@ endif::manvolnum[] Wake-on-LAN ~~~~~~~~~~~ -Wake-on-LAN (WoL) allows to switch on a sleeping computer in the network by -sending a magic packet. At least one NIC must support this feature and the -respective option needs to be enabled in the computers firmware (BIOS/UEFI) +Wake-on-LAN (WoL) allows you to switch on a sleeping computer in the network, by +sending a magic packet. At least one NIC must support this feature, and the +respective option needs to be enabled in the computer's firmware (BIOS/UEFI) configuration. The option name can vary from 'Enable Wake-on-Lan' to -'Power On By PCIE Device', check your motherboards vendor manual, if unsure. -`ethtool` can be used to check the WoL configuration of `` by -running: +'Power On By PCIE Device'; check your motherboard's vendor manual, if you're +unsure. `ethtool` can be used to check the WoL configuration of `` +by running: ---- ethtool | grep Wake-on ---- -`pvenode` allows to wake sleeping members of a cluster via WoL using the +`pvenode` allows you to wake sleeping members of a cluster via WoL, using the command: ---- @@ -76,8 +78,8 @@ pvenode wakeonlan ---- This broadcasts the WoL magic packet on UDP port 9, containing the MAC address -of `` obtained from the `wakeonlan` property. The node specific -`wakeonlan` property can be set by the following command: +of `` obtained from the `wakeonlan` property. The node-specific +`wakeonlan` property can be set using the following command: ---- pvenode config set -wakeonlan XX:XX:XX:XX:XX:XX -- 2.30.2