Novell ZENworks 10 Configuration Management

October 8, 2008

3.7 CASA
3.10 Imaging
3.22 Zman

1.0 Readme Updates

This document was updated in the following sections on the dates indicated:

1.1 October 8, 2008

Removed the “Invalid Certificates” section.

1.2 May 16, 2008

The following changes were made:

1.3 March 17, 2008

Section 3.5, Asset Management Services Migration Utility, was added, which details issues with the ZENworks Asset Management Migration Utility.

1.4 January 16, 2008

The following changes were made:

1.5 December 20, 2007

In Reporting Issues, the workaround for the following issue has been updated:

Reporting does not work if the ZENworks database is an SQL Server* database, and the authentication mode is Windows Authentication.

2.0 Overview

The issues included in this document were identified for Novell ZENworks 10 Configuration Management.

For installation instructions, see the Novell ZENworks Configuration Management Installation Guide.

For administrative tasks, see the Novell ZENworks 10 Configuration Management documentation Web site.

3.0 Known Issues

This section contains information about ZENworks Configuration Management issues that might occur.

3.1 System Updates

This section contains information about the issues that might occur with using the System Updates feature in ZENworks Configuration Management.

3.1.1 System Updates requires a minimum of 5 GB of free disk space for the download

Each Primary Server requires at least 5 GB of disk space for downloading the update because the server where the update is actually downloaded is randomly chosen. Each managed device needs only 1 GB to do a full update.

3.1.2 System Updates hangs during download and building processes

Sometimes the System Updates download or building process does not complete.

Workaround: Delete the download, wait a few minutes, then restart the download.

3.1.3 Linux servers appear to be managed devices in ZENworks Control Center

When you install the Primary Server software to a Linux* server, a portion of the ZENworks Adaptive Agent is activated so that you can use the System Updates feature for your Linux server. Because of this, other Adaptive Agent management capabilities appear to be available for Linux servers. However, if you attempt to use them, nothing happens because those portions of the agent are not active for the Linux platform.

Workaround: Ignore Linux servers that are listed as managed devices.

3.2 Installation

This section contains information about the issues that might occur when you install ZENworks Configuration Management.

3.2.1 Configuration Management installation hangs when installing a ZENworks MSI using VMware or a share on 64-bit Windows 2003 Server

If you are running the installation to a 64-bit Windows device through either a share on a VMware* host or another network drive, the installation might hang when attempting to install a ZENworks MSI.

Workaround: Cancel the installation, kill the hung msiexe.exe process in the process viewer, copy the ZENworks installation folders to the local device, then re-run the installation.

3.2.2 Installation of an external MS SQL database requires an existing path

If you select to install a new Microsoft* SQL database during installation of Configuration Management, the path must already exist. You cannot create the database’s directory during installation.

Workaround: Create the directory for the MS SQL database before starting the installation program.

3.2.3 Cannot install ZENworks if the external Microsoft SQL named instance contains an underscore character

(Fixed in v10.0.3) If you attempt to install using a named instance of an external Microsoft SQL server that contains an underscore (_) character, such as DB_NEW, a message indicates you need to start the browser service on the MSSQL server, but it is already running. The installation cannot proceed.

Workaround: Do not use a named instance that contains underscore characters.

3.2.4 Some ZENworks partitions must be fixed in order to work with Configuration Management

If your environment is running the Novell ZENworks Linux Management - Dell Edition and you created ZENworks partitions on your clients, when the partition is booted to update your clients to ZENworks 10 Configuration Management, the partition no longer works and fails the update.

Workaround: Before you install ZENworks 10 Configuration Management to your environment, create a scripted imaging task and force all ZENworks partitions to run it in preparation to update to Configuration Management.

Create the following script to fix the /etc/ZUpudate.sig file contained in the initrd resource file:

export PATH=/sbin:/usr/sbin:/bin:/usr/bin:/lbin

mount $ZENDEVICE /mnt/harddisk

cp /mnt/harddisk/boot/loader/initrd /initrd.gz

#make a backup of initrd

cp /mnt/harddisk/boot/loader/initrd /mnt/harddisk/boot/loader/initrd.sav

gunzip /initrd.gz

mount -o loop /initrd /mnt/cdrom

cp /mnt/cdrom/etc/ZUpdate.sig /

dos2unix /ZUpdate.sig

cp /ZUpdate.sig /mnt/cdrom/etc

umount /mnt/cdrom

gzip -v9c /initrd > /mnt/harddisk/boot/loader/initrd

umount /mnt/harddisk

3.2.5 Cannot use the GUI installation from a VNC connection

A Java* exception is given when you are trying to install with a VNC connection.

Workaround: Use SSH and the command line installation.

3.2.6 Time synchronization causes invalid certificate errors

If time is not synchronized on the network before you install the ZENworks Configuration Management services, you see invalid certificate errors because the certificates have dates that are in the future, and therefore are considered invalid.

Workaround: Make sure that your network has its time synchronized before you install the Configuration Management services. Make sure to include ZENworks back-end servers in the synchronization.

3.2.7 There is a disconnect between ports used by the Primary Server and managed devices

The ZENworks Configuration Management installation uses the default SSL port of 443. If your SSL is configured to use a different port and you make that change during installation, your managed devices cannot connect to their Primary Servers.

Workaround: On each client, open the following file in a text editor and replace the 443 port number with the one that you changed to during installation:

c:\program files\novell\casa\etc\auth\client.conf

3.2.8 BusinessObjects Enterprise XI cannot be installed on 64-bit servers

You cannot install BusinessObjects* Enterprise XI Release 2 to a Primary Server running a 64-bit operating system.

3.2.9 Cancellation of BusinessObjects Enterprise installation displays an incorrect message

If you cancel the BusinessObjects Enterprise installation, the following incorrect message is displayed:

ZENworks Configuration Management has been successfully installed to ZENworks_installation_path.

