Novell's GroupWise 6 Administrators Guide

Chapter 1: Understanding the Basics of GroupWise Architecture

Understanding a Basic GroupWise 6 System

GroupWise User
GroupWise Post Office
GroupWise Domain
GroupWise System
GroupWise Client
Post Office Agent (POA)
Message Transfer Agent (MTA)
GroupWise Administrator
GroupWise Directory
The GroupWise Message Store
Other GroupWise Objects and Services

GroupWise Evolution
Summary

Chapter 2: Creating a GroupWise System

Installing GroupWise

Allowing for Extending the NDS Schema
Defining the ConsoleOne Path for GroupWise Administration
Creating a Software Distribution Directory

Creating a GroupWise System

Selecting the Software Distribution Directory
Selecting an NDS Tree
Choosing a System Name

Creating the GroupWise Primary Domain

Choosing Your Primary Domain Name
Selecting a Primary Domain Directory
Specifying the Domain Context
Letting GroupWise Know Your Time Zone
Giving the Post Office a Name
Giving the Post Office a Home: The Post Office Directory
Selecting Your Post Office Access Mode
Establishing the Post Office Context
Defining a Post Office Link
Selecting Post Office Users

Summary

Chapter 3: Understanding the GroupWise Directory

Understanding GroupWise Directory Components

How Novell Directory Services Is Used
Grafting GroupWise Objects with NDS
The Role of the GroupWise Domain Database
The Role of the GroupWise Post Office Database

Summary

Chapter 4: Understanding the GroupWise Information Store

Identifying Components of the Post Office Directory Structure

How Input and Output Queues Are Used
The Function of the OFUSER and OFMSG Directories
The Purpose of the OFFILES Directories
Storing Libraries in the GWDMS Directory Structure

Understanding the Core of the Messaging System

What Is Contained in the User Database
Understanding the Contents of a User Database
What Is Contained in the Message Databases
Understanding the User Database/Message Database Relationship
Understanding Binary Large Objects (BLOB Files)
Understanding the Purpose of the Deferred Message Database
Understanding How Prime User Databases Are Made
Using the Mailbox Index to Find Mailbox Items
Keeping Track of Databases with the Guardian Database

Exploring the User and Message Database Relationship
-Understanding the Structure of the GroupWise Document Management System

Shared Document Management Services Database (DMSH)
Library Directories and Naming Conventions

Exploring Document Reference Relationships
Summary

Chapter 5: Working with GroupWise Objects

Calling Up the GroupWise View

Filtering the GroupWise View
Creating GroupWise Objects

Viewing the Domain Object

The Domain Information Property Page
The Post Offices Property Page
The Domain Address Book Property Page
The Domain Addressing Rules and Internet Addressing Property Pages
The Default WebAccess Property Page

Viewing the Post Office Object

The Post Office Identification Property Page
The Post Office Settings Property Page
The Post Office Membership Property Page
The Post Office Resources, Distribution Lists, and Libraries Property Pages
Creating a Post Office Alias
The Internet Addressing Property Page
The Security Property Page
The Default WebAccess Property Page

Configuring Library Objects

The Library Identification Property Page
The Storage Areas Property Page
Configuring the Rights Property Page

GroupWise 6 Agent and Gateway Objects
Administering User Objects

The User Object’s GroupWise Account Property Page
The User Distribution Lists Property Page
The User Nicknames Property Page
The User GroupWise Aliases Property Page
The User GroupWise X.400 Information Property Page
The User GroupWise Internet Addressing Property Page

Understanding Resource Objects

The Resource Distribution Lists Property Page
The Resource Nicknames Property Page

The Distribution List Object

The Distribution List Identification Property Page
The Distribution List Internet Addressing Property Page
The Distribution List Membership Property Page
The Distribution List Nicknames Property Page

Summary

Chapter 6: Using GroupWise System Operations

Changing Connections with Select Domain
System Preferences
NDS User Synchronization
Admin-Defined Fields
Pending Operations
Addressing Rules
Time Zones
External System Synchronization
Software Directory Management

