64b6c9261e
Current folder name New folder name Book title ---------------------------------------------------------- basic-install DELETE cli-guide DELETE common common NEW admin-guide-cloud Cloud Administrators Guide docbkx-example DELETE openstack-block-storage-admin DELETE openstack-compute-admin DELETE openstack-config config-reference OpenStack Configuration Reference openstack-ha high-availability-guide OpenStack High Availabilty Guide openstack-image image-guide OpenStack Virtual Machine Image Guide openstack-install install-guide OpenStack Installation Guide openstack-network-connectivity-admin admin-guide-network OpenStack Networking Administration Guide openstack-object-storage-admin DELETE openstack-security security-guide OpenStack Security Guide openstack-training training-guide OpenStack Training Guide openstack-user user-guide OpenStack End User Guide openstack-user-admin user-guide-admin OpenStack Admin User Guide glossary NEW OpenStack Glossary bug: #1220407 Change-Id: Id5ffc774b966ba7b9a591743a877aa10ab3094c7 author: diane fleming
124 lines
6.2 KiB
XML
124 lines
6.2 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>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></para>
|
|
<para>Adds a network interface to a bare metal node.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><command>baremetal-interface-list</command></para>
|
|
<para>Lists network interfaces associated with a bare metal
|
|
node.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
<command>baremetal-interface-remove</command></para>
|
|
<para>Removes a network interface from a bare metal
|
|
node.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
<command>baremetal-node-create</command></para>
|
|
<para>Creates a bare metal node.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
<command>baremetal-node-delete</command></para>
|
|
<para>Removes a bare metal node and any associated
|
|
interfaces.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><command>baremetal-node-list</command></para>
|
|
<para>Lists available bare metal nodes.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><command>baremetal-node-show</command></para>
|
|
<para>Shows information about a bare metal node.</para>
|
|
</listitem></itemizedlist>
|
|
<procedure><title>To manage bare metal nodes</title><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>+-----------------------------+--------------------------------------+
|
|
| Property | Value |
|
|
+-----------------------------+--------------------------------------+
|
|
| status | BUILD |
|
|
| id | cc302a8f-cd81-484b-89a8-b75eb3911b1b |
|
|
|
|
... wait for instance to become active ... </screen>
|
|
</step>
|
|
<step><para>You can list bare metal nodes and interfaces, as follows:</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>
|
|
</section>
|