sin/samba-mirror
1
0
Fork 0
mirror of https://github.com/samba-team/samba.git synced 2025-02-26 21:57:41 +03:00
Code

ctdb-docs: Update "ctdb reloadnodes" documentation

Browse Source 
Format instructions for adding/deleting nodes with appropriate XML and
simplify wording.

Signed-off-by: Martin Schwenke <martin@meltin.net>
Reviewed-by: Amitay Isaacs <amitay@gmail.com>
Reviewed-by: Jose A. Rivera <jarrpa@samba.org>
Reviewed-by: Michael Adam <obnox@samba.org>
This commit is contained in:
Martin Schwenke 2015-08-21 16:07:21 +10:00 committed by Michael Adam
parent e7a139bffe
commit 36a14730f1
1 changed files with 83 additions and 43 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

126
ctdb/doc/ctdb.1.xml
View File

@ -1088,54 +1088,94 @@ DB Statistics: locking.tdb
<refsect2>
<title>reloadnodes</title>
<para>
This command is used when adding new nodes, or removing existing nodes from an existing cluster.
This command is used when adding new nodes, or removing
existing nodes from an existing cluster.
</para>
<para>
Procedure to add a node:
</para>
<para>
1, To expand an existing cluster, first ensure with 'ctdb status' that
all nodes are up and running and that they are all healthy.
Do not try to expand a cluster unless it is completely healthy!
</para>
<para>
2, On all nodes, edit /etc/ctdb/nodes and add the new node as the last
entry to the file. The new node MUST be added to the end of this file!
</para>
<para>
3, Verify that all the nodes have identical /etc/ctdb/nodes files after you edited them and added the new node!
</para>
<para>
4, Run 'ctdb reloadnodes' to force all nodes to reload the nodesfile.
</para>
<para>
5, Use 'ctdb status' on all nodes and verify that they now show the additional node.
</para>
<para>
6, Install and configure the new node and bring it online.
</para>
<para>
Procedure to remove a node:
</para>
<para>
1, To remove a node from an existing cluster, first ensure with 'ctdb status' that
all nodes, except the node to be deleted, are up and running and that they are all healthy.
Do not try to remove a node from a cluster unless the cluster is completely healthy!
</para>
<para>
2, Shutdown and poweroff the node to be removed.
</para>
<para>
3, On all other nodes, edit the /etc/ctdb/nodes file and comment out the node to be removed. Do not delete the line for that node, just comment it out by adding a '#' at the beginning of the line.
</para>
<para>
4, Run 'ctdb reloadnodes' to force all nodes to reload the nodesfile.
</para>
<para>
5, Use 'ctdb status' on all nodes and verify that the deleted node no longer shows up in the list..
Procedure to add nodes:
</para>
<orderedlist>
<listitem>
<para>
To expand an existing cluster, first ensure with
<command>ctdb status</command> that all nodes are up and
running and that they are all healthy. Do not try to
expand a cluster unless it is completely healthy!
</para>
</listitem>
<listitem>
<para>
On all nodes, edit <filename>/etc/ctdb/nodes</filename>
and <emphasis>add the new nodes at the end of this
file</emphasis>.
</para>
</listitem>
<listitem>
<para>
Verify that all the nodes have identical
<filename>/etc/ctdb/nodes</filename> files after adding
the new nodes.
</para>
</listitem>
<listitem>
<para>
Run <command>ctdb reloadnodes</command> to force all nodes
to reload the nodes file.
</para>
</listitem>
<listitem>
<para>
Use <command>ctdb status</command> on all nodes and verify
that they now show the additional nodes.
</para>
</listitem>
<listitem>
<para>
Install and configure the new node and bring it online.
</para>
</listitem>
</orderedlist>
<para>
Procedure to remove nodes:
</para>
<orderedlist>
<listitem>
<para>
To remove nodes from an existing cluster, first ensure
with <command>ctdb status</command> that all nodes, except
the node to be deleted, are up and running and that they
are all healthy. Do not try to remove nodes from a
cluster unless the cluster is completely healthy!
</para>
</listitem>
<listitem>
<para>
Shutdown and power off the node to be removed.
</para>
</listitem>
<listitem>
<para>
On all other nodes, edit the
<filename>/etc/ctdb/nodes</filename> file and
<emphasis>comment out</emphasis> the nodes to be removed.
<emphasis>Do not delete the lines for the deleted
nodes</emphasis>, just comment them out by adding a '#' at
the beginning of the lines.
</para>
</listitem>
<listitem>
<para>
Run <command>ctdb reloadnodes</command> to force all nodes
to reload the nodes file.
</para>
</listitem>
<listitem>
<para>
Use <command>ctdb status</command> on all nodes and verify
that the deleted nodes are no longer listed.
</para>
</listitem>
</orderedlist>
</refsect2>