GroupWise 6 Support Pack 4

November 14, 2003

Overview

This Support Pack contains updates for all components contained in the GroupWise® 6 product. If the Support Pack file was downloaded, the Support Pack file 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, internationalization testing, and integration testing with other Novell® products.

This Support Pack includes all fixes from the previous Support Packs; therefore, you do not need to install earlier Support Packs before installing this Support Pack. Do not install individual files from the Support Pack.

Install the NetWare® Support Pack before installing other Novell product support packs like GroupWise and BorderManager®. These Support Packs are included with the Consolidated Support Pack, or they can be downloaded individually from the Consolidated Support Pack Web site.

For information on the latest Support Pack issues, see TID 10085454 at the Novell Support Web site .

To order the Support Pack CD, go to the Consolidated Support Pack ordering page .

1.0 Support Pack Installation
1.1 Version Information
1.2 Prerequisites
1.3 Installing the Support Pack
2.0 Installation Issues
2.1 NDS/eDirectory Schema Extension During Installation
2.2 Windows Version Requirements for WebAccess and Monitor
2.3 WebAccess and Monitor on the Same Web Server
2.4 Wireless Device Support for WebAccess and Monitor
2.5 Windows 2000 Service Pack 2 or Above Required for Agents
2.6 Wsock32.dll Dated July/August 1995
2.7 Additional Installation Issues
3.0 Component Issues
3.1 Administration Issues
3.1.1 GWTSA Error Message
3.1.2 Directory Names and Filenames
3.1.3 Server Names
3.1.4 ConsoleOne on Windows NT
3.1.5 Quotas on NSS Volumes
3.1.6 TurboFat Compatibility
3.2 Agent Issues
3.2.1 Newer LDAP Files
3.2.2 Unread Message Count Feature Requires at Least the SP1 Version of the POA
3.3 Client Issues
3.3.1 NetWare 5.1 SP1 Compatibility for Client Installation
3.4 Internet Agent Issues
3.4.1 IMAP Access Requires at Least the SP1 Version of the POA
3.4.2 Address Resolution Change Since GroupWise 6 and Previous Support Packs
3.4.3 Viewer Issue with the Internet Agent and Clustering
3.4.4 Display Name Format Changed for Last.First@Host Address Format
3.5 Monitor Issues
3.5.1 Restoring Monitor Settings after Reinstallation
3.6 WebAccess Issues
3.6.1 Using the Latest Novell Client
3.6.2 Installing NetWare 5 Support Pack 3a or NetWare 5.1
3.6.3 Installing to Non-Supported Web Servers
3.6.4 Configuring WebAccess to Use a Java Servlet Engine Other Than the Novell Servlet Gateway or Tomcat Servlet Engine
3.6.5 Login Page Reappears after Successful Login
3.6.6 Security Issue with WebAccess and Internet Explorer 5.0
4.0 International Issues
4.1 Installation on Windows 98
4.2 Double-Byte Characters in Directory Names and File Names
4.3 Double-Byte Characters in Passwords
4.4 Euro Character in Subject Field
4.5 Print Calendar Language
4.6 RichWin and GroupWise 6
4.7 Windows Messaging System
4.8 Arabic Spell Checker
4.9 German Spell Checker
5.0 Changes Since the Last Support Pack
5.1 Address Book Fixes
5.2 Administration Fixes
5.3 Admin API Fixes
5.4 Agent Fixes
5.5 Client Fixes
5.6 Client API Fixes
5.7 Engine Fixes
5.8 GWCheck Fixes
5.9 Internet Agent Fixes
5.10 Monitor Fixes
5.11 WebAccess Fixes
6.0 Product Testing
7.0 Documentation
7.1 Support Pack Documentation
7.2 GroupWise 6 Readme Files
7.3 GroupWise 6 Installation Guide
7.4 GroupWise 6 Administration Guide
7.5 GroupWise 6 Help
8.0 Documentation Conventions
9.0 Legal Notices

