Maybe the hosting provider you just bought a server from automatically sets the hostname or maybe you didn’t think about it when you setup your homelab and now want to give your servers better names than “PVE0X”. Whatever your reason is, the problem is still the same: you need to rename your proxmox node(s). The process is fairly simple, but there are some considerations to be made before proceeding.<\/p>\n\n\n\n
If your shared storage refers to its host via hostname rather than IP address or DNS entry, then these will need to be re-provisioned as they cannot be edited. Any containers or virtual machines that are using that storage needs to be migrated to a different storage location.<\/p>\n\n\n\n
The same goes for storage such as NFS referenced by containers, nodes and virtual machines. You should change these references to IP address or DNS entry name. You may also update then to use the hostname you plan on using, but this is less advisable for potential future changes.<\/p>\n\n\n\n
Now that we have migrated our storages to IP address or our local-lvm, we can start making changes. You will need to repeat the following steps on each node in the cluster you want to rename. You will also need to repeat the corosync config step for every node in the cluster, even if they are not being renamed.<\/p>\n\n\n\n
First things first, we will want to be connecting to the node(s) via SSH and not the Proxmox Web Interface. This will prevent any communication issues that may crop up during the process. Make sure to transfer your SSH key to the nodes prior to continuing, if you haven’t already.<\/p>\n\n\n\n
eval $(ssh-agent)\nssh-add \/path\/to\/ssh\/key\nssh <user>@<server_ip><\/code><\/pre>\n\n\n\nStep 2 – Obtain Local Lock<\/h2>\n\n\n\n
Now that we are connected, we will need to obtain a local lock with pmxcfs<\/code> so that we can edit our server’s configuration. To do this, we will need to kill the process with the current lock, pve-cluster<\/code>, then pass the -l<\/code> flag to the invocation of pmxcfs<\/code>.<\/p>\n\n\n\nsystemctl stop pve-cluster\npmxcfs -l<\/code><\/pre>\n\n\n\nIf there is any issue with the lock, there will be an error message similar to: [main] notice: unable to acquire pmxcfs lock - trying again<\/code>. <\/p>\n\n\n\nIf everything is okay, the output should just look like <\/p>\n\n\n\n
[main] notice: resolved node name 'tucana' to '192.168.12.3' for default node IP address\n[main] notice: forcing local mode (although corosync.conf exists)<\/code><\/pre>\n\n\n\nStep 3 – Modify Host Files<\/h2>\n\n\n\n
Now, we will need to edit \/etc\/hostname<\/code> and \/etc\/hosts<\/code> to reflect our desired changes. Here, I will be changing pve<\/code> to tucana<\/code><\/p>\n\n\n\n\/etc\/hosts<\/code><\/p>\n\n\n\n127.0.0.1 localhost.localdomain localhost\n192.168.12.3 tucana.net.hlab tucana\n\n# The following lines are desirable for IPv6 capable hosts\n\n::1 ip6-localhost ip6-loopback\nfe00::0 ip6-localnet\nff00::0 ip6-mcastprefix\nff02::1 ip6-allnodes\nff02::2 ip6-allrouters\nff02::3 ip6-allhosts<\/code><\/pre>\n\n\n\n\/etc\/hostname<\/code><\/p>\n\n\n\ntucana<\/code><\/pre>\n\n\n\nStep 4 – Modify Corosync Config<\/h2>\n\n\n\n
Since we have changed the hostname, we will also have to update references in \/etc\/pve\/corosync.conf<\/code> to reflect the changes. Alternatively, you can delete this configuration to reset the cluster state, then recreate the cluster after the name changes have been made.<\/p>\n\n\n\n\/etc\/pve\/corosync.conf<\/code><\/p>\n\n\n\nlogging {\n debug: off\n to_syslog: yes\n}\n\nnodelist {\n node {\n name: ara\n nodeid: 1\n quorum_votes: 1\n ring0_addr: 192.168.12.125\n }\n node {\n name: tucana\n nodeid: 3\n quorum_votes: 1\n ring0_addr: 192.168.12.3\n }\n node {\n name: volans\n nodeid: 2\n quorum_votes: 1\n ring0_addr: 192.168.12.251\n }\n}\n\nquorum {\n provider: corosync_votequorum\n}\n\ntotem {\n cluster_name: hlab01\n config_version: 3\n interface {\n linknumber: 0\n }\n ip_version: ipv4-6\n link_mode: passive\n secauth: on\n token_coefficient: 321\n version: 2\n}<\/code><\/pre>\n\n\n\nStep 5 – Restart The Node<\/h2>\n\n\n\n
Once we have made those changes, we will need to restart the node so it can create the directory structure required for the next step.<\/p>\n\n\n\n
killall pmxcfs\nreboot<\/code><\/pre>\n\n\n\nStep 6 – Transfer LXC Configs<\/h2>\n\n\n\n
Before we can transfer the LXC configs to the new node name, we will again need to kill the current lock and create our own.<\/p>\n\n\n\n
systemctl stop pve-cluster\npmxcfs -l<\/code><\/pre>\n\n\n\nNow, we can move the configs from the old node name to the new name.<\/p>\n\n\n\n
mv \/etc\/pve\/nodes\/<old_name>\/lxc\/* \/etc\/pve\/nodes\/<new_name>\/lxc\/<\/code><\/pre>\n\n\n\nStep 7 – Cleanup & Reboot<\/h2>\n\n\n\n
Finally, we will need to clean up the last reference to the node’s previous name.<\/p>\n\n\n\n
rm -rf \/etc\/pve\/nodes\/<old_name><\/code><\/pre>\n\n\n\nAfter this, restart the node<\/p>\n\n\n\n
reboot<\/code><\/pre>\n\n\n\nThat’s it! Your node has been renamed and you can move on to the other nodes in the cluster.<\/p>\n","protected":false},"excerpt":{"rendered":"
Maybe the hosting provider you just bought a server from automatically sets the hostname or maybe you didn’t think about it when you setup your homelab and now want to give your servers better names than “PVE0X”. Whatever your reason is, the problem is still the same: you need to rename your proxmox node(s). The […]<\/p>\n","protected":false},"author":1,"featured_media":146,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[5,18,25],"tags":[],"class_list":["post-145","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-blog","category-homelab","category-server"],"_links":{"self":[{"href":"http:\/\/digitalartifex.dev\/index.php\/wp-json\/wp\/v2\/posts\/145","targetHints":{"allow":["GET"]}}],"collection":[{"href":"http:\/\/digitalartifex.dev\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/digitalartifex.dev\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/digitalartifex.dev\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"http:\/\/digitalartifex.dev\/index.php\/wp-json\/wp\/v2\/comments?post=145"}],"version-history":[{"count":17,"href":"http:\/\/digitalartifex.dev\/index.php\/wp-json\/wp\/v2\/posts\/145\/revisions"}],"predecessor-version":[{"id":163,"href":"http:\/\/digitalartifex.dev\/index.php\/wp-json\/wp\/v2\/posts\/145\/revisions\/163"}],"wp:featuredmedia":[{"embeddable":true,"href":"http:\/\/digitalartifex.dev\/index.php\/wp-json\/wp\/v2\/media\/146"}],"wp:attachment":[{"href":"http:\/\/digitalartifex.dev\/index.php\/wp-json\/wp\/v2\/media?parent=145"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/digitalartifex.dev\/index.php\/wp-json\/wp\/v2\/categories?post=145"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/digitalartifex.dev\/index.php\/wp-json\/wp\/v2\/tags?post=145"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}