Novell GROUPWISE 8 - MONITOR Instruction Manual

Novell®
www.novell.com
novdocx (en) 22 June 2009
AUTHORIZED DOCUMENTATION
GroupWise 8 Administration Guide
GroupWise ®
8
August 31, 2009
Administration Guide

novdocx (en) 22 June 2009
Legal Notices
Novell, Inc. makes no representations or warranties with respect to the contents or use of this documentation, and
specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose.
Further, Novell, Inc. reserves the right to revise this publication and to make changes to its content, at any time,
without obligation to notify any person or entity of such revisions or changes.
Further, Novell, Inc. makes no representations or warranties with respect to any software, and specifically disclaims
any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc.
reserves the right to make changes to any and all parts of Novell software, at any time, without any obligation to
notify any person or entity of such changes.
Any products or technical information provided under this Agreement may be subject to U.S. export controls and the
trade laws of other countries. You agree to comply with all export control regulations and to obtain any required
licenses or classification to export, re-export, or import deliverables. You agree not to export or re-export to entities
on the current U.S. export exclusion lists or to any embargoed or terrorist countries as specified in the U.S. export
laws. You agree to not use deliverables for prohibited nuclear, missile, or chemical biological weaponry end uses. See
the Novell International Trade Services Web page (http://www.novell.com/info/exports/) for more information on
exporting Novell software. Novell assumes no responsibility for your failure to obtain any necessary export
approvals.
Copyright © 2003-2009 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.
Novell, Inc. has intellectual property rights relating to technology embodied in the product that is described in this
document. In particular, and without limitation, these intellectual property rights may include one or more of the U.S.
patents listed on the Novell Legal Patents Web page (http://www.novell.com/company/legal/patents/) and one or
more additional patents or pending patent applications in the U.S. and in other countries.
Novell, Inc.
404 Wyman Street, Suite 500
Waltham, MA 02451
U.S.A.
www.novell.com
Online Documentation: To access the online documentation for this and other Novell products, and to get
updates, see the Novell Documentation Web site (http://www.novell.com/documentation).

novdocx (en) 22 June 2009
Novell Trademarks
For Novell trademarks, see the Novell Trademark and Service Mark list (http://www.novell.com/company/legal/
trademarks/tmlist.html).
Third-Party Materials
All third-party trademarks are the property of their respective owners.

4GroupWise 8 Administration Guide
novdocx (en) 22 June 2009

Contents 5
Contents
novdocx (en) 22 June 2009
About This Guide 35
Part I System 37
1 GroupWise System Administration 39
2 ConsoleOne Administration Tool 41
2.1 ConsoleOne on Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
2.1.1 Installing ConsoleOne on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
2.1.2 Configuring Your Windows Machine for ConsoleOne . . . . . . . . . . . . . . . . . . . . . . . . 42
2.1.3 Starting ConsoleOne on Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
2.2 ConsoleOne on Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
2.2.1 Installing ConsoleOne on Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
2.2.2 Starting ConsoleOne on Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
2.3 ConsoleOne in a Multiple-Platform Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
2.3.1 Using Windows ConsoleOne to Access Domains and Post Offices on Linux . . . . . . 43
2.3.2 Using Linux ConsoleOne to Access Domains and Post Offices on NetWare or
Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
3 GroupWise View 47
3.1 eDirectory View vs. GroupWise View. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
3.2 GroupWise Object Icons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
3.3 Customizing the GroupWise View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
3.3.1 Changing the Column Display and Order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
3.3.2 Changing the Column Widths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
3.4 Searching in the GroupWise View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
3.5 Performing Administrative Tasks from the GroupWise View . . . . . . . . . . . . . . . . . . . . . . . . . . 52
4 GroupWise System Operations 55
4.1 Select Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
4.2 System Preferences. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
4.2.1 Admin Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
4.2.2 Routing Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
4.2.3 External Access Rights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
4.2.4 Nickname Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
4.2.5 Default Password. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
4.2.6 Admin Lockout Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
4.2.7 Archive Service Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
4.2.8 Linux Settings (Linux ConsoleOne Only). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
4.3 eDirectory User Synchronization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
4.4 Admin-Defined Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
4.5 Pending Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
4.6 Addressing Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
4.7 Time Zones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
4.7.1 Modifying a Time Zone Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
4.7.2 Adding a Time Zone Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

6GroupWise 8 Administration Guide
novdocx (en) 22 June 2009
4.7.3 Deleting a Time Zone Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
4.8 External System Synchronization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
4.9 Software Directory Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
4.9.1 Creating a Software Distribution Directory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
4.9.2 Updating a Software Distribution Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
4.9.3 Deleting a Software Distribution Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
4.10 Restore Area Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
4.11 Internet Addressing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
4.12 Trusted Applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
4.12.1 Creating a Key for a Trusted Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
4.12.2 Editing a Trusted Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
4.12.3 Deleting a Trusted Application. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
4.13 LDAP Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
4.14 Global Signatures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
5 GroupWise Utilities 79
5.1 Mailbox/Library Maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
5.2 System Maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
5.3 Backup/Restore Mailbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
5.4 Recover Deleted Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
5.5 Client Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
5.6 Expired Records. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
5.7 Email Address Lookup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
5.8 Synchronize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
5.9 User Move Status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
5.10 Link Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
5.11 Document Properties Maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
5.12 Import/Export . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
5.13 New System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
5.14 Check eDirectory Schema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
5.15 Gateway Alias Migration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
5.16 GW / eDirectory Association . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
5.16.1 Graft GroupWise Objects. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
5.16.2 Invalid Associations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
5.16.3 Associate Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
5.16.4 Disassociate GroupWise Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
5.16.5 Convert External Entity to User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
5.16.6 Convert User to External Entity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
5.17 Standalone GroupWise Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
5.17.1 GroupWise Check Utility (GWCheck) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
5.17.2 GroupWise Target Service Agent for File Systems (TSAFSGW) . . . . . . . . . . . . . . . 88
5.17.3 GroupWise Backup Time Stamp Utility (GWTMSTMP) . . . . . . . . . . . . . . . . . . . . . . . 88
5.17.4 GroupWise Database Copy Utility (DBCOPY). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
5.17.5 GroupWise Generate CSR Utility (GWCSRGEN) . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
6 GroupWise Address Book 91
6.1 Customizing Address Book Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
6.1.1 Adding eDirectory Fields to the Address Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
6.1.2 Adding LDAP Fields to the Address Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
6.1.3 Changing the Default Sort Order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
6.1.4 Changing the Default Field Order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
6.1.5 Removing Fields from the Address Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
6.1.6 Preventing the User Description Field from Displaying in the Address Book . . . . . . 96

Contents 7
novdocx (en) 22 June 2009
6.2 Controlling Object Visibility. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
6.3 Updating Address Book Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
6.3.1 Synchronizing Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
6.3.2 Rebuilding the Post Office Database. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
6.4 Controlling Users’ Frequent Contacts Address Books . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
6.5 Controlling Address Book Synchronization for Remote Client Users. . . . . . . . . . . . . . . . . . . . 99
6.6 Publishing E-Mail Addresses to eDirectory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
6.7 Enabling Wildcard Addressing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
6.7.1 Setting Wildcard Addressing Levels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
6.7.2 Wildcard Addressing Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
6.8 Adding External Users to the GroupWise Address Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
6.8.1 Creating a Non-GroupWise Domain to Represent the Internet . . . . . . . . . . . . . . . . 104
6.8.2 Linking to the Non-GroupWise Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
6.8.3 Creating a Non-GroupWise Post Office to Represent an Internet Host. . . . . . . . . . 106
6.8.4 Creating External Users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
6.9 Facilitating Addressing through GroupWise Gateways . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
6.9.1 Creating an Addressing Rule. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
6.9.2 Enabling an Addressing Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
7 Multilingual GroupWise Systems 111
7.1 Client Languages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
7.2 Administration and Agent Languages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
7.3 International Character Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
7.4 MIME Encoding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
7.5 Multi-Language Workstations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Part II Domains 117
8 Creating a New Domain 119
8.1 Understanding the Purpose of Domains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
8.2 Planning a New Domain. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
8.2.1 Determining When to Add a New Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
8.2.2 Deciding Who Will Administer the New Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
8.2.3 Planning Post Offices in the New Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
8.2.4 Determining the Context for the Domain Object . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
8.2.5 Choosing the Domain Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
8.2.6 Deciding Where to Create the Domain Directory. . . . . . . . . . . . . . . . . . . . . . . . . . . 125
8.2.7 Deciding Where to Install the Agent Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
8.2.8 Deciding How to Link the New Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
8.2.9 Selecting the Domain Language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
8.2.10 Selecting the Domain Time Zone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
8.3 Setting Up the New Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
8.3.1 Creating the New Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
8.3.2 Configuring the MTA for the New Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
8.3.3 Installing and Starting the New MTA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
8.4 What’s Next . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
8.5 Domain Worksheet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
9 Managing Domains 135
9.1 Connecting to a Domain. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
9.2 Editing Domain Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
9.3 Converting a Secondary Domain to a Primary Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139

8GroupWise 8 Administration Guide
novdocx (en) 22 June 2009
9.4 Moving a Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
9.5 Deleting a Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
9.6 Changing MTA Configuration to Meet Domain Needs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
10 Managing the Links between Domains and Post Offices 145
10.1 Understanding Link Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
10.1.1 Domain-to-Domain Links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
10.1.2 Domain-to-Post Office Links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
10.1.3 Link Protocols for Direct Links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
10.2 Using the Link Configuration Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
10.2.1 Starting the Link Configuration Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
10.2.2 Editing a Domain Link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
10.2.3 Editing Multiple Domain Links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
10.2.4 Editing a Post Office Link. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
10.2.5 Viewing the Path of an Indirect Link between Domains. . . . . . . . . . . . . . . . . . . . . . 155
10.2.6 Viewing the Indirect Links Passing through a Domain. . . . . . . . . . . . . . . . . . . . . . . 156
10.2.7 Viewing the Gateway Links Passing through a Gateway . . . . . . . . . . . . . . . . . . . . 157
10.2.8 Saving and Synchronizing Link Configuration Information . . . . . . . . . . . . . . . . . . . 158
10.3 Interpreting Link Symbols. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
10.3.1 Link Type Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
10.3.2 Link Status Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
10.4 Modifying Links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
Part III Post Offices 161
11 Creating a New Post Office 163
11.1 Understanding the Purpose of Post Offices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
11.2 Planning a New Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
11.2.1 Determining When to Add a Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
11.2.2 Selecting the Domain That the Post Office Will Belong To . . . . . . . . . . . . . . . . . . . 165
11.2.3 Determining the Context for the Post Office Object. . . . . . . . . . . . . . . . . . . . . . . . . 166
11.2.4 Choosing the Post Office Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
11.2.5 Deciding Where to Create the Post Office Directory . . . . . . . . . . . . . . . . . . . . . . . . 168
11.2.6 Deciding Where to Install the Agent Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
11.2.7 Deciding How to Link the New Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
11.2.8 Selecting the Post Office Language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
11.2.9 Selecting the Post Office Time Zone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
11.2.10 Selecting a Software Distribution Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
11.2.11 Selecting a Post Office Security Level. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
11.2.12 Deciding if You Want to Create a Library for the New Post Office . . . . . . . . . . . . . 174
11.3 Setting Up the New Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
11.3.1 Creating the New Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
11.3.2 Configuring the POA for the New Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
11.3.3 Installing and Starting the New POA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
11.3.4 Setting Up User Access to the New Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
11.4 What’s Next . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
11.5 Post Office Worksheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
12 Managing Post Offices 183
12.1 Connecting to the Domain That Owns a Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
12.2 Editing Post Office Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
12.3 Managing Disk Space Usage in the Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190

Contents 9
novdocx (en) 22 June 2009
12.3.1 Understanding Disk Space Usage and Mailbox Size Limits . . . . . . . . . . . . . . . . . . 190
12.3.2 Preparing to Implement Disk Space Management . . . . . . . . . . . . . . . . . . . . . . . . . 191
12.3.3 Setting Mailbox Size Limits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
12.3.4 Enforcing Mailbox Size Limits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
12.3.5 Restricting the Size of Messages That Users Can Send. . . . . . . . . . . . . . . . . . . . . 195
12.3.6 Preventing the Post Office from Running Out of Disk Space . . . . . . . . . . . . . . . . . 197
12.3.7 An Alternative to Disk Space Management in the Post Office . . . . . . . . . . . . . . . . . 200
12.3.8 Forcing Caching Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
12.4 Auditing Mailbox License Usage in the Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
12.5 Viewing Current Client Usage in the Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
12.6 Tracking and Restricting Client Access to the Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
12.7 Refreshing the Client View Files in the Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
12.8 Disabling a Post Office. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
12.9 Moving a Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
12.10 Deleting a Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
12.11 Changing POA Configuration to Meet Post Office Needs . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
Part IV Users 211
13 Creating GroupWise Accounts 213
13.1 Establishing a Default Password for All New GroupWise Accounts. . . . . . . . . . . . . . . . . . . . 213
13.2 Creating GroupWise Accounts for eDirectory Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
13.2.1 Creating a Single GroupWise Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
13.2.2 Creating Multiple GroupWise Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
13.2.3 Using a Template to Create GroupWise Accounts . . . . . . . . . . . . . . . . . . . . . . . . . 218
13.2.4 Creating GroupWise Accounts by Importing Users . . . . . . . . . . . . . . . . . . . . . . . . . 219
13.3 Creating GroupWise Accounts for Non-eDirectory Users . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
13.4 Educating Your New Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
13.4.1 Windows Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
13.4.2 Linux/Mac Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
13.4.3 WebAccess Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
14 Managing GroupWise Accounts and Users 227
14.1 Adding a User to a Distribution List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
14.2 Allowing Users to Modify Distribution Lists. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
14.3 Adding a Global Signature to Users’ Messages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
14.3.1 Creating Global Signatures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
14.3.2 Selecting a Default Global Signature for All Outgoing Messages . . . . . . . . . . . . . . 230
14.3.3 Assigning Global Signatures to Internet Agents . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
14.3.4 Assigning Global Signatures to Windows Client Users . . . . . . . . . . . . . . . . . . . . . . 231
14.3.5 Excluding Global Signatures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
14.4 Moving GroupWise Accounts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
14.4.1 Live Move vs. File Transfer Move . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
14.4.2 Moves Between GroupWise 6.xor Later Post Offices. . . . . . . . . . . . . . . . . . . . . . . 233
14.4.3 Moves Between GroupWise 6.xor Later and GroupWise 5.xPost Offices . . . . . . . 233
14.4.4 Preparing for a User Move. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
14.4.5 Moving a GroupWise Account to Another Post Office in the Same eDirectory Tree 235
14.4.6 Moving a GroupWise Account to Another Post Office in a Different eDirectory
Tree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
14.4.7 Monitoring User Move Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
14.5 Renaming Users and Their GroupWise Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
14.6 Managing Mailbox Passwords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
14.6.1 Creating or Changing a Mailbox Password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242

10 GroupWise 8 Administration Guide
novdocx (en) 22 June 2009
14.6.2 Removing a Mailbox Password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
14.6.3 Bypassing the GroupWise Password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
14.7 Managing E-Mail Addresses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
14.7.1 Ensuring Unique E-Mail Addresses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
14.7.2 Changing a User’s Internet Addressing Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
14.7.3 Changing a User’s Visibility in the Address Book . . . . . . . . . . . . . . . . . . . . . . . . . . 249
14.7.4 Creating a Nickname for a User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
14.8 Checking GroupWise Account Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
14.9 Disabling and Enabling GroupWise Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
14.10 Removing GroupWise Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
14.10.1 Deleting a GroupWise Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
14.10.2 Expiring a GroupWise Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
14.10.3 Managing Expired or Expiring GroupWise Accounts . . . . . . . . . . . . . . . . . . . . . . . . 256
Part V Resources 259
15 Creating Resources 261
15.1 Understanding Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
15.1.1 Resource Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
15.1.2 Resource Types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
15.1.3 Resource Mailboxes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
15.1.4 Resource Owners . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
15.2 Planning Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
15.3 Creating a New Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
16 Managing Resources 265
16.1 Changing a Resource’s Owner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
16.2 Adding a Resource to a Distribution List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
16.3 Moving a Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
16.4 Renaming a Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
16.5 Deleting a Resource. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
16.6 Managing E-Mail Addresses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
16.6.1 Changing a Resource’s Internet Addressing Settings . . . . . . . . . . . . . . . . . . . . . . . 269
16.6.2 Changing a Resource’s Visibility in the Address Book . . . . . . . . . . . . . . . . . . . . . . 270
16.6.3 Creating a Nickname for a Resource. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
Part VI Distribution Lists, Groups, and Organizational Roles 275
17 Understanding Distribution Lists, Groups, and Organizational Roles 277
17.1 Public vs. Personal Address Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
17.2 Distribution Lists. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
17.3 eDirectory Groups and Organizational Roles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
18 Creating and Managing Distribution Lists 279
18.1 Creating a New Distribution List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
18.2 Adding Members to a Distribution List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282
18.3 Removing Members from a Distribution List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
18.4 Moving a Distribution List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
18.5 Renaming a Distribution List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284

Contents 11
novdocx (en) 22 June 2009
18.6 Enabling Users to Modify a Distribution List. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284
18.7 Deleting a Distribution List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
18.8 Managing E-Mail Addresses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
18.8.1 Changing a Distribution List’s Internet Addressing Settings . . . . . . . . . . . . . . . . . . 286
18.8.2 Changing a Distribution List’s Visibility in the Address Book . . . . . . . . . . . . . . . . . . 288
18.8.3 Creating a Nickname for a Distribution List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289
18.9 Adding External Users to a Distribution List. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290
18.9.1 Creating an External Domain. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291
18.9.2 Creating an External Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291
18.9.3 Creating an External User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291
19 Using eDirectory Groups as GroupWise Distribution Lists 293
19.1 Setting Up an eDirectory Group for Use in GroupWise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
19.2 Seeing Which Members of an eDirectory Group Have GroupWise Accounts . . . . . . . . . . . . 294
19.3 Changing a Group’s Visibility in the Address Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
19.4 Moving a Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
19.5 Renaming a Group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
19.6 Removing a Group from GroupWise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
20 Using eDirectory Organizational Roles as GroupWise Distribution Lists 299
20.1 Setting Up an Organizational Role for Use in GroupWise . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
20.2 Seeing Which Members of an Organizational Role Have GroupWise Accounts . . . . . . . . . . 300
20.3 Changing an Organizational Role’s Visibility in the Address Book. . . . . . . . . . . . . . . . . . . . . 301
20.4 Moving an Organizational Role . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
20.5 Renaming an Organizational Role . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
20.6 Removing an Organizational Role from GroupWise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
Part VII Libraries and Documents 305
21 Document Management Services Overview 307
21.1 Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
21.2 Document Storage Areas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309
21.3 Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309
21.3.1 Document Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309
21.3.2 Document Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310
21.4 Integrations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
22 Creating and Managing Libraries 313
22.1 Planning a Basic Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313
22.1.1 Selecting the Post Office That the Library Will Belong To . . . . . . . . . . . . . . . . . . . . 314
22.1.2 Determining the Context for the Library Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314
22.1.3 Choosing the Library Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314
22.1.4 Deciding Where to Store Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315
22.2 Setting Up a Basic Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316
22.2.1 Creating the Basic Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316
22.3 Planning Full-Service Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
22.3.1 Deciding Which Libraries to Create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
22.3.2 Selecting the Post Offices To Own Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322
22.3.3 Determining the Contexts for Library Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322
22.3.4 Choosing Library Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322

12 GroupWise 8 Administration Guide
novdocx (en) 22 June 2009
22.3.5 Deciding Where to Store Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323
22.3.6 Setting Document Version Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325
22.3.7 Figuring Maximum Archive Directory Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326
22.3.8 Designating Initial Librarians . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327
22.3.9 Restricting Initial Public Library Rights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327
22.3.10 Determining Your Indexing Needs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328
22.3.11 Determining If You Need to Set Up Integrations for DMS Users . . . . . . . . . . . . . . . 328
22.4 Setting Up a Full-Service Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
22.4.1 Creating the Full-Service Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
22.4.2 What’s Next . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
22.5 Viewing a New Library in Your GroupWise System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
22.5.1 Seeing the New Library in ConsoleOne. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
22.5.2 Seeing the New Library in the GroupWise Windows Client. . . . . . . . . . . . . . . . . . . 333
22.6 Managing Libraries. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333
22.6.1 Editing Library Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
22.6.2 Managing Document Storage Areas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
22.6.3 Managing Library Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339
22.6.4 Adding and Training Librarians . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341
22.6.5 Maintaining Library Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345
22.6.6 Moving a Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345
22.6.7 Deleting a Library. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346
22.7 Library Worksheets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346
22.7.1 Basic Library Worksheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346
22.7.2 Full-Service Library Worksheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
23 Creating and Managing Documents 351
23.1 Adding Documents to Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
23.1.1 Creating New Documents in the GroupWise Windows Client . . . . . . . . . . . . . . . . . 351
23.1.2 Importing Existing Documents into the GroupWise DMS System . . . . . . . . . . . . . . 352
23.1.3 Managing Groups of Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353
23.2 Organizing Documents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354
23.2.1 Customizing Document Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354
23.2.2 Defining Related Document Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363
23.3 Indexing Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
23.3.1 Understanding DMS Indexing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
23.3.2 Determining Your Indexing Needs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374
23.3.3 Implementing Indexing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376
23.4 Managing Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376
23.4.1 Archiving and Deleting Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376
23.4.2 Backing Up and Restoring Archived Documents. . . . . . . . . . . . . . . . . . . . . . . . . . . 376
23.4.3 Handling Orphaned Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378
24 Integrations 379
24.1 Setting Up Integrations during Windows Client Installation . . . . . . . . . . . . . . . . . . . . . . . . . . 379
24.2 Setting Up Integrations Using the gwappint.inf File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380
24.2.1 Understanding the Three Levels of Integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381
24.2.2 Understanding the gwappint.inf File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382
24.2.3 Editing the gwappint.inf File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385
24.3 Controlling Integrations in the GroupWise Windows Client . . . . . . . . . . . . . . . . . . . . . . . . . . 385

Contents 13
novdocx (en) 22 June 2009
Part VIII Databases 387
25 Understanding GroupWise Databases 389
25.1 Domain Databases. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389
25.2 Post Office Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389
25.3 User Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390
25.4 Message Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390
25.5 Library Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390
25.6 Guardian Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391
26 Maintaining Domain and Post Office Databases 393
26.1 Validating Domain or Post Office Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393
26.2 Recovering Domain or Post Office Databases. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394
26.3 Rebuilding Domain or Post Office Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397
26.4 Rebuilding Database Indexes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399
27 Maintaining User/Resource and Message Databases 401
27.1 Analyzing and Fixing User and Message Databases. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401
27.2 Performing a Structural Rebuild of a User Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403
27.3 Re-creating a User Database. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404
28 Maintaining Library Databases and Documents 407
28.1 Analyzing and Fixing Databases for Libraries and Documents . . . . . . . . . . . . . . . . . . . . . . . 407
28.2 Analyzing and Fixing Library and Document Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . 408
29 Synchronizing Database Information 411
29.1 Synchronizing Individual Users or Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411
29.2 Synchronizing a Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412
29.3 Synchronizing a Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413
29.4 Synchronizing a Secondary Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413
29.5 Synchronizing the Primary Domain from a Secondary Domain . . . . . . . . . . . . . . . . . . . . . . . 414
30 Managing Database Disk Space 415
30.1 Gathering Mailbox Statistics. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415
30.2 Reducing the Size of User and Message Databases. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417
30.3 Reclaiming Disk Space in Domain and Post Office Databases . . . . . . . . . . . . . . . . . . . . . . . 419
30.4 Reducing the Size of Libraries and Document Storage Areas . . . . . . . . . . . . . . . . . . . . . . . . 420
30.4.1 Archiving and Deleting Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420
30.4.2 Deleting Activity Logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421
31 Backing Up GroupWise Databases 423
31.1 Backing Up a Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423
31.2 Backing Up a Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423
31.3 Backing Up a Library and Its Documents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424
31.4 Backing Up Individual Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425

14 GroupWise 8 Administration Guide
novdocx (en) 22 June 2009
32 Restoring GroupWise Databases from Backup 427
32.1 Restoring a Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427
32.2 Restoring a Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427
32.3 Restoring a Library. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428
32.4 Restoring an Individual Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428
32.5 Restoring Deleted Mailbox Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429
32.5.1 Setting Up a Restore Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429
32.5.2 Restoring a User’s Mailbox Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431
32.5.3 Letting Client Users Restore Their Own Mailbox Items . . . . . . . . . . . . . . . . . . . . . . 431
32.6 Recovering Deleted GroupWise Accounts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432
33 Retaining User Messages 435
33.1 How Message Retention Works. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435
33.1.1 What GroupWise Does . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435
33.1.2 What the Message Retention Application Does . . . . . . . . . . . . . . . . . . . . . . . . . . . 436
33.2 Acquiring a Message Retention Application. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437
33.3 Enabling Message Retention . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437
34 Standalone Database Maintenance Programs 439
34.1 GroupWise Check . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439
34.1.1 GWCheck Functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439
34.1.2 Using GWCheck on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441
34.1.3 Using GWCheck on Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442
34.1.4 Using GWCheck on Macintosh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444
34.1.5 Performing Mailbox/Library Maintenance Using GWCheck. . . . . . . . . . . . . . . . . . . 445
34.1.6 Executing GWCheck from a Windows Batch File . . . . . . . . . . . . . . . . . . . . . . . . . . 447
34.1.7 Executing GWCheck from a Linux Script. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448
34.1.8 GWCheck Startup Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448
34.2 GroupWise Target Service Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451
34.2.1 System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451
34.2.2 TSAFS Functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451
34.2.3 TSAFSGW Functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452
34.2.4 NetWare: Running TSAFS and TSAFSGW. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453
34.2.5 Linux: Running TSAFS and TSAFSGW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456
34.2.6 TSAFSGW Startup Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459
34.3 GroupWise Time Stamp Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461
34.3.1 GWTMSTMP Functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461
34.3.2 Running GWTMSTMP on NetWare. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462
34.3.3 Running GWTMSTMP on Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463
34.3.4 Running GWTMSTMP on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463
34.3.5 GWTMSTMP Startup Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464
34.4 GroupWise Database Copy Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468
34.4.1 Using DBCopy on NetWare . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468
34.4.2 Using DBCopy on Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469
34.4.3 Using DBCopy on Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470
34.4.4 DBCopy Startup Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470
Part IX Post Office Agent 473
35 Understanding Message Delivery and Storage in the Post Office 475
35.1 Post Office Representation in ConsoleOne . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475
35.2 Post Office Directory Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476

Contents 15
novdocx (en) 22 June 2009
35.3 Information Stored in the Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476
35.3.1 Post Office Database. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476
35.3.2 Message Store. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476
35.3.3 Guardian Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478
35.3.4 Agent Input/Output Queues in the Post Office. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478
35.3.5 Libraries (optional) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 479
35.4 Post Office Access Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 480
35.5 Role of the Post Office Agent. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481
35.5.1 Client/Server Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481
35.5.2 Message File Processing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482
35.5.3 Other POA Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482
35.6 Message Flow in the Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483
35.7 Cross-Platform Issues in the Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483
35.7.1 Client/Post Office Platform Independence through Browser Technology . . . . . . . . 484
35.7.2 Client/Post Office Platform Independence through Client/Server Mode . . . . . . . . . 484
35.7.3 POA/Post Office Platform Dependencies Because of Direct Access Requirements 484
36 Configuring the POA 487
36.1 Performing Basic POA Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 487
36.1.1 Creating a POA Object in eDirectory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 488
36.1.2 Configuring the POA in ConsoleOne . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 489
36.1.3 Changing the Link Protocol between the Post Office and the Domain . . . . . . . . . . 493
36.1.4 Binding the POA to a Specific IP Address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495
36.1.5 Moving the POA to a Different Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496
36.1.6 Adjusting the POA for a New Post Office Location . . . . . . . . . . . . . . . . . . . . . . . . . 496
36.1.7 Adjusting the POA Logging Level and Other Log Settings . . . . . . . . . . . . . . . . . . . 497
36.2 Configuring User Access to the Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 498
36.2.1 Using Client/Server Access to the Post Office. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 498
36.2.2 Simplifying Client/Server Access with a GroupWise Name Server . . . . . . . . . . . . . 501
36.2.3 Supporting IMAP Clients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502
36.2.4 Supporting SOAP Clients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 504
36.2.5 Checking What GroupWise Clients Are in Use . . . . . . . . . . . . . . . . . . . . . . . . . . . . 505
36.2.6 Supporting Forced Mailbox Caching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506
36.2.7 Restricting Message Size between Post Offices . . . . . . . . . . . . . . . . . . . . . . . . . . . 507
36.2.8 Supporting Calendar Publishing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 508
36.3 Configuring Post Office Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 508
36.3.1 Securing Client/Server Access through an External Proxy Server . . . . . . . . . . . . . 509
36.3.2 Controlling Client Redirection Inside and Outside Your Firewall . . . . . . . . . . . . . . . 510
36.3.3 Securing the Post Office with SSL Connections to the POA . . . . . . . . . . . . . . . . . . 511
36.3.4 Providing LDAP Authentication for GroupWise Users . . . . . . . . . . . . . . . . . . . . . . . 514
36.3.5 Enabling Intruder Detection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 519
36.3.6 Configuring Trusted Application Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520
36.4 Configuring Post Office Maintenance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520
36.4.1 Scheduling Database Maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520
36.4.2 Scheduling Disk Space Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523
36.4.3 Performing Nightly User Upkeep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526
37 Monitoring the POA 529
37.1 Using the POA Server Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 529
37.1.1 Monitoring the POA from the POA Server Console. . . . . . . . . . . . . . . . . . . . . . . . . 529
37.1.2 Controlling the POA from the POA Server Console . . . . . . . . . . . . . . . . . . . . . . . . 533
37.2 Using the POA Web Console. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544
37.2.1 Setting Up the POA Web Console. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544
37.2.2 Accessing the POA Web Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 546
37.2.3 Monitoring the POA from the POA Web Console . . . . . . . . . . . . . . . . . . . . . . . . . . 546

16 GroupWise 8 Administration Guide
novdocx (en) 22 June 2009
37.2.4 Controlling the POA from the POA Web Console . . . . . . . . . . . . . . . . . . . . . . . . . . 551
37.3 Using POA Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 553
37.3.1 Configuring POA Log Settings and Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 553
37.3.2 Viewing POA Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 554
37.3.3 Interpreting POA Log File Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 554
37.4 Using GroupWise Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 554
37.5 Using Novell Remote Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555
37.6 Using an SNMP Management Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555
37.6.1 Setting Up SNMP Services for the POA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555
37.6.2 Copying and Compiling the POA MIB File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 558
37.6.3 Configuring the POA for SNMP Monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 559
37.7 Notifying the GroupWise Administrator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 559
37.8 Using the POA Error Message Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 560
37.9 Employing POA Troubleshooting Techniques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 560
37.10 Using Platform-Specific POA Monitoring Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 560
38 Optimizing the POA 561
38.1 Optimizing Client/Server Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 561
38.1.1 Adjusting the Number of POA Threads for Client/Server Processing . . . . . . . . . . . 561
38.1.2 Adjusting the Number of Connections for Client/Server Processing . . . . . . . . . . . . 563
38.1.3 Configuring a Dedicated Client/Server POA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 564
38.2 Optimizing Message File Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 566
38.2.1 Adjusting the Number of POA Threads for Message File Processing . . . . . . . . . . . 566
38.2.2 Configuring a Dedicated Message File Processing POA . . . . . . . . . . . . . . . . . . . . 567
38.3 Optimizing Indexing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 568
38.3.1 Regulating Indexing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 569
38.3.2 Configuring the Document Conversion Agent for Indexing Specific Document
Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 570
38.3.3 Configuring a Dedicated Indexing POA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 571
38.3.4 Customizing Indexing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 573
38.4 Optimizing Database Maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 575
38.4.1 Adjusting the Number of POA Threads for Database Maintenance . . . . . . . . . . . . 575
38.4.2 Configuring a Dedicated Database Maintenance POA . . . . . . . . . . . . . . . . . . . . . . 576
38.5 Optimizing CPU Utilization for the NetWare POA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 577
38.6 Optimizing Client Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 578
39 Using POA Startup Switches 581
39.1 @filename . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585
39.2 /attemptsresetinterval. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585
39.3 /certfile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585
39.4 /cluster . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 586
39.5 /cpu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 586
39.6 /dn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 586
39.7 /enforceclientversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 586
39.8 /evocontrol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 587
39.9 /externalclientssl. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 587
39.10 /gwchkthreads . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 588
39.11 /gwclientreleasedate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 588
39.12 /gwclientreleaseversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 588
39.13 /help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 588
39.14 /home . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 589
39.15 /httppassword. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 589

Contents 17
novdocx (en) 22 June 2009
39.16 /httpport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 589
39.17 /httprefresh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 590
39.18 /httpssl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 590
39.19 /httpuser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 590
39.20 /imap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 590
39.21 /imapmaxthreads . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 591
39.22 /imapreadlimit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 591
39.23 /imapport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 591
39.24 /imapssl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 592
39.25 /imapsslport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 592
39.26 /incorrectloginattempts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 592
39.27 /internalclientssl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 592
39.28 /intruderlockout. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 593
39.29 /ip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 593
39.30 /keyfile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 593
39.31 /keypassword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 594
39.32 /language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 594
39.33 /ldapdisablepwdchg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 594
39.34 /ldapipaddr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 595
39.35 /ldapippooln. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 595
39.36 /ldappoolresettime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 595
39.37 /ldapport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 596
39.38 /ldapportpooln. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 596
39.39 /ldappwd. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 596
39.40 /ldapssl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 596
39.41 /ldapsslpooln. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597
39.42 /ldapsslkey . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597
39.43 /ldapsslkeypooln. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597
39.44 /ldaptimeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598
39.45 /ldapuser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598
39.46 /ldapuserauthmethod . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598
39.47 /lockoutresetinterval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599
39.48 /log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599
39.49 /logdays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 600
39.50 /logdiskoff . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 600
39.51 /loglevel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 600
39.52 /logmax. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 601
39.53 /maxappconns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 601
39.54 /maxphysconns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 601
39.55 /mtpinipaddr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 601
39.56 /mtpinport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 602
39.57 /mtpoutipaddr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 602
39.58 /mtpoutport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 602
39.59 /mtpsendmax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 603
39.60 /mtpssl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 603
39.61 /name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 603
39.62 /noada . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 603
39.63 /nocache. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 604
39.64 /noconfig. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 604
39.65 /nodca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 604
39.66 /noerrormail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 604
39.67 /nogwchk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 605

18 GroupWise 8 Administration Guide
novdocx (en) 22 June 2009
39.68 /noldapx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 605
39.69 /nomf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 605
39.70 /nomfhigh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 605
39.71 /nomflow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 606
39.72 /nomtp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 606
39.73 /nonuu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 606
39.74 /noqf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 606
39.75 /nordab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607
39.76 /norecover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607
39.77 /nosnmp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607
39.78 /notcpip. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607
39.79 /nuuoffset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 608
39.80 /password. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 608
39.81 /port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 608
39.82 /primingmax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 609
39.83 /qfbaseoffset. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 609
39.84 /qfbaseoffsetinminute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 609
39.85 /qfdeleteold. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 609
39.86 /qfinterval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 610
39.87 /qfintervalinminute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 610
39.88 /qflevel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 610
39.89 /qfnolibs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 611
39.90 /qfnopreproc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 611
39.91 /qfnousers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 611
39.92 /qfuserfidbeg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 612
39.93 /qfuserfidend . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 612
39.94 /rdaboffset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 612
39.95 /rights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613
39.96 --show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613
39.97 /sleep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613
39.98 /soap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613
39.99 /soapmaxthreads . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 614
39.100/soapport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 614
39.101/soapsizelimit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 614
39.102/soapssl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 615
39.103/soapthreads . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 615
39.104/tcpthreads . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 615
39.105/threads . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 615
39.106/user . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 616
Part X Message Transfer Agent 617
40 Understanding Message Transfer between Domains and Post Offices 619
40.1 Domain Representation in ConsoleOne. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 619
40.2 Domain Directory Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 620
40.3 Information Stored in the Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 620
40.3.1 Domain Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 620
40.3.2 Agent Input/Output Queues in the Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 621
40.3.3 Gateways. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 621
40.4 Role of the Message Transfer Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 622
40.5 Link Configuration between Domains and Post Offices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 622

Contents 19
novdocx (en) 22 June 2009
40.6 Message Flow between Domains and Post Offices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 622
40.6.1 Message Flow between Post Offices in the Same Domain . . . . . . . . . . . . . . . . . . . 623
40.6.2 Message Flow between Different Domains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 623
40.7 Cross-Platform Issues between Domains and Post Offices. . . . . . . . . . . . . . . . . . . . . . . . . . 623
40.7.1 MTA Platform Dependencies Because of Direct Access Requirements to Post
Offices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 624
40.7.2 MTA/Post Office Platform Independence through TCP/IP Links . . . . . . . . . . . . . . . 624
40.7.3 MTA Platform Dependencies Because of Direct Access Requirements to the
Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 624
40.7.4 MTA/Domain Platform Independence through TCP/IP Links . . . . . . . . . . . . . . . . . 625
40.7.5 MTA/Domain Platform Independence through the Transfer Pull Configuration. . . . 625
41 Configuring the MTA 627
41.1 Performing Basic MTA Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 627
41.1.1 Creating an MTA Object in eDirectory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 628
41.1.2 Configuring the MTA in ConsoleOne . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 629
41.1.3 Changing the Link Protocol between Domains . . . . . . . . . . . . . . . . . . . . . . . . . . . . 632
41.1.4 Changing the Link Protocol between a Domain and Its Post Offices . . . . . . . . . . . 636
41.1.5 Binding the MTA to a Specific IP Address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 639
41.1.6 Moving the MTA to a Different Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 640
41.1.7 Adjusting the MTA for a New Location of a Domain or Post Office . . . . . . . . . . . . . 640
41.1.8 Adjusting the MTA Logging Level and Other Log Settings . . . . . . . . . . . . . . . . . . . 641
41.2 Configuring User Access through the Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 642
41.2.1 Restricting Message Size between Domains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 642
41.2.2 Enabling Live Remote . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 643
41.2.3 Securing the Domain with SSL Connections to the MTA . . . . . . . . . . . . . . . . . . . . 643
41.3 Configuring Specialized Routing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 645
41.3.1 Using Routing Domains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 646
41.3.2 Scheduling Direct Domain Links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 648
41.3.3 Using a Transfer Pull Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 651
41.4 Configuring Domain Maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 652
41.4.1 Using eDirectory User Synchronization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 653
41.4.2 Enabling MTA Message Logging. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 658
42 Monitoring the MTA 661
42.1 Using the MTA Server Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 661
42.1.1 Monitoring the MTA from the MTA Server Console. . . . . . . . . . . . . . . . . . . . . . . . . 661
42.1.2 Controlling the MTA from the MTA Server Console . . . . . . . . . . . . . . . . . . . . . . . . 664
42.2 Using the MTA Web Console. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 673
42.2.1 Setting Up the MTA Web Console. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 673
42.2.2 Accessing the MTA Web Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 675
42.2.3 Monitoring the MTA from the MTA Web Console . . . . . . . . . . . . . . . . . . . . . . . . . . 675
42.2.4 Controlling the MTA from the MTA Web Console . . . . . . . . . . . . . . . . . . . . . . . . . . 679
42.3 Using MTA Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 681
42.3.1 Configuring MTA Log Settings and Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 681
42.3.2 Viewing MTA Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 682
42.3.3 Interpreting MTA Log File Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 682
42.4 Using GroupWise Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 682
42.5 Using Novell Remote Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 683
42.6 Using an SNMP Management Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 683
42.6.1 Setting Up SNMP Services for the MTA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 683
42.6.2 Copying and Compiling the MTA MIB File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 686
42.6.3 Configuring the MTA for SNMP Monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 687
42.7 Notifying the Domain Administrator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 687

20 GroupWise 8 Administration Guide
novdocx (en) 22 June 2009
42.8 Using the MTA Error Message Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 688
42.9 Employing MTA Troubleshooting Techniques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 688
42.10 Using Platform-Specific MTA Monitoring Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 688
42.11 Using MTA Message Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 688
43 Optimizing the MTA 689
43.1 Optimizing TCP/IP Links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 689
43.1.1 Adjusting the Number of MTA TCP/IP Connections . . . . . . . . . . . . . . . . . . . . . . . . 689
43.1.2 Adjusting the MTA Wait Intervals for Slow TCP/IP Connections . . . . . . . . . . . . . . . 689
43.2 Optimizing Mapped/UNC Links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 690
43.2.1 Using TCP/IP Links between Locations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 690
43.2.2 Adjusting MTA Polling of Input Queues in the Domain, Post Offices, and
Gateways. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 690
43.2.3 Adjusting the Number of MTA Scanner Threads for the Domain and Post Offices . 692
43.3 Optimizing the Routing Queue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 694
43.3.1 Adjusting the Maximum Number of Active Router Threads . . . . . . . . . . . . . . . . . . . 694
43.3.2 Adjusting the Maximum Number of Idle Router Threads. . . . . . . . . . . . . . . . . . . . . 694
43.4 Adjusting MTA Polling of Closed Locations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 694
44 Using MTA Startup Switches 697
44.1 @filename . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 699
44.2 /activelog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 699
44.3 /certfile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 699
44.4 /cluster . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 700
44.5 /cyhi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 700
44.6 /cylo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 700
44.7 /defaultroutingdomain. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 700
44.8 /dn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 701
44.9 /fast0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 701
44.10 /fast4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 701
44.11 /help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 701
44.12 /home . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 702
44.13 /httppassword. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 702
44.14 /httpport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 702
44.15 /httprefresh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 703
44.16 /httpssl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 703
44.17 /httpuser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 703
44.18 /ip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 703
44.19 /keyfile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 704
44.20 /keypassword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 704
44.21 /language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 704
44.22 /liveremote . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 705
44.23 /log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 705
44.24 /logdays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 706
44.25 /logdiskoff . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 706
44.26 /loglevel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 706
44.27 /logmax. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 707
44.28 /lrconn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 707
44.29 /lrwaitdata. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 707
44.30 /maxidlerouters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 707
44.31 /maxrouters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 708