9.1 Assigning Existing Bundles to Devices

When you create bundles, the object is created without assigning devices or users to it, or specifying distribution, launch, or availability schedules. Before the bundle can be used on assigned devices, you must complete the steps in the following procedure. You can assign bundles to devices, device groups, or device folders.

You can use ZENworks Control Center or the zman command line utility to assign bundles. The following procedure explains how to assign a bundle using ZENworks Control Center. If you prefer the zman command line utility, see the Bundle Commands in ZENworks Command Line Utilities.

1. In ZENworks Control Center, click the Bundles tab.

2. Select the desired bundle in the Bundles list by clicking the box next to its name, click Action, then click Assign to Device.

   or

   Click the desired bundle, click Relationships. In the Direct Assignments panel, click Add.

   A bundle must be assigned to devices and users before it can be distributed to them.

   You can assign the bundle to individual devices, users, folders, or groups. Assigning a bundle to a folder or group is the preferred method of assigning bundles. This allows for easier management of the bundle assignments and can decrease the possibility of high server utilization caused by assigning the bundle to a large number of items (for example, more than 250).

3. In the Select Objects dialog box, browse to and select the objects to which you want to assign the bundle.

   The Select Objects dialog box opens with the Devices folder as the root folder. By default, the Servers and Workstations folders are displayed along with any custom folders that you have created in the Devices folder.

   Browse for and select the devices or users, groups, and folders to which you want to assign the bundle. To do so:

   1. Click next to a folder (for example, the Workstations folder or Servers folder) to navigate through the folders until you find the device, group, or folder you want to select.

      If you are looking for a specific item, such as a Workstation or a Workstation Group, you can use the Items of type list to limit the types of items that are displayed. If you know the name of the item you are looking for, you can also use the Item name box to search for the item.

   2. Click the underlined link in the Name column to select the device, group, or folder and display its name in the Selected list box.

   3. Click OK to add the selected devices, folders, and groups to the Devices list.

4. Specify the bundle’s shortcut location.

   You can use the Shortcut Location assignments to specify the locations on the managed device where ZENworks Agent displays the bundle’s icon.

   The possible locations include the following:

   Application Window: Places the icon in the Application window. This location is selected by default.

   Quick Launch: Places the icon on the Quick Launch area of the Windows taskbar.

   Desktop: Places the icon on the device’s desktop.

   System Tray: Places the icon in the system tray (notification area) of the Windows taskbar.

   Start Menu: Places the icon on the Start menu on all Windows devices except for Windows Vista and later. It places the icon in Start > All Programs on Windows Vista and later.

   Taskbar: Places the icon on the taskbar.

   Start Menu Tiles: Places the icon on the Start menu tiles. This is applicable only for Windows 10 and later versions.

   On a Windows Vista devices, if you want to change the look and feel of the Start menu or pin applications to the Start menu, see Section D.0, Best Practices.

5. Click Next to display the Schedules page.

   In the Schedules page select the schedules you want to define:

   Distribution Schedule: Defines the dates and times when the content of the bundle is distributed from the ZENworks Server to the managed device or user. If you do not establish a schedule, the bundle’s content is distributed to the device or user when it is first launched. However, the schedule does not define the date and time when the action in the bundle runs.

   Installation Schedule: Defines the date and time when the bundle is installed from the ZENworks Server to the managed device or user. If you do not configure a schedule, the bundle is installed to the device when it is first launched.

   Launch Schedule: Defines the dates and times when the ZENworks Agent automatically launches the bundle. If you do not establish a schedule, the bundle is launched only when the user launches it. Before launching the bundle, the ZENworks Agent checks if the bundle is distributed and installed. If the bundle is not yet distributed, the agent first distributes the bundle, performs the bundle’s install actions to install the bundle, then performs the bundle’s launch actions to launch it.

   IMPORTANT:If Install Immediately after Distribution and Launch Immediately after Installation options are set for the distribution schedule of a bundle, the content of the bundle is distributed as per the schedule and, then the bundle is installed and launched.

   The Bundle that is distributed once will not be distributed again on the next schedule. Hence, the Install Immediately after Distribution and Launch Immediately after Installation options which are specified in the distribution schedule are not considered on subsequent schedules.

   To launch the same bundle repeatedly on subsequent schedules, you need to configure the launch schedule.

   Availability Schedule: Defines the dates and times when the bundle is available to the device or user. The ZENworks Agent displays the bundle icon only during the times defined by the schedule. If you do not establish a schedule, the bundle is available at all times.

   NOTE: If a bundle with an assignment schedule fails to execute on a device, an attempt to execute the bundle on the device is made five times, by default.

   To change the default value:

   1. Open the Registry Editor.

   2. Go to HKLM\Software\Novell\ZCM\.

   3. Create a STRING called ScheduleRetries, and set its value as desired.

   For example, if you do not want the failed bundle to be executed again on the device, set the value of the ScheduleRetries to 0.

