aboutsummaryrefslogtreecommitdiffstats
path: root/docs/release/userguide
diff options
context:
space:
mode:
authorCharalampos Kominos <charalampos.kominos@enea.com>2017-12-07 11:19:04 +0100
committerCristina Pauna <cristina.pauna@enea.com>2017-12-13 18:13:54 +0200
commit94954c13104b7f7e3bd04a7b5fdbae84a93457ac (patch)
tree520ebb474add22a5828275c86d8c05848dbc2b29 /docs/release/userguide
parentae4434bdf6a96e06286409aa51e8cd9975f7e8b8 (diff)
Add tutorial for reclass-doc tool in documentation
JIRA: FUEL-293 Change-Id: I2612e8d63875dca4d05f8c30db24a5ae84cc8dea Signed-off-by: Charalampos Kominos <Charalampos.Kominos@enea.com> Signed-off-by: Cristina Pauna <cristina.pauna@enea.com>
Diffstat (limited to 'docs/release/userguide')
-rw-r--r--docs/release/userguide/img/reclass_doc.pngbin0 -> 78645 bytes
-rw-r--r--docs/release/userguide/userguide.rst57
2 files changed, 57 insertions, 0 deletions
diff --git a/docs/release/userguide/img/reclass_doc.png b/docs/release/userguide/img/reclass_doc.png
new file mode 100644
index 000000000..374f92a6a
--- /dev/null
+++ b/docs/release/userguide/img/reclass_doc.png
Binary files differ
diff --git a/docs/release/userguide/userguide.rst b/docs/release/userguide/userguide.rst
index f00e66357..2b46a84ac 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:
==========