openstack/openstack-manuals
Code Issues Proposed changes

UG edits: cli_nova_manage_instances section

Browse Source 
- Breaking up https://review.openstack.org/#/c/89581/
- cli_nova_manage_instances and associated files

Change-Id: I301ea42b29690a67859e3ac600817792ca76afcf
This commit is contained in:
Karin Levenstein 2014-04-24 09:54:52 -04:00
parent 2cae2e7f2d
commit 2ce3d3aea0
9 changed files with 266 additions and 258 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

165
doc/common/section_cli_nova_baremetal.xml
View File

@ -2,56 +2,64 @@
<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>The bare metal driver for OpenStack Compute manages <para>The bare-metal driver for OpenStack Compute manages provisioning of
provisioning of physical hardware using common cloud APIs and physical hardware by using common cloud APIs and tools such as Orchestration
tools such as Orchestration (Heat). The use case for this driver (Heat). The use case for this driver is for single tenant clouds such as a
is for single tenant clouds such as a high-performance computing high-performance computing cluster or for deploying OpenStack itself.</para>
cluster or deploying OpenStack itself. Development efforts are <para>If you use the bare-metal driver, you must create a network interface
focused on moving the driver out of the Compute code base in the and add it to a bare-metal node. Then, you can launch an instance from a
Icehouse release. If you use the bare metal driver, you must bare-metal image.</para>
create and add a network interface to a bare metal node. Then, you <note><para>Development efforts are focused on moving the driver out of the Compute
can launch an instance from a bare metal image.</para> code base in the Icehouse release.</para></note>
<para>You can list and delete bare metal nodes. When you delete a <para>You can list and delete bare-metal nodes. When you delete a node, any
node, any associated network interfaces are removed. You can list associated network interfaces are removed. You can list and remove network
and remove network interfaces that are associated with a bare interfaces that are associated with a bare-metal node.</para>
metal node.</para>
<itemizedlist> <itemizedlist>
<title>Commands</title> <title>Commands</title>
<para>The following commands can be used to manage bare-metal nodes.</para>
<listitem> <listitem>
<para><command>baremetal-interface-add</command>. Adds a network <para><command>baremetal-interface-add</command>. Adds a network interface
interface to a bare metal node.</para> to a bare-metal node.</para>
</listitem> </listitem>
<listitem> <listitem>
<para><command>baremetal-interface-list</command>. Lists network <para><command>baremetal-interface-list</command>. Lists network
interfaces associated with a bare metal node.</para> interfaces associated with a bare-metal node.</para>
</listitem> </listitem>
<listitem> <listitem>
<para><command>baremetal-interface-remove</command>. Removes a <para><command>baremetal-interface-remove</command>. Removes a network
network interface from a bare metal node.</para> interface from a bare-metal node.</para>
</listitem> </listitem>
<listitem> <listitem>
<para><command>baremetal-node-create</command>. Creates a bare <para><command>baremetal-node-create</command>. Creates a bare-metal
metal node.</para> node.</para>
</listitem> </listitem>
<listitem> <listitem>
<para><command>baremetal-node-delete</command>. Removes a bare <para><command>baremetal-node-delete</command>. Removes a bare-metal node
metal node and any associated interfaces.</para> and any associated interfaces.</para>
</listitem> </listitem>
<listitem> <listitem>
<para><command>baremetal-node-list</command>. Lists available <para><command>baremetal-node-list</command>. Lists available bare-metal
bare metal nodes.</para> nodes.</para>
</listitem> </listitem>
<listitem> <listitem>
<para><command>baremetal-node-show</command>. Shows information <para><command>baremetal-node-show</command>. Shows information about a
about a bare metal node.</para> bare-metal node.</para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
<procedure> <section xml:id="cli_nova_baremetal-create">
<step> <title>Create a bare-metal node</title>
<para>Create a bare metal node:</para> <para>When you create a bare-metal node, your PM address, username, and
<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> password should match those that are configured in your hardware's
<screen><computeroutput>+------------------+-------------------+ BIOS/IPMI configuration.</para>
<screen><prompt>$</prompt> <userinput>nova baremetal-node-create --pm_address=PM_ADDRESS --pm_user=PM_USERNAME \
--pm_password=PM_PASSWORD $(hostname -f) 1 512 10 aa:bb:cc:dd:ee:ff</userinput></screen>
<para>The following example shows the command and results from creating
a node with the PM address <filename>1.2.3.4</filename>, the PM username
<literal>ipmi</literal>, and password <literal>ipmi</literal>.</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>
<computeroutput>+------------------+-------------------+
| Property | Value | | Property | Value |
+------------------+-------------------+ +------------------+-------------------+
| instance_uuid | None | | instance_uuid | None |
@ -66,51 +74,64 @@
| id | 1 | | id | 1 |
| pm_user | ipmi | | pm_user | ipmi |
| terminal_port | None | | terminal_port | None |
+------------------+-------------------+</computeroutput></screen> +------------------+-------------------+</computeroutput></screen></section>
</step> <section xml:id="cli_nova_baremetal-interface">
<step> <title>Add a network interface to the node:</title>
<para>Add a network interface to the node:</para> <para>For each NIC on the node, you must create an interface, specifying the
<screen><prompt>$</prompt> <userinput>nova baremetal-interface-add 1 aa:bb:cc:dd:ee:ff</userinput></screen> interface's MAC address.</para>
<screen><computeroutput>+-------------+-------------------+ <screen><prompt>$</prompt> <userinput>nova baremetal-interface-add 1 aa:bb:cc:dd:ee:ff</userinput>
<computeroutput>+-------------+-------------------+
| Property | Value | | Property | Value |
+-------------+-------------------+ +-------------+-------------------+
| datapath_id | 0 | | datapath_id | 0 |
| id | 1 | | id | 1 |
| port_no | 0 | | port_no | 0 |
| address | aa:bb:cc:dd:ee:ff | | address | aa:bb:cc:dd:ee:ff |
+-------------+-------------------+</computeroutput></screen> +-------------+-------------------+</computeroutput></screen></section>
</step> <section xml:id="cli_nova_baremetal-instancelaunch">
<step> <title>Launch an instance
<para>Launch an instance from a bare metal image:</para> from a bare-metal image:</title>
<screen><prompt>$</prompt> <userinput>nova boot --image my-baremetal-image --flavor my-baremetal-flavor test</userinput> </screen> <para>A bare-metal instance is an instance created directly on a physical
<screen><computeroutput>+-----------------------------+--------------------------------------+ machine without any virtualization layer running underneath it. Nova
retains power control via IPMI. In some situations, Nova may retain
network control via Neutron and OpenFlow.</para>
<screen><prompt>$</prompt> <userinput>nova boot --image my-baremetal-image --flavor my-baremetal-flavor test</userinput>
<computeroutput>+-----------------------------+--------------------------------------+
| Property | Value | | Property | Value |
+-----------------------------+--------------------------------------+ +-----------------------------+--------------------------------------+
| status | BUILD | | status | BUILD |
| id | cc302a8f-cd81-484b-89a8-b75eb3911b1b | | id | cc302a8f-cd81-484b-89a8-b75eb3911b1b |
... wait for instance to become active ...</computeroutput></screen> ... wait for instance to become active ...</computeroutput></screen>
</step> <note>
<step> <para>Set the <parameter>--availability_zone</parameter> parameter to
<para>List bare metal nodes and interfaces:</para> specify which zone or node to use to start the server. Separate the zone
<screen><prompt>$</prompt> <userinput>nova baremetal-node-list</userinput></screen> from the host name with a comma. For example:</para>
<para>When a node is in use, its status includes the UUID of the <screen><prompt>$</prompt> <userinput>nova boot --availability_zone=zone:<replaceable>HOST</replaceable>,<replaceable>NODE</replaceable></userinput></screen>
instance that runs on it:</para> <para><literal>host</literal> is optional for the
<screen><computeroutput>+----+--------+------+-----------+---------+------------------- <literal>--availability_zone</literal> parameter. You can specify
+------+------------+-------------+-------------+---------------+ simply <literal>zone:,node</literal>. You must still use the
| ID | Host | CPUs | Memory_MB | Disk_GB | MAC Address comma.</para>
| VLAN | PM Address | PM Username | PM Password | Terminal Port | </note>
+----+--------+------+-----------+---------+------------------- </section>
+------+------------+-------------+-------------+---------------+ <section xml:id="cli_nova_baremetal-list">
| 1 | ubuntu | 1 | 512 | 10 | aa:bb:cc:dd:ee:ff <title>List bare-metal nodes and
| None | 1.2.3.4 | ipmi | | None | interfaces:</title>
+----+--------+------+-----------+---------+------------------- <para>Use the <command>nova baremetal-node-list</command> command to view
+------+------------+-------------+-------------+---------------+</computeroutput></screen> all bare-metal nodes and interfaces. When a node is in use, its status
</step> includes the UUID of the instance that runs on it:</para>
<step> <screen><prompt>$</prompt> <userinput>nova baremetal-node-list</userinput>
<para>Show details for a bare metal node:</para> <computeroutput>+----+--------+------+-----------+---------+-------------------+------+------------+-------------+-------------+---------------+
<screen><prompt>$</prompt> <userinput>nova baremetal-node-show 1</userinput> </screen> | ID | Host | CPUs | Memory_MB | Disk_GB | MAC Address | VLAN | PM Address | PM Username | PM Password | Terminal Port |
<screen><computeroutput>+------------------+--------------------------------------+ +----+--------+------+-----------+---------+-------------------+------+------------+-------------+-------------+---------------+
| 1 | ubuntu | 1 | 512 | 10 | aa:bb:cc:dd:ee:ff | None | 1.2.3.4 | ipmi | | None |
+----+--------+------+-----------+---------+-------------------+------+------------+-------------+-------------+---------------+</computeroutput></screen></section>
<section xml:id="cli_nova_baremetal-details">
<title>Show details for a bare-metal node:</title>
<para>Use the <command>nova baremetal-node-list</command> command to view
the details for a bare-metal node.</para>
<screen><prompt>$</prompt> <userinput>nova baremetal-node-show 1</userinput>
<computeroutput>+------------------+--------------------------------------+
| Property | Value | | Property | Value |
+------------------+--------------------------------------+ +------------------+--------------------------------------+
| instance_uuid | cc302a8f-cd81-484b-89a8-b75eb3911b1b | | instance_uuid | cc302a8f-cd81-484b-89a8-b75eb3911b1b |
@ -126,17 +147,5 @@
| id | 1 | | id | 1 |
| pm_user | ipmi | | pm_user | ipmi |
| terminal_port | None | | terminal_port | None |
+------------------+--------------------------------------+</computeroutput></screen> +------------------+--------------------------------------+</computeroutput></screen></section>
</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> </section>

