[Top] [Prev] [Next] [Bottom]




Post offices


The post office configuration details provide MAILsweeper with the information it needs to integrate into the host mail system. That is, how to access messages for processing and how to forward them on to their intended recipients.

Post office configuration details are found in:

The appropriate section is found in the post office configuration file for the host mail system.

The name of the post office configuration file reflects the name of the host mail system, that is, SMTP.CFG for SMTP systems, GRPWISE.CFG for GroupWise systems, NOTES.CFG for Lotus Notes systems, EXCHANGE.CFG for Exchange systems, CCMAIL.CFG for cc:Mail systems.

[PostOffices] section

The[PostOffices]configuration section determines the post offices MAILsweeper is to service for SMTP, GroupWise, Lotus Notes and Exchange mail systems.

Each directive in the section specifies the name of a post office and the name of the dynamic link library (.DLL) that holds the mail access code for the host mail system.

For example (SMTP access):

[PostOffices]
SMTP=SMAWNT

This example specifies that there is one post office called SMTP and that the code for accessing it is in SMAWNT.DLL.

Another example is (GroupWise access):

[PostOffices]
domain1=GWAWNT
domain2=GWAWNT

This example specifies that there are two post offices called domain1 and domain2 and that the code for accessing them is in GWAWNT.DLL.

Another example is (Lotus Notes access):

[PostOffices]
Server=NMAWNT

This example specifies that there is one post office called Server and that the code for accessing it is in NMAWNT.DLL.

Another example is (Exchange access):

[PostOffices]
Exchange=EXCWNT

This example specifies that there is one post office called Exchange and that the code for accessing it is in EXCWNT.DLL.

For GroupWise there must be two post offices defined. For SMTP, Lotus Notes and Exchange there must be only one.

Each post office defined in this way must have its own configuration section in the same configuration file as the [PostOffices] section. The name of the section must be the same as the name of the post office.

For example (SMTP access):

[SMTP]
ContainerClass=Container
MailDomain=example.com
SourceDir=C:\MSW\INTERNET\PENDING\
DestDir=C:\MSW\INTERNET\INCOMING\
SpoofThreshold=10
;Timezone=+0000
For an explanation of the directives used to configure an SMTP post office see page 7-51.

Another example is (GroupWise access):

[domain1]
Location=C:\DOMAIN1\WPGATE\API\
WorkDir=C:\TEMP\

[domain2]
Location=C:\DOMAIN2\WPGATE\API\
WorkDir=C:\TEMP\
For an explanation of the directives used to configure a GroupWise post office see page 7-53.

Another example is (Lotus Notes access):

[Server]
Configuration of a Lotus Notes post office requires no directives.

Another example is (Exchange access):

[Exchange]
Profile=MAILsweeper
ClearInterceptOnShutdown=FALSE
MailboxCheckInterval=15
For an explanation of the directives used to configure an Exchange post office see page 7-54.

[PostOfficeGroups] section

The[PostOfficeGroups]configuration section determines the post office groups MAILsweeper is to service for cc:Mail systems.

For a standard cc:Mail configuration (see the diagram on page 2-77) this section will comprise one post office group only.

For example:

[PostOfficeGroups]
Group1

For a hub configuration (see the diagram on page 2-79) the section will comprise two or more post office groups.

For example:

[PostOfficeGroups]
Group1
Group2
During installation only one post office group can be named, regardless of the configuration (standard or hub). For a hub configuration you will have to add the remaining groups manually, after the installation is complete. See page 2-99 for details.

Each group defined in the [PostOfficeGroups]section must have its own configuration section in the same file. The name of the section must be the same as the name of the group.

For example:

[Group1]
Inside=CCAWNT
Hub1=CCAWNT

[Group2]
Outside=CCAWNT
Hub2=CCAWNT

Each directive in the configuration section specifies the name of a post office and the name of the dynamic link library (.DLL) that holds the mail access code for the host mail system.

The example on the previous page indicates that there are two post offices in each group and that the code for accessing them is in CCAWNT.DLL.

For cc:Mail there must be two post offices defined in each group. There is no limit on the number of groups that can be defined. However, this should be a realistic number, based on the machine power and workload.

Each post office defined in the group must have its own configuration section in the same file as the [PostOfficeGroups] section. The name of the section must be the same as the name of the post office.

For example:

[Inside]
Location=C:\MSW\CCMPO_EG\INSIDE\
MailBox=Hub1
Password=MSW
ProcessReadMessages=TRUE

[Hub1]
Location=C:\MSW\CCMPO_EG\HUB1\
Mailbox=Inside
Password=MSW
ProcessReadMessages=TRUE
For an explanation of the directives used to configure a cc:Mail post office see page 7-50.

Configuration directives

The directives used to configure a post office are dependent on the host mail system (cc:Mail, SMTP, GroupWise, Lotus Notes and Exchange). These directives are explained in the following four sections.

cc:Mail

Configuration of a cc:Mail post office requires three directives. These are:

A fourth optional directive may also be included:

For example:

[Inside]
Location=C:\MSW\CCMPO_EG\INSIDE\
MailBox=Hub1
Password=MSW
ProcessReadMessages=TRUE

The Location directive specifies the path to the post office directory. This is the directory that holds the database files for the post office.

The MailBox directive specifies the name of the mail box that holds messages destined for the other post office in the group.

The Password directive specifies the password for mail box given in the MailBox directive.

The optional directive ProcessReadMessages specifies whether messages waiting to be processed are still accepted by MAILsweeper if a user has logged in to the post office account and read the message. This directive can have the value TRUE or FALSE. The default value is TRUE meaning that messages which have been read shall still be processed.

SMTP

Configuration of an SMTP post office requires six directives. These are:

For example:

[SMTP]
ContainerClass=Container
MailDomain=example.com
SourceDir=C:\MSW\INTERNET\PENDING\
DestDir=C:\MSW\INTERNET\INCOMING\
SpoofThreshold=10
;Timezone=+0000

The ContainerClass directive is required in this section. This is because the SMTP .DLL does first level decomposition of the message.

See page 7-59 for more details on the ContainerClass directive.

The MailDomain directive specifies the home DNS domain for the MAILsweeper SMTP server. This is used as the default domain for any messages received that have addresses with no domain information.

The SourceDir directive specifies the path to the directory where the SMTP receiving service (SMTPRS) places messages awaiting processing by MAILsweeper.

The DestDir directive specifies the path to the directory where MAILsweeper places messages ready for onward delivery. This is where the SMTP delivery service (SMTPDS) collects messages for delivery.

The SpoofThreshold directive specifies the threshold value used to determine possible message spoofing. The minimum threshold value that can be specified is 10, the maximum is 30. Default is 10.

For details on how MAILsweeper can be configured to identify possibly spoofed messages, and how the spoof threshold is calculated, see page 5-15.

The Timezone directive is used to specify a string indicating the time differential from GMT (UTC). The string specified is appended to the date field of the message.

The value of this directive is:

+/-hhmm

where + indicates ahead, that is, the East and - indicates behind, that is, the West. hhmm is a time , specified in 24 hour clock.

By default, this directive is commented out. In this case, MAILsweeper uses the local time zone, set via the Date/Time icon on the Control Panel.

If you wish to specify a time differential, edit the [SMTP] configuration section to ensure that the Timezone directive is no longer commented out. Then replace the default value with the time differential.

For example, change:

[SMTP]
...
;Timezone=+0000

to

[SMTP]
...
Timezone=-0500

The above example will append -0500 to the date field of the message, indicating that it is 5 hours behind GMT.

GroupWise

Configuration of a GroupWise post office requires two directives. These are:

For example:

[domain1]
Location=C:\DOMAIN1\WPGATE\API\
WorkDir=C:\TEMP\

The Location directive specifies the path to the API gateway directory. This is the directory that contains the subdirectories, API_IN, API_OUT, ATT_IN and ATT_OUT.

The WorkDir directive specifies the path to a working directory used to create temporary files. This is usually the system temp directory.

Lotus Notes

Configuration of a Lotus Notes post office requires no directives.

For example:

[Server]

Exchange

Configuration of an Exchange post office requires three directives. These are:

For example:

[Exchange]
Profile=MAILsweeper
ClearInterceptOnShutdown=FALSE
MailboxCheckInterval=15

The Profile directive specifies the name of the MAPI profile that MAILsweeper uses to log on to the Exchange Server. The profile includes information such as the name of the Exchange Server MAILsweeper is to connect to and the name of a mailbox on the Server. This profile must be defined on the PC on which MAILsweeper is running.

The default configuration specifies the profile that is entered during installation, see page 2-172 for details.

The ClearInterceptOnShutdown directive specifies whether MAILsweeper should remove the mail intercept when the MAILsweeper service is stopped. This directive can have the value TRUE or FALSE. Default value is FALSE, meaning that the intercept is not removed and consequently mail cannot get through until the MAILsweeper service is restarted. TRUE means that the intercept is removed and mail will get through, however this mail is not checked by MAILsweeper.

You must always remove the intercept before uninstalling MAILsweeper. If you do not, mail will subsequently not be able to pass through the Exchange Server. See page 2-182 for more details on the uninstall process.

The MailboxCheckInterval directive specifies the frequency, in minutes, that MAILsweeper checks for new mailboxes. The default value is 15, meaning that MAILsweeper will check for new mailboxes every 15 minutes.

If you add a new mailbox while MAILsweeper is still running there will be a period during which mail for that user is not scanned, that is, until the next check for new mailboxes is made. For this reason, it is advised that you stop MAILsweeper before adding new mailboxes. These mailboxes will then be detected immediately when MAILsweeper is restarted. See page 6-4 for more details on starting and stopping the MAILsweeper service.



[Top] [Prev] [Next] [Bottom]



msw.support@mimesweeper.com

Copyright © 1998, Content Technologies Limited. All rights reserved.