13.3 Bundle Deployment Status

Bundle deployment status is a set of dashlets that provide a summary of the bundle status for the distribute, install and launch action sets across both user and device assignments. The Dashboard feature provides default views for each of these action sets. However, you can configure and view each of these action sets within a single dashlet. The status of the deployment status dashlets is gathered when the devices reports the bundle status information to the server. Therefore, when you immediately access one of the deployment status dashlets, after assigning a bundle to a device or a user, no data will be displayed for that version of the bundle, till the bundle is distributed, installed or launched on the device and the device reports this information back to the server. If you want this information to be reported back to the server immediately, click the Retrieve Bundle Status quick task.

The bundle status information for the distribute, install and launch action set is categorized as:

  • Success: Indicates that the contents of the bundle are successfully distributed, installed or launched on the device.

  • Failure: Indicates that the contents of the bundle have failed to distribute, install or launch on the device.

  • Partial Success: Indicates that the distribute, install or launch of the bundle is partially successful if the bundle is executed, even though one or more of the bundle actions that was set to Continue on Failure have failed.

  • Unknown: Indicates that the distribute, install or launch status of the bundle could not be determined by the ZENworks Server. For example, the status will be unknown if the agent did not contact the ZENworks Server after the bundle is assigned to the device. For more information on the scenarios in which the deployment status will be Unknown, see Unknown Status Scenarios.

NOTE:The Launch status will not be displayed for mobile bundles in the Launch Status dashlet, as no Launch action set exists for mobile bundles.

To determine how best to configure the dashlet for your organization’s needs, you can ask questions such as:

  • How many instances of bundle failures exist and need to be addressed?

  • How many instances of the bundle assignment made to the device are currently not active but the bundle is still installed on the device?

  • How many devices do not have the latest published version of the bundle deployed on them?

  • What is the time period for which you want to view the bundles that have failed to deploy?

Group the data displayed: You can group data to be displayed in the chart based on the action set, that is, distribute, install, or launch. For example, in the Bundle Distribution Status dashlet, you can change the Group Chart Data By value to Install, to view the install status of the bundle in the dashlet chart. However, by changing the Group Chart Data By value, the columns in the Status panel will not be updated. You will have to manually select the relevant columns associated with the Group Chart Data By value.

The dashlet chart will display the instances of success, failure and other statuses for the selected action set. Therefore, for a given bundle-device combination, multiple records might be displayed in the chart.

Filter the data displayed: To filter the data that the dashlet displays, expand and modify any of the sections in the Filter panel. Along with general filters, this panel also includes tabs that contain filters specific to each action set (Distribute, Install, and Launch).

The default dashlets for each action set displays data based on the latest published version of the bundle. If you update the Group Chart Data By field to another action set in any of the default dashlets, to ensure accuracy of data, select the appropriate bundle version and other values in the corresponding filter of the updated action set. For example, in the Bundle Distribution Status dashlet, if you change the Group Chart Data By value to Install, select the Installed Version as Published (Latest Version) in the Install tab, which will enable you to view the install status of the current published version of the bundle.

If you apply filters in each of the action set tabs, the deployments that meet the conditions selected in each tab, are displayed.

For example:

Scenario 2: Consider you have 2 versions of a bundle of which version 2 is the published version of the bundle. In the default distribution status dashlet, you modify the Group Chart Data By to Install. In the filters, you select the Distribution Status in the Distribute filter as success, specify the Install Version in the Install filter as 1 and Install Status in the Install filter as Success. The Status Details panel will display those deployments for which the distribution status was successful for the latest published version of the bundle and the install status was successful for version 1of the bundle. The dashlet chart will display the status based on the Install action set selected in the Group Chart Data By section.

NOTE:You need to have relevant device rights to view deployments in this dashlet, even if the bundle is a user assigned bundle. The results are displayed based on the rights that you have on devices. Thus 2 administrators might see different sets of devices based on their rights.

General

The filters in this tab include Device Folders, Device Groups, Device Type, Platform, Operating System and Agent Version. Additionally, this tab also includes the following filters:

Filter

Description

Device Folders

View deployments based on the device folder to which the devices belong.

Device Groups

View deployments based on the device group to which the devices belong.

Device Type

View deployments based on whether the device is a server, workstation or a mobile device.

Operating System

View deployments based on the operating system version on the device.

Platform

View deployments based on the operating system on the device.

Agent Version

View deployments based on the agent version installed on the device.

Status Processed Time

View deployments based on the time at which the bundle status was last processed by the ZENworks Server.

Assignment Source

View deployments based on user or device assignments.

