Deploying Packages

To create a new one-time deployment, click the Deploy button at the top right of the Devices or Deployments pages.

Creating a New Deployment

The Create deployment popup allows you to select the packages you wish to deploy and the targets to deploy to. 

Type the name of a package in the left search field and select the package to be added to the deployment.  The latest version of the chosen package will be selected by default. Select the dropdown in the Version column to choose a different version of that package.  To add multiple packages to a deployment, search for another package and select it to add it to the deployment.  To remove a package from the deployment, click the trash can icon for that package in the list. To specify a target for the package deployment, type the name of the device or group in the right search field.  Multiple targets may be added by searching for additional groups and devices.

Deployment Status

To view the results of any deployment, select Deployments from the left navigation bar. The Deployments page will display a list of all deployments created in the last 90 days across your entire organization. 

• The Last Deployment column displays the time and date the deployment last run.
• The Package column displays the name of the package that was deployed and the version of the package. Historical version numbers are retained for PDQ-provided packages. For custom packages, updating the version number will update it on all past deployments. 
• The Deployed to column shows the total number of devices. If only one device is deployed, its name is displayed, and selecting it directs you to the device information page. Selecting the total number directs you to the deployment instance details page, showing all devices under that deployment.
• In the Deployment Status column, status icons are displayed in the following order: Queued, In progress, Complete, Failed, and Canceled. Each icon shows the total number of devices in that status. Selecting an icon opens the deployment instance details page, filtered to show the device(s) associated with that status. The statuses represent the following: queued deployments display Queued, running deployments display In progress, successful deployments display Complete, failed deployments display Failed, and canceled deployments display Canceled.
• The Deployed by column displays the name of the user or Automation that initiated the deployment. Select the name of the Automation to open that Automation's page.

In deployment instance page, you can view all devices in a deployment along with their status and logs, and perform actions such as redeploy and cancel.

• Select Complete or Failed in the Deployment Status column to display the Output Log for that deployment.
• Return codes will be displayed in the Details column. 0 is the default code for a successful deployment. 
• In the Actions button, select Cancel to stop a running deployment, or Redeploy to retry a failed deployment.
  • You can optionally Redeploy from failed step when re-deploying failed deployments. This will start the redeployment from the step that failed, skipping steps that already successfully completed.
    • Note: if you edit a package, you can no longer select Redeploy from failed step for that package's prior deployments, as the step order may have changed.

Note: If a custom package is edited while queued for deployment to an offline device, the device will still receive the original version of the package when it comes back online.