Purity//FA Self-Service Upgrade via Array CLI

This section outlines how to perform a non-disruptive self-service Purity//FA upgrade on a connected array using the command-line interface.

Attention: Everpure Restricted Content - Do Not Distribute or Replicate

Note: Everpure recommends using Pure1 as the primary method to perform Purity//FA upgrades. However, for customers who prefer performing the upgrade directly on the array using the Purity//FA CLI, follow the below procedure.

This procedure includes health checks, bundle download, upgrade initiation, and post-check response handling.

Pre-requisite: The array must be able to either download the Purity//FA bundle from Everpure Cloud or have the bundle already present on the array. Phonehome must be enabled and working to allow the array to download the Purity//FA bundle from the cloud.

This process is part of the Everpure broader goal to simplify lifecycle operations through self-service, array-CLI upgrades. As product capabilities evolve, this document should be used in conjunction with the latest Everpure FlashArray Admin and CLI Reference Guide before starting to ensure you're using the most up-to-date commands, endpoints, and workflows.

Using this procedure, customers can ensure secure, reliable, and efficient upgrades.

Remember: Always check the latest Everpure FlashArray Admin and CLI Reference Guide before starting. New CLI enhancements may improve the process or add additional functionality.

Determine the available Purity versions:

Retrieve a list of Purity versions available for upgrade based on the current version and controller model using the following command:

puresw list --catalog

Example:

user@array> puresw list --catalog
Name        Release Family  Version     Upgrade Path         Details
Purity//FA  6.10            6.10.2      6.8.7->6.10.2        -
Purity//FA  6.10            6.10.1      6.8.7->6.10.1        -
Purity//FA  6.10            6.10.0      6.8.7->6.10.0        -

Run the upgrade checks:

Before upgrading, confirm there are no issues by running upgrade checks for your target Purity version (in this example: Purity//FA 6.8.2):
```
puresw check start Purity//FA --version 6.8.2
```

Check the status of the upgrade checks:

puresw check list

Example:

user@array> puresw check list
Software Name  Upgrade Path  Check Start Time         Check End Time  Status   Details
Purity//FA     6.8.2->6.8.9  2025-12-15 10:15:41 PST  -               running  Running checks

If any checks fail, you will see the following:

user@array> puresw check list
Software Name  Upgrade Path         Check Start Time         Check End Time           Status  Details
Purity//FA     6.8.7->6.8.9->6.9.2  2025-12-15 08:55:42 PST  2025-12-15 09:06:25 PST  failed  Finished checks

To get more details into the failures, use the following command:

user@array> puresw check show-detail

Take the necessary steps to resolve them. If you need assistance, contact Everpure Technical Services.

Download the Purity software:

If the upgrade checks pass, initiate the download of the Purity software bundle from Pure Cloud:

puresw download --version <purity_version> Purity//FA

Example:

user@array> puresw download --version 6.8.9 Purity//FA
Name        Version  Status  Progress  Details
Purity//FA  6.8.9    new     -         Pure1 cloud is building upgrade package. This will take up to 5 minutes to complete.

Check the status of the Purity bundle download:

puresw list

Example:

user@array> puresw list
Name        Version  Status       Progress  Details
Purity//FA  6.9.2    downloading  63.37%    Software is downloading

Note: The bundle can be several gigabytes and may take time to download.

Initiate the upgrade:
1. Once the download is complete, proceed with the Purity upgrade (in this example, the target software version is 6.8.2):
  There are two upgrade modes that can be used:
  - Semi-Interactive: The upgrade proceeds automatically until completion or until an upgrade check failure occurs, at which point manual intervention is required.
  - Interactive: Manual approval required for key steps.
```
puresw upgrade start --mode interactive --version 6.8.2 Purity//FA
```
2. Check the status and the progress of the Purity upgrade:
```
puresw upgrade list
```
  Example Output:
```
user@array> puresw upgrade list
Software Name  Plan          Mode         Start Time               End Time  Current Step ID                       Status      Progress  Details
Purity//FA     6.8.2->6.8.9  interactive  2025-12-15 10:58:35 PST  -         8f5e4960-2cd1-4352-873f-e4086d12c9a0  installing  0.00%     Running pre-upgrade check, 91 checks in total. For more information, please run "puresw upgrade show-step" or "puresw upgrade show-step-detail".
```
  Note: The response will include IDs that will be used in the following steps. Allow a few minutes before the command provides the Current Step ID.

Respond to the upgrade checks:

In interactive mode (or semi-interactive where an upgrade check failed) before each controller reboots, you will need to take an action. The response from the above command will display the upgrade check results and will require you to take one of three possible actions:

user@array> puresw upgrade list
Software Name  Plan          Mode         Start Time               End Time  Current Step ID                       Status  Progress  Details
Purity//FA     6.8.2->6.8.9  interactive  2025-12-15 10:58:35 PST  -         8f5e4960-2cd1-4352-873f-e4086d12c9a0  paused  8.99%     Upgrade has been paused since Mon, 15 Dec 2025 11:06:50. Finished pre-upgrade check, 91 checks in total, 1 failed (HardwareCheck).

Run command "puresw upgrade show-step-detail" for more information.

To proceed with the upgrade, either:
1) Continue the upgrade - Run "puresw upgrade continue 8f5e4960-2cd1-4352-873f-e4086d12c9a0 --override <CheckName>"
2) Retry checks - Run "puresw upgrade retry 8f5e4960-2cd1-4352-873f-e4086d12c9a0 [--override <CheckName>]"
3) Abort the upgrade - Run "puresw upgrade abort 8f5e4960-2cd1-4352-873f-e4086d12c9a0"

The secondary controller (ct1) will be upgraded to 6.8.9 after continuing the upgrade

Continue: proceed with rebooting the controller (or if an upgrade check failed but you have determined things are safe and you would like to override the check and proceed with the upgrade).
Abort: Cancel the ongoing upgrade.
Retry: Run the upgrade checks again.

These steps can be taken as per the following example command:

puresw upgrade continue --step-id 8f5e4960-2cd1-4352-873f-e4086d12c9a0

To retrieve more detailed step information:

puresw upgrade show-step-detail

Monitor the upgrade to completion:
Continue monitoring the upgrade progress using the following command:
```
puresw upgrade list
```
Use puresw upgrade continue as needed to advance through the upgrade.

Once both controllers complete their reboots, the upgrade will finalize.

eccinxstc76