Cisco IOS Carrier Ethernet Configuration Guide, Release 12.2SR - Syslog Support for Ethernet Connectivity Fault Management [Cisco IOS Software Releases 12.2 SR]

Table Of Contents

Syslog Support for Ethernet Connectivity Fault Management

Finding Feature Information

Contents

Prerequisites for Syslog Support for Ethernet Connectivity Fault Management

Restrictions for Syslog Support for Ethernet Connectivity Fault Management

Information About Syslog Support for Ethernet Connectivity Fault Management

Syslog

CFM System Messages

AIS syslogs

Cisco MIB Alarm syslogs

IEEE MIB Alarm syslogs

Syslog Support for Ethernet Connectivity Fault Management

Benefits of Syslog Support for Ethernet Connectivity Fault Management

How to Enable System Message Logging for Ethernet Connectivity Fault Management

Enabling CFM Syslog Messages

Disabling CFM Syslog Messages

Configuration Examples for System Logging for Ethernet Connectivity Fault Management

Enabling All CFM Syslog Messages: Example

Enabling Cisco MIB Syslog Messages: Example

Enabling IEEE MIB Syslog Messages: Example

Enabling CFM AIS Syslog Messages: Example

Disabling All CFM Syslog Messages: Example

Additional References

Related Documents

Standards

MIBs

RFCs

Technical Assistance

Feature Information for Syslog Support for Ethernet Connectivity Fault Management

Syslog Support for Ethernet Connectivity Fault Management

First Published: February 26, 2009

Last Updated: February 26, 2009

The Cisco IOS software system message facility helps to define and report errors and changes in system status. System messages aid customers and Cisco engineers in identifying the types and severities of events and in maintaining and operating Cisco IOS devices. For Ethernet connectivity fault management (CFM), system messages also allow network administrators to develop scripts for effectively configuring and managing the CFM function.

This document describes syslog support for Ethernet CFM and how to enable and disable CFM system messages.

Finding Feature Information

Your software release may not support all the features documented in this module. For the latest feature information and caveats, see the release notes for your platform and software release. To find information about the features documented in this module, and to see a list of the releases in which each feature is supported, see the "Feature Information for Syslog Support for Ethernet Connectivity Fault Management" section.

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

•Prerequisites for Syslog Support for Ethernet Connectivity Fault Management

•Restrictions for Syslog Support for Ethernet Connectivity Fault Management

•Information About Syslog Support for Ethernet Connectivity Fault Management

•How to Enable System Message Logging for Ethernet Connectivity Fault Management

•Configuration Examples for System Logging for Ethernet Connectivity Fault Management

•Additional References

•Feature Information for Syslog Support for Ethernet Connectivity Fault Management

Prerequisites for Syslog Support for Ethernet Connectivity Fault Management

•Knowledge of the Cisco IOS implementation of Ethernet CFM 802.1ag and of ITU-T Y.1731 fault management functions.

Restrictions for Syslog Support for Ethernet Connectivity Fault Management

•CFM does not support user-configurable actions in response to some events.

•CFM does not support the automatic use of CFM operations such as loopback and linktrace when failures are detected.

•Embedded Event Manager (EEM) does not support Simple Network Management Protocol (SNMP) traps.

Information About Syslog Support for Ethernet Connectivity Fault Management

Before you set up Ethernet CFM syslogs, you should understand the following concepts:

•Syslog

•CFM System Messages

•Syslog Support for Ethernet Connectivity Fault Management

Syslog

Syslog is a delivery method for system messages, typically across an IP network. The term "syslog" is used to describe both the protocol that transfers messages and the messages themselves. Syslog is commonly used for managing computer systems and auditing system security. Syslog is supported by a variety of devices across many platforms. Because of this support, syslog can be used to integrate log data from different types of systems into a central repository.

Syslog messages are text messages less than 1 KB. They can be sent using User Datagram Protocol (UDP), TCP, or both. Messages are not encrypted, but a Secure Sockets Layer (SSL) wrapper can be used to provide a layer of encryption through the SSL or Transport Layer Security (TLS) protocols.

Syslog receivers are called "syslogd," "syslog daemon," or "syslog server."

The syslog protocol and message format are defined in RFC 3164, The BSD syslog Protocol.

CFM System Messages

This section describes the types of CFM syslog messages that can be generated and the CFM events that trigger those messages. There are three types of syslog messages:

•AIS syslogs

•Cisco MIB Alarm syslogs

•IEEE MIB Alarm syslogs

AIS syslogs

Alarm Indication Signal (AIS) syslog messages can be enabled using the ethernet cfm logging command with the ais keyword. Following are the AIS syslog messages and corresponding CFM events:

•ENTER_AIS_INT—The interface has entered an AIS defect condition.

•EXIT_AIS_INT—The interface has exited an AIS defect condition.