3.2.10 Reinstallation of BusinessObjects Enterprise XI on Windows fails

On Windows, BusinessObjects XI is not successfully reinstalled if you uninstall ZENworks Configuration Management and then reinstall it

Workaround: Install the BusinessObjects Enterprise on a different ZENworks server in the same management zone.

3.2.11 The Remote Desktop Connection program session fails if you install the ZENworks Adaptive Agent with the Remote Management component

If you remotely connect to a managed device using Remote Desktop Connection (RDP), then download and install the ZENworks Adaptive Agent, the installation does not complete and the Remote Desktop Connection program stops working.

Workaround: Avoid using RDP to install the ZENworks Adaptive Agent. If you want to install the ZENworks Adaptive Agent through RDP, install it without the Remote Management component.

3.2.12 AdminStudio ZENworks Edition requires the Primary Server to be using ports 80 and 443

During product installation you have the option to select ports other than the defaults of 80 and 443, but AdminStudio requires that the Primary Server be using ports 80 and 443.

Workaround: None. To use AdminStudio, you must install it on a Primary Server that is using ports 80 and 443.

3.2.13 Mono-extras-1.2.4-3.novell must be installed manually to a SUSE Linux Enterprise Server

The ZENworks Adaptive Agent and zac utility require the mono-extras-1.2.4-3.novell.i586.rpm file to be installed on a SUSE® Linux Enterprise Server. If it is not, the agent and utility do not load.

Although Mono® can be installed on the Linux server and is detected by the requirements checker during installation, the checker does not detect whether the required mono-extras file exists.

Workaround: Do the following:

  1. Obtain the RPM file from one of the following sources:

    • We recommend that you install the mono-extras file from the product media to ensure that all required files are installed. The file is located on the product media in either:

      /mono/1.2.4/sles10
      

      or

      /mono/1.2.4/sles10_64
      
    • If the product media is not available, download the mono-extras file from the Mono Web site:

      http://www.mono-project.com/downloads

      Then, under either rpm Linux/x86 or rpm Linux/x85_64, click Stable for either SUSE Linux 10.1 or 10.2.

      Under Mono, click mono-extras and save the file to disk.

  2. Install the mono-extras file using YaST.

    For information on using YaST, see Add Package Repositories to YaST.

3.2.14 If ConfigureAction fails due to an error detected by HotSpot Virtual Machine, it can be ignored

If you are installing the first primary server on a Linux device, and if at the end of the process that configures the database you see an error has occurred and you are given the option of continuing or rolling back, you should check the log file at /var/opt/novell/log/zenworks/ZENworks_Install_[date].log.xml. If it’s the error specified below, it is safe to continue with the install.

ConfigureAction failed!:
select tableName, internalName, defaultValue from Adf where inUse =?#
An unexpected error has been detected by HotSpot Virtual Machine:
#SIGSEGV (0xb) at pc=0xb7f6e340, pid=11887, tid=2284317600
#
#Java VM: Java HotSpot(TM) Server VM (1.5.0_11-b03 mixed mode)
#Problematic frame:
#C [libpthread.so.0+0x7340] __pthread_mutex_lock+0x20

Workaround: Ignore the error message.

3.2.15 Installation of BusinessObjects Enterprise might display an incorrect message

If you install BusinessObjects Enterprise on Windows or Linux Primary server by using the Novell ZENworks 10 Configuration Management DVD, the following incorrect message might be displayed:

Failed to install BusinessObjects Enterprise XI R2. See installation logs for more details.

Workaround: To verify that the installation completed successfully, open ZENworks Control Center, click the Reports tab, then click Predefined Reports.

If the installation was successful, the Predefined Reports page should be displayed.

If the installation was unsuccessful, the following might be displayed at the top of the ZENworks Control Center page for the Reports tab:

There are no Business Objects Reporting servers configured in the Management Zone.

For more information, review the BusinessObjects XI installation log file.

  • Windows: Installation_path\Novell\ZENworks\share\boe\ BusinessObjectsEnterprise11.5\Logging\BOEInstall_0.log.

  • Linux: /var/opt/novell/log/zenworks/install_boe.log.

3.3 Accessibility

This section contains information about accessibility issues when using ZENworks Configuration Management.

3.3.1 Keyboard support for selecting an application on the toolbar is not working

By default, Windows does not provide keyboard support for the toolbar.

Workaround: Enable the accessibility options in Windows and use the Accessibility Wizard to enable mouse key settings. Then, mouse functions can be controlled by using the numeric keypad.

3.4 Asset Management Services

This section contains information about ZENworks Asset Management Services.

3.4.1 New Software Usage custom reports don't display when saved

When you create a new Software Usage custom report and save it, the new report does not appear in the report list.

Workaround: Navigate out of the page and back in.

3.5 Asset Management Services Migration Utility

This section contains information about the issues that might occur with the ZENworks 10 Configuration Management with SP1 Asset Management Services Migration Utility.

3.5.1 Do not use version 10 if you plan to migrate data to ZENworks 10.x Configuration/Asset Management

Do not use version 10 of the migration utility if you plan on migrating asset management data to ZENworks 10.x Configuration/Asset Management at a later date. If you use version 10 of the ZENworks Asset Management Migration utility, you will not be able to use ZENworks 10 Configuration Management with SP1 Asset Management Services Migration Utility, which will support migration of asset management data.

Workaround: None.

3.5.2 Workstations must be migrated before the Adaptive Agent is deployed

To ensure migrated devices are reconciled to active devices in your ZENworks Configuration Management system, first apply version 10.0.3, migrate devices, and then deploy the ZENworks Configuration Management Adaptive Agent to those devices from the Discovered Devices tab in ZENworks Control Center (under the Devices created via ZENworks Asset Management Migration list.)

If you want to roll out ZENworks Configuration Management in stages, you can still ensure that migrated device inventory is reconciled to active devices in ZENworks Configuration Management by migrating sets of workstations from ZENworks Asset Management Services and then deploying the Adaptive Agent to those devices using the method described above.

