diff options
Diffstat (limited to 'README')
-rw-r--r-- | README | 73 |
1 files changed, 36 insertions, 37 deletions
@@ -1,48 +1,47 @@ -Jarmon 11.10.1 - - -What is this? -============= -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. +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 -<a href="http://collectd.org/">Collectd</a>. - -# 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 Twisted, but there are other web server -# config examples in docs/ -$ aptitude install twisted -$ twistd -n web --port 8080 --path . - -$ firefox http://localhost:8080/docs/examples/index.html +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 + * `docs/examples/index.html` + * `docs/examples/jarmon_example_recipes.js` -...for examples of how to use jarmon.js then add your own chart recipes. +...for examples of how to use jarmon.js then add your own chart +recipes. |