Upgrading Everpure Cloud Dedicated via the Purity CLI

Log in to the CLI for your Pure Storage Cloud Dedicated instance using an SSH utility like PuTTY. See Logging into Everpure Cloud Dedicated for Azure via CLI for details.
If you deployed Everpure Cloud Dedicated with an SSH key, you can use that key to log in as pureuser. Alternatively, you can create an array administrator role on Everpure Cloud Dedicated under Settings > Access and use the username and password combination to log in, or an SSH key.

Run the following command to see what Purity versions are available to upgrade to:

puresw list --catalog

Example output:


Name        Release Family  Version    Upgrade Path      Details
Purity//FA  6.6             6.6.8      6.6.7->6.6.8         -

Download the desired version of Purity to the array. This typically takes about 5 minutes to complete. An example of this is shown below.

puresw download --version 6.6.8 Purity//FA

Example output:


Name        Version   Status  Progress  Details
Purity//FA  6.6.8     new     -         Pure1 cloud is building upgrade package. This will take up to 5 minutes to complete.

Optionally, run a pre-check to confirm that the Everpure Cloud Dedicated array has all the required prerequisites for the upgrade to be run by executing the following command:
```
puresw upgrade start --mode check-only --version 6.6.8 Purity//FA
```
Status of an upgrade or an upgrade check can be seen by executing the following:
```
puresw list
```
If a check fails, Everpure Cloud Dedicated will output an error message. Below is an example of the error message you will receive if the service endpoint prerequisite mentioned above was not properly added or applied.
You can see further details about a failed upgrade check by running:
```
puresw upgrade show-step-detail
```

Starting the upgrade process

There are a two different modes to use when upgrading Purity to new version - Interactive and Semi-interactive upgrade mode. Note that both modes will execute pre-checks prior to execution and provide a warning if a pre-check fails.

Note: Upgrade process will check for existence of any conflicting tags on Everpure Cloud Dedicated resources. In case there are conflicting tags on resources, an upgrade pre-check error (CbsTagsCheck) will be thrown. In this case, please follow on this article for more details.

Important: one-click upgrade mode is deprecated and will be removed in future versions. Please don't use this mode anymore.

The below code samples show a upgrade of specific version of Purity (6.6.8). You will need to replace this variable with the specific version of Purity you are upgrading to.

Interactive upgrade mode - should be utilized when the customer wishes to watch the upgrade closely and provide responses at different stages of the upgrade for it to proceed.
```
puresw upgrade start --mode interactive --version 6.6.8 Purity//FA
```
Interactive mode progress can be queried by running the puresw list command. At a few certain points in the upgrade process, you will be prompted to execute a command in order to continue the upgrade process. An example of this is shown below:
Semi-interactive upgrade mode - it will pause in case of the upgrade checks fail and will require user interaction in order to proceed. When the upgrade is paused, semi-interactive mode acts like interactive mode unless the user retries a step, in which case the upgrade continues automatically if no checks fail.
```
puresw upgrade start --mode semi-interactive --version 6.6.8 Purity//FA
```
Semi-interactive mode progress can be queried by running the puresw list command.