Hexamail Guard Configuration Reference [Users]

[Users]

The following settings can be used in this section:

CompactUsers
User compaction automatically clears up any free space during quiet periods
bool
On/Off, True/False, Yes/No, 1/0
On
CompactUsers=On
CacheSize
User store cache size in MBytes
int
200 mbytes
CacheSize=200
ADCache
Cache ADSI password check results to prevent login issues on ADSI connectivity failures
bool
On/Off, True/False, Yes/No, 1/0
true
ADCache=false
RoutesInExpireDays
This setting controls when to expire inbound route information from the database
int
30 Days
RoutesInExpireDays=90
RoutesOutExpireDays
This setting controls when to expire outbound route information from the database. Use 0 to never expire outbound routes.
int
300 Days
RoutesOutExpireDays=90
Routes
This allows collection of email route information for all email. This will increase the RAM and disk usage and will be a little slower.
on
Routes=on
Autowhite
This collects outbound email route information for use in autoallowlisting. This will increase the RAM and disk usage and will be a little slower.
on
Autowhite=on
StatsRoute
This allows collection of time-based statistics for every email route detected. This will increase the RAM and disk usage of the statistics collected and will be a little slower. For each route stats are collected for the quarterly, weekly and daily count, size, attachment count and attachment sizes. This can be up to 0.5GB for 200,000 routes.
off
StatsRoute=off
StatsAttach
This allows collection of attachment count and size statistics. This involves processing the MIME of every email so can be a little slower.
off
StatsAttach=off
ImportDomain
text
ImportMachine
If Active Directory is on the same machine as Hexamail try localhost as the hostname. If this does not work try a blank hostname. If Active Directory is on another machine please specify the fully qualified network name of the machine. Be sure to APPLY your settings to allow users to login using their Active Directory passwords once imported.
text
localhost
ImportMachine=Exchangeserver1
ImportPort
By default the port is 0 as this specifies default port to the ADSI COM objects. Specify 389 to explicitly include the port in ADSI LDAP requests when this is necessary to resolve MS communications issues.
number
0
ImportPort=389
ImportBind
By default active directory connections bind to the RootDSE. You may want to change this to the default naming context in some circumstances with dsitrbuted or multiple active directory servers
text
RootDSE
ImportBind=RootDSE
ImportPartition
By default active directory connections use the domain partition. You may want to change this to a different parition in some circumstances with dsitrbuted or multiple active directory servers
text
ImportAdmin
text
ImportPass
encryptedtext
ImportFilter
text
(&(|(objectClass=user)(objectClass=contact)(objectClass=publicFolder)(objectClass=Group))(!(cn=HealthMailbox*))(!(cn=SystemMailbox*)))
ImportFilter=(|(objectClass=user)(objectClass=contact))
ImportLDAPBase
text
ImportLDAPMachine
text
ImportLDAPMachine=Exchangeserver1
ImportLDAPPort
number
389
ImportLDAPPort=389
ImportLDAPAdmin
text
ImportLDAPPass
encryptedtext
ImportLDAPFilter
text
(mail=*)
ImportLDAPFilter=(mail=*)
ImportFile
text
ImportFileColumns
text
username,email,description,aliaslist
ImportFileColumns=username,email,description,aliaslist
ImportDeduplicate
bool
On/Off, True/False, Yes/No, 1/0
On
ImportDeduplicate=On
ImportRemoveUsers
bool
On/Off, True/False, Yes/No, 1/0
Off
ImportRemoveUsers=Off
ImportSkipNoEmail
bool
On/Off, True/False, Yes/No, 1/0
On
ImportSkipNoEmail=On
ImportCSVSchedule
Use this setting to enable automatic scheduled synchronization of the users from a CSV file.
bool
On/Off, True/False, Yes/No, 1/0
off
ImportCSVSchedule=off
ImportCSVScheduleMinutes
You can specify how often to attempt to import the csv file. If the file is not present the import will be retried after 1 minute. If the file is still being written when the import is attempted, the import will be retried once the file has stopped changing size.
number
1 - 360 minutes
60 minutes
ImportCSVScheduleMinutes=60
ImportCSVSchedulePath
In order to schedule import from a CSV file you must specify the SERVER path to the file. The file must be accessible to the server software, and the path specified should be an absolute path to the csv file.
text
ImportADIRSchedule
Use this setting to enable automatic scheduled synchronization of the users from the configured active directory server.
bool
On/Off, True/False, Yes/No, 1/0
off
ImportADIRSchedule=off
ImportADIRScheduleMinutes
number
1 - 360 minutes
60 minutes
ImportADIRScheduleMinutes=60
ImportLDAPSchedule
Use this setting to enable automatic scheduled synchronization of the users from the configured LDAP server.
bool
On/Off, True/False, Yes/No, 1/0
off
ImportLDAPSchedule=off
ImportLDAPScheduleMinutes
number
1 - 360 minutes
60 minutes
ImportLDAPScheduleMinutes=60
ImportFieldMap
You can configure Hexamail Guard to remap imported fields to user fields. This can be used for example to set the external POP/IMAP account download settings, or change the contact settings from their default mappings. In Exchange it is possible to add 15 custom attributes to an active directory mailbox, and these should be referred to using extensionAttribute1, extensionAttribute2 ... extensionattribute15 In Hexamail the following fields are used by the system and can be mapped to if required.
					phone			- Phone number for user
					office			- Office address
					mobile			- Mobile/Cellular number
					title			- Job Title
					dept			- Department
					company			- Company Name
					other			- Other field
					sigcustom		- Enable custom signature (on/off)
					sigcustomtext	- Custom sugnature text
					sigcustomhtml	- Custom sugnature html
					p3denableui		- Enable external account collection web interface (on/off)
					p3denable		- Enable external account collection (on/off)
					p3dexpiretime	- Expire email in external account (days)
					p3dname			- External account login username
					p3dpassword		- External account login password
					p3dserver		- External account server hostname or IP
					p3dssl			- External account ssl (on/off)
					p3dport			- External account port number
					p3dprot			- External account protocol (POP3/IMAP)
					p3daction		- External account action (Keep,Expire,Delete)
					p3dschedule		- External account schedule (minutes)
					p3dfolders		- External account IMAP folders to download
					fwd				- HEXAMAIL SERVER ONLY Enable forwarding for mailboxes (on/off)
					fwddeliver		- HEXAMAIL SERVER ONLY Also deliver forwarded mail to mailbox (on/off)
					fwdaddr			- HEXAMAIL SERVER ONLY SMTP email Address to forward to
					mboxquota		- HEXAMAIL SERVER ONLY Mailbox quota in megabytes
				
Other custom fields can be added just by mapping to a new unreserved name.
text
ImportFieldMap=extensionAttribute1:p3dserver extensionAttribute2:p3dport extensionAttribute3:userp3dname extensionAttribute4:userp3dpassword extensionAttribute5:p3dschedule extensionAttribute6:p3dexpiretime extensionAttribute7:anyfieldyouwant extensionAttribute8:anotherfield cn:CNInExchange
RouteGraphFilter
RouteGraphFilter=*@domain.com
RouteGraphAge
365
RouteGraphAge=365
RouteGraphFlags
0
RouteGraphFlags=0
RouteGraphMaxEdges
100
RouteGraphMaxEdges=100
RouteGraphMinCount
25
RouteGraphMinCount=25