Send e-mail with your Cisco router

[LEFT][CODE]http://blogs.techrepublic.com.com/networking/?p=454[/CODE]
Did you know your Cisco router could send you an e-mail? Until recently, I would have said that it wasn’t possible, but today, I’ll show you how to do it. And we won’t stop there: I’ll tell you where to find some other scripts that you can use on your Cisco router. Let’s see how the Cisco IOS Tool Command Language (TCL) can make your Cisco administration easier.
A while ago, I wrote an article introducing TCL — “[URL="http://articles.techrepublic.com.com/5100-10878_11-6089628.html"]Get to know Cisco’s Tool Command Language (TCL)[/URL]” — and I told you how you can create your own scripts using TCL. To run TCL, your router needs to be running Cisco IOS 12.3(2)T or later.
While TCL offers many uses for your Cisco router, it needs to be able to communicate with the Cisco IOS. Traditionally, when an event happens on a Cisco router, it sends that event to a management station on your network for some subsequent action. However, with Cisco’s introduction of the Embedded Event Manager (EEM), Cisco routers now have more intelligence and can take actions on their own.
Cisco originally released EEM 1.0 in IOS versions 12.0(26)S and 12.3(4)T. Today, with IOS versions 12.4(2)T, 12.2(31)SB3, 12.2(33)SRB, we’re up to EEM version 2.2, and we’ve gained many features along the way. To learn more, check out [URL="http://www.cisco.com/en/US/docs/ios/12_2sx/sw_modularity/configuration/guide/nmb_eemo.html"]Cisco’s Embedded Event Manager Overview[/URL].
I suspect that TCL and EEM sound only moderately interesting to most of you because, like any scripting language, it can be difficult to envision what you can do with it. To help you understand the power of EEM, Cisco has created the [URL="http://forums.cisco.com/eforum/servlet/EEM?page=main"]Embedded Event Manager (EEM) Scripting Community[/URL].
Thanks to this site, you can not only download many useful scripts, but you can also submit your own to share with other Cisco users. Kudos to Cisco for this excellent resource!
[B]Send e-mail with your router[/B]

To better understand the uses of TCL and EEM, let’s look at an example. Here’s a simple demonstration of how a router can send an e-mail that contains the output of the [I]show version[/I] command.
First, I went to the EEM Scripting Community and downloaded the [URL="http://forums.cisco.com/eforum/servlet/EEM?page=eem&fn=script&scriptId=921"]Send Email script[/URL]. I unzipped the script and ended up with a simple text file called Sendmail.tcl.
Next, I stated my TFTP server on my PC, and I used TFTP on the router to transfer the modified script from my PC to the router’s flash. [B]Figure A[/B] shows you what it looked like.
[CENTER][B]Figure A[/B][/CENTER]
[CENTER][IMG]http://i.i.com.com/cnwk.1d/i/tr/Eve/figs031312008/Cisco1.png[/IMG][/CENTER]
Next, I ran the following command while in Global Configuration Mode:
Router(config)# [B][I]event manager directory user policy flash:[/I][/B] Then, according to the instructions included in the script’s comments, I set the following environmental variables on the router to fit my particular configuration (still in Global Configuration Mode), as shown in [B]Figure B[/B]:
Router(config)#

event manager environment _email_server 10.10.10.10

Router(config)#

event manager environment _email_from [EMAIL="router-123@cisco.com"]router-123@cisco.com[/EMAIL]

Router(config)#

