atFilev2CopyBegin

AT-FILEv2-MIB · allied-old variant · .1.3.6.1.4.1.207.8.4.4.4.600.3.7

Object

scalar r/w OctetString
A read on this object can return several possible values,
depending on the current status of the system and the
various file operation objects:
          
idle                               There is no file operation
                                   in progress and all required
                                   objects have been set
                                   correctly. Setting a '1' to
                                   this object will begin the
                                   file copy.
          
Error codes: [1-7]                 A copy operation cannot be
                                   started until these errors
                                   are resolved. See below for
                                   key.
          
[action]ing x [--> y]              A file operation is
                                   currently in progress. You
                                   cannot start another
                                   operation while the object
                                   is returning this value.
          
[action] x [--> y] success         The last copy, move or
                                   delete operation was 
                                   successfully completed.
          
[action] x [--> y] failure: [err]  The last copy, move or
                                   delete operation failed, 
                                   with the error message
                                   attached. Common failures 
                                   include lack of space on the
                                   destination file system,
                                   incorrect source file names
                                   or communication errors with
                                   remote services.
          
Upon reading a success or failure message, the message will be
cleared and the next read will result in either an 'idle'
message or an 'Error codes' message if not all required objects
have been correctly set. If the read returned 'idle', a new
file operation can now be started.
          
          
Error codes for file copy:
          
1 - atFilev2SourceDevice has not been set
2 - atFilev2SourceFilename has not been set
3 - atFilev2DestinationDevice has not been set
4 - atFilev2DestinationFilename has not been set
5 - atFilev2SourceDevice and atFilev2DestinationDevice are both
    set to TFTP
6 - the combination of source device, stackID and filename is
    the same as the destination device, stackID and filename
    (i.e. it is not valid to copy a file onto itself.
7 - TFTP IP address has not been set and TFTP has been set for
    one of the devices
          
Provided all above requirements are met, immediately upon
executing the SNMP set, the device will indicate that it was a
success. The actual file copy itself will be started and
continue on the device until it has completed. For large files,
operations can take several minutes to complete.
          
Subsequent reads of the object will return one of messages
shown in the first table, to allow for tracking of the progress
of the copy operation.

Context

MIB
AT-FILEv2-MIB
OID
.1.3.6.1.4.1.207.8.4.4.4.600.3.7
Type
scalar
Access
readwrite
Status
current
Parent
atFilev2FileOperation

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

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

Syntax

OctetString

Values & Constraints

No enumerated values or constraints recorded.