SoftwareCentral · Phased Deployments

Phased Deployment Status

The status window shows where a rollout is, how each phase is doing, and lets you step in: approve a phase, skip it, start it now, or move on to the next one.

Phase list Statuses Approve & skip

1 Open the status window

On Software › Phased Deployments, click the text in the Status column (or the name, once a phase has started).

The link in an approval mail opens the Phased Deployments page with the status window of that phased deployment already open.

2 What the window shows

The status window: details at the top, the phase list, and phase 1 expanded with its success criteria, status, run time, target source, success, failed and pending devices, View detailed status and Continue to next phase
A rollout whose first phase has failed. The active phase is expanded; Continue to next phase is shown because it has failed.
PartWhat it tells you
Details (top)The software and its Type, the Install Collection it is deployed to (SCCM), the Phased Deployment name, Start at, Created by, Created at, the Total number of devices in all phases and the Total success so far.
PhasesOne row per phase: the number of target devices, the Status and when it last changed (Time). The active phase is expanded; click another to expand it.
Success criteriaWhat the phase must reach, or Always Continue when that installation-wide setting is on.
Run timeThe hour the phase may start, in UTC, or As soon as possible — plus the waiting hours after the previous phase, when set.
Target sourceThe collection or group of the phase, or Fixed list for hand-picked devices, followed by limited to ‘…’ when the phased deployment has Limit to.
Success / Failed / PendingHow many of the phase’s devices (or, for Intune, endpoints) have installed it, have failed, or have not reported yet, with a chart.
View detailed statusSCCM Opens the installation status of every device in the phase. Shown once the phase has started. For Intune the counts above come straight from Intune’s install status of the application.

3 Phase statuses

StatusWhat it means
Pending previous phaseAn earlier phase has not finished yet.
Waiting to startThis is the next phase; it starts at the next run within its time of day and weekday.
Waiting until date and timeThe phase waits the hours set in Wait at least … hours after the previous phase completed.
Pending approvalThe phase needs approval before it can start.
Approved - Waiting to startApproved; it starts at the next run within its time of day and weekday.
In progressThe phase is being started.
Pending complianceThe software has been deployed to the phase; the compliance check will tell when the success criteria is met.
CompletedThe success criteria was met, or someone marked the phase as completed.
SkippedSomeone skipped the phase, or it was empty and When a phase is empty is set to skip.
No target resourcesNo devices were found for the phase. It is tried again at every run.
Not enough licensesThe License Module does not allow more installations of the software.
Not enough devices to completeThe success criteria asks for more successful devices than the phase has.
FailedThe success criteria was not met within the days set in the notifications (or the maximum phase runtime), or the deployment could not be created.
PausedThe rollout was paused from Application Manager.
Package deletedThe software no longer exists.

4 Actions on a phase

The buttons appear in the expanded phase when they make sense for its status, and only if your security role has the matching permission.

ButtonWhat it doesShown when the phase is…
Approve this phaseGives the approval the phase needs. The phase does not start installing immediately: it starts at the next run of the evaluator within its time of day and weekday.Pending approval.
RetryRuns the phase again, for example after more licences were added. It does not fix problems with the deployment itself.Not enough licenses.
Continue to next phaseMarks the phase as completed, whatever its compliance, and continues with the next phase. The next phase still waits for its scheduled time and waiting hours. On the last phase the button is called Mark as completed.Pending compliance, failed, or not enough devices.
Run PhaseStarts the phase now instead of waiting for the next run of the evaluator. Its time of day and weekday still apply.Next to start, or approved.
Skip this phaseThe phase is skipped and the rollout continues with the next phase. A mail is sent to the notification addresses.Not started yet, pending approval, or without target resources.

5 From Application Manager

Phased deployments created by a Robopack Patch Flow can also be followed in Application Manager, next to the version they roll out.

There the buttons are called Go to next phase, Approve Phase and Skip Phase, and there is one more: Pause, which stops the rollout at the current phase. A paused phase is not continued by the evaluator. See Downloaded apps – Phase buttons.

6 Best practice

  • Approve only when the phase is waiting for it. Approve this phase is only offered while the phase is Pending approval and nobody has approved it yet, so one approval is enough.
  • Use Retry after you have added licences. Retry is only offered for the status Not enough licenses.
  • Use Continue to next phase only when you accept the result of the phase. The button is offered for Pending compliance, Failed and Not enough devices, and it does not wait for the success criteria.
  • Expect fewer buttons if your role has fewer permissions. Each button needs its own permission.

7 Troubleshooting

SymptomCauseWhat to do
Status: Not enough licenses The License Module does not allow more installations of the software. Add licences, then click Retry on the phase.
Status: No target resources No devices were found for the phase. If a Limit to collection or group is set and it has no members, the log says: “has no members, so no devices are targeted.” Check that the collection or group of the phase has members, and that the Limit to collection or group has members.
Status: Package deleted The software no longer exists. None of the buttons on the phase is offered for this status. Restore the software in SoftwareCentral.
Status: Not enough devices to complete The success criteria asks for more successful devices than the phase has. Click Continue to next phase if the result is acceptable.
Status: Failed. The mail says: “The deployment of name has failed at phase X of Y.” The success criteria was not met, or the deployment could not be created. For a deployment that could not be created the mail says: “Failed to create Phased Deployment name. View the log in SoftwareCentral for details.” Open the log for the details. Click Continue to next phase if the result is acceptable.