Purity//FA Self-Service Upgrade via Array CLI on a Darksite Array

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

Attention: Everpure Restricted Content - Do Not Distribute or Replicate

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 a local server or have the bundle already present on the array on a local directory via a mounted USB drive.

This process is part of the Everpure broader goal to simplify lifecycle operations through self-service, API-driven 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 API version, endpoints, and workflows.

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

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.

Note: This utility currently cannot process bundles larger than the array's /reset partition. If the bundle gets stuck in a downloading or failed state, please check if the /reset partition has enough space for the entire bundle. If it does not, you may need to break up the upgrade into 1 hop per bundle and do them individually.
Download the Purity bundle:
1. Contact Everpure Technical Services to obtain the Purity bundle and copy it to a local server that the array can access via supported file transfer protocols (e.g., http, https, ftp, or ftps). Then, use puresw to download the bundle from the server to the array (e.g., https://<server>/upgrade_bundle.sh).
  Important:
  
  Make sure to replace upgrade_bundle.sh with the actual name of the Purity bundle.
  
  For USB usage, contact Everpure Technical Services to help transfer the bundle from the USB drive to the array.
  Example of Purity bundle download from a local server to the array:
```
puresw bundle download "https://local/upgrade_bundle.sh"
```
```
pureuser@array> puresw bundle download "https://local/upgrade_bundle.sh"
Status       Download Progress  Details                                 Source
downloading  0.00%              Software Bundle is queued for download  https://local/upgrade_bundle.sh
```
2. Check the status of the Purity bundle download:
```
puresw bundle list
```
```
pureuser@array> puresw bundle list
Status  Download Progress  Details                                  Source
ready   100.00%            Successfully downloaded software bundle  https://local/upgrade_bundle.sh
```
  Note: The bundle can be several gigabytes and may take time to download.

Run the upgrade checks:

Before upgrading, confirm there are no issues by running pre-upgrade checks for your target Purity version (in this example: Purity//FA 6.7.7):

puresw check start Purity//FA --version 6.7.7

pureuser@array> puresw check start Purity//FA --version 6.7.7
Software Name  Upgrade Path   Check Start Time         Check End Time  Status  Details
Purity//FA     6.5.13->6.7.7  2026-02-11 12:49:59 MST  -               queued  Initializing software check task

Check the status of the upgrade checks using the following command:

puresw check list

pureuser@array> puresw check list
Software Name  Upgrade Path   Check Start Time         Check End Time  Status   Details
Purity//FA     6.5.13->6.7.7  2026-02-11 12:49:59 MST  -               running  Running checks

If any checks fail, take the necessary steps to resolve them or consider upgrading to a different version:

puresw check show-detail --name Purity//FA --version 6.7.7

Initiate the upgrade:

Once the download is complete, proceed with the Purity upgrade using the following command:

puresw upgrade start --mode interactive --version 6.7.7 Purity//FA

pureuser@array> puresw upgrade start --mode interactive --version 6.7.7 Purity//FA
Software Name  Plan           Mode         Start Time               End Time  Current Step ID  Status      Progress  Details
Purity//FA     6.5.13->6.7.7  interactive  2026-02-11 12:56:16 MST  -         -                downloaded  100.00%   Software downloaded

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.

Check the status and the progress of the Purity upgrade:

puresw upgrade list

pureuser@array> puresw upgrade list
Software Name  Plan           Mode         Start Time               End Time  Current Step ID                       Status  Progress  Details
Purity//FA     6.5.13->6.7.7  interactive  2026-02-11 12:56:16 MST  -         2c364560-b88f-4e08-be94-7c3ea92bbf90  paused  8.99%     Upgrade has been paused since Wed, 11 Feb 2026 13:02:31. Finished pre-upgrade check, 97 checks in total, all passed. 
To proceed with the upgrade, either: 
1) Continue the upgrade - Run "puresw upgrade continue 2c364560-b88f-4e08-be94-7c3ea92bbf90" 
2) Retry checks - Run "puresw upgrade retry 2c364560-b88f-4e08-be94-7c3ea92bbf90"
3) Abort the upgrade - Run "puresw upgrade abort 2c364560-b88f-4e08-be94-7c3ea92bbf90"  
The secondary controller (ct0) will be upgraded to 6.7.7 after continuing the upgrade

Important: The response will include IDs that will be used in the following steps.

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:
- 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 with the following example:
```
puresw upgrade continue 2c364560-b88f-4e08-be94-7c3ea92bbf90
```
```
pureuser@array> puresw upgrade continue 2c364560-b88f-4e08-be94-7c3ea92bbf90
Software Name  Plan           Mode         Start Time               End Time  Current Step ID                       Status      Progress  Details
Purity//FA     6.5.13->6.7.7  interactive  2026-02-11 12:56:16 MST  -         2c364560-b88f-4e08-be94-7c3ea92bbf90  installing  8.99%     Continued installation
```
To retrieve more detailed step information, use the following command:
```
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.

pureuser@array> puresw upgrade list
Software Name  Plan           Mode         Start Time               End Time                 Current Step ID                       Status    Progress  Details
Purity//FA     6.5.13->6.7.7  interactive  2026-02-11 12:56:16 MST  2026-02-11 13:41:08 MST  24dd306f-2033-4d43-abf0-fe3abfd96fd3  finished  100.00%   Upgrade stopped. 1/1 hops completed.

eccinxstc76