Novell ZENworks 10 Asset Management SP3

January 19, 2011
5.8 Zman

1.0 Overview

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

For system requirements and installation instructions, see the Novell ZENworks 10 Asset Management Installation Guide.

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

This product contains undocumented utilities that Novell Support might use to diagnose or correct problems.

2.0 Readme Updates

The following table contains information on the documentation content changes that were made in this Readme after the initial release of ZENworks 10 Management SP3 (10.3):

Table 1 Readme Updates

Date

Readme Item Added or Updated

July 27, 2010

3.0 Upgrading to ZENworks 10 Asset Management SP3

You can upgrade Primary Servers and managed devices directly to ZENworks 10 Asset Management SP3 from the following versions:

  • ZENworks 10 Asset Management SP2 (10.2)

  • Update for ZENworks 10 Asset Management (10.2.1)

  • Update for ZENworks 10 Asset Management (10.2.2)

For detailed information about upgrading from a previous version of ZENworks 10 Asset Management to ZENworks 10 Asset Management SP3, see the ZENworks 10 Asset Management SP3 Upgrade Guide.

In ZENworks 10 Asset Management SP3, the registry structure has changed from HKLM\Software\Novell\ZENworks to HKLM\Software\Novell\ZCM. When you upgrade from a previous version of ZENworks 10 Asset Management to ZENworks 10 Asset Management SP3, the registry structure changes are automatically made.

IMPORTANT:If you have only ZENworks 10 Asset Management SP2 installed (without ZENworks 10 Configuration Management), and the Installed check box for the User Management agent feature is selected in ZENworks Control Center (Configuration > Device Management > ZENworks Agent), you must do the following before upgrading from ZENworks Asset Management 10.2.x to ZENworks 10 Asset Management SP3:

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

  2. In the Management Zone Settings panel, click Device Management.

  3. Click ZENworks Agent.

  4. Deselect the Installed check box next to User Management, then click Apply.

  5. Select the Installed check box next to User Management, then click Apply.

4.0 Issues Resolved in ZENworks 10 Asset Management SP3

For a list of the resolved issues in ZENworks 10 Asset Management SP3, see TID 7005455 in the Novell Support Knowledgebase.

5.0 Known Issues

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

5.1 Installation

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

5.1.1 Time synchronization causes invalid certificate errors

If time is not synchronized on the network before you install the ZENworks services, you might 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 ZENworks services. Make sure to include ZENworks back-end servers in the synchronization.

5.1.2 Command line installation on a Linux server with the MS SQL Server or Oracle database fails

During the command line installation of ZENworks 10 Asset Management SP3 on a Linux* server, if you choose to create an MS SQL Server* database or an Oracle* database, and subsequently specify an existing database username, the installation fails at the end.

Workaround: Specify a new database username while creating the database.

5.1.3 You might be prompted to reboot the ZENworks Server twice if only ZENworks Asset Management is installed on the server

The installer prompts for the first reboot after completing the installation of ZENworks Asset Management. The server prompts for a reboot again to remove any additional packages that might have been installed while installing ZENworks Asset Management.

Workaround: None

5.1.4 You are not prompted to configure any other port if port 2645 is busy

In the ZENworks 10 Asset Management SP3 Installation Wizard, the Select ZENworks Ports page does not prompt you to configure any other port if port 2645 is busy. The installation proceeds but authentication to the user source might not work.

Workaround: Before you install ZENworks 10 Asset Management SP3, make sure that port 2645 is free.

5.1.5 Unable to connect to the default ZENworks Adaptive Agent installed with ZENworks 10 Asset Management on SLES 11

(Fixed in v10.3.1) When you install ZENworks 10 Asset Management on SLES 11, the server components and default ZENworks Adaptive Agent are installed. However, the ZENworks Server is unable to connect to the default agent because the default port 7628, which is used by the ZENworks Adaptive Agent, is not automatically opened. The following message is displayed in ZENworks Control Center (Devices > Servers > click the device > Summary > ZENworks Agent Status):

Unable to connect through IP Address or Host Name

Workaround: Do one of the following:

  • Manually open port 7628.

  • Disable the firewall settings.

