Quick Start Guide

• March 16, 2021

Prerequisites #

Before getting started with Yavin, make sure to have:

For macOS #

1. Java 8 or greater - You can check by running java -version.

   Free prebuilt OpenJDK binaries are available on https://adoptopenjdk.net.

2. Git - You can check by running git --version

For Windows #

1. Windows Subsystem for Linux - You can follow this guide to enable it
2. An Ubuntu distribution
3. Java 8 or greater - You can install it by running

   sudo apt-get update
   sudo apt-get install default-jdk
   

   Make sure it is working by running java -version

4. Git - You can check by running git --version but it should come installed

Boot Example Yavin App Locally #

Once you are all set up, run the following steps (On Terminal for macOS, and on Bash for Windows) to boot the example Yavin app:

There is currently a bug that requires your locale to be set otherwise your app may crash.

If you see an error like Error parsing "September 9, 2019", run export LANG=en_US.UTF-8

1.1 (Option 1) Run Jar Locally #

To kick of your custom data application building, you will only need the app repo.

git clone https://github.com/yavin-dev/app.git
./gradlew bootRun                           

1.2 (Option 2) Launch Demo App in Docker Container #

If local port is different then change the argument in below command. Format is -p <host port>:<container port>

docker run -p 8080:8080 docker.io/verizonmedia/yavin_demo:latest

(To stop the server at any time, type Ctrl-C in your terminal.)

2. Open The App In Your Browser #

Congratulations! You can now open http://localhost:8080. This will launch the Yavin application into your browser with the built in data set for Netflix and TV shows that is sourced from Kaggle data.

Steps In Action #

The video above is a recording of the steps required to boot the Yavin example app.

Helpful Links #

For a more extended list of commands that can be done once you clone the repo, please check: https://github.com/yavin-dev/app#getting-started