Creating New Software Distribution Directories
Editing or Moving Existing Directories
Deleting Existing Directories
Patching or Updating Existing Directories

Using Restore Area Management
Internet Addressing
Summary

Chapter 7: Using GroupWise Utilities and Diagnostics

The GroupWise Utilities Menu

Mailbox/Library Maintenance
System Maintenance
Backup/Restore Mailbox
Client Options
Expired Records
Email Address Lookup
Synchronize
Link Configuration
Document Properties Maintenance
New System
GW/NDS Association
GroupWise Diagnostics

Summary

Chapter 8: Configuring the Post Office Agent

Loading the Post Office Agent

Loading the POA Using the Startup File
Loading the POA with Command-Line Switches
Learning the Switches
When to Use Switches

Configuring the Post Office Agent

The Identification Property Page
The Agent Settings Property Page
The Log Settings Property Page
The Scheduled Events Property Page

Monitoring and Configuring the POA at the Console Screen

The Configuration Menu
The Options Menu
Undocumented POA Commands and Switches

Understanding the Agent Log

Log Line Format
Common Log Entries and Explanations

Best Practices

Limit the Size of the Post Office
Limit the Size of the Message Store
One Post Office Per Server
Dedicate the Server to GroupWise
Tune the POA for Maximum Performance

Monitoring Your POA through a Web Browser

Simple Configuration
Advanced Configuration

Summary

Chapter 9: Configuring the Message Transfer Agent

Loading the Message Transfer Agent

Loading the MTA with Command-Line Switches
Learning the Switches
Configuring the Message Transfer Agent

Link Configuration and the MTA

Creating an Indirect Connection
Overriding Links with the Link Configuration Tool
Configuring a Transfer Pull Link
Cutting Down on WAN Traffic by Scheduling Links with the Link Configuration Tool

Message Transfer Agent Console Commands

Restarting and Exiting
The Options Menu

Undocumented MTA Commands and Switches
Understanding the MTA Log

The Top of the Log File
The Body of the Log
The Process Column

Configuring the MTA to Support Live Remote
Best Practices

System Design
Moving MTAs to New IP Addresses or Ports
Tuning the MTA

Monitoring Your MTA through a Web Browser

Simple Configuration
Monitoring the MTA with a Web Browser

Summary

Chapter 10: Installing and Configuring the GroupWise Internet Agent

GroupWise Internet Agent Architecture

Translation
Transport
Mailbox Access
Architecture Summary

Installing the GroupWise Internet Agent
Loading the GroupWise Internet Agent

Loading the GWIA
Understanding GWIA Configuration Files

Configuring the GroupWise Internet Agent

Understanding the GroupWise Identification Property Page

Configuring Access Control
Understanding the GroupWise Internet Agent Console
Understanding the GroupWise Internet Agent Log

Log Line Format
Configuration Information in the GWIA Log
Message Processing Log Entries
POP3 Connection Log Entries

Designating a Postmaster for RFC-822 Compliance
Configuring Dial-up Internet Access
Monitoring the GWIA through a Web Browser
Best Practices
Summary

Chapter 11: Configuring GroupWise WebAccess

Understanding WebAccess Architecture

Understanding the WebAccess Agent
Understanding the WebAccess Application

Installing the GroupWise WebAccess Gateway
Loading the GroupWise WebAccess Agent and Application

Loading the GroupWise WebAccess Agent
Loading the GroupWise WebAccess Application

Logging In to the GroupWise WebAccess Client
Configuring the GroupWise WebAccess Gateway

The WebAccess Agent
Configuring the GroupWise Optional Gateway Settings Property Page
Configuring the GroupWise Gateway Administrators Property Page
Configuring the WebAccess Settings Property Page
Configuring the Access Control Settings Property Page
Understanding the Access Control Database Management Properties Page
Configuring the Reattach Settings Property Page
Configuring the Post Office Links Settings Property Page
Configuring the WebPublisher Settings Property Page

Configuring the WebAccess agent Sub-Components

GroupWise WebAccess Object
NovellSpeller Object
GroupWise Provider Object
LDAP Provider Object

