Skip to main content
Pure Technical Services

How To: Upgrading the Pure VMware Appliance with puresw

Currently viewing public documentation. Please login to access the full scope of documentation.

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.

  1. Log into the VMware Appliance CLI
    ssh pureuser@appliance-fqdn
  2. 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
    
  3. 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!
    1. 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:~$
      
  4. 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.