1.0 Support Pack Installation


1.1 Version Information

GroupWise 6 Support Pack 4 can be applied to any of the following GroupWise versions in your software distribution directory:

When you update the software distribution directory, we recommend that all GroupWise components be updated to keep them at the same version level.

GroupWise 6 Pack Support Pack 4 is the last scheduled update to the GroupWise 6 product. You can update to GroupWise 6.5 to continue receiving Support Packs for GroupWise.


1.2 Prerequisites

Before installing GroupWise 6 Support Pack 4:


1.3 Installing the Support Pack

  1. If you are installing from the Web, extract the contents of the downloaded Support Pack file by copying it to a temporary directory and running it. If you are installing from the CD, no extraction is needed; continue with Step 2.

    Extract the file on the server's sys: volume or on another server volume that has read/write access. This compressed file contains directory paths that could exceed the DOS limits. The file must be extracted in a root-level directory on your local drive or on a NetWare volume that accepts longer paths.

  2. Use Windows* to run the setup.exe program extracted in the previous step. Click Start > Run > Browse. Select the file from the temporary directory, then click OK.

    See Section 1.2: Windows Version Requirements for WebAccess and Monitor in the gw6_iss.txt file at the root of the Support Pack if you are installing GroupWise WebAccess or GroupWise Monitor.

  3. Follow the on-screen instructions provided in the Support Pack program to update the software distribution directory and the administration, agent, and client software in production.

  4. After applying the update on NetWare servers where agents are running, restart the NetWare servers to ensure that all updated NLMTM programs are loaded. This will resolve any errors you might see during the update process.


2.0 Installation Issues


2.1 NDS/eDirectory Schema Extension During Installation

The installation programs for the following GroupWise® components extend the NDS®/eDirectoryTM schema of the tree where you are installing the components:

You must be an admin equivalent to extend an NDS tree's schema.


2.2 Windows Version Requirements for WebAccess and Monitor

Limitations with Windows* 95a (SR1) require that you install GroupWise WebAccess and GroupWise Monitor from a Windows 95b, Windows 98, Windows NT*, Windows XP, or Windows 2000 workstation. Do not install from a Windows 95a (SR1) workstation.


2.3 WebAccess and Monitor on the Same Web Server

The WebAccess Application, WebPublisher Application, and Monitor Application share a common library. This library changed significantly from GroupWise 6 to GroupWise 6 SP1 and above. If you plan to run these applications on the same Web server, you must update all three before any of them can work properly.


2.4 Wireless Device Support for WebAccess and Monitor

The GroupWise Monitor software included with GroupWise 6 SP4 supports the following wireless devices:

We are continually evaluating and adding support. As we add support for additional devices, we post the updates at the Novell® GroupWise Wireless Web site. We encourage you to check this site frequently for updates and news.


2.5 Windows 2000 Service Pack 2 or Above Required for Agents

If the GroupWise Post Office Agent, Message Transfer Agent, Internet Agent, and WebAccess Agent are installed on Windows 2000 and the GroupWise domain and/or post office directories accessed by the agents are on NetWare® servers (or any non-Windows servers), you need to apply the Windows 2000 Service Pack 2 or above on the Windows servers. You can download Windows 2000 Service Packs from Microsoft*.

NOTE:  If, as required with the initial release of GroupWise 6, you already installed Microsoft HotFix* Q266066 on all Windows 2000 servers where GroupWise 6 Support Pack 4 agents run, you do not need to apply Windows 2000 Service Pack 2 or above.


2.6 Wsock32.dll Dated July/August 1995

The versions of wsock32.dll dated July 1995 and August 1995 are known to cause the following problems:

An updated version of wsock32.dll is available from Microsoft as wsockupd.exe.


2.7 Additional Installation Issues

Installation issues for individual GroupWise components are located under the heading for each component.


3.0 Component Issues


3.1 Administration Issues


3.1.1 GWTSA Error Message

If you load the GWTSA and then connect using SBCON, you receive the following message:

Unexpected Error:
-- FailedToOpenFile (unregistered error)
Details: <FailedToOpenFile>
<Filename>sys:\system\tsa\XisErr.xml>

The backup still runs successfully. To eliminate the error message, create an empty XisErr.xml file in sys:\system\tsa.


3.1.2 Directory Names and Filenames

All directory names in paths to GroupWise domains and post offices can consist of up to 8 characters.

Filenames can consist of up to 8 characters, with extensions of up to 3 characters. Do not use long filenames. This requirement also applies to any files that are not specific to GroupWise (such as SSL certificates and key files) but are used by GroupWise components.


3.1.3 Server Names

When filling in a UNC Path field in ConsoleOne®, you must specify the server name. You cannot use an IP address or DNS host name.


3.1.4 ConsoleOne on Windows NT

If you plan to run ConsoleOne on Windows NT 4, you must install NT 4 Service Pack 6 before you install ConsoleOne.


3.1.5 Quotas on NSS Volumes

If you use NSS volumes with quotas turned on, then you must turn on quotas on all GroupWise directories. Otherwise, you receive No Disk Space errors.


3.1.6 TurboFat Compatibility

If you see E811 errors on the POA or the GroupWise client, a possible cause is that TurboFat is causing corruption to GroupWise database pointers. The solution is to turn off TurboFat.

These NLMTM programs disable TurboFat at startup.


3.2 Agent Issues


3.2.1 Newer LDAP Files

During installation of the NetWare agents, you might receive the following messages:

The file \\path\ldapsdk.nlm is newer than the file being installed.
  Do you want to replace this file?

The file \\path\ldapssl.nlm is newer than the file being installed.
  Do you want to replace this file?

The file \\path\ldapx.nlm is newer than the file being installed.
  Do you want to replace this file?

Do not overwrite your new LDAP files with the older LDAP files that are in the Support Pack. The Support Pack does not rely on the older versions. The newer versions work fine.


3.2.2 Unread Message Count Feature Requires at Least the SP1 Version of the POA

Starting with GroupWise 6 SP1, the client includes the Unread Message Count feature. Next to each folder, the GroupWise client displays the number of unread messages included in the folder.

For the Unread Message Count feature to work when the GroupWise client is running in Online mode, the POA must be at least the GroupWise 6 SP1 version.


3.3 Client Issues


3.3.1 NetWare 5.1 SP1 Compatibility for Client Installation

If you are using the AutoUpdate feature for installing the GroupWise 6 client, you might encounter an error if you are installing the client from a NetWare 5.1 server where Support Pack 1 has been installed. The setupip.exe program used during the AutoUpdate process might not run correctly.

To resolve the problem, you must modify the magnus.conf file located in the following directory:

sys:\novonyx\suitespot\http-web_server_name\config

by adding the following line:

MaximumFilesReturnedInIndex 500

Then run the client installation again.


3.4 Internet Agent Issues


3.4.1 IMAP Access Requires at Least the SP1 Version of the POA

The GroupWise 6 SP1 or above POA must be running for any post offices that the SP4 Internet Agent accesses via IMAP.


3.4.2 Address Resolution Change Since GroupWise 6 and Previous Support Packs

In GroupWise 6 and its previous Support Packs, there was a problem with the address format used for sending to distribution lists and resources if you set Internet Addressing to one of the following formats (which are not appropriate for distribution lists and resources):

Messages to distribution lists and resources were initially undeliverable and were sent to the Internet Agent. The Internet Agent then successfully resolved the addresses and sent the messages back into the GroupWise system. Users did not notice the problem, but some administrators noticed unnecessary traffic through the Internet Agent.

In GroupWise 6 Support Pack 4, the address format problem for sending to distribution lists and resources has been corrected. However, users existing GroupWise 6 users have the erroneous address format for distribution lists and resources in their Frequent Contacts address books. If unnecessary traffic through the Internet Agent is a continuing problem, have users delete distribution lists and resources from their Frequent Contacts address books so that the correct address format is used for name completion in the future.


