Command 'migrate'

See also: login, controllers, status


Migrate a workload model to another controller.


juju migrate [options] <model-name> <target-controller-name>


Flag Default Usage
--B, --no-browser-login false Do not use web browser for authentication


migrate begins the migration of a model from its current controller to a new controller. This is useful for load balancing when a controller is too busy, or as a way to upgrade a model’s controller to a newer Juju version. Once complete, the model’s machine and and unit agents will be connected to the new controller. The model will no longer be available at the source controller.

Note that only workload models can be migrated. Controller models can not be migrated.

If the migration fails for some reason, the model be returned to its original state with the model being managed by the original controller.

In order to start a migration, the target controller must be in the juju client’s local configuration cache. See the juju “login” command for details of how to do this.

This command only starts a model migration - it does not wait for its completion. The progress of a migration can be tracked using the “status” command and by consulting the logs.

Last updated 1 year, 1 month ago. Help improve this document in the forum.