3.5.3 Migrated devices may produce duplicate records

Migrated devices may produce duplicate records if a workstation that had been managed by legacy ZENworks Desktop Management and ZENworks Asset Management 7.5 is migrated from ZENworks Asset Management 7.5 and then the ZENworks 10 Configuration Management Adaptive Agent is deployed to it.

Workaround. None.

3.5.4 Objects can only be migrated once

Data can only be migrated once using the migration utility.

Workaround: None.

3.5.5 Custom reports are not migrated

The migration utility does not migrate asset inventory custom reports.

Workaround: None.

3.5.6 The data associated with user-defined fields is not migrated

The migration utility does not migrate user-defined field data.

Workaround: None.

3.6 Bundles

This section contains information about the issues that might occur when you use bundles in ZENworks Configuration Management.

3.6.1 Directive bundles might be shown as effective even though bundles cannot be assigned to Linux devices

Because Linux devices cannot have the ZENworks Adaptive Agent, you cannot assign bundles to be sent to them. However, in ZENworks Control Center, Directive bundles assigned to a Linux device might show as effective, which is incorrect.

Workaround: None.

3.6.2 The Registry Edit action cannot both back up the entire registry and edit the HKEY_CURRENT_USER part of the registry in Windows Vista

If you set up an action to both back up the registry and edit the HKEY_CURRENT_USER part on Windows Vista, because all user-initiated processes in Vista run as the lowest privileged user, this action fails.

Workaround: Use two different registry actions, one to back up the registry in the system context, then another to edit HKEY_CURRENT_USER in the user context.

3.6.3 The Undo Install Actions action fails to uninstall a directory if the directory name contains spaces

When you create an Install Directory File bundle, the directory is installed even if its name contains spaces; however, it cannot currently be uninstalled using the Undo Install Actions action.

Workaround: Avoid spaces in directory names if you want to enable the uninstall of that directory.

3.6.4 If the Wake-on-LAN schedule on the managed device is behind the server’s time zone, the device fails to wake up

Workaround: None.

3.7 CASA

This section contains information about the issues that might occur with CASA in ZENworks Configuration Management.

3.7.1 CASA fails to use HTTP proxy settings for initial authentication

CASA does not completely authenticate via the HTTP proxy during initial authentication, but instead contacts the Primary Server directly. After authentication, all CASA traffic goes through the HTTP proxy when using the ZENworks Adaptive Agent Logout/Login feature.

Workaround: Access rules must allow access to ports 80, 443, and 2645. Additionally, HTTP forward proxy settings must be configured in two locations:

  • Device Management in ZENworks Configuration Management uses the WinInet HTTP protocol. Therefore, forward proxy settings must be configured in Internet Explorer*: Click Tools > Internet Options > Connections > LAN Settings > Proxy Setting.

  • Device Management in ZENworks Configuration Management uses CASA authentication, which uses WinHTTP Services. WinHTTP requires proxycfg.exe. For example:

    proxycfg -p forward_proxy_IP_address:8080
    

    For more information on proxycfg.exe, see ProxyCfg.exe, a Proxy Configuration Tool.

3.8 Discovery and Deployment

This section contains information about the issues that might occur when you use the Discovery and Deployment functions in ZENworks Configuration Management.

3.8.1 LDAP discovery does not work on an Active Directory domain

If your workstations and servers are not configured in your DNS server, the discovery process cannot work because Active Directory* does not contain DNS names.

Novell eDirectory™ can contain DNS names. However, if the DNS attribute is not configured in eDirectory, you should configure them in your DNS server. Otherwise, IP addresses are displayed as the names in the discovery listing.

Workaround: Configure DNS names for your workstations and servers before running LDAP discovery.

3.8.2 Refreshing the Deployment page causes Discovery tasks to be repeated

It is normal for a Web browser to resend information in order to refresh a page. ZENworks auto-updates the data on a Deployment page every 5 seconds, so you should not need to refresh the Deployment page after running a Discovery task. If you do refresh the Deployment page in ZENworks Control Center, after running a Discovery task you are asked to confirm to resend in order to refresh the page. Do not do this, or the Discovery task runs again.

Workaround: Do not refresh the Deployment page after running a Discovery task. Instead, exit the page and return to see any changes.

3.8.3 Orphaned and deleted files are not cleaned up from deployment task that uses a proxy

Orphaned or to-be-deleted files from a pre-task or post-task action during a deployment task that uses a proxy are not cleaned up.

For example, if you run the deployment task from a Linux server through a Windows proxy, there is a folder created in the _rfu_cache directory on the Windows device that contains the pre-task or post-task command file. If you delete the task in ZENworks Control Center, the command file is left on the Windows proxy device.

Workaround: Manually delete the orphaned or to-be-deleted files.

3.9 File Access

This section contains information about the issues that might occur for access to files in ZENworks Configuration Management.

3.9.1 ActiveX controls are signed and Firefox extensions are activated for uploading files to ZENworks servers

If you want to uninstall ActiveX controls or Firefox extensions, do the following:

  • ActiveX Controls: Go to c:\windows\downloaded program files, right-click nfileupload class, then select Remove.

  • Firefox Extension: In Firefox, click Tools > Extensions, select Novell File Upload, then click Uninstall.

3.10 Imaging

This section contains information about the issues that might occur when using Imaging in ZENworks Configuration Management.

3.10.1 Zmediacreator and zmgbootcd Imaging utilities availability

These imaging utilities are available at the following locations:

https://primary_server_ID/zenworks-downloads/msi/novell-zenworks-zmediacreator-10.0.0.msi
https://primary_server_ID/zenworks-downloads/rpm/novell-zenworks-zmediacreator-10.0.0.i586.rpm
https://primary_server_ID/zenworks-downloads/msi/novell-zenworks-zmgbootcd-10.0.0.msi
https://primary_server_ID/zenworks-downloads/rpm/novell-zenworks-zmgbootcd-10.0.0.i586.rpm

