GroupWise 6 Support Pack 1
November 1, 2001

IMPORTANT: If you are downloading the GroupWise 6 Support Pack 1 for use in France, make sure you download the 56-bit encrypted version (GW6SP1FR.EXE). French regulations require the use of the 56-bit encrypted version, not the 128-bit encrypted version (GW6SP1.EXE).

Table of Contents

1. Installation of GroupWise 6 Support Pack 1
2. Additional Documentation
3. General Issues  
  3.1 Support Pack 1 Includes Padlock Patch  
  3.2 Directory Names and Filenames  
  3.3 Server Names  
  3.4 Current System Address Book for Caching Mode Users  
  3.5 GroupWise Target Service Agent (GWTSA) Issues  
  3.6 Restoring Mailbox Items  
  3.7 ConsoleOne on Windows NT 4  
  3.8 Quotas on NSS Volumes  
  3.9 NetWare 5.1 SP1 Compatibility  
  3.10 TurboFat Compatibility  
  3.11 Help Files  
  3.12 International Issues  
4. Agent Issues  
  4.1 Windows 2000 Service Pack 2 Required  
  4.2 Using SSL  
  4.3 Username and Password Required when Running Agents in Protected Mode in a Server Cluster  
  4.4 Updating to GroupWise 6 Agents  
  4.5 Generating the System Address Book for Caching Mode Users  
  4.6 Unread Message Count Feature Requires the SP1 Version of the Post Office Agent (POA)  
5. Internet Agent Issues  
  5.1 Windows 2000 Service Pack 2 Required  
  5.2 IMAP Access Requires SP1 Version of the Post Office Agent (POA)  
  5.3 Using the STATUS.XML File to Change Status Messages  
6. WebAccess Issues  
  6.1 Using the Latest Novell Client  
  6.2 Installing NetWare 5 Support Pack 3a or NetWare 5.1  
  6.3 Windows 2000 Service Pack 2 Required  
  6.4 Running WebAccess and Monitor on the Same Web Server  
  6.5 Installing to Non-Supported Web Servers  
  6.6 Configuring WebAccess to Use a Java Servlet Engine Other than the Novell Servlet Gateway or Tomcat Servlet Engine  
  6.7 Running Busy Search on a UNIX Post Office  
  6.8 Login Page Reappears after Successful Login  
7. Monitor Issues  
  7.1 Restoring Monitor Settings after Reinstallation  
  7.2 Running Monitor and WebAccess on the Same Web Server  
8. Client Issues  
  8.1 Librarian and Mass Document Operations  
  8.2 Caching Mode Address Book and Rules  
  8.3 Unread Message Count Feature  
  8.4 Print Calendar Language  
9. Changes Since the Last Release (GroupWise 6)  
  9.1 Administration  
  9.2 Agents  
  9.3 GWCheck and GWBackup  
  9.4 Internet Agent  
  9.5 WebAccess  
  9.6 Object API  
  9.7 Client  
10. Legal Information  
  10.1 Disclaimer, Export Notice, Patents, and Copyright  
  10.2 Trademarks  

1. Installation of GroupWise 6 Support Pack 1

If you are installing from a GroupWise 6 Support Pack 1 CD, follow the instructions provided in the GroupWise 6 Installation guide. The Installation guide, named GroupWiseInstallationGuide.PDF, is located in the DOCS/<lang> directory on the CD, where <Lang> represents a language.

If you are installing from GroupWise 6 Support Pack 1 files downloaded from the Novell Web site, follow the installation instructions provided in the support pack's Technical Information Document.

2. Additional Documentation

The GroupWise 6 product documentation includes detailed instructions for installing, administering, and troubleshooting all components of a GroupWise system. The GroupWise documentation is located at the Novell Documentation site.

3. General Issues

3.1 Support Pack 1 Includes Padlock Patch
This SP1 release includes the Padlock patch, a security update made available for GroupWise 6. If you have the Padlock patch, do not apply it to SP1.

For more information about the Padlock patch, see the Novell GroupWise page at:

http://www.novell.com/products/groupwise

