#!/usr/bin/env bash # Tests for event streams using notifications # See RFC5277 NETCONF Event Notifications # RFC8040 Sec 6.2 # 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 # # XXX There is some state/timing issue introduced in 5.7, see test-pause and parallell # Magic line must be first in script (see README.md) s="$_" ; . ./lib.sh || if [ "$s" = $0 ]; then exit 0; else return 0; fi # Skip it other than fcgi and http if [ "${WITH_RESTCONF}" != "fcgi" -o "$RCPROTO" = https ]; then rm -rf $dir if [ "$s" = $0 ]; then exit 0; else return 0; fi # skip fi # Dont run this test with valgrind if [ $valgrindtest -ne 0 ]; then echo "...skipped " rm -rf $dir return 0 # skip fi # Degraded does not work at all rm -rf $dir if [ "$s" = $0 ]; then exit 0; else return 0; fi # skip : ${SLEEP2:=1} SLEEP5=.5 APPNAME=example : ${clixon_util_stream:=clixon_util_stream} # Ensure UTC DATE=$(date -u +"%Y-%m-%d") cfg=$dir/conf.xml fyang=$dir/stream.yang xml=$dir/xml.xml # Define default restconfig config: RESTCONFIG RESTCONFIG=$(restconf_config none false) # example cat < $cfg $cfg clixon-restconf:allow-auth-none ${YANG_INSTALLDIR} $fyang /usr/local/var/$APPNAME/$APPNAME.sock /usr/local/lib/$APPNAME/backend example_backend.so$ /usr/local/var/$APPNAME/$APPNAME.pidfile /usr/local/var/$APPNAME /usr/local/lib/$APPNAME/clispec /usr/local/lib/$APPNAME/cli $APPNAME true true streams https://localhost 60 $RESTCONFIG 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 "urn:example:clixon"; 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 # Temporary pause between tests to make state timeout # XXX This should not really be here, there is some state/timing issue introduced in 5.7 function test-pause() { sleep 5 # -m 1 means 1 sec timeout curl -Ssik --http1.1 -X GET -m 1 -H "Accept: text/event-stream" -H "Cache-Control: no-cache" -H "Connection: keep-alive" "http://localhost/streams/EXAMPLE" 2>&1 > /dev/null } new "test params: -f $cfg" if [ $BE -ne 0 ]; then new "kill old backend" sudo clixon_backend -zf $cfg if [ $? -ne 0 ]; then err fi new "start backend -s init -f $cfg -- -n" start_backend -s init -f $cfg -- -n # create example notification stream fi new "wait backend" wait_backend if [ $RC -ne 0 ]; then new "kill old restconf daemon" stop_restconf_pre new "start restconf daemon" start_restconf -f $cfg fi new "wait restconf" wait_restconf new "netconf event stream discovery RFC8040 Sec 6.2" expecteof_netconf "$clixon_netconf -D $DBG -qf $cfg" 0 "$DEFAULTHELLO" "" "" "EXAMPLEExample event streamtruexmlhttps://localhost/streams/EXAMPLE" # # 1.2 Netconf stream subscription # 2. Restconf RFC8040 stream testing new "2. Restconf RFC8040 stream testing" # 2.1 Stream discovery new "restconf event stream discovery RFC8040 Sec 6.2" expectpart "$(curl $CURLOPTS -X GET $RCPROTO://localhost/restconf/data/ietf-restconf-monitoring:restconf-state/streams)" 0 "HTTP/$HVER 200" '{"ietf-restconf-monitoring:streams":{"stream":\[{"name":"EXAMPLE","description":"Example event stream","replay-support":true,"access":\[{"encoding":"xml","location":"https://localhost/streams/EXAMPLE"}\]}\]}' sleep $SLEEP2 new "restconf subscribe RFC8040 Sec 6.3, get location" expectpart "$(curl $CURLOPTS -X GET $RCPROTO://localhost/restconf/data/ietf-restconf-monitoring:restconf-state/streams/stream=EXAMPLE/access=xml/location)" 0 "HTTP/$HVER 200" '{"ietf-restconf-monitoring:location":"https://localhost/streams/EXAMPLE"}' sleep $SLEEP2 # Restconf stream subscription RFC8040 Sec 6.3 # Start Subscription w error new "restconf monitor event nonexist stream" # Note cant use -S or -i here, the former dont know, latter because expectwait cant take # partial returns like expectpart can expectwait "curl -sk -X GET -H \"Accept: text/event-stream\" -H \"Cache-Control: no-cache\" -H \"Connection: keep-alive\" $RCPROTO://localhost/streams/NOTEXIST" 0 "" "" 2 'applicationinvalid-valueerrorNo such stream' # 2a) start subscription 8s - expect 1-2 notifications new "2a) start subscriptions 8s - expect 1-2 notifications" ret=$($clixon_util_stream -u $RCPROTO://localhost/streams/EXAMPLE -t 8) expect="data: ${DATE}T[0-9:.]*ZfaultEthernet0major" 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 test-pause # 2b) start subscription 8s - stoptime after 5s - expect 1-2 notifications new "2b) start subscriptions 8s - stoptime after 5s - expect 1-2 notifications" ret=$($clixon_util_stream -u $RCPROTO://localhost/streams/EXAMPLE -t 8 -e +10) expect="data: ${DATE}T[0-9:.]*ZfaultEthernet0major" 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 test-pause # 2c new "2c) start sub 8s - replay from start -8s - expect 3-4 notifications" ret=$($clixon_util_stream -u $RCPROTO://localhost/streams/EXAMPLE -t 10 -s -8) expect="data: ${DATE}T[0-9:.]*ZfaultEthernet0major" 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 if [ $nr -lt 3 ]; then err 4 "$nr" fi test-pause # 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=$($clixon_util_stream -u $RCPROTO://localhost/streams/EXAMPLE -t 10 -s -30 -e +4) expect="data: ${DATE}T[0-9:.]*ZfaultEthernet0major" 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 if [ $nr -lt 4 ]; then err 6 "$nr" fi test-pause if false; then # XXX Should work but function detoriated # 2e) start sub 8s - replay from -90s w retention 60s - expect 9-14 notifications new "2e) start sub 8s - replay from -90s w retention 60s - expect 10 notifications" ret=$($clixon_util_stream -u $RCPROTO://localhost/streams/EXAMPLE -t 10 -s -90 -e +0) expect="data: ${DATE}T[0-9:.]*ZfaultEthernet0major" match=$(echo "$ret" | grep -Eo "$expect") if [ -z "$match" ]; then err "$expect" "$ret" fi nr=$(echo "$ret" | grep -c "data:") if [ $nr -lt 8 -o $nr -gt 14 ]; then err "8-14" "$nr" fi test-pause sleep 5 # Try parallell # start background job curl $CURLOPTS -X GET -H "Accept: text/event-stream" -H "Cache-Control: no-cache" -H "Connection: keep-alive" "$RCPROTO://localhost/streams/EXAMPLE" & # > /dev/null & PID=$! new "Start subscriptions in parallell" ret=$($clixon_util_stream -u $RCPROTO://localhost/streams/EXAMPLE -t 8) expect="data: ${DATE}T[0-9:.]*ZfaultEthernet0major" 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 fi # XXX kill $PID #-------------------------------------------------------------------- # NCHAN Need manual testing echo "Nchan streams requires manual testing" echo "Add http://localhost/pub to config" echo "Eg: curl $CURLOPTS -H \"Accept: text/event-stream\" -s -X GET $RCPROTO://localhost/sub/EXAMPLE" #----------------- sleep $SLEEP5 if [ $RC -ne 0 ]; then new "Kill restconf daemon" stop_restconf fi if [ $BE -ne 0 ]; then new "Kill backend" # Check if premature kill pid=$(pgrep -u root -f clixon_backend) if [ -z "$pid" ]; then err "backend already dead" fi # kill backend stop_backend -f $cfg fi # Set by restconf_config unset RESTCONFIG # unset conditional parameters unset clixon_util_stream unset nr new "Endtest" endtest rm -rf $dir