openstack-manuals/doc/user-guide-admin/section_nova_specify_host.xml
Diane Fleming 69b79de7b9 Update headings plus edits for consistency and clarity in End and Admin User Guides
Partial-Bug: #1250515

author: diane fleming

Change-Id: I0ae7f3da1ef0bf9af4900097d527e2cd7b94c966
backport: havana
2013-11-16 14:41:21 -06:00

63 lines
2.8 KiB
XML

<?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 hosts where instances are launched</title>
<para>With the appropriate permissions, you can select on which
host instances are launched and which roles can boot instances
on this host.</para>
<procedure>
<step>
<para>To select the host where instances are launched, use
the <literal>--availability_zone
<replaceable>zone</replaceable>:<replaceable>host</replaceable></literal>
parameter on the <command>nova boot</command> command, </para>
<para>For example:</para>
<screen><prompt>$</prompt> <userinput>nova boot --image &lt;uuid&gt; --flavor m1.tiny --key_name test --availability-zone nova:server2</userinput></screen>
</step>
<step>
<para>To specify which roles can launch an instance on a
specified host, enable the
<literal>create:forced_host</literal> option in
the <filename>policy.json</filename> file. By default,
this option is enabled for only the admin role.</para>
</step>
<step>
<para>To view the list of valid compute hosts, use the
<command>nova hypervisor-list</command> command,
as follows:</para>
<screen><prompt>$</prompt> <userinput>nova hypervisor-list</userinput>
<computeroutput>+----+---------------------+
| ID | Hypervisor hostname |
+----+---------------------+
| 1 | server2 |
| 2 | server3 |
| 3 | server4 |
+----+---------------------+</computeroutput></screen>
</step>
</procedure>
<note>
<para>
<itemizedlist>
<listitem>
<para>Beginning in the Folsom release, the
<literal>--availability_zone
<replaceable>zone</replaceable>:<replaceable>host</replaceable></literal>
parameter replaces the
<literal>--force_hosts</literal> scheduler
hint parameter.</para>
</listitem>
<listitem>
<para>Beginning in the Grizzly release, you can
enable the
<literal>create:forced_host</literal>
option in the <filename>policy.json</filename>
file to specify which roles can launch an
instance on a specified host.</para>
</listitem>
</itemizedlist>
</para>
</note>
</section>