A.0 Troubleshooting Linux Package Management

The following sections provide solutions to the problems you might encounter while working with Linux Package Management:

The zac bundle-list command displays the bundle status as Available even though the packages of the bundle are not installed

Source: ZENworks Configuration Management; Linux Package Management.
Possible Cause: This issue might occur if the Freshen flag is set for a package and the base version of the package is not installed.
Action: None.

Unable to access the YUM URL from YUM clients if you change the ZENworks Server port after creating the YUM Service

Source: ZENworks Configuration Management; Linux Package Management.
Action: On the YUM client, manually add the new HTTP port of the ZENworks Server to the YUM Service URL. The YUM Service URL is represented as http://ZENworks_Server_IP_address:port/zenworks-yumrepo/yum_service_name.

For example, if you have changed the HTTP port of the ZENworks Server to 81, modify the YUM Service URL to http://ZENworks_Server_IP_address:81/zenworks-yumrepo/SLES11Updates.

For more information on how to add the new HTTP port to the YUM client, see Section 9.0, Subscribing to External Services.

Listing of the subscription channels by using the zman srcl command might result in the Java heap space exception

Source: ZENworks Configuration Management; Linux Package Management.
Explanation: The following out-of-memory exception error might occur when you list the subscription channels by using the zman srcl command: 
Exception in thread "Thread-1" java.lang.OutOfMemoryError: Java heap space
Action: Increase the zman memory size:

  1. Open the /opt/microfocus/zenworks/bin/zman file in a text editor.

  2. Search for the MEM_OPTS variable, then change its value to -Xms64m -Xmx256m or -Xms64m -Xmx512m.

  3. Save the /opt/microfocus/zenworks/bin/zman file.

Using zac bundle install command to install a bundle on a device also installs other bundles assigned to the device

Source: ZENworks Configuration Management; Linux Package Management.
Explanation: If you use the zac bundle-install command to install a bundle that contains characters such as underscore(_), dollar($), hash(#), or exclamation(!) followed by an alphanumeric value in its name, all the assigned bundles whose name contains the character followed by the alphanumeric value are also installed on the device.

Example 1: Consider five bundles named bundle_1, bundle_10, bundle_20, bundle_100, and bundle_200 are assigned to a device. Run the zac bundle-install bundle_1 command to install bundle_1 on the device. The bundles named bundles_10 and bundle_100 are also installed on the device.

Example 2: Consider four bundles named bundle#abc, bundle#abcd, bundle#def, and bundle#abcrt are assigned to a device. Run the zac bundle-install bundle#abc command to install bundle#abc on the device. The bundles named bundle#abcd and bundles#abcrt are also installed on the device

Action: To install such a bundle on the device, specify the bundle GUID instead of the bundle name in the command. To determine the bundle GUID, run the zac bundle-list --show-guid command.

The actions listed in the Distribute action set of a bundle gets executed twice

Source: ZENworks Configuration Management; Linux Package Management.
Explanation: Consider a bundle that is assigned to a device with the Distribution schedule set as Now and the Install Immediately after Distribution option selected. Both the Distribute and Install action set run on the device as a result of which the actions listed in the Distribute action set of the bundle gets executed twice.
Action: Perform the following steps in ZENworks Control Center:

  1. Edit the bundle’s distribution schedule to set the distribution schedule type as Recurring and select the When a device is refreshed option.

    Ensure that the Install Immediately after Distribution option is selected.

  2. Click the Devices tab. Select the device to which you have assigned the bundle, then click Quick Tasks > Refresh Device.

Unable to view the selected targets of packages on Internet Explorer 8

Source: ZENworks Configuration Management; Linux Package Management.
Possible Cause: This issue might occur if you use Internet Explorer 8.
Action: To view the selected targets of packages, you should use Mozilla Firefox or Internet Explorer 7.

Integrity check failed message is displayed while installing OES or SLES using the ZENworks Repository

Source: ZENworks Configuration Management; Linux Package Management.
Possible Cause: While installing OES with the ZENworks repository, messages are displayed indicating that the integrity check failed for most of the packages that are installed using the repository.
Action: Download the repomd.xml.asc and repomd.xml.key files from the SLES repository (https://updates.suse.com/SUSE/Updates/SLE-INSTALLER/15-SP1/x86_64/update/repodata/) and copy them to every Primary server providing the YUM service for repository encountering the issue. To access the URL and download the files, you need to use the mirror credentials to access the URL.

For example, you can download the repomd.xml.asc and the repomd.xml.key files for the OES2018-Updates catalog and the sle-12-x86_64 target from the http://nu.novell.com/repo/$RCE/OES2018-Updates/sle-12-x86_64/repodata location.

The location of the YUM repository on the Linux Primary Server is: /var/opt/novell/zenworks/yum-repo/.

On Linux, after the files have been copied, you need to run permissions.sh

NOTE:ZENworks no longer supports Windows Server as a Primary Server from version 24.2 onwards. For more information, see End of Windows Primary Server Support.