HOME | Library | JRobin API | Utilities | Support | About Us | Forum

Main library
Simple demo
Complex demo
Stress test
Other demos
Playing with ANT

# Main library

JRobin is distributed as a single tarball named jrobin-{version}.tar.gz. When you unpack it, the following directory structure will be created:

    /jrobin-{version}
        /src                           -> full source code
        /doc                           -> HTML documentation
            /javadoc                   -> javadoc
        /res                           -> files used for JRobin MRTG demo development
        /lib                           ->
            jrobin-{version}.jar       -> main library, JRobin itself
            jrobin-demo-{version}.jar  -> library with demo classes
            mrtg-server-{version}.jar  -> see JRobin MRTG demo
            mrtg-client-{version}.jar  -> (same as above)
            xmlrpc.jar                 -> (same as above)
            snmp.jar                   -> (same as above)
            inspector-{version}.jar    -> check Inspector utility page
            convertor-{version}.jar    -> check Convertor utility page
        /ant
            build.xml                  -> Jakarta ant build file

To use JRobin in your Java code you'll have to include main JRobin library in the classpath. JRobin library comes in a single JAR file (jrobin-{version}.jar), without external dependencies. This jar consists of two packages:

- org.jrobin.core.*
  The core library. All classes and methods necessary to create and update your RRD files, or to fetch data from them are here. This package must be imported whenever a create/update/fetch/graph/last operation is to be performed.
- org.jrobin.graph.*
  JRobin's graphing API. Import this package in your java code only when you want to create RRD graphs with JRobin. Prior to version 1.2.0, JRobin used JFreeChart library to do the hard work (actual graph drawing) but this library is now obsolete and you won't find it in the distribution. Starting from version 1.2.0, JRobin uses no external libraries.

Important: If your JRobin based application should run on a platform without XFree86 system (common situation on many network servers), you have to run your JVM in a headless mode:

    java -Djava.awt.headless=true -cp jrobin-{version}.jar ...

Otherwise, you'll end with a nasty looking exception whenever you try to create your custom RRD graphs with JRobin API.

Back to the top

Copyright © 2003, 2004 Sasa Markovic & Arne Vandamme. All Rights Reserved.