How To: Upgrading the Pure VMware 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.
- VMware Appliance Release Notes
- vSphere Plugin Release Notes
- VMware Analytics Collector Release Notes
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
orpuresw 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:~$
- 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.
- 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.