<?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 &lt;command_name&gt; </programlisting>
        </step>
    </procedure></section>
