GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
TORRUS_GENDDX(1) torrus TORRUS_GENDDX(1)

genddx - Generates SNMP discovery instructions file for devdiscover

torrus 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 Torrus 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.

See torrus_ttproclist(1) for a more flexible and complex DDX generator.

More information is available in Torrus SNMP Discovery User Guide.

--out=OUTFILENAME
Sets the output file to OUTFILENAME. Default is routers.ddx. Without absolute path, the file will be placed in /usr/local/etc/torrus/discovery.
--discout=FILENAME
Sets the discovery output file to FILENAME. This will be the filename of the Torrus XML configuration file once the output file of the genddx is processed by the devdiscover utility. Default value is routers.xml. Without absolute path, the file would be resided in /usr/local/etc/torrus/xmlconfig.
--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/torrus/collector_rrd.
--holtwinters
Enables Holt-Winters analysis.

/usr/local/etc/torrus/discovery/routers.ddx
Default output file of genddx.
/usr/local/etc/torrus/xmlconfig/routers.xml
Default Torrus XML configuration file which will be written once the genddx output file is processed with devdiscover utility.

torrus(1), torrus_devdiscover(1), torrus_ttproclist(1)

See more documentation at Torrus home page: http://torrus.org

Stanislav Sinyagin <ssinyagin@k-open.com>
2022-06-08 torrus 2.09

Search for    or go to Top of page |  Section 1 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.