3.10.2 Image file location in Configuration Management

In traditional ZENworks, you provided the path for imaging files (.zmg). In ZENworks Configuration Management, image files are automatically saved to the following location, which cannot be changed:

Windows: installation_path\novell\zenworks\work\content-repo\images

Linux: /opt/Novell/ZENworks/work/content-repo/images

If you need more disk space for large imaging files than is available in your current content repository location, you can change this location to a different partition. For more information, see Content Repository in the System Administration Reference.

3.10.3 Manual imaging command line changes for Configuration Management

In traditional ZENworks imaging, to manually perform an imaging operation you needed to provide the server ID and full path to the imaging file. Because images are stored in a fixed location in ZENworks Configuration Management (see Section 3.10.2, Image file location in Configuration Management), you only need to provide the image filename (the .zmg file). For example, if you saved the image file in the default location, enter:

img -rp myimagefile.zmg

Because you can organize your images under the \images directory by adding subdirectories, the additional path where you created the image file should be provided. For example:

img -rp /windows/vista/myimagefile.zmg

3.10.4 Image Explorer help opens only in Firefox on Linux devices

When you launch Image Explorer in Linux, then click Help > Contents, the Firefox browser is opened by default.

Workaround: If you want to use any other HTML viewer, modify the ZMGEXP_HELP_BROWSER environment variable to point to the utility of your choice.

3.10.5 Static IP address allocation is not working after imaging a non-registered device

You can configure IP addresses for non-registered devices. Click the Configuration tab > Device Management > Preboot Services, under Non-Registered Device Settings click Specify Address List to expand the section, go to the IP Address Configuration panel and click Add to open the Range Information dialog box, then fill in the fields to specify an IP range for non-registered devices.

However, after a non-registered device is imaged, the allocation of IP addresses from the provided ranges does not work.

Workaround: None.

3.10.6 Shortcut files are not saved by Image Explorer

If you create a new image file in Image Explorer, then select a .lnk file for the image, instead of including the shortcut file, the file it points to is saved in the image.

For example, you open Image Explorer, click File > New, select a partition, click Image > Add Files, select a shortcut file that points to services.msc, then save the new image file. Instead of including the .lnk file that points to services.msc, services.msc itself is contained in the image.

Workaround: None.

3.10.7 Cannot create a multicast session that uses devices as a master

In previous versions of ZENworks you could specify a registered device as a master in a multicast session. However, in Configuration Management you can only point to a file and the users, and the time-out can be specified; you cannot specify a particular device as the master.

Workaround: None.

3.10.8 Windows Vista does not receive ISD from ziswin

After the ZENworks Adaptive Agent is installed and the device is rebooted for the first time, the device should receive its image safe data (ISD) when the operating system loads. However, Windows Vista devices only receive a device GUID and a device index in ISD (from the agent).

Workaround: Reboot the device again, and the remainder of the ISD is received from ziswin (the ZISD service).

3.10.9 Image Explorer does not save .lnk files

In Image Explorer, if you add shortcut icon file by using the Add Files option, then the actual .lnk file is not saved; however, only the actual file that the .lnk points to is saved. For example, if the shortcut is pointing to an .exe file, the original .exe file is saved but not the .lnk file.

Workaround: To add the .lnk file, use the Add Directory option.

3.10.10 The ziswin.chm help file is not installed

When installing Configuration Management, the help file (ziswin.chm) for the ZENworks Image Safe Data for Windows Editor does not get installed with its executable (ziswin.exe).

Workaround: Download the help file and install it manually:

  1. Under Help, click ZENworks Image Safe Data for Windows Editor to download the help file.

  2. Copy the file into the following path on your ZENworks 10 Windows server:

    installation_path/novell/zenworks/bin/preboot
    

    The preboot directory is where the ziswin.exe file resides.

3.11 Logging In

This section contains information about the issues that might occur when logging in to various locations in ZENworks Configuration Management.

3.11.1 Login to ZENworks Control Center fails in Internet Explorer when using unsupported DNS characters in the server name

A Microsoft security fix (see their knowledge base article 312461) disallows certain characters in DNS names by not returning cookies where those characters are used in the server’s name. Without cookies being returned, state information cannot be preserved across HTML requests, so the user cannot log in to ZENworks Control Center.

The only characters allowed in Windows for DNS names are the alphabetical characters (a‑z), numbers, and the hyphen. For example, you cannot use an underscore character. Use a hyphen instead.

This is not an issue with the Firefox browser, even when it is being run in Windows.

Workarounds:

  • Reference the IP address instead of its DNS name.

  • Reference a valid DNS name for the IP address the server is using. For example, your server name might be A_Server.mycompany.com, but the DNS registration for the IP address might be Aserver.mycompany.com, which will work.

  • If you will only use Internet Explorer to run ZENworks Control Center, do not use underscores in your server names.

3.11.2 Rebooting can take awhile after a Windows Vista device has been re-imaged

After an image containing the ZENworks Adaptive Agent has been restored on a Windows Vista device, nothing is displayed to indicate that anything is happening. After awhile, the device suddenly reboots.

Workaround: None.

3.12 Migration

This section contains information about the issues that might occur during migration to ZENworks Configuration Management.

3.12.1 An MSI created by the converter does not actually delete the registry string entries

If you create an Application object in ZENworks 7 that merely deletes a single registry string value, then migrate it to ZENworks 10, the Migration Utility converts the Application object to an MSI. However, the registry entry is not deleted when the migrated MSI is installed.

Workaround: None.

3.12.2 Application versions might not get migrated

When migrating applications, the application version might not get migrated. This happens if Windows .NET Framework 2.0 patch KB928365 has been applied to the device being used for migrating. This is an issue that requires Microsoft to fix in a future patch.

