Server Update Readme

ZENworks for Desktops 3.2 Support Pack 1

December 12, 2002

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

November 5, 2002 = 3.6.1 (reference to batch file removed)
November 13, 2002 = 1.1 (clarification: ZfD 3.2 Preboot Services updates are integrated into SP1)
December 12, 2002 = 2.2 (added an important note to emphasize the need to have Admin rights to install)

Table of Contents

1.0  Overview

The ZENworks® for Desktops (ZfD) 3.2 Support Pack 1 (SP1) download contains updates for the ZfD server components contained in the original shipping version of ZENworks for Desktops 3.2. All previous field patches supplied by Novell® Support, including any consolidated field patches, are contained in this support pack.

The purpose of ZfD 3.2 SP1 is to provide a bundle of ZfD 3.2 fixes that have been tested together. ZfD 3.2 also includes changes that support the use of ZfD components on Windows XP Professional workstations. The ZfD 3.2 SP1 files have undergone component testing, core OS testing, internationalization testing, and integration testing with other Novell products.

The ZfD 3.2 SP1 server-side update must be used in conjunction with the ZfD 3.2 SP1 client-side update for user workstations. The client update can be downloaded from TID 2963840 at the Novell Support Connection Web site at http://support.novell.com. For more information, refer to the Readme file, ZFD32SP1CLIENT.TXT, that ships with the client update.

Information about the new features and updates included in the ZfD 3.2 Support Pack are included in ZfD 3.2 product documentation at
http://www.novell.com/documentation/lg/zdfs/index.html.

[Contents]

1.1  ZENworks Preboot Services Updates Are Integrated into ZfD 3.2 SP1

Although ZENworks for Desktops 3.2 Preboot Services originally shipped as a separate product, files to update the shipping version of that product are included in this support pack.

[Contents]

2.0  Downloading and Installing ZfD 3.2 SP1

2.1  Downloading the Server-Side Update of the Support Pack

The ZfD 3.2 SP1 server-side update (ZFD32SP1SERVER.EXE) can be downloaded from TID 2963839 at the Novell Support Web site at http://support.novell.com. Use the following steps to perform the download:

  1. Click the file link to open a Global Download page on the Novell Support site.
  2. Select an HTTP or FTP server and click its link to open the download dialog box.
  3. Follow the prompts to copy the download file to the network path of your choice.
[Contents]

2.2  Installing the Server-Side Update of the Support Pack

When installing ZfD 3.2 SP1 to any server, you must make sure that the ZfD 3.2 product has already been installed on the same server. The SP1 NIS Installation program checks the existing ZfD 3.2 installation on a server to verify which components are installed there.

IMPORTANT: Because the ZfD 3.2 SP1 installation program makes changes to the eDirectory schema, you must have Admin rights to [Root] in the eDirectory tree to install ZFD32SP1.

Only those components that were previously installed are updated by the ZfD 3.2 SP1 Installation program. If you want to add other ZfD 3.2 components, you must run the ZfD 3.2 installation program and add these components prior to updating with ZfD 3.2 SP1.

Make sure that you understand the software prerequisites for using this product. This information is displayed in one of the initial installation dialog boxes. You can also find it in the PREREQ.TXT file located in the ZENWORKS\NI\LICENSE\language\ folder of the download package.

[Contents]

2.2.1  Preparing Windows NT/2000 Servers for the SP1 Installation

Make sure that ConsoleOne® is not running when you install this product.

Before you install ZfD 3.2 SP1 on a Windows* NT* or Windows 2000 server, make sure that you shut down any ZENworks services that might already be running, including Inventory, Workstation Import, Workstation Removal and Imaging Service.

Double-click the NT Services icon in the Windows Control Panel to open the services console and to verify whether Workstation Import and Workstation Removal services are running. You can shut down the services at the console.

Double-click the NDS Services icon in the Windows Control Panel to open the services console and to verify whether ImgServ and ZENImgDS are running. You can shut down these services at the console.

You can right-click the Inventory Server icon in the System tray > click Exit to stop the Inventory service.

2.2.2  Preparing NetWare Servers for the SP1 Installation

If you will be installing ZfD 3.2 SP1 on a NetWare® server, it will be necessary to unload JAVA.NLM (at the Server Console, type java -exit). Make sure you do
this when Java is not being used by another process and the proper Java components have already been installed. You should also make sure that ConsoleOne is not
running when you install this product.

[Contents]

2.2.3  Preparing for ZfD 3.2 SP1 Workstation Inventory Installation

