Monday, 17 September 2012

Upgrading From vCloud Director 1.5 to 5.1

Upgrading From vCloud Director 1.5 to 5.1

An awesome blog written by Jason Shiplett of Clearpath SolutionsGroup 

The general steps for upgrading are as follows:
  1. Quiesce all cells
  2. Upgrade vCloud Director
  3. Upgrade vCloud Director database
  4. Restart vCloud Director service
  5. Upgrade vShield Manager
  6. Upgrade ESXi hosts and vCenter Server


Quiesce All Cells

To start off the process, we’ll quiesce and shutdown the cell. First, let’s check the cell status.
  • /opt/vmware/vcloud-director/bin/cell-management-tool -u <username> cell --status
vcloud cell status resized 600

My installation has zero active jobs, but yours may have some or even many. We’ll run a quiesce command to suspend the task scheduler. Once all tasks are finished, the cell is turned to inactive.
  • /opt/vmware/vcloud-director/bin/cell-management-tool -u <username> cell --quiesce true
vcloud quiesce true resized 600

Now that the cell is inactive, we can gracefully shut it down.
  • /opt/vmware/vcloud-director/bin/cell-management-tool -u <username> cell --shutdown
vcloud cell shutdown resized 600

The cell has now been successfully shut down.


Upgrade vCloud Director

The next step is to upgrade vCloud Director. To do so, we’ll need to get the upgrade bits onto the server. I’ve copied mine into the /tmp directory. Before I run the upgrade installer, I need to make sure it’s executable.
  • chmod u+x vmware-vcloud-director-5.1.0-810718.bin
Vmware vcloud director 5.1.0 resized 600

Now that it’s executable, we can run it.
  • ./vmware-vcloud-director-5.1.0-810718.bin
VMware vcloud director 5.1.0 run resized 600

NOTE: that I’m prompted because I’m not running a supported Linux distribution (CentOS 5.8 x64). If you’re on RedHat Enterprise Linux of a supported rev, you shouldn’t see the error.

Hit ‘y’ to upgrade.

install vcloud director unsupport mode resized 600

You should see something similar to the screenshots below during the upgrade process.

upgrade vcloud director resized 600 

upgrade vcloud director complete resized 600

The vCloud Director upgrade is now complete.


Upgrade vCloud Director Database/Restart Service

The next step is to upgrade the vCloud Director database. To do so, run the following command.
  • /opt/vmware/vcloud-director/bin/upgrade
vmware vcloud command resized 600

NOTE- It’s very important to have a full backup of your database before proceeding. Hit ‘y’ to upgrade the database.

vcloud director upgrade database resized 600

You should see a screen similar to that below. Hit ‘y’ to rebuild indexes, then to update database statistics or ‘n’ to skip. This is recommended to increase database performance. When finished, hit ‘y’ to automatically start the vmware-vcd service.

vcloud director upgrade database resized 600 

start vmware vcd resized 600

The vCloud Director database has now been upgraded. My lab vCloud Director wasn’t accessible at this point until I fully rebooted the machine, but your mileage may vary. A simple ‘service vmware-vcd restart’ may be all that’s required.


Upgrade vShield Manager

The next step is to upgrade vShield Manager from 5.0 to 5.1, which will be accomplished via the vShield Manager GUI.

upgrade vshield login resized 600

Log in as you usually would as an administrative user.

vmware vshield manager login resized 600

Once logged in, click on ‘Settings & Reports’

vcenter settings reports resized 600

Now, click on the ‘Updates’ tab.

vcenter upgrades tab resized 600

On the ‘Updates’ tab, click ‘Upload Upgrade Bundle’.

Browse to the file location, then hit ‘Upload File’. Note - I ran into a problem here where vShield Manager would not recognize my upgrade package as legit. You can reference this article for a resolution.

vshield manager upload resized 600 

vshield manager upload upgrade bundle resized 600

You should then see a popup similar to the one below. Click ‘OK’.

update vshield manager resized 600 

update vshield manager processing resized 600

Once the upgrade file has been imported, click ‘Install’ to perform the upgrade.

update vshield manager install resized 600

vShield Manager will now confirm the upgrade. Click ‘Confirm Install’.

update vshield manager confirm install resized 600

You should now see the process go forward.

update vshield manager install processing resized 600

After the installation is finished, the virtual appliance will reboot, and you will have to log back in, possibly even re-enable the vShield Manager vCenter plugin. When you log back in to vShield Manager, you should see a new interface, as below.

vshield manager new interface resized 600

On the ‘Updates’ tab, you’ll see that you’re on the new revision, 5.1.0-807847.

vshield manager new version resized 600

vShield Manager is now up to date.