Skip to main content

Deployments - Conceptual

Deployment features

Deployment schedule

When you create a deployment, you can deploy immediately (Deploy now) or schedule a deployment (Schedule for later (future)).

  • With Deploy now, the deployment will take place immediately for all devices in the device group.

    • The deployment will be continuous, and be applied to newly added devices to the device group.

    • The Deployment state will be labeled as Active, unless the deployment is canceled by the user or the deployment has reached a limit. To learn more about limits, see Deployment limits.

  • With Schedule for later (future), the deployment will take place on the scheduled date and time.

    • Until the scheduled date and time is reached, the Deployment state will be labeled as Scheduled.

Deployment limits

When you create a deployment, you can optionally configure a deployment limit to create a boundary around the deployment. Specifically, the deployment will be limited based on a device count or timeframe.

When the deployment limit is reached, the Deployment state will be labeled as Completed.

  • With count limit, the deployment will be limited to specific devices within a device group. This option is useful for users who want to perform A / B testing on the release.

  • With a time limit, the deployment will only be valid for a specified time period. This option is useful for users who want to restrict the deployment for compliance reasons.

Deployment timeouts

When you create a deployment, you can optionally configure the maximum number of times that the updates will be re-tried on each device before the Device deployment state is labeled as Failed.

Until the deployment limit is reached, the Device deployment state will be labeled as Retrying.

Deployment force updates

When you create a deployment, you can optionally enable a forced deployment of a release on a device.

With this option enabled, the TrustEdge agent will install the update, even if the corresponding release has already been installed as part of a previous deployment.

Understand the Deployments table

When you create a deployment, an entry will be created in the Deployments table in Device Trust Manager > Software updates > Deployments.

The following table describes the components of the Deployments table:

1. Deployments

Column

Description

Deployment ID

Deployment state

This column displays the latest state of the deployment, which can be:

Device deployment result

This column displays the results of the deployments to the targeted device groups, which can be:

  • Successful

    • This result displays when the artifacts in the release have successfully deployed to the device group.

  • Failed

    • This result displays when all retries have failed, based on the configured Timeouts, or when updates have been rolled back.

  • Canceled

    • This result displays when a deployment has been aborted, specifically when an update to a device was not attempted.

Release

Device group

This column displays the associated device group, which determines the associated devices that will receive the deployment.

Start date

This column displays the date and time that the release was deployed.


Before you begin

To create a deployment, you must have the following assets available:

  • Division

  • Device group

  • Release