1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
|
## This Source Code Form is subject to the terms of the Mozilla Public
## License, v. 2.0. If a copy of the MPL was not distributed with this
## file, You can obtain one at https://mozilla.org/MPL/2.0/.
##
## Copyright (c) 2016-2023 VMware, Inc. or its affiliates. All rights reserved.
defmodule RabbitMQ.CLI.Ctl.Commands.JoinClusterCommand do
alias RabbitMQ.CLI.Core.{Config, DocGuide, Helpers}
@behaviour RabbitMQ.CLI.CommandBehaviour
def switches() do
[
disc: :boolean,
ram: :boolean
]
end
def merge_defaults(args, opts) do
{args, Map.merge(%{disc: false, ram: false}, opts)}
end
def validate(_, %{disc: true, ram: true}) do
{:validation_failure, {:bad_argument, "The node type must be either disc or ram."}}
end
def validate([], _), do: {:validation_failure, :not_enough_args}
def validate([_], _), do: :ok
def validate(_, _), do: {:validation_failure, :too_many_args}
use RabbitMQ.CLI.Core.RequiresRabbitAppStopped
def run([target_node], %{node: node_name, ram: ram, disc: disc} = opts) do
node_type =
case {ram, disc} do
{true, false} -> :ram
{false, true} -> :disc
## disc is default
{false, false} -> :disc
end
long_or_short_names = Config.get_option(:longnames, opts)
target_node_normalised = Helpers.normalise_node(target_node, long_or_short_names)
ret =
:rabbit_misc.rpc_call(
node_name,
:rabbit_db_cluster,
:join,
[target_node_normalised, node_type]
)
case ret do
{:badrpc, {:EXIT, {:undef, _}}} ->
:rabbit_misc.rpc_call(
node_name,
:rabbit_mnesia,
:join_cluster,
[target_node_normalised, node_type]
)
_ ->
ret
end
end
def output({:ok, :already_member}, _) do
{:ok, "The node is already a member of this cluster"}
end
def output({:error, :mnesia_unexpectedly_running}, %{node: node_name}) do
{:error, RabbitMQ.CLI.Core.ExitCodes.exit_software(),
RabbitMQ.CLI.DefaultOutput.mnesia_running_error(node_name)}
end
def output({:error, :cannot_cluster_node_with_itself}, %{node: node_name}) do
{:error, RabbitMQ.CLI.Core.ExitCodes.exit_software(),
"Error: cannot cluster node with itself: #{node_name}"}
end
def output(
{:error,
{:khepri_mnesia_migration_ex, :all_mnesia_nodes_must_run,
%{all_nodes: nodes, running_nodes: running}}},
_opts
) do
{:error, RabbitMQ.CLI.Core.ExitCodes.exit_software(),
"Error: all mnesia nodes must run to join the cluster, mnesia nodes: #{inspect(nodes)}, running nodes: #{inspect(running)}"}
end
use RabbitMQ.CLI.DefaultOutput
def banner([target_node], %{node: node_name}) do
"Clustering node #{node_name} with #{target_node}"
end
def usage() do
"join_cluster [--disc|--ram] <existing_cluster_member>"
end
def usage_additional() do
[
["<existing_cluster_member>", "Existing cluster member (node) to join"],
[
"--disc",
"new node should be a disk one (stores its schema on disk). Highly recommended, used by default."
],
[
"--ram",
"new node should be a RAM one (stores schema in RAM). Not recommended. Consult clustering doc guides first."
]
]
end
def usage_doc_guides() do
[
DocGuide.clustering(),
DocGuide.cluster_formation()
]
end
def help_section(), do: :cluster_management
def description(),
do: "Instructs the node to become a member of the cluster that the specified node is in"
end
|