Downloading Files from a File Server to a Switch

This section describes the packets sent when files are downloaded from a file server to a switch.

**Table 1** Downloading files from a file server to a switch
Operation	XPATH
rpc	/huawei-system-load/load-file

Data requirement

**Table 2** Data required during file download from a file server to a switch
Item	Data	Description
File name	test.cc	Indicates the name of a downloaded file.
File type	sys-load:cc-packet	Indicates the type of a downloaded file.
File size	60301028 byte	Indicates the size of a downloaded file.
Authentication mode	sha256	Set the file authentication mode used by the controller.
Verification value of the target file	ff0fd0701a5ab80ee406816be4f8ea4d61c798a7ed503ece6e25f0b569b73369	Set the verification value of the file to be downloaded.
Check code	31688	Indicates the check code used to check a file.
File processing mode	download	Indicates file download.
SFTP server address	192.168.1.5	Indicates the IP address of a file server.
File server directory	/	Indicates the file directory of a file server.
HTTPS server authentication method	none	Indicates that no authentication is required.
HTTPS server port number	18020	Indicates the port number of a file server.

Request example

<?xml version="1.0" encoding="UTF-8"?>
<rpc xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="d05b09cf-309f-11e7-bc35-c5664306265c">
 <sys-load:load-file xmlns:sys-load="urn:huawei:params:xml:ns:yang:huawei-system-load"> 
  <sys-load:loadfile> 
   <sys-load:files> 
    <sys-load:name>test.cc</sys-load:name> 
    <sys-load:file-parameters> 
     <sys-load:type>sys-load:cc-packet</sys-load:type> 
     <sys-load:size>60301028</sys-load:size> 
     <sys-load:checksum>
       <sys-load:digest-algorithm>sha256</sys-load:digest-algorithm>
       <sys-load:digest>ff0fd0701a5ab80ee406816be4f8ea4d61c798a7ed503ece6e25f0b569b73369</sys-load:digest>
    </sys-load:file-parameters> 
    <sys-load:direction>download</sys-load:direction>
    <sys-load:file-load-peers> 
     <sys-load:file-location> 
      <sys-load:fileserver-address>192.168.1.5</sys-load:fileserver-address> 
      <sys-load:file-directory>/</sys-load:file-directory> 
     </sys-load:file-location> 
    </sys-load:file-load-peers> 
    <sys-load:https> 
     <sys-load:authentication-method>none</sys-load:authentication-method>
     <sys-load:port>18020</sys-load:port> 
    </sys-load:https> 
   </sys-load:files> 
  </sys-load:loadfile> 
 </sys-load:load-file> 
</rpc>

Response example

Sample of successful response

<?xml version="1.0" encoding="UTF-8"?> 
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="1001"> 
  <ok/> 
</rpc-reply>

Sample of failed response

<?xml version='1.0' encoding='UTF-8'?>
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="5">
  <rpc-error>
    <error-type>application</error-type>
    <error-tag>operation-failed</error-tag>
    <error-severity>error</error-severity>
    <error-message>parse rpc config error.</error-message>
  </rpc-error>
</rpc-reply>