Managing NerveCenter - Controlling NerveCenter from the Command Line - ipsweep -
installdb      mibcomp

ipsweep

NAME

ipsweep

SYNOPSIS

DESCRIPTION

Discovers network devices on the subnets managed with NerveCenter. Ipsweep pings IP addresses according to filters set in the NerveCenter Administrator. If no filters are defined, ipsweep does not ping any IP addresses. If ipsweep receives a response from an IP address, ipsweep sends a SNMP v1 trap to NerveCenter. You must configure NerveCenter to automatically add nodes if a trap is received in order to update your node list. For more information about configuring NerveCenter to work with ipsweep, see Managing NerveCenter and Designing and Managing Behavior Models.

The NerveCenter Server must be running to use ipsweep.

OPTIONS

Specifies debug mode and outputs verbose debug messages to the console.

Specifies trace mode and outputs status messages to the console.

Specifies a file that contains a list of IP addresses for ipsweep to ignore.

Specifies a map file that contains node information about the network.

IP Filters must still be configured in the NerveCenter Administrator's IP Filters page for each subnet that is discovered. The map file uses the subnet and mask value to match an existing pair in the IP Filters page. The Map file does not specify which subnets to discover. It just specifies the read community string used for a subnet if it is discovered.

Writes a text file containing the read community string used for discovered subnets. You can then edit this file and use with -m.

Specifies that no SNMPv1 Traps are sent. Useful with -d and -trace for debugging behavior without causing unnecessary notifications.

ICMP timeout interval. timedelay is a value in milliseconds (default is 20 milliseconds).

Specifies the time to live (TTL) value for IPSweep, where the valid value is between 0 and 255 hops. The default value for -ttl is: 255 hops (128 for Windows 2000).

Provides command line help for ipsweep.

USAGE

Ipsweep can read an exclude file specified by the -f switch. This exclude file is parsed as follows:

• One IP Address can be listed on each line.
• The IP Address must be the first token in each line; there can be no leading white space.
• Any text or data following the IP Address is ignored.
• Each line cannot be more than 16 characters in length or else the entire line is ignored.
• Lines which are blank or do not contain a valid IP Address as the first token are ignored.
• An IP Address is considered valid only if it contains four octets, separated by periods (.), where each octet is in the range 0 (zero) to 255 inclusive.
• A hostname cannot be used in place of an IP Address; no lookup is performed to see whether a non-valid IP Address is actually a hostname.
• You can use comment labels, such as # or ;, to comment your exclude file, for example:
     # Private QA Router
   168.192.13.194
   # Printer
   168.192.1.44

On startup, ipsweep can read a map file specified by the -m switch. This map file contains a table as follows:

The first line should be the `Default DefaultReadCommunity' line. A single blank separates the word Default and the community string. Each of the lines following the Default line will be in the format specified above. These lines will be a Subnet immediately followed by a slash ("/") immediately followed by the Mask. The "Subnet/Mask" is followed by a single blank and then the community string, for example: