All MIBs › CISCO-SM-FILE-DOWNLOAD-MIB › csDefineFileStatus
csDefineFileStatus
Module: CISCO-SM-FILE-DOWNLOAD-MIB
OID (symbolic): CISCO-SM-FILE-DOWNLOAD-MIB::csDefineFileStatus
OID (numeric): 1.3.6.1.4.1.9.9.199.1.1.1.1.4
Node type: OBJECT-TYPE
Type: INTEGER
Access: read-only
Description: The overall status of the file validation and service module download as surmised by the controller card. A more detailed status on service module downloads could be obtained in csFileStatusTable which stores download information specific to a particular slot.
inProgress - processing file validation/download request success - file has been validated and downloaded to all applicable service modules (as per value in csDefineSlotNumber) successfully. noMemory - failure due to insufficient dynamic memory fileOpenFailed - failure to open the file downloaded to some non-volatile storage on the controller card. fileReadFailed - failure to read the file downloaded to some non-volatile storage on the controller card. fileNotValid - file parsing/validation failed downloadFailed - download to service module failed aborted - download aborted due to switchover in a redundant controller card configuration dbUpdateFailed - error in accessing/updating the database miscError - miscellaneous error due to lack of internal resource (eg. error obtaining semaphore etc)
This object is valid only after the entry status becomes 'active'.
This object is especially useful when csDefineSlotNumber has a value of 100 signifying a download to all applicable service modules. This object gives overall status of the download request and hence, has a value of 'downloadFailed' even if one SM fails the download. csFileStatusTable could be consulted for the purpose of obtaining a list of SMs that failed the download and their corresponding reasons.
What is csDefineFileStatus?
This object is the overall status, such as inProgress, success, noMemory, fileOpenFailed, or downloadFailed, of the most recent file validation and download operation as tracked by the controller card, with per-slot detail available in a separate table. This is the field an automation script polls after triggering a download to know when it is safe to consider the operation finished, and its specific failure values point to different root causes without needing to dig into the per-slot table first. Seeing this return noMemory(3) after a download attempt means the controller card itself ran out of storage or RAM to hold the file, a different problem than fileReadFailed(5), which would instead point to an issue reading the source file itself.
Examples
Walk all instances (SNMPv2c):
snmpwalk -v2c -c public <target> 1.3.6.1.4.1.9.9.199.1.1.1.1.4 snmpwalk -v2c -c public <target> CISCO-SM-FILE-DOWNLOAD-MIB::csDefineFileStatus
Get a specific instance (index 1):
snmpget -v2c -c public <target> 1.3.6.1.4.1.9.9.199.1.1.1.1.4.1 snmpget -v2c -c public <target> CISCO-SM-FILE-DOWNLOAD-MIB::csDefineFileStatus.1
Start monitoring Cisco modular chassis with service modules with a free 30-day trial of IPNetwork Monitor. Create custom SNMP monitor using the CISCO-SM-FILE-DOWNLOAD-MIB::csDefineFileStatus OID value, configure state conditions and alerts, and monitor any Cisco modular chassis with service modules from a single console.
OID Breakdown
Upper-level ancestors (8 from the standard OID tree / other modules)
| Numeric OID | Name | Module |
|---|---|---|
| 1 | iso | LANART-AGENT |
| 1.3 | org | AirPair-MIB |
| 1.3.6 | dod | AirPair-MIB |
| 1.3.6.1 | internet | AirPair-MIB |
| 1.3.6.1.4 | private | AirPair-MIB |
| 1.3.6.1.4.1 | enterprises | AirPair-MIB |
| 1.3.6.1.4.1.9 | cisco | CAT2600-MIB |
| 1.3.6.1.4.1.9.9 | ciscoMgmt | CISCO-SMI |
| Numeric OID | Name | Module |
|---|---|---|
| 1.3.6.1.4.1.9.9.199 | ciscoSmFileDownloadMIB | CISCO-SM-FILE-DOWNLOAD-MIB |
| 1.3.6.1.4.1.9.9.199.1 | csFileMIBObjects | CISCO-SM-FILE-DOWNLOAD-MIB |
| 1.3.6.1.4.1.9.9.199.1.1 | csDefineFile | CISCO-SM-FILE-DOWNLOAD-MIB |
| 1.3.6.1.4.1.9.9.199.1.1.1 | csDefineFileTable | CISCO-SM-FILE-DOWNLOAD-MIB |
| 1.3.6.1.4.1.9.9.199.1.1.1.1 | csDefineFileEntry | CISCO-SM-FILE-DOWNLOAD-MIB |
| 1.3.6.1.4.1.9.9.199.1.1.1.1.4 | csDefineFileStatus | CISCO-SM-FILE-DOWNLOAD-MIB |