Novell GROUPWISE 7 ADMINISTRATION GUIDE

GroupWise 7 Administration Guide

Novell
GroupWise®

novdocx (en) 10 March 2008

7

March 14, 2008

www.novell.com

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) 10 March 2008

Copyright © 2003-2008 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) 10 March 2008

novdocx (en) 10 March 2008

Contents

About This Guide 33

Part I System 35

1 GroupWise System Administration 37

2 ConsoleOne Administration Tool 39

2.1 ConsoleOne on Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

2.1.1 Installing ConsoleOne on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

2.1.2 Starting ConsoleOne on Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

2.2 ConsoleOne on Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

2.2.1 Installing ConsoleOne on Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

2.2.2 Starting ConsoleOne on Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

2.3 ConsoleOne in a Multiple-Platform Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

novdocx (en) 10 March 2008

3 GroupWise View 43

3.1 eDirectory View vs. GroupWise View. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

3.2 GroupWise Object Icons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

3.3 Customizing the GroupWise View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

3.3.1 Changing the Column Display and Order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

3.3.2 Changing the Column Widths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

3.4 Searching in the GroupWise View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

3.5 Performing Administrative Tasks from the GroupWise View . . . . . . . . . . . . . . . . . . . . . . . . . . 48

4 GroupWise System Operations 51

4.1 Select Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

4.2 System Preferences. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

4.2.1 Admin Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

4.2.2 Routing Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

4.2.3 External Access Rights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

4.2.4 Nickname Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

4.2.5 Default Password. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

4.2.6 Admin Lockout Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

4.2.7 Linux Settings (Linux ConsoleOne Only). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

4.3 eDirectory User Synchronization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

4.4 Admin-Defined Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

4.5 Pending Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

4.6 Addressing Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

4.7 Time Zones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

4.7.1 Modifying a Time Zone Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

4.7.2 Adding a Time Zone Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

4.7.3 Deleting a Time Zone Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

4.8 External System Synchronization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

4.9 Software Directory Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

4.9.1 Creating a Software Distribution Directory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

4.9.2 Updating a Software Distribution Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

Contents 5

4.9.3 Deleting a Software Distribution Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

4.10 Restore Area Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

4.11 Internet Addressing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

4.12 Trusted Applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

4.12.1 Creating a Key for a Trusted Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

4.12.2 Configuring a Trusted Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

4.12.3 Deleting a Trusted Application. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

4.13 LDAP Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

4.14 Global Signatures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

5 GroupWise Utilities 73

5.1 Mailbox/Library Maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

5.2 System Maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

5.3 Backup/Restore Mailbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

5.4 Recover Deleted Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

5.5 Client Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

5.6 Expired Records. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

5.7 Email Address Lookup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

5.8 Synchronize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

5.9 User Move Status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

5.10 Link Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

5.11 Document Properties Maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

5.12 Import/Export . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

5.13 New System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

5.14 Check eDirectory Schema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

5.15 Gateway Alias Migration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

5.16 GW / eDirectory Association . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

5.16.1 Graft GroupWise Objects. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

5.16.2 Invalid Associations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

5.16.3 Associate Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

5.16.4 Disassociate GroupWise Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

5.16.5 Convert External Entity to User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

5.16.6 Convert User to External Entity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

5.17 Standalone GroupWise Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

5.17.1 GroupWise Check Utility (GWCheck) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

5.17.2 GroupWise Target Service Agent (GWTSA) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

5.17.3 GroupWise Target Service Agent for File Systems (TSAFSGW) . . . . . . . . . . . . . . . 82

5.17.4 GroupWise Backup Time Stamp Utility (GWTMSTMP) . . . . . . . . . . . . . . . . . . . . . . . 83

5.17.5 GroupWise Database Copy Utility (DBCOPY). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

5.17.6 GroupWise Generate CSR Utility (GWCSRGEN) . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

novdocx (en) 10 March 2008

6 GroupWise Address Book 85

6.1 Customizing Address Book Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

6.1.1 Adding eDirectory Fields to the Address Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

6.1.2 Adding LDAP Fields to the Address Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

6.1.3 Changing the Default Sort Order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

6.1.4 Removing Fields from the Address Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

6.1.5 Preventing the User Description Field from Displaying in the Address Book . . . . . . 89

6.2 Controlling Object Visibility. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

6.3 Supporting Messenger Presence Display in GroupWise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90

6.4 Updating Address Book Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

6.4.1 Synchronizing Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

6.4.2 Rebuilding the Post Office Database. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

6 GroupWise 7 Administration Guide

6.5 Controlling Address Book Synchronization for Remote Client Users. . . . . . . . . . . . . . . . . . . . 91

6.6 Enabling Wildcard Addressing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

6.6.1 Setting Wildcard Addressing Levels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93

6.6.2 Wildcard Addressing Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

6.7 Adding External Users to the GroupWise Address Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95

6.7.1 Creating a Non-GroupWise Domain to Represent the Internet . . . . . . . . . . . . . . . . . 96

6.7.2 Linking to the Non-GroupWise Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

6.7.3 Creating a Non-GroupWise Post Office to Represent an Internet Host. . . . . . . . . . . 98

6.7.4 Creating External Users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100

6.8 Facilitating Addressing through GroupWise Gateways . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100

6.8.1 Creating an Addressing Rule. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101

6.8.2 Enabling an Addressing Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102

7 Multilingual GroupWise Systems 105

7.1 Client Languages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

7.2 Administration Languages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106

7.3 International Character Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106

7.4 Multi-Language Workstations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

novdocx (en) 10 March 2008

Part II Domains 109

8 Creating a New Domain 111

8.1 Understanding the Purpose of Domains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

8.2 Planning a New Domain. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112

8.2.1 Determining When to Add a New Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112

8.2.2 Deciding Who Will Administer the New Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . 113

8.2.3 Planning Post Offices in the New Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114

8.2.4 Determining the Context for the Domain Object . . . . . . . . . . . . . . . . . . . . . . . . . . . 114

8.2.5 Choosing the Domain Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116

8.2.6 Deciding Where to Create the Domain Directory. . . . . . . . . . . . . . . . . . . . . . . . . . . 117

8.2.7 Deciding Where to Install the Agent Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118

8.2.8 Deciding How to Link the New Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

8.2.9 Selecting the Domain Language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

8.2.10 Selecting the Domain Time Zone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

8.3 Setting Up the New Domain. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122

8.3.1 Creating the New Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122

8.3.2 Configuring the MTA for the New Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123

8.3.3 Installing and Starting the New MTA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124

8.4 What’s Next . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124

8.5 Domain Worksheet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125

9 Managing Domains 127

9.1 Connecting to a Domain. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127

9.2 Editing Domain Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127

9.3 Converting a Secondary Domain to a Primary Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131

9.4 Moving a Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132

9.5 Deleting a Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133

9.6 Changing MTA Configuration to Meet Domain Needs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135

Contents 7

10 Managing the Links between Domains and Post Offices 137

10.1 Understanding Link Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137

10.1.1 Domain-to-Domain Links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137

10.1.2 Domain-to-Post Office Links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140

10.1.3 Link Protocols for Direct Links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141

10.2 Using the Link Configuration Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143

10.2.1 Starting the Link Configuration Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143

10.2.2 Editing a Domain Link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144

10.2.3 Editing Multiple Domain Links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145

10.2.4 Editing a Post Office Link. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146

10.2.5 Viewing the Path of an Indirect Link between Domains. . . . . . . . . . . . . . . . . . . . . . 147

10.2.6 Viewing the Indirect Links Passing through a Domain. . . . . . . . . . . . . . . . . . . . . . . 148

10.2.7 Viewing the Gateway Links Passing through a Gateway . . . . . . . . . . . . . . . . . . . . 149

10.2.8 Saving and Synchronizing Link Configuration Information . . . . . . . . . . . . . . . . . . . 150

10.3 Interpreting Link Symbols. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150

10.3.1 Link Type Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150

10.3.2 Link Status Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150

10.4 Modifying Links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151

Part III Post Offices 153

novdocx (en) 10 March 2008

11 Creating a New Post Office 155

11.1 Understanding the Purpose of Post Offices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155

11.2 Planning a New Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156

11.2.1 Determining When to Add a Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156

11.2.2 Selecting the Domain That the Post Office Will Belong To . . . . . . . . . . . . . . . . . . . 157

11.2.3 Determining the Context for the Post Office Object. . . . . . . . . . . . . . . . . . . . . . . . . 158

11.2.4 Choosing the Post Office Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160

11.2.5 Deciding Where to Create the Post Office Directory . . . . . . . . . . . . . . . . . . . . . . . . 160

11.2.6 Deciding Where to Install the Agent Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161

11.2.7 Deciding How to Link the New Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164

11.2.8 Selecting the Post Office Language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165

11.2.9 Selecting the Post Office Time Zone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165

11.2.10 Selecting a Software Distribution Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165

11.2.11 Selecting a Post Office Security Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166

11.2.12 Deciding if You Want to Create a Library for the New Post Office . . . . . . . . . . . . . 166

11.3 Setting Up the New Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167

11.3.1 Creating the New Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167

11.3.2 Configuring the POA for the New Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170

11.3.3 Installing and Starting the New POA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170

11.3.4 Setting Up User Access to the New Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . 171

11.4 What’s Next . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171

11.5 Post Office Worksheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171

12 Managing Post Offices 175

12.1 Connecting to the Domain That Owns a Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175

12.2 Editing Post Office Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176

12.3 Managing Disk Space Usage in the Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182

12.3.1 Preparing to Implement Disk Space Management . . . . . . . . . . . . . . . . . . . . . . . . . 182

12.3.2 Setting Mailbox Size Limits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183

12.3.3 Enforcing Mailbox Size Limits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185

12.3.4 Restricting the Size of Messages That Users Can Send. . . . . . . . . . . . . . . . . . . . . 185

12.3.5 Preventing the Post Office from Running Out of Disk Space . . . . . . . . . . . . . . . . . 187

8 GroupWise 7 Administration Guide

12.3.6 An Alternative to Disk Space Management in the Post Office . . . . . . . . . . . . . . . . . 190

12.3.7 Forcing Caching Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190

12.4 Auditing Mailbox License Usage in the Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191

12.5 Tracking and Restricting Client Access to the Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . 193

12.6 Refreshing the Client View Files in the Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195

12.7 Disabling a Post Office. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195

12.8 Moving a Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196

12.9 Deleting a Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197

12.10 Changing POA Configuration to Meet Post Office Needs . . . . . . . . . . . . . . . . . . . . . . . . . . . 199

Part IV Users 201

13 Creating GroupWise Accounts 203

13.1 Establishing a Default Password for All New GroupWise Accounts. . . . . . . . . . . . . . . . . . . . 203

13.2 Creating GroupWise Accounts for eDirectory Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204

13.2.1 Creating a Single GroupWise Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204

13.2.2 Creating Multiple GroupWise Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206

13.2.3 Using a Template to Create GroupWise Accounts . . . . . . . . . . . . . . . . . . . . . . . . . 208

13.2.4 Creating GroupWise Accounts by Importing Users . . . . . . . . . . . . . . . . . . . . . . . . . 209

13.3 Creating GroupWise Accounts for Non-eDirectory Users . . . . . . . . . . . . . . . . . . . . . . . . . . . 214

13.4 Educating Your New Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215

novdocx (en) 10 March 2008

14 Managing GroupWise Accounts and Users 217

14.1 Adding a User to a Distribution List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217

14.2 Allowing Users to Modify Distribution Lists. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218

14.3 Adding a Global Signature to Users’ Messages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219

14.3.1 Creating Global Signatures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219

14.3.2 Selecting a Default Global Signature for All Outgoing Messages . . . . . . . . . . . . . . 220

14.3.3 Assigning Global Signatures to Internet Agents . . . . . . . . . . . . . . . . . . . . . . . . . . . 221

14.3.4 Assigning Global Signatures to Windows Client Users . . . . . . . . . . . . . . . . . . . . . . 221

14.3.5 Excluding Global Signatures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222

14.4 Moving GroupWise Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222

14.4.1 Live Move vs. File Transfer Move . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223

14.4.2 Moves Between GroupWise 6.x or Later Post Offices. . . . . . . . . . . . . . . . . . . . . . . 223

14.4.3 Moves Between GroupWise 6.x or Later and GroupWise 5.x Post Offices. . . . . . . 223

14.4.4 Preparing for a User Move. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224

14.4.5 Moving a GroupWise Account to Another Post Office in the Same eDirectory Tree 225

14.4.6 Moving a GroupWise Account to Another Post Office in a Dif ferent e Direc tory

Tree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226

14.4.7 Monitoring User Move Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228

14.5 Renaming Users and Their GroupWise Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231

14.6 Managing Mailbox Passwords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231

14.6.1 Creating or Changing a Mailbox Password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232

14.6.2 Removing a Mailbox Password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233

14.6.3 Bypassing the GroupWise Password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233

14.7 Managing E-Mail Addresses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235

14.7.1 Ensuring Unique E-Mail Addresses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236

14.7.2 Changing a User’s Internet Addressing Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . 236

14.7.3 Changing a User’s Visibility in the Address Book . . . . . . . . . . . . . . . . . . . . . . . . . . 238

14.7.4 Creating a Nickname for a User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239

14.8 Checking GroupWise Account Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240

14.9 Disabling and Enabling GroupWise Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240

14.10 Removing GroupWise Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241

Contents 9

14.10.1 Deleting a GroupWise Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241

14.10.2 Expiring a GroupWise Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243

14.10.3 Managing Expired or Expiring GroupWise Accounts . . . . . . . . . . . . . . . . . . . . . . . . 244

Part V Resources 247

15 Creating Resources 249

15.1 Understanding Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249

15.1.1 Resource Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249

15.1.2 Resource Types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249

15.1.3 Resource Mailboxes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249

15.1.4 Resource Owners . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250

15.2 Planning Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250

15.3 Creating a New Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250

16 Managing Resources 253

16.1 Changing a Resource’s Owner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253

16.2 Adding a Resource to a Distribution List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254

16.3 Moving a Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255

16.4 Renaming a Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256

16.5 Deleting a Resource. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256

16.6 Managing E-Mail Addresses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256

16.6.1 Changing a Resource’s Internet Addressing Settings . . . . . . . . . . . . . . . . . . . . . . . 257

16.6.2 Changing a Resource’s Visibility in the Address Book . . . . . . . . . . . . . . . . . . . . . . 258

16.6.3 Creating a Nickname for a Resource. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259

novdocx (en) 10 March 2008

Part VI Distribution Lists, Groups, and Organizational Roles 261

17 Understanding Distribution Lists, Groups, and Organizational Roles 263

17.1 Public vs. Personal Address Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263

17.2 Distribution Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263

17.3 eDirectory Groups and Organizational Roles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264

18 Creating and Managing Distribution Lists 265

18.1 Creating a New Distribution List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265

18.2 Adding Members to a Distribution List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268

18.3 Removing Members from a Distribution List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269

18.4 Moving a Distribution List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269

18.5 Renaming a Distribution List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270

18.6 Enabling Users to Modify a Distribution List. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270

18.7 Deleting a Distribution List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272

18.8 Managing E-Mail Addresses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272

18.8.1 Changing a Distribution List’s Internet Addressing Settings . . . . . . . . . . . . . . . . . . 272

18.8.2 Changing a Distribution List’s Visibility in the Address Book . . . . . . . . . . . . . . . . . . 274

18.8.3 Creating a Nickname for a Distribution List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275

18.9 Adding External Users to a Distribution List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276

18.9.1 Creating an External Domain. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276

18.9.2 Creating an External Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276

18.9.3 Creating an External User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276

10 GroupWise 7 Administration Guide

19 Using eDirectory Groups as GroupWise Distribution Lists 279

19.1 Setting Up an eDirectory Group for Use in GroupWise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279

19.2 Seeing Which Members of an eDirectory Group Have GroupWise Accounts . . . . . . . . . . . . 280

19.3 Changing a Group’s Visibility in the Address Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281

19.4 Moving a Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281

19.5 Renaming a Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282

19.6 Removing a Group from GroupWise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282

