6 SCR_DIR=`readlink -f $0 | xargs dirname`
7 TESTCASE_BN=testcase.txt
23 echo "Usage: $0 <source_directory> [seconds_timeout]"
25 echo " source_directory:"
26 echo " The source directory may contain .xml and .metadata files grouped by pairs and alphabetically classified,"
27 echo " and also (and this is VERY IMPORTANT), a file called 'origin-hosts' containing a list of Origin-Host"
28 echo " values that represents the point of view of the ADML testing system, together with the type of the"
29 echo " simulated ADML node (client/server):"
31 echo " <id>.hex.as.xml: ANNA-Diameter XML message format."
32 echo " <id>.metadata: Some decoded message information."
34 echo " origin-hosts: Example of content:"
35 echo " OCS3GPPNodeHostname.ocs3gpprealm.com server"
36 echo " ggsnNodeHostname.nodeHostRealm.com client"
38 echo " The order for the xml and metadata files comes from first dot-separated part (<id>), which is normally the"
39 echo " decoded frame from a pcap file. The xml files are ANNA-Diameter xml messages and a typical metadata file"
40 echo " would be something like this:"
41 echo " date=vie ene 29 15:37:14 CET 2016"
42 echo " timestamp=1454078234.050988000"
43 echo " src=192.168.14.42"
44 echo " dst=192.168.12.40"
47 echo " applicationid=0"
48 echo " originhost=OCSNodeHostname.ocsrealm.com"
50 echo " You can use the 'example/diameter/pcapDecoder/tsharkDecoder.sh' script over a pcap file, in order to get"
51 echo " the hexadecimal buffers and then process them with 'example/diameter/batchConverter' tool to get the xml"
52 echo " messages and metadata for each pcap diameter frame."
55 echo " seconds_timeout:"
56 echo " Timeout in seconds for the testcase. If not provided, no timeout will be programmed for the testcase."
60 echo " The resulting '$TESTCASE_BN' will have all the operations needed to program the test case and will be"
61 echo " written on same source directory referencing xml files as local-relative ones. Normally, 'change-dir'"
62 echo " operation will be used before programming to ease the procedure without having to copy the stuff into"
63 echo " installed ADML execution directory."
65 echo " Connection issues (CER/A), disconnect procedures (DPR/A), database populations and sanity checks are"
66 echo " not responsability for this script. Anyway, CER/A messages detected are symbolically linked with the"
67 echo " name 'ce<r/a>.<origin host>.xml', and missing ones are created with a basic template which the user"
68 echo " could edit and fix with the appropiate values."
74 # Nested Result-Code's not supported here (i.e. charging application)
76 grep "<avp name=\"Result-Code\"" $1 | awk -F'data=' '{ print $2 }' | cut -d\" -f2
79 # $1: metadata file; $2: xml file; $3: check Result-Code indicator; $4: client/server (ADML node role)
83 # date=Wed Oct 7 01:51:16 CEST 2015
84 # timestamp=1444175476.212667000
89 # applicationid=16777238
95 local wait_command=waitfe
97 local waitxml_command=waitfe-xml
98 local send_command=sendxml2e
99 [ "$adml_type" = "server" ] && { wait_command=waitfc ; waitxml_command=waitfc-xml ; send_command=sendxml2c ; }
102 # Ignore disconnect peer messages on testcase format (they have no session-id):
103 grep "^code=282$" $mtd > /dev/null
104 [ $? -eq 0 ] && return
106 local code=$(grep ^code $mtd | cut -d= -f2)
107 local isrequest=$(grep ^isrequest $mtd | cut -d= -f2)
108 local sessionid=$(grep Session-Id $xml | cut -d\" -f4)
109 local lines=$(wc -l $TESTCASE_BN | awk '{ print $1 }')
111 local s_wait="test|1|$wait_command|$code|$((1-isrequest))"
113 local s_waitxml="test|1|$waitxml_command|$xml"
114 [ -n "$sessionid" ] && s_wait="${s_wait}|||${sessionid}"
116 local s_send="test|1|$send_command|$xml"
118 if [ $isrequest -eq 1 ]
121 # 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
122 if [ "$adml_type" = "server" ]
124 if [ "$code" = "8388636" -o "$code" = "275" ]
126 s_send="test|1|$send_command|$xml|$REQUEST_STEP"
127 s_wait="test|1|$wait_command|$code|0|||"
131 echo "$s_send" >> $TESTCASE_BN
133 if [ -n "$resultcode" ]
135 local hbh="$(grep -o "hop-by-hop-id=\"[0-9]*\"" $xml)"
136 local hbh_matchs=( $(grep -l "$hbh" *.xml) )
137 local ans_xml=${hbh_matchs[1]}
141 _rc=$(getResultCode $ans_xml)
142 [ -n "$_rc" ] && rc=$_rc
146 s_wait="${s_wait}|${rc}"
148 echo "$s_waitxml" >> $TESTCASE_BN
149 echo "#$s_wait" >> $TESTCASE_BN
151 local next_step_number=$((lines+1))
154 # Special case for SLR/SLA (code=8388635) and STR (code=275) coming from SAPC: the Session-Id is created on client
155 if [ "$adml_type" = "server" ]
157 if [ "$code" = "8388635" -o "$code" = "275" ]
159 s_wait="test|1|$wait_command|$code|1"
160 REQUEST_STEP=$next_step_number
163 echo "$s_wait" >> $TESTCASE_BN
166 echo "test|1|$send_command|$xml|$next_step_number" >> $TESTCASE_BN
174 [ -z "$SOURCE_DIR" ] && usage
175 SOURCE_DIR=`readlink -f $SOURCE_DIR`
176 [ ! -d "$SOURCE_DIR" ] && _exit "Can't found provided directory '$SOURCE_DIR'"
177 # Work on source directory:
180 # Must have metadata:
181 ls *.*metadata >/dev/null 2>/dev/null
182 [ $? -ne 0 ] && _exit "Cannot found '*.*metadata' files on '$SOURCE_DIR' !!"
184 # Check origin-hosts:
185 ohs_file=$SOURCE_DIR/origin-hosts
186 [ ! -f $ohs_file ] && _exit "Can't found the mandatory file '$ohs_file' !!"
187 awk '{ print $NF }' $ohs_file | egrep -qw 'client|server'
188 [ ${PIPESTATUS[1]} -ne 0 ] && _exit "Can't found any Origin-Host in '$ohs_file' with a valid ADML node role value (client or server) !!"
190 # Identify useful frames: those which are created at test-bed side (all except frames coming from tested systems):
192 0> .involved_origin_hosts
194 for oh in `awk '{ print $1 }' $ohs_file`
196 for frame in $(grep -l "^originhost=$oh$" *.*metadata | cut -d\. -f1)
198 echo "$frame" >> .involved_frames
199 echo "$oh" >> .involved_origin_hosts
200 n_involved_frames=$((n_involved_frames + 1))
203 [ $n_involved_frames -eq 0 ] && _exit "No frame has been selected within '$SOURCE_DIR' for provided origin-hosts file !!"
204 sort .involved_frames > .involved_frames_sort
205 mv .involved_frames_sort .involved_frames
207 # Messages classification:
209 #0> ceas_4_establishing
210 0> cers_4_starting_origin_hosts
211 0> ceas_4_establishing_origin_hosts
212 0> requests_4_sending
213 0> answers_4_programming
218 [ -n "$TIMEOUT_SEC" ] && echo "test|1|timeout|$((TIMEOUT_SEC * 1000))" >> $TESTCASE_BN
221 for frame in `cat .involved_frames`
223 mtd=( `ls ${frame}.*metadata 2>/dev/null` )
224 [ ${#mtd[@]} -ne 1 ] && _exit "There must be one metadata file corresponding to frame '$frame' !!"
225 xml=( `ls ${frame}.*xml 2>/dev/null` )
226 [ ${#xml[@]} -ne 1 ] && _exit "There must be one xml message file corresponding to '$mtd' (frame '$frame') !!"
227 originHost=$(grep ^originhost= ${frame}.metadata | cut -d= -f2-)
229 # Ignore keep alives:
230 grep -q "^code=280$" $mtd
231 [ $? -eq 0 ] && continue
233 grep -q "^isrequest=1$" $mtd
237 grep -q "^code=257$" $mtd
240 #echo $frame >> cers_4_starting
241 [ -z "$originHost" ] && _exit "Missing Origin-Host (frame $frame, CER message) !!"
242 echo "$originHost" >> cers_4_starting_origin_hosts
243 ln -sf $xml cer.${originHost}.xml
247 echo $frame >> requests_4_sending
250 adml_type=$(grep -w "$originHost" $ohs_file | awk '{ print $NF }')
251 update_testcase $mtd $xml check_result_code $adml_type
254 grep -q "^code=257$" $mtd
257 #echo $frame >> ceas_4_establishing
258 originHost=$(grep ^originhost= ${frame}.metadata | cut -d= -f2-)
259 [ -z "$originHost" ] && _exit "Missing Origin-Host (frame $frame, CEA message) !!"
260 echo "$originHost" >> ceas_4_establishing_origin_hosts
261 ln -sf $xml cea.${originHost}.xml
265 echo $frame >> answers_4_programming
268 adml_type=$(grep -w "$originHost" $ohs_file | awk '{ print $NF }')
269 update_testcase $mtd $xml "" $adml_type
274 # We will replace all the requests hop-by-hop's with a unique value, to avoid bad sniffing cases (different sources using bad values).
275 # For example, the frame number could be valid enough.
278 for frame in `cat .involved_frames`
280 xml=( `ls ${frame}.*xml` )
281 mtd=( `ls ${frame}.*metadata` )
282 isrequest=$(grep "isrequest=1" $mtd)
283 if [ -n "$isrequest" ]
285 hbh_ini="$(grep -o "hop-by-hop-id=\"[0-9]*\"" $xml)"
286 sed -i 's/'$hbh_ini'/hop-by-hop-id="'$frame'"/' $xml
291 # Simplify origin hosts file (oh + adml role):
292 sort -u .involved_origin_hosts > .involved_origin_hosts_unique
293 grep -w -f .involved_origin_hosts_unique $ohs_file > .involved_origin_hosts_with_info
294 mv .involved_origin_hosts_with_info $ohs_file
295 rm .involved_origin_hosts .involved_origin_hosts_unique
298 for oh in $(awk -v input=client '{if ($2 == input) print $1;}' $ohs_file)
300 cer=$SOURCE_DIR/cer.${oh}.xml
303 echo $oh >> cers_4_starting_origin_hosts
304 echo "Missing CER: `basename $cer` (a basic template has been created, please edit & fix the unknowns)"
306 <message version="1" name="CER" application-id="0" hop-by-hop-id="1" end-to-end-id="1">
307 <avp name="Origin-Host" data="$oh"/>
308 <avp name="Origin-Realm" data="$(echo $oh | cut -d\. -f2-) $WHAT"/>
309 <avp name="Auth-Application-Id" data="16777236 $WHAT 16777238 $WHAT"/>
310 <avp name="Origin-State-Id" data="1"/>
311 <avp name="Host-IP-Address" data="1|192.168.14.42 $WHAT"/>
312 <avp name="Vendor-Id" data="193"/>
313 <avp name="Product-Name" data="afNode $WHAT ggsnNode $WHAT"/>
314 <avp name="Firmware-Revision" data="1"/>
321 for oh in $(awk -v input=server '{if ($2 == input) print $1;}' $ohs_file)
323 cea=$SOURCE_DIR/cea.${oh}.xml
326 echo $oh >> ceas_4_establishing_origin_hosts
327 echo "Missing CEA: `basename $cea` (a basic template has been created, please edit & fix the unknowns)"
329 <message version="1" name="CEA" application-id="0" hop-by-hop-id="1" end-to-end-id="1">
330 <avp name="Result-Code" data="2001" alias="DIAMETER_SUCCESS"/>
331 <avp name="Origin-Host" data="$oh"/>
332 <avp name="Origin-Realm" data="$(echo $oh | cut -d\. -f2-) $WHAT"/>
333 <avp name="Host-IP-Address" data="1|192.168.12.42 $WHAT"/>
334 <avp name="Vendor-Id" data="193"/>
335 <avp name="Product-Name" data="SAPC"/>
336 <avp name="Supported-Vendor-Id" data="5535"/>
337 <avp name="Supported-Vendor-Id" data="10415"/>
338 <avp name="Auth-Application-Id" data="16777238"/>
339 <avp name="Auth-Application-Id" data="16777236"/>
340 <avp name="Vendor-Specific-Application-Id">
341 <avp name="Vendor-Id" data="10415"/>
342 <avp name="Auth-Application-Id" data="16777238"/>
344 <avp name="Vendor-Specific-Application-Id">
345 <avp name="Vendor-Id" data="10415"/>
346 <avp name="Auth-Application-Id" data="16777236"/>
348 <avp name="Firmware-Revision" data="1"/>