**This is an old revision of the document!** ----
====== Email Collector ====== ===== Download ===== ===== Installation ===== Use the Module Management Tool to install the Email Collector. Information about how to do this can be found at: [[http://wiki.alfresco.com/wiki/Module_Management_Tool|Module Management Tool Guide]] The Module Management Tool can be downloaded [[http://sourceforge.net/project/showfiles.php?group_id=143373&package_id=157460&release_id=524558|here]]. ** Don't forget to create an email-collector.properties file as described in the next section of this manual. ** If this file is not available Alfresco will not start up. ===== Configuration ===== ==== Mailbox and check interval configuration ==== Mailboxes and how often they are checked is configured in the **email-collector.properties** file. This file must be present in the classpath of your server. For Tomcat: <tomcat-home>/shared/classes/alfresco/extension/email-collector.properties For JBoss: <jboss-home>/server/default/conf/alfresco/extension/email-collector.properties This is an example properties file: <code> # A single sample mailbox configuration. # Mailbox properties always start with 'mailbox'. The next term is some arbitrary name for the mailbox # in this case 'somebox'. The third term is the mailbox property name. mailbox.somebox.host=pop3.strato.de mailbox.somebox.protocol=pop3 mailbox.somebox.port=110 mailbox.somebox.folder=Inbox mailbox.somebox.user=mail@mycompany.de mailbox.somebox.password=mailpassword mailbox.somebox.ssl=false # the start delay of the Email Collector in milliseconds emailCollector.startDelay=5000 # the mailbox check interval of the Email Collector in milliseconds emailCollector.repeatInterval=300000 </code> The upper part of the configuration is the mailbox configuration. The mailbox Properties configure the mailbox. Mailbox properties always start with //mailbox//. The next term is some arbitrary name for the mailbox in this case //somebox//. The third term is the mailbox property name. All available properties can be seen in the example above. The properties //host//, //protocol//, //user// and //password// are required. If no //folder// is given, Inbox will be taken as the default folder. If no //port// is given the default port for the selected protocol will be taken. If no //ssl// property value is given then ssl will be disabled. ==== Email Service Configuration ==== To store emails into Alfresco the Email Collector uses the Alfresco in-built Email Service. Check the [[http://wiki.alfresco.com/wiki/Email_Server_Configuration|Email Server Configuration]] on how to configure the Email Service. You can skip the Email Server configuration part and start reading at the chapter 'How Email Messages are Handled'. ===== Troubleshooting ===== * If you experience the problem that some of your Email Aliases do not work check this [[http://forums.alfresco.com/en/viewtopic.php?f=9&t=13860&p=45596#p45596|forum entry]] * ERROR: //The Alfresco server is not configured to accept inbound emails.// You have to enable the Alfresco Email Service to accept incoming emails in alfresco/WEB-INF/classes/alfresco/emailserver/email-server.properties. Though the Alfresco email server may not be in use the Email Service used by the Email Collector has to be configured there.