20 Using eDirectory Organizational Roles as GroupWise Distribution Lists 285

20.1 Setting Up an Organizational Role for Use in GroupWise . . . . . . . . . . . . . . . . . . . . . . . . . . . 285

20.2 Seeing Which Members of an Organizational Role Have GroupWise Accounts . . . . . . . . . . 286

20.3 Changing an Organizational Role’s Visibility in the Address Book. . . . . . . . . . . . . . . . . . . . . 287

20.4 Moving an Organizational Role . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287

20.5 Renaming an Organizational Role . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288

20.6 Removing an Organizational Role from GroupWise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289

Part VII Libraries and Documents 291

novdocx (en) 10 March 2008

21 Document Management Services Overview 293

21.1 Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293

21.2 Document Storage Areas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295

21.3 Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295

21.3.1 Document Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295

21.3.2 Document Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296

21.4 Integrations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298

22 Creating and Managing Libraries 299

22.1 Planning a Basic Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299

22.1.1 Selecting the Post Office That the Library Will Belong To . . . . . . . . . . . . . . . . . . . . 300

22.1.2 Determining the Context for the Library Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300

22.1.3 Choosing the Library Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300

22.1.4 Deciding Where to Store Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301

22.2 Setting Up a Basic Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302

22.2.1 Creating the Basic Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302

22.3 Planning Full-Service Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303

22.3.1 Deciding Which Libraries to Create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304

22.3.2 Selecting the Post Offices To Own Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308

22.3.3 Determining the Contexts for Library Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308

22.3.4 Choosing Library Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308

22.3.5 Deciding Where to Store Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309

22.3.6 Setting Document Version Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311

22.3.7 Figuring Maximum Archive Directory Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312

22.3.8 Designating Initial Librarians . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312

22.3.9 Restricting Initial Public Library Rights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313

22.3.10 Determining Your Indexing Needs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314

22.3.11 Determining If You Need to Set Up Integrations for DMS Users . . . . . . . . . . . . . . . 314

22.4 Setting Up a Full-Service Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315

22.4.1 Creating the Full-Service Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315

22.4.2 What’s Next . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317

22.5 Viewing a New Library in Your GroupWise System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318

22.5.1 Seeing the New Library in ConsoleOne. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318

Contents 11

22.5.2 Seeing the New Library in the GroupWise Windows Client . . . . . . . . . . . . . . . . . . . 319

22.6 Managing Libraries. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319

22.6.1 Editing Library Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320

22.6.2 Managing Document Storage Areas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321

22.6.3 Managing Library Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324

22.6.4 Adding and Training Librarians . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326

22.6.5 Maintaining Library Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330

22.6.6 Moving a Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330

22.6.7 Deleting a Library. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330

22.7 Library Worksheets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331

22.7.1 Basic Library Worksheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331

22.7.2 Full-Service Library Worksheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332

23 Creating and Managing Documents 335

23.1 Adding Documents to Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335

23.1.1 Creating New Documents in the GroupWise Windows Client . . . . . . . . . . . . . . . . . 335

23.1.2 Importing Existing Documents into the GroupWise DMS System . . . . . . . . . . . . . . 336

23.1.3 Managing Groups of Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337

23.2 Organizing Documents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338

23.2.1 Customizing Document Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338

23.2.2 Defining Related Document Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347

23.3 Indexing Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351

23.3.1 Understanding DMS Indexing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352

23.3.2 Determining Your Indexing Needs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358

23.3.3 Implementing Indexing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360

23.4 Managing Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360

23.4.1 Archiving and Deleting Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360

23.4.2 Backing Up and Restoring Archived Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . 360

23.4.3 Handling Orphaned Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362

novdocx (en) 10 March 2008

24 Integrations 363

24.1 Setting Up Integrations during Windows Client Installation . . . . . . . . . . . . . . . . . . . . . . . . . . 363

24.2 Setting Up Integrations Using the gwappint.inf File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364

24.2.1 Understanding the Three Levels of Integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365

24.2.2 Understanding the gwappint.inf File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365

24.2.3 Editing the gwappint.inf File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368

24.3 Controlling Integrations in the GroupWise Windows Client . . . . . . . . . . . . . . . . . . . . . . . . . . 369

Part VIII Databases 371

25 Understanding GroupWise Databases 373

25.1 Domain Databases. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373

25.2 Post Office Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373

25.3 User Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374

25.4 Message Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374

25.5 Library Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374

25.6 Guardian Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375

26 Maintaining Domain and Post Office Databases 377

26.1 Validating Domain or Post Office Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377

26.2 Recovering Domain or Post Office Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378

12 GroupWise 7 Administration Guide

26.3 Rebuilding Domain or Post Office Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381

26.4 Rebuilding Database Indexes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383

27 Maintaining User/Resource and Message Databases 385

27.1 Analyzing and Fixing User and Message Databases. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385

27.2 Performing a Structural Rebuild of a User Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387

27.3 Re-creating a User Database. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388

28 Maintaining Library Databases and Documents 391

28.1 Analyzing and Fixing Databases for Libraries and Documents . . . . . . . . . . . . . . . . . . . . . . . 391

28.2 Analyzing and Fixing Library and Document Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . 392

29 Synchronizing Database Information 395

29.1 Synchronizing Individual Users or Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395

29.2 Synchronizing a Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396

29.3 Synchronizing a Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397

29.4 Synchronizing a Secondary Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397

29.5 Synchronizing the Primary Domain from a Secondary Domain . . . . . . . . . . . . . . . . . . . . . . . 398

novdocx (en) 10 March 2008

30 Managing Database Disk Space 399

30.1 Gathering Mailbox Statistics. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399

30.2 Reducing the Size of User and Message Databases. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401

30.3 Reclaiming Disk Space in Domain and Post Office Databases . . . . . . . . . . . . . . . . . . . . . . . 403

30.4 Reducing the Size of Libraries and Document Storage Areas . . . . . . . . . . . . . . . . . . . . . . . . 404

30.4.1 Archiving and Deleting Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404

30.4.2 Deleting Activity Logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405

31 Backing Up GroupWise Databases 407

31.1 Backing Up a Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407

31.2 Backing Up a Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407

31.3 Backing Up a Library and Its Documents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408

31.4 Backing Up Individual Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409

32 Restoring GroupWise Databases from Backup 411

32.1 Restoring a Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411

32.2 Restoring a Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411

32.3 Restoring a Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412

32.4 Restoring an Individual Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412

32.5 Restoring Deleted Mailbox Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413

32.5.1 Setting Up a Restore Area. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413

32.5.2 Restoring a User’s Mailbox Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415

32.5.3 Letting Client Users Restore Their Own Mailbox Items . . . . . . . . . . . . . . . . . . . . . . 416

32.6 Recovering Deleted GroupWise Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416

33 Retaining User Messages 419

33.1 How Message Retention Works . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419

Contents 13

33.1.1 What GroupWise Does . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419

33.1.2 What the Message Retention Application Does . . . . . . . . . . . . . . . . . . . . . . . . . . . 420

33.2 Acquiring a Message Retention Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421

33.3 Enabling Message Retention . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421

34 Standalone Database Maintenance Programs 423

34.1 GroupWise Check . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423

34.1.1 GWCheck Functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423

34.1.2 Using GWCheck on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425

34.1.3 Using GWCheck on Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426

34.1.4 Using GWCheck on Macintosh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428

34.1.5 Performing Mailbox/Library Maintenance Using GWCheck . . . . . . . . . . . . . . . . . . . 429

34.1.6 Executing GWCheck from a Windows Batch File . . . . . . . . . . . . . . . . . . . . . . . . . . 431

34.1.7 Executing GWCheck from a Linux Script. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432

34.1.8 GWCheck Startup Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432

34.2 Target Service Agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434

34.2.1 GroupWise Target Service Agent (GWTSA) for NetWare 5.1 . . . . . . . . . . . . . . . . . 435

34.2.2 GroupWise Target Service Agent for File Systems (TSAFSGW) for NetWare 6.x/OES

and Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439

34.3 GroupWise Time Stamp Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448

34.3.1 GWTMSTMP Functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449

34.3.2 Running GWTMSTMP on NetWare. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449

