doveadm rmb plugin

doveadm rmb

Name

doveadm rmb - dovecot ceph plugin administration utility

Synopsis

doveadm [-Dv] [-f formatter] rmb command [command_options] [command_arguments]

Description

doveadm rmb is the Dovecot Ceph storage plugin administration utiltiy, which basically wraps the rmb cli commands, but also provides access to the index management of Dovecot. Execute doveadm rmb for a command usage listing.

Options

-D

Enables verbosity and debug messages.

-f formatter

Specifies the formatter for formatting the output. Supported formatters are:

flow

Prints each line with key=value pairs

pager

Prints each key value pair on its own line and separates records with from feed character.

table

Prints a table header fallowed by adjusted value lines

-o setting=value

Overrides the configuration setting from /etc/dovecot/dovecot.conf and from the userdb with the given value. In order to override multiple settings, the -o option may be specified multiple times.

-v

Enables verbosity, including progress counter.

Command specific options:

-u user/mask

Run the command only for the given user. It’s also possible to use '*' and '?' wildcards (e.g. -u *@example.org). When neither the -A option, nor the -F file option, nor the -u user was specified, the command will be executed with the environment of the currently logged in user.

-S socket_path

The option’s argument is either an absolute path to a local UNIX domain socket, or a hostname and port (hostname:port), in order to connect a remote host via a TCP socket.
This allows an administrator to execute doveadm mail commands through the given socket.

Arguments

For the possible arguments and their meaning have a look at the rmb cli page.

Commands

check indices

doveadm rmb specific command, system will check if there are objects in RADOS which are not in the index files, and vice versa.

⚠️	This is a costly operation, because we are scanning the object storage namespace of a user.

config create |show |update

Allows the creation of the dovecot plugin ceph configuration, for details see rmb cli documentation.

delete <oid>

Deletes the obejct with given <oid> from RADOS.

⚠️	This command will not ask for confirmation!

ls - | key=value

List objects in RADOS storage. For more information have a look at rmb cli documentation.

get - | key=value

Allows the download of objects from RADOS storage to a local directory. The command will only download the objectfile (original mail) without metadata. If you need to do a backup use doveadm backup.

set oid key=value

Allows the update of metadata attributes. See rmb cli documentation for details.

ls mb

Displays the user mailboxes with some stats.

⚠️	This command does not use the index files, it scans the object storage.

lspools

List all storage pools.

mailbox delete

This command wraps the doveadm mailbox delete command. In case you are using namespace indirection this command will delete the user namespace file, if all mailboxes are empty.

rename <username>

Allows the renaming of a user if namespace indirection is active. Only the RADOS namespace indirection will be changed. The users home directory will noch be renamed.

revert <save_log filename>

Used to clean up all objects given in save_log. For more information, have a look at rmb cli documentation and rbox configuration. The save_log will be recorded by the rbox storage if request by configuration. It contains information RADOS object creation and manipulation. The save_log has three command types: save, copy and move. During save_log replay the recorded operations will be reverted as much as possible:

save

Objects will be deleted

copy

Objects will be deleted

move

The rbox plugin does not change the mail object when it is moved between the user’s mailboxes. It only creates a new index entry and removes the old. The doveadm save_log command will restore the original index entry for the moved mail.

Example

Delete mail objects with doveadm rmb and save_log with re-creation of moved index entries:

doveadm rmb save_log /path/to/save_log