Skip to content

Commit

Permalink
Add procedure for corosync stage of crm cluster init
Browse files Browse the repository at this point in the history
  • Loading branch information
tahliar committed Oct 14, 2024
1 parent 904883e commit 91baf0c
Showing 1 changed file with 72 additions and 0 deletions.
72 changes: 72 additions & 0 deletions xml/ha_config_cli.xml
Original file line number Diff line number Diff line change
Expand Up @@ -954,6 +954,78 @@ Membership information
For more details, see
<link xlink:href="https://crmsh.nongnu.org/crm.8.html#cmdhelp_corosync"/>.
</para>

<para>
You can use the <command>crm cluster init</command>
script to change the &corosync; communication channels (or rings). For example, you might need
to switch from using two &corosync; rings to using a single ring with network device bonding,
or vice versa.
</para>
<procedure xml:id="pro-ha-config-crm-corosync">
<title>Changing &corosync; communication channels with &crmsh;</title>
<step>
<para>
Stop the cluster services on all nodes:
</para>
<screen>&prompt.root;<command>crm cluster stop --all</command></screen>
</step>
<step>
<para>
On the first node, change &corosync;'s ring configuration with one of the
following commands:
</para>
<itemizedlist>
<listitem>
<para>
To configure one ring, run the script's <option>corosync</option> stage
with no additional parameters:
</para>
<screen>&prompt.root;<command>crm cluster init corosync</command></screen>
<para>
Accept the proposed network address or enter a different one,
for example, the address of <literal>bond0</literal>.
</para>
</listitem>
<listitem>
<para>
To configure two rings, specify two network addresses by using the
option <literal>--interface</literal> (or <literal>-i</literal>) twice:
</para>
<screen>&prompt.root;<command>crm cluster init corosync -i eth0 -i eth1</command></screen>
<para>
Accept the first network address and port. Enter <literal>y</literal>
to accept a second heartbeat line, then accept the second network address and port.
</para>
</listitem>
</itemizedlist>
</step>
<step>
<para>
On each of the other cluster nodes, update the &corosync; configuration to match the
first node:
</para>
<itemizedlist>
<listitem>
<para>
For one ring, run the following command:
</para>
<screen>&prompt.root;<command>crm cluster join corosync -c <replaceable>NODE1</replaceable></command></screen>
</listitem>
<listitem>
<para>
For two rings, run the following command:
</para>
<screen>&prompt.root;<command>crm cluster join corosync -i eth0 -i eth1 -c <replaceable>NODE1</replaceable></command></screen>
</listitem>
</itemizedlist>
</step>
<step>
<para>
Start the cluster services on all nodes:
</para>
<screen>&prompt.root;<command>crm cluster start --all</command></screen>
</step>
</procedure>
</sect2>

<sect2 xml:id="sec-ha-config-crm-setpwd">
Expand Down

0 comments on commit 91baf0c

Please sign in to comment.