3.3 Editing Subscriptions

You can edit an existing subscription to add additional properties, to change its description, add or remove the subscription from a subscription folder, add or remove packages from the bundle, and more.

You can use ZENworks Control Center or the zman command line utility to edit subscriptions. The following procedure explains how to edit a subscription by using ZENworks Control Center. If you prefer the zman command line utility, see

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

  2. Click the subscription name you want to edit to display the Summary page.

    Use the Summary page to view detailed information about the selected subscription. This page provides general information about the subscription, the remote server URL and its credentials, the options that can be additionally set for a subscription, and the schedule information such as the replication schedule and status, the last replication date, and the URL of the subscription server.

    You can also use this page to edit the subscription’s description, enable or disable the subscription, and change other configuration settings as described.

  3. Make the configuration changes:

    1. Review the information in the General section, then make the desired changes. You can edit only the Description, Download to Folder, and Enabled fields.

      Name: Displays the name of the subscription.

      Type: Displays the type of subscription.

      Created By: Displays who created the subscription.

      GUID: Displays the subscription’s GUID (global unique identifier), which is a randomly generated string that provides a unique identifier for the subscription.

      Description: Displays the subscription’s description if it was provided when the subscription was created. The description appears only in ZENworks Control Center.

      Click Edit to change the description, as necessary.

      Enabled: Displays Yes if the subscription is enabled, or displays No if the subscription is disabled.

      Click the link next to the field to enable or disable the subscription, as necessary.

      Download To Folder: Displays the folder to which to download the subscriptions. To change the folder, browse to and select a different folder. Not applicable for Android Enterprise and Apple VPP Subscription.

      NOTE:The specified folder is not applicable when you choose to create a Static Subscription. Irrespective of the folder you specify, the subscriptions are downloaded to the following folders:

      • On Windows: %ZENWORKS_HOME%\work\cache\pkg-repo\Static_Subscriptions

      • On Linux: /var/opt/microfocus/zenworks/cache/pkg-repo/Static_Subscriptions

      Subscription Logs: Click the View Log link to display any warning or error messages for the subscription.

    2. Review the information in the VPP Token Details section. This applicable for Apple VPP only.

      • Organization: The name of the organization that has subscribed for the Apple VPP.

      • Country Code: The country code of the organization that has subscribed for the Apple VPP.

      • Apple ID: The Apple ID associated with the Apple VPP token.

      • Email: The email address associated with the Apple VPP token.

      • Location ID The unique location code associated with the location-based token (applicable only for Apple Business Manager).

      • Location Name The name of the location associated with the location-based token (applicable only for Apple Business Manager).

      • Token Expiry: The expiry date of the Apple VPP token.

    3. Review the information in the Android Enterprise details section. This is applicable for Android Enterprise Subscription only.

      • Organization Name: Displays the name of the organization.

      • Enterprise ID: Displays the unique ID of the enterprise. This ID is automatically generated by Google.

      • Status: Displays the status of this organization. By default, Active will be displayed as the status.

      • Email ID: Displays the email ID with which the enterprise is enrolled.

    4. The User Context section is applicable for Android Enterprise Subscription only. All the users in the selected user contexts will be allowed to enroll for the Android Enterprise Program.

    5. The Languages section is applicable for Android Enterprise Subscription only. The app details will be retrieved in the selected languages from Google for the apps that you approve in managed Google Play. The retrieved details will be used to display app details in the Apps Catalog page and information within a bundle such as permissions and managed configurations. By default, English will be selected, which cannot be modified.

    6. Review the Bundle Details information. This is applicable for Apple VPP Subscription and Android Enterprise Subscription only.

      • ZENworks Bundle Location: Displays the folder location in which you want the iOS bundle to reside. To change the folder, browse and select a different folder.

      • Bundle Settings Displays the app settings configured while creating the subscription. Only Create Bundle as Sandbox is applicable for Android Enterprise Subscription.

        • Allow ZENworks to take ownership of the app, if app is already installed on the device: If the app is already installed on the device, this option allows ZENworks to manage the app on the device. This option is selected by default for all Apple VPP bundles.

        • Retain app on the device after unenrolling the device from the ZENworks Management Zone: Retains the app on the device even after it is unenrolled from the ZENworks Management Zone. The app will be retained on the device, but it will no longer be managed by ZENworks.

        • Prevent backup 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 Bundle as Sandbox: Creates a Sandbox-only version of the bundle. A Sandbox version of a bundle enables you to test it on your device before actually deploying it.

    7. Review the information in the Remote Server section, then make the desired configuration changes:

      Base URL: Displays the URL of the repository that you want to access and the server credentials that you provided while configuring the remote server for the subscription.

      Click Edit to provide a different URL.

      Server Credentials: Displays the server credentials that you provided while configuring the remote server for the subscription. To change the credential, browse to and select a different credential.

    8. Select the common options, Kernel Package Install type options and the bundle options that you want to additionally set for the subscription:

      Common Options: The following common options are available for the subscription.

      • Dry Run: Select this option to perform a test to determine if the content can be successfully downloaded. A successful dry run ensures that the content can be successfully downloaded to the server and the bundle can be successfully created.

      • Force Replication: Select this option to re-download the packages from the repository if they are corrupted on the ZENworks Server.

      • Create Sandbox: Select this option to replicate the bundle as a sandbox version. A sandbox version of a bundle enables you to test it on your device before you actually replicate it.

      • RollBack Installation of Bundles on Failure: Select this option to revert the transaction to its original state (before the bundles were installed).

      Kernel Package Install type options: The following Kernel Package install type options are available for the subscription. The selected option will be set for Kernel Packages during replication.

      • Install: Select this option to set the install type option for Kernel Packages as Install.

      • Upgrade: Select this option to set the install type option for Kernel Packages as Upgrade.

      Bundle Options: The following bundle options are available for the subscription.

      • Static Replication: Select this option to perform a static replication to download the package updates from the remote repository to the file system on your local server. On Linux, the default location to download the content from is /var/opt/microfocus/zenworks/cache/package-repo/Static-Subscription, and on Windows, the default location is %ZENSERVER_HOME%\work\cache\pkg-repo\Static_Subscriptions.

        • Monolithic Bundle: This option is selected by default for RCE, YUM, and Static repositories. Monolithic bundles are applicable only for NU, RCE, YUM, and Static repositories.

          If you are replicating from a ZLM repository that has multiple bundles, selecting this option creates the same number of bundles as are in the ZLM catalog. If you are replicating content from a repository other than a ZLM repository, selecting this option creates a single bundle.

        • Source RPMs: Select this option to download the source RPMs, if they are available in the remote repository, to the monolithic bundle.

        • Patches: Select this option to download patches to the local file system. Patches are applicable only for NU, RCE, and YUM.

          A monolithic bundle is replicated along with patches. However, the monolithic bundle is skipped if all categories are not selected or the bundle filter is configured.

        • Retain Bundle GUID: This option is applicable only for ZLM Subscriptions and Static subscriptions created with the ZENworks Linux Management static source.

          Select this option to prevent the bundle from being reinstalled on managed devices that are migrated from ZENworks Linux Management to ZENworks Configuration Management.

      • Create Linux Bundle: This option is selected by default for NU and RCE repositories. Select this option to create a Linux bundle on the ZENworks server.

        • Monolithic Bundle: This option is applicable only for NU, RCE, YUM, and Static repositories and is selected by default.

          If you are replicating from a ZLM repository that has multiple bundles, selecting this option creates the same number of Linux bundles as are in the ZLM catalog. If you are replicating from a repository other than a ZLM repository, selecting this option creates a single Linux bundle.

        • Source RPMs: Select this option to download the source RPMs to the bundle.

        • Patches: This option is applicable only for NU, RCE, YUM, and Static repositories and is selected by default for the NU and RCE repositories. Select this option to create patch bundles and download the patches to these bundles.

          A monolithic bundle is replicated along with patches. However, the monolithic bundle is skipped if all categories are not selected or if the bundle filter is configured.

          NOTE:Patch replication might not work for all YUM repositories.YUM, as an open format allows defining of repository patch metadata in different formats. As a result, the format of repositories published by different vendors for different distributions, varies. Subscription replication might not be able to handle all formats, because there is no consistent formatted patch metadata.

        • Create Category based Bundle Groups: Select this option to create different bundle groups for the replicated bundles based on their categories.

        • Retain Bundle GUID: This option is applicable only for ZLM subscriptions and Static subscriptions created with the ZENworks Linux Management static source.

          Select this option to prevent the bundle from being reinstalled on managed devices that are migrated from ZENworks Linux Management to ZENworks Configuration Management.

      • Create Linux Dependency Bundle: Select this option to create a Linux Dependency bundle on your ZENworks server.

        If you are replicating from a ZLM repository that has multiple bundles, selecting this option creates the same number of Linux dependency bundles as are in the ZLM catalog. If you are replicating from a repository other than a ZLM repository, selecting this option creates a single Linux dependency bundle.

        • Publish Packages: Select this option to allow the user on the ZENworks agent to directly install the packages on the agent by using the zac command. If you do not select this option, the packages are used for dependency resolution in other Linux bundles.

    9. Review the information in the Schedule section, then make the desired configuration changes:

      Status: Displays the subscription status.

      Click Run Now to begin the subscription immediately.

      Last Replication: Displays the date on which the content was last replicated.

      Subscription Server: Displays the complete path of the ZENworks Primary Server to which you are downloading the content. To change the server, browse to and select a different server.

      Replication Schedule: Displays the schedule type that you set up while creating the subscription. Select a different schedule type from the drop-down list or edit the existing one, as necessary.

      Bundle Creation Schedule: Displays the schedule type that you set up while creating an iOS bundle. You can select a different schedule type from the drop-down list or edit the existing one. Applicable for Apple VPP only.

      For more information on schedules, see Schedule Types in the ZENworks Primary Server and Satellite Reference.

      MDM Server: Displays the name of the MDM server through which the enterprise last connected to Google.

    10. Click Apply to save any changes.