openstack/openstack-manuals
Code Issues Proposed changes

Merge "Enhances and updates bare metal information"

Browse Source
This commit is contained in:
Jenkins 2013-09-18 06:50:15 +00:00 committed by Gerrit Code Review
commit 366e2881d6
7 changed files with 114 additions and 61 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
doc/admin-guide-cloud/ch_compute.xml
View File

@ -59,8 +59,10 @@
Xen, Citrix XenServer and Xen Cloud Platform (XCP)</para> Xen, Citrix XenServer and Xen Cloud Platform (XCP)</para>
</listitem> </listitem>
<listitem> <listitem>
<para><link xlink:href="https://wiki.openstack.org/wiki/GeneralBareMetalProvisioningFramework"> <para><link
Bare Metal</link> - Provisions physical hardware through pluggable sub-drivers.</para> xlink:href="https://wiki.openstack.org/wiki/Baremetal"
>Bare Metal</link> - Provisions physical hardware through pluggable
sub-drivers</para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
</section> </section>

29
doc/common/section_baremetal.xml
View File

@ -6,21 +6,18 @@ xml:id="baremetal">
<title>Bare Metal Driver</title> <title>Bare Metal Driver</title>
<para> <para>
</para> </para>
<para> <para>The baremetal driver is a hypervisor driver for OpenStack Nova
The baremetal driver is a hypervisor driver for OpenStack Nova Compute. Within the OpenStack framework, it has the same role as the
Compute. Within the OpenStack framework, it has the same role drivers for other hypervisors (libvirt, xen, etc), and yet it is
as the drivers for other hypervisors (libvirt, xen, etc), and presently unique in that the hardware is not virtualized - there is no
yet it is presently unique in that the hardware is not hypervisor between the tenants and the physical hardware. It exposes
virtualized - there is no hypervisor between the tenants and hardware via OpenStack's API, using pluggable sub-drivers to deliver
the physical hardware. It exposes hardware via OpenStack's machine imaging (PXE) and power control (IPMI). With this, provisioning
API, using pluggable sub-drivers to deliver machine imaging and management of physical hardware is accomplished using common cloud
(PXE) and power control (IPMI). With this, provisioning and APIs and tools, such as Heat or salt-cloud. However, due to this unique
management of physical hardware is accomplished using common situation, using the baremetal driver requires some additional
cloud APIs and tools, such as Heat or salt-cloud. However, due preparation of its environment, the details of which are beyond the
to this unique situation, using the baremetal driver requires scope of this guide. </para>
some additional preparation of its environment, the details of
which are beyond the scope of this guide.
</para>
<note><para> <note><para>
Some OpenStack Compute features are not implemented by Some OpenStack Compute features are not implemented by
the baremetal hypervisor driver. See the <link the baremetal hypervisor driver. See the <link
@ -44,7 +41,7 @@ reserved_host_memory_mb=0</programlisting>
Baremetal driver. Also, some additional steps will be Baremetal driver. Also, some additional steps will be
required, such as building the baremetal deploy ramdisk. See required, such as building the baremetal deploy ramdisk. See
the <link the <link
xlink:href="https://wiki.openstack.org/wiki/GeneralBareMetalProvisioningFramework"> xlink:href="https://wiki.openstack.org/wiki/Baremetal">
main wiki page</link> for details and implementation suggestions. main wiki page</link> for details and implementation suggestions.
</para> </para>
<xi:include href="tables/nova-baremetal.xml"/> <xi:include href="tables/nova-baremetal.xml"/>

14
doc/common/section_cli_install.xml
View File

@ -15,6 +15,13 @@
<title>Install the OpenStack command-line clients</title> <title>Install the OpenStack command-line clients</title>
<para>Install the prerequisite software and the Python package for <para>Install the prerequisite software and the Python package for
each OpenStack client.</para> each OpenStack client.</para>
<note>
<para>For each command, replace
<replaceable>PROJECT</replaceable>
with the lower case name of the client to
install, such as <literal>nova</literal>.
Repeat for each client.</para>
</note>
<table rules="all" width="75%"> <table rules="all" width="75%">
<caption>Prerequisite software</caption> <caption>Prerequisite software</caption>
<col width="15%"/> <col width="15%"/>
@ -117,13 +124,6 @@
the clients: the clients:
<screen><prompt>#</prompt> <userinput>zypper install python-<replaceable>PROJECT</replaceable>client</userinput></screen></para> <screen><prompt>#</prompt> <userinput>zypper install python-<replaceable>PROJECT</replaceable>client</userinput></screen></para>
</formalpara> </formalpara>
<note>
<para>For each command, replace
<replaceable>PROJECT</replaceable>
with the lower case name of the client to
install, such as <literal>nova</literal>.
Repeat for each client.</para>
</note>
</td> </td>
</tr> </tr>
</tbody> </tbody>

88
doc/common/section_nova_cli_baremetal.xml
View File