6. (Conditional) If you selected Distribution Schedule in Step 5, click Next to display the Bundle Distribution Schedule page.

   The distribution schedule defines the dates and times when the bundle is distributed from the ZENworks Server to the managed device. The default schedule (no schedule) causes the bundle to be distributed to the device when it is first launched.

7. In the Schedule Type field, select one of the following schedules, then fill in the fields. For detailed information, click the Help button on the wizard page or see the following sections in the ZENworks Primary Server and Satellite Reference:

   • Date Specific

   • Recurring

   • Event

   • Now

   For the 'Now' schedule to be effective during bundle assignment, ensure that the number of devices to which you want to assign a bundle does not exceed 30. The Now schedule sets a refresh device schedule and triggers a bundle quick task. To assign bundles randomly to more than 30 devices, use the Quick Tasks option in ZENworks Control Center.

   For more information on the quick tasks, see Using Quick Tasks in the ZENworks Control Center Reference.

8. Select the following options as desired:

   Wake-on-LAN: If the device is not on at the scheduled time, ZENworks attempts to use Wake-on-LAN (WOL) technology to power on the device. The device must support WOL.

   NOTE:If you are assigning bundles to Wake-on-Lan devices with Date Specific scheduling option, you need to enable the Process immediately if device unable to execute on schedule option. This is required for the distribution to occur on schedule after the device wakes and receives the bundle distribution schedule.

   Install Immediately After Distribution: Performs any installation actions immediately after the bundle is distributed to the device.

   Launch Immediately After Installation: Performs any launch actions immediately after the bundle is installed. This option is available only if the Install Immediately After Distribution option is enabled.

9. (Conditional) If you selected Launch Schedule in Step 5, click Next to display the Bundle Launch Schedule page.

   The launch schedule determines the dates and times when ZENworks Agent automatically launches the bundle. The default schedule (no schedule) results in the bundle only being launched if the user launches it.

10. In the Schedule Type field, select one of the following schedules, then fill in the fields. For detailed information, click the Help button on the wizard page or see the following sections in the ZENworks Primary Server and Satellite Reference:

    • Date Specific

    • Recurring

    • Event

11. (Conditional) If you selected Availability Schedule in Step 5, click Next to display the Bundle Availability Schedule page.

    The availability schedule defines the dates and times when the bundle is available on the managed device. ZENworks Agent displays the bundle icon only during the times defined by the schedule. The default schedule (no schedule) makes the bundle available at all times.

    The schedule applies regardless of whether or not the bundle is installed. For example, if a user has not yet installed the bundle, it is only available for installation at the times specified by the schedule. If a user has already installed the bundle, it is only available for running during the scheduled times.

12. In the Schedule Type field, select one of the following schedules, then fill in the fields. For detailed information, click the Help button on the wizard page or see the following sections in the ZENworks Primary Server and Satellite Reference:

    • Date Specific

    • Recurring

13. Click Next to display the Finish page, review the information and, if necessary, use the Back button to make changes to the information.

14. Click Finish.