Cisco Cisco Prime Network Registrar 8.1 Technical References
DiscoverNetElement
Cisco Prime Network Registrar IPAM 8.1.1 CLI and API Guide
104
DiscoverNetElement
Overview
The
DiscoverNetElement
CLI allows the user to issue an immediate Discover task to
discover the interfaces bound to a network element already defined in Cisco Prime
Network Registrar IPAM.
Usage
Direct
$INCHOME/jre/bin/java –cp $CLASSPATH com.diamondip.netcontrol.cli.DiscoverNetElementCLI
–u <adminId> -p <admin password> (-n <network element name> or -i <netelement address>)
[-?]
–u <adminId> -p <admin password> (-n <network element name> or -i <netelement address>)
[-?]
Via command script (Unix)
$INCHOME/etc/DiscoverNetElement.sh –u <adminId> -p <admin password>
[-n <network element name>] (-n <network element name> or -i <netelement address>) [-?]
[-n <network element name>] (-n <network element name> or -i <netelement address>) [-?]
Via command script (Windows) from the %INCHOME%/etc/cli directory
DiscoverNetElement.cmd –u <adminId> -p <admin password>
(-n <network element name> or -i <netelement address>) [-?]
(-n <network element name> or -i <netelement address>) [-?]
Parameters
Parameter
Required
Description
-u <userId>
Yes
User Id
-p <pwd>
Yes
Password
-?
No
Print help
-i <IP Address | FQDN>
Yes
IP Address or fully-qualified domain name (FQDN) of the
device to discover. Required only if Network Element Name not
specified.
-n <Name>
Yes
Name of Network Element (device) to discover. Required only
if IP Address or FQDN not specified.
Examples
This example creates a task on the queue to perform a Discover for the device found at the
IP address
10.10.23.4
.
$INCHOME/etc/DiscoverNetElement.sh –u joe –p joepwd –i 10.10.23.4
This example creates a task to perform a Discover for the device with the DNS name
corerouter1.mycompany.com
.
$INCHOME/etc/DiscoverNetElement.sh –u joe –p joepwd –i corerouter1.mycompany.com
This example creates a task to perform a Discover for the Cisco Prime Network Registrar
IPAM network element named
router3
.
$INCHOME/etc/DiscoverNetElement.sh –u joe –p joepwd –n router3
Return codes
If the task is scheduled successfully, an errorlevel of 0 is passed, along with a string
including the task number. That task number can then be passed to the
TaskStatus
CLI
to obtain the status of that task.