The information in this Readme file pertains to Novell® ZENworks® for Desktops (ZfD) 4 Support Pack (SP) 1b.
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.
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 http://support.novell.com/tools/csp.
For information on the latest Consolidated Support Pack issues, see TID 10077724 at the Novell Support Connection® Web site .
To order the Support Pack CD, go to the Consolidated Support Pack ordering information page.
Added text to section entitled 6.1 Preparing for the ZfD Management Agent Installation to clarify that removing the noted registry key and then rebooting the NT-based workstation runs the ZfD Management Agent, but the Agent will not work.
When you have met the hardware and software requirements and prerequisites for installation, use the instructions in this document to install ZfD software on a NetWare or Windows* server.
If you are installing ZfD 4 SP1b from Consolidated Support Pack (CSP 9), download and install CSP 9 and copy the self-extracting file for ZfD 4 SP1b to a temporary directory on a server, then expand the self-extracting archive at the root directory.
If you are installing ZfD 4 SP1b from a Novell Support Web site, follow the prompts on the Web site to download the Support Pack and copy it to a temporary directory on a server and expand the self-extracting archive at the root directory.
Before you install the ZfD Server or ZfD Middle Tier Server components on a NetWare® server, you need to exit ConsoleOne® sessions and stop the Java* components running on that server. If they are running, these processes will hold open a number of files that will not be updated because they are in use.
To stop Java components on the NetWare server, enter the following commands at the server console:
Java -killall
Java -exit
IMPORTANT: Do not install the ZfD 4 SP1b Inventory, Database, or Remote Management components over a ZfD 4.0.1 installation. ZfD 4 SP1b includes defect fixes intended for ZfD version 4.0 only. The ZfD 4 SP1b installation will not work over a ZfD 4.0.1 installation.
The ZfD Server installation program for ZfD 4 SP1b does not support installing ZfD Server software to a NetWare cluster server. However, this functionality is supported in the ZfD Server installation program for ZfD 4.0.1. For more information about using ZENworks for Desktops in a clustering environment, see the ZfD Clustering Guide at the ZfD 4 documentation Web site (http://www.novell.com/documentation/lg/zdpr/index.html).
At a Windows 2000 or Windows XP workstation, browse to the location where you downloaded ZfD 4 Support Pack 1b and run the winsetup.exe program to begin the installation.
Click the language you want to use for the installation. A window with general installation options will be displayed.
Choose whether to extend the schema for ZfD 4 SP1b before installing, or install with the option of extending the schema during the installation.
To extend the schema first, select Schema Extensions to display a list of the trees where you are authenticated. Select a tree from this list where you want to add ZfD 4 SP1b schema extensions, click OK, then click Yes.
If you want to extend the schema during the installation, click Installation to display a window with more installation options.
Click Install Server to launch the ZfD Server installation program.
Follow the prompts during the ZfD Server installation program to upgrade the ZfD Server files to SP1b.
NOTE: No ZfD 4 SP1b components will be installed unless you are installing SP1b over a previous installation of ZfD 4.
If you attempt to install ZfD 4 SP1b after a previous installation of ZfD 4.0.1, the SP1b version of the Workstation Inventory, Remote Management, and Sybase database components will not be installed.
ZfD 4 SP1b includes support for a configuration where ZfD Middle Tier server software is installed on Windows 2000 with ZfD Server software on NetWare 6.
For more information, see the ZENworks for Desktops Installation Guide at the ZENworks for Desktops Documentation Web site.
If you install Workstation Inventory and the Sybase* database on a NetWare Server as part of the ZfD Server installation, enter the following commands at the server console after the installation to restart the inventory service and the database:
mgmtdbs
startinv
At a Windows 2000 or Windows XP workstation, browse to the location where you downloaded ZfD 4 Support Pack 1b and run the winsetup.exe program to begin the installation.
Click the language you want to use for the installation. A window with general installation options will be displayed.
Choose whether to extend the schema for ZfD 4 before installing, or install with the option of extending the schema during the installation.
To extend the schema first, select Schema Extensions to display a list of the trees where you are authenticated. Select a tree from this list where you want to add ZfD 4 schema extensions, click OK, then click Yes.
If you want to extend the schema during the installation, click Installation to display a window with more installation options.
Click Install ZfD Middle Tier Server to launch the Middle Tier Server installation program.
Follow the prompts during the Middle Tier Server installation program to upgrade the ZfD Middle Tier Server files to SP1b.
NOTE: If you install NetWare 6 SP3 to a server where a previous installation of ZfD 4 already exists, the NetWare install will not copy new NetStorage file to that server. The ZfD 4 SP1b Middle Tier Server installation installs the current ZfD 4 SP1b files to the server.
When you download ZfD4 SP1b, you should extract it to a network server location that will be accessible later to the Novell Application Launcher. When the file is extracted, the following language folders and files are created in the AgentInstall directory of the Support Pack image:
Use the path to the localized MSI package of your choice when you create the Application object that will be distributed to users.
NOTE: If you choose to run the installation to a single workstation from the ZfD 4 SP1b image, you can find the localized version of the ZfD Agent installation by running winsetup.exe from the image, clicking the language of your choice, then clicking Installation > Install ZfD Management Agent.
If you want to manually deploy the MSI package on a Windows 98 workstation where the ZfD 4 Management Agent is already installed, you need to use the Add/Remove Programs feature in Windows to uninstall the existing agent first, then install zfdagent.msi.
The most efficient method for installing the ZfD Management Agent is to distribute it to workstations as an MSI application using the Novell Application Launcher. This document provides the steps for configuring the MSI package for distribution, including:
The zfdagent.msi package is a complex application that will install many files and make many configuration changes to the workstation. The Novell Application Launcher not only distributes the Agent MSI package, it also calls the Windows Installer to perform the installation on the workstation.
When the MSI package is distributed and installed, it uninstalls the existing installation of the ZfD 4 Management Agent (original shipping version, setup.exe).
To facilitate the uninstall process on a Windows NT/2000/XP workstation, we recommend that prior to upgrading to the ZfD 4 SP1b Agent using the MSI distribution, you delete the InstallPath string value in HKEY_LOCAL_MACHINE\Software\Novell\ZENworks.
You can delete the value manually by using regedit.exe prior to uninstalling the old ZfD Management Agent with the Add/Remove Programs.
WARNING:
If the workstation is rebooted without this key, the ZfD Management Agent is reloaded and much of its functionality will not work. You should remove the key only when reinstalling or removing the ZfD Management Agent.
NOTE: Some Windows NT-based workstations fail with a 1603 error when upgraded from the ZfD 4 (setup.exe) version of the ZfD Management Agent. You can work around this problem by manually deleting the InstallPath string as described above, then immediately running the SP1b/4.0.1 Management Agent installation program prior to any reboot.
For more information about creating and configuring the MSI Application object, see 6.2 Creating and Configuring the MSI Application Object .
Use the following steps to create and configure the Agent MSI as an application object.
In ConsoleOne, right-click the container where you want to create the Application object > click New > click Object to display the New Object dialog box.
In the New Application dialog box, select the Application That Has an .msi File option, then click Next.
Specify the path to the .msi file.
The file should be in the network location where you installed or copied the application.
Click Next, then modify the fields as necessary to customize the Application object.
Click Next, then define the system requirements that a workstation must meet before the Agent MSI will be distributed to it.
Click Next, then associate the Agent MSI Application object with the users or workstations where you want to distribute it.
Click Next, then review the Application object settings, then click Finish to create the Application object.
For more information about creating an MSI Application object, scroll to Creating the Application Object from a Windows Installer (.msi) File in Configuring the Application in eDirectory in the ZENworks for Desktops Administration Guide.
If you are installing the ZfD Agent MSI on a workstation that you are upgrading from ZENworks 2 or the Starter Pack, see Installing the ZfD Management Agent in the ZENworks for Desktops Upgrade Guide.
By default, all of the following features are installed by the MSI Agent package:
If you want to change what is installed by the MSI, you can add MSI features as public properties of the zfdagent.msi. Use the following steps to modify the list of installed features:
On the Properties page of the MSI tab of the Application Object, click Add to display the Select Property to Add dialog box.
In the Value Name field, enter ADDLOCAL as the property name, then specify the property's value in the Value Data field. Use one or more of the following feature names as a property value:
You can add more than one of these values to the list by separating them with a comma (no spaces). For example, if you wanted to add Application Launcher and Workstation Manager as features, you would type ADDLOCAL as the property and ApplicationLauncher,WorkstationManager as the values for that property.
Click OK to add the property to the Properties list.
If you want to run the Agent MSI in silent mode, set the user interface to Silent on the Icon page of the Identification tab of the object Properties. If you run the installation in this mode, you can add other properties to the object.
These properties and their values (including definitions for the values) are listed below. If one of these properties is listed without a value, it will use the default value.
The values for this property are effective only if the Novell Client is not installed on the workstation. If the Novell Client is already installed, the settings have no effect after zfdagent.msi installation.
If the Novell Client is removed after zfdagent.msi is installed, these settings take effect.
NOTE: If the Novell Client might be removed later and you want to use DLU, you need to assign a value of zero (0) to this property.
The values for this property are effective only if the Novell Client is not installed on the workstation. If the Novell Client is already installed, the settings have no effect after the zfdagent.msi installation.
If the Novell Client is removed after zfdagent.msi is installed, these settings take effect.
This property specifies the ZENworks Middle Tier Server IP address or DNS name. It is not necessary to specify this property if you are not using a Middle Tier Server.
For a list of installation issues and other known issues since ZfD 4 last shipped, see zfd4_iss.txt located at the root of the Support Pack.
In addition to this Readme file, the following sources provide additional information about the Support Pack:
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.
US Patent Nos. 5,633,931; 5,692,129; 5,758,069; 5,761,499; 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,144,959; 6,173,289. Patents Pending.
ConsoleOne, GroupWise, Novell, Novell Support Connection, NetWare, and ZENworks are registered trademarks of Novell, Inc. in the United States and other countries.
eDirectory, Novell Application Launcher, and Novell Client are trademarks of Novell, Inc.
All third-party trademarks are the property of their respective owners.