3.2 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.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.4 Current System Address Book for Caching Mode Users
When users prime their Caching mailboxes, they receive a copy of the system Address Book. To make sure that Caching mode users always have a current copy to download, make sure the POA is configured to generate the system Address Book regularly, as described in the Agents Readme.

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.5 GroupWise Target Service Agent (GWTSA) Issues
If you are using a backup process other than the GroupWise Target Service Agent (GWTSA) and you enable GroupWise Smart Purge, you must run the GroupWise Time Stamp Utility (GWTMSTMP) after each successful backup for Smart Purge to function properly.

Supported Third-Party Backup Software
At the time of release, the GWTSA supports Veritas Backup Exec for NetWare.

GWTSA Temporary Directory
By default, the GWTSA places temporary files in the \SYSTEM\TEMP directory during the backup process. Use the /tempdir switch to specify an alternate location. For example:

load gwtsa /tempdir-\temp\gwtsa

Limitation of SBackup Console
If you are using the SBackup Console (SBCON.NLM) in conjunction with the 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.6 Restoring Mailbox Items
If you create a backup copy of a post office, you must define the backup copy as a GroupWise restore area before the post office’s users will be able to use the GroupWise client’s Restore feature to restore mailbox items from the backup. 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.

To define a post office backup as a restore area:

  1. In ConsoleOne, click the Tools menu > click GroupWise System Operations > click Restore Area Management to display the Restore Area Directory Management dialog box.

  2. Click Create to display the Edit Backup/Restore Area dialog box.

  3. On the Identification tab, fill in the following fields:

    Name: Enter a name for he restore area.

    UNC Path: Select the path to the backup copy of the post office.

  4. Click the Membership tab.

  5. To assign a post office to use the restore area, click Add > select the post office.

3.7 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.8 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.9 NetWare 5.1 SP1 Compatibility
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.10 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.11 Help Files
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.

3.12 International Issues

3.12.1 Double-Byte Characters in Directory Names and File Names
Do not use double-byte characters in directory names and file names.

3.12.2 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.

3.12.3 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.

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

3.12.5 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.

If you install the GroupWise client to a Japanese Windows XP operating system, Windows XP must be using the English version of Windows Messaging System. To install the English version of Windows Messaging System, run WMS.EXE from the CLIENT\WIN32\WMS\NT\US directory on the GroupWise CD

4. Agent Issues

4.1 Windows 2000 Service Pack 2 Required
If the GroupWise agents are installed on Windows 2000 and the GroupWise domain directory and post office directories accessed by the agents are on a NetWare server (or any non-Windows server), you need to apply the Windows 2000 Service Pack 2 to the operating system.

You can download Windows 2000 Service Pack 2 from:

http://windowsupdate.microsoft.com

Note: If, as required with the initial release of GroupWise 6, you already installed Microsoft HotFix Q266066, you do not need to apply Windows 2000 Service Pack 2.

4.2 Using SSL
GroupWise 6 SP1 supports the use of SSL connections between agents (MTA-to-MTA, MTA-to-POA). If you use SSL between agents, you cannot run the agents in protected mode or on a multiprocessor machine.

4.3 Username and Password Required when Running Agents in Protected Mode in a Server Cluster
GroupWise 6 SP1 supports Novell Cluster Services. If you run the GroupWise Agents in protected mode in a NetWare server clustering system, you need to use the /user-<username> and /password-<password> startup switches to supply a valid network user ID and password.

This requirement applies to versions of NetWare 5.1 prior to NetWare 5.1 Support Pack 4 and versions of NetWare 6 prior to NetWare 6 Support Pack 1. If you are using a more recent version of NetWare 5.1 or NetWare 6, you do not need to use the /user and /password startup switch unless the agent requires access to a GroupWise document storage area located on a remote server.

4.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.

4.5 Generating the System Address Book for Caching Mode Users
When users prime their Caching mailboxes, they receive a copy of the system Address Book. To make sure that Caching mode users always have a current copy to download, make sure the POA is configured to generate the system Address Book regularly. On the POA Agent Settings page in ConsoleOne, make sure that Generate Address Book for Remote is selected. You can choose the time when you want the generation to take place.

4.6 Unread Message Count Feature Requires SP1 Version of the Post Office Agent (POA)
The GroupWise 6 SP1 client includes a new feature, Unread Message Count. 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 GroupWise Post Office Agent must be the GroupWise 6 SP1 version.

5. Internet Agent Issues

