GroupWise 6 Support Pack 2
July 25, 2002

Overview

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

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 Pack; therefore, you do not need to install Support Pack 1 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 http://support.novell.com/tools/csp/.

For information on the latest Support Pack issues, see TID 10070085 in the Novell Knowledgebase at http://support.novell.com/search/kb_index.htm.

If you experience problems downloading large files, refer to TID 2947202.

To order the Support Pack CD, go to http://support.novell.com/tools/csp/orderinfo.html.

Table of Contents

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 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.2 Agent Issues
    3.3 Client Issues
    3.4 Internet Agent Issues
    3.5 Monitor Issues
    3.6 WebAccess Issues

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 Information
    8.1 Disclaimer, Patents, Copyright, and Export Notice
    8.2 Trademarks

1.0        Support Pack Installation

1.1         Version Information

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

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

1.2         Prerequisites

Before installing GroupWise 6 Support Pack 2:

1.3         Installing the Support Pack

To install GroupWise 6 Support Pack 2:

  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 > click OK.

    See Section 1.2: Windows Version Requirements for Installation in GW6_ISS.TXT 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 NLM programs are loaded. This will resolve any errors you may see during the update process.

     

2.0        Installation Issues

2.1         NDS Schema Extension during Installation

The installation programs for the following components extend the NDS 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 SP2 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:

http://www.novell.com/wireless

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:

http://windowsupdate.microsoft.com

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 2 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 applies to any non-GroupWise-specific files (such as SSL certificates and key files) that 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 may 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 4

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 NLM programs disable TurboFat at startup.

3.2         Agent Issues

3.2.1    LDAP Server Failover

Starting in GroupWise 6, users can authenticate through LDAP. You can configure one LDAP server on the Security property page of the Post Office object in ConsoleOne. You can configure multiple LDAP servers by using the /ldapipaddr POA startup switch. For setup instructions, see “Configuring Single Server Mode for Multiple LDAP Servers” in “Post Office Agent” in the “Administration” guide.

3.2.2    New LDAP Pooling Feature

In Support Pack 2, you can configure a pool of as many as five LDAP servers to facilitate load balancing and fault tolerance, so the POA cycles to a different LDAP server each time it needs to authenticate a user. For setup instructions, see “Configuring Pooling Mode” in “Post Office Agent” in the “Administration” guide.

3.2.3    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
/FileFlushTimer=75
/BufferFlushTimer=75

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 650MB of memory. Experiment with various settings in order to optimize performance.

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

TID 10021605: Implementing GroupWise 5.x on a
              NetWare 5 NSS Volume
TID
10065215: Resolving GroupWise Performance
              Issues with NSS Volumes

3.2.4    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.5    Unread Message Count Feature Requires at Least the SP1 Version of the Post Office Agent (POA)

Starting with GroupWise 6 SP1, client includes the Unread Message Count feature. Next to each folder, GroupWise 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 may 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 may not run correctly.

To resolve the problem, you must modify the MAGNUS.CONF file located in the SYS:\NOVONYX\SUITESPOT\HTTP-<web_server_name>\CONFIG directory 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 SP2 version of the Post Office Agent (POA) must be running against any post offices that the SP2 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.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 Client. The Novell Client is available for download from the Novell Software Downloads site:

http://www.novell.com/download

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 Services 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 > 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 SP2 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 SP2 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 SP1 CD.

  2. 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) > 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 at:

   http://support.novell.com/search/kb_index.htm

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 GWTEMP 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 may 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 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 at:

   http://support.novell.com/search/kb_index.htm

7.0        Documentation

7.1         Support Pack Documentation

For installation instructions, see GW6SP2.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 at:

   http://support.novell.com/search/kb_index.htm

7.2         GroupWise 6 Readme Files

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

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

   http://www.novell.com/documentation

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        Legal Information

8.1         Disclaimer, Patents, Copyright, and Export Notice

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. 

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 (C) 2002 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.

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.

8.2         Trademarks

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

C3PO, NLM, Novell Client, and QuickFinder are trademarks of Novell, Inc.

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