•ENTER_AIS—An Ethernet CFM maintenance endpoint (MEP) has entered an AIS defect condition.

•EXIT_AIS—An Ethernet CFM MEP has exited an AIS defect condition.

Cisco MIB Alarm syslogs

The same Cisco MIB alarm message definitions apply to both VLAN and Ethernet virtual circuit (EVC) services. Cisco MIB alarm syslog messages can be enabled using the ethernet cfm logging command with the alarm and cisco keywords. Following are the Cisco MIB alarm syslog messages and corresponding CFM events:

•REMOTE_MEP_UP—A continuity check (CC) message is received from an active remove MEP.

•REMOTE_MEP_DOWN—The entry in the CC database corresponding to the MEP times out or the device receives a CC message with a zero hold time.

•CROSS_CONNECTED_SERVICE—The CC message contains a customer service instance (CSI) ID or maintenance association (MA) ID is different from what is configured locally on the device.

•FORWARDING_LOOP—A device is receiving CC messages with its maintenance point ID (MPID) and source MAC address.

•CONFIG_ERROR—A device is receiving a CC message with its MPID but a different source MAC address.

•CROSSCHECK_MEP_MISSING—A configured remote MEP does not come up during the cross-check start timeout interval.

•CROSSCHECK_MEP_UNKNOWN—The remote MEP that is received is not in the configured static list.

•CROSSCHECK_SERVICE_UP—The configured service, either CSI or MA, is up as it receives CC messages from all remote, statically configured MEPs.

IEEE MIB Alarm syslogs

The IEEE MIB alarm syslog message can be enabled using the ethernet cfm logging command with the alarm and ieee keywords. Following is the Cisco MIB alarm syslog message and corresponding CFM event:

•FAULT_ALARM—A fault in the network has occurred.

Syslog Support for Ethernet Connectivity Fault Management

The Syslog Support for Ethernet Connectivity Fault Management (Syslog Support for CFM) feature provides syslog support for CFM notifications that can be used to determine the status of services and of network connectivity. This feature is disabled by default. The command-line interface (CLI) ethernet cfm logging command provides the option to either enable or disable all CFM syslogs or to separately enable or disable syslogs for the AIS feature, Cisco MIB alarms, and IEEE MIB alarms.

The Syslog Support for CFM feature must be implemented either on CFM over VLANs or when you use the IEEE 802.1ag on Bridge Domains feature and want to automate diagnostics or implement actions in response to CFM events.

Benefits of Syslog Support for Ethernet Connectivity Fault Management

•Creates a record of events that assists in troubleshooting.

•Establishes a mechanism for leveraging EEM scripts for CFM event notifications.

•Allows control of syslog messages with the CLI ethernet cfm logging command.

How to Enable System Message Logging for Ethernet Connectivity Fault Management

To turn on or turn off syslog support for CFM, perform these tasks:

•Enabling CFM Syslog Messages

•Disabling CFM Syslog Messages

Enabling CFM Syslog Messages

CFM syslogs are disabled by default. Perform this task to enable CFM syslog messages.

SUMMARY STEPS

1. enable

2. configure terminal

3. ethernet cfm logging [ais | alarm {cisco | ieee}]

4. end

DETAILED STEPS

Command or Action

Purpose

Step 1

enable
Example:

Router> enable

Enables privileged EXEC mode.

•Enter your password if prompted.

Step 2

configure terminal
Example:

Router# configure terminal

Enters global configuration mode.

Step 3

ethernet cfm logging [ais | alarm {cisco | ieee}]
Example:

Router(config)# ethernet cfm logging

Enables all CFM syslog messages.

Step 4

end
Example:

Router(config)# end

Returns the CLI to privileged EXEC mode.

Disabling CFM Syslog Messages

Perform this task to disable CFM syslog messages.

SUMMARY STEPS

1. enable

2. configure terminal

3. no ethernet cfm logging [ais | alarm {cisco | ieee}]

4. end

DETAILED STEPS

Command or Action

Purpose

Step 1

enable
Example:

Router> enable

Enables privileged EXEC mode.

•Enter your password if prompted.

Step 2

configure terminal
Example:

Router# configure terminal

Enters global configuration mode.

Step 3

no ethernet cfm logging [ais | alarm {cisco | ieee}]
Example:

Router(config)# no ethernet cfm logging

Disables all CFM syslog messages.

Step 4

end
Example:

Router(config)# end

Returns the CLI to privileged EXEC mode.

Configuration Examples for System Logging for Ethernet Connectivity Fault Management

This section contains the following examples:

•Enabling All CFM Syslog Messages: Example

•Enabling Cisco MIB Syslog Messages: Example

•Enabling IEEE MIB Syslog Messages: Example

•Enabling CFM AIS Syslog Messages: Example

•Disabling All CFM Syslog Messages: Example

