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 SolusVM 2 installation in its current state:

• If SolusVM 2 running inside of a virtual machine, create a snapshot using tools provided by virtualization automation solution you are using
• Or create a backup of SolusVM 2 on Management node using this article

Once backup is created, proceed with hostname change using steps below:

1. Connect to SolusVM 2 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 the execution of the command above it will try to renew Let's Encrypt certificate for the specified hostname, so it is better to have the new hostname resolvable globally prior to changing it.

4. If you have SSL certificate for a 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 node:
   

   # 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 SolusVM 2 > Virtual Servers page for the existing database. It is required to update os_image settings in SolusVM 2 database using this article