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 1: In the default distribution status dashlet, if you retain the Group Chart Data By as Distribution and select the Distribution, Install and Launch statuses as Success in each of the filter tabs, then only those deployments for which the bundle is successfully distributed, installed and launched are displayed in the Status Details panel. The dashlet chart will display the status based on the Distribution action set selected in the Group Chart Data By section.
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.
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. |
Filter |
Description |
---|---|
Distributed Version |
View deployments based on any of the following versions of the bundle.
|
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:
|
Filter |
Description |
---|---|
Installed Version |
View deployments based on any of the following versions of the bundle:
|
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:
|
Installing Parent Bundle |
View deployments based on the parent bundle that last installed the bundle. Click Add or Remove to specify the parent bundle. |
Filter |
Description |
---|---|
Launched Version |
View deployments based on any of the following versions of the bundle:
|
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:
|
Launching Parent Bundle |
View deployments based on the parent bundle that last launched the bundle. Click Add or Remove to specify the bundles. |
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 |
Indicates whether the bundle is blocked from executing on the device. |
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:
|
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.