@ -1,30 +1,33 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<section xml:id="baremetal" xmlns="http://docbook.org/ns/docbook" <section xml:id="baremetal" xmlns="http://docbook.org/ns/docbook"
xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"> xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
<title>Manage bare metal nodes</title> <title>Manage bare metal nodes</title>
<para>If you use the bare metal driver, you must create and add a <para>The bare metal driver for OpenStack Compute manages provisioning of
network interface to a bare metal node. Then, you can launch an physical hardware using common cloud APIs and tools such as Orchestration
instance from a bare metal image.</para> (Heat). The use case for this driver is for single tenant clouds such as a
<para>You can list and delete bare metal nodes. When you delete a high-performance computing cluster or deploying OpenStack itself.
node, any associated network interfaces are removed. You can list Development efforts are focused on moving the driver out of the Compute code
and remove network interfaces that are associated with a bare base in the Icehouse release. If you use the bare metal driver, you must
metal node.</para> create and add a network interface to a bare metal node. Then, you can
launch an instance from a bare metal image.</para>
<itemizedlist><title>Commands</title><listitem> <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><command>baremetal-interface-add</command></para>
<para>Adds a network interface to a bare metal node.</para> <para>Adds a network interface to a bare metal node.</para>
</listitem> </listitem>
<listitem> <listitem>
<para><command>baremetal-interface-list</command></para> <para><command>baremetal-interface-list</command></para>
<para>Lists network interfaces associated with a bare metal <para>Lists network interfaces associated with a bare metal node.</para>
node.</para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
<command>baremetal-interface-remove</command></para> <command>baremetal-interface-remove</command></para>
<para>Removes a network interface from a bare metal <para>Removes a network interface from a bare metal node.</para>
node.</para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
@ -34,8 +37,7 @@
<listitem> <listitem>
<para> <para>
<command>baremetal-node-delete</command></para> <command>baremetal-node-delete</command></para>
<para>Removes a bare metal node and any associated <para>Removes a bare metal node and any associated interfaces.</para>
interfaces.</para>
</listitem> </listitem>
<listitem> <listitem>
<para><command>baremetal-node-list</command></para> <para><command>baremetal-node-list</command></para>
@ -44,10 +46,14 @@
<listitem> <listitem>
<para><command>baremetal-node-show</command></para> <para><command>baremetal-node-show</command></para>
<para>Shows information about a bare metal node.</para> <para>Shows information about a bare metal node.</para>
</listitem></itemizedlist> </listitem>
<procedure><title>To manage bare metal nodes</title><step><para>Create a bare metal node:</para> </itemizedlist>
<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> <procedure>
<screen><computeroutput>+------------------+-------------------+ <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 | | Property | Value |
+------------------+-------------------+ +------------------+-------------------+
| instance_uuid | None | | instance_uuid | None |
@ -64,9 +70,10 @@
| terminal_port | None | | terminal_port | None |
+------------------+-------------------+</computeroutput></screen> +------------------+-------------------+</computeroutput></screen>
</step> </step>
<step><para>Add a network interface to the node:</para> <step>
<screen><prompt>$</prompt> <userinput>nova baremetal-interface-add 1 aa:bb:cc:dd:ee:ff</userinput></screen> <para>Add a network interface to the node:</para>
<screen><computeroutput>+-------------+-------------------+ <screen><prompt>$</prompt> <userinput>nova baremetal-interface-add 1 aa:bb:cc:dd:ee:ff</userinput></screen>
<screen><computeroutput>+-------------+-------------------+
| Property | Value | | Property | Value |
+-------------+-------------------+ +-------------+-------------------+
| datapath_id | 0 | | datapath_id | 0 |
@ -74,8 +81,9 @@
| port_no | 0 | | port_no | 0 |
| address | aa:bb:cc:dd:ee:ff | | address | aa:bb:cc:dd:ee:ff |
+-------------+-------------------+</computeroutput> </screen> +-------------+-------------------+</computeroutput> </screen>
</step> </step>
<step><para>Launch an instance from a bare metal image:</para> <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><prompt>$</prompt> <userinput>nova boot --image my-baremetal-image --flavor my-baremetal-flavor test</userinput> </screen>
<screen>+-----------------------------+--------------------------------------+ <screen>+-----------------------------+--------------------------------------+
| Property | Value | | Property | Value |
@ -85,10 +93,11 @@
... wait for instance to become active ... </screen> ... wait for instance to become active ... </screen>
</step> </step>
<step><para>You can list bare metal nodes and interfaces, as follows:</para> <step>
<para>You can list bare metal nodes and interfaces, as follows:</para>
<screen><prompt>$</prompt> <userinput>nova baremetal-node-list</userinput></screen> <screen><prompt>$</prompt> <userinput>nova baremetal-node-list</userinput></screen>
<para>When a node is in use, its status includes the UUID of the <para>When a node is in use, its status includes the UUID of the instance
instance that runs on it:</para> that runs on it:</para>
<screen><computeroutput>+----+--------+------+-----------+---------+------------------- <screen><computeroutput>+----+--------+------+-----------+---------+-------------------
+------+------------+-------------+-------------+---------------+ +------+------------+-------------+-------------+---------------+
| ID | Host | CPUs | Memory_MB | Disk_GB | MAC Address | ID | Host | CPUs | Memory_MB | Disk_GB | MAC Address
@ -99,10 +108,10 @@
| None | 1.2.3.4 | ipmi | | None | | None | 1.2.3.4 | ipmi | | None |
+----+--------+------+-----------+---------+------------------- +----+--------+------+-----------+---------+-------------------
+------+------------+-------------+-------------+---------------+</computeroutput></screen> +------+------------+-------------+-------------+---------------+</computeroutput></screen>
</step> </step>
<step>
<step><para>Show details for a bare metal node:</para> <para>Show details for a bare metal node:</para>
<screen><prompt>$</prompt> <userinput>nova baremetal-node-show 1</userinput> </screen> <screen><prompt>$</prompt> <userinput>nova baremetal-node-show 1</userinput> </screen>
<screen><computeroutput>+------------------+--------------------------------------+ <screen><computeroutput>+------------------+--------------------------------------+
| Property | Value | | Property | Value |
+------------------+--------------------------------------+ +------------------+--------------------------------------+
@ -119,5 +128,14 @@
| id | 1 | | id | 1 |
| pm_user | ipmi | | pm_user | ipmi |
| terminal_port | None | | terminal_port | None |
+------------------+--------------------------------------+</computeroutput></screen></step></procedure> +------------------+--------------------------------------+</computeroutput></screen>
</step>
</procedure>
<note>
<para>Set the <parameter>--availability_zone</parameter> parameter to
specify which zone or node to start the server. You can separate the zone
from the hostname with a comma. As an example:
<screen><prompt>$</prompt> <userinput>nova boot --availability_zone=zone:<replaceable>host</replaceable>,<replaceable>node</replaceable></userinput></screen>
Specifying "host" is optional for the <parameter>--availability_zone</parameter> parameter, and "zone:,node" also works.</para>
</note>
</section> </section>

