From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from firstgate.proxmox.com (firstgate.proxmox.com [212.224.123.68]) by lore.proxmox.com (Postfix) with ESMTPS id 20D231FF185 for ; Mon, 4 Aug 2025 18:23:54 +0200 (CEST) Received: from firstgate.proxmox.com (localhost [127.0.0.1]) by firstgate.proxmox.com (Proxmox) with ESMTP id 12BE336A68; Mon, 4 Aug 2025 18:25:25 +0200 (CEST) From: Stefan Hanreich To: pbs-devel@lists.proxmox.com Date: Mon, 4 Aug 2025 18:24:41 +0200 Message-ID: <20250804162448.607184-8-s.hanreich@proxmox.com> X-Mailer: git-send-email 2.47.2 In-Reply-To: <20250804162448.607184-1-s.hanreich@proxmox.com> References: <20250804162448.607184-1-s.hanreich@proxmox.com> MIME-Version: 1.0 X-SPAM-LEVEL: Spam detection results: 0 AWL -0.192 Adjusted score from AWL reputation of From: address BAYES_00 -1.9 Bayes spam probability is 0 to 1% DMARC_MISSING 0.1 Missing DMARC policy KAM_DMARC_STATUS 0.01 Test Rule for DKIM or SPF Failure with Strict Alignment KAM_LAZY_DOMAIN_SECURITY 1 Sending domain does not have any anti-forgery methods RDNS_NONE 0.793 Delivered to internal network by a host with no rDNS SPF_HELO_NONE 0.001 SPF: HELO does not publish an SPF Record SPF_NONE 0.001 SPF: sender does not publish an SPF Record Subject: [pbs-devel] [PATCH proxmox-backup v5 3/4] docs: add documentation for proxmox-network-interface-pinning X-BeenThere: pbs-devel@lists.proxmox.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Proxmox Backup Server development discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: Proxmox Backup Server development discussion Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Errors-To: pbs-devel-bounces@lists.proxmox.com Sender: "pbs-devel" Mostly taken from the Proxmox VE documentation, but removed the Proxmox VE specific parts and added a short introductory paragraph that describes the problem of network interface name changes. Signed-off-by: Stefan Hanreich --- docs/network-management.rst | 55 +++++++++++++++++++++++++++++++++++++ 1 file changed, 55 insertions(+) diff --git a/docs/network-management.rst b/docs/network-management.rst index 5ae19e56..492becdf 100644 --- a/docs/network-management.rst +++ b/docs/network-management.rst @@ -97,3 +97,58 @@ of **Configuration** or by using the ``dns`` subcommand of .. include:: traffic-control.rst + + +Overriding network device names +------------------------------- + +When upgrading kernels, adding PCIe devices or updating your BIOS, automatically +generated network interface names can change. To alleviate this issues, Proxmox +Backup Server provides a tool for automatically generating .link files for +overriding the name of network devices. It also automatically replaces the +occurences of the old interface name in `/etc/network/interfaces`. + +The generated link files are stored in `/usr/local/lib/systemd/network`. For the +interfaces file a new file will be generated in the same place with a `.new` +suffix. This way you can inspect the changes made to the configuration by +using diff (or another diff viewer of your choice): + +---- +diff -y /etc/network/interfaces /etc/network/interfaces.new +---- + +If you see any problematic changes or want to revert the changes made by the +pinning tool **before rebooting**, simply delete all `.new` files and the +respective link files from `/usr/local/lib/systemd/network`. + +The following command will generate a .link file for all physical network +interfaces that do not yet have a .link file and update selected Proxmox VE +configuration files (see above). The generated names will use the default prefix +`nic`, so the resulting interface names will be `nic1`, `nic2`, ... + +---- +proxmox-network-interface-pinning generate +---- + +You can override the default prefix with the `--prefix` flag: + +---- +proxmox-network-interface-pinning generate --prefix myprefix +---- + +It is also possible to pin only a specific interface: + +---- +proxmox-network-interface-pinning generate --interface enp1s0 +---- + +When pinning a specific interface, you can specify the exact name that the +interface should be pinned to: + +---- +proxmox-network-interface-pinning generate --interface enp1s0 --target-name if42 +---- + +In order to apply the changes made by `proxmox-network-interface-pinning` to the +network configuration, the host needs to be rebooted. + -- 2.47.2 _______________________________________________ pbs-devel mailing list pbs-devel@lists.proxmox.com https://lists.proxmox.com/cgi-bin/mailman/listinfo/pbs-devel