Upgrading Managed Workstations

Before you upgrade to ZENworks 6.5, you must either upgrade the Novell Client or install the ZENworks 6.5 Desktop Management Agent. One of these will be used as your means to authenticate to eDirectory. See the following sections:


Installing the Desktop Management Agent

When you have updated the Novell Client and the ZENworks Server (called the "Desktop Management Server in ZENworks 6.5), you need to install the Desktop Management Agent on the user workstations. This installation updates the Novell Application Launcher, Workstation Manager, and Remote Management software on the user workstation. It also installs the Workstation Inventory agent and the Image Safe Data service.

You can uninstall the Novell Client from user workstations after you deploy the Desktop Management Agent as the exclusive means for users to authenticate to eDirectory. In this sense, ZENworks 6.5 Desktop Management can be "clientless;" that is, ZENworks 6.5 Desktop Management does not require the Novell Client if users log in with the Desktop Management Agent. For more information, see "Using the Novell Client in a ZENworks 6.5 Environment" in the Novell ZENworks 6.5 Desktop Management Administration Guide.

The workstation functionality afforded by ZENworks 6.5 Desktop Management components is available only if you install the Desktop Management Agent. This is true even if you currently have the Novell Client installed on that workstation. The Desktop Management Agent installation removes the Desktop Management features that were previously installed by the Novell Client and replaces them with selected ZENworks 6.5 Desktop Management workstation features.

The following tasks must be performed if you want to install the Desktop Management Agent on workstations that are currently using ZENworks for Desktops 3.2 SP3:

  1. Deploying the Windows Installer (MSI) Engine
  2. Using the Novell Application Launcher to Distribute and Install the Desktop Management Agent
  3. Pre-installation Considerations (Support Pack 2)
  4. Manually Installing the Desktop Management Agent


Deploying the Windows Installer (MSI) Engine

The Desktop Management Agent installation program, zfdagent.msi, requires a minimum of Microsoft Windows Installer (MSI) 1.1 during the installation process. You can upgrade Windows 98 workstations by manually installing version MSI 1.11 (or later) on every workstation prior to the installation.

The following table lists the versions of the MSI that should already be installed on Windows workstations.

Windows Version Version of MSI Engine Included

Windows 98 SE Workstations

MSI is not included unless another application installed it.

Windows 2000 Workstations

MSI 1.1 is included with the OS.

Windows XP Workstations

MSI 2.0 is included with the OS.

NOTE:  You should consider whether to upgrade all of the user workstations to use the same version of the MSI engine.

For your convenience, MSI 2.0 for Windows 2000/XP or Windows 98 is available in the \windows installer folder of the Novell ZENworks 6.5 Companion 2 CD.

For detailed information about Microsoft Windows Installer, see the MSI Web site.

If the MSI engine needs to be installed, you can use the Novell Application Launcher in ZENworks for Desktops 3.2 to install it with a Simple Application distribution.

  1. From the Novell ZENworks 6.5 Companion 2 CD, copy the appropriate MSI engine installer utility to your ZENworks Server.

    • \windows installer\98\instmsia.exe installs the MSI 2.0 engine on Windows 98 machines.
    • \windows installer\nt\instmsiw.exe installs the MSI 2.0 engine on Windows 2000/XP machines.
  2. Using the newly installed ZENworks 6.5 Desktop Management snap-ins in ConsoleOne, create a Simple Application object for the version of the MSI engine you want to install.

    If you want to install both versions, you must create a Simple Application object for each version.

    1. After you name the simple application, enter the path to the location from which the application's executable file will run. Include the executable file in the path. Because the Application Launcher will copy the file to a target directory on the workstation, specify the path as it will exist after the file is copied to the target directory.

      Example: c:\temp\instmsiw.exe

    2. Define the system requirements that a workstation must meet before the MSI engine application will be distributed to it.

      For more information, see "Configuring the Application in eDirectory" in the Novell ZENworks 6.5 Desktop Management Administration Guide.

    3. Associate the application object to users or imported workstations, then select the characteristics you want to apply to the association.

      We recommend that you select the Force Run characteristic for the association so that the Application object will run as soon as the Application Launcher or Workstation Helper starts and the Application object is available.

      For more information, see "Configuring the Application in eDirectory" in the Novell ZENworks 6.5 Desktop Management Administration Guide.

  3. Configure the Simple Application object.

    1. In the Application object Properties page, click the Distribution Options tab > Application Files.

      You need to add the file to the Application Files list so that the Application Launcher will copy it to the workstation. For more information, see the online help in ConsoleOne.

    2. Click Add, click File, then fill in the following fields:

      Source File: Select the MSI engine installer utility you want copied to the workstation (for example, q:\public\zenworks\instmsiw.exe).

      Target File: Enter the full path, including the file name, where you want the file copied (for example, c:\temp\instmsiw.exe).

    3. Click OK to add the file to the list, then click OK to save the Application Object information.

    4. If you are installing to Windows 2000 or Windows XP, in the Application object Properties page, click the Run Options tab > Environment > select the Run Normal option, set the Executable Security Level to Run as Unsecure System User, then click OK to save the Application Object information.

    If you selected Force Run on the Associations tab, he MSI Engine is installed as soon as the Application Launcher starts and the Application object is available.

    The MSI engine installs an executable that will be used later for installing the Desktop Management Agent MSI. The MSI engine installer utility installs this file, called msiexec.exe, in the windows_drive:windows_directory\system directory of the workstation.


Using the Novell Application Launcher to Distribute and Install the Desktop Management Agent

The zfdagent.msi package is a complex application that installs many files and makes many configuration changes to the workstation. The most efficient method for installing the Desktop Management Agent is to distribute it to workstations as an MSI application using the Novell Application Launcher. The Novell Application Launcher not only distributes the Agent MSI package, it also calls the Windows Installer to perform the installation on the workstation.

This section provides the steps for configuring the MSI package for distribution with the Application Launcher, including:


Creating and Configuring the MSI Application Object
  1. 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.

  2. In the New Application dialog box, select the Application That Has an .MSI File option, then click Next.

  3. Specify the path to the network location where you copied the .msi file.

  4. Click Next, then modify the fields as necessary to customize the Application object.

  5. Click Next, then define the distribution rules that a workstation must meet before the Agent MSI will be distributed to it.

  6. Click Next, then associate the Agent MSI Application object with the users or workstations to where you want to distribute it.

  7. Click Next, review the Application object settings, then click Finish to create the Application object.

    IMPORTANT:  Before you distribute the Agent MSI (or any MSI package) using the Novell Application Launcher, we recommend that you make sure the Agent MSI application object is set to Force Cache and that the user credentials on the local workstation, in eDirectory, and in Active Directory (if used) are synchronized.

For more information about creating an MSI Application object, see "Creating the Application Object from a Windows Installer (.MSI) File" in the Novell ZENworks 6.5 Desktop Management Administration Guide.


Modifying Installed Features in the MSI Application Object

By default, all of the following features are installed by the ZENworks 6.5 Desktop Management Agent MSI package:

  • Application Management: Uses the Novell Application Launcher to provide users access to workstation applications that the administrator can install and then manage.

  • Workstation Manager: Lets administrators configure and manage workstations by using eDirectory.

  • Workstation Inventory: Helps administrators collect hardware and software inventory information from scanned workstations. Workstation Manager is selected by default when you select this feature.

  • Remote Management: Lets an administrator manage remote workstations from a management console.

  • Mirror Driver: Provides video adapter independence and co-existence with other Remote Control Solutions. If this feature is selected, the MSI installation overrides video driver checks and suppresses any Windows messages. If you do not want this driver, you can deselect it (optimization will be disabled).

    NOTE:  The Mirror Driver is not yet signed by Microsoft.

  • Workstation Imaging: Lets an administrator take an image of a workstation's hard drive and put it on other workstations over the network.

If you want to modify this default install, you can add MSI features as public properties of the zfdagent.msi Application object. Use the following steps to modify the list of installed features:

  1. On the Properties page of the MSI tab of the Application Object, click Add to display the Select Property to Add dialog box.

  2. In the Value Name field, enter ADDLOCAL (this is case-sensitive) 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:

    • ApplicationLauncher
    • WorkstationManager
    • RemoteManagement
    • MirrorDriver (this property will not work unless you add the RemoteManagement property)
    • Imaging
    • Inventory

    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.

  3. Click OK to add the property to the Properties list.


Adding Properties to the Agent MSI Application Object

Other properties you can modify and their values (including definitions for the values) are listed in the table below. If one of these properties is listed without a value, the MSI package uses the default value.

Property Value Meaning

ADDLOCAL

  • WorkstationManager
  • ApplicationLauncher
  • RemoteManagement
  • MirrorDriver
  • Inventory
  • Imaging

Comma-delimited list of features to install.

LOGIN_PASSIVE_MODE

0

Displays a Novell login at user login time.

1

Default. Displays the standard Microsoft login at user login time.

NOTE:  If you want to use Dynamic Local User, you need to assign a value of zero (0) to this property.

EDITABLE_MT_ADDRESS

1

Allows the user to change the ZENworks Middle Tier IP address where authentication will take place. This is available only if the Novell Client is not installed.

0

Default. Do not allow the user to specify the Middle Tier address.

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.

STARTUP_APPEXPLORER

1

Launch Application Explorer on Windows startup.

0

Default. Do not launch Application Explorer on Windows startup.

STARTUP_APPWINDOW

1

Launch Application Window on Windows startup.

0

Default. Do not launch the Application Window on Windows startup.

MT_SERVER_ADDRESS

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.

HTTP_PORT

0-65536

This property specifies the HTTP port to be used by the Desktop Management Agent when communicating with the Middle Tier Server. This property must be added and its value defined if you are using a Middle Tier Server.

80

Default HTTP port.

NAL_SINGLE_TREE

1

Limit access of the Novell Application Launcher to applications in one tree only.

0

Default. Do not limit the Application Launcher to one tree for access to applications.

ZENWORKS_TREE

any tree name

This property specifies the eDirectory tree to be used as the ZENworks tree.

  • If Workstation Manager is installed, this tree becomes the tree where Workstation Manager looks for policies.
  • If the NAL_SINGLE_TREE property is configured and the Novell Application Launcher is installed, this tree becomes the only tree where the Application Launcher looks for applications.


Pre-installation Considerations (Support Pack 2)

If Symantec PCAnywhere* 10.x (or an earlier version) is installed on the managed device, and if you are upgrading the Remote Management Agent, you need to know the following information:


Installing the Desktop Management Agent Selecting the Mirror Driver Option (Recommended)

Selecting the Mirror Driver option during the Desktop Management Agent installation might cause the managed device to shift into low resolution or VGA mode. This occurs because PCAnywhere does not support coexistence with Remote Control solutions that are based on hook driver technology. The Remote Management hook driver shipping with ZENworks 6.5 has been deprecated and is not installed on the managed device during upgrade.

To resolve this issue, do the following:

  1. Reinstall the system video driver on the managed device.

  2. Reinstall PCAnywhere on the managed device.

  3. Install the ZENworks Management Agent with the Mirror Driver option selected.

NOTE:  You need to execute these steps only once. Because subsequent upgrades will not require these steps, we recommend that you select the Mirror Driver option during installation.


Installing the Desktop Management Agent without Selecting the Mirror Driver Option

If you choose not to select the Mirror Driver option, you will not encounter the low resolution or VGA screen problem. However, the remote sessions are not optimized for performance without Mirror Driver selected. For this reason, you will need to launch rmsetdrv.exe to enable the hook driver, which is deprecated with ZENworks 6.5.

To resolve this issue, do the following:

  1. Install the ZENworks Management Agent without selecting the Mirror Driver option.

  2. Run rmsetdrv.exe /hook.

    NOTE:  Because you must launch rmsetdrv.exe every time you upgrade the agent without selecting the Mirror Driver option, and because the hook driver is deprecated with ZENworks 6.5, we recommend that you select the Mirror Driver option during the agent upgrade.

    For more information on rmsetdrv.exe, see TID 10089810 in the Novell Support Knowledgebase.


Manually Installing the Desktop Management Agent

If you want to install to a single workstation at a time, you can install zfdagent.msi manually. For more information, see Manually Installing the Desktop Management Agent.

When completed with both manual command line parameters and MSI installation properties, the parameter field might look like this:

/i zfdagent.msi /qb STARTUP_APPEXPLORER=1 

Because the Parameters field of the Application object has a line length limitation, you might not be able to add a large number of MSI Installation properties. To work around this limitation, you can do one of two things: