Withdraw of the 6.9.2 Release
Unfortunately, due to critical issues identified with version 6.9.2, we have decided to remove it and ensure it's no longer available for download. These issues impacted the ability to install or upgrade but none were security-related. We are diligently working to resolve these issues and are planning to release an updated version 6.9.3 in early May.
What if you've already upgraded?For customers who have already upgraded to 6.9.2, no immediate action is required, as none of these issues are security-related. Once it's available, you will still be able to upgrade to 6.9.3 as normal. We appreciate your patience and trust as we continue to enhance our software to better serve you. Thank you for your understanding.
Queryhost - Listing
Valid parameters are:
hostname
— hostname of the server as stored within the database. Required.ip
— Hostname or IP address. Required if not using hostname or if this is a new host.snmp_version
— one of 1, 2c or 3. Required if not using hostname or if this is a new host.hostid
— hostid of the host from the DB. Not required if this is a new host.msid
— the monitoring cluster that the query is to be run from. Will use the first node if it is a cluster. Can be set to the primary collector, which is set to 1. Default is primary.snmp_port
— port for snmp to listen for devices. Defaults to 161.
The remaining parameters for QueryHost depends on the version of SNMP requested.
Version 1 and 2c Copied
The parameters required are:
snmp_community
— the community string.
Version 3 Copied
Extra information is required to satify the snmpv3 credentials. These must be added to the call.
- snmpv3_username
- snmpv3_authpassword
- snmpv3_authprotocol
- snmpv3_privpassword
- snmpv3_privprotocol
Listing interfaces Copied
Output of a list response (NOTE: id => 0
is used to set the default threasholds for all interfaces and is not a ‘real’ interface):
{
interfaces => [
{
discards_critical => 15,
discards_warning => "",
errors_critical => 10,
errors_warning => "",
extra_info => "alias:'' speed:'' link:'' status:''",
id => 0,
ifAlias => undef,
ifDescr => "",
ifLink => undef,
ifSpeed => undef,
ifStatus => undef,
interfacename => "",
throughput_critical => "0:50%",
throughput_warning => "",
},
{
discards_critical => "",
discards_warning => "",
errors_critical => "",
errors_warning => "",
extra_info => "alias:'192.168.13.0 network' speed:'10Mbit/s' link:'up' status:'up'",
id => 1,
ifAlias => "192.168.13.0 network",
ifDescr => "Ethernet0/0",
ifLink => "up",
ifSpeed => "10Mbit/s",
ifStatus => "up",
interfacename => "Ethernet0/0",
throughput_critical => "",
throughput_warning => "",
},
{
discards_critical => "",
discards_warning => "",
errors_critical => "",
errors_warning => "",
extra_info => "alias:'192.168.21.0 network' speed:'10Mbit/s' link:'down' status:'down'",
id => 3,
ifAlias => "192.168.21.0 network",
ifDescr => "Ethernet0/1",
ifLink => "down",
ifSpeed => "10Mbit/s",
ifStatus => "down",
interfacename => "Ethernet0/1",
throughput_critical => "",
throughput_warning => "",
},
{
discards_critical => "",
discards_warning => "",
errors_critical => "",
errors_warning => "",
extra_info => "alias:'' speed:'8Gbit/s' link:'up' status:'up'",
id => 5,
ifAlias => "",
ifDescr => "Loopback0",
ifLink => "up",
ifSpeed => "8Gbit/s",
ifStatus => "up",
interfacename => "Loopback0",
throughput_critical => "",
throughput_warning => "",
},
{
discards_critical => "",
discards_warning => "",
errors_critical => "",
errors_warning => "",
extra_info => "alias:'' speed:'10Gbit/s' link:'up' status:'up'",
id => 4,
ifAlias => "",
ifDescr => "Null0",
ifLink => "up",
ifSpeed => "10Gbit/s",
ifStatus => "up",
interfacename => "Null0",
throughput_critical => "",
throughput_warning => "",
},
{
discards_critical => "",
discards_warning => "",
errors_critical => "",
errors_warning => "",
extra_info => "alias:'192.168.250.0 network' speed:'2Mbit/s' link:'up' status:'down'",
id => 2,
ifAlias => "192.168.250.0 network",
ifDescr => "Serial0/0",
ifLink => "up",
ifSpeed => "2Mbit/s",
ifStatus => "down",
interfacename => "Serial0/0",
throughput_critical => "",
throughput_warning => "",
},
{
discards_critical => "",
discards_warning => "",
errors_critical => "",
errors_warning => "",
extra_info => "alias:'' speed:'100Mbit/s' link:'up' status:'up'",
id => 7,
ifAlias => "",
ifDescr => "Virtual-Access1",
ifLink => "up",
ifSpeed => "100Mbit/s",
ifStatus => "up",
interfacename => "Virtual-Access1",
throughput_critical => "",
throughput_warning => "",
},
{
discards_critical => "",
discards_warning => "",
errors_critical => "",
errors_warning => "",
extra_info => "alias:'' speed:'100Mbit/s' link:'up' status:'down'",
id => 8,
ifAlias => "",
ifDescr => "Virtual-Access2",
ifLink => "up",
ifSpeed => "100Mbit/s",
ifStatus => "down",
interfacename => "Virtual-Access2",
throughput_critical => "",
throughput_warning => "",
},
{
discards_critical => "",
discards_warning => "",
errors_critical => "",
errors_warning => "",
extra_info => "alias:'' speed:'100Mbit/s' link:'up' status:'down'",
id => 6,
ifAlias => "",
ifDescr => "Virtual-Template1",
ifLink => "up",
ifSpeed => "100Mbit/s",
ifStatus => "down",
interfacename => "Virtual-Template1",
throughput_critical => "",
throughput_warning => "",
},
],
system_description => "Cisco Internetwork Operating System Software",
}
Testing connection Copied
{
system_description => "Cisco Internetwork Operating System Software",
}