Logo Twistround LTD  

Email Forwarding Service
Additional Information

Running Poprep using a Service Account:

By default poprep is running as Local System, but you can configure it to run using a service account either from the command line specifying a Username and Password together with the -install or -reinstall switches or using the MMC Services snapin.

If you configure it to run using a service account, you need to ensure it has got write access to all folders where it's configuration, logfiles and queues are stored. The preferred option is to make the service account a member of the PopRepAdmins group.

For more information about the PopRepAdmins group, see PopConf.

Running Poprep interactively:

PopRep is a service, but you can run it interactively from a command prompt. You would typically only do so if you are testing/troubleshoting a configuration and you quickly want to display additional information, for example what authentication protocols that are suported by a POP Server. For this you would use the -debug switch.

This is a list of all command line options supported:
 -install   </U:User </P:Pass>>  to install the service
 -reinstall </U:User </P:Pass>> to RE-install the service
 -Uninstall | -remove           to Uninstall the service
 -start                         to start the service
 -stop                          to stop the service
 -auto                          to set Startup to Auto
 -manual                        to set Startup to Manual
 -disabled                      to set Startup to Disabled
 -debug<:lvl>                   to run as a console app for debugging
 [-threads:num]                 specify max number of workerThreads
                                default is 1 when executed from cmd line 
 -help                          to display the help screen

Example, running poprep from a command line with full debug output displayed to the console:

poprep.exe -debug:9

When executed from the command line, the DebugLevel will be set to a minimum of 3 independent of what debug level that has been set at the command line, or through the admin console.


C:\Program Files\Twistround\Poprep
C:\Program Files\Twistround (x86)\Poprep

Data files (Windows 2000, XP, 2003):
C:\Documents and Settings\All Users\Application Data\Twistround\Poprep

Data files (Windows Vista, 2008):

Sample Folder Hierarchy:

    ¦       PopRep-Backup.xml
    ¦       Poprep.xml
    ¦       poprep-2007-06-01.log
            ¦   MailFilter.vbs
            ¦   Mails.tbl
            ¦   59c046e7-f2fb-431e-abe4-340ad1dacf17.eml

Configuration File:

The connector properties is stored in an XML file called, Poprep.xml. This file is stored in the folder .\Data\Config. It is recomended that this file is not manually modified, any changes should be made using the Admin Console. The Admin Console creates a backup copy of the configuraiton file, if you change the password used for storing the connector passwords. The backup file is called PopRep-Backup.xml.

Log Files:

The POPREP Service may create a daily log file, any log file is stored in the folder .\Data\Logs.

Connector Folder:

Every connector has got it's own folder used for temporary storage at .\Data\Queues\<Connector Name>. This folder also contains a transaction file used by the service to ensure that a specific mail item is only read once, and to keep a history of when the mail was recieved so that the service can remove the mail from the source mailbox after it's been sent. This folder is also the default location for any connector event script.

It is possible to change the location of all of these folders through settings in the registry.

Transaction file format:

Mails.tbl, MailsLog.tbl, Bad-Mail-Log.tbl

TimeStamp  Source MailboxMessageID           Status  Local Unique Identifier [FileName.eml]
========= ========================= ===== ================================
1203851894 AGe8ktkAAXlwR8FSBgFWYhAJ5ww  1      a4f1e7e9-c868-4b2f-beb6-dbba1dec01a8
1203869288 AGa8ktkAAUJgR8GWBgunehwSJCw  1      adb043a9-a6af-496c-83af-a14ebcae317e
1203935619 ABG8ktkAAPjlR8KWTAE69GQ3mE8  0      bf630393-44ae-4eb3-a9e4-a455d4b7b3ff

If you need to move any mail from the BadMail folder back to the queue then stop the service, move the mails back to the connector folder, and append the contents of the Bad-Mail-Log.tbl file to the MailsLog.tbl file, or if the MailsLog.tbl doesn't exist copy Bad-Mail-Log.tbl to MailsLog.tbl. Obviously, the only reason mails would have been moved to the bad mail folder is if you have an event script containing rules to detect unwanted mails. So unless you change the even script prior to starting the service the mails will simply be moved back to the badMail fodler again.

Registry Values:

A number of optional settings can be stored in the registry, typically you would never have to change these directly, but they are documented here:


Value Name: DataFolder
Type: REG_SZ
Description: Overrides the default root folder for configuration, log and connector files.

Value Name: QueueFolder
Type: REG_SZ
Description: Overrides the default root folder for connectors.

Value Name: LogFolder
Type: REG_SZ
Description: Overrides the default root folder for Log Files.

Value Name: ConfigFolder
Type: REG_SZ
Description: Overrides the default root folder for configuration files.

Value Name: LogLevel
Data: 2
Description: Allow you to configure how verbose you want the log file to be. Default log level is 2, Set to 0 if you want to disable logging.

Value Name: DebugLevel
Data: 0
Description: Allow you to enable verbose debug information to be sent to a user mode debugger. Default is 0, Debug info Disabled.

Value Name: WorkerThreads
Data: 10
Description: Allow you to configure how many connectors that poprep can poll concurrently. Valid number is 1 to 25, Default is 10. Increasing the number will increase the CPU utilization, so ensure you don?t overload the system by allowing more connectors to be polled than the system can cope with.