Node Creation with Known MAC address(es)#
When a new node's MAC address is known to the cluster administrator,
the simplest method is add the node to the cluster is to use
scyld-nodectl create
action and supply that node's MAC address:
scyld-nodectl create mac=11:22:33:44:55:66
and the node is assigned the next available node index and associated IP address.
The administrator can also add the node at an index other than the next available index, e.g., to add a node n10:
scyld-nodectl create mac=11:22:33:44:55:66 index=10
Of course, if a node already exists for the specified MAC or index, then an error is returned and no node is created.
Adding nodes one at a time would be tedious for a large cluster,
so an administrator can also provide JSON formatted content to the create
action.
For example,
scyld-nodectl create --content @path/to/file.json
where that file.json
contains an array of JSON objects,
each object describing a single node, e.g., for two nodes:
[
{ "mac": "11:22:33:44:55:66" },
{ "mac": "00:11:22:33:44:55" }
]
The content
argument can also directly accept JSON, or an INI formatted
file, or a specially formatted text file. Details of how to use these
alternative formats are available in ICE ClusterWare Command Line Tools.