Understanding the GroupWise WebAccess Console
Understanding the GroupWise WebAccess Log Files

WebAccess Agent Log Settings
GroupWise WebAccess Object Log settings
WebAccess Speller Application
WebAccess WebPublisher Application

Configuring GroupWise WebAccess for More Scalability and Stability

Configuring Multiple Agents and Application Servers for a Fault-Tolerant WebAccess System
Lookup/Failover List: Scenario 1
Lookup/Failover List – Scenario 2

Running the WebAccess Agent on Windows NT/2000

Installing the WebAccess Agent to Run on Windows NT/2000
Starting the GroupWise WebAccess Agent Service for Windows NT/2000
Starting the GroupWise WebAccess Agent from a Batch File

Configuring an LDAP Address Book for WebAccess
Monitoring GroupWise WebAccess through a Web Browser
Advanced Installation Options for WebAccess

Distributed Installation Concepts
Installing Additional WebAccess Agents

Changing the GroupWise WebAccess Login Experience
Skipping the GroupWise WebAccess Language Page
Best Practices
Summary

Chapter 12: Administering the GroupWise Client

Understanding the GroupWise Windows Client Installation Process
Upgrading the GroupWise Client from GroupWise 5x to GroupWise 6

Understanding the Auto-Update Algorithm
Configuring the SETUP.CFG
Using the SETUP.CFG in an Example Scenario

Upgrading All Users on a Post Office with a Mapped Drive to the Software Distribution Directory
Upgrading the GroupWise Client Using SETUPIP

Configuring the Web Server for SETUPIP
Configuring the Post Office SDD to Support SETUPIP

Upgrading Remote GroupWise Users with the SETUPIP Utility
Auditing the GroupWise Client Upgrade
Understanding the GroupWise Login Process

Is GroupWise in Memory?
Command-Line Options
The Network Provider
Novell Directory Services
The Windows Registry
Domain Name Services
NGWNAMESERVER Redirection
Prompting the User

Administering the Login Process

Configuring NDS
Configuring DNS

Administering GroupWise Client Options
Using Clients for Non-Windows Platforms

GroupWise 6 32-Bit Windows Client
GroupWise 5.2 32-Bit Macintosh Client
GroupWise 5.2 16-Bit Windows Client
GroupWise 6 WebAccess Full-Featured Browser Support
GroupWise 6 WebAccess Simple HTML Browser Support
GroupWise 6 Wireless
GroupWise Internet Agent POP3/IMAP4

Summary

Chapter 13: Moving Users

Understanding the Directory Level Move of a GroupWise User Object

Determining When a Move Is Pending
Understanding the Chronology of the Move-User Process

Moving a GroupWise User
How to Assess the Success of a User Move
When Something Goes Wrong Moving a User

The User Moved, but Only a Part of the User’s Messages Moved
The User Moved, but the User’s Password Was Lost
The User Moved, but None of the User’s Messages Moved

Summary

Chapter 14: Library and Document Administration

Understanding the Role of Document Management
Working with GroupWise Documents

Document References
Query Folder
Shared Folder
The Find Feature
Document Management and Application Integrations
Document Management Security
Understanding QuickFinder Indexing Process And Document Management

Planning Your Document-Management System

Determining the Number of Users Requiring Library Access
Library Location
Disk Space for Document Management
Plan for Additional Hardware
User Training
Selecting a Librarian User

Creating a Library
Using Document Properties Maintenance
Maintaining GroupWise Libraries

Creating Library Maintenance Schedule Events
Performing a Mass Change to the Author Field
Performing a Mass Change on an Author’s Name
Using Archive/Delete Documents

Moving a Document Storage Area

Troubleshooting Document Storage Area Move Problems
Backing Up the GroupWise Document Management System
Exporting Orphaned Document BLOBs

Best Practices
Summary

Chapter 15: Administering Multiple GroupWise Systems

Multiple-System Concepts

The Primary Domain Defines the System
External Domains Are Placeholders
Releasing Domains
Merging Systems
Synchronizing Systems

