test/app_test/run_lcall_test.ksh

   1 #!/usr/bin/env ksh
   2 # :vi ts=4 sw=4 noet :
   3 #==================================================================================
   4 #    Copyright (c) 2019 Nokia
   5 #    Copyright (c) 2018-2019 AT&T Intellectual Property.
   6 #
   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
  10 #
  11 #       http://www.apache.org/licenses/LICENSE-2.0
  12 #
  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 #==================================================================================
  19 #
  20
  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.
  30 #
  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.
  39 #
  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
  44 #
  45 #       Date:           28 May 2019
  46 #       Author:         E. Scott Daniels
  47 # ---------------------------------------------------------------------------------
  48
  49
  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.
  52 #
  53 function run_sender {
  54         ./lcaller ${nmsg:-10} ${delay:-500} ${cthreads:-3}
  55         echo $? >/tmp/PID$$.src         # must communicate state back via file b/c asynch
  56 }
  57
  58 # $1 is the instance so we can keep logs separate
  59 function run_rcvr {
  60         typeset port
  61
  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
  66 }
  67
  68 #       Drop a contrived route table in such that the sender sends each message to n
  69 #       receivers.
  70 #
  71 function set_rt {
  72         typeset port=4460
  73         typeset groups="localhost:4460"
  74         for (( i=1; i < ${1:-3}; i++ ))
  75         do
  76                 groups="$groups,localhost:$((port+i))"
  77         done
  78
  79         cat <<endKat >lcall.rt
  80                 newrt | start
  81                 mse |0 | 0 | $groups
  82                 mse |1 | 10 | $groups
  83                 mse |2 | 20 | $groups
  84                 rte |3 | $groups
  85                 rte |4 | $groups
  86                 rte |5 | $groups
  87                 rte |6 | $groups
  88                 rte |7 | $groups
  89                 rte |8 | $groups
  90                 rte |9 | $groups
  91                 rte |10 | $groups
  92                 rte |11 | $groups
  93                 newrt | end
  94 endKat
  95 }
  96
  97 # ---------------------------------------------------------
  98
  99 if [[ ! -f local.rt ]]          # we need the real host name in the local.rt; build one from mask if not there
 100 then
 101         hn=$(hostname)
 102         sed "s!%%hostname%%!$hn!" rt.mask >local.rt
 103 fi
 104
 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
 108 wait=1
 109 rebuild=0
 110 verbose=0
 111 nrcvrs=3                                        # this is sane, but -r allows it to be set up
 112 use_installed=0
 113
 114 while [[ $1 == -* ]]
 115 do
 116         case $1 in
 117                 -c)     cthreads=$2; shift;;
 118                 -B)     rebuild=1;;
 119                 -d)     delay=$2; shift;;
 120                 -i)     use_installed=1;;
 121                 -n)     nmsg=$2; shift;;
 122                 -r)     nrcvrs=$2; shift;;
 123                 -v)     verbose=1;;
 124
 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)"
 129                         exit 1
 130                         ;;
 131         esac
 132
 133         shift
 134 done
 135
 136 if (( verbose ))
 137 then
 138         echo "2" >.verbose
 139         export RMR_VCTL_FILE=".verbose"
 140 fi
 141
 142 if (( use_installed ))                  # point at installed library
 143 then
 144         export LD_LIBRARY_PATH=/usr/local/lib
 145         export LIBRARY_PATH=$LD_LIBRARY_PATH
 146 else
 147         if (( rebuild ))
 148         then
 149                 build_path=../../.build         # if we rebuild we can insist that it is in .build :)
 150                 set -e
 151                 ksh ./rebuild.ksh
 152                 set +e
 153         else
 154                 build_path=${BUILD_PATH:-"../../.build"}        # we prefer .build at the root level, but allow user option
 155
 156                 if [[ ! -d $build_path ]]
 157                 then
 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"
 160                         exit 1
 161                 fi
 162         fi
 163
 164         if [[ -d $build_path/lib64 ]]
 165         then
 166                 export LD_LIBRARY_PATH=$build_path:$build_path/lib64
 167         else
 168                 export LD_LIBRARY_PATH=$build_path:$build_path/lib
 169         fi
 170 fi
 171
 172 export LIBRARY_PATH=$LD_LIBRARY_PATH
 173 export RMR_SEED_RT=./lcall.rt
 174
 175 set_rt $nrcvrs                                          # set up the rt for n receivers
 176
 177 if (( rebuild )) || [[ ! -f ./lcaller ]]
 178 then
 179         if ! make -B lcaller lreceiver >/dev/null 2>&1
 180         then
 181                 echo "[FAIL] cannot find lcaller binary, and cannot make it.... humm?"
 182                 exit 1
 183         fi
 184 fi
 185
 186 for (( i=0; i < nrcvrs; i++ ))          # start the receivers with an instance number
 187 do
 188         run_rcvr $i &
 189 done
 190
 191 sleep 2                         # let receivers init so we don't shoot at an empty target
 192 run_sender &
 193
 194 wait
 195
 196
 197 for (( i=0; i < nrcvrs; i++ ))          # collect return codes
 198 do
 199         head -1 /tmp/PID$$.$i.rrc | read x
 200         (( rrc += x ))
 201 done
 202
 203 head -1 /tmp/PID$$.src | read src
 204
 205 if (( !! (src + rrc) ))
 206 then
 207         echo "[FAIL] sender rc=$src  receiver rc=$rrc"
 208 else
 209         echo "[PASS] sender rc=$src  receiver rc=$rrc"
 210         rm -f lcall.rt
 211 fi
 212
 213 rm /tmp/PID$$.*
 214 rm -f .verbose
 215
 216 exit $(( !! (src + rrc) ))
 217