example/diameter/launcher/deployments/st-client/README

   1 ABOUT CONTENT
   2 -------------
   3 Template for xml messages (message.dtd), dictionaries (dictionary.dtd)
   4 and services (services.dtd) are informative, not actually required by
   5 process. They are located at './DTDs'. Stacks at './stack_examples'.
   6 There are also some stuff (hex/xml examples, etc.) which could be useful.
   7
   8 You could adapt your 'services' configuration using stuff from dynamic
   9 directories if you are going to execute their tests, for example, from
  10 'dynlibs/gx/00001/services' you will get the corresponding services
  11 template and CER file for the test case messages CCR-I and CCR-T. If
  12 not, dynamic programming will fail because the appropiate service is
  13 not configured before starting ADML instances.
  14
  15 Execute './configure.sh' and follow the intructions to clone the ADML
  16 instance into the needed amount for system testing. Every time you run
  17 this, a new 'ADMLS#<description>' directory is created and symlinked
  18 to 'ADMLS'.
  19
  20 STARTING THE PROCESS
  21 --------------------
  22 After configuring the ADML execution context, a new script has been
  23 created: 'run.sh'. This script will run all the cloned ADML instances
  24 within ADMLS directory. Also, an './operation.sh' script will broadcast
  25 the operation provided through every cloned instance. For example, if
  26 you provide 'test|ttps|5', the speed of 5 test cases per second will
  27 be set on every ADML instance. Imagine you have N instances, and then
  28 you actually are establishing a total 5*N speed rate over the servers.
  29 You could run another 'ADMLS#<description>' directory just providing
  30 it as argument.
  31
  32 TESTING PROCEDURE
  33 -----------------
  34 Firstly you shall program the test cases by mean script './program.sh'.
  35 For example:
  36   ./program.sh st_examples/DynamicQualification
  37
  38 Using option '-s', the testing will start after programming, with the
  39 desired rate selected on configuration stage.
  40
  41 Don't forget to populate whatever data you need on the tested system,
  42 because this work is not done here.
  43
  44 Program script acts over ADMLS symlink. You must update it if want to
  45 program another ADMLS instances directory.
  46
  47 OPERATION
  48 ---------
  49 Management interface for lite version is based on SIGUSR2 signal caugh.
  50 Use './operation.sh' script within a specific instance directory to send
  51 any operation to the process. Check 'HELP.md' for more information.
  52
  53 Operation script acts over ADMLS symlink. You must update it if want to
  54 operate another ADMLS instances directory.
  55