The VMware Knowledge Base provides support solutions, error messages and troubleshooting guides
Performing a side-by-side upgrade of the vCenter Operations 5.0 Appliance (2031543)
This article uses these terms to describe the vApps involved:
- New vApp: The vApp that is the target of the upgrade
- Source vApp: The vApp that is the source of the upgrade and from which data is exported
This procedure consists of two stages:
- Deploy the OVF and transfer data
- Configure the appliance via the admin web interface
To deploy the OVF and transfer data:
- Deploy the latest vCenter Operations Manager vApp OVF file. (This is the new vApp we work with in this procedure.)
- Power on the vCenter Operations Manager vApp (the new vApp) for the first time.
Note: Do not perform the initial configuration of the application from the admin web interface. Configuration is handled later in this procedure.
- Obtain the
/datapartition size for each virtual machine in the source vApp by running this command on each virtual machine:
df –k /data
- Add additional disk(s) to the virtual machines in the new vApp to ensure that you have at least 110% of the source data storage size available. Be aware that UI virtual machine comes with 120 GB and the Analytics virtual machine comes with 200 GB data disk sizes by default.
- Log into the virtual machine console or
sshto the UI virtual machine as
- Validate the networking of the UI virtual machine:
- Ping the IP addresses of the source UI and Analytics virtual machines.
- Ping the IP addresses and host names of the vCenter Servers that will be added to this vApp.
- Run this command to transfer all the data, specifying the details of one vCenter Server (preferably the one that holds the license; you will configure the remaining vCenter Servers later) in the command:
vcops-admin upgrade50 --vc-name vc_name --vc-server vc_server --user vc_username --password vc_password [--collection-user collection_user] [--collection-password collection_password] --uiHost UI_host --uiRootPassword UI_password --analyticsHost analytics_host --analyticsRootPassword analytics_password
- vc_name is the friendly name of one of the vCenter Servers configured in the source vApp
- vc_server is the vCenter Server's IP address or hostname related to the vc_name
- vc_username and vc_password is the vCenter Server username and password with which they are registered
- UI_host is the source UI virtual machine IP address
- analytics_host is the source Analytics virtual machine IP address
Note: You can optionally specify a new collection user and collection password.
- If you are asked to trust the certificate of the vCenter Server, answer Yes.
- The upgrade is complete and one vCenter Server is now registered. If the operation fails, you can check the
/var/log/vmware/vcops-admin.cmd.logfile for error details or contact VMware Support. If the operation succeeds, continue to the next step.
- Restart the Admin user interface service by running this command, which reloads the newly trusted certificate:
sudo service vcopsadmin restart
At this point, this content has been copied from the source vApp to the new vApp:
- Data in the CapacityIQ database
- Data in the Alive database. This includes data for all adapters (both vCenter and non-vCenter adapters).
- Data in FSDB.
- Configuration for CapacityIQ.
- Configuration for the vCenter adapter only. Configuration for non-vCenter adapters is not copied.
Note: Do not re-run the above commands using the other registered vCenter Servers. This is covered in the next section.
To configure the appliance via the admin web interface:
- Access the admin user interface by browsing to:
- Log in as
Note: You will not be asked to change the passwords for
- On the Registration tab of admin user interface, reconnect with each vCenter Server by clicking Update for each of them.
Note: Do not click Update for the vCenter Server specified in the upgrade command in the previous procedure.
- Ensure that you accept the certificate for every vCenter Server when you are prompted.
Note: If the environment is large, the time between each update can take 20 minutes because Analytics takes 20 minutes to initialize RMI on large setups. RMI must be functioning when updating registration later.
- Change the
This completes the import of all data from the source vApp to the new vApp, and all the original vCenter Servers are registered and connected to the new vApp.
Unless the configuration for VCM and VIN adapters were customized in the source vApp, they are not required to be copied to the new vApp.
If the source vApp had adapters for third-party software, you must copy the configuration data to the new vApp manually. This may require restarting services after the copy.
Log into the
/customweb page to ensure all data has been migrated.
Request a Product Feature
To request a new product feature or to provide feedback on a VMware product, please visit the Request a Product Feature page.