Table Of Contents
Logging to Local Nonvolatile Storage (ATA Disk)
Prerequisites for Logging to Local Nonvolatile Storage (ATA Disk)
Restrictions for Logging to Local Nonvolatile Storage (ATA Disk)
Information About Logging to Local Nonvolatile Storage (ATA Disk)
How to Configure Logging to Local Nonvolatile Storage (ATA Disk)
Writing Logging Messages to an ATA Disk
Copying Logging Messages to an External Disk
Configuration Examples for Logging to Local Nonvolatile Storage (ATA Disk)
Writing Logging Messages to an ATA Disk: Example
Copying Logging Messages to an External Disk: Example
Feature Information for Logging to Local Nonvolatile Storage (ATA Disk)
Logging to Local Nonvolatile Storage (ATA Disk)
First Published: August 26, 2003Last Updated: June 28, 2007The Logging to Local Nonvolatile Storage (ATA Disk) feature enables system logging messages to be saved on an advanced technology attachment (ATA) flash disk. Messages saved on an ATA drive persist after a router is rebooted.
Finding Feature Information in This Module
Your Cisco IOS software release may not support all of the features documented in this module. To reach links to specific feature documentation in this module and to see a list of the releases in which each feature is supported, use the "Feature Information for Logging to Local Nonvolatile Storage (ATA Disk)" section.
Finding Support Information for Platforms and Cisco IOS and Catalyst OS Software Images
Use Cisco Feature Navigator to find information about platform support and Cisco IOS and Catalyst OS software image support. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account on Cisco.com is not required.
Contents
•Restrictions for Logging to Local Nonvolatile Storage (ATA Disk)
•Information About Logging to Local Nonvolatile Storage (ATA Disk)
•How to Configure Logging to Local Nonvolatile Storage (ATA Disk)
•Configuration Examples for Logging to Local Nonvolatile Storage (ATA Disk)
•Feature Information for Logging to Local Nonvolatile Storage (ATA Disk)
Prerequisites for Logging to Local Nonvolatile Storage (ATA Disk)
The logging buffered Command Must Be Enabled
Before the Logging to Local Nonvolatile Storage (ATA Disk) feature can be enabled with the logging persistent command, you must enable the logging of messages to an internal buffer with the logging buffered command. For additional information, refer to the "Writing Logging Messages to an ATA Disk" section, and to the "Related Documents" section.
Restrictions for Logging to Local Nonvolatile Storage (ATA Disk)
Available ATA Disk Space Constrains the Size and Number of Stored Log Files
The amount of ATA disk space allocated to system logging messages constrains the number of logging files that can be stored. When the allocation threshold is passed, the oldest log file in the directory is deleted to make room for new system logging messages. To permanently store system logging messages, you must archive them to an external device. For more information, refer to the "Copying Logging Messages to an External Disk" section.
Information About Logging to Local Nonvolatile Storage (ATA Disk)
The Logging to Local Nonvolatile Storage (ATA Disk) feature adds a router's ATA flash disk as a storage destination for logging messages. When using this feature, be sure to understand the following concepts:
System Logging Messages
System logging messages include error and debug messages generated by application programming interfaces (APIs) on the router. Typically, logging messages are stored in a router's memory buffer; when the buffer is full, older messages are overwritten by new messages. All logging messages are erased from the memory buffer when the router reboots.
ATA Flash Disks
ATA flash disks are PC cards included with some Cisco routers, which are used to provide nonvolatile data storage. The greater the capacity of the ATA flash disk, the more data, such as logging messages, it can hold. Logging messages written to an ATA flash disk persist when the router reboots.
How to Configure Logging to Local Nonvolatile Storage (ATA Disk)
This section contains the following procedures:
•Writing Logging Messages to an ATA Disk (required)
•Copying Logging Messages to an External Disk (optional)
Writing Logging Messages to an ATA Disk
Perform this task to enable the Logging to Local Nonvolatile Storage (ATA Disk) feature and write logging messages to an ATA flash disk:
SUMMARY STEPS
1. enable
2. configure terminal
3. logging buffered [buffer-size | severity-level]
4. logging persistent [url {disk0:/directory | disk1:/directory}] [size filesystem-size]
[filesize logging-file-size]DETAILED STEPS
Copying Logging Messages to an External Disk
Perform this task to copy logging messages from the ATA flash disk to an external disk:
SUMMARY STEPS
1. enable
2. copy
DETAILED STEPS
Configuration Examples for Logging to Local Nonvolatile Storage (ATA Disk)
This section provides the following configuration examples:
•Writing Logging Messages to an ATA Disk: Example
•Copying Logging Messages to an External Disk: Example
Writing Logging Messages to an ATA Disk: Example
The following example shows how to write up to 134217728 bytes (128 MB) of logging messages to the syslog directory of disk 0, specifying a file size of 16384 bytes:
Router(config)# logging bufferedRouter(config)# logging persistent url disk0:/syslog size 134217728 filesize 16384Copying Logging Messages to an External Disk: Example
The following example shows how to copy logging messages from the router's ATA flash disk to an external disk:
Router# copy disk0:/syslog ftp://myuser/mypass@192.168.1.129/syslogAdditional References
The following sections provide references related to the Logging to Local Nonvolatile Storage (ATA Disk) feature.
Related Documents
Related Topic Document Titlecopy command
Cisco IOS Configuration Fundamentals Command Reference, Release 12.4
logging buffered command
Cisco IOS Network Management Command Reference, Release 12.4T
Standards
Standards TitleNo new or modified standards are supported by this feature, and support for existing standards has not been modified by this feature.
—
MIBs
RFCs
RFCs TitleNo new or modified RFCs are supported by this feature, and support for existing RFCs has not been modified by this feature.
—
Technical Assistance
Command Reference
This section documents only commands that are new or modified.
logging persistent
To enable the storage of logging messages on the router's advanced technology attachment (ATA) disk, use the logging persistent command in global configuration mode. To disable logging message storage on the ATA disk, use the no form of this command.
logging persistent [url {disk0:/directory | disk1:/directory}] [size filesystem-size]
[filesize logging-file-size]no logging persistent
Syntax Description
Command Default
The logging messages are not stored in the router's ATA memory.
Command Modes
Global configuration (config)
Command History
Usage Guidelines
The logging persistent command enables the storage of syslog data on the router's ATA Flash disk. Because the syslog data must be copied from the router's internal memory buffer, you must enable the logging buffered command prior to enabling the logging persistent command.
Note Any filtering of syslog messages written to the router's internal memory buffer results in filtering of syslog messages written to the router's ATA Flash disk.
Examples
The following example shows how to write up to 134217728 bytes (128 MB) of logging messages to the syslog directory of disk 0, with a file size of 16384 bytes:
Router(config)# logging bufferedRouter(config)# logging persistent url disk0:/syslog size 134217728 filesize 16384Related Commands
Feature Information for Logging to Local Nonvolatile Storage (ATA Disk)
Table 1 lists the release history for this feature.
Not all commands may be available in your Cisco IOS software release. For release information about a specific command, see the command reference documentation.
Use Cisco Feature Navigator to find information about platform support and software image support. Cisco Feature Navigator enables you to determine which Cisco IOS and Catalyst OS software images support a specific software release, feature set, or platform. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account on Cisco.com is not required.
Note Table 1 lists only the Cisco IOS software release that introduced support for a given feature in a given Cisco IOS software release train. Unless noted otherwise, subsequent releases of that Cisco IOS software release train also support that feature.
Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental.
© 2003, 2006, 2007 Cisco Systems, Inc. All rights reserved.