From 394df04bdd747004416bd6fc8d48a73bb47813cd Mon Sep 17 00:00:00 2001
From: Cristina Pauna <cristina.pauna@enea.com>
Date: Thu, 14 Dec 2017 17:54:01 +0200
Subject: Update documentation

This documentation is a copy of Fuel@OPNFV documentation

Change-Id: I03b289043b3a48ef6d423f958846295e3d26121a
Signed-off-by: Cristina Pauna <cristina.pauna@enea.com>
---
 docs/release/userguide/userguide.rst | 57 ++++++++++++++++++++++++++++++++++++
 1 file changed, 57 insertions(+)

(limited to 'docs/release/userguide/userguide.rst')

diff --git a/docs/release/userguide/userguide.rst b/docs/release/userguide/userguide.rst
index f00e6635..2b46a84a 100644
--- a/docs/release/userguide/userguide.rst
+++ b/docs/release/userguide/userguide.rst
@@ -254,6 +254,63 @@ For Virtual deploys, the most commonly used IPs are in the table below.
 +-----------+--------------+---------------+
 
 
+=============================
+Reclass model viewer tutorial
+=============================
+
+
+In order to get a better understanding on the reclass model Fuel uses, the `reclass-doc
+<https://github.com/jirihybek/reclass-doc>`_ can be used to visualise the reclass model.
+A simplified installation can be done with the use of a docker ubuntu container. This
+approach will avoid installing packages on the host, which might collide with other packages.
+After the installation is done, a webbrowser on the host can be used to view the results.
+
+**NOTE**: The host can be any device with Docker package already installed.
+          The user which runs the docker needs to have root priviledges.
+
+
+**Instructions**
+
+
+#. Create a new directory at any location
+
+   .. code-block:: bash
+
+      $ mkdir -p modeler
+
+
+#. Place fuel repo in the above directory
+
+   .. code-block:: bash
+
+      $ cd modeler
+      $ git clone https://gerrit.opnfv.org/gerrit/fuel && cd fuel
+
+
+#. Create a container and mount the above host directory
+
+   .. code-block:: bash
+
+      $ docker run --privileged -it -v <absolute_path>/modeler:/host ubuntu bash
+
+
+#. Install all the required packages inside the container.
+
+   .. code-block:: bash
+
+      $ apt-get update
+      $ apt-get install -y npm nodejs
+      $ npm install -g reclass-doc
+      $ cd /host/fuel/mcp/reclass
+      $ ln -s /usr/bin/nodejs /usr/bin/node
+      $ reclass-doc --output /host /host/fuel/mcp/reclass
+
+
+#. View the results from the host by using a browser. The file to open should be now at modeler/index.html
+
+   .. figure:: img/reclass_doc.png
+
+
 .. _references:
 
 ==========
-- 
cgit 1.2.3-korg