TORRUS_ACTION_PRINTEMAIL(7) torrus TORRUS_ACTION_PRINTEMAIL(7)NAME
action_printemail - A script for sending email from monitor action.
SYNOPSIS
<action name="report-email">
<param name="action-type" value="exec" />
<param name="command">
$TORRUS_BIN/action_printemail | mail alarms@example.com
</param>
<param name="launch-when" value="set, clear" />
</action>
DESCRIPTION
This program is designed for usage from a monitor action only. It takes the arguments from environment variables, as described in action-
type "exec" in Torrus XML Configuration Guide. In addition, some values may be supplied via command-line arguments (see section OPTIONS
below).
Site-specific variables must be specified in the file email-siteconfig.pl. Default values are installed by the first run of "make
install". Subsequent runs of "make install" do not override this file.
OPTIONS --url=GRAPHER-URL
Sets the URL of the grapher CGI script.
--template=TEMPLATE-FILE
Uses given file as a template. The template file must reside in /usr/share/torrus/templates directory. It must be a Template-toolkit
file, with the following variables defined:
tree Tree name
token Leaf token
path Leaf path
url URL for browsing this leaf
ncomment This leaf comment
npcomment Leaf's parent comment
event Event type
monitor Monitor name
mcomment Monitor comment
timestamp Time and date of the event
env(VAR) Environment variable VAR
FILES
/etc/torrus/conf/email-siteconfig.pl
Torrus site email configuration script.
/usr/share/torrus/templates
/etc/torrus/templates
Torrus template directories.
SEE ALSO torrus(8)NOTES
See more documentation at Torrus home page: http://torrus.org
AUTHOR
Stanislav Sinyagin <ssinyagin@yahoo.com>
torrus 2.03 2013-07-26 TORRUS_ACTION_PRINTEMAIL(7)
Check Out this Related Man Page
TORRUS_CONFIGSNAPSHOT(8) torrus TORRUS_CONFIGSNAPSHOT(8)NAME
configsnapshot - Generates a configuration snapshot for a Torrus tree.
SYNOPSIS
torrus configsnapshot --tree=TREENAME [options...]
DESCRIPTION
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 RRFW release
"0.1.4bf2" instead. "configsnapshot" utility from RRFW release 0.1.4bf2 does not preserve aliases.
This utility is useful in Torrus upgrade process. In case when RRD files structure is changing in Torrus default templates, and user(s)
demand to preserve the historical data, the following steps could be done:
o Stop the collector and monitor processes.
o Install newest Torrus software and do not run "compilexml" immediately.
o Create snapshots of the trees that you want to preserve for historical reasons:
torrus configsnapshot --tree=myrouters
--out=/etc/torrus/xmlconfig/myrouters-snapshot.xml
o If needed, move the existing RRD files into different directory. Then change the "data-dir" parameters in the snapshot XML accordingly.
o Create a new tree with only the snapshot file in it. Compile the tree.
o 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.
OPTIONS --tree=TREE
Mandatory parameter specifying the tree name.
--out=FILE
Sets the output file to FILE. Default is snapshot.xml.
--param=PARAM--value=VALUE
Sets the filter on datasource leaves that have to be included in the snapshot. PARAM specifies the name of the datasource parameter,
and VALUE sets the matching value. By default the numeric comparison is performed.
--op=OPERATOR
Sets the fiter comparison operator. Accepted values: = (numeric), eq (text string comparison), and re (regular expression match).
Default is numeric comparison.
--verbose
Displays some extra information.
--help
Displays a help message.
FILES
/usr/share/torrus/xmlconfig/defaults.xml
XML configuration file with default settings for the datasources and tokensets, as well as default view definitions.
snapshot.xml
Default configsnapshot output file.
SEE ALSO torrus(8), torrus_compilexml(8)NOTES
See more documentation at Torrus home page: http://torrus.org
AUTHOR
Stanislav Sinyagin <ssinyagin@yahoo.com>
torrus 2.03 2013-07-26 TORRUS_CONFIGSNAPSHOT(8)