10
doc/common/section_cli_nova_get_console.xml
View File

@ -4,14 +4,16 @@
xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:svg="http://www.w3.org/2000/svg" xmlns:svg="http://www.w3.org/2000/svg"
xmlns:html="http://www.w3.org/1999/xhtml" version="5.0"> xmlns:html="http://www.w3.org/1999/xhtml" version="5.0">
<title>Get a console to access an instance</title> <title>Access an instance through a console</title>
<procedure> <step><para>To get a VNC console to access an instance, run the following <para>To access an instance through a VNC console, run the
command:</para> <screen><prompt>$</prompt> <userinput>nova get-vnc-console myCirrosServer xvpvnc</userinput></screen> following command:</para> <screen><prompt>$</prompt> <userinput>nova get-vnc-console <replaceable>INSTANCE_NAME</replaceable> xvpvnc</userinput></screen>
<para>The command returns a URL from which you can access your instance:</para> <para>The command returns a URL from which you can access your instance:</para>
<screen><computeroutput>+--------+------------------------------------------------------------------------------+ <screen><computeroutput>+--------+------------------------------------------------------------------------------+
| Type | Url | | Type | Url |
+--------+------------------------------------------------------------------------------+ +--------+------------------------------------------------------------------------------+
| xvpvnc | http://166.78.190.96:6081/console?token=c83ae3a3-15c4-4890-8d45-aefb494a8d6c | | xvpvnc | http://166.78.190.96:6081/console?token=c83ae3a3-15c4-4890-8d45-aefb494a8d6c |
+--------+------------------------------------------------------------------------------+</computeroutput></screen> +--------+------------------------------------------------------------------------------+</computeroutput></screen>
<note><para>To get a non-VNC console, specify the <parameter>novnc</parameter> parameter instead of the <parameter>xvpvnc</parameter> parameter.</para></note></step></procedure> <note><para>To access an instance through a non-VNC console, specify the
<parameter>novnc</parameter> parameter instead of the
<parameter>xvpvnc</parameter> parameter.</para></note>
</section> </section>