3.4.3 Viewer Issue with the Internet Agent and Clustering

If you are running the Internet Agent in a clustering environment, you must copy the Inso viewer NLM files (scc*.nlm) to the sys:\system directory of each server in the Internet Agent's failover path. Otherwise, the Internet Agent cannot locate the Inso viewer files.


3.4.4 Display Name Format Changed for Last.First@Host Address Format

In previous releases, if a user's preferred address format was Last Name.First Name@Internet Domain Name (for example, Smith.John@novell.com), the user's display name would be Last Name First Name (Smith John). This has been changed so that the display name is First Name Last Name (John Smith), which makes the display name format the same for all address formats.

If you want users' display names to be Last Name First Name, you can use a new /displaylastfirst startup switch with the Internet Agent. This forces the display name format to be Last Name First Name, regardless of the preferred address format.


3.5 Monitor Issues


3.5.1 Restoring Monitor Settings after Reinstallation

Monitor settings are stored in the monitor.xml file in the Monitor installation directory. If you reinstall the Monitor software, the monitor.xml file is backed up as monitor.001. To restore previous Monitor settings, remove the newly installed monitor.xml file and rename monitor.001 to monitor.xml.


3.6 WebAccess Issues


3.6.1 Using the Latest Novell Client

If you receive an error during installation indicating that the nvweb.dll file cannot be found, update the workstation to the latest Novell ClientTM. The Novell Client is available for download from the Novell Software Downloads site.


3.6.2 Installing NetWare 5 Support Pack 3a or NetWare 5.1

If you install NetWare 5 Support Pack 3a or NetWare 5.1 after you install the WebAccess and WebPublisher Applications to a NetWare 5 server, you need to reinstall the WebAccess and WebPublisher Applications. The Support Pack and NetWare 5.1 replace the java.cfg file and other files that are modified by the GroupWise WebAccess Installation program.

If you install the WebSphere* Application Server that is part of NetWare 5.1, the WebAccess and WebPublisher Applications no longer function. Reinstalling them does not resolve the problem. You need to restore them from backup.


3.6.3 Installing to Non-Supported Web Servers

The GroupWise WebAccess Installation program installs the WebAccess and WebPublisher Applications to the Web servers listed below. These are the Web servers for which Novell Technical ServicesSM provides support.

If necessary, you can run the WebAccess and WebPublisher Applications on a non-supported Web server as long as the Web server supports a Java* servlet engine that is JSDK 2.0 and JDK* 1.1.6 compatible. However, the Installation program does not install the applications to other Web servers, which means you must manually install and configure them. When you run the Installation program, deselect the options to install the WebAccess Application and WebPublisher Application, install the WebAccess Agent, then complete the following steps to install the applications:

  1. Unzip webaccess.zip to the root of the network server volume where the Web server resides.

    webaccess.zip and the ZIP files referred to in the next three steps are in the \internet\webacces\other directory in GroupWise 6 SP4.

  2. Unzip webaccessdocs.zip to the Web server's document root directory.

  3. Unzip webaccessservlets.zip to the servlet root directory.

  4. Unzip webaccessjars.zip to a library or jar file directory on the network server (for example, you might want to create a \novell\lib directory), then add the jar files (ldapfilt.jar, ldapjdk.jar, njgwap.jar, njweb.jar, spellservlet.jar, xalan.jar, and xerces.jar) to the class path.

  5. Modify your Java engine's servlet properties file to include the settings shown in the sample WebAccess servlets.properties file.

    The WebAccess servlet.properties file is located in the \internet\webacces\other directory in GroupWise 6 SP4.

  6. Modify the Templates.path setting in the webacc.cfg and webpub.cfg files, located in the \novell\webaccess and \novell\webpublisher directories, to replace java/servlets with the path to the servlet root directory.

  7. If you created the \novell directory structure in the location specified in step 4 (the root of the volume where the Web server resides), the paths for the following settings in the webacc.cfg and webpub.cfg should already be correct. If not, you need to modify the paths to make them correct from the perspective of the Web server.

    File.Upload.path
    Log.path
    Security.Timeout.path
    Provider.GWAP.Config.file
    Provider.LDAP.Config.file (webacc.cfg only)

  8. Copy the index.html file to the Web server's document root directory. You can replace your Web server's current default home page with this file, or you can rename the file and link to it from your current default home page.

  9. Copy the commgr.cfg file, located in the WebAccess gateway home directory (domain\wpgate\webac60a), to the \novell\webaccess directory and the \novell\webpublisher directory.


