UnmanageNode.pl

Use the UnmanageNode.pl Perl script to set one or more devices to unmanaged state so that engineers can work on these devices without generating network events. Unmanaged devices are not polled by Network Manager. Events for these devices from other sources are tagged in the Event Viewer to indicate they are from an unmanaged device.

Description

If you set a device to unmanaged, polling is suspended for the unmanaged node. In the Event Viewer, all alerts are tagged to indicate they are from an unmanaged device, and are not used for root cause analysis. You can also unmanage individual devices or groups of devices from the topology map views. There is also an option to set individual components of a device to unmanaged state using the Structure Browser.

Running the script

To run the script, use a command line similar to the following:

$NCHOME/precision/bin/ncp_perl $NCHOME/precision/bin/UnmanageNode.pl -domain NCOMS -user root -pwd fruit -noMainNodeLookup -verbose -file mynodes.txt

$NCHOME/precision/bin/ncp_perl $NCHOME/precision/bin/UnmanageNode.pl -domain NCOMS -user root -pwd fruit -verbose neptune.ibm.com 192.168.0.6

Command-line options

The following table describes the command-line options for the script.

Table 1. UnmanageNode.pl command-line options
Command-line option	Description
-domain `DomainName`	Mandatory; the name of the domain where the node to be unmanaged resides.
-user `username`	Mandatory; the name of the database user.
-pwd `password`	Mandatory; the password for the database user.
-noMainNodeLookup	Optional; switch that enables both interfaces and main nodes to placed into unmanaged status. Use this option together with the `-file` option. Note: If you do not specify the -noMainNodeLookup option, then the script only places main nodes into unmanaged state. Where an interface is specified in the file, the script will look up the main node and place that main node into unmanaged status.
-file `FileName`	Optional; file containing the list of nodes and interfaces to be unmanaged. Add one IP address or host name per line in the file. Note: You must provide the names of the nodes and interfaces either in a file or by entering them in the command line, as described in `host` below.
-verbose	Optional; provides more information on the screen.
`host`	Optional; the name of the node to be unmanaged. You can specify any number of nodes this way, separated by spaces. The information entered for a node can be either the IP address or the host name. If you do not provide a host name, then the -file option must be used.