How to change hostname for SolusIO management node?
Warning: It is strongly recommended to schedule a maintenance time frame before changing a hostname.
First, it is recommended to create a backup of SolusIO installation in current state:
- If SolusIO running inside of virtual machine, create a snapshot using tools provided by virtualization automation solution you are using
- Or create a backup of SolusIO on management node using this article
Once backup is created, proceed with hostname change using steps below:
- Connect to SolusIO Management node via SSH
- After that run the following command to update docker stack settings:
# /usr/local/solus/bin/installer -reconfigure
Note: During execution of the command above it will try to renew Let's Encrypt certificate for specified hostname, so it is better to have the new hostname resolvable globally prior to changing it.
- If you have SSL certificate for new domain name purchased from a certificate authority, you can update certificate files using this article
- On the next step, check
/etc/solus/agent.jsonfile on every CR nodes:
# grep host /etc/solus/agent.json
If there is an old hostname, change it to new one and restart solus-agent service to apply changes
# systemctl restart solus-agent
There is a probability that icons will not be displayed properly on SolusIO > Virtual Servers page for existing database. It is required to update os_image settings in SolusIO database using this article