3.6.4 Configuring WebAccess to Use a Java Servlet Engine Other Than the Novell Servlet Gateway or Tomcat Servlet Engine

If you use a Java servlet engine other than the Novell Servlet Gateway or the Tomcat servlet engine, the servlet engine needs to be JSDK 2.0 and JDK 1.1.6 compatible.

After you've installed WebAccess, complete the following tasks to configure WebAccess to work with the Java servlet engine:

  1. Modify the Java servlet engine's servlet properties file to include the settings shown in the sample WebAccess servlets.properties file.

    The servlets.properties file is located in the \internet\webacces\other directory in GroupWise 6 SP4.

  2. In the webacc.cfg and webpub.cfg files, modify the Templates.path setting to replace java/servlets with the path to the servlet root directory.

    The files are located in the novell\webaccess and novell\webpublisher directories on the root of the server.

  3. Add the WebAccess jar files (ldapfilt.jar, ldapjdk.jar, njgwap.jar, njweb.jar, spellservlet.jar, xalan.jar, and xerces.jar) to the class path.

    On a NetWare server, the jar files are located in the java\lib directory. On a Windows NT server, the files are located in the novell\java\lib directory.


3.6.5 Login Page Reappears after Successful Login

If the WebAccess login page appears in one or more of the frames (for example, the Folder list or the Item list) after a WebAccess user has successfully logged in, the user is probably accessing WebAccess through one or more proxy servers.

To prevent this problem:

  1. In ConsoleOne, right-click the WebAccess Application object (GroupWiseWebAccess), then click Properties.

  2. On the Environment page (located on the Application tab), deselect the Use Client IP in Securing Sessions option.

    For information about this option, click the Help button on the Environment page.

  3. Click OK to save the change.


3.6.6 Security Issue with WebAccess and Internet Explorer 5.0

When using Internet Explorer 5.0 to view messages through WebAccess, URLs to messages become part of the History cache and can be read by other users who have access to the same workstation. For solutions to this problem, see TID 10056452 in the Novell Knowledgebase.


4.0 International Issues


4.1 Installation on Windows 98

During installation of international versions of the Support Pack, select Copy to the GWtemp Directory in order to avoid the possibility of long file names being truncated.


4.2 Double-Byte Characters in Directory Names and File Names

Do not use double-byte characters in directory names and file names.


4.3 Double-Byte Characters in Passwords

Do not use double-byte character in users' passwords. The Change GroupWise Password dialog box in ConsoleOne currently allows entry of double-byte characters. However, the GroupWise client login does not allow entry of double-byte characters in passwords, so a user who was assigned a password with double-byte characters in ConsoleOne cannot type the double-byte characters when attempting to log in to GroupWise.


4.4 Euro Character in Subject Field

If a WebAccess client user receives a message, task, or appointment with a Euro character in the Subject field, it might display as an upside-down question mark when viewed in the Java Calendar. The issue resides with the user's browser.

Netscape users need to upgrade to Netscape Communicator* 6.

Internet Explorer users need to be using at least version 3309 of the JVM*. The latest JVM can be downloaded from the Microsoft Web site and installed on the user's workstation. This JVM enables Internet Explorer 4.x and above to correctly display the Euro character.


4.5 Print Calendar Language

