Domino Pop3 Quickstart[1]

POP3 Collect Quickstart Introduction Description:




The Domino addin task POP3Collect reads messages from one or more POP3 servers and sends them to an SMTP server (Domino, Exchange, Sendmail or any other compatible SMTP Server).

Updates:




The current version of this program is always available on http://NotesNet.CH (see Downloads/Demos). During startup, this program will also check if a newer version is available . This will be indicated with a message during initialization .

Prerequisites:





Lotus Domino 7.0 or higher (with the builtin Java VM) This Domino addin task is entirely written in Java and should therefore run on any Domino 7 (or higher) server platform and processor architecture supported by the Domino JVM .

Installation steps:




Create a new database on the target server from the template POP3Collect.ntf. The new database can have any name and can be placed on any data directory on the server . Open the newly created database and configure the Connections and Accounts documents. Detach the following two Java class files and copy them to the servers Domino program directory.

Installation





Upgrade steps:




Start the POP3Collect task with the console command or program document :




Load RunJava POP3Collect [Database] were Database is the path and name of the newly created configuration database . The default is POP3Collect.nsf. Please note that the Java task name POP3Collect is case sensitive. Terminate the tast POP3 Collect with Tell POP3Collect Shutdown . Make sure that no other







RunJava task is active on the server . This is necessary, because otherwise RunJava will have the Java class file still cached in memory . Replace the two Java class files and the POP3Collect.ntf files in the corresponding directories . Issue a database refresh design of your POP 3Collect configuration database. Verify the Connections and Accounts configuration documents. Restart the Domino POP3Collect addin task.

Notes Notes:
















Use Load RunJava POP3Collect -? and Tell POP3Collect -? for a help on the program arguments and usage. This addin checks for updates to the configuration database and will reload the configuration dynamically. The sending part is implemented as an SMTP connection (as opposed to a Notes/Domino NRPC connection) to avoid any message content conversion . This also allows to use this Domino addin in gateway scenarios, where the SMTP server is on any remote machine with any SMTP implementation. The STARTTLS command is currently (as of Domino 8.0.1) not supported for outgoing SMTP connections. As soon as IBM updates the JavaMail to 1.4 (or higher) in the Domino JVM, the STARTTLS function should be supported automatically . However, the standard SSL/TLS can still be used to encrypt SMTP connections . Since there is no support in the POP3 protocol of marking messages as read , this program implements the option of leaving message on the server by POP3 Checkpoint documents. To avoid out-of-memory errors in Java while processing large messages , you can increase the Java heap memory buffer by adding the following Notes .Ini variable on the Domino Server: JavaMaxHeapSize=xxxMB (Default is 64MB, recommended value is 256MB) Please send an email to [email protected] if you have any question, suggestion or if you have found a problem using this software .

Version History 0.8.0 - 07-Nov-2008





0.7.5 - 09-Apr-2008

New: Scheduling periods may be specified in the Connection documents to allow specific message scheduling times. New: Send an email to the administrator if a new POP3 Collect version is available. The recipient will be the first entry found in the Administators field of the server document (Security tab).





Update: Replace any invalid (non-RFC822) Internet address with "[email protected]" to avoid SMTP delivery failures. Add: Add RFC-822 header "X-POP3-Collect-Version" (POP3 Collect version number) Add: Add RFC-822 header "X-POP3-Collect-Date" (Processing date and time)

0.7.0 - 26-Mar-2008







Update: Create formal release and remove test time limit Update: Fix Java noSuchMethod Error under Domino 7.0 Update: Remove support for Domino 6.0/6.5 Update: New Notes 8 style program icon. Many thanks to Giorgio Toni for his work.

0.6.0 - 16-Mar-2008






Beta 5 (limited availability) - Expires 30/Apr/2008 New: Implement version update checking Update: Minor Notes user interface changes

0.5.0 - 15-Mar-2008







Beta 4 (limited availability) - Expires 30/Apr/2008 New: Added SSL/TLS support for POP3 and SMTP connections New: Implement POP3 Checkpoints to keep track of the last message read per POP 3 account Update: Notes user interface updated

0.4.0 - 27-Feb-2008




Beta 3 (limited availability) - Expires 31/Mar/2008

0.3.0 - 25-Feb-2008




Beta 2 (limited availability)

0.2.0 - 14-Feb.2008




Beta 1 (internal)

0.1.0 - 02-Feb-2008




Alpha (proof of concept)