On May 10, 2017, at 10:18 AM, Sami Ketola sami.ketola@dovecot.fi wrote:
On 10 May 2017, at 15.06, KT Walrus kevin@my.walr.us wrote:
On May 10, 2017, at 9:50 AM, Sami Ketola sami.ketola@dovecot.fi wrote:
On 9 May 2017, at 19.26, KT Walrus kevin@my.walr.us wrote:
Is “doveadm save” an undocumented feature? Or, just well-hidden?
https://wiki2.dovecot.org/Tools/Doveadm https://wiki2.dovecot.org/Tools/Doveadm
That wikipage is autogenerated from the doveadm manpage… which unfortunately lags behind on the features. We’ll try to update the manpage eventually some day.
How long does this usually take? Googling the topic seems to indicate that this feature was implemented several years ago.
Seems that we have been quite busy on working on more important issues. Also it’s possible that we just forgot to update the manpage.
Thanks. I don’t mean to have you change your priorities, but it is difficult to really understand how to set up and use Dovecot with incomplete user documentation. For example, I had to search for a half hour to figure out how to set an API key to use with the Doveadm HTTP API. I finally noticed the single reference to ‘doveadm_api_key’ in the Design.DoveadmProtocol.HTTP.txt file. I should have noticed it much sooner, but I was looking in the example-config files for how to configure doveadm and couldn’t find its settings there. In fact, there should be a “How to configure doveadm” page.
I also have plans to deploy using 3 server clusters. Maybe it isn’t a good idea, but I haven’t really found much on how to set up a 3 server cluster that keeps the local storage sync’d between all 3 servers. Maybe this is obvious to most, but the documentation only really goes into depth on how to dsync 2 servers. I guess it is natural to expect to just set up 3 servers with each server dsync’ing to the 2 other servers in the cluster, but I worry that this might not work best in production and I should look into using converged storage so each server in the cluster has read/write access to the converged storage and I make sure that no 2 servers access the same mailbox at the same time.
I want to deploy in 3 server clusters since this is the way we deploy MySQL database clusters and this works well in production. But, maybe, for Dovecot, 2 server clusters is enough for production and going to 3 servers is just a waste of money. We do not use RAID storage on our local servers preferring to use replication to 3 separate servers in 3 separate racks to take care of the occasional hardware failures. So, the general rule is that all persistent data is replicated 3 times. Maybe, for Dovecot, we should deploy 2 server clusters with btrfs/rsync backup to a third backup only server.
Anyway, I’m highjacking my own thread in discussing these production issues, but maybe you and your team could consider bumping up the priority on documentation just a bit in the future…
Thanks again,
Kevin