ons15501SysSwDownload

ONS15501-MIB · .1.3.6.1.4.1.1869.11.11.1.4
Commands MIB view Table view

Object

scalar r/w SNMPv2-TCDisplayString 
Used to control the image download to the flash banks.
NOTE: Read on this attribute returns the last t/ftp command,
      without login/password.
      For s/w release 4.0 and above, the value read back
      includes the Kilo-Bytes downloaded for last download
      command.
      It is the size of file downloaded (in KB), if the
      download has completed. If a download is in progress
      this value would correspond to Kilo-Bytes successfully 
      downloaded so far.
          
For set the string syntax is one of the following
a. abort
    - Aborts the current download
b. ftp:<svr-IP>:<login>:<pass>:<path>:<fName>:<flash#>[:passive]
    - Download image using ftp
c. tftp:<srvr-IP>:<fName>:<flashNo>
    - Download image using tftp
          
where 
  <svr-IP>  - is t/ftp server name
          
  <login>   - is login to be used for ftp (default anonymous)
          
  <pass>    - password for the login name for ftp
		 (default - no passwd - passwd is empty string)
          
  <path>    - path to be given on ftp prompt for cd
		 (default - skip cd command )
          
  <fName>   - name of the file to be downloaded and burnt
		to the flash - NO DEFAULTS - because the
		filename is used as distinguishing versions
		there are no defaults for this command.
		For TFTP Path information is part of the filename
          
  <flash#>  - which flash has to be burnt [1|2|3]
		NOTE: Burn to active bank fails
          
  passive   - if `passive` is specified, ftp is done using
	      passive mode (provided for FTP download across
	      firewall).
          
  NOTE: None of the fields should contain ':' within them, as
	    it is used as field separator.

Context

MIB
ONS15501-MIB
OID
.1.3.6.1.4.1.1869.11.11.1.4
Type
scalar
Access
readwrite
Status
current
Parent
ons15501Sys
Groups
2

Net-SNMP examples

How SNMP and these commands work

Scalars have one instance, identified by the .0 suffix.

Read the scalar instance
/usr/bin/snmpget -v2c -c '<community>' -Pud -Ir -OQUv -m 'ONS15501-MIB' -M '/opt/observium/mibs/cisco:/opt/observium/mibs/rfc:/opt/observium/mibs/net-snmp' 'udp:<hostname>:161' 'ONS15501-MIB::ons15501SysSwDownload.0'
More examples
Translate to a numeric OID
/usr/bin/snmptranslate -Pud -Ir -On -m 'ONS15501-MIB' -M '/opt/observium/mibs/cisco:/opt/observium/mibs/rfc:/opt/observium/mibs/net-snmp' 'ONS15501-MIB::ons15501SysSwDownload'

Syntax

SNMPv2-TCDisplayString
Source
SNMPv2-TCDisplayString
Base type
OctetString
Display format
255a
Type Description
Represents textual information taken from the NVT ASCII
          
character set, as defined in pages 4, 10-11 of RFC 854.
          
To summarize RFC 854, the NVT ASCII repertoire specifies:
          
  - the use of character codes 0-127 (decimal)
          
  - the graphics characters (32-126) are interpreted as
    US ASCII
          
  - NUL, LF, CR, BEL, BS, HT, VT and FF have the special
    meanings specified in RFC 854
          
  - the other 25 codes have no standard interpretation
          
  - the sequence 'CR LF' means newline
          
  - the sequence 'CR NUL' means carriage-return
          
  - an 'LF' not preceded by a 'CR' means moving to the
    same column on the next line.
          
  - the sequence 'CR x' for any x other than LF or NUL is
    illegal.  (Note that this also means that a string may
    end with either 'CR LF' or 'CR NUL', but not with CR.)
          
Any object defined using this syntax may not exceed 255
characters in length.

Values & Constraints

Type Constraints
range: 0..255

Conformance

Member of
ons15501SysInfoGroup ons15501SysInfoGroup2