#!/bin/bash # Tests for event streams using notifications # Assumptions: # 1. http server setup, such as nginx described in apps/restconf/README.md # especially SSE - ngchan setup # 2. Example stream as Clixon example which needs registration, callback and # notification generating code every 5s # # Testing of streams is quite complicated. # Here are some testing dimensions in restconf alone: # - start/stop subscription # - start-time/stop-time in subscription # - stream retention time # - native vs nchan implementation # Focussing on 1-3 # 2a) start sub 8s - expect 2 notifications # 2b) start sub 8s - stoptime after 5s - expect 1 notifications # 2c) start sub 8s - replay from start -8s - expect 4 notifications # 2d) start sub 8s - replay from start -8s to stop +4s - expect 3 notifications # 2e) start sub 8s - replay from -90s w retention 60s - expect 10 notifications # Note the sleeps are mainly for valgrind usage APPNAME=example UTIL=../util/clixon_util_stream if [ ! -x $UTIL ]; then echo "$UTIL not found. To build: (cd ../util; make clixon_util_stream)" exit 1 fi DATE=$(date +"%Y-%m-%d") # include err() and new() functions and creates $dir . ./lib.sh cfg=$dir/conf.xml fyang=$dir/stream.yang xml=$dir/xml.xml # example cat < $cfg $cfg /usr/local/share/clixon false /usr/local/var/$APPNAME/$APPNAME.sock /usr/local/lib/$APPNAME/backend example_backend.so$ $dir/restconf.pidfile /usr/local/var/$APPNAME /usr/local/lib/xmldb/text.so /usr/local/lib/$APPNAME/clispec /usr/local/lib/$APPNAME/cli $APPNAME true true true streams https://localhost 60 EOF # For nchan testing add this line to above config # http://localhost/pub # RFC5277 NETCONF Event Notifications # using reportingEntity (rfc5277) not reporting-entity (rfc8040) cat < $fyang module example { namespace "http://example.com/event/1.0"; prefix ex; organization "Example, Inc."; contact "support at example.com"; description "Example Notification Data Model Module."; revision "2016-07-07" { description "Initial version."; reference "example.com document 2-9976."; } notification event { description "Example notification event."; leaf event-class { type string; description "Event class identifier."; } container reportingEntity { description "Event specific information."; leaf card { type string; description "Line card identifier."; } } leaf severity { type string; description "Event severity description."; } } container state { config false; description "state data for the example application (must be here for example get operation)"; leaf-list op { type string; } } } EOF # kill old backend (if any) new "kill old backend" sudo clixon_backend -zf $cfg if [ $? -ne 0 ]; then err fi new "start backend -s init -f $cfg -y $fyang" sudo $clixon_backend -s init -f $cfg -y $fyang # -D 1 if [ $? -ne 0 ]; then err fi new "kill old restconf daemon" sudo pkill -u www-data clixon_restconf new "start restconf daemon" sudo su -c "/www-data/clixon_restconf -f $cfg -y $fyang" -s /bin/sh www-data & sleep 2 # # 1. Netconf RFC5277 stream testing new "1. Netconf RFC5277 stream testing" # 1.1 Stream discovery new "netconf event stream discovery RFC5277 Sec 3.2.5" expecteof "$clixon_netconf -qf $cfg -y $fyang" 0 ']]>]]>' 'EXAMPLEExample event streamtrue]]>]]>' new "netconf event stream discovery RFC8040 Sec 6.2" expecteof "$clixon_netconf -qf $cfg -y $fyang" 0 ']]>]]>' 'EXAMPLEExample event streamtruexmlhttps://localhost/streams/EXAMPLE]]>]]>' # # 1.2 Netconf stream subscription new "netconf EXAMPLE subscription" expectwait "$clixon_netconf -qf $cfg -y $fyang" 'EXAMPLE]]>]]>' '^]]>]]>20' 10 new "netconf subscription with empty startTime" expectwait "$clixon_netconf -qf $cfg -y $fyang" 'EXAMPLE]]>]]>' '^]]>]]>20' 5 new "netconf EXAMPLE subscription with simple filter" expectwait "$clixon_netconf -qf $cfg -y $fyang" "EXAMPLE]]>]]>" '^]]>]]>20' 5 new "netconf EXAMPLE subscription with filter classifier" expectwait "$clixon_netconf -qf $cfg -y $fyang" "EXAMPLE]]>]]>" '^]]>]]>20' 5 new "netconf NONEXIST subscription" expectwait "$clixon_netconf -qf $cfg -y $fyang" 'NONEXIST]]>]]>' '^invalid-valueapplicationerrorNo such stream]]>]]>$' 5 new "netconf EXAMPLE subscription with wrong date" expectwait "$clixon_netconf -qf $cfg -y $fyang" 'EXAMPLEkallekaka]]>]]>' '^bad-elementapplicationstartTimeerrorExpected timestamp]]>]]>$' 0 #new "netconf EXAMPLE subscription with replay" #NOW=$(date +"%Y-%m-%dT%H:%M:%S") #sleep 10 #expectwait "$clixon_netconf -qf $cfg -y $fyang" "EXAMPLE$NOW]]>]]>" '^]]>]]>20' 10 sleep 2 # # 2. Restconf RFC8040 stream testing new "2. Restconf RFC8040 stream testing" # 2.1 Stream discovery new "restconf event stream discovery RFC8040 Sec 6.2" expectfn "curl -s -X GET http://localhost/restconf/data/ietf-restconf-monitoring:restconf-state/streams" 0 '{"streams": {"stream": \[{"name": "EXAMPLE","description": "Example event stream","replay-support": true,"access": \[{"encoding": "xml","location": "https://localhost/streams/EXAMPLE"}\]}\]}' sleep 2 new "restconf subscribe RFC8040 Sec 6.3, get location" expectfn "curl -s -X GET http://localhost/restconf/data/ietf-restconf-monitoring:restconf-state/streams/stream=EXAMPLE/access=xml/location" 0 '{"location": "https://localhost/streams/EXAMPLE"}' sleep 2 # Restconf stream subscription RFC8040 Sec 6.3 # Start Subscription w error new "restconf monitor event nonexist stream" expectwait 'curl -s -X GET -H "Accept: text/event-stream" -H "Cache-Control: no-cache" -H "Connection: keep-alive" http://localhost/streams/NOTEXIST' 0 'invalid-valueapplicationerrorNo such stream' 2 # 2a) start subscription 8s - expect 1-2 notifications new "2a) start subscriptions 8s - expect 1-2 notifications" ret=$($UTIL -u http://localhost/streams/EXAMPLE -t 8) expect="data: ${DATE}T[0-9:.]*faultEthernet0major" match=$(echo "$ret" | grep -Eo "$expect") if [ -z "$match" ]; then err "$expect" "$ret" fi nr=$(echo "$ret" | grep -c "data:") if [ $nr -lt 1 -o $nr -gt 2 ]; then err 2 "$nr" fi sleep 2 # 2b) start subscription 8s - stoptime after 5s - expect 1-2 notifications new "2b) start subscriptions 8s - stoptime after 5s - expect 1-2 notifications" ret=$($UTIL -u http://localhost/streams/EXAMPLE -t 8 -e +10) expect="data: ${DATE}T[0-9:.]*faultEthernet0major" match=$(echo "$ret" | grep -Eo "$expect") if [ -z "$match" ]; then err "$expect" "$ret" fi nr=$(echo "$ret" | grep -c "data:") if [ $nr -lt 1 -o $nr -gt 2 ]; then err 1 "$nr" fi # 2c new "2c) start sub 8s - replay from start -8s - expect 3-4 notifications" ret=$($UTIL -u http://localhost/streams/EXAMPLE -t 10 -s -8) expect="data: ${DATE}T[0-9:.]*faultEthernet0major" match=$(echo "$ret" | grep -Eo "$expect") if [ -z "$match" ]; then err "$expect" "$ret" fi nr=$(echo "$ret" | grep -c "data:") if [ $nr -lt 3 -o $nr -gt 4 ]; then err 4 "$nr" fi # 2d) start sub 8s - replay from start -8s to stop +4s - expect 3 notifications new "2d) start sub 8s - replay from start -8s to stop +4s - expect 3 notifications" ret=$($UTIL -u http://localhost/streams/EXAMPLE -t 10 -s -30 -e +4) expect="data: ${DATE}T[0-9:.]*faultEthernet0major" match=$(echo "$ret" | grep -Eo "$expect") if [ -z "$match" ]; then err "$expect" "$ret" fi nr=$(echo "$ret" | grep -c "data:") if [ $nr -lt 4 -o $nr -gt 10 ]; then err 6 "$nr" fi # 2e) start sub 8s - replay from -90s w retention 60s - expect 10 notifications new "2e) start sub 8s - replay from -90s w retention 60s - expect 10 notifications" ret=$($UTIL -u http://localhost/streams/EXAMPLE -t 10 -s -90 -e +0) expect="data: ${DATE}T[0-9:.]*faultEthernet0major" match=$(echo "$ret" | grep -Eo "$expect") if [ -z "$match" ]; then err "$expect" "$ret" fi nr=$(echo "$ret" | grep -c "data:") if [ $nr -lt 10 -o $nr -gt 14 ]; then err 10 "$nr" fi # Try parallell # start background job curl -s -X GET -H "Accept: text/event-stream" -H "Cache-Control: no-cache" -H "Connection: keep-alive" "http://localhost/streams/EXAMPLE" > /dev/null & new "Start subscription in parallell" ret=$($UTIL -u http://localhost/streams/EXAMPLE -t 8) expect="data: ${DATE}T[0-9:.]*faultEthernet0major" match=$(echo "$ret" | grep -Eo "$expect") if [ -z "$match" ]; then err "$expect" "$ret" fi nr=$(echo "$ret" | grep -c "data:") if [ $nr -lt 1 -o $nr -gt 2 ]; then err 2 "$nr" fi #-------------------------------------------------------------------- # NCHAN Need manual testing echo "Nchan streams requires manual testing" echo "Add http://localhost/pub to config" echo "Eg: curl -H \"Accept: text/event-stream\" -s -X GET http://localhost/sub/EXAMPLE" #----------------- sudo pkill -u www-data clixon_restconf new "Kill backend" # kill backend sudo clixon_backend -zf $cfg if [ $? -ne 0 ]; then err "kill backend" fi # Check if still alive pid=`pgrep clixon_backend` if [ -n "$pid" ]; then sudo kill $pid fi rm -rf $dir