The GroupWise client Print Calendar feature always prints calendars in the language specified in Regional Options or Regional Settings in the Control Panel, even if the client is installed in a different language. For example, if French (Switzerland) or French (Swiss) is specified in the Control Panel and the client is installed in German, calendars print in French.


4.6 RichWin and GroupWise 6

If you use RichWin in combination with GroupWise 6, be sure to run RichWin first, then run GroupWise 6.


4.7 Windows Messaging System

When installing the GroupWise client to a non-English or non-Japanese Windows NT/2000 operating system, users receive a prompt asking them to replace a Windows Messaging System DLL with the English version of the DLL. Users must click Yes and replace this Windows Messaging System DLL. Otherwise, GroupWise cannot function properly.


4.8 Arabic Spell Checker

If you install the client in Arabic and click Tools > Writing Tools Language, Arabic is not listed. However, you can still successfully spell-check an Arabic message, and after doing so, Arabic appears in the list of writing tools languages.


4.9 German Spell Checker

The German spell checker technology is no longer owned by Novell. The company that purchased it has changed its plans about updating that technology. If you use WordPerfect*, GroupWise can use the updated German spell checker that comes with the latest version of WordPerfect.


5.0 Changes Since the Last Support Pack


5.1 Address Book Fixes


5.2 Administration Fixes


5.3 Admin API Fixes


5.4 Agent Fixes


5.5 Client Fixes


5.6 Client API Fixes


5.7 Engine Fixes


5.8 GWCheck Fixes


5.9 Internet Agent Fixes


5.10 Monitor Fixes


5.11 WebAccess Fixes


6.0 Product Testing

The Support Pack has undergone component testing, core OS testing, and integration testing with other Novell products. The Support Pack was also tested with the following:

For more information about updates for the Novell Client, see TID 10062546 in the Novell Knowledgebase.


7.0 Documentation


7.1 Support Pack Documentation

For installation instructions, see readmeus.txt located at the root of the Support Pack.

For more information on the latest Support Pack issues, see TID 10085454 in the Novell Knowledgebase.


7.2 GroupWise 6 Readme Files

For Readme information about specific GroupWise 6 components, see the following additional Readme files that shipped with GroupWise 6 Support Pack 1, where new features were added. These component Readmes do not contain Support Pack 4 issues.

Agents: \gw6sp4\us\agents\readmeus.txt
Client: \gw6sp4\us\client\win32\readmeus.txt
WebAccess: \gw6sp4\us\internet\webaccess\readmeus.txt
Internet Agent: \gw6sp4\us\internet\gwia\readmeus.txt
Monitor: \gw6sp4\us\admin\monitor\readmeus.txt


7.3 GroupWise 6 Installation Guide

For detailed installation and update instructions, see the GroupWise 6 Installation guide (GroupWiseInstallationGuide.pdf) in the \gw6sp4\us\docs\us directory of the Support Pack.


7.4 GroupWise 6 Administration Guide

For additional GroupWise 6 documentation, see the GroupWise 6 Administration guide at the Novell Documentation Web site.


7.5 GroupWise 6 Help

Starting with GroupWise 6 Support Pack 1, to better support accessibility requirements within GroupWise Help, the Help for the following GroupWise components has been changed from Microsoft Windows Help to Microsoft HTML Help:

In order for Microsoft HTML Help to display on a Windows workstation, the workstation must have Internet Explorer 4.x or higher installed.


8.0 Documentation Conventions

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.


9.0 Legal Notices

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.

U.S. Patent Nos. 4,555,775; 4,580,218; 5,412,772; 5,701,459; 5,717,912; 5,760,772; 5,870,739; 5,873,079; 5,884,304; 5,903,755; 5,913,209; 5,924,096; 5,946,467; 5,963,938; 6,081,804; 6,138,170; 6,167,393; D393,457 and Patents Pending.

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.

BorderManager, GroupWise, NetWare, and Novell are registered trademarks of Novell, Inc. in the United States and other countries.

NLM is a trademark of Novell, Inc.

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