example/diameter/launcher/deployments/st-client/configure.sh

   1 #!/bin/bash
   2
   3 #############
   4 # VARIABLES #
   5 #############
   6 MAXIMUM_ADML_ASYNC_RATE=50
   7 MAXIMUM_SUGGESTED_CLIENT_CONNECTION_PER_ADML_INSTANCE=10
   8 ADML_INSTANCES__ST_CONF_FILE=.st_conf_adml_instances
   9 ADML_CONNECTIONS__ST_CONF_FILE=.st_conf_adml_connections
  10 CYCLE_REPEATS__ST_CONF_FILE=.st_conf_cycle_repeats
  11 N_TESTCASES__ST_CONF_FILE=.st_conf_n_testcases
  12 ADML_RATE_PER_INSTANCE__ST_CONF_FILE=.st_conf_rate_per_instance
  13 ADML_DESIRED_RATE__ST_CONF_FILE=.st_conf_desired_rate
  14 N_TESTCASES_PROGRAM_LAYOUT__ST_CONF_FILE=.st_conf_n_testcases_program_layout
  15
  16 #############
  17 # FUNCTIONS #
  18 #############
  19 _exit () {
  20   echo
  21   echo $1
  22   echo
  23   exit 1
  24 }
  25
  26 # ceil of division $1/$2
  27 ceil() {
  28   #echo "$1 $2" | awk '{print int( ($1/$2) + 1 )}'
  29   awk -vnumber="$1" -vdiv="$2" '
  30   function ceiling(x){return x%1 ? int(x)+1 : x}
  31   BEGIN{ print ceiling(number/div) }'
  32 }
  33
  34 # Calculates the number of ADML instances and their client connections
  35 calculate_deployment_layout() {
  36   echo "Input the maximum client connections accepted by the server to be tested [5000]:"
  37   read max_server_accepted_connections
  38   [ "$max_server_accepted_connections" = "" ] && max_server_accepted_connections=5000
  39
  40   echo "Input the maximum desired test case rate per second:"
  41   read desired_rate
  42   while [ -z "$desired_rate" ]; do read desired_rate; done
  43
  44   max_connections=$((desired_rate/MAXIMUM_ADML_ASYNC_RATE))
  45   if [ $max_connections -eq 0 ]
  46   then
  47     G_ADML_CONNECTIONS=1
  48     G_ADML_INSTANCES=1
  49     return
  50   elif [ $max_connections -gt $max_server_accepted_connections ]
  51   then
  52     _exit "Not enough server connections to fit the desired rate (requires $max_connections connections)."
  53   fi
  54
  55   echo
  56   echo "==========================================================================================================="
  57   echo "Orientative table"
  58   echo "-----------------------------------------------------------------------------------------------------------"
  59   echo -n "Number of instances:  "
  60   for conn in `seq 1 $MAXIMUM_SUGGESTED_CLIENT_CONNECTION_PER_ADML_INSTANCE | tac`
  61   do
  62     instances=$(ceil $max_connections $conn)
  63     echo -n -e "\t$instances"
  64   done
  65   echo
  66   echo -e "Connects per instance:\t10\t9\t8\t7\t6\t5\t4\t3\t2\t1"
  67   echo "==========================================================================================================="
  68   echo
  69   #echo "Input selection (connections per instance 1..$MAXIMUM_SUGGESTED_CLIENT_CONNECTION_PER_ADML_INSTANCE) [1]:"
  70   instances__dflt=$(ceil $max_connections $MAXIMUM_SUGGESTED_CLIENT_CONNECTION_PER_ADML_INSTANCE)
  71   echo "Input the desired number of ADML instances [$instances__dflt]:"
  72   read G_ADML_INSTANCES
  73   [ -z "$G_ADML_INSTANCES" ] && G_ADML_INSTANCES=$instances__dflt
  74   [ $G_ADML_INSTANCES -lt 1 ] && G_ADML_INSTANCES=1
  75   G_ADML_CONNECTIONS=$(ceil $max_connections $G_ADML_INSTANCES)
  76   if [ $G_ADML_CONNECTIONS -gt $MAXIMUM_SUGGESTED_CLIENT_CONNECTION_PER_ADML_INSTANCE ]
  77   then
  78     echo "Warning: the number of connections per ADML instance ($G_ADML_CONNECTIONS) is greater"
  79     echo "         than the maximum suggested: $MAXIMUM_SUGGESTED_CLIENT_CONNECTION_PER_ADML_INSTANCE"
  80     echo
  81     echo "Press ENTER to continue, CTRL-C to abort ..."
  82     read dummy
  83   fi
  84   client_connections=$((G_ADML_INSTANCES*G_ADML_CONNECTIONS))
  85   if [ $client_connections -gt $max_server_accepted_connections ]
  86   then
  87     echo
  88     echo "Insufficient server connections available ($max_server_accepted_connections) to accept"
  89     echo " launcher client connections: $G_ADML_INSTANCES x $G_ADML_CONNECTIONS = $client_connections."
  90     _exit "Configuration error"
  91   fi
  92 }
  93
  94 #############
  95 # EXECUTION #
  96 #############
  97
  98 cd `dirname $0`
  99
 100 echo
 101 echo "====================================="
 102 echo "ADML SYSTEM TEST CONFIGURATION WIZARD"
 103 echo "====================================="
 104 echo
 105 [ -d ADMLS ] && _exit "ADMLS directory still exists. Please remove it to continue (you may have to 'pkill ADML' before) !"
 106 [ ! -d services ] && _exit "Missing services configuration (expecting '$PWD/services' directory) !"
 107
 108 calculate_deployment_layout
 109
 110 # Dump persintently:
 111 echo $G_ADML_INSTANCES > $ADML_INSTANCES__ST_CONF_FILE
 112 echo $G_ADML_CONNECTIONS > $ADML_CONNECTIONS__ST_CONF_FILE
 113
 114 # Rate per instance:
 115 #rate_per_instance=$(ceil $desired_rate $G_ADML_INSTANCES)
 116 rate_per_instance=$((desired_rate/$G_ADML_INSTANCES))
 117 [ $rate_per_instance -lt 1 ] && rate_per_instance=1
 118 echo $rate_per_instance > $ADML_RATE_PER_INSTANCE__ST_CONF_FILE
 119 echo $desired_rate > $ADML_DESIRED_RATE__ST_CONF_FILE
 120
 121 echo
 122 echo "Suggested layout:"
 123 echo " - $G_ADML_INSTANCES ADML instances"
 124 echo " - $G_ADML_CONNECTIONS client connections per ADML instance"
 125 maximum_rate=$((G_ADML_INSTANCES*G_ADML_CONNECTIONS*MAXIMUM_ADML_ASYNC_RATE))
 126 echo " - Maximum rate: $maximum_rate test cases per second"
 127 echo " - Desired rate: $desired_rate test cases per second"
 128 echo
 129 echo "Usually, you will program a test case per subscriber."
 130 echo "Input the number of test cases to program:"
 131 read N_TESTCASES
 132 while [ -z "$N_TESTCASES" ]; do read N_TESTCASES; done
 133 echo $N_TESTCASES > $N_TESTCASES__ST_CONF_FILE
 134 testcase_per_adml_instance=$N_TESTCASES
 135 echo "Input the first test id to program [1]:"
 136 read first_value
 137 [ "$first_value" = "" ] && first_value=1
 138 [ $first_value -lt 1 ] && first_value=1
 139 echo
 140 time_covered_1=$(ceil $N_TESTCASES $desired_rate)
 141 time_covered=$(ceil $N_TESTCASES $((desired_rate*G_ADML_INSTANCES)))
 142 echo "That amount covers $time_covered_1 seconds for one running ADML instance."
 143 if [ $G_ADML_INSTANCES -gt 1 ]
 144 then
 145   echo "But you will have $G_ADML_INSTANCES instances running in parallel, then the total covered time is: $time_covered seconds"
 146   testcase_per_adml_instance=$((N_TESTCASES/G_ADML_INSTANCES))
 147   echo "(aproximately, $testcase_per_adml_instance test cases will be programmed on each ADML instance)"
 148 fi
 149
 150 0>$N_TESTCASES_PROGRAM_LAYOUT__ST_CONF_FILE
 151 for instance in `seq 1 $G_ADML_INSTANCES`
 152 do
 153   offset=$((testcase_per_adml_instance * (instance-1)))
 154   ini=$((offset + first_value))
 155   fin=$((offset + first_value + testcase_per_adml_instance - 1))
 156   echo "$instance $ini $fin" >> $N_TESTCASES_PROGRAM_LAYOUT__ST_CONF_FILE
 157 done
 158
 159 echo
 160 if [ $time_covered -lt 300 ]
 161 then
 162   echo "$time_covered seconds is under 5 minutes, you should add more test cases to the pool except if you are sure"
 163   echo " they will take less time that cycle completion. You could ensure that with a first timeout step."
 164   echo "Configuring such timeout slightly under $((1000*time_covered)) milliseconds, you could repeat the cycle safely to"
 165   echo " obtain a greater total time of testing."
 166 fi
 167 echo
 168 echo "How many total time do you want to cover (in minutes):"
 169 read minutes
 170 while [ -z "$minutes" ]; do read minutes; done
 171 seconds=$((minutes*60))
 172 repeats=$(ceil $seconds $time_covered)
 173 echo $repeats > $CYCLE_REPEATS__ST_CONF_FILE
 174 [ $repeats -gt 0 ] && echo "Configured $repeats cycle repeats ($repeats x $time_covered seconds ~ $seconds seconds (desired $minutes minutes)"
 175 echo
 176 echo "System test configuration completed."
 177 echo
 178 echo "Ready to clone/start the ADML instances: press ENTER to continue, CTRL+C to abort ..."
 179 read dummy
 180
 181 # Update services.xml regarding the number of client connections:
 182 cd services
 183 cp services.msk services.xml
 184 sed -i 's/__CLIENT_CONNECTIONS__/'$G_ADML_CONNECTIONS'/g' services.xml
 185 cd - >/dev/null
 186
 187
 188 for instance in `seq 1 $G_ADML_INSTANCES`
 189 do
 190   echo "Creating ADML instance $instance ..."
 191   mkdir -p ADMLS/ADML-$instance
 192   cd ADMLS/ADML-$instance
 193   mkdir counters
 194   mkdir test-reports
 195   # Create resources:
 196   ln -s ../../.operation-one.sh operation.sh
 197   ln -s ../../pre-start.sh
 198   cp ../../.run-one.sh run.sh
 199   sed -i 's/^EXE=.*/EXE=ADML-'$instance'/' run.sh
 200   ln -s ../../ADML-launcher ADML-$instance
 201   for xml in `ls ../../services/*xml`; do ln -s $xml; done
 202   cd - >/dev/null
 203 done
 204
 205 echo
 206 echo "Now you can run all the instances deployed: ./run.sh"
 207 echo
 208 echo "Done!"
 209