ccb80d725d
Updated a typo (keystone-mange -> keystone-manage) Updated a few capitalization errors in titles Change-Id: I38ec2a6c53b9e3a1e1bf330b54c26f293a764d94 author: diane fleming
143 lines
7.0 KiB
XML
143 lines
7.0 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<section xml:id="baremetal" xmlns="http://docbook.org/ns/docbook"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
|
|
<title>Manage bare metal nodes</title>
|
|
<para>The bare metal driver for OpenStack Compute manages
|
|
provisioning of physical hardware using common cloud APIs and
|
|
tools such as Orchestration (Heat). The use case for this driver
|
|
is for single tenant clouds such as a high-performance computing
|
|
cluster or deploying OpenStack itself. Development efforts are
|
|
focused on moving the driver out of the Compute code base in the
|
|
Icehouse release. If you use the bare metal driver, you must
|
|
create and add a network interface to a bare metal node. Then, you
|
|
can launch an instance from a bare metal image.</para>
|
|
<para>You can list and delete bare metal nodes. When you delete a
|
|
node, any associated network interfaces are removed. You can list
|
|
and remove network interfaces that are associated with a bare
|
|
metal node.</para>
|
|
<itemizedlist>
|
|
<title>Commands</title>
|
|
<listitem>
|
|
<para><command>baremetal-interface-add</command>. Adds a network
|
|
interface to a bare metal node.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><command>baremetal-interface-list</command>. Lists network
|
|
interfaces associated with a bare metal node.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><command>baremetal-interface-remove</command>. Removes a
|
|
network interface from a bare metal node.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><command>baremetal-node-create</command>. Creates a bare
|
|
metal node.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><command>baremetal-node-delete</command>. Removes a bare
|
|
metal node and any associated interfaces.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><command>baremetal-node-list</command>. Lists available
|
|
bare metal nodes.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><command>baremetal-node-show</command>. Shows information
|
|
about a bare metal node.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<procedure>
|
|
<step>
|
|
<para>Create a bare metal node:</para>
|
|
<screen><prompt>$</prompt> <userinput>nova baremetal-node-create --pm_address=1.2.3.4 --pm_user=ipmi --pm_password=ipmi $(hostname -f) 1 512 10 aa:bb:cc:dd:ee:ff</userinput></screen>
|
|
<screen><computeroutput>+------------------+-------------------+
|
|
| Property | Value |
|
|
+------------------+-------------------+
|
|
| instance_uuid | None |
|
|
| pm_address | 1.2.3.4 |
|
|
| interfaces | [] |
|
|
| prov_vlan_id | None |
|
|
| cpus | 1 |
|
|
| memory_mb | 512 |
|
|
| prov_mac_address | aa:bb:cc:dd:ee:ff |
|
|
| service_host | ubuntu |
|
|
| local_gb | 10 |
|
|
| id | 1 |
|
|
| pm_user | ipmi |
|
|
| terminal_port | None |
|
|
+------------------+-------------------+</computeroutput></screen>
|
|
</step>
|
|
<step>
|
|
<para>Add a network interface to the node:</para>
|
|
<screen><prompt>$</prompt> <userinput>nova baremetal-interface-add 1 aa:bb:cc:dd:ee:ff</userinput></screen>
|
|
<screen><computeroutput>+-------------+-------------------+
|
|
| Property | Value |
|
|
+-------------+-------------------+
|
|
| datapath_id | 0 |
|
|
| id | 1 |
|
|
| port_no | 0 |
|
|
| address | aa:bb:cc:dd:ee:ff |
|
|
+-------------+-------------------+</computeroutput></screen>
|
|
</step>
|
|
<step>
|
|
<para>Launch an instance from a bare metal image:</para>
|
|
<screen><prompt>$</prompt> <userinput>nova boot --image my-baremetal-image --flavor my-baremetal-flavor test</userinput> </screen>
|
|
<screen><computeroutput>+-----------------------------+--------------------------------------+
|
|
| Property | Value |
|
|
+-----------------------------+--------------------------------------+
|
|
| status | BUILD |
|
|
| id | cc302a8f-cd81-484b-89a8-b75eb3911b1b |
|
|
|
|
... wait for instance to become active ...</computeroutput></screen>
|
|
</step>
|
|
<step>
|
|
<para>List bare metal nodes and interfaces:</para>
|
|
<screen><prompt>$</prompt> <userinput>nova baremetal-node-list</userinput></screen>
|
|
<para>When a node is in use, its status includes the UUID of the
|
|
instance that runs on it:</para>
|
|
<screen><computeroutput>+----+--------+------+-----------+---------+-------------------
|
|
+------+------------+-------------+-------------+---------------+
|
|
| ID | Host | CPUs | Memory_MB | Disk_GB | MAC Address
|
|
| VLAN | PM Address | PM Username | PM Password | Terminal Port |
|
|
+----+--------+------+-----------+---------+-------------------
|
|
+------+------------+-------------+-------------+---------------+
|
|
| 1 | ubuntu | 1 | 512 | 10 | aa:bb:cc:dd:ee:ff
|
|
| None | 1.2.3.4 | ipmi | | None |
|
|
+----+--------+------+-----------+---------+-------------------
|
|
+------+------------+-------------+-------------+---------------+</computeroutput></screen>
|
|
</step>
|
|
<step>
|
|
<para>Show details for a bare metal node:</para>
|
|
<screen><prompt>$</prompt> <userinput>nova baremetal-node-show 1</userinput> </screen>
|
|
<screen><computeroutput>+------------------+--------------------------------------+
|
|
| Property | Value |
|
|
+------------------+--------------------------------------+
|
|
| instance_uuid | cc302a8f-cd81-484b-89a8-b75eb3911b1b |
|
|
| pm_address | 1.2.3.4 |
|
|
| interfaces |
|
|
[{u'datapath_id': u'0', u'id': 1, u'port_no': 0, u'address': u'aa:bb:cc:dd:ee:ff'}] |
|
|
| prov_vlan_id | None |
|
|
| cpus | 1 |
|
|
| memory_mb | 512 |
|
|
| prov_mac_address | aa:bb:cc:dd:ee:ff |
|
|
| service_host | ubuntu |
|
|
| local_gb | 10 |
|
|
| id | 1 |
|
|
| pm_user | ipmi |
|
|
| terminal_port | None |
|
|
+------------------+--------------------------------------+</computeroutput></screen>
|
|
</step>
|
|
</procedure>
|
|
<note>
|
|
<para>Set the <parameter>--availability_zone</parameter> parameter
|
|
to specify which zone or node to use to start the server.
|
|
Separate the zone from the host name with a comma. For
|
|
example:</para>
|
|
<screen><prompt>$</prompt> <userinput>nova boot --availability_zone=zone:<replaceable>host</replaceable>,<replaceable>node</replaceable></userinput></screen>
|
|
<para><parameter>host</parameter> is optional for the
|
|
<parameter>--availability_zone</parameter> parameter.
|
|
<parameter>zone:,node</parameter> also works.</para>
|
|
</note>
|
|
</section>
|