Cisco Cisco Prime Network Registrar 8.1 Technical References

Page of 316
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>) 
[-?] 
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>) [-?] 
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>) [-?] 
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.