Use the Command Line feature to Import Devices .
See Setting the Number of Devices before you begin this task.
To import devices,
-
Go to Accessing the Command Line Interface if you have not already done so.
-
Here is the import devices command format you need to enter. importDevices <network name> <device server name> devicesCSVFile <updateFlag>
-
Make sure the format and syntax is entered at the cmd > prompt, exactly as shown in the example.
cmd> importDevices Network1 DeviceServer1 devices.csv false
The input file names should be quoted only if the file name contains special characters - this applies to various commands.
Note: You do not have to enter the Credential Name or the Device Name using double quotes inside the file. The different values need only to be separated by a comma.NOTES:
-
hostfile names
-
The hostfile format is the following:
(Single-Level Mode)
#IP Address, HostName, DeviceAlias,DevicePkg,InMech,InAcct,In-Snmp,In-CTMech,InCutCre,OOBMech,OOBCre,OOBCTMec,OOBCTCre,OOBDS,OOBP,PP Field,PP Field,PP Field,PP Field
172.18.20.3,Test1-Device1,TestAliasName,1,SNMP / TFTP,global:Cisco-Account,global:Cust1,Telnet,global:Cisco-Account,global:r2511,global:Cisco-Account,global:rlocal,global:Cisco-Account,972,1112,PPIBP:global:ciscop,PPIBC:global:level14,PPOBP:global:level11,PPOBC:global:level12, SNMPV2:global:Cust1,SNMPV3:global:testuser,SNMPPORT:162,ACTIVESNMPVERSI
ON:v1
Notice PP information has been added after the 15th column and has to be qualified with either (in Normal Mode : 4 new entries):
[PPIBP|PPIBC|PPOBP|PPOBC]::<global/network>:<pp cred>
Note: Privilege Password values.The last 4 fields in the CSV are for Priv Pass credentials. They each require a prefix to define which Priv Pass you are setting. The prefixes are:
-
"PPIBP:" aka. Priv Pass In-Band Primary management
-
"PPIBC:" aka. Priv Pass In-Band Cut-thru
-
"PPOBP:" aka. Priv Pass Out-of-Band Primary management
-
"PPOBC:" aka Priv Pass Out-of-Band Cut-thru
(Multi-Level Mode) - (requires each priv pass to be appended with @<level> : up to 15 new privlevel entries)
#IPAddress,HostName,DeviceAlias,DevicePkg,InMech,InAcct,In-Snmp,In-CTMech,InCutCre,OOBMech,OOBCre,OOBCTMec,OOBCTCre,OOBDS,OOBP,PP Field,PP Field,PP Field,PP Field
172.18.20.3,Test1-Device1,TestAliasName,1,SNMP / TFTP,global:Cisco-Account,global:Cust1,Telnet,global:Cisco-Account,global:r2511,global:Cisco-Account,global:rlocal,global:Cisco-Account,972,1112,PPLEV:global:ciscop@15,PPLEV:global:level14@14,PPLEV:global:level11@11,PPLEV:global:level12@11, SNMPV2:global:Cust1,SNMPV3:global:testuser,SNMPPORT:162,ACTIVESNMPVERSI
ON:v1
Notice format : PPLEV:<global>:<ppcred>@<level>
Note: For SNMPv3 Credentials there is no change in command but the .csv format should indicate v2 ,v3 ,snmpport , snmpactiveversion params with qualifiers in the above example. These parameters must be added to the end of the .csv record for the specific device.
-
These field names are mandatory in the input deviceCSVfile.
-
IP Address
-
HostName
-
DevicePkg
-
A combination of ip address and hostname is used to check for uniqueness.
-
All the field names can be updated except "Hostname" as it is the key in the CSV data input file for updates.
-
The remaining are optional. These include, InMech,InAcct,In-Snmp,In-CTMech,InCutCre,OOBMech,OOBCre,OOBCTMec,OOBCTCre,OOBDS,OOBP
-
UpdateFlag
-
false - to create new devices
-
true - to update existing credentials
What each column represents:
Valid Package Numbers are:
-
-
Press Enter.
-
In a separate telnet window, verify your command results by entering change directory (cd) to $VOYENCE_HOME /logs, then pressing Enter. The log file to review is commandLineUtil.log. You can also go to the System Administration screens (in Network Configuration Manager) to verify that the devices have been imported.
-
If you have completed importing devices, and no further actions are needed, enter quit at the command line, then press Enter. You are now logged off of Network Configuration Manager.
| Column Number |
Field Name |
Required/Optional |
Valid Values |
| 1 |
IP Address - The IP Address of the Device |
Required |
|
| 2 |
HostName - The Hostname of the Device |
Required |
|
| 3 |
DeviceAlias - The Device Alias name |
Optional |
|
| 4 |
DevicePkg - The name of the Device Package |
Required |
Valid Package Number |
| 5 |
InMech - The In-Band Management Mechanism (Telnet/SSH for example) |
Optional |
SNMP/TFTP, TELNET, SSH, TELNET/TFTP, SSH/SCP |
| 6 |
InAcct - The In-Band Account Credential name |
Optional |
Valid Account Name |
| 7 |
In-Snmp - The In-Band SNMP Credential name |
Optional |
Valid SNMP Credential Name |
| 8 |
In-CTMech - The In-Band Cut-Through Mechanism (Telnet/SSH for example)- |
Optional |
SSH, TELNET |
| 9 |
In-CutCre - The In-Band Cut-Through Credential name |
Optional |
Valid Account Credential |
| 10 |
OOBMECH - The Out-of-Band Management Mechanism |
Optional |
Out-of-Band Server Name |
| 11 |
OOB CRED - The Out-of-Band Management Credential |
Optional |
Valid Account Credential |
| 12 |
OOBCTMec - The Out-of-Band Cut-Through Mechanism name |
Optional |
Out-of-Band Server Name |
| 13 |
OOBCTCRre - The Out-of-Band Cut-Through Credential name |
Optional |
Valid Account Credential |
| 14 |
OOBDS - The Out-of-Band Dial String name |
Optional |
Any String |
| 15 |
OOBP - The Out-of-Band Port name |
Optional |
Number |
| 16 |
PP Field In-band Management |
Optional |
Privilege Password Name |
| 17 |
PP Field – In-band cut-thro - Privilege Password field In-Band Cut-thro |
Optional |
Privilege Password Name |
| 18 |
PP Field – OOB Mgmt - Privilege Password field Out-of-Band Management |
Optional |
Privilege Password Name |
| 19 |
PP Field – OOB Cut-thro - Privilege Password Filed - Out-of-Band Cut-through |
Optional |
Privilege Password Name |
| Package ID |
Package Name |
| 1220 |
3Comm NetBuilder II |
| 19 |
Adtran NetVanta |
| 18 |
Adtran NetVanta Switch |
| 1007 |
Airespace Wireless Switch |
| 14 |
Alcatel OmniCore 5000 |
| 45 |
Nortel Alteon |
| 42 |
Nortel Router |
| 25 |
Aruba Wireless Switch |
| 40 |
Nortel Baystack |
| 41 |
Nortel BPS2000 |
| 15 |
Cisco Aironet AP |
| 16 |
Cisco Aironet AP CXWorks |
| 17 |
Cisco Aironet Bridge |
| 2 |
Cisco CATOS Switch |
| 1004 |
Cisco Content Switch |
| 24 |
Cisco ISO Layer 3 Switch |
| 1 |
Cisco ISO Router |
| 2 |
Cisco IOS Switch |
| 4 |
Cisco Lightstream ATM Switch |
| 10 |
Cisco PIX |
| 11 |
Cisco VPN Concentrator 3000 |
| 1000 |
Checkpoint Firewall |
| 1203 |
Ericsson MSED |
| 13 |
Extreme Switch |
| 1006 |
F5 Load Balancer Rev |
| 1001 |
F5 Load Balancer |
| 1008 |
Foundry |
| 2000 |
Generic Cisco REM Device |
