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 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="localhost:4460"
74 for (( i=1; i < ${1:-3}; i++ ))
76 groups="$groups,localhost:$((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 cthreads=3 # number of caller threads
106 nmsg=100 # total number of messages to be exchanged (-n value changes)
107 delay=500 # microsec sleep between msg 1,000,000 == 1s
111 nrcvrs=3 # this is sane, but -r allows it to be set up
117 -c) cthreads=$2; shift;;
119 -d) delay=$2; shift;;
120 -i) use_installed=1;;
122 -r) nrcvrs=$2; shift;;
125 *) echo "unrecognised option: $1"
126 echo "usage: $0 [-B] [-c caller-threads] [-d micor-sec-delay] [-i] [-n num-msgs] [-r num-receivers]"
127 echo " -B forces a rebuild which will use .build"
128 echo " -i will use installed libraries (/usr/local) and cause -B to be ignored if supplied)"
139 export RMR_VCTL_FILE=".verbose"
142 if (( use_installed )) # point at installed library
144 export LD_LIBRARY_PATH=/usr/local/lib
145 export LIBRARY_PATH=$LD_LIBRARY_PATH
149 build_path=../../.build # if we rebuild we can insist that it is in .build :)
154 build_path=${BUILD_PATH:-"../../.build"} # we prefer .build at the root level, but allow user option
156 if [[ ! -d $build_path ]]
158 echo "cannot find build in: $build_path"
159 echo "either create, and then build RMr, or set BUILD_PATH as an evironment var before running this"
164 if [[ -d $build_path/lib64 ]]
166 export LD_LIBRARY_PATH=$build_path:$build_path/lib64
168 export LD_LIBRARY_PATH=$build_path:$build_path/lib
172 export LIBRARY_PATH=$LD_LIBRARY_PATH
173 export RMR_SEED_RT=./lcall.rt
175 set_rt $nrcvrs # set up the rt for n receivers
177 if (( rebuild )) || [[ ! -f ./lcaller ]]
179 if ! make -B lcaller lreceiver >/dev/null 2>&1
181 echo "[FAIL] cannot find lcaller binary, and cannot make it.... humm?"
186 for (( i=0; i < nrcvrs; i++ )) # start the receivers with an instance number
191 sleep 2 # let receivers init so we don't shoot at an empty target
197 for (( i=0; i < nrcvrs; i++ )) # collect return codes
199 head -1 /tmp/PID$$.$i.rrc | read x
203 head -1 /tmp/PID$$.src | read src
205 if (( !! (src + rrc) ))
207 echo "[FAIL] sender rc=$src receiver rc=$rrc"
209 echo "[PASS] sender rc=$src receiver rc=$rrc"
216 exit $(( !! (src + rrc) ))