How To Change IP Addresses on vCloud Applications

Last week at Partner Exchange Duncan Epping and I presented a little deeper insight into the SRM solution we published earlier in the week.  One great question that came up was about the processes to change the IP addresses on the various vCloud infrastructure after the failover happens.  We mentioned how Site Recovery Manager can change the IP of some Guest Operating Systems, but the IP change also handled differently within the various applications.  Many of the vCloud applications are bound to the IP address when they are installed or configured.  This means if you just change the IP address on the operating system, the application still will not function properly.  Below is a quick list of some of the core vCloud applications we used in our SRM testing when we changed IP addresses and the processes to do so.

Database Server

Microsoft SQL seemed to have no issues when changing the IP on the guest OS.  The services appear to bind to whatever IP is on the guest at the time the services start.  We did not see any issues here, but we also did not test using Oracle.  I would suggest checking with your DBA’s to ensure there are no issues, but I would suspect on Oracle you may need to make additional changes.

VMware vCenter Server

Changing the IP on this service is not specifically required when using the full install.  Simply updating the IP on the guest OS is enough since vCenter Server has no direct tie to the Guest IP.  This may be different with the vCenter Virtual Appliance, but we did not use that in our testing.

VMware vShield Manager

This is easy enough to change its IP on the appliance by re-running the setup command

  1. Log into the appliance with admin/default
  2. Enabled Admin mode with the command “en” and the same credentials
  3. re-run “setup” script to change the IP address
You must wait AT LEAST 5 Minutes or more for this change to take effect and all the services to startup.  If you try to do anything sooner you might see some odd errors.  The services take a bit of time to come back up.

VMware vCloud Director Cells

There is actually a KB article for this that explains it really well.  It is written for Oracle, however the steps are the same for MSSQL.  The bottom line is you need to do a couple of things:

  1. Change the Guest OS IP and routing information
  2. Stop the vCloud Director Cells
  3. Update the “cells” table with the new IP addresses of the cells per the KB article
  4. Edit the /opt/vmware/vcloud-director/ entries
    1. vcloud.cell.ip.primary – Change it to the new primary IP address
    2. – Change it to the new console proxy IP address
    3. vcloud.cell.ips – Change both the IPs in this field appropriately
  5. Restart the vCloud Director Cell service

Once  you make these changes the cell should start and you will see it bind to the new IP addresses when you examine the cell.log file.

VMware vCenter ChargeBack

There is a little known script located on the chargeback server that is needed to change the IP address.  Essentially you need to re-run the configuration of the server without re-installing.

  1. Start Menu
  2. VMware
  3. Vmware vCenter Chargeback
  4. vCenter Chargeback Manager Tools
  5. Reset IP address of the vCenter Chargeback Manager Server

VMware vCenter Orchestrator

This can be done in one of two places, but I recommend checking them both once you make the change to ensure it is set up correctly.  You can change the IP through the “Configure Network” option in the console or through the “Appliance Configuration” option, however you still need to make the change elsewhere in the “Orchestrator Configuration”

  1. Edit the vCO network tab in side the configuration screens for new IP
    • Check Installation Folder>\app-server\bin\
  1. Reboot is required for change to take effect


This covers the “Core” components of the vCloud management stack and changing the IP addresses on them through various means.  The key here is to remember that just by updating the networking in the Guest OS does not mean the various applications are properly updated.  You may need to check and double-check once the IP addresses are changed to ensure they are working before you continue on with your updates.

About Chris Colotti

Chris is active on the VMUG and event speaking circuit and is available for many events if you want to reach out and ask. Previously to this he spent close to a decade working for VMware as a Principal Architect. Previous to his nine plus years at VMware, Chris was a System Administrator that evolved his career into a data center architect. Chris spends a lot of time mentoring co-workers and friends on the benefits of personal growth and professional development. Chris is also amongst the first VMware Certified Design Experts (VCDX#37), and author of multiple white papers. In his spare time he helps his wife Julie run her promotional products as the accountant, book keeper, and IT Support. Chris also believes in both a healthy body and healthy mind, and has become heavily involved with fitness as a Diamond Team Beachbody Coach using P90X and other Beachbody Programs. Although Technology is his day job, Chris is passionate about fitness after losing 60 pounds himself in the last few years.


  1. Hi Chris,

    On the ESXi5 host in /etc/vmware/vpxa/vpxa.cfg  you have an entry of the ip address of the vcenter server. Changing the IP of the vcenter server can result in ESXi host to be disconnected in vcenter.

    See KB 1001493

    • I should have mentioned this was asked of me after the DR of the Cloud session at PEX and would assume the vCenter was already failed over and the hosts would already be disconnected in the Protected Site.  🙂

  2. Hi,

    I believe the is in /opt/vmware/vcloud-director/etc/ rather than /opt/vmware/vcloud-director/ I believe its a typo in your article, & I only came to discover this as one of my customers were following your article but could not find the file in there & emailed me asking where its.

    I hope this benefit others who could not find the file.

    Eiad Al-Aqqad
    T: @VirtualizationT

Leave a Reply

Your email address will not be published.