Upgrading from OnApp 5.1 to 5.2 with vCloud Director integration

Jim Freeman

Jim Freeman
Senior Cloud Architect

The upgrade process between versions of OnApp for vCD is very straightfoward. While we offer free and paid upgrade services,  if you want to perform the upgrade yourself, you can do so with this simple guide.

To see a list of new features in 5.2 please refer to our latest release notes and this blog post from our head of product strategy, Raymond Paxton.

On with the guide…


1. Download and install the latest OnApp repository:

# rpm -Uvh

2. Upgrade the OnApp installer package:

# yum update onapp-cp-install

3. Update the CentOS base components:

# /onapp/onapp-cp-install/ -y

4. Run the OnApp upgrade script:

# /onapp/onapp-cp-install/

Depending on the size of the existing environment, the upgrade script will take somewhere between 5 and 30 minutes to complete.

5. Check sync:

Once the upgrade has successfully completed, it is strongly recommended to run the following scripts to ensure that OnApp and vCloud Director are in sync:

# cd /onapp/interface ; RAILS_ENV=production rake vcloud:resync_clean

# cd /onapp/interface ; RAILS_ENV=production rake vcloud:resync

The first script should take less than a minute or two to run, while the second script can take up to 25 minutes (dependent on the size of your environment).

You can can check the status of these scripts while they are running, by having a separate console open and monitoring the following file as follows:

# tail -f /onapp/interface/log/production_vcloud.log

If you notice any errors in this log file during the upgrade, please get in touch with OnApp support and they will be able to assist!