GroupWise 6 Support Pack 3

March 24, 2003

The information in this Readme file pertains to GroupWise® 6 Support Pack 3.

This Support Pack contains updates for all components contained in the GroupWise product only. If the Support Pack file was downloaded, it must be extracted at the root of the drive because it contains directory paths that could exceed the DOS limits.

The purpose of this Support Pack is to provide a bundle of fixes that have all been tested together. These files have undergone component testing, core OS testing, and integration testing with other Novell® products.

This Support Pack includes all fixes from the previous Support Packs; therefore, you do not need to install Support Pack 2 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 page.

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

To order the Support Pack CD, go to the Consolidated Support Pack ordering 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 Directory Names and File Names
3.1.2 Server Names
3.1.3 Current System Address Book for Caching Mode Users
3.1.4 GroupWise Target Service Agent and the SBackup Console
3.1.5 Restoring Mailbox Items
3.1.6 ConsoleOne on Windows NT
3.1.7 Quotas on NSS Volumes
3.1.8 TurboFat Compatibility
3.2 Agent Issues
3.2.1 Updating to GroupWise 6 Agents
3.2.2 Improving POA Performance on NetWare NSS Volumes
3.2.3 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 Viewer Issue with the Internet Agent and Clustering
3.4.3 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
3.6.7 Running Busy Search on a UNIX Post Office
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 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 Legal Notices


1.0 Support Pack Installation


1.1 Version Information

GroupWise 6 Support Pack 3 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.


1.2 Prerequisites

Before installing GroupWise 6 Support Pack 3:


1.3 Installing the Support Pack

To install GroupWise 6 Support Pack 3:

  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 gw6_iss.txt 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 will run these applications on the same Web server, you must update all three before any of them will work properly.


2.4 Wireless Device Support for WebAccess and Monitor

The GroupWise Monitor software included on the GroupWise 6 SP3 CD supports the following wireless devices:

We are continually evaluating and adding support. As we add support for additional devices, we will 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 3 agents will run, you do not need to apply Windows 2000 Service Pack 2 or above.


2.6 wsock32.dll Dated July/August 1995

wsock32.dll versions 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 Directory Names and File Names

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

File names can consist of up to 8 characters, with extensions of up to 3 characters. Do not use long file names. 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.2 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.3 Current System Address Book for Caching Mode Users

The POA should be configured to generate the system Address Book for Caching mode users daily, as described in Performing Nightly User Upkeep in Post Office Agent in the Administration guide.

If you want to generate the system Address Book for download more often than once a day, you can delete the existing wprof50.db file from the \wpcsout\ofs subdirectory of each post office. A new downloadable system Address Book will be generated automatically for users on each post office.


3.1.4 GroupWise Target Service Agent and the SBackup Console

If you are using the SBackup Console (sbcon.nlm) in conjunction with the GroupWise Target Service Agent (GWTSA), you might encounter the following limitation: If you navigate down through the directory structure and then back up to the root directory, you are unable to navigate down a different directory. You can exit the SBackup Console and restart it to choose a different directory below the root directory.


3.1.5 Restoring Mailbox Items

If you create a backup copy of a post office, you must define the backup copy as a GroupWise restore area, as described in Restoring Mailbox Items in Databases in the Administration guide. If you don't define the backup as a restore area, GroupWise users can still access the restore area (if you let them know the location), but they will receive an error when they try to restore items.


3.1.6 ConsoleOne on Windows NT

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


3.1.7 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 will receive No Disk Space errors.


3.1.8 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 Updating to GroupWise 6 Agents

If you are updating an existing GroupWise 5.x system, and you are running the MTA and a POA on the same machine, you should not choose to launch the agents at the end of the installation process. Start the MTA first, so that it can update the domain to a GroupWise 6 level. When this process is finished, then start the POA to update the post office.


3.2.2 Improving POA Performance on NetWare NSS Volumes

If you run the POA on NetWare 5.x or 6.x NSS volumes, you can significantly improve GroupWise performance by using the following parameters and settings on the NSS command in the autoexec.ncf file:

/NameCacheSize=20000
/OpenFileHashShift=15
/ClosedFileCacheSize=50000
/CacheBalance=60

The best /ClosedFileCacheSize setting for a server depends on many things, such as the amount of memory on the server, the load on the POA, and the number of other programs running on the server. For example, the 50000 setting can work well for a server that has 650 MB of memory. Experiment with various settings in order to optimize performance.

The following TID, although originally written for GroupWise 5.x and NetWare 5.x, applies to GroupWise 6 and NetWare 6.x as well:


3.2.3 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 SP3 Internet Agent will access via IMAP.


3.4.2 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 will not be able to locate the Inso viewer files.


3.4.3 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 will be 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 will 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 will no longer function. Reinstalling them will not resolve the problem. You will 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 will provide 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 will 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 on the GroupWise 6 SP3 CD.

  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 may 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 on the GroupWise 6 SP3 CD.

  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 on the GroupWise 6 SP3 CD

  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.


3.6.7 Running Busy Search on a UNIX Post Office

GroupWise WebAccess will not return valid Busy Search results for users whose mailboxes are on UNIX post offices.


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 would not be able to 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 will 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 will 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 will not function properly.


4.8 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 10070085 in the Novell Knowledgebase.


7.2 GroupWise 6 Readme Files

For Readme information about specific GroupWise 6 components, see the following additional Readme files:

Agents: \gw6sp3\us\agents\readmeus.txt
Client: \gw6sp3\us\client\win32\readmeus.txt
WebAccess: \gw6sp3\us\internet\webaccess\readmeus.txt
Internet Agent: \gw6sp3\us\internet\gwia\readmeus.txt
Monitor: \gw6sp3\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 \gw6sp3\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.

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, ConsoleOne, GroupWise, iChain, NDS, NetWare, Novell, and ZENworks are registered trademarks of Novell, Inc. in the United States and other countries.

eDirectory, NLM, Novell Client, and Novell Cluster Services are trademarks of Novell, Inc.

Novell Technical Services is a service mark of Novell, Inc.

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