Releasing a Secondary Domain to Create a New GroupWise System

ACME’S Pre-Domain Release Preparation
WorldWide Widgets — The Release
Final Steps and Cleanup

Synchronizing External Systems

Creating System Definitions for Synchronizing
Creating MTA Connectivity
Testing System Connectivity
Configuring External System Synchronization
Synchronizing Systems

Merging Two External GroupWise Systems

The Merge Scenario
Creating System Definitions for Merged Systems
Creating MTA Connectivity for Merged Systems
Testing Connectivity for Merged Systems
Merging Systems
Synchronizing Objects

Summary

Chapter 16: Internet Addressing

Defining an Internet Address

Understanding Old-Style GroupWise Addressing Format
Pitfalls with Old-Style GroupWise Addressing
Benefits of GroupWise Internet Addressing
Potential Pitfalls When Enabling Internet Addressing

Enabling Internet Addressing

Selecting the Default GWIA
Selecting a Default Internet Domain Name
Choosing an Internet Addressing Format

Enabling MTA-Direct Connectivity (GWMTP)

Allowing MTAs to Send Directly to Other GroupWise Systems
Allowing MTAs to Browse DNS
Allowing MTAs to Connect on High-Numbered Ports
GWMTP.TCP Record Information for the DNS Administrator
Internet Addressing Overrides

Mail Routing with Internet Addressing Enabled

Outbound E-Mail
Inbound E-Mail

Understanding the Parsing and Lookup Process

Parsing User Names
Parsing Scenarios

Best Practices

Naming Conventions
System Design

Summary

Chapter 17: Maintaining the GroupWise System

Information Store Maintenance Concepts

Structural Maintenance
Contents Maintenance
E-Mail Expiration
GWCHECK/GroupWise Message Store Check
Understanding Scheduled Events for Post Office Maintenance
Managing Scheduled Event Creation and Modification

Creating Scheduled Events for Maintenance

Structural Maintenance
Contents Maintenance
Trash Deletion
Message Expiration
Order and Timing of Scheduled Events
Seeing a POA’s Scheduled Events from the Console Screen
Editing Scheduled Events

GroupWise Archive Message Store Maintenance
GroupWise Caching Mode and Remote Mode Maintenance
Maintaining GroupWise Directory Database Maintenance
Summary

Chapter 18: Building Your GroupWise System Correctly

General System Configuration

E-Mail, Calendaring, and Document Management Are Mission Critical
Mesh Message Transfer on the LAN
Match WAN Message Transfer to WAN Topology
Applying System Configuration Principles in the Real World
Planning Your GroupWise System

Post Office Configuration

E-Mail Policies
Post Office Design
Configuring the POA Object for Optimum Performance and Function
Configuring the Post Office Object for Optimum Performance and Function
Configuring the Post Office Client Options for Optimum Performance and Function
Tuning the NetWare Server for Optimum Performance and Function

Summary

Chapter 19: Troubleshooting Message Flow

Understanding Message Flow at the Database Level

GroupWise Information Store Concepts
A Simplified View of Message Flow

Using File Flow for Troubleshooting

Troubleshooting Scenario #1: Can’t Send Internet E-Mail
Lessons from Troubleshooting Scenario #1
Troubleshooting Scenario #2: Can’t Send between Post Offices
Lessons from Troubleshooting Scenario # 2

Troubleshooting Tips and Tricks

X-Locked Files
TCP/IP Troubles

Best Practices
Summary

Chapter 20: Moving Domains and Post Offices

Considerations Related to Moving a Domain

Connectivity to the Primary Domain
Connectivity to Post Offices
Moving a Domain to a New Server
Final Notes on Moving a Domain

Considerations Related to Moving a Post Office

GroupWise Client Connectivity
Domain-to-Post Office Connectivity
GroupWise WebAccess and GWIA Connectivity
Libraries with Additional Document Storage Areas
The Software Distribution Directory

Moving a GroupWise Post Office to a New UNC Path

Moving the Post Office and Creating Domain-to-PO Connectivity
Moving a Post Office to a New Organizational Unit

