CISCO-FTP-CLIENT-MIB

All MIBs › CISCO-FTP-CLIENT-MIB

Organization: Cisco Systems, Inc.

Last Updated: 2006-03-31

Category: Cisco Devices, Device Management

Description: Provides management objects for initiating and monitoring FTP file transfers from Cisco devices for configuration and image management.

Start monitoring vendor-neutral, standards-based MIB, any SNMPv3-capable network device (SNMP engine identity/boot/clock status) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

What Is CISCO-FTP-CLIENT-MIB?

CISCO-FTP-CLIENT-MIB is a Cisco-specific MIB that lets an SNMP manager initiate and monitor FTP file transfer operations directly from a Cisco device, typically used for uploading/downloading configuration files or IOS images. It exposes both global counters for outstanding and historical FTP requests and a per-request table describing the operation type, local/remote filenames, target server, and user credentials context of each transfer. It is a software-operation-status MIB: it reports whether config/image transfer jobs are succeeding, queued, or being rejected due to load, which is directly useful for confirming that automated backup or firmware push jobs completed. It has no significant dependency on external IETF MIBs beyond standard SNMPv2 conventions, being a self-contained Cisco management extension. It is typically used in network management systems that automate configuration backup or software image distribution to Cisco routers and switches via FTP. Engineers can download the CISCO-FTP-CLIENT-MIB file directly to load it into their MIB browser.

IPNetwork Monitor allows you to monitor SNMP objects defined in CISCO-FTP-CLIENT-MIB. Use the built-in SNMP Monitoring Browser to explore available variables, view their current values and descriptions, and select the objects you want to monitor. You can then create SNMP monitors, configure thresholds, and receive alerts when monitored values change.

Supported Devices

vendor-neutral in principle but implemented on Cisco IOS/IOS-XE routers and switches

Monitoring Examples

An admin can poll cfcRequests against cfcRequestMaximum to see how close the device is to its concurrent FTP request limit, and check cfcRequestsBumped to see whether new transfer requests are being rejected due to overload. Inspecting cfcRequestTable/cfcRequestEntry for a specific cfcRequestIndex shows cfcRequestOperation, cfcRequestServer, and cfcRequestRemoteFile, letting the admin confirm a scheduled config backup or image download is targeting the correct server and file.

What Can Be Monitored

number of active FTP requests
maximum/high-water request count
bumped (rejected) requests
request operation type (get/put)
target server and remote/local filename

Imported Objects

From CISCO-SMI

ciscoMgmt

OBJECT-IDENTITY

From SNMPv2-CONF

MODULE-COMPLIANCE
OBJECT-GROUP

From SNMPv2-SMI

Counter32
Gauge32
MODULE-IDENTITY
OBJECT-TYPE
Unsigned32

From SNMPv2-TC

DisplayString
RowStatus
TimeStamp

How to Use in IPNetwork Monitor

Example using cfcRequestsBumped OID:

Select a Cisco IOS/IOS-XE router or switch (FTP client) as the target host to create a monitor — the SNMP service should be up and running on it. Click New Monitor, then check SNMP Custom on the Favorites tab, click Next, and confirm the host. On the next page, click Select... to open the built-in SNMP MIB Browser and type cfcRequestsBumped into the Find box to locate it in the OID tree, then select it and click OK. The number of requests in cfcRequestTable that were bumped out to make room for a new request. On the monitor's Main parameters page you can set the target's SNMP port (default 161), credentials, polling interval, and other settings — see the SNMP Monitor help for details. On the State conditions and Alerting tabs, configure when the monitor should change state and trigger an alert; since this is a Counter32-type OID, Value bounds is the most useful condition here — trigger an alert if the counter increases sharply between polls relative to its normal baseline, since an unexpected spike often reflects a real change in traffic or activity. Click Finish to create the monitor; you can adjust any parameter later.

OIDs

