1 # DCAE VES Adapter (Mapper)
4 Different VNF vendors generates event and telemetry data in different formats. Out of the box all VNF vendors may not support ONAP VES format. This solution provides generic adapter(mapper) which can convert different formats of event and telemetry data to VES format which is needed by ONAP
6 This release supports only SNMP format. DCAE existing SNMP traps receiver are pushing SNMP traps (converted to json format) to DMaaP. DCAE Universal VES Adapter (mapper) micro-service consumes snmp trap from dmaap topic and reads uploaded mapper file (for the specific vendor). After reading mapper file, converts snmp trap (JSON format) to VES format and publish on dmaap topic.
8 ONAP DCAE VES Adapter (Mapper) is delivered with **2 Docker container** having spring boot mocroservices
10 ## Compiling and Building Mapper
12 mapper (structured as a Maven project) uses the Maven tool to help compile, build, and deploy mapper Artifacts into a Maven Repository. In order to compile and build, a `mvn clean install` is executed, which checks for any errors and Java exceptions during compilation process.
14 ## Getting the containers
16 ONAP DCAE Mapper containers are stored on [here] for the releases, and [here] for the snapshots
20 ONAP DCAE VES Adapter (Mapper) is delivered with **2 Docker containers**, both are spring boot mocroservices
22 The following Docker images are the actual deployment images used for running mapper:
23 **UniversalVesAdapter** and **snmpmapper**
27 'mapper' solution is based on smokes framework which tranforms object model to another objet model. Here we transformed SNMP trap JSON format to VES JSON format
30 For this release it accepts the mapper XML file and stores it locally.
31 *** Aims to develop the functionality that creates mapping files for SNMP traps in SDC during VNF on-boarding process.
32 To be completed on next release ***
34 ## UniversalVesAdapter
35 Based on the sample mapper file <<snmpTrapToVes.xml>>, data tranformation will be done.
36 sample file location: /UniversalVesAdapter/SampleofMappingFile/snmpTrapToVes.xml
38 Ther following steps are needed to deploy and start ONAP dcae mapper:
40 ## UniversalVesAdapter and snmpmapper containers can run together.
42 - docker run -p 8081:8888 snmpmapper
44 - Start UniversalVesAdapter
45 - docker run -p 8082:8080 UniversalVesAdapter
48 - UniversalVesAdapter service will listen to DMAAP <<topic>> to consume SNMP trap object
49 - UniversalVesAdapter service will publish the tranformed VES object to DMAAP <<topic>> for other ONAP components to consume.