Knowledge Base

The VMware Knowledge Base provides support solutions, error messages and troubleshooting guides
 
Search the VMware Knowledge Base (KB)   View by Article ID
 

Performing a side-by-side upgrade of the vCenter Operations 5.0 Appliance (2031543)

Purpose

This article provides steps to deploy a new instance of the vCenter Operations Manager vApp to upgrade or replace an existing instance.

Resolution

Generally speaking, the latest version is deployed, so two instances of vCenter Operations Manager exist at the same time and data is migrated from the previous version.

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
Please see the deployment guide for storage/CPU/IP prerequisites. For storage, you will require enough space in each virtual machine in the new vApp to hold 110% of the data partition size of the corresponding source virtual machine.

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:

  1. Deploy the latest vCenter Operations Manager vApp OVF file. (This is the new vApp we work with in this procedure.)
  2. 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.

  3. Obtain the /data partition size for each virtual machine in the source vApp by running this command on each virtual machine:

    df –k /data

  4. 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.
  5. Log into the virtual machine console or ssh to the UI virtual machine as admin/admin.
  6. Validate the networking of the UI virtual machine:

    1. Ping the IP addresses of the source UI and Analytics virtual machines.
    2. Ping the IP addresses and host names of the vCenter Servers that will be added to this vApp.

  7. 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

    Where:
    • 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.

  8. If you are asked to trust the certificate of the vCenter Server, answer Yes.
  9. 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.log file for error details or contact VMware Support. If the operation succeeds, continue to the next step.
  10. 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:

  1. Access the admin user interface by browsing to:

    https://new_UI_virtualmachine_IP_or_hostname/admin

  2. Log in as admin/admin.

    Note: You will not be asked to change the passwords for admin and root.

  3. 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.

  4. 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.

  5. Change the root and admin passwords.

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 /vsphere or /custom web page to ensure all data has been migrated.

Additional Information

When upgrading from vCenter Operations Manager 5.6 to a newer 5.6 or 5.7 version, the following files must be manually copied from the old UI and Analytics VM to the new UI and Analytics VMs:

UI VM:

$ALIVE_BASE/tomcat/webapps/vcops-vsphere/WEB-INF/classes/View_CustomViews.properties
$ALIVE_BASE/tomcat/webapps/vcops-vsphere/WEB-INF/classes/Metric_CustomViews.properties
$ALIVE_BASE/user/conf/analytics/user_ciq_metrics_collected.xml
$ALIVE_BASE/user/conf/analytics/user_group_metrics.xml

Analytics VM:

$ALIVE_BASE/user/conf/analytics/user_ciq_metrics_collected.xml
$ALIVE_BASE/user/conf/analytics/user_group_metrics.xml

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.

Feedback

  • 4 Ratings

Did this article help you?
This article resolved my issue.
This article did not resolve my issue.
This article helped but additional information was required to resolve my issue.
What can we do to improve this information? (4000 or fewer characters)
  • 4 Ratings
Actions
KB: