Upgrading the ZfD Management Agent

After you have upgraded the ZfD Server software and the ZfD Middle Tier Server software, you need to upgrade to the ZfD 4 SP1/4.0.1 Management Agent. If you installed the original version of the ZfD Agent, the Windows Installer package should have been installed on the workstations. For more information, see Upgrading the Windows Installer (MSI) on Each Workstation Prior to a New Installation in Installing in the ZENworks for Desktops 4 Installation Guide.

The version of the ZfD Management Agent that shipped with ZfD 4 (setup.exe) is no longer supported. You need to replace the older version of the agent with the version of the agent shipping with ZfD 4 SP1 or ZfD 4.0.1 (zfdagent.msi). ZfD 4 SP1 is included as part of Consolidated Support Pack (CSP) 9, and can be downloaded individually from the CSP download Web site. The updated ZfD Agent MSI (ZfD 4 SP1/4.0.1) can also be downloaded from the Novell Product Downloads Web site.

When you install zfdagent.msi over setup.exe, the newer version of the ZfD Management Agent uninstalls the older version and runs its own installation. As the ZfD Management agent is being upgraded, the installation program attempts to keep all of the registry settings made by the original installation except the LOGIN_PASSIVE_MODE property and the EDITABLE_MT_ADDRESS property, which are kept in a restricted area of the registry. Make sure that the values for these two properties are set the way you want them when you are upgrading to ZfD 4 SP1/4.0.1. You can add these properties and the appropriate values on the command line if you are installing from the command line (that is, a manual installation). For example:

msiexe/i zfdagent.msi LOGIN_PASSIVE_MODE=0 EDITABLE_MT_ADDRESS=1

For more information about MSI command line syntax, see the Windows Installer Command Line Options page.

If you are distributing an MSI Application object from Application Launcher, you can configure these properties and the values you want when you configure the object. For more information, see Creating and Configuring the MSI Application Object in Using the Novell Application Launcher to Distribute and Install the ZfD Management Agent in the ZENworks for Desktops 4 Installation Guide.

This section includes information that you need to know for the following scenarios:

For more information about the ZfD Agent, see Understanding the ZfD Management Agent in the ZENworks for Desktops 4 Administration Guide.


Upgrading the ZfD Management Agent if Support Patches Have Been Applied

If you have downloaded and applied interim patches from Novell Support for the ZfD 4 Management Agent (setup.exe), you need to upgrade the ZfD Management Agent with either an interim patch or with an .aot file that prepares the workstation for the latest ZfD Agent. The SP1/4.0.1 upgrade detects that the agent is already installed on the workstation and then silently uninstalls it. After the uninstall is performed, the new installation (copying files, writing to the Windows registry) is executed.

If your Windows NT/2000/XP or Windows 98 workstations have the original ZfD 4 Management Agent (setup.exe, August 13, 2002) installed, or if you installed the original release of the zfdagent.msi (January 8, 2003), or if you have installed Patch 4 (zfd4patch4a.exe) to either of these versions, you can apply ZfD Agent 4 SP1/4.0.1 directly to those workstations.

If you applied Support Patch 1 (zfd4patch1.exe, 2 January 2003), Patch 2 (zfd4patch2a, 24 January 2003), or Patch 3 (zfd4patch3.exe.,24 January 2003) to workstations that had the original setup.exe installed, you must install zfdagntpatchfix.aot before you can apply 4 SP1/4.0.1.

You can download zfdagntpatchfix.aot from TID 29652811, available from the Novell Support Web site.


Rolling Back the ZfD Management Agent to an Earlier Version

If you want to revert from the ZfD Management Agent installed on a workstation to an earlier version or patch, you must use the REINSTALLMODE property on the command line or in the properties of the MSI Application object you intend to distribute. You must specify the value of vamus to force the install to always overwrite any files currently found on the workstation. If you do not specify this value, the default value, omus (replace files only if older) will be used.

For more information about configuring the distribution properties of the MSI Application object, see Creating and Configuring the MSI Application Object in Using the Novell Application Launcher to Distribute and Install the ZfD Management Agent in the ZENworks for Desktops 4 Installation Guide.

NOTE:  If you attempt to install setup.exe over any previous installation of zfdagent.msi, the installation will appear to proceed, but the installation will not actually be completed. We recommend that you do not try to install setup.exe over zfdagent.msi as a rollback option.



  Previous Page: Upgrading the ZfD Middle Tier Server Software  Next Page: Upgrading from DeFrame 2.01 to ZfD 4.01 DeFrame