starlingx/docs
Code Issues Proposed changes
docs/doc/source/deploy_install_guides/release/bare_metal/adding-hosts-in-bulk.rst
Ron Stone f98eb51fb4 Simplify install dirs 
Simplify install doc dir structure
- Remove r6 directory
- Rename r7 directory to be non release-specific
- Delete unused files
- Delete obsolete include files
- Delete obsolete commented sections in install topics
- Remove redundent version menu entry

Signed-off-by: Ron Stone <ronald.stone@windriver.com>
Change-Id: I59634826d4b3af41410e9d26cc182f6b4aed8ade
2023-01-04 07:30:40 -05:00

1.6 KiB
Raw 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>