How to patch your VMware Integrated Openstack (VIO) environment

Here in this post I am going to explain you about How to patch your existing VMware Integrated OpenStack environment?? which is fairly simple and can be easily installed on the OpenStack Management Server (OMS).

I have the lab environment running VIO 2.0.1 and I will be going to install the 2.0.3 patch in my lab environment.

This 2.0.3 patch is released on 2016-04-01 and can be downloaded from the My VMware Downloads Page.

New Features with the  2.0.3 patch release:

  • Support for Single Root I/O Virtualization (SR-IOV)
  • Leveraging the vSphere Resource pool in OpenStack
  • Abitility to configure the Additional Advanced VM Settings like enabling multi-threading, and reserving full CPU and memory
  • Extended Image Conversion where Non-VMDK images are now automatically converted to streamOptimized images
  • Ability to do the Volume ” viocli volume-migrate” command
  • Custom CLI documentation.

For more information please refer to the VMware Integrated OpenStack 2.0.3 Patch Release Notes:

Prerequisites to install the 2.0.3 patch

  • You must be running either 2.0.1 or 2.0.2
  • VIO Deployment must be in a running or Not Deployed State
  • If you have any other version, upgrade will fail

Step 1: Downloading the VMware Integrated OpenStack 2.0.3 debian package

Step 2: Uploading and adding the patch to the patch repository in the oms server

To upload the patch from windows machine to openstack management server, use winscp or anyother tools to your convenience. Once the file is copied to Openstack Management Server (OMS) run the following command.

I have logged into the oms server using putty with the viouser credentials and then I switched the user to root with su – command. If you want to run the following command as a viouser use the sudo command.

root@oms:~# viopatch add -l /home/viouser/vio-patch-203_2.0.3.3720171_all.deb
/home/viouser/vio-patch-203_2.0.3.3720171_all.deb patch has been added.

Run the following command to check whether the patch is added, this command also lists the patch installation status. From the following command output you could see the Installation status Installed is No

root@oms:~# viopatch list
Name           Version        Type    Installed
-------------  -------------  ------  -----------
vio-patch-203  infra   No

Step 3: Installing the patch:

root@oms:~# viopatch install --patch vio-patch-203 --version
Installation complete for patch vio-patch-203 version

Step 4: Check the current version of the OpenStack with the following commands.

root@oms:~# viopatch list
Name           Version        Type    Installed
-------------  -------------  ------  -----------
vio-patch-203  infra   Yes

root@oms:~# viopatch version

To check the Openstack version in the vSphere Web Client, logout from the current session and login back to vCenter Server and then click on the VMware Integrated OpenStack Link from the vSphere Web Client Home Page and then click on the Summary tab. This will list out the new patch version


How about uninstalling the patch?

You can uninstall the patch using the following command:

viopatch uninstall -p vio-patch-203 -v

For the viopatch command line help type “viopatch –help” to list all options


root@oms:~# viopatch --help
usage: viopatch [-h] {add,list,install,uninstall,version} ...

Patching CLI for VIO.

positional arguments:
                        sub-command help
    add                 Adds the provided patch to the downloaded patch list.
    list                Lists the already downloaded patches.
    install             Install the provided patch.
    uninstall           Unistall the provided patch.
    version             output version information and exit

optional arguments:
  -h, --help            show this help message and exit

That is it. Installing the patch in the VMware Integrated OpenStack is fairly a simple and easy process.

Leave a Reply