Before you install the Workstation Inventory component of ZfD 3.2 SP1, make sure you do the following:

  1. Stop the inventory services.
  2. Log in to the server where the database is installed and stop the database.
[Contents]

2.2.4  Running the ZfD 3.2 SP1 Installation Program

To install ZfD 3.2 SP1 files to the server or servers you need to upgrade, run INSTALL.EXE from the directory where you downloaded ZfD 3.2 SP1 and follow the prompts.

IMPORTANT: Do not install individual files from ZfD 3.2 Support Pack 1 or consolidate the files from this support pack with files from ZfD 3.2 shipping product to expedite a single installation session. This overlay method is not supported.

ZfD 3.2 must be completely installed as shipped (or with support patches applied), followed by the installation of this ZfD 3.2 SP1 server-side update.

[Contents]

2.2.5  Top-Down Deployment of Inventory Installation

Always begin the installation at the topmost level server and proceed with the next lower-level servers. For example, in an Inventory setup with a Root Server
and a Leaf Server, complete the Inventory installation at the Root Server, and then run the installation for the Leaf Server.

[Contents]

3.0  Known Issues

3.1  Installation Issues

3.1.1  Installing ZfD 3.2 SP1 from a Windows 2000 Server with eDirectory 8.7

If you want to install ZfD 3.2 SP1 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

[Contents]

3.1.2  ZENVER.EXE Does Not Check ZfD File Versions in All Directories

When run in verbose mode (/v), ZENVER.EXE, the file version checking utility that ships with ZfD, reports the versions of the ZfD files only under the \PUBLIC
directory and below.

If you have installed some ZfD 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.

[Contents]

3.1.3  Installing Workstation Inventory to NetWare Servers While the Inventory Scanner is Running

If the scanner is running on the workstations, the ZfD 3.2 SP1 installation will not overwrite the files.

To work around this situation, follow these steps on the servers where inventory is installed:

  1. In Windows Explorer, right-click the Scanner file, NTSCAN32.EXE, in the PUBLIC\ZENWORKS directory > click Properties > NetWare Rights.
  2. Double-click [Root]. In the Trustees option, uncheck the Read [R] and the FileScan [F] rights > click Apply > Close.
  3. 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 till in progress.

    If the scanner does not complete the scanning process or if the Scanner crashes, see the Workstation Inventory Troubleshooting documentation at the ZfD 3.2 documentation Web site at http://www.novell.com/documentation/lg/zdfs/docui/index.html.


  4. Complete the ZfD 3.2 SP1 installation.
  5. In Windows Explorer, right-click the PUBLIC\ZENWORKS\NTSCAN32.EXE file > click Properties > click NetWare Rights.
  6. Double-click [Root]. In the Trustees option, check the Read [R] and FileScan [F] rights > click Apply > Close.
  7. In Windows Explorer, right-click the PUBLIC\ZENWORKS\WINSCAN.EXE file > click Properties > NetWare Rights.
  8. Double-click [Root]. In the Trustees option, check the Read [R] and FileScan [F] rights > click Apply > Close.
[Contents]

3.1.4  Installing Workstation Inventory to Windows NT/2000 Servers While the Inventory Scanner is Running

If the scanner is running on the workstations, the ZfD 3.2 SP1 installation will not overwrite the files.

To work around this situation, follow these steps on the servers where inventory is installed:

  1. In Windows Explorer, right-click NTSCAN32.EXE in the PUBLIC\ZENWORKS directory > click Properties > click Security > Permissions.
  2. Click Add > select Administrators > click Add. In the Type of Access, select Full Control > click OK.
  3. From the list, click Everyone > click Remove > OK > OK.
  4. In Windows Explorer, right-click WINSCAN.EXE in the PUBLIC\ZENWORKS directory > click Properties > Security > Permissions.
  5. Click Add > select Administrators > click Add. In the Type of Access, select Full Control > click OK.
  6. From the list, click Everyone > click Remove > OK > OK.
  7. Complete the ZfD 3.2 SP1 installation.
  8. In Windows Explorer, right-click NTSCAN32.EXE in the PUBLIC\ZENWORKS directory > click Properties > click Security tab > Permissions.
  9. Click Add > select Everyone > click Add. In the Type of Access, select Full Control > click OK.
  10. From the list, click Administrators > click Remove > OK > OK.
  11. In Windows Explorer, right-click WINSCAN.EXE in the PUBLIC\ZENWORKS directory > click Properties > Security > Permissions.
  12. Click Add > select Everyone > click Add. In the Type of Access, select Full Control > click OK.
  13. From the list, click Administrators > click Remove > OK > OK.
[Contents]