Workaround: To perform the migration of applications, use only a Windows device where patch KB928365 has not yet been applied.

3.12.3 The DNS settings of the ZENworks 10 Configuration Management device configured in the ZENworks Control Center are overwritten

When you migrate the network settings, including the DNS settings, of a non-registered traditional ZENworks device to a ZENworks 10 Configuration Management device, the DNS settings of the ZENworks 10 Configuration Management device configured in the ZENworks Control Center are overwritten.

Workaround: Do not migrate the DNS settings of the traditional ZENworks device. You must manually add the DNS setting as follows:

  1. In ZENworks Control Center, click Configuration.

  2. In the Management Zone Settings panel, click Preboot Services.

  3. Add the DNS settings in the Name Servers list.

3.12.4 Migration tool fails to connect to the server

If the password of the ZENworks 10 Configuration Management server contains extended characters, then the Migration tool fails to connect to the server.

Workaround: You must not use extended characters in the ZENworks server password.

3.13 Network Address Translation (NAT)

This section contains information about the issues that might occur when you use NAT with ZENworks Configuration Management.

3.13.1 Content is not pushed down to devices when using NAT

In both a public and private network where static NAT is configured between the networks, content might not be pushed down to the devices you are managing.

Workaround: Configure the DNS server with the DNS name of the ZENworks server, and map the DNS name to the public IP address.

3.14 Patch Management

This section contains information about the issues that might occur when you use Patch Management in ZENworks Configuration Management.

3.14.1 Vulnerabilities tab not showing any results

To enable the Patch Management feature, log in to ZENworks Control Center and go to the Configuration tab, select the Patch Management Services settings area, and click the Subscription Service Information link.

  1. Select a Windows or Linux Primary Server in your zone that can be used for patch subscription downloads.

    This server should have at least 2 GB RAM and 10 GB free disk space for patch storage. To identify the server, click the Start Service button.

  2. Select a daily subscription download time for when the patch subscription is downloaded to your Primary Server, then click OK.

At your predetermined time, the patch subscription downloads. This process takes 30 minutes longer, depending upon your Internet connection and processor speed.

When the download finishes, devices on your network are scanned automatically at their next refresh cycle, and results are displayed on the Vulnerabilities tab in ZENworks Control Center.

3.14.2 What do the Vulnerabilities icons mean?

Vulnerabilities that appear in the vulnerability list have icons that indicate their status:

  • Orange: The vulnerability signature and information has been downloaded. At this stage the vulnerability can be scanned for, but remediation cannot be assigned successfully.

  • Blue: Indicates that all information for this patch, including the patch installation file itself, have been cached down to the ZCM server. The patch remediation for this vulnerability is ready to be assigned to devices that require it.

  • Grey: Shows that the vulnerability has been disabled from the patch list and scanning for it is no longer required.

  • Red: Denotes a mandatory baseline patch that is auto-assigned to devices that require the patch within a particular group or dynamic group.

If you choose a vulnerability that does not have cached files, it is not automatically deployed to devices. You must download the files from the patch repository and they must be packaged by ZENworks Configuration Management. Then the icon turns blue.

To initiate an immediate download of these packages, select the Update Cache option from the Actions menu.

3.14.3 Deploy Remediation schedule does not work like in ZENworks Patch Management 6.3

The integrated ZENworks Patch Management feature leverages the bundle creation and assignment features of ZENworks and the ZENworks Adaptive Agent to perform the actual scheduling and delivery of patches.

There are many difference between the way scheduling works in the ZENworks Patch Management 6.3 product and the new integrated offering. You should start with deploy on refresh so that patches are deployed during the next refresh cycle.

Many other options are available, including Blackout Schedules and so forth. Please refer to the documentation on software delivery.

3.14.4 Viewing prior Deploy Remediation tasks

Every time you use the Deploy Remediation Wizard, it creates a Directive Bundle in the ZPM folder on the Bundles tab. Within each Directive Bundle, it is possible to see the exact sequence of patch remediation bundles that were deployed, as well as any reboot actions that were added at the end of deployment.

These Directive Bundles are named beginning with ZPM Assignment and contain the date and time of deployment within the bundle name.

3.14.5 The Advanced option is not available in Deploy Remediation

The Deploy Remediation Wizard step 4 has the Advanced button disabled in this release. It will be re-enabled in a future version of the integrated product. For now, the product allows assignment of patch remediation bundles quietly, either with or without a reboot at the end.

3.14.6 Content Unavailable on a patch delivery

If you choose a vulnerability that has not been cached to your ZENworks Server, Deploy Remediation can still be used to assign the patch to target devices; however, there might be some time required before the assignment can be successfully delivered while the patch is downloaded to the ZENworks Server. If a remediation bundle is delivered before its payload is downloaded, you may receive a Content Unavailable error, but the bundle will eventually be delivered fully (if it has a recurring assignment) after the patch payload files are cached to the ZENworks Server.

To initiate an immediate download of patch remediation bundles, use the Update Cache option from the Actions menu within any Vulnerabilities view.

3.14.7 Deploy Remediation bundle assignment sticks and doesn't run to completion

When using the Deploy Remediation feature to assign a sequence of patch remediation bundles to one or more devices in the network, a “stuck” state has been discovered where the ZENworks Adaptive Agent may attempt to repeatedly re-deploy the same patch sequence again and again, potentially including some unwanted additional reboots. At this time the root cause of this issue appears to be related to patch remediation bundles in the /ZPM folder that were not able to be fully downloaded prior to the agent starting its install process.

