Skip to content

onyx-platform/onyx-dashboard

Repository files navigation

onyx-dashboard

UNMAINTAINED

A dashboard for the Onyx distributed computation system.

Gitter

Circle CI

Design and User Guide

A description and user guide disguised as a blog post can be found here.

Versioning

Version numbers will be kept in sync with [Onyx] (https://github.com/onyx-platform/onyx). For example, to use a version compatible with Onyx 0.8.1.0-alpha8, use a version of the dashboard beginning with 0.8.1.0-alpha8. The fourth version number will be reserved for dashboard versioning, in order to provide releases out of band with Onyx.

Releases are listed at RELEASES.md.

Deployment

Run the jar via:

java -server -jar onyx-dashboard-VERSION.jar ZOOKEEPER_ADDR

By default the server will listen on port 3000, but this can be configured via the PORT environment variable.

Alternately, run the docker image like so:

docker run -p 3000:3000 onyx/onyx-dashboard:<tag> 192.168.1.170:2188

The IP passed in is used by ZooKeeper.

NOTE: If you are running the Onyx Dashboard via Docker on Mac, but are running ZooKeeper locally, be aware that there are limitations with networking on Mac. Per the Docker on Mac networking documentation, your best work around is to assign a dummy IP as an alias to the loopback adapter on the host machine and point the Docker image at that IP. Something like this should do the trick:

sudo ifconfig lo0 alias 10.200.10.1/24
docker run -p 3000:3000 onyx/onyx-dashboard:latest 10.200.10.1:2188

Development

In a terminal start a sample job and cluster to dashboard against:

lein run -m onyx.peer.dag-test

Then start developyment:

Run lein repl to start your repl.

In the REPL, run

(onyx-dashboard.dev/start-figwheel)

Then run:

(user/stop) (clojure.tools.namespace.repl/refresh) (user/go "127.0.0.1:2188")

to start the server, and each time you make a change on the server.

Then point your browser at http://localhost:3000/

License

Copyright © 2016 Distributed Masonry

Distributed under the Eclipse Public License either version 1.0 or (at your option) any later version.

Chestnut

Created with Chestnut 0.7.0-SNAPSHOT (ecadc3ce).