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

OLD_FQDN=my-old-hostname.psi.ch
NEW_FQDN=my-new-hostname.psi.ch
bob node list -v $OLD_FQDN

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

for mac in $(bob node list-macs $OLD_FQDN); do 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.

Actual 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
• if the host is icinga2 monitored you need to remove icinga2 from the host before running puppet so that a new cert, etc. is generated for the host

  yum remove icinga2-common icinga2-bin icinga2
  rm -rf /var/lib/icinga2
  rm -rf /etc/icinga2
  

Remove Old Hostname¶

• bob node delete $OLD_FQDN
• bob puppet delete $OLD_FQDN - delete puppet certificate (can also be done by web UI)
• remove from Hiera
• inform the Linux Team (linux-eng@psi.ch) so it can remove other data and remove the computer object from the AD