summaryrefslogtreecommitdiffstats
path: root/docs/apex/APEX-PCVS-Example.rst
diff options
context:
space:
mode:
authoraditya.puthuparambil <aditya.puthuparambil@est.tech>2020-04-06 16:00:03 +0100
committeraditya puthuparambil <aditya.puthuparambil@est.tech>2020-04-06 15:01:41 +0000
commit935358b4bfcf551ec780a4f6342032ac2a00376d (patch)
tree3a6747bab03c8608503aaa3cdaa629cd056b5110 /docs/apex/APEX-PCVS-Example.rst
parentc80213e91c20dca8794a7d7540d9afb876b6d693 (diff)
Apex-pdp documentation conversion from .adoc to .rst
Issue-ID: POLICY-2424 Signed-off-by: aditya.puthuparambil <aditya.puthuparambil@est.tech> Change-Id: Ic72f5cabe74d389ebafbcc8008525ef0831bd9b4
Diffstat (limited to 'docs/apex/APEX-PCVS-Example.rst')
-rw-r--r--docs/apex/APEX-PCVS-Example.rst2954
1 files changed, 2954 insertions, 0 deletions
diff --git a/docs/apex/APEX-PCVS-Example.rst b/docs/apex/APEX-PCVS-Example.rst
new file mode 100644
index 00000000..fc420303
--- /dev/null
+++ b/docs/apex/APEX-PCVS-Example.rst
@@ -0,0 +1,2954 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+.. _apex-PCVSExample:
+
+Policy-controlled Video Streaming (pcvs) with APEX
+**************************************************
+
+.. contents::
+ :depth: 3
+
+Introduction
+^^^^^^^^^^^^
+
+ .. container:: sectionbody
+
+ .. container:: paragraph
+
+ This module contains several demos for
+ Policy-controlled Video Streaming (PCVS). Each demo
+ defines a policy using AVRO and Javascript (or other
+ scripting languages for the policy logic). To run the
+ demo, a vanilla Ubuntu server with some extra software
+ packages is required:
+
+ .. container:: ulist
+
+ - Mininet as network simulator
+
+ - Floodlight as SDN controller
+
+ - Kafka as messaging system
+
+ - Zookeeper for Kafka configuration
+
+ - APEX for policy control
+
+Install Ubuntu Server and SW
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+ .. container:: sect1
+
+ .. rubric:: Install Demo
+ :name: install_demo
+
+ .. container:: sectionbody
+
+ .. container:: paragraph
+
+ Requirements:
+
+ .. container:: ulist
+
+ - Ubuntu server: 1.4 GB
+
+ - Ubuntu with Xubuntu Desktop, git, Firefox: 2.3 GB
+
+ - Ubuntu with all, system updated: 3 GB
+
+ - With ZK, Kafka, VLC, Mininet, Floodlight, Python:
+ 4.4 GB
+
+ - APEX Build (M2 and built): M2 ~ 2 GB, APEX ~3.5 GB
+
+ - APEX install (not build locally): ~ 300 MB
+
+ .. container:: paragraph
+
+ On a Ubuntu OS (install a stable or LTS server first)
+
+ .. container:: listingblock
+
+ .. container:: content
+
+ ::
+
+ # pre for Ubuntu, tools and X
+ sudo apt-get -y install --no-install-recommends software-properties-common
+ sudo apt-get -y install --no-install-recommends build-essential
+ sudo apt-get -y install --no-install-recommends git
+ sudo aptitude -y install --no-install-recommends xubuntu-desktop
+ sudo apt-get -y install --no-install-recommends firefox
+
+
+ # install Java
+ sudo add-apt-repository ppa:webupd8team/java
+ sudo apt-get update
+ sudo apt-get -y install --no-install-recommends oracle-java8-installer
+ java -version
+
+
+ # reboot system, run system update, then continue
+
+ # if VBox additions are needed, install and reboot
+ sudo (cd /usr/local/share; wget https://www.virtualbox.org/download/testcase/VBoxGuestAdditions_5.2.7-120528.iso)
+ sudo mount /usr/local/share/VBoxGuestAdditions_5.2.7-120528.iso /media/cdrom
+ sudo (cd /media/cdrom;VBoxLinuxAdditions.run)
+
+
+ # update apt-get DB
+ sudo apt-get update
+
+ # if APEX is build from source, install maven and rpm
+ sudo apt-get install maven rpm
+
+ # install ZooKeeper
+ sudo apt-get install zookeeperd
+
+ # install Kafka
+ (cd /tmp;wget http://ftp.heanet.ie/mirrors/www.apache.org/dist/kafka/1.0.0/kafka_2.12-1.0.0.tgz --show-progress)
+ sudo mkdir /opt/Kafka
+ sudo tar -xvf /tmp/kafka_2.12-1.0.0.tgz -C /opt/Kafka/
+
+ # install mininet
+ cd /usr/local/src
+ sudo git clone https://github.com/mininet/mininet.git
+ (cd mininet;util/install.sh -a)
+
+ # install floodlight, requires ant
+ sudo apt-get install ant
+ cd /usr/local/src
+ sudo wget --no-check-certificate https://github.com/floodlight/floodlight/archive/master.zip
+ sudo unzip master.zip
+ cd floodlight-master
+ sudo ant
+ sudo mkdir /var/lib/floodlight
+ sudo chmod 777 /var/lib/floodlight
+
+ # install python pip
+ sudo apt-get install python-pip
+
+ # install kafka-python (need newer version from github)
+ cd /usr/local/src
+ sudo git clone https://github.com/dpkp/kafka-python
+ sudo pip install ./kafka-python
+
+ # install vlc
+ sudo apt-get install vlc
+
+ .. container:: paragraph
+
+ Install APEX either from source or from a distribution
+ package. See the APEX documentation for details. We
+ assume that APEX is installed in
+ ``/opt/ericsson/apex/apex``
+
+ .. container:: paragraph
+
+ Copy the LinkMonitor file to Kafka-Python
+
+ .. container:: listingblock
+
+ .. container:: content
+
+ ::
+
+ sudo cp /opt/ericsson/apex/apex/examples/scripts/pcvs/vpnsla/LinkMonitor.py /usr/local/src/kafka-python
+
+ .. container:: paragraph
+
+ Change the Logback configuration in APEX to logic
+ logging
+
+ .. container:: listingblock
+
+ .. container:: content
+
+ ::
+
+ (cd /opt/ericsson/apex/apex/etc; sudo cp logback-logic.xml logback.xml)
+
+ .. container:: sect1
+
+ .. rubric:: Get the Demo Video
+ :name: get_the_demo_video
+
+ .. container:: sectionbody
+
+ .. container:: ulist
+
+ - For all download options of the movie please visit
+ http://bbb3d.renderfarming.net/download.html
+
+ - For lower-res downloads and mirrors see
+ https://peach.blender.org/download
+
+ .. container:: listingblock
+
+ .. container:: content
+
+ ::
+
+ sudo mkdir /usr/local/src/videos
+
+ .. container:: paragraph
+
+ Standard 720p (recommended)
+
+ .. container:: listingblock
+
+ .. container:: content
+
+ ::
+
+ (cd /usr/local/src/videos; sudo curl -o big_buck_bunny_480p_surround.avi http://download.blender.org/peach/bigbuckbunny_movies/big_buck_bunny_480p_surround-fix.avi)
+
+ .. container:: paragraph
+
+ Full HD video
+
+ .. container:: listingblock
+
+ .. container:: content
+
+ ::
+
+ (cd videos; sudo curl -o bbb_sunflower_1080p_60fps_normal.mp4 http://distribution.bbb3d.renderfarming.net/video/mp4/bbb_sunflower_1080p_60fps_normal.mp4)
+
+
+
+VPN SLA Demo
+^^^^^^^^^^^^^
+
+ .. container:: sect1
+
+ .. container:: sectionbody
+
+ .. container:: paragraph
+
+ This demo uses a network with several central office
+ and core switches, over which two VPNs are run. A
+ customer ``A`` has two location ``A1`` and ``A2`` and
+ a VPN between them. A customer ``B`` has two location
+ ``B1`` and ``B2`` and a VPN between them.
+
+ .. container:: imageblock
+
+ .. container:: content
+
+ |VPN SLA Architecture|
+
+ .. container:: paragraph
+
+ The architecture above shows the scenario. The
+ components are realized in this demo as follows:
+
+ .. container:: ulist
+
+ - *CEP / Analytics* - a simple Python script taking
+ events from Kafka and sending them to APEX
+
+ - *APEX / Policy* - the APEX engine running the VPA
+ SLA policy
+
+ - *Controller* - A vanilla Floodlight controller
+ taking events from the Link Monitor and configuring
+ Mininet
+
+ - *Network* - A network created using Mininet
+
+ .. container:: paragraph
+
+ The demo requires to start some software (detailed
+ below). To show actual video streams, we use ``VLC``.
+ If you do not want to show video streams, but only the
+ policy, skip the ``VLC`` section.
+
+ .. container:: paragraph
+
+ All shown scripts are available in a full APEX
+ installation in
+ ``$APEX_HOME/examples/scripts/pcvs/vpnsla``.
+
+ .. container:: sect2
+
+ .. rubric:: Start all Software
+ :name: start_all_software
+
+ .. container:: paragraph
+
+ Create environment variables in a file, say
+ ``env.sh``. In each new Xterm
+
+ .. container:: ulist
+
+ - Source these environment settings, e.g.
+ ``. ./env.sh``
+
+ - Run the commands below as root (``sudo`` per
+ command or ``sudo -i`` for interactive mode as
+ shown below)
+
+ .. container:: listingblock
+
+ .. container:: content
+
+ ::
+
+ #!/usr/bin/env bash
+
+ export src_dir=/usr/local/src
+ export APEX_HOME=/opt/ericsson/apex/apex
+ export APEX_USER=apexuser
+
+ .. container:: paragraph
+
+ In a new Xterm, start Floodlight
+
+ .. container:: listingblock
+
+ .. container:: content
+
+ ::
+
+ sudo -i
+ . ./env.sh
+ cd $src_dir/floodlight-master && java -jar target/floodlight.jar
+
+ .. container:: paragraph
+
+ In a new Xterm start Mininet
+
+ .. container:: listingblock
+
+ .. container:: content
+
+ ::
+
+ sudo -i
+ . ./env.sh
+ mn -c && python $APEX_HOME/examples/scripts/pcvs/vpnsla/MininetTopology.py
+
+ .. container:: paragraph
+
+ In a new Xterm, start Kafka
+
+ .. container:: listingblock
+
+ .. container:: content
+
+ ::
+
+ sudo -i
+ . ./env.sh
+ /opt/Kafka/kafka_2.12-1.0.0/bin/kafka-server-start.sh /opt/Kafka/kafka_2.12-1.0.0/config/server.properties
+
+ .. container:: paragraph
+
+ In a new Xerm start APEX with the Kafka
+ configuration for this demo
+
+ .. container:: listingblock
+
+ .. container:: content
+
+ ::
+
+ cd $APEX_HOME
+ ./bin/apexApps.sh engine -c examples/config/pcvs/vpnsla/kafka2kafka.json
+
+ .. container:: paragraph
+
+ In a new Xterm start the Link Monitor. The Link
+ Monitor has a 30 second sleep to slow down the
+ demonstration. So the first action of it comes 30
+ seconds after start. Every new action in 30 second
+ intervals.
+
+ .. container:: listingblock
+
+ .. container:: content
+
+ ::
+
+ sudo -i
+ . ./env.sh
+ cd $src_dir
+ xterm -hold -e 'python3 $src_dir/kafka-python/LinkMonitor.py' &
+
+ .. container:: paragraph
+
+ Now all software should be started and the demo is
+ running. The Link Monitor will send link up events,
+ picked up by APEX which triggers the policy. Since
+ there is no problem, the policy will do nothing.
+
+ .. container:: sect2
+
+ .. rubric:: Create 2 Video Streams with VLC
+ :name: create_2_video_streams_with_vlc
+
+ .. container:: paragraph
+
+ In the Mininet console, type ``xterm A1 A2`` and
+ ``xterm B1 B2`` to open terminals on these nodes.
+
+ .. container:: paragraph
+
+ ``A2`` and ``B2`` are the receiving nodes. In these
+ terminals, run ``vlc-wrapper``. In each opened VLC
+ window do
+
+ .. container:: ulist
+
+ - Click Media → Open Network Stream
+
+ - Give the URL as ``rtp://@:5004``
+
+ .. container:: paragraph
+
+ ``A1`` and ``B1`` are the sending nodes (sending
+ the video stream) In these terminals, run
+ ``vlc-wrapper``. In each opened VLC window do
+
+ .. container:: ulist
+
+ - Click Media → Stream
+
+ - Add the video (from ``/usr/local/src/videos``)
+
+ - Click ``Stream``
+
+ - Click ``Next``
+
+ - Change the destination
+ ``RTP / MPEG Transport Stream`` and click
+ ``Add``
+
+ - Change the address and type to ``10.0.0.2`` in
+ ``A1`` and to ``10.0.0.4`` in ``B1``
+
+ - Turn off ``Active Transcoding`` (this is
+ important to minimize CPU load)
+
+ - Click ``Next``
+
+ - Click ``Stream``
+
+ .. container:: paragraph
+
+ The video should be streaming across the network
+ from ``A1`` to ``A2`` and from ``B1`` to ``B2``. If
+ the video streams a slow or interrupted the CPU
+ load is too high. In these cases either try a
+ better machine or use a different (lower quality)
+ video stream.
+
+ .. container:: sect2
+
+ .. rubric:: Take out L09 and let the Policy do it’s
+ Magic
+ :name: take_out_l09_and_let_the_policy_do_it_s_magic
+
+ .. container:: paragraph
+
+ Now it is time to take out the link ``L09``. This
+ will be picked up by the Link Monitor, which sends
+ a new event (L09 DOWN) to the policy. The policy
+ then will calculate which customer should be
+ impeded (throttled). This will continue, until SLAs
+ are violated, then a priority calculation will kick
+ in (Customer ``A`` is prioritized in the setup).
+
+ .. container:: paragraph
+
+ To initiate this, simply type ``link s5 s6 down``
+ in the Mininet console followed by ``exit``.
+
+ .. container:: paragraph
+
+ If you have the video streams running, you will see
+ one or the other struggeling, depending on the
+ policy decision.
+
+ .. container:: sect2
+
+ .. rubric:: Reset the Demo
+ :name: reset_the_demo
+
+ .. container:: paragraph
+
+ If you want to reset the demo, simple stop (in this
+ order) the following process
+
+ .. container:: ulist
+
+ - Link Monitor
+
+ - APEX
+
+ - Mininet
+
+ - Floodlight
+
+ .. container:: paragraph
+
+ Then restart them in this order
+
+ .. container:: ulist
+
+ - Floodlight
+
+ - Mininet
+
+ - APEX
+
+ - Link Monitor
+
+ .. container:: sect2
+
+ .. rubric:: Monitor the Demo
+ :name: monitor_the_demo
+
+ .. container:: paragraph
+
+ Floodlight and APEX provide REST interfaces for
+ monitoring.
+
+ .. container:: ulist
+
+ - Floodlight: see `Floodlight
+ Docs <https://floodlight.atlassian.net/wiki/spaces/floodlightcontroller/pages/40403023/Web+GUI>`__
+ for details on how to access the monitoring. In
+ a standard installation as we use here, pointing
+ browser to the URL
+ ``http://localhost:8080/ui/pages/index.html``
+ should work on the same host
+
+ - APEX please see the APEX documentation for
+ `Monitoring
+ Client <https://ericsson.github.io/apex-docs/user-manual/engine-apps/um-engapps-eng-monitoring.html>`__
+ or `Full
+ Client <https://ericsson.github.io/apex-docs/user-manual/engine-apps/um-engapps-full-client.html>`__
+ for details on how to monitor APEX.
+
+
+VPN SLA Policy
+^^^^^^^^^^^^^^
+
+ .. container:: sectionbody
+
+ .. container:: paragraph
+
+ The VPN SLA policy is designed as a MEDA policy. The
+ first state (M = Match) takes the trigger event (a
+ link up or down) and checks if this is a change to the
+ known topology. The second state (E = Establish) takes
+ all available information (trigger event, local
+ context) and defines what situation we have. The third
+ state (D = Decide) takes the situation and selects
+ which algorithm is best to process it. This state can
+ select between ``none`` (nothing to do), ``solved`` (a
+ problem is solved now), ``sla`` (compare the current
+ customer SLA situation and select one to impede), and
+ ``priority`` (impede non-priority customers). The
+ fourth and final state (A = Act) selects the right
+ action for the taken decision and creates the response
+ event sent to the orchestrator.
+
+ .. container:: paragraph
+
+ We have added three more policies to set the local
+ context: one for adding nodes, one for adding edges
+ (links), and one for adding customers. These policies
+ do not realize any action, they are only here for
+ updating the local context. This mechanism is the
+ fasted way to update local context, and it is
+ independent of any context plugin.
+
+ .. container:: paragraph
+
+ The policy uses data defined in Avro, so we have a
+ number of Avro schema definitions.
+
+Context Schemas
+---------------
+
+ .. container:: sect1
+
+ .. container:: sectionbody
+
+ .. container:: paragraph
+
+ The context schemas are for the local context. We
+ model edges and nodes for the topology, customers, and
+ problems with all information on detected problems.
+
+ .. container:: listingblock
+
+ .. container:: content
+
+ .. code:: CodeRay
+
+ {
+ "type" : "record",
+ "name" : "TopologyEdges",
+ "fields" : [
+ {"name": "name", "type": "string", "doc": "Name of the Edge, typically a link name"},
+ {"name": "start", "type": "string", "doc": "Edge endpoint: start - a node name"},
+ {"name": "end", "type": "string", "doc": "Edge endpoint: end - a node name"},
+ {"name": "active", "type": "boolean", "doc": "Flag for active/inactive edges, inactive means a link is down"}
+ ]
+ }
+
+ .. container:: listingblock
+
+ .. container:: content
+
+ .. code:: CodeRay
+
+ {
+ "type" : "record",
+ "name" : "TopologyNodes",
+ "fields" : [
+ {"name" : "name", "type" : "string", "doc": "The name of the node"},
+ {"name" : "mnname", "type" : "string", "doc": "The name of the node in Mininet"}
+ ]
+ }
+
+ .. container:: listingblock
+
+ .. container:: content
+
+ .. code:: CodeRay
+
+ {
+ "type" : "record",
+ "name" : "Customer",
+ "fields" : [
+ {"name" : "customerName", "type" : "string"},
+ {"name" : "dtSLA" , "type" : "int"},
+ {"name" : "dtYTD" , "type" : "int"},
+ {"name" : "priority" , "type" : "boolean"},
+ {"name" : "satisfaction", "type" : "int"},
+ {
+ "name": "links",
+ "doc": "Links used by this customer",
+ "type": {"type" : "array", "items" : "string"}
+ }
+ ]
+ }
+
+
+Trigger Schemas
+---------------
+
+ .. container:: sect1
+
+ .. container:: sectionbody
+
+ .. container:: paragraph
+
+ The trigger event provides a status as ``UP`` or
+ ``DOWN``. To avoid tests for these strings in the
+ logic, we defined an Avro schema for an enumeration.
+ This does not impact the trigger system (it can still
+ send the strings), but makes the task logic simpler.
+
+ .. container:: listingblock
+
+ .. container:: content
+
+ .. code:: CodeRay
+
+ {
+ "type": "enum",
+ "name": "Status",
+ "symbols" : [
+ "UP",
+ "DOWN"
+ ]
+ }
+
+Context Logic Nodes
+--------------------
+
+ .. container:: sect1
+
+ .. container:: sectionbody
+
+ .. container:: paragraph
+
+ The node context logic simply takes the trigger event
+ (for context) and creates a new node in the local
+ context topology.
+
+ .. container:: listingblock
+
+ .. container:: content
+
+ .. code:: CodeRay
+
+ /*
+ * ============LICENSE_START=======================================================
+ * Copyright (C) 2016-2018 Ericsson. All rights reserved.
+ * ================================================================================
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ * ============LICENSE_END=========================================================
+ */
+
+ load("nashorn:mozilla_compat.js");
+
+ var logger = executor.logger;
+ logger.trace("start: " + executor.subject.id);
+ logger.trace("-- infields: " + executor.inFields);
+
+ var ifNodeName = executor.inFields["nodeName"];
+ var ifMininetName = executor.inFields["mininetName"];
+
+ var albumTopoNodes = executor.getContextAlbum("albumTopoNodes");
+
+ logger.trace("-- got infields, testing existing node");
+
+ var ctxtNode = albumTopoNodes.get(ifNodeName);
+ if (ctxtNode != null) {
+ albumTopoNodes.remove(ifNodeName);
+ logger.trace("-- removed node: <" + ifNodeName + ">");
+ }
+
+ logger.trace("-- creating node: <" + ifNodeName + ">");
+ ctxtNode = "{name:" + ifNodeName + ", mnname:" + ifMininetName + "}";
+ albumTopoNodes.put(ifNodeName, ctxtNode);
+
+ if (logger.isTraceEnabled()) {
+ logger.trace(" >> *** Nodes ***");
+ if (albumTopoNodes != null) {
+ for (var i = 0; i < albumTopoNodes.values().size(); i++) {
+ logger.trace(" >> >> " + albumTopoNodes.values().get(i).get("name") + " : "
+ + albumTopoNodes.values().get(i).get("mnname"));
+ }
+ } else {
+ logger.trace(" >> >> node album is null");
+ }
+ }
+
+ executor.outFields["report"] = "node ctxt :: added node " + ifNodeName;
+
+ logger.info("vpnsla: ctxt added node " + ifNodeName);
+
+ var returnValueType = Java.type("java.lang.Boolean");
+ var returnValue = new returnValueType(true);
+ logger.trace("finished: " + executor.subject.id);
+ logger.debug(".");
+
+Context Logic Edges
+--------------------
+
+ .. container:: sect1
+
+ .. container:: sectionbody
+
+ .. container:: paragraph
+
+ The edge context logic simply takes the trigger event
+ (for context) and creates a new edge in the local
+ context topology.
+
+ .. container:: listingblock
+
+ .. container:: content
+
+ .. code:: CodeRay
+
+ /*
+ * ============LICENSE_START=======================================================
+ * Copyright (C) 2016-2018 Ericsson. All rights reserved.
+ * ================================================================================
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ * ============LICENSE_END=========================================================
+ */
+
+ load("nashorn:mozilla_compat.js");
+
+ var logger = executor.logger;
+ logger.trace("start: " + executor.subject.id);
+ logger.trace("-- infields: " + executor.inFields);
+
+ var ifEdgeName = executor.inFields["edgeName"];
+ var ifEdgeStatus = executor.inFields["status"];
+
+ var albumTopoEdges = executor.getContextAlbum("albumTopoEdges");
+
+ logger.trace("-- got infields, testing existing edge");
+
+ var ctxtEdge = albumTopoEdges.get(ifEdgeName);
+ if (ctxtEdge != null) {
+ albumTopoEdges.remove(ifEdgeName);
+ logger.trace("-- removed edge: <" + ifEdgeName + ">");
+ }
+
+ logger.trace("-- creating edge: <" + ifEdgeName + ">");
+ ctxtEdge = "{name:" + ifEdgeName + ", start:" + executor.inFields["start"] + ", end:" + executor.inFields["end"]
+ + ", active:" + ifEdgeStatus + "}";
+ albumTopoEdges.put(ifEdgeName, ctxtEdge);
+
+ if (logger.isTraceEnabled()) {
+ logger.trace(" >> *** Edges ***");
+ if (albumTopoEdges != null) {
+ for (var i = 0; i < albumTopoEdges.values().size(); i++) {
+ logger.trace(" >> >> " + albumTopoEdges.values().get(i).get("name") + " \t "
+ + albumTopoEdges.values().get(i).get("start") + " --> " + albumTopoEdges.values().get(i).get("end")
+ + " \t " + albumTopoEdges.values().get(i).get("active"));
+ }
+ } else {
+ logger.trace(" >> >> edge album is null");
+ }
+ }
+
+ executor.outFields["report"] = "edge ctxt :: added edge " + ifEdgeName;
+
+ logger.info("vpnsla: ctxt added edge " + ifEdgeName);
+
+ var returnValueType = Java.type("java.lang.Boolean");
+ var returnValue = new returnValueType(true);
+ logger.trace("finished: " + executor.subject.id);
+ logger.debug(".");
+
+Context Logic Customer
+----------------------
+
+ .. container:: sect1
+
+ .. container:: sectionbody
+
+ .. container:: paragraph
+
+ The customer context logic simply takes the trigger
+ event (for context) and creates a new customer in the
+ local context topology.
+
+ .. container:: listingblock
+
+ .. container:: content
+
+ .. code:: CodeRay
+
+ /*
+ * ============LICENSE_START=======================================================
+ * Copyright (C) 2016-2018 Ericsson. All rights reserved.
+ * ================================================================================
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ * ============LICENSE_END=========================================================
+ */
+
+ load("nashorn:mozilla_compat.js");
+
+ var logger = executor.logger;
+ logger.trace("start: " + executor.subject.id);
+ logger.trace("-- infields: " + executor.inFields);
+
+ var ifCustomerName = executor.inFields["customerName"];
+ var ifLinks = executor.inFields["links"];
+
+ logger.trace("-- got infields, testing existing customer");
+ var ctxtCustomer = executor.getContextAlbum("albumCustomerMap").get(ifCustomerName);
+ if (ctxtCustomer != null) {
+ executor.getContextAlbum("albumCustomerMap").remove(ifCustomerName);
+ logger.trace("-- removed customer: <" + ifCustomerName + ">");
+ }
+
+ logger.trace("-- creating customer: <" + ifCustomerName + ">");
+ var links = new Array();
+ for (var i = 0; i < ifLinks.split(" ").length; i++) {
+ var link = executor.getContextAlbum("albumTopoEdges").get(ifLinks.split(" ")[i]);
+ if (link != null) {
+ logger.trace("-- link: <" + ifLinks.split(" ")[i] + ">");
+ links.push(ifLinks.split(" ")[i]);
+ } else {
+ logger.trace("-- unknown link: <" + ifLinks.split(" ")[i] + "> for customer <" + ifCustomerName + ">");
+ }
+ }
+ logger.trace("-- links: <" + links + ">");
+ ctxtCustomer = "{customerName:" + ifCustomerName + ", dtSLA:" + executor.inFields["dtSLA"] + ", dtYTD:"
+ + executor.inFields["dtYTD"] + ", priority:" + executor.inFields["priority"] + ", satisfaction:"
+ + executor.inFields["satisfaction"] + ", links:[" + links + "]}";
+
+ executor.getContextAlbum("albumCustomerMap").put(ifCustomerName, ctxtCustomer);
+
+ if (logger.isTraceEnabled()) {
+ logger.trace(" >> *** Customers ***");
+ if (executor.getContextAlbum("albumCustomerMap") != null) {
+ for (var i = 0; i < executor.getContextAlbum("albumCustomerMap").values().size(); i++) {
+ logger.trace(" >> >> " + executor.getContextAlbum("albumCustomerMap").values().get(i).get("customerName")
+ + " : " + "dtSLA=" + executor.getContextAlbum("albumCustomerMap").values().get(i).get("dtSLA")
+ + " : " + "dtYTD=" + executor.getContextAlbum("albumCustomerMap").values().get(i).get("dtYTD")
+ + " : " + "links=" + executor.getContextAlbum("albumCustomerMap").values().get(i).get("links")
+ + " : " + "priority="
+ + executor.getContextAlbum("albumCustomerMap").values().get(i).get("priority") + " : "
+ + "satisfaction="
+ + executor.getContextAlbum("albumCustomerMap").values().get(i).get("satisfaction"));
+ }
+ } else {
+ logger.trace(" >> >> customer album is null");
+ }
+ }
+
+ executor.outFields["report"] = "customer ctxt :: added customer: " + ifCustomerName;
+
+ logger.info("vpnsla: ctxt added customer " + ifCustomerName);
+
+ var returnValueType = Java.type("java.lang.Boolean");
+ var returnValue = new returnValueType(true);
+ logger.trace("finished: " + executor.subject.id);
+ logger.debug(".");
+
+Logic: Match
+------------
+
+ .. container:: sect1
+
+ .. container:: sectionbody
+
+ .. container:: paragraph
+
+ This is the logic for the match state. It is kept very
+ simple. Beside taking the trigger event, it also
+ creates a timestamp. This timestamp is later used for
+ SLA and downtime calculations as well as for some
+ performance information of the policy.
+
+ .. container:: listingblock
+
+ .. container:: content
+
+ .. code:: CodeRay
+
+ /*
+ * ============LICENSE_START=======================================================
+ * Copyright (C) 2016-2018 Ericsson. All rights reserved.
+ * ================================================================================
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ * ============LICENSE_END=========================================================
+ */
+
+ load("nashorn:mozilla_compat.js");
+
+ var now = new Date().getTime();
+ executor.outFields["matchStart"] = now;
+
+ importClass(org.slf4j.LoggerFactory);
+
+ var logger = executor.logger;
+ logger.trace("start: " + executor.subject.id);
+ logger.trace("-- infields: " + executor.inFields);
+
+ var rootLogger = LoggerFactory.getLogger(logger.ROOT_LOGGER_NAME);
+
+ var ifEdgeName = executor.inFields["edgeName"];
+ var ifLinkStatus = executor.inFields["status"];
+
+ var albumTopoEdges = executor.getContextAlbum("albumTopoEdges");
+
+ logger.trace("-- got infields, checking albumTopoEdges changes");
+
+ var active = false;
+ switch (ifLinkStatus.toString()) {
+ case "UP":
+ active = true;
+ break;
+ case "DOWN":
+ active = false;
+ break;
+ default:
+ active = false;
+ logger.error("-- trigger sent unknown link status <" + ifLinkStatus + "> for link <" + ifEdgeName + ">");
+ rootLogger.error(executor.subject.id + " " + "-- trigger sent unknown link status <" + ifLinkStatus
+ + "> for link <" + ifEdgeName + ">");
+ }
+
+ var link = albumTopoEdges.get(ifEdgeName);
+ if (link == null) {
+ logger.trace("-- link <" + ifEdgeName + "> not in albumTopoEdges");
+ } else {
+ logger.trace("-- found link <" + link + "> in albumTopoEdges");
+ logger.trace("-- active <" + active + "> : link.active <" + link.get("active") + ">");
+ if (active != link.get("active")) {
+ link.put("active", active);
+ logger.trace("-- link <" + ifEdgeName + "> status changed to <active:" + link.get("active") + ">");
+ executor.outFields["hasChanged"] = true;
+ } else {
+ logger.trace("-- link <" + ifEdgeName + "> status not changed <active:" + link.get("active") + ">");
+ executor.outFields["hasChanged"] = false;
+ }
+ }
+
+ executor.outFields["edgeName"] = ifEdgeName;
+ executor.outFields["status"] = ifLinkStatus;
+
+ logger.info("vpnsla: detected " + ifEdgeName + " as " + ifLinkStatus);
+
+ var returnValueType = Java.type("java.lang.Boolean");
+ var returnValue = new returnValueType(true);
+ logger.trace("finished: " + executor.subject.id);
+ logger.debug(".m");
+
+
+Logic: Policy Establish State
+-----------------------------
+
+ .. container:: sect1
+
+ .. container:: sectionbody
+
+ .. container:: paragraph
+
+ This is the logic for the establish state. It is the
+ most complicated logic, since establishing a situation
+ for a decision is the most important part of any
+ policy. First, the policy describes what we find (the
+ switch block), in terms of 8 normal situations and 1
+ extreme error case.
+
+ .. container:: paragraph
+
+ If required, it creates local context information for
+ the problem (if it is new) or updates it (if the
+ problem still exists). It also calculates customer SLA
+ downtime and checks for any SLA violations. Finally,
+ it creates a situation object.
+
+ .. container:: listingblock
+
+ .. container:: content
+
+ .. code:: CodeRay
+
+ /*
+ * ============LICENSE_START=======================================================
+ * Copyright (C) 2016-2018 Ericsson. All rights reserved.
+ * ================================================================================
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ * ============LICENSE_END=========================================================
+ */
+
+ load("nashorn:mozilla_compat.js");
+ importClass(org.slf4j.LoggerFactory);
+
+ importClass(java.util.ArrayList);
+
+ importClass(org.apache.avro.generic.GenericData.Array);
+ importClass(org.apache.avro.generic.GenericRecord);
+ importClass(org.apache.avro.Schema);
+
+ var logger = executor.logger;
+ logger.trace("start: " + executor.subject.id);
+ logger.trace("-- infields: " + executor.inFields);
+
+ var rootLogger = LoggerFactory.getLogger(logger.ROOT_LOGGER_NAME);
+
+ var ifEdgeName = executor.inFields["edgeName"];
+ var ifEdgeStatus = executor.inFields["status"].toString();
+ var ifhasChanged = executor.inFields["hasChanged"];
+ var ifMatchStart = executor.inFields["matchStart"];
+
+ var albumCustomerMap = executor.getContextAlbum("albumCustomerMap");
+ var albumProblemMap = executor.getContextAlbum("albumProblemMap");
+
+ var linkProblem = albumProblemMap.get(ifEdgeName);
+
+ // create outfiled for situation
+ var situation = executor.subject.getOutFieldSchemaHelper("situation").createNewInstance();
+ situation.put("violatedSLAs", new ArrayList());
+
+ // create a string as states+hasChanged+linkProblem and switch over it
+ var switchTest = ifEdgeStatus + ":" + ifhasChanged + ":" + (linkProblem == null ? "no" : "yes");
+ switch (switchTest) {
+ case "UP:false:no":
+ logger.trace("-- edge <" + ifEdgeName + "> UP:false:no => everything ok");
+ logger.info("vpnsla: everything ok");
+ situation.put("problemID", "NONE");
+ break;
+ case "UP:false:yes":
+ logger.trace("-- edge <" + ifEdgeName + "> UP:false:yes ==> did we miss earlier up?, removing problem");
+ albumProblemMap.remove(ifEdgeName);
+ linkProblem = null;
+ situation.put("problemID", "NONE");
+ break;
+ case "UP:true:no":
+ logger.trace("-- edge <" + ifEdgeName + "> UP:true:no ==> did we miss the earlier down?, creating new problem");
+ situation.put("problemID", ifEdgeName);
+ break;
+ case "UP:true:yes":
+ logger.trace("-- edge <" + ifEdgeName + "> UP:true:yes ==> detected solution, link up again");
+ logger.info("vpnsla: problem solved");
+ linkProblem.put("endTime", ifMatchStart);
+ linkProblem.put("status", "SOLVED");
+ situation.put("problemID", "NONE");
+ break;
+ case "DOWN:false:no":
+ logger.trace("-- edge <" + ifEdgeName + "> DOWN:false:no ==> did we miss an earlier down?, creating new problem");
+ situation.put("problemID", ifEdgeName);
+ break;
+ case "DOWN:false:yes":
+ logger.trace("-- edge <" + ifEdgeName + "> DOWN:false:yes ==> problem STILL exists");
+ logger.info("vpnsla: problem still exists");
+ linkProblem.put("status", "STILL");
+ situation.put("problemID", ifEdgeName);
+ break;
+ case "DOWN:true:no":
+ logger.trace("-- edge <" + ifEdgeName + "> DOWN:true:no ==> found NEW problem");
+ logger.info("vpnsla: this is a new problem");
+ situation.put("problemID", ifEdgeName);
+ break;
+ case "DOWN:true:yes":
+ logger.trace("-- edge <" + ifEdgeName
+ + "> DOWN:true:yes ==> did we miss to remove an earlier problem?, remove and create new problem");
+ linkProblem = null;
+ situation.put("problemID", ifEdgeName);
+ break;
+
+ default:
+ logger.error("-- input wrong for edge" + ifEdgeName + ": edge status <" + ifEdgeStatus
+ + "> unknown or null on hasChanged <" + ifhasChanged + ">");
+ rootLogger.error("-- input wrong for edge" + ifEdgeName + ": edge status <" + ifEdgeStatus
+ + "> unknown or null on hasChanged <" + ifhasChanged + ">");
+ }
+
+ // create new problem if situation requires it
+ if (situation.get("problemID").equals(ifEdgeName) && linkProblem == null) {
+ logger.trace("-- edge <" + ifEdgeName + "> creating new problem");
+ linkProblem = albumProblemMap.getSchemaHelper().createNewInstance();
+ linkProblem.put("edge", ifEdgeName);
+ linkProblem.put("startTime", ifMatchStart);
+ linkProblem.put("lastUpdate", ifMatchStart);
+ linkProblem.put("endTime", 0);
+ linkProblem.put("status", "NEW");
+ linkProblem.put("edgeUsedBy", new ArrayList());
+ linkProblem.put("impededLast", new ArrayList());
+
+ for (var i = 0; i < albumCustomerMap.values().size(); i++) {
+ var customer = albumCustomerMap.values().get(i);
+ var customerLinks = albumCustomerMap.values().get(i).get("links");
+ for (var k = 0; k < customerLinks.size(); k++) {
+ if (customerLinks.get(k) == ifEdgeName) {
+ linkProblem.get("edgeUsedBy").add(customer.get("customerName"));
+ }
+ }
+ }
+ albumProblemMap.put(ifEdgeName, linkProblem);
+ logger.trace("-- edge <" + ifEdgeName + "> problem created as <" + linkProblem + ">");
+ }
+
+ // set dtYTD if situation requires it
+ if (linkProblem != null && (linkProblem.get("status") == "STILL" || linkProblem.get("status") == "SOLVED")) {
+ var linkDownTimeinSecs = (ifMatchStart - linkProblem.get("lastUpdate")) / 1000;
+ logger.trace("-- edge <" + ifEdgeName + "> down time: " + linkDownTimeinSecs + " s");
+ for (var k = 0; k < linkProblem.get("impededLast").size(); k++) {
+ for (var i = 0; i < albumCustomerMap.values().size(); i++) {
+ var customer = albumCustomerMap.values().get(i);
+ if (customer.get("customerName").equals(linkProblem.get("impededLast").get(k))) {
+ logger.info("-- vpnsla: customer " + customer.get("customerName") + " YDT downtime increased from "
+ + customer.get("dtYTD") + " to " + (customer.get("dtYTD") + linkDownTimeinSecs));
+ customer.put("dtYTD", (customer.get("dtYTD") + linkDownTimeinSecs))
+ }
+ }
+ }
+ // set lastUpdate to this policy execution for next execution calculation
+ linkProblem.put("lastUpdate", ifMatchStart);
+ }
+
+ // check SLA violations if situation requires it
+ if (linkProblem != null && linkProblem.get("status") != "SOLVED") {
+ logger.info(">e> customer\tDT SLA\tDT YTD\tviolation");
+ for (var i = 0; i < albumCustomerMap.values().size(); i++) {
+ var customer = albumCustomerMap.values().get(i);
+ if (customer.get("dtYTD") > customer.get("dtSLA")) {
+ situation.get("violatedSLAs").add(customer.get("customerName"));
+ logger.info(">e> " + customer.get("customerName") + "\t\t" + customer.get("dtSLA") + "s\t"
+ + customer.get("dtYTD") + "s\t" + "!!");
+ } else {
+ logger.info(">e> " + customer.get("customerName") + "\t\t" + customer.get("dtSLA") + "s\t"
+ + customer.get("dtYTD") + "s");
+ }
+ }
+ }
+
+ executor.outFields["situation"] = situation;
+
+ logger.trace("-- out fields <" + executor.outFields + ">");
+
+ var returnValueType = Java.type("java.lang.Boolean");
+ var returnValue = new returnValueType(true);
+ logger.trace("finished: " + executor.subject.id);
+ logger.debug(".e");
+
+Logic: Policy Decide State
+--------------------------
+
+ .. container:: sect1
+
+ .. container:: sectionbody
+
+ .. container:: paragraph
+
+ The decide state can select between different
+ algorithms depending on the situation. So it needs a
+ Task Selection Logic (TSL). This TSL select a task in
+ the current policy execution (i.e. potentially a
+ different one per execution).
+
+ .. container:: listingblock
+
+ .. container:: content
+
+ .. code:: CodeRay
+
+ /*
+ * ============LICENSE_START=======================================================
+ * Copyright (C) 2016-2018 Ericsson. All rights reserved.
+ * ================================================================================
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ * ============LICENSE_END=========================================================
+ */
+
+ load("nashorn:mozilla_compat.js");
+ importClass(org.slf4j.LoggerFactory);
+
+ var logger = executor.logger;
+ logger.trace("start: " + executor.subject.id + " - TSL");
+
+ var rootLogger = LoggerFactory.getLogger(logger.ROOT_LOGGER_NAME);
+
+ var ifSituation = executor.inFields["situation"];
+
+ var albumProblemMap = executor.getContextAlbum("albumProblemMap");
+
+ var returnValueType = Java.type("java.lang.Boolean");
+ if (ifSituation.get("problemID") == "NONE") {
+ logger.trace("-- situation has no problem, selecting <VpnSlaPolicyDecideNoneTask>");
+ executor.subject.getTaskKey("VpnSlaPolicyDecideNoneTask").copyTo(executor.selectedTask);
+ var returnValue = new returnValueType(true);
+ } else if (albumProblemMap.get(ifSituation.get("problemID")).get("status") == "SOLVED") {
+ logger.trace("-- situation is solved, selecting <VpnSlaPolicyDecideSolvedTask>");
+ executor.subject.getTaskKey("VpnSlaPolicyDecideSolvedTask").copyTo(executor.selectedTask);
+ var returnValue = new returnValueType(true);
+ } else if (ifSituation.get("violatedSLAs") != null && ifSituation.get("violatedSLAs").size() > 0) {
+ logger.trace("-- situation is problem with violations, selecting <VpnSlaPolicyDecidePriorityTask>");
+ executor.subject.getTaskKey("VpnSlaPolicyDecidePriorityTask").copyTo(executor.selectedTask);
+ var returnValue = new returnValueType(true);
+ } else if (ifSituation.get("violatedSLAs") != null && ifSituation.get("violatedSLAs").size() == 0) {
+ logger.trace("-- situation is problem without violations, selecting <VpnSlaPolicyDecideSlaTask>");
+ executor.subject.getTaskKey("VpnSlaPolicyDecideSlaTask").copyTo(executor.selectedTask);
+ var returnValue = new returnValueType(true);
+ } else {
+ logger.error("-- detected unknown decision for situation <" + ifSituation.get("problemID") + ">");
+ rootLogger.error(executor.subject.id + " " + "-- detected unknown decision for situation <"
+ + ifSituation.get("problemID") + ">");
+ var returnValue = new returnValueType(false);
+ }
+
+ logger.trace("finished: " + executor.subject.id);
+ logger.debug(".d-tsl");
+
+ .. container:: paragraph
+
+ The actual task logic are then ``none``, ``solved``,
+ ``sla``, and ``priority``.
+
+Logic: Decide None
+-------------------
+
+ .. container:: sect1
+
+ .. container:: sectionbody
+
+ .. container:: listingblock
+
+ .. container:: content
+
+ .. code:: CodeRay
+
+ /*
+ * ============LICENSE_START=======================================================
+ * Copyright (C) 2016-2018 Ericsson. All rights reserved.
+ * ================================================================================
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ * ============LICENSE_END=========================================================
+ */
+
+ load("nashorn:mozilla_compat.js");
+ importClass(org.slf4j.LoggerFactory);
+
+ importClass(java.util.ArrayList);
+
+ importClass(org.apache.avro.generic.GenericData.Array);
+ importClass(org.apache.avro.generic.GenericRecord);
+ importClass(org.apache.avro.Schema);
+
+ var logger = executor.logger;
+ logger.trace("start: " + executor.subject.id);
+ logger.trace("-- infields: " + executor.inFields);
+
+ var rootLogger = LoggerFactory.getLogger(logger.ROOT_LOGGER_NAME);
+
+ var ifSituation = executor.inFields["situation"];
+
+ // create outfiled for decision
+ var decision = executor.subject.getOutFieldSchemaHelper("decision").createNewInstance();
+ decision.put("description", "None, everything is ok");
+ decision.put("decision", "NONE");
+ decision.put("customers", new ArrayList());
+
+ var returnValueType = Java.type("java.lang.Boolean");
+ if (ifSituation.get("problemID") == "NONE") {
+ logger.trace("-- no problem, everything ok");
+ var returnValue = new returnValueType(true);
+ } else {
+ logger.trace("-- wrong problemID <" + problemID + "> for NONE task, we should not be here");
+ rootLogger.error(executor.subject.id + " " + "-- wrong problemID <" + problemID
+ + "> for NONE task, we should not be here");
+ var returnValue = new returnValueType(false);
+ }
+
+ executor.outFields["decision"] = decision;
+
+ logger.trace("finished: " + executor.subject.id);
+ logger.debug(".d-non");
+
+Logic: Decide Solved
+---------------------
+
+ .. container:: sect1
+
+ .. container:: sectionbody
+
+ .. container:: listingblock
+
+ .. container:: content
+
+ .. code:: CodeRay
+
+ /*
+ * ============LICENSE_START=======================================================
+ * Copyright (C) 2016-2018 Ericsson. All rights reserved.
+ * ================================================================================
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ * ============LICENSE_END=========================================================
+ */
+
+ load("nashorn:mozilla_compat.js");
+ importClass(org.slf4j.LoggerFactory);
+
+ importClass(java.util.ArrayList);
+
+ importClass(org.apache.avro.generic.GenericData.Array);
+ importClass(org.apache.avro.generic.GenericRecord);
+ importClass(org.apache.avro.Schema);
+
+ var logger = executor.logger;
+ logger.trace("start: " + executor.subject.id);
+ logger.trace("-- infields: " + executor.inFields);
+
+ var rootLogger = LoggerFactory.getLogger(logger.ROOT_LOGGER_NAME);
+
+ var ifSituation = executor.inFields["situation"];
+
+ var albumProblemMap = executor.getContextAlbum("albumProblemMap");
+
+ // create outfiled for decision
+ var decision = executor.subject.getOutFieldSchemaHelper("decision").createNewInstance();
+ decision.put("description", "None, everything is ok");
+ decision.put("decision", "REBUILD");
+ decision.put("customers", new ArrayList());
+ decision.put("problemID", ifSituation.get("problemID"));
+
+ var returnValueType = Java.type("java.lang.Boolean");
+ if (albumProblemMap.get(ifSituation.get("problemID")).get("status") == "SOLVED") {
+ logger.trace("-- problem solved");
+ var returnValue = new returnValueType(true);
+ } else {
+ logger.trace("-- wrong problemID <" + problemID + "> for SOLVED task, we should not be here");
+ rootLogger.error(executor.subject.id + " " + "-- wrong problemID <" + problemID
+ + "> for SOLVED task, we should not be here");
+ var returnValue = new returnValueType(false);
+ }
+
+ executor.outFields["decision"] = decision;
+
+ logger.info("vpnsla: sla solved, problem solved");
+
+ logger.trace("finished: " + executor.subject.id);
+ logger.debug(".d-non");
+
+Logic: Decide SLA
+------------------
+
+ .. container:: sect1
+
+ .. container:: sectionbody
+
+ .. container:: listingblock
+
+ .. container:: content
+
+ .. code:: CodeRay
+
+ /*
+ * ============LICENSE_START=======================================================
+ * Copyright (C) 2016-2018 Ericsson. All rights reserved.
+ * ================================================================================
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ * ============LICENSE_END=========================================================
+ */
+
+ load("nashorn:mozilla_compat.js");
+ importClass(org.slf4j.LoggerFactory);
+
+ importClass(java.util.ArrayList);
+
+ importClass(org.apache.avro.generic.GenericData.Array);
+ importClass(org.apache.avro.generic.GenericRecord);
+ importClass(org.apache.avro.Schema);
+
+ var logger = executor.logger;
+ logger.trace("start: " + executor.subject.id);
+ logger.trace("-- infields: " + executor.inFields);
+
+ var rootLogger = LoggerFactory.getLogger(logger.ROOT_LOGGER_NAME);
+
+ var ifSituation = executor.inFields["situation"];
+
+ var albumCustomerMap = executor.getContextAlbum("albumCustomerMap");
+ var albumProblemMap = executor.getContextAlbum("albumProblemMap");
+
+ // create outfiled for decision
+ var decision = executor.subject.getOutFieldSchemaHelper("decision").createNewInstance();
+ decision.put("description", "Impede given customers selected based on maximum SLA delta");
+ decision.put("decision", "IMPEDE");
+ decision.put("problemID", ifSituation.get("problemID"));
+ decision.put("customers", new ArrayList());
+
+ var problem = albumProblemMap.get(ifSituation.get("problemID"));
+ var returnValueType = Java.type("java.lang.Boolean");
+ if (problem != null && ifSituation.get("violatedSLAs").size() == 0) {
+ logger.trace("-- impede by maximum SLA");
+ var customer = "";
+ var customerSla = 0;
+ for (var i = 0; i < problem.get("edgeUsedBy").size(); i++) {
+ customerCtxt = albumCustomerMap.get(problem.get("edgeUsedBy").get(i).toString());
+ if (customerSla == 0) {
+ customerSla = customerCtxt.get("dtSLA") - customerCtxt.get("dtYTD");
+ }
+ if ((customerCtxt.get("dtSLA") - customerCtxt.get("dtYTD")) >= customerSla) {
+ customer = customerCtxt.get("customerName");
+ customerSla = (customerCtxt.get("dtSLA") - customerCtxt.get("dtYTD"));
+ }
+ }
+ decision.get("customers").add(customer);
+ var returnValue = new returnValueType(true);
+ } else {
+ logger.trace("-- wrong problemID <" + ifSituation.get("problemID") + "> for SLA task, we should not be here");
+ rootLogger.error(executor.subject.id + " " + "-- wrong problemID <" + ifSituation.get("problemID")
+ + "> for SLA task, we should not be here");
+ var returnValue = new returnValueType(false);
+ }
+
+ // set impededLast to decision[customers]
+ problem.get("impededLast").clear();
+ problem.get("impededLast").addAll(decision.get("customers"));
+
+ executor.outFields["decision"] = decision;
+ logger.trace("-- decision: " + decision);
+
+ logger.info("vpnsla: sla balance, impeding customers " + decision.get("customers"));
+
+ logger.trace("finished: " + executor.subject.id);
+ logger.debug(".d-sla");
+
+Logic: Decide Priority
+----------------------
+
+ .. container:: sect2
+
+ .. container:: listingblock
+
+ .. container:: content
+
+ .. code:: CodeRay
+
+ /*
+ * ============LICENSE_START=======================================================
+ * Copyright (C) 2016-2018 Ericsson. All rights reserved.
+ * ================================================================================
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ * ============LICENSE_END=========================================================
+ */
+
+ load("nashorn:mozilla_compat.js");
+ importClass(org.slf4j.LoggerFactory);
+
+ importClass(java.util.ArrayList);
+
+ importClass(org.apache.avro.generic.GenericData.Array);
+ importClass(org.apache.avro.generic.GenericRecord);
+ importClass(org.apache.avro.Schema);
+
+ var logger = executor.logger;
+ logger.trace("start: " + executor.subject.id);
+ logger.trace("-- infields: " + executor.inFields);
+
+ var rootLogger = LoggerFactory.getLogger(logger.ROOT_LOGGER_NAME);
+
+ var ifSituation = executor.inFields["situation"];
+
+ var albumCustomerMap = executor.getContextAlbum("albumCustomerMap");
+ var albumProblemMap = executor.getContextAlbum("albumProblemMap");
+
+ // create outfiled for decision
+ var decision = executor.subject.getOutFieldSchemaHelper("decision").createNewInstance();
+ decision.put("description", "None, everything is ok");
+ decision.put("decision", "IMPEDE");
+ decision.put("problemID", ifSituation.get("problemID"));
+ decision.put("customers", new ArrayList());
+
+ var problem = albumProblemMap.get(ifSituation.get("problemID"));
+ var returnValueType = Java.type("java.lang.Boolean");
+ if (problem != null && ifSituation.get("violatedSLAs").size() > 0) {
+ logger.trace("-- impede by priority");
+ for (var i = 0; i < problem.get("edgeUsedBy").size(); i++) {
+ customerCtxt = albumCustomerMap.get(problem.get("edgeUsedBy").get(i).toString());
+ if (customerCtxt.get("priority") == false) {
+ decision.get("customers").add(customerCtxt.get("customerName"));
+ }
+ }
+ var returnValue = new returnValueType(true);
+ } else {
+ logger.trace("-- wrong problemID <" + ifSituation.get("problemID") + "> for PRIORITY task, we should not be here");
+ rootLogger.error(executor.subject.id + " " + "-- wrong problemID <" + ifSituation.get("problemID")
+ + "> for PRIORITY task, we should not be here");
+ var returnValue = new returnValueType(false);
+ }
+
+ // set impededLast to decision[customers]
+ problem.get("impededLast").clear();
+ problem.get("impededLast").addAll(decision.get("customers"));
+
+ executor.outFields["decision"] = decision;
+ logger.trace("-- decision: " + decision);
+
+ logger.info("vpnsla: priority, impeding customers " + decision.get("customers"));
+
+ logger.trace("finished: " + executor.subject.id);
+ logger.debug(".d-pri");
+
+Logic: Policy Act State
+------------------------
+
+ .. container:: sect1
+
+ .. container:: sectionbody
+
+ .. container:: paragraph
+
+ This is the logic for the act state. It is simply
+ selecting an action, and creating the repsonse event
+ for the orchestrator (the output of the policy).
+
+ .. container:: listingblock
+
+ .. container:: content
+
+ .. code:: CodeRay
+
+ /*
+ * ============LICENSE_START=======================================================
+ * Copyright (C) 2016-2018 Ericsson. All rights reserved.
+ * ================================================================================
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ * ============LICENSE_END=========================================================
+ */
+
+ load("nashorn:mozilla_compat.js");
+
+ var logger = executor.logger;
+ logger.trace("start: " + executor.subject.id);
+ logger.trace("-- infields: " + executor.inFields);
+
+ var ifDecision = executor.inFields["decision"];
+ var ifMatchStart = executor.inFields["matchStart"];
+
+ var albumCustomerMap = executor.getContextAlbum("albumCustomerMap");
+ var albumProblemMap = executor.getContextAlbum("albumProblemMap");
+
+ switch (ifDecision.get("decision").toString()) {
+ case "NONE":
+ executor.outFields["edgeName"] = "";
+ executor.outFields["action"] = "";
+ break;
+ case "IMPEDE":
+ for (var i = 0; i < ifDecision.get("customers").size(); i++) {
+ customer = albumCustomerMap.get(ifDecision.get("customers").get(i).toString());
+ executor.outFields["edgeName"] = customer.get("links").get(0);
+ executor.outFields["action"] = "firewall";
+ }
+ break;
+ case "REBUILD":
+ // finally solved, remove problem
+ albumProblemMap.remove(ifDecision.get("problemID"));
+ executor.outFields["edgeName"] = "L10"; // this is ###static###
+ executor.outFields["action"] = "rebuild"; // this is ###static###
+ break;
+ default:
+
+ }
+
+ var returnValueType = Java.type("java.lang.Boolean");
+ var returnValue = new returnValueType(true);
+
+ if (executor.outFields["action"] != "") {
+ logger.info("vpnsla: action is to " + executor.outFields["action"] + " " + executor.outFields["edgeName"]);
+ } else {
+ logger.info("vpnsla: no action required");
+ }
+
+ logger.trace("-- outfields: " + executor.outFields);
+ logger.trace("finished: " + executor.subject.id);
+ logger.debug(".a");
+
+ var now = new Date().getTime();
+ logger.info("VPN SLA finished in " + (now - ifMatchStart) + " ms");
+
+CLI Spec
+--------
+
+ .. container:: sect1
+
+ .. rubric:: Complete Policy Definition
+ :name: complete_policy_definition
+
+ .. container:: sectionbody
+
+ .. container:: paragraph
+
+ The complete policy definition is realized using the
+ APEX CLI Editor. The script below shows the actual
+ policy specification. All logic and schemas are
+ included (as macro file).
+
+ .. container:: listingblock
+
+ .. container:: content
+
+ .. code:: CodeRay
+
+ #-------------------------------------------------------------------------------
+ # ============LICENSE_START=======================================================
+ # Copyright (C) 2016-2018 Ericsson. All rights reserved.
+ # ================================================================================
+ # Licensed under the Apache License, Version 2.0 (the "License");
+ # you may not use this file except in compliance with the License.
+ # You may obtain a copy of the License at
+ #
+ # http://www.apache.org/licenses/LICENSE-2.0
+ #
+ # Unless required by applicable law or agreed to in writing, software
+ # distributed under the License is distributed on an "AS IS" BASIS,
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ # See the License for the specific language governing permissions and
+ # limitations under the License.
+ #
+ # SPDX-License-Identifier: Apache-2.0
+ # ============LICENSE_END=========================================================
+ #-------------------------------------------------------------------------------
+
+ # ============LICENSE_START=======================================================
+ # Copyright (C) 2016-2018 Ericsson. All rights reserved.
+ # ================================================================================
+ # Licensed under the Apache License, Version 2.0 (the "License");
+ # you may not use this file except in compliance with the License.
+ # You may obtain a copy of the License at
+ #
+ # http://www.apache.org/licenses/LICENSE-2.0
+ #
+ # Unless required by applicable law or agreed to in writing, software
+ # distributed under the License is distributed on an "AS IS" BASIS,
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ # See the License for the specific language governing permissions and
+ # limitations under the License.
+ #
+ # SPDX-License-Identifier: Apache-2.0
+ # ============LICENSE_END=========================================================
+
+ model create name=PCVS-VpnSla version=1.0.0 description="Policies-Controlled Video Streaming, VPN SLA Policy Model"
+
+
+
+ schema create name=reportDecl version=1.0.0 description="Report of activities of a policy/task" flavour=Java schema=java.lang.String
+ event create name=ReportOut version=1.0.0 description="Report of a policy (issued by a task)" nameSpace=org.onap.policy.apex.examples.pcvs.vpnsla source="APEX" target="CtxtManagement"
+ event parameter create name=ReportOut version=1.0.0 parName=report schemaName=reportDecl schemaVersion=1.0.0
+
+ schema create name=timestampDecl version=1.0.0 description="Timestamp" flavour=Java schema=java.lang.Long
+
+
+
+ schema create name=ctxtEdgeNameDecl version=1.0.0 description="Topology Edges: edge (link) name" flavour=Java schema=java.lang.String
+ schema create name=ctxtEdgeStartDecl version=1.0.0 description="Topology Edges: edge endpoint (start)" flavour=Java schema=java.lang.String
+ schema create name=ctxtEdgeEndDecl version=1.0.0 description="Topology Edges: edge endpoint (end)" flavour=Java schema=java.lang.String
+ schema create name=ctxtEdgeStatusDecl version=1.0.0 description="Topology Edges: edge status as up (true) or down (false)" flavour=Java schema=java.lang.Boolean
+
+ schema create name=ctxtTopologyEdgesDecl version=1.0.0 description="Topology Edges Context Map" flavour=Avro schema=LS
+ #MACROFILE:"src/main/resources/org/onap/policy/apex/examples/pcvs/vpnsla/avro/topology-edges.avsc"
+ LE
+ album create name=albumTopoEdges scope=global writable=true schemaName=ctxtTopologyEdgesDecl
+
+
+ task create name=EdgeContextTask version=1.0.0 description="This task adds event context to edge context"
+ task inputfield create name=EdgeContextTask version=1.0.0 fieldName=edgeName schemaName=ctxtEdgeNameDecl schemaVersion=1.0.0
+ task inputfield create name=EdgeContextTask version=1.0.0 fieldName=start schemaName=ctxtEdgeStartDecl schemaVersion=1.0.0
+ task inputfield create name=EdgeContextTask version=1.0.0 fieldName=end schemaName=ctxtEdgeEndDecl schemaVersion=1.0.0
+ task inputfield create name=EdgeContextTask version=1.0.0 fieldName=status schemaName=ctxtEdgeStatusDecl schemaVersion=1.0.0
+ task outputfield create name=EdgeContextTask version=1.0.0 fieldName=report schemaName=reportDecl schemaVersion=1.0.0
+ task contextref create name=EdgeContextTask albumName=albumTopoEdges
+ task logic create name=EdgeContextTask logicFlavour=JAVASCRIPT logic=LS
+ #MACROFILE:"src/main/resources/org/onap/policy/apex/examples/pcvs/vpnsla/logic/ctxt-edges.js"
+ LE
+
+ event create name=EdgeContextEventIn version=1.0.0 description="Event to add an Edge to engine Context" nameSpace=org.onap.policy.apex.examples.pcvs.vpnsla source="CtxtManagement" target="APEX"
+ event parameter create name=EdgeContextEventIn version=1.0.0 parName=edgeName schemaName=ctxtEdgeNameDecl schemaVersion=1.0.0
+ event parameter create name=EdgeContextEventIn version=1.0.0 parName=start schemaName=ctxtEdgeStartDecl schemaVersion=1.0.0
+ event parameter create name=EdgeContextEventIn version=1.0.0 parName=end schemaName=ctxtEdgeEndDecl schemaVersion=1.0.0
+ event parameter create name=EdgeContextEventIn version=1.0.0 parName=status schemaName=ctxtEdgeStatusDecl schemaVersion=1.0.0
+
+ policy create name=EdgeContextPolicy version=1.0.0 description="Policy that adds an edge to context" template=FREEFORM firstState=EdgeContextState
+ policy state create name=EdgeContextPolicy version=1.0.0 stateName=EdgeContextState triggerName=EdgeContextEventIn triggerVersion=1.0.0 defaultTaskName=EdgeContextTask defaultTaskVersion=1.0.0
+ policy state output create name=EdgeContextPolicy version=1.0.0 stateName=EdgeContextState outputName=EdgeContextState_Output_Direct eventName=ReportOut eventVersion=1.0.0 nextState=NULL
+ policy state taskref create name=EdgeContextPolicy version=1.0.0 stateName=EdgeContextState taskLocalName=doContext taskName=EdgeContextTask taskVersion=1.0.0 outputType=DIRECT outputName=EdgeContextState_Output_Direct
+
+
+
+ schema create name=ctxtNodeNameDecl version=1.0.0 description="Topology Nodes: node name" flavour=Java schema=java.lang.String
+ schema create name=ctxtNodeMininetNameDecl version=1.0.0 description="Topology Nodes: node name in Mininet" flavour=Java schema=java.lang.String
+
+ schema create name=ctxtTopologyNodesDecl version=1.0.0 description="Topology Nodes Context Map" flavour=Avro schema=LS
+ #MACROFILE:"src/main/resources/org/onap/policy/apex/examples/pcvs/vpnsla/avro/topology-nodes.avsc"
+ LE
+ album create name=albumTopoNodes scope=global writable=true schemaName=ctxtTopologyNodesDecl
+
+ task create name=NodeContextTask version=1.0.0 description="This task adds event context to node context"
+ task inputfield create name=NodeContextTask version=1.0.0 fieldName=nodeName schemaName=ctxtNodeNameDecl schemaVersion=1.0.0
+ task inputfield create name=NodeContextTask version=1.0.0 fieldName=mininetName schemaName=ctxtNodeMininetNameDecl schemaVersion=1.0.0
+ task outputfield create name=NodeContextTask version=1.0.0 fieldName=report schemaName=reportDecl schemaVersion=1.0.0
+ task contextref create name=NodeContextTask albumName=albumTopoNodes
+ task logic create name=NodeContextTask logicFlavour=JAVASCRIPT logic=LS
+ #MACROFILE:"src/main/resources/org/onap/policy/apex/examples/pcvs/vpnsla/logic/ctxt-nodes.js"
+ LE
+
+ event create name=NodeContextEventIn version=1.0.0 description="Event to add Node to engine Context" nameSpace=org.onap.policy.apex.examples.pcvs.vpnsla source="CtxtManagement" target="APEX"
+ event parameter create name=NodeContextEventIn version=1.0.0 parName=nodeName schemaName=ctxtNodeNameDecl schemaVersion=1.0.0
+ event parameter create name=NodeContextEventIn version=1.0.0 parName=mininetName schemaName=ctxtNodeMininetNameDecl schemaVersion=1.0.0
+
+ policy create name=NodeContextPolicy version=1.0.0 description="Policy that adds an node to context" template=FREEFORM firstState=NodeContextState
+ policy state create name=NodeContextPolicy version=1.0.0 stateName=NodeContextState triggerName=NodeContextEventIn triggerVersion=1.0.0 defaultTaskName=NodeContextTask defaultTaskVersion=1.0.0
+ policy state output create name=NodeContextPolicy version=1.0.0 stateName=NodeContextState outputName=NodeContextState_Output_Direct eventName=ReportOut eventVersion=1.0.0 nextState=NULL
+ policy state taskref create name=NodeContextPolicy version=1.0.0 stateName=NodeContextState taskLocalName=doContext taskName=NodeContextTask taskVersion=1.0.0 outputType=DIRECT outputName=NodeContextState_Output_Direct
+
+
+
+
+ schema create name=ctxtCustomerNameDecl version=1.0.0 description="Customer Context: customer name" flavour=Java schema=java.lang.String
+ schema create name=ctxtCustomerPriorityDecl version=1.0.0 description="Customer Context: priority flag" flavour=Java schema=java.lang.Boolean
+ schema create name=ctxtCustomerSatisfactionDecl version=1.0.0 description="Customer Context: satisfaction in percent" flavour=Java schema=java.lang.Integer
+ schema create name=ctxtCustomerDowntimeSLADecl version=1.0.0 description="Customer Context: contracted downtime as per SLA" flavour=Java schema=java.lang.Integer
+ schema create name=ctxtCustomerDowntimeYTDDecl version=1.0.0 description="Customer Context: year-to-date downtime experienced" flavour=Java schema=java.lang.Integer
+ schema create name=ctxtCustomerLinksDecl version=1.0.0 description="Customer Context: links a customer uses (for events/task)" flavour=Java schema=java.lang.String
+
+ schema create name=ctxtCustomerMapDecl version=1.0.0 description="Map of customers with all known information" flavour=Avro schema=LS
+ #MACROFILE:"src/main/resources/org/onap/policy/apex/examples/pcvs/vpnsla/avro/customers.avsc"
+ LE
+ album create name=albumCustomerMap scope=global writable=true schemaName=ctxtCustomerMapDecl
+
+ task create name=CustomerContextTask version=1.0.0 description="This task adds event context to customer context"
+ task inputfield create name=CustomerContextTask version=1.0.0 fieldName=customerName schemaName=ctxtCustomerNameDecl schemaVersion=1.0.0
+ task inputfield create name=CustomerContextTask version=1.0.0 fieldName=priority schemaName=ctxtCustomerPriorityDecl schemaVersion=1.0.0
+ task inputfield create name=CustomerContextTask version=1.0.0 fieldName=satisfaction schemaName=ctxtCustomerSatisfactionDecl schemaVersion=1.0.0
+ task inputfield create name=CustomerContextTask version=1.0.0 fieldName=dtSLA schemaName=ctxtCustomerDowntimeSLADecl schemaVersion=1.0.0
+ task inputfield create name=CustomerContextTask version=1.0.0 fieldName=dtYTD schemaName=ctxtCustomerDowntimeYTDDecl schemaVersion=1.0.0
+ task inputfield create name=CustomerContextTask version=1.0.0 fieldName=links schemaName=ctxtCustomerLinksDecl schemaVersion=1.0.0
+ task outputfield create name=CustomerContextTask version=1.0.0 fieldName=report schemaName=reportDecl schemaVersion=1.0.0
+ task contextref create name=CustomerContextTask albumName=albumCustomerMap
+ task contextref create name=CustomerContextTask albumName=albumTopoEdges
+ task logic create name=CustomerContextTask logicFlavour=JAVASCRIPT logic=LS
+ #MACROFILE:"src/main/resources/org/onap/policy/apex/examples/pcvs/vpnsla/logic/ctxt-customer.js"
+ LE
+
+ event create name=CustomerContextEventIn version=1.0.0 description="Event to add Customers to engine Context" nameSpace=org.onap.policy.apex.examples.pcvs.vpnsla source="CtxtManagement" target="APEX"
+ event parameter create name=CustomerContextEventIn version=1.0.0 parName=customerName schemaName=ctxtCustomerNameDecl schemaVersion=1.0.0
+ event parameter create name=CustomerContextEventIn version=1.0.0 parName=priority schemaName=ctxtCustomerPriorityDecl schemaVersion=1.0.0
+ event parameter create name=CustomerContextEventIn version=1.0.0 parName=satisfaction schemaName=ctxtCustomerSatisfactionDecl schemaVersion=1.0.0
+ event parameter create name=CustomerContextEventIn version=1.0.0 parName=dtSLA schemaName=ctxtCustomerDowntimeSLADecl schemaVersion=1.0.0
+ event parameter create name=CustomerContextEventIn version=1.0.0 parName=dtYTD schemaName=ctxtCustomerDowntimeYTDDecl schemaVersion=1.0.0
+ event parameter create name=CustomerContextEventIn version=1.0.0 parName=links schemaName=ctxtCustomerLinksDecl schemaVersion=1.0.0
+
+ policy create name=CustomerContextPolicy version=1.0.0 description="Policy that adds Customer information to engine context" template=FREEFORM firstState=CustomerContextState
+ policy state create name=CustomerContextPolicy version=1.0.0 stateName=CustomerContextState triggerName=CustomerContextEventIn triggerVersion=1.0.0 defaultTaskName=CustomerContextTask defaultTaskVersion=1.0.0
+ policy state output create name=CustomerContextPolicy version=1.0.0 stateName=CustomerContextState outputName=CustomerContextState_Output_Direct eventName=ReportOut eventVersion=1.0.0 nextState=NULL
+ policy state taskref create name=CustomerContextPolicy version=1.0.0 stateName=CustomerContextState taskLocalName=doContext taskName=CustomerContextTask taskVersion=1.0.0 outputType=DIRECT outputName=CustomerContextState_Output_Direct
+
+
+
+
+ schema create name=edgeNameDecl version=1.0.0 description="Edge name" flavour=Java schema=java.lang.String
+ schema create name=edgeStatusDecl version=1.0.0 description="Statuf of the edge (UP, DOWN)" flavour=Avro schema=LS
+ #MACROFILE:"src/main/resources/org/onap/policy/apex/examples/pcvs/vpnsla/avro/link-status.avsc"
+ LE
+ schema create name=edgeChangedDecl version=1.0.0 description="Status Change (true:change, false:no change)" flavour=Java schema=java.lang.Boolean
+
+ task create name=VpnSlaPolicyMatchTask version=1.0.0 description="Pre-process an edge event"
+ task inputfield create name=VpnSlaPolicyMatchTask version=1.0.0 fieldName=edgeName schemaName=edgeNameDecl schemaVersion=1.0.0
+ task inputfield create name=VpnSlaPolicyMatchTask version=1.0.0 fieldName=status schemaName=edgeStatusDecl schemaVersion=1.0.0
+ task outputfield create name=VpnSlaPolicyMatchTask version=1.0.0 fieldName=edgeName schemaName=edgeNameDecl schemaVersion=1.0.0
+ task outputfield create name=VpnSlaPolicyMatchTask version=1.0.0 fieldName=status schemaName=edgeStatusDecl schemaVersion=1.0.0
+ task outputfield create name=VpnSlaPolicyMatchTask version=1.0.0 fieldName=hasChanged schemaName=edgeChangedDecl schemaVersion=1.0.0
+ task outputfield create name=VpnSlaPolicyMatchTask version=1.0.0 fieldName=matchStart schemaName=timestampDecl schemaVersion=1.0.0
+ task contextref create name=VpnSlaPolicyMatchTask albumName=albumTopoEdges
+ task logic create name=VpnSlaPolicyMatchTask logicFlavour=JAVASCRIPT logic=LS
+ #MACROFILE:"src/main/resources/org/onap/policy/apex/examples/pcvs/vpnsla/logic/task-match.js"
+ LE
+
+
+
+
+ schema create name=problemMapDecl version=1.0.0 description="Map of problems with all known Information" flavour=Avro schema=LS
+ #MACROFILE:"src/main/resources/org/onap/policy/apex/examples/pcvs/vpnsla/avro/problems.avsc"
+ LE
+ album create name=albumProblemMap scope=global writable=true schemaName=problemMapDecl
+
+ schema create name=establishSituationDecl version=1.0.0 description="Establish: the situation that was established" flavour=Avro schema=LS
+ #MACROFILE:"src/main/resources/org/onap/policy/apex/examples/pcvs/vpnsla/avro/situation.avsc"
+ LE
+
+ task create name=VpnSlaPolicyEstablishTask version=1.0.0 description="Task taking a match event and establishing a situation"
+ task inputfield create name=VpnSlaPolicyEstablishTask version=1.0.0 fieldName=edgeName schemaName=edgeNameDecl schemaVersion=1.0.0
+ task inputfield create name=VpnSlaPolicyEstablishTask version=1.0.0 fieldName=status schemaName=edgeStatusDecl schemaVersion=1.0.0
+ task inputfield create name=VpnSlaPolicyEstablishTask version=1.0.0 fieldName=hasChanged schemaName=edgeChangedDecl schemaVersion=1.0.0
+ task inputfield create name=VpnSlaPolicyEstablishTask version=1.0.0 fieldName=matchStart schemaName=timestampDecl schemaVersion=1.0.0
+ task outputfield create name=VpnSlaPolicyEstablishTask version=1.0.0 fieldName=situation schemaName=establishSituationDecl schemaVersion=1.0.0
+ task outputfield create name=VpnSlaPolicyEstablishTask version=1.0.0 fieldName=matchStart schemaName=timestampDecl schemaVersion=1.0.0
+ task contextref create name=VpnSlaPolicyEstablishTask albumName=albumProblemMap
+ task contextref create name=VpnSlaPolicyEstablishTask albumName=albumCustomerMap
+ task logic create name=VpnSlaPolicyEstablishTask logicFlavour=JAVASCRIPT logic=LS
+ #MACROFILE:"src/main/resources/org/onap/policy/apex/examples/pcvs/vpnsla/logic/task-establish.js"
+ LE
+
+
+
+
+ schema create name=decideDecisionDecl version=1.0.0 description="Decide: the taken decision" flavour=Avro schema=LS
+ #MACROFILE:"src/main/resources/org/onap/policy/apex/examples/pcvs/vpnsla/avro/decision.avsc"
+ LE
+
+ task create name=VpnSlaPolicyDecideNoneTask version=1.0.0 description="Decide task for a 'none' problem"
+ task inputfield create name=VpnSlaPolicyDecideNoneTask version=1.0.0 fieldName=situation schemaName=establishSituationDecl schemaVersion=1.0.0
+ task inputfield create name=VpnSlaPolicyDecideNoneTask version=1.0.0 fieldName=matchStart schemaName=timestampDecl schemaVersion=1.0.0
+ task outputfield create name=VpnSlaPolicyDecideNoneTask version=1.0.0 fieldName=decision schemaName=decideDecisionDecl schemaVersion=1.0.0
+ task outputfield create name=VpnSlaPolicyDecideNoneTask version=1.0.0 fieldName=matchStart schemaName=timestampDecl schemaVersion=1.0.0
+ task logic create name=VpnSlaPolicyDecideNoneTask logicFlavour=JAVASCRIPT logic=LS
+ #MACROFILE:"src/main/resources/org/onap/policy/apex/examples/pcvs/vpnsla/logic/task-decide-none.js"
+ LE
+
+
+ task create name=VpnSlaPolicyDecideSlaTask version=1.0.0 description="Decide task solving the problem by balancing SLAs"
+ task inputfield create name=VpnSlaPolicyDecideSlaTask version=1.0.0 fieldName=situation schemaName=establishSituationDecl schemaVersion=1.0.0
+ task inputfield create name=VpnSlaPolicyDecideSlaTask version=1.0.0 fieldName=matchStart schemaName=timestampDecl schemaVersion=1.0.0
+ task outputfield create name=VpnSlaPolicyDecideSlaTask version=1.0.0 fieldName=decision schemaName=decideDecisionDecl schemaVersion=1.0.0
+ task outputfield create name=VpnSlaPolicyDecideSlaTask version=1.0.0 fieldName=matchStart schemaName=timestampDecl schemaVersion=1.0.0
+ task contextref create name=VpnSlaPolicyDecideSlaTask albumName=albumCustomerMap
+ task contextref create name=VpnSlaPolicyDecideSlaTask albumName=albumProblemMap
+ task logic create name=VpnSlaPolicyDecideSlaTask logicFlavour=JAVASCRIPT logic=LS
+ #MACROFILE:"src/main/resources/org/onap/policy/apex/examples/pcvs/vpnsla/logic/task-decide-sla.js"
+ LE
+
+
+ task create name=VpnSlaPolicyDecidePriorityTask version=1.0.0 description="Decide task solving the problem by using customer priorities"
+ task inputfield create name=VpnSlaPolicyDecidePriorityTask version=1.0.0 fieldName=situation schemaName=establishSituationDecl schemaVersion=1.0.0
+ task inputfield create name=VpnSlaPolicyDecidePriorityTask version=1.0.0 fieldName=matchStart schemaName=timestampDecl schemaVersion=1.0.0
+ task outputfield create name=VpnSlaPolicyDecidePriorityTask version=1.0.0 fieldName=decision schemaName=decideDecisionDecl schemaVersion=1.0.0
+ task outputfield create name=VpnSlaPolicyDecidePriorityTask version=1.0.0 fieldName=matchStart schemaName=timestampDecl schemaVersion=1.0.0
+ task contextref create name=VpnSlaPolicyDecidePriorityTask albumName=albumCustomerMap
+ task contextref create name=VpnSlaPolicyDecidePriorityTask albumName=albumProblemMap
+ task logic create name=VpnSlaPolicyDecidePriorityTask logicFlavour=JAVASCRIPT logic=LS
+ #MACROFILE:"src/main/resources/org/onap/policy/apex/examples/pcvs/vpnsla/logic/task-decide-priority.js"
+ LE
+
+
+ task create name=VpnSlaPolicyDecideSolvedTask version=1.0.0 description="Decide task solving the problem by using customer priorities"
+ task inputfield create name=VpnSlaPolicyDecideSolvedTask version=1.0.0 fieldName=situation schemaName=establishSituationDecl schemaVersion=1.0.0
+ task inputfield create name=VpnSlaPolicyDecideSolvedTask version=1.0.0 fieldName=matchStart schemaName=timestampDecl schemaVersion=1.0.0
+ task outputfield create name=VpnSlaPolicyDecideSolvedTask version=1.0.0 fieldName=decision schemaName=decideDecisionDecl schemaVersion=1.0.0
+ task outputfield create name=VpnSlaPolicyDecideSolvedTask version=1.0.0 fieldName=matchStart schemaName=timestampDecl schemaVersion=1.0.0
+ task contextref create name=VpnSlaPolicyDecideSolvedTask albumName=albumProblemMap
+ task logic create name=VpnSlaPolicyDecideSolvedTask logicFlavour=JAVASCRIPT logic=LS
+ #MACROFILE:"src/main/resources/org/onap/policy/apex/examples/pcvs/vpnsla/logic/task-decide-solved.js"
+ LE
+
+
+
+
+ schema create name=actionDecl version=1.0.0 description="An action for the actioning system" flavour=Java schema=java.lang.String
+
+ task create name=VpnSlaPolicyActTask version=1.0.0 description="Task issueing an action for taken decision"
+ task inputfield create name=VpnSlaPolicyActTask version=1.0.0 fieldName=decision schemaName=decideDecisionDecl schemaVersion=1.0.0
+ task inputfield create name=VpnSlaPolicyActTask version=1.0.0 fieldName=matchStart schemaName=timestampDecl schemaVersion=1.0.0
+ task outputfield create name=VpnSlaPolicyActTask version=1.0.0 fieldName=edgeName schemaName=edgeNameDecl schemaVersion=1.0.0
+ task outputfield create name=VpnSlaPolicyActTask version=1.0.0 fieldName=action schemaName=actionDecl schemaVersion=1.0.0
+ task contextref create name=VpnSlaPolicyActTask albumName=albumCustomerMap
+ task contextref create name=VpnSlaPolicyActTask albumName=albumProblemMap
+ task logic create name=VpnSlaPolicyActTask logicFlavour=JAVASCRIPT logic=LS
+ #MACROFILE:"src/main/resources/org/onap/policy/apex/examples/pcvs/vpnsla/logic/task-act.js"
+ LE
+
+
+
+
+
+
+
+ event create name=VpnSlaTrigger version=1.0.0 description="Event triggering the VPN SLA policy" nameSpace=org.onap.policy.apex.examples.pcvs.vpnsla source="TriggerSys" target="VpnSlaMatch"
+ event parameter create name=VpnSlaTrigger version=1.0.0 parName=edgeName schemaName=edgeNameDecl schemaVersion=1.0.0
+ event parameter create name=VpnSlaTrigger version=1.0.0 parName=status schemaName=edgeStatusDecl schemaVersion=1.0.0
+
+ event create name=VpnSlaMatchOut version=1.0.0 description="Event with matched trigger for the VPN SLA policy" nameSpace=org.onap.policy.apex.examples.pcvs.vpnsla source="VpnSlaMatch" target="VpnSlaEstablish"
+ event parameter create name=VpnSlaMatchOut version=1.0.0 parName=edgeName schemaName=edgeNameDecl schemaVersion=1.0.0
+ event parameter create name=VpnSlaMatchOut version=1.0.0 parName=status schemaName=edgeStatusDecl schemaVersion=1.0.0
+ event parameter create name=VpnSlaMatchOut version=1.0.0 parName=hasChanged schemaName=edgeChangedDecl schemaVersion=1.0.0
+ event parameter create name=VpnSlaMatchOut version=1.0.0 parName=matchStart schemaName=timestampDecl schemaVersion=1.0.0
+
+ event create name=VpnSlaEstablishOut version=1.0.0 description="Event with situation for the SLA policy" nameSpace=org.onap.policy.apex.examples.pcvs.vpnsla source="SlaEstablish" target="SlaDecide"
+ event parameter create name=VpnSlaEstablishOut version=1.0.0 parName=situation schemaName=establishSituationDecl schemaVersion=1.0.0
+ event parameter create name=VpnSlaEstablishOut version=1.0.0 parName=matchStart schemaName=timestampDecl schemaVersion=1.0.0
+
+ event create name=VpnSlaDecideOut version=1.0.0 description="Event with a decision for the SLA policy" nameSpace=org.onap.policy.apex.examples.pcvs.vpnsla source="SlaDecide" target="SlaAct"
+ event parameter create name=VpnSlaDecideOut version=1.0.0 parName=decision schemaName=decideDecisionDecl schemaVersion=1.0.0
+ event parameter create name=VpnSlaDecideOut version=1.0.0 parName=matchStart schemaName=timestampDecl schemaVersion=1.0.0
+
+ event create name=VpnSlaActOut version=1.0.0 description="Event action" nameSpace=org.onap.policy.apex.examples.pcvs.vpnsla source="SlaAct" target="ActioningSystem"
+ event parameter create name=VpnSlaActOut version=1.0.0 parName=edgeName schemaName=edgeNameDecl schemaVersion=1.0.0
+ event parameter create name=VpnSlaActOut version=1.0.0 parName=action schemaName=actionDecl schemaVersion=1.0.0
+
+
+ policy create name=VpnSlaPolicy version=1.0.0 description="Policy deciding customer treatment based on SLAs as MEDA policy" template=FREEFORM firstState=VpnSlaPolicyMatchState
+
+ policy state create name=VpnSlaPolicy version=1.0.0 stateName=VpnSlaPolicyActState triggerName=VpnSlaDecideOut triggerVersion=1.0.0 defaultTaskName=VpnSlaPolicyActTask defaultTaskVersion=1.0.0
+ policy state output create name=VpnSlaPolicy version=1.0.0 stateName=VpnSlaPolicyActState outputName=SlaPolicyAct_Output_Direct eventName=VpnSlaActOut eventVersion=1.0.0 nextState=NULL
+ policy state taskref create name=VpnSlaPolicy version=1.0.0 stateName=VpnSlaPolicyActState taskLocalName=act taskName=VpnSlaPolicyActTask taskVersion=1.0.0 outputType=DIRECT outputName=SlaPolicyAct_Output_Direct
+
+ policy state create name=VpnSlaPolicy version=1.0.0 stateName=VpnSlaPolicyDecideState triggerName=VpnSlaEstablishOut triggerVersion=1.0.0 defaultTaskName=VpnSlaPolicyDecideSlaTask defaultTaskVersion=1.0.0
+ policy state contextref create name=VpnSlaPolicy version=1.0.0 stateName=VpnSlaPolicyDecideState albumName=albumProblemMap
+ policy state selecttasklogic create name=VpnSlaPolicy stateName=VpnSlaPolicyDecideState logicFlavour=JAVASCRIPT logic=LS
+ #MACROFILE:"src/main/resources/org/onap/policy/apex/examples/pcvs/vpnsla/logic/tsl-decide.js"
+ LE
+ policy state output create name=VpnSlaPolicy version=1.0.0 stateName=VpnSlaPolicyDecideState outputName=VpnSlaPolicyDecide_Output_Direct eventName=VpnSlaDecideOut eventVersion=1.0.0 nextState=VpnSlaPolicyActState
+ policy state taskref create name=VpnSlaPolicy version=1.0.0 stateName=VpnSlaPolicyDecideState taskLocalName=decideNone taskName=VpnSlaPolicyDecideNoneTask taskVersion=1.0.0 outputType=DIRECT outputName=VpnSlaPolicyDecide_Output_Direct
+ policy state taskref create name=VpnSlaPolicy version=1.0.0 stateName=VpnSlaPolicyDecideState taskLocalName=decideNone taskName=VpnSlaPolicyDecideSolvedTask taskVersion=1.0.0 outputType=DIRECT outputName=VpnSlaPolicyDecide_Output_Direct
+ policy state taskref create name=VpnSlaPolicy version=1.0.0 stateName=VpnSlaPolicyDecideState taskLocalName=decideSla taskName=VpnSlaPolicyDecideSlaTask taskVersion=1.0.0 outputType=DIRECT outputName=VpnSlaPolicyDecide_Output_Direct
+ policy state taskref create name=VpnSlaPolicy version=1.0.0 stateName=VpnSlaPolicyDecideState taskLocalName=decidePriority taskName=VpnSlaPolicyDecidePriorityTask taskVersion=1.0.0 outputType=DIRECT outputName=VpnSlaPolicyDecide_Output_Direct
+
+ policy state create name=VpnSlaPolicy version=1.0.0 stateName=VpmSlaPolicyEstablishState triggerName=VpnSlaMatchOut triggerVersion=1.0.0 defaultTaskName=VpnSlaPolicyEstablishTask defaultTaskVersion=1.0.0
+ policy state output create name=VpnSlaPolicy version=1.0.0 stateName=VpmSlaPolicyEstablishState outputName=VpnSlaPolicyEstablish_Output_Direct eventName=VpnSlaEstablishOut eventVersion=1.0.0 nextState=VpnSlaPolicyDecideState
+ policy state taskref create name=VpnSlaPolicy version=1.0.0 stateName=VpmSlaPolicyEstablishState taskLocalName=establish taskName=VpnSlaPolicyEstablishTask taskVersion=1.0.0 outputType=DIRECT outputName=VpnSlaPolicyEstablish_Output_Direct
+
+ policy state create name=VpnSlaPolicy version=1.0.0 stateName=VpnSlaPolicyMatchState triggerName=VpnSlaTrigger triggerVersion=1.0.0 defaultTaskName=VpnSlaPolicyMatchTask defaultTaskVersion=1.0.0
+ policy state output create name=VpnSlaPolicy version=1.0.0 stateName=VpnSlaPolicyMatchState outputName=VpnSlaPolicyMatch_Output_Direct eventName=VpnSlaMatchOut eventVersion=1.0.0 nextState=VpmSlaPolicyEstablishState
+ policy state taskref create name=VpnSlaPolicy version=1.0.0 stateName=VpnSlaPolicyMatchState taskLocalName=match taskName=VpnSlaPolicyMatchTask taskVersion=1.0.0 outputType=DIRECT outputName=VpnSlaPolicyMatch_Output_Direct
+
+
+
+ validate
+ quit
+
+Context Events Nodes
+--------------------
+
+ .. container:: sect1
+
+ .. container:: sectionbody
+
+ .. container:: paragraph
+
+ The following events create all nodes of the topology.
+
+ .. container:: listingblock
+
+ .. container:: content
+
+ .. code:: CodeRay
+
+ {
+ "nameSpace": "org.onap.policy.apex.examples.pcvs.vpnsla",
+ "name": "NodeContextEventIn",
+ "version": "1.0.0",
+ "source": "CtxtManagement",
+ "target" : "VpnSlaPolicy_NodeContext",
+ "nodeName": "A1",
+ "mininetName": "nn"
+ }
+
+ {
+ "nameSpace": "org.onap.policy.apex.examples.pcvs.vpnsla",
+ "name": "NodeContextEventIn",
+ "version": "1.0.0",
+ "source": "CtxtManagement",
+ "target" : "VpnSlaPolicy_NodeContext",
+ "nodeName": "A2",
+ "mininetName": "nn"
+ }
+
+ {
+ "nameSpace": "org.onap.policy.apex.examples.pcvs.vpnsla",
+ "name": "NodeContextEventIn",
+ "version": "1.0.0",
+ "source": "CtxtManagement",
+ "target" : "VpnSlaPolicy_NodeContext",
+ "nodeName": "B1",
+ "mininetName": "nn"
+ }
+
+ {
+ "nameSpace": "org.onap.policy.apex.examples.pcvs.vpnsla",
+ "name": "NodeContextEventIn",
+ "version": "1.0.0",
+ "source": "CtxtManagement",
+ "target" : "VpnSlaPolicy_NodeContext",
+ "nodeName": "B2",
+ "mininetName": "nn"
+ }
+
+
+ {
+ "nameSpace": "org.onap.policy.apex.examples.pcvs.vpnsla",
+ "name": "NodeContextEventIn",
+ "version": "1.0.0",
+ "source": "CtxtManagement",
+ "target" : "VpnSlaPolicy_NodeContext",
+ "nodeName": "A1CO",
+ "mininetName": "s1"
+ }
+
+ {
+ "nameSpace": "org.onap.policy.apex.examples.pcvs.vpnsla",
+ "name": "NodeContextEventIn",
+ "version": "1.0.0",
+ "source": "CtxtManagement",
+ "target" : "VpnSlaPolicy_NodeContext",
+ "nodeName": "A2CO",
+ "mininetName": "s2"
+ }
+
+ {
+ "nameSpace": "org.onap.policy.apex.examples.pcvs.vpnsla",
+ "name": "NodeContextEventIn",
+ "version": "1.0.0",
+ "source": "CtxtManagement",
+ "target" : "VpnSlaPolicy_NodeContext",
+ "nodeName": "B1CO",
+ "mininetName": "s3"
+ }
+
+ {
+ "nameSpace": "org.onap.policy.apex.examples.pcvs.vpnsla",
+ "name": "NodeContextEventIn",
+ "version": "1.0.0",
+ "source": "CtxtManagement",
+ "target" : "VpnSlaPolicy_NodeContext",
+ "nodeName": "B2CO",
+ "mininetName": "s4"
+ }
+
+ {
+ "nameSpace": "org.onap.policy.apex.examples.pcvs.vpnsla",
+ "name": "NodeContextEventIn",
+ "version": "1.0.0",
+ "source": "CtxtManagement",
+ "target" : "VpnSlaPolicy_NodeContext",
+ "nodeName": "BBL",
+ "mininetName": "s5"
+ }
+
+ {
+ "nameSpace": "org.onap.policy.apex.examples.pcvs.vpnsla",
+ "name": "NodeContextEventIn",
+ "version": "1.0.0",
+ "source": "CtxtManagement",
+ "target" : "VpnSlaPolicy_NodeContext",
+ "nodeName": "BBR",
+ "mininetName": "s6"
+ }
+
+Context Events Edges
+--------------------
+
+ .. container:: sect1
+
+ .. container:: sectionbody
+
+ .. container:: paragraph
+
+ The following events create all edges of the topology.
+
+ .. container:: listingblock
+
+ .. container:: content
+
+ .. code:: CodeRay
+
+ {
+ "nameSpace": "org.onap.policy.apex.examples.pcvs.vpnsla",
+ "name": "EdgeContextEventIn",
+ "version": "1.0.0",
+ "source": "CtxtManagement",
+ "target" : "VpnSlaPolicy_EdgeContext",
+ "edgeName": "L01",
+ "start": "A1",
+ "end": "A1CO",
+ "status": true
+ }
+
+ {
+ "nameSpace": "org.onap.policy.apex.examples.pcvs.vpnsla",
+ "name": "EdgeContextEventIn",
+ "version": "1.0.0",
+ "source": "CtxtManagement",
+ "target" : "VpnSlaPolicy_EdgeContext",
+ "edgeName": "L02",
+ "start": "B1",
+ "end": "B1CO",
+ "status": true
+ }
+
+ {
+ "nameSpace": "org.onap.policy.apex.examples.pcvs.vpnsla",
+ "name": "EdgeContextEventIn",
+ "version": "1.0.0",
+ "source": "CtxtManagement",
+ "target" : "VpnSlaPolicy_EdgeContext",
+ "edgeName": "L03",
+ "start": "A2",
+ "end": "A2CO",
+ "status": true
+ }
+
+ {
+ "nameSpace": "org.onap.policy.apex.examples.pcvs.vpnsla",
+ "name": "EdgeContextEventIn",
+ "version": "1.0.0",
+ "source": "CtxtManagement",
+ "target" : "VpnSlaPolicy_EdgeContext",
+ "edgeName": "L04",
+ "start": "B2",
+ "end": "B2CO",
+ "status": true
+ }
+
+ {
+ "nameSpace": "org.onap.policy.apex.examples.pcvs.vpnsla",
+ "name": "EdgeContextEventIn",
+ "version": "1.0.0",
+ "source": "CtxtManagement",
+ "target" : "VpnSlaPolicy_EdgeContext",
+ "edgeName": "L05",
+ "start": "A1CO",
+ "end": "BBL",
+ "status": true
+ }
+
+ {
+ "nameSpace": "org.onap.policy.apex.examples.pcvs.vpnsla",
+ "name": "EdgeContextEventIn",
+ "version": "1.0.0",
+ "source": "CtxtManagement",
+ "target" : "VpnSlaPolicy_EdgeContext",
+ "edgeName": "L06",
+ "start": "B1CO",
+ "end": "BBL",
+ "status": true
+ }
+
+ {
+ "nameSpace": "org.onap.policy.apex.examples.pcvs.vpnsla",
+ "name": "EdgeContextEventIn",
+ "version": "1.0.0",
+ "source": "CtxtManagement",
+ "target" : "VpnSlaPolicy_EdgeContext",
+ "edgeName": "L07",
+ "start": "A2CO",
+ "end": "BBR",
+ "status": true
+ }
+
+ {
+ "nameSpace": "org.onap.policy.apex.examples.pcvs.vpnsla",
+ "name": "EdgeContextEventIn",
+ "version": "1.0.0",
+ "source": "CtxtManagement",
+ "target" : "VpnSlaPolicy_EdgeContext",
+ "edgeName": "L08",
+ "start": "B2CO",
+ "end": "BBR",
+ "status": true
+ }
+
+ {
+ "nameSpace": "org.onap.policy.apex.examples.pcvs.vpnsla",
+ "name": "EdgeContextEventIn",
+ "version": "1.0.0",
+ "source": "CtxtManagement",
+ "target" : "VpnSlaPolicy_EdgeContext",
+ "edgeName": "L09",
+ "start": "BBL",
+ "end": "BBR",
+ "status": true
+ }
+
+ {
+ "nameSpace": "org.onap.policy.apex.examples.pcvs.vpnsla",
+ "name": "EdgeContextEventIn",
+ "version": "1.0.0",
+ "source": "CtxtManagement",
+ "target" : "VpnSlaPolicy_EdgeContext",
+ "edgeName": "L10",
+ "start": "BBR",
+ "end": "BBL",
+ "status": true
+ }
+
+Context Events Customers
+------------------------
+
+ .. container:: sect1
+
+ .. container:: sectionbody
+
+ .. container:: paragraph
+
+ The following events create all customers of the
+ topology.
+
+ .. container:: listingblock
+
+ .. container:: content
+
+ .. code:: CodeRay
+
+ {
+ "nameSpace": "org.onap.policy.apex.examples.pcvs.vpnsla",
+ "name": "CustomerContextEventIn",
+ "version": "1.0.0",
+ "source": "CtxtManagement",
+ "target" : "VpnSlaPolicy_CustomerContext",
+ "customerName": "A",
+ "links": "L01 L05 L09 L10",
+ "dtSLA": 180,
+ "dtYTD": 10,
+ "priority": false,
+ "satisfaction": 80
+ }
+
+ {
+ "nameSpace": "org.onap.policy.apex.examples.pcvs.vpnsla",
+ "name": "CustomerContextEventIn",
+ "version": "1.0.0",
+ "source": "CtxtManagement",
+ "target" : "VpnSlaPolicy_CustomerContext",
+ "customerName": "B",
+ "links": "L02 L07 L09 L10",
+ "dtSLA": 180,
+ "dtYTD": 120,
+ "priority": true,
+ "satisfaction": 99
+ }
+
+Trigger Examples
+----------------
+
+ .. container:: sect1
+
+ .. container:: sectionbody
+
+ .. container:: paragraph
+
+ The following events are examples for trigger events
+
+ .. container:: listingblock
+
+ .. container:: content
+
+ .. code:: CodeRay
+
+ {
+ "nameSpace": "org.onap.policy.apex.examples.pcvs.vpnsla",
+ "name": "VpnSlaTrigger",
+ "version": "1.0.0",
+ "source": "ExampleEvents",
+ "target" : "VpnSlaPolicy",
+ "edgeName": "L09",
+ "status": "UP"
+ }
+
+ {
+ "nameSpace": "org.onap.policy.apex.examples.pcvs.vpnsla",
+ "name": "VpnSlaTrigger",
+ "version": "1.0.0",
+ "source": "ExampleEvents",
+ "target" : "VpnSlaPolicy",
+ "edgeName": "L09",
+ "status": "UP"
+ }
+
+ {
+ "nameSpace": "org.onap.policy.apex.examples.pcvs.vpnsla",
+ "name": "VpnSlaTrigger",
+ "version": "1.0.0",
+ "source": "ExampleEvents",
+ "target" : "VpnSlaPolicy",
+ "edgeName": "L09",
+ "status": "DOWN"
+ }
+
+ {
+ "nameSpace": "org.onap.policy.apex.examples.pcvs.vpnsla",
+ "name": "VpnSlaTrigger",
+ "version": "1.0.0",
+ "source": "ExampleEvents",
+ "target" : "VpnSlaPolicy",
+ "edgeName": "L09",
+ "status": "DOWN"
+ }
+
+ {
+ "nameSpace": "org.onap.policy.apex.examples.pcvs.vpnsla",
+ "name": "VpnSlaTrigger",
+ "version": "1.0.0",
+ "source": "ExampleEvents",
+ "target" : "VpnSlaPolicy",
+ "edgeName": "L09",
+ "status": "UP"
+ }
+
+Link Monitor
+------------
+
+ .. container:: sect1
+
+ .. container:: sectionbody
+
+ .. container:: paragraph
+
+ The Link Monitor is a Python script. At startup, it
+ sends the context events to APEX to initialize the
+ topology and the customers. Then it takes events from
+ Kafka and sends them to APEX.
+
+ .. container:: listingblock
+
+ .. container:: content
+
+ .. code:: CodeRay
+
+ # ============LICENSE_START=======================================================
+ # Copyright (C) 2016-2018 Ericsson. All rights reserved.
+ # ================================================================================
+ # Licensed under the Apache License, Version 2.0 (the "License");
+ # you may not use this file except in compliance with the License.
+ # You may obtain a copy of the License at
+ #
+ # http://www.apache.org/licenses/LICENSE-2.0
+ #
+ # Unless required by applicable law or agreed to in writing, software
+ # distributed under the License is distributed on an "AS IS" BASIS,
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ # See the License for the specific language governing permissions and
+ # limitations under the License.
+ #
+ # SPDX-License-Identifier: Apache-2.0
+ # ============LICENSE_END=========================================================
+
+ import http.client
+ import json
+ import time
+ from kafka import KafkaConsumer, KafkaProducer
+
+ class StaticFlowPusher(object):
+
+ def __init__(self, server):
+ self.server = server
+
+ def get(self, data):
+ ret = self.rest_call({}, 'GET')
+ return json.loads(ret[2])
+
+ def set(self, data):
+ ret = self.rest_call(data, 'POST')
+ return ret[0] == 200
+
+ def remove(self, objtype, data):
+ ret = self.rest_call(data, 'DELETE')
+ return ret[0] == 200
+
+ def getControllerSummary(self, data):
+ ret = self.rest_call_controller_summary({}, 'GET')
+ return json.loads(ret[2])
+
+ def getLinks(self, data):
+ ret = self.rest_call_links({}, 'GET')
+ return json.loads(ret[2].decode())
+
+ def rest_call(self, data, action):
+ path = '/wm/staticflowpusher/json'
+ headers = {
+ 'Content-type': 'application/json',
+ 'Accept': 'application/json',
+ }
+ body = json.dumps(data)
+ conn = http.client.HTTPConnection(self.server, 8080)
+ conn.request(action, path, body, headers)
+ response = conn.getresponse()
+ ret = (response.status, response.reason, response.read())
+ print(ret)
+ conn.close()
+ return ret
+
+ def rest_call_controller_summary(self, data, action):
+ path = '/wm/core/controller/summary/json'
+ headers = {
+ 'Content-type': 'application/json',
+ 'Accept': 'application/json',
+ }
+ body = json.dumps(data)
+ conn = http.client.HTTPConnection(self.server, 8080)
+ conn.request(action, path, body, headers)
+ response = conn.getresponse()
+ ret = (response.status, response.reason, response.read())
+ print(ret)
+ conn.close()
+ return ret
+
+ def rest_call_links(self, data, action):
+ path = '/wm/topology/links/json'
+ headers = {
+ 'Content-type': 'application/json',
+ 'Accept': 'application/json',
+ }
+ body = json.dumps(data)
+ conn = http.client.HTTPConnection(self.server, 8080)
+ conn.request(action, path, body, headers)
+ response = conn.getresponse()
+ ret = (response.status, response.reason, response.read())
+ conn.close()
+ return ret
+
+ pusher = StaticFlowPusher('127.0.1.1')
+
+
+ def parseLinks(links):
+ #print("\n\n\n",links)
+ result = []
+ for link in links:
+ list = []
+ #print("\n\n\n",link)
+ #print("\nsrc-switch : s", link['src-switch'][len(link['src-switch'])-1])
+ #print("\ndst-switch : s", link['dst-switch'][len(link['dst-switch'])-1])
+ list.append("s")
+ list.append(link['src-switch'][len(link['src-switch'])-1])
+ list.append("-s")
+ list.append(link['dst-switch'][len(link['dst-switch'])-1])
+ result.append(''.join(list))
+ #print(result, "\n")
+ return result
+
+
+
+ counter =0
+ healthyList = []
+ testableList = []
+ healthyLinks = ""
+ testableLinks = ""
+ producer = KafkaProducer(bootstrap_servers='localhost:9092')
+ while(True):
+ time.sleep(30)
+ switchLinks = pusher.getLinks({})
+ if counter == 0:
+ healthyList = parseLinks(switchLinks)
+ #Build All Links
+ print("READING LINKS FROM MININET\n")
+ for l in healthyList:
+ link = ""
+ #print(l, "\n")
+ #Links between switches [s6-s7 is ignored so it matches VPN SCENARIO]
+ if(l == "s1-s5"):
+ link = "{'nameSpace': 'org.onap.policy.apex.examples.pcvs.vpnsla','name': 'EdgeContextEventIn','version': '1.0.0','source': 'LinkMonitor.py','target': 'VpnSlaPolicy_EdgeContext','status': true,'edgeName': 'L05', 'start': 'A1CO','end': 'BBL'}"
+ producer.send("apex-in-0", bytes(link, encoding="ascii"))
+ if(l == "s5-s6"):
+ link = "{'nameSpace': 'org.onap.policy.apex.examples.pcvs.vpnsla','name': 'EdgeContextEventIn','version': '1.0.0','source': 'LinkMonitor.py','target': 'VpnSlaPolicy_EdgeContext','status': true,'edgeName': 'L09', 'start': 'BBL','end': 'BBR'}"
+ producer.send("apex-in-0", bytes(link, encoding="ascii"))
+ if(l == "s2-s6"):
+ link = "{'nameSpace': 'org.onap.policy.apex.examples.pcvs.vpnsla','name': 'EdgeContextEventIn','version': '1.0.0','source': 'LinkMonitor.py','target': 'VpnSlaPolicy_EdgeContext','status': true,'edgeName': 'L07', 'start': 'A2CO','end': 'BBR'}"
+ producer.send("apex-in-0", bytes(link, encoding="ascii"))
+ if(l == "s5-s7"):
+ link = "{'nameSpace': 'org.onap.policy.apex.examples.pcvs.vpnsla','name': 'EdgeContextEventIn','version': '1.0.0','source': 'LinkMonitor.py','target': 'VpnSlaPolicy_EdgeContext','status': true,'edgeName': 'L10', 'start': 'BBR','end': 'BBL'}"
+ producer.send("apex-in-0", bytes(link, encoding="ascii"))
+ if(l == "s3-s5"):
+ link = "{'nameSpace': 'org.onap.policy.apex.examples.pcvs.vpnsla','name': 'EdgeContextEventIn','version': '1.0.0','source': 'LinkMonitor.py','target': 'VpnSlaPolicy_EdgeContext','status': true,'edgeName': 'L06', 'start': 'B1CO','end': 'BBL'}"
+ producer.send("apex-in-0", bytes(link, encoding="ascii"))
+ if(l == "s4-s6"):
+ link = "{'nameSpace': 'org.onap.policy.apex.examples.pcvs.vpnsla','name': 'EdgeContextEventIn','version': '1.0.0','source': 'LinkMonitor.py','target': 'VpnSlaPolicy_EdgeContext','status': true,'edgeName': 'L08', 'start': 'B2CO','end': 'BBR'}"
+ producer.send("apex-in-0", bytes(link, encoding="ascii"))
+ #Links between switches and hosts [NoT SENT IN FROM FLOODLIGHT]
+ producer.send("apex-in-0", b"{'nameSpace': 'org.onap.policy.apex.examples.pcvs.vpnsla','name': 'EdgeContextEventIn','version': '1.0.0','source': 'LinkMonitor.py','target': 'VpnSlaPolicy_EdgeContext','status': true,'edgeName': 'L01', 'start': 'A1','end': 'A1CO'}")
+ producer.send("apex-in-0", b"{'nameSpace': 'org.onap.policy.apex.examples.pcvs.vpnsla','name': 'EdgeContextEventIn','version': '1.0.0','source': 'LinkMonitor.py','target': 'VpnSlaPolicy_EdgeContext','status': true,'edgeName': 'L02', 'start': 'B1','end': 'B1CO'}")
+ producer.send("apex-in-0", b"{'nameSpace': 'org.onap.policy.apex.examples.pcvs.vpnsla','name': 'EdgeContextEventIn','version': '1.0.0','source': 'LinkMonitor.py','target': 'VpnSlaPolicy_EdgeContext','status': true,'edgeName': 'L03', 'start': 'A2','end': 'A2CO'}")
+ producer.send("apex-in-0", b"{'nameSpace': 'org.onap.policy.apex.examples.pcvs.vpnsla','name': 'EdgeContextEventIn','version': '1.0.0','source': 'LinkMonitor.py','target': 'VpnSlaPolicy_EdgeContext','status': true,'edgeName': 'L04', 'start': 'B2','end': 'B2CO'}")
+ print("LINKS HAVE BEEN SENT TO APEX\n")
+
+ #Build Customers
+ print("BUILDING CUSTOMERS\n")
+ producer.send("apex-in-0", b"{'nameSpace': 'org.onap.policy.apex.examples.pcvs.vpnsla','name': 'CustomerContextEventIn','version': '1.0.0','source': 'LinkMonitor.py','target': 'VpnSlaPolicy_CustomerContext','dtYTD': 10,'dtSLA': 180,'links': 'L01 L05 L09 L10','customerName': 'A', 'priority': true,'satisfaction': 80}")
+ producer.send("apex-in-0", b"{'nameSpace': 'org.onap.policy.apex.examples.pcvs.vpnsla','name': 'CustomerContextEventIn','version': '1.0.0','source': 'LinkMonitor.py','target': 'VpnSlaPolicy_CustomerContext','dtYTD': 120,'dtSLA': 180,'links': 'L02 L07 L09 L10','customerName': 'B', 'priority': false,'satisfaction': 99}")
+ print("CUSTOMERS HAVE BEEN SENT TO APEX\n")
+ healthyLinks = switchLinks
+ myfile = open('LinkInfo.json', 'a')
+ myfile.write(str(healthyLinks))
+ myfile.write('\n')
+ myfile.close()
+ print("We start off with", len(healthyLinks), "healthy Links!\n")
+ else:
+ testableList = parseLinks(switchLinks)
+ issueLink = "";
+ for h in healthyList:
+ issueLink = h
+ for t in testableList:
+ if t == h:
+ issueLink = ""
+ if issueLink != "":
+ print("There is an issue with the links! ", issueLink, " \n")
+ if(issueLink == "s1-s5"):
+ link = "{'nameSpace': 'org.onap.policy.apex.examples.pcvs.vpnsla','name': 'VpnSlaTrigger','version': '1.0.0','source': 'LinkMonitor.py','target': 'VpnSlaPolicy','status': 'DOWN','edgeName': 'L05'}"
+ producer.send("apex-in-0", bytes(link, encoding="ascii"))
+ if(issueLink == "s5-s6"):
+ link = "{'nameSpace': 'org.onap.policy.apex.examples.pcvs.vpnsla','name': 'VpnSlaTrigger','version': '1.0.0','source': 'LinkMonitor.py','target': 'VpnSlaPolicy','status': 'DOWN','edgeName': 'L09'}"
+ producer.send("apex-in-0", bytes(link, encoding="ascii"))
+ if(issueLink == "s2-s6"):
+ link = "{'nameSpace': 'org.onap.policy.apex.examples.pcvs.vpnsla','name': 'VpnSlaTrigger','version': '1.0.0','source': 'LinkMonitor.py','target': 'VpnSlaPolicy','status': 'DOWN','edgeName': 'L07'}"
+ producer.send("apex-in-0", bytes(link, encoding="ascii"))
+ if(issueLink == "s5-s7"):
+ link = "{'nameSpace': 'org.onap.policy.apex.examples.pcvs.vpnsla','name': 'VpnSlaTrigger','version': '1.0.0','source': 'LinkMonitor.py','target': 'VpnSlaPolicy','status': 'DOWN','edgeName': 'L10'}"
+ producer.send("apex-in-0", bytes(link, encoding="ascii"))
+ if(issueLink == "s3-s5"):
+ link = "{'nameSpace': 'org.onap.policy.apex.examples.pcvs.vpnsla','name': 'VpnSlaTrigger','version': '1.0.0','source': 'LinkMonitor.py','target': 'VpnSlaPolicy','status': 'DOWN','edgeName': 'L06'}"
+ producer.send("apex-in-0", bytes(link, encoding="ascii"))
+ if(issueLink == "s4-s6"):
+ link = "{'nameSpace': 'org.onap.policy.apex.examples.pcvs.vpnsla','name': 'VpnSlaTrigger','version': '1.0.0','source': 'LinkMonitor.py','target': 'VpnSlaPolicy','status': 'DOWN','edgeName': 'L08'}"
+ producer.send("apex-in-0", bytes(link, encoding="ascii"))
+ break
+ if issueLink == "":
+ print("All Links are working\n")
+ producer.send("apex-in-0", b"{'nameSpace': 'org.onap.policy.apex.examples.pcvs.vpnsla','name': 'VpnSlaTrigger','version': '1.0.0','source': 'LinkMonitor.py','target': 'VpnSlaPolicy','status': 'UP','edgeName': 'L01'}")
+ producer.send("apex-in-0", b"{'nameSpace': 'org.onap.policy.apex.examples.pcvs.vpnsla','name': 'VpnSlaTrigger','version': '1.0.0','source': 'LinkMonitor.py','target': 'VpnSlaPolicy','status': 'UP','edgeName': 'L02'}")
+ producer.send("apex-in-0", b"{'nameSpace': 'org.onap.policy.apex.examples.pcvs.vpnsla','name': 'VpnSlaTrigger','version': '1.0.0','source': 'LinkMonitor.py','target': 'VpnSlaPolicy','status': 'UP','edgeName': 'L03'}")
+ producer.send("apex-in-0", b"{'nameSpace': 'org.onap.policy.apex.examples.pcvs.vpnsla','name': 'VpnSlaTrigger','version': '1.0.0','source': 'LinkMonitor.py','target': 'VpnSlaPolicy','status': 'UP','edgeName': 'L04'}")
+ producer.send("apex-in-0", b"{'nameSpace': 'org.onap.policy.apex.examples.pcvs.vpnsla','name': 'VpnSlaTrigger','version': '1.0.0','source': 'LinkMonitor.py','target': 'VpnSlaPolicy','status': 'UP','edgeName': 'L05'}")
+ producer.send("apex-in-0", b"{'nameSpace': 'org.onap.policy.apex.examples.pcvs.vpnsla','name': 'VpnSlaTrigger','version': '1.0.0','source': 'LinkMonitor.py','target': 'VpnSlaPolicy','status': 'UP','edgeName': 'L06'}")
+ producer.send("apex-in-0", b"{'nameSpace': 'org.onap.policy.apex.examples.pcvs.vpnsla','name': 'VpnSlaTrigger','version': '1.0.0','source': 'LinkMonitor.py','target': 'VpnSlaPolicy','status': 'UP','edgeName': 'L07'}")
+ producer.send("apex-in-0", b"{'nameSpace': 'org.onap.policy.apex.examples.pcvs.vpnsla','name': 'VpnSlaTrigger','version': '1.0.0','source': 'LinkMonitor.py','target': 'VpnSlaPolicy','status': 'UP','edgeName': 'L08'}")
+ producer.send("apex-in-0", b"{'nameSpace': 'org.onap.policy.apex.examples.pcvs.vpnsla','name': 'VpnSlaTrigger','version': '1.0.0','source': 'LinkMonitor.py','target': 'VpnSlaPolicy','status': 'UP','edgeName': 'L09'}")
+ producer.send("apex-in-0", b"{'nameSpace': 'org.onap.policy.apex.examples.pcvs.vpnsla','name': 'VpnSlaTrigger','version': '1.0.0','source': 'LinkMonitor.py','target': 'VpnSlaPolicy','status': 'UP','edgeName': 'L10'}")
+
+ testableLinks = switchLinks
+ myfile = open('LinkInfo.json', 'a')
+ myfile.write(str(testableLinks))
+ myfile.write('\n')
+ myfile.close()
+ counter += 1
+
+Mininet Topology
+----------------
+
+ .. container:: sect1
+
+ .. container:: sectionbody
+
+ .. container:: paragraph
+
+ The topology is realized using Mininet. The following
+ script is use to estalish the topology and to realize
+ network configurations.
+
+ .. container:: listingblock
+
+ .. container:: content
+
+ .. code:: CodeRay
+
+ # ============LICENSE_START=======================================================
+ # Copyright (C) 2016-2018 Ericsson. All rights reserved.
+ # ================================================================================
+ # Licensed under the Apache License, Version 2.0 (the "License");
+ # you may not use this file except in compliance with the License.
+ # You may obtain a copy of the License at
+ #
+ # http://www.apache.org/licenses/LICENSE-2.0
+ #
+ # Unless required by applicable law or agreed to in writing, software
+ # distributed under the License is distributed on an "AS IS" BASIS,
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ # See the License for the specific language governing permissions and
+ # limitations under the License.
+ #
+ # SPDX-License-Identifier: Apache-2.0
+ # ============LICENSE_END=========================================================
+
+ #Add Mininet to PATH
+ import sys
+ sys.path.insert(0, "/~/mininet")
+
+ #Kafka
+ import httplib
+ import json
+ import time
+ from kafka import KafkaConsumer, KafkaProducer
+
+ #Mininet
+ from mininet.clean import *
+ from mininet.cli import *
+ from mininet.link import *
+ from mininet.log import *
+ from mininet.net import *
+ from mininet.node import *
+ from mininet.nodelib import *
+ from mininet.topo import *
+ from mininet.topolib import *
+
+ class StaticFlowPusher(object):
+ def __init__(self, server):
+ self.server = server
+
+ def enableFirewall(self, data):
+ path = "/wm/firewall/module/enable/json"
+ headers = {'Content-Type': 'application/json','Accept': 'application/json',}
+ body = json.dumps(data)
+ conn = httplib.HTTPConnection(self.server, 8080)
+ conn.request("PUT", path, "")
+ response = conn.getresponse()
+ ret = (response.status, response.reason, response.read())
+ conn.close()
+ return ret
+
+ def addRule(self, data):
+ path = '/wm/firewall/rules/json'
+ headers = {'Content-Type': 'application/json','Accept': 'application/json',}
+ body = json.dumps(data)
+ conn = httplib.HTTPConnection(self.server, 8080)
+ conn.request('POST', path, body, headers)
+ response = conn.getresponse()
+ ret = (response.status, response.reason, response.read())
+ conn.close()
+ return ret
+
+ def deleteRule(self, data):
+ path = '/wm/firewall/rules/json'
+ headers = {'Content-Type': 'application/json','Accept': 'application/json',}
+ body = json.dumps(data)
+ conn = httplib.HTTPConnection(self.server, 8080)
+ conn.request('DELETE', path, body, headers)
+ response = conn.getresponse()
+ ret = (response.status, response.reason, response.read())
+ conn.close()
+ return ret
+
+ #Build Pusher(REST/IN)
+ pusher = StaticFlowPusher('127.0.0.1')
+
+ net = Mininet(link=TCLink)
+
+ #Create Customers
+ customerA1 = net.addHost( 'A1' )
+ customerA2 = net.addHost( 'A2' )
+ customerB1 = net.addHost( 'B1' )
+ customerB2 = net.addHost( 'B2' )
+
+ #Create Switches
+ switchA1CO = net.addSwitch( 's1' )
+ switchA2CO = net.addSwitch( 's2' )
+ switchB1CO = net.addSwitch( 's3' )
+ switchB2CO = net.addSwitch( 's4' )
+ switchBBL = net.addSwitch( 's5' )
+ switchBBR = net.addSwitch( 's6' )
+ # we need an extra switch here because Mininet does not allow two links between two switches
+ switchEx = net.addSwitch( 's7' )
+
+ #Create Links
+ net.addLink( customerA1, switchA1CO )
+ net.addLink( customerA2, switchA2CO )
+ net.addLink( customerB1, switchB1CO )
+ net.addLink( customerB2, switchB2CO )
+ net.addLink( switchA1CO, switchBBL )
+ net.addLink( switchB1CO, switchBBL )
+ net.addLink( switchA2CO, switchBBR )
+ net.addLink( switchB2CO, switchBBR )
+ net.addLink( switchBBL, switchBBR)
+ net.addLink( switchBBR, switchEx, bw=1.2 )
+ net.addLink( switchEx, switchBBL )
+
+ #Create Controller
+ floodlightController = net.addController(name='c0' , controller=RemoteController , ip='127.0.0.1', port=6653)
+
+ net.start()
+
+ if pusher.enableFirewall({})[0] == 200:
+ print("Firewall enabled!")
+
+ #print(pusher.addRule({"switchid": "00:00:00:00:00:00:00:01"})[2])
+ s1id = json.loads(pusher.addRule({"switchid": "00:00:00:00:00:00:00:01"})[2])['rule-id']
+ s2id = json.loads(pusher.addRule({"switchid": "00:00:00:00:00:00:00:02"})[2])['rule-id']
+ s3id = json.loads(pusher.addRule({"switchid": "00:00:00:00:00:00:00:03"})[2])['rule-id']
+ s4id = json.loads(pusher.addRule({"switchid": "00:00:00:00:00:00:00:04"})[2])['rule-id']
+ s5id = json.loads(pusher.addRule({"switchid": "00:00:00:00:00:00:00:05"})[2])['rule-id']
+ s6id = json.loads(pusher.addRule({"switchid": "00:00:00:00:00:00:00:06"})[2])['rule-id']
+ s7id = json.loads(pusher.addRule({"switchid": "00:00:00:00:00:00:00:07"})[2])['rule-id']
+
+
+ result = 100
+ while result!=0:
+ result = net.pingAll(None)
+ print("Network Simulation Complete")
+
+ #Assume control and when finished "exit"
+ cli = CLI( net )
+
+ consumer = KafkaConsumer(bootstrap_servers='localhost:9092',auto_offset_reset='latest')
+ consumer.subscribe(['apex-out'])
+ print("Starting Message Loop")
+ for message in consumer:
+ myOutput = json.loads(message.value.decode())
+ action = ""
+ try:
+ print("Checking Message")
+ #print("SWITCHES= ",net.switches)
+ #print("LINKS= ",net.links)
+ #print("VALUES= ",net.values)
+ if myOutput['edgeName'] != '':
+ print("Message Received: ",myOutput['edgeName'])
+ pusher.deleteRule({"ruleid": s1id})
+ pusher.deleteRule({"ruleid": s2id})
+ pusher.deleteRule({"ruleid": s3id})
+ pusher.deleteRule({"ruleid": s4id})
+ pusher.deleteRule({"ruleid": s5id})
+ pusher.deleteRule({"ruleid": s6id})
+ pusher.deleteRule({"ruleid": s7id})
+ s1id = json.loads(pusher.addRule({"switchid": "00:00:00:00:00:00:00:01"})[2])['rule-id']
+ s2id = json.loads(pusher.addRule({"switchid": "00:00:00:00:00:00:00:02"})[2])['rule-id']
+ s3id = json.loads(pusher.addRule({"switchid": "00:00:00:00:00:00:00:03"})[2])['rule-id']
+ s4id = json.loads(pusher.addRule({"switchid": "00:00:00:00:00:00:00:04"})[2])['rule-id']
+ s5id = json.loads(pusher.addRule({"switchid": "00:00:00:00:00:00:00:05"})[2])['rule-id']
+ s6id = json.loads(pusher.addRule({"switchid": "00:00:00:00:00:00:00:06"})[2])['rule-id']
+ s7id = json.loads(pusher.addRule({"switchid": "00:00:00:00:00:00:00:07"})[2])['rule-id']
+ if myOutput['edgeName'] == "L01":
+ action = "link s1 s5 down"
+ #net.configLinkStatus('s1', 's5', "down")
+ pusher.deleteRule({"ruleid": s1id})
+ s1id = json.loads(pusher.addRule({"switchid": "00:00:00:00:00:00:00:01", "action": "DENY"})[2])['rule-id']
+ if myOutput['edgeName'] == "L02":
+ action = "link s3 s5 down"
+ #net.configLinkStatus('s3', 's5', "down")
+ pusher.deleteRule({"ruleid": s3id})
+ s3id = json.loads(pusher.addRule({"switchid": "00:00:00:00:00:00:00:03", "action": "DENY"})[2])['rule-id']
+ if myOutput['edgeName'] == "L03":
+ action = "link s2 s6 down"
+ #net.configLinkStatus('s2', 's6', "down")
+ pusher.deleteRule({"ruleid": s1id})
+ s1id = json.loads(pusher.addRule({"switchid": "00:00:00:00:00:00:00:01", "action": "DENY"})[2])['rule-id']
+ if myOutput['edgeName'] == "L04":
+ action = "link s4 s6 down"
+ #net.configLinkStatus('s4', 's6', "down")
+ pusher.deleteRule({"ruleid": s3id})
+ s3id = json.loads(pusher.addRule({"switchid": "00:00:00:00:00:00:00:03", "action": "DENY"})[2])['rule-id']
+ if myOutput['edgeName'] == "L05":
+ action = "link s1 s5 down"
+ #net.configLinkStatus('s1', 's5', "down")
+ pusher.deleteRule({"ruleid": s1id})
+ s1id = json.loads(pusher.addRule({"switchid": "00:00:00:00:00:00:00:01", "action": "DENY"})[2])['rule-id']
+ if myOutput['edgeName'] == "L06":
+ action = "link s3 s5 down"
+ #net.configLinkStatus('s3', 's5', "down")
+ pusher.deleteRule({"ruleid": s3id})
+ s3id = json.loads(pusher.addRule({"switchid": "00:00:00:00:00:00:00:03", "action": "DENY"})[2])['rule-id']
+ if myOutput['edgeName'] == "L07":
+ action = "link s2 s6 down"
+ #net.configLinkStatus('s2', 's6', "down")
+ pusher.deleteRule({"ruleid": s2id})
+ s2id = json.loads(pusher.addRule({"switchid": "00:00:00:00:00:00:00:02", "action": "DENY"})[2])['rule-id']
+ if myOutput['edgeName'] == "L08":
+ action = "link s4 s6 down"
+ #net.configLinkStatus('s4', 's6', "down")
+ pusher.deleteRule({"ruleid": s4id})
+ s4id = json.loads(pusher.addRule({"switchid": "00:00:00:00:00:00:00:04", "action": "DENY"})[2])['rule-id']
+ if myOutput['edgeName'] == "L09":
+ action = "link s5 s6 down"
+ #net.configLinkStatus('s5', 's6', "down")
+ pusher.deleteRule({"ruleid": s7id})
+ s7id = json.loads(pusher.addRule({"switchid": "00:00:00:00:00:00:00:07", "action": "DENY"})[2])['rule-id']
+ if myOutput['edgeName'] == "L10":
+ print("L10")
+ #print(action)
+ #print("3")
+ except KeyError:
+ print(myOutput)
+ print("HA")
+ net.stop()
+
+ .. container::
+ :name: footer-text
+
+ 2.3.0-SNAPSHOT
+ Last updated 2020-04-03 16:04:24 IST
+
+
+.. |ONAP| image:: ../../../images/logos.png
+ :class: builtBy
+ :target: http://www.onap.org/
+
+.. |VPN SLA Architecture| image:: images/pcvs/vpnsla-arch.png
+
+