2.3 Creating Macintosh Bundles

Macintosh bundles allow you to configure, manage applications, and store the package updates on Macintosh devices.

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

If you are creating Macintosh bundle on a windows device, then you need to install ZCC Helper.

To create a Macintosh bundle:

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

  2. In the Bundle list, click New, then click Bundle to display the Select Bundle Type page.

  3. Select Macintosh Bundle, then click Next to display the Select Bundle Category page.

  4. Select the desired bundle category:

    Empty Bundle: A bundle with no initial tasks. This bundle category is useful to quickly create a bundle without performing all of tasks in the Create New Bundle Wizard. After you create the empty bundle, you can edit its details to add assignments, actions, and so forth, at a later time.

    Copy Directory: Copies a source directory to the specified location on the managed device.

    Copy Files: Copies files to the specified location on the managed device.

    Create/Delete Directory: Creates or Deletes a directory on the managed device.

    Install Directory: Uploads the contents of a directory and its sub-directories to the ZENworks content system and then installs them to the specified destination path on the managed device. By default, the content is replicated to all primary servers.

    Install Files: Uploads the files to the ZENworks content system and then installs them to the specified destination path on the managed device. By default, the content is replicated to all primary servers.

    NOTE:To add link or shortcut files, in ZCCHelper, when you enter *.lnk as the File Name, the available list of link and shortcut files are displayed. After you select the required file, ZENworks uploads only the link file, instead of the executable to which the file links.

  5. Click Next to display the Define Details page, then fill in the fields:

    Bundle Name: Provide a name for the bundle. The bundle name must be different than the name of any other item (bundle, group, folder, and so forth) that resides in the same folder. The name you provide displays in ZENworks Control Center and the ZENworks Agent (on managed devices).

    To easily identify the bundle, you can specify the name of the application associated with the bundle, as the Display Name. For example, if the bundle installs the XYZ application, you can specify the display name as XYZ. In the Display Name, you could also specify whether the application is a 64-bit or a 32-bit version.

    For more information, see Naming Conventions in ZENworks Control Center in the ZENworks Control Center Reference.

    Folder: Type the name or browse to and select the ZENworks Control Center folder where you want the bundle to reside. The default path is the context from where the bundle creation wizard is invoked. For example, if you choose to create a new bundle from the bundles page, the default folder path is /bundles. However, if you choose to create a bundle from with a bundle folder named folder1, the default folder path is /bundles/folder1. You can also create additional folders to organize your bundles.

    Icon: ZENworks Configuration Management lets you select an icon that users see during installation of a particular bundle. This icon applies only to the icon displayed by ZENworks Agent on the managed device. ZCC uses default icons to represent the different bundles.

    Before an icon can be selected, you need to install ZCC Helper.

    To easily identify the bundle, you could use an icon that represents the application associated with the bundle. It is recommended that you upload a .JPG, .PNG, or .BMP format and a square image. However, ZENworks automatically converts the uploaded icon images to the correct format and size.

    To select an icon, clickBrowse icon, allow browser to launch ZCC Helper, and then browse and select the icon you want to display on managed devices.

    If you do not specify an icon, a default icon is used.

    NOTE:The icon (.ico file) uploaded while creating a Linux or a Macintosh bundle using a Windows device is not displayed on the agent, instead the default icon is displayed.

    Description: Provide a short description of the bundle's contents. This description displays in ZENworks Control Center and in the ZENworks Agent.

    It is recommended that you provide enough information to the user by detailing the actions that will be performed when the user double-clicks the bundle icon on the device. To view the description on the device, the user can right-click the bundle icon and select Properties.

  6. Click Next, then skip to the appropriate step, depending on which bundle category you chose in Step 4:

    • Empty Bundle: Continue with Step 10.

    • Create/Delete Directory: Continue with Step 7.

    • Install Directory: Continue with Step 8.

    • Install Files: Continue with Step 9.

  7. (Conditional) If you are creating an Create/Delete Directory bundle, follow the wizard prompts until you reach the Summary page, then skip to Step 17.

    Click Help for information about each page or refer to the following table:

    Wizard Page and Field

    Details

    Select Directory page > Action Type field

    Select one of the following:

    • Create Directory: Creates a directory on the managed device when the action is performed.

    • Delete Directory: Deletes a directory on the managed device when the action is performed.

    Select Directory page > Directory Name field

    Specify the complete path of the directory you want to create or delete on the managed device. This path must be resolved by the device on which the bundle is run.

  8. (Conditional) If you are creating an Install Directory bundle, follow the wizard prompts until you reach the Summary page, then skip to Step 17.

    Click Help for information about each page or refer to the following table:

    Wizard Page and Field

    Details

    Select Directory page > Source Directory field

    Click , and allow browser to launch ZCC Helper. Select Folder dialog box is displayed, browse and select the file to upload.

    The Status field displays each file’s upload status.

    Select the Upload all files within the source directory as a single package option to enable all the files within the specified source directory to be uploaded as a single content.

    If ZCC Helper is not installed on this device, it must be installed before you can browse to and upload files.

    Select Directory page > Upload Files As field

    Specifies whether the content has been uploaded as a single content or multiple contents to the ZENworks content repository.

    If the Upload all files within the source directory as a single package option in the Select Directory dialog box is not selected, then the files are uploaded by packaging in to multiple contents and the value of Upload Files As option is displayed as Multiple Content.

    If the Upload all files within the source directory as a single package option in the Select Directory dialog box is selected, then the files are uploaded by packaging in to single content and the value of Upload Files As option is displayed as Single Content.

    NOTE:This option is especially useful when you select the Install Directory action. It makes it faster both to process the files on the server, and to later download the file package to the client computer

    Select Directory page > Destination Directory field

    Specify the destination path on the device where you want to install the directory.

    Select Directory page > Permissions field

    You can configure permissions and set the access for the directory that you have installed.

    Mode: Select this option and enter a 3 digit octal number to specify the permissions for owner, group, and others.

    Owner: Select this option and set the access for Owner, Group, and Others.

    Select Directory page > Ownership field

    You can configure permissions and set the access for the directory that you have installed.

    Root: Select this option to provide the ownership for the root user.

    User: Select this option to provide the ownership for a particular user. You can also specify the group of the user.

    Select Directory page > Copy Option

    Select a copy option from the list. For more information on the options, click Help.

  9. (Conditional) If you are creating an Install Files bundle, follow the wizard prompts until you reach the Summary page, then skip to Step 17.

    Click Help for information about each page or refer to the following table:

    Wizard Page and Field

    Details

    Select Files page > File field

    Click Add to display the Select File dialog box, specify the files you want to install on the device, then click Open. Repeat this step as many times as necessary to copy the desired files.

    Click OK to upload the files to the server. The File option lists all the uploaded files, the size of the files, and how the content is packaged.

    If ZCC Helper is not installed on this device, you must install it before you can browse for file paths.

    Select Files page > Destination Directory field

    Specify the destination directory on the device in which you want to install the file.

    Select Directory page > Permissions field

    You can configure permissions and set the access for the directory that you have installed.

    Mode: Select this option and enter a 3 digit octal number to specify the permissions for owner, group, and others.

    Owner: Select this option and set the access for Owner, Group, and Others.

    Select Directory page > Ownership field

    You can configure permissions and set the access for the directory that you have installed.

    Root: Select this option to provide the ownership for the root user.

    User: Select this option to provide the ownership for a particular user. You can also specify the group of the user.

    Select Files page > Unpack field

    Select this option to indicate that the files that are compressed in GZIP, BZIP2, or ZIP formats should be decompressed and extracted on to the device where you want to install them.

    By default, ZipperUtil.sh is used to unpack the files. If you want to unpack the files using Java API, in the xplatzmd.properties file, the value of install-file-unpack-with-java-first should be set to True.

    Select Files page > Delete After Unpack field

    Select this option to indicate that the GZIP, BZIP2 or ZIP files should be deleted after extracting them on to the device where you want to install them.

    Select Files page > Copy Option

    Select a copy option from the list. For more information on the options, click Help.

  10. Review the information on the Summary page, making any changes to the bundle settings by using the Back button as necessary.

  11. Skip to Step 13 to create the published version of the bundle.

  12. (Conditional) Select the Create as Sandbox option to create a sandbox-only version of the bundle.

    A sandbox-only version of a bundle enables you to test the bundle on your device before actually deploying it. For more information on a sandbox-only bundle, see Section 7.0, Understanding Bundle Change Management.

  13. (Conditional) Select the Define Additional Properties option to display the bundle’s Action page after the wizard completes. You can use the various tabs to edit the bundle’s assignments, system requirements, actions, settings, and content replication settings.

  14. Click Finish to create the bundle as configured per settings on the Summary page.

    When you click Finish, the bundle is created but it does not have users or devices assigned, s, and group membership. At some point in the future, you need to configure additional options for the bundle by continuing with Section 9.1, Assigning Existing Bundles to Devices or Section 9.2, Assigning Existing Bundles to Users.

    For information on the viewing the bundle information, see Section 3.0, Viewing the Bundle Information.