The information in this Readme file pertains to Novell ZENworks for Desktops 3.2 Support Pack (SP) 3.
This Support Pack contains updates for all components contained in the ZENworks for Desktops product only. If the Support Pack file was downloaded, it must be extracted at the root of the drive because it contains directory paths that could exceed the DOS limits.
The purpose of this Support Pack is to provide a bundle of fixes that have all been tested together. These files have undergone component testing, core OS testing, and integration testing with other Novell products.
This Support Pack includes all fixes from the previous ZENworks for Desktops 3.2 Support Packs; therefore, you do not need to install ZENworks for Desktops 3.2 SP1 or ZENworks for Desktops 3.2 SP2 before installing this Support Pack.
Do not install individual files from the Support Pack.
Install the NetWare Support Pack before installing other Novell product support packs like GroupWise and ZENworks for Servers. These Support Packs are included with the Consolidated Support Pack, or they can be downloaded individually from the Consolidated Support Pack file download Web page.
For information on the latest Support Pack issues, see TID 10085454 at the Support Connection Web site .
To order the Support Pack CD, go to the Consolidated Support Pack Ordering Information Web page.
ZENworks for Desktops does not support workstations that have more than one network interface card. This hardware configuration may also be called "multi-homed" workstations or "dual NIC" workstations.
The ZENworks for Desktops Remote Management component does not work properly when imported workstations have more than one network interface card.
If you run the ZENworks for Desktops 3.2 SP3 installation program from a folder with a long name on a Windows 2000 server or workstation, you might receive the following message:
Launch.exe has generated errors and will be closed by windows...
The installation fails at this point.
To avoid the error, make sure you run the installation from a location with a short folder name. We recommend copying the self-extracting file (zfd32sp3.exe) for ZENworks for Desktops 3.2 SP3 to the root of a local or server drive, then running the .exe at that location.
If you want to install ZENworks for Desktops 3.2 SP3 into a Novell eDirectory 8.7 tree from a Windows* 2000 server that is also running eDirectory 8.7, you first need to delete the c:\program files\common files\novell\jre directory on the Windows 2000 server.
If you do not delete this directory, the installation will freeze and the following message will be displayed:
Checking for previous installations of ZENworks for Desktops
If you want to install ZENworks for Desktops 3.2 SP3 from a Windows workstation or server where ConsoleOne 1.3.4 is installed, you first need to delete the windows_installation_drive\program files\common files\novell\jre directory on the Windows server or workstation.
If you do not delete this directory, the installation does not proceed after the Novell eDirectory tree selection page of the installation is displayed.
If you want to install ZENworks for Desktops 3.2 SP3 over a previous version of ZENworks for Desktops 3.2 or ZENworks for Desktops 3.2 SP1 (both installed with the Novell Installation Service---NIS), you first need to delete the windows_installation_drive\program files\common files\novell directory on the Windows server or workstation.
If you do not delete this directory, the following error will be displayed:
ZfD 3.2 (ZENworks for Desktops 3.2) has not been installed on the selected tree.
This support Pack must be installed on a tree that has ZENworks for Desktops 3.2 installed.
Please choose a tree that has ZENworks for Desktops 3.2 installed.
You could also see other problems in the installation, such as failure to run or other error messages being displayed.
When run in verbose mode (/v), zenver.exe, the file version checking utility that ships with ZENworks for Desktops, reports the versions of the ZENworks for Desktops files only under the public directory and below.
If you have installed some ZENworks for Desktops files (for example, ConsoleOne files) in locations other than under the public directory, you can work around the version reporting problem by manually editing zenver.txt (located in the public directory). Search and replace the path to the files you want to check with a path that includes public.
If the scanner is running on the workstations, the ZENworks for Desktops 3.2 SP3 installation will not overwrite the files.
To work around this situation, follow these steps on the servers where inventory is installed:
In Windows Explorer, right-click the scanner file, ntscan32.exe, in the public\zenworks directory > click Properties > NetWare Rights.
Double-click [Root]. In the Trustees option, uncheck the Read [R] and the FileScan [F] rights, click Apply, then click Close.
In Windows Explorer, right-click the Scanner file, winscan.exe, in the public\zenworks directory > click Properties > click NetWare Rights. Follow Step 2.
Wait for some time before proceeding with the installation. This is required if the scanning is still in progress.
If the scanner does not complete the scanning process or if the Scanner crashes, see the Workstation Inventory Troubleshooting documentation at the ZENworks for Desktops 3.2 documentation Web site.
Complete the ZENworks for Desktops 3.2 SP3 installation.
In Windows Explorer, right-click the public\zenworks\ntscan32.exe file > click Properties > click NetWare Rights.
Double-click [Root]. In the Trustees option, check the Read [R] and FileScan [F] rights, click Apply, then click Close.
In Windows Explorer, right-click the public\zenworks\winscan.exe file > click Properties > NetWare Rights.
Double-click [Root]. In the Trustees option, check the Read [R] and FileScan [F] rights, click Apply, then click Close.
If the scanner is running on the workstations, the ZENworks for Desktops 3.2 SP3 installation will not overwrite the files.
To work around this situation, follow these steps on the servers where inventory is installed:
In Windows Explorer, right-click ntscan32.exe in the public\zenworks directory > click Properties > click Security > Permissions.
Click Add, select Administrators, then click Add. In the Permissions box, select Full Control, then click OK.
From the list, click Everyone, click Remove, click OK, then OK again.
In Windows Explorer, right-click winscan.exe in the public\zenworks directory > click Properties > Security > Permissions.
Click Add, select Administrators, then click Add. In the Permissions box, select Full Control, then click OK.
From the list, click Everyone, click Remove, click OK, then click OK again.
Complete the ZENworks for Desktops 3.2 SP3 installation.
In Windows Explorer, right-click ntscan32.exe in the public\zenworks directory > click Properties > click Security > Permissions.
Click Add, select Everyone, then click Add. In the Permissions box, select Full Control, then click OK.
From the list, click Administrators, click Remove, click OK, then click OK again.
In Windows Explorer, right-click winscan.exe in the public\zenworks directory > click Properties > Security > Permissions.
Click Add, select Everyone, then click Add. In the Permissions box, select Full Control, then click OK.
From the list, click Administrators, click Remove, click OK, then click OK again.
If you choose to run the ZENworks for Desktops 3.2 SP3 installation program from a Windows NT/2000 workstation that has Pentium 4 processor, you will encounter an error during the installation, but the installation will proceed.
To resolve this problem, download and install the latest version of JRE 1.2.2 or JRE 1.3.1 from the Java 2 Standard Edition download Web site on the Windows NT/2000 workstation that has the Pentium 4 processor before you run the ZENworks for Desktops 3.2 SP3 installation program.
ZENworks for Desktops 3.2 Support Pack 3 has been tested on NetWare 6.5 servers where Support Pack 1 has been installed.
If the Workstation Inventory component fails to start after installing on a NetWare 6.5 server, edit sys:\system\autoexec.ncf to add the following line after the zfdstart.ncf entry:
sys:\system\startinv.ncf
If you move a server to a different eDirectory container after you install ZENworks for Desktops 3.2, Automatic Workstation Import no longer works. The following error is included in the wsreg32.log file:
Policy not found.
This error occurs because the server location for the Workstation Import policy is recorded in zenwsimp.ncf. Even though you move the server, the original container location remains in the .ncf file.
To work around this problem, edit the zenwsimp.ncf file to show the current server location in the eDirectory tree.
If you enable personal folders as you configure the Novell Application Launcher snap-in for ConsoleOne, users with the Windows XP operating system who rename folders in Application Explorer view will notice that the act of renaming a personal folder actually creates a new folder instead. The issue occurs only when the following steps are used:
Enable personal folders in ConsoleOne.
From a Windows XP workstation, open the Application Explorer view.
Right-click the personal folder > click Explore.
Create one or more new folders > rename a folder.
A new folder is created.
Users can work around this problem by closing the Application Explorer view and then reopening it. The view will open without displaying a duplicate folder with the original name.
If you launch a DeFrame terminal session from Novell Portal Services or from the Novell Application Launcher using the Remote Management console on a Windows 98 workstation, the following error is displayed:
Zenrc32 caused an invalid page fault in module Zenrc32.exe.
The Remote Management session ends but the terminal session continues normally.
To work around the problem, launch the OnDemand/DeFrame terminal session before you begin the Remote Management session.
ATI display adapters do not support the Screen Blanking feature of Remote Management. The managed workstation screen will not be blanked when these adapters are used.
If you install ZENworks for Desktops 3.2 and ZENworks for Desktops 3.2 SP3 on a NetWare server that has JVM* 1.2.2 or 1.3.x installed, or if you upgrade the JVM to version 1.2.2 or to version 1.3.x on a NetWare server after you install ZENworks for Desktops 3.2 and ZENworks for Desktops 3.2 SP3, the Inventory server components will not work.
To resolve this problem, download and install the zd3xjvm.exe patch. This patch is referenced in TID 2962013 in the Knowledgebase at Novell Support.
When you install ZENworks for Desktops 3.2 SP3 Workstation Inventory on a Windows NT/2000 server, the installation program will automatically copy the JRE 1.2.2_011 to the server. DBExport might not work if you have installed other JREs separately.
Use the following procedure if DBExport fails to run in an isolated mode on a Windows NT/2000 server.
Append the following entry to SYS share\public\zenworks\wminv\bin\javadir.bat:
set path=%java_dir%\bin;%java_dir%\njclv2\bin;%path%
Enter the following string at the server console prompt to run dbexport.bat:
DBEXPORT <configuration_filename>.exp <csv_filename>.csv
where <configuration_filename>.exp is an existing file that contains the data export settings and <csv_filename>.csv is the filename where the data exported from the database will be stored.
If the software inventory report shows more than one installed copy of a software program that was actually installed on a workstation only once, edit the sys:\public\zenworks\swrules.ini file on the Inventory server and add the following contents at the end of the file:
[SOFTWARE]
doMaxVersionSWScan=True
If the swrules.ini file already has a [SOFTWARE] section, you only need to add this new content in the existing section.
NOTE: By default, the value of doMaxVersionSWScan is set to FALSE.
If the Workstation Inventory scanner continuously scans the workstation floppy disk, edit the sys:\public\zenworks\swrules.ini file on the Inventory server and add the following contents at the end of the file:
[SOFTWARE]
doMSIScan=TRUE
If the swrules.ini file already has a [SOFTWARE] section, you only to add this new content in the existing section.
NOTE: By default, the value of doMSIScan is set to FALSE.
If you install ZENworks for Desktops 3.2 Workstation Inventory on a Windows NT/2000 server that has a Pentium 4 processor, the JRE that is installed with the component does not support the Pentium 4 processor. Consequently, the Inventory service fails to start. No error message is displayed on the server.
Use the following steps on the Windows NT/2000 Inventory server to resolve the problem:
Download the latest version of JRE 1.2.2 or JRE 1.3.1 from the Java 2 Standard Edition download Web site.
If the Inventory service is running, stop it.
On a Windows NT Inventory Server: At the Windows Control Panel, double-click Services, select ZENworks Inventory Service, then click Stop.
On a Windows 2000 Inventory Server: At the Windows Control Panel, double-click Administrative Tools, double-click Services, select ZENworks Inventory Service, then click Stop.
Install the downloaded JRE on the Inventory server.
Copy zenws.dll from workstation_inventory_installation_directory\zenworks\jre\1.2\bin to JRE_installation_directory\bin.
JRE_installation_directory is the location where you have installed the downloaded JRE.
Copy zencommon.jar and zenws.jar from workstation_inventory_installation_directory\zenworks\jre\1.2\lib to JRE_installation_directory\lib.
Copy the njclv2 directory from workstation_inventory_installation_directory\zenworks\jre\1.2 to JRE_installation_directory.
Edit workstation_inventory_installation_directory\public\zenworks\wminv\bin\zensetenv.ini to change all instances of workstation_inventory_installation_directory\zenworks\jre\1.2 to JRE_installation_directory.
If the JRE_installation_directory pathname contains a space, you must enter the complete pathname containing JRE_installation_directory within double quotes.
For example: If the recommended JRE is installed in c:\program files\java, change workstation_inventory_installation_directory\zenworks\jre\1.2\lib\zenws.jar to "c:\program files\java\lib\zenws.jar".
Edit workstation_inventory_installation_directory\public\zenworks\wminv\bin\javadir.bat to change all instances of workstation_inventory_installation_directory\zenworks\jre\1.2 to JRE_installation_directory.
If the JRE_installation_directory pathname contains a space, you must enter the complete pathname containing JRE_installation_directory within double quotes.
For example: If the recommended JRE is installed in c:\program files\java, change workstation_inventory_installation_directory\zenworks\jre\1.2\lib\zenws.jar to "c:\program files\java\lib\zenws.jar".
Start the Inventory service.
On a Windows NT Inventory Server: At the Windows Control Panel, double-click Services, select ZENworks Inventory Service, then click Start.
On a Windows 2000 Inventory Server: At the Windows Control Panel, double-click Administrative Tools, double-click Services, select ZENworks Inventory Service, then click Start.
If you are running ZENworks for Desktops 3.2 Inventory services on a Novell Cluster Services node and then you migrate services from that cluster node to another cluster node, the Inventory service does not start on the new node.
If the cluster services fail over to a secondary node and then fail back to the primary node, Inventory services fail to start on the primary node.
To resolve this problem, use the workaround information available in TID 10087682 in the Novell Knowledgebase.
If you upgrade from ZENworks for Desktops 3.2 SP3 to ZENworks for Desktops 4, the ZENworks for Desktops 4 installation program does not overwrite some ZENworks for Desktops 3.2 SP3 files because the ZENworks for Desktops 3.2 SP3 file dates are later than the ZENworks for Desktops 4 file dates.
TID 10076066 in the Novell Knowledgebase lists the ZENworks for Desktops 3.2 SP3 files that must be renamed to work around this problem.
For information on the ZENworks for Desktops 3.2 issues addressed by fixes in Support Pack 3, see TID 10081470 in the Novell Knowledgebase.
For installation instructions, see zfd32sp3.txt located at the root of the Support Pack.
For updated ZENworks for Desktops 3.2 product documentation (including Support Pack updates) see http://www.novell.com/documentation/lg/zdfs/index.html
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 (®, TM, etc.) denotes a Novell trademark; an asterisk (*) denotes a third-party trademark.
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.
You may not export or re-export this product in violation of any applicable laws or regulations including, without limitation, U.S. export regulations or the laws of the country in which you reside.
Copyright © 2003 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.
U.S. Patent Nos. 5,349,642; 5,594,863; 5,633,931; 5,692,129; 5,758,069; 5,761,499; 5,781,724; 5,781,733; 5,859,978; 5,893,118; 5,905,860; 6,023,586; 6,047,312; 6,061,743; 6,105,069; 6,115,549; 6,173,289; 6,144,959. Patents Pending.
ConsoleOne, GroupWise, NetWare, Novell, and ZENworks are registered trademarks of Novell, Inc. in the United States and other countries, and DeFrame, eDirectory, Novell Application Launcher, and ZENworks OnDemand Services are trademarks of Novell, Inc.
All third-party products are the property of their respective owners.