Moving a Domain to a New Organizational Unit
Summary

Chapter 21: Using GroupWise Monitor

Installing GroupWise Monitor

Installing Windows SNMP Services
Installing GroupWise Monitor Agent

Configuring Your System to Better Support GroupWise Monitor

Enabling HTTP Monitoring
Enabling SNMP Monitoring
Enabling MTA Message Logging

Starting and Using the GroupWise Monitoring Agent

Configuring Visual Notification: GroupWise Monitor Agent Windows Interface
Configuring Visual Notification: GroupWise Monitor Agent HTTP Interface
Configuring Audio Notification
Configuring Remote Notification

Installing the GroupWise Monitor Application

Prerequisites to Installing the GroupWise Monitor Application
Installing the GroupWise Monitor Application

Configuring the GroupWise Monitor Application
Starting the GroupWise Monitor Application
Utilizing the GroupWise Monitor Applicaton
Summary

Chapter 22: Troubleshooting the GroupWise Directory

Using the Correct Tools
Fixing WPHOST.DB Files

System Maintenance: Validate, Recover, and Rebuild
General Notes on Repairing Post Office Databases

Fixing WPDOMAIN.DB Files
Fixing GroupWise Directory Anomalies without Rebuilds

Synchronize the User
Edit the User
Remove GroupWise Attributes
Delete the NDS Portion of a User Object

How GroupWise Directory Changes and Objects Get Replicated

Short Explanation
Long Explanation
Very, Very Long Explanation

Best Practices for Working with the GroupWise Directory
Bulletproofing the GroupWise Directory
Understanding the Administration System

The GroupWise Snap-Ins

Understanding the GroupWise Admin Thread
Summary:

Chapter 23: Troubleshooting GroupWise

Using the Scientific Method

Observation Tools
GroupWise Error Codes
Using the Error Classes

Using Three-Step Mailbox Troubleshooting
Determining Problem Specificity

Determine If the Problem Is Machine-Specific
Troubleshooting Machine-Specific Problems

Troubleshooting User-Specific Problems

Components Specific to Users

Generate a Fresh User Database without Losing Items
Summary:

Chapter 24: Using Wireless and Handheld Devices with GroupWise WebAccess

Understanding Templates

Out of the Box Templates Included in GroupWise 6
Obtaining Updated WebAccess Templates
Managing Templates through the GroupWise WebAccess Object
Defining User Interface and Browser Integration
Understanding How the WebAccess Application Detects What Templates to Use

Accessing Your GroupWise Mailbox from a Windows CE Device
Accessing Your GroupWise Mailbox from a Wireless Phone
Accessing Your GroupWise Mailbox from a Palm OS Device
Information Regarding SSL-ized Connections from Handheld Devices
Summary:

Chapter 25: GroupWise Developer APIs

Prerequisite Knowledge

Delphi and Visual Basic
Microsoft’s Component Object Model (COM) and OLE Automation

Structure of This Chapter
Access GroupWise Data from Custom Windows Applications

Scenario
The GroupWise Object API
The Basic Solution
The List Box Click Event Handler
Locating a Folder in the Mailbox
Searching for Items in a Folder
Filter Expressions
Working with Date and Time Objects
Conclusion

Automate the GroupWise Client

Scenario
The Token Commander
The Basic Solution
Conclusion

Other Methods for Accessing GroupWise Data

POP3 and IMAP4
MAPI

Add Your Own Buttons or Menus to the GroupWise Client

Custom Third-Party Objects (C3POs)
A Tutorial and Sample Projects

Trap and Handle Events in the GroupWise Client

C3POs
Third-Party Token Handler DLL (TPH DLL)

Access GroupWise Data from the Web
Connect GroupWise to Other Messaging Systems
Automatically Create, Modify, and Delete GroupWise Accounts
Connect to the GroupWise Document Management System
The Future of Customizing GroupWise: XML Integration Services
Summary:

Appendix A: Managing Your GroupWise Message Store: Smart Purge, Backup, and Restore

Appendix B: What’s on the CD-ROM?