starlingx/docs
Code Issues Proposed changes
master
docs/doc/source/deploy_install_guides/release/bare_metal/adding-hosts-in-bulk.rst
Ron Stone f125a8b892 Remove spurious escapes (r8,dsR8) 
This change addresses a long-standing issue in rST documentation imported from XML.
That import process added backslash escapes in front of various characters. The three
most common being '(', ')', and '_'.
These instances are removed.

Signed-off-by: Ron Stone <ronald.stone@windriver.com>
Change-Id: Id43a9337ffcd505ccbdf072d7b29afdb5d2c997e
2023-03-01 11:19:04 +00:00

1.6 KiB
Raw Permalink Blame History

Add Hosts in Bulk

You can add an arbitrary number of hosts using a single CLI command.

  1. Prepare an XML file that describes the hosts to be added.

    For more information, see Bulk Host XML File Format <bulk-host-xml-file-format-r7>.

    You can also create the XML configuration file from an existing, running configuration using the system host-bulk-export command.

  2. Run the system host-bulk-add utility.

    The command syntax is:

    ~[keystone_admin]$ system host-bulk-add <xml_file>

    where <xml_file> is the name of the prepared XML file.

  3. Power on the hosts to be added, if required.

    Note

    Hosts can be powered on automatically from board management controllers using settings in the XML file.

The hosts are configured. The utility provides a summary report, as shown in the following example:

Success:
worker-0
worker-1
Error:
controller-1: Host-add Rejected: Host with mgmt_mac 08:00:28:A9:54:19 already exists

After adding the host, you must provision it according to the requirements of the personality.

Bulk Host XML File Format <bulk-host-xml-file-format-r7>