openstack-manuals/doc/install-guide/ch_clients.xml
Andreas Jaeger 69afda54b5 Cleanup openrc.sh creation and usage
Consistently create and use PROJECT-openrc.sh files. This is the default
when you use the dashboard, so let's follow this everywhere. This makes
it also clearer which project is used.

Change-Id: I5e4604ed61b29e86193697171a9fc84f673fc102
Partial-Bug: #1290082
2014-04-14 21:07:33 +02:00

49 lines
1.9 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<chapter 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="ch_clients">
<title>Install and configure the OpenStack clients</title>
<para>The following sections contain information about working
with the OpenStack clients. Recall: in the previous section,
you used the <command>keystone</command> client.</para>
<para>You must install the client tools to complete the rest of
the installation.</para>
<para>Configure the clients on your desktop rather than on the
server so that you have a similar experience to your
users.</para>
<xi:include href="../common/section_cli_overview.xml"/>
<xi:include href="../common/section_cli_install.xml"/>
<xi:include href="../common/section_cli_openrc.xml"/>
<section xml:id="ch_clients_openrc_files">
<title>Create openrc.sh files</title>
<para>
As explained in <xref linkend="openrc-create"/>,
<phrase os="rhel;centos;fedora;opensuse;sles;ubuntu"> use the
credentials from <xref linkend="keystone-users"/> and</phrase>
create the following
<filename><replaceable>PROJECT</replaceable>-openrc.sh</filename>
files:
</para>
<itemizedlist>
<listitem>
<para>
<filename>admin-openrc.sh</filename> for the administrative user
</para>
</listitem>
<listitem>
<para>
<filename>demo-openrc.sh</filename> for the normal user:
<programlisting language="bash" audience="installer">export OS_USERNAME=demo
export OS_PASSWORD=<replaceable>DEMO_PASS</replaceable>
export OS_TENANT_NAME=demo
export OS_AUTH_URL=http://<replaceable>controller</replaceable>:35357/v2.0</programlisting>
</para>
</listitem>
</itemizedlist>
</section>
</chapter>