2 # vim: ts=4 sw=4 noet :
3 #==================================================================================
4 # Copyright (c) 2019-2021 Nokia
5 # Copyright (c) 2018-2021 AT&T Intellectual Property.
7 # Licensed under the Apache License, Version 2.0 (the "License");
8 # you may not use this file except in compliance with the License.
9 # You may obtain a copy of the License at
11 # http://www.apache.org/licenses/LICENSE-2.0
13 # Unless required by applicable law or agreed to in writing, software
14 # distributed under the License is distributed on an "AS IS" BASIS,
15 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16 # See the License for the specific language governing permissions and
17 # limitations under the License.
18 #==================================================================================
21 # ---------------------------------------------------------------------------------
22 # Mnemonic: run_lcall_test.ksh
23 # Abstract: This is a simple script to set up and run the basic send/receive
24 # processes for some library validation on top of nng. This
25 # particular test starts the latency caller and latency receiver
26 # processes such that they exchange messages and track the latency
27 # from the caller's perepective (both outbound to receiver, and then
28 # back. Stats are presented at the end. This test is NOT intended
29 # to be used as a CI validation test.
31 # The sender and receiver processes all have a 20s timeout (+/-)
32 # which means that all messages must be sent, and acked within that
33 # time or the processes will give up and report failure. Keep in mind
34 # that n messages with a delay value (-d) set will affect whether or
35 # not the messages can be sent in the 20s timeout period. There is
36 # currently no provision to adjust the timeout other than by changing
37 # the C source. The default (100 msgs with 500 micro-sec delay) works
38 # just fine for base testing.
40 # Example command line:
41 # # run with 10 caller threads sending 10,000 meessages each,
42 # # 5 receivers, and a 10 mu-s delay between each caller send
43 # ksh ./run_lcall_test.ksh -d 10 -n 10000 -r 5 -c 10
46 # Author: E. Scott Daniels
47 # ---------------------------------------------------------------------------------
50 # The sender and receivers are run asynch. Their exit statuses are captured in a
51 # file in order for the 'main' to pick them up easily.
54 ./lcaller ${nmsg:-10} ${delay:-500} ${cthreads:-3}
55 echo $? >/tmp/PID$$.src # must communicate state back via file b/c asynch
58 # $1 is the instance so we can keep logs separate
62 port=$(( 4460 + ${1:-0} ))
63 export RMR_RTG_SVC=$(( 9990 + $1 ))
64 ./lreceiver $(( ((nmsg * cthreads)/nrcvrs) + 10 )) $port
65 echo $? >/tmp/PID$$.$1.rrc
68 # Drop a contrived route table in such that the sender sends each message to n
73 typeset groups="127.0.0.1:4460"
74 for (( i=1; i < ${1:-3}; i++ ))
76 groups="$groups,127.0.0.1:$((port+i))"
79 cat <<endKat >lcall.rt
97 # ---------------------------------------------------------
99 if [[ ! -f local.rt ]] # we need the real host name in the local.rt; build one from mask if not there
102 sed "s!%%hostname%%!$hn!" rt.mask >local.rt
105 export RMR_ASYNC_CONN=0 # ensure we don't lose first msg as drops waiting for conn look like errors
106 cthreads=3 # number of caller threads
107 nmsg=100 # total number of messages to be exchanged (-n value changes)
108 delay=500 # microsec sleep between msg 1,000,000 == 1s
112 nrcvrs=3 # this is sane, but -r allows it to be set up
120 -c) cthreads=$2; shift;;
122 -d) delay=$2; shift;;
123 -i) use_installed=1;;
126 -N) si="";; # build NNG binaries (turn off si)
127 -r) nrcvrs=$2; shift;;
128 -S) si="_si";; # build SI95 binaries
131 *) echo "unrecognised option: $1"
132 echo "usage: $0 [-B] [-c caller-threads] [-d micor-sec-delay] [-i] [-M] [-n num-msgs] [-r num-receivers] [-S]"
133 echo " -B forces an RMR rebuild which will use .build"
134 echo " -i will use installed libraries (/usr/local) and cause -B to be ignored if supplied)"
135 echo " -M force test applictions to be remade"
136 echo " -S build/test SI95 based binaries"
147 export RMR_VCTL_FILE=".verbose"
150 if (( use_installed )) # point at installed library
152 export LD_LIBRARY_PATH=${LD_LIBRARY_PATH-:/usr/local/lib} # use caller's or set sane default
156 build_path=../../.build # if we rebuild we can insist that it is in .build :)
161 build_path=${BUILD_PATH:-"../../.build"} # we prefer .build at the root level, but allow user option
163 if [[ ! -d $build_path ]]
165 echo "cannot find build in: $build_path"
166 echo "either create, and then build RMr, or set BUILD_PATH as an evironment var before running this"
171 if [[ -z $LD_LIBRARY_PATH ]] # cmake test will set this; we must honour it
173 if [[ -d $build_path/lib64 ]]
175 export LD_LIBRARY_PATH=$build_path:$build_path/lib64:$LD_LIBRARY_PATH
177 export LD_LIBRARY_PATH=$build_path:$build_path/lib:$LD_LIBRARY_PATH
182 export LIBRARY_PATH=$LD_LIBRARY_PATH
183 export RMR_SEED_RT=./lcall.rt
185 set_rt $nrcvrs # set up the rt for n receivers
187 if (( force_make || rebuild )) || [[ ! -f ./lcaller || ! -f ./lreceiver ]]
189 if ! make -B lcaller lreceiver >/dev/null 2>&1
191 echo "[FAIL] cannot find lcaller and/or lreceiver binary, and cannot make them.... humm?"
196 for (( i=0; i < nrcvrs; i++ )) # start the receivers with an instance number
201 sleep 2 # let receivers init so we don't shoot at an empty target
207 for (( i=0; i < nrcvrs; i++ )) # collect return codes
209 head -1 /tmp/PID$$.$i.rrc | read x
213 head -1 /tmp/PID$$.src | read src
215 if (( !! (src + rrc) ))
217 echo "[FAIL] sender rc=$src receiver rc=$rrc"
219 echo "[PASS] sender rc=$src receiver rc=$rrc"
226 exit $(( !! (src + rrc) ))