Novell GROUPWISE 8 Administration Guide

Administration Guide

Novell®

novdocx (en) 22 June 2009

AUTHORIZED DOCUMENTATION

GroupWise

8

August 31, 2009

®

www.novell.com

GroupWise 8 Administration Guide

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.

novdocx (en) 22 June 2009

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

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.

novdocx (en) 22 June 2009

novdocx (en) 22 June 2009

4 GroupWise 8 Administration Guide

Contents

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

novdocx (en) 22 June 2009

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

Contents 5

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

novdocx (en) 22 June 2009

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

6 GroupWise 8 Administration Guide

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

novdocx (en) 22 June 2009

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

Contents 7

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

novdocx (en) 22 June 2009

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

8 GroupWise 8 Administration Guide

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

novdocx (en) 22 June 2009

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.x or Later Post Offices. . . . . . . . . . . . . . . . . . . . . . . 233

14.4.3 Moves Between GroupWise 6.x or Later and GroupWise 5.x Post 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 Dif feren t 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

Contents 9

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

novdocx (en) 22 June 2009

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

10 GroupWise 8 Administration Guide

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

novdocx (en) 22 June 2009

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

Contents 11

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

novdocx (en) 22 June 2009

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

12 GroupWise 8 Administration Guide

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

novdocx (en) 22 June 2009

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

Contents 13

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

novdocx (en) 22 June 2009

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

14 GroupWise 8 Administration Guide

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

novdocx (en) 22 June 2009

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

Contents 15

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

novdocx (en) 22 June 2009

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

16 GroupWise 8 Administration Guide

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

/noconfig. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 604

39.64

39.65 /nodca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 604

39.66 /noerrormail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 604

39.67 /nogwchk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 605

. . . . . . . . 604

novdocx (en) 22 June 2009

Contents 17

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

novdocx (en) 22 June 2009

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

18 GroupWise 8 Administration Guide

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

novdocx (en) 22 June 2009

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

Contents 19

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

novdocx (en) 22 June 2009

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

20 GroupWise 8 Administration Guide

44.32 /messagelogdays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 708

44.33 /messagelogmaxsize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 708

44.34 /messagelogpath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 709

44.35 /messagelogsettings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 709

44.36 /msgtranssl. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 709

44.37 /noada . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 709

44.38 /nodns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 710

44.39 /noerrormail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 710

44.40 /nondssync . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 710

44.41 /norecover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 710

44.42 /nosnmp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 710

44.43 /password. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 711

44.44 --show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 711

44.45 /tcpinbound. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 711

44.46 /tcpport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 711

44.47 /tcpwaitconnect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 712

44.48 /tcpwaitdata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 712

44.49 /tracelogin. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 712

44.50 /user . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 713

44.51 /vsnoadm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 713

44.52 /work. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 713

novdocx (en) 22 June 2009

Part XI Internet Agent 715

45 Configuring Internet Addressing 717

45.1 Planning Internet Addressing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 717

45.1.1 Internet Agent Requirement. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 718

45.1.2 Internet Agents Used for Outbound Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . 718

45.1.3 Internet Domain Names. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 718

45.1.4 Preferred Address Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 718

45.1.5 Allowed Address Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 721

45.1.6 Override Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 722

45.2 Setting Up Internet Addressing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 722

45.2.1 Installing the Internet Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 722

45.2.2 Enabling Internet Addressing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 722

45.2.3 Overriding Internet Addressing Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 725

45.3 Transitioning from SMTP Gateway Aliases to Internet Addressing . . . . . . . . . . . . . . . . . . . . 727

45.3.1 Planning to Migrate Gateway Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 728

45.3.2 Preparing to Migrate Gateway Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 728

45.3.3 Performing the Gateway Alias Migration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 728

45.3.4 Verifying the Gateway Alias Migration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 730

46 Configuring Internet Services 731

46.1 Configuring SMTP/MIME Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 731

46.1.1 Configuring Basic SMTP/MIME Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 731

46.1.2 Using Extended SMTP (ESMTP) Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 734

46.1.3 Configuring How the Internet Agent Handles E-Mail Addresses . . . . . . . . . . . . . . . 735

46.1.4 Determining Format Options for Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 738

