4.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 Subscription Commands in the ZENworks Command Line Utilities Reference.

  1. In ZENworks Control Center, click Subscribe and Share.

  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.

      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: %ZENSERVER_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 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.

    3. 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). For more information on the rollback feature, see Rolling Back to a Previously Installed Software Configuration State.

      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, SUSE, 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 bundle per catalog.

        • 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, SUSE, 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,SUSE, and RCE repositories. Select this option to create a Linux bundle on the ZENworks server.

        • Monolithic Bundle: This option is applicable only for NU, SUSE, 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, SUSE,RCE, YUM, and Static repositories and is selected by default for the NU, SUSE, 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.

    4. 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.

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

    5. Click Apply to save any changes.