34.3.3 Running GWTMSTMP on Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450

34.3.4 Running GWTMSTMP on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450

34.3.5 GWTMSTMP Startup Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451

34.4 GroupWise Database Copy Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455

34.4.1 Using DBCopy on NetWare . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456

34.4.2 Using DBCopy on Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456

34.4.3 Using DBCopy on Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457

34.4.4 DBCopy Startup Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458

novdocx (en) 10 March 2008

Part IX Post Office Agent 461

35 Understanding Message Delivery and Storage in the Post Office 463

35.1 Post Office Representation in ConsoleOne . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463

35.2 Post Office Directory Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464

35.3 Information Stored in the Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464

35.3.1 Post Office Database. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464

35.3.2 Message Store. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464

35.3.3 Guardian Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466

35.3.4 Agent Input/Output Queues in the Post Office. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466

35.3.5 Libraries (optional) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467

35.4 Post Office Access Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468

35.5 Role of the Post Office Agent. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469

35.5.1 Client/Server Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469

35.5.2 Message File Processing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470

35.5.3 Other POA Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470

35.6 Message Flow in the Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471

35.7 Cross-Platform Issues in the Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471

35.7.1 Client/Post Office Platform Independence through Browser Technology . . . . . . . . 472

35.7.2 Client/Post Office Platform Independence through Client/Server Mode . . . . . . . . . 472

35.7.3 POA/Post Office Platform Dependencies Because of Direct Access Requirements 472

14 GroupWise 7 Administration Guide

36 Configuring the POA 475

36.1 Performing Basic POA Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475

36.1.1 Creating a POA Object in eDirectory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476

36.1.2 Configuring the POA in ConsoleOne . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 477

36.1.3 Changing the Link Protocol between the Post Office and the Domain . . . . . . . . . . 481

36.1.4 Binding the POA to a Specific IP Address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483

36.1.5 Moving the POA to a Different Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484

36.1.6 Adjusting the POA for a New Post Office Location . . . . . . . . . . . . . . . . . . . . . . . . . 484

36.1.7 Adjusting the POA Logging Level and Other Log Settings . . . . . . . . . . . . . . . . . . . 485

36.2 Configuring User Access to the Post Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486

36.2.1 Using Client/Server Access to the Post Office. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486

36.2.2 Simplifying Client/Server Access with a GroupWise Name Server . . . . . . . . . . . . . 488

36.2.3 Supporting IMAP Clients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490

36.2.4 Supporting SOAP Clients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 491

36.2.5 Supporting CAP Clients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 492

36.2.6 Checking What GroupWise Clients Are in Use . . . . . . . . . . . . . . . . . . . . . . . . . . . . 492

36.2.7 Supporting Forced Mailbox Caching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494

36.2.8 Restricting Message Size between Post Offices . . . . . . . . . . . . . . . . . . . . . . . . . . . 495

36.3 Configuring Post Office Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496

36.3.1 Securing Client/Server Access through a Proxy Server . . . . . . . . . . . . . . . . . . . . . 496

36.3.2 Controlling Client Redirection Inside and Outside Your Firewall . . . . . . . . . . . . . . . 498

36.3.3 Securing the Post Office with SSL Connections to the POA . . . . . . . . . . . . . . . . . . 498

36.3.4 Providing LDAP Authentication for GroupWise Users . . . . . . . . . . . . . . . . . . . . . . . 501

36.3.5 Enabling Intruder Detection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506

36.3.6 Configuring Trusted Application Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 507

36.4 Configuring Post Office Maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 507

36.4.1 Scheduling Database Maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 507

36.4.2 Scheduling Disk Space Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 510

36.4.3 Performing Nightly User Upkeep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 513

novdocx (en) 10 March 2008

37 Monitoring the POA 515

37.1 Using the POA Server Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515

37.1.1 Monitoring the POA from the POA Server Console. . . . . . . . . . . . . . . . . . . . . . . . . 515

37.1.2 Controlling the POA from the POA Server Console . . . . . . . . . . . . . . . . . . . . . . . . 520

37.2 Using the POA Web Console. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 530

37.2.1 Setting Up the POA Web Console. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 531

37.2.2 Accessing the POA Web Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532

37.2.3 Monitoring the POA from the POA Web Console . . . . . . . . . . . . . . . . . . . . . . . . . . 533

37.2.4 Controlling the POA from the POA Web Console . . . . . . . . . . . . . . . . . . . . . . . . . . 536

37.3 Using POA Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 538

37.3.1 Configuring POA Log Settings and Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 538

37.3.2 Viewing POA Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 539

37.3.3 Interpreting POA Log File Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 539

37.4 Using GroupWise Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 539

37.5 Using Novell Remote Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 540

37.6 Using an SNMP Management Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 540

37.6.1 Setting Up SNMP Services for the POA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 541

37.6.2 Copying and Compiling the POA MIB File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 543

37.6.3 Configuring the POA for SNMP Monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544

37.7 Notifying the GroupWise Administrator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544

37.8 Using the POA Error Message Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 545

37.9 Employing POA Troubleshooting Techniques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 545

37.10 Using Platform-Specific POA Monitoring Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 546

Contents 15

38 Optimizing the POA 547

38.1 Optimizing Client/Server Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 547

38.1.1 Adjusting the Number of POA Threads for Client/Server Processing . . . . . . . . . . . 547

38.1.2 Adjusting the Number of Connections for Client/Server Processing . . . . . . . . . . . . 549

38.1.3 Configuring a Dedicated Client/Server POA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 550

38.2 Optimizing Message File Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 552

38.2.1 Adjusting the Number of POA Threads for Message File Processing . . . . . . . . . . . 552

38.2.2 Configuring a Dedicated Message File Processing POA . . . . . . . . . . . . . . . . . . . . 553

38.3 Optimizing Indexing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 554

38.3.1 Regulating Indexing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555

38.3.2 Configuring a Dedicated Indexing POA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 556

38.3.3 Customizing Indexing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 557

38.4 Optimizing Database Maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 559

38.4.1 Adjusting the Number of POA Threads for Database Maintenance . . . . . . . . . . . . 559

38.4.2 Configuring a Dedicated Database Maintenance POA . . . . . . . . . . . . . . . . . . . . . . 560

38.5 Optimizing CPU Utilization for the NetWare POA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 562

39 Using POA Startup Switches 565

39.1 @filename . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 569

39.2 /attemptsresetinterval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 569

39.3 /cap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 569

39.4 /capmaxthreads . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 570

39.5 /capport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 570

39.6 /capssl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 570

39.7 /certfile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 570

39.8 /cluster . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 571

39.9 /cpu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 571

39.10 /dn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 571

39.11 /enforceclientversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 572

39.12 /evocontrol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 572

39.13 /externalclientssl. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 572

39.14 /gwchkthreads . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 573

39.15 /gwclientreleasedate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 573

39.16 /gwclientreleaseversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 573

39.17 /help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 574

39.18 /home . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 574

39.19 /httppassword. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 574

39.20 /httpport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 574

39.21 /httprefresh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 575

39.22 /httpssl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 575

39.23 /httpuser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 575

39.24 /imap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 576

39.25 /imapmaxthreads . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 576

39.26 /imapreadlimit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 576

39.27 /imapport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 576

39.28 /imapssl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 577

39.29 /imapsslport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 577

39.30 /incorrectloginattempts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 577

39.31 /internalclientssl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 577

39.32 /intruderlockout. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 578

39.33 /ip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 578

39.34 /keyfile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 578

novdocx (en) 10 March 2008

16 GroupWise 7 Administration Guide

39.35 /keypassword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 579

39.36 /language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 579

39.37 /ldapdisablepwdchg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 580

39.38 /ldapipaddr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 580

39.39 /ldapippooln . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 581

39.40 /ldappoolresettime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 581

39.41 /ldapport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 581

39.42 /ldapportpooln . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 581

39.43 /ldappwd. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 582

39.44 /ldapssl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 582

39.45 /ldapsslpooln . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 582

39.46 /ldapsslkey . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583

39.47 /ldapsslkeypooln. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583

39.48 /ldaptimeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583