Workaround: The following workarounds are available for this issue, should the problem arise while using ZENworks:

  • Make sure that patch vulnerabilities to be deployed are all cached prior to using the Deploy Remediation wizard to deploy remediation to the devices on your network.

  • Allow plenty of elapsed time between the assignment of the patch remediation bundle and the device refresh cycle, so that the ZEnworks Server always has an opportunity to auto-cache and patch vulnerabilities that have yet to be downloaded.

  • Make sure that the ZEnworks Server where the Patch Management Service is running has a high bandwidth connection to the Internet, so that downloads of larger patches (such as Service Packs) can complete within 15 to 45 minutes maximum.

  • If a stuck assignment exhibits itself, the corresponding ZPM Assignment on MM/DD/YY bundle that is created in the /ZPM folder within Bundles can be deleted. This removes any assignments of that patch remediation bundle sequence from all devices, and thus stops any unwanted re-deployments from occurring.

With any patch remediation operation, it is always the best practice to test your sequence of patch remediation bundles on a limited set of test systems first, prior to deploying to a pilot deployment, and eventually rolling the patch sequence to the entire network.

3.15 Policies

This section contains information about the issues that might occur when you use policies in ZENworks Configuration Management.

3.15.1 General Policy Issues

  • On 64-bit versions of Windows Server 2003 servers, only the Browser Bookmarks policy, SNMP policy, Printer policy, Local File Rights policy, and the Windows Group policy device related settings are applied if they are associated to the device.

    Workaround: None.

  • If ZENworks Control Center is opened by more than one user at the same time and a new user source is added to the management zone by one of the users through ZENworks Control Center, the newly added user source is not reflected in all the open sessions of ZENworks Control Center. Consequently, the policies might not be assigned to the new user sources.

    Workaround: To assign policies to new user sources, re-log in to ZENworks Control Center.

3.15.2 Printer Policy Issues

  • Uninstall does not roll back the previously enforced Printer policies.

    Workaround: Disassociate the Printer policy from the users or devices to unenforce the policy. After unenforcing the policy, uninstall ZENworks.

  • The iPrint nipp.exe client installer does not support a silent installation.

    Workaround: Use iPrint nipp-s.exe or nipp.zip for a silent installation.

  • The policy does not support driver installation of .exe drivers.

    Workaround: None

  • The iPrint client is not supported on Windows Vista, or on 64-bit versions of Windows Server 2003 devices.

    Workaround: None.

3.15.3 Windows Group Policy Issues

  • The Windows Group policy containing the local group policy settings is not applied if the operating system of the device where the policy is applied is different from the device where the policy is created.

    Workaround: Remove the System Requirement from the Windows Group policy and apply the policy. However, the security settings are applied only if the operating system version of the device where the policy is applied is later than the operating system version of the device where the policy is created.

  • The Security settings configured in the Windows Group policy are not applied on the Windows XP managed devices.

    Workaround: Install Windows Hotfix KB897327 from the Microsoft Support Web site on the Windows XP managed devices.

  • In Internet Explorer on 64-bit Windows devices, the Group policy helper cannot be installed directly by clicking the Install Group Policy Helper link.

    Workaround: Save the novell-zenworks-grouppolicyhelper-10.0.1.0.msi package to your local device, then double-click the MSI to install the package.

  • On a managed device, .NET 2.0 must be installed to use the Group policy helper.

    Workaround: Download .NET 2.0 runtime from the Microsoft Download Center Web site, then install it on the device where you are browsing in ZENworks Control Center.

  • Software restrictions in security settings are not enforced if the Apply only security settings option is selected.

    Workaround: In the Computer Configuration tab, select Apply all settings to enforce the software restrictions.

  • If a Windows Group policy is associated with both devices and users, only the status of the last enforcement is displayed.

    The Windows Group policy settings are applied at different time intervals. The various device settings are applied when the device starts and the various user settings are applied when the user logs in. Therefore, if a Windows Group policy is associated with both devices and users and there are failures in the device settings but not in the user settings, a successful status is incorrectly displayed.

    Workaround: None.

  • The User Last and the Device Last Policy Conflict Resolution settings do not work.

    If both a user-associated policy and a device-associated policy are effective for a device, both policies have Administrative templates from the same Configuration type (either Computer Configuration or User Configuration), and if the Policy Conflict Resolution setting is User Last, the device-associated policy is applied first and the user-associated policy is applied later. However, the user-associated policy overwrites the Administrative templates configured by the device-associate policy.

    If the Policy Conflict Resolution setting is Device Last, then the user-associated policy is applied first, and the device-associated policy is applied later. However, the device-associated policy overwrites the Administrative templates configured by the user-associated policy.

    Workaround: None.

  • (Fixed in v10.0.2) The Group Policy tool does not launch on a Windows Vista machine if the User Account Control (Start > Settings > Control Panel > User Accounts) is enabled and Mozilla Firefox 2.0.0.8 or later is installed.

    Workaround: Configure Firefox to run with administrator credentials.

    • To configure Firefox for a session, right-click the Firefox shortcut icon on the desktop, then select Run as administrator.

    • To configure Firefox permanently:

      • 1. On the desktop, right-click the Firefox shortcut icon and select Properties. Click the Shortcut tab, then click the Advanced button. In the Advanced Properties dialog box, select Run as administrator.
      • or
      • In Windows Explorer, navigate to the Firefox executable file, right-click the file, then select Properties. Click the Compatibility tab, then select Run this program as an administrator.
      • 2. Restart the browser.

3.15.4 Browser Bookmarks Policy Issues

  • On a managed device, empty folders cannot be created in a user’s Favorites.

    Workaround: None.

  • On a managed device, uninstalling the Browser Bookmarks policy does not remove a user’s Favorites.

    Workaround: None.

3.15.5 Dynamic Local User Policy Issues

  • If both user-associated and device-associated policies are effective for a device, only the policy that takes precedence according to the Policy Conflict Resolution settings is applied. However, the Effective status for both policies is displayed as Success in the ZENworks Adaptive Agent icon.

    Workaround: None.

3.15.6 Roaming Profile Policy Issues

  • The Roaming Profile policy is not supported for the Windows Vista managed devices.

    Workaround: None.

3.16 Registration

