This project reads a Lotus Domino iNotes 8.5 webmail and exports the data as POP3(S), mbox and/or maildir.
SEO keywords: IBM Lotus Notes Domino iNotes POP3 mbox maildir export
This is a command-line application. For a web front-end, see iNotes-exporter-web. For exporting local email .nsf files, see NSF-exporter.
- Lotus iNotes (the Lotus Notes webmail) credentials (tested with version 8.5.3)
- Java 6
- Maven 3 for compiling
Personal credentials and preferences: src/main/resources/iNotes.properties (can be overriden on command-line: -D<key>=<value>)
logging: src/main/resources/simplelogger.properties
If you need to use an HTTP/SOCKS proxy, you can also use the usual Java Networking System properties.
(after configuration!)
mvn -Dmaven.test.skip clean assembly:single
In addition to exposing a Notes INBOX as a POP3 server, iNotes exporter supports exporting either 1 mailbox or all Notes server emails, to different formats:
- single mailbox
mbox: traditional UNIX mailbox format; single file contains multiple messages.
Multiple variants exist:mboxo(deprecated)mboxrdMMDF
maildir: one file contains one message
- multiple mailboxes
MH(deprecated)EMLmaildir++
java [-Dinotes.server=...] [-Dnotes.user=...] [-Dnotes.password=...] -jar target/iNotes-exporter-1.8-jar-with-dependencies.jar listfolders
java [-Dinotes.server=...] [-Dnotes.user=...] [-Dnotes.password=...] -jar target/iNotes-exporter-1.8-jar-with-dependencies.jar quota
java [-Dinotes.server=...] [-Dnotes.user=...] [-Dnotes.password=...] [-Dnotes.folder.id=($Inbox)] -jar target/iNotes-exporter-1.8-jar-with-dependencies.jar (mboxrd|maildir) <output_file|output_dir> [start date: yyyy-MM-dd'T'HH:mm [end date: yyyy-MM-dd'T'HH:mm [--delete]]]
where
<output_file>will be overwritten if no start date is given. Otherwise, the newest email data is appended to it.yyyy-MM-dd'T'HH:mmis the date of the oldest message to export- if none provided, and
output_filedoes not exists, exports all messages - if none provided, and
output_fileexists, do an incremental export since last time this tool was run
- if none provided, and
yyyy-MM-dd'T'HH:mmis the date of the newest message to export--delete: delete messages from the Notes server after exporting
examples:
java -jar target/iNotes-exporter-1.8-jar-with-dependencies.jar maildir ~/Maildir 2012-01-20T20:00- will export all messages after 2012-01-20T20:00 from iNotes server's INBOX to the
~/Maildirmaildir
- will export all messages after 2012-01-20T20:00 from iNotes server's INBOX to the
java -jar target/iNotes-exporter-1.8-jar-with-dependencies.jar mboxrd ~/archive_2012.gz 2012-01-01T00:00 2013-01-01T00:00 --delete- will export all 2012 messages from iNotes server's INBOX to the (compressed)
~/archive_2012.mboxrd.gzmailbox file, deleting messages from the server
- will export all 2012 messages from iNotes server's INBOX to the (compressed)
If you don't know which mbox format to choose (mboxo, mboxrd, mboxcl, mboxcl2, MMDF, maildir), use mboxrd.
Specifying a .gz extension for a mailbox file name is specifically made for Dovecot which can read compressed mbox archives.
Please note that any kind of export to an existing compressed mbox is not allowed, as this would corrupt the mbox file!
The (incremental) last export date is stored in the Java Preferences (~/.java/ for Linux / *BSD, ~/Library/Preferences/fr.cedrik.inotes.plist for Mac OS X, and the Registry for Windows).
If running unattended, please have a process monitor the output for all ERROR's that could occur!
java [-Dinotes.server=...] [-Dnotes.user=...] [-Dnotes.password=...] -jar target/iNotes-exporter-1.8-jar-with-dependencies.jar maildirpp <output_dir>
example:
java -jar target/iNotes-exporter-1.8-jar-with-dependencies.jar maildirpp ~/Maildir- will (incrementally) export all messages to the
~/Maildirmaildir++
- will (incrementally) export all messages to the
If you don't know which maildir format to choose (MH, EML, maildir++), use maildir++.
The (incremental) last export date is stored in the Java Preferences (~/.java/ for Linux / *BSD, ~/Library/Preferences/fr.cedrik.inotes.plist for Mac OS X, and the Registry for Windows).
If running unattended, please have a process monitor the output for all ERROR's that could occur!
java [-Dpop3.port=110] [-Dpop3.shutdown=now!] [-Dinotes.server=...] [-Dnotes.folder.id=($Inbox)] -jar target/iNotes-exporter-1.8-jar-with-dependencies.jar pop3server
Use as pop3 user login: username@https://webmail.example.com
This POP3 server has a user and IP lock out mechanism if there are too many failed authentication attempts in a given period of time. It achieves this by recording all failed logins, including those for users that do not exist. To prevent a DOS by deliberating making requests with invalid users (and hence causing this cache to grow) the size of the list of users and IPs that have failed authentication is limited. (Configurable in iNotes.properties)
POP3 communication is clear-text. For extra security, you can add an SSL/TLS transport to POP3.
You will need to generate and configure a certificate. For example:
$JAVA_HOME/bin/keytool -genkey -alias pop3s -keyalg RSA -keysize 2048 -validity 3650 -keystore /opt/iNotes-keystore -storepass b92kqmp -keypass changeit -dname "cn=<your_FQN_server_name>, o=cedrik.fr, l=Paris, s=Ile-de-France, c=FR"
which will then be configured in iNotes.properties as:
pop3s.port=995
pop3s.keyStoreName=/opt/iNotes-keystore
pop3s.keyStorePassword=b92kqmp
pop3s.keyStoreType=jks
pop3s.keyPassword=changeit
As an alternative to configuring POP3S, you can also use stunnel.
Note: to disable the POP3 connector and only keep the secure POP3S version, set pop3.port=-1.
The following POP3 commands are not RFC standard, but can help manage your iNotes account:
SHUTDOWN <secret>: to shutdown the POP3 server (set the secret iniNotes.properties)QUOTA: gives information on quota usageFOLDER: list available iNotes foldersFOLDER <id>: change current folderLOGGER: get loggers levelsLOGGER <logger_id> <level>: set logger level
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent