{"type":"doc","content":[{"type":"paragraph","content":[{"text":"SDN-R microservices in ONAP Dublin/El Alto are compiled in gerrit since first version of 0.4.2 for Opendaylight Flourine SR2. ","type":"text"}]},{"type":"paragraph","content":[{"text":"If there is the need to run this services in Opendaylight Flourine SR1 environment the adaption can be done in a few simple steps, that are descirbed here.","type":"text"}]},{"type":"paragraph","content":[{"text":"Test environment for creating and running docker container is located here: ","type":"text"},{"text":"https://github.com/onap-oof-pci-poc/ccsdk/tree/master/distribution/odlwt-alpine-standalone-0.4.1-SNAPSHOT","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/onap-oof-pci-poc/ccsdk/tree/master/distribution/odlwt-alpine-standalone-0.4.1-SNAPSHOT"}}]}]},{"type":"extension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"6d543a98-ea91-45d6-8ad0-7a7b37fecb08"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}}}},{"type":"heading","attrs":{"level":1},"content":[{"text":"ONAP to ODL Dependency Background","type":"text"}]},{"type":"paragraph","content":[{"text":"The parent used in the pom file for a CCSDK feature is defining the Opendaylight Version that is targeted as run time environment. The interfaces provided by an Opendaylight main version, like Flourine, are not changed from one SRn to SRn+1. ","type":"text"}]},{"type":"paragraph","content":[{"text":"If the feature needs to be executed by using a different opendaylight version, all pom.xml need to be adjusted and the features need to be compiled. That's it.","type":"text"}]},{"type":"paragraph","content":[{"text":"The artifacts version number should be use the schema from table below to prevent confusion.","type":"text"}]},{"type":"table","content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Artifacts version number","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Parents version number","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Target ODL Version","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"0.4.1/0.4.1-SNAPSHOT","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"1.2.1/1.2.1-SNAPSHOT","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Flourine SR1","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"0.4.2/0.4.2-SNAPSHOT","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"1.2.2/1.2.2-SNAPSHOT","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Flourine SR2","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"0.5.0/0.5.0-SNAPSHOT","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"1.3.0/1.3.0-SNAPSHOT","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Flourine SR2","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"0.5.0/0.5.0-SNAPSHOT","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"1.3.1/1.3.1-SNAPSHOT","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Flourine SR2","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Example for adapting to a different Opendaylight version","type":"text"}]},{"type":"paragraph","content":[{"text":"Prerequ: ","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Server with Ubuntu with development setup for ONAP with access to ONAP Nexus.","type":"text"},{"type":"hardBreak"}]}]}]},{"type":"paragraph","content":[{"text":"Example uses: ","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"onap microservice: ccsdk/features:sdnr/wt","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"artifact version/parent version: ","type":"text"},{"text":"0.4.2-SNAPSHOT with 1.2.2-SNAPSHOT","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Target version is: 0.4.1-SNAPSHOT/1.2.1-SNAPSHOT","type":"text"},{"type":"hardBreak"}]}]}]},{"type":"paragraph","content":[{"text":"Steps","type":"text","marks":[{"type":"strong"}]},{"text":" to create a Flourine SR1 Version, by example for using 0.4.2-SNAPSHOT.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Clone gerrit ccsdk/feature repository to ","type":"text"},{"text":"features","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Copy recurse ","type":"text"},{"text":"sdnr/wt","type":"text","marks":[{"type":"em"}]},{"text":" tree into new ","type":"text"},{"text":"sdnr/wt-0.4.1","type":"text","marks":[{"type":"em"}]},{"text":" directory","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Change the version numbers in th pom files accordingly","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Compile the microservice that the result is in local .m2 repository for related use","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"in","type":"text"},{"text":" .m2/repository","type":"text","marks":[{"type":"em"}]},{"text":" under ","type":"text"},{"text":"org/onap/ccsdk/features/sdnr/wt","type":"text","marks":[{"type":"em"}]},{"text":" the bundles are now available with version 0.4.1-SNAPSHOT","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"All bundles are included into ","type":"text"},{"text":"sdnr-wt-feature-aggregator.","type":"text","marks":[{"type":"em"}]},{"text":" See dependency below.","type":"text"}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"codeBlock","content":[{"text":"\n\torg.onap.ccsdk.features.sdnr.wt\n\tsdnr-wt-feature-aggregator-installer\n\t0.4.1-SNAPSHOT\n\trepo\n\tzip\n\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Related command sequence","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Example with Ubuntu and bash, ONAP dev environment.","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Hint:","type":"text","marks":[{"type":"strong"}]},{"text":"It can not be excluded that the version number to replace by sed is used by something else in the pom.xml. ","type":"text"}]}]},{"type":"paragraph","content":[{"text":"As a check use grep command with the version numbers to replace and verify if the list contains the elementes expected:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"grep \"1\\.2\\.2-SNAPSHOT\" $(find . -name pom.xml)\ngrep \"0\\.4\\.2-SNAPSHOT\" $(find . -name pom.xml)\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Replacing the version number:","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"cd ~\ngit clone git clone https://gerrit.onap.org/r/ccsdk/features\ncd features/sdnr/wt\ncp -r wt wt-0.4.1 \ncd wt-0.4.1 \nsed -i 's#1.2.2-SNAPSHOT#1.2.1-SNAPSHOT#g' $(find . -name \"pom.xml\") \nsed -i 's#0.4.2-SNAPSHOT#0.4.1-SNAPSHOT#g' $(find . -name \"pom.xml\")\nmvn clean install","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Create and run a Wireless transport micro services (wt) Container","type":"text"}]},{"type":"paragraph","content":[{"text":"Refering to github repository ","type":"text"},{"text":"https://github.com/onap-oof-pci-poc/ccsdk","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/onap-oof-pci-poc/ccsdk"}},{"type":"em"}]},{"text":" with ","type":"text"},{"text":"distribution/odlwt-alpine-standalone-0.4.1-SNAPSHOT","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"This distribution uses the ONAP ODL image \"onap/ccsdk-odl-fluorine-alpine-image\" to create the ONAP WT Container.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Container image versin 0.4.1-SNAPSHOUT with OpenDaylight Flourine SR1","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"There is no dependency to other ONAP Containers.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"This version is including 0.4.1-SNAPSHOT features.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Configuration used by this container","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Linux alpine as OS","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ODL as single node or cluster node","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Added bundles are Repository: 'ccsdk/features'/sdnr","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ENTRYPOINT /opt/onap/ccsdk/bin/startSdnr.sh","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ODLUX Login: - ODL Default is user here: admin/admin","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Creation of 0.4.1-SNAPSHOUT Version for ODL Flourine SR1","type":"text"}]},{"type":"paragraph","content":[{"text":"The ONAP Dublin parents 1.2.1-SNAPSHOT and 1.2.1 are creating the bundles for ODL Flourine SR1. Parents with higher version number are creating bundles for ODL Floutine SR2.","type":"text"}]},{"type":"paragraph","content":[{"text":"Prerequ: Ubuntu with development setup for ONAP with access to ONAP Nexus.","type":"text"}]},{"type":"paragraph","content":[{"text":"Steps to create a Flourine SR1 Version, by example for using 0.4.2-SNAPSHOT:","type":"text"}]},{"type":"paragraph","content":[{"text":"cd features/sdnr/wt\n cp -r wt wt-0.4.1\n cd wt-0.4.1\n sed -i 's#1.2.2-SNAPSHOT#1.2.1-SNAPSHOT#g' $(find . -name \"pom.xml\")\n sed -i 's#0.4.2-SNAPSHOT#0.4.1-SNAPSHOT#g' $(find . -name \"pom.xml\")","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"text":"Hint: It could occur that the versin number is used by something in the pom.xml. As a check use grep command with the version numbers to replace:","type":"text"}]},{"type":"paragraph","content":[{"text":"grep \"1\\.2\\.1-SNAPSHOT\" $(find . -name pom.xml)","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Compile features and create image","type":"text"}]},{"type":"paragraph","content":[{"text":"After changing the version numbers a private build is required of \"wireless transport\" features for version \"0.4.1-SNAPSHOT\".","type":"text"}]},{"type":"paragraph","content":[{"text":"cd features/sdnr/wt\n mvn clean install","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"text":"Create image with","type":"text"}]},{"type":"paragraph","content":[{"text":"cd distribution/odlwt-alpine-standalone-0.4.1-SNAPSHOT\n mvn clean install -P docker","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"HINT","type":"text","marks":[{"type":"strong"}]},{"text":": ONAP/Nexus does contain also a bundle with such a version number. This version is used as default if no compilation was done. Indication is such error: \"[ERROR] Failed to execute goal io.fabric8:docker-maven-plugin:0.16.5:build (generate-images) on project distribution-odlwt-alpine: Unable to build image [oof-pci/ccsdk-odlwt-alpine-image]: COPY failed: stat /var/lib/docker/tmp/docker-builder864199067/preload.cache.schema: no such file or directory -> [Help 1]\"","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Parameters","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"SDNRWT true|false","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Switch on the SDNRWT feature.","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Cluster specific","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Node index, provided via host-name","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Format name-n","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"n defines the host index. Starts with 0 .. N-1. Index of the cluster node that is started.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"--env SDNC_REPLICAS=n","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"n Number of cluster members.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"--env PEER","type":"text"},{"text":"ODL","type":"text","marks":[{"type":"em"}]},{"text":"CLUSTER=\"true\"","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set to any value for non GEO redundant setup.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"--env ENABLE","type":"text"},{"text":"ODL","type":"text","marks":[{"type":"em"}]},{"text":"CLUSTER=\"true\"","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Mandatory to enable cluster configuration","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Examples","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Start single node","type":"text"}]},{"type":"paragraph","content":[{"text":" docker run imageName","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Start three node clusters","type":"text"}]},{"type":"paragraph","content":[{"text":" docker run imageName --env NODE_INDEX=\"1\" --env NODE_LIST=\"10.42.167.43 10.42.168.2 192.168.178.65\"\n docker run imageName --env NODE_INDEX=\"2\" --env NODE_LIST=\"10.42.167.43 10.42.168.2 192.168.178.65\"\n docker run imageName --env NODE_INDEX=\"3\" --env NODE_LIST=\"10.42.167.43 10.42.168.2 192.168.178.65\"","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Reference","type":"text"}]},{"type":"paragraph","content":[{"text":"Opendaylight cluster configuration","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.opendaylight.org/en/stable-nitrogen/getting-started-guide/common-features/clustering.html"}}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Container ports","type":"text"}]},{"type":"paragraph","content":[{"text":"docker run --detach --publish 8181:8181 --name sdnr \"$IMAGE\"","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Version reference ODL ↔ ONAP","type":"text"}]},{"type":"paragraph","content":[{"text":"Import during compile is to have the same mdsal version inuse that is also provided by the Opendaylight/Karaf OSGi system.","type":"text"}]},{"type":"paragraph","content":[{"text":"If the Opendaylight Version name is known, e.g. Flourine/SR2 the related mdsal api information can be found by github opendaylight repository in the pom that is creating this API. This repository contains the names of the opendaylight version as Tag or Branch. It is located here: ","type":"text"},{"text":"https://github.com/opendaylight/mdsal/blob/release/fluorine-sr3/binding/mdsal-binding-api/pom.xml","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/opendaylight/mdsal/blob/release/fluorine-sr3/binding/mdsal-binding-api/pom.xml"}}]},{"text":" . The artifact ","type":"text"},{"text":"","type":"text","marks":[{"type":"strong"}]},{"text":" is the relevant version number, here 2.5.2","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Client:","type":"text","marks":[{"type":"strong"}]},{"text":" Enter a running sdnr container and open client by $ODL_HOME/bin/client. that is also visible with karaf/opendaylight/client under feature:list and used by a specific ODL Version. Search for odl-mdsal-binding: ","type":"text"},{"text":"odl-mdsal-binding │ 2.5.2 │ │ Started │ odl-mdsal-binding │ OpenDaylight :: MD-SAL :: Binding","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Repository","type":"text","marks":[{"type":"strong"}]},{"text":": The list command \"l","type":"text"},{"text":"s $ODL_HOME/system/org/opendaylight/mdsal/mdsal-binding-api/\"","type":"text","marks":[{"type":"em"}]},{"text":" indicates a directory with related version number. Here \"2.5.2\"","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"In ONAP/ccsdk the same version number is specified in via parent pom.xml by the ","type":"text"},{"text":"2.5.2","type":"text","marks":[{"type":"strong"}]},{"text":" parameter.","type":"text"}]},{"type":"paragraph","content":[{"text":"In the example above all this version numbers should show 2.5.2 and the world is OK.","type":"text"}]}],"version":1}