17 KiB
Bulk Host XML File Format
Hosts for bulk addition are described using an XML document.
The document root is hosts. Within the root, each
host is described using a host node. To provide
details, child elements are used, corresponding to the parameters for
the host-add
command.
The following elements are accepted. Each element takes a text string. For valid values, refer to the CLI documentation.
| Element | Remarks |
|---|---|
| hostname | A unique name for the host. Note Controller and storage node names are assigned automatically and override user input. |
| personality | The type of host. |
| subfunctions | For a worker host, an optional element to enable a low-latency performance profile. |
| mgmt_mac | The MAC address of the management interface. |
| mgmt_ip | The IP address of the management interface. |
| bm_ip | The IP address of the board management controller. |
| bm_type | The board management controller type. |
| bm_username | The username for board management controller authentication. |
| bm_password | The password for board management controller authentication. |
| power_on | An empty element. If present, powers on the host automatically using the specified board management controller. |
| install_output | The display mode to use during installation (text or graphical). The default is text. Note The graphical option currently has no effect. Text-based installation is used regardless of this setting. |
| console | If present, this element specifies the port, and if applicable the baud, for displaying messages. If the element is empty or not present, the default setting ttyS0,115200 is used. |
| rootfs_device | The device to use for the rootfs partition, relative to /dev. |
| boot_device | The device to use for the boot partition, relative to /dev. |
| location | A description of the host location. |
The following sample describes a controller, three worker nodes, and two storage nodes:
<?xml version="1.0" encoding="UTF-8" ?>
<hosts>
<host>
<personality>controller</personality>
<mgmt_mac>08:00:27:19:b0:c5</mgmt_mac>
<bm_ip>10.10.10.100</bm_ip>
<bm_type>bmc</bm_type>
<bm_username>tsmith1</bm_username>
<bm_password>mypass1</bm_password>
<install_output>text</install_output>
<location>System12/A4</location>
</host>
<host>
<hostname>worker-0</hostname>
<personality>worker</personality>
<mgmt_mac>08:00:27:dc:42:46</mgmt_mac>
<mgmt_ip>192.168.204.50</mgmt_ip>
<bm_ip>10.10.10.101</bm_ip>
<bm_username>tsmith1</bm_username>
<bm_password>mypass1</bm_password>
<bm_type>bmc</bm_type>
<install_output>text</install_output>
<console></console>
</host>
<host>
<hostname>worker-1</hostname>
<personality>worker</personality>
<mgmt_mac>08:00:27:87:82:3E</mgmt_mac>
<mgmt_ip>192.168.204.51</mgmt_ip>
<bm_ip>10.10.10.102</bm_ip>
<bm_type>bmc</bm_type>
<bm_username>tsmith1</bm_username>
<bm_password>mypass1</bm_password>
<rootfs_device>sda</rootfs_device>
<install_output>text</install_output>
</host>
<host>
<hostname>worker-2</hostname>
<personality>worker</personality>
<mgmt_mac>08:00:27:b9:16:0d</mgmt_mac>
<mgmt_ip>192.168.204.52</mgmt_ip>
<rootfs_device>sda</rootfs_device>
<install_output>text</install_output>
<console></console>
<power_on/>
<bm_ip>10.10.10.103</bm_ip>
<bm_type>bmc</bm_type>
<bm_username>tsmith1</bm_username>
<bm_password>mypass1</bm_password>
</host>
<host>
<personality>storage</personality>
<mgmt_mac>08:00:27:dd:e3:3f</mgmt_mac>
<bm_ip>10.10.10.104</bm_ip>
<bm_type>bmc</bm_type>
<bm_username>tsmith1</bm_username>
<bm_password>mypass1</bm_password>
</host>
<host>
<personality>storage</personality>
<mgmt_mac>08:00:27:8e:f1:b8</mgmt_mac>
<bm_ip>10.10.10.105</bm_ip>
<bm_type>bmc</bm_type>
<bm_username>tsmith1</bm_username>
<bm_password>mypass1</bm_password>
</host>
</hosts>