JRobin Converter

From OpenNMS
Jump to: navigation, search

The JRobin Converter is a tool for converting and combining RRD data for the purposes of migrating data into a storeByGroup archive.

Getting the JRobin Converter

The JRobin Converter does not currently have a stable release, but will get one soon after confirmation with the customer we've done the development for. In the meantime, you can get it by building it from source. The converter is a part of the opennms-tools directory in what will be OpenNMS 1.8.11 and 1.9.7.

Follow the instructions on the Developing with Git page for checking out OpenNMS, and build it:

 cd opennms-tools/opennms-rrd-converter
 ../../compile.pl package

Your finished converter jar will be in target/opennms-rrd-converter-*-jar-with-dependencies.jar.

Now you can try running it:

 $ java -Xmx1g -jar path-to/opennms-rrd-converter-*-jar-with-dependencies.jar -h
 usage: jrobin-converter [options] [file-or-directory1] [...file-or-directoryN]
  -f,--factory <arg>   The JRobin factory to use. (Default: MNIO)
  -h,--help            This help.
  -l,--log <arg>       The log level to use. (Default: INFO)
  -t,--threads <arg>   Number of threads to start. (Default: 5)

The defaults should be fine for most people, just run it (make sure to give it enough memory), and pass 1 or more files or directories to convert.

 $ java -Xmx1g -jar path-to/opennms-rrd-converter-*-jar-with-dependencies.jar 56541
 Mon Feb 28 17:07:10 EST 2011: INFO: JRobinConverter: Scanning 56541 for storeByGroup data.
 Mon Feb 28 17:07:10 EST 2011: INFO: JRobinConverter: Finished scanning for storeByGroup RRDs. (Total RRD count: 2)
 Mon Feb 28 17:07:10 EST 2011: INFO: JRobinConsolidationRunnable: Starting processing 56541/en0-001cfbfc58e0/mib2-interfaces.rrd (1/2 Started)
 Mon Feb 28 17:07:10 EST 2011: INFO: JRobinConsolidationRunnable: Starting processing 56541/WAN_1/mib2-interfaces.rrd (2/2 Started)
 Mon Feb 28 17:07:25 EST 2011: INFO: JRobinConsolidationRunnable: Completed processing 56541/WAN_1/mib2-interfaces.rrd (1/2 Complete)
 Mon Feb 28 17:07:25 EST 2011: INFO: JRobinConsolidationRunnable: Completed processing 56541/en0-001cfbfc58e0/mib2-interfaces.rrd (2/2 Complete)

Your old storeByGroup files will be renamed to <file>.finished, and the new ones with the combined data will be in their place.