Added EEM example

Author: Jason Frazier

EEM-interface-move-routes/EEM-interface-move-routes.py

@@ -0,0 +1,42 @@
+#!/usr/bin/env python
+#
+# Copyright (c) 2017  Jason Frazier <[email protected]>
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions
+# are met:
+# 1. Redistributions of source code must retain the above copyright
+#    notice, this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright
+#    notice, this list of conditions and the following disclaimer in the
+#    documentation and/or other materials provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
+# ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+# ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
+# FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+# DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+# OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+# HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+# LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+# OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+# SUCH DAMAGE.
+#
+# This script retrieves entire configuration from a network element via NETCONF 
+# prints it out in a "pretty" XML tree.
+
+# importing the cli module is necessary to run
+# config or exec commands on the host.
+import cli
+# importing the time module works well in 
+# this script, as we are pacing some of the execution.
+
+import time
+# importing the time module works well in this script, as we are pacing 
+# some of the execution.
+
+cli.configure('no ip route 10.10.1.2 255.255.255.255 10.90.1.1');
+time.sleep(2)
+cli.configure('ip route 10.10.1.2 255.255.255.255 10.90.1.65');

EEM-interface-move-routes/README.md

@@ -0,0 +1,19 @@
+# EEM interface-move-routes.py
+
+This is an example Python script utilizing EEM integration. 
+
+The example EEM is below:
+event manager applet INTERFACE-DOWN
+ event syslog pattern "LINEPROTO-5-UPDOWN: Line protocol on Interface GigabitEthernet0/0, changed state to down"
+ action 0.0 cli command "en"
+ action 1.0 cli command "guestshell run python EEM-interface-routes.py"
+
+As you can see, this EEM policy named "INTERFACE-DOWN" looks for a syslog pattern. In this example case, it is a syslog pattern for a specifc interface going down. When EEM sees this, it triggers an exec CLI that executes the onbox Python script named "EEM-interface-routes.py"
+
+No verification has been built into this, but the script could be extednded as well.
+
+# requirements
+-- IOS-XE running >/= 16.5.1 also enabled for GuestShell
+
+# running
+-- onbox