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 299BE1FF183 for ; Wed, 16 Jul 2025 18:38:58 +0200 (CEST) Received: from firstgate.proxmox.com (localhost [127.0.0.1]) by firstgate.proxmox.com (Proxmox) with ESMTP id 02D7417FE2; Wed, 16 Jul 2025 18:39:50 +0200 (CEST) From: Stefan Hanreich To: pve-devel@lists.proxmox.com Date: Wed, 16 Jul 2025 18:39:11 +0200 Message-Id: <20250716163911.406995-10-s.hanreich@proxmox.com> X-Mailer: git-send-email 2.39.5 In-Reply-To: <20250716163911.406995-1-s.hanreich@proxmox.com> References: <20250716163911.406995-1-s.hanreich@proxmox.com> MIME-Version: 1.0 X-SPAM-LEVEL: Spam detection results: 2 AWL -2.717 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 KAM_SOMETLD_ARE_BAD_TLD 5 .bar, .beauty, .buzz, .cam, .casa, .cfd, .club, .date, .guru, .link, .live, .monster, .online, .press, .pw, .quest, .rest, .sbs, .shop, .stream, .top, .trade, .wiki, .work, .xyz TLD abuse 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: [pve-devel] [PATCH pve-docs v3 1/1] network: add documentation for proxmox-network-interface-pinning 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: , Reply-To: Proxmox VE development discussion Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Errors-To: pve-devel-bounces@lists.proxmox.com Sender: "pve-devel" Signed-off-by: Stefan Hanreich --- pve-network.adoc | 42 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 42 insertions(+) diff --git a/pve-network.adoc b/pve-network.adoc index 55c796b..48f3d5b 100644 --- a/pve-network.adoc +++ b/pve-network.adoc @@ -158,6 +158,48 @@ command line. You need to reboot for the changes to take effect. Overriding network device names ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Using the proxmox-network-interface-pinning tool +++++++++++++++++++++++++++++++++++++++++++++++++ + +Proxmox VE 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 the following files: + +* `/etc/network/interfaces` +* `/etc/pve/nodes//host.fw` +* `/etc/pve/sdn/controllers.cfg` + +NOTE: Since the generated mapping is local to the node it is generated on, +interface names contained in the Firewall Datacenter configuration +(`/etc/pve/firewall/cluster.fw`) are **not** automatically updated. + +The generated link files are stored in `/usr/local/lib/systemd/network`. + +It is currently only possible to generate names with the prefix `nic`, since +otherwise the interfaces would not get recognized as a physical interface. When +auto-generating new interface names, the tool will use `nic0`, `nic1`, ... + +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): + +---- +proxmox-network-interface-pinning generate +---- + +It is also possible to pin only a specific interface: + +---- +proxmox-network-interface-pinning generate --nic enp1s0 +---- + +In order to apply the changes made by `proxmox-network-interface-pinning` to the +network configuration, the node needs to be rebooted. + + +Manual method ++++++++++++++ + You can manually assign a name to a particular network device using a custom https://manpages.debian.org/stable/udev/systemd.link.5.en.html[systemd.link file]. This overrides the name that would be assigned according to the latest -- 2.39.5 _______________________________________________ pve-devel mailing list pve-devel@lists.proxmox.com https://lists.proxmox.com/cgi-bin/mailman/listinfo/pve-devel