How to change hostname of management-server in VMware Integrated OpenStack

Products

• VMware
• VMware Integrated OpenStack

Issue/Introduction

This article provides steps to change the hostname of a management-server in VMware Integrated OpenStack.

Environment

VMware Integrated OpenStack 2.0.x
VMware Integrated OpenStack 2.5.x
VMware Integrated OpenStack 3.0.x

Resolution

To change the hostname of VIO management-server:

1. Create a snapshot of VMware Integrated OpenStack vApp.
2. Create a DNS A and PTR record for management-server IP address.
3. Shutdown and power on VMware Integrated OpenStack vApp.
4. Connect to the management-server through SSH.
   
5. Stop oms services by running these commands:
   
   service oms stop
   service osvmw stop
   
   
6. Take a back up of the /opt/vmware/vio/etc file by running this command:
   
   cp -r /opt/vmware/vio/etc /root/etc_backup
   
   
7. Take a snapshot of the management-server.
8. Remove files that block certificate regeneration by running this command:
   
   rm /opt/vmware/vio/etc/oms.lock /opt/vmware/vio/etc/guard.key
   
   
9. Clean up the old certificate values by running this command:
   
   sed -i '/cms.*/d' /opt/vmware/vio/etc/vio_system.properties
   
   
10. Run this command to generate new certificate:
    
    /opt/vmware/vio/sysctl/scripts/generate-certs.sh `cat /opt/vmware/vio/etc/keystore.properties | grep keystorePass | awk -F"=" '{print $2}' | tr -d "\n"` oms oms_server /opt/vmware/vio/etc
    
    
11. Modify the /opt/vmware/vio/etc/omjs.properties file and set the oms.extension.registered to false to allow oms to register with vCenter Server with new certificate.
12. Restore original guard.key and password:
    
    cp /root/etc_backup/guard.key /opt/vmware/vio/etc/
    
    
13. Open the /opt/vmware/vio/etc/vio_system.properties file and locate the entry starting with:
    
    "cms.guard_keystore_pswd"
    
    
14. Replace it with same entry from /root/etc_backup/vio_system.properties file.
15. Stop and restart VIO vApp.
16. Log out from the vSphere Web Client.
17. Clear the browser cache and log in to the vSphere Web Clinet.
18. Go to the VMware Integrated Openstack plugin and reconnect the OMS.
19. Verify the hostname and certificate and delete the snapshot.