diff options
| author | Jean-Sébastien Pédron <jean-sebastien.pedron@dumbbell.fr> | 2018-07-19 10:15:16 +0200 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2018-07-19 10:15:16 +0200 |
| commit | ac5db6f67859385b4e0aa4049b93e3dbdc0e19a7 (patch) | |
| tree | e9017ec087fbba4a77e421b68f918bcff32e57e4 /docs/rabbitmqctl.8 | |
| parent | f1c720f7cabec25f571e5bb4e5c5c79683123f43 (diff) | |
| parent | 49ed422eff547752d0f4ef790eaff594aaf16f3c (diff) | |
| download | rabbitmq-server-git-ac5db6f67859385b4e0aa4049b93e3dbdc0e19a7.tar.gz | |
Merge pull request #1641 from blgm/rename_node_docs_improvement
Additional info for `rabbitmqctl rename_cluster_node` man page
Diffstat (limited to 'docs/rabbitmqctl.8')
| -rw-r--r-- | docs/rabbitmqctl.8 | 40 |
1 files changed, 40 insertions, 0 deletions
diff --git a/docs/rabbitmqctl.8 b/docs/rabbitmqctl.8 index 7a8497a89b..27e8b2b055 100644 --- a/docs/rabbitmqctl.8 +++ b/docs/rabbitmqctl.8 @@ -431,6 +431,46 @@ to the node .Qq rabbit@cordelia .sp .Dl rabbitmqctl rename_cluster_node rabbit@misshelpful rabbit@cordelia +.Pp +Note that this command only changes the local database. +It may also be necessary to rename the local database directories, +and to configure the new node name. +For example: +.sp +.Bl -enum -compact +.It +Stop the node: +.sp +.Dl rabbitmqctl stop rabbit@misshelpful +.sp +.It +Rename the node in the local database: +.sp +.Dl rabbitmqctl rename_cluster_node rabbit@misshelpful rabbit@cordelia +.sp +.It +Rename the local database directories (note, you do not need to do this if you have set the RABBITMQ_MNESIA_DIR environment variable): +.sp +.Bd -literal -offset indent -compact +mv \\ + /var/lib/rabbitmq/mnesia/rabbit\\@misshelpful \\ + /var/lib/rabbitmq/mnesia/rabbit\\@cordelia +mv \\ + /var/lib/rabbitmq/mnesia/rabbit\\@misshelpful-rename \\ + /var/lib/rabbitmq/mnesia/rabbit\\@cordelia-rename +mv \\ + /var/lib/rabbitmq/mnesia/rabbit\\@misshelpful-plugins-expand \\ + /var/lib/rabbitmq/mnesia/rabbit\\@cordelia-plugins-expand +.Ed +.sp +.It +If you have +.Ar /etc/rabbitmq/rabbitmq-env.conf +and configured the node name there, update this configuration. +.sp +.It +Start the node when ready +.El .\" ------------------------------------ .It Cm update_cluster_nodes Ar clusternode .Bl -tag -width Ds |