8.6 Viewing Bundle Information

When you create a bundle, the bundle is listed on the Bundles page of the ZENworks Control Center.

8.6.1 Understanding the Bundle Information

The Bundles page displays the following information:

  • Status: Provides a quick indication of the message logging and enforcement status of the bundle. The status icons are:

    • Normal or Enforced Status icon - No warning or error messages;
    • Warning or Enforced Status icon - Warning messages;
    • Error or Enforced Status icon - Error messages;
  • Name: Displays the object’s (bundle, bundle group, or the bundle folder) name. Click the name to view or edit the object’s information.

  • Type: Displays the type of object. For example, an iOS bundle.

  • Category: Displays the bundle category selected during the creation of the bundle. For example, App Store App.

  • Enabled: Displays whether the bundle is enabled to be deployed on a device or not. The possible values are Yes and No.

  • Version: Displays the latest published version of the bundle. However, if the bundle is a sandbox-only bundle, it displays Sandbox.

  • Has Sandbox: Displays whether the bundle has a sandbox or not.

8.6.2 Bundle Summary Page

The Summary page of the bundle displays the general information, bundle status, generated messages, and scheduled events for the specified version of the bundle.This page can be viewed when you click a specific bundle on the Bundles page.

Displayed Version

Lists all existing versions of the bundle and the latest version of the bundle is selected by default. Select the version of the bundle whose details you want to view or edit. If a Sandbox version of the bundle exists, this option displays the Sandbox version. However, if a Sandbox version of the bundle does not exist, this option displays the published version.

General

The General panel provides a summary of the bundle’s general settings.

  • Bundle Type: Displays the type of bundle.

  • Volume Purchase Program Account: Displays the Apple VPP account, if the bundle is an Apple VPP bundle.

  • Version: Displays the bundle’s version number.

  • Enabled: Displays whether or not the bundle can be deployed to iOS devices. If a bundle is enabled, it can be deployed to iOS devices. When you disable a bundle, the app is uninstalled from the device. However, if the Retain app on the device if the bundle is deleted or unassigned, or if the device is removed from the zone setting is enabled as part of the app configuration settings, then this bundle will not be uninstalled from the device. If the bundle is disabled and if the app is installed on the device, then the app will be uninstalled from the device. You can click Enable to allow it to be deployed.

  • Number of Errors not Acknowledged: An error is anything that causes the deployment or installation of the bundle to fail. The number displayed indicates the number of unacknowledged warnings, which are errors that you have not specifically marked as acknowledged. Unacknowledged errors are displayed in the Message Log section.

  • Number of Warnings not Acknowledged: A warning is anything that does not cause the deployment or installation of the bundle to fail, but indicates minor problems with the bundle. The number displayed indicates the number of unacknowledged warnings, which include warnings that you have not specifically marked as acknowledged. Unacknowledged warnings are displayed in the Message Log section.

  • GUID: Lists the bundle’s GUID (global unique identifier), a randomly generated string that provides a unique identifier for the bundle. You cannot edit the GUID.

  • Display Name: Displays the bundle’s name as it appears in ZENworks Control Center (ZCC). Click Edit to change the name. Changing the name does not cause the bundle to be redeployed.

  • Description: Displays the bundle’s description, if one was provided when the bundle was created. The description appears in ZCC. Click Edit to change the description.

  • Administrator Notes: Displays any information that has been added specifically for ZENworks administrators to view. The notes are displayed only in ZCC.

    Click Edit to change the notes, add notes, or delete notes. Editing the note does not create a sandbox. You can edit the administrator notes for any version of a bundle.

Bundle Status

The Bundle Status panel displays a summary of the bundle’s assignment and deployment status. The User row displays the status of the bundle through assignment to users; the Device row displays the status of the bundle through assignment to devices. A bundle can be directly assigned or assigned through membership in a folder or group. You can click an underlined link in any column to view the status of the individual users and devices to which the bundle is assigned or export the data to a CSV file. To export a bundle, select the bundle and click Actions > Export.

A bundle’s status is calculated using the status of many events. For example, a device might indicate that the bundle failed when the distribution was successful, but the installation failed. The numbers in the various columns represent an overall view of the bundle’s status.

The bundle status information is separated into the following groups listed below, which are independent of each other.

Assignment Status

The following status information is available:

Targeted: Displays the number of users and devices to which the bundle is assigned.

Devices Effective: Displays the number of devices on which the bundle is effective through a user or device assignment. A bundle is effective for a device if the device meets the system requirements of the bundle. The number of users or devices in the Devices Effective column might be less than the number in the Targeted column because the bundle might be assigned to a device that does not meet the bundle’s system requirements.

Devices Not Effective: Displays the number of devices on which the bundle is not effective through a user or device assignment. If a bundle is not effective for the device, it means that the device does not meet the bundle’s system requirements.

Pending: The pending status for the device displays the number of devices on which the bundle is not yet distributed or installed, such as devices that are switched off. Click the underlined link to display the list of such devices.