Enabling All CFM Syslog Messages: Example

The following example shows how to enable all CFM syslog messages:
Router> enable
Router# configure terminal
Router(config)# ethernet cfm logging
Router(config)#

Enabling Cisco MIB Syslog Messages: Example

The following example shows how to enable all Cisco MIB syslog messages:
Router> enable
Router# configure terminal
Router(config)# ethernet cfm logging alarm cisco
Router(config)#

Enabling IEEE MIB Syslog Messages: Example

The following example shows how to enable IEEE MIB syslog messages for VLAN services:
Router> enable
Router# configure terminal
Router(config)# ethernet cfm logging alarm ieee
Router(config)#

Enabling CFM AIS Syslog Messages: Example

The following example shows how to enable syslog messages specific to the CFM AIS feature:
Router> enable
Router# configure terminal
Router(config)# ethernet cfm logging ais
Router(config)#

Disabling All CFM Syslog Messages: Example

The following example shows how to disable all syslog messages:
Router> enable
Router# configure terminal
Router(config)# no ethernet cfm logging
Router(config)#

Additional References

The following sections provide references related to the Syslog Support for Ethernet Connectivity Fault Management feature.

Related Documents

Related Topic

Document Title

CFM commands

Cisco IOS Carrier Ethernet Command Reference

Ethernet CFM

Configuring Ethernet Connectivity Fault Management in a Service Provider Network

IEEE 802.3ah

IEEE 802.3ah Ethernet in the First Mile

ITU-T Y.1731 fault management functions

Configuring ITU-T Y.1731 Fault Management Functions

Delivering and filtering syslog messages

Reliable Delivery and Filtering for Syslog

Standards

Standard

Title

IEEE P802.1ag/D1.0

Standard for Local and Metropolitan Area Networks - Virtual Bridged Local Area Networks - Amendment 5: Connectivity Fault Management

IETF VPLS OAM

L2VPN OAM Requirements and Framework

ITU-T

ITU-T Y.1731 OAM Mechanisms for Ethernet-Based Networks

MIBs

MIB

MIBs Link

•CISCO-ETHER-CFM-MIB

•CISCO-IEEE-CFM-MIB

To locate and download MIBs for selected platforms, Cisco IOS releases, and feature sets, use Cisco MIB Locator found at the following URL:

http://www.cisco.com/go/mibs

RFCs

RFC

Title

RFC 3164

The BSD syslog Protocol

Technical Assistance

Description

Link

The Cisco Support website provides extensive online resources, including documentation and tools for troubleshooting and resolving technical issues with Cisco products and technologies.

To receive security and technical information about your products, you can subscribe to various services, such as the Product Alert Tool (accessed from Field Notices), the Cisco Technical Services Newsletter, and Really Simple Syndication (RSS) Feeds.

Access to most tools on the Cisco Support website requires a Cisco.com user ID and password.

http://www.cisco.com/techsupport

Feature Information for Syslog Support for Ethernet Connectivity Fault Management

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 or 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.

Table 1 Feature Information for Syslog Support for Ethernet Connectivity Fault Management

Feature Name

Releases

Feature Information

Syslog Support for Ethernet Connectivity Fault Management

12.2(33)SRD1

The Syslog Support for Ethernet CFM feature provides syslog support for CFM notifications that can be used to determine the status of services and of network connectivity. This feature must be implemented either when you use the IEEE 802.1ag on Bridge Domains feature or CFM over VLANs or if you are using the IEEE 802.1ag on Bridge Domains feature and want to automate diagnostics or implement actions in response to CFM events.

The following commands were introduced or modified: ethernet cfm logging.

CCDE, CCENT, Cisco Eos, Cisco HealthPresence, the Cisco logo, Cisco Lumin, Cisco Nexus, Cisco StadiumVision, Cisco TelePresence, Cisco WebEx, DCE, and Welcome to the Human Network are trademarks; Changing the Way We Work, Live, Play, and Learn and Cisco Store are service marks; and Access Registrar, Aironet, AsyncOS, Bringing the Meeting To You, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, CCVP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Collaboration Without Limitation, EtherFast, EtherSwitch, Event Center, Fast Step, Follow Me Browsing, FormShare, GigaDrive, HomeLink, Internet Quotient, IOS, iPhone, iQuick Study, IronPort, the IronPort logo, LightStream, Linksys, MediaTone, MeetingPlace, MeetingPlace Chime Sound, MGX, Networkers, Networking Academy, Network Registrar, PCNow, PIX, PowerPanels, ProConnect, ScriptShare, SenderBase, SMARTnet, Spectrum Expert, StackWise, The Fastest Way to Increase Your Internet Quotient, TransPath, WebEx, and the WebEx logo are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.

All other trademarks mentioned in this document or website are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (0812R)

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.

© 2009 Cisco Systems, Inc. All rights reserved.