event manager environment _email_to [EMAIL="noc@cisco.com"]noc@cisco.com[/EMAIL] [CENTER][B]Figure B[/B][/CENTER]
[CENTER][IMG]http://i.i.com.com/cnwk.1d/i/tr/Eve/figs031312008/Cisco2.png[/IMG][/CENTER]
Next, I registered the script using the following command:
Router(config)#[B] [I]event manager policy sendmail.tcl[/I][/B] Finally, I ran the script using the [I]event manager run sendmail.tcl[/I] command. If all goes well, there’s no output. [B]Figure C[/B] shows the e-mail message.
[CENTER][B]Figure C[/B][/CENTER]
[CENTER][IMG]http://i.i.com.com/cnwk.1d/i/tr/Eve/figs031312008/Cisco3.png[/IMG][/CENTER]
You can also modify this script to run on triggered events. For example, there’s a script called [I]showtech[/I] that you can use to e-mail the output from the [I]show tech-support[/I] command directly to Cisco or to yourself. For more information, check out Cisco’s [URL="http://www.cisco.com/en/US/prod/iosswrel/ps6537/ps6555/ps9421/networking_solutions_products_genericcontent0900aecd80719ee6.html"]video tutorials[/URL] on using TCL/EEM router scripts.
[B]More uses for TCL and EEM[/B]

While this article has focused on using TCL and EEM to send an e-mail with your router, I want to stress that there are so many more practical uses for TCL and EEM with the Cisco IOS. For example, one of the most useful things you can do with TCL and EEM is use a set of diagnostic scripts dubbed [I][URL="http://www.cisco.com/en/US/products/ps9424/products_ios_protocol_group_home.html"][B]IOS Service Diagnostics[/B][/URL][/I]. Such scripts are available for OSPF, BGP, and QoS.
With these scripts running on your router, when abnormal events occur (such as losing an OSPF Neighbor), your router can automatically attempt to diagnose the issue, perhaps take action to solve it, or, if nothing else, notify you of the issue along with all of the relevant information needed to resolve it. In other words, the scripts can provide for a shorter Mean Time To Repair (MTTR) — which equates to cost savings. In addition, the scripts can increase network uptime, quickly identify root causes, and automatically collect network troubleshooting data.
Here are some of the other interesting scripts available:

[LIST][*]Memory Health[*]Power and Temperature Health[*]Composite Device Health — Interface Errors[*]HSRP State Change[*]L3 Path Failure Detection — EIGRP Neighbor Change[*]VPN Failure Detection[*]WAN Load Alarm[/LIST]
[B]Conclusion[/B]

According to Cisco’s IOS Service Diagnostic Web site, Cisco plans on introducing a management interface to help administrators manage these types of scripts on Cisco routers. I look forward to trying that out as soon as it’s available. In the meantime, we have a lot of powerful scripts available to test and learn about. In fact, you could even write your own
[/LEFT]

[LEFT][B][CODE]http://www.cisco.com/en/US/prod/iosswrel/ps6537/ps6555/ps9421/networking_solutions_products_genericcontent0900aecd80719ee6.html[/CODE][/B]

[B]Cisco IOS Diagnostic Tools for Commercial[/B]

[B]Automated Diagnostics for Commercial Networks[/B]





The following list contains simple, easy-to-use scripts and applets that allow network engineers managing Commercial networks to automate common diagnostics and customize complex network tasks.
The scripts and applets use Cisco IOS® Embedded Event Manager (EEM), a powerful device and system management technology integrated into specific Cisco switches and routers. EEM helps customers harness the network intelligence intrinsic to Cisco IOS Software and gives them the ability to customize behavior based on network events as they happen.
Requirements:

[LIST][*]Hardware platform: Cisco 1800, 2800, 3800 ISRs[*]Cisco IOS® Software Release: Scripts written using Release 12.4(9)T4[/LIST]

Composite Device Health - Interface Errors
[URL="http://forums.cisco.com/eforum/servlet/EEM?page=eem&fn=script&scriptId=762"]Download Script[/URL]
[URL="http://www.cisco.com/cdc_content_elements/flash/ios/ios_commercial/composite_device_health_interface/Composite_Device_Health_Interface.html"] View Video[/URL]

Composite Device Health - Memory
[URL="http://forums.cisco.com/eforum/servlet/EEM?page=eem&fn=script&scriptId=763"]Download Script[/URL]
[URL="http://www.cisco.com/cdc_content_elements/flash/ios/ios_commercial/composite_device_health_memory/Composite_Device_Health_Memory.html"] View Video[/URL]

