From 6faf217ae4e0551554e1bc5973d749c61662ba10 Mon Sep 17 00:00:00 2001
From: Maria Zlatkova <mzlatkova@mirantis.com>
Date: Thu, 24 Mar 2016 15:09:19 +0200
Subject: [PATCH] [Murano Docs] Set environment variables

Adds the "Set environment variables" section to the End User Guide.

Change-Id: I9b42ebafbcbf5a236565cca4dc7e04d048357e35
---
 .../draft/enduser-guide/install_client.rst    | 40 ++++++++++++++++++-
 1 file changed, 38 insertions(+), 2 deletions(-)

diff --git a/doc/source/draft/enduser-guide/install_client.rst b/doc/source/draft/enduser-guide/install_client.rst
index 74ac36bf..00bfac5c 100644
--- a/doc/source/draft/enduser-guide/install_client.rst
+++ b/doc/source/draft/enduser-guide/install_client.rst
@@ -3,8 +3,8 @@
 .. toctree::
    :maxdepth: 2
 
-Install the murano client
-~~~~~~~~~~~~~~~~~~~~~~~~~
+Install and use the murano client
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 The Application Catalog project provides a command-line client,
 python-muiranoclient, which enables you to access the project API.
@@ -47,6 +47,42 @@ To upgrade or remove the python-muranoclient, use the corresponding commands.
 
    $ pip uninstall python-muranoclient
 
+Set environment variables
+-------------------------
+
+To use the murano client, you must set the environment variables. To do this,
+download and source the OpenStack RC file. For more information, see
+`Download and source the OpenStack RC file <http://docs.openstack.org/user-guide/common/cli_set_environment_variables_using_openstack_rc.html#download-and-source-the-openstack-rc-file>`_.
+
+Alternatively, create the ``PROJECT-openrc.sh`` file from scratch. For this,
+perform the following steps:
+
+#. In a text editor, create a file named ``PROJECT-openrc.sh`` containing the
+   following authentication information:
+
+   .. code-block:: console
+
+      export OS_USERNAME=user
+      export OS_PASSWORD=password
+      export OS_TENANT_NAME=tenant
+      export OS_AUTH_URL=http://auth.example.com:5000
+      export MURANO_URL=http://murano.example.com:8082/
+
+#. In the terminal, source the ``PROJECT-openrc.sh`` file. For example:
+
+   .. code-block:: console
+
+      $ . admin-openrc.sh
+
+Once you have configured your authentication parameters, run
+:command:`murano help` to see a complete list of available commands and
+arguments. Use :command:`murano help <sub_command>` to get help on a specific
+subcommand.
+
+.. seealso::
+
+   `Set environment variables using the OpenStack RC file <http://docs.openstack.org/user-guide/common/cli_set_environment_variables_using_openstack_rc.html>`_.
+
 Bash completion
 ---------------