85 lines
4.5 KiB
XML
85 lines
4.5 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="install_openstack_heat_cli">
|
|
<title>Install OpenStack heat CLI</title>
|
|
<para>This example walks through installing the heat client. After
|
|
you install a client, you must configure environment variables
|
|
for authentication. </para>
|
|
<procedure>
|
|
<title>To install the heat client:</title>
|
|
<step>
|
|
<title>Install Python</title>
|
|
<para>Install Python 2.6 or later. Currently, the heat
|
|
client does not support Python 3. </para>
|
|
</step>
|
|
<step>
|
|
<title>Install the heat client package</title>
|
|
<para>Choose one of the following methods to install the
|
|
heat client package. <itemizedlist>
|
|
<listitem>
|
|
<para><emphasis role="bold">Recommended
|
|
method:</emphasis>
|
|
<command>pip</command></para>
|
|
<para>Install <command>pip</command> through
|
|
the package manager for your
|
|
system:<informaltable rules="all">
|
|
<col width="20%"/>
|
|
<col width="80%"/>
|
|
<thead>
|
|
<tr>
|
|
<th>System</th>
|
|
<th>Command</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td>Mac OS X</td>
|
|
<td>
|
|
<programlisting language="bash" role="gutter: false"><prompt>$</prompt> sudo easy_install pip</programlisting>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td>Ubuntu</td>
|
|
<td>
|
|
<programlisting language="bash" role="gutter: false"><prompt>$</prompt> aptitude install python-pip </programlisting>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td>RHEL, CentOS, or Fedora:</td>
|
|
<td>
|
|
<programlisting language="bash" role="gutter: false"><prompt>$</prompt> yum install python-pip</programlisting>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</informaltable></para>
|
|
<para>Run the following command to install the heat client package:
|
|
<programlisting language="bash" role="gutter: false"><prompt>$</prompt> sudo pip install python-heatclient</programlisting></para>
|
|
|
|
</listitem>
|
|
<listitem>
|
|
<para><emphasis role="bold"
|
|
>easy_install</emphasis></para>
|
|
<para>Run the following command to install the
|
|
heat client package: </para>
|
|
<programlisting language="bash" role="gutter: false"><prompt>$</prompt> sudo easy_install python-heatclient</programlisting>
|
|
</listitem>
|
|
</itemizedlist></para>
|
|
</step>
|
|
<step>
|
|
<title>Get help for heat client commands</title>
|
|
<para>To get help for heat client commands, run the
|
|
following command:</para>
|
|
<programlisting language="bash" role="gutter: false"><prompt>$</prompt> heat -h </programlisting>
|
|
<para>Depending on your user credentials, you may not have
|
|
permissions to use every command that is listed. The
|
|
heat client was written for use with recent
|
|
development versions of OpenStack.</para>
|
|
<para>To get help for a specific command, type the command
|
|
name after the <parameter>help</parameter> parameter,
|
|
as follows:</para>
|
|
<programlisting language="bash" role="gutter: false"><prompt>$</prompt> heat help <command_name> </programlisting>
|
|
</step>
|
|
</procedure></section>
|