62
doc/common/section_cli_nova_resizerebuild.xml
View File

@ -7,24 +7,10 @@
<para>You change the size of a server by changing its flavor.</para> <para>You change the size of a server by changing its flavor.</para>
<procedure> <procedure>
<step> <step>
<para>List the available flavors:</para> <para>Show information about your server, including its size, which is shown as the value of the flavor
<screen><prompt>$</prompt> <userinput>nova flavor-list</userinput></screen> property.</para>
<screen><computeroutput>+----+-----------+-----------+------+-----------+------+-------+-------------+-----------+ <screen><prompt>$</prompt> <userinput>nova show myCirrosServer</userinput>
| ID | Name | Memory_MB | Disk | Ephemeral | Swap | VCPUs | RXTX_Factor | Is_Public | <computeroutput>+-------------------------------------+----------------------------------------------------------------+
+----+-----------+-----------+------+-----------+------+-------+-------------+-----------+
| 1 | m1.tiny | 512 | 0 | 0 | | 1 | 1.0 | True |
| 2 | m1.small | 2048 | 20 | 0 | | 1 | 1.0 | True |
| 3 | m1.medium | 4096 | 40 | 0 | | 2 | 1.0 | True |
| 4 | m1.large | 8192 | 80 | 0 | | 4 | 1.0 | True |
| 5 | m1.xlarge | 16384 | 160 | 0 | | 8 | 1.0 | True |
+----+-----------+-----------+------+-----------+------+-------+-------------+-----------+</computeroutput></screen>
</step>
<step>
<para>Show information about your server, including its
size:</para>
<screen><prompt>$</prompt> <userinput>nova show myCirrosServer</userinput></screen>
<screen><computeroutput>+-------------------------------------+----------------------------------------------------------------+
| Property | Value | | Property | Value |
+-------------------------------------+----------------------------------------------------------------+ +-------------------------------------+----------------------------------------------------------------+
| status | ACTIVE | | status | ACTIVE |
@ -54,13 +40,24 @@
| OS-EXT-AZ:availability_zone | nova | | OS-EXT-AZ:availability_zone | nova |
| config_drive | | | config_drive | |
+-------------------------------------+----------------------------------------------------------------+</computeroutput></screen> +-------------------------------------+----------------------------------------------------------------+</computeroutput></screen>
<para>The size of the server is <literal>m1.small <para>The size (flavor) of the server is <literal>m1.small (2)</literal>.</para>
(2)</literal>.</para>
</step> </step>
<step> <step>
<para>To resize the server, pass the server ID and the desired <para>List the available flavors with the following command:</para>
flavor to the nova <command>resize</command> command. Include <screen><prompt>$</prompt> <userinput>nova flavor-list</userinput>
the <literal>--poll</literal> parameter to report the resize <computeroutput>+----+-----------+-----------+------+-----------+------+-------+-------------+-----------+
| ID | Name | Memory_MB | Disk | Ephemeral | Swap | VCPUs | RXTX_Factor | Is_Public |
+----+-----------+-----------+------+-----------+------+-------+-------------+-----------+
| 1 | m1.tiny | 512 | 0 | 0 | | 1 | 1.0 | True |
| 2 | m1.small | 2048 | 20 | 0 | | 1 | 1.0 | True |
| 3 | m1.medium | 4096 | 40 | 0 | | 2 | 1.0 | True |
| 4 | m1.large | 8192 | 80 | 0 | | 4 | 1.0 | True |
| 5 | m1.xlarge | 16384 | 160 | 0 | | 8 | 1.0 | True |
+----+-----------+-----------+------+-----------+------+-------+-------------+-----------+</computeroutput></screen>
</step>
<step>
<para>To resize the server, pass the server ID or name and the new flavor to the <command>nova
resize</command> command. Include the <literal>--poll</literal> parameter to report the resize
progress.</para> progress.</para>
<screen><prompt>$</prompt> <userinput>nova resize myCirrosServer 4 --poll</userinput></screen> <screen><prompt>$</prompt> <userinput>nova resize myCirrosServer 4 --poll</userinput></screen>
<screen><computeroutput>Instance resizing... 100% complete <screen><computeroutput>Instance resizing... 100% complete
@ -68,24 +65,23 @@ Finished</computeroutput> </screen>
</step> </step>
<step> <step>
<para>Show the status for your server:</para> <para>Show the status for your server:</para>
<screen><prompt>$</prompt> <userinput>nova list</userinput></screen> <screen><prompt>$</prompt> <userinput>nova list</userinput>
<screen><computeroutput>+--------------------------------------+-------------+--------+-----------------------------------------+ <computeroutput>+--------------------------------------+----------------+--------+-----------------------------------------+
| ID | Name | Status | Networks | | ID | Name | Status | Networks |
+--------------------------------------+-------------+--------+-----------------------------------------+ +--------------------------------------+----------------+--------+-----------------------------------------+
| 970e4ca0-f9b7-4c44-80ed-bf0152c96ae1 | resize-demo | RESIZE | private=172.16.101.6, public=10.4.113.6 | | 84c6e57d-a6b1-44b6-81eb-fcb36afd31b5 | myCirrosServer | RESIZE | private=172.16.101.6, public=10.4.113.6 |
+--------------------------------------+-------------+--------+-----------------------------------------+</computeroutput></screen> +--------------------------------------+----------------+--------+-----------------------------------------+</computeroutput></screen>
<para>When the resize completes, the status becomes VERIFY_RESIZE.</para>
</step> </step>
<step> <step>
<para>When the resize completes, the status becomes <para>Confirm the resize:</para>
<literal>VERIFY_RESIZE</literal>. To confirm the <screen><prompt>$</prompt> <userinput>nova resize-confirm 84c6e57d-a6b1-44b6-81eb-fcb36afd31b5</userinput></screen>
resize:</para>
<screen><prompt>$</prompt> <userinput>nova resize-confirm 6beefcf7-9de6-48b3-9ba9-e11b343189b3</userinput></screen>
<para>The server status becomes ACTIVE.</para> <para>The server status becomes ACTIVE.</para>
</step> </step>
<step> <step>
<para>If the resize fails or does not work as expected, you can <para>If the resize fails or does not work as expected, you can
revert the resize:</para> revert the resize:</para>
<screen><prompt>$</prompt> <userinput>nova resize-revert 6beefcf7-9de6-48b3-9ba9-e11b343189b3</userinput></screen> <screen><prompt>$</prompt> <userinput>nova resize-revert 84c6e57d-a6b1-44b6-81eb-fcb36afd31b5</userinput></screen>
<para>The server status becomes ACTIVE.</para> <para>The server status becomes ACTIVE.</para>
</step> </step>
</procedure> </procedure>

