Files
gitea-pages/admin-guide/configuration/basic/host_rename.md

1.2 KiB

Host Renaming

Following steps are required to rename a host.

Introduce New Hostname

Sysdb/bob

For sysdb create a new node with bob as usual. For reference do

bob node list -v $OLD_FQDN

then add the new node

bob node add $NEW_FQDN $SYSDB_ENV
bod node set-attr $NEW_FQDN [all attributes as listed above]

and the same for the MAC addresses:

for mac in $(bob node list-macs $OLD_FQDN); do echo bob node add-mac $NEW_FQDN $mac; done

Hiera

In Hiera ensure that a host specific configuration file exists for the FQDN with the same content as for the old hostname.

Acutal Hostname Change

On the node as root run

hostnamectl set-hostname $NEW_FQDN
rm -rf /etc/puppetlabs/puppet/ssl
puppet agent -t

which changes the local hostname, removes the local Puppet certificate and updates the configuration with Puppet using the new hostname.

Other Changes to Consider

  • change DNS entry if a static IP address is assigned
  • redo SSL/TLS certificates with new hostname

Remove Old Hostname

  • bob node delete $OLD_FQDN
  • remove from Hiera
  • inform the Linux Team (linux-eng@psi.ch) so it can remove from Puppet server the certificate and other data and remove the computer object from the AD