3 #==================================================================================
4 # Copyright (c) 2019 Nokia
5 # Copyright (c) 2018-2019 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 nano/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.
56 echo "nanomsg not supportded"
59 ./lcaller ${nmsg:-10} ${delay:-500} ${cthreads:-3}
61 echo $? >/tmp/PID$$.src # must communicate state back via file b/c asynch
64 # $1 is the instance so we can keep logs separate
68 port=$(( 4460 + ${1:-0} ))
69 export RMR_RTG_SVC=$(( 9990 + $1 ))
70 if (( $nano_receiver ))
72 echo "nanomsg not supported"
75 ./lreceiver $(( ((nmsg * cthreads)/nrcvrs) + 10 )) $port
77 echo $? >/tmp/PID$$.$1.rrc
80 # Drop a contrived route table in such that the sender sends each message to n
85 typeset groups="localhost:4460"
86 for (( i=1; i < ${1:-3}; i++ ))
88 groups="$groups,localhost:$((port+i))"
91 cat <<endKat >lcall.rt
109 # ---------------------------------------------------------
111 if [[ ! -f local.rt ]] # we need the real host name in the local.rt; build one from mask if not there
114 sed "s!%%hostname%%!$hn!" rt.mask >local.rt
117 cthreads=3 # number of caller threads
118 nmsg=100 # total number of messages to be exchanged (-n value changes)
119 delay=500 # microsec sleep between msg 1,000,000 == 1s
120 nano_sender=0 # start nano version if set (-N)
125 nrcvrs=3 # this is sane, but -r allows it to be set up
131 -c) cthreads=$2; shift;;
133 -d) delay=$2; shift;;
134 -i) use_installed=1;;
135 -N) echo "abort: nanomsg does not support epoll and thus cannot be used for mt-caller"
140 -r) nrcvrs=$2; shift;;
143 *) echo "unrecognised option: $1"
144 echo "usage: $0 [-B] [-c caller-threads] [-d micor-sec-delay] [-i] [-n num-msgs] [-r num-receivers]"
145 echo " -B forces a rebuild which will use .build"
146 echo " -i will use installed libraries (/usr/local) and cause -B to be ignored if supplied)"
157 export RMR_VCTL_FILE=".verbose"
160 if (( use_installed )) # point at installed library
162 export LD_LIBRARY_PATH=/usr/local/lib
163 export LIBRARY_PATH=$LD_LIBRARY_PATH
167 build_path=../../.build # if we rebuild we can insist that it is in .build :)
172 build_path=${BUILD_PATH:-"../../.build"} # we prefer .build at the root level, but allow user option
174 if [[ ! -d $build_path ]]
176 echo "cannot find build in: $build_path"
177 echo "either create, and then build RMr, or set BUILD_PATH as an evironment var before running this"
182 if [[ -d $build_path/lib64 ]]
184 export LD_LIBRARY_PATH=$build_path:$build_path/lib64
186 export LD_LIBRARY_PATH=$build_path:$build_path/lib
190 export LIBRARY_PATH=$LD_LIBRARY_PATH
191 export RMR_SEED_RT=./lcall.rt
193 set_rt $nrcvrs # set up the rt for n receivers
195 if (( rebuild )) || [[ ! -f ./lcaller ]]
197 if ! make -B lcaller lreceiver >/dev/null 2>&1
199 echo "[FAIL] cannot find lcaller binary, and cannot make it.... humm?"
204 for (( i=0; i < nrcvrs; i++ )) # start the receivers with an instance number
209 sleep 2 # let receivers init so we don't shoot at an empty target
215 for (( i=0; i < nrcvrs; i++ )) # collect return codes
217 head -1 /tmp/PID$$.$i.rrc | read x
221 head -1 /tmp/PID$$.src | read src
223 if (( !! (src + rrc) ))
225 echo "[FAIL] sender rc=$src receiver rc=$rrc"
227 echo "[PASS] sender rc=$src receiver rc=$rrc"
234 exit $(( !! (src + rrc) ))