opentsdb-vagrant-box's Introduction

opentsdb-vagrant-box

Introduction

Work In Progress: Vagrant box to easily get OpenTSDB up and running through Vagrant (with a Chef provisionning)

Done so far:

installs HBase as listed at OpenTSDB/Setup HBase (recipe opentsdb::install)
starts HBase if needed (recipe opentsdb::install)
installs OpenTSDB from source (recipe opentsdb::install)
creates OpenTSDB hbase tables (only if needed) (recipe opentsdb::install)
installs tcollector (dedicated recipe opentsdb::tcollector) (recipe opentsdb::tcollector)
starts a TSD process (recipe opentsdb::opentsdb)
starts sample metrics gathering (recipe opentsdb::opentsdb)

Requirements

TIP

The Vagrant file suggests to use a centos box but it may work with other linux distributions.
The Vagrant file suggests an url for a centos box if you don't have any base box registred under the name centos63, but you should be able to use any centos box (see available boxes at Vagrantbox.es)

Usage

Install Vagrant
Install VirtualBox
git clone https://github.com/looztra/opentsdb-vagrant-box.git
cd opentsdb-vagrant-box
vagrant up
wait several minutes the first time (hbase downloading, opentsdb building, ...)
- if provisionning fails, you may need to adjust according to your configuration and restart it using vagrant provision
when your VM is up and provisionning is done you should be able to access the OpenTSDB UI at http://localhost:4242 (check your iptables and firewall settings if needed)

Disclaimer

The Chef recipes provided are not relevant for a production usage (HBase installation does not use HDFS and does not run on a cluster for instance). This VM can be used to give a try to OpenTSDB or to developp something in the OpenTSDB ecosystem (like a new Dashboard UI or a Metrics connector for instance :]).

Recommend Projects