This section contains information about the issues that might occur with registration in ZENworks Configuration Management.

3.16.1 The zac unregister command help does not explain the -f switch

If you type zac unr /?, the help shows an example using the -f switch, but doesn’t explain its purpose.

The -f switch forces a device to unregister in the event that the zac unregister command alone does not unregister the device.

3.17 Remote Management

This section contains information about the issues that might occur when you use the Remote Management feature in ZENworks Configuration Management.

3.17.1 Unable to lock mouse and keyboard on the Windows Vista managed devices during remote sessions

On Windows Vista managed devices, mouse and keyboard locks do not function if the Aero theme is enabled.

Workaround: Do not use the Aero theme.

3.17.2 Unable to use the login GINA to log in to the managed device

If you log out of a managed device when a Remote Management session is in progress, you might not be able to use the login GINA to log in to the managed device again.

Workaround: Restart the managed device.

3.17.3 Installation of the Remote Management viewer might fail

The Remote Management viewer installation might fail. This error is inherent to the MSI framework.

Workaround: Perform either of the following steps:

  • Uninstall the Remote Management viewer by using Add/Remove Programs, then reinstall it.

  • Use the Microsoft Windows Installer Cleanup Utility to clean up the application, then reinstall it. This utility can be downloaded from Microsoft Support.

3.17.4 Installation of the Remote Management viewer on Windows Server 2003 devices might fail

On Windows Server 2003 devices using Internet Explorer 6.0, installation of the Remote Management viewer might fail.

Workaround: Use Save As instead of the Run option while downloading the viewer, then execute the MSI.

3.17.5 The Remote Management viewer fails to launch on Windows Vista devices

On Windows Vista devices, the Remote Management viewer fails even though the security prompt is successfully completed.

Workaround: In the Internet Explorer browser’s security settings (Tools > Internet Options > Security), turn off the protected mode, then restart the browser.

3.17.6 During the Remote Control session, clicking the Ctrl+Alt+Del icon on the Remote Management viewer might display the Secure Attention Sequence window without any controls, such as Logout or Shutdown

Workaround: Click the Ctrl+Alt+Del icon on the Remote Management viewer, then press the Esc key to exit the Secure Attention Sequence (SAS) window. Then, click the Ctrl+Alt+Del icon again on the Remote Management viewer.

3.17.7 The Remote Management session might be slow on Windows Vista and 64-bit Windows Server 2003 operating systems

Workaround: None.

3.17.8 Blanking the screen of a Tablet PC managed device during a remote session degrades the session performance

Workaround: None.

3.17.9 The Override Screen Saver functionality is disabled for Vista platforms

Workaround: None.

3.17.10 The Ctrl+Alt+Del functionality is disabled for Vista platforms

Workaround: None.

3.17.11 In case of ZENworks 10 Configuration Management External Certificate Authority (CA) Server, if a Remote Management policy is assigned to the managed device and then unassigned, the default Remote Management policy that is created has the "SSLClientAuthentication" value set as true instead of false

Workaround: Do not unassign the Remote Management policy. If the policy has been already unassigned, then reassign a Remote Management policy to the device.

3.18 Reporting

The ZENworks Reporting solution is based on BusinessObjects Enterprise XI. This section contains issues that might occur when you use ZENworks Reporting.

3.18.1 Reporting Limitations

The ZENworks Reporting solution has the following limitations:

  • You cannot use Crystal Reports* with ZENworks Configuration Management Reporting Universe.

3.18.2 Reporting Issues

When you use the Reporting feature in ZENworks Configuration Management, you might see the issues listed below. To troubleshoot other error messages that you might encounter while working with BusinessObjects Enterprise XI, see the BusinessObjects XI Release 2 Error Message guide.

  • Reporting does not work if the ZENworks database is an SQL Server* database, and the authentication mode is Windows Authentication.

    Workaround: Do one of the following:

    • If the ZENworks database has not yet been installed, then select the SQL Server authentication mode during the ZENworks Configuration Management installation and ensure that the SQL Server is configured to use SQL Server Authentication.

    • If the ZENworks SQL Server database is in the Windows Authentication mode and the SQL authentication mode is selected during the ZENworks Configuration Management installation, do the following:

    1. Configure the DSN of the ZENworks database to set it to Windows NT Authentication:

      • 1a. From the desktop Start menu, click Settings, click Control Panel, then double-click ODBC Data Source.
      • The ODBC Data Source Administrator window is displayed.
      • 1b. Click the System DSN tab.
      • 1c. Select ZENworks Datastore, then click Configure.
      • The Microsoft SQL Server DSN Configuration window is displayed.
      • 1d. Click Next to accept the default data source name and SQL server name.
      • 1e. Select With Windows NT authentication using the network Login ID, then click Next.
      • 1f. Click Next to accept the default values.
      • 1g. Click Finish.
      • 1h. In the ODBC Microsoft SQL Server Setup window, click Test Data Source.
      • The following message is displayed:
      • Tests Completed Successfully.
      • 1i. Click OK.
    2. Edit the property of BusinessObjects Enterprise Services on the ZENworks server:

      • 2a. From the desktop Start menu, click All Programs > BusinessObjects XI Release 2 > BusinessObjects Enterprise > Central Configuration Manager.
      • The Central Configuration Manager window is displayed.
      • 2b. Right-click Web Intelligence Report Server, then click Stop.
      • 2c. Right-click Web Intelligence Report Server, then click Properties.
      • The Web Intelligence Report Server Properties window is displayed.
      • 2d. In the Log On As panel, deselect System Account, then specify the username and password of the domain account of the Windows server that hosts the MS SQL database.
      • 2e. Click OK.
      • 2f. Right-click Web Intelligence Report Server, then click Start.
      • 2g. Repeat Step 2b through Step 2f for all the services listed in the Central Configuration Manager window.
  • Reporting does not work if BusinessObjects Enterprise XI is installed on a Linux Primary server, and the ZENworks database is a Microsoft SQL 2005 Server database.

    Workaround: None.

  • The BusinessObjects InfoView might not be launched if the DNS name of the server with BusinessObjects Enterprise XI installed is not correctly resolved.

    Workaround: On the Windows server where ZENworks Control Center is launched, add the appropriate DNS entry in the %Windows_root%\systems32\drivers\etc\hosts file.

  • The BusinessObjects InfoView might not be launched if the BusinessObjects Enterprise XI is installed on a ZENworks Server that uses NAT.

    Workaround: On the Windows server where ZENworks Control Center is launched, add the appropriate DNS entry in the %Windows_root%\systems32\drivers\etc\hosts file.

