Getting Started as an EdgeX Developer Tech Talks – Session 1

Agenda Introduction Tech Talk Sessions Tools you need to install Getting EdgeX code from GitHub (and what to get) Setting up the database Bringing the Code into Eclipse Running EdgeX in Eclipse Future Topics Q&A

Jim White Dell Distinguished Engineer & Senior Software Architect From Dell End User Computing (EUC) CTO Chief Architect and lead developer of Fuse I wrote code line #1  Fuse => EdgeX Foundry james_white2@dell.com

EdgeX Tech Talks Provide this new community with background on the current system In the future, they may address future architecture or special calls to action Currently scheduled for every week (Thursdays) Alternating weekly times: 8am and 6pm ET Trying to be sensitive to global attendance Quick poll in a second on where people are located and what times work Topics TBD – we’ll discuss at the end or you can email me suggestions

Where are you located?

Tools of the trade What you need to get in order to develop EdgeX today Git Mongo database* Java JDK (version 1.8 or better) Eclipse (recommend Mars version or better) Make sure Eclipse knows where your is located through Preferences Docker and Docker Compose* * optional depending on your work EdgeX has been developed a cross a variety of OS Windows Linux Mac Going to assume you can get and setup the tools you need on your environment If you desperately need help, please contact me

Getting EdgeX Download the project repositories with Git at github.com/edgexfoundry EdgeX is comprised of many micro services and libraries M – A – N – Y!! Learn the landscape (dependencies and connection points) as you go. https://wiki.edgexfoundry.org/display/FA/Get+EdgeX+Foundry+- +Developers#GetEdgeXFoundry-Developers-Dependencies

Git EdgeX See it In Action Stop when you have the pieces you need (more in a bit) developer-scripts core- domain, test, & exception support-domain support- logging & notifications support- logging & notifications -client core- metadata, data, command core- metadata, data, command –client device- sdk-tools, sdk, virtual export- domain & test export- client, distro support- scheduler & rulesengine You can ignore the docker versions for now See it In Action

EdgeX Services and libs export-domain export-test support-domain core-domain core-test core-exception device-sdk device-sdk-tools

Setting up the database See it In Action Make sure you have the developer-scripts repos Go to the directory containing init-mongo.js Run mongo with this script mongo init-mongo.js Alternately, for advanced users, you can run the EdgeX Mongo Docker container Using and working with Docker topic for another session

Bringing EdgeX into Eclipse Nearly all the EdgeX micro services and libraries are Java Maven Projects device-sdk-tools is the exception Import each as a Maven Project After importing, do a Maven Install of the project Gets the associated libraries and compile/build your project in your local environment Import and Build in the order per slide 9 See it In Action

Oops There is an error in the device-virtual pom.xml Before building it, correct the problem Open pom.xml by double clicking on it Add <pluginManagement> element around the <plugins> element. Save and let the project rebuild itself. All better This will be fixed with the next build See it In Action

Running in Eclipse Minimally, you an run the following micro services to explore EdgeX core-metadata core-data device-virtual Before you do, change the configuration of the device-virtual Update the service-name & host You may want to set the log level of any of the services Start mongo (if not already running) To run each service, right click & select Run As -> Java Application Select the org.edgexfoundry.Application class to run

Minimal EdgeX Running

Check that EdgeX is working Check the logs “This is … the X Micro Service” Ping the service http://<host>:<service port>/api/v1/ping http://dell-demo:48080/api/v1/ping for core data on dell-demo See the event count collected http://dell-demo:48080/api/v1/event/count See the devices “connected” http://dell-demo:48081/api/v1/device See the event/reading data from a particular device http://dell-demo:48080/api/v1/event/device/<id>/<count limit> See it In Action

EdgeX Resources Wiki (wiki.edgexfoundry.org) Rocket Chat (chat.edgexfoundry.org) Web Site (edgexfoundry.org) Github (github.com/edgexfoundry) Jim’s email address (james_white2@dell.com)

What Topics Should Be Covered in Tech Talks Docker version? Deep dive on each micro service? Device SDK? ??? And what’s the priority?

Questions and Answer Time