Skip to content

Commit f6decb7

Browse files
committed
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.
1 parent 4b2be40 commit f6decb7

File tree

1 file changed

+31
-0
lines changed

1 file changed

+31
-0
lines changed

docs/rabbitmqctl.8

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -431,6 +431,37 @@ to the node
431431
.Qq rabbit@cordelia
432432
.sp
433433
.Dl rabbitmqctl rename_cluster_node rabbit@misshelpful rabbit@cordelia
434+
.Pp
435+
Note that this command only changes the local database.
436+
It is also necessary to rename the local database directories,
437+
and to configure the new node name.
438+
For example:
439+
.sp
440+
.Bl -bullet -compact
441+
.It
442+
Stop the node:
443+
.sp
444+
.Dl rabbitmqctl stop rabbit@misshelpful
445+
.sp
446+
.It
447+
Rename the node in the local database:
448+
.sp
449+
.Dl rabbitmqctl rename_cluster_node rabbit@misshelpful rabbit@cordelia
450+
.sp
451+
.It
452+
Rename the local database directories:
453+
.sp
454+
.Dl mv /var/lib/rabbitmq/mnesia/rabbit\\@misshelpful /var/lib/rabbitmq/mnesia/rabbit\\@cordelia
455+
.Dl mv /var/lib/rabbitmq/mnesia/rabbit\\@misshelpful-rename /var/lib/rabbitmq/mnesia/rabbit\\@cordelia-rename
456+
.Dl mv /var/lib/rabbitmq/mnesia/rabbit\\@misshelpful-plugins-expand /var/lib/rabbitmq/mnesia/rabbit\\@cordelia-plugins-expand
457+
.sp
458+
.It
459+
Rename the node in
460+
.Ar /etc/rabbitmq/rabbitmq-env.conf
461+
.sp
462+
.It
463+
Start the node when ready
464+
.El
434465
.\" ------------------------------------
435466
.It Cm update_cluster_nodes Ar clusternode
436467
.Bl -tag -width Ds

0 commit comments

Comments
 (0)