Blocked/Targeted: Displays the number of users or devices on which the bundle is blocked from being used, versus the targeted number of users or devices. Click the underlined link to display the list of such users or devices.

Deployment Status

The following status information is available:

Devices Pending: Displays the number of devices on which the bundle is pending to be deployed. A bundle’s status is pending if the bundle has met the device’s system requirements, but the bundle has not been distributed to the device or the bundle has been distributed to the device but the bundle has not been installed.

Devices Succeeded: Displays the number of devices on which the bundle was successfully distributed and installed.

Devices Failed: Displays the number of devices on which the bundle’s distribution or installation failed.

Message Log

The Message Log panel displays all unacknowledged messages generated for the object. An unacknowledged message is one that you have not yet reviewed and marked as acknowledged.

  • Status: Displays an icon indicating the type of message: Critical Status icon critical, Warning Status icon warning, and Normal Status icon normal.

  • Message: Displays a brief description of the event that occurred.

  • Date: Displays the date and time the event occurred.

A message remains in the Message Log list until you acknowledge it. You can acknowledge individual messages, acknowledge all messages at one time, or view more information about both acknowledged and unacknowledged messages. The following table explains how to do these tasks:

Task

Steps

Additional Details

Acknowledge a message

  1. Click the message to display the Message Detail Information dialog box.

  2. Click Acknowledge.

If you decide that you do not want to acknowledge the message, click Cancel to dismiss the dialog box. This causes the message to remain in the Message Log list.

Acknowledge all messages

  1. In the Tasks list located in the left navigation pane, click Acknowledge All Messages.

 

View all acknowledged or unacknowledged messages

  1. Click the Advanced button to display the Edit Message Log page.

In addition to viewing all acknowledged and unacknowledged messages, you can also view only those messages with a specific status or date, view more details about messages, and acknowledge messages.

Click the Help button on the Edit Message Log page for specific information about performing tasks on that page.

Delete a message

  1. Click the relevant messages to display the Message Log dialog box.

  2. Click Delete.

Deleting a message completely removes the message from your ZENworks system.

App Details

The App Details Panel displays additional information about the app. The name of the app and the publisher is displayed along with the following information:

  • Size: Displays the size of the app.

  • Categories: Displays the Apple App Store categories in which the app is included. For example: Games, Education and Business.

  • iTunes Store ID: Displays the App Store ID that is linked to the iTunes Store. Click the ID to access the app on the iTunes Store.

  • Cost: Displays the cost associated with the app.

  • App Region: Displays the region selected while creating the new bundle.

  • Device Compatibility: Displays the supported devices that can run the app.

  • OS version compatibility: Displays the supported operating system versions for the app.

  • Supported Languages: Displays the supported languages for the app.

8.6.3 Bundles Relationship Page

The Relationships page of the bundle lets you view and manage the assignments that the bundle has for devices, users, and groups.

Displayed Version: Lists all existing versions of the bundle, and the latest version of the bundle is selected by default. Select the version of the bundle whose details you want to view or edit. If a Sandbox version of the bundle exists, this option displays the Sandbox version. However, if a Sandbox version of the bundle does not exist, this option displays the published version.

Device Assignments: Lists the devices, device folders, or device groups to which the bundle is assigned. You can add and remove assignments.

User Assignments: Lists the users, user folders, or user groups to which the bundle is assigned. You can add and remove assignments.

Bundle Groups: Displays the groups in which the bundle is a member. You can add the bundle to groups or remove it from groups.

8.6.4 Bundles Details Page

For App Store App Bundles:

The Details page of the bundle lets you view or edit the app settings:

  • Allow ZENworks to take ownership of the app, if the app is already installed on the device: This option allows ZENworks to manage the existing app on the device. If this option is selected, then the ownership will be retained by ZENworks even if it is unchecked in the subsequent versions of the bundle.

  • Retain app on the device if the bundle is deleted or unassigned, or if the device is removed from the zone: Retains the app on the device if the bundle is deleted, unassigned, blocked, or disabled, or if the device is removed from the zone. Subsequently, ZENworks will no longer manage the app on the device.

  • Prevent backup of app data to iCloud: Prevents the backup data from getting synced with iCloud. You will not be able to retrieve the app data if the device has unenrolled from the ZENworks Management Zone.

  • Create Sandbox: Creates a Sandbox-only version of the bundle. A Sandbox version of a bundle enables you to test it on your device before deploying it.

For iOS Profile Bundles:

You can click the download button to view or edit the configuration profile XML file. Subsequently, you can replace the previously uploaded file with the modified file by clicking the browse icon.

If you have modified the settings on the Bundle Details page, then click Publish to display the Publish Options page. In this page, you can publish the bundle to assigned devices or users as a new bundle or as a new version of the same bundle.

For more information on the existing Bundles feature of ZENworks, see the ZENworks Software Distribution Reference guide.