Cleaning up Failed Deployments

Before you re-attempt the deployment, you must clean the remnants of the failed deployment. Use Force undeploy to clean the remnants of the failed deployment. Force undeploy only affects the current version of the application; it does not affect any older versions that may be running.

After Force undeploy completes, the Runtime State reflects the state of the remaining versions (and thus may change from one of the failure states to the Running state after Force undeploy).

Once Force undeploy has completed, you have three choices:

  • Revert to the older running version of the application.
  • Re-deploy the same version (preferably after you have identified and resolved the cause of the failure).
  • Upgrade to a newer version and then deploy that newer version.

A) Revert to the Older Running Version of the Application

  1. Click Undeploy > Force undeploy to clean the remnants of the failed version.

    In the dialog box for dependent applications, unselect any other dependent application that the ActiveMatrix Administrator offers you to Force undeploy.

  2. In the General tab, choose the older version (that is, the version in a Running state) of the Application Template Version from the drop-down list. Note that a version already in the Preparing for Undeploy state cannot be changed back to the Running state. You must choose the version that is in the Running state.
  3. In the dialog that follows, click Save.

    Your application is flagged as Out of Sync.

  4. Click Deploy.

    This brings the application to In Sync and Running state. The application has been fully reverted to the previous version.

B) Re-deploy the Same Version

  1. Click Undeploy > Force undeploy to clean the remnants of the failed version.

    In the dialog box for dependent applications, unselect any other dependent application that the ActiveMatrix Administrator offers you to Force undeploy.

  2. Click Deploy to re-deploy the same version.

    If this attempt also fails, use Force undeploy before attempting to deploy (or downgrade) again.

C) Upgrade to a newer version and then deploy that newer version

  1. Click Undeploy > Force undeploy to clean the remnants of the failed version.

    In the dialog box for dependent applications, unselect any other dependent application that the ActiveMatrix Administrator offers you to Force undeploy.

  2. In the Generaltab, upload a new DAA.
  3. Upgrade the application to the newer version you uploaded.
  4. Click Deploy.
Next topic: Force Undeploy Behavior