Deploying Packages

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

Create 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 Deployment 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 Deployment type column specifies whether the package is a Custom package or a PDQ-provided package.
• 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 page, showing all devices under that deployment.
• In the Deployment statuses 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 page, filtered to show the device(s) associated with that status. Queued deployments are waiting to run, In progress deployments are running, Complete deployments succeeded, Failed deployments did not succeed, and Canceled deployments were stopped before finishing.
• The Avg. elapsed time column shows the average time it took for the package to finish deploying.
• 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.

Deployment instance page

On the 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 the status in the Deployment status column, or select View output in the Output log column, to display the output log for that deployment. The output log shows each step of the package.

  

• 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 last failed step when redeploying failed deployments. This will start the redeployment from the step that failed, skipping steps that already successfully completed.  
  • If you edit a package, you can no longer select Redeploy from last failed step for that package's prior deployments, as the step order may have changed.