{"type":"doc","content":[{"type":"paragraph","content":[{"text":"Lets extend the example by adding a block of logic to setting up the data center connection to the third part local controllers between edge and core.","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"We will need to:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create a Local Controller Emulator as a simple http server with basic auth that takes POST input, logs the data and returns succes-dci-connnect.jsons.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":" 2. Create the Directed Graph","type":"text"}]},{"type":"paragraph","content":[{"text":" 3. Load the l3-dci-connect template into the SDNC controller for the json body to the emulator","type":"text"}]},{"type":"paragraph","content":[{"text":" 4. Use the SLI-API: Execute Graph function to test the new DG.","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Create Local Controller Emulator","type":"text"}]},{"type":"paragraph","content":[{"text":"If you already have an http server available use it. For this demo we will install and run a lighttp docker container on the SDNC controller so that we have a self contained enivonment.","type":"text"}]},{"type":"paragraph","content":[{"text":"Lets use port 9000 for the outside port.","type":"text"}]},{"type":"paragraph","content":[{"text":"create a \"http_test_server\" directory on the SDNC VM under /opt and use that as the home directory for the container","type":"text"}]},{"type":"paragraph","content":[{"text":"scp this tar file ","type":"text"},{"text":"http_test_server.tar","type":"text","marks":[{"type":"link","attrs":{"href":"https://lf-onap.atlassian.net/wiki/download/attachments/16237649/http_test_server.tar?version=1&modificationDate=1500675193000&cacheVersion=1&api=v2"}}]},{"text":" into the /opt/http_test_server directory and untar it","type":"text"}]},{"type":"paragraph","content":[{"text":"cd docker","type":"text"}]},{"type":"paragraph","content":[{"text":"follow the notes in the README.txt to create the debian-lighttpd container","type":"text"}]},{"type":"paragraph","content":[{"text":"start the container","type":"text"}]},{"type":"paragraph","content":[{"text":"use testEmulator.sh to test that php is working","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"\"docker exec -it debian-lighttpd bash\" to log in to the emulator","type":"text"}]},{"type":"paragraph","content":[{"text":"\"cd /var/log/lighttpd\"","type":"text"}]},{"type":"paragraph","content":[{"text":"\"tail emulator.log\"","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"and you should see a test line like ","type":"text"}]},{"type":"paragraph","content":[{"text":"\"17:07:21 07:29:08 | name:test,value:testdata 3\"","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"This emulator is setup to reply on \"http://10.0.7.1:9000/l3-dci-connect.php\" so we will use that in the Directed Graph.","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Create a Directed Graph","type":"text"}]},{"type":"paragraph","content":[{"text":"This directed graph adds a block to deal with the setting of parametres and a set of REST API Call Nodes to the emulator so we can see the behavoir and experiment with different templates/sequences.","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"expand","attrs":{"title":"VoLTE DG 0.0.2"},"content":[{"type":"paragraph","content":[{"text":"[{\"id\":\"1c91b4f1.e45473\",\"type\":\"service-logic\",\"name\":\"VOLTE-API 0.0.2-DEMO\",\"module\":\"VOLTE-API\",\"version\":\"0.0.2-DEMO\",\"comments\":\"\",\"xml\":\"\",\"outputs\":1,\"x\":317.1666564941406,\"y\":106.16667175292969,\"z\":\"30ac5fe5.ab4d2\",\"wires\":[[\"a28ec6bd.3832d8\"]]},{\"id\":\"40983a09.90a524\",\"type\":\"dgstart\",\"name\":\"DGSTART\",\"outputs\":1,\"x\":111,\"y\":81,\"z\":\"30ac5fe5.ab4d2\",\"wires\":[[\"1c91b4f1.e45473\"]]},{\"id\":\"a28ec6bd.3832d8\",\"type\":\"method\",\"name\":\"method volte-wan-activate\",\"xml\":\"\\n\",\"comments\":\"\",\"outputs\":1,\"x\":181.16668701171875,\"y\":170.16665649414062,\"z\":\"30ac5fe5.ab4d2\",\"wires\":[[\"e53e6cd.afc3f1\"]]},{\"id\":\"e53e6cd.afc3f1\",\"type\":\"block\",\"name\":\"block : atomic\",\"xml\":\"\",\"atomic\":\"true\",\"outputs\":1,\"x\":389,\"y\":258,\"z\":\"30ac5fe5.ab4d2\",\"wires\":[[\"cdeda8e3.1218f\",\"9794fca5.9de488\",\"cd5f5503.b9f128\",\"19f372e1.31b345\",\"8ff8c47.cd19b38\",\"edd83200.432db8\"]]},{\"id\":\"cdeda8e3.1218f\",\"type\":\"set\",\"name\":\"set: order-status = Active\",\"xml\":\"\\n\\t\",\"comments\":\"\",\"x\":597,\"y\":603,\"z\":\"30ac5fe5.ab4d2\",\"wires\":[]},{\"id\":\"19f372e1.31b345\",\"type\":\"returnSuccess\",\"name\":\"return success\",\"xml\":\"\\n\\t\\n\\t\",\"comments\":\"\",\"x\":569,\"y\":790,\"z\":\"30ac5fe5.ab4d2\",\"wires\":[]},{\"id\":\"9794fca5.9de488\",\"type\":\"set\",\"name\":\"set: service-data = input\",\"xml\":\"\\n\\t\",\"comments\":\"\",\"x\":596.8888854980469,\"y\":704.388916015625,\"z\":\"30ac5fe5.ab4d2\",\"wires\":[]},{\"id\":\"cd5f5503.b9f128\",\"type\":\"set\",\"name\":\"Set final indicator to Y\",\"xml\":\"\\n\",\"comments\":\"\",\"x\":591.2063369750977,\"y\":748.1031608581543,\"z\":\"30ac5fe5.ab4d2\",\"wires\":[]},{\"id\":\"8ff8c47.cd19b38\",\"type\":\"record\",\"name\":\"record\",\"xml\":\"\\n\\n\\n\\n\\n\\n\\n\",\"comments\":\"\",\"outputs\":1,\"x\":559,\"y\":301,\"z\":\"30ac5fe5.ab4d2\",\"wires\":[[]]},{\"id\":\"c2486391.d9417\",\"type\":\"execute\",\"name\":\"excute REST DC-Connect-Create-A\",\"xml\":\"\\n\\t\\n\\t\\n\\t\\n\\t\\n\\t\\n\\t\\n\\t\\n\\t\\n\\t\\n\\t\",\"comments\":\"\",\"outputs\":1,\"x\":998,\"y\":727,\"z\":\"30ac5fe5.ab4d2\",\"wires\":[[]]},{\"id\":\"852c391a.a7d2b\",\"type\":\"execute\",\"name\":\"excute REST DC-Connect-Create-B\",\"xml\":\"\\n\\t\\n\\t\\n\\t\\n\\t\\n\\t\\n\\t\\n\\t\\n\\t\\n\\t\\n\\t\",\"comments\":\"\",\"outputs\":1,\"x\":998,\"y\":830,\"z\":\"30ac5fe5.ab4d2\",\"wires\":[[]]},{\"id\":\"edd83200.432db8\",\"type\":\"block\",\"name\":\"block\",\"xml\":\"\\n\",\"atomic\":\"false\",\"comments\":\"\",\"outputs\":1,\"x\":560,\"y\":370,\"z\":\"30ac5fe5.ab4d2\",\"wires\":[[\"f3cc8b33.0516c\",\"6a3b097e.b896d8\",\"a67a46fc.946838\",\"c2486391.d9417\",\"fbd78797.a6d598\",\"852c391a.a7d2b\",\"de93e82.c1dca18\"]]},{\"id\":\"f3cc8b33.0516c\",\"type\":\"set\",\"name\":\"set A controller data (http emulator)\",\"xml\":\"\\n\\n\\n\\n\\n\\n\\n\",\"comments\":\"\",\"x\":994,\"y\":455,\"z\":\"30ac5fe5.ab4d2\",\"wires\":[]},{\"id\":\"6a3b097e.b896d8\",\"type\":\"set\",\"name\":\"set WAN data (l3_vni=5001)\",\"xml\":\"\\n\\n\",\"comments\":\"\",\"x\":976,\"y\":556,\"z\":\"30ac5fe5.ab4d2\",\"wires\":[]},{\"id\":\"a67a46fc.946838\",\"type\":\"set\",\"name\":\"set DC A network data\",\"xml\":\"\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\",\"comments\":\"\",\"x\":958,\"y\":675,\"z\":\"30ac5fe5.ab4d2\",\"wires\":[]},{\"id\":\"fbd78797.a6d598\",\"type\":\"set\",\"name\":\"set DC B network data\",\"xml\":\"\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\",\"comments\":\"\",\"x\":955,\"y\":782,\"z\":\"30ac5fe5.ab4d2\",\"wires\":[]},{\"id\":\"d5a70b78.3a1\",\"type\":\"comment\",\"name\":\"Test block to describe logic - template uses \\\"device.\\\" for parameters\",\"info\":\"\",\"comments\":\"\",\"x\":1054,\"y\":378,\"z\":\"30ac5fe5.ab4d2\",\"wires\":[]},{\"id\":\"a5a8ce82.7fa0d\",\"type\":\"comment\",\"name\":\"DC Set Nodes should map from Input parameters\",\"info\":\"\",\"comments\":\"\",\"x\":1043,\"y\":618,\"z\":\"30ac5fe5.ab4d2\",\"wires\":[]},{\"id\":\"de93e82.c1dca18\",\"type\":\"set\",\"name\":\"set B controller data (http emulator)\",\"xml\":\"\\n\\n\\n\\n\\n\\n\\n\",\"comments\":\"\",\"x\":998,\"y\":503,\"z\":\"30ac5fe5.ab4d2\",\"wires\":[]}]","type":"text"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"This DG is 0.0.2-demo so we will add this as another version to the sdnc. I will summarize the steps since the first part and the netconf node tutorial cover this with screen shots.","type":"text"}]},{"type":"paragraph","content":[{"text":"Go to the dbbuilder on port 3000","type":"text"}]},{"type":"paragraph","content":[{"text":"Create a new tab with the \"+\" symbol","type":"text"}]},{"type":"paragraph","content":[{"text":"Copy the json string above to the clipboard ","type":"text"}]},{"type":"paragraph","content":[{"text":"Select the menu → import → clipboard","type":"text"}]},{"type":"paragraph","content":[{"text":"Paste the json string into the dialog","type":"text"}]},{"type":"paragraph","content":[{"text":"Postition the DG on the pane","type":"text"}]},{"type":"paragraph","content":[{"text":"Click on the big red SAVE button","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":66.0},"content":[{"type":"media","attrs":{"width":1839,"id":"a0b83b68-4d62-49e6-9cc2-9aa9a7440780","collection":"contentId-16237649","type":"file","height":863}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"This directed graph handles both the A and B side local controller.","type":"text"}]},{"type":"paragraph","content":[{"text":"We use SET nodes for protoping but in the real DG we would use data form the input , or query A&AI or call resource allocate nodes to generate the data.","type":"text"}]},{"type":"paragraph","content":[{"text":"The WAN VNI is in its own set node but would be a resource allocation node in a real DG.","type":"text"}]},{"type":"paragraph","content":[{"text":"For each local controller we:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set the url and credentials","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set the Data ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Call the REST API execute node - note we are using the same template just changing the parameters.","type":"text"}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Lets upload the DG","type":"text"}]},{"type":"paragraph","content":[{"text":"1.Click on the DGStart node ","type":"text"}]},{"type":"paragraph","content":[{"text":"2.Click on UploadXML","type":"text"}]},{"type":"paragraph","content":[{"text":"3.Click on DGList","type":"text"}]},{"type":"paragraph","content":[{"text":"4.Click on Activate for the new DG version 0.0.2-demo","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Load the l3-dci-connect template","type":"text"}]},{"type":"paragraph","content":[{"text":"This is basically the same flow as the Tutorial on setting up Netconf from SDNC to APPC.","type":"text"}]},{"type":"paragraph","content":[{"text":"Log into the SDNC VM and then log into the sdnc_controller_container","type":"text"}]},{"type":"paragraph","content":[{"text":"cd /opt/onap/sdnc/data","type":"text"}]},{"type":"paragraph","content":[{"text":"create the file \"l3-dci-connect.json\"","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"codeBlock","content":[{"text":"{\n \"l3-dci-connect\": {\n\t \"id\": \"${device.id}\",\n\t \"name\": \"${device.name}\",\n\t \"description\": \"${device.description}\",\n\t \"router_id\": \"${device.router_id}\",\n\t \"local_subnets\": [\"${device.local_subnets}\"],\n\t \"local_network_all\":false,\n\t \"evpn_irts\": [\"${device.evpn_irts}\"],\n\t \"evpn_erts\": [\"${device.evpn_erts}\"],\n\t \"l3_vni\": \"${device.wan.l3_vni}\"\n }\n}","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Note that the variables for the json payload are \"device.\" or \"device.wan.\" . The variable name branch would be a decision by the Adapter developer as to what model it would use. The DG maps variables into this device model.","type":"text"}]},{"type":"paragraph","content":[{"text":"The adapter developer may choose other model parameter names so this is just illustrative for the tutorial.","type":"text"}]},{"type":"paragraph","content":[{"text":"This template name, location and variable names must match what we have created in the REST API Call Node ","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"codeBlock","content":[{"text":"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Use the SLI-API: Execute Graph","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Now that we have the emulator, the directed graph and the template loaded we can test.","type":"text"}]},{"type":"paragraph","content":[{"text":"Go to http://:8282/apidoc/explorer/index.html","type":"text"}]},{"type":"paragraph","content":[{"text":"Go to the SLI-API:execute-graph operation and use the same input we used for the fist part of the tutorial.","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"codeBlock","content":[{"text":"{\n\"input\": {\n \"module-name\": \"VOLTE-API\",\n \"rpc-name\": \"volte-wan-activate\",\n \"mode\": \"sync\",\n \"sli-parameter\": [\n {\n \"parameter-name\": \"volte-wan-activate.dca-wanip\",\n \"string-value\": \"10.1.20.2\"\n },\n {\n \"parameter-name\": \"volte-wan-activate.dcz-wanip\",\n \"string-value\": \"10.2.20.2\"\n },\n {\n \"parameter-name\": \"volte-wan-activate.wan_vni\",\n \"string-value\": \"101\"\n },\n {\n \"parameter-name\": \"volte-wan-activate.route_target\",\n \"string-value\": \"6020:201\"\n },\n {\n \"parameter-name\": \"volte-wan-activate.route_distinguisher\",\n \"string-value\": \"6020:101\"\n }\n ]\n }\n}","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Click on \"Try It Out!\"","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"You should get ","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"output\": {\n \"ack-final-indicator\": \"Y\",\n \"response-text\": \"service-data.dcz-wanip=10.2.20.2\",\n \"response-code\": \"200\"\n }\n}","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Log in to the debian-lighttpd container and tail the /var/log/lighttpd/emulator.log and you should see the calls to emulator for local controller A and local controler B. ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":46.0},"content":[{"type":"media","attrs":{"width":775,"id":"f6923a08-48ee-4fa1-ae47-98c274a0ee76","collection":"contentId-16237649","type":"file","height":517}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Next Steps","type":"text"}]},{"type":"paragraph","content":[{"text":"We should map from the input to the variable needed for the device in the set node instead of hard coding the value.","type":"text"}]},{"type":"paragraph","content":[{"text":"Once a local controller is available we can use this DG to test against it by changing the \"set A controller data (http emulator)\" nodes.","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}],"version":1}