Novell GROUPWISE 8 - TROUBLESHOOTING 3 User manual

Novell®
www.novell.com
novdocx (en) 22 June 2009
AUTHORIZED DOCUMENTATION
GroupWise 8 Troubleshooting 3: Message Flow and Directory Structure
GroupWise ®
8
August 31, 2009
Troubleshooting 3: Message Flow and Directory Structure

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

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

4GroupWise 8 Troubleshooting 3: Message Flow and Directory Structure
novdocx (en) 22 June 2009

Contents 5
Contents
novdocx (en) 22 June 2009
About This Guide 9
Part I Message Flow Diagrams 11
1 Message Delivery in the Local Post Office 13
1.1 Online Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
1.2 Caching Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
1.3 Remote Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
2 Message Delivery to a Different Post Office 19
2.1 TCP/IP Link Open: Transfer between Post Offices Successful . . . . . . . . . . . . . . . . . . . . . . . . 19
2.2 TCP/IP Link Closed: Transfer between Post Offices Delayed . . . . . . . . . . . . . . . . . . . . . . . . . 22
3 Message Delivery to a Different Domain 25
3.1 TCP/IP Link Open: Transfer between Domains Successful. . . . . . . . . . . . . . . . . . . . . . . . . . . 25
3.2 TCP/IP Link Closed: Transfer between Domains Delayed. . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
4 Message Delivery to and from the Internet 33
4.1 TCP/IP Link: Outbound Transfer to the Internet Successful . . . . . . . . . . . . . . . . . . . . . . . . . . 33
4.2 TCP/IP Link: Outbound Transfer to the Internet Delayed or Unsuccessful . . . . . . . . . . . . . . . 35
4.3 Mapped/UNC Link: Outbound Transfer to the Internet Successful . . . . . . . . . . . . . . . . . . . . . 38
4.4 Mapped/UNC Link: Outbound Transfer to the Internet Delayed or Unsuccessful . . . . . . . . . . 41
4.5 TCP/IP Link: Inbound Transfer from the Internet Successful . . . . . . . . . . . . . . . . . . . . . . . . . . 43
4.6 Mapped/UNC Link: Inbound Transfer from the Internet Successful. . . . . . . . . . . . . . . . . . . . . 45
5 Message Delivery through a Modem Connection 47
5.1 “Hit the Road” Process in Online Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
5.2 Modem Link through the Async Gateway in Remote Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
6 Administrative Database Update 53
Part II Directory Structure Diagrams 55
7 Message Transfer/Storage Directories 57
7.1 Domain Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
7.1.1 domain directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
7.1.2 wpcsin directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
7.1.3 wptools directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
7.1.4 wpgate directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
7.1.5 wpcsout directory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
7.1.6 mtaname file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

6GroupWise 8 Troubleshooting 3: Message Flow and Directory Structure
novdocx (en) 22 June 2009
7.1.7 wpdomain.db file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
7.1.8 wpdomain.dc file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
7.1.9 wphost.dc file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
7.1.10 gwdom.dc file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
7.1.11 gwpo.dc file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
7.1.12 viewcopy.log file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
7.2 Post Office Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
7.2.1 post_office directory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
7.2.2 wpcsin directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
7.2.3 gwdms directory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
7.2.4 ofmsg directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
7.2.5 ofuser directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
7.2.6 offiles directory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
7.2.7 ofviews directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
7.2.8 ofwork directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
7.2.9 ofdirect directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
7.2.10 oftemp directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
7.2.11 wpcsout directory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
7.2.12 wphost.db file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
7.2.13 gwpo.dc file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
7.2.14 ngwguard.db file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
7.2.15 ngwguard.dc file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
7.2.16 ngwguard.fbk file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
7.2.17 ngwguard.rfl file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
7.2.18 ngwcheck.db . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
7.3 MTA Local Queue Directory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
7.3.1 mslocal directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
7.3.2 msglog directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
7.3.3 gwinprog directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
7.3.4 mshold directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
7.3.5 domainms directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
7.3.6 postx directories. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
7.3.7 gatewayx directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
7.3.8 domainx directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
7.3.9 0-7 directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
7.3.10 mtaname files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
7.3.11 gwvsscan directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
7.3.12 mtaconv directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
7.4 Internet Agent Queue Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
7.4.1 domain\wpgate\gwia directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
7.4.2 gwia directory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
7.5 WebAccess Agent Queue Directory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
7.5.1 domain\wpgate\webac80a directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
7.5.2 000.prc directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
7.5.3 wpcsin directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
7.5.4 wpcsout directory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
7.5.5 gwhold directory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
7.5.6 gwprob directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
7.5.7 template directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
7.5.8 commgr.cfg file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
7.5.9 comint.cfg file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
7.5.10 mimetype.cfg file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
7.5.11 gwac.db file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
7.5.12 gwac.dc file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
7.6 Caching Mailbox Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
7.6.1 gwxxxxxx directory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
7.6.2 rofdata directory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
7.6.3 wpcsin directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93

Contents 7
novdocx (en) 22 June 2009
7.6.4 wpcsout\ofs directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
7.6.5 wpgwsend directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
7.6.6 wpgwrecv directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
7.6.7 remoten.log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
7.7 Remote Mailbox Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
7.7.1 remote_mailbox directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
7.7.2 rofdata directory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
7.7.3 wpcsin directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
7.7.4 wpcsout\ofs directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
7.7.5 wpgwsend directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
7.7.6 wpgwrecv directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
7.7.7 remoten.log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
8 Agent Installation Directories 99
8.1 GroupWise Agent Installation (POA and MTA) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
8.1.1 NetWare Installation Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
8.1.2 Linux Installation Directory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
8.1.3 Windows Installation Directory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
8.2 Internet Agent Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
8.2.1 NetWare Installation Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
8.2.2 Linux Installation Directory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
8.2.3 Windows Installation Directory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
8.3 WebAccess Agent Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
8.3.1 NetWare Installation Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
8.3.2 Linux Installation Directory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
8.3.3 Windows Installation Directory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
8.3.4 Document Viewer Agent Working Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
8.4 Monitor Agent Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
8.4.1 Linux Installation Directory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
8.4.2 Windows Installation Directory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
8.5 Web Server Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
8.5.1 NetWare Apache/Tomcat Installation Directories . . . . . . . . . . . . . . . . . . . . . . . . . . 134
8.5.2 OES Linux Apache/Tomcat Installation Directories . . . . . . . . . . . . . . . . . . . . . . . . . 139
8.5.3 SUSE Linux Enterprise Server Apache/Tomcat Installation Directories . . . . . . . . . 144
8.5.4 Windows IIS/Tomcat Installation Directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
9 Software Distribution Directory 155
9.1 NetWare/Windows Software Distribution Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
9.1.1 \grpwise\software directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
9.1.2 setup.exe file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
9.1.3 agents directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
9.1.4 domain directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
9.1.5 po directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
9.1.6 client directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
9.1.7 gwcheck directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
9.1.8 ofviews directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
9.1.9 ppforms directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
9.1.10 uwl directory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
9.1.11 admin directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
9.1.12 internet directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
9.1.13 license directory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
9.1.14 common directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
9.1.15 docs directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
9.2 Linux Software Distribution Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
9.2.1 /opt/novell/groupwise/software directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163

8GroupWise 8 Troubleshooting 3: Message Flow and Directory Structure
novdocx (en) 22 June 2009
9.2.2 agents directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
9.2.3 domain directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
9.2.4 po directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
9.2.5 client directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
9.2.6 ofviews directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
9.2.7 admin directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
9.2.8 internet directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
9.2.9 license directory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
9.2.10 docs directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
9.2.11 gwinst directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
10 GroupWise Client Installation Directories 171
10.1 Windows Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
10.1.1 c:\Program Files\Novell\GroupWise. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
10.1.2 grpwise.exe file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
10.1.3 gwdca.exe file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
10.1.4 notify.exe file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
10.1.5 addrbook.exe file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
10.1.6 htrsetup.exe file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
10.1.7 gwimpexe.exe file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
10.1.8 gwmailto.exe file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
10.1.9 gwreload.exe file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
10.1.10 gwsync.exe file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
10.1.11 ngwguard.dc file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
10.1.12 wprof.dc file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
10.1.13 *.dll files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
10.1.14 *.ocx files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
10.1.15 *.flt files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
10.1.16 *.chm files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
10.1.17 gwcheck directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
10.1.18 ofviews directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
10.1.19 ppforms directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
10.2 Linux Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
10.2.1 /opt/novell/groupwise/client directory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
10.2.2 bin directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
10.2.3 lib directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
10.2.4 java directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
10.2.5 logs directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
10.3 Mac Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
10.3.1 /Applications/GroupWise.app directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
10.3.2 Contents directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
10.3.3 MacOS directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
10.3.4 Resources directory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
10.3.5 lib directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
Part III Documentation Updates 179
A August 31, 2009 (GroupWise 8 SP1) 181