39.49 /ldapuser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584

39.50 /ldapuserauthmethod . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584

39.51 /lockoutresetinterval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584

39.52 /log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585

39.53 /logdays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585

39.54 /logdiskoff . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585

39.55 /loglevel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 586

39.56 /logmax. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 586

39.57 /maxappconns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 586

39.58 /maxphysconns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 587

39.59 /mtpinipaddr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 587

39.60 /mtpinport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 587

39.61 /mtpoutipaddr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 587

39.62 /mtpoutport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 588

39.63 /mtpsendmax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 588

39.64 /mtpssl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 588

39.65 /name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 589

39.66 /noada . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 589

39.67 /nocache. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 589

39.68 /noconfig. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 590

39.69 /noerrormail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 590

39.70 /nogwchk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 590

39.71 /noldapx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 590

39.72 /nomf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 591

39.73 /nomfhigh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 591

39.74 /nomflow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 591

39.75 /nomtp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 591

39.76 /nonuu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 592

39.77 /noqf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 592

39.78 /nordab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 592

39.79 /norecover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 592

39.80 /nosnmp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 593

39.81 /notcpip. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 593

39.82 /nuuoffset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 593

39.83 /password. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 593

39.84 /port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 594

39.85 /primingmax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 594

39.86 /qfbaseoffset. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 594

novdocx (en) 10 March 2008

Contents 17

39.87 /qfbaseoffsetinminute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 594

39.88 /qfdeleteold. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 595

39.89 /qfinterval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 595

39.90 /qfintervalinminute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 595

39.91 /qflevel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 596

39.92 /qfnolibs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 596

39.93 /qfnopreproc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597

39.94 /qfnousers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597

39.95 /qfuserfidbeg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597

39.96 /qfuserfidend . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597

39.97 /rdaboffset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598

39.98 /rights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598

39.99 --show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598

39.100/sleep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599

39.101/soap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599

39.102/soapmaxthreads . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599

39.103/soapport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599

39.104/soapsizelimit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 600

39.105/soapssl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 600

39.106/soapthreads . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 600

39.107/tcpthreads . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 600

39.108/threads . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 601

39.109/user . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 601

novdocx (en) 10 March 2008

Part X Message Transfer Agent 603

40 Understanding Message Transfer between Domains and Post Offices 605

40.1 Domain Representation in ConsoleOne . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 605

40.2 Domain Directory Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 606

40.3 Information Stored in the Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 606

40.3.1 Domain Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 606

40.3.2 Agent Input/Output Queues in the Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607

40.3.3 Gateways. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607

40.4 Role of the Message Transfer Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 608

40.5 Link Configuration between Domains and Post Offices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 608

40.6 Message Flow between Domains and Post Offices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 608

40.6.1 Message Flow between Post Offices in the Same Domain . . . . . . . . . . . . . . . . . . . 609

40.6.2 Message Flow between Different Domains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 609

40.7 Cross-Platform Issues between Domains and Post Offices. . . . . . . . . . . . . . . . . . . . . . . . . . 609

40.7.1 MTA Platform Dependencies Because of Direct Access Requirements to Post

Offices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 610

40.7.2 MTA/Post Office Platform Independence through TCP/IP Links . . . . . . . . . . . . . . . 610

40.7.3 MTA Platform Dependencies Because of Direct Access Requirements to the

Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 610

40.7.4 MTA/Domain Platform Independence through TCP/IP Links . . . . . . . . . . . . . . . . . 611

40.7.5 MTA/Domain Platform Independence through the Transfer Pull Configuration. . . . 611

41 Configuring the MTA 613

41.1 Performing Basic MTA Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613

41.1.1 Creating an MTA Object in eDirectory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 614

41.1.2 Configuring the MTA in ConsoleOne . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 615

18 GroupWise 7 Administration Guide

41.1.3 Changing the Link Protocol between Domains . . . . . . . . . . . . . . . . . . . . . . . . . . . . 618

41.1.4 Changing the Link Protocol between a Domain and Its Post Offices . . . . . . . . . . . 622

41.1.5 Binding the MTA to a Specific IP Address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 625

41.1.6 Moving the MTA to a Different Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 626

41.1.7 Adjusting the MTA for a New Location of a Domain or Post Office . . . . . . . . . . . . . 626

41.1.8 Adjusting the MTA Logging Level and Other Log Settings . . . . . . . . . . . . . . . . . . . 627

41.2 Configuring User Access through the Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 628

41.2.1 Restricting Message Size between Domains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 628

41.2.2 Enabling Live Remote . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 629

41.2.3 Securing the Domain with SSL Connections to the MTA . . . . . . . . . . . . . . . . . . . . 629

41.3 Configuring Specialized Routing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 631

41.3.1 Using Routing Domains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 631

41.3.2 Scheduling Direct Domain Links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 633

41.3.3 Using a Transfer Pull Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 636

41.4 Configuring Domain Maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 638

41.4.1 Using eDirectory User Synchronization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 638

41.4.2 Enabling MTA Message Logging. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 643

42 Monitoring the MTA 645

42.1 Using the MTA Server Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 645

42.1.1 Monitoring the MTA from the MTA Server Console. . . . . . . . . . . . . . . . . . . . . . . . . 645

42.1.2 Controlling the MTA from the MTA Server Console . . . . . . . . . . . . . . . . . . . . . . . . 648

42.2 Using the MTA Web Console. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 657

42.2.1 Setting Up the MTA Web Console. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 657

42.2.2 Accessing the MTA Web Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 659

42.2.3 Monitoring the MTA from the MTA Web Console . . . . . . . . . . . . . . . . . . . . . . . . . . 659

42.2.4 Controlling the MTA from the MTA Web Console . . . . . . . . . . . . . . . . . . . . . . . . . . 664

42.3 Using MTA Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 665

42.3.1 Configuring MTA Log Settings and Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 666

42.3.2 Viewing MTA Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 666

42.3.3 Interpreting MTA Log File Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 666

42.4 Using GroupWise Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 666

42.5 Using Novell Remote Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 667

42.6 Using an SNMP Management Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 667

42.6.1 Setting Up SNMP Services for the MTA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 668

42.6.2 Copying and Compiling the MTA MIB File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 670

42.6.3 Configuring the MTA for SNMP Monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 671

42.7 Notifying the Domain Administrator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 671

42.8 Using the MTA Error Message Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 672

42.9 Employing MTA Troubleshooting Techniques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 672

42.10 Using Platform-Specific MTA Monitoring Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 673

42.11 Using MTA Message Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 673

novdocx (en) 10 March 2008

43 Optimizing the MTA 675

43.1 Optimizing TCP/IP Links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 675

43.1.1 Adjusting the Number of MTA TCP/IP Connections . . . . . . . . . . . . . . . . . . . . . . . . 675

43.1.2 Adjusting the MTA Wait Intervals for Slow TCP/IP Connections . . . . . . . . . . . . . . . 676

43.2 Optimizing Mapped/UNC Links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 676

43.2.1 Using TCP/IP Links between Locations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 676

43.2.2 Adjusting MTA Polling of Input Queues in the Domain, Post Offices, and

Gateways. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 676

43.2.3 Adjusting the Number of MTA Scanner Threads for the Domain and Post Offices . 678

43.3 Optimizing the Routing Queue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 680

43.3.1 Adjusting the Maximum Number of Active Router Threads . . . . . . . . . . . . . . . . . . . 680

Contents 19

43.3.2 Adjusting the Maximum Number of Idle Router Threads . . . . . . . . . . . . . . . . . . . . . 680

43.4 Adjusting MTA Polling of Closed Locations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 680

44 Using MTA Startup Switches 683

44.1 @filename . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 685

44.2 /activelog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 685

44.3 /certfile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 685

44.4 /cyhi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 685

44.5 /cylo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 686

44.6 /defaultroutingdomain. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 686

44.7 /dn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 686

44.8 /fast0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 686

44.9 /fast4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 687

44.10 /help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 687

44.11 /home . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 687

44.12 /httppassword. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 687

44.13 /httpport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 688

44.14 /httprefresh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 688

