X-Git-Url: https://git.teslayout.com/public/public/public/?a=blobdiff_plain;f=example%2Fdiameter%2Flauncher%2Fresources%2Fscripts%2FtinyTestcase.sh;h=01674c217cb7d75a19fb0e633eea543cf8788680;hb=8cc313630b9926900da2abdce7dff280a7fc8d6a;hp=e08120fdfe51f363bbc25f49ebf5a5dd19c6f7b1;hpb=09f74ebd57cd733b52ad48ba482bc406b1ce91f6;p=anna.git diff --git a/example/diameter/launcher/resources/scripts/tinyTestcase.sh b/example/diameter/launcher/resources/scripts/tinyTestcase.sh index e08120f..01674c2 100755 --- a/example/diameter/launcher/resources/scripts/tinyTestcase.sh +++ b/example/diameter/launcher/resources/scripts/tinyTestcase.sh @@ -4,6 +4,10 @@ # VARIABLES # ############# SCR_DIR=`readlink -f $0 | xargs dirname` +TESTCASE_BN=testcase.txt +WHAT=????????? +REQUEST_STEP= +VARIANT__dflt=safe ############# # FUNCTIONS # @@ -16,57 +20,411 @@ _exit() { } usage() { - echo "Usage: $0 " echo - echo " The source directory may contain .xml and .metadata files grouped by pairs and alphabetically classified:" + echo "Usage: $0 [variant: fast|[safe]]" echo - echo " 11.hex.as.xml 15.hex.as.xml 19.hex.as.xml ..." - echo " 11.metadata 15.metadata 19.metadata ..." - echo " 13.hex.as.xml 17.hex.as.xml 21.hex.as.xml ..." - echo " 13.metadata 17.metadata 21.metadata ..." + echo " source_directory:" + echo " The source directory may contain .xml and .metadata files grouped by pairs and alphabetically classified," + echo " and also (and this is VERY IMPORTANT), a file called 'origin-hosts' containing a list of Origin-Host" + echo " values that represents the point of view of the ADML testing system, together with the type of the" + echo " simulated ADML node (client/server):" echo - echo " Normally the order comes from first dot-separated part, which is the decoded frame from pcap:" + echo " .hex.as.xml: ANNA-Diameter XML message format." + echo " .metadata: Some decoded message information." + echo " ..." + echo " origin-hosts: Example of content:" + echo " OCS3GPPNodeHostname.ocs3gpprealm.com server" + echo " ggsnNodeHostname.nodeHostRealm.com client" echo - echo " 11.hex.as.xml: would be the ANNA-Diameter decoded message from hexadecimal sniffed one." - echo " 11.metadata: would contain parsed metadata from tshark or another fulfilling this information:" - echo - echo " date=Sat Dec 19 11:50:55 CET 2015" - echo " timestamp=1450522255.205673000" - echo " src=gentraf" - echo " dst=testbed" + echo " The order for the xml and metadata files comes from first dot-separated part (), which is normally the" + echo " decoded frame from a pcap file. The xml files are ANNA-Diameter xml messages and a typical metadata file" + echo " would be something like this:" + echo " date=vie ene 29 15:37:14 CET 2016" + echo " timestamp=1454078234.050988000" + echo " src=192.168.14.42" + echo " dst=192.168.12.40" echo " code=257" - echo " isrequest=1" + echo " isrequest=0" echo " applicationid=0" + echo " originhost=OCSNodeHostname.ocsrealm.com" + echo + echo " You can use the 'example/diameter/pcapDecoder/tsharkDecoder.sh' script over a pcap file, in order to get" + echo " the hexadecimal buffers and then process them with 'example/diameter/batchConverter' tool to get the xml" + echo " messages and metadata for each pcap diameter frame." + echo + echo + echo " variant:" + echo " Two variants are implemented: 'fast', where wait conditions does not check the complete message, and" + echo " 'safe' which checks the full xml message content (good for function test). Default is '$VARIANT__dflt'." + echo + echo + echo " seconds_timeout:" + echo " Timeout in seconds for the testcase. If '-' provided, no timeout will be programmed for the testcase." + echo echo - echo " Presented example has been achieved using the 'example/diameter/pcapDecoder/tsharkDecoder.sh' script" - echo " and then decoding with 'example/diameter/batchConverter' tool with appropiate diameter dictionaries." echo - echo " This script will create a basic testcase based on frames timeline (11, 13, 15, etc.), from the desired" - echo " end-point. For example, from the 'gentraf' point of view, outgoing requests will be translated as send" - echo " operations with corresponding waits for answers and successful result code (2001). CER/A are detected" - echo " creating a symbolic link to better reference them, and DPR/A are ignored." + echo " The resulting '$TESTCASE_BN' will have all the operations needed to program the test case and will be" + echo " written on same source directory referencing xml files as local-relative ones. Normally, 'change-dir'" + echo " operation will be used before programming to ease the procedure without having to copy the stuff into" + echo " installed ADML execution directory." echo - echo " The resulting 'testcase.txt' will have all the operations needed to program the test case and will be" - echo " written on same source directory referencing xml files as local-relative ones. Probably, 'change-dir'" - echo " operation will be used before programming to ease the procedure without having to copy the stuff into" - echo " installed ADML execution directory." + echo " Connection issues (CER/A), disconnect procedures (DPR/A), database populations and sanity checks are" + echo " not responsability for this script. Anyway, CER/A messages detected are symbolically linked with the" + echo " name 'ce..xml', and missing ones are created with a basic template which the user" + echo " could edit and fix with the appropiate values." echo - echo " Connection issues (CER/A), disconnect procedures (DPR/A), database populations and sanity checks are" - echo " not responsability for this script. Such operations shall be externally performed to guarantee that" - echo " programming this testcase is going to be valid in context of test execution." _exit } +# Check number: +isnumber() { + local re='^[0-9]+$' + [[ "$1" =~ $re ]] && return 0 + return 1 +} + +# $1: xml file +# Nested Result-Code's not supported here (i.e. charging application) +getResultCode () { + grep " frame) print $1 }') ) + fi + + local frame= + local mtd= + local found= + local _code= + local _isrequest= + for frame in ${frames[@]} + do + mtd=${frame}.metadata + [ ! -f $mtd ] && _exit "Unexpected error: can't found '$mtd' file !!" + + _code=$(grep ^code $mtd | cut -d= -f2) + _isrequest=$(grep ^isrequest $mtd | cut -d= -f2) + + [ $_code -ne $code -o $_isrequest -ne $isrequest ] && continue + + found="$(ls ${frame}.*.xml 2>/dev/null)" + [ -z "$found" ] && _exit "Unexpected error: can't found xml file for frame '${frame}' file !!" + echo $found + return 0 + done + + return 1 +} + +# $1: metadata file; $2: xml file; $3: check Result-Code indicator; $4: client/server (ADML node role) +update_testcase () { + # metadata aspect: + # + # date=Wed Oct 7 01:51:16 CEST 2015 + # timestamp=1444175476.212667000 + # src=gt_traf + # dst=vcbavipt + # code=258 + # isrequest=0 + # applicationid=16777238 + local mtd=$1 + local xml=$2 + local resultcode=$3 + local adml_type=$4 + + local wait_command=waitfe + # wait xml variant: + local waitxml_command=waitfe-xml + local send_command=sendxml2e + [ "$adml_type" = "server" ] && { wait_command=waitfc ; waitxml_command=waitfc-xml ; send_command=sendxml2c ; } + + + # Ignore disconnect peer messages on testcase format (they have no session-id): + grep "^code=282$" $mtd > /dev/null + [ $? -eq 0 ] && return + + local code=$(grep ^code $mtd | cut -d= -f2) + local isrequest=$(grep ^isrequest $mtd | cut -d= -f2) + local sessionid=$(grep Session-Id $xml | cut -d\" -f4) + local lines=$(wc -l $TESTCASE_BN | awk '{ print $1 }') + + local s_wait="test|1|$wait_command|$code|$((1-isrequest))" + # wait xml variant: + local this_frame=$(echo $xml | cut -d\. -f1) + local pairxml=$(search_xml $code $((1-isrequest)) $this_frame) + local s_waitxml="test|1|$waitxml_command|$pairxml" + + [ -n "$sessionid" ] && s_wait="${s_wait}|||${sessionid}" + + local s_send="test|1|$send_command|$xml" + + if [ $isrequest -eq 1 ] + then + # Send the request + # Special case for SNR/SNA (code=8388636) and STR (code=275) going to SAPC: the Session-Id is created on client and received on SLR previously + if [ "$adml_type" = "server" ] + then + if [ "$code" = "8388636" -o "$code" = "275" ] + then + s_send="test|1|$send_command|$xml|$REQUEST_STEP" + s_wait="test|1|$wait_command|$code|0|||" + fi + fi + + echo "$s_send" >> $TESTCASE_BN + + if [ -n "$resultcode" ] + then + local hbh="$(grep -o "hop-by-hop-id=\"[0-9]*\"" $xml)" + local hbh_matchs=( $(grep -l "$hbh" *.xml) ) + local ans_xml=${hbh_matchs[1]} + local rc=2001 + if [ -n "$ans_xml" ] + then + _rc=$(getResultCode $ans_xml) + [ -n "$_rc" ] && rc=$_rc + fi + + # Wait the answer: + s_wait="${s_wait}|${rc}" + fi + + # Wait step: + if [ "$VARIANT" = "fast" ] + then + echo "$s_wait" >> $TESTCASE_BN + else + echo "$s_waitxml" >> $TESTCASE_BN + fi + + else + local next_step_number=$((lines+1)) + + # Wait the request + # Special case for SLR/SLA (code=8388635) and STR (code=275) coming from SAPC: the Session-Id is created on client + if [ "$adml_type" = "server" ] + then + if [ "$code" = "8388635" -o "$code" = "275" ] + then + s_wait="test|1|$wait_command|$code|1" + REQUEST_STEP=$next_step_number + fi + fi + + # Wait step: + if [ "$VARIANT" = "fast" ] + then + echo "$s_wait" >> $TESTCASE_BN + else + echo "$s_waitxml" >> $TESTCASE_BN + fi + + # Send the answer + echo "test|1|$send_command|$xml|$next_step_number" >> $TESTCASE_BN + fi +} + ############# # EXECUTION # ############# -cd $SCR_DIR -source ../../configure.sh -echo SOURCE_DIR=$1 [ -z "$SOURCE_DIR" ] && usage SOURCE_DIR=`readlink -f $SOURCE_DIR` [ ! -d "$SOURCE_DIR" ] && _exit "Can't found provided directory '$SOURCE_DIR'" +# Work on source directory: +cd $SOURCE_DIR + +# Must have metadata: +ls *.*metadata >/dev/null 2>/dev/null +[ $? -ne 0 ] && _exit "Cannot found '*.*metadata' files on '$SOURCE_DIR' !!" + +# Check origin-hosts: +ohs_file=$SOURCE_DIR/origin-hosts +[ ! -f $ohs_file ] && _exit "Can't found the mandatory file '$ohs_file' !!" +awk '{ print $NF }' $ohs_file | egrep -qw 'client|server' +[ ${PIPESTATUS[1]} -ne 0 ] && _exit "Can't found any Origin-Host in '$ohs_file' with a valid ADML node role value (client or server) !!" + +# Identify useful frames: those which are created at test-bed side (all except frames coming from tested systems): +0> .involved_frames +0> .involved_origin_hosts +n_involved_frames=0 +for oh in `awk '{ print $1 }' $ohs_file` +do + for frame in $(grep -l "^originhost=$oh$" *.*metadata | cut -d\. -f1) + do + echo "$frame" >> .involved_frames + echo "$oh" >> .involved_origin_hosts + n_involved_frames=$((n_involved_frames + 1)) + done +done +[ $n_involved_frames -eq 0 ] && _exit "No frame has been selected within '$SOURCE_DIR' for provided origin-hosts file !!" +sort .involved_frames > .involved_frames_sort +mv .involved_frames_sort .involved_frames + +# Messages classification: +#0> cers_4_starting +#0> ceas_4_establishing +0> cers_4_starting_origin_hosts +0> ceas_4_establishing_origin_hosts +0> requests_4_sending +0> answers_4_programming +0> $TESTCASE_BN + +# Optional timeout: +TIMEOUT_SEC=$2 +isnumber $TIMEOUT_SEC +[ $? -eq 0 ] && echo "test|1|timeout|$((TIMEOUT_SEC * 1000))" >> $TESTCASE_BN + +# Variant: +VARIANT=$VARIANT__dflt +[ "$3" = "fast" ] && VARIANT=fast + +# Process frames: +for frame in `cat .involved_frames` +do + mtd=( `ls ${frame}.*metadata 2>/dev/null` ) + [ ${#mtd[@]} -ne 1 ] && _exit "There must be one metadata file corresponding to frame '$frame' !!" + xml=( `ls ${frame}.*xml 2>/dev/null` ) + [ ${#xml[@]} -ne 1 ] && _exit "There must be one xml message file corresponding to '$mtd' (frame '$frame') !!" + originHost=$(grep ^originhost= ${frame}.metadata | cut -d= -f2-) + + # Ignore keep alives: + grep -q "^code=280$" $mtd + [ $? -eq 0 ] && continue + + grep -q "^isrequest=1$" $mtd + if [ $? -eq 0 ] + then + # CER's: + grep -q "^code=257$" $mtd + if [ $? -eq 0 ] + then + #echo $frame >> cers_4_starting + [ -z "$originHost" ] && _exit "Missing Origin-Host (frame $frame, CER message) !!" + echo "$originHost" >> cers_4_starting_origin_hosts + ln -sf $xml cer.${originHost}.xml + continue + fi + # Other requests: + echo $frame >> requests_4_sending + + # client or server: + adml_type=$(grep -w "$originHost" $ohs_file | awk '{ print $NF }') + update_testcase $mtd $xml check_result_code $adml_type + else + # CEA's: + grep -q "^code=257$" $mtd + if [ $? -eq 0 ] + then + #echo $frame >> ceas_4_establishing + originHost=$(grep ^originhost= ${frame}.metadata | cut -d= -f2-) + [ -z "$originHost" ] && _exit "Missing Origin-Host (frame $frame, CEA message) !!" + echo "$originHost" >> ceas_4_establishing_origin_hosts + ln -sf $xml cea.${originHost}.xml + continue + fi + # Other answers: + echo $frame >> answers_4_programming + + # client or server: + adml_type=$(grep -w "$originHost" $ohs_file | awk '{ print $NF }') + update_testcase $mtd $xml "" $adml_type + fi +done + + +# We will replace all the requests hop-by-hop's with a unique value, to avoid bad sniffing cases (different sources using bad values). +# For example, the frame number could be valid enough. +hbh_ini= +hbh_fin= +for frame in `cat .involved_frames` +do + xml=( `ls ${frame}.*xml` ) + mtd=( `ls ${frame}.*metadata` ) + isrequest=$(grep "isrequest=1" $mtd) + if [ -n "$isrequest" ] + then + hbh_ini="$(grep -o "hop-by-hop-id=\"[0-9]*\"" $xml)" + sed -i 's/'$hbh_ini'/hop-by-hop-id="'$frame'"/' $xml + fi +done +rm .involved_frames + +# Simplify origin hosts file (oh + adml role): +sort -u .involved_origin_hosts > .involved_origin_hosts_unique +grep -w -f .involved_origin_hosts_unique $ohs_file > .involved_origin_hosts_with_info +mv .involved_origin_hosts_with_info $ohs_file +rm .involved_origin_hosts .involved_origin_hosts_unique + +# Missing CERs: +for oh in $(awk -v input=client '{if ($2 == input) print $1;}' $ohs_file) +do + cer=$SOURCE_DIR/cer.${oh}.xml + if [ ! -f $cer ] + then + echo $oh >> cers_4_starting_origin_hosts + echo "Missing CER: `basename $cer` (a basic template has been created, please edit & fix the unknowns)" + cat << EOF > $cer + + + + + + + + + + +EOF + fi +done + +# Missing CEAs: +for oh in $(awk -v input=server '{if ($2 == input) print $1;}' $ohs_file) +do + cea=$SOURCE_DIR/cea.${oh}.xml + if [ ! -f $cea ] + then + echo $oh >> ceas_4_establishing_origin_hosts + echo "Missing CEA: `basename $cea` (a basic template has been created, please edit & fix the unknowns)" + cat << EOF > $cea + + + + + + + + + + + + + + + + + + + + + +EOF + fi +done + +exit 0 -# UNDER CONSTRUCTION -# .........