Skip to content

spacehellas/tnova-vim-backend

Repository files navigation

T-NOVA VIM Monitoring Back-End

Build Status Dependency Status

The monitoring back-end of T-NOVA's Virtual Infrastructure Manager (VIM).

Primarily developed by SPACE Hellas and released under the GNU General Public License v3.0.

Quick Start

Step 1. Download collectd's types.db:

mkdir tnova_vim
cd tnova_vim
curl -LO https://github.com/collectd/collectd/raw/master/src/types.db

Step 2. Launch an InfluxDB container:

docker run -d --name tnova-monitoring-influxdb \
    --restart always \
    -p 8083:8083 -p 8086:8086 -p 25826:25826/udp \
    -v $PWD/influxdata:/var/lib/influxdb \
    -v $PWD/types.db:/usr/share/collectd/types.db \
    -e INFLUXDB_REPORTING_DISABLED=true \
    -e INFLUXDB_COLLECTD_ENABLED=true \
    -e INFLUXDB_COLLECTD_BIND_ADDRESS=":25826" \
    -e INFLUXDB_COLLECTD_DATABASE="statsdb" \
    -e INFLUXDB_COLLECTD_TYPESDB="/usr/share/collectd/types.db" \
    influxdb:alpine

Step 3. Launch the monitoring container:

docker run --name=tnova-vim-backend -d \
    --link tnova-monitoring-influxdb:influxdb \
    --publish 8080:3000 \
    tnova/vim-backend:latest

Running locally

Although it is recommended to run the back-end inside a Docker container as described here, it is possible to run it locally.

Requirements

  • Node.js v4.2 or higher (Tested version: 4.4.7)
  • npm
  • InfluxDB v0.9 or higher (Tested version: 0.12)

Running instructions

Before running the application, make sure that an InfluxDB service is available and that the default configuration file, config/default.json is properly modified.

git clone [email protected]:spacehellas/tnova-vim-backend.git # or clone your own fork
cd tnova-vim-backend
npm install
node app.js

More information