Executing the Auto-Discovery tool

To execute the Auto-Discovery tool, specify the command appropriate to the operating system you are running.

About this task

The Auto-Discovery tool is available for AIX and Linux, and is executed from the command line. The Auto-Discovery tool is invoked by calling the applicable Auto-Discovery script along with the name of the text file that contains the host names or IP addresses of those devices to be discovered.

The syntax for the executing the Auto-Discovery tool is as follows:

script_name text_file_name.txt

Procedure

To execute the Auto-Discovery tool on Linux or AIX, execute the autodiscover.sh script from the command line and follow it with the name of the text file. For example:

./autodiscover.sh DeviceInfo.txt

Sample output of Auto-Discovery

The following example demonstrates the output expected after the Auto-Discovery tool has been successfully executed.

The following is a sample DeviceInfo.txt file used by the Auto-Discovery tool:

a:cisco
p:cisco
e:cisco
d:./results
r:vmware/Devices
r2501a
r2501b
r2503a
r2503b
r2514a
r2610a
r2610b
r2509a

The output of a successful execution of the autodiscover.sh script and the DeviceInfo.txt file would look like the following:

./autodiscover.sh DeviceInfo.txt

---------------------------------------------------------------------------
Begin Scan :
Device Info File: DeviceInfo.txt
Number Of Threads: 10
Custom Rad: false
TimeOut: 20
---------------------------------------------------------------------------
Attempting Login with the following Account / Password group
***** Using Account: cisco *****
***** Using Password: cisco *****
---------------------------------------------------------------------------
Connected to r2503a
Device VTMOS - Cisco/Router/2500/12.2(1D)
---------------------------------------------------------------------------
Connected to r2514a
Device VTMOS - Cisco/Router/2500/12.1(3)T
---------------------------------------------------------------------------
Connected to r2610a
Device VTMOS - Cisco/Router/2610/12.1(16)
---------------------------------------------------------------------------
Connected to r2501a
Device VTMOS - Cisco/Router/2500/12.1(3)T
---------------------------------------------------------------------------
Connected to r2501b
Device VTMOS - Cisco/Router/2500/12.1(3)T
---------------------------------------------------------------------------
Connected to r2610b
Device VTMOS - Cisco/Router/2610/12.1(16)
---------------------------------------------------------------------------
Connected to r2509a
Device VTMOS - Cisco/Router/2509/12.3(19)
---------------------------------------------------------------------------
Connected to r2503b
Device VTMOS - Cisco/Router/2500/12.0(4)
---------------------------------------------------------------------------
Finished Scan - Date: 20070903

To view the results files created as part of the execution, see the results file located in the ./results/ directory. The results file produced for the bulkimport utility would look as follows:

#realm, hostname, vendor, type, model, os,*"com-type,ssh type,streaming,
username,password,enable-password,alt-hostname,port"
vmware/Devices,r2503a,Cisco,Router,2500,12.2(1D)
vmware/Devices,r2514a,Cisco,Router,2500,12.1(3)T
vmware/Devices,r2610a,Cisco,Router,2610,12.1(16)
vmware/Devices,r2610b,Cisco,Router,2610,12.1(16)
vmware/Devices,r2501a,Cisco,Router,2500,12.1(3)T
vmware/Devices,r2501b,Cisco,Router,2500,12.1(3)T
vmware/Devices,r2509a,Cisco,Router,2509,12.3(19)
vmware/Devices,r2503b,Cisco,Router,2500,12.0(4)

Note: It is a requirement that a Resource Access Document (RAD) is created or exists in the destination realm prior to the use of the Bulkload.csv by the Bulkload utility.

The RAD specifies the method by which the devices are communicated via (ssh or telnet), and in addition the credentials used by the Bulkload utility to interact with the device.

What to do next

The Auto-Discovery script that executes the Auto-Discovery tool requires a text file with any name and an extension of .txt. For the purposes of illustrating the contents of this text file, subsequent examples use a text file called DeviceInfo.txt. The text file that you supply to the Auto-Discovery script is integral in establishing logon connections to the network devices in a realm.

For more information on the DeviceInfo.txt file, see Deviceinfo.txt syntax.