Search K
Appearance
Appearance
doveadm [GLOBAL OPTIONS] cluster site add [ --id id ] [ --tag tag ] [ --load-balancer host ] name
doveadm [GLOBAL OPTIONS] cluster site remove name
doveadm [GLOBAL OPTIONS] cluster site update [ --status online|offline|standby|evacuate ] [ --load-balancer host ] --self | name
doveadm [GLOBAL OPTIONS] cluster site status name
doveadm [GLOBAL OPTIONS] cluster site list
doveadm [GLOBAL OPTIONS] cluster site force-move start [--id id] name percentage dest-site [dest-site ...]
doveadm [GLOBAL OPTIONS] cluster site force-move update name percentage
doveadm [GLOBAL OPTIONS] cluster site force-move stop name
doveadm cluster site can be used to run actions that interact with and modify Palomar sites.
doveadm [GLOBAL OPTIONS] cluster site add [--id id] [--tag tag] [--load-balancer host] name
Adds a new site to cluster. Load balancer is the host or IP address where another site's proxy connects to do site to site connections.
New sites are added in online state. UUID should not be used unless you are re-adding the same site.
doveadm [GLOBAL OPTIONS] cluster site remove name
Remove a site. This currently has no safety checks, so be sure to remove first all of the site's backends and remove it from all users' preferred sites.
doveadm [GLOBAL OPTIONS] cluster site update [--status online|offline|standby|evacuate] [--load-balancer host] --self | name
Update site status and load balancer. The --self
parameter can be used to target the local site. Changing the status also resets the site's force-move state.
doveadm [GLOBAL OPTIONS] cluster site list
List all sites.
doveadm [GLOBAL OPTIONS] cluster site force-move start [--id id] name percentage dest-site [dest-site ...]
Forcibly start moving users out of the site while they are logging in. This works by getting a hash of the given id and username in the range 0..99, and comparing that to the given percentage. If the hash is below the percentage, the user will be moved to one of the dest-site during login. The picked dest-site is also based on the hash of the username. If the id is not given, a new unique UUID is generated.
The force-moving is tracked entirely in GeoDB, so this command can be used on any of the proxies or backends. The source site does not need to be accessible for the force-moving to work.
The force-move state is cleared also when updating the site's status with doveadm cluster site update --status
.
Normally this command is used internally by the controller.
doveadm [GLOBAL OPTIONS] cluster site force-move update name percentage
Update a new percentage to an already started force-move.
doveadm [GLOBAL OPTIONS] cluster site force-move stop name
Stop an already started force-move. This is similar to updating the percentage to 0, but it also clears out the ID and dest-site fields in GeoDB.