5.1.6 The ZENworks 10 ConfigurationAsset Management SP3 (10.3.0) Vista managed device registered to a ZENworks 10 ConfigurationAsset Management SP3 Primary Server fails to contact the server after you upgrade the server to ZENworks 11

If you have a Windows Vista managed device that has ZENworks 10 ConfigurationAsset Management SP3 (10.3.0) registered to a ZENworks 10 ConfigurationAsset Management SP3 Primary Server, the managed device fails to contact the server after you upgrade the server to ZENworks 11.

Workaround: To reconnect the managed device with the ZENworks 11 Primary Server, do one of the following:

Option 1: Upgrade the managed device to 10.3.1, and then to ZENworks 11.

Option 2: If you choose not to upgrade the managed device to ZENworks 11, unregister the device from the ZENworks ConfigurationAsset Management 10.3 zone and manually register it to the ZENworks 11 Primary Server by using the zac reg command.

5.2 Accessibility

This section contains information about accessibility issues with ZENworks Asset Management.

5.2.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. When you do this, mouse functions are controlled by using the numeric keypad.

5.3 Authentication

This section contains information about issues that might occur with Authentication.

5.3.1 You must restart the ZENworks Services after Changing authentication mechanisms for an authentication server

If you change the Authentication mechanism for an Authentication server, you must stop and restart the ZENworks services before the change takes effect.

5.4 Remote Management

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

5.4.1 On a Windows XP device, the installation of ZENworks Adaptive Agent with the Remote Management component through Remote Desktop Connection fails

If you remotely connect to a managed device through 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: To fix the issue, download the patch from Microsoft Support Web site and install it on the managed device.

5.5 Reporting

The ZENworks Reporting solution is based on BusinessObjects Enterprise* XI. This section contains issues that might occur when you use ZENworks Reporting. To troubleshoot other error messages that you might encounter while working with BusinessObjects* Enterprise XI, see the BusinessObjects XI 3.1 documentation Web site.

5.5.1 The report layouts of the predefined reports can be modified only by the user who logs in to ZENworks Reporting Server with the username as Administrator

Modifying the report layouts of the predefined reports is not recommended.

5.5.2 Unable to launch the ZENworks Reporting Server InfoView after the session has expired

You might encounter the following error message when the ZENworks Reporting Server InfoView session expires:

Unable to reconnect to the CMS <server-name>:6400. The session has been logged
off or has expired. (FWM 01002)

Workaround: Do the following:

  1. Delete the cookies from your browser.

  2. Close all browser instances.

  3. Log in to ZENworks Control Center, then launch the ZENworks Reporting Server InfoView.

5.5.3 Closing the ZENworks Reporting Server InfoView page without logging out to end the session fails to relaunch the ZENworks Reporting Server InfoView

Workaround: Click ZENworks Reporting Server InfoView (ZENworks Control Center > Reports) two times to relaunch the ZENworks Reporting Server InfoView page.

All the cookies that were created in the prior session are deleted on the first click, and the ZENworks Reporting Server InfoView page is displayed on the subsequent click.

To end the ZENworks Reporting Server InfoView session, ensure that you click Logout on the ZENworks Reporting Server InfoView page.

5.5.4 Unable to launch the ZENworks Reporting Server InfoView

This problem might occur if the Central Management Server failed to start. The following error message is displayed in the %zenworks_home%\logs\zcc.log file:

cause:com.crystaldecisions.enterprise.ocaframework.OCAFrameworkException$NotFoundInDirectory: Server <Server_name>:6400 not found or server may be down (FWM 01003)
cause:java.net.ConnectException: Connection refused: connect
detail:Server <Server_name>:6400 not found or server may be down (FWM 01003) Connection refused: connect
detail:Server <Server_name>:6400 not found or server may be down (FWM 01003) Connection refused: connect

Workaround 1: See the Business Objects Board forum.

Workaround 2: Contact Novell Support.

5.5.5 The Report Engine Server fails to initialize after installing ZENworks Reporting Server

The following error message is displayed when the Report Engine Server fails to initialize:

Cannot initialize Report Engine server. (Error: RWI 00226) (Error: INF)

This problem might occur if the Report Engine Server is not running, and you are trying to create or access the reports.

Workaround: Manually initialize the Report Engine Server before launching the ZENworks Reporting Server InfoView:

On Windows: Restart the Server Intelligence Agent:

  1. From the desktop Start menu, click Programs > ZENworks Reporting Server > ZENworks Reporting Server > Central Configuration Manager > Server Intelligence Agent to display the Central Configuration Manager window.

  2. Click Restart.

  3. Wait 2 to 3 minutes for the services to restart.

On Linux: Restart the BusinessObjects Enterprise services:

  1. Stop the BusinessObjects Enterprise services by running the following command as a root user:

    /etc/init.d/BobjEnterprise120 stop

  2. Wait 2 to 3 minutes for all the services to stop.

  3. Start the BusinessObjects Enterprise services by running the following command as a root user:

    /etc/init.d/BobjEnterprise120 start

  4. Wait 2 to 3 minutes for all the services to start.

5.5.6 ZENworks Reporting might fail when you log in to ZENworks Control Center by using an administrator account that was created in ZENworks 10 Asset Management SP2

ZENworks Reporting might not contain a reference to users that were created by using the ZENworks 10 Asset Management SP2 user source. Therefore, ZENworks Reporting fails when you log in to ZENworks Control Center by using an administrator account (such as Administrator@windowdomain.com) created in ZENworks Asset Management 10 SP2.

Workaround: On the ZENworks Reporting Server, use the following command to create users for the administrator account that was created by using the ZENworks 10 Asset Management SP2 user source:

zman rpau complete_user_name

where the complete_user_name is the administrator account, such as Administrator@windowdomain.com.

5.5.7 ZENworks Reporting might display inaccurate data if the Installation dimensions are added to Suites or Software Collections reports

In the ZENworks Reporting Server InfoView, the Suites or Software Collection reports display inaccurate data if you add Installation dimensions to them. The Installation dimensions are located in ZENworks Universe > Asset Management > Licensed Products > Discovered Products.

Workaround: None.

5.5.8 The User Details Report data is not displayed if you choose to view it in a new browser window in Firefox 3.5

If you launch the ZENworks Reporting Server InfoView in Firefox 3.5, and you select New Window as the target window in the Create Hyperlink dialog box while linking a ZENworks Report to a User Details Report, the User Details Report data is not displayed in the new browser window.

Workaround: While linking a ZENworks Report to a User Details Report in a Firefox 3.5 browser, select Current Window as the target window in the Create Hyperlink dialog box.

5.5.9 If ZENworks Reporting Server is installed on a Linux Primary Server, reporting does not work

If ZENworks Reporting Server is installed on a Linux Primary Server, reporting does not work if the ZENworks database is an MS SQL Server database and the authentication mode is Windows Authentication.

Workaround: See TID 7006288 at Novell Support.

5.5.10 The rpsv and rpgn reporting zman commands fail on SLES 10

Workaround: Before executing the rpsv and rpgn commands, ensure that the specified destination path has the read-write-execute (rwx) permissions for all Linux users.

5.6 ZENworks Adaptive Agent

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

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

5.6.2 Uninstallation of the User Management Agent Feature on a Windows 2000 device fails

If you deselect the User Management Agent Feature in ZENworks Control Center (Agent Features panel on the ZENworks Agent page), the User Management feature is not uninstalled on a Windows 2000 device.

For more information on customizing the agent features, see Customizing the Agent Features.

Workaround: None.

5.7 ZENworks Control Center

This section contains information about issues that might occur when you use ZENworks Control Center.

5.7.1 Login to ZENworks Control Center fails in Internet Explorer when there are unsupported DNS characters in the server name

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

The only characters allowed for DNS names in Windows 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 Mozilla Firefox browser, even when it runs on 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 use only Internet Explorer to run ZENworks Control Center, do not use underscores in your server names.

5.7.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.), there are differing sort orders and collations offered. This means that the ordering of lists in ZENworks Control Center is affected, including devices 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.

5.8 Zman

This section contains information about issues that might occur when you use the zman command line utility.

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

6.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 © 2010-2011 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.

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

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