Power and Temperature Health
[URL="http://forums.cisco.com/eforum/servlet/EEM?page=eem&fn=script&scriptId=764"]Download Script[/URL]

Memory Health
[URL="http://forums.cisco.com/eforum/servlet/EEM?page=eem&fn=script&scriptId=765"]Download Script[/URL]

Forwarding Path Health
[URL="http://forums.cisco.com/eforum/servlet/EEM?page=eem&fn=script&scriptId=904"]Download Script[/URL]

HSRP State Change
[URL="http://forums.cisco.com/eforum/servlet/EEM?page=eem&fn=script&scriptId=767"]Download Script[/URL]

L2 WAN Failure Detection
[URL="http://forums.cisco.com/eforum/servlet/EEM?page=eem&fn=script&scriptId=768"]Download Script[/URL]

L3 Path Failure Detection - EIGRP Neighbor Change
[URL="http://forums.cisco.com/eforum/servlet/EEM?page=eem&fn=script&scriptId=1002"]Download Script[/URL]

L3 Path Failure Detection - IP Route Tracking
[URL="http://forums.cisco.com/eforum/servlet/EEM?page=eem&fn=script&scriptId=771"]Download Script[/URL]

VPN Failure Detection
[URL="http://forums.cisco.com/eforum/servlet/EEM?page=eem&fn=script&scriptId=772"]Download Script[/URL]
[URL="http://www.cisco.com/cdc_content_elements/flash/ios/ios_commercial/vpn_failure/cam_vpn_failure_default_quality.html"]View Video[/URL]

Server Failure Detection - Down State
[URL="http://forums.cisco.com/eforum/servlet/EEM?page=eem&fn=script&scriptId=905"]Download Script[/URL]
[URL="http://www.cisco.com/cdc_content_elements/flash/ios/ios_commercial/server_failure_detection_down/Server_Failure_Detection_Down.html"]View Video[/URL]

Server Failure Detection - Up State
[URL="http://forums.cisco.com/eforum/servlet/EEM?page=eem&fn=script&scriptId=901"]Download Script[/URL]
[URL="http://www.cisco.com/cdc_content_elements/flash/ios/ios_commercial/server_available/server_available.html"]View Video[/URL]

Application Failure Detection
[URL="http://forums.cisco.com/eforum/servlet/EEM?page=eem&fn=script&scriptId=1081"]Download Script[/URL]

Priority Queue Threshold
[URL="http://forums.cisco.com/eforum/servlet/EEM?page=eem&fn=script&scriptId=777"]Download Script[/URL]
[URL="http://www.cisco.com/cdc_content_elements/flash/ios/ios_commercial/priority_queue_threshold/Priority_Queue_Threshold.html"]View Video[/URL]

WAN Load Alarm
[URL="http://forums.cisco.com/eforum/servlet/EEM?page=eem&fn=script&scriptId=1003"]Download Script[/URL]

Log New Configuration After Updates
[URL="http://forums.cisco.com/eforum/servlet/EEM?page=eem&fn=script&scriptId=780"]Download Script[/URL]

Log Config Diffs After Updates
[URL="http://forums.cisco.com/eforum/servlet/EEM?page=eem&fn=script&scriptId=782"]Download Script[/URL]
[URL="http://www.cisco.com/cdc_content_elements/flash/ios/ios_commercial/log_config_update/LogConfigUpdate.html"]View Video[/URL]

Log User Name Information
[URL="http://forums.cisco.com/eforum/servlet/EEM?page=eem&fn=script&scriptId=783"]Download Script[/URL]

Send Show-tech via Email
[URL="http://forums.cisco.com/eforum/servlet/EEM?page=eem&fn=script&scriptId=784"]Download Script[/URL]

Send Email
[URL="http://forums.cisco.com/eforum/servlet/EEM?page=eem&fn=script&scriptId=921"]Download Script[/URL]
[URL="http://www.cisco.com/cdc_content_elements/flash/ios/ios_commercial/send_email/Send_Email.html"]View Video[/URL]



[/LEFT]