Search K
Appearance
Appearance
doveadm [GLOBAL OPTIONS] cluster user access [-u user | -A | -f file | --no-userdb-lookup] [-i]
doveadm [GLOBAL OPTIONS] cluster user delete user
doveadm [GLOBAL OPTIONS] cluster user move backend [--direct] user dest-host
doveadm [GLOBAL OPTIONS] cluster user move site [--direct] [--keep-preferred] user dest-site
doveadm [GLOBAL OPTIONS] cluster user move status
doveadm [GLOBAL OPTIONS] cluster user batch move backend [--id id] [--min-last-moved age] [--reason reason] --count users dest-host [dest-host ...]
doveadm [GLOBAL OPTIONS] cluster user batch move site [--id id] [--min-last-moved age] [--keep-preferred] [--reason reason] --count users dest-site [dest-site ...]
doveadm [GLOBAL OPTIONS] cluster user batch move stop
doveadm [GLOBAL OPTIONS] cluster user batch move status
doveadm [GLOBAL OPTIONS] cluster user status user
doveadm cluster user can be used to run actions that interact with Palomar users.
Global doveadm(1)
options:
Enables verbosity and debug messages.
Do not read any config file, just use defaults. The dovecot_storage_version
defaults to the latest version, but can be overridden with -o.
Preserve entire environment for doveadm, not just import_environment
.
Enables verbosity, including progress counter.
If using multiple Dovecot instances, choose the config file based on this instance name.
See instance_name
for more information.
Read configuration from the given config-file. By default it first reads config socket, and then falls back to /etc/dovecot/dovecot.conf. You can also point this to config socket of some instance running compatible version.
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.
Specifies the formatter for formatting the output. Supported formatters are:
If the -A option is present, the command will be performed for all users. Using this option in combination with system users from userdb { driver = passwd } is not recommended, because it contains also users with a lower UID than the one configured with the first_valid_uid
setting.
When the SQL userdb module is used, make sure that the userdb_sql_iterate_query
setting matches your database layout.
When using the LDAP userdb module, make sure that the userdb_fields
and userdb_ldap_iterate_fields
settings match your LDAP schema. Otherwise doveadm(1)
will be unable to iterate over all users.
Execute the command for all the users in the file. This is similar to the -A option, but instead of getting the list of users from the userdb, they are read from the given file. The file contains one username per line.
Do not perform userdb lookup. Use the USER
environment variable to specify the username.
Run the command only for the given user. It's also possible to use '*' and '?' wildcards (e.g. -u *@example.org).
doveadm [GLOBAL OPTIONS] cluster user access [-u user | -A | -F file | --no-userdb-lookup] [-i]
Perform cluster lookup for the user (or users). Displays the host name or IP address of the backend which the user ended up. This command can be run from either a proxy or a backend. This command is also used internally to finish user moves.
You can use the -i
parameter to display backend's IP rather than host name.
doveadm [GLOBAL OPTIONS] cluster user delete user
Deletes a user record from GeoDB.
doveadm [GLOBAL OPTIONS] cluster user move backend [--direct] user dest-host
Initiates moving user to a different backend. The move is added to the queue of user moves, and it will finish on background. This command only moves the user from the backend where it is run from, i.e. the command should be run on the user's current backend.
--direct
will update the user's new backend immediately to GeoDB without performing any user moving (kicking of existing sessions or flushing metacache). This is intended for testing and troubleshooting purposes only, and should not be normally used.
doveadm [GLOBAL OPTIONS] cluster user move site [--direct] [--keep-preferred] user dest-site
Initiates moving user to a different site. The move is added to the queue of user moves, and it will finish on background. This command only moves the user from the backend where it is run from, i.e. the command should be run on the user's current backend.
--direct
will update the user's new site immediately to GeoDB without performing any user moving (kicking of existing sessions or flushing metacache). This is intended for testing and troubleshooting purposes only, and should not be normally used.
--keep-preferred
disables changing the user's preferred site. This is used to temporarily move users to different sites, e.g. for load-balancing purposes.
Output the status of the current user move queue.
doveadm [GLOBAL OPTIONS] cluster user batch move backend [--id id] [--min-last-moved age] [--reason reason] --count users dest-host [dest-host ...]
Initiates moving a number of users to different backends which will finish in background. If the command is run again while a batch (backend or site) move is already in progress, the previous batch move is aborted.
The user moves are equally distributed to the list of given destination backends.
--id
specifies a UUID for the move operation. By default a new ID is generated. The moving status is visible in GeoDB's move_* fields.
--min-last-moved
specifies a time interval (e.g. "1 hour") for the minimum age of the user's last-moved timestamp. This is used to avoid moving the same users too often.
--reason
specifies a human readable reason why the move is performed. This is visible in logs, cluster_user_batch_move_finished
event and doveadm cluster user batch move status
output.
doveadm [GLOBAL OPTIONS] cluster user batch move site [--id id] [--min-last-moved age] [--keep-preferred] [--reason reason] --count users dest-site [dest-site ...]
Initiates moving a number of users to different sites which will finish in background. If the command is run again while a batch (backend or site) move is already in progress, the previous batch move is aborted.
The user moves are equally distributed to the list of given destination sites.
--id
specifies a UUID for the move operation. By default a new ID is generated. The moving status is visible in GeoDB's move_* fields.
--min-last-moved
specifies a time interval (e.g. "1 hour") for the minimum age of the user's last-moved timestamp. This is used to avoid moving the same users too often.
--keep-preferred
disables changing the users' preferred sites. This is used to temporarily move users to different sites, e.g. for load-balancing purposes.
--reason
specifies a human readable reason why the move is performed. This is visible in logs, cluster_user_batch_move_finished
event and doveadm cluster user batch move status
output.
Stop the currently running user batch move.
Output the status of the currently running user batch move.
doveadm [GLOBAL OPTIONS] cluster user status user
Displays status information of a user.
Report bugs, including doveconf -n output, to the Dovecot Mailing List dovecot@dovecot.org. Information about reporting bugs is available at: https://dovecot.org/bugreport.html