summaryrefslogtreecommitdiff
path: root/README
blob: 2da9744d5a1475b7fdc5b330aa1bdb602a888430 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
jarmon.js contains various wrappers and convenience fuctions for
working with the [javascriptRRD][], [Flot][] and RRD files generated
by eg [Collectd][].  Additionally, there is a fully working example
which demonstrates how to use jarmon.js and how to integrate it with
other javascript components - such as calendar date pickers etc.

[javascriptRRD]: http://javascriptrrd.sourceforge.net/
[Flot]: http://www.flotcharts.org/
[Collectd]: https://collectd.org/

Debian / Ubuntu Quick Start
===========================

There is a demo html page in the `docs/examples` folder.  To get this
demo working, you will need to serve that page from a local webserver
and serve the folder that contains your RRD files.

This demo is designed to work with the RRD files generated by
[Collectd][].

    # Install and configure collectd (enable the rrd plugin)
    $ aptitude install collectd
    
    # Create a project folder and check out the code
    $ mkdir -p ~/Projects/Jarmon
    $ cd ~/Projects/Jarmon
    $ bzr branch lp:~richardw/jarmon/trunk
    $ cd trunk
    
    # Link to the collectd rrd folder
    $ ln -s /var/lib/collectd/rrd/localhost docs/examples/data
    
    # Start a local webserver - here we use Python 2's built-in web
    # server, but there are other web server config examples in docs/
	$ python2 -m SimpleHTTPServer 8080
    
    $ firefox http://localhost:8080/docs/examples/index.html

Next Steps
==========

Examine:
 * `docs/examples/index.html`
 * `docs/examples/jarmon_example_recipes.js`

...for examples of how to use jarmon.js then add your own chart
recipes.