dovecot - Sep 2014 - "doveadm backup/sync" are badly documented

Most documents around there talk abour "dsync", but the modern way is
"doveadm backup". This command is not documented in the wiki and there
are a few details missing, like how to use it thru SSH.

I am currently doing some tests about how to backup my mdbox. I can do
tests in local using:

$ doveadm backup -u jcea -m proveedores/dovecot mdbox:/tmp/aa/

This will "backup" this mailing list mailbox to "/tmp/aa".
Good. Lets
try thru SSH:

$ doveadm backup -u jcea  -m proveedores/dovecot ssh 127.0.0.1 dsync -u
jcea mdbox:/tmp/aa/
jcea at 127.0.0.1's password:
Fatal: Invalid parameter: mdbox:/tmp/aa/
dsync-local(jcea): Error: read(remote) failed: EOF (version not received)

How shoudl I do it?.

$ doveadm backup -h
backup: invalid option -- 'h'
doveadm backup [-u <user>|-A] [-S <socket_path>] [-dfR] [-l
<secs>] [-r
<rawlog path>] [-m <mailbox>] [-n <namespace> | -N] [-x
<exclude>] [-s
<state>] <dest>

I can't find any explanation at all about the different parameters of
"doveadm backup".

Same thing with "doveadm sync".

-- 
Jes?s Cea Avi?n                         _/_/      _/_/_/        _/_/_/
jcea at jcea.es - http://www.jcea.es/     _/_/    _/_/  _/_/    _/_/  _/_/
Twitter: @jcea                        _/_/    _/_/          _/_/_/_/_/
jabber / xmpp:jcea at jabber.org  _/_/  _/_/    _/_/          _/_/  _/_/
"Things are not so easy"      _/_/  _/_/    _/_/  _/_/    _/_/  _/_/
"My name is Dump, Core Dump"   _/_/_/        _/_/_/      _/_/  _/_/
"El amor es poner tu felicidad en la felicidad de otro" - Leibniz

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 473 bytes
Desc: OpenPGP digital signature
URL:
<http://dovecot.org/pipermail/dovecot/attachments/20140928/995c56c2/attachment.sig>

On 28/09/14 23:52, Jesus Cea wrote:
[..]
> This will "backup" this mailing list mailbox to
"/tmp/aa". Good. Lets
> try thru SSH:
> 
> $ doveadm backup -u jcea  -m proveedores/dovecot ssh 127.0.0.1 dsync -u
> jcea mdbox:/tmp/aa/
> jcea at 127.0.0.1's password:
> Fatal: Invalid parameter: mdbox:/tmp/aa/
> dsync-local(jcea): Error: read(remote) failed: EOF (version not received)
> 
> How shoudl I do it?.
Trying a few things I got here, that works:

$ doveadm -o mail_fsync=never -o mdbox_rotate_interval=99d -o
mdbox_rotate_size=10M -o mail_attachment_dir=/tmp/aa/attachments -o
mail_attachment_min_size=64k -o mail_attachment_hash=%{sha256} -o
mail_location=mdbox:/tmp/aa/:DIRNAME=XxX backup  -m 'varios/nosotros' -R
 ssh 127.0.0.1 doveadm dsync-server

Two things:

1. I am connecting to myself thru SSH. I want to do a copy of my mdbox
with a different configuration. I was not able to transfer that
configuration change to thru SSH, so I just reverse the data flow
direction (The "-R"): just connect to the regular mailbox_location and
bring data here to be stored with a different configuration. This was a
kind of enlightment.

2. You must do "ssh 127.0.0.1 doveadm dsync-server" instead of simply
"ssh 127.0.0.1" because you would get this error:

bash: dsync-server: command not found
dsync-local(jcea): Error: read(remote) failed: EOF (version not received)
dsync-local(jcea): Error: Remote command returned error 127: ssh
127.0.0.1 dsync-server

I guess dovecot is sending the legacy "dsync-server" instead of the
current "doveadm dsync-server".

LOOKS LIKE THAT IS A BUG!!.
> $ doveadm backup -h
> backup: invalid option -- 'h'
> doveadm backup [-u <user>|-A] [-S <socket_path>] [-dfR] [-l
<secs>] [-r
> <rawlog path>] [-m <mailbox>] [-n <namespace> | -N] [-x
<exclude>] [-s
> <state>] <dest>
> 
> I can't find any explanation at all about the different parameters of
> "doveadm backup".
Please, document.
> Same thing with "doveadm sync".
-- 
Jes?s Cea Avi?n                         _/_/      _/_/_/        _/_/_/
jcea at jcea.es - http://www.jcea.es/     _/_/    _/_/  _/_/    _/_/  _/_/
Twitter: @jcea                        _/_/    _/_/          _/_/_/_/_/
jabber / xmpp:jcea at jabber.org  _/_/  _/_/    _/_/          _/_/  _/_/
"Things are not so easy"      _/_/  _/_/    _/_/  _/_/    _/_/  _/_/
"My name is Dump, Core Dump"   _/_/_/        _/_/_/      _/_/  _/_/
"El amor es poner tu felicidad en la felicidad de otro" - Leibniz

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 473 bytes
Desc: OpenPGP digital signature
URL:
<http://dovecot.org/pipermail/dovecot/attachments/20140929/b977ac99/attachment-0001.sig>