# 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