46.1.5 Configuring the SMTP Timeout Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 739

46.1.6 Determining What to Do with Undeliverable Messages. . . . . . . . . . . . . . . . . . . . . . 740

46.1.7 Configuring SMTP Dial-Up Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 742

46.1.8 Enabling SMTP Relaying. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 745

Contents 21

46.1.9 Using a Route Configuration File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 747

46.1.10 Customizing Delivery Status Notifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 747

46.1.11 Managing MIME Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 748

46.2 Configuring POP3/IMAP4 Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 752

46.2.1 Enabling POP3/IMAP4 Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 752

46.2.2 Configuring Post Office Links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 754

46.2.3 Giving POP3 or IMAP4 Access Rights to Users . . . . . . . . . . . . . . . . . . . . . . . . . . . 755

46.2.4 Setting Up an E-Mail Client for POP3/IMAP4 Services . . . . . . . . . . . . . . . . . . . . . . 755

46.3 Configuring LDAP Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 757

46.3.1 Enabling LDAP Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 757

46.3.2 Configuring Public Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 758

46.4 Configuring Paging Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 759

46.4.1 Setting Up Paging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 760

46.4.2 Using Paging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 761

47 Managing Internet Access 763

47.1 Controlling User Access to the Internet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 763

47.1.1 Classes of Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 763

47.1.2 Creating a Class of Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 764

47.1.3 Testing Access Control Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 770

47.1.4 Maintaining the Access Control Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 771

47.2 Blocking Unwanted E-Mail from the Internet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 773

47.2.1 Real-Time Blacklists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 773

47.2.2 Access Control Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 775

47.2.3 Blocked.txt File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 775

47.2.4 Mailbomb (Spam) Protection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 776

47.2.5 Customized Spam Identification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 777

47.2.6 SMTP Host Authentication. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 779

47.2.7 Unidentified Host Rejection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 779

47.3 Tracking Internet Traffic with Accounting Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 780

47.3.1 Selecting an Accountant . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 780

47.3.2 Enabling Accounting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 781

47.3.3 Understanding the Accounting File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 782

novdocx (en) 22 June 2009

48 Configuring the Internet Agent 785

48.1 Changing the Link Protocol between the Internet Agent and the Message Transfer Agent. . 785

48.2 Configuring an Alternate Internet Agent for a Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 786

48.3 Binding the Internet Agent to a Specific IP Address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 787

48.4 Securing Internet Agent Connections with SSL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 788

48.4.1 Defining the Certificate File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 788

48.4.2 Defining Which Connections Use SSL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 789

49 Monitoring the Internet Agent 793

49.1 Using the Internet Agent Server Console. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 793

49.1.1 Description. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 794

49.1.2 Status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 794

49.1.3 Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 795

49.1.4 Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 802

49.1.5 Menu Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 803

49.2 Using the Internet Agent Web Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 805

49.2.1 Setting Up the Internet Agent Web Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 805

49.2.2 Monitoring the Internet Agent at the Web Console . . . . . . . . . . . . . . . . . . . . . . . . . 806

49.3 Using Novell Remote Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 807

22 GroupWise 8 Administration Guide

49.4 Using an SNMP Management Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 807

49.5 Assigning Operators to Receive Warning and Error Messages. . . . . . . . . . . . . . . . . . . . . . . 808

49.6 Using Internet Agent Log Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 809

49.6.1 Modifying Log Settings in ConsoleOne . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 810

49.6.2 Modifying Log Settings through Startup Switches . . . . . . . . . . . . . . . . . . . . . . . . . . 811

49.6.3 Modifying Log Settings through the Internet Agent Server Console . . . . . . . . . . . . 812

49.6.4 Viewing Log Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 813

49.7 Using Internet Agent Error Message Documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 814

49.8 Employing Internet Agent Troubleshooting Techniques . . . . . . . . . . . . . . . . . . . . . . . . . . . . 814

49.9 Stopping the Internet Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 814

49.9.1 Using the Internet Agent Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 814

49.9.2 Using a Command at the Command Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 814

49.9.3 Using a Mail Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 815

49.9.4 Using a Shutdown File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 815

50 Optimizing the Internet Agent 817

50.1 Relocating the Internet Agent’s Processing Directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 817

