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
Net-SNMP examples
How SNMP and these commands workScalars 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.