Revert "Remove mysql and oracle resources for anna-ericsson project"
[anna.git] / example / diameter / launcher / Launcher.cpp
1 // ANNA - Anna is Not Nothingness Anymore                                                         //
2 //                                                                                                //
3 // (c) Copyright 2005-2015 Eduardo Ramos Testillano & Francisco Ruiz Rayo                         //
4 //                                                                                                //
5 // See project site at http://redmine.teslayout.com/projects/anna-suite                           //
6 // See accompanying file LICENSE or copy at http://www.teslayout.com/projects/public/anna.LICENSE //
7
8
9 // Standard
10 #include <sstream>      // std::istringstream
11 #include <iostream>     // std::cout
12 #include <math.h> // ceil
13 #include <climits>
14 #include <unistd.h> // chdir
15 //#include <regex> TODO: use this from gcc4.9.0: http://stackoverflow.com/questions/8060025/is-this-c11-regex-error-me-or-the-compiler
16 #include <stdio.h>
17
18 // Project
19 #include <anna/timex/Engine.hpp>
20 #include <anna/statistics/Engine.hpp>
21 #include <anna/diameter/codec/functions.hpp>
22 #include <anna/diameter/codec/Engine.hpp>
23 #include <anna/diameter/codec/EngineManager.hpp>
24 #include <anna/http/Transport.hpp>
25 #include <anna/diameter/stack/Engine.hpp>
26 #include <anna/diameter/helpers/base/functions.hpp>
27 #include <anna/time/functions.hpp>
28 #include <anna/diameter.comm/ApplicationMessageOamModule.hpp>
29 #include <anna/testing/defines.hpp>
30 #include <anna/xml/xml.hpp>
31 #include <anna/diameter.comm/OriginHost.hpp>
32 #include <anna/diameter.comm/OriginHostManager.hpp>
33 #include <Procedure.hpp>
34
35 // Process
36 #include <Launcher.hpp>
37 #include <MyDiameterEngine.hpp>
38 #include <anna/testing/TestManager.hpp>
39 #include <anna/testing/TestCase.hpp>
40
41
42 #define SIGUSR2_TASKS_INPUT_FILENAME "sigusr2.in"
43 #define SIGUSR2_TASKS_OUTPUT_FILENAME "sigusr2.out"
44
45
46 const char *ServicesDTD = "\
47 <?xml version=\"1.0\" encoding=\"UTF-8\"?>\n\
48 <!-- Diameter services DTD -->\n\
49 \n\
50 <!ELEMENT services (stack*, node*)>\n\
51 \n\
52 <!ELEMENT stack EMPTY>\n\
53 <!ATTLIST stack id CDATA #REQUIRED dictionary CDATA #REQUIRED validationMode (BeforeEncoding | AfterDecoding | Always | Never) #IMPLIED validationDepth (Complete | FirstError) #IMPLIED fixMode (BeforeEncoding | AfterDecoding | Always | Never) #IMPLIED ignoreFlagsOnValidation (yes | no) #IMPLIED>\n\
54 <!--\n\
55    Stack record\n\
56 \n\
57     id:                      Normally the id corresponds to the Application-Id for which the dictionary provided is designed\n\
58                              (in multistack applications, it shall be mandatory respect such association to know the stack used\n\
59                              for processed messages).\n\
60     dictionary:              Path to the dictionary file.\n\
61     validationMode:          Sets the validation mode. Default is 'AfterDecoding'.\n\
62     validationDepth:         Sets the validation depth. Default is 'FirstError'.\n\
63     fixMode:                 Sets the fix mode. Default is 'BeforeEncoding'.\n\
64     ignoreFlagsOnValidation: Ignore flags during message validation. Default is 'no'.\n\
65 -->\n\
66 \n\
67 <!ELEMENT node EMPTY>\n\
68 <!ATTLIST node originHost CDATA #REQUIRED applicationId CDATA #REQUIRED originRealm CDATA #IMPLIED cer CDATA #IMPLIED dwr CDATA #IMPLIED cea CDATA #IMPLIED allowedInactivityTime CDATA #IMPLIED tcpConnectDelay CDATA #IMPLIED answersTimeout CDATA #IMPLIED ceaTimeout CDATA #IMPLIED watchdogPeriod CDATA #IMPLIED entity CDATA #IMPLIED entityServerSessions CDATA #IMPLIED diameterServer CDATA #IMPLIED diameterServerSessions CDATA #IMPLIED balance (yes | no) #IMPLIED sessionBasedModelsClientSocketSelection (SessionIdLowPart | SessionIdHighPart | SessionIdOptionalPart | RoundRobin) #IMPLIED retries CDATA #IMPLIED log CDATA #IMPLIED splitLog (yes | no) #IMPLIED detailedLog (yes | no) #IMPLIED dumpLog (yes | no) #IMPLIED burstLog (yes | no) #IMPLIED>\n\
69 <!--\n\
70    Node record\n\
71 \n\
72    originHost:                              Node identifier as diameter application host name.\n\
73    applicationId:                           The Application-Id provided must exists as a registered 'stack id'.\n\
74    originRealm:                             Origin-Realm (domain-name internally used by default).\n\
75 \n\
76 \n\
77    - Diameter clients:\n\
78 \n\
79    entity:                                  Target diameter entity (comma-separated '<address>:<port>' format).\n\
80                                             For example: 10.20.30.40:3868,10.20.30.41:3868. If missing, no entity will be enabled.\n\
81    entityServerSessions:                    Diameter entity server sessions (0: diameter entity disabled). Default value of 1.\n\
82    cer:                                     User defined CER path file to be encoded to establish diameter connections.\n\
83                                             If missing, will be harcoded.\n\
84    dwr:                                     User defined DWR path file to be encoded for diameter protocol keep alive.\n\
85                                             If missing, will be harcoded.\n\
86    tcpConnectDelay:                         Milliseconds to wait TCP connect to any server. If missing, default value of 200 will\n\
87                                             be assigned\n\
88    ceaTimeout:                              Milliseconds to wait CEA from diameter server. If missing, default value of 'answersTimeout'\n\
89                                             will be assigned.\n\
90    watchdogPeriod:                          Milliseconds for watchdog timer (Tw) for diameter keep-alive procedure. If missing, default\n\
91                                             value of 30000 will be assigned.\n\
92    balance:                                 Balance over entity servers instead of doing standard behaviour (first primary, secondary\n\
93                                             if fails, etc.). Default value 'no'.\n\
94    sessionBasedModelsClientSocketSelection: By default, round-robin will be applied for IEC model (SMS/MMS), and Session-Id Low Part\n\
95                                             will be analyzed for ECUR/SCUR model (data, voice and content). You could change ECUR/SCUR\n\
96                                             analysis behaviour providing 'SessionIdHighPart', 'SessionIdOptionalPart' (atoi applied;\n\
97                                             usually subscriber id data, i.e. MSISDN or IMSI) and 'RoundRobin' (also 'SessionIdLowPart').\n\
98 \n\
99 \n\
100    - Diameter servers:\n\
101 \n\
102    diameterServer:                          Diameter own server address in '<address>:<port>' format. For example: 10.20.30.40:3868.\n\
103                                             If missing, no local server will be enabled.\n\
104    diameterServerSessions:                  Diameter own server available connections (0: diameter server disabled). Default value of 1.\n\
105                                             Negative value implies no limit accepting incoming connections.\n\
106    cea:                                     User defined CEA path file to be encoded to answer client CERs.\n\
107                                             If missing, will be harcoded.\n\
108    allowedInactivityTime:                   Milliseconds for the maximum allowed inactivity time on server sessions born over the\n\
109                                             local server before being reset. If missing, default value of 90000 will be assigned.\n\
110 \n\
111 \n\
112    - General:\n\
113 \n\
114    answersTimeout:                          Milliseconds to wait pending application answers from diameter peers. If missing,\n\
115                                             default value of 10000 will be assigned.\n\
116    retries:                                 Expired responses will cause a number of request retransmissions. Disabled by default (0 retries).\n\
117    log:                                     Process log file (operations result, traffic log, etc.). By default '<originHost>.launcher.log'.\n\
118                                             Empty string or \"null\" name, to disable. Warning: there is no rotation for log files\n\
119                                             (use logrotate or whatever you consider).\n\
120    splitLog:                                Splits log file (appends to log filename, extensions with the type of event: see help on\n\
121                                             startup information-level traces). No log files for code/decode and load operations are created.\n\
122                                             Default value 'no'.\n\
123    detailedLog:                             Insert detailed information at log files (timestamps, communication resources, etc.). Useful\n\
124                                             to analyze the messages flow along the sockets (specially on 'balance' mode). Default 'no'.\n\
125    dumpLog:                                 Write to disk every incoming/outcoming message named as:\n\
126                                                '<unix ms timestamp>.<originHost>.<hop by hop>.<end to end>.<message code>.<request|answer>.<type of event>.xml'\n\
127                                             Default value 'no'.\n\
128    burstLog:                                Burst operations log file. By default '<originHost>.launcher.burst'. Empty string or \"null\" name, to disable.\n\
129                                             Warning: there is no rotation for log files (use logrotate or whatever). Output: dot (.) for each\n\
130                                             burst message sent/pushed, cross (x) for popped ones, and order number when multiple of 1% of burst\n\
131                                             list size, plus OTA requests when changed.\n\
132 \n\
133 -->\n\
134 \n\
135 ";
136
137
138 Launcher::Launcher() : anna::comm::Application("launcher", "DiameterLauncher", "1.1"), a_communicator(NULL) {
139   a_timeEngine = NULL;
140   a_counterRecorder = NULL;
141   a_admlMinResolution = 2 * anna::timex::Engine::minResolution; // 2*10 = 20 ms; 1000/20 = 50 ticks per second;
142   //a_admlMinResolution = (anna::Millisecond)100;
143   a_counterRecorderClock = NULL;
144
145   a_workingNode = NULL;
146
147   a_httpServerSocket = NULL;
148 }
149
150
151 std::string Launcher::getSignalUSR2InputFile() const throw() {
152   return (a_initialWorkingDirectory + "/" + SIGUSR2_TASKS_INPUT_FILENAME);
153 }
154
155 std::string Launcher::getSignalUSR2OutputFile() const throw() {
156   return (a_initialWorkingDirectory + "/" + SIGUSR2_TASKS_OUTPUT_FILENAME);
157 }
158
159
160 void Launcher::servicesFromXML(const anna::xml::Node* servicesNode, bool eventOperation) throw(anna::RuntimeException) {
161
162   CommandLine& cl(anna::CommandLine::instantiate());
163   bool allLogsDisabled = cl.exists("disableLogs");
164
165     //<!ATTLIST stack id CDATA #REQUIRED dictionary CDATA #REQUIRED>
166   const anna::xml::Attribute *id, *dictionary;
167
168   // <!ATTLIST node originHost CDATA #REQUIRED applicationId CDATA #REQUIRED cer CDATA #IMPLIED dwr CDATA #IMPLIED allowedInactivityTime CDATA #IMPLIED tcpConnectDelay CDATA #IMPLIED answersTimeout CDATA #IMPLIED ceaTimeout CDATA #IMPLIED watchdogPeriod CDATA #IMPLIED entity CDATA #IMPLIED entityServerSessions CDATA #IMPLIED diameterServer CDATA #IMPLIED diameterServerSessions CDATA #IMPLIED balance (yes | no) #IMPLIED sessionBasedModelsClientSocketSelection (SessionIdLowPart | SessionIdHighPart | SessionIdOptionalPart | RoundRobin) #IMPLIED retries CDATA #IMPLIED log CDATA #IMPLIED splitLog (yes | no) #IMPLIED detailedLog (yes | no) #IMPLIED dumpLog (yes | no) #IMPLIED burstLog (yes | no) #IMPLIED>
169   const anna::xml::Attribute *originHost, *appId, *originRealm, *cer, *dwr, *cea, *allowedInactivityTime, *tcpConnectDelay,
170   *answersTimeout, *ceaTimeout, *watchdogPeriod, *entity, *entityServerSessions,
171   *diameterServer, *diameterServerSessions, *balance, *sessionBasedModelsClientSocketSelection,
172   *retries, *log, *splitLog, *detailedLog, *dumpLog, *burstLog;
173   // Never clear services content from here (append new data from xml). At the moment no node removing is implemented in this process
174
175   // Stacks
176   anna::diameter::stack::Engine &stackEngine = anna::diameter::stack::Engine::instantiate();
177   anna::diameter::stack::Dictionary *d;
178   const anna::diameter::stack::Dictionary *bpd = NULL; // base protocol dictionary
179
180   // Codec engine manager:
181   anna::diameter::codec::EngineManager &em = anna::diameter::codec::EngineManager::instantiate();
182   anna::diameter::codec::Engine *ce;
183
184   ///////////////////////////////////////////
185   // APPLICATION MESSAGE OAM MODULE SCOPES //
186   ///////////////////////////////////////////
187   // We will register a scope per stack id registered. The counters will be dynamically registered at count method.
188   anna::diameter::comm::ApplicationMessageOamModule & appMsgOamModule = anna::diameter::comm::ApplicationMessageOamModule::instantiate();
189   appMsgOamModule.enableCounters(); // this special module is disabled by default (the only)
190   static int scope_id = 3;
191   unsigned int id_value;
192   std::string codecEngineName;
193
194   for(anna::xml::Node::const_child_iterator it = servicesNode->child_begin(); it != servicesNode->child_end(); it++) {
195     std::string nodeName = (*it)->getName();
196
197     if(nodeName == "stack") {
198       // Input data:
199       id = (*it)->getAttribute("id");
200       dictionary = (*it)->getAttribute("dictionary");
201       id_value = id->getIntegerValue();
202
203       if (stackEngine.getDictionary(id_value)) { // Ignore (but don't fail) dictionary load with same stack id already registered
204         LOGWARNING(anna::Logger::warning(anna::functions::asString("Ignore dictionary load for stack id already registered: %llu", id_value), ANNA_FILE_LOCATION));
205         continue;
206       }
207
208       try {
209         d = stackEngine.createDictionary(id_value, dictionary->getValue());
210         LOGDEBUG(anna::Logger::debug(anna::functions::asString("Created dictionary (%p) for stack id %llu", d, id_value), ANNA_FILE_LOCATION));
211
212         // OAM module for counters:
213         appMsgOamModule.createStackCounterScope(scope_id, id_value /* application-id */);
214         scope_id++;
215
216       } catch(anna::RuntimeException &ex) {
217         //_exit(ex.asString());
218         throw ex;
219       }
220
221       bpd = d; // base protocol dictionary in case of monostack. If multistack, will be calculated later
222
223       // Create codec engine and register it in the codec engine manager:
224       codecEngineName = anna::functions::asString("CodecEngineForStackId_%llu", id_value);
225       ce = new anna::diameter::codec::Engine(codecEngineName.c_str(), d);
226       em.registerCodecEngine(id_value, ce);
227
228       // Codec engine configuration:
229       const anna::xml::Attribute *vm_attr = (*it)->getAttribute("validationMode", false /* no exception */);
230       const anna::xml::Attribute *vd_attr = (*it)->getAttribute("validationDepth", false /* no exception */);
231       const anna::xml::Attribute *fm_attr = (*it)->getAttribute("fixMode", false /* no exception */);
232       const anna::xml::Attribute *if_attr = (*it)->getAttribute("ignoreFlagsOnValidation", false /* no exception */);
233
234       std::string vm_value = vm_attr ? vm_attr->getValue() : "AfterDecoding";
235       std::string vd_value = vd_attr ? vd_attr->getValue() : "FirstError";
236       std::string fm_value = fm_attr ? fm_attr->getValue() : "BeforeEncoding";
237
238       anna::diameter::codec::Engine::ValidationMode::_v vm;
239       if (vm_value == "BeforeEncoding") vm = anna::diameter::codec::Engine::ValidationMode::BeforeEncoding;
240       else if (vm_value == "AfterDecoding") vm = anna::diameter::codec::Engine::ValidationMode::AfterDecoding;
241       else if (vm_value == "Always") vm = anna::diameter::codec::Engine::ValidationMode::Always;
242       else if (vm_value == "Never") vm = anna::diameter::codec::Engine::ValidationMode::Never;
243       ce->setValidationMode(vm);
244
245       anna::diameter::codec::Engine::ValidationDepth::_v vd;
246       if (vd_value == "Complete") vd = anna::diameter::codec::Engine::ValidationDepth::Complete;
247       else if (vd_value == "FirstError") vd = anna::diameter::codec::Engine::ValidationDepth::FirstError;
248       ce->setValidationDepth(vd);
249
250       anna::diameter::codec::Engine::FixMode::_v fm;
251       if (fm_value == "BeforeEncoding") fm = anna::diameter::codec::Engine::FixMode::BeforeEncoding;
252       else if (fm_value == "AfterDecoding") fm = anna::diameter::codec::Engine::FixMode::AfterDecoding;
253       else if (fm_value == "Always") fm = anna::diameter::codec::Engine::FixMode::Always;
254       else if (fm_value == "Never") fm = anna::diameter::codec::Engine::FixMode::Never;
255       ce->setFixMode(fm);
256
257       bool if_value = (if_attr ? (if_attr->getValue() == "yes") : false);
258       ce->ignoreFlagsOnValidation(if_value);
259     }
260   }
261
262   // Show loaded stacks:
263   std::cout << "Stacks currently loaded:" << std::endl;
264   std::cout << anna::functions::tab(stackEngine.asString(false /* light */)) << std::endl;
265
266   // Basic checking for multistack:
267   bool multistack = (stackEngine.stack_size() > 1);
268   if (multistack) {
269     bpd = stackEngine.getDictionary(0);
270     if(!bpd)
271       throw anna::RuntimeException("In multistack applications is mandatory register a stack id = 0 using a dictionary which contains the needed elements to build base protocol messages (CER/A, DWR/A, DPR/A, STR/A, etc.)", ANNA_FILE_LOCATION);
272   }
273
274   // REALMS:
275   for(anna::xml::Node::const_child_iterator it = servicesNode->child_begin(); it != servicesNode->child_end(); it++) {
276     std::string nodeName = (*it)->getName();
277
278     if(nodeName == "node") {
279       // Input data:
280       originHost = (*it)->getAttribute("originHost");
281       appId = (*it)->getAttribute("applicationId");
282       originRealm = (*it)->getAttribute("originRealm", false /* no exception */);
283       cer = (*it)->getAttribute("cer", false /* no exception */);
284       dwr = (*it)->getAttribute("dwr", false /* no exception */);
285       cea = (*it)->getAttribute("cea", false /* no exception */);
286       allowedInactivityTime = (*it)->getAttribute("allowedInactivityTime", false /* no exception */);
287       tcpConnectDelay = (*it)->getAttribute("tcpConnectDelay", false /* no exception */);
288       answersTimeout = (*it)->getAttribute("answersTimeout", false /* no exception */);
289       ceaTimeout = (*it)->getAttribute("ceaTimeout", false /* no exception */);
290       watchdogPeriod = (*it)->getAttribute("watchdogPeriod", false /* no exception */);
291       entity = (*it)->getAttribute("entity", false /* no exception */);
292       entityServerSessions = (*it)->getAttribute("entityServerSessions", false /* no exception */);
293       diameterServer = (*it)->getAttribute("diameterServer", false /* no exception */);
294       diameterServerSessions = (*it)->getAttribute("diameterServerSessions", false /* no exception */);
295       balance = (*it)->getAttribute("balance", false /* no exception */); // (yes | no)
296       sessionBasedModelsClientSocketSelection = (*it)->getAttribute("sessionBasedModelsClientSocketSelection", false /* no exception */); // (SessionIdHighPart | SessionIdOptionalPart | RoundRobin)
297       retries = (*it)->getAttribute("retries", false /* no exception */);
298       log = (*it)->getAttribute("log", false /* no exception */);
299       splitLog = (*it)->getAttribute("splitLog", false /* no exception */); // (yes | no)
300       detailedLog = (*it)->getAttribute("detailedLog", false /* no exception */); // (yes | no)
301       dumpLog = (*it)->getAttribute("dumpLog", false /* no exception */); // (yes | no)
302       burstLog = (*it)->getAttribute("burstLog", false /* no exception */); // (yes | no)
303
304       // Basic checkings:
305       anna::diameter::comm::OriginHostManager &ohm = anna::diameter::comm::OriginHostManager::instantiate();
306       anna::diameter::comm::OriginHost *oh = ohm.getOriginHost(originHost->getValue());
307       if (oh) {
308         std::string msg = "Already registered such Origin-Host: "; msg += originHost->getValue();
309         throw anna::RuntimeException(msg, ANNA_FILE_LOCATION);
310       }
311
312       unsigned int applicationId = appId->getIntegerValue();
313       if (!stackEngine.getDictionary(applicationId)) {
314         std::string msg = "Cannot found a registered stack id with the value of applicationId provided: "; msg += appId->getValue();
315         throw anna::RuntimeException(msg, ANNA_FILE_LOCATION);
316       }
317
318       // Engine time measures checking & assignment:
319       anna::Millisecond allowedInactivityTimeMs(90000);
320       anna::Millisecond tcpConnectDelayMs(200);
321       anna::Millisecond answersTimeoutMs(10000);
322       anna::Millisecond ceaTimeoutMs(10000);
323       anna::Millisecond watchdogPeriodMs(30000);
324
325       if (allowedInactivityTime) allowedInactivityTimeMs = checkTimeMeasure("allowedInactivityTime", allowedInactivityTime->getValue());
326       if (tcpConnectDelay)       tcpConnectDelayMs =       checkTimeMeasure("tcpConnectDelay",       tcpConnectDelay->getValue());
327       if (answersTimeout)        answersTimeoutMs =        checkTimeMeasure("answersTimeout",        answersTimeout->getValue());
328       if (ceaTimeout)            ceaTimeoutMs =            checkTimeMeasure("ceaTimeout",            ceaTimeout->getValue());
329       if (watchdogPeriod)        watchdogPeriodMs =        checkTimeMeasure("watchdogPeriod",        watchdogPeriod->getValue());
330
331       // Checking command line parameters
332       std::string sessionBasedModelsType;
333       anna::diameter::comm::Entity::SessionBasedModelsType::_v sessionBasedModelsTypeEnum;
334       if(sessionBasedModelsClientSocketSelection) {
335         sessionBasedModelsType = sessionBasedModelsClientSocketSelection->getValue();
336         if (sessionBasedModelsType == "RoundRobin") {
337           sessionBasedModelsTypeEnum = anna::diameter::comm::Entity::SessionBasedModelsType::RoundRobin;
338         }
339         else if (sessionBasedModelsType == "SessionIdOptionalPart") {
340           sessionBasedModelsTypeEnum = anna::diameter::comm::Entity::SessionBasedModelsType::SessionIdOptionalPart;
341         }
342         else if (sessionBasedModelsType == "SessionIdHighPart") {
343           sessionBasedModelsTypeEnum = anna::diameter::comm::Entity::SessionBasedModelsType::SessionIdHighPart;
344         }
345         else if (sessionBasedModelsType == "SessionIdLowPart") {
346           sessionBasedModelsTypeEnum = anna::diameter::comm::Entity::SessionBasedModelsType::SessionIdLowPart;
347         }
348         else {
349           throw anna::RuntimeException("Parameter 'sessionBasedModelsClientSocketSelection' only accepts 'SessionIdLowPart'/'SessionIdHighPart'/'SessionIdOptionalPart'/'RoundRobin' as parameter values", ANNA_FILE_LOCATION);
350         }
351       }
352
353       int retransmissions = retries ? retries->getIntegerValue() : 0;
354       if(retransmissions < 0) {
355         throw anna::RuntimeException("Parameter 'retries' must be non-negative", ANNA_FILE_LOCATION);
356       }
357
358       /////////////////////////////////////////////////////////////////////////////////////////////
359       // Diameter communication engine:
360       std::string commEngineName = originHost->getValue() + "_DiameterCommEngine";
361       MyDiameterEngine *commEngine = new MyDiameterEngine(commEngineName.c_str(), bpd);
362       commEngine->setAutoBind(false);  // allow to create client-sessions without binding them, in order to set timeouts.
363       commEngine->setMaxConnectionDelay(tcpConnectDelayMs);
364       commEngine->setWatchdogPeriod(watchdogPeriodMs);
365       commEngine->setOriginHostName(originHost->getValue());
366       if (originRealm) commEngine->setOriginRealmName(originRealm->getValue());
367
368       // Origin host node:
369       a_workingNode = new anna::diameter::comm::OriginHost((anna::diameter::comm::Engine*)commEngine, applicationId);
370       a_workingNode->setRequestRetransmissions(retransmissions);
371       /////////////////////////////////////////////////////////////////////////////////////////////
372
373
374       // Diameter entity:
375       if(entity) {
376         int sessions = entityServerSessions ? entityServerSessions->getIntegerValue() : 1;
377
378         if(sessions > 0) {
379           // Number of sessions:
380           commEngine->setNumberOfClientSessionsPerServer(sessions);
381
382           // Client CER and DWR
383           std::string cerPathfile = cer ? cer->getValue() : "";
384           std::string dwrPathfile = dwr ? dwr->getValue() : "";
385           commEngine->setClientCERandDWR(cerPathfile, dwrPathfile);
386
387           // Register one entity for this engine:
388           a_workingNode->createEntity(entity->getValue(), ceaTimeoutMs, answersTimeoutMs);
389           a_workingNode->getEntity()->setSessionBasedModelsType(sessionBasedModelsTypeEnum);
390           a_workingNode->getEntity()->setBalance(balance ? (balance->getValue() == "yes") : false); // for sendings
391           if (eventOperation) a_workingNode->getEntity()->bind();
392         }
393       }
394
395       // Diameter Server:
396       if(diameterServer) {
397         // Server CEA
398         std::string ceaPathfile = cea ? cea->getValue() : "";
399
400         int sessions = diameterServerSessions ? diameterServerSessions->getIntegerValue() : 1;
401         a_workingNode->createDiameterServer(diameterServer->getValue(), sessions, allowedInactivityTimeMs, answersTimeoutMs, ceaPathfile);
402       }
403
404       // Logs:
405       if (!allLogsDisabled) {
406         std::string host = commEngine->getOriginHostName();
407         std::string s_log = host + ".launcher.log"; if (log) s_log = log->getValue();
408         bool b_splitLog = (splitLog ? (splitLog->getValue() == "yes") : false);
409         bool b_detailedLog = (detailedLog ? (detailedLog->getValue() == "yes") : false);
410         bool b_dumpLog = (dumpLog ? (dumpLog->getValue() == "yes") : false);
411         std::string s_burstLog = host + ".launcher.burst"; if (burstLog) s_burstLog = burstLog->getValue();
412         a_workingNode->setLogs(s_log, b_splitLog, b_detailedLog, b_dumpLog, s_burstLog);
413       }
414
415
416       // Lazy initialization for comm engine:
417       if (eventOperation) commEngine->lazyInitialize();
418
419       // Node and Codec Engine registration ///////////////////////////////////////////////////////
420       ohm.registerOriginHost(originHost->getValue(), a_workingNode);
421       /////////////////////////////////////////////////////////////////////////////////////////////
422     }
423   }
424
425   if (!uniqueOriginHost())
426     a_workingNode = NULL; // by default, mode auto
427
428   // Diameter comm engines which are loaded after application start (via management operation 'services') are not really started,
429   //  but this don't care because application startComponents() -> initialize() -> do_initialize() -> do nothing.
430   // And when stopped, running state is not checked and it will be stopped anyway.
431 }
432
433
434 void Launcher::loadServices(const std::string & xmlPathFile, bool eventOperation) throw(anna::RuntimeException) {
435
436   if (xmlPathFile == "null" || xmlPathFile == "") {
437     LOGWARNING(anna::Logger::warning("Ignoring services configuration on start: empty or 'null' string provided as xml file. Use management interface (operation 'services') in order to add services", ANNA_FILE_LOCATION));
438     return;
439   }
440
441   LOGDEBUG(
442       std::string trace = "Loading ADML services file '";
443   trace += xmlPathFile;
444   trace += "'";
445   anna::Logger::debug(trace, ANNA_FILE_LOCATION);
446   );
447   anna::xml::DocumentFile xmlDocument; // has private copy constructor defined but not implemented to avoid inhenrit/copy (is very heavy)
448   anna::xml::DTDMemory xmlDTD;
449   const anna::xml::Node *rootNode;
450   xmlDocument.initialize(xmlPathFile.c_str()); // fail here is i/o error
451   xmlDTD.initialize(ServicesDTD);
452   try {
453     rootNode = xmlDocument.parse(xmlDTD); // Parsing: fail here if xml violates dtd
454   }
455   catch (anna::RuntimeException &ex) {
456     LOGWARNING(
457         std::string msg = "Services DTD schema:\n\n";
458     msg += ServicesDTD;
459     anna::Logger::warning(msg, ANNA_FILE_LOCATION);
460     );
461     throw ex;
462   }
463
464   LOGDEBUG(
465       std::string trace = "Loaded XML file (";
466   trace += xmlPathFile;
467   trace += "):\n";
468   trace += anna::xml::Compiler().apply(rootNode);
469   anna::Logger::debug(trace, ANNA_FILE_LOCATION);
470   );
471   servicesFromXML(rootNode, eventOperation);
472 }
473
474
475 anna::Millisecond Launcher::checkTimeMeasure(const std::string &parameter, const std::string &value) throw(anna::RuntimeException) {
476
477   if(anna::functions::isLike("^[0-9]+$", value)) {  // para incluir numeros decimales: ^[0-9]+(.[0-9]+)?$
478     int msecs;
479     std::istringstream ( value ) >> msecs;
480
481     if(msecs > a_timeEngine->getMaxTimeout()) { // 600000 ms
482       std::string msg = "Configuration value for '";
483       msg += parameter;
484       msg += "' ("; msg += value; msg += " msecs) is greater than allowed max timeout for timming engine: ";
485       msg += anna::functions::asString(a_timeEngine->getMaxTimeout());
486       throw RuntimeException(msg, ANNA_FILE_LOCATION);
487     }
488
489     if(msecs > 300000) {
490       std::string msg = "Configuration value for '";
491       msg += parameter;
492       msg += "' ("; msg += value; msg += " msecs) is perhaps very big (over 5 minutes).";
493       LOGWARNING(anna::Logger::warning(msg, ANNA_FILE_LOCATION));
494     }
495
496     if(msecs <= a_timeEngine->getResolution()) {
497       std::string msg = "Configuration value for '";
498       msg += parameter;
499       msg += "' ("; msg += value; msg += " msecs) as any other time measure, must be greater than timming engine resolution: ";
500       msg += anna::functions::asString(a_timeEngine->getResolution());
501       throw RuntimeException(msg, ANNA_FILE_LOCATION);
502     }
503
504     return (anna::Millisecond)msecs; // ok
505   }
506
507   // Non-integer exception:
508   std::string msg = "Configuration error for '";
509   msg += parameter;
510   msg += "' = '";
511   msg += value;
512   msg += "': must be a non-negative integer number";
513   throw RuntimeException(msg, ANNA_FILE_LOCATION);
514 }
515
516 bool Launcher::setWorkingNode(const std::string &name) throw() {
517   bool result = false;
518
519   anna::diameter::comm::OriginHostManager &ohm = anna::diameter::comm::OriginHostManager::instantiate();
520   anna::diameter::comm::OriginHost *oh = ohm.getOriginHost(name);
521
522   if (oh) {
523     a_workingNode = const_cast<anna::diameter::comm::OriginHost*>(oh);
524     result = true;
525   }
526
527   return result;
528 }
529
530 anna::diameter::comm::OriginHost *Launcher::getOriginHost(const std::string &name) const throw(anna::RuntimeException) {
531   anna::diameter::comm::OriginHostManager &ohm = anna::diameter::comm::OriginHostManager::instantiate();
532   anna::diameter::comm::OriginHost *result = ohm.getOriginHost(name);
533
534   if (!result)
535   throw anna::RuntimeException(anna::functions::asString("There is no origin host registered as '%s' (set Origin-Host avp correctly or force a specific host with 'node' operation)", name.c_str()), ANNA_FILE_LOCATION);
536
537   return result;
538 }
539
540 anna::diameter::comm::OriginHost *Launcher::getOriginHost(const anna::diameter::codec::Message &message) const throw(anna::RuntimeException) {
541   std::string originHost = message.getAvp(anna::diameter::helpers::base::AVPID__Origin_Host)->getDiameterIdentity()->getValue();
542   return (getOriginHost(originHost));
543 }
544
545 bool Launcher::uniqueOriginHost() const throw() {
546   anna::diameter::comm::OriginHostManager &ohm = anna::diameter::comm::OriginHostManager::instantiate();
547   return (ohm.size() == 1);
548 }
549
550
551 void Launcher::updateOperatedOriginHostWithMessage(const anna::diameter::codec::Message &message) throw(anna::RuntimeException) {
552   if (!a_operatedHost) // priority for working node by mean 'node' operation
553     a_operatedHost = getOriginHost(message);
554 }
555
556 anna::diameter::comm::OriginHost *Launcher::getWorkingNode() const throw(anna::RuntimeException) {
557   if(!a_workingNode)
558     throw anna::RuntimeException("Working node not identified (try to load services)", ANNA_FILE_LOCATION);
559
560   return a_workingNode;
561 }
562
563 anna::diameter::comm::OriginHost *Launcher::getOperatedHost() const throw(anna::RuntimeException) {
564   if(!a_operatedHost)
565     throw anna::RuntimeException("Node not identified (try to force a specific Origin-Host with 'node' operation)", ANNA_FILE_LOCATION);
566
567   return a_operatedHost;
568 }
569
570 MyDiameterEntity *Launcher::getOperatedEntity() const throw(anna::RuntimeException) {
571   MyDiameterEntity *result = (MyDiameterEntity *)(getOperatedHost()->getEntity());
572   if (!result)
573     throw anna::RuntimeException("No entity configured for the operated node", ANNA_FILE_LOCATION);
574   return result;
575 }
576
577 MyLocalServer *Launcher::getOperatedServer() const throw(anna::RuntimeException) {
578   MyLocalServer *result = (MyLocalServer *)(getOperatedHost()->getDiameterServer());
579   if (!result)
580     throw anna::RuntimeException("No local server configured for the operated node", ANNA_FILE_LOCATION);
581   return result;
582 }
583
584 MyDiameterEngine *Launcher::getOperatedEngine() const throw(anna::RuntimeException) {
585   return (MyDiameterEngine *)getOperatedHost()->getCommEngine(); // never will be NULL
586 }
587
588 void Launcher::initialize()
589 throw(anna::RuntimeException) {
590   anna::comm::Application::initialize();
591   CommandLine& cl(anna::CommandLine::instantiate());
592   anna::comm::Communicator::WorkMode::_v workMode(anna::comm::Communicator::WorkMode::Single);
593   a_communicator = new MyCommunicator(workMode);
594   a_timeEngine = new anna::timex::Engine((anna::Millisecond)600000, a_admlMinResolution);
595   anna::testing::TestManager::instantiate().setTimerController(a_timeEngine);
596
597   // Counters record procedure:
598   const char *varname = "cntRecordPeriod";
599   anna::Millisecond cntRecordPeriod;
600   try {
601     cntRecordPeriod = (cl.exists(varname)) ? checkTimeMeasure(varname, cl.getValue(varname)) : (anna::Millisecond)300000;
602   }
603   catch(anna::RuntimeException &ex) {
604     if (cntRecordPeriod != 0) throw ex;
605   }
606
607   if(cntRecordPeriod != 0) {
608     a_counterRecorderClock = new MyCounterRecorderClock("Counters record procedure clock", cntRecordPeriod); // clock
609     std::string cntDir = ".";
610     if(cl.exists("cntDir")) cntDir = cl.getValue("cntDir");
611     a_counterRecorder = new MyCounterRecorder(cntDir + anna::functions::asString("/Counters.Pid%d", (int)getPid()));
612   }
613
614   // Testing framework:
615   std::string tmDir = ".";
616   if(cl.exists("tmDir")) tmDir = cl.getValue("tmDir");
617   anna::testing::TestManager::instantiate().setReportsDirectory(tmDir);
618
619   // Tracing:
620   if(cl.exists("trace"))
621     anna::Logger::setLevel(anna::Logger::asLevel(cl.getValue("trace")));
622
623   // Load launcher services:
624   loadServices(cl.getValue("services")); // before run (have components to be created)
625 }
626
627 void Launcher::run()
628 throw(anna::RuntimeException) {
629   LOGMETHOD(anna::TraceMethod tm("Launcher", "run", ANNA_FILE_LOCATION));
630   CommandLine& cl(anna::CommandLine::instantiate());
631   anna::diameter::stack::Engine::instantiate();
632
633   // Start time:
634   a_start_time.setNow();
635
636   // Initial working directory:
637   char cwd[1024];
638   if (getcwd(cwd, sizeof(cwd)) == NULL)
639     throw anna::RuntimeException("Cannot retrieve initial working directory !!", ANNA_FILE_LOCATION);
640   a_initialWorkingDirectory = cwd;
641
642   // Statistics:
643   anna::statistics::Engine::instantiate().enable();
644
645   LOGINFORMATION(
646       // Help on startup traces:
647       anna::Logger::information(help(), ANNA_FILE_LOCATION);
648   // Test messages dtd:
649   std::string msg = "\n                     ------------- TESTMESSAGES DTD -------------\n";
650   msg += anna::diameter::codec::MessageDTD;
651   anna::Logger::information(msg, ANNA_FILE_LOCATION);
652   );
653
654   // HTTP Server:
655   if(cl.exists("httpServer")) {
656     anna::comm::Network& network = anna::comm::Network::instantiate();
657     std::string address;
658     int port;
659     anna::functions::getAddressAndPortFromSocketLiteral(cl.getValue("httpServer"), address, port);
660     //const anna::comm::Device* device = network.find(Device::asAddress(address)); // here provide IP
661     const anna::comm::Device* device = *((network.resolve(address)->device_begin())); // trick to solve
662     a_httpServerSocket = new anna::comm::ServerSocket(anna::comm::INetAddress(device, port), cl.exists("httpServerShared") /* shared bind */, &anna::http::Transport::getFactory());
663   }
664
665   ///////////////////////////////
666   // Diameter library COUNTERS //
667   ///////////////////////////////
668   anna::diameter::comm::OamModule & oamDiameterComm = anna::diameter::comm::OamModule::instantiate();
669   oamDiameterComm.initializeCounterScope(1);  // 1000 - 1999
670   oamDiameterComm.enableCounters();
671   oamDiameterComm.enableAlarms();
672   anna::diameter::codec::OamModule & oamDiameterCodec = anna::diameter::codec::OamModule::instantiate();
673   oamDiameterCodec.initializeCounterScope(2);  // 2000 - 2999
674   oamDiameterCodec.enableCounters();
675   oamDiameterCodec.enableAlarms();
676   /////////////////
677   // COMM MODULE //
678   /////////////////
679   /* Main events */
680   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::RequestReceived, "" /* get defaults for enum type*/, 0 /*1000*/);
681   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::AnswerReceived,                 "", 1 /*1001*/);
682   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::RequestReceivedOnClientSession, "", 2 /*1002*/);
683   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::AnswerReceivedOnClientSession,  "", 3 /*1003*/);
684   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::RequestReceivedOnServerSession, "", 4 /* etc. */);
685   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::AnswerReceivedOnServerSession,  "", 5);
686   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::RequestSentOK,                  "", 6);
687   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::RequestSentNOK,                 "", 7);
688   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::AnswerSentOK,                   "", 8);
689   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::AnswerSentNOK,                  "", 9);
690   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::RequestSentOnClientSessionOK,   "", 10);
691   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::RequestSentOnClientSessionNOK,  "", 11);
692   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::AnswerSentOnClientSessionOK,    "", 12);
693   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::AnswerSentOnClientSessionNOK,   "", 13);
694   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::RequestSentOnServerSessionOK,   "", 14);
695   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::RequestSentOnServerSessionNOK,  "", 15);
696   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::AnswerSentOnServerSessionOK,    "", 16);
697   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::AnswerSentOnServerSessionNOK,   "", 17);
698   /* Diameter Base (capabilities exchange & keep alive) */
699   // as client
700   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::CERSentOK,   "", 18);
701   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::CERSentNOK,  "", 19);
702   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::CEAReceived, "", 20);
703   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::DWRSentOK,   "", 21);
704   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::DWRSentNOK,  "", 22);
705   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::DWAReceived, "", 23);
706   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::DPRSentOK,   "", 24);
707   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::DPRSentNOK,  "", 25);
708   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::DPAReceived, "", 26);
709   // as server
710   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::CERReceived, "", 27);
711   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::CEASentOK,   "", 28);
712   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::CEASentNOK,  "", 29);
713   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::DWRReceived, "", 30);
714   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::DWASentOK,   "", 31);
715   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::DWASentNOK,  "", 32);
716   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::DPRReceived, "", 33);
717   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::DPASentOK,   "", 34);
718   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::DPASentNOK,  "", 35);
719   /* server socket operations (enable/disable listening port for any local server) */
720   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::ServerSocketsOpened, "", 36);
721   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::ServerSocketsClosed, "", 37);
722   /* Connectivity */
723   // clients
724   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::UnableToDeliverOverEntity,                  "", 38);
725   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::LostAvailabilityOverClientSession,          "", 39);
726   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::RecoveredAvailabilityOverClientSession,     "", 40);
727   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::LostAvailabilityOverServer,                 "", 41);
728   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::RecoveredAvailabilityOverServer,            "", 42);
729   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::LostAvailabilityOverEntity,                 "", 43);
730   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::RecoveredAvailabilityOverEntity,            "", 44);
731   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::LostAvailabilityOverEngineForEntities,      "", 45);
732   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::RecoveredAvailabilityOverEngineForEntities, "", 46);
733   // servers
734   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::UnableToDeliverToClient,                                    "", 47);
735   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::LostConnectionForServerSession,                             "", 48);
736   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::UnbindConnectionForServerSessionDueToInactivityTimeAnomaly, "", 49);
737   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::CreatedConnectionForServerSession,                          "", 50);
738   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::LostAvailabilityOverLocalServer,                            "", 51);
739   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::RecoveredAvailabilityOverLocalServer,                       "", 52);
740   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::LostAvailabilityOverEngineForLocalServers,                  "", 53);
741   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::RecoveredAvailabilityOverEngineForLocalServers,             "", 54);
742   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::RequestSentExpired,  "", 55);
743   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::RequestSentOnClientSessionExpired,  "", 56);
744   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::RequestSentOnServerSessionExpired,  "", 57);
745   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::RequestRetransmitted,  "", 58);
746   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::RequestRetransmittedOnClientSession,  "", 59);
747   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::RequestRetransmittedOnServerSession,  "", 60);
748   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::AnswerReceivedUnknown,  "", 61);
749   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::AnswerReceivedOnClientSessionUnknown,  "", 62);
750   oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::AnswerReceivedOnServerSessionUnknown,  "", 63);
751   //////////////////
752   // CODEC MODULE //
753   //////////////////
754   /* Avp decoding */
755   oamDiameterCodec.registerCounter(anna::diameter::codec::OamModule::Counter::AvpDecode__NotEnoughBytesToCoverAvpHeaderLength,                          "", 0 /*2000*/);
756   oamDiameterCodec.registerCounter(anna::diameter::codec::OamModule::Counter::AvpDecode__IncoherenceBetweenActivatedVBitAndZeroedVendorIDValueReceived, "", 1 /*2001*/);
757   oamDiameterCodec.registerCounter(anna::diameter::codec::OamModule::Counter::AvpDecode__IncorrectLength,                                               "", 2 /*2002*/);
758   oamDiameterCodec.registerCounter(anna::diameter::codec::OamModule::Counter::AvpDecode__DataPartInconsistence,                                         "", 3 /*2003*/);
759   oamDiameterCodec.registerCounter(anna::diameter::codec::OamModule::Counter::AvpDecode__UnknownAvpWithMandatoryBit,                                    "", 4 /*2004*/);
760   /* Message decoding */
761   oamDiameterCodec.registerCounter(anna::diameter::codec::OamModule::Counter::MessageDecode__NotEnoughBytesToCoverMessageHeaderLength, "", 5 /*2005*/);
762   oamDiameterCodec.registerCounter(anna::diameter::codec::OamModule::Counter::MessageDecode__NotEnoughBytesToCoverMessageLength,       "", 6 /*2006*/);
763   /* Avp validation */
764   oamDiameterCodec.registerCounter(anna::diameter::codec::OamModule::Counter::AvpValidation__EnumeratedAvpWithValueDoesNotComplyRestriction, "", 10 /*2010*/);
765   oamDiameterCodec.registerCounter(anna::diameter::codec::OamModule::Counter::AvpValidation__AvpFlagsDoesNotFulfillTheDefinedFlagRules,      "", 11 /*2011*/);
766   /* Message validation */
767   oamDiameterCodec.registerCounter(anna::diameter::codec::OamModule::Counter::MessageValidation__UnknownOperationUnableToValidate, "", 12 /*2012*/);
768   oamDiameterCodec.registerCounter(anna::diameter::codec::OamModule::Counter::MessageValidation__OperationHaveIncoherentFlags,     "", 13 /*2013*/);
769   /* Level validation */
770   oamDiameterCodec.registerCounter(anna::diameter::codec::OamModule::Counter::LevelValidation__MissingFixedRule,                                       "", 14 /*2014*/);
771   oamDiameterCodec.registerCounter(anna::diameter::codec::OamModule::Counter::LevelValidation__FailedRuleForCardinality,                               "", 15 /*2015*/);
772   oamDiameterCodec.registerCounter(anna::diameter::codec::OamModule::Counter::LevelValidation__FailedRuleForCardinalityLessThanNeeded,                 "", 16 /*2016*/);
773   oamDiameterCodec.registerCounter(anna::diameter::codec::OamModule::Counter::LevelValidation__FailedRuleForCardinalityMoreThanNeeded,                 "", 17 /*2017*/);
774   oamDiameterCodec.registerCounter(anna::diameter::codec::OamModule::Counter::LevelValidation__FailedGenericAvpRuleForCardinalityFoundDisregardedItem, "", 18 /*2018*/);
775   oamDiameterCodec.registerCounter(anna::diameter::codec::OamModule::Counter::LevelValidation__FoundDisregardedItemsAndGenericAVPWasNotSpecified,      "", 19 /*2019*/);
776
777
778   /////////////////////////////////
779   // Counter recorder associated //
780   /////////////////////////////////
781   if(a_counterRecorderClock) {
782     oamDiameterComm.setCounterRecorder(a_counterRecorder);
783     oamDiameterCodec.setCounterRecorder(a_counterRecorder);
784     anna::diameter::comm::ApplicationMessageOamModule::instantiate().setCounterRecorder(a_counterRecorder);
785     a_timeEngine->activate(a_counterRecorderClock); // start clock
786   }
787
788   /////////////////////////////
789   // Log statistics concepts //
790   /////////////////////////////
791   if(cl.exists("logStatisticSamples"))
792     logStatisticsSamples(cl.getValue("logStatisticSamples"));
793
794   // Start client connections //////////////////////////////////////////////////////////////////////////////////
795   MyDiameterEntity *entity;
796   anna::diameter::comm::OriginHostManager &ohm = anna::diameter::comm::OriginHostManager::instantiate();
797   for (diameter::comm::origin_hosts_it it = ohm.begin(); it != ohm.end(); it++) {
798     entity = (MyDiameterEntity *)(it->second->getEntity());
799     if (entity) entity->bind();
800   }
801
802   // Go into communicator poll
803   // Reconnection period (tcp reconnect retry time):
804   const char *varname = "reconnectionPeriod";
805   anna::Millisecond reconnectionPeriod = (cl.exists(varname)) ? checkTimeMeasure(varname, cl.getValue(varname)) : (anna::Millisecond)10000;
806
807   a_communicator->setRecoveryTime(reconnectionPeriod);
808   if(cl.exists("httpServer")) a_communicator->attach(a_httpServerSocket);  // HTTP
809   a_communicator->accept();
810 }
811
812 bool Launcher::getDataBlockFromHexFile(const std::string &pathfile, anna::DataBlock &db) const throw(anna::RuntimeException) {
813   // Get hex string
814   static char buffer[8192];
815   std::ifstream infile(pathfile.c_str(), std::ifstream::in);
816
817   if(infile.is_open()) {
818     infile >> buffer;
819     std::string hexString(buffer, strlen(buffer));
820     // Allow colon separator in hex string: we have to remove them before processing with 'fromHexString':
821     hexString.erase(std::remove(hexString.begin(), hexString.end(), ':'), hexString.end());
822     LOGDEBUG(
823         std::string msg = "Hex string (remove colons if exists): ";
824     msg += hexString;
825     anna::Logger::debug(msg, ANNA_FILE_LOCATION);
826     );
827
828     anna::functions::fromHexString(hexString, db); // could launch exception
829     // Close file
830     infile.close();
831     return true;
832   }
833
834   return false;
835 }
836
837 bool Launcher::getContentFromFile(const std::string &pathfile, std::string &content) const throw(anna::RuntimeException) {
838
839   std::ifstream inFile(pathfile.c_str(), std::ifstream::in);
840   if(!inFile.good()) {
841     throw RuntimeException(anna::functions::asString("Unable to open file '%s'", pathfile.c_str()), ANNA_FILE_LOCATION);
842   }
843
844   std::stringstream strStream;
845   strStream << inFile.rdbuf(); //read the file
846   content = strStream.str(); // holds the content of the file
847   inFile.close();
848
849   return true;
850 }
851
852 void Launcher::resetStatistics() throw() {
853   if (a_workingNode) {
854     a_workingNode->getCommEngine()->resetStatistics();
855   }
856   else {
857     anna::diameter::comm::OriginHostManager &ohm = anna::diameter::comm::OriginHostManager::instantiate();
858     for (diameter::comm::origin_hosts_it it = ohm.begin(); it != ohm.end(); it++) {
859       it->second->getCommEngine()->resetStatistics();
860     }
861   }
862 }
863
864 void Launcher::resetCounters() throw() {
865   anna::diameter::comm::OamModule::instantiate().resetCounters();
866   anna::diameter::comm::ApplicationMessageOamModule::instantiate().resetCounters();
867   anna::diameter::codec::OamModule::instantiate().resetCounters();
868 }
869
870 void Launcher::signalUSR2() throw(anna::RuntimeException) {
871
872   std::string inputFile = getSignalUSR2InputFile();
873   std::string outputFile = getSignalUSR2OutputFile();
874
875   LOGNOTICE(
876   std::string msg = "Captured signal SIGUSR2. Reading tasks at '";
877   msg += inputFile;
878   msg += "' (results will be written at '";
879   msg += outputFile;
880   msg += "')";
881   anna::Logger::notice(msg, ANNA_FILE_LOCATION);
882   );
883
884   // Operation:
885   std::string line;
886   std::string response_content;
887   std::ifstream in_file(inputFile);
888   std::ofstream out_file(outputFile);
889
890   if(!in_file.is_open()) throw RuntimeException("Unable to read tasks", ANNA_FILE_LOCATION);
891   if(!out_file.is_open()) throw RuntimeException("Unable to write tasks", ANNA_FILE_LOCATION);
892
893   while(getline(in_file, line)) {
894
895     // Ignore comments and blank lines:
896     if (line[0] == '#')  continue;
897     if (std::string::npos == line.find_first_not_of(" \t")) continue;
898
899     LOGDEBUG(
900         std::string msg = "Processing line: ";
901     msg += line;
902     anna::Logger::debug(msg, ANNA_FILE_LOCATION);
903     );
904
905     try {
906       eventOperation(line, response_content);
907     } catch(RuntimeException &ex) {
908       ex.trace();
909     }
910
911     out_file << response_content << "\n";
912   }
913
914   in_file.close();
915   out_file << "EOF\n";
916   out_file.close();
917 }
918
919 std::string Launcher::help() const throw() {
920   std::string result = "\n";
921   result += "\n                     ------------- HELP -------------\n";
922   result += "\n";
923   result += "\nOVERVIEW";
924   result += "\n--------";
925   result += "\n";
926   result += "\nThe ADML (ANNA Diameter MultiHost Launcher) process is a multi-host node with client and server";
927   result += "\n capabilities as well as balancer (proxy) features. It could be used as diameter server (i.e. to";
928   result += "\n simulate PCRF nodes, OCS systems, etc.), as diameter client (GGSNs, DPIs, etc.), and balancer";
929   result += "\n systems to provide failover to external round-robin launchers. Also, auxiliary encoder/decoder/loader";
930   result += "\n function could be deployed to reinterpret certain external flow and send it to another process.";
931   result += "\n ";
932   result += "\nThe ANNA::diameter_comm built-in module provides a great set of characteristics as multiple connections";
933   result += "\n on both server and client side, definition for multiple-server entities (and not only two as standard";
934   result += "\n establish as minimum), separate statistics analyzer per each resource, automatic CER/CEA and DWR/DWA";
935   result += "\n generation, expiration control and many more features.";
936   result += "\n";
937   result += "\nThe ADML process can easily configure a many origin-host nodes as needed, which will have own endpoints.";
938   result += "\nYou should avoid loop configurations (client and server for that client) because automatic forwarding,";
939   result += "\n is implemented and this would get in a never ending cycle when a request is sent.";
940   result += "\n";
941   result += "\nProcess traces are dump on \"launcher.trace\" and could have any trace level (POSIX levels), usually";
942   result += "\n 'debug' or 'warning'. See ANNA documentation for more details.";
943   result += "\n";
944   result += "\nAs any other ANNA process, context dump could be retrieved sending SIGUSR1 signal:";
945   result += "\n   kill -10 <pid>";
946   result += "\n    or";
947   result += "\n   kill -s SIGUSR1 <pid>";
948   result += "\n    and then";
949   result += "\n   vi /var/tmp/anna.context.<pid>";
950   result += "\n";
951   result += "\nA complete xml report will show all the context information (counters, alarms, statistics,";
952   result += "\n handlers, diameter stacks, etc.), and a powerful log module could dump all the events";
953   result += "\n processed and flow information. Statistics could be analized at context dump and optionally";
954   result += "\n written to disk as sample files (useful for graphs and spreadsheet reports) with all the";
955   result += "\n measurements.";
956   result += "\n";
957   result += "\nAlso SIGUSR2 is handled for management purposes. We will talk later about this.";
958   result += "\n";
959   result += "\n";
960   result += "\nCOMMAND LINE";
961   result += "\n------------";
962   result += "\n";
963   result += "\nStart the launcher process without arguments in order to see all the startup configuration";
964   result += "\n posibilities, many of which could be modified on the air through the management interface";
965   result += "\n (we will talk later about this great feature). There is only one mandatory parameter which";
966   result += "\n is the services definition: --services <services xml file>. You must follow the dtd schema";
967   result += "\n to build a valid services xml file. Some basic examples are:";
968   result += "\n";
969   result += "\nClient configuration:";
970   result += "\n";
971   result += "\n<services>";
972   result += "\n  <!-- Stacks -->";
973   result += "\n  <stack id=\"0\" dictionary=\"dictionary.xml\"/>";
974   result += "\n";
975   result += "\n  <!-- Nodes -->";
976   result += "\n  <node originHost=\"ADML-client\" applicationId=\"0\" entity=\"localhost:3868\"/>";
977   result += "\n</services>";
978   result += "\n";
979   result += "\nServer configuration:";
980   result += "\n";
981   result += "\n<services>";
982   result += "\n  <!-- Stacks -->";
983   result += "\n  <stack id=\"0\" dictionary=\"dictionary.xml\"/>";
984   result += "\n";
985   result += "\n  <!-- Nodes -->";
986   result += "\n  <node originHost=\"ADML-server\" applicationId=\"0\" diameterServer=\"localhost:3868\"/>";
987   result += "\n</services>";
988   result += "\n";
989   result += "\nIf you act as a proxy or a translation agent, you need to combine both former setups, and probably";
990   result += "\n will need to program the answers to be replied through the operations interface. To balance the";
991   result += "\n traffic at your client side you shall use '--balance' and '--sessionBasedModelsClientSocketSelection'";
992   result += "\n arguments in order to define the balancing behaviour. To make hybrid setups you only must mix the nodes:";
993   result += "\n";
994   result += "\nClient and server configuration:";
995   result += "\n";
996   result += "\n<services>";
997   result += "\n  <!-- Stacks -->";
998   result += "\n  <stack id=\"16777236\" dictionary=\"dictionary_Rx.xml\"/>";
999   result += "\n  <stack id=\"16777238\" dictionary=\"dictionary_Gx.xml\"/>";
1000   result += "\n  <stack id=\"0\" dictionary=\"dictionary_base.xml\"/>";
1001   result += "\n";
1002   result += "\n  <!-- Nodes -->";
1003   result += "\n  <node originHost=\"ADML-Rx-client\" applicationId=\"16777236\" entity=\"localhost:3868\" cer=\"cer_Rx.xml\"/>";
1004   result += "\n  <node originHost=\"ADML-Gx-client\" applicationId=\"16777238\" entity=\"localhost:3868\" cer=\"cer_Gx.xml\"/>";
1005   result += "\n</services>";
1006   result += "\n";
1007   result += "\n";
1008   result += "\nThe process builds automatically CER and DWR messages as a client, but you could specify your own";
1009   result += "\n as shown in the hybrid former example. Note that the base protocol stack must be registered because";
1010   result += "\n the configuration corresponds to a multistack process which change the stack using the application-id";
1011   result += "\n processed (0 in the case of base protocol messages: CER, CEA, DWR, DWA, DPR, DPA).";
1012   result += "\n";
1013   result += "\nDYNAMIC OPERATIONS";
1014   result += "\n------------------";
1015   result += "\n";
1016   result += "\nADML supports several operations which could be reconized via HTTP interface or SIGUSR2 caugh.";
1017   result += "\nAn operation is specified by mean a string containing the operation name and needed arguments";
1018   result += "\n separated by pipes. These are the available commands:";
1019   result += "\n";
1020   result += "\n--------------------------------------------------------------------------------------- General purpose";
1021   result += "\n";
1022   result += "\nhelp                                 This help.";
1023   result += "\n";
1024   result += "\n--------------------------------------------------------------------------------------- Node management";
1025   result += "\n";
1026   result += "\nnode[|<name>]                         Selects a context working node by mean a registered name (origin-host).";
1027   result += "\n                                      All the subsequent operations will be forced to work with";
1028   result += "\n                                      this node, which makes possible some rare scenarios like";
1029   result += "\n                                      sending unexpected messages on remote peers. This is also";
1030   result += "\n                                      useful for some operations in order to restrict the scope";
1031   result += "\n                                      of action (statistics, communication visibility, etc.).";
1032   result += "\n                                      Empty parameter will show the current configuration.";
1033   result += "\n";
1034   result += "\nnode_auto                             Returns to the default behaviour (smart node selection).";
1035   result += "\n                                      Depending on the operation, this could imply a global";
1036   result += "\n                                      action scope, affecting to all the registered hosts.";
1037   result += "\n                                      This should be the normal configuration. Take into";
1038   result += "\n                                      account that if you fix the working node, this could";
1039   result += "\n                                      affect to things like test programming: communication";
1040   result += "\n                                      resources will override those which would be inferred";
1041   result += "\n                                      from programmed messages Origin-Host avps.";
1042   result += "\n";
1043   result += "\n------------------------------------------------------------------------------------ Parsing operations";
1044   result += "\n";
1045   result += "\ncode|<source_file>|<target_file>     Encodes source file (pathfile) into target file (pathfile).";
1046   result += "\ndecode|<source_file>|<target_file>   Decodes source file (pathfile) into target file (pathfile).";
1047   result += "\nloadxml|<source_file>                Reinterpret xml source file (pathfile).";
1048   result += "\n";
1049   result += "\n------------------------------------------------------------------------------------------- Hot changes";
1050   result += "\n";
1051   result += "\nservices[|source file]               Adds and starts the services specified in the xml file provided.";
1052   result += "\n                                      (if missing, the file 'services.xml' will be used). This is used";
1053   result += "\n                                      to load new nodes once the ADML is started, regardless if command";
1054   result += "\n                                      line '--services' parameter was used or not. Those services which";
1055   result += "\n                                      are not correctly loaded will be ignored to keep the process alive.";
1056   result += "\n                                     If you need to load services as deltas, you must firstly load the";
1057   result += "\n                                      diameter base dictionary with stack id 0, because all the nodes";
1058   result += "\n                                      will use this dictionary to encode/decode base protocol messages";
1059   result += "\n                                      managed by the communication engine.";
1060   result += "\n";
1061   result += "\ndiameterServerSessions|<integer>     Updates the maximum number of accepted connections to diameter";
1062   result += "\n                                      server socket.";
1063   result += "\ncontext[|target file]                Application context could also be written by mean this operation,";
1064   result += "\n                                      and not only through SIGUSR1. If optional path file is missing,";
1065   result += "\n                                      default '/var/tmp/anna.context.<pid>' will be used.";
1066   result += "\ncollect                              Reset statistics and counters to start a new test stage of";
1067   result += "\n                                      performance measurement. Context data can be written at";
1068   result += "\n                                      '/var/tmp/anna.context.<pid>' by mean 'kill -10 <pid>'.";
1069   result += "\n                                      or sending operation 'context|[target file]'.";
1070   result += "\n                                     This operation applies over all the registered host nodes";
1071   result += "\n                                      except if one specific working node has been set.";
1072   result += "\nforceCountersRecord                  Forces dump to file the current counters of the process.";
1073   result += "\nlog-statistics-samples|<list>        Log statistics samples for the provided comma-separated concept id";
1074   result += "\n                                      list, over './sample.<concept id>.csv' files. For example: \"1,2\"";
1075   result += "\n                                      will log concepts 1 and 2. Reserved words \"all\"/\"none\" activates/";
1076   result += "\n                                      deactivates all registered statistics concept identifiers. That ids";
1077   result += "\n                                      are shown at context dump.";
1078   result += "\nchange-dir[|directory]               Changes the execution point which could be fine to ease some";
1079   result += "\n                                     file system interaction tasks. Be care about some requirements";
1080   result += "\n                                     (for example if you have a user defined counters directory as";
1081   result += "\n                                     relative path this must exists from the new execution directory).";
1082   result += "\n                                     If nothing provided, initial working directory will be restored.";
1083   result += "\nshow-oam                             Dumps current counters of the process. This is also done at";
1084   result += "\n                                      process context dump.";
1085   result += "\nshow-stats                           Dumps statistics of the process. This is also done at process";
1086   result += "\n                                      context dump.";
1087   result += "\n";
1088   result += "\n<visibility action>[|<address>:<port>][|socket id]";
1089   result += "\n";
1090   result += "\n       Actions: hide, show (update state) and hidden, shown (query state).";
1091   result += "\n       Acts over a client session for messages delivery (except CER/A, DWR/A, DPR/A).";
1092   result += "\n       If missing server (first parameter) all applications sockets will be affected.";
1093   result += "\n       If missing socket (second parameter) for specific server, all its sockets will be affected.";
1094   result += "\n";
1095   result += "\n       All application client sessions are shown on startup, but standard delivery only use primary";
1096   result += "\n        server ones except if fails. Balance configuration use all the allowed sockets. You could also";
1097   result += "\n        use command line 'sessionBasedModelsClientSocketSelection' to force traffic flow over certain";
1098   result += "\n        client sessions, but for this, hide/show feature seems easier.";
1099   result += "\n";
1100   result += "\n--------------------------------------------------------------------------------------- Flow operations";
1101   result += "\n";
1102   result += "\nsendxml2e|<source_file>    Sends xml source file (pathfile) through configured entity.";
1103   result += "\nsendxml2c|<source_file>    Sends xml source file (pathfile) to client.";
1104   result += "\nanswerxml2e[|source_file]  Answer xml source file (pathfile) for incoming request with same code from entity.";
1105   result += "\n                           The answer is stored in a FIFO queue for a specific message code, then there are";
1106   result += "\n                           as many queues as different message codes have been programmed.";
1107   result += "\nanswerxml2c[|source_file]  Answer xml source file (pathfile) for incoming request with same code from client.";
1108   result += "\n                           The answer is stored in a FIFO queue for a specific message code, then there are";
1109   result += "\n                           as many queues as different message codes have been programmed.";
1110   result += "\nanswerxml<2e/2c>           List programmed answers (to entity/client) if no parameter provided.";
1111   result += "\nanswerxml<2e/2c>|dump      Write programmed answers (to entity/client) to file 'programmed_answer.<message code>.<sequence>',";
1112   result += "\n                           where 'sequence' is the order of the answer in each FIFO code-queue of programmed answers.";
1113   result += "\nanswerxml<2e/2c>|clear     Clear programmed answers (to entity/client).";
1114   result += "\nanswerxml<2e/2c>|exhaust   Disable the corresponding queue rotation, which is the default behaviour.";
1115   result += "\nanswerxml<2e/2c>|rotate    Enable the corresponding queue rotation, useful in performance tests.";
1116   result += "\n                           Rotation consists in add again to the queue, each element retrieved for answering.";
1117   result += "\n";
1118   result += "\nSend operations are available using hexadecimal content (hex formatted files) which also allow to test";
1119   result += "\nspecial scenarios (protocol errors):";
1120   result += "\n";
1121   result += "\nsendhex2e|<source_file>    Sends hex source file (pathfile) through configured entity.";
1122   result += "\nsendhex2c|<source_file>    Sends hex source file (pathfile) to client.";
1123   result += "\n";
1124   result += "\nAnswer programming in hexadecimal is not really neccessary (you could use send primitives) and also";
1125   result += "\n is intended to be used with decoded messages in order to replace things like hop by hop, end to end,";
1126   result += "\n subscriber id, session id, etc. Anyway you could use 'decode' operation and then program the xml created.";
1127   result += "\n";
1128   result += "\nIf a request is received, answer map (built with 'answerxml<2e/2c>' operations) will be";
1129   result += "\n checked to find a corresponding programmed answer to be replied(*). If no ocurrence is found,";
1130   result += "\n or answer message was received, the message is forwarded to the other side (entity or client),";
1131   result += "\n or nothing but trace when no peer at that side is configured. Answer to client have sense when";
1132   result += "\n diameter server socket is configured, answer to entity have sense when entity does.";
1133   result += "\n";
1134   result += "\nIn the most complete situation (process with both client and server side) there are internally";
1135   result += "\n two maps with N FIFO queues, one for each different message code within programmed answers.";
1136   result += "\nOne map is for answers towards the client, and the other is to react entity requests. Then in";
1137   result += "\n each one we could program different answers corresponding to different request codes received.";
1138   result += "\n";
1139   result += "\n(*) sequence values (hop-by-hop and end-to-end), Session-Id and Subscription-Id avps, are mirrored";
1140   result += "\n    to the peer which sent the request. If user wants to test a specific answer without changing it,";
1141   result += "\n    use sendxml<2e/2c>/sendhex<2e/2c> operations better than programming.";
1142   result += "\n";
1143   result += "\nBalance ('--balance' command line parameter) could be used to forward server socket receptions through";
1144   result += "\n entity servers by mean a round-robin algorithm. Both diameter server socket and entity targets should";
1145   result += "\n have been configured, that is to say: launcher acts as client and server. If no balance is used, an";
1146   result += "\n standard delivery is performed: first primary entity server, secondary when fails, etc.";
1147   result += "\n";
1148   result += "\n--------------------------------------------------------------------------- Processing types (log tags)";
1149   result += "\n";
1150   result += "\nUsed as log file extensions (when '--splitLog' is provided on command line) and context preffixes on log";
1151   result += "\n details when unique log file is dumped:";
1152   result += "\n";
1153   result += "\n   [sent2e/send2eError]   Send to entity (success/error)";
1154   result += "\n   [sent2c/send2cError]   Send to client (success/error)";
1155   result += "\n   [fwd2e/fwd2eError]     Forward to entity a reception from client (success/error)";
1156   result += "\n   [fwd2c/fwd2cError]     Forward to client a reception from entity (success/error)";
1157   result += "\n   [recvfc]               Reception from client";
1158   result += "\n   [recvfe]               Reception from entity";
1159   result += "\n   [req2c-expired]        A request sent to client has been expired";
1160   result += "\n   [req2e-expired]        A request sent to entity has been expired";
1161   result += "\n   [recvfc-ans-unknown]   Reception from client of an unknown answer (probably former [req2c-expired]";
1162   result += "\n                           has been logged)";
1163   result += "\n   [recvfe-ans-unknown]   Reception from entity of an unknown answer (probably former [req2e-expired]";
1164   result += "\n                           has been logged)";
1165   result += "\n   [retry]                Request retransmission";
1166   result += "\n";
1167   result += "\n------------------------------------------------------------------------------------------- Burst tests";
1168   result += "\n";
1169   result += "\nIn order to simplify user experience, burst category operations are only allowed in single host node";
1170   result += "\n configuration. Indeed, you could send messages with unmatched Origin-Host, and no warning is shown.";
1171   result += "\nAll the operations are performed through the unique host: if you need to use more interfaces, you may";
1172   result += "\n launch different ADML instances. Is nonsense to allow burst in a multi-host configured ADML, because";
1173   result += "\n this feature is not able to coordinate the messages.";
1174   result += "\n";
1175   result += "\nburst|<action>[|parameter]     Used for performance testing, we first program diameter requests";
1176   result += "\n                                messages in order to launch them from client side to the configured";
1177   result += "\n                                diameter entity. We could start the burst with an initial load";
1178   result += "\n                                (non-asynchronous sending), after this, a new request will be sent";
1179   result += "\n                                per answer received or expired context. There are 10 actions: clear,";
1180   result += "\n                                load, start, push, pop, stop, repeat, send, goto and look.";
1181   result += "\n";
1182   result += "\n   burst|clear                 Clears all loaded burst messages.";
1183   result += "\n   burst|load|<source_file>    Loads the next diameter message into launcher burst.";
1184   result += "\n   burst|start|<initial load>  Starts (or restarts if already in progress) the message sending with";
1185   result += "\n                                a certain initial load.";
1186   result += "\n   burst|push|<load amount>    Sends specific non-aynchronous load.";
1187   result += "\n   burst|pop|<release amount>  Skip send burst messages in order to reduce over-the-air requests.";
1188   result += "\n                               Popping all OTA requests implies burst stop because no more answer";
1189   result += "\n                                will arrive to the process. Burst output file (--burstLog command";
1190   result += "\n                                line parameter) shows popped messages with crosses (x). Each cross";
1191   result += "\n                                represents one received answer for which no new request is sent.";
1192   result += "\n   burst|stop                  Stops the burst cycle. You can resume pushing 1 load amount.";
1193   result += "\n   burst|repeat[|[yes]|no]     Restarts the burst launch when finish. If initial load or push load";
1194   result += "\n                                amount is greater than burst list size, they will be limited when";
1195   result += "\n                                the list is processed except when repeat mode is enabled.";
1196   result += "\n   burst|send|<amount>         Sends messages from burst list. The main difference with start/push";
1197   result += "\n                                operations is that burst won't be awaken. Externally we could control";
1198   result += "\n                                sending time (no request will be sent for answers).";
1199   result += "\n   burst|goto|<order>          Updates current burst pointer position.";
1200   result += "\n   burst|look[|order]          Show programmed burst message for order provided, current when missing.";
1201   result += "\n";
1202   result += "\n-------------------------------------------------------------------------------------- Advanced testing";
1203   result += "\n";
1204   result += "\n                           Burst mode only allows single interface interaction. For multiple interface";
1205   result += "\n                            (origin-host) coordination, you could use the advanced test cases programming:";
1206   result += "\n";
1207   result += "\n";
1208   result += "\n   test|<id>|<command>[|parameters]";
1209   result += "\n";
1210   result += "\n                           Adds a new step to the test case with provided identifier. If provided identifier";
1211   result += "\n                            is not registered yet, a new test case will be created with that value and the";
1212   result += "\n                            step will be added as the first. For a specific 'id', the steps are stored in";
1213   result += "\n                            order as they are programmed. Check possible runtime exceptions when adding a";
1214   result += "\n                            new step because those which fail, will be ignored/skipped during test case";
1215   result += "\n                            programming giving an incomplete sequence invalid for the testing purpose.";
1216   result += "\n";
1217   result += "\n                           <id>: integer number, normally monotonically increased for each test case. Some external";
1218   result += "\n                                 script/procedure shall clone a test case template in order to build a collection";
1219   result += "\n                                 of independent and coherent test cases (normally same type) with different context";
1220   result += "\n                                 values (Session-Id, Subscriber-Id, etc.).";
1221   result += "\n";
1222   result += "\n                           <command>: commands to be executed for the test id provided. Each command programmed";
1223   result += "\n                                      constitutes a test case 'step', numbered from 1 to N.";
1224   result += "\n";
1225   result += "\n                              timeout|<msecs>            Sets an asynchronous timer to restrict the maximum timeout";
1226   result += "\n                                                          until last test step. Normally, this command is invoked";
1227   result += "\n                                                          in the first step, anyway it measures the time from the";
1228   result += "\n                                                          execution point whatever it is. The expiration will abort";
1229   result += "\n                                                          the test if still running. One or more timeouts could be";
1230   result += "\n                                                          programmed (not usual), but the more restrict will apply.";
1231   result += "\n                                                         It is highly recommended to program a initial timeout step,";
1232   result += "\n                                                          or the test case could be eternally in-progress.";
1233   result += "\n";
1234   result += "\n                              sendxml2e|<source_file>[|<step number>]";
1235   result += "\n                                                         Sends xml source file (pathfile) to entity (it would be a";
1236   result += "\n                                                          'forward' event if it came through local server endpoint).";
1237   result += "\n                                                         Take into account that the xml message is encoded just on";
1238   result += "\n                                                          call. The xml file is not longer needed neither interpreted";
1239   result += "\n                                                          in case of modification, after calling this command.";
1240   result += "\n                                                         The step number should be provided for answers to indicate";
1241   result += "\n                                                          the 'wait for request' corresponding step. If you miss this";
1242   result += "\n                                                          reference, the sequence information (hop-by-hop, end-to-end)";
1243   result += "\n                                                          will be sent as they are in the answer xml message (realize";
1244   result += "\n                                                          the difficulty of predicting these information). Be sure to";
1245   result += "\n                                                          refer to a 'wait for request' step. Conditions like 'regexp'";
1246   result += "\n                                                          (as we will see later) are not verified.";
1247   result += "\n                                                         In the case of requests, the step number is used to force the";
1248   result += "\n                                                          copy of Session-Id value from the referred step.";
1249   result += "\n";
1250   result += "\n                              sendxml2c|<source_file>[|<step number>]";
1251   result += "\n                                                         Sends xml source file (pathfile) to client (it would be a";
1252   result += "\n                                                          'forward' event if it came through remote server endpoint).";
1253   result += "\n                                                         Same commented for 'sendxml2e' regarding the step number.";
1254   result += "\n";
1255   result += "\n                              delay|<msecs>              Blocking step until the time lapse expires. Useful to give ";
1256   result += "\n                                                          some cadence control and time schedule for a specific case.";
1257   result += "\n                                                         A value of 0 could be used as a dummy step.";
1258   result += "\n";
1259   result += "\n                              sh-command|<script>        External execution for script/executable via shell through a dedicated";
1260   result += "\n                                                          thread, providing the command and parameters. You could use dynamic";
1261   result += "\n                                                          variables ##<tag> to have more flexibility:";
1262   result += "\n                                                             Test pool cycle id: "; result += SH_COMMAND_TAG_FOR_REPLACE__CYCLE_ID;
1263   result += "\n                                                             Test case id:       "; result += SH_COMMAND_TAG_FOR_REPLACE__TESTCASE_ID;
1264   result += "\n                                                             Test step id:       "; result += SH_COMMAND_TAG_FOR_REPLACE__TESTSTEP_ID;
1265   result += "\n";
1266   result += "\n                                                         For example, your command could be something like this:";
1267   result += "\n                                                          insert_sql_"; result += SH_COMMAND_TAG_FOR_REPLACE__TESTCASE_ID; result += ".sh -db dbname --verbose";
1268   result += "\n                                                             > /tmp/cycle-"; result += SH_COMMAND_TAG_FOR_REPLACE__CYCLE_ID;
1269   result += ".testcase-"; result += SH_COMMAND_TAG_FOR_REPLACE__TESTCASE_ID;
1270   result += ".teststep-"; result += SH_COMMAND_TAG_FOR_REPLACE__TESTSTEP_ID;
1271   result += ".out";
1272   result += "\n                                                         Try to redirect stdout and stderr to avoid ADML output contamination";
1273   result += "\n                                                          with the possible outputs from the scripts. You could also put your";
1274   result += "\n                                                          job in background although sh-command will return 0-value immediately.";
1275   result += "\n";
1276   result += "\n                              wait<fe/fc>-hex|<source_file>[|strict]";
1277   result += "\n                                                         Wait condition, from entity (waitfe-hex) or client (waitfc-hex) to";
1278   result += "\n                                                          match the hexadecimal representation for received messages against";
1279   result += "\n                                                          source file (hex format). Fix mode must be enabled to avoid unexpected";
1280   result += "\n                                                          matching behaviour. Specify 'strict' to use the hex content 'as is'.";
1281   result += "\n                                                          If not, the hex content will be understood as whole message and then,";
1282   result += "\n                                                          borders will be added (^<content>$) and sequence information bypassed";
1283   result += "\n                                                          even for diameter answers.";
1284   result += "\n";
1285   result += "\n                              wait<fe/fc>-xml|<source_file>[|strict]";
1286   result += "\n                                                         Wait condition from entity (waitfe-xml) or client (waitfc-xml) to";
1287   result += "\n                                                          match the serialized xml content for received messages against";
1288   result += "\n                                                          source file (xml representation). Fix mode must be enabled to avoid";
1289   result += "\n                                                          unexpected matching behaviour. If you need a strict matching you";
1290   result += "\n                                                          must add parameter 'strict', if not, regexp is built ignoring sequence";
1291   result += "\n                                                          information (hop-by-hop-id=\"[0-9]+\" end-to-end-id=\"[0-9]+\") and";
1292   result += "\n                                                          Origin-State-Id value.";
1293   result += "\n                                                          All LF codes will be internally removed when comparison is executed";
1294   result += "\n                                                          in order to ease xml content configuration.";
1295   result += "\n";
1296   result += "\n                              wait<fe/fc>|<condition>    Blocking step until condition is fulfilled. The message could";
1297   result += "\n                                                          received from entity (waitfe) or from client (waitfc).";
1298   result += "\n                                                         CPU cost is lower than former 'wait<fe/fc>-<xml|hex>' variants.";
1299   result += "\n";
1300   result += "\n                                          <condition>: Optional parameters which must be fulfilled to continue through the next step.";
1301   result += "\n                                                       Any received message over diameter interfaces will be evaluated against the";
1302   result += "\n                                                        corresponding test case starting from the current step until the first one";
1303   result += "\n                                                        whose condition is fulfilled. If no condition is fulfilled the event will be";
1304   result += "\n                                                        classified as 'uncovered' (normally a test case bad configuration, or perhaps";
1305   result += "\n                                                        a real unexpected message).";
1306
1307   // TODO(***)
1308   //  result += "\n                                        The way to identify the test case, is through registered Session-Id values for";
1309   //  result += "\n                                         programmed requests. But this depends on the type of node. Acting as clients,";
1310   //  result += "\n                                         requests received have Session-Id values which are already registered with";
1311   //  result += "\n                                         one test case, causing an error if not found. Acting as servers, requests are";
1312   //  result += "\n                                         received over a diameter local server from a client which are generating that";
1313   //  result += "\n                                         Session-Id values. Then we know nothing about such values. The procedure in";
1314   //  result += "\n                                         this case is find out a test case not-started containing a condition which";
1315   //  result += "\n                                         comply with the incoming message, and reactivates it.";
1316   // The other solution: register Session-Id values for answers send to client from a local diameter server.
1317
1318   result += "\n                                                       How to answer: a wait condition for a request will store the incoming message";
1319   result += "\n                                                        which fulfills that condition. This message is useful together with the peer";
1320   result += "\n                                                        connection source in a further send step configured with the corresponding";
1321   result += "\n                                                        response. You could also insert a delay between wait and send steps to be";
1322   result += "\n                                                        more realistic (processing time simulation in a specific ADML host node).";
1323   result += "\n                                                        Always, a response send step will get the needed information from the most";
1324   result += "\n                                                        recent wait step finding in reverse order (note that some race conditions";
1325   result += "\n                                                        could happen if your condition is not specific enough).";
1326
1327   result += "\n";
1328   result += "\n                                                       Condition format:";
1329   result += "\n";
1330   result += "\n                                                          [code]|[bitR]|[hopByHop]|[applicationId]|[sessionId]|[resultCode]|[msisdn]|[imsi]|[serviceContextId]";
1331   result += "\n";
1332   result += "\n                                                            code: integer number";
1333   result += "\n                                                            bitR: 1 (request), 0 (answer)";
1334   result += "\n                                                            hopByHop: integer number or request send step reference: #<step number>";
1335   result += "\n";
1336   result += "\n                                                                      Using the hash reference, you would indicate a specific wait condition";
1337   result += "\n                                                                       for answers. The step number provided must correspond to any of the";
1338   result += "\n                                                                       previous send commands (sendxml2e/sendxml2c) configured for a request.";
1339   result += "\n                                                                      This 'hop-by-hop' variant eases the wait condition for answers in the";
1340   result += "\n                                                                       safest way.";
1341   result += "\n";
1342   result += "\n                                                            applicationId: integer number";
1343   result += "\n                                                            sessionId: string";
1344   result += "\n                                                            resultCode: integer number";
1345   result += "\n                                                            msisdn: string";
1346   result += "\n                                                            imsi: string";
1347   result += "\n                                                            serviceContextId: string";
1348   result += "\n";
1349   result += "\n                                                       Take into account these rules, useful in general:";
1350   result += "\n";
1351   result += "\n                                                          - Be as much specific as possible defining conditions to avoid ambiguity sending";
1352   result += "\n                                                            messages out of context due to race conditions. Although you could program several";
1353   result += "\n                                                            times similar conditions, some risky practices will throw a warning trace (if you";
1354   result += "\n                                                            repeat the same condition within the same test case).";
1355   result += "\n                                                          - Adding a ResultCode and/or HopByHop to the condition are only valid waiting answers.";
1356   result += "\n                                                          - Requests hop-by-hop values must be different for all the test case requests.";
1357   result += "\n                                                            RFC says that a hop by hop must be unique for a specific connection, something that";
1358   result += "\n                                                            could be difficult to manage if we have multiple available connections from client";
1359   result += "\n                                                            side endpoint (entity or local server), even if we would have only one connection but";
1360   result += "\n                                                            several host interfaces. It is enough to configure different hop-by-hop values within";
1361   result += "\n                                                            each test case, because on reception, the Session-Id is used to identify that test case.";
1362   result += "\n";
1363   result += "\n";
1364   result += "\n";
1365   result += "\n";
1366   result += "\n                           Programming example:";
1367   result += "\n";
1368   result += "\n                              Basic Rx/Gx scenary: PCEF (Gx) - PCRF - AF (Rx)";
1369   result += "\n";
1370   result += "\n                              test|1|timeout|5000                  (step 1: whole time requirement is 5 seconds)";
1371   result += "\n                              test|1|sendxml2e|CCR-I.xml           (step 2: imagine this xml uses the Session-Id 'SGx')";
1372   result += "\n                              test|1|waitfe|272|0|||SGx|2001       (step 3: waits the CCA for the CCR-I with Result-Code = DIAMETER_SUCCESS)";
1373   result += "\n                              test|1|sendxml2e|AAR-flows.xml       (step 4: imagine this xml uses the Session-Id 'SRx')";
1374   result += "\n                              test|1|waitfe|265|0|||SRx|2001       (step 5: waits the AAA for the AAR-flows with Result-Code = DIAMETER_SUCCESS)";
1375   result += "\n                              test|1|waitfe|258|1|||SGx            (step 6: waits the RAR (install policies) from the PCRF server)";
1376   result += "\n                              test|1|sendxml2e|RAA-install.xml|6   (step 7: sends the response for the RAR)";
1377   result += "\n                              test|1|sendxml2e|CCR-T.xml           (step 8: termination of the Gx session, imagine this xml puts hop-by-hop 'H1')";
1378   result += "\n                              test|1|waitfe|272|0|H1||SGx|2001     (step 9: waits the CCA for the CCR-T with Result-Code = DIAMETER_SUCCESS and hop-by-hop 'H1')";
1379   result += "\n                              test|1|waitfe|258|1|||SGx            (step 10: waits the RAR (remove policies) from the PCRF server)";
1380   result += "\n                              test|1|sendxml2e|RAA-remove.xml|10   (step 11: sends the response for the RAR)";
1381   result += "\n";
1382   result += "\n                              Notes: We added an additional condition in step 9: the hop-by-hop. When we program the corresponding";
1383   result += "\n                                      source request (CCR-T), we configured the value 'H1' for the hop-by-hop. This is an 'application";
1384   result += "\n                                      value' because the real hop-by-hop transported through the client connection is managed by the";
1385   result += "\n                                      diameter stack. But when returned, the transaction pool resolve the original value. This feature";
1386   result += "\n                                      is necessary to ease the implementation of certain diameter agents (proxies for example). In our";
1387   result += "\n                                      case, we could format the hop-by-hop values within the request templates with total freedom to";
1388   result += "\n                                      improve the programmed conditions.";
1389   result += "\n";
1390   result += "\n                                     In the case of 'waiting for requests' is not such easy. Indeed, steps 6 and 10 will write a warning";
1391   result += "\n                                      because they are the same condition. We know that we are not going to have any problem because";
1392   result += "\n                                      such events are blocking-protected regarding logic-dependent messages (CCR-T), and race condition";
1393   result += "\n                                      is absolutely strange in this case.";
1394   result += "\n";
1395   result += "\n                                     You could speed up the test case moving forward steps like 3 & 5, understood as non-strict requirements";
1396   result += "\n                                      to continue testing. Anyway, remember that test cases should be as real as possible, and that there";
1397   result += "\n                                      are many ways to increase the load rate as we will see in next section (test cases execution).";
1398   result += "\n";
1399   result += "\n                                     Other simplifications: the steps 3, 5 and 9 can be replaced by";
1400   result += "\n";
1401   result += "\n                                        test|1|waitfe||0|#2";
1402   result += "\n                                        test|1|waitfe||0|#4";
1403   result += "\n                                        test|1|waitfe||0|#8";
1404   result += "\n";
1405   result += "\n                                        which means that hop-by-hop must be retrieved from steps 2, 4 and 8 respectively,";
1406   result += "\n                                        and the expected message shall be an answer. Normally you will add other conditions,";
1407   result += "\n                                        for example a DIAMETER_SUCCESS result (adding 2001 as Result-Code).";
1408   result += "\n";
1409   result += "\nTest cases execution:";
1410   result += "\n";
1411   result += "\n";
1412   result += "\n   test|ttps|<amount>            Starts/resume the provided number of test ticks per second (ttps). The ADML starts";
1413   result += "\n                                 with the event trigger system suspended, and this operation is neccessary to begin";
1414   result += "\n                                 those cases which need this time event (internal triggering). Some other test cases";
1415   result += "\n                                 could be started through external events (first test case event could be programmed";
1416   result += "\n                                 to wait specific message), but is not usual this external mode and neither usual to";
1417   result += "\n                                 mix triggering types. Normally, you will pause/stop new test launchs providing 0 as";
1418   result += "\n                                 ttps value, and also you could dynamically modify the load rate updating that value.";
1419   result += "\n                                 If a test case has N messages then 'ttps * N' will be the virtual number of messages";
1420   result += "\n                                 managed per second when no bottleneck exists.";
1421   result += "\n";
1422   result += "\n                                 Provide 0 in order to stop the timer triggering.";
1423   result += "\n";
1424   result += "\n                                 The timer manager resolution currently harcoded allows a maximum  of ";
1425   result += anna::functions::asString(1000/a_admlMinResolution); result += " events";
1426   result += "\n                                 per second. To reach greater rates ADML will join synchronously the needed number of";
1427   result += "\n                                 new time-triggered test cases per a single event, writting a warning-level trace to";
1428   result += "\n                                 advice about the risk of burst sendings and recommend launching multiple instances";
1429   result += "\n                                 to achieve such load with a lower rate per instance.";
1430   result += "\n";
1431   result += "\n   test|next[|<sync-amount>]     Forces the execution of the next test case(s) without waiting for test manager tick.";
1432   result += "\n                                 Provide an integer value for 'sync-amount' to send a burst synchronous amount of the";
1433   result += "\n                                 next programmed test cases (1 by default). This event works regardless the timer tick";
1434   result += "\n                                 function, but it is normally used with the test manager tick stopped.";
1435   result += "\n";
1436   result += "\n   test|ip-limit[|amount]        In-progress limit of test cases. No new test cases will be launched over this value";
1437   result += "\n                                 (test Manager tick work will be ignored). Zero-value is equivalent to stop the clock.";
1438   result += "\n                                 tick, -1 is used to specify 'no limit' which is the default. If missing amount, the";
1439   result += "\n                                 limit and current amount of in-progress test cases will be shown.";
1440   result += "\n";
1441   result += "\n   test|goto|<id>                Updates current test pointer position.";
1442   result += "\n";
1443   result += "\n   test|look[|id]                Show programmed test case for id provided, current 'in-process' test case when missing.";
1444   result += "\n                                 Test cases reports are not dumped on process context (too many information in general).";
1445   result += "\n                                 The report contains context information in every moment: this operation acts as a snapshot.";
1446   result += "\n";
1447   result += "\n   test|interact|amount|id       Makes interactive a specific test case id. The amount is the margin of execution steps";
1448   result += "\n                                 to be done. Normally, we will execute 'test|interact|0|<test case id>', which means that";
1449   result += "\n                                 the test case is selected to be interactive, but no step is executed. Then you have to";
1450   result += "\n                                 interact with positive amounts (usually 1), executing the provided number of steps if";
1451   result += "\n                                 they are ready and fulfill the needed conditions. The value of 0, implies no execution";
1452   result += "\n                                 steps margin, which could be useful to 'freeze' a test in the middle of its execution.";
1453   result += "\n                                 You could also provide -1 to make it non-interactive resuming it from the current step.";
1454   result += "\n";
1455   result += "\n   test|reset|<[soft]/hard>[|id] Reset the test case for id provided, all the tests when missing. It could be hard/soft:";
1456   result += "\n                                 - hard: you probably may need to stop the load rate before. This operation initializes";
1457   result += "\n                                         all test cases regardless their states.";
1458   result += "\n                                 - soft: only for finished cases (those with 'Success' or 'Failed' states). It does not";
1459   result += "\n                                         affect to test cases with 'InProgress' state.";
1460   result += "\n";
1461   result += "\n   test|repeats|<amount>         Restarts the whole programmed test list when finished the amount number of times (repeats";
1462   result += "\n                                 forever if value -1 is provided). This is disabled by default (amount = 0): testing trigger";
1463   result += "\n                                 system will enter suspended state until new ttps operation is received and a soft reset has";
1464   result += "\n                                 been done before. Test cases state & data will be reset (when achieved again), but general";
1465   result += "\n                                 statistics and counters will continue measuring until reset with 'collect' operation.";
1466   result += "\n";
1467   result += "\n   test|auto-reset|<soft|hard>   When cycling, current test cases can be soft (default) or hard reset. If no timeout has";
1468   result += "\n                                 been configured for the test case, hard reset could prevent stuck on the next cycle for";
1469   result += "\n                                 those test cases still in progress.";
1470   result += "\n";
1471   result += "\n   test|clear                    Clears all the programmed test cases and stop testing (if in progress).";
1472   result += "\n";
1473   result += "\n   test|summary                  Test manager general report (number of test cases, counts by state, global configuration,";
1474   result += "\n                                 forced in-progress limitation, reports visibility, etc.). Be careful when you have reports";
1475   result += "\n                                 enabled because the programmed test cases dumps could be heavy (anyway you could enable the";
1476   result += "\n                                 dumps separately, for any of the possible states: Initialized, InProgress, Failed, Success).";
1477   result += "\n";
1478   result += "\n   test|report|<initialized/in-progress/failed/success/[all]/none>[|[yes]|no]";
1479   result += "\n";
1480   result += "\n                                 Enables/disables report generation for a certain test case state: initialized, in-progress,";
1481   result += "\n                                 failed or success (also 'all' and 'none' reserved words could be used). This applies to report";
1482   result += "\n                                 summary (former described operation) and automatic dumps during testing where only failed or";
1483   result += "\n                                 successful states will appear: every time a test case is finished its xml representation will";
1484   result += "\n                                 be dump on a file under the execution directory (or the one configured in process command-line";
1485   result += "\n                                 'tmDir') with the name:";
1486   result += "\n";
1487   result += "\n                                    'cycle-<cycle id>.testcase-<test case id>.xml'.";
1488   result += "\n";
1489   result += "\n                                 By default, all the states are disabled to avoid IO overload. In most of cases not all the";
1490   result += "\n                                 tests are going to fail then you could enable only such failed dumps. Anyway you could set";
1491   result += "\n                                 the reports visibility to fit your needs in a given situation.";
1492   result += "\n";
1493   result += "\n   test|report-hex[|[yes]|no]    Reports could include the diameter messages in hexadecimal format. Disabled by default.";
1494   result += "\n";
1495   result += "\n";
1496   result += "\n------------------------------------------------------------------------------------- Dynamic procedure";
1497   result += "\n";
1498   result += "\ndynamic[|args]                   This launch an internal operation implemented in 'Procedure' class.";
1499   result += "\n                                 Its default implementation does nothing, but you could create a dynamic";
1500   result += "\n                                 library 'libanna_launcherDynamic.so' and replace the one in this project.";
1501   result += "\n                                 One interesting application consists in the use of the diameter API and";
1502   result += "\n                                 event operation to create a set of libraries as the testing framework.";
1503   result += "\n                                 To execute each test case, the ADML process would be executed with a";
1504   result += "\n                                 specific library path. But the main use would be the stress programming";
1505   result += "\n                                 to achieve a great amount of cloned (even mixed) tests without using";
1506   result += "\n                                 the management operation interface by mean http or signals: a single";
1507   result += "\n                                 call to 'dynamic' would be enough to start a cascade of internally";
1508   result += "\n                                 implemented operations.";
1509   result += "\n                                 This operation accepts a generic string argument (piped or not, as you";
1510   result += "\n                                 desire and depending on your procedure implementation).";
1511   result += "\n";
1512   result += "\n                                 This operation requires advanced programming and knowlegde of ANNA Diameter";
1513   result += "\n                                 stack and testing framework, to take advantage of all the possibilities.";
1514   result += "\n";
1515   result += "\n";
1516   result += "\n";
1517   result += "\nUSING OPERATIONS INTERFACE";
1518   result += "\n--------------------------";
1519   result += "\n";
1520   result += "\n------------------------------------------------------------------------- Operations via HTTP interface";
1521   result += "\n";
1522   result += "\nAll the operations described above can be used through the optional HTTP interface. You only have";
1523   result += "\n to define the http server at the command line with something like: '--httpServer localhost:9000'.";
1524   result += "\nTo send the task, we shall build the http request body with the operation string. Some examples";
1525   result += "\n using curl client could be:";
1526   result += "\n";
1527   result += "\n   curl -m 1 --data \"diameterServerSessions|4\" localhost:9000";
1528   result += "\n   curl -m 1 --data \"code|ccr.xml\" localhost:9000";
1529   result += "\n   curl -m 1 --data \"decode|ccr.hex\" localhost:9000";
1530   result += "\n   curl -m 1 --data \"sendxml2e|ccr.xml\" localhost:9000";
1531   result += "\n   etc.";
1532   result += "\n";
1533   result += "\n------------------------------------------------------------------------- Operations via SIGUSR2 signal";
1534   result += "\n";
1535   result += "\nThe alternative using SIGUSR2 signal requires the creation of the task(s) file which will be read at";
1536   result += "\n signal event:";
1537   result += "\n   echo \"<<operation>\" > "; result += getSignalUSR2InputFile();
1538   result += "\n    then";
1539   result += "\n   kill -12 <pid>";
1540   result += "\n    or";
1541   result += "\n   kill -s SIGUSR2 <pid>";
1542   result += "\n    and then see the results:";
1543   result += "\n   cat "; result += getSignalUSR2OutputFile();
1544   result += "\n";
1545   result += "\n   (this file is ended with EOF final line, useful managing huge batch files to ensure the job completion)";
1546   result += "\n";
1547   result += "\nYou could place more than one line (task) in the input file. Output reports will be appended in that";
1548   result += "\n case over the output file. Take into account that all the content of the task file will be executed";
1549   result += "\n sinchronously by the process. If you are planning traffic load, better use the asynchronous http";
1550   result += "\n interface.";
1551   result += "\n";
1552   result += "\n";
1553
1554   return result;
1555 }
1556
1557
1558 void Launcher::logStatisticsSamples(const std::string &conceptsList) throw() {
1559   anna::statistics::Engine &statEngine = anna::statistics::Engine::instantiate();
1560
1561   if(conceptsList == "all") {
1562     if(statEngine.enableSampleLog(/* -1: all concepts */))
1563       LOGDEBUG(anna::Logger::debug("Sample log activation for all statistic concepts", ANNA_FILE_LOCATION));
1564   }
1565   else if(conceptsList == "none") {
1566       if(statEngine.disableSampleLog(/* -1: all concepts */))
1567         LOGDEBUG(anna::Logger::debug("Sample log deactivation for all statistic concepts", ANNA_FILE_LOCATION));
1568   } else {
1569     anna::Tokenizer lst;
1570     lst.apply(conceptsList, ",");
1571
1572     if(lst.size() >= 1) {
1573       anna::Tokenizer::const_iterator tok_min(lst.begin());
1574       anna::Tokenizer::const_iterator tok_max(lst.end());
1575       anna::Tokenizer::const_iterator tok_iter;
1576       int conceptId;
1577
1578       for(tok_iter = tok_min; tok_iter != tok_max; tok_iter++) {
1579         conceptId = atoi(anna::Tokenizer::data(tok_iter));
1580
1581         if(statEngine.enableSampleLog(conceptId))
1582           LOGDEBUG(anna::Logger::debug(anna::functions::asString("Sample log activation for statistic concept id = %d", conceptId), ANNA_FILE_LOCATION));
1583       }
1584     }
1585   }
1586 }
1587
1588
1589 void Launcher::eventOperation(const std::string &operation, std::string &response_content) throw(anna::RuntimeException) {
1590   LOGMETHOD(anna::TraceMethod tm("Launcher", "eventOperation", ANNA_FILE_LOCATION));
1591   if (operation == "") return; // ignore
1592   LOGDEBUG(anna::Logger::debug(anna::functions::asString("Operation: %s", operation.c_str()), ANNA_FILE_LOCATION));
1593
1594   // Default response:
1595   response_content = "Operation processed with exception: ";
1596   response_content += operation;
1597   std::string opt_response_content = ""; // aditional response content
1598   anna::DataBlock db_aux(true);
1599   anna::diameter::codec::Message codecMsg; // auxiliary codec message
1600
1601   // Singletons:
1602   anna::testing::TestManager &testManager = anna::testing::TestManager::instantiate();
1603
1604
1605   ///////////////////////////////////////////////////////////////////
1606   // Simple operations without arguments:
1607
1608   // Dynamic operation:
1609   if(operation.find("dynamic") == 0) {
1610     Procedure p(this);
1611     int op_size = operation.size();
1612     std::string args = ((operation.find("dynamic|") == 0) && (op_size > 8)) ? operation.substr(8) : "";
1613     if (args == "" && op_size != 7)
1614       throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION);
1615     try {
1616       p.execute(args, response_content);
1617     }
1618     catch(anna::RuntimeException &ex) {
1619       ex.trace();
1620       response_content = ex.asString();
1621       return;
1622     }
1623     return;
1624   }
1625
1626   // Help:
1627   if(operation == "help") {
1628     response_content = help();
1629     return;
1630   }
1631
1632   // Reset performance data:
1633   if(operation == "collect") {
1634     resetCounters();
1635     resetStatistics();
1636     response_content = "All process counters & statistic information have been reset";
1637     return;
1638   }
1639
1640   // Counters dump on demand:
1641   if(operation == "forceCountersRecord") {
1642     forceCountersRecord();
1643     response_content = "Current counters have been dump to disk";
1644     return;
1645   }
1646
1647   // OAM & statistics:
1648   if(operation == "show-oam") {
1649     anna::xml::Node root("root");
1650     response_content = anna::xml::Compiler().apply(oamAsXML(&root));
1651     return;
1652   }
1653   if(operation == "show-stats") {
1654     anna::xml::Node root("root");
1655     response_content = anna::xml::Compiler().apply(statsAsXML(&root));
1656     return;
1657   }
1658
1659   ///////////////////////////////////////////////////////////////////
1660   // Tokenize operation
1661   Tokenizer params;
1662   params.apply(operation, "|", "<null>" /* allow contiguous separators */);
1663   int numParams = params.size() - 1;
1664
1665   // Get the operation type and parameters:
1666   Tokenizer::const_iterator tok_iter = params.begin();
1667   std::string opType = Tokenizer::data(tok_iter);
1668   std::string param1, param2, param3, param4, param5, param6, param7, param8, param9, param10, param11;
1669   if(numParams >= 1) { tok_iter++; param1 = Tokenizer::data(tok_iter); }
1670   if(numParams >= 2) { tok_iter++; param2 = Tokenizer::data(tok_iter); }
1671   if(numParams >= 3) { tok_iter++; param3 = Tokenizer::data(tok_iter); }
1672   // Tests conditions
1673   if(numParams >= 4) { tok_iter++; param4 = Tokenizer::data(tok_iter); }
1674   if(numParams >= 5) { tok_iter++; param5 = Tokenizer::data(tok_iter); }
1675   if(numParams >= 6) { tok_iter++; param6 = Tokenizer::data(tok_iter); }
1676   if(numParams >= 7) { tok_iter++; param7 = Tokenizer::data(tok_iter); }
1677   if(numParams >= 8) { tok_iter++; param8 = Tokenizer::data(tok_iter); }
1678   if(numParams >= 9) { tok_iter++; param9 = Tokenizer::data(tok_iter); }
1679   if(numParams >= 10) { tok_iter++; param10 = Tokenizer::data(tok_iter); }
1680   if(numParams >= 11) { tok_iter++; param11 = Tokenizer::data(tok_iter); }
1681   // Remove '<null>' artificial token to ease further checkings:
1682   if (param1 == "<null>") param1 = "";
1683   if (param2 == "<null>") param2 = "";
1684   if (param3 == "<null>") param3 = "";
1685   if (param4 == "<null>") param4 = "";
1686   if (param5 == "<null>") param5 = "";
1687   if (param6 == "<null>") param6 = "";
1688   if (param7 == "<null>") param7 = "";
1689   if (param8 == "<null>") param8 = "";
1690   if (param9 == "<null>") param9 = "";
1691   if (param10 == "<null>") param10 = "";
1692   if (param11 == "<null>") param11 = "";
1693
1694   // No operation has more than 2 arguments except 'test' ...
1695   if(opType != "test" && numParams > 2)
1696     throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION);
1697
1698
1699   // Check the number of parameters:
1700   bool wrongBody = false;
1701
1702   if((opType == "change-dir") && (numParams > 1)) wrongBody = true;
1703   if((opType == "log-statistics-samples") && (numParams != 1)) wrongBody = true;
1704   if((opType == "node") && (numParams > 1)) wrongBody = true;
1705
1706   if((opType == "node_auto") && (numParams > 0)) wrongBody = true;
1707
1708   if(((opType == "code") || (opType == "decode")) && (numParams != 2)) wrongBody = true;
1709
1710   if(((opType == "sendxml2e") || (opType == "sendhex2e")) && (numParams != 1)) wrongBody = true;
1711
1712   if((opType == "burst") && (numParams < 1)) wrongBody = true;
1713
1714   if((opType == "test") && (numParams < 1)) wrongBody = true;
1715
1716   if(((opType == "sendxml2c") || (opType == "sendhex2c") || (opType == "loadxml") || (opType == "diameterServerSessions")) && (numParams != 1)) wrongBody = true;
1717
1718   if(wrongBody) {
1719     // Launch exception
1720     std::string msg = "Wrong body content format on HTTP Request for '";
1721     msg += opType;
1722     msg += "' operation (missing parameter/s). Use 'help' management command to see more information.";
1723     throw anna::RuntimeException(msg, ANNA_FILE_LOCATION);
1724   }
1725
1726   // Operations:
1727   if(opType == "context") {
1728     std::string contextFile = ((numParams == 1) ? param1 : anna::functions::asString("/var/tmp/anna.context.%05d", getPid()));
1729     writeContext(contextFile);
1730     response_content = anna::functions::asString("Context dumped on file '%s'", contextFile.c_str());
1731     return;
1732   }
1733
1734   if(opType == "log-statistics-samples") {
1735     logStatisticsSamples(param1);
1736     response_content = anna::functions::asString("Log statistics samples for '%s' concepts", param1.c_str());
1737     return;
1738   }
1739
1740   // Change execution directory:
1741   if(opType == "change-dir") {
1742     if (param1 == "") param1 = a_initialWorkingDirectory;
1743     if (chdir(param1.c_str()) == 0)
1744       response_content = "New execution directory configured: ";
1745     else
1746       response_content = "Cannot assign provided execution directory: ";
1747
1748     response_content += param1;
1749     return;
1750   }
1751
1752   if(opType == "services") {
1753     std::string servicesFile = ((numParams == 1) ? param1 : "services.xml");
1754     try {
1755       loadServices(servicesFile, true /* bind entities */);
1756     }
1757     catch(anna::RuntimeException &ex) {
1758       ex.trace();
1759       response_content = anna::functions::asString("Loaded services from file '%s' with errors", servicesFile.c_str());
1760       return;
1761     }
1762     response_content = anna::functions::asString("Loaded services from file '%s'", servicesFile.c_str());
1763     return;
1764   }
1765
1766   // Host switch:
1767   if(opType == "node") {
1768     if (param1 != "") {
1769       if (setWorkingNode(param1)) response_content = anna::functions::asString("Forced node is now '%s'", param1.c_str());
1770     }
1771     else {
1772       if (a_workingNode) {
1773         response_content = "Working node is forced to be: \n\n";
1774         response_content += a_workingNode->asXMLString();
1775       }
1776       else {
1777         response_content = "Working node is automatic";
1778       }
1779     }
1780     return;
1781   }
1782   if(opType == "node_auto") {
1783     a_workingNode = NULL;
1784     response_content = "Working node has been set to automatic";
1785     return;
1786   }
1787
1788   // Operated host from possible forced-working node:
1789   a_operatedHost = a_workingNode ? a_workingNode /* priority */: NULL /* auto */;
1790   // Use later:
1791   //    If any message is managed: updateOperatedOriginHostWithMessage(codecMessage)
1792   //    To operate, use the exception-protected methods which never will return NULL:
1793   //         getOperatedHost(), getOperatedEntity(), getOperatedServer(), getOperatedEngine()
1794
1795
1796   if(opType == "code") {
1797     codecMsg.loadXML(param1);
1798     std::string hexString = anna::functions::asHexString(codecMsg.code());
1799     // write to outfile
1800     std::ofstream outfile(param2.c_str(), std::ifstream::out);
1801     outfile.write(hexString.c_str(), hexString.size());
1802     outfile.close();
1803   } else if(opType == "decode") {
1804     // Get DataBlock from file with hex content:
1805     if(!getDataBlockFromHexFile(param1, db_aux))
1806       throw anna::RuntimeException("Error reading hex file provided", ANNA_FILE_LOCATION);
1807
1808     // Decode
1809     try { codecMsg.decode(db_aux); } catch(anna::RuntimeException &ex) { ex.trace(); }
1810
1811     std::string xmlString = codecMsg.asXMLString();
1812     // write to outfile
1813     std::ofstream outfile(param2.c_str(), std::ifstream::out);
1814     outfile.write(xmlString.c_str(), xmlString.size());
1815     outfile.close();
1816   } else if((opType == "hide") || (opType == "show") || (opType == "hidden") || (opType == "shown")) {
1817
1818     if(param1 != "") {
1819       if(param2 != "") {
1820         std::string key = param1;
1821         key += "|";
1822         key += param2;
1823
1824         if(opType == "hide") getOperatedEngine()->findClientSession(key)->hide();
1825
1826         if(opType == "show") getOperatedEngine()->findClientSession(key)->show();
1827
1828         if(opType == "hidden") opt_response_content = getOperatedEngine()->findClientSession(key)->hidden() ? "true" : "false";
1829
1830         if(opType == "shown") opt_response_content = getOperatedEngine()->findClientSession(key)->shown() ? "true" : "false";
1831       } else {
1832         std::string address;
1833         int port;
1834         anna::functions::getAddressAndPortFromSocketLiteral(param1, address, port);
1835
1836         if(opType == "hide") getOperatedEngine()->findServer(address, port)->hide();
1837
1838         if(opType == "show") getOperatedEngine()->findServer(address, port)->show();
1839
1840         if(opType == "hidden") opt_response_content = getOperatedEngine()->findServer(address, port)->hidden() ? "true" : "false";
1841
1842         if(opType == "shown") opt_response_content = getOperatedEngine()->findServer(address, port)->shown() ? "true" : "false";
1843       }
1844     } else {
1845       if(opType == "hide") getOperatedEntity()->hide();
1846
1847       if(opType == "show") getOperatedEntity()->show();
1848
1849       if(opType == "hidden") opt_response_content = getOperatedEntity()->hidden() ? "true" : "false";
1850
1851       if(opType == "shown") opt_response_content = getOperatedEntity()->shown() ? "true" : "false";
1852     }
1853   } else if((opType == "sendxml2e") || (opType == "sendhex2e")) {
1854     anna::diameter::comm::Message *msg;
1855
1856     if(opType == "sendxml2e") {
1857       codecMsg.loadXML(param1);
1858       updateOperatedOriginHostWithMessage(codecMsg);
1859       msg = getOperatedHost()->createCommMessage();
1860       msg->clearBody();
1861       try { codecMsg.valid(); } catch(anna::RuntimeException &ex) { ex.trace(); }  // at least we need to see validation errors although it will continue sending (see validation mode configured in launcher)
1862       msg->setBody(codecMsg.code());
1863     } else {
1864       // Get DataBlock from file with hex content:
1865       if(!getDataBlockFromHexFile(param1, db_aux))
1866         throw anna::RuntimeException("Error reading hex file provided", ANNA_FILE_LOCATION);
1867       msg = getOperatedHost()->createCommMessage();
1868       msg->setBody(db_aux);
1869       try { if(getOperatedHost()->logEnabled()) codecMsg.decode(db_aux); } catch(anna::RuntimeException &ex) { ex.trace(); }
1870     }
1871
1872     bool success = getOperatedEntity()->send(msg);
1873     getOperatedHost()->releaseCommMessage(msg);
1874
1875     // Detailed log:
1876     if(getOperatedHost()->logEnabled()) {
1877       anna::diameter::comm::Server *usedServer = getOperatedEntity()->getLastUsedResource();
1878       anna::diameter::comm::ClientSession *usedClientSession = usedServer ? usedServer->getLastUsedResource() : NULL;
1879       std::string detail = usedClientSession ? usedClientSession->asString() : "<null client session>"; // shouldn't happen
1880       getOperatedHost()->writeLogFile(codecMsg, (success ? "sent2e" : "send2eError"), detail);
1881     }
1882   } else if((opType == "burst")) {
1883
1884     if (!uniqueOriginHost())
1885       throw anna::RuntimeException("Burst category operations are only allowed in single host node configuration. This is only to simplify user experience.", ANNA_FILE_LOCATION);
1886
1887     // burst|clear                     clears all loaded burst messages.
1888     // burst|load|<source_file>        loads the next diameter message into launcher burst.
1889     // burst|start|<initial load>      starts the message sending with a certain initial load.
1890     // burst|push|<load amount>        sends specific non-aynchronous load.
1891     // burst|stop                      stops the burst cycle.
1892     // burst|repeat|[[yes]|no]         restarts the burst launch when finish.
1893     // burst|send|<amount>             send messages from burst list. The main difference with
1894     //                                 start/push operations is that burst won't be awaken.
1895     //                                 Externally we could control sending time (no request
1896     //                                 will be sent for answers).
1897     // burst|goto|<order>              Updates current burst pointer position.
1898     // burst|look|<order>              Show programmed burst message for order provided, current when missing.
1899
1900     if(param1 == "clear") {
1901       opt_response_content = "removed ";
1902       opt_response_content += anna::functions::asString(getOperatedHost()->clearBurst());
1903       opt_response_content += " elements";
1904     } else if(param1 == "load") {
1905       if(param2 == "") throw anna::RuntimeException("Missing xml path file for burst load operation", ANNA_FILE_LOCATION);
1906
1907       codecMsg.loadXML(param2);
1908       if(codecMsg.isAnswer()) throw anna::RuntimeException("Cannot load diameter answers for burst feature", ANNA_FILE_LOCATION);
1909       try { codecMsg.valid(); } catch(anna::RuntimeException &ex) { ex.trace(); }  // at least we need to see validation errors although it will continue loading (see validation mode configured in launcher)
1910
1911       int position = getOperatedHost()->loadBurstMessage(codecMsg.code());
1912       opt_response_content = "loaded '";
1913       opt_response_content += param2;
1914       opt_response_content += "' file into burst list position ";
1915       opt_response_content += anna::functions::asString(position);
1916     } else if(param1 == "start") {
1917       if(param2 == "") throw anna::RuntimeException("Missing initial load for burst start operation", ANNA_FILE_LOCATION);
1918
1919       int initialLoad = atoi(param2.c_str());
1920       int processed = getOperatedHost()->startBurst(initialLoad);
1921
1922       if(processed > 0) {
1923         opt_response_content = "initial load completed for ";
1924         opt_response_content += anna::functions::entriesAsString(processed, "message");
1925       }
1926     } else if(param1 == "push") {
1927       if(param2 == "") throw anna::RuntimeException("Missing load amount for burst push operation", ANNA_FILE_LOCATION);
1928
1929       int pushed = getOperatedHost()->pushBurst(atoi(param2.c_str()));
1930
1931       if(pushed > 0) {
1932         opt_response_content = "pushed ";
1933         opt_response_content += anna::functions::entriesAsString(pushed, "message");
1934       }
1935     } else if(param1 == "pop") {
1936       if(param2 == "") throw anna::RuntimeException("Missing amount for burst pop operation", ANNA_FILE_LOCATION);
1937
1938       int releaseLoad = atoi(param2.c_str());
1939       int popped = getOperatedHost()->popBurst(releaseLoad);
1940
1941       if(popped > 0) {
1942         opt_response_content = "burst popped for ";
1943         opt_response_content += anna::functions::entriesAsString(popped, "message");
1944       }
1945     } else if(param1 == "stop") {
1946       int left = getOperatedHost()->stopBurst();
1947
1948       if(left != -1) {
1949         opt_response_content += anna::functions::entriesAsString(left, "message");
1950         opt_response_content += " left to the end of the cycle";
1951       }
1952     } else if(param1 == "repeat") {
1953       if(param2 == "") param2 = "yes";
1954
1955       bool repeat = (param2 == "yes");
1956       getOperatedHost()->repeatBurst(repeat);
1957       opt_response_content += (repeat ? "repeat enabled" : "repeat disabled");
1958     } else if(param1 == "send") {
1959       if(param2 == "") throw anna::RuntimeException("Missing amount for burst send operation", ANNA_FILE_LOCATION);
1960
1961       int sent = getOperatedHost()->sendBurst(atoi(param2.c_str()));
1962
1963       if(sent > 0) {
1964         opt_response_content = "sent ";
1965         opt_response_content += anna::functions::entriesAsString(sent, "message");
1966       }
1967     } else if(param1 == "goto") {
1968       if(param2 == "") throw anna::RuntimeException("Missing order position for burst goto operation", ANNA_FILE_LOCATION);
1969
1970       opt_response_content = getOperatedHost()->gotoBurst(atoi(param2.c_str()));
1971     } else if(param1 == "look") {
1972       int order = ((param2 != "") ? atoi(param2.c_str()) : -1);
1973       opt_response_content = "\n\n";
1974       opt_response_content += getOperatedHost()->lookBurst(order);
1975     } else {
1976       throw anna::RuntimeException("Wrong body content format on HTTP Request for 'burst' operation (unexpected action parameter). See help", ANNA_FILE_LOCATION);
1977     }
1978
1979   } else if((opType == "test")) {
1980     // test|<id>|<command>[|parameters]         Add a new step to the test case ...
1981     // test|ttps|<amount>                       Starts/resume the provided number of time ticks per second (ttps). The ADML starts ...
1982     // test|next[|<sync-amount>]                Forces the execution of the next test case(s) without waiting for test manager tick ...
1983     // test|ip-limit[|amount]                   In-progress limit of test cases. No new test cases will be launched over this value ...
1984     // test|repeats|<amount>                    Restarts the whole programmed test list when finished the amount number of times ...
1985     // test|report|<initialized/in-progress/failed/success/[all]/none>[|[yes]|no]
1986     //                                          Enables/disables report generation for a certain test case state: initialized, in-progress ...
1987     // test|report-hex[|[yes]|no]               Reports could include the diameter messages in hexadecimal format. Disabled by default.
1988     // test|goto|<id>                           Updates current test pointer position.
1989     // test|look[|id]                           Show programmed test case for id provided, current when missing ...
1990     // test|interact|amount|id                  Makes interactive a specific test case id. The amount is the margin of execution steps ...
1991     // test|reset|<[soft]/hard>[|id]            Reset the test case for id provided, all the tests when missing ...
1992     // test|auto-reset|<soft|hard>              When cycling, current test cases can be soft (default) or hard reset ...
1993     // test|clear                               Clears all the programmed test cases.
1994     // test|summary                             Test manager general report (number of test cases, counts by state ...
1995
1996
1997     if(param1 == "ttps") {
1998       if (numParams > 2)
1999         throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION);
2000
2001       bool success = ((param2 != "") ? testManager.configureTTPS(atoi(param2.c_str())) : false);
2002       if (success) {
2003         opt_response_content = "assigned new test launch rate to ";
2004         opt_response_content += anna::functions::asString(atoi(param2.c_str()));
2005         opt_response_content += " events per second";
2006       }
2007       else {
2008         opt_response_content += "unable to configure the test rate provided";
2009       }
2010     }
2011     else if (param1 == "next") {
2012       if (numParams > 2)
2013         throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION);
2014
2015       int sync_amount = ((param2 != "") ? atoi(param2.c_str()) : 1);
2016
2017       if (sync_amount < 1)
2018         throw anna::RuntimeException("The parameter 'sync-amount' must be a positive integer value", ANNA_FILE_LOCATION);
2019
2020       bool success = testManager.execTestCases(sync_amount);
2021
2022       opt_response_content = (success ? "" : "not completely " /* completed cycle and no repeats, rare case */);
2023       opt_response_content += "processed ";
2024       opt_response_content += anna::functions::asString(sync_amount);
2025       opt_response_content += ((sync_amount > 1) ? " test cases synchronously" : " test case");
2026     }
2027     else if(param1 == "ip-limit") {
2028       if (numParams > 2)
2029         throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION);
2030
2031       unsigned int limit;
2032       if (param2 != "") {
2033         limit = atoi(param2.c_str());
2034         testManager.setInProgressLimit(limit);
2035         opt_response_content = "new in-progress limit: ";
2036         opt_response_content += (limit != UINT_MAX) ? anna::functions::asString(limit) : "<no limit>";
2037       }
2038       else {
2039         opt_response_content = "in-progress limit amount: ";
2040         limit = testManager.getInProgressLimit();
2041         opt_response_content += (limit != UINT_MAX) ? anna::functions::asString(limit) : "<no limit>";
2042         opt_response_content += "; currently there are ";
2043         opt_response_content += anna::functions::asString(testManager.getInProgressCount());
2044         opt_response_content += " test cases running";
2045       }
2046     }
2047     else if(param1 == "repeats") {
2048       if (numParams != 2)
2049         throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION);
2050       int repeats = atoi(param2.c_str());
2051       if (repeats < 0) repeats = -1;
2052       testManager.setPoolRepeats(repeats);
2053       std::string nolimit = (repeats != -1) ? "":" [no limit]";
2054       opt_response_content += anna::functions::asString("Pool repeats: %d%s (current cycle: %d)", repeats, nolimit.c_str(), testManager.getPoolCycle());
2055     }
2056     else if(param1 == "report") {
2057       if (numParams > 3)
2058         throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION);
2059
2060       if(param2 == "") param2 = "all";
2061       if(param3 == "") param3 = "yes";
2062       bool enable = (param3 == "yes");
2063
2064       if(param2 == "initialized")
2065         testManager.setDumpInitializedReports(enable);
2066       else if(param2 == "in-progress")
2067         testManager.setDumpInProgressReports(enable);
2068       else if(param2 == "failed")
2069         testManager.setDumpFailedReports(enable);
2070       else if(param2 == "success")
2071         testManager.setDumpSuccessReports(enable);
2072       else if(param2 == "all") {
2073         param2 = "any";
2074         testManager.setDumpAllReports(enable);
2075       }
2076       else if(param2 == "none") {
2077         enable = !enable;
2078         param2 = "any";
2079         testManager.setDumpAllReports(enable);
2080       }
2081       else
2082         throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION);
2083
2084       opt_response_content += (enable ? "report enabled " : "report disabled ");
2085       opt_response_content += "for tests in '";
2086       opt_response_content += param2;
2087       opt_response_content += "' state";
2088     }
2089     else if(param1 == "report-hex") {
2090       if (numParams > 2)
2091         throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION);
2092
2093       if(param2 == "") param2 = "yes";
2094       testManager.setDumpHex((param2 == "yes"));
2095       opt_response_content += (testManager.getDumpHex() ? "report includes hexadecimal messages" : "report excludes hexadecimal messages");
2096     }
2097     else if(param1 == "goto") {
2098       if (numParams > 2)
2099         throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION);
2100
2101       if(param2 == "") throw anna::RuntimeException("Missing id for test goto operation", ANNA_FILE_LOCATION);
2102       int id = atoi(param2.c_str());
2103       if (testManager.gotoTestCase(id)) {
2104         opt_response_content = "position updated for id provided (";
2105       }
2106       else {
2107         opt_response_content = "cannot found test id (";
2108       }
2109       opt_response_content += anna::functions::asString(id);
2110       opt_response_content += ")";
2111     }
2112     else if(param1 == "look") {
2113       if (numParams > 2)
2114         throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION);
2115
2116       int id = ((param2 != "") ? atoi(param2.c_str()) : -1);
2117       anna::testing::TestCase *testCase = testManager.findTestCase(id);
2118
2119       if (testCase) {
2120         response_content = testCase->asXMLString();
2121         return;
2122       }
2123       else {
2124         if (id == -1) {
2125           opt_response_content = "no current test case detected (testing started ?)";
2126         }
2127         else {
2128           opt_response_content = "cannot found test id (";
2129           opt_response_content += anna::functions::asString(id);
2130           opt_response_content += ")";
2131         }
2132       }
2133     }
2134     else if (param1 == "interact") {
2135       if (numParams != 3)
2136         throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION);
2137
2138       int amount = atoi(param2.c_str());
2139       if (amount < -1)
2140         throw anna::RuntimeException("Interactive amount must be -1 (to disable interactive mode) or a positive number.", ANNA_FILE_LOCATION);
2141
2142       int id = atoi(param3.c_str());
2143       anna::testing::TestCase *testCase = testManager.findTestCase(id);
2144       if (testCase) {
2145         if (amount == -1) {
2146           testCase->makeInteractive(false);
2147           opt_response_content = "interactive mode disabled";
2148         }
2149         else {
2150           testCase->addInteractiveAmount(amount);
2151           opt_response_content = "added interactive amount of ";
2152           opt_response_content += anna::functions::asString(amount);
2153           opt_response_content += " units";
2154           if (amount == 0) opt_response_content += " (0: freezing a non-interactive testcase, no effect on already interactive)";
2155         }
2156         opt_response_content += " for test case id ";
2157         opt_response_content += anna::functions::asString(id);
2158       }
2159       else {
2160         opt_response_content = "cannot found test id (";
2161         opt_response_content += anna::functions::asString(id);
2162         opt_response_content += ")";
2163       }
2164     }
2165     else if(param1 == "reset") {
2166       if (numParams > 3)
2167         throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION);
2168
2169       if(param2 == "") param2 = "soft";
2170      if (param2 != "soft" && param2 != "hard")
2171         throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION);
2172
2173       int id = ((param3 != "") ? atoi(param3.c_str()) : -1);
2174       anna::testing::TestCase *testCase = ((id != -1) ? testManager.findTestCase(id) : NULL);
2175
2176       if (testCase) {
2177         bool done = testCase->reset(param2 == "hard");
2178         opt_response_content = "test ";
2179         opt_response_content += param2;
2180         opt_response_content += " reset for id ";
2181         opt_response_content += anna::functions::asString(id);
2182         opt_response_content += done ? ": done": ": not done";
2183       }
2184       else {
2185         if (id == -1) {
2186           bool anyReset = testManager.resetPool(param2 == "hard");
2187           opt_response_content = param2; opt_response_content += " reset have been sent to all programmed tests: "; opt_response_content += anyReset ? "some/all have been reset" : "nothing was reset";
2188         }
2189         else {
2190           opt_response_content = "cannot found test id (";
2191           opt_response_content += anna::functions::asString(id);
2192           opt_response_content += ")";
2193         }
2194       }
2195     }
2196     else if(param1 == "auto-reset") {
2197       if (numParams != 2)
2198         throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION);
2199
2200       if (param2 != "soft" && param2 != "hard")
2201         throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION);
2202
2203       testManager.setAutoResetHard(param2 == "hard");
2204       opt_response_content += anna::functions::asString("Auto-reset configured to '%s'", param2.c_str());
2205     }
2206     else if(param1 == "clear") {
2207       if (numParams > 1)
2208         throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION);
2209
2210       if (testManager.clearPool()) {
2211         opt_response_content = "all the programmed test cases have been dropped";
2212       }
2213       else {
2214         opt_response_content = "there are not programmed test cases to be removed";
2215       }
2216     }
2217     else if(param1 == "summary") {
2218       response_content = testManager.asXMLString();
2219       return;
2220     }
2221     else {
2222       int id = atoi(param1.c_str());
2223       if(id < 0)
2224         throw anna::RuntimeException("Invalid test case identifier: must be a non-negative number", ANNA_FILE_LOCATION);
2225
2226       // PARAM: 1     2            3      4          5           6             7           8          9       10         11
2227       // test|<id>|<command>
2228       //             timeout|    <msecs>
2229       //             sendxml2e|  <file>[|<step number>]
2230       //             sendxml2c|  <file>[|<step number>]
2231       //             delay|      [msecs]
2232       //             wait<fe/fc>|[code]|[bitR]|[hopByHop]|[applicationId]|[sessionId]|[resultCode]|[msisdn]|[imsi]|[serviceContextId]
2233       //      wait<fe/fc>-answer|<step number>
2234       //      wait<fe/fc>-xml   |<source_file>[|strict]
2235       //      wait<fe/fc>-hex   |<source_file>[|strict]
2236       if(param2 == "") throw anna::RuntimeException("Missing command for test id operation", ANNA_FILE_LOCATION);
2237
2238       // Commands:
2239       if (param2 == "timeout") {
2240         if (numParams > 3)
2241           throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION);
2242         if(param3 == "") throw anna::RuntimeException("Missing milliseconds for 'timeout' command in test id operation", ANNA_FILE_LOCATION);
2243         anna::Millisecond timeout = checkTimeMeasure("Test case timeout", param3);
2244         testManager.getTestCase(id)->addTimeout(timeout); // creates / reuses
2245       }
2246       else if ((param2 == "sendxml2e")||(param2 == "sendxml2c")) {
2247         if (numParams > 4)
2248           throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION);
2249         if(param3 == "") throw anna::RuntimeException(anna::functions::asString("Missing xml file for '%s' command in test id operation", param2.c_str()), ANNA_FILE_LOCATION);
2250         codecMsg.loadXML(param3);
2251         LOGWARNING(
2252           if (!codecMsg.isRequest() && (param4 == ""))
2253             anna::Logger::warning("Step number has not been provided. Take into account that this answer message will be sent 'as is' and sequence information could be wrong at the remote peer", ANNA_FILE_LOCATION);
2254         );
2255
2256         updateOperatedOriginHostWithMessage(codecMsg);
2257         int stepNumber = ((param4 != "") ? atoi(param4.c_str()):-1);
2258
2259         if (param2 == "sendxml2e")
2260           testManager.getTestCase(id)->addSendxml2e(codecMsg.code(), getOperatedHost(), stepNumber); // creates / reuses
2261         else
2262           testManager.getTestCase(id)->addSendxml2c(codecMsg.code(), getOperatedHost(), stepNumber); // creates / reuses
2263       }
2264       else if (param2 == "delay") {
2265         if (numParams > 3)
2266           throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION);
2267         if(param3 == "") throw anna::RuntimeException("Missing milliseconds for 'delay' command in test id operation", ANNA_FILE_LOCATION);
2268         anna::Millisecond delay = ((param3 == "0" /* special case */) ? (anna::Millisecond)0 : checkTimeMeasure("Test case delay step", param3));
2269         testManager.getTestCase(id)->addDelay(delay); // creates / reuses
2270       }
2271       else if ((param2 == "waitfe")||(param2 == "waitfc")) {
2272         if (numParams > 11)
2273           throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION);
2274         if (param3 != "" || param4 != "" || param5 != "" || param6 != "" || param7 != "" || param8 != "" || param9 != "" || param10 != "" || param11 != "") {
2275           bool fromEntity = (param2.substr(4,2) == "fe");
2276           testManager.getTestCase(id)->addWait(fromEntity, param3, param4, param5, param6, param7, param8, param9, param10, param11);
2277         }
2278         else {
2279           throw anna::RuntimeException(anna::functions::asString("Missing condition for '%s' command in test id operation", param2.c_str()), ANNA_FILE_LOCATION);
2280         }
2281       }
2282       else if ((param2 == "waitfe-hex")||(param2 == "waitfc-hex")) {
2283         if (numParams > 4)
2284           throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION);
2285         if(param3 == "") throw anna::RuntimeException(anna::functions::asString("Missing hex file for '%s' command in test id operation", param2.c_str()), ANNA_FILE_LOCATION);
2286
2287         // Get DataBlock from file with hex content:
2288         if(!getDataBlockFromHexFile(param3, db_aux))
2289           throw anna::RuntimeException("Error reading hex content from file provided", ANNA_FILE_LOCATION);
2290
2291         // Hexadecimal representation read from file:
2292         std::string regexp = anna::functions::asHexString(db_aux);
2293
2294         // optional 'full':
2295         if(param4 != "strict") {
2296           //// If request, we will ignore sequence data:
2297           //if (anna::diameter::codec::functions::requestBit(db_aux))
2298             regexp.replace (24, 16, "[0-9A-Fa-f]{16}");
2299
2300           regexp.insert(0, "^");
2301           regexp += "$";
2302         }
2303
2304         bool fromEntity = (param2.substr(4,2) == "fe");
2305         testManager.getTestCase(id)->addWaitRegexpHex(fromEntity, regexp);
2306       }
2307       else if ((param2 == "waitfe-xml")||(param2 == "waitfc-xml")) {
2308         if (numParams > 4)
2309           throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION);
2310         if(param3 == "") throw anna::RuntimeException(anna::functions::asString("Missing xml file for '%s' command in test id operation", param2.c_str()), ANNA_FILE_LOCATION);
2311
2312         // Get xml content from file:
2313         std::string regexp;
2314         if(!getContentFromFile(param3, regexp))
2315           throw anna::RuntimeException("Error reading xml content from file provided", ANNA_FILE_LOCATION);
2316
2317         // optional 'full':
2318         if(param4 != "strict") {
2319
2320           // TODO: use this from gcc4.9.0: http://stackoverflow.com/questions/8060025/is-this-c11-regex-error-me-or-the-compiler
2321 /*
2322           std::string s_from = "hop-by-hop-id=\"[0-9]+\" end-to-end-id=\"[0-9]+\"";
2323           std::string s_to = s_from;
2324           std::string s_from2 = "avp name=\"Origin-State-Id\" data=\"[0-9]+\"";
2325           std::string s_to2 = s_from2;
2326
2327           try {
2328             regexp = std::regex_replace (regexp, std::regex(s_from), s_to);
2329             regexp = std::regex_replace (regexp, std::regex(s_from2), s_to2);
2330           }
2331           catch (const std::regex_error& e) {
2332             throw anna::RuntimeException(e.what(), ANNA_FILE_LOCATION);
2333           }
2334
2335 */
2336           std::string::size_type pos, pos_1, pos_2;
2337
2338           pos = regexp.find("hop-by-hop-id=", 0u);
2339           pos = regexp.find("\"", pos);
2340           pos_1 = pos;
2341           pos = regexp.find("\"", pos+1);
2342           pos_2 = pos;
2343           regexp.replace(pos_1 + 1, pos_2 - pos_1 - 1, "[0-9]+");
2344
2345           pos = regexp.find("end-to-end-id=", 0u);
2346           pos = regexp.find("\"", pos);
2347           pos_1 = pos;
2348           pos = regexp.find("\"", pos+1);
2349           pos_2 = pos;
2350           regexp.replace(pos_1 + 1, pos_2 - pos_1 - 1, "[0-9]+");
2351
2352           pos = regexp.find("Origin-State-Id", 0u);
2353           pos = regexp.find("\"", pos);
2354           pos = regexp.find("\"", pos+1);
2355           pos_1 = pos;
2356           pos = regexp.find("\"", pos+1);
2357           pos_2 = pos;
2358           regexp.replace(pos_1 + 1, pos_2 - pos_1 - 1, "[0-9]+");
2359
2360           //regexp.insert(0, "^");
2361           //regexp += "$";
2362         }
2363
2364         bool fromEntity = (param2.substr(4,2) == "fe");
2365         testManager.getTestCase(id)->addWaitRegexpXml(fromEntity, regexp);
2366       }
2367       else if (param2 == "sh-command") {
2368         // Allow pipes in command:
2369         //if (numParams > 4)
2370         //  throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION);
2371         if(param3 == "") throw anna::RuntimeException("Missing script/executable command-line for 'sh-command' in test id operation", ANNA_FILE_LOCATION);
2372         std::string token = "|sh-command|";
2373         std::string command = operation.substr(operation.find(token) + token.size());
2374         testManager.getTestCase(id)->addCommand(command); // creates / reuses
2375       }
2376       else {
2377         throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION);
2378       }
2379     }
2380
2381   } else if((opType == "sendxml2c") || (opType == "sendhex2c")) {
2382     anna::diameter::comm::Message *msg;
2383
2384     if(opType == "sendxml2c") {
2385       codecMsg.loadXML(param1);
2386       updateOperatedOriginHostWithMessage(codecMsg);
2387       msg = getOperatedHost()->createCommMessage();
2388       msg->clearBody();
2389       try { codecMsg.valid(); } catch(anna::RuntimeException &ex) { ex.trace(); }  // at least we need to see validation errors although it will continue sending (see validation mode configured in launcher)
2390
2391       msg->setBody(codecMsg.code());
2392     } else {
2393       // Get DataBlock from file with hex content:
2394       if(!getDataBlockFromHexFile(param1, db_aux))
2395         throw anna::RuntimeException("Error reading hex file provided", ANNA_FILE_LOCATION);
2396       msg = getOperatedHost()->createCommMessage();
2397       msg->setBody(db_aux);
2398     }
2399
2400     bool success = getOperatedServer()->send(msg);
2401     getOperatedHost()->releaseCommMessage(msg);
2402
2403     // Detailed log:
2404     if(getOperatedHost()->logEnabled()) {
2405       anna::diameter::comm::ServerSession *usedServerSession = getOperatedServer()->getLastUsedResource();
2406       std::string detail = usedServerSession ? usedServerSession->asString() : "<null server session>"; // shouldn't happen
2407       getOperatedHost()->writeLogFile(codecMsg, (success ? "sent2c" : "send2cError"), detail);
2408     }
2409   } else if(opType == "loadxml") {
2410     codecMsg.loadXML(param1);
2411     response_content = codecMsg.asXMLString();
2412     return;
2413   } else if(opType == "diameterServerSessions") {
2414     int diameterServerSessions = atoi(param1.c_str());
2415     getOperatedServer()->setMaxConnections(diameterServerSessions);
2416
2417   } else if(opType == "answerxml2c") {
2418     if(param1 == "") { // programmed answers FIFO's to stdout
2419       response_content = getOperatedServer()->getReactingAnswers()->asString("ANSWERS TO CLIENT");
2420       return;
2421     } else if (param1 == "rotate") {
2422       getOperatedServer()->getReactingAnswers()->rotate(true);
2423     } else if (param1 == "exhaust") {
2424       getOperatedServer()->getReactingAnswers()->rotate(false);
2425     } else if (param1 == "clear") {
2426       getOperatedServer()->getReactingAnswers()->clear();
2427     } else if (param1 == "dump") {
2428       getOperatedServer()->getReactingAnswers()->dump("programmed_answer");
2429     } else {
2430       codecMsg.loadXML(param1);
2431       updateOperatedOriginHostWithMessage(codecMsg);
2432       anna::diameter::codec::Message *message = getOperatedHost()->getCodecEngine()->createMessage(param1); // loads xml again, lesser of two evils
2433       LOGDEBUG(anna::Logger::debug(message->asXMLString(), ANNA_FILE_LOCATION));
2434
2435       if(message->isRequest())
2436         throw anna::RuntimeException("Cannot program diameter requests. Answer type must be provided", ANNA_FILE_LOCATION);
2437
2438       int code = message->getId().first;
2439       LOGDEBUG(anna::Logger::debug("Adding a new programed 'answer to client' to the FIFO queue corresponding to its message code ...", ANNA_FILE_LOCATION));
2440       getOperatedServer()->getReactingAnswers()->addMessage(code, message);
2441     }
2442   } else if(opType == "answerxml2e") {
2443
2444     if(param1 == "") { // programmed answers FIFO's to stdout
2445       response_content = getOperatedEntity()->getReactingAnswers()->asString("ANSWERS TO ENTITY");
2446       return;
2447     } else if (param1 == "rotate") {
2448       getOperatedEntity()->getReactingAnswers()->rotate(true);
2449     } else if (param1 == "exhaust") {
2450       getOperatedEntity()->getReactingAnswers()->rotate(false);
2451     } else if (param1 == "clear") {
2452       getOperatedEntity()->getReactingAnswers()->clear();
2453     } else if (param1 == "dump") {
2454       getOperatedEntity()->getReactingAnswers()->dump("programmed_answer");
2455     } else {
2456       codecMsg.loadXML(param1);
2457       updateOperatedOriginHostWithMessage(codecMsg);
2458       anna::diameter::codec::Message *message = getOperatedHost()->getCodecEngine()->createMessage(param1); // loads xml again, lesser of two evils
2459       LOGDEBUG(anna::Logger::debug(message->asXMLString(), ANNA_FILE_LOCATION));
2460
2461       if(message->isRequest())
2462         throw anna::RuntimeException("Cannot program diameter requests. Answer type must be provided", ANNA_FILE_LOCATION);
2463
2464       int code = message->getId().first;
2465       LOGDEBUG(anna::Logger::debug("Adding a new programed 'answer to entity' to the FIFO queue corresponding to its message code ...", ANNA_FILE_LOCATION));
2466       getOperatedEntity()->getReactingAnswers()->addMessage(code, message);
2467     }
2468   } else {
2469     throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION);
2470   }
2471
2472   // HTTP response
2473   response_content = "Operation correctly processed: "; response_content += operation;
2474   if (opt_response_content != "") {
2475     response_content += " => ";
2476     response_content += opt_response_content;
2477   }
2478 }
2479
2480 anna::xml::Node* Launcher::asXML(anna::xml::Node* parent) const
2481 throw() {
2482   anna::xml::Node* result = parent->createChild("launcher");
2483   anna::comm::Application::asXML(result);
2484   // Timming:
2485   result->createAttribute("StartTime", a_start_time.asString());
2486   result->createAttribute("InitialWorkingDirectory", a_initialWorkingDirectory);
2487   result->createAttribute("SecondsLifeTime", anna::time::functions::lapsedMilliseconds() / 1000);
2488   // Diameter:
2489   anna::diameter::comm::OriginHostManager &ohm = anna::diameter::comm::OriginHostManager::instantiate();
2490   for (diameter::comm::origin_hosts_it it = ohm.begin(); it != ohm.end(); it++) {
2491     it->second->asXML(result);
2492   }
2493
2494   // Registered codec engines:
2495   anna::diameter::codec::EngineManager &em = anna::diameter::codec::EngineManager::instantiate();
2496   em.asXML(result);
2497
2498   // OAM & statistics:
2499   oamAsXML(result);
2500   statsAsXML(result);
2501
2502   // Testing: could be heavy if test case reports are enabled
2503   anna::testing::TestManager::instantiate().asXML(result);
2504
2505   return result;
2506 }
2507
2508 anna::xml::Node* Launcher::oamAsXML(anna::xml::Node* parent) const
2509 throw() {
2510   anna::xml::Node* result = parent->createChild("Oam");
2511
2512   // OAM:
2513   anna::diameter::comm::OamModule::instantiate().asXML(result);
2514   anna::diameter::comm::ApplicationMessageOamModule::instantiate().asXML(result);
2515   anna::diameter::codec::OamModule::instantiate().asXML(result);
2516
2517   return result;
2518 }
2519
2520 anna::xml::Node* Launcher::statsAsXML(anna::xml::Node* parent) const
2521 throw() {
2522   anna::xml::Node* result = parent->createChild("Statistics");
2523
2524   // Statistics:
2525   anna::statistics::Engine::instantiate().asXML(result);
2526
2527   return result;
2528 }