50.2 Increasing Internet Agent Speed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 819

50.2.1 Sending and Receiving Threads . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 819

50.2.2 Changing the Maximum Packet Received Buffers . . . . . . . . . . . . . . . . . . . . . . . . . 819

50.2.3 Increasing Polling Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 819

50.2.4 Decreasing the Timeout Cycles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 820

50.3 Automating Reattachment to NetWare Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 820

novdocx (en) 22 June 2009

51 Connecting GroupWise Systems and Domains Using the Internet Agent 823

51.1 Connecting GroupWise Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 823

51.1.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 823

51.1.2 Creating an External Domain. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 824

51.1.3 Linking to the External Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 825

51.1.4 Checking the Link Status of the External Domain . . . . . . . . . . . . . . . . . . . . . . . . . . 827

51.1.5 Sending Messages Between Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 828

51.1.6 Exchanging Information Between Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 828

51.2 Linking Domains. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 828

52 Using Internet Agent Startup Switches 831

52.1 How to Use Startup Switches. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 831

52.1.1 Changing Internet Agent Settings in ConsoleOne . . . . . . . . . . . . . . . . . . . . . . . . . . 832

52.1.2 Modifying the gwia.cfg File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 832

52.1.3 Editing Guidelines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 832

52.2 Alphabetical List of Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 833

52.3 Required Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 839

52.3.1 /dhome. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 840

52.3.2 /hn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 840

52.3.3 /home. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 840

52.3.4 /user (NetWare Only). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 841

52.3.5 /password (NetWare Only) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 841

52.4 Console Switches. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 841

52.4.1 /color . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 841

52.4.2 /help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 841

52.4.3 /mono. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 841

52.4.4 --show (Linux Only) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 841

52.5 Environment Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 842

52.5.1 /cluster . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 842

Contents 23

52.5.2 /ip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 842

52.5.3 /ipa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 842

52.5.4 /ipp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 843

52.5.5 /nosnmp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 843

52.5.6 /smtphome . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 843

52.5.7 /work . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 843

52.5.8 /nasoq . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 844

52.6 SMTP/MIME Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 844

52.6.1 SMTP Enabled. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 844

52.6.2 iCal Enabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 845

52.6.3 Address Handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 845

52.6.4 Message Formatting and Encoding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 850

52.6.5 Forwarded and Deferred Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 853

52.6.6 Extended SMTP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 854

52.6.7 Send/Receive Cycle and Threads . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 855

52.6.8 Dial-Up Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 856

52.6.9 Timeouts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 857

52.6.10 Relay Host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 858

52.6.11 Host Authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 859

52.6.12 Undeliverable Message Handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 859

52.6.13 Mailbomb and Spam Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 860

52.7 POP3 Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 862

52.7.1 /nopopversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 862

52.7.2 /pop3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 862

52.7.3 /popintruderdetect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 862

52.7.4 /popport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 862

52.7.5 /popsport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 863

52.7.6 /popssl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 863

52.7.7 /pt. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 863

52.7.8 /sslpt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 863

52.8 IMAP4 Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 864

52.8.1 /imap4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 864

52.8.2 /imapport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 864

52.8.3 /imapreadlimit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 864

52.8.4 /imapsport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 864

52.8.5 /imapssl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 865

52.8.6 /it . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 865

52.8.7 /noimapversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 865

52.8.8 /sslit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 865

52.9 HTTP (Web Console) Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 866

52.9.1 /httpport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 866

52.9.2 /httpuser. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 866

52.9.3 /httppassword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 866

52.9.4 /httprefresh. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 866

52.9.5 /httpssl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 867

52.10 SSL Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 867

52.10.1 /certfile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 867

52.10.2 /keyfile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 867

52.10.3 /keypasswd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 867

52.10.4 /smtpssl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 868

52.10.5 /httpssl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 868

52.10.6 /popssl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 868

52.10.7 /imapssl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 868

52.10.8 /ldapssl. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 869

52.11 LDAP Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

52.11.1 GroupWise Authentication Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 869

52.11.2 LDAP Query Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 870

52.12 Log File Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 872

. . . . 869

novdocx (en) 22 June 2009

24 GroupWise 8 Administration Guide

52.12.1 /log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 872

52.12.2 /logdays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 872

52.12.3 /loglevel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 872

52.12.4 /logmax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 873

Part XII WebAccess 875

53 Scaling Your WebAccess Installation 877

53.1 WebAccess Configurations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 877

53.1.1 Multiple WebAccess Agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 877

53.1.2 Multiple WebAccess and WebPublisher Applications . . . . . . . . . . . . . . . . . . . . . . . 878

53.2 Installing Additional WebAccess Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 880

53.2.1 Installing Additional Components on NetWare or Windows . . . . . . . . . . . . . . . . . . 880

53.2.2 Installing Additional Components on Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 881

53.3 Configuring Redirection and Failover Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 882

53.3.1 How the WebAccess Application Knows Which WebAccess Agents to Use. . . . . . 883

53.3.2 Synchronizing the Encryption Key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 885

53.3.3 Specifying a WebAccess Agent in the WebAccess URL . . . . . . . . . . . . . . . . . . . . . 886

53.3.4 Assigning a Default WebAccess Agent to a Post Office . . . . . . . . . . . . . . . . . . . . . 887

53.3.5 Assigning a Default WebAccess Agent to a Domain . . . . . . . . . . . . . . . . . . . . . . . . 888

53.3.6 Adding WebAccess Agents to the GroupWise Service Provider’s List . . . . . . . . . . 889

novdocx (en) 22 June 2009

54 Configuring WebAccess Components 891

54.1 Configuring the WebAccess Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 892

54.1.1 Modifying WebAccess Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 892

54.1.2 Modifying WebPublisher Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 893

54.1.3 Managing Access to Post Offices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 895

54.1.4 Securing WebAccess Agent Connections with SSL . . . . . . . . . . . . . . . . . . . . . . . . 897

54.1.5 Changing the WebAccess Agent’s Network Address or Port Numbers. . . . . . . . . . 899

54.1.6 Binding the WebAccess Agent to a Specific IP Address . . . . . . . . . . . . . . . . . . . . . 900

54.2 Configuring the WebAccess Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 900

54.2.1 Modifying the WebAccess Application Environment Settings . . . . . . . . . . . . . . . . . 901

54.2.2 Adding or Removing Service Providers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 903

54.2.3 Modifying WebAccess Application Template Settings . . . . . . . . . . . . . . . . . . . . . . . 904

54.2.4 Securing WebAccess Application Sessions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 909

54.2.5 Controlling Availability of WebAccess Features . . . . . . . . . . . . . . . . . . . . . . . . . . . 911

54.3 Configuring the WebPublisher Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 914

54.3.1 Modifying the WebPublisher Application Environment Settings . . . . . . . . . . . . . . . 914

54.3.2 Adding or Removing Service Providers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 916

54.3.3 Modifying WebPublisher Application Template Settings . . . . . . . . . . . . . . . . . . . . . 917

54.3.4 Controlling Availability of WebPublisher Features . . . . . . . . . . . . . . . . . . . . . . . . . . 921

54.4 Configuring the GroupWise Service Provider. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 923

54.5 Configuring the LDAP Service Provider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 925

54.6 Configuring the GroupWise Document Service Provider . . . . . . . . . . . . . . . . . . . . . . . . . . . . 927

54.7 Configuring the Document Viewer Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 929

54.7.1 Viewer Agent Web Console. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 930

54.7.2 Document Conversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 930

54.7.3 Document Quarantine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 931

54.7.4 Document Cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 931

54.7.5 Agent Performance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 932

54.7.6 Agent Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 932

54.7.7 Client/Server Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 932

54.8 Enabling Web Server Data Compression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 933

54.8.1 Apache 2 on NetWare 6.5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 933

Contents 25

54.8.2 Apache 2 on Open Enterprise Server (OES) Linux . . . . . . . . . . . . . . . . . . . . . . . . . 933

54.8.3 Apache 2 on SUSE Linux Enterprise Server 9 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 934

54.8.4 Microsoft Internet Information Server (IIS) on Windows Server 2003/2008. . . . . . . 934

55 Managing User Access 935

55.1 Controlling User Access to Mailboxes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 935

55.1.1 Class Membership . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 935