OID symbolic	OID numeric	Type	Access	Description
ciscoFtpClientMIB	1.3.6.1.4.1.9.9.80			The MIB module for invoking Internet File Transfer Protocol (FTP) operations for network management purposes.
ciscoFtpClientMIBObjects	1.3.6.1.4.1.9.9.80.1
cfcRequest	1.3.6.1.4.1.9.9.80.1.1
U32 cfcRequestMaximum	1.3.6.1.4.1.9.9.80.1.1.1	Unsigned32	read-write	The maximum number of requests this system can hold in cfcRequestTable. A value of 0 indicates no configured limit. This object may be read-only on some systems. When an attempt is made to create a new entry but the table is full, the oldest completed entry is bumped out and cfcRequestsBumped is incremented. Changing this number does not disturb existing requests that are not completed and bumps completed requests as necessary.
G32 cfcRequests	1.3.6.1.4.1.9.9.80.1.1.2	Gauge32	read-only	The current number of requests in cfcRequestTable.
G32 cfcRequestsHigh	1.3.6.1.4.1.9.9.80.1.1.3	Gauge32	read-only	The highest number of requests in cfcRequestTable since this system was last initialized.
C32 cfcRequestsBumpedEx	1.3.6.1.4.1.9.9.80.1.1.4	Counter32	read-only	The number of requests in cfcRequestTable that were bumped out to make room for a new request.
cfcRequestTable	1.3.6.1.4.1.9.9.80.1.1.5		not-accessible	A table of FTP client requests.
cfcRequestEntry	1.3.6.1.4.1.9.9.80.1.1.5.1		not-accessible	Information about an FTP client request. Management applications use cfcRequestEntryStatus to control entry modification, creation, and deletion. Setting cfcRequestEntryStatus to 'active' from any state including 'active' causes the operation to be started. The entry may be modified only when cfcRequestOperationState is 'stopped'. The value of cfcRequestEntryStatus may be set to 'destroy' at any time. Doing so will abort a running request. Entries may not be created without explicitly setting cfcRequestEntryStatus to either 'createAndGo' or 'createAndWait'.
U32 cfcRequestIndex	1.3.6.1.4.1.9.9.80.1.1.5.1.1	Unsigned32	not-accessible	An arbitrary integer to uniquely identify this entry. To create an entry a management application should pick a random number.
INT cfcRequestOperation	1.3.6.1.4.1.9.9.80.1.1.5.1.2	INTEGER	read-create	The FTP operation to be performed.
STR cfcRequestLocalFile	1.3.6.1.4.1.9.9.80.1.1.5.1.3	DisplayString	read-create	The local file on which the operation is to be performed.
STR cfcRequestRemoteFile	1.3.6.1.4.1.9.9.80.1.1.5.1.4	DisplayString	read-create	The remote file on which the operation is to be performed.
STR cfcRequestServer	1.3.6.1.4.1.9.9.80.1.1.5.1.5	DisplayString	read-create	The domain name or IP address of the FTP server to use.
STR cfcRequestUser	1.3.6.1.4.1.9.9.80.1.1.5.1.6	DisplayString	read-create	The user name to use at the FTP server.
STR cfcRequestPassword	1.3.6.1.4.1.9.9.80.1.1.5.1.7	DisplayString	read-create	The password to use at the FTP server. When read this object always returns a zero-length string.
INT cfcRequestResult	1.3.6.1.4.1.9.9.80.1.1.5.1.8	INTEGER	read-only	The result of the FTP operation.
TIM cfcRequestCompletionTime	1.3.6.1.4.1.9.9.80.1.1.5.1.9	TimeStamp	read-only	The value of sysUpTime when the operation completed. For an incomplete operation this value is zero.
INT cfcRequestStop	1.3.6.1.4.1.9.9.80.1.1.5.1.10	INTEGER	read-create	The action control to stop a running request. Setting this to 'stop' will begin the process of stopping the request. Setting it to 'ready' or setting it to 'stop' more than once have no effect. When read this object always returns ready.
INT cfcRequestOperationState	1.3.6.1.4.1.9.9.80.1.1.5.1.11	INTEGER	read-only	The operational state of the file transfer. To short-terminate the transfer set cfcRequestStop to 'stop'.
ROW cfcRequestEntryStatus	1.3.6.1.4.1.9.9.80.1.1.5.1.12	RowStatus	read-create	The control that allows modification, creation, and deletion of entries. For detailed rules see the DESCRIPTION for cfcRequestEntry.
ciscoFtpClientMIBConformance	1.3.6.1.4.1.9.9.80.3
ciscoFtpClientMIBCompliances	1.3.6.1.4.1.9.9.80.3.1
ciscoFtpClientMIBCompliance	1.3.6.1.4.1.9.9.80.3.1.1			The compliance statement for entities which implement the Cisco FTP Client MIB. Implementation of this MIB is based on individual product needs.
ciscoFtpClientMIBGroups	1.3.6.1.4.1.9.9.80.3.2
ciscoFtpClientRequestGroup	1.3.6.1.4.1.9.9.80.3.2.1			FTP client request management.

RFC description

FTP client operations for network management purposes on Cisco devices.

Start monitoring Cisco IOS/IOS-XE routers and switches (FTP client) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

Download CISCO-FTP-CLIENT-MIB