Support for Multiple Peer deployments. Support for coexisting several ADMLS instances...
[anna.git] / example / diameter / launcher / deployments / st-client / README
index 6c8c711..fd3860a 100644 (file)
@@ -1,20 +1,56 @@
 ABOUT CONTENT
 -------------
-Template for xml messages (message.dtd), dictionaries (dictionary.dtd) and services (services.dtd)
-are informative, not actually required by process. They are located at './DTDs'. Stacks are available
-at './stacks'. There are also some stuff (hex/xml examples, etc.) which could be useful.
+Template for xml messages (message.dtd), dictionaries (dictionary.dtd)
+and services (services.dtd) are informative, not actually required by
+process. They are located at './DTDs'. Stacks at './stack_examples'.
+There are also some stuff (hex/xml examples, etc.) which could be useful.
 
-Execute './configure.sh' and follow the intructions to clone the ADML instance into the needed amount
-for system testing.
+You could adapt your 'services' configuration using stuff from dynamic
+directories if you are going to execute their tests, for example, from
+'dynlibs/gx/00001/services' you will get the corresponding services
+template and CER file for the test case messages CCR-I and CCR-T. If
+not, dynamic programming will fail because the appropiate service is
+not configured before starting ADML instances.
+
+Execute './configure.sh' and follow the intructions to clone the ADML
+instance into the needed amount for system testing. Every time you run
+this, a new 'ADMLS#<description>' directory is created and symlinked
+to 'ADMLS'.
 
 STARTING THE PROCESS
 --------------------
-After configuring the ADML execution context, a new script has been created: 'run.sh'.
-This script will run all the cloned ADML instances within ADMLS directory.
+After configuring the ADML execution context, a new script has been
+created: 'run.sh'. This script will run all the cloned ADML instances
+within ADMLS directory. Also, an './operation.sh' script will broadcast
+the operation provided through every cloned instance. For example, if
+you provide 'test|ttps|5', the speed of 5 test cases per second will
+be set on every ADML instance. Imagine you have N instances, and then
+you actually are establishing a total 5*N speed rate over the servers.
+You could run another 'ADMLS#<description>' directory just providing
+it as argument.
+
+TESTING PROCEDURE
+-----------------
+Firstly you shall program the test cases by mean script './program.sh'.
+For example:
+  ./program.sh st_examples/DynamicQualification
+
+Using option '-s', the testing will start after programming, with the
+desired rate selected on configuration stage.
+
+Don't forget to populate whatever data you need on the tested system,
+because this work is not done here.
+
+Program script acts over ADMLS symlink. You must update it if want to
+program another ADMLS instances directory.
 
 OPERATION
 ---------
-Management interface for lite version is based on SIGUSR2 signal caugh. Use './operation.sh'
-script to send any operation to the processes. Ask for help with that script to see all the
-operations supported.
+Management interface for lite version is based on SIGUSR2 signal caugh.
+Use './operation.sh' script within a specific instance directory to send
+any operation to the process. Ask for help with that script to see all
+the operations supported.
+
+Operation script acts over ADMLS symlink. You must update it if want to
+operate another ADMLS instances directory.