Upgrading to is only supported from or later. If you are running a version older than, you must first upgrade to or later before upgrading to For customers running on a release earlier than and needing to upgrade to or higher, please contact Delphix support to help coordinate this upgrade.

If you are upgrading from a version < before you begin the upgrade process, contact Delphix Support to perform some pre-checks.

Once you have uploaded an upgrade version, verified the upgrade, optionally reviewed the warnings in the Impact of Upgrade section, scheduled downtime pertaining to the type of upgrade you are performing, you can apply the upgrade.

  1. Login to the Delphix Setup application.
  2. In the Upgrade Images panel, click View.
  3. On the left-hand side, select the version to which you will be upgrading.
  4. Click Apply Upgrade to initiate the upgrade process.
    • For upgrades on engines already running and greater, the user can choose the type of upgrade they want to perform.

The upgrade will run in the background. You can view the progress of the upgrade in the Action sidebar. Only the current system admin user can view the progress.

The status of the upgrade will be visible on the screen - if the upgrade is successful, the page will be redirected to the login view.

If an Apply Now upgrade fails, the appliance will automatically rollback to the version running prior to the upgrade.

The version page will show the new version in an UPLOADED state and the Action sidebar will show that a rollback was performed. If automatic rollback was disabled through the CLI (not advised), you will have to contact support to proceed further, since you may not even be able to log in to the Delphix Engine.

Failure to Quiesce a Dataset

If Upgrade has failed to quiesce a dataset, it will pause and you will see the banner at the top of the Upgrade page as shown below:

While the upgrade is paused, datasets that have been quiesced are unavailable until you either roll back or continue the upgrade.

To review the list of failures, open the Report tab:

The datasets listed in the report were identified as having issues which prevented them from being quiesced, and may not be available after the upgrade is complete. Review the messages in the report and take the suggested corrective actions.

If you think that the errors may be the result of transient failures, you can click Retry Upgrade to try again. Otherwise, it is recommended that you manually quiesce datasets that are still running. To do so:

  1. Use a different browser or use an incognito window to go to the Delphix Management application.
  2. Either resolve issues such as a wrong password or stop the dataset using Force Disable.
  3. In the original browser or window, click Retry Upgrade to try applying the upgrade again.

If you want to ignore the failures to quiesce datasets and proceed with the upgrade:

  1. Click Continue Upgrade. This will attempt to quiesce all datasets which have not yet been quiesced, but will not pause on failures.

    This may result in datasets remaining unavailable after the upgrade is complete and the Delphix Engine restarts, since the underlying storage that backs the datasets will be unreachable during the upgrade. This may cause the databases or applications to failover or transition to a failure state, thus requiring administrator intervention to recover.

  2. Review the messages in the report and take the suggested corrective actions.
  3. If any of the listed datasets are critical, and you are unable to resolve the configuration errors in the report, you can Rollback the upgrade. If you choose Rollback, all changes will be reversed, the upgrade will end, and the Delphix Engine will be in the state it was in before you started the upgrade.

Related Topics