The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

netdisco-do - Run any Netdisco job from the command-line.

SYNOPSIS

 ~/bin/netdisco-do <action> [-DISQ] [-d <device> [-p <port>] [-e <extra>]]

DESCRIPTION

This program allows you to run any Netdisco poller job from the command-line.

Note that some jobs (discoverall, macwalk, arpwalk), nbtwalk) simply add entries to the Netdisco job queue for other jobs, so won't seem to do much when you trigger them.

ACTIONS

discover

Run a discover on the device (specified with -d).

macsuck

Run a macsuck on the device (specified with -d).

arpnip

Run an arpnip on the device (specified with -d).

nbtstat

Run an nbtstat on the node (specified with -d).

graph

Generate GrapgViz graphs for the largest cluster of devices.

show

Dump the content of an SNMP MIB leaf, which is useful for diagnostics and troubleshooting. You should provide the "-e" option which is the name of the leaf (such as interfaces or uptime).

If you wish to test with a device class other than that discovered, prefix the leaf with the class short name, for example "Layer3::C3550::interfaces" or "Layer2::HP::uptime".

set_location

Set the SNMP location field on the device (specified with -d). Pass the location string in the -e extra parameter.

set_contact

Set the SNMP contact field on the device (specified with -d). Pass the contact name in the -e extra parameter.

set_portname

Set the description on a device port. Requires the -d parameter (device), -p parameter (port), and -e parameter (description).

set_portcontrol

Set the up/down status on a device port. Requires the -d parameter (device), -p parameter (port), and -e parameter ("up" or "down").

set_vlan

Set the native VLAN on a device port. Requires the -d parameter (device), -p parameter (port), and -e parameter (VLAN number).

set_power

Set the PoE on/off status on a device port. Requires the -d parameter (device), -p parameter (port), and -e parameter ("true" or "false").

DEBUG LEVELS

The flags "-DISQ" can be specified, multiple times, and enable the following items in order:

-D

Netdisco debug log level

-I or -II

SNMP::Info trace level (1 or 2).

-S or -SS or -SSS

SNMP (net-snmp) trace level (1, 2 or 3).

-Q

DBIx::Class trace enabled.