19
doc/common/section_cli_nova_search_ip.xml
View File

@ -5,21 +5,16 @@ xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xlink="http://www.w3.org/1999/xlink"
xml:id="search_ip" version="5.0"> xml:id="search_ip" version="5.0">
<title>Search for an instance using IP address</title> <title>Search for an instance using IP address</title>
<para>You can search for an instance using the IP address parameter.</para> <para>You can search for an instance using the IP address parameter,
<procedure> <literal>--ip</literal>, with the <command>nova list</command>
<step> command.</para>
<para>Use the --<parameter>ip</parameter> to search for an instance <screen><prompt>$</prompt> <userinput>nova list --<parameter>ip</parameter> <replaceable>IP_ADDRESS</replaceable> </userinput></screen>
using the IP address.</para> <para>The following example shows the results of a search on
<screen><prompt>$</prompt> <userinput>nova list --<parameter>ip</parameter> <replaceable>IP_ADDRESS</replaceable> </userinput> <filename>10.0.0.4</filename>.</para>
</screen>
<para>For example, use the <command>nova list</command> command as follows:</para>
<screen><prompt>$</prompt> <userinput>nova list --<parameter>ip</parameter> <replaceable>10.0.0.4</replaceable></userinput> <screen><prompt>$</prompt> <userinput>nova list --<parameter>ip</parameter> <replaceable>10.0.0.4</replaceable></userinput>
<computeroutput>+--------------------------------------+----------------------+--------+------------+-------------+------------------+ <computeroutput>+--------------------------------------+----------------------+--------+------------+-------------+------------------+
| ID | Name | Status | Task State | Power State | Networks | | ID | Name | Status | Task State | Power State | Networks |
+--------------------------------------+----------------------+--------+------------+-------------+------------------+ +--------------------------------------+----------------------+--------+------------+-------------+------------------+
| 8a99547e-7385-4ad1-ae50-4ecfaaad5f42 | myInstanceFromVolume | ACTIVE | None | Running | private=10.0.0.4 | | 8a99547e-7385-4ad1-ae50-4ecfaaad5f42 | myInstanceFromVolume | ACTIVE | None | Running | private=10.0.0.4 |
+--------------------------------------+----------------------+--------+------------+-------------+------------------+</computeroutput> +--------------------------------------+----------------------+--------+------------+-------------+------------------+</computeroutput></screen>
</screen>
</step>
</procedure>
</section> </section>

54
doc/common/section_cli_nova_startstop.xml
View File

