Add Intel DeepInsight integration section
Change-Id: I698551a601f40abdba88f954be000c3f5d64bd4b
diff --git a/advanced/int.rst b/advanced/int.rst
index 0816792..aefc2ca 100644
--- a/advanced/int.rst
+++ b/advanced/int.rst
@@ -62,3 +62,48 @@
}
}
}
+
+
+Intel DeepInsight integration
+-----------------------------
+
+.. note::
+ In this chapter, we assume that you already deploy the
+ `Intel DeepInsight Network Analytics Software <https://www.intel.com/content/www/us/en/products/network-io/programmable-ethernet-switch/network-analytics/deep-insight.html>`_
+ to your setup with a valid license.
+
+ Please contact Intel to get the software package and license of the DeepInsight Network Analytics Software.
+
+Configure the DeepInsight topology
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+We use `SD-Fabric utiliity <https://github.com/opennetworkinglab/sdfabric-utils>`_
+to convert the ONOS topology and configurations to DeepInsight
+topology configuration and upload it.
+
+To install the DeepInsight utility, use the following command:
+
+.. code-block:: bash
+
+ pip3 install git+ssh://git@github.com/opennetworkinglab/sdfabric-utils.git#subdirectory=deep-insight
+
+use the following command to generate the topology configuration file:
+
+.. code-block:: bash
+
+ di gen-topology [-s ONOS_ADDRESS] [-u ONOS_USER] [-p ONOS_PASSWORD] [-o TOPOLOGY-CONFIG-JSON]
+
+For example, we installs ONOS to ``192.168.100.1:8181``
+
+.. code-block:: bash
+
+ di gen-topology -s 192.168.100.1:8181 -o /tmp/topology.json
+
+.. tip::
+
+ Use ``di -h`` to get more detail about commands and parameters
+
+To upload the topology configuration file, go to DeepInsight web UI.
+In ``settings`` page there is a ``Topology Settings`` section.
+
+Choose ``Upload topology.json`` and use ``Browse...`` button to upload it.
diff --git a/conf.py b/conf.py
index 29956cc..e3a51e3 100644
--- a/conf.py
+++ b/conf.py
@@ -243,7 +243,8 @@
# -- Options for linkcheck ---------------------------------------------------
# The link checker strips off .md from links and then complains
linkcheck_ignore = [
- r'https://github.com/stratum/fabric-tna/*' # Ignore link of private repos
+ r'https://github.com/stratum/fabric-tna/*', # Ignore link of private repos
+ r'https://github.com/opennetworkinglab/sdfabric-utils', # Private repo
]
linkcheck_timeout = 3
diff --git a/dict.txt b/dict.txt
index 94b21c5..9cae4f3 100644
--- a/dict.txt
+++ b/dict.txt
@@ -65,4 +65,5 @@
virtualenv
vRouter
recirculation
-SKU
\ No newline at end of file
+SKU
+Analytics