configsnapshot - Generates a configuration snapshot for a RRFW tree.
configsnapshot --tree=TREENAME [options...]
This command generates a configuration snapshot from current datasources for tree TREENAME. The output is an XML file, ready for compilation, representing all datasources, monitors and tokensets of a given tree. The snapshot does not include view definitions. Templates and file patterns are expanded inside the file. It does not require any other XML configuration files, except for defaults.xml and your custom view definitions.
Warning: configsnapshot from RRFW release 0.1.5 will not work
correctly with databases from previous releases. Use release
0.1.4bf2 instead. configsnapshot utility from release 0.1.4bf2
does not preserve aliases.
This utility is useful in RRFW upgrade process. In case when RRD files
structure is changing in RRFW default templates, and user(s) demand to
preserve the historical data, the following steps could be done:
compilexml immediately.
Create snapshots of the trees that you want to preserve for historical reasons:
configsnapshot --tree=myrouters \
--out=share/xmlconfig/myrouters-snapshot.xml
If needed, move the existing RRD files into different directory. Then
change the data-dir parameters in the snapshot XML accordingly.
Create a new tree with only the snapshot file in it. Compile the tree.
At this stage, it is up to the user to decide wether to continue running the
collector and monitor daemons for this new tree. The old data may be preserved
for historical reference, and collector may be run with the newest tree
structure and definitions.
compilexml(1)
See more documentation at RRFW home page: http://rrfw.sf.net
Stanislav Sinyagin <ssinyagin@yahoo.com>