diff options
| author | George Blue <gblue@pivotal.io> | 2018-07-12 13:52:06 +0100 |
|---|---|---|
| committer | George Blue <gblue@pivotal.io> | 2018-07-12 13:52:06 +0100 |
| commit | f6decb7df3844192f5b5cb1cd511ca64a1b6c4b0 (patch) | |
| tree | 911323cdc0b707e1c7be0b411996ab875615bcf3 /docs | |
| parent | 4b2be400838c417a308bcfbdf27dd281761fde0f (diff) | |
| download | rabbitmq-server-git-f6decb7df3844192f5b5cb1cd511ca64a1b6c4b0.tar.gz | |
Additional info for `rabbitmqctl rename_cluster_node` man page
The man page currently explains that it only changes the local database.
I have added information about the other steps required to successfully
rename a node.
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/rabbitmqctl.8 | 31 |
1 files changed, 31 insertions, 0 deletions
diff --git a/docs/rabbitmqctl.8 b/docs/rabbitmqctl.8 index 7a8497a89b..8f82ac7a6c 100644 --- a/docs/rabbitmqctl.8 +++ b/docs/rabbitmqctl.8 @@ -431,6 +431,37 @@ 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 is also necessary to rename the local database directories, +and to configure the new node name. +For example: +.sp +.Bl -bullet -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: +.sp +.Dl mv /var/lib/rabbitmq/mnesia/rabbit\\@misshelpful /var/lib/rabbitmq/mnesia/rabbit\\@cordelia +.Dl mv /var/lib/rabbitmq/mnesia/rabbit\\@misshelpful-rename /var/lib/rabbitmq/mnesia/rabbit\\@cordelia-rename +.Dl mv /var/lib/rabbitmq/mnesia/rabbit\\@misshelpful-plugins-expand /var/lib/rabbitmq/mnesia/rabbit\\@cordelia-plugins-expand +.sp +.It +Rename the node in +.Ar /etc/rabbitmq/rabbitmq-env.conf +.sp +.It +Start the node when ready +.El .\" ------------------------------------ .It Cm update_cluster_nodes Ar clusternode .Bl -tag -width Ds |