Image and configuration file download and upload
The following objects manage file downloads and uploads. They are available in all devices.
When uploading or downloading configuration files to and from the TFTP server using SNMP, check for the following:
- If the SNMP password check is enabled on the device, the object must be sent with
the following information in the same PDU as the TFTP objects:
- If AAA is used for SNMP authentication and the authentication method is enable or line, then the value of snAgGlbPassword must be in cleartext format.
- If AAA is used for SNMP authentication and the authentication method is local, RADIUS, Telnet, TACACS, or TACACS+, then the value of snAgGlbPassword must be in the user password format. The space between user and password is the delimiter.
- If AAA is not used for authentication, then the value of snAgGlbPassword for the enable password must be in cleartext format.
- Make sure that the user has administrative access (privilege=0) on the device; otherwise, the user will not be able to upload files to the TFTP server.
Name, OID, and syntax |
Access |
Description |
|---|---|---|
snAgImgFname 1.3.6.1.4.1.1991.1.1.2.1.6 Syntax: DisplayString |
Read-write |
Shows the name of the image file, including path, that is currently associated with the system. When the object is not used, the value is blank. It can have up to 32 characters. |
snAgImgLoad 1.3.6.1.4.1.1991.1.1.2.1.7 Syntax: Integer |
Read-write |
Downloads or uploads a new software image to the agent. Use one of the following values in an SNMP set:
|
The following messages may be displayed:
|
||
snAgCfgFname 1.3.6.1.4.1.1991.1.1.2.1.8 Syntax: DisplayString |
Read-write |
Shows the name of the configuration file, including its path, currently associated with the system. If there are multiple configuration files, the names are separated by semicolons (;). This object can have up to 32 characters. |
snAgCfgLoad 1.3.6.1.4.1.1991.1.1.2.1.9 Syntax: Integer |
Read-write |
Downloads or uploads a configuration file to the agent. Use one of the following values for an SNMP set:
|
The following values may be read:
The objects Image and configuration file download and upload and “snAgTftpServerIp” are required to allow the download or upload process to occur. No write requests is allowed while a download or upload process is in progress. The snAgCfgEosTable objects must be sent along in one PDU for network management systems to recognize values from (24) to (27). Note: The
snAgTftpServerIp object is deprecated by the
snAgTftpServerAddrType object and the snAgTftpServerAddr object
supports both IPv4 and IPv6.
|
||
snAgTftpServerAddrType 1.3.6.1.4.1.1991.1.1.2.1.65 Syntax: IpAddress |
Read-write |
Shows the TFTP server IP address type. The supported address types are ipv4(1) and ipv6(2). The default address type is ipv4(1). |
snAgTftpServerAddr 1.3.6.1.4.1.1991.1.1.2.1.66 Syntax: DisplayString |
Read-write |
Shows the TFTP server IP address. |
snAgGblEnableTelnetAuthentication 1.3.6.1.4.1.1991.1.1.2.1.69 Syntax: Integer |
Read-write |
Default is disabled. |
| snAgEraseConfig 1.3.6.1.4.1.1991.1.1.2.1.72 Syntax: Integer { normal(1), error(2), erase(3), erasing(4), busy(5) } |
Read-write |
Action object to erase start-up configuration from the flash. The following values can only be read: normal(1) error(2) - operation failed or bad flash erasing(4) - agent is erasing from the flash busy(5) - operation not allowed at this time, flash is busy. The following value can be written: erase(3) - do erase The agent will return a response even before the erase is done and the read value will be erasing until erase is done. Also, the erase request will be rejected until error or normal. |
| snAgSaveConfig 1.3.6.1.4.1.1991.1.1.2.1.73 Syntax: Integer { normal(1), error(2), write(3), writing(4), busy(5) } |
Read-write |
Action object to save all configuration information to the flash. The following values can only be read: normal(1) error(2) - operation failed or bad flash writing(4) - agent is writing into the flash busy(5) - operation not allowed at this time, flash is busy. The following value can be written: write(3) - do write The agent will return a response even before the write is done. The read value will be writing until write is done. The write request will be rejected until error or normal. |