2
doc/config-reference/compute/section_compute-hypervisors.xml
View File

@ -80,7 +80,7 @@
</listitem> </listitem>
<listitem> <listitem>
<para><link <para><link
xlink:href="https://wiki.openstack.org/wiki/GeneralBareMetalProvisioningFramework" xlink:href="https://wiki.openstack.org/wiki/Baremetal"
> Bare Metal</link> - Not a hypervisor in the > Bare Metal</link> - Not a hypervisor in the
traditional sense, this driver provisions physical traditional sense, this driver provisions physical
hardware through pluggable sub-drivers (for example, PXE for image hardware through pluggable sub-drivers (for example, PXE for image

2
doc/user-guide-admin/ch_cli.xml
View File

@ -34,6 +34,8 @@
<?hard-pagebreak?> <?hard-pagebreak?>
<xi:include href="section_nova_cli_manage_flavors.xml"/> <xi:include href="section_nova_cli_manage_flavors.xml"/>
<?hard-pagebreak?> <?hard-pagebreak?>
<xi:include href="section_nova_specify_host.xml"/>
<?hard-pagebreak?>
<xi:include href="section_keystone_cli_set_quotas.xml"/> <xi:include href="section_keystone_cli_set_quotas.xml"/>
<?hard-pagebreak?> <?hard-pagebreak?>
<xi:include href="section_swift_cli_analyze_log_files.xml"/> <xi:include href="section_swift_cli_analyze_log_files.xml"/>

34
doc/user-guide-admin/section_nova_specify_host.xml Normal file
View File

@ -0,0 +1,34 @@
<?xml version="1.0" encoding="UTF-8"?>
<section 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"
xml:id="specify-host-to-boot-instances-on">
<title>Select a specific host to boot instances on</title>
<para>If you have the appropriate permissions, you can select the specific host where the
instance will be launched. This is done using the <literal>--availability_zone
<replaceable>zone</replaceable>:<replaceable>host</replaceable></literal>
arguments to the <command>nova boot</command> command. For example:</para>
<para>
<screen><prompt>$</prompt> <userinput>nova boot --image &lt;uuid&gt; --flavor m1.tiny --key_name test --availability-zone nova:server2</userinput></screen>
</para>
<para>Starting with the Grizzly release, you can specify which roles are permitted to boot
an instance to a specific host with the <literal>create:forced_host</literal> setting
within <filename>policy.json</filename> on the desired roles. By default, only the admin
role has this setting enabled.</para>
<para>You can view the list of valid compute hosts by using the <command>nova
hypervisor-list </command>command, for
example:<screen><prompt>$</prompt> <userinput>nova hypervisor-list</userinput>
<computeroutput>+----+---------------------+
| ID | Hypervisor hostname |
+----+---------------------+
| 1 | server2 |
| 2 | server3 |
| 3 | server4 |
+----+---------------------+</computeroutput></screen></para>
<note>
<para>The <literal>--availability_zone
<replaceable>zone</replaceable>:<replaceable>host</replaceable></literal>
flag replaced the <literal>--force_hosts</literal> scheduler hint for specifying a
specific host, starting with the Folsom release.</para>
</note>
</section>