3.19 User Sources

This section contains information about the issues that might occur with authoritative user sources in ZENworks Configuration Management.

3.19.1 LDAP cannot read extended characters

The LDAP user cannot access fully qualified contexts that contain extended characters.

Workaround: None.

3.20 ZENworks Adaptive Agent

This section contains information about the issues that might occur with the ZENworks Adaptive Agent in ZENworks Configuration Management.

3.20.1 Linux Servers are not managed devices even though the Adaptive Agent is installed on them

The ZENworks Adaptive Agent is installed on Linux Primary Servers to enable software updates. Although Linux servers appear as managed devices in ZENworks Control Center, any actions performed on them, such as assignments, QuickTasks, and so on, will fail.

3.20.2 The ZENworks Adaptive Agent UI shows both English and the local language chosen for viewing

ZENworks resources are loaded according to the locale of the process that retrieves them. When using regional settings, the ZENworks Windows service might be configured to use a different language than the user is configured to use. The result is that the strings from both languages are displayed.

Workaround: Do one of the following:

  • Install the native language operating system

  • Change the default user language to match the language displayed by the user

3.21 ZENworks Control Center

This section contains information about the issues that might occur when using ZENworks Control Center in ZENworks Configuration Management.

3.21.1 An HTTP request is not redirected to HTTPS if IIS is running on the Primary Server

During installation, the setup checks to see if the default HTTP port (80) and HTTPS port (443) are in use. If the ports are in use by another application (such as IIS), you are prompted to use alternative ports. In this case, you must access ZENworks Control Center via the port it is using and not access IIS.

Workaround: While http://Primary_Server_IP_address works if ZENworks Control Center is using port 80, http://Primary_Server_IP_address:### (where ### is the port Tomcat is using) always works.

3.21.2 MS SQL Server 2005 provides multiple collation options that affect how lists display in ZENworks Control center

When Microsoft SQL Server 2005 is installed on non-English (U.S.), locales there are differing sort orders and collations offered. This means that the ordering of lists in ZENworks Control Center is affected, including devices, bundles, and so on.

Workaround: When you install an SQL Server, it selects a default based on the locale of the server. Review the Microsoft documentation to determine which collation option to use when installing your MS SQL Server.

3.22 Zman

This section contains information about the issues that might occur when you use the zman command in ZENworks Configuration Management.

3.22.1 When running the zman command in Linux, the password appears in plain text when switching from one user to another user

zman disables the echoing of passwords in Linux by turning the echo off on the controlling terminal. For example, /dev/pts/0. When you switch from one user to another user, the new user does not have the file permissions on the controlling terminal.

Workaround: Before switching to the new user, give Read and Write file permissions to the new user on the controlling terminal. Run tty to display the current controlling terminal.

3.22.2 Zman help does not display in Chinese

Using the man zman command for Simplified Chinese and Traditional Chinese doesn’t display any help. It only displays the tilde (~) character.

Workaround: None.

3.22.3 The zman reporting commands do not work for non-root users on a ZENworks Linux server

If a non-root user executes the zman reporting commands on a ZENworks Linux server, the following error message is displayed:

Failed to connect CMS server.for more information see the zman log.

Workaround: Add the non-root user to the zmanusers group before executing the zman reporting commands.

  1. Log in to the ZENworks server as root.

  2. At the server console prompt, execute the following command:

    useradd -G zmanusers non-rootusername

  3. Log in to the ZENworks server as a non-root user.

4.0 Documentation Conventions

In this documentation, a greater-than symbol (>) is used to separate actions within a step and items in a cross-reference path.

A trademark symbol (®, ™, etc.) denotes a Novell trademark; an asterisk (*) denotes a third-party trademark

5.0 Legal Notices

Novell, Inc. makes no representations or warranties with respect to the contents or use of this documentation, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to revise this publication and to make changes to its content, at any time, without obligation to notify any person or entity of such revisions or changes.

Further, Novell, Inc. makes no representations or warranties with respect to any software, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to make changes to any and all parts of Novell software, at any time, without any obligation to notify any person or entity of such changes.

Any products or technical information provided under this Agreement may be subject to U.S. export controls and the trade laws of other countries. You agree to comply with all export control regulations and to obtain any required licenses or classification to export, re-export, or import deliverables. You agree not to export or re-export to entities on the current U.S. export exclusion lists or to any embargoed or terrorist countries as specified in the U.S. export laws. You agree to not use deliverables for prohibited nuclear, missile, or chemical biological weaponry end uses. Please refer to the Novell International Trade Services Web page for more information on exporting Novell software. Novell assumes no responsibility for your failure to obtain any necessary export approvals.

Copyright © 2008 Novell, Inc. All rights reserved. No part of this publication may be reproduced, photocopied, stored on a retrieval system, or transmitted without the express written consent of the publisher.

Novell, Inc. has intellectual property rights relating to technology embodied in the product that is described in this document. In particular, and without limitation, these intellectual property rights may include one or more of the U.S. patents listed on the Novell Legal Patents Web page and one or more additional patents or pending patent applications in the U.S. and in other countries.

For Novell trademarks, see the Novell Trademark and Service Mark list.

All third-party trademarks are the property of their respective owners.