How to change hostname for SolusVM 2 management node

Question

How to change hostname for SolusVM 2 management node?

Answer

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:

1. Connect to SolusIO Management node via SSH
2. Update host parameter in /usr/local/solus/config/config.yml file
3. 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.

4. If you have SSL certificate for new domain name purchased from a certificate authority, you can update certificate files using this article
5. On the next step, check api_host and host parameters in /etc/solus/agent.json file 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