genddx - Generates SNMP discovery instructions file for
devdiscover.
genddx --host=HOSTNAME | --hostfile=HOSTFILENAME \
[options...]
genddx generates the SNMP discovery instructions file, which may
be later used as input for the devdiscover utility to produce the
corresponding RRFW XML configuration file. The hostname(s) of router(s) to
be included in SNMP discovery must be specified either using the
--host (for a single router) or --hostfile option. In the latter
case the file HOSTFILENAME must contain a space-separated list of router
hostnames. Hostnames may have the form host:devname where devname is
a symbolic device name.
This utility is designed to be used only once, in order to generate
the discovery XML canvas, for futher manual editing. It generates only
basic set of parameters, and there are much more of those that you may
use to customize the discovery process.
More information is available in RRFW SNMP Discovery User Guide.
- --out=OUTFILENAME
-
Sets the output file to OUTFILENAME. Default is routers.ddx.
- --discout=FILENAME
-
Sets the discovery output file to FILENAME. This will be the filename of
the RRFW XML configuration file once the output file of the genddx
is processed by the devdiscover utility. Default value is
/usr/local/rrfw-0.1/share/rrfw/xmlconfig/routers.xml.
- --domain=DOMAIN
-
Sets the DNS domain name to DOMAIN.
- --version=SNMPVERSION
-
Sets discovery SNMP version to SNMPVERSION. Default value is
2c.
- --community=COMMUNITY
-
Sets discovery SNMP read community value to string COMMUNITY. Default
is
public.
- --port=PORT
-
Sets SNMP port to PORT. Default is 161.
- --retries=NUMRETRIES
-
Sets number of retries to NUMRETRIES. Default value is 2.
- --timeout=TIMEOUT
-
Sets SNMP timeout to TIMEOUT seconds. Default value is 10.
- --subtree=SUBTREE
-
Sets the subtree name to SUBTREE. Default is
/Routers.
- --datadir=DATADIR
-
Sets the path of the directory where SNMP data is collected to DATADIR.
Default value is /var/snmpcollector.
- --holtwinters
-
Enables Holt-Winters analysis.
- routers.ddx
-
Default output file of genddx.
- /usr/local/rrfw-0.1/share/rrfw/xmlconfig/routers.xml
-
Default RRFW XML configuration file which will be written once the
genddx output file is processed with devdiscover utility.
devdiscover(1)
See more documentation at RRFW home page: http://rrfw.sf.net
Stanislav Sinyagin <ssinyagin@yahoo.com>