@ -7,38 +7,38 @@
<para>Use one of the following methods to stop and start an <para>Use one of the following methods to stop and start an
instance.</para> instance.</para>
<section xml:id="pause_server"> <section xml:id="pause_server">
<title>Pause and un-pause an instance</title> <title>Pause and unpause an instance</title>
<procedure xml:id="nova_cli_pause_unpause"> <itemizedlist>
<step> <listitem>
<para>To pause a server, run the following command:</para> <para>To pause an instance, run the following command:</para>
<screen><prompt>$</prompt> <userinput>nova pause <replaceable>SERVER</replaceable></userinput> </screen> <screen><prompt>$</prompt> <userinput>nova pause <replaceable>INSTANCE_NAME</replaceable></userinput> </screen>
<para>This command stores the state of the VM in RAM. A paused <para>This command stores the state of the VM in RAM. A paused
instance continues to run in a frozen state.</para> instance continues to run in a frozen state.</para></listitem>
<para>To un-pause the server, run the following <listitem><para>To unpause the instance, run the following command:</para>
command:</para> <screen><prompt>$</prompt> <userinput>nova unpause <replaceable>INSTANCE_NAME</replaceable></userinput> </screen>
<screen><prompt>$</prompt> <userinput>nova unpause <replaceable>SERVER</replaceable></userinput> </screen> </listitem>
</step> </itemizedlist>
</procedure>
</section> </section>
<section xml:id="suspend_resume"> <section xml:id="suspend_resume">
<title>Suspend and resume an instance</title> <title>Suspend and resume an instance</title>
<procedure xml:id="nova_cli_suspend_resume"> <itemizedlist>
<para>Administrative users might want to suspend an infrequently <para>Administrative users might want to suspend an instance if
used instance or to perform system maintenance.</para> it is infrequently used or to perform system maintenance. When
<step> you suspend an instance, its VM state is stored on disk, all
<para>When you suspend an instance, its VM state is stored on memory is written to disk, and the virtual machine is stopped.
disk, all memory is written to disk, and the virtual machine Suspending an instance is similar to placing a device in
is stopped. Suspending an instance is similar to placing a hibernation; memory and vCPUs become available to create other
device in hibernation; memory and vCPUs become instances.</para>
available.</para> <listitem>
<para>To initiate a hypervisor-level suspend operation, run <para>To initiate a hypervisor-level suspend operation, run
the following command:</para> the following command:</para>
<screen><prompt>$</prompt> <userinput>nova suspend <replaceable>SERVER</replaceable></userinput></screen> <screen><prompt>$</prompt> <userinput>nova suspend <replaceable>INSTANCE_NAME</replaceable></userinput></screen>
</step> </listitem>
<step> <listitem>
<para>To resume a suspended server:</para> <para>To resume a suspended instance, run the following
<screen><prompt>$</prompt> <userinput>nova resume <replaceable>SERVER</replaceable></userinput></screen> command:</para>
</step> <screen><prompt>$</prompt> <userinput>nova resume <replaceable>INSTANCE_NAME</replaceable></userinput></screen>
</procedure> </listitem>
</itemizedlist>
</section> </section>
</section> </section>

10
doc/common/section_cli_nova_terminate.xml
View File

@ -18,13 +18,11 @@
| d7efd3e4-d375-46d1-9d57-372b6e4bdb7f | newServer | ERROR | None | NOSTATE | | | d7efd3e4-d375-46d1-9d57-372b6e4bdb7f | newServer | ERROR | None | NOSTATE | |
+--------------------------------------+----------------------+--------+------------+-------------+------------------+</computeroutput></screen> +--------------------------------------+----------------------+--------+------------+-------------+------------------+</computeroutput></screen>
</step><step> </step><step>
<para>Use the following command to delete the <para>Run the <command>nova delete</command> command to delete the instance. The following example shows deletion
<literal>newServer</literal> instance, which is in of the <filename>newServer</filename> instance, which is in <literal>ERROR</literal> state:</para>
<literal>ERROR</literal> state:</para>
<screen><prompt>$</prompt> <userinput>nova delete newServer</userinput></screen> <screen><prompt>$</prompt> <userinput>nova delete newServer</userinput></screen>
</step><step><para>The command does not notify that your server was deleted.</para> <para>The command does not notify that your server was deleted.</para></step><step>
<para>Instead, run the <command>nova list</command> <para>To verify that the server was deleted, run the <command>nova list</command> command:</para>
command:</para>
<screen><prompt>$</prompt> <userinput>nova list</userinput> <screen><prompt>$</prompt> <userinput>nova list</userinput>
<computeroutput>+--------------------------------------+----------------------+--------+------------+-------------+------------------+ <computeroutput>+--------------------------------------+----------------------+--------+------------+-------------+------------------+
| ID | Name | Status | Task State | Power State | Networks | | ID | Name | Status | Task State | Power State | Networks |

92
doc/common/section_cli_nova_usage_statistics.xml
View File

