Updating the AVS and Everpure Cloud Dedicated PowerShell Modules

This document will guide you through the procedure for upgrading the AVS and Everpure Cloud Dedicated integration via PowerShell.

Regular updates, bug fixes, and new features are common in any software stack. As the AVS and Everpure Cloud Dedicated integration - managed via PowerShell - continues to mature and expand in functionality, we consistently maintain and update our software packages.

Important:

There are two possible upgrade paths depending on your deployment. You only need to follow one of the options below based on your setup:

If you are using the Everpure VMware Cloud Manager OVA, follow the instructions under Option 1.
If you are using the PureStorage.CBS.AVS PowerShell module on an Azure VM or AVS VM, follow the instructions under Option 2.

Please proceed with the option that applies to your environment.

Option 1: Upgrade the Everpure VMware Cloud Manager OVA

Check for available updates by running the following commands:

puresw list

You should see output similar to the examples below, indicating that an upgrade is available or system packages have updates:

Package                    Description                        Installed  Update Available
pure-vmware-appliance      Pure Storage VMware Appliance      5.0.0      No
pure-vmware-cloud-manager  Pure Storage VMware Cloud Manager  1.1.469    No

81 system packages have updates available

Checking for updates...

Package                    Description                        Installed  Update Available
pure-vmware-appliance      Pure Storage VMware Appliance      5.0.0      No
pure-vmware-cloud-manager  Pure Storage VMware Cloud Manager  1.1.389    Yes (1.1.469)

Upgrade the Appliance by running the following command:
```
puresw upgrade start pure-vmware-cloud-manager
```
After the upgrade completes, log in to Azure via the plugin using the purepwsh command.
Authenticate using the method displayed in the SSH session.

Option 2: Update the PureStorage.CBS.AVS PowerShell Module on an Azure VM or AVS VM

On the virtual machine that has the PureStorage.CBS.AVS, VMware.PowerCLI, and Az PowerShell modules installed, launch PowerShell.
Uninstall all previous versions of the PureStorage.CBS.AVS PowerShell module to prevent potential issues with having multiple versions of the modules on the same machine:
```
Uninstall-Module -Name PureStorage.CBS.AVS -AllVersions
```
Install and Import the latest available version of the PureStorage.CBS.AVS PowerShell module using the following commands:
```
Install-Module -Name PureStorage.CBS.AVS -Repository PSGallery
Import-Module -Name PureStorage.CBS.AVS -Force
```

Optionaly set VMware PowerCLI configuration to ignore untrusted certificates and CEIP

Set-PowerCLIConfiguration -InvalidCertificateAction:Ignore -DefaultVIServerMode multiple -ParticipateInCEIP:$false -Confirm:$false

After the upgrade completes, re-authenticate with Azure:
```
Connect-azAccount -UseDeviceAuthentication
```