About This Guide 9
novdocx (en) 22 June 2009
About This Guide
This Novell®GroupWise®Troubleshooting 3 Guide provides diagrams to help you understand the
structure and functioning of your GroupWise system. The guide is divided into the following
sections:
“Message Flow Diagrams” on page 11
“Directory Structure Diagrams” on page 55
Other sources of troubleshooting assistance include:
Novell Support and Knowledgebase (http://www.novell.com/support)
To search the GroupWise documentation from the Novell Support Web site, click Advanced
Search, select Documentation in the Search In drop-down list, select GroupWise in the
Products drop-down list, type the search string, then click Search.
GroupWise 8 Support Forums (http://forums.novell.com/novell-product-support-forums/
groupwise)
GroupWise Support Community (http://www.novell.com/support/products/groupwise)
GroupWise Cool Solutions (http://www.novell.com/communities/coolsolutions/gwmag)
Audience
This guide is intended for network administrators who install and administer GroupWise.
Feedback
We want to hear your comments and suggestions about this manual and the other documentation
included with this product. Please use the User Comments feature at the bottom of each page of the
online documentation, or go to www.novell.com/documentation/feedback.html and enter your
comments there.
Documentation Updates
For the most recent version of GroupWise 8 Troubleshooting 3: Message Flow and Directory
Structure, visit the GroupWise 8 Documentation Web site (http://www.novell.com/documentation/
gw8).
Additional Documentation
For additional GroupWise documentation, see the following guides at the GroupWise 8
Documentation Web site (http://www.novell.com/documentation/gw8):
Installation Guide
Administration Guide
Multi-System Administration Guide
Interoperability Guide
Troubleshooting 1: Error Messages

10 GroupWise 8 Troubleshooting 3: Message Flow and Directory Structure
novdocx (en) 22 June 2009
Troubleshooting 2: Solutions to Common Problems
GroupWise Client User Guides
GroupWise Client Frequently Asked Questions (FAQ)
Documentation Conventions
In Novell documentation, a greater-than symbol (>) is used to separate actions within a step and
items in a cross-reference path.
A trademark symbol (TM, ®, etc.) denotes a Novell trademark. An asterisk denotes a third-party
trademark.
When a single pathname can be written with a backslash for some platforms or a forward slash for
other platforms, the pathname is presented with a backslash. Users of platforms that require a
forward slash, such as Linux*, should use forward slashes as required by your software.
When a startup switch can be written with a forward slash for some platforms or a double hyphen for
other platforms, the startup switch is presented with a forward slash. Users of platforms that require
a double hyphen, such as Linux, should use double hyphens as required by your software.

Message Flow Diagrams
I
11
novdocx (en) 22 June 2009
I
Message Flow Diagrams
This part of Troubleshooting 3: Message Flow and Directory Structure helps you understand how
messages travel between GroupWise®users and how administrative updates to GroupWise
databases occur.
Chapter 1, “Message Delivery in the Local Post Office,” on page 13
Chapter 2, “Message Delivery to a Different Post Office,” on page 19
Chapter 3, “Message Delivery to a Different Domain,” on page 25
Chapter 4, “Message Delivery to and from the Internet,” on page 33
Chapter 5, “Message Delivery through a Modem Connection,” on page 47
Chapter 6, “Administrative Database Update,” on page 53

12 GroupWise 8 Troubleshooting 3: Message Flow and Directory Structure
novdocx (en) 22 June 2009

Message Delivery in the Local Post Office
1
13
novdocx (en) 22 June 2009
1
Message Delivery in the Local
Post Office
The GroupWise®8 client always uses client/server access to the post office but it can interact with
the POA for the post office in different ways. For a review, see “Changing GroupWise Modes” in
“Getting Organized” in the GroupWise 8 Windows Client User Guide.
Section 1.1, “Online Mode,” on page 13
Section 1.2, “Caching Mode,” on page 14
Section 1.3, “Remote Mode,” on page 17
1.1 Online Mode
This message flow diagram illustrates how a GroupWise message travels from one user to another in
the local post office when the client and POA communicate by way of TCP/IP and the users are
accessing their Online mailboxes.
Figure 1-1 Message Flow in Online Mode
Table 1-1 Message Flow in Online Mode Stages
Stage Icon Description
Sender The user sends a message to recipients in the same post office. The
access mode setting for the post office is Client/Server Only.
Sender’s
GroupWise Client
The GroupWise client communicates with the POA by way of TCP/IP.
ab
wpcsin
0-7
0-7
ofmsg
msgnnn.db
ofuser
userxxx.db
wpcsout
ads
offiles
fdo-7f
0-7
ofs
POA
b
10
12
9
3
4
7
8
6
5

14 GroupWise 8 Troubleshooting 3: Message Flow and Directory Structure
novdocx (en) 22 June 2009
1.2 Caching Mode
This message flow diagram illustrates how a GroupWise message travels from one user to another in
the local post office when the users are accessing their Caching mailboxes.
POA for Local
Post Office
The POA receives the message from the GroupWise client and performs
the following actions for the sender:
Adds the message to the message database ( msgnnn.db )
assigned to the sender.
Creates a pointer in the sender’s user database ( userxxx.db ) so
the message appears in the sender’s mailbox as a sent item.
Places attachments larger than 2 KB in one of the
post_office\offiles\fd0-F6 subdirectories and creates
pointers from the message to its attachments. (For database
efficiency, messages and distribution lists larger than 2 KB are also
handled as attachments.)
The POA also performs the following actions for the recipient:
Creates a pointer in each recipient’s user database ( userxxx.db )
to the message in the message database (
msgnnn.db ) so the new
message appears in the recipient’s mailbox.
Updates the message in the message database ( msgnnn.db ) with
a Delivered status for each recipient.
POA for Local
Post Office
The POA communicates to the GroupWise client by way of TCP/IP that a
new message has arrived.
Recipient’s
GroupWise Client
The Notify component of the recipient’s GroupWise client notifies the
recipient that a new message has arrived.
Recipient Each recipient opens the message in the GroupWise client.
Recipient’s
GroupWise Client
Each recipient’s GroupWise client communicates the Opened status to
the POA by way of TCP/IP.
POA for Local
Post Office
The POA receives the Opened status from the GroupWise client and
updates the message in the message database with the Opened status
for each recipient who opens the message.
POA for Local
Post Office
The POA communicate the Opened status to the sender’s GroupWise
client by way of TCP/IP.
Sender When the sender checks the sent items in his or her mailbox in the
GroupWise client, the message displays a status of Delivered for each
recipient (and possibly Opened as well if the recipient has opened the
message).
Stage Icon Description

Message Delivery in the Local Post Office 15
novdocx (en) 22 June 2009
Figure 1-2 Message Flow in Caching Mode
Table 1-2 Message Flow in Caching Mode Stages
Stage Icon Description
Sender The user sends a message to recipients in the same post office. The
user is in Caching mode.
Sender’s
GroupWise Client
The GroupWise client updates the sender’s Caching mailbox
(
\novell\groupwise\gwxxxxxxx\rofdata ) by performing the
following actions:
Adds the message to the message database ( rofdata\msg.db )
in the Caching mailbox. This database is local equivalent of the
msgnnn.db database in the post office.
Creates a pointer in the sender’s user database
( rofdata\user.db ) in the Caching mailbox so the message
appears in the sender’s mailbox as a sent item. This database is
the local equivalent of the
userxxx.db database in the post office.
Places attachments larger than 2 KB in the rofdata subdirectory
in the Caching mailbox and creates pointers from the message to
its attachments. (For database efficiency, messages and
distribution lists larger than 2 KB are also handled as attachments.)
There is no local equivalent to the
offiles subdirectory in the
post office, so attachments are placed directly in the rofdata
subdirectory in the Caching mailbox.
Places a copy of the message in the rofdata\wpcsin\1 priority
subdirectory to await the next connection to the POA.
Sender’s
GroupWise Client
In Caching mode, sending a message always initiates an immediate
connection with the POA in order to send the message. The GroupWise
client communicates the message to the POA and deletes the copy in
the
rofdata\wpcsin\1 priority subdirectory when the POA has
processed the message.
ab
wpcsin
0-7
0-7
ofmsg
msgnnn.db
ofuser
userxxx.db
wpcsout
ads
offiles
fdo-7f
0-7
ofs
POA
b
16
13
4
6
5
9
8
rofdata
msg.db
user.db
wpcsin
l
wprof.db
rofdata
msg.db
user.db
wpcsin
l
wprof.db
15
13
2
14 11
10 7
12

16 GroupWise 8 Troubleshooting 3: Message Flow and Directory Structure
novdocx (en) 22 June 2009
POA for Local
Post Office
The POA receives the message from the GroupWise client and performs
the following actions for the sender to update the sender’s Online
mailbox:
Adds the message to the message database ( msgnnn.db )
assigned to the sender in the post office.
Creates a pointer in the sender’s user database ( userxxx.db ) in
the post office.
Places attachments larger than 2 KB in one of the
post_office\offiles\fd0-F6 subdirectories in the post office
and creates pointers from the message to its attachments. (For
database efficiency, messages and distribution lists larger than 2
KB are also handled as attachments.)
The POA also performs the following actions for the recipients to update
their Online mailboxes:
Creates a pointer in each recipient’s user database ( userxxx.db )
to the message in the message database ( msgnnn.db ) in the post
office so that the new message appears in each recipient’s mailbox.
Updates the message in the message database ( msgnnn.db ) in
the post office with a Delivered status for the recipients.
POA for Local
Post Office
Because the recipients are also in Caching mode, they do not receive
immediate notification that a new message has arrived in their Online
mailboxes. Based on the Send/Retrieve All Marked Accounts Every nn
Minutes option under Accounts > Account Options > General, each
recipient’s GroupWise client sends a request to the POA for items that
have arrived in the recipient’s Online mailbox since the last connection
with the POA.
POA for Local
Post Office
The POA responds by sending information to update each recipient’s
Caching mailbox and communicates to the GroupWise client that a new
message has arrived.
Recipient’s
GroupWise Client
Each recipient’s GroupWise client updates the recipient’s Caching
mailbox by performing the following actions:
Adds the message to the message database ( rofdata\msg.db )
in the recipient’s Caching mailbox.
Creates a pointer in the recipient’s user database
(
rofdata\user.db ) to the message in the message database
(
rofdata\msg.db ) so the new message appears in the recipient’s
Caching mailbox.
Recipient’s
GroupWise Client
The Notify component of each recipient’s GroupWise client notifies the
recipient that a new message has arrived.
Recipient Each recipient opens the message in the GroupWise client.
Recipient’s
GroupWise Client
Each recipient’s GroupWise client generates an Opened status and
places it in the
rofdata\wpcsin\1 priority subdirectory to await the
next connection with the POA.
Stage Icon Description

Message Delivery in the Local Post Office 17
novdocx (en) 22 June 2009
1.3 Remote Mode
Before you can use Remote mode, you must create a Remote mailbox on your computer and have a
connection to your master GroupWise system. See Chapter 5, “Message Delivery through a Modem
Connection,” on page 47.
Recipient’s
GroupWise Client
When each recipient sends a message or the time specified by the Send/
Receive All Marked Accounts Every nn Minutes option has elapsed,
each recipient’s GroupWise client connects with the POA and
communicates the Opened status to the POA, along with any other data
that needs to be uploaded to the recipient’s Online mailbox.
POA for Local
Post Office
The POA receives the Opened status from the GroupWise client and
updates the message in the sender’s message database with the
Opened status.
Recipient’s
GroupWise Client
Because the sender is in Caching mode, the sender does not
immediately receive the Opened status. Based on the sender’s actions
and caching schedule, the sender’s GroupWise client eventually sends a
request to the POA for items that have arrived in the sender’s Online
mailbox since the last synchronization of the Caching mailbox.
POA for Local
Post Office
The POA responds by sending information to update the sender’s
Caching mailbox and communicates the Opened status to the sender’s
GroupWise client.
Recipient’s
GroupWise Client
The sender’s GroupWise client updates the sender’s Caching mailbox by
performing the following action:
Updates the message in the message database
( rofdata\msg.db ) with a Delivered and Opened status for each
recipient.
Sender When the sender checks the sent items in his or her mailbox in the
GroupWise client, the message displays a status of Delivered and
Opened for each recipient.
Stage Icon Description

18 GroupWise 8 Troubleshooting 3: Message Flow and Directory Structure
novdocx (en) 22 June 2009

Message Delivery to a Different Post Office
2
19
novdocx (en) 22 June 2009
2
Message Delivery to a Different
Post Office
The MTA handles message transfer between post offices.
Section 2.1, “TCP/IP Link Open: Transfer between Post Offices Successful,” on page 19
Section 2.2, “TCP/IP Link Closed: Transfer between Post Offices Delayed,” on page 22
The message flow diagrams in GroupWise 8 Troubleshooting 3: Message Flow and Directory
Structure focus on TCP/IP links because they are the most common and convenient (unless you have
a post office and a domain on the same server). For diagrams that include mapped/UNC links, see
GroupWise 6.5 Troubleshooting 3: Message Flow and Directory Structure. For an explanation of
link types and link protocols, see “Understanding Link Configuration” in “Domains” in the
GroupWise 8 Administration Guide.
2.1 TCP/IP Link Open: Transfer between Post
Offices Successful
This message flow diagram illustrates how a GroupWise®message travels from one user to another
between post offices in the same domain when the TCP/IP link between the post office and the
domain is open.
Figure 2-1 Message Flow When the TCP/IP Link is Open
wpcsin
0-7
0-7
wpcsout
ads
mslocal
gwinprog
0-7
mshold
domainms
0-7
domainx
MTA
0-7
posta
0-7
postb
0-7
gatewayx
a
wpcsin
0-7
ofmsg
msgnnn.db
ofuser
userxxx.db
wpcsout
ads
offiles
fdo-7f
0-7
ofs
POAa
a
17
2
3
16
0-7
1
wpcsin
0-7
ofmsg
msgnnn.db
ofuser
userxxx.db
wpcsout
ads
offiles
fdo-7f
0-7
ofs
POAb
b
12
0-7
4
b
10
11
8
9
7
6
5
4
15
14
13

20 GroupWise 8 Troubleshooting 3: Message Flow and Directory Structure
novdocx (en) 22 June 2009
Table 2-1 Message Flow When the TCP/IP Link is Open Stages
Stage Icon Description
Sender The user sends a message to recipients in a different post office in the same
domain.
In this diagram, the access mode setting in the local post office is Client/Server
Only.
Sender’s
GroupWise
Client
The GroupWise client communicates the message to the POA by way of TCP/
IP.
POA for
Sender’s Post
Office
The POA receives the message from the GroupWise client and performs the
following actions for the sender:
Adds the message to the message database ( msgnnn.db ) assigned to
the sender.
Creates a pointer in the sender’s user database ( userxxx.db ) so the
message appears in the sender’s mailbox as a sent item.
Places attachments larger than 2 KB in one of the
post_office\offiles\fd0-F6 subdirectories and creates pointers
from the message to its attachments. (For database efficiency, messages
and distribution lists larger than 2 KB are also handled as attachments.)
Creates a copy of the message in the appropriate priority 0-7
subdirectory of the MTA input queue in the sender’s post office, in case
the TCP/IP link to the MTA is currently closed.
POA for
Sender’s Post
Office
The POA then communicates the message to the MTA by way of TCP/IP, and
deletes the copy in the MTA input queue because the TCP/IP transfer to the
MTA was successful.
To see what happens if the TCP/IP link to the MTA is closed, see Section 2.2,
“TCP/IP Link Closed: Transfer between Post Offices Delayed,” on page 22.
MTA for
Local Domain
The MTA receives the message and places it into the MTA “in progress”
(
gwinprog ) queue.
MTA for
Local Domain
The MTA then communicates the message to the POA in the recipient’s post
office by way of TCP/IP. When the transmission is successful, the MTA deletes
the message from the MTA “in progress” queue.
If the TCP/IP link to the recipient’s post office is closed, the message is placed
in the closed post office’s holding queue in the MTA’s
mslocal directory for
later transfer. The resulting message flow is parallel to what occurs when a
domain is closed. See Section 3.2, “TCP/IP Link Closed: Transfer between
Domains Delayed,” on page 28 for a similar message flow that illustrates how
messages to closed locations are handled.