44.15 /httpssl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 688

44.16 /httpuser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 689

44.17 /ip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 689

44.18 /keyfile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 689

44.19 /keypassword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 689

44.20 /language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 690

44.21 /liveremote . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 691

44.22 /log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 691

44.23 /logdays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 691

44.24 /logdiskoff . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 692

44.25 /loglevel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 692

44.26 /logmax. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 692

44.27 /lrconn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 693

44.28 /lrwaitdata. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 693

44.29 /maxidlerouters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 693

44.30 /maxrouters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 693

44.31 /messagelogdays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 694

44.32 /messagelogmaxsize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 694

44.33 /messagelogpath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 694

44.34 /messagelogsettings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 695

44.35 /msgtranssl. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 695

44.36 /noada . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 695

44.37 /nodns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 695

44.38 /noerrormail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 695

44.39 /nondssync . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 696

44.40 /norecover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 696

44.41 /nosnmp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 696

44.42 /password. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 696

44.43 --show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 697

44.44 /tcpinbound. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 697

44.45 /tcpport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 697

44.46 /tcpwaitconnect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 697

44.47 /tcpwaitdata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 698

novdocx (en) 10 March 2008

20 GroupWise 7 Administration Guide

44.48 /tracelogin. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 698

44.49 /user . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 698

44.50 /vsnoadm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 698

44.51 /work. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 699

Part XI Internet Agent 701

45 Configuring Internet Addressing 703

45.1 Planning Internet Addressing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 703

45.1.1 Internet Agent Requirement. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 704

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

45.1.3 Internet Domain Names. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 704

45.1.4 Preferred Address Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 704

45.1.5 Allowed Address Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 707

45.1.6 Override Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 707

45.2 Setting Up Internet Addressing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 708

45.2.1 Installing the Internet Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 708

45.2.2 Enabling Internet Addressing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 708

45.2.3 Overriding Internet Addressing Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 710

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

45.3.1 Planning to Migrate Gateway Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 714

45.3.2 Preparing to Migrate Gateway Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 714

45.3.3 Performing the Gateway Alias Migration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 714

45.3.4 Verifying the Gateway Alias Migration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 716

novdocx (en) 10 March 2008

46 Configuring Internet Services 717

46.1 Configuring SMTP/MIME Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 717

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

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

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

46.1.4 Determining Format Options for Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 723

46.1.5 Configuring the SMTP Timeout Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 725

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

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

46.1.8 Enabling SMTP Relaying. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 731

46.1.9 Using a Route Configuration File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 732

46.1.10 Customizing Delivery Status Notifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 732

46.1.11 Managing MIME Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 733

46.2 Configuring LDAP Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 737

46.2.1 Enabling LDAP Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 737

46.2.2 Configuring Public Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 738

46.3 Configuring POP3/IMAP4 Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 739

46.3.1 Enabling POP3/IMAP4 Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 740

46.3.2 Configuring Post Office Links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 741

46.3.3 Giving POP3 or IMAP4 Access Rights to Users . . . . . . . . . . . . . . . . . . . . . . . . . . . 743

46.3.4 Setting Up an E-Mail Client for POP3/IMAP4 Services . . . . . . . . . . . . . . . . . . . . . . 743

46.4 Configuring Paging Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 744

46.4.1 Setting Up Paging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 745

46.4.2 Using Paging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 746

47 Managing Internet Access 747

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

47.1.1 Classes of Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 747

Contents 21

47.1.2 Creating a Class of Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 748

47.1.3 Testing Access Control Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 753

47.1.4 Maintaining the Access Control Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 755

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

47.2.1 Real-Time Blacklists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 757

47.2.2 Access Control Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 759

47.2.3 Blocked.txt File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 759

47.2.4 Mailbomb (Spam) Protection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 760

47.2.5 Customized Spam Identification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 761

47.2.6 SMTP Host Authentication. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 762

47.2.7 Unidentified Host Rejection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 763

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

47.3.1 Selecting an Accountant . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 764

47.3.2 Enabling Accounting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 765

47.3.3 Understanding the Accounting File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 766

48 Configuring the Internet Agent 769

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

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

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

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

48.4.1 Defining the Certificate File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 772

48.4.2 Defining Which Connections Use SSL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 773

novdocx (en) 10 March 2008

49 Monitoring the Internet Agent 775

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

49.1.1 Description. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 776

49.1.2 Status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 776

49.1.3 Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 777

49.1.4 Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 784

49.1.5 Menu Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 785

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

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

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

49.3 Using Novell Remote Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 789

49.4 Using an SNMP Management Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 789

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

49.6 Using Internet Agent Log Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 791

49.6.1 Modifying Log Settings in ConsoleOne . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 792

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

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

49.6.4 Viewing Log Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 795

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

49.8 Employing Internet Agent Troubleshooting Techniques . . . . . . . . . . . . . . . . . . . . . . . . . . . . 796

49.9 Stopping the Internet Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 796

49.9.1 Using the Internet Agent Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 796

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

49.9.3 Using a Mail Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 797

49.9.4 Using a Shutdown File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 797

50 Optimizing the Internet Agent 799

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

50.2 Increasing Internet Agent Speed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 801

22 GroupWise 7 Administration Guide

50.2.1 Sending and Receiving Threads . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 801

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

50.2.3 Increasing Polling Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 801

50.2.4 Decreasing the Timeout Cycles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 802

50.3 Automating Reattachment to NetWare Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 802

51 Connecting GroupWise Systems and Domains Using the Internet Agent 805

51.1 Connecting GroupWise Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 805

51.1.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 805

51.1.2 Creating an External Domain. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 806

51.1.3 Linking to the External Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 807

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

51.1.5 Sending Messages Between Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 810

51.1.6 Exchanging Information Between Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 810

51.2 Linking Domains. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 810

52 Using Internet Agent Startup Switches 813

52.1 How to Use Startup Switches. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 813

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

52.1.2 Modifying the gwia.cfg File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 814

52.1.3 Editing Guidelines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 814

52.2 Alphabetical List of Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 815

52.3 Required Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 821

52.3.1 /dhome. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 821

52.3.2 /hn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 821

52.3.3 /home. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 822

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

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

52.4 Console Switches. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 822

52.4.1 /color . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 822

52.4.2 /help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 823

52.4.3 /nosnmp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 823

52.4.4 /mono. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 823

52.4.5 --show (Linux Only) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 823

52.5 Environment Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 823

52.5.1 /ip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 823

52.5.2 /ipa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 824

52.5.3 /ipp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 824

52.5.4 /cluster (NetWare Only) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 824

52.5.5 /smtphome . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 824

52.5.6 /work . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 825

52.5.7 /nasoq . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 825

52.6 SMTP/MIME Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 825

52.6.1 SMTP Enabled. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 826

52.6.2 iCal Enabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 826

52.6.3 Address Handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 826

52.6.4 Message Formatting and Encoding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 831

52.6.5 Forwarded and Deferred Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 834

52.6.6 Extended SMTP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 835

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

52.6.8 Dial-Up Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 836

52.6.9 Timeouts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 837

52.6.10 Relay Host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 838

52.6.11 Host Authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 839

52.6.12 Undeliverable Message Handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 840

novdocx (en) 10 March 2008

Contents 23

52.6.13 Mailbomb and Spam Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 840

52.7 POP3 Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 842

52.7.1 /pop3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 842

52.7.2 /popintruderdetect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 842

52.7.3 /popport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 842

52.7.4 /popsport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 842

52.7.5 /popssl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 843

52.7.6 /pt. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 843

52.7.7 /sslpt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 843

52.8 IMAP4 Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 843

52.8.1 /imap4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 844

52.8.2 /imapport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 844

52.8.3 /imapreadlimit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 844

52.8.4 /imapsport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 844

52.8.5 /imapssl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 844

52.8.6 /it . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 845

52.8.7 /sslit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 845

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

52.9.1 /httpport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 845

52.9.2 /httpuser. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 846

52.9.3 /httppassword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 846

52.9.4 /httprefresh. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 846

52.9.5 /httpssl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 846

52.10 SSL Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 846

52.10.1 /certfile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 847

52.10.2 /keyfile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 847

