#!/bin/cat
# $Id: FAQ.Domino.txt,v 1.13 2020/09/06 20:33:46 gilles Exp gilles $

This documentation is also available online at
https://imapsync.lamiral.info/FAQ.d/
https://imapsync.lamiral.info/FAQ.d/FAQ.Domino.txt


=======================================================================
               Imapsync tips for Domino.
=======================================================================

Questions answered in this FAQ are:

Q. How to use imapsync from Domino Notes to XXX?

Q. How to use imapsync from XXX to Domino Notes?

Q. Whan I use --maxage imapsync sees no messages at all.
   What can I do?

Q. My usual email software client like Thunderbird sees more messages
   than imapsync. How can it be possible?

Now the questions again with their answers:


=======================================================================
Q. How to use imapsync from Domino Notes to XXX?

R1. Use --domino1, like this:

  imapsync ... --domino1


R2. Or use the following options:

On Windows use:

  imapsync.exe ... --sep1 "\\" --prefix1 "" --messageidnodomain

On Unix use:

  imapsync ... --sep1 '\' --prefix1 '' --messageidnodomain

=======================================================================
Q. How to use imapsync from XXX to Domino Notes

R1. Use --domino2, like this:

  imapsync ... --domino2


R2. Or follow this:

Domino doesn't accept INBOX subfolders. 

On Windows:

  imapsync.exe ... ^
    --sep2 "\\" --prefix2 "" --messageidnodomain ^
    --regextrans2 "s,^Inbox\\(.*),$1,i"  

On Unix:

  imapsync ... \
    --sep2 '\' --prefix2 '' --messageidnodomain \
    --regextrans2 's,^Inbox\\(.*),$1,i'

If you want to sync the complete host1 mailbox in a subfolder called OLDBOX use:

On Windows:
  imapsync.exe ... ^
    --sep2 "\\" --prefix2 "" --messageidnodomain ^
    --subfolder2 "OLDBOX" --justfolders --dry

On Unix:
  imapsync ... \
  --sep2 '\' --prefix2 '' --messageidnodomain \
  --subfolder2 'OLDBOX' --justfolders --dry
    
If the output is correct for you then remove --dry and have a run.
Verify the folder hierarchy is good on host2 then remove --justfolders to
sync the messages.

For Domino with imapsync and Domino on Linux:
(Thanks to Zafer)

R. We've migrated about 5000 users from cyrus to lotus domino 853! 
Mails are being copied into the new created lotus domino mailbox 
retaining the existing folder structure from the old mail database.
This means that sent mails can be found in the sent folder and 
mails from the old inbox are copied into the new inbox
We also marked migrated mails with the header Migratedbyus

For Domino 853FP6 on Linux, we used this command on Unix:

  imapsync \
  --host1 hhh1  --user1 uuu1  --password1 ppp1 \
  --host2 hhh2  --user2 uuu2  --password2 ppp2 \
  --exclude "^INBOX/Trash"  --exclude 'Junk|Drafts' \
  --regextrans2 's#^INBOX/Sent$#^Sent#' \
  --prefix2 ""  --sep2 "\/" --messageidnodomain \
  --regexmess 's{\A(.*?(?! ^$))^Date:(.*?)$}{$1Migratedbyus:$2\nx-MailDate:$2}gxms'


=======================================================================
Q. When I use --maxage option, imapsync sees no messages at all.
   What can I do?

R. Use --noabletosearch

  imapsync ... --noabletosearch

Same thing with --minage

=======================================================================
Q. On Domino this errors occurs: 
   "Login failure, cannot convert Mailbox: code 02:46"

R. Follow
   https://atnotes.de/index.php?topic=44888.0

Use:

   load convert -e mail\mailfilename.nsf

=======================================================================
Q. My usual email software client like Thunderbird sees more messages
   than imapsync. How can it be possible?

R. (Issue given and solved by Falko Veith)
   "As you might know, it is possible to replicate databases, aka mailboxes,
   across domino servers. THAT is the explanation. Thunderbird and some Notes 
   clients may be connected to one server and imapsync to another.
   As funny and simply the solution is, as mysterious is why those two 
   databases are not completely in sync - new emails are replicated but not
   the old ones. One mystery solved - and a new one to go.

Thanks to Falko Veith for this question and the answer!

=======================================================================