From e92e314b136e8449784e49b655f28cb747894e4c Mon Sep 17 00:00:00 2001
From: Svetlana Karslioglu <skarslioglu@mirantis.com>
Date: Thu, 24 Nov 2016 14:44:18 -0800
Subject: [PATCH] Added prerequisites and configure IaC extension

Added the following sub-sections to the "Modify your
environment using Git repository section":

- Prerequisites
- Configure the Fuel IaC extension

Change-Id: I437800bc86885ddbe294b12bfd30040e189711be
---
 .../post-deployment-conf/lcm-git-repo.rst     | 10 ++--
 .../lcm-git-repo/configure-iac.rst            | 56 ++++++++++++++++++-
 .../lcm-git-repo/lcm-prerequisites.rst        |  9 ++-
 3 files changed, 66 insertions(+), 9 deletions(-)

diff --git a/userdocs/fuel-user-guide/post-deployment-conf/lcm-git-repo.rst b/userdocs/fuel-user-guide/post-deployment-conf/lcm-git-repo.rst
index 6befa4d88..fcf75a961 100644
--- a/userdocs/fuel-user-guide/post-deployment-conf/lcm-git-repo.rst
+++ b/userdocs/fuel-user-guide/post-deployment-conf/lcm-git-repo.rst
@@ -9,12 +9,12 @@ configurations in this repository and apply changes to your
 environments. This approach enables you to modify the settings
 you typically cannot modify through the Fuel web UI.
 
-The functionality is implemented through an additional Infrastructure-as-
-a-Code extension to Fuel. You need to clone the
-``fuel-nailgun-extension-iac`` repository
-on your Fuel Master node before you can use this feature.
+The functionality is implemented through an additional Infrastructure-as-Code
+(IaC) extension to Fuel. The extension is distributed as an ``.rpm`` package.
+Therefore, you need to download and install the package on your Fuel Master
+node before you can use this feature.
 
-With the Infrastructure-as-a-Code extension to Fuel you can:
+With the Infrastructure-as-Code extension to Fuel you can:
 
 * Associate a Git repository with a specific OpenStack environment.
 * Perform management operations, such as create, read, update, and delete
diff --git a/userdocs/fuel-user-guide/post-deployment-conf/lcm-git-repo/configure-iac.rst b/userdocs/fuel-user-guide/post-deployment-conf/lcm-git-repo/configure-iac.rst
index d66635872..3628560dc 100644
--- a/userdocs/fuel-user-guide/post-deployment-conf/lcm-git-repo/configure-iac.rst
+++ b/userdocs/fuel-user-guide/post-deployment-conf/lcm-git-repo/configure-iac.rst
@@ -1,6 +1,56 @@
 .. _configure-iac:
 
-Configure the IAC extenstion
-============================
+Configure the Fuel IaC extenstion
+=================================
 
-TBA
+To be able to deploy changes from a Git repository, you need
+to configure the Fuel Infrastructure-as-Code (IaC) extension
+on the Fuel Master node. The Fuel Master node must have either
+an access to the Internet, or an access to a local repository
+mirror with the required ``.rpm`` package.
+
+**To configure the IaC extension:**
+
+#. Install the Fuel IaC extension using the ``yum`` command:
+
+   ::
+
+     yum install fuel-nailgun-extension-iac
+
+#. Synchronize the Nailgun database:
+
+   ::
+
+     nailgun_syncdb
+
+#. Restart the Nailgun service:
+
+   ::
+
+     systemctl restart nailgun.service
+
+#. Verify the extension is installed correctly by viewing
+   the list of installed extensions:
+
+   ::
+
+     fuel2 extension list
+
+   **Example of system response:**
+
+   ::
+
+    +-------------------+---------+-------------------+---------------------+
+    | name              | version | description       | provides            |
+    +-------------------+---------+-------------------+---------------------+
+    | fuel_external_git | 1.0.0   | Nailgun extension | []                  |
+    |                   |         | which uses git    |                     |
+    |                   |         | repo for config   |                     |
+    |                   |         | files.            |                     |
+    +-------------------+---------+-------------------+---------------------+
+
+#. Enable the extension for the required environment:
+
+   ::
+
+     fuel2 env extension enable <env_id> -E fuel_external_git
diff --git a/userdocs/fuel-user-guide/post-deployment-conf/lcm-git-repo/lcm-prerequisites.rst b/userdocs/fuel-user-guide/post-deployment-conf/lcm-git-repo/lcm-prerequisites.rst
index 5dc0edf9d..c1863e33c 100644
--- a/userdocs/fuel-user-guide/post-deployment-conf/lcm-git-repo/lcm-prerequisites.rst
+++ b/userdocs/fuel-user-guide/post-deployment-conf/lcm-git-repo/lcm-prerequisites.rst
@@ -3,6 +3,13 @@
 Prerequisites
 =============
 
-TBA
+To apply changes using ``.yaml`` files from a Git repository,
+your environment must meet the following prerequisites:
 
+* A Git repository that has a structure similar to the described in
+  :ref:`repo-structure`.
+* The Fuel Master node must have an access to the Git
+  repository with the structure and to the repository with the Fuel
+  IaC extension..
+* Your environment must run Mirantis OpenStack 9.2 or later.