52.10.3 /keypasswd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 847

52.10.4 /smtppssl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 847

52.10.5 /httpssl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 847

52.10.6 /popssl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 848

52.10.7 /imapssl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 848

52.10.8 /ldapssl. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 848

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

52.11.1 GroupWise Authentication Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 849

52.11.2 LDAP Query Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 850

52.12 Log File Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 851

52.12.1 /log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 851

52.12.2 /logdays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 852

52.12.3 /loglevel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 852

52.12.4 /logmax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 852

novdocx (en) 10 March 2008

Part XII WebAccess 853

53 Scaling Your WebAccess Installation 855

53.1 WebAccess Configurations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 855

53.1.1 Multiple WebAccess Agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 855

53.1.2 Multiple WebAccess and WebPublisher Applications . . . . . . . . . . . . . . . . . . . . . . . 856

53.2 Installing Additional WebAccess Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 858

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

53.2.2 Installing Additional Components on Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 859

53.3 Configuring Redirection and Failover Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 860

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

53.3.2 Synchronizing the Encryption Key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 863

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

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

24 GroupWise 7 Administration Guide

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

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

54 Configuring WebAccess Components 869

54.1 Configuring the WebAccess Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 870

54.1.1 Modifying WebAccess Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 870

54.1.2 Modifying WebPublisher Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 871

54.1.3 Managing Access to Post Offices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 873

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

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

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

54.2 Configuring the WebAccess Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 879

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

54.2.2 Adding or Removing Service Providers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 881

54.2.3 Modifying WebAccess Application Template Settings . . . . . . . . . . . . . . . . . . . . . . . 882

54.2.4 Securing WebAccess Application Sessions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 888

54.2.5 Controlling Availability of WebAccess Features . . . . . . . . . . . . . . . . . . . . . . . . . . . 890

54.3 Configuring the Novell Speller Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 892

54.4 Configuring the WebPublisher Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 894

54.4.1 Modifying the WebPublisher Application Environment Settings . . . . . . . . . . . . . . . 895

54.4.2 Adding or Removing Service Providers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 896

54.4.3 Modifying WebPublisher Application Template Settings . . . . . . . . . . . . . . . . . . . . . 897

54.4.4 Controlling Availability of WebPublisher Features . . . . . . . . . . . . . . . . . . . . . . . . . . 901

54.5 Configuring the GroupWise Service Provider. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 903

54.6 Configuring the LDAP Service Provider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 905

54.7 Configuring the GroupWise Document Service Provider . . . . . . . . . . . . . . . . . . . . . . . . . . . . 907

54.8 Configuring the Document Viewer Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 909

54.8.1 Viewer Agent Web Console. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 910

54.8.2 Document Conversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 910

54.8.3 Document Quarantine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 911

54.8.4 Document Cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 911

54.8.5 Agent Performance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 912

54.8.6 Agent Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 912

54.8.7 Client/Server Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 912

54.9 Enabling Web Server Data Compression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 913

54.9.1 Apache 2 on NetWare 6.5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 913

54.9.2 Apache 2 on Open Enterprise Server (OES) Linux . . . . . . . . . . . . . . . . . . . . . . . . . 914

54.9.3 Apache 2 on SUSE Linux Enterprise Server 9 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 914

54.9.4 Microsoft Internet Information Server (IIS) on Windows 2003 . . . . . . . . . . . . . . . . . 914

novdocx (en) 10 March 2008

55 Managing User Access 915

55.1 Controlling User Access to Mailboxes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 915

55.1.1 Class Membership . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 915

55.1.2 Creating a Class of Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 916

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

55.1.4 Maintaining the Access Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 918

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

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

55.4 Customizing the WebAccess Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 924

56 Monitoring WebAccess Operations 925

56.1 Monitoring the WebAccess Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 925

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

Contents 25

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

56.1.3 Using Novell Remote Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 932

56.1.4 Using an SNMP Management Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 932

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

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

56.1.7 Employing WebAccess Agent Troubleshooting Techniques . . . . . . . . . . . . . . . . . . 934

56.2 Monitoring the WebAccess Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 934

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

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

56.3 Monitoring the Document Viewer Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 935

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

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

56.4 Using WebAccess Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 937

56.4.1 Controlling WebAccess Agent Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 937

56.4.2 Controlling WebAccess Application Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 941

56.4.3 Controlling Document Viewer Agent Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 943

56.4.4 Viewing WebAccess Log Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 943

56.4.5 Interpreting WebAccess Log File Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 944

57 Using WebAccess Startup Switches 945

novdocx (en) 10 March 2008

57.1 WebAccess Agent Startup Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 945

57.1.1 @filename . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 946

57.1.2 /cluster . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 947

57.1.3 /help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 947

57.1.4 /home (Required). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 948

57.1.5 /http . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 948

57.1.6 /httppassword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 948

57.1.7 /httpport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 948

57.1.8 /httpuser. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 949

57.1.9 /ip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 949

57.1.10 /log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 949

57.1.11 /logdays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 950

57.1.12 /logdiskon. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 950

57.1.13 /loglevel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 950

57.1.14 /logmax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 951

57.1.15 /maxusers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 951

57.1.16 /password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 951

57.1.17 /port-number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 952

57.1.18 --show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 952

57.1.19 /threads-number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 952

57.1.20 /user. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 952

57.1.21 /work . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 953

57.2 Document Viewer Agent Startup Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 953

57.2.1 /addrspacename . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 954

57.2.2 /cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 954

57.2.3 /domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 955

57.2.4 /email . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 955

57.2.5 /hold . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 955

57.2.6 /http . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 955

57.2.7 /httpport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 956

57.2.8 /httppw . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 956

57.2.9 /httpuser. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 956

57.2.10 /ip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 957

57.2.11 /lang . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 957

57.2.12 /log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 957

57.2.13 /logdays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 958

57.2.14 /loglevel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 958

26 GroupWise 7 Administration Guide

57.2.15 /logmax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 958

57.2.16 /maxcache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 959

57.2.17 /maxhold . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 959

57.2.18 /maxprobtime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 959

57.2.19 /maxsize. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 959

57.2.20 /maxtime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 960

57.2.21 /maxtrancache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 960

57.2.22 /maxtrantime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 960

57.2.23 /maxworkers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 960

57.2.24 /minworkers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 961

57.2.25 /port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 961

57.2.26 /relay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 961

57.2.27 /temp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 962

Part XIII Monitor 963

58 Understanding the Monitor Agent Consoles 965

58.1 Monitor Agent Server Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 965

58.2 Monitor Agent Web Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 965

58.3 Monitor Web Console. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 966

novdocx (en) 10 March 2008

59 Configuring the Monitor Agent 969

59.1 Selecting Agents to Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 970

59.1.1 Filtering the Agent List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 970

59.1.2 Adding All Agents on a Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 971

59.1.3 Adding All Agents on a Subnet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 971

59.1.4 Adding an Individual Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 972

59.1.5 Removing Added Agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 972

59.2 Creating and Managing Agent Groups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 973

59.2.1 Creating an Agent Group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 974

59.2.2 Managing Agent Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 974

59.2.3 Viewing Your Agent Group Hierarchy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 974

59.2.4 Configuring an Agent Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 975

59.3 Configuring Monitoring Protocols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 975

59.3.1 Configuring the Monitor Agent for HTTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 975

59.3.2 Configuring the Monitor Agent for SNMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 977

59.4 Configuring Polling of Monitored Agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 978

59.5 Configuring E-Mail Notification for Agent Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 979

59.5.1 Configuring E-Mail Notification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 979

59.5.2 Customizing Notification Thresholds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 981

59.6 Configuring Audible Notification for Agent Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 983

59.7 Configuring SNMP Trap Notification for Agent Problems. . . . . . . . . . . . . . . . . . . . . . . . . . . . 984

59.8 Configuring Authentication and Intruder Lockout for the Monitor Web Console . . . . . . . . . . 985

59.9 Configuring Monitor Agent Log Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 986

59.10 Configuring Proxy Service Support for the Monitor Web Console . . . . . . . . . . . . . . . . . . . . . 987

59.11 Monitoring Messenger Agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 988