55.1.2 Creating a Class of Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 936

55.1.3 Adding Users to a Class of Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 937

55.1.4 Maintaining the Access Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 938

55.2 Setting the Timeout Interval for Inactive Sessions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 940

55.3 Configuring User Access to WebAccess Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 941

55.4 Customizing the WebAccess Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 943

56 Monitoring WebAccess Operations 945

56.1 Monitoring the WebAccess Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 945

56.1.1 Using the WebAccess Agent Server Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 945

56.1.2 Using the WebAccess Agent Web Console. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 949

56.1.3 Using Novell Remote Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 952

56.1.4 Using an SNMP Management Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 952

56.1.5 Assigning Operators to Receive Warning and Error Messages. . . . . . . . . . . . . . . . 952

56.1.6 Using WebAccess Agent Error Message Documentation . . . . . . . . . . . . . . . . . . . . 954

56.1.7 Employing WebAccess Agent Troubleshooting Techniques . . . . . . . . . . . . . . . . . . 954

56.2 Monitoring the WebAccess Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 954

56.2.1 Enabling the WebAccess Application Web Console . . . . . . . . . . . . . . . . . . . . . . . . 954

56.2.2 Using the WebAccess Application Web Console . . . . . . . . . . . . . . . . . . . . . . . . . . 955

56.3 Monitoring the Document Viewer Agent. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 955

56.3.1 Using the Document Viewer Agent Server Console . . . . . . . . . . . . . . . . . . . . . . . . 955

56.3.2 Using the Document Viewer Agent Web Console . . . . . . . . . . . . . . . . . . . . . . . . . . 956

56.4 Using WebAccess Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 957

56.4.1 Controlling WebAccess Agent Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 958

56.4.2 Controlling WebAccess Application Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 961

56.4.3 Controlling Document Viewer Agent Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 963

56.4.4 Viewing WebAccess Log Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 964

56.4.5 Interpreting WebAccess Log File Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 964

novdocx (en) 22 June 2009

57 Using WebAccess Startup Switches 965

57.1 WebAccess Agent Startup Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 965

57.1.1 @filename . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 966

57.1.2 /cluster . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 967

57.1.3 /help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 967

57.1.4 /home (Required). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 967

57.1.5 /http . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 968

57.1.6 /httppassword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 968

57.1.7 /httpport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 968

57.1.8 /httpuser. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 969

57.1.9 /ip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 969

57.1.10 /log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 969

57.1.11 /logdays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 970

57.1.12 /logdiskon. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 970

57.1.13 /loglevel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 970

57.1.14 /logmax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 971

57.1.15 /maxusers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 971

57.1.16 /password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 971

26 GroupWise 8 Administration Guide

57.1.17 /port-number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 971

57.1.18 --show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 972

57.1.19 /threads-number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 972

57.1.20 /user. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 972

57.1.21 /work . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 972

57.2 Document Viewer Agent Startup Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 973

57.2.1 /addrspacename . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 974

57.2.2 /cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 974

57.2.3 /domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 975

57.2.4 /email . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 975

57.2.5 /hold . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 975

57.2.6 /http . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 975

57.2.7 /httpport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 976

57.2.8 /httppw . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 976

57.2.9 /httpuser. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 976

57.2.10 /ip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 977

57.2.11 /lang . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 977

57.2.12 /log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 977

57.2.13 /logdays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 978

57.2.14 /loglevel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 978

57.2.15 /logmax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 978

57.2.16 /maxcache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 979

57.2.17 /maxhold . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 979

57.2.18 /maxprobtime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 979

57.2.19 /maxsize. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 979

57.2.20 /maxtime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 980

57.2.21 /maxtrancache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 980

57.2.22 /maxtrantime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 980

57.2.23 /maxworkers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 980

57.2.24 /minworkers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 981

57.2.25 /port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 981

57.2.26 /relay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 981

57.2.27 /temp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 982

novdocx (en) 22 June 2009

Part XIII Calendar Publishing Host 983

58 Configuring the Calendar Publishing Host 985

58.1 Logging In to the Administration Web Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 985

58.2 Changing Post Office Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 985

58.3 Adjusting Log Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 986

58.4 Configuring LDAP Authentication. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 988

