How To: Upgrading the Pure VMware Appliance with puresw

Last updated
Save as PDF

The Pure Storage VMware Appliance was released to support deployments of Pure Storage integrations such as the Remote Plugin for the vSphere Client and the VM Analytics Collector. While the OVA supports each of these integrations, the OVA can only support one integration at a time. When multiple integrations are needed, more than one OVA will need to be deployed. This KB covers the process to upgrade the appliance, remote plugin or collector directly from the appliance with puresw.

Please remember that the VMware appliance can only support a single integration. Meaning that you deploy an OVA for either the Remote Plugin or the VMA Collector, not both. When multiple integrations are needed, then more than one OVA will need to be deployed.

Upgrading the VMware Appliance and Remote Plugin

Here is the process to upgrade the VMware Appliance with either the Remote Plugin or Collector application when either has an upgrade available.

Log into the VMware Appliance CLI
ssh pureuser@appliance-fqdn

Find what upgrades are available by using puresw list

To upgrade from appliance versions 3.4.1 and older to 3.4.2 and newer, a new OVA will need to be deployed.

Please see this KB for more information.

For example, when the vSphere 5.2.0 remote plugin was released, if the appliance was on versions 3.4.1 or older, no update would be shown as available.

VMware Appliance with the Remote Plugin Installed

pureuser@remote-plugin:~$ puresw list
Checking for updates...

Package                     Description                         Installed  Update Available
pure-vmware-appliance       Pure Storage VMware Appliance       3.2.0      Yes (3.3.1)
pure-vsphere-remote-plugin  Pure Storage vSphere Client Plugin  5.0.0      Yes (5.1.0)

33 system packages have updates available

VMware Appliance with the VM Analytics Collector Installed

pureuser@vm-analytics-collector:~$ puresw list
Checking for updates...

Package                 Description                          Installed  Update Available
pure-vmware-appliance   Pure Storage VMware Appliance        3.3.0      Yes (3.3.1)
vm-analytics-collector  Pure Storage VM Analytics Collector  3.1.0      Yes (3.1.4)

33 system packages have updates available

Upgrade either the appliance or plugin with puresw upgrade start pure-vsphere-remote-plugin or puresw upgrade start vm-analytics-collector

VMware Appliance with the Remote Plugin Installed

pureuser@remote-plugin:~$ puresw upgrade start pure-vsphere-remote-plugin
Installing...

==================================WARNING======================================
There is a plugin upgrade ongoing. After the upgrade is complete, please run
`pureplugin update-registration` to update the registration on vCenter(s).
===============================================================================


Installation complete!

VMware Appliance with the VM Analytics Collector Installed

pureuser@vm-analytics-collector:~$ puresw upgrade start vm-analytics-collector
Installing...

Installation complete!

The vSphere Remote Plugin will require that the extensions are re-registered in order to ensure the updated extensions are pushed to the vCenter. You will need to run pureplugin update-registration which will require a username and password in order to re-register the extensions. This is required as the credentials to register the extensions is not stored on the appliance.

pureuser@remote-plugin:~$ pureplugin update-registration
Please enter user for demo-vcsa-01.purecloud.com: extension-register@vsphere.local
Please enter password for demo-vcsa-01.purecloud.com:
Unregistering plugin...
Plugin   Status   Version  Registrations
vSphere  running  5.1.0    -
Re-registering plugin...
Host thumbprint is d1:27:2b:0e:3c:a1:6e:ff:88:9b:aa:7b:8e:f4:c7:ca:69:3b:7e:94. Is this correct? (y/n) y
Plugin   Status   Version  Registrations
vSphere  running  5.1.0    demo-vcsa-01.purecloud.com
Registration update for demo-vcsa-01.purecloud.com complete!
pureuser@remote-plugin:~$

Check that the appliance or plugin are updated with puresw list

VMware Appliance with the Remote Plugin Installed

pureuser@remote-plugin:~$ puresw list
Checking for updates...

Package                     Description                         Installed  Update Available
pure-vmware-appliance       Pure Storage VMware Appliance       3.3.1      No
pure-vsphere-remote-plugin  Pure Storage vSphere Client Plugin  5.1.0      No

0 system packages have updates available

Software is up to date!

VMware Appliance with the VM Analytics Collector Installed

pureuser@vm-analytics-collector:~$ puresw list
Checking for updates...

Package                 Description                          Installed  Update Available
pure-vmware-appliance   Pure Storage VMware Appliance        3.3.1      No
vm-analytics-collector  Pure Storage VM Analytics Collector  3.1.4      No

0 system packages have updates available

Software is up to date!

In the event that there is a failed upgrade process please open a Pure Support case and work with them to resolve the issue.