@ -3,17 +3,23 @@
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="usage_statistics"> xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="usage_statistics">
<title>Show usage statistics for hosts and instances</title><para xlink:href="http://graphite.wikidot.com">You can show basic <title>Show usage statistics for hosts and instances</title><para xlink:href="http://graphite.wikidot.com">You can show basic
statistics on resource usage for hosts and instances.</para> statistics on resource usage for hosts and instances.</para>
<note> <para xlink:href="http://graphite.wikidot.com">For more sophisticated <note>
<para xlink:href="http://graphite.wikidot.com">For more sophisticated
monitoring, see the <link monitoring, see the <link
xlink:href="https://launchpad.net/ceilometer" xlink:href="https://launchpad.net/ceilometer"
>Ceilometer</link> project, which is under >Ceilometer</link> project, which is under
development. You can also use tools, such as <link development. You can also use tools, such as <link
xlink:href="http://ganglia.info/">Ganglia</link> or xlink:href="http://ganglia.info/">Ganglia</link> or
<link xlink:href="http://graphite.wikidot.com/" <link xlink:href="http://graphite.wikidot.com/"
>Graphite</link>, to gather more detailed data.</para></note> >Graphite</link>, to gather more detailed data.</para>
<procedure xml:id="host_usage_statistics"> </note>
<title>To show host usage statistics</title> <section xml:id="host_usage_statistics">
<step><para>List the hosts and the nova-related services that run on <title>Show host usage statistics</title>
<para>The following examples show the host usage statistics for a host
called <filename>devstack</filename>.</para>
<itemizedlist>
<listitem>
<para>List the hosts and the nova-related services that run on
them:</para><screen><prompt>$</prompt> <userinput>nova host-list</userinput> them:</para><screen><prompt>$</prompt> <userinput>nova host-list</userinput>
<computeroutput>+-----------+-------------+----------+ <computeroutput>+-----------+-------------+----------+
| host_name | service | zone | | host_name | service | zone |
@ -24,12 +30,11 @@
| devstack | network | internal | | devstack | network | internal |
| devstack | scheduler | internal | | devstack | scheduler | internal |
| devstack | consoleauth | internal | | devstack | consoleauth | internal |
+-----------+-------------+----------+</computeroutput></screen> +-----------+-------------+----------+</computeroutput></screen></listitem>
</step> <listitem><para>Get a summary of resource usage of all of the instances running on
<step><para>Get a summary of resource usage of all of the instances running the host:</para>
on the host.</para> <screen><prompt>$</prompt> <userinput>nova host-describe devstack</userinput>
<screen><prompt>$</prompt> <userinput>nova host-describe <replaceable>devstack</replaceable></userinput> <computeroutput>+-----------+----------------------------------+-----+-----------+---------+
<computeroutput>+-----------+----------------------------------+-----+-----------+---------+
| HOST | PROJECT | cpu | memory_mb | disk_gb | | HOST | PROJECT | cpu | memory_mb | disk_gb |
+----------+----------------------------------+-----+-----------+---------+ +----------+----------------------------------+-----+-----------+---------+
| devstack | (total) | 2 | 4003 | 157 | | devstack | (total) | 2 | 4003 | 157 |
@ -40,38 +45,43 @@
+----------+----------------------------------+-----+-----------+---------+</computeroutput></screen> +----------+----------------------------------+-----+-----------+---------+</computeroutput></screen>
<para>The <literal>cpu</literal> column shows the sum of <para>The <literal>cpu</literal> column shows the sum of
the virtual CPUs for instances running on the host.</para> the virtual CPUs for instances running on the host.</para>
<para>The <literal>memory_mb</literal> column shows the <para>The <literal>memory_mb</literal> column shows the sum of the
sum of the memory (in MB) allocated to the instances memory (in MB) allocated to the instances that run on the
that run on the hosts.</para> host.</para>
<para>The <literal>disk_gb</literal> column shows the sum <para>The <literal>disk_gb</literal> column shows the sum of the
of the root and ephemeral disk sizes (in GB) of the root and ephemeral disk sizes (in GB) of the instances that
instances that run on the hosts.</para> run on the host.</para>
<para>The <literal>used_now</literal> row shows the sum <para>The row that has the value <literal>used_now</literal> in the
of the resources allocated to the instances <literal>PROJECT</literal> column shows the sum of the
that run on the host plus the resources allocated to resources allocated to the instances that run on the host,
the virtual machine of the host itself.</para> plus the resources allocated to the virtual machine of the
<para>The <literal>used_max</literal> row shows the sum host itself.</para>
of the resources allocated to the instances <para>The row that has the value <literal>used_max</literal> row in
that run on the host.</para> the <literal>PROJECT</literal> column shows the sum of the
<note> <para>These values are computed by using only information resources allocated to the instances that run on the
about the flavors of the instances that run on the host.</para></listitem>
hosts. This command does not query the CPU usage, </itemizedlist>
memory usage, or hard disk usage of the physical <note>
host.</para> </note> </step> </procedure> <para>These values are computed by using information about the flavors of the
<procedure xml:id="instance_usage_statistics"> instances that run on the hosts. This command does not query the
<title>To show instance usage statistics</title> CPU usage, memory usage, or hard disk usage of the physical
<step> host.</para>
<para>Get CPU, memory, I/O, and network statistics for an </note>
</section>
<section xml:id="instance_usage_statistics">
<title>Show instance usage statistics</title>
<itemizedlist>
<listitem><para>Get CPU, memory, I/O, and network statistics for an
instance.</para> instance.</para>
<para>First, list instances:</para> <orderedlist><listitem><para>List instances:</para>
<screen><prompt>$</prompt> <userinput>nova list</userinput> <screen><prompt>$</prompt> <userinput>nova list</userinput>
<computeroutput>+--------------------------------------+----------------------+--------+------------+-------------+------------------+ <computeroutput>+--------------------------------------+----------------------+--------+------------+-------------+------------------+
| ID | Name | Status | Task State | Power State | Networks | | ID | Name | Status | Task State | Power State | Networks |
+--------------------------------------+----------------------+--------+------------+-------------+------------------+ +--------------------------------------+----------------------+--------+------------+-------------+------------------+
| 84c6e57d-a6b1-44b6-81eb-fcb36afd31b5 | myCirrosServer | ACTIVE | None | Running | private=10.0.0.3 | | 84c6e57d-a6b1-44b6-81eb-fcb36afd31b5 | myCirrosServer | ACTIVE | None | Running | private=10.0.0.3 |
| 8a99547e-7385-4ad1-ae50-4ecfaaad5f42 | myInstanceFromVolume | ACTIVE | None | Running | private=10.0.0.4 | | 8a99547e-7385-4ad1-ae50-4ecfaaad5f42 | myInstanceFromVolume | ACTIVE | None | Running | private=10.0.0.4 |
+--------------------------------------+----------------------+--------+------------+-------------+------------------+</computeroutput></screen> +--------------------------------------+----------------------+--------+------------+-------------+------------------+</computeroutput></screen></listitem>
<para>Then, get diagnostic statistics:</para> <listitem><para>Get diagnostic statistics:</para>
<screen><prompt>$</prompt> <userinput>nova diagnostics myCirrosServer</userinput> <screen><prompt>$</prompt> <userinput>nova diagnostics myCirrosServer</userinput>
<computeroutput>+------------------+----------------+ <computeroutput>+------------------+----------------+
| Property | Value | | Property | Value |
@ -91,9 +101,8 @@
| vnet1_rx_packets | 5485 | | vnet1_rx_packets | 5485 |
| vda_read_req | 0 | | vda_read_req | 0 |
| vda_errors | -1 | | vda_errors | -1 |
+------------------+----------------+</computeroutput></screen> +------------------+----------------+</computeroutput></screen></listitem></orderedlist></listitem>
</step> <listitem><para>Get summary statistics for each tenant:</para>
<step> <para>Get summary statistics for each tenant:</para>
<screen><prompt>$</prompt> <userinput>nova usage-list</userinput> <screen><prompt>$</prompt> <userinput>nova usage-list</userinput>
<computeroutput>Usage from 2013-06-25 to 2013-07-24: <computeroutput>Usage from 2013-06-25 to 2013-07-24:
+----------------------------------+-----------+--------------+-----------+---------------+ +----------------------------------+-----------+--------------+-----------+---------------+
@ -101,7 +110,6 @@
+----------------------------------+-----------+--------------+-----------+---------------+ +----------------------------------+-----------+--------------+-----------+---------------+
| b70d90d65e464582b6b2161cf3603ced | 1 | 344064.44 | 672.00 | 0.00 | | b70d90d65e464582b6b2161cf3603ced | 1 | 344064.44 | 672.00 | 0.00 |
| 66265572db174a7aa66eba661f58eb9e | 3 | 671626.76 | 327.94 | 6558.86 | | 66265572db174a7aa66eba661f58eb9e | 3 | 671626.76 | 327.94 | 6558.86 |
+----------------------------------+-----------+--------------+-----------+---------------+</computeroutput></screen> +----------------------------------+-----------+--------------+-----------+---------------+</computeroutput></screen></listitem></itemizedlist>
</step> </section>
</procedure>
</section> </section>