58.5 Customizing the Calendar Publishing Host Logo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 989

58.6 Logging Out of the Administration Web Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 990

58.6.1 Restarting Tomcat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 990

58.7 Changing the SSL Trusted Root Certificate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 990

59 Monitoring Calendar Publishing 993

59.1 Viewing Calendar Publishing Status at the POA Web Console . . . . . . . . . . . . . . . . . . . . . . . 993

59.2 Using Calendar Publishing Host Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 994

59.3 Using POA Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 994

Contents 27

60 Creating a Corporate Calendar Browse List 995

61 Managing Your Calendar Publishing Host 997

61.1 Adding Multiple Calendar Publishing Hosts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 997

61.2 Assigning a Different Calendar Publishing Host to Users . . . . . . . . . . . . . . . . . . . . . . . . . . . 997

61.3 Editing Calendar Publishing Host Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 998

61.4 Deleting a Calendar Publishing Host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 999

Part XIV Monitor 1001

62 Understanding the Monitor Agent Consoles 1003

62.1 Monitor Agent Server Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1003

62.2 Monitor Agent Web Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1003

62.3 Monitor Web Console. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1004

63 Configuring the Monitor Agent 1007

novdocx (en) 22 June 2009

63.1 Selecting Agents to Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1008

63.1.1 Filtering the Agent List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1009

63.1.2 Adding All Agents on a Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1009

63.1.3 Adding All Agents on a Subnet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1010

63.1.4 Adding an Individual Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1010

63.1.5 Removing Added Agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1011

63.2 Creating and Managing Agent Groups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1011

63.2.1 Creating an Agent Group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1012

63.2.2 Managing Agent Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1013

63.2.3 Viewing Your Agent Group Hierarchy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1013

63.2.4 Configuring an Agent Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1013

63.3 Configuring Monitoring Protocols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1014

63.3.1 Configuring the Monitor Agent for HTTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1014

63.3.2 Configuring the Monitor Agent for SNMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1016

63.4 Configuring Polling of Monitored Agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1017

63.5 Configuring E-Mail Notification for Agent Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1018

63.5.1 Configuring E-Mail Notification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1018

63.5.2 Customizing Notification Thresholds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1019

63.6 Configuring Audible Notification for Agent Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1021

63.7 Configuring SNMP Trap Notification for Agent Problems. . . . . . . . . . . . . . . . . . . . . . . . . . . 1022

63.8 Configuring Authentication and Intruder Lockout for the Monitor Web Console . . . . . . . . . 1023

63.9 Configuring Monitor Agent Log Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1024

63.10 Configuring Proxy Service Support for the Monitor Web Console . . . . . . . . . . . . . . . . . . . . 1026

63.11 Monitoring Messenger Agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1026

63.12 Supporting the GroupWise High Availability Service on Linux . . . . . . . . . . . . . . . . . . . . . . . 1028

64 Configuring the Monitor Application 1029

64.1 Modifying Monitor Application Environment Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1029

64.2 Modifying Monitor Application Log Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1030

64.3 Adding or Removing Service Providers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1032

64.4 Modifying Monitor Application Template Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1033

28 GroupWise 8 Administration Guide

65 Using GroupWise Monitor 1037

65.1 Using the Monitor Agent Server Console. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1037

65.1.1 Viewing All Agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1038

65.1.2 Viewing Problem Agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1038

65.1.3 Viewing an Agent Server Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1039

65.1.4 Viewing an Agent Web Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1040

65.1.5 Polling the Agents for Updated Status Information . . . . . . . . . . . . . . . . . . . . . . . . 1040

65.2 Using the Monitor Web Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1041

65.3 Generating Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1042

65.3.1 Link Trace Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1042

65.3.2 Link Configuration Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1043

65.3.3 Image Map Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1044

65.3.4 Environment Report. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1049

65.3.5 User Traffic Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1049

65.3.6 Link Traffic Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1050

65.3.7 Message Tracking Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1050

65.3.8 Performance Tracking Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1051

65.3.9 Connected User Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1051

65.3.10 Gateway Accounting Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1051

65.3.11 Trends Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1051

65.3.12 Down Time Report. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1052

65.4 Measuring Agent Performance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1052

65.4.1 Setting Up an External Monitor Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1052

