summaryrefslogtreecommitdiffstats
path: root/vnfs/VESreporting_vFW5.0_DANOS/README.md
diff options
context:
space:
mode:
authorroot <root@danos-build.zbl31w4ywk4ulg0far32rd2huc.cx.internal.cloudapp.net>2020-04-27 21:53:00 +0000
committerMarco Platania <platania@research.att.com>2020-04-28 14:52:48 +0000
commit08eddb8df44beacbb7b4047e313a771292030ccc (patch)
treeede637e3c6725bfd999d115b6ad330f1caa2602f /vnfs/VESreporting_vFW5.0_DANOS/README.md
parent6610dc1180d0dfbe30a737306d0f059b463aeb26 (diff)
Initial VES for DANOS vRouter
1. Create vpp_measurement_reporter that use DANOS configd query to retrieve statistics and libevel to transmit 2. Copy VES evel library to build a debian package under vpp_measurement_report 3. Add debian files to create a vpp_measurement_reporter + libevel debian package 4. Add debian install and systemctl start files 5. Add instruction to build VES reporter debian package (that will include libevel.so) 6. Add instructions to build DANOS ISO with VES reporter debian package and creating glance image Issue-ID: INT-1566 Change-Id: If18f16525f07f1b6bae0fc105e0452263b4bf661 Signed-off-by: Brian Freeman <bf1936@att.com>
Diffstat (limited to 'vnfs/VESreporting_vFW5.0_DANOS/README.md')
-rw-r--r--vnfs/VESreporting_vFW5.0_DANOS/README.md42
1 files changed, 42 insertions, 0 deletions
diff --git a/vnfs/VESreporting_vFW5.0_DANOS/README.md b/vnfs/VESreporting_vFW5.0_DANOS/README.md
new file mode 100644
index 00000000..b72aef7d
--- /dev/null
+++ b/vnfs/VESreporting_vFW5.0_DANOS/README.md
@@ -0,0 +1,42 @@
+
+PROJECT DESCRIPTION
+---
+This project is a port of the VES event library and reporting client to run on DANOS, an open source virtual router. DANOS has an embedded stateless firewall that can be used to demonstrate ONAP closed loop control as an alternative to the rudimentary demonstration VNF we have with the original ONAP vFW. As a real VNF , DANOS has features that we can use for better demonstrations of ONAP capability over time so making it easier to do ONAP demosntrations with a real VNF will be beneficial.
+
+The project is meant to be used to build a customer ISO of DANOS with ves/libevel integrated into the build and then that ISO can be used to generate a glance image for ONAP testing.
+
+The project will be both the ONAP source code for the VES event reporting and the instructions on how to crate the DANOS image that could be used in a glance repository.
+
+Heat templates , environment files , preload data and service mapping will be in the normal sections of the repository for those things (demo/vnfs)
+
+Generaly after downloading this directoy you will use the DANOS package build tools to run make which will create the debian file for inclusing in a DANO ISO build.
+
+See DANOS_BUILD.md for details.
+
+This project contains the source code and scripts for the periodic generation of network measurement reports for the DANOS virtual router with embeded firewall. It calls the DANOS API's to pull statistics for the ONAP vFW closed loop use case and could be extended for more statistics as needed. The project also includes a systemd start script to be compatible with the DANOS run time environment. The important part of the folder are:
+
+ - README.md: this file.
+
+ - LICENSE.TXT: the license text.
+
+ - vpp_measurement_reporter_danos.c: source code that uses the ECOMP Vendor Event Listener Library (VES) to read metrics from the network interface and send periodic measurement reports to the VES collector in DCAE. The VES library used here has been cloned from the GitHub repository at https://github.com/att/evel-library on February 1, 2017.
+
+ - evel/* source code for the Event Library that needs to be built with the vpp_measurement_reporter_danos as a shared library and included in the debian install
+
+ - debian/* debian package mandaatory files reqiured to specify the control and rules needed to build the vpp_measurement_report_danos debian file.
+
+ - Makefile: makefile that compiles libevel, vpp_measurement_reporter_danos.c and generates vpp_measurement_reporter binary.
+
+
+USAGE
+---
+
+vpp_measurement_report_danos can be started via systemctl once the DANOS Virtual Machine is instantiated.
+
+
+CONFIGURATION
+---
+Consult the onap wiki for instructions on how to use netconf to configuration the DANOS router for the vFWCL use case.
+
+[fill in url to page on wiki.onap.org ]
+