Skip to main content
Cisco SD-WAN
Support
Product Documentation
Viptela Documentation

request device-upload

request device—Add vEdge router chassis numbers by uploading a file that contains the device information onto the vBond orchestrator that is acting as a ZTP server.

Command Syntax

request device-upload chassis-file file-path [vpn vpn-id]

Options

Filename
chassis-file file-paht
Name of a CSV file containing the chassis information required by the ZTP server. filename can be on the local device or an HTTP, FTP, or TFTP path to a remote server.  file-path can be one of the following:
• filename—Path to a file in your home directory on the local Viptela device.
• ftp:file-path—Path to a file on an FTP server.
• http://url/file-path—Path to a file on a webserver.
• scp:user@host:file-path
• tftp:file-path—Path to a file on a TFTP server.
Each row in the CSV file must contain the following information for each vEdge router:
• Chassis number
• Serial number
• Validity (either valid or invalid)
• vBond IP address
• vBond port number (entering a value is optional)
• Organization name
• Path to the root certification (entering a value is optional)
VPN
vpn vpn-id
VPN in which the remote server is located.

Output Fields

The output fields are self-explanatory.

Example Output

The following example uploads the device information from the local router. Here, the root CA path is omitted, but the comma preceding its value is required.

vBond# vshell
vm4vBond~$ cat ztp-chassis-file
12345,6789,valid,10.1.14.1,12345,viptela,
vBond:~$ exit
exit
vBond request device-upload chassis-file /home/admin/ztp-chassis-file
Uploading chassis numbers via VPN 0
Copying ... /home/admin/ztp-chassis-file via VPN 0
Successfully loaded the chassis numbers file to the database.

Uploading the serial numbers to the vedge-list ...
Uploading serial numbers via VPN 0
Copying ... /home/admin/vedge_serial_entries via VPN 0
Successfully loaded the vEdge serial numbers
vBond# show ztp entries
                                                                  ROOT  
       CHASSIS  SERIAL                       VBOND  ORGANIZATION  CERT  
INDEX  NUMBER   NUMBER  VALIDITY  VBOND IP   PORT   NAME          PATH  
------------------------------------------------------------------------
1      12345    6789    valid     10.1.14.1  12345  viptela             

Release Information

Command introduced in Viptela Software Release 14.3.

Additional Information

request device
show ztp entries

  • Was this article helpful?