5.1 Windows 2000 Service Pack 2 Required
If the Internet Agent is installed on Windows 2000 as a Windows service and the GroupWise domain directory accessed by the Internet Agent is on a NetWare server (or any non-Windows server), you need to apply the Windows 2000 Service Pack 2 to the operating system.

You can download Windows 2000 Service Pack 2 from:

http://windowsupdate.microsoft.com

Note: If, as required with the initial release of GroupWise 6, you already installed Microsoft HotFix Q266066, you do not need to apply Windows 2000 Service Pack 2.

5.2 IMAP Access Requires SP1 Version of the Post Office Agent (POA)
The GroupWise 6 SP1 version of the Post Office Agent (POA) must be running against any post offices that the Internet Agent will access via IMAP.

5.3 Using the STATUS.XML File to Change Status Messages
The Internet Agent returns status messages for all outbound messages. For example, if a GroupWise user sends a message that the Internet Agent cannot deliver, the Internet Agent returns an undeliverable message to the GroupWise user.

By default, the Internet Agent will use internal status messages. However, you can override the internal status messages with status messages you define. To do so:

  1. Open the STATUS.XM_ file, located in the <domain>\WPGATE\<gwia> directory.

  2. Make the modifications you want.

  3. Save the file, renaming it from STATUS.XM_ to STATUS.XML.

  4. Restart the Internet Agent.

The Internet Agent will now use the status messages defined in the STATUS.XML file rather than its internal status messages.

6. WebAccess Issues

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 Download site:

http://download.novell.com

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.

6.3 Windows 2000 Service Pack 2 Required
If the WebAccess Agent is installed on Windows 2000 as a Windows service and the GroupWise domain directory accessed by the WebAccess Agent is on a NetWare server (or any non-Windows server), you need to apply the Windows 2000 Service Pack 2 to the operating system.

You can download Windows 2000 Service Pack 2 from:

http://windowsupdate.microsoft.com

Note: If, as required with the initial release of GroupWise 6, you already installed Microsoft HotFix Q266066, you do not need to apply Windows 2000 Service Pack 2.

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

6.5 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 SP1 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 SP1 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.

6.6 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 Support Pack 1 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.

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.

6.8 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.

7. Monitor Issues

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

7.2 Running Monitor and WebAccess 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. If you will run these applications on the same Web server, you must update all three before any of them will work properly.

8. Client Issues

8.1 Librarian and Mass Document Operations
Librarian and mass document operations are available only in the Online mode of the GroupWise 6 SP1 client.

8.2 Caching Mode Address Book and Rules
All address books and rules will be downloaded on the initial priming of the Caching mailbox. You can configure how often you want to re-download the system Address Book, your personal address books, and rules by clicking Accounts > Account Options > Options > Advanced and specifying the number of days in the Refresh Address Books and Rules Every field.

Address books and rules will also be re-downloaded in Caching mode when you click Tools > Retrieve Entire Mailbox.

8.3 Unread Message Count Feature
The GroupWise 6 SP1 client includes a new feature, Unread Message Count. 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 GroupWise Post Office Agent must be the GroupWise 6 SP1 version.

8.4 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.

9. Changes Since the Last Release (GroupWise 6)

The following sections provide information about changes that have been made in Support Pack 1 to resolve issues in the GroupWise 6 release. These changes do not include information about features that have been added in Support Pack 1. For information about new features, see "What's New in GroupWise 6" in the GroupWise 6 documentation.

9.1 Administration
The following changes were made to resolve GroupWise administration issues:

9.2 Agents
The following changes were made to resolve MTA and POA issues:

9.3 GWCheck and GWBackup
The following changes were made to resolve GWCheck and GWBackup issues:

9.4 Internet Agent
The following changes were made to resolve Internet Agent issues:

9.5 WebAccess
The following changes were made to resolve WebAccess issues:

9.6 Object API
The following changes where made to resolve issues with the Object API:

9.7 Client
The following changes were made to resolve issues with the GroupWise client for Windows:

10. Legal Information

10.1 Disclaimer, Export Notice, Patents, and Copyright
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.

This product may require export authorization from the U.S. Department of Commerce prior to exporting from the US or Canada.

US 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) 2001 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.

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

ConsoleOne, 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.