7.5 Internet Agent Queue Directory
The following directories and files are found under the \domain\wpgate\ structure for the Internet Agent after the software has been installed and the Internet Agent has processed messages.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
GroupWise Internet Agent home directory
|
|
|
|
|
|
|
7.5.1 domain\wpgate\gwia directory
The domain\wpgate\gwia directory is the GroupWise Internet Agent home directory where Internet Agent configuration files and queue directories are located. The name is established when you install the Internet Agent. The default is wpgate\gwia in the domain directory. You can change the location using the /home startup switch in the Internet Agent configuration file (gwia.cfg).
000.prc directory
The Internet Agent uses the 000.prc directory to process messages.
gwwork directory
The gwwork directory stores temporary files created by the Internet Agent as it converts and builds messages for transfer across the Internet.
mmddlog.nnn file
The mmddlog.nnn files hold error and status messages about the functioning of the Internet Agent. The Internet Agent creates a log file each day with a unique name, where mm is the month, dd is the day, and nnn is a sequential number indicating the sequence of log files in a single day. For more information log files, see Using Internet Agent Log Files
in Internet Agent
in the GroupWise 8 Administration Guide.
acct file
The acct file contains information about the messages the Internet Agent sends each day. It is e-mailed to the accounts each day at midnight. For more information about the accounting files, see Tracking Internet Traffic with Accounting Data
in Internet Agent
in the GroupWise 8 Administration Guide.
set file
The set file stores Internet Agent console settings such as color, log settings, and so on. For more information, see Using the Internet Agent Server Console
.
stat file
The stat file stores statistics about the Internet Agent’s functioning. For information about the statistics provided by the Internet Agent, see Statistics
in Internet Agent
in the GroupWise 8 Administration Guide.
proc file
The proc file is the lock file for the Internet Agent process. The proc file is opened and locked when the Internet Agent starts. This prevents multiple Internet Agents from being started for the same domain.
pulse.tmp file
The pulse.tmp file is re-created by the Internet Agent every time it completes a cycle (after an idle loop). If you are not at the Internet Agent console but need to know if the Internet Agent is running, you can delete the pulse.tmp file. If the Internet Agent is running, it re-creates the file.
wpcsin directory
For a mapped/UNC link, the Internet Agent places inbound messages in one of the wpcsin priority subdirectories (0-7). Most messages go in the 4 directory, although some administrative and status messages might go in other directories. The Message Transfer Agent retrieves the messages and delivers them to the proper destinations.
For a TCP/IP link, the Internet Agent and the MTA communicate by way of TCP/IP rather than by transferring message files. For a comparison, see Section 4.0, Message Delivery to and from the Internet.
wpcsout directory
For a mapped/UNC link, the wpcsout directory is the MTA output queue as well as being the Internet Agent input queue.
For a TCP/IP link, the Internet Agent and the MTA communicate by way of TCP/IP rather than by transferring message files. For a comparison, see Section 4.0, Message Delivery to and from the Internet.
gwixxxx directory
The gwixxxx directory is a system-defined directory, where gwi represents the first three letters of the Internet Agent object name as defined during installation and displayed in ConsoleOne, and xxxx is a randomly-generated string. Here, the Message Transfer Agent places outbound messages in the appropriate 0-7 priority subdirectory for the Internet Agent to retrieve and process.
problem directory
The problem directory holds messages that the MTA cannot process.
You should check this directory periodically for problem files, resolve the problem, then place the files back into the appropriate queue for continued processing. For assistance, see Message Is Dropped in the problem Directory in the Domain
in Strategies for Message Delivery Problems
in the GroupWise 8 Troubleshooting 2: Solutions to Common Problems.
gwhold directory
The gwhold directory holds messages that are scheduled for delayed delivery.
qfiles directory
The qfiles directory holds messages that cannot be sent during the current Send/Receive cycle. The messages are queued to this directory until the next cycle.
The delayed delivery messages waiting in the qfiles directory remain in encrypted format until the Internet Agent transfers them to the send directory for processing by the SMTP service.
gwprob directory
The Internet Agent uses the gwprob directory for messages it cannot process. These are usually messages that have been damaged during transmission or that contain incorrectly formed MIME data.
These messages cannot be recovered. You can delete them to conserve disk space.
gwchars directory
This directory contains conversion tables that the Internet Agent uses to convert message attachments between character sets.
save directory
If you reinstall or upgrade the Internet Agent, your old configuration files are copied to the save directory as a backup. If you reinstall or upgrade repeatedly, the files are overwritten each time.
gwia.cfg file
The gwia.cfg file is the Internet Agent configuration file that contains startup switches. Some switches are set during installation. You can set others as needed. For more information, see Using Internet Agent Startup Switches
in Internet Agent
in the GroupWise 8 Administration Guide.
|
NetWare: |
The NetWare Internet Agent uses the gwia.cfg file created in sys:\system during installation. The gwia.cfg file under the domain is just a boilerplate file with no switches set during installation. |
|
Linux: |
The Linux Internet Agent uses the gwia.cfg file created in /opt/novell/groupwise/agents/share during installation. The gwia.cfg file under the domain is just a boilerplate file with no switches set during installation. |
|
Windows: |
Only the Windows Internet Agent actually uses the gwia.cfg file under the domain. |
route.cfg file
The route.cfg file enables you to customize routing for specific hosts. For more information, see Using a Route Configuration File
in Internet Agent
in the GroupWise 8 Administration Guide.
gwauth.cfg file
The gwauth.cfg file enables the Internet Agent to log in to SMTP hosts that require authentication. For more information, see SMTP Host Authentication
in Internet Agent
in the GroupWise 8 Administration Guide.
mimetype.cfg file
The mimetype.cfg file enables you to customize MIME content-type mappings for various attachment types. For more information, see Customizing MIME Content-Type Mappings
in Internet Agent
in the GroupWise 8 Administration Guide
exepath.cfg file
The exepath.cfg file is used by ConsoleOne to locate the gwia.cfg file. This enables ConsoleOne to write any configuration setting changes to the gwia.cfg file or update Novell eDirectory with any changes from the file. The file must contain the path to the gwia.cfg file in the sys:\system directory on NetWare, the /opt/novell/groupwise/agents/share directory on Linux, or the domain\wpgate\gwia directory on Windows.
frgnames.cfg file
The frgnames.cfg file lets you list more Internet domain names than can fit in the field on the Identification page of the Internet Agent object in ConsoleOne. For more information, see Configuring How the Internet Agent Handles E-Mail Addresses
in Internet Agent
in the GroupWise 8 Administration Guide.
xspam.cfg file
The xspam.cfg file lists “X” header fields that your anti-spam service writes to the MIME header, along with the values that flag the message as spam. The Internet Agent examines the MIME header for any field listed in the xspam.cfg file. When a match occurs, the message is marked for handling by the GroupWise client Junk Mail Handling feature. For more information, see Customized Spam Identification
in Internet Agent
in the GroupWise 8 Administration Guide.
gwac.db file
The gwac.db file is the access control database that stores information about the classes of service you have created. For more information, see Maintaining the Access Control Database
in Internet Agent
in the GroupWise 8 Administration Guide.
gwac.dc file
The gwac.dc file is the data dictionary file from which the gwac.db is created.
preamble.txt file
The preamble.txt file is an ASCII text file that is automatically included with any MIME multipart message and is displayed when the message recipient lacks a MIME-compliant mail reader. For more information, see Customizing MIME Preamble Text
in Internet Agent
in the GroupWise 8 Administration Guide.
preamble.all file
The preamble.all file contains the preamble text in multiple languages. For more information, see Customizing MIME Preamble Text
in Internet Agent
in the GroupWise 8 Administration Guide.
blocked.txt file
The blocked.txt file contains a list of Internet sites that you have added to the Prevent Messages From list for your default class of service in ConsoleOne. For more information, see Controlling User Access to the Internet
in Internet Agent
in the GroupWise 8 Administration Guide.
statusxx.xml file
The statusxx.xml file enables you to customize the messages that users receive regarding message delivery status. For more information, see Customizing Delivery Status Notifications
in Internet Agent
in the GroupWise 8 Administration Guide.
7.5.2 gwia directory
The gwia directory is the SMTP service (daemon) home directory where messages are converted between GroupWise format and Internet format. On NetWare and Linux, the default location is wpgate/gwia, the same as the Internet Agent home directory. On Windows, the default location is the Internet Agent installation directory. You can change the location using the /dhome startup switch in the Internet Agent configuration file (gwia.cfg).
send directory
The Internet Agent SMTP service places outbound messages in the send directory after they have been converted out of GroupWise format into SMTP format. The SMTP service polls the send directory and sends any messages to the destination SMTP host.
receive directory
The Internet Agent SMTP service places inbound messages in the receive directory, converts them into GroupWise format, and then passes them to the Message Transfer Agent by placing them in the wpcsin directory.
result directory
When the Internet Agent SMTP service processes the message, it builds a file, r*.*, in the result directory that contains several lines of comments and SMTP reply codes, which might indicate possible errors or confirm correct transmission. After the Internet Agent SMTP service has completed the transmission with the destination host, it moves another file, s*.* from the send directory to the result directory. The filenames for both files are identical, except for the first letter, which is either “s” or “r”. The s*.* file is the converted message file. The SMTP service looks at the “s” and “r” files in the result directory and compares the conversation. If the r*.* file contains the correct (250 OK) SMTP reply codes, the SMTP service deletes the file and sends a transferred status message to the user’s Sent Items folder in the GroupWise client.
defer directory
The defer directory holds messages that are deferred and re-queued according to the Retry Schedule. If the Internet Agent SMTP service receives a temporary error, such as Host Down, it places the message in the defer directory for a specified time, then transfers the file to the send directory for another attempt at sending to the Internet. For more information, see Configuring Basic SMTP/MIME Settings
in Internet Agent
in the GroupWise 8 Administration Guide.
dsnhold directory
The dsnhold directory stores header information for inbound messages that request delivery status notifications. For more information, see Using Extended SMTP (ESMTP) Options
in Internet Agent
in the GroupWise 8 Administration Guide.