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, basically it 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.

Warning

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 objectstore, 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.

Warning

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

Allows the renaming of a user, if namespace indirection is active.

save_log <filename>

Used to clean up all objects given in save_log. For more information, have a look at rmb cli documentation and dovecot configuration.

Example