The information in this Readme file pertains to Novell® ZENworks® 7 Desktop Management, the Novell product for managing desktops on Windows* workstations located inside or outside of your corporate firewall. Information about ZENworks services running on NetWare®, Windows, or Linux* server platforms is included.
The issues included in this document were identified when ZENworks 7 Desktop Management was initially released. For information about issues corrected after the initial release, see TID 10097368 in the Novell Support Knowledgebase.
The ZENworks 7 Desktop Management Installation Guide provides detailed installation instructions. It is available on the Novell documentation Web site and as a menu option when running the installation program.
There are some limitations on the scope and environment where you can use ZENworks 7 Desktop Management.
For more information, see TID 10019161 in the Novell Support Knowledgebase.
If NetWare 6.5 SP2 is installed on the server where you authenticate workstations for ZENworks functionality, you will not be able to administer the eDirectoryTM tree or a server with ConsoleOne® 1.3.6 until you upgrade the version of the Novell ClientTM installed on the machine to 4.9 SP2.
We recommend that you do not install the version of the Novell Client (4.90.0 SP1a) that ships with eDirectory 8.7.3. This version requires additional patches in order to work with Windows Server 2003. Instead, we recommend that you install the Novell Client for Windows 4.91, which is available for download from the Novell Product Download Web site.
This section explains the installation issues for the Desktop Management Server, the Middle Tier Server, and the Desktop Management Agent. It also discusses some installation issues for Desktop Management components such as Application Management and Workstation Imaging.
Issues with installing ZENworks Desktop Management services on a Linux server are grouped together for your convenience.
This section explains the issues that have been discovered with the installation of the Novell ZENworks 7 Desktop Management Services on Linux.
When you open ConsoleOne for the first time after installing ZENworks 7 Desktop Management on a Linux server, a license pop-up message displays. You must enter the license code to administer the ZENworks Desktop Management Linux machine.
Although the Installation Complete message states that all installed ZENworks services have been started, the proxydhcp service is not started after the ZENworks 7 Desktop Management Services on Linux installation is completed, nor is it started after a reboot. To start the service, run /etc/init.d/novell-proxydhcp start. If you want the service to be started after a reboot, you can use a runlevel editor and add the daemon to the required runlevel.
If you open YaST after installing only the ZENworks 7 Middle Tier Server on a SLES 9 server, then you select Software Installations and then click Dependencies, errors are displayed indicating a dependency conflict.
These errors indicate that the dependency is on novell-zenworks-common, which is not copied to the server unless you also install the ZENworks 7 Desktop Management Server to the same machine.
You can disregard this error if the Middle Tier Server is installed by itself on the SLES 9 server.
If you install ZENworks 7 Middle Tier Server on an OES (Linux) server (shipping version) and then you enable the Universal Password setting, all users logging in through the Middle Tier will fail to authenticate. Administrators are also unable to log in; consequently, the NSAdmin utility becomes unusable.
To work around this issue, you can do one of the following:
Open /etc/opt/novell/xtier/xsrvd/envvars in a text editor.
Replace this line:
LD_LIBRARY_PATH="${LD_LIBRARY_PATH}":/opt/novell/xtier/lib
with this line:
LD_LIBRARY_PATH="${LD_LIBRARY_PATH}":/opt/novell/xtier/lib:/opt/novell/nmas/client/lib
Use the following command to restart novell-xsrvd:
/etc/init.d/novell-xsrvd restart
This section contains information about the issues that might occur when you install the Desktop Management Server.
The Desktop Management Server installation program requires free space on the designated system drive of the workstation from which you are installing. If the installation program fails, it might be because there is not sufficient free space to continue.
You must create sufficient space in order to continue with the installation. If your Windows drive is almost full, you can set the SystemDrive environment variable to use disk space on another drive.
The Desktop Management Server installation program reads the NetWare server's autoexec.ncf file to find and use the first listed BIND IP Address statement. If the file has two or more BIND IP Address statements and if the first address is incorrect or inactive, the installation fails.
To correct the problem, make sure that the correct IP address is listed first in the autoexec.ncf file.
If you use a Windows 2000 server with ConsoleOne installed to install Desktop Management ConsoleOne snap-ins to another server, Windows adds the new installation path to ConsoleOne to its registry, which also includes the default location of the previously installed ConsoleOne.
If you use this same Windows 2000 server to install ConsoleOne snap-ins to another server, the installation fails because it uses the default path for installation.
If you cannot install the snap-ins from another server, we recommend that you delete the default value from the following registry entry:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\App_Paths\ConsoleOne.exe
The Desktop Management Server installation program fails to install to a cluster in a multi-server eDirectory tree when the Prerequisite Check check box is selected and the Cluster object is not the first server in the Server Selection list.
To work around this problem, deselect the Prerequisite Check check box.
When you install ZENworks 7 Desktop Management Services, the installation creates a new ConsoleOne Update Application object in the eDirectory tree. This object will not work until you have configured it properly.
To configure the object:
In ConsoleOne, right-click the ConsoleOne Update Application object > click Properties, click the Run Options tab, then click Application.
In the Path to File field, type \\server_name\sys\public\zenworks\c1update.exe.
or
This section contains information about the issues that might occur when you install the Middle Tier Server.
If you install the Novell Client on a Windows 2000/2003 server, then install the Middle Tier Server on the same machine, then uninstall the Novell Client from this server, the Middle Tier Server will fail. The client uninstall program removes important files needed by the ZENworks Middle Tier Server.
In this same software combination scenario, if you subsequently upgrade the client to 4.9 SP2, a different version of nicm.sys will be installed. If you do not use the nicm.sys included in ZENworks 7 Middle Tier Server, the Middle Tier Server will fail.
To work around this issue, you have two options:
If you previously installed the ZENworks 7 Middle Tier Server on an OES NetWare server, and then you subsequently upgrade the NetWare server to OES Support Pack 1, the support pack installation program overwrites the ZENworks 7 Middle Tier Server (version 2.0x) with a newer version of XTier (version 3.01). This version of XTier is not compatible with other ZENworks 7 Middle Tier components and effectively disables the Middle Tier.
If you must upgrade your OES server with OES Support Pack 1, you can work around the problem by reinstalling the ZENworks 7 Middle Tier Server after the OES upgrade.
This section contains information about the issues that might occur when you install the Desktop Management Agent. For more information, see TID 10078667 in the Novell Knowledgebase.
IMPORTANT: The version of the Desktop Management Agent that shipped with ZENworks for Desktops 4.0 is no longer supported. Prior to upgrading the Desktop Management Agent to ZENworks 7, users should replace this older version of the agent with the version of the agent shipping with the ZENworks 6 Suite (ZENworks for Desktops 4.0.1/SP1b) or later.
The Microsoft Windows Installer engine (msi.dll) and the Windows Installer executable (msiexec.exe) must be present on the workstation in order for the Desktop Management Agent MSI package to be unpacked and executed. Some Windows 98 workstations might not have the MSI engine installed, so the Desktop Management Agent MSI package will not install.
You can obtain the latest version of the Windows Installer from the Microsoft downloads site or you can use the MSI 2.0 file (instmsia.exe) that is available in the \microsoft windows installer\98 folder of the Novell ZENworks 7 Companion 2 CD.
If you distribute the Desktop Management Agent MSI through Application Launcher to a Windows workstation, users should not have ConsoleOne open on those workstations.
If ConsoleOne is open during the distribution, the Desktop Management Agent Installation MSI fails.
We recommend that you do not configure the Desktop Management Agent MSI object to allow for a user-based uninstall because the workstation does not currently prompt for a reboot when the user executes an uninstall by right-clicking the Application object icon.
If you grant Administrator rights to the user, he or she can uninstall the Desktop Management Agent using Add/Remove Programs. In this case, the workstation does display a prompt for reboot. You can use the agentdistributor.exe utility located in the sys:public\mgmt\consoleone\1.2\bin folder of the Desktop Management Server when ZENworks 7 has been applied to that server. Using this utility, you can "push" the latest agent to workstations based on their IP address.
If you or a user install myapps.html on a Windows 98 workstation, some ZENworks Management Agent files are installed on that workstation that cannot be subsequently uninstalled in the Add/Remove Programs feature of the Windows Control Panel.
This might cause a problem if it becomes necessary to install the Novell Client on the same workstation; the client installation program detects the Desktop Management Agent files and will not proceed until the Agent (or its files) is removed from the workstation. Because the files do not constitute the entire installation of the Agent, there is no listing of the Desktop Management Agent in Add/Remove Programs.
If you install application plug-ins from the Application Browser view (myapps.html) on a Windows 98 workstation, and if you subsequently install the full ZENworks Desktop Management Agent on that workstation using the agent MSI available from the Application Browser view, the Application Browser view stops working.
The problem occurs because of file name truncation occurring during the MSI installation from the Browser view. We recommend that you install the Agent MSI on Windows 98 using a method other than the Application Browser view.
If you or a user uninstall the ZENworks 7 Desktop Management Agent from a Windows 98 workstation, the uninstall process might fail with the following error message:
Error 1605: This action is only valid for products that are currently installed
The failure is due to the Windows 98 MSI Installer incorrectly setting up the Windows registry for uninstall.
InstallShield Consumer Central has published a Knowledgebase resource that provides some steps for working around the problem. The workaround recommends that you run Windows Installer CleanUp Utility to clear registry entries from the workstation. The utility is available for download at the Microsoft Support site.
If you install the Novell Client 4.9 SP1a, then install Novell NetIdentity 1.2 (from the same Novell Client CD), then install the ZENworks 7 Desktop Management Agent, and then remove the Agent, NetIdentity will not work because the Agent NetIdentity files are removed.
To work around this problem, you need to use the Windows Add/Remove Programs utility to remove NetIdentity, then you need to reinstall it.
If you install NetIdentity on a clean workstation using the Novell Client, NetIdentity is listed in the Add/Remove Programs list of the Windows Control Panel.
If you subsequently install the ZENworks Desktop Management Agent (which also installs NetIdentity) on this workstation, you can use Add/Remove Programs in Windows to "remove" NetIdentity from the workstation, but NetIdentity is not truly removed from the machine; it is simply removed from the Add/Remove Programs list. NetIdentity is not removed until the ZENworks Desktop Management Agent is uninstalled.
If you install the Novell Client 3.x and enable Workstation Manager on a Windows 98 workstation, then install the ZENworks 7 Desktop Management Agent, and then you uninstall Novell Client 3.x, Workstation Manager is uninstalled on the workstation, so no policies are distributed to the workstation.
To correct this problem, you must uninstall the Desktop Management Agent and re-install it on the Windows 98 workstation.
If you install the ZENworks 7 Desktop Management Agent and subsequently distribute or "roll back to" a previously shipped ZENworks for Desktops 4.0.1 patch or interim release, the workstation is no longer recognized as imported and workstation associated applications do not appear in the Novell Application Launcher views.
If you have already installed the ZENworks 7 Desktop Management Agent, we recommend that you do not roll back to a ZENworks for Desktops 4.0.1 patch or interim release of the Desktop Management Agent.
Installing the ZENworks 7 Desktop Management Agent on a workstation will overwrite some third party network login GINAs. The ZENworks 7 Desktop Management Agent supports the following third party GINAs (that is, they will not be overwritten by the Desktop Management Agent installation):
If some other third-party GINA (that is, a GINA not in this list) is already installed on the user workstation, the Desktop Management Agent will not install. You can use the IGNORE_3RDPARTY_GINA MSI property with a setting of 1 to force the installation of the Agent and overwrite the third party GINA.
IMPORTANT: Some other third party GINAs will not function if they are not the primary (that is, the first) listing in a Microsoft GINA chain. This causes a problem on workstations where the Desktop Management Agent is already installed: the Agent requires the primary listing in the chain and will disable the third party GINA.
The Desktop Management Agent Distributor (agentdistributor.exe) included with ZENworks 7 can cause excessive CPU cycling on the Windows workstation that you use to distribute the agent. The problem occurs when several configuration elements are selected. Desktop Management Agent features, the Middle Tier address, and the ZENworks tree name all contribute to lengthen the command line. If the command line string becomes too long (approximately 240 characters) the ZDPAService used to deploy the agent uses excessive CPU cycles. This can possibly lock up the machine.
One way to reduce the length of the command line is to select all of the features that can be installed with the Desktop Management Agent. This will result in an abbreviated command line (ADDLOCAL=ALL) being passed to the buffer so that the Agent Distributor will run normally.
IMPORTANT: This procedure installs all the features of the Desktop Management Agent. Depending on your business needs, you might not want to install all of these features on user desktops in your organization. We do not recommend that you install Agent features one at a time.
For more information about the Agent Distributor, see "Using the Desktop Management Agent Distributor to Deploy the Agent to Workstations in a Microsoft Domain" in the Novell ZENworks 7 Desktop Management Installation Guide.
If you launch the Agent Distributor utility (either independently or from ConsoleOne) from a Windows server whose locale is set to Spain or Honduras, the English version of the utility is displayed.
To work around this issue, use the Regional Options settings in the Windows Control Panel to set the regional format to a Spanish locale other than Spain or Honduras.
The Microsoft RDP 5.1 client (msrdp.ocx) is included with the ZENworks 7 Launch gadget. When a user launches a terminal server application that you've configured to run in an RDP client session, the Launch gadget generates an error message indicating that the certificate for the file has expired.
If you click Yes in the error message to continue the installation, the Launch gadget installs the msrdp.ocx file to the c:\program files\novell\zenworks directory on the user's workstation and registers the OCX file.
If you install the msrdp.cab file to a workstation using the ZENworks Management Agent installation program, no error messages are displayed.
This section contains information about the issues that might occur when you install the Workstation Imaging component of ZENworks 7 Desktop Management.
If you reinstall or upgrade the Workstation Imaging component of the ZENworks Server installation, the following lines are added to the Desktop Managementlog.txt log file:
Imaging\NTa Components NOT successfully installed on
<server_name> at <installation_path>
Imaging\NTb Components NOT successfully installed on
<server_name> at <installation_path>
The installation log file (zenworks_for_desktops_server_installlog.log) indicates that the zenimgdsr.dll file was not successfully copied. This condition exists because the original .dll file remains open on the server during the installation. Both the ZENworks for Desktops 4.x and the ZENworks 7 Desktop Management versions of the .dll are the same, so the failure to install is inconsequential.
If you want to avoid the error, you can rename zenimgdsr.dll on the server and then run the installation program.
This section explains the issues that might occur when users upgrade from older versions of ZENworks Desktop Management or ZENworks for Desktops to ZENworks 7 Desktop Management.
If you upgrade your ZENworks Desktop Management Server to ZENworks 7 (NetWare, Windows, or Linux server platforms) but do not upgrade the ZENworks 6.5 Middle Tier Server software to ZENworks 7, and if the Middle Tier Server is running on NetWare 6, workstation associated group policies will fail to distribute to workstations where the ZfD 4.x or ZENworks 6.5 Desktop Management Agent is installed.
To work around this issue, make sure you upgrade the Middle Tier Server to ZENworks 7.
When configuring the upgrade Application object for the Desktop Management Agent, you should set the application to RUN ONCE, so that after the agent is installed the user can no longer see the application in the Novell Application Launcher. We also recommend that you do not enable uninstall for the Application Object.
Administrator rights are not needed to upgrade the Desktop Management Agent. The user's privileges are elevated temporarily by the Desktop Management Agent during the installation.
If you are logged in as a member of only the Users group when you upgrade the ZENworks Desktop Management Agent to version 7, the information in the HKLM\Software\Novell\Workstation Manager\Identification registry key is lost. This results in the workstation no longer being registered (that is, it is no longer imported into the eDirectory tree).
This condition occurs because registry information is not read and saved prior to the uninstall. In some environments, this is not an issue because the workstation is re-imported at the next workstation reboot. In environments where import is dependent on the User (for naming or location) however, the user must log in as many times as specified in the User Login Limits field (specified in the Import Policy) before the workstation is re-imported.
NOTE: You can avoid this issue if you change the permissions to the HKLM\Software\Novell\Workstation Manager\Identification key before you upgrade the Agent upgrade: grant Read access to the Users group. You can distribute registry permissions using ZENworks Group Policies by importing an INF file containing the desired permissions. For more information, see Windows Group Policy (User and Workstation Packages) in the Novell ZENworks 7 Desktop Management Administration Guide.
After the ZENworks 7 Desktop Management Agent is installed, the necessary permissions for the registry key are set for future upgrades.
If you upgrade the ZENworks Desktop Management Agent already installed on Windows 98 to the ZENworks 7 version of the agent, the installation displays a message after the workstation reboot stating that an error has occurred in ncred9x.dll. No user login is possible after this failed upgrade and the workstation is left in a bad state.
The error occurs because of a flaw in the Windows 98 MSI engine that does not properly update certain files.
If you want to avoid this problem, you need to include the following property on the MSI Application object for Windows 98 workstations only:
REINSTALLMODE=vamus
This will properly place the files on the Windows 98 workstation.
For more information about setting MSI properties, see "MSI Tab" in "Reference: Application Object Settings" in the "Application Management" section of the ZENworks 7 Desktop Management Administration Guide.
If you upgrade the ZENworks Desktop Management Agent already installed on Windows 98 to the ZENworks 7 version of the agent, the installation displays a message after the workstation reboot stating that an error has occurred in ncred9x.dll. No user login is possible after this failed upgrade and the workstation is left in a bad state.
The error occurs because of a flaw in the Windows 98 MSI engine that does not properly update certain files.
If you want to avoid this problem, you need to include the following property on the MSI Application object for Windows 98 workstations only:
REINSTALLMODE=vamus
This will properly place the files on the Windows 98 workstation.
For more information about setting MSI properties, see "MSI Tab" in "Reference: Application Object Settings" in the "Application Management" section of the ZENworks 7 Desktop Management Administration Guide.
This section explains the issues that might occur when users try to authenticate to the Desktop Management Server using either the Novell Client or the Desktop Management Agent for login.
Some NetWare servers might generate a 500-level error when you attempt to import workstations after editing the hosts file on that NetWare server.
To work around the problem, reboot the NetWare server where you installed the ZENworks Middle Tier Server and whose hosts file you edited for workstation import.
If you try to authenticate through the Middle Tier Server to a Desktop Management Server installed on a Windows 2000 machine that already has Active Directory* (installed because the Desktop Management Server acts as the Primary Domain Controller) and eDirectory (installed to accommodate Desktop Management) both installed, the authentication fails unless the user logs on with a full context.
The reason for this failure is a contention for the default LDAP port between the Active Directory and eDirectory LDAP listeners. To work around this port conflict, during the install of eDirectory either choose an LDAP port other than the default of 389 or modify the LDAP Group object found in the server's container in ConsoleOne, then use the NSAdmin utility in the Middle Tier Server to configure the Middle Tier Server to communicate over that port.
To configure the port in NSAdmin:
In the Address box of Internet Explorer, type the URL for the NSAdmin utility. For example:
http://server_name_or_IPAddress/oneNet/nsadmin
In the Value field of the LDAP Port configuration parameter, specify the LDAP port number you already set in eDirectory and which the Middle Tier Server should use to communicate with the Desktop Management Server > click Submit.
NOTE: Do not attempt to use another Internet Browser (such as Mozilla Firefox) instead of Internet Explorer to run the NSAdmin utility. Other browsers fail to run NSAdmin properly.
For more information regarding this issue, see TID 10073537 in the Novell Support Knowledgebase.
If you try to manually unload the Middle Tier Server Handlers (for example, xzen.nlm) running on NetWare 6, the server abends.
On NetWare 6, you should use NVXADMDN to unload Apache and Middle Tier handlers. Use NVXADMUP to restart Apache and Middle Tier handlers.
On NetWare 6.5, you should use AP2WEBDN to unload Apache and Middle Tier handlers. Use AP2WEBUP to restart Apache and Middle Tier handlers.
Using ndscons.exe on Windows 2000 to verify the connection between the Middle Tier Server and the Desktop Management Server does not work unless you have Administrator rights for the local Windows 2000 user.
A workstation with the Desktop Management Agent installed and running in Passive mode without the Novell Client presents the following option in a drop-down box when you click Change Password from a Windows Security dialog box (Ctrl+Alt+Delete):
<Novell Netidentity Credentials Provider>
This option for changing the eDirectory password from NetIdentity is currently non-functional. To change the password for the Agent running in Passive mode, open the Control Panel, click ZENworks Agent Options, and change the password in the appropriate dialog box.
If the Novell Client and the Desktop Management Agent are installed on the same workstation and the user logs in to the local workstation, then opens myapps.html and clicks the Work Online link in the Application Launcher Web View, the NetIdentity login does not work. This is designed behavior. If a workstation has the Novell Client and the ZENworks Management Agent both installed, Application Management always uses the Novell Client.
If only the Agent is installed on the workstation, in this same scenario, the Work Online link in the Web view activates the NetIdentity login.
Workstations that use the ZENworks for Desktops 4.x Desktop Management Agent cannot access files (such as applications to be cached) from a Desktop Management Server installed on Windows if the files must be accessed through a Middle Tier Server installed on a Linux machine (SLES 9 SP1 or OES Linux).
The problem occurs for two reasons:
You can work around this problem by installing a ZENworks 6.5 (or later) Desktop Management Agent, which uses ZENMUP to communicate directly to the Windows server.
Testing indicates that excessive login times result when workstations authenticate through a firewall and copy policy files or application files at login time.
To work around this issue, we recommend that you configure applications and policies to use DNS names for file locations on the back end, rather than IP addresses.
LDAP authentication, which is launched when users log in and access ZENworks applications or policies, consumes two of the grace logins granted to a user when the user's password expires. Grace logins are set in ConsoleOne on the Restrictions page (password restrictions section) of the eDirectory User object.
For example, when eDirectory notifies a user that he or she has 2 grace logins left on a server, that user actually has no grace logins and will not be able to log in until the password is reset.
This section identifies some areas of the Desktop Management Workstation Import and Removal component that might not work properly or that might require further configuration in ZENworks 7 Desktop Management.
If, during eDirectory installation on a SLES 9 server, the LDAP port was set to listen on a port other than port 389, Automatic Workstation Import will fail when run on that server.
It is now possible to manually configure the novell-zdm-awsi.conf file to allow alternate ports to handle Automatic Workstation Import. Use the following steps to modify the .conf file:
This section identifies some areas of the Desktop Management Workstation Management component that might not work properly or that might require further configuration in ZENworks 7 Desktop Management.
The startup scripts for Windows Workstation Group Policies configured in the Workstation Policy Package might not run consistently when scheduled for system startup in ZENworks 7 Desktop Management, even when Persist Workstation Settings is selected.
This section discusses some aspects of Windows Group policy administration that might not work properly or that might require further configuration in ZENworks 7 Desktop Management.
If you apply a workstation group policy created for Windows XP that is configured with security settings and you also apply a user group policy created for Windows XP that is configured with security settings (for example, you want to define a user certificate), the security settings applied with the user group policy overwrite the security settings applied by the workstation group policy.
If you disable the security settings in the user policies, the security settings configured in the workstation policy are set and activated.
If you use an explicit IP address in the file path when you associate a group policy to a user or workstation (that is, in ConsoleOne, you supply an IP address in the path to the policy---for example, \\137.65.167.123\c$\pathname), you cannot log in from an XP workstation with the Desktop Management Agent installed.
You should use the server name in the path rather than an IP address.
If you launch the Microsoft Management Console (MMC) from ConsoleOne to edit a Windows Group Policy---specifically to rename a default user account (Administrator or Guest), you must not be logged in as the user whose default account name you are changing. If you log in using this default account and rename the account, the changes are not saved to the network path you designate in ConsoleOne and might remain on the administration machine.
If network users with Roaming Profiles are seeing multiple c:\documents and settings\username.machine_name.nnn folders on a Windows workstation where they log in, or if users notice slow Windows logoffs or slow workstation shutdowns, it might be due to Windows registry keys being left open.
To work around this problem, download and use the Microsoft User Profile Hive Cleanup Service, a utility that closes open registry keys in the user hive, allows Roaming Profiles to be deleted normally at logoff time, and allows faster workstation logoffs and shutdowns.
We recommend that you use the Novell Application LauncherTM to distribute this MSI application to all affected workstations.
After ZENworks 7 Desktop Management installation, iPrint printers are not distributed to users running Windows 2000/XP workstations, even after the ZENworks 7 Desktop Management iPrint policy is configured in the User Policy package (which installs the iPrint Client and pushes printer drivers to the users) and their workstations are rebooted.
To work around this problem in NetWare 6, modify the AllowUserPrinters value in the iprint.ini file in the \\server_name\sys\login\ippdocs directory from zero (0)---the default value---to one (1), which will allow the user to add the printer. In NetWare 6.5, the iprint.ini file is found in the \\server_name\sys\apache2\htdocs\ippdocs directory.
NOTE: The iprint.ini file is available only if you have installed Novell Distributed Print ServicesTM as part of a NetWare installation and if you have extracted the nipp.exe to that directory. If you do not have iprint.ini and nipp.exe, you can download them from Novell Support at http://support.novell.com. Search for TID 2968629.
If you use the iPrint policy to distribute printers through a firewall to a Windows 2000/2003 terminal server user session, the policy does not correctly set the required registry key to bypass the iPrint proxy address manual configuration.
Each terminal server session user who needs to print to printers from outside the firewall needs to use the following steps to set the proxy address:
In the User's Terminal Server session, click Start > Programs > Novell iPrint > iPrint Client, then click the Proxy tab.
Select the Use a proxy Server for iPrint Printing check box.
In the Proxy URL field, type the external firewall proxy address of the proxy server, then click OK.
When the proxy address is set, the printer policy distributes without a problem.
If user authenticates to a Desktop Management Server installed on a Linux server (OES or SLES 9), the iPrint client will be distributed to their desktops, but the iPrint printer drivers will not be distributed to their desktops.
This is a known issue in one of the ZENworks Desktop Management Agent files and will be corrected in a future version of the Desktop Management Agent.
The Novell iPrint policy (User and Workstation packages) does not run in a SUSE LINUX Enterprise Server 9 only environment. In order to run the Novell iPrint client, you must have at least one NetWare server in your system.
This section identifies some areas of the Application Management component that might not work properly or that might require further configuration in ZENworks 7 Desktop Management.
Although nal.exe and nalexpld.exe are included in the product and still launch executables, their purpose is to facilitate the continued functioning of existing login scripts.
ZENworks 7 Desktop Management only supports switches that are supported by nalwin32.exe. To see a list of these switches, enter the following command:
nalwin32.exe /?
You see the same switches if you enter the following command:
nalwin.exe /?
It is currently not possible to close the Application Explorer window using the Exit Application Explorer option on the File menu.
To close the Application Explorer, click the Close (X) button on the upper right-hand corner of the Application Explorer window.
Although you can drag an application icon from the right-hand pane of the Application Window view to the Windows desktop, doing so creates a broken shortcut that will not launch the application.
You can work around this issue by launching the Application Explorer view after you create the shortcut. Launching the Application Explorer causes the shortcut to work properly. Later, when you close the Application Explorer, the shortcut is removed from the desktop.
If a user sets the option of using a myapps.html as the Web page background for their Windows XP desktop, Windows XP generates script errors and myapps.html will not display applications.
If you want users to use this feature, you need to edit portions of the myapps.html that this feature can't handle. The easiest method is to extract the data from WriteData() function in the file and use it as the content of a new .html file.
The comments of the Web page will look like this:
<head>
<title>Novell Delivered Applications</title>
</head>
<body scroll='no' style='margin: 0; overflow:hidden'>
<object id="AxNalView" classid="CLSID:4F4B2E32-B44C-450E-8683-6903FE9DDCEA" width="100%" height="100%">
<!--param name="SingleTree" value="ZENWORKS_TREE"-->
<!--param name="PortalView" value="false"-->
<!--param name="BannerURL" value="http://www.company.com/banner.html"-->
<!--param name="BannerHeight" value="80"-->
<!--param name="ShowTree" value="true"-->
<!--param name="ShowTasks" value="false"-->
<!--param name="AppDisplayType" value="1"-->
<!--param name="ShowAppFrameNavigation" value="true"-->
<!--param name="ShowIEToolbarButton" value="true"-->
</object>
</body>
</html>
Save this file to the hard drive. You can then use it as an XP background.
If you access a Web page served by the Apache Web Server, and if that Web page contains Japanese characters, such as the Japanese version of myapps.html, the characters on that page might appear garbled.
This is a known issue with the Apache Web Server, and can be corrected with a simple configuration workaround in Apache. To better understand the problem, see the Sun Developer Network site for an article entitled Creating Multilingual Web Sites with Apache. For specific information about how to work around the problem and configure the server, see the Apache HTTP Server Version 2.0 Documentation article entitled Content Negotiation.
The ZENworks 7 Desktop Management version of myapps.html (part of the Application Launcher Plug-in) does not include functionality to launch thin client applications from a Windows Terminal Server.
If you want users to launch thin client applications, you need to install the ZENworks Management Agent on user workstations.
The next release of ZENworks Desktop Management will add functionality to the Application Launcher Plug-in installation to allow launching of thin client applications from workstations.
The new Terminal Server system requirement on an Application object applies only to remote Terminal Server sessions. Sessions running at the Terminal Server console are considered to be remote sessions by default. This behavior can be changed by creating the following registry key on the Terminal Server itself:
HKEY_LOCAL_MACHINE\Software\Netware\Nal\ConsoleIsNotTS
Creating this registry key will cause sessions running on the Terminal Server console to be treated as non-Terminal Server sessions.
If users have a version of the Novell ClientTM older than version 4.9 Support Pack 2 to login locally (that is, "Workstation Only"), the NWGINA will not authenticate to eDirectory and will not make any network requests. In addition, the Novell Client will have an unauthenticated or "monitored" connection to the eDirectoryTM tree determined to be the primary tree.
If the user subsequently authenticates from the Novell Application Launcher using the Middle Tier Login, the NetIdentity client authenticates to the ZENworks Management Server serviced by the Middle Tier Server.
Attempts made by the Application Launcher to distribute an application through this authentication will fail because the files to be distributed are located on the server where the client has created a monitored connection. Through this connection, the client sees the sys: volume on the server (all users have rights to the \login directory on the sys: volume of a NetWare server because older clients authenticated by running login.exe).
To work around this issue, the user must right-click the red "N" icon for the Novell Client in the system tray to log in to the server. Users should not right-click the Application Launcher icon in the system tray and select "ZENworks Middle Tier Server Login" to log in.
When a distributed application is configured to be uninstalled from a workstation, the workstation does not currently prompt for a reboot when the uninstall is complete.
Because the uninstall might affect the Windows registry, other applications reading the registry at startup might be adversely affected unless the workstation is rebooted. Users should always reboot manually after a distributed application is uninstalled.
If you configure an .ini file application to be uninstalled with the Create Or Append To Existing Value attribute selected for uninstall, the value that was added during the original installation is not removed.
The only current workaround for this issue is a manual edit of the .ini file.
A key component of Novell Licensing Services, nls32.dll, does not ship with the current Novell Client. As a result, an error is generated when you try to use Software License Metering and Monitoring in Desktop Management.
To work around this problem, copy nls32.dll and nlsapi32.dll from the companioncd\companion1\licensing directory of the Companion 1 CD to each workstation where you want to check application licenses. On Windows 2000/XP workstations, copy to the c:\winnt\system32 directory. On a Windows 98 SE workstation, copy to the c:\windows\system directory.
The icon for a workstation associated application set as disconnectable does not appear immediately when the user logs in to the workstation locally without authenticating to eDirectory.
Due to a delay built into the code, the icon reappears on the desktop if you refresh the Novell Application Launcher after waiting for five minutes.
If you try to distribute a workstation associated MSI Application that has not had the Distribute in Workstation Security Space if Workstation Associated option selected and if the workstation launch cache is disabled when the application distribution is attempted, an error will be generated to inform you that the application distribution is unsuccessful.
The distribution fails because the Application Launcher tries to read the MSI application attributes with user privileges. User privileges are not recognized because writing to the launch cache is disabled, and the user does not have privileges to the Application Object outside the cache.
To avoid this error, do one of the following:
When several Application objects previously set for Force Cache are accessed by the Novell Application Launcher running against a NetWare 6.5 server with cifs.nlm loaded, the NetWare server might abend when the first application is cached.
We have identified the problem and fixed it in a NetWare 6.5 SP1 patch and in NetWare 6.5 SP2.
Workstation associated applications will be available to users on the first reboot following a successful import of the workstation to an eDirectory tree.
If you run ConsoleOne and ZENworks 7 snap-ins locally from a Windows XP workstation where the ZENworks for Desktops 4 SP1b or 4.0.1 Desktop Management Agent has also been installed, you will not be able to import or export AOT or AXT files from ConsoleOne on that workstation. Doing so will cause ConsoleOne to crash.
We recommend that you avoid using this combination of software if you want to use ConsoleOne to import or export AOT or AXT files.
Instead, you should launch a local copy of ConsoleOne from a workstation that has the ZENworks 7 Desktop Management Agent installed. This copy should not contain the ZENworks for Desktops 4 SP1b or ZENworks for Desktops 4.0.1 snap-ins.
If you try to create an AOT/AXT of a Windows XP application using SnAppShot, an error might display informing you that the SnAppshot failed to copy a file from the c:\windows\softwaredistribution directory.
The error occurs because the c:\windows\softwaredistribution folder has not been added to the exclusion list.
If you have not yet begun to create the AOT/AXT, we recommend that you manually add c:\windows\softwaredistribution to the exclusion list.
If you have already begun the snAppShot process and received the error, we recommend the following workaround procedure:
From the error message, note the name of the file that could not be copied, then click Ignore on the error message dialog box to skip copying the file to the .fil directory.
Import the AOT/AXT into ConsoleOne.
Remove the entry for the uncopied file from the App Files tab of the AOT/AXT Application object.
When you create an application in snAppShot on a Japanese-enabled Windows XP workstation and then browse the applications install directory, the following error might be displayed:
External Exception C0000006
This issue will be addressed in the next release of snAppShot.
If you initiate the distribution of Application object from a cluster resource and then initiate a cluster resource migration before the distribution is complete, the distribution might time out before completing and will generate an error.
To work around this issue, you need to manually relaunch the distribution.
If you attempt to import an existing Application object's .fil files or registry keys when you create new Application object, the import of that information will fail if the location of the older information is located in a path that includes a folder name with a more than 8 characters, a space, or an extended character.
If you distribute chained, dependent applications to a Windows 98 workstation in a ZENworks environment where the Middle Tier and Desktop Management Servers have been upgraded to ZENworks 7 Desktop Management but the Desktop Management Agent has not been upgraded from the 4.x version or from the 6.5 shipping version, the application distribution might fail with various errors.
In this situation, you might see the first few applications in the chain distribute normally, but a subsequent distribution of another application in the chain might seem to place the workstation in a disconnected state.
There are two methods of working around the problem:
This section identifies some areas of the Desktop Management Workstation Imaging component that might not work properly or that might require further configuration in ZENworks 7 Desktop Management.
Upgrading a Windows 2000 workstation hard disk from a Basic Disk System to a Dynamic Disk System changes the partition table so that it does not allow the workstation to boot to the production partition, only to the Desktop Management Linux* partition. No fixes for this issue are included in ZENworks 7 Desktop Management.
The Workstation Imaging component of ZENworks 7 does not support dynamic disks. If you upgrade your disks, you will no longer be able to use Workstation Imaging.
If you install the ZENworks 7 Desktop Management Workstation Imaging component to a Windows 2000 server that has more than one network interface card (NIC), you do not have the option of binding the imaging proxy server to a specific IP address.
If you install Workstation Imaging to a NetWare server, you can bind the imaging proxy server to a specific IP address (that is, the NIC of your choice) by using the following switch:
load imgserv -i:IP_Address
The PXE-on-Disk Setup utility does not detect nor display drivers for PXE-compatible network adapters that are manufactured by NETGEAR, Inc.
The five boot disks created with zimgboot.exe do not have enough room to include all files, including USB drivers.
If a workstation requires USB drivers, users may see error messages similar to one of the following:
Load USB Modules /bin/runme.s: /lib/modules/2.4.22/kernel/drivers/usb No Such File or Directory
or
Load USB Modules /bin/runme.s: /lib/modules/2.4.22/kernel/drivers/usb/storage No Such File or Directory
If users whose workstations require USB drivers encounter these errors, you should prepare an imaging boot CD for their workstations. An imaging boot CD has enough space to include the proper USB drivers.
This section identifies some areas of ZENworks Desktop Management's Remote Management component that might not work properly or that might require further configuration in ZENworks 7 Desktop Management.
If a managed workstation has multiple monitors, a remote session from a management console manages only the primary monitor of the managed workstation.
During a remote control session on the managed workstation, if you change the mode of display from DOS box application mode to full-screen mode, you do not receive updates until you change to the normal mode or close the DOS box.
If a user uses the Remote Desktop Connection to connect to a Windows XP workstation, and then initiates a Remote Control session on that workstation, the Remote Control console will be black and you will not be able to remote control it.
Users with a Windows XP workstation should log in locally before you attempt to remote control their workstations.
During a Remote Control session, you might not be able to remove the active desktop wallpaper on the managed workstation. This affects Remote Management performance.
To work around this problem, you must manually suppress the wallpaper of the managed workstation.
For wallpaper suppression, Windows XP behaves differently from other Windows operating systems. When you set the wallpaper, Windows XP creates a backup of it. When you disable the wallpaper, it is disabled from the primary location only. When you change the settings, the wallpaper might resurface.
Animated and the colored cursors on the managed workstation are not supported for Remote Management.
During a Remote Management session with a Windows XP managed workstation, if you place the mouse cursor on a window that is continuously changing (for example, Task Manager), the mouse cursor flickers at the managed workstation. This cursor behavior is apparent at the managed workstation only.
Wake-on-LAN service running on NetWare 6.5 SP1a (and later) server might not wake up target workstations if the schedule is modified.
To work around this problem, try restarting the service.
On Windows 2000/XP workstations, DirectX applications do not run in exclusive mode during a Remote Control or a Remote View Session.
If the Service Control Manager is running when the Remote Management Agent is upgraded to ZENworks 7, the Novell ZENworks Remote Management Service is not created, even after you restart the managed workstation.
To resolve this problem, ensure that the Service Control Manager is closed before upgrade.
When you restart a Linux server where the ZENworks Wake-On-LAN service is installed, the boot login screen might display the Wake-On-LAN service as missing even though the Wake-On-LAN services run appropriately. You can ignore the message.
On a Windows 98 workstation, when you upgrade the Remote Management Agent from ZENworks for Desktops 4.0.1, ZENworks 6.5 Desktop Management or ZENworks 6.5 Desktop Management Support Pack 1 to ZENworks 7, the Remote Management password, if set, is deleted.
Workaround: At the command prompt, enter the following command:
msiexec /i "path_of_MSI zfdagent.msi" REINSTALLMODE=vamus
If you are installing via MSI application object, specify vamus in the REINSTALLMODE property.
IMPORTANT: This workaround is applicable only if you are upgrading from ZENworks 6.5 Desktop Management or a later version of the Desktop Management Agent.
The Remote Management Agent help might not launch from the Remote Management Agent icon in the system tray of the managed device.
To work around the problem and view the Help, navigate to the following location and double-click rcagent.chm: zenworks_agent_directory\remotemanagement\rmagent\nls\language directory.
File Transfer does not work when launched from desktop4.exe extracted from desktop.zip shipping with the Companion 2 CD.
To work around the problem, use the the following steps:
Extract desktop.zip.
Remove the \jre directory extracted from desktop.zip.
Copy the \jre directory shipping with ConsoleOne 1.3.6 and paste it in place of the \jre directory you removed in Step 2.
This section identifies some areas of the Desktop Management Workstation Inventory component that might not work properly or that might require further configuration in ZENworks 7 Desktop Management.
If you want to reinstall the Inventory Server or the Inventory Database on Linux, you must first uninstall the component you want to reinstall, then proceed with installing the component again.
If you install the Inventory server component of ZENworks 7 Desktop Management on a NetWare 6.5 SP2/SP3 or NetWare OES server, the Inventory service might fail to start after the installation.
If the Novell Client is not installed on inventoried workstations, and if you use double-byte characters in the Inventory Service object's scan directory (scandir) path, the .str files are not transferred to the Inventory server.
By default, the scandir path is the installation path where the Inventory server-side components and the database are installed (unless you manually changed it after the ZENworks 7 Desktop Management installation by configuring the Inventory Service object).
This section identifies other issues that might cause problems or require workarounds when you use ZENworks 7 Desktop Management.
Launching an RDP or ICA application from the Launch Item Gadget on a Windows XP SP2 workstation generates the following error message:
To help protect your security, Internet Explorer stopped this site from installing software on your computer. Click here for options...
If users are using Windows XP SP2 (or greater) workstations, they can click on the information bar at top of Plug-in dialog box in order to install the Citrix ICA/RDP client. Alternatively, you can have users contact you for help with installing the Citrix ICA/RDP client.
ZENworks 7 Desktop Management does not support DNS-rooted trees or federated trees.
In the shipping version of ZENworks for Desktops 4.x, the property pages for User, Workstation, and Container objects in ConsoleOne included an Application Launcher and an Applications tab.
With ZENworks 7 Desktop Management, these two pages are now consolidated under the ZENworks tab in the User, Workstation, and Container objects.
Workstation Import and Workstation Management (that is, policies pushed to workstations or users) may work differently when users connect through a VPN.For more information, see TID 10096902 in the Novell Support Knowledgebase.
If you have installed either the Desktop Management Database or the Inventory Database on a NetWare server, the following error message might be displayed during database operations:
Connection terminated abnormally
This is a false message and can be ignored.
If you are running ConsoleOne on a Windows machine configured with two different IP Addresses on two different networks, ConsoleOne will not be able to send data to eDirectory and will generate an error code.
You may see this behavior if you attempt to create a stream attribute against eDirectory running on a SUSE Linux server.
The ZENworks 7 Desktop Management Agent does not work properly with versions of the NSure® SecureLogin earlier than 3.51.1.
If you install the ZENworks 7 Management Agent on a workstation that has a version of SecureLogin earlier than 3.51.1 already installed, the user's login attempts will fail and the workstation will reboot.
If you have already encountered this problem, you can return the workstation to a working state by following the instructions in TID 10096513 in the Novell Knowledgebase.
In this documentation, a greater-than symbol (>) is used to separate actions required when navigating menus in a user interface.
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.
Any products or technical information provided under this Agreement may be subject to U.S. export controls and the trade laws of other countries. You agree to comply with all export control regulations and to obtain any required licenses or classification to export, re-export, or import deliverables. You agree not to export or re-export to entities on the current U.S. export exclusion lists or to any embargoed or terrorist countries as specified in the U.S. export laws. You agree to not use deliverables for prohibited nuclear, missile, or chemical biological weaponry end uses. Please refer to http://www.novell.com/info/exports/ for more information on exporting Novell software. Novell assumes no responsibility for your failure to obtain any necessary export approvals.
Copyright © 2005 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.
Novell, Inc. has intellectual property rights relating to technology embodied in the product that is described in this document. In particular, and without limitation, these intellectual property rights may include one or more of the U.S. patents listed at http://www.novell.com/company/legal/patents and one or more additional patents or pending patent applications in the U.S. and in other countries.
ConsoleOne, NetWare, Novell, NSure, and ZENworks are registered trademarks of Novell, Inc. in the United States and other countries. eDirectory, NLM, Novell Application Launcher, Novell Client, Novell Distributed Print Services, and snAppShot are trademarks of Novell, Inc.
All third-party products are the property of their respective owners.