If device is selected, you can select Yes in the Assignment is effective for Device field to view only those deployments where the assignment is still active. For example: if a bundle is disabled, even though the assignment for the device exists, the assignment is not effective. Therefore, if you select Yes in the Assignment is effective for device field, then no data is displayed.

Distribute

Filter

Description

Distributed Version

View deployments based on any of the following versions of the bundle.

  • All lets you view the distribution status for all the versions of the bundle

  • Published (Latest Version) lets you view the distribution status of the current published version of the bundle. This is the default value.

  • Published (Older Version) lets you view the distribution status of the older versions of the bundle.

  • Sandbox version lets you view the deployments of the sandbox version of the bundle.

  • Custom lets you view the deployment status of a specified version of the bundle. You can specify a comma separated list of versions. The Sandbox version can be represented with value -1.

  • Unknown lets you view the status for those deployments whose bundle version could not be determined. If this filter is selected, then the Distributed Version with empty values are displayed in the Status Details panel.

Distribution Time

View deployments based on the date or time at which the action to distribute was performed on the device.

Distribution Status

View deployments based on the following statuses:

  • Success

  • Partial Success

  • Failure

  • Unknown

Install

Filter

Description

Installed Version

View deployments based on any of the following versions of the bundle:

  • All lets you view the install status for all the versions of the bundle.

  • Published (Latest Version) lets you view the install status of the current published version of the bundle. This is the default value.

  • Published (Older Version) lets you view the install status of the older versions of the bundle.

  • Sandbox version lets you view the deployments of the sandbox version of the bundle.

  • Custom lets you view the deployment status of a specified version of the bundle. You can specify a comma separated list of versions. The Sandbox version can be represented with value -1.

  • Unknown lets you view the status for those deployments whose bundle version could not be determined by the server. If this filter is selected, then the Installed Version with empty values are displayed in the Status Details panel.

Install Time

View deployments based on the date or time at which the action to install the bundle was performed on the device.

Install Status

View deployments based on the following statuses:

  • Success

  • Partial Success

  • Failure

  • Unknown

Installing Parent Bundle

View deployments based on the parent bundle that last installed the bundle. Click Add or Remove to specify the parent bundle.

Launch

Filter

Description

Launched Version

View deployments based on any of the following versions of the bundle:

  • All lets you view the launch status for all the versions of the bundle

  • Published (Latest Version) lets you view the launch status of the current published version of the bundle. This is the default value.

  • Published (Older Version) lets you view the launch status of the older versions of the bundle.

  • Sandbox version lets you view the deployments of the sandbox version of the bundle.

  • Custom lets you view the deployment status of a specified version of the bundle. You can specify a comma separated list of versions. The Sandbox version can be represented with value -1.

  • Unknown lets you view the status for those deployments whose bundle version could not be determined by the server. If this filter is selected, then the Launch Version with empty values are displayed in the Status Details panel.

Launch Time

View deployments based on the date or time at which the action to launch the bundle was performed on the device.

Launch Status

View deployments based on the following statuses:

  • Success

  • Partial Success

  • Failure

  • Unknown

Launching Parent Bundle

View deployments based on the parent bundle that last launched the bundle. Click Add or Remove to specify the bundles.

Unknown Status Scenarios

The scenarios in which the deployment status will be displayed as Unknown are:

Scenario 1: When you access one of the Deployment Status dashlets, immediately after assigning a bundle to a device or user, no data will be displayed till the device reports the bundle status information. In the meantime, if you click the Refresh Dashlet icon, the status of the record will change to Unknown. However, you can view this record only if you change the bundle version filter from the default Published (Latest Version) to All or Unknown.

Scenario 2: A bundle is assigned to a Device Group that contains three devices. The bundle is scheduled to deploy at a specific time. However, since all three devices are in different time zones, the deployment status is rolled back for Device 1. The deployment status dashlet will display only one record for the latest published version of the bundle. If you modify the bundle version filter to All, then all three records will be displayed and the status for Device 2 and Device 3 will be Unknown till the deployment status information is reported back by these devices.

The Status Details panel: The Status Details panel displays the devices that meet the criteria that you defined in the Filter panel. You can also use the search option to further filter the displayed records, based on the device name, user name, distribution message, install message, and launch message. However, as some of these columns, such as distribution message and install message, might be hidden based on the selected dashlet type, no records will be displayed if a search is performed on the columns that are not visible in the Status Details panel.

The Status Details panel displays only those columns that are relevant to the dashlet and all other columns are hidden in the default view. For example, in the default Bundle Distribution Status dashlet, the columns relevant to distribution status are displayed. To view the install and launch status related columns within this dashlet, you can click the hamburger menu appearing in the right corner Status Details panel and select the relevant columns.

Column Name

Description

Device

Indicates the name of the device.

Device Folder Path

The device folder to which the device belongs, is displayed.

Operating System

Indicates the operating system version on the device.

Agent Version

Indicates the ZENworks agent version installed on the device.

User Name

Indicates the name of the user, if the user has logged-in to the device at the time the bundle was executed. The user name is displayed only when the bundle is assigned to a user.

Status Processed Time

View deployments based on the time at which the bundle status was last processed by the ZENworks Server.

Distributed Version

Indicates the distributed version of the bundle.

Distribution Status

Indicates the distribution status for a specific distributed version of the bundle. The statuses can be Success, Partial Success, Failure or Unknown.

Distribution Time

Indicates the date or time at which the action to distribute was performed.

Distribution Message

Indicates the reason (if any) for failed or partially distributed bundles. This message is also displayed on the successful distribution of a mobile bundle.

Distribution Duration

Indicates the time taken to distribute the bundle on the device.

Installed Version

Indicates the installed version of the bundle.

Install Status

Indicates the installation status for the specific installed version of the bundle. The statuses can be Success, Partial Success, Failure or Unknown.

Installation Time

Indicates the date or time at which the action to distribute was performed.

Install Message

Indicates the reason (if any) for failed or partially installed bundles. This message is also displayed on the successful installation of a mobile bundle.

Installing Parent

Indicates the parent bundle (if any) to which the bundle belongs that last installed the bundle.

Install Duration

Indicates the time taken to install the bundle on the device.

Launched Version

Indicates the launch version of the bundle.

Launch Status

Indicates the launch status for the specific launch version of the bundle. The statuses can be Success, Partial Success, Failure or Unknown.

Launch Time

Indicates the date or time at which the action to launch was performed.

Launch Message

Indicates the reason (if any) for failed or partially launched bundles. This message is also displayed on the successful launch of a mobile bundle.

Launching Parent

Indicates the parent bundle (if any) to which the bundle belongs that last launched the bundle.

Launch Duration

Indicates the time taken to launch the bundle on the device.

Device Type

Indicates the type of device, that is, server, workstation or mobile devices.

Platform

Indicates the operating system on the device.

Blocked Assignment

Indicates whether the bundle is blocked from executing on the device. The values displayed can be Device, User, or an empty value.

Assignment Source

Indicates whether the assignment is a user or device assignment.

Effective Assignment Exists

Indicates whether the assignment is an active and an effective assignment. For example: If a bundle that is deployed to the device is disabled, the column will display No as the value, as the assignment is currently not effective on the device.

For information about other actions and options you have in the Status Details panel, see the following table:

NOTE:After implementing the quick tasks, it is recommended that you click the Refresh Dashlet icon to view the updated data in the dashlet grid.

Task

Description

Install Bundle

This quick task installs the bundle immediately on one or more devices. For more information, see Bundle Quick Tasks.

Uninstall Bundle

Uninstalls the bundle immediately on one or more devices. For more information, see Bundle Quick Tasks.

Launch Bundle

Launches the bundle immediately on one or more devices. For more information, see Bundle Quick Tasks.

Block Assignment

Blocks the bundle assignment from executing on the device. For a blocked bundle, the Deployment Status dashlet will display the last known status of the bundle and the Assignment Exists column will display ‘No’ as the value. If the blocked bundle uninstalls from the device, then the Deployment Status will change to Unknown, which can be viewed only if the Bundle Version filter is selected as Unknown or All.

Unblock Assignment

Unblocks an already blocked bundle on the device.

Refresh Device

Refreshes the device so that any pending actions can immediately be initiated on the device. This quick task updates all information (bundle, policy, configuration settings, registration, and so forth) on the selected devices.

Retrieve Bundle Status

Obtains the latest bundle status from the selected devices and rolls up this information to the server. You can select from one of the following options:

  • Differential scan: obtains the change in bundle status for all the bundles on the selected device since the last complete scan.

  • Complete scan: runs a full scan to obtain the current status of all the bundles on the selected device.

NOTE:A message displayed in the collapsed and expanded views of the bundle dashlets, indicates the time at which the bundle status was last computed by the ZENworks server. There might be discrepancies with the time displayed in the message in scenarios where the device has rolled back status information before bundle status computation on the server.

To resolve these discrepancies and to view the latest bundle status for the selected bundle, click the Refresh Dashlet icon on any one of the dashlets of the selected bundle.

Also, if the bundle dashlets are configured to read data from the Vertica database, then the data displayed in the bundle dashlets might not be the latest, as data from the existing RDBMS syncs with the Vertica database at an interval of 10 minutes. To view the latest data, click the Refresh Dashlet icon, wait for 10 minutes and click the Refresh Dashlet icon again.