Giter Club home page Giter Club logo

peakaboo's Introduction

Peakaboo

A real time dashboard for the remote monitoring of Opencast compatible capture agents

Alt text

To run in development

Installing the extra node packages:

meteor npm install
mkdir config
cp docs/settings.example.json config/settings.json
chmod u+x run
./run

The meteor applcation will build then point a web browser at:

http://localhost:3000

To run in in production

Peakaboo has been dockerized so its super straight forward to get this running in a production environment. There are however alternatives to running meteor apps in production but they aren't covered here.

Its highly recomended you run this as a non-root user. Create a new user, a good name would be peakaboo

First generate a valid SSL certificate. You can generate a self signed certificate or you could also use Letsencrypt with certbot https://letsencrypt.org/.

You will also need to create a new .htpasswd file to allow clients to POST images back to peakaboo

move into the docker folder and place your SSL key file and certificate into the Nginx

cd .docker/
cp /path/to/ssl-key.file nginx/my.key
cp /path/to/ssl-cert.file nginx/my.crt
cp /path/to/.htpasswd nginx/.htpasswd

Install docker and docker-compose. Please refer to the latest docker documenation on how to get started on your platform https://docs.docker.com/engine/installation/ https://docs.docker.com/compose/ you can also install the latest docker-compose via pip

pip install docker-compose

In production Meteor apps get their settings from enviroment variables, these can be set in the .bash_profile or exported on the fly. Export your settings JSON and give set the SERVER_NAME to match your DNS hostname of the server.

export METEOR_SETTINGS=$(cat ~/path/to/settings.json)
export SERVER_NAME=peakaboo.example.com

To Build the peakaboo docker container run:

docker-compose build peakaboo

CentOS 6: To divert docker's logs to syslog so that they are auto rotated and don't fill up the disk, make sure /etc/sysconfig/docker has:

other_args="--log-driver=syslog"

Then run peakaboo!

docker-compose up -d

When there's a change peakaboo you can update the docker images by stopping the containers and re building the images

docker-compose stop
docker-compose build peakaboo
docker-compose up -d

Client Side

To send/recieve data from the peakaboo app you will need to use a client that uses the Distributed data protocol from Meteor. You could write your own, or check out the examples in the docs directory: Peakaboo Plugins

peakaboo's People

Contributors

andiempettjisc avatar mliradelc avatar paulgration avatar ppettit avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.