59.12 Supporting the GroupWise High Availability Service on Linux . . . . . . . . . . . . . . . . . . . . . . . . 989

60 Configuring the Monitor Application 991

60.1 Modifying Monitor Application Environment Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 991

60.2 Modifying Monitor Application Log Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 992

60.3 Adding or Removing Service Providers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 994

Contents 27

60.4 Modifying Monitor Application Template Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 995

61 Using GroupWise Monitor 997

61.1 Using the Monitor Agent Server Console. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 997

61.1.1 Viewing All Agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 998

61.1.2 Viewing Problem Agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 998

61.1.3 Viewing an Agent Server Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 999

61.1.4 Viewing an Agent Web Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1000

61.1.5 Polling the Agents for Updated Status Information . . . . . . . . . . . . . . . . . . . . . . . . 1000

61.2 Using the Monitor Web Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1001

61.3 Generating Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1002

61.3.1 Link Trace Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1002

61.3.2 Link Configuration Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1003

61.3.3 Image Map Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1004

61.3.4 Environment Report. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1009

61.3.5 User Traffic Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1009

61.3.6 Link Traffic Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1010

61.3.7 Message Tracking Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1010

61.3.8 Performance Tracking Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1011

61.3.9 Connected User Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1011

61.3.10 Gateway Accounting Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1011

61.3.11 Trends Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1011

61.3.12 Down Time Report. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1012

61.4 Measuring Agent Performance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1012

61.4.1 Setting Up an External Monitor Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1012

61.4.2 Selecting an MTA to Communicate with the Monitor Agent . . . . . . . . . . . . . . . . . 1013

61.4.3 Configuring the Monitor Agent for Agent Performance Testing . . . . . . . . . . . . . . . 1014

61.4.4 Viewing Agent Performance Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1014

61.4.5 Viewing an Agent Performance Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1015

61.4.6 Receiving Notification of Agent Performance Problems . . . . . . . . . . . . . . . . . . . . 1015

61.5 Collecting Gateway Accounting Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1015

61.5.1 Setting Up an External Monitor Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1015

61.5.2 Selecting an MTA to Communicate with the Monitor Agent . . . . . . . . . . . . . . . . . 1016

61.5.3 Setting Up an External Post Office and External User for Monitor . . . . . . . . . . . . 1017

61.5.4 Receiving the Accounting Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1017

61.5.5 Viewing the Gateway Accounting Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1018

61.6 Assigning Responsibility for Specific Agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1018

61.7 Searching for Agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1019

novdocx (en) 10 March 2008

62 Comparing the Monitor Consoles 1021

63 Using Monitor Agent Switches 1023

63.1 /hapassword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1024

63.2 /hapoll. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1024

63.3 /hauser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1025

63.4 /help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1025

63.5 /home . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1025

63.6 /httpagentpassword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1026

63.7 /httpagentuser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1026

63.8 /httpcertfile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1026

63.9 /httpmonpassword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1027

63.10 /httpmonuser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1027

63.11 /httpport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1028

28 GroupWise 7 Administration Guide

63.12 /httpssl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1028

63.13 /ipa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1028

63.14 /ipp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1028

63.15 /lang . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1029

63.16 /log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1029

63.17 /monwork . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1030

63.18 /nmaddress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1030

63.19 /nmhome . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1031

63.20 /nmpassword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1031

63.21 /nmuser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1031

63.22 /nosnmp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1031

63.23 /pollthreads. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1032

63.24 /proxy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1032

63.25 /tcpwaitconnect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1032

Part XIV Client 1033

64 Setting Up GroupWise Modes and Accounts 1035

novdocx (en) 10 March 2008

64.1 GroupWise Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1035

64.1.1 Online Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1035

64.1.2 Caching Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1035

64.1.3 Remote Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1037

64.2 Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1042

64.2.1 Accounts Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1042

64.2.2 Enabling POP3, IMAP4, and NNTP Account Access in Online Mode . . . . . . . . . . 1042

65 Setting Defaults for the GroupWise Client Options 1045

65.1 Client Options Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1045

65.2 Setting Client Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1049

65.2.1 Modifying Environment Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1050

65.2.2 Modifying Send Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1062

65.2.3 Modifying Security Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1073

65.2.4 Modifying Date and Time Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1076

65.3 Resetting Client Options to Default Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1080

66 Distributing the GroupWise Client 1081

66.1 Using GroupWise AutoUpdate and SetupIP to Distribute the GroupWise Windows Client . 1081

66.1.1 Preparing to Use AutoUpdate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1082

66.1.2 Using the Setup Configuration File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1085

66.1.3 Modifying the Setup Configuration File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1085

66.1.4 Adding LDAP Directory Service Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1091

66.1.5 Testing Your AutoUpdate Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1092

66.1.6 Enabling AutoUpdate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1093

66.1.7 Modifying the addon.cfg File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1094

66.1.8 Error Log File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1095

66.2 Using ZENworks Desktop Management to Distribute the GroupWise Windows Client . . . . 1095

66.2.1 Creating a GroupWise Client Application Object . . . . . . . . . . . . . . . . . . . . . . . . . . 1096

66.2.2 Using GroupWise 7 Tuner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1099

66.2.3 Configuring ZENworks to Use a Transform File . . . . . . . . . . . . . . . . . . . . . . . . . . 1101

66.3 Using Novell ZENworks Linux Management to Distribute the GroupWise Cross-Platform

Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1101

Contents 29

67 Supporting the GroupWise Client in Multiple Languages 1103

67.1 Providing the GroupWise Client Software in Multiple Languages . . . . . . . . . . . . . . . . . . . . 1103

67.2 Providing Post Office Support for Multiple Languages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1103

68 Tools for Analyzing and Correcting GroupWise Client Problems 1105

68.1 GroupWise Exception Handler for the Windows Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1105

68.2 GroupWise Check . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1105

68.2.1 Enabling GroupWise Check in the Windows Client . . . . . . . . . . . . . . . . . . . . . . . . 1106

68.2.2 Using GroupWise Check with the Cross-Platform Client . . . . . . . . . . . . . . . . . . . . 1106

69 Startup Switches for the GroupWise Client 1107

69.1 /@u-? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1107

69.2 /@u-user_ID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1107

69.3 /bl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1108

69.4 /c . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1108

69.5 /cm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1108

69.6 /iabs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1108

69.7 /ipa-IP_address_or_hostname . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1108

69.8 /ipp-port_number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1109

69.9 /l-xx. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1109

69.10 /la-network_ID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1110

69.11 /nu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1110

69.12 /ph-pathname . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1110

69.13 /pc-path_to_caching_mailbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1110

69.14 /pr-path_to_remote_mailbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1110

69.15 -ui=xxx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1111

novdocx (en) 10 March 2008

Part XV Security Administration 1113

70 GroupWise Passwords 1115

70.1 Mailbox Passwords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1115

70.1.1 Using Post Office Security Instead of GroupWise Passwords. . . . . . . . . . . . . . . . 1115

70.1.2 Requiring GroupWise Passwords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1116

70.1.3 Managing GroupWise Passwords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1116

70.1.4 Using LDAP Passwords Instead of GroupWise Passwords . . . . . . . . . . . . . . . . . 1118

70.1.5 Bypassing Mailbox Passwords to Respond to Corporate Mandates . . . . . . . . . . . 1118

70.2 Agent Passwords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1119

70.2.1 Facilitating Access to Remote Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1119

70.2.2 Facilitating Access to eDirectory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1120

70.2.3 Protecting the Agent Web Consoles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1120

70.2.4 Protecting the GroupWise Monitor Web Console . . . . . . . . . . . . . . . . . . . . . . . . . 1120

71 Encryption and Certificates 1121

71.1 Personal Digital Certificates, Digital Signatures,

and S/MIME Encryption . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1121

71.2 Server Certificates and SSL Encryption . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1123

71.2.1 Generating a Certificate Signing Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1123

71.2.2 Using a GWCSRGEN Configuration File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1124

71.2.3 Submitting the Certificate Signing Request to a Certificate Authority . . . . . . . . . . 1125

30 GroupWise 7 Administration Guide