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.