65.4.2 Selecting an MTA to Communicate with the Monitor Agent . . . . . . . . . . . . . . . . . 1053

65.4.3 Configuring the Monitor Agent for Agent Performance Testing . . . . . . . . . . . . . . . 1054

65.4.4 Viewing Agent Performance Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1055

65.4.5 Viewing an Agent Performance Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1055

65.4.6 Receiving Notification of Agent Performance Problems . . . . . . . . . . . . . . . . . . . . 1055

65.5 Collecting Gateway Accounting Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1055

65.5.1 Setting Up an External Monitor Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1056

65.5.2 Selecting an MTA to Communicate with the Monitor Agent . . . . . . . . . . . . . . . . . 1056

65.5.3 Setting Up an External Post Office and External User for Monitor . . . . . . . . . . . . 1057

65.5.4 Receiving the Accounting Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1058

65.5.5 Viewing the Gateway Accounting Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1058

65.6 Assigning Responsibility for Specific Agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1059

65.7 Searching for Agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1059

novdocx (en) 22 June 2009

66 Comparing the Monitor Consoles 1061

67 Using Monitor Agent Startup Switches 1063

67.1 /hapassword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1064

67.2 /hapoll. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1064

67.3 /hauser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1065

67.4 /help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1065

67.5 /home . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1065

67.6 /httpagentpassword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1066

67.7 /httpagentuser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1066

67.8 /httpcertfile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1066

67.9 /httpmonpassword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1067

67.10 /httpmonuser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1067

67.11 /httpport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1067

67.12 /httpssl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1068

67.13 /ipa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1068

Contents 29

67.14 /ipp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1068

67.15 /lang . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1069

67.16 /log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1069

67.17 /monwork . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1069

67.18 /nmaddress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1070

67.19 /nmhome . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1070

67.20 /nmpassword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1070

67.21 /nmuser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1071

67.22 /nosnmp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1071

67.23 /pollthreads. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1071

67.24 /proxy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1071

67.25 /tcpwaitconnect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1072

Part XV Client 1073

68 Setting Up GroupWise Modes and Accounts 1075

68.1 GroupWise Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1075

68.1.1 Online Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1075

68.1.2 Caching Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1075

68.1.3 Remote Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1077

68.2 Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1082

68.2.1 Accounts Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1082

68.2.2 Enabling POP3, IMAP4, and NNTP Account Access in Online Mode . . . . . . . . . . 1082

novdocx (en) 22 June 2009

69 Setting Defaults for the GroupWise Client Options 1085

69.1 Client Options Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1085

69.2 Setting Client Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1090

69.2.1 Modifying Environment Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1091

69.2.2 Modifying Send Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1107

69.2.3 Modifying Documents Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1119

69.2.4 Modifying Security Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1119

69.2.5 Modifying Date and Time Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1122

69.3 Resetting Client Options to Default Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1126

70 Distributing the GroupWise Client 1127

70.1 Using GroupWise AutoUpdate and SetupIP to Distribute the GroupWise Windows Client . 1127

70.1.1 Understanding the Setup Configuration File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1128

70.1.2 Adding LDAP Directory Service Accounts to the Setup Configuration File . . . . . . 1132

70.1.3 Preparing Your Software Distribution Directory to Support AutoUpdate . . . . . . . . 1133

70.1.4 Preparing for Client Software Installation from a Mapped Drive . . . . . . . . . . . . . . 1134

70.1.5 Preparing for Client Software Installation from a Web Server . . . . . . . . . . . . . . . . 1134

70.1.6 Customizing the Setup Configuration File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1137

70.1.7 Enabling AutoUpdate in ConsoleOne . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1138

70.1.8 Error Log File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1139

70.1.9 Disabling Your AutoUpdate Customizations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1139

70.2 Using ZENworks Desktop Management to Distribute the GroupWise Windows Client . . . . 1139

70.3 Using ZENworks Linux Management to Distribute the GroupWise Linux Client . . . . . . . . . 1139

71 Supporting the GroupWise Client in Multiple Languages 1141

71.1 Providing the GroupWise Client Software in Multiple Languages . . . . . . . . . . . . . . . . . . . . 1141

30 GroupWise 8 Administration Guide