Updated test env documentation
[nonrtric.git] / test / common / ricsim_api_functions.sh
1 #!/bin/bash
2
3 #  ============LICENSE_START===============================================
4 #  Copyright (C) 2020-2023 Nordix Foundation. All rights reserved.
5 #  ========================================================================
6 #  Licensed under the Apache License, Version 2.0 (the "License");
7 #  you may not use this file except in compliance with the License.
8 #  You may obtain a copy of the License at
9 #
10 #       http://www.apache.org/licenses/LICENSE-2.0
11 #
12 #  Unless required by applicable law or agreed to in writing, software
13 #  distributed under the License is distributed on an "AS IS" BASIS,
14 #  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 #  See the License for the specific language governing permissions and
16 #  limitations under the License.
17 #  ============LICENSE_END=================================================
18 #
19
20 # This is a script that contains container/service management functions and test functions for RICSIM A1 simulators
21
22 ################ Test engine functions ################
23
24 # Create the image var used during the test
25 # arg: <image-tag-suffix> (selects staging, snapshot, release etc)
26 # <image-tag-suffix> is present only for images with staging, snapshot,release tags
27 __RICSIM_imagesetup() {
28         __check_and_create_image_var RICSIM "RIC_SIM_IMAGE" "RIC_SIM_IMAGE_BASE" "RIC_SIM_IMAGE_TAG" $1 "$RIC_SIM_DISPLAY_NAME" ""
29 }
30
31 # Pull image from remote repo or use locally built image
32 # arg: <pull-policy-override> <pull-policy-original>
33 # <pull-policy-override> Shall be used for images allowing overriding. For example use a local image when test is started to use released images
34 # <pull-policy-original> Shall be used for images that does not allow overriding
35 # Both var may contain: 'remote', 'remote-remove' or 'local'
36 __RICSIM_imagepull() {
37         __check_and_pull_image $1 "$RIC_SIM_DISPLAY_NAME" $RIC_SIM_PREFIX"_"$RIC_SIM_BASE RIC_SIM_IMAGE
38 }
39
40 # Generate a string for each included image using the app display name and a docker images format string
41 # If a custom image repo is used then also the source image from the local repo is listed
42 # arg: <docker-images-format-string> <file-to-append>
43 __RICSIM_image_data() {
44         echo -e "$RIC_SIM_DISPLAY_NAME\t$(docker images --format $1 $RIC_SIM_IMAGE)" >>   $2
45         if [ ! -z "$RIC_SIM_IMAGE_SOURCE" ]; then
46                 echo -e "-- source image --\t$(docker images --format $1 $RIC_SIM_IMAGE_SOURCE)" >>   $2
47         fi
48 }
49
50 # Scale kubernetes resources to zero
51 # All resources shall be ordered to be scaled to 0, if relevant. If not relevant to scale, then do no action.
52 # This function is called for apps fully managed by the test script
53 __RICSIM_kube_scale_zero() {
54         __kube_scale_all_resources $KUBE_A1SIM_NAMESPACE autotest RICSIM
55 }
56
57 # Scale kubernetes resources to zero and wait until this has been accomplished, if relevant. If not relevant to scale, then do no action.
58 # This function is called for pre-started apps not managed by the test script.
59 __RICSIM_kube_scale_zero_and_wait() {
60         #__kube_scale_and_wait_all_resources $KUBE_A1SIM_NAMESPACE app $KUBE_A1SIM_NAMESPACE"-"$RIC_SIM_PREFIX
61         __kube_scale_and_wait_all_resources $KUBE_A1SIM_NAMESPACE app $KUBE_A1SIM_NAMESPACE"-a1simulator"
62 }
63
64 # Delete all kube resources for the app
65 # This function is called for apps managed by the test script.
66 __RICSIM_kube_delete_all() {
67         __kube_delete_all_resources $KUBE_A1SIM_NAMESPACE autotest RICSIM
68 }
69
70 # Store docker logs
71 # This function is called for apps managed by the test script.
72 # args: <log-dir> <file-prefix>
73 __RICSIM_store_docker_logs() {
74         if [ $RUNMODE == "KUBE" ]; then
75                 for podname in $(kubectl $KUBECONF get pods -n $KUBE_A1SIM_NAMESPACE -l "autotest=RICSIM" -o custom-columns=":metadata.name"); do
76                         kubectl $KUBECONF logs -n $KUBE_A1SIM_NAMESPACE $podname --tail=-1 > $1$2_$podname.log 2>&1
77                 done
78         else
79
80                 rics=$(docker ps --filter "name=$RIC_SIM_PREFIX" --filter "network=$DOCKER_SIM_NWNAME" --filter "status=running" --filter "label=a1sim" --format {{.Names}})
81                 for ric in $rics; do
82                         docker logs $ric > $1$2_$ric.log 2>&1
83                 done
84         fi
85 }
86
87 # Initial setup of protocol, host and ports
88 # This function is called for apps managed by the test script.
89 # args: -
90 __RICSIM_initial_setup() {
91         use_simulator_http
92 }
93
94 # Set app short-name, app name and namespace for logging runtime statistics of kubernetes pods or docker containers
95 # For docker, the namespace shall be excluded
96 # This function is called for apps managed by the test script as well as for pre-started apps.
97 # args: -
98 __RICSIM_statistics_setup() {
99         for ((RICSIM_INSTANCE=10; RICSIM_INSTANCE>0; RICSIM_INSTANCE-- )); do
100                 if [ $RUNMODE == "KUBE" ]; then
101                         RICSIM_INSTANCE_KUBE=$(($RICSIM_INSTANCE-1))
102                         echo -n " RICSIM_G1_$RICSIM_INSTANCE_KUBE ${RIC_SIM_PREFIX}-g1-$RICSIM_INSTANCE_KUBE $KUBE_A1SIM_NAMESPACE "
103                         echo -n " RICSIM_G2_$RICSIM_INSTANCE_KUBE ${RIC_SIM_PREFIX}-g2-$RICSIM_INSTANCE_KUBE $KUBE_A1SIM_NAMESPACE "
104                         echo -n " RICSIM_G3_$RICSIM_INSTANCE_KUBE ${RIC_SIM_PREFIX}-g3-$RICSIM_INSTANCE_KUBE $KUBE_A1SIM_NAMESPACE "
105                 else
106                         if [ $DOCKER_COMPOSE_VERSION == "V1" ]; then
107                                 echo -n " RICSIM_G1_$RICSIM_INSTANCE ${RIC_SIM_PREFIX}_g1_$RICSIM_INSTANCE "
108                                 echo -n " RICSIM_G2_$RICSIM_INSTANCE ${RIC_SIM_PREFIX}_g2_$RICSIM_INSTANCE "
109                                 echo -n " RICSIM_G3_$RICSIM_INSTANCE ${RIC_SIM_PREFIX}_g3_$RICSIM_INSTANCE "
110                         else
111                                 echo -n " RICSIM_G1_$RICSIM_INSTANCE ${RIC_SIM_PREFIX}-g1-$RICSIM_INSTANCE "
112                                 echo -n " RICSIM_G2_$RICSIM_INSTANCE ${RIC_SIM_PREFIX}-g2-$RICSIM_INSTANCE "
113                                 echo -n " RICSIM_G3_$RICSIM_INSTANCE ${RIC_SIM_PREFIX}-g3-$RICSIM_INSTANCE "
114                         fi
115                 fi
116         done
117 }
118
119 # Check application requirements, e.g. helm, the the test needs. Exit 1 if req not satisfied
120 # args: -
121 __RICSIM_test_requirements() {
122         :
123 }
124
125 #######################################################
126
127
128 RIC_SIM_HTTPX="http"
129 RIC_SIM_PORT=$RIC_SIM_INTERNAL_PORT
130
131
132 #Vars for container count
133 G1_COUNT=0
134 G2_COUNT=0
135 G3_COUNT=0
136 G4_COUNT=0
137 G5_COUNT=0
138
139
140 ###########################
141 ### RIC Simulator functions
142 ###########################
143
144 use_simulator_http() {
145         echo -e $BOLD"RICSIM protocol setting"$EBOLD
146         echo -e " Using $BOLD http $EBOLD towards the simulators"
147         RIC_SIM_HTTPX="http"
148         RIC_SIM_PORT=$RIC_SIM_INTERNAL_PORT
149         echo ""
150 }
151
152 use_simulator_https() {
153         echo -e $BOLD"RICSIM protocol setting"$EBOLD
154         echo -e " Using $BOLD https $EBOLD towards the simulators"
155         RIC_SIM_HTTPX="https"
156         RIC_SIM_PORT=$RIC_SIM_INTERNAL_SECURE_PORT
157         echo ""
158 }
159
160 # Start one group (ricsim_g1, ricsim_g2 .. ricsim_g5) with a number of RIC Simulators using a given A interface
161 # 'ricsim' may be set on command line to other prefix
162 # args:  ricsim_g1|ricsim_g2|ricsim_g3|ricsim_g4|ricsim_g5 <count> <interface-id>
163 # (Function for test scripts)
164 start_ric_simulators() {
165
166         echo -e $BOLD"Starting $RIC_SIM_DISPLAY_NAME"$EBOLD
167
168         if [ $RUNMODE == "KUBE" ]; then
169
170                 # Check if app shall be fully managed by the test script
171                 __check_included_image "RICSIM"
172                 retcode_i=$?
173
174                 # Check if app shall only be used by the test script
175                 __check_prestarted_image "RICSIM"
176                 retcode_p=$?
177
178                 if [ $retcode_i -ne 0 ] && [ $retcode_p -ne 0 ]; then
179                         echo -e $RED"The $1 app is not included as managed nor prestarted in this test script"$ERED
180                         echo -e $RED"The $1 will not be started"$ERED
181                         exit
182                 fi
183                 if [ $retcode_i -eq 0 ] && [ $retcode_p -eq 0 ]; then
184                         echo -e $RED"The $1 stub app is included both as managed and prestarted in this test script"$ERED
185                         echo -e $RED"The $1 will not be started"$ERED
186                         exit
187                 fi
188
189                 if [ $retcode_p -eq 0 ]; then
190                         echo -e " Using existing $1 statefulset and service"
191                         echo " Using existing simulator deployment and service for statefulset $1"
192                         echo " Setting $1 replicas=$2"
193                         __kube_scale statefulset $1 $KUBE_A1SIM_NAMESPACE $2
194                         echo ""
195                         return
196                 fi
197         fi
198
199         RIC1=$RIC_SIM_PREFIX"_g1"
200         RIC2=$RIC_SIM_PREFIX"_g2"
201         RIC3=$RIC_SIM_PREFIX"_g3"
202         RIC4=$RIC_SIM_PREFIX"_g4"
203         RIC5=$RIC_SIM_PREFIX"_g5"
204
205         if [ $# != 3 ]; then
206                 ((RES_CONF_FAIL++))
207                 __print_err "need three args,  $RIC1|$RIC2|$RIC3|$RIC4|$RIC5 <count> <interface-id>" $@
208                 exit 1
209         fi
210
211         echo " $2 simulators using basename: $1 on interface: $3"
212         #Set env var for simulator count and A1 interface version for the given group
213         if [ $1 == "$RIC1" ]; then
214                 G1_COUNT=$2
215         elif [ $1 == "$RIC2" ]; then
216                 G2_COUNT=$2
217         elif [ $1 == "$RIC3" ]; then
218                 G3_COUNT=$2
219         elif [ $1 == "$RIC4" ]; then
220                 G4_COUNT=$2
221         elif [ $1 == "$RIC5" ]; then
222                 G5_COUNT=$2
223         else
224                 ((RES_CONF_FAIL++))
225                 __print_err "need three args, $RIC1|$RIC2|$RIC3|$RIC4|$RIC5 <count> <interface-id>" $@
226                 exit 1
227         fi
228
229         if [ $RUNMODE == "KUBE" ]; then
230
231                 if [ $retcode_i -eq 0 ]; then
232
233                         #export needed env var for statefulset
234                         export RIC_SIM_SET_NAME=$(echo "$1" | tr '_' '-')  #kube does not accept underscore in names
235                         export KUBE_A1SIM_NAMESPACE
236                         export RIC_SIM_IMAGE
237                         #Adding 1 more instance, instance 0 is never used. This is done to keep test scripts compatible
238                         # with docker that starts instance index on 1.....
239                         export RIC_SIM_COUNT=$(($2+1))
240                         export A1_VERSION=$3
241                         export RIC_SIM_INTERNAL_PORT
242                         export RIC_SIM_INTERNAL_SECURE_PORT
243
244                         echo -e " Creating $RIC_SIM_PREFIX app and expose service"
245
246                         #Check if nonrtric namespace exists, if not create it
247                         __kube_create_namespace $KUBE_A1SIM_NAMESPACE
248
249                         # Create service
250                         input_yaml=$SIM_GROUP"/"$RIC_SIM_COMPOSE_DIR"/"svc.yaml
251                         output_yaml=$PWD/tmp/ric_${1}_svc.yaml
252                         __kube_create_instance service $RIC_SIM_SET_NAME $input_yaml $output_yaml
253
254                         # Create app
255                         input_yaml=$SIM_GROUP"/"$RIC_SIM_COMPOSE_DIR"/"app.yaml
256                         output_yaml=$PWD/tmp/ric_${1}_app.yaml
257                         __kube_create_instance app $RIC_SIM_SET_NAME $input_yaml $output_yaml
258
259                         #Using only instance from index 1 to keep compatability with docker
260                         for (( count=1; count<${RIC_SIM_COUNT}; count++ )); do
261                                 host=$(__find_sim_host $RIC_SIM_SET_NAME"-"$count)
262                                 __check_service_start $RIC_SIM_SET_NAME"-"$count $host"/"
263                         done
264                 fi
265         else
266                 __check_included_image 'RICSIM'
267                 if [ $? -eq 1 ]; then
268                         echo -e $RED"The Near-RT RIC Simulator app is not included as managed in this test script"$ERED
269                         echo -e $RED"Near-RT RIC Simulator will not be started"$ERED
270                         exit 1
271                 fi
272
273                 # Create .env file to compose project, all ric container will get this prefix
274                 echo "COMPOSE_PROJECT_NAME="$RIC_SIM_PREFIX > $SIM_GROUP/$RIC_SIM_COMPOSE_DIR/.env
275
276                 #extract service name (group), g1, g2, g3, g4 or g5 from var $1
277                 #E.g. ricsim_g1 -> g1 is the service name
278                 TMP_GRP=$1
279                 RICSIM_COMPOSE_SERVICE_NAME=$(echo "${TMP_GRP##*_}")
280
281                 export RICSIM_COMPOSE_A1_VERSION=$3
282                 export RICSIM_COMPOSE_SERVICE_NAME
283                 export RIC_SIM_INTERNAL_PORT
284                 export RIC_SIM_INTERNAL_SECURE_PORT
285                 export RIC_SIM_CERT_MOUNT_DIR
286                 export DOCKER_SIM_NWNAME
287                 export RIC_SIM_DISPLAY_NAME
288
289                 echo -e $BOLD$YELLOW" Warning: Using docker compose --force-recreate "$EYELLOW$EBOLD
290                 docker_args="--force-recreate --scale $RICSIM_COMPOSE_SERVICE_NAME=$2"
291
292                 #Create a list of container names
293                 #Will be <ricsim-prefix>_<service-name>_<index>
294                 # or
295                 # <ricsim-prefix>-<service-name>-<index>
296                 app_data=""
297                 cntr=1
298                 if [ $DOCKER_COMPOSE_VERSION == "V1" ]; then
299                         app_name_prefix=$RIC_SIM_PREFIX"_"$RICSIM_COMPOSE_SERVICE_NAME"_"
300                 else
301                         app_name_prefix=$RIC_SIM_PREFIX"-"$RICSIM_COMPOSE_SERVICE_NAME"-"
302                 fi
303                 while [ $cntr -le $2 ]; do
304                         app=$app_name_prefix$cntr
305                         app_data="$app_data $app"
306                         let cntr=cntr+1
307                 done
308
309                 __start_container $RIC_SIM_COMPOSE_DIR "" "$docker_args" $2 $app_data
310
311                 cntr=1
312                 while [ $cntr -le $2 ]; do
313                         if [ $DOCKER_COMPOSE_VERSION == "V1" ]; then
314                                 app=$RIC_SIM_PREFIX"_"$RICSIM_COMPOSE_SERVICE_NAME"_"$cntr
315                         else
316                                 app=$RIC_SIM_PREFIX"-"$RICSIM_COMPOSE_SERVICE_NAME"-"$cntr
317                         fi
318                         __check_service_start $app $RIC_SIM_HTTPX"://"$app:$RIC_SIM_PORT$RIC_SIM_ALIVE_URL
319                         let cntr=cntr+1
320                 done
321
322         fi
323         echo ""
324         return 0
325 }
326
327 # Translate ric name to kube host name
328 # args: <ric-name>
329 # For test scripts
330 get_kube_sim_host() {
331         name=$(echo "$1" | tr '_' '-')  #kube does not accept underscore in names
332         #example gnb_1_2 -> gnb-1-2
333         set_name=$(echo $name | rev | cut -d- -f2- | rev) # Cut index part of ric name to get the name of statefulset
334         # example gnb-g1-2 -> gnb-g1 where gnb-g1-2 is the ric name and gnb-g1 is the set name
335         echo $name"."$set_name"."$KUBE_A1SIM_NAMESPACE
336 }
337
338 # Helper function to get a the port and host name of a specific ric simulator
339 # args: <ric-id>
340 # (Not for test scripts)
341 __find_sim_host() {
342         if [ $RUNMODE == "KUBE" ]; then
343                 ricname=$(echo "$1" | tr '_' '-') # Kube does not accept underscore in names as docker do
344                 if [ -z "$RIC_SIM_COMMON_SVC_NAME" ]; then
345                         ric_setname="${ricname%-*}"  #Extract the stateful set name
346                 else
347                         ric_setname=$RIC_SIM_COMMON_SVC_NAME # Use the common svc name in the host name of the sims
348                 fi
349                 echo $RIC_SIM_HTTPX"://"$ricname.$ric_setname.$KUBE_A1SIM_NAMESPACE":"$RIC_SIM_PORT
350         else
351                 if [ $DOCKER_COMPOSE_VERSION == "V1" ]; then
352                         echo $RIC_SIM_HTTPX"://"$1":"$RIC_SIM_PORT
353                 else
354                         ricname=$(echo "$1" | tr '_' '-')
355                         echo $RIC_SIM_HTTPX"://"$ricname":"$RIC_SIM_PORT
356                 fi
357
358         fi
359 }
360
361 # Generate a UUID to use as prefix for policy ids
362 sim_generate_policy_uuid() {
363         UUID=$(python3 -c 'import sys,uuid; sys.stdout.write(uuid.uuid4().hex)')
364         #Reduce length to make space for serial id, uses 'a' as marker where the serial id is added
365         UUID=${UUID:0:${#UUID}-4}"a"
366 }
367
368 # Execute a curl cmd towards a ricsimulator and check the response code.
369 # args: <expected-response-code> <curl-cmd-string>
370 __execute_curl_to_sim() {
371         echo ${FUNCNAME[1]} "line: "${BASH_LINENO[1]} >> $HTTPLOG
372         proxyflag=""
373         if [ ! -z "$KUBE_PROXY_PATH" ]; then
374                 if [ $KUBE_PROXY_HTTPX == "http" ]; then
375                         proxyflag=" --proxy $KUBE_PROXY_PATH"
376                 else
377                         proxyflag=" --proxy-insecure --proxy $KUBE_PROXY_PATH"
378                 fi
379         fi
380         if [ -z "$KUBE_PROXY_CURL_JWT" ]; then
381                 echo " CMD: $2 $proxyflag" >> $HTTPLOG
382                 res="$($2 $proxyflag)"
383         else
384                 echo " CMD: $2 $proxyflag -H Authorization: Bearer $KUBE_PROXY_CURL_JWT" >> $HTTPLOG
385                 res=$($2 $proxyflag -H 'Authorization: Bearer '$KUBE_PROXY_CURL_JWT)
386         fi
387
388         echo " RESP: $res" >> $HTTPLOG
389         retcode=$?
390     if [ $retcode -ne 0 ]; then
391                 ((RES_CONF_FAIL++))
392                 echo " RETCODE: "$retcode
393         echo -e $RED" FAIL - fatal error when executing curl."$ERED
394         return 1
395     fi
396     status=${res:${#res}-3}
397     if [ $status -eq $1 ]; then
398         echo -e $GREEN" OK"$EGREEN
399         return 0
400     fi
401     echo -e $RED" FAIL - expected http response: "$1" but got http response: "$status $ERED
402         ((RES_CONF_FAIL++))
403     return 1
404 }
405
406 # Tests if a variable value in the ricsimulator is equal to a target value and and optional timeout.
407 # Arg: <ric-id> <variable-name> <target-value> - This test set pass or fail depending on if the variable is
408 # equal to the target or not.
409 # Arg: <ric-id> <variable-name> <target-value> <timeout-in-sec>  - This test waits up to the timeout seconds
410 # before setting pass or fail depending on if the variable value becomes equal to the target
411 # value or not.
412 # (Function for test scripts)
413 sim_equal() {
414
415         if [ $# -eq 3 ] || [ $# -eq 4 ]; then
416                 host=$(__find_sim_host $1)
417                 __var_test $1 "$host/counter/" $2 "=" $3 $4
418                 return 0
419         else
420                 __print_err "needs three or four args: <ric-id> <sim-param> <target-value> [ timeout ]"
421                 return 1
422         fi
423 }
424
425 # Print a variable value from the RIC sim.
426 # args: <ric-id> <variable-name>
427 # (Function for test scripts)
428 sim_print() {
429
430         if [ $# != 2 ]; then
431         __print_err "need two args, <ric-id> <sim-param>" $@
432                 exit 1
433         fi
434         host=$(__find_sim_host $1)
435         echo -e $BOLD"INFO(${BASH_LINENO[0]}): $1, $2 = $(__do_curl $host/counter/$2)"$EBOLD
436 }
437
438 # Tests if a variable value in the RIC simulator contains the target string and and optional timeout
439 # Arg: <ric-id> <variable-name> <target-value> - This test set pass or fail depending on if the variable contains
440 # the target or not.
441 # Arg: <ric-id> <variable-name> <target-value> <timeout-in-sec>  - This test waits up to the timeout seconds
442 # before setting pass or fail depending on if the variable value contains the target
443 # value or not.
444 # (Function for test scripts)
445 sim_contains_str() {
446
447         if [ $# -eq 3 ] || [ $# -eq 4 ]; then
448                 host=$(__find_sim_host $1)
449                 __var_test $1 "$host/counter/" $2 "contain_str" $3 $4
450                 return 0
451         else
452                 __print_err "needs three or four args: <ric-id> <sim-param> <target-value> [ timeout ]"
453                 return 1
454         fi
455 }
456
457 # Simulator API: Put a policy type in a ric
458 # args: <response-code> <ric-id> <policy-type-id> <policy-type-file>
459 # (Function for test scripts)
460 sim_put_policy_type() {
461         __log_conf_start $@
462         if [ $# -ne 4 ]; then
463                 __print_err "<response-code> <ric-id> <policy-type-id> <policy-type-file>" $@
464                 return 1
465         fi
466         host=$(__find_sim_host $2)
467     curlString="curl -X PUT -skw %{http_code} "$host"/policytype?id="$3" -H Content-Type:application/json --data-binary @"$4
468         __execute_curl_to_sim $1 "$curlString"
469         return $?
470 }
471
472 # Simulator API: Delete a policy type in a ric
473 # <response-code> <ric-id> <policy-type-id>
474 # (Function for test scripts)
475 sim_delete_policy_type() {
476         __log_conf_start $@
477         if [ $# -ne 3 ]; then
478                 __print_err "<response-code> <ric-id> <policy_type_id>" $@
479                 return 1
480         fi
481         host=$(__find_sim_host $2)
482     curlString="curl -X DELETE -skw %{http_code} "$host"/policytype?id="$3
483     __execute_curl_to_sim $1 "$curlString"
484         return $?
485 }
486
487 # Simulator API: Delete instances (and status), for one ric
488 # <response-code> <ric-id>
489 # (Function for test scripts)
490 sim_post_delete_instances() {
491         __log_conf_start $@
492         if [ $# -ne 2 ]; then
493                 __print_err "<response-code> <ric-id>" $@
494                 return 1
495         fi
496         host=$(__find_sim_host $2)
497     curlString="curl -X POST -skw %{http_code} "$host"/deleteinstances"
498     __execute_curl_to_sim $1 "$curlString"
499         return $?
500 }
501
502 # Simulator API: Delete all (instances/types/statuses/settings), for one ric
503 # <response-code> <ric-id>
504 # (Function for test scripts)
505 sim_post_delete_all() {
506         __log_conf_start $@
507         if [ $# -ne 2 ]; then
508                 __print_err "<response-code> <numericic-id>" $@
509                 return 1
510         fi
511         host=$(__find_sim_host $2)
512     curlString="curl -X POST -skw %{http_code} "$host"/deleteall"
513     __execute_curl_to_sim $1 "$curlString"
514         return $?
515 }
516
517 # Simulator API: Set (or reset) response code for next A1 message, for one ric
518 # <response-code> <ric-id> [<forced_response_code>]
519 # (Function for test scripts)
520 sim_post_forcedresponse() {
521         __log_conf_start $@
522         if [ $# -ne 3 ]; then
523                 __print_err "<response-code> <ric-id> <forced_response_code>" $@
524                 return 1
525         fi
526         host=$(__find_sim_host $2)
527     curlString="curl -X POST -skw %{http_code} "$host"/forceresponse"
528         if [ $# -eq 3 ]; then
529                 curlString=$curlString"?code="$3
530         fi
531     __execute_curl_to_sim $1 "$curlString"
532         return $?
533 }
534
535 # Simulator API: Set (or reset) A1 response delay, for one ric
536 # <response-code> <ric-id> [<delay-in-seconds>]
537 # (Function for test scripts)
538 sim_post_forcedelay() {
539         __log_conf_start $@
540         if [ $# -ne 3 ]; then
541                 __print_err "<response-code> <ric-id> [<delay-in-seconds>]" $@
542                 return 1
543         fi
544         host=$(__find_sim_host $2)
545     curlString="curl -X POST -skw %{http_code} $host/forcedelay"
546         if [ $# -eq 3 ]; then
547                 curlString=$curlString"?delay="$3
548         fi
549     __execute_curl_to_sim $1 "$curlString"
550         return $?
551 }