3.1.5  Installing ZfD 3.2 SP1 from a Windows Workstation or Server Where ConsoleOne 1.3.4 Is Installed

If you want to install ZfD 3.2 SP1 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 will not proceed after the Novell eDirectory tree selection page of the installation is displayed.

[Contents]

3.2  Workstation Management Issues

3.2.1 Edit the Windows Group Policies in the OS Where They Will Be Used

Due to changes in the group policy templates and the differences and additions in Windows XP, problems might occur when group policy settings created on Windows 2000 are pushed to Windows XP desktops.

We recommend that you launch ConsoleOne from a Windows XP workstation or server to edit Windows XP Group Policies or launch ConsoleOne from a Windows 2000 workstation or server to edit Windows 2000 Group Policies.

[Contents]

3.3  Workstation Import Issues

If you move a server to a different eDirectory container after you install ZfD 3.2, Automatic Workstation Import will no longer work. 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.

[Contents]

3.4  Remote Management Issues

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.

[Contents]

3.5  Workstation Inventory Issues

3.5.1  JVM Upgrades Are Not Compatible with ZfD 3.2 or ZfD 3.2 SP1

If you install ZfD 3.2 and ZfD 3.2 SP1 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 ZfD 3.2 and ZfD 3.2 SP1, the Inventory server components will not work.

To resolve this problem, download and install the patch that is available with TID 2962013 in the Knowledgebase at the Novell Support Web Site at http://support.novell.com.

[Contents]

3.5.2  ZfD 3.2 SP1 Will Not Overwrite a Modified ZfD 3.2 File

If you modified the Inventory_server_installation_path\PUBLIC\ZENWORKS\SCANSOURCE.INI file after installing ZfD 3.2, the ZfD 3.2 SP1 installation will not overwrite it.

To work around this problem, after you install ZfD 3.2 SP1, you need to manually edit the SCANSOURCE.INI file to add the following entries:

[SOURCE]
doWMIScan=<retain_the_existing_value>
doDMIScan= TRUE
FullScanSchedule = 10

[FLOPPY]
doFloppyScan = TRUE
doWMIFloppyScan = TRUE
doDMIFloppyScan = TRUE

[LOGICALDRIVE]
doLogicalDriveScan= TRUE
doWMILogicalDriveScan= TRUE

[Contents]

3.6  Upgrade Issues

3.6.1  ZfD 4 Upgrade Does Not Overwrite ZfD 3.2 SP1 Files

If you upgrade from ZfD 3.2 SP1 to ZfD 4, the ZfD 4 installation program does not overwrite some ZfD 3.2 SP1 files because the ZfD 3.2 SP1 file dates are later the ZfD 4 file dates.

TID 10076066 at the Novell Support Web site at http://support.novell.com lists the ZfD 3.2 SP1 files that must be renamed to work around this problem.

[Contents]

4.0  Documentation

4.1  Documentation Sources for the Support Pack

In addition to this file, the following sources provide additional information about the Support Pack:

[Contents]

4.2  Reading Online Help for ZfD Desktop Applications Requires Internet Explorer

To meet the requirements of Section 508 of the Rehabilitation Act of 1973, Novell is migrating its Windows online help systems from WinHelp to Microsoft HTML Help. HTML Help uses Internet Explorer (version 4.01 SP2 or later) as the viewer for HTML Help. This means that every user workstation running ZfD 3.2 Windows applications such as Novell Application Launcher, Novell Application Explorer, Boot Disk Creator, etc., must have Internet Explorer 4.01 SP2 or later installed to access online help.

The requirement for IE 4.01 SP2 or higher only applies if the workstation where the MS HTML help is being viewed is Win95 or WinNT4. Windows 98/2000/XP machines all have a built-in viewer for MS HTML help that is used by default, so IE isn't called for viewing help on those platforms.

[Contents]

4.3  Problem with Help in ConsoleOne ZfD 3.2 Inventory Report Snap-Ins

Help topics might not display when you click Help in the Export Report and GoTo dialog boxes of the Workstation Inventory Report pages of ConsoleOne.

To resolve this problem, download and install ConsoleOne version 1.3.4 that is available from the Novell Product Downloads Web site at http://download.novell.com.

[Contents]

5.0  Legal Notices

5.1  Disclaimer, Export Notice, Copyright, and Patents

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 (C) 2002 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.

[Contents]

5.2  Trademarks

ConsoleOne, NDS, NetWare, Novell, and ZENworks are registered trademarks of Novell, Inc. in the United States and other countries, and DeFrame, eDirectory, and Novell Application Launcher are trademarks of Novell, Inc.

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

[Contents]