97
doc/user-guide/section_cli_nova_floating_ips.xml
View File

@ -6,35 +6,30 @@
<title>Manage IP addresses</title> <title>Manage IP addresses</title>
<para>Each instance can have a private, or fixed, IP address and a <para>Each instance can have a private, or fixed, IP address and a
public, or floating, one.</para> public, or floating, one.</para>
<para>Private IP addresses are used for communication between <para>Private IP addresses are used for communication between instances, and
instances, and public ones are used for communication with the public ones are used for communication with networks outside the cloud,
outside world.</para> including the Internet.</para>
<para>When you launch an instance, it is automatically assigned a <para>When you launch an instance, it is automatically assigned a
private IP address that stays the same until you explicitly private IP address that stays the same until you explicitly
terminate the instance. Rebooting an instance has no effect on terminate the instance. Rebooting an instance has no effect on
the private IP address.</para> the private IP address.</para>
<para>A pool of floating IPs, configured by the cloud operator, is <para>A pool of floating IP addresses, configured by the cloud operator, is
available in OpenStack Compute.</para> available in OpenStack Compute. You can allocate a certain number of
<para>You can allocate a certain number of these to a project: The these IP addresses to a project. The maximum number of floating IP
maximum number of floating IP addresses per project is defined addresses per project is defined by the quota.</para>
by the quota.</para> <para>After you allocate floating IP addresses to a project, you can add a
<para>You can add a floating IP address from this set to an floating IP address from this set to an instance of the project. You can
instance of the project. Floating IP addresses can be assign a floating IP address to one instance at a time. Floating IP
dynamically disassociated and associated with other instances addresses can be disassociated from an instance and associated with
of the same project at any time.</para> another instance of the same project at any time.</para>
<para>Before you can assign a floating IP address to an instance,
you first must allocate floating IPs to a project. After
floating IP addresses have been allocated to the current
project, you can assign them to running instances.</para>
<para>You can assign a floating IP address to one instance at a
time.</para>
<section xml:id="floating_ips_proc"> <section xml:id="floating_ips_proc">
<title>List floating IP address information</title> <title>List floating IP address information</title>
<procedure> <itemizedlist>
<step> <listitem>
<para>To list all floating IP addresses:</para> <para>To list all floating IP addresses, run the following
<screen><prompt>$</prompt> <userinput>nova floating-ip-bulk-list</userinput></screen> command:</para>
<screen><computeroutput>+------------+---------------+---------------+--------+-----------+ <screen><prompt>$</prompt> <userinput>nova floating-ip-bulk-list</userinput>
<computeroutput>+------------+---------------+---------------+--------+-----------+
| project_id | address | instance_uuid | pool | interface | | project_id | address | instance_uuid | pool | interface |
+------------+---------------+---------------+--------+-----------+ +------------+---------------+---------------+--------+-----------+
| None | 172.24.4.225 | None | public | eth0 | | None | 172.24.4.225 | None | public | eth0 |
@ -58,10 +53,10 @@
| None | 192.168.253.5 | None | test | eth0 | | None | 192.168.253.5 | None | test | eth0 |
| None | 192.168.253.6 | None | test | eth0 | | None | 192.168.253.6 | None | test | eth0 |
+------------+---------------+---------------+--------+-----------+</computeroutput></screen> +------------+---------------+---------------+--------+-----------+</computeroutput></screen>
</step> </listitem>
<step> <listitem>
<para>To list all pools that provide floating IP <para>To list all pools that provide floating IP addresses, run
addresses:</para> the following command:</para>
<screen><prompt>$</prompt> <userinput>nova floating-ip-pool-list</userinput></screen> <screen><prompt>$</prompt> <userinput>nova floating-ip-pool-list</userinput></screen>
<screen><computeroutput>+--------+ <screen><computeroutput>+--------+
| name | | name |
@ -69,20 +64,20 @@
| public | | public |
| test | | test |
+--------+</computeroutput></screen> +--------+</computeroutput></screen>
</step> </listitem>
</procedure> </itemizedlist>
</section> </section>
<section xml:id="floating_ip_allocate"> <section xml:id="floating_ip_allocate">
<title>Assign floating IP addresses</title> <title>Assign floating IP addresses</title>
<para>You can assign floating IP addresses to a project or an <para>You can assign floating IP addresses to a project and to an
instance.</para> instance.</para>
<procedure> <procedure>
<step> <step>
<para>Allocate a floating IP address to the current <para>Run the following command to allocate a floating IP
project. If more than one IP address pool is address to the current project. If more than one IP address
available, you can specify the pool from which to pool is available, you can specify the pool from which to
allocate the IP address. This example specifies allocate the IP address. This example specifies the
the <literal>public</literal> pool:</para> <literal>public</literal> pool:</para>
<screen><prompt>$</prompt> <userinput>nova floating-ip-create public</userinput></screen> <screen><prompt>$</prompt> <userinput>nova floating-ip-create public</userinput></screen>
<screen><computeroutput>+--------------+-------------+----------+--------+ <screen><computeroutput>+--------------+-------------+----------+--------+
| Ip | Instance Id | Fixed Ip | Pool | | Ip | Instance Id | Fixed Ip | Pool |
@ -91,20 +86,9 @@
+--------------+-------------+----------+--------+</computeroutput></screen> +--------------+-------------+----------+--------+</computeroutput></screen>
</step> </step>
<step> <step>
<para>To release a floating IP address from the <para>After at least one floating IP address is allocated to the
current project:</para> project, assign an IP address to an instance in the project,
<screen><prompt>$</prompt> <userinput>nova floating-ip-delete <replaceable>FLOATING_IP</replaceable></userinput></screen> as follows:</para>
<para>The IP address is returned to the pool of IP
addresses that are available for all projects. If
an IP address is assigned to a running instance,
it is disassociated from the instance.</para>
</step>
<step>
<para>To associate an IP address with an instance, at
least one floating IP address must be allocated to
the current project.</para>
<para>To assign a floating IP address to an
instance:</para>
<screen><prompt>$</prompt> <userinput>nova add-floating-ip <replaceable>INSTANCE_NAME_OR_ID</replaceable> <replaceable>FLOATING_IP</replaceable></userinput></screen> <screen><prompt>$</prompt> <userinput>nova add-floating-ip <replaceable>INSTANCE_NAME_OR_ID</replaceable> <replaceable>FLOATING_IP</replaceable></userinput></screen>
<para>After you assign the IP address and configure <para>After you assign the IP address and configure
security group rules for the instance, the security group rules for the instance, the
@ -112,11 +96,20 @@
address.</para> address.</para>
</step> </step>
<step> <step>
<para>To remove a floating IP address from an <para>To remove a floating IP address from an instance, specify
instance, specify the same arguments that the same arguments that you used to assign the IP address,
you used to assign the IP address:</para> but run the following command:</para>
<screen><prompt>$</prompt> <userinput>nova remove-floating-ip <replaceable>INSTANCE_NAME_OR_ID</replaceable> <replaceable>FLOATING_IP</replaceable></userinput></screen> <screen><prompt>$</prompt> <userinput>nova remove-floating-ip <replaceable>INSTANCE_NAME_OR_ID</replaceable> <replaceable>FLOATING_IP</replaceable></userinput></screen>
</step> </step>
<step>
<para>To release a floating IP address from the current project,
run the following command:</para>
<screen><prompt>$</prompt> <userinput>nova floating-ip-delete <replaceable>FLOATING_IP</replaceable></userinput></screen>
<para>The IP address is returned to the pool of IP addresses
that are available for all projects. If an IP address is
assigned to a running instance, it is disassociated from the
instance.</para>
</step>
</procedure> </procedure>
</section> </section>
</section> </section>

11
doc/user-guide/section_cli_nova_manage_instances.xml
View File

@ -4,8 +4,15 @@
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
xml:id="cli_manage_instances"> xml:id="cli_manage_instances">
<title>Manage instances and hosts</title> <title>Manage instances and hosts</title>
<para>Instances are virtual machines that run inside the <para>Instances are virtual machines that run inside the cloud on
cloud.</para> physical compute nodes. The Compute service manages instances.
A host is the node on which a group of instances
resides.</para>
<para>This section describes how to perform the different tasks
involved in instance management, such as adding floating IP
addresses, stopping and starting instances, and terminating
instances. This section also discusses node management
tasks.</para>
<xi:include href="section_cli_nova_floating_ips.xml"/> <xi:include href="section_cli_nova_floating_ips.xml"/>
<xi:include href="../common/section_cli_nova_resizerebuild.xml"/> <xi:include href="../common/section_cli_nova_resizerebuild.xml"/>
<xi:include href="../common/section_cli_nova_search_ip.xml"/> <xi:include href="../common/section_cli_nova_search_ip.xml"/>