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.
Note: An atomic set of snAgImgLoad, snAgImgFname, snAgTftpServerAddrType and snAgTftpServerAddr is required for a successful download or upload.

Name, OID, and syntax

Access

Description

snAgImgFname

brcdIp.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

brcdIp.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:

  • uploadMPPrimary(19) - Uploads the primary image from the management processor flash memory to the TFTP server.
  • downloadMPPrimary(20) - Downloads the primary image from the TFTP server to management processor flash memory.
  • uploadMPSecondary(21) - Uploads the secondary image from the management processor flash memory to the TFTP server.
  • downloadMPSecondary(22) - Downloads the secondary image from the TFTP server to management processor flash memory.
  • downloadSPPrimary(24) - Downloads the primary image from the TFTP server to secondary processor flash memory.
  • downloadSPSecondary(25) - Downloads the secondary image from the TFTP server to secondary processor flash memory.
  • uploadMPBootROM(26) - Uploads the Boot from the management processor flash memory to the TFTP server.
  • downloadMPBootROM(27) - Downloads the Boot from flash image from the TFTP server to management processor flash memory.
  • uploadMPBootTFTP(28) - Uploads the Boot from TFTP image from management processor flash memory to the TFTP server.
  • downloadMPBootTFTP(29) - Downloads the Boot from TFTP image from the TFTP server to management processor flash memory.
  • uploadMPMonitor(30) - Uploads the Monitor image from management processor flash memory to the TFTP server.
  • downloadMPMonitor(31) - Downloads the Monitor image from the TFTP server to management processor flash memory.
  • downloadSPBootROM(32) - Download the Boot image from the TFTP server to secondary processor flash memory .
  • downloadSPMonitor(33) - Download the monitor image from TFTP server to SP flash.
   

The following messages may be displayed:

  • normal(1)
  • flashPrepareReadFailure(2)
  • flashReadError(3)
  • flashPrepareWriteFailure(4)
  • flashWriteError(5)
  • tftpTimeoutError(6)
  • tftpOutOfBufferSpace(7)
  • tftpBusy(8)
  • tftpRemoteOtherErrors(9)
  • tftpRemoteNoFile(10)
  • tftpRemoteBadAccess(11)
  • tftpRemoteDiskFull(12)
  • tftpRemoteBadOperation(13)
  • tftpRemoteBadId(14)
  • tftpRemoteFileExists(15)
  • tftpRemoteNoUser(16)
  • operationError(17)
  • loading(18) - The operation is in process.
  • uploadMPPrimary(19)
  • downloadMPPrimary(20)
  • uploadMPSecondary(21)
  • downloadMPSecondary(22)
  • tftpWrongFileType(23)
  • downloadSPPrimary(24)
  • downloadSPSecondary(25)
  • uploadMPBootROM(26)
  • downloadMPBootROM(27)
  • uploadMPBootTFTP(28)
  • downloadMPBootTFTP(29)
  • uploadMPMonitor(30)
  • downloadMPMonitor(31)
  • downloadSPBootROM(32)
  • downloadSPMonitor(33)

snAgCfgFname

brcdIp.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

brcdIp.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:

  • uploadFromFlashToServer(20) - Uploads the configuration file from the flash to the TFTP server.
  • downloadToFlashFromServer(21) - Downloads the configuration file from the TFTP server to flash.
  • uploadFromDramToServer(22) - Uploads the configuration file from the DRAM to the TFTP server.
  • downloadToDramFromServer(23) - Downloads the configuration file from the TFTP server to DRAM.
  • uploadFromFlashToNMS(24) - Uploads the configuration file from flash to the network management system.
  • downloadToFlashFromNMS(25) - Downloads the configuration file from the network management system to flash.
  • uploadFromDramToNMS(26) - Uploads the configuration file from DRAM to the network management system.
  • downloadToDramFromNMS(27) - Downloads the configuration file from the network management system to DRAM.
   

The following values may be read:

  • normal(1)
  • flashPrepareReadFailure(2)
  • flashReadError(3)
  • flashPrepareWriteFailure(4)
  • flashWriteError(5)
  • tftpTimeoutError(6)
  • tftpOutOfBufferSpace(7)
  • tftpBusy(8)
  • tftpRemoteOtherErrors(9)
  • tftpRemoteNoFile(10)
  • tftpRemoteBadAccess(11)
  • tftpRemoteDiskFull(12)
  • tftpRemoteBadOperation(13)
  • tftpRemoteBadId(14)
  • tftpRemoteFileExists(15)
  • tftpRemoteNoUser(16)
  • operationError(17)
  • loading(18)
  • tftpWrongFileType(29)
  • operationDoneWithNMS(28)
  • tftpWrongFileType(29)
  • downloadToDramFromServerOverwrite(30)

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).A separate write memory using the CLI or an SNMP “set snAgWriteNVRAM” is required to save the configuration to NVRAM.

Note: The snAgTftpServerIp object is deprecated by the snAgTftpServerAddrType object and the snAgTftpServerAddr object supports both IPv4 and IPv6.

snAgTftpServerAddrType

brcdIp.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

brcdIp.1.1.2.1.66

Syntax: DisplayString

Read-write

Shows the TFTP server IP address.

snAgGblEnableTelnetAuthentication

brcdIp.1.1.2.1.69

Syntax: Integer

Read-write

Enables or disables telnet authentication in the device.

  • disabled (0)
  • enabled (1)
Default is disabled.