X-Git-Url: https://git.teslayout.com/public/public/public/?a=blobdiff_plain;f=example%2Fdiameter%2Flauncher%2FLauncher.cpp;h=eb4dfe7f1f49006f1efdddce2b3f6ae2ccc13df4;hb=4c3f0a4d7e4db76996404d80c6f939548fca656f;hp=a21466a8354b89ff9a52533797f7dac2e74baa70;hpb=c82a3818b279727e943a76343f3cf1a278ac9e19;p=anna.git diff --git a/example/diameter/launcher/Launcher.cpp b/example/diameter/launcher/Launcher.cpp index a21466a..eb4dfe7 100644 --- a/example/diameter/launcher/Launcher.cpp +++ b/example/diameter/launcher/Launcher.cpp @@ -9,6 +9,8 @@ // Standard #include // std::istringstream #include // std::cout +#include // ceil +#include // Project #include @@ -22,15 +24,18 @@ #include // Process -#include "Launcher.hpp" -#include "RealmNode.hpp" -#include "MyDiameterEngine.hpp" +#include +#include +#include +#include +#include #define SIGUSR2_TASKS_INPUT_FILENAME "./sigusr2.tasks.input" #define SIGUSR2_TASKS_OUTPUT_FILENAME "./sigusr2.tasks.output" + const char *ServicesDTD = "\ \n\ \n\ @@ -109,6 +114,8 @@ Launcher::Launcher() : anna::comm::Application("launcher", "DiameterLauncher", " a_codecEngine = new anna::diameter::codec::Engine("MyCodecEngine"); a_timeEngine = NULL; a_counterRecorder = NULL; + a_admlMinResolution = 2 * anna::timex::Engine::minResolution; // 2*10 = 20 ms; 1000/20 = 50 ticks per second; + //a_admlMinResolution = (anna::Millisecond)100; a_counterRecorderClock = NULL; // a_nodes.clear(); @@ -430,9 +437,8 @@ throw(anna::RuntimeException) { CommandLine& cl(anna::CommandLine::instantiate()); anna::comm::Communicator::WorkMode::_v workMode(anna::comm::Communicator::WorkMode::Single); a_communicator = new MyCommunicator(workMode); - - //a_timeEngine = new anna::timex::Engine((anna::Millisecond)600000, anna::timex::Engine::minResolution); - a_timeEngine = new anna::timex::Engine((anna::Millisecond)600000, (anna::Millisecond)100); // puedo bajar hasta 10 + a_timeEngine = new anna::timex::Engine((anna::Millisecond)600000, a_admlMinResolution); + TestManager::instantiate().setTimerController(a_timeEngine); // Counters record procedure: const char *varname = "cntRecordPeriod"; @@ -444,6 +450,11 @@ throw(anna::RuntimeException) { a_counterRecorder = new MyCounterRecorder(cntDir + anna::functions::asString("/Counters.Pid%d", (int)getPid())); } + // Testing framework: + std::string tmDir = "."; + if(cl.exists("tmDir")) tmDir = cl.getValue("tmDir"); + TestManager::instantiate().setReportsDirectory(tmDir); + // Tracing: if(cl.exists("trace")) anna::Logger::setLevel(anna::Logger::asLevel(cl.getValue("trace"))); @@ -563,9 +574,12 @@ throw(anna::RuntimeException) { oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::RequestSentExpired, "", 55); oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::RequestSentOnClientSessionExpired, "", 56); oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::RequestSentOnServerSessionExpired, "", 57); - oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::AnswerReceivedUnknown, "", 58); - oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::AnswerReceivedOnClientSessionUnknown, "", 59); - oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::AnswerReceivedOnServerSessionUnknown, "", 60); + oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::RequestRetransmitted, "", 58); + oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::RequestRetransmittedOnClientSession, "", 59); + oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::RequestRetransmittedOnServerSession, "", 60); + oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::AnswerReceivedUnknown, "", 61); + oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::AnswerReceivedOnClientSessionUnknown, "", 62); + oamDiameterComm.registerCounter(anna::diameter::comm::OamModule::Counter::AnswerReceivedOnServerSessionUnknown, "", 63); ////////////////// // CODEC MODULE // ////////////////// @@ -672,6 +686,7 @@ throw(anna::RuntimeException) { a_communicator->accept(); } + bool Launcher::getDataBlockFromHexFile(const std::string &pathfile, anna::DataBlock &db) const throw() { // Get hex string static char buffer[8192]; @@ -939,7 +954,7 @@ std::string Launcher::help() const throw() { result += "\n has been logged)"; result += "\n [retry] Request retransmission"; result += "\n"; - result += "\n-------------------------------------------------------------------------------------------- Load tests"; + result += "\n------------------------------------------------------------------------------------------- Burst tests"; result += "\n"; result += "\nburst|[|parameter] Used for performance testing, we first program diameter requests"; result += "\n messages in order to launch them from client side to the configured"; @@ -966,7 +981,230 @@ std::string Launcher::help() const throw() { result += "\n operations is that burst won't be awaken. Externally we could control"; result += "\n sending time (no request will be sent for answers)."; result += "\n burst|goto| Updates current burst pointer position."; - result += "\n burst|look| Show programmed burst message for order provided."; + result += "\n burst|look[|order] Show programmed burst message for order provided, current when missing."; + result += "\n"; + result += "\n-------------------------------------------------------------------------------------- Advanced testing"; + result += "\n"; + result += "\n Burst mode only allows single interface interaction. For multiple interface"; + result += "\n (realm) coordination, you could use the advanced test cases programming:"; + result += "\n"; + result += "\n"; + result += "\n test||[|parameters]"; + result += "\n"; + result += "\n Adds a new step to the test case with provided identifier. If provided identifier"; + result += "\n is not registered yet, a new test case will be created with that value and the"; + result += "\n step will be added as the first. For a specific 'id', the steps are stored in"; + result += "\n order as they are programmed"; + result += "\n"; + result += "\n : integer number, normally monotonically increased for each test case. Some external"; + result += "\n script/procedure shall clone a test case template in order to build a collection"; + result += "\n of independent and coherent test cases (normally same type) with different context"; + result += "\n values (Session-Id, Subscriber-Id, etc.)."; + result += "\n"; + result += "\n : commands to be executed for the test id provided. Each command programmed"; + result += "\n constitutes a test case 'step', numbered from 1 to N."; + result += "\n"; + result += "\n timeout| Sets an asynchronous timer to restrict the maximum timeout"; + result += "\n until last test step. Normally, this command is invoked"; + result += "\n in the first step, anyway it measures the time from the"; + result += "\n execution point whatever it is. The expiration will abort"; + result += "\n the test if still running. One or more timeouts could be"; + result += "\n programmed (not usual), but the more restrict will apply."; + result += "\n It is highly recommended to program a initial timeout step,"; + result += "\n or the test case could be eternally in-progress."; + result += "\n"; + result += "\n sendxml2e|[|]"; + result += "\n Sends xml source file (pathfile) to entity (it would be a"; + result += "\n 'forward' event if it came through local server endpoint)."; + result += "\n The step number should be provided for answers to indicate"; + result += "\n the 'wait for request' corresponding step. If you miss this"; + result += "\n reference, the sequence information (hop-by-hop, end-to-end)"; + result += "\n will be sent as they are in the answer xml message (realize"; + result += "\n the difficulty of predicting these information). Be sure to"; + result += "\n refer to a 'wait for request' step. Conditions like 'regexp'"; + result += "\n (as we will see later) are not verified."; + result += "\n"; + result += "\n sendxml2c|[|]"; + result += "\n Sends xml source file (pathfile) to client (it would be a"; + result += "\n 'forward' event if it came through remote server endpoint)."; + result += "\n Same commented for 'sendxml2e' regarding the step number."; + result += "\n"; + result += "\n delay| Blocking step until the time lapse expires. Useful to give "; + result += "\n some cadence control and time schedule for a specific case."; + result += "\n wait| Blocking step until condition is fulfilled. The message could"; + result += "\n received from entity (waitfe) or from client (waitfc)."; + result += "\n"; + result += "\n wait-regexp|"; + result += "\n Wait condition, from entity (waitfe-regexp) or client (waitfc-regexp)"; + result += "\n to match the serialized xml content for received messages. CPU cost"; + result += "\n is bigger than the former ones because the whole message must be"; + result += "\n decoded and converted to xml instead of doing a direct hexadecimal"; + result += "\n buffer search. The main advantage is the great flexibility to identify"; + result += "\n any content with a regular expression."; + result += "\n"; + result += "\n : Optional parameters which must be fulfilled to continue through the next step."; + result += "\n Any received message over diameter interfaces will be evaluated against the"; + result += "\n corresponding test case starting from the current step until the first one"; + result += "\n whose condition is fulfilled. If no condition is fulfilled the event will be"; + result += "\n classified as 'uncovered' (normally a test case bad configuration, or perhaps"; + result += "\n a real unexpected message)."; + + // TODO(***) +// result += "\n The way to identify the test case, is through registered Session-Id values for"; +// result += "\n programmed requests. But this depends on the type of node. Acting as clients,"; +// result += "\n requests received have Session-Id values which are already registered with"; +// result += "\n one test case, causing an error if not found. Acting as servers, requests are"; +// result += "\n received over a diameter local server from a client which are generating that"; +// result += "\n Session-Id values. Then we know nothing about such values. The procedure in"; +// result += "\n this case is find out a test case not-started containing a condition which"; +// result += "\n comply with the incoming message, and reactivates it."; + // The other solution: register Session-Id values for answers send to client from a local diameter server. + + result += "\n How to answer: a wait condition for a request will store the incoming message"; + result += "\n which fulfills that condition. This message is useful together with the peer"; + result += "\n connection source in a further send step configured with the corresponding"; + result += "\n response. You could also insert a delay between wait and send steps to be"; + result += "\n more realistic (processing time simulation in a specific ADML realm node)."; + result += "\n Always, a response send step will get the needed information from the most"; + result += "\n recent wait step finding in reverse order (note that some race conditions"; + result += "\n could happen if your condition is not specific enough)."; + + result += "\n"; + result += "\n Condition format:"; + result += "\n"; + result += "\n [code]|[bitR]|[ResultCode]|[sessionId]|[hopByHop]|[msisdn]|[imsi]|[serviceContextId]"; + result += "\n"; + result += "\n code: integer number"; + result += "\n bitR: 1 (request), 0 (answer)"; + result += "\n ResultCode: integer number"; + result += "\n sessionId: string"; + result += "\n hopByHop: integer number or request send step reference: #"; + result += "\n"; + result += "\n Using the hash reference, you would indicate a specific wait condition"; + result += "\n for answers. The step number provided must correspond to any of the"; + result += "\n previous send commands (sendxml2e/sendxml2c) configured for a request."; + result += "\n This 'hop-by-hop' variant eases the wait condition for answers in the"; + result += "\n safest way."; + result += "\n"; + result += "\n msisdn: string"; + result += "\n imsi: string"; + result += "\n serviceContextId: string"; + result += "\n"; + result += "\n Take into account these rules, useful in general:"; + result += "\n"; + result += "\n - Be as much specific as possible defining conditions to avoid ambiguity sending"; + result += "\n messages out of context due to race conditions. Although you could program several"; + result += "\n times similar conditions, some risky practices will throw a warning trace (if you"; + result += "\n repeat the same condition within the same test case)."; + result += "\n - Adding a ResultCode and/or HopByHop to the condition are only valid waiting answers."; + result += "\n - Requests hop-by-hop values must be different for all the test case requests."; + result += "\n RFC says that a hop by hop must be unique for a specific connection, something that"; + result += "\n could be difficult to manage if we have multiple available connections from client"; + result += "\n side endpoint (entity or local server), even if we would have only one connection but"; + result += "\n several realm interfaces. It is enough to configure different hop-by-hop values within"; + result += "\n each test case, because on reception, the Session-Id is used to identify that test case."; + result += "\n"; + result += "\n"; + result += "\n"; + result += "\n"; + result += "\n Programming example:"; + result += "\n"; + result += "\n Basic Rx/Gx scenary: PCEF (Gx) - PCRF - AF (Rx)"; + result += "\n"; + result += "\n test|1|timeout|5000 (step 1: whole time requirement is 5 seconds)"; + result += "\n test|1|sendxml2e|CCR-I.xml (step 2: imagine this xml uses the Session-Id 'SGx')"; + result += "\n test|1|waitfe|272|0|2001|SGx (step 3: waits the CCA for the CCR-I with Result-Code = DIAMETER_SUCCESS)"; + result += "\n test|1|sendxml2e|AAR-flows.xml (step 4: imagine this xml uses the Session-Id 'SRx')"; + result += "\n test|1|waitfe|265|0|2001|SRx (step 5: waits the AAA for the AAR-flows with Result-Code = DIAMETER_SUCCESS)"; + result += "\n test|1|waitfe|258|1||SGx (step 6: waits the RAR (install policies) from the PCRF server)"; + result += "\n test|1|sendxml2e|RAA-install.xml|6 (step 7: sends the response for the RAR)"; + result += "\n test|1|sendxml2e|CCR-T.xml (step 8: termination of the Gx session, imagine this xml puts hop-by-hop 'H1')"; + result += "\n test|1|waitfe|272|0|2001|SGx|H1 (step 9: waits the CCA for the CCR-T with Result-Code = DIAMETER_SUCCESS and hop-by-hop 'H1')"; + result += "\n test|1|waitfe|258|1||SGx (step 10: waits the RAR (remove policies) from the PCRF server)"; + result += "\n test|1|sendxml2e|RAA-remove.xml|10 (step 11: sends the response for the RAR)"; + result += "\n"; + result += "\n Notes: We added an additional condition in step 9: the hop-by-hop. When we program the corresponding"; + result += "\n source request (CCR-T), we configured the value 'H1' for the hop-by-hop. This is an 'application"; + result += "\n value' because the real hop-by-hop transported through the client connection is managed by the"; + result += "\n diameter stack. But when returned, the transaction pool resolve the original value. This feature"; + result += "\n is necessary to ease the implementation of certain diameter agents (proxies for example). In our"; + result += "\n case, we could format the hop-by-hop values within the request templates with total freedom to"; + result += "\n improve the programmed conditions."; + result += "\n"; + result += "\n In the case of 'waiting for requests' is not such easy. Indeed, steps 6 and 10 will write a warning"; + result += "\n because they are the same condition. We know that we are not going to have any problem because"; + result += "\n such events are blocking-protected regarding logic-dependent messages (CCR-T), and race condition"; + result += "\n is absolutely strange in this case."; + result += "\n"; + result += "\n You could speed up the test case moving forward steps like 3 & 5, understood as non-strict requirements"; + result += "\n to continue testing. Anyway, remember that test cases should be as real as possible, and that there"; + result += "\n are many ways to increase the load rate as we will see in next section (test cases execution)."; + result += "\n"; + result += "\n Other simplifications: the steps 3, 5 and 9 can be replaced by"; + result += "\n"; + result += "\n test|1|waitfe||0|||#2"; + result += "\n test|1|waitfe||0|||#4"; + result += "\n test|1|waitfe||0|||#8"; + result += "\n"; + result += "\n which means that hop-by-hop must be retrieved from steps 2, 4 and 8 respectively,"; + result += "\n and the expected message shall be an answer. Normally you will add other conditions,"; + result += "\n for example a DIAMETER_SUCCESS result (adding 2001 as Result-Code)."; + result += "\n"; + result += "\nTest cases execution:"; + result += "\n"; + result += "\n"; + result += "\n test|ttps| Starts/resume the provided number of test ticks per second (ttps). The ADML starts"; + result += "\n with the event trigger system suspended, and this operation is neccessary to begin"; + result += "\n those cases which need this time event (internal triggering). Some other test cases"; + result += "\n could be started through external events (first test case event could be programmed"; + result += "\n to wait specific message), but is not usual this external mode and neither usual to"; + result += "\n mix triggering types. Normally, you will pause/stop new test launchs providing 0 as"; + result += "\n ttps value, and also you could dynamically modify the load rate updating that value."; + result += "\n If a test case has N messages then 'ttps * N' will be the virtual number of messages"; + result += "\n managed per second when no bottleneck exists."; + result += "\n"; + result += "\n Provide 0 in order to stop the timer triggering."; + result += "\n"; + result += "\n There timer manager resolution currently harcoded allows a maximum of "; + result += anna::functions::asString(1000/a_admlMinResolution); result += " events"; + result += "\n per second. To reach greater rates ADML will join synchronously the needed number of"; + result += "\n new time-triggered test cases per a single event, writting a warning-level trace to"; + result += "\n advice about the risk of burst sendings and recommend launching multiple instances"; + result += "\n to achieve such load with a lower rate per instance."; + result += "\n"; + result += "\n test|ip-limit[|amount] In-progress limit of test cases. No new test cases will be launched over this value"; + result += "\n (test Manager tick work will be ignored). Zero-value is equivalent to stop the clock."; + result += "\n tick, -1 is used to specify 'no limit' which is the default. If missing amount, the"; + result += "\n limit and current amount of in-progress test cases will be shown."; + result += "\n"; + result += "\n test|goto| Updates current test pointer position."; + result += "\n"; + result += "\n test|look[|id] Show programmed test case for id provided, current when missing. Test cases programmed"; + result += "\n are not dumped on process context (too many information in general). When the test case"; + result += "\n has been completed or initiated, it will contain context information acting as a report."; + result += "\n"; + result += "\n test|report[|[yes]|no] Every time a test case is finished, its xml representation will be dump on a file under"; + result += "\n the execution directory (or the one configured in process command-line 'tmDir') with"; + result += "\n the name 'testcase..xml'. If repeat mode is active, new test case executions will"; + result += "\n append its reports into the same file. This option is disabled by default to improve"; + result += "\n performance (reducing IO). ADML process context will show test manager whole information"; + result += "\n and test case reports will be written depending on this report option. Anyway, you could"; + result += "\n use the 'look' operation to see the report."; + result += "\n"; + result += "\n test|reset|[|id] Reset the test case for id provided, all the tests when missing. It could be hard/soft:"; + result += "\n - hard: you probably may need to stop the load rate before. This operation initializes"; + result += "\n all test cases regardless their states."; + result += "\n - soft: only for finished cases (those with 'Success' or 'Failed' states). It does not"; + result += "\n affect to test cases with 'InProgress' state."; + result += "\n"; + result += "\n test|repeat[|[yes]|no] Restarts the whole programmed test list when finished, disabled by default (testing"; + result += "\n time trigger system will enter suspended state until new ttps operation is received)."; + result += "\n Test cases state & data will be reset (when achieved again), but general statistics"; + result += "\n and counters will continue measuring until reset with 'collect' operation."; + result += "\n When the test cases pool has been processed (and this repeat option is disabled), you"; + result += "\n could reactivate the testing by mean 'test|reset|soft' and then 'test|ttps|'."; + result += "\n"; + result += "\n test|clear Clears all the programmed test cases and stop testing (if in progress)."; result += "\n"; result += "\n"; result += "\nUSING OPERATIONS INTERFACE"; @@ -1009,11 +1247,18 @@ std::string Launcher::help() const throw() { void Launcher::eventOperation(const std::string &operation, std::string &response_content) throw(anna::RuntimeException) { LOGMETHOD(anna::TraceMethod tm("Launcher", "eventOperation", ANNA_FILE_LOCATION)); CommandLine& cl(anna::CommandLine::instantiate()); + TestManager &testManager = TestManager::instantiate(); LOGDEBUG(anna::Logger::debug(operation, ANNA_FILE_LOCATION)); - response_content = "Operation processed with exception. See traces\n"; // supposed - std::string result = ""; + + // Default response: + response_content = "Operation processed with exception (see traces): "; + response_content += operation; + response_content += "\n"; + + std::string result_msg = ""; anna::DataBlock db_aux(true); + /////////////////////////////////////////////////////////////////// // Simple operations without arguments: @@ -1022,7 +1267,7 @@ void Launcher::eventOperation(const std::string &operation, std::string &respons std::string s_help = help(); std::cout << s_help << std::endl; LOGINFORMATION(anna::Logger::information(s_help, ANNA_FILE_LOCATION)); - response_content = "Help dumped on stdout and information-level traces (launcher.trace file)\n"; + response_content = "Help dumped on stdout and information-level traces\n"; return; } @@ -1044,18 +1289,41 @@ void Launcher::eventOperation(const std::string &operation, std::string &respons /////////////////////////////////////////////////////////////////// // Tokenize operation Tokenizer params; - params.apply(operation, "|"); + params.apply(operation, "|", "" /* allow contiguous separators */); int numParams = params.size() - 1; - // No operation has more than 2 arguments ... - if(numParams > 2) { - LOGWARNING(anna::Logger::warning(help(), ANNA_FILE_LOCATION)); - throw anna::RuntimeException("Wrong body content format on HTTP Request", ANNA_FILE_LOCATION); - } - - // Get the operation type: + // Get the operation type and parameters: Tokenizer::const_iterator tok_iter = params.begin(); std::string opType = Tokenizer::data(tok_iter); + std::string param1, param2, param3, param4, param5, param6, param7, param8, param9, param10; + if(numParams >= 1) { tok_iter++; param1 = Tokenizer::data(tok_iter); } + if(numParams >= 2) { tok_iter++; param2 = Tokenizer::data(tok_iter); } + if(numParams >= 3) { tok_iter++; param3 = Tokenizer::data(tok_iter); } + // Tests conditions + if(numParams >= 4) { tok_iter++; param4 = Tokenizer::data(tok_iter); } + if(numParams >= 5) { tok_iter++; param5 = Tokenizer::data(tok_iter); } + if(numParams >= 6) { tok_iter++; param6 = Tokenizer::data(tok_iter); } + if(numParams >= 7) { tok_iter++; param7 = Tokenizer::data(tok_iter); } + if(numParams >= 8) { tok_iter++; param8 = Tokenizer::data(tok_iter); } + if(numParams >= 9) { tok_iter++; param9 = Tokenizer::data(tok_iter); } + if(numParams >= 10) { tok_iter++; param10 = Tokenizer::data(tok_iter); } + // Remove '' artificial token to ease further checkings: + if (param1 == "") param1 = ""; + if (param2 == "") param2 = ""; + if (param3 == "") param3 = ""; + if (param4 == "") param4 = ""; + if (param5 == "") param5 = ""; + if (param6 == "") param6 = ""; + if (param7 == "") param7 = ""; + if (param8 == "") param8 = ""; + if (param9 == "") param9 = ""; + if (param10 == "") param10 = ""; + + // No operation has more than 2 arguments except 'test' ... + if(opType != "test" && numParams > 2) + throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION); + + // Check the number of parameters: bool wrongBody = false; @@ -1067,23 +1335,18 @@ void Launcher::eventOperation(const std::string &operation, std::string &respons if((opType == "burst") && (numParams < 1)) wrongBody = true; + if((opType == "test") && (numParams < 1)) wrongBody = true; + if(((opType == "sendxml2c") || (opType == "sendhex2c") || (opType == "loadxml") || (opType == "diameterServerSessions")) && (numParams != 1)) wrongBody = true; if(wrongBody) { // Launch exception std::string msg = "Wrong body content format on HTTP Request for '"; msg += opType; - msg += "' operation (missing parameter/s)"; + msg += "' operation (missing parameter/s). Use 'help' management command to see more information."; throw anna::RuntimeException(msg, ANNA_FILE_LOCATION); } - // All seems ok: - std::string param1, param2; - - if(numParams >= 1) { tok_iter++; param1 = Tokenizer::data(tok_iter); } - - if(numParams == 2) { tok_iter++; param2 = Tokenizer::data(tok_iter); } - // Operations: if(opType == "context") { std::string contextFile = ((numParams == 1) ? param1 : anna::functions::asString("/var/tmp/anna.context.%05d", getPid())); @@ -1157,9 +1420,9 @@ void Launcher::eventOperation(const std::string &operation, std::string &respons if(opType == "show") commEngine->findClientSession(key)->show(); - if(opType == "hidden") result = commEngine->findClientSession(key)->hidden() ? "true" : "false"; + if(opType == "hidden") result_msg = commEngine->findClientSession(key)->hidden() ? "true" : "false"; - if(opType == "shown") result = commEngine->findClientSession(key)->shown() ? "true" : "false"; + if(opType == "shown") result_msg = commEngine->findClientSession(key)->shown() ? "true" : "false"; } else { std::string address; int port; @@ -1169,18 +1432,18 @@ void Launcher::eventOperation(const std::string &operation, std::string &respons if(opType == "show") commEngine->findServer(address, port)->show(); - if(opType == "hidden") result = commEngine->findServer(address, port)->hidden() ? "true" : "false"; + if(opType == "hidden") result_msg = commEngine->findServer(address, port)->hidden() ? "true" : "false"; - if(opType == "shown") result = commEngine->findServer(address, port)->shown() ? "true" : "false"; + if(opType == "shown") result_msg = commEngine->findServer(address, port)->shown() ? "true" : "false"; } } else { if(opType == "hide") entity->hide(); if(opType == "show") entity->show(); - if(opType == "hidden") result = entity->hidden() ? "true" : "false"; + if(opType == "hidden") result_msg = entity->hidden() ? "true" : "false"; - if(opType == "shown") result = entity->shown() ? "true" : "false"; + if(opType == "shown") result_msg = entity->shown() ? "true" : "false"; } } else if((opType == "sendxml") || (opType == "sendxml2e") || (opType == "sendhex") || (opType == "sendhex2e")) { if(!entity) throw anna::RuntimeException("No entity configured to send the message", ANNA_FILE_LOCATION); @@ -1224,12 +1487,12 @@ void Launcher::eventOperation(const std::string &operation, std::string &respons // Externally we could control sending time (no request // will be sent for answers). // burst|goto| Updates current burst pointer position. - // burst|look| Show programmed burst message for order provided. + // burst|look| Show programmed burst message for order provided, current when missing. if(param1 == "clear") { - result = "Removed "; - result += anna::functions::asString(getWorkingNode()->clearBurst()); - result += " elements."; + result_msg = "removed "; + result_msg += anna::functions::asString(getWorkingNode()->clearBurst()); + result_msg += " elements"; } else if(param1 == "load") { if(param2 == "") throw anna::RuntimeException("Missing xml path file for burst load operation", ANNA_FILE_LOCATION); @@ -1239,10 +1502,10 @@ void Launcher::eventOperation(const std::string &operation, std::string &respons 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) int position = getWorkingNode()->loadBurstMessage(codecMsg.code()); - result = "Loaded '"; - result += param2; - result += "' file into burst list position "; - result += anna::functions::asString(position); + result_msg = "loaded '"; + result_msg += param2; + result_msg += "' file into burst list position "; + result_msg += anna::functions::asString(position); } else if(param1 == "start") { if(param2 == "") throw anna::RuntimeException("Missing initial load for burst start operation", ANNA_FILE_LOCATION); @@ -1250,9 +1513,8 @@ void Launcher::eventOperation(const std::string &operation, std::string &respons int processed = getWorkingNode()->startBurst(initialLoad); if(processed > 0) { - result = "Initial load completed for "; - result += anna::functions::entriesAsString(processed, "message"); - result += "."; + result_msg = "initial load completed for "; + result_msg += anna::functions::entriesAsString(processed, "message"); } } else if(param1 == "push") { if(param2 == "") throw anna::RuntimeException("Missing load amount for burst push operation", ANNA_FILE_LOCATION); @@ -1260,9 +1522,8 @@ void Launcher::eventOperation(const std::string &operation, std::string &respons int pushed = getWorkingNode()->pushBurst(atoi(param2.c_str())); if(pushed > 0) { - result = "Pushed "; - result += anna::functions::entriesAsString(pushed, "message"); - result += "."; + result_msg = "pushed "; + result_msg += anna::functions::entriesAsString(pushed, "message"); } } else if(param1 == "pop") { if(param2 == "") throw anna::RuntimeException("Missing amount for burst pop operation", ANNA_FILE_LOCATION); @@ -1271,47 +1532,266 @@ void Launcher::eventOperation(const std::string &operation, std::string &respons int popped = getWorkingNode()->popBurst(releaseLoad); if(popped > 0) { - result = "Burst popped for "; - result += anna::functions::entriesAsString(popped, "message"); - result += "."; + result_msg = "burst popped for "; + result_msg += anna::functions::entriesAsString(popped, "message"); } } else if(param1 == "stop") { int left = getWorkingNode()->stopBurst(); if(left != -1) { - result += anna::functions::entriesAsString(left, "message"); - result += " left to the end of the cycle."; + result_msg += anna::functions::entriesAsString(left, "message"); + result_msg += " left to the end of the cycle"; } } else if(param1 == "repeat") { if(param2 == "") param2 = "yes"; bool repeat = (param2 == "yes"); getWorkingNode()->repeatBurst(repeat); - result += (repeat ? "Mode on." : "Mode off."); + result_msg += (repeat ? "repeat enabled" : "repeat disabled"); } else if(param1 == "send") { if(param2 == "") throw anna::RuntimeException("Missing amount for burst send operation", ANNA_FILE_LOCATION); int sent = getWorkingNode()->sendBurst(atoi(param2.c_str())); if(sent > 0) { - result = "Sent "; - result += anna::functions::entriesAsString(sent, "message"); - result += "."; + result_msg = "sent "; + result_msg += anna::functions::entriesAsString(sent, "message"); } } else if(param1 == "goto") { if(param2 == "") throw anna::RuntimeException("Missing order position for burst goto operation", ANNA_FILE_LOCATION); - result = getWorkingNode()->gotoBurst(atoi(param2.c_str())); - result += "."; + result_msg = getWorkingNode()->gotoBurst(atoi(param2.c_str())); } else if(param1 == "look") { - if(param2 == "") throw anna::RuntimeException("Missing order position for burst look operation", ANNA_FILE_LOCATION); - - result = "\n\n"; - result += getWorkingNode()->lookBurst(atoi(param2.c_str())); - result += "\n\n"; + int order = ((param2 != "") ? atoi(param2.c_str()) : -1); + result_msg = "\n\n"; + result_msg += getWorkingNode()->lookBurst(order); } else { throw anna::RuntimeException("Wrong body content format on HTTP Request for 'burst' operation (unexpected action parameter). See help", ANNA_FILE_LOCATION); } + + } else if((opType == "test")) { + // test||[|parameters] Add a new step to the test case ... + // test|ttps| Starts/resume the provided number of time ticks per second (ttps). The ADML starts ... + // test|ip-limit[|amount] In-progress limit of test cases. No new test cases will be launched over this value ... + // test|repeat[|[yes]|no] Restarts the programmed test cases when finished. Disabled by default: the testing ... + // test|report[|[yes]|no] Every time a test case is finished a report file in xml format will be created under ... + // test|goto| Updates current test pointer position. + // test|look[|id] Show programmed test case for id provided, current when missing ... + // test|reset|[|id] Reset the test case for id provided, all the tests when missing ... + // test|clear Clears all the programmed test cases. + + if(param1 == "ttps") { + if (numParams > 2) + throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION); + + bool success = ((param2 != "") ? testManager.configureTTPS(atoi(param2.c_str())) : false); + if (success) { + result_msg = "assigned new test launch rate to "; + result_msg += anna::functions::asString(atoi(param2.c_str())); + result_msg += " events per second"; + } + else { + result_msg += "unable to configure the test rate provided"; + } + } + else if(param1 == "ip-limit") { + if (numParams > 2) + throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION); + + unsigned int limit; + if (param2 != "") { + limit = atoi(param2.c_str()); + testManager.setInProgressLimit(limit); + result_msg = "new in-progress limit: "; + result_msg += (limit != UINT_MAX) ? anna::functions::asString(limit) : ""; + } + else { + result_msg = "in-progress limit amount: "; + limit = testManager.getInProgressLimit(); + result_msg += (limit != UINT_MAX) ? anna::functions::asString(limit) : ""; + result_msg += "; currently there are "; + result_msg += anna::functions::asString(testManager.getInProgressCount()); + result_msg += " test cases running"; + } + } + else if(param1 == "repeat") { + if (numParams > 2) + throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION); + + if(param2 == "") param2 = "yes"; + testManager.setPoolRepeat((param2 == "yes")); + result_msg += (testManager.getPoolRepeat() ? "repeat enabled" : "repeat disabled"); + } + else if(param1 == "report") { + if (numParams > 2) + throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION); + + if(param2 == "") param2 = "yes"; + testManager.setDumpReports((param2 == "yes")); + result_msg += (testManager.getDumpReports() ? "report enabled" : "report disabled"); + } + else if(param1 == "goto") { + if (numParams > 2) + throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION); + + if(param2 == "") throw anna::RuntimeException("Missing id for test goto operation", ANNA_FILE_LOCATION); + int id = atoi(param2.c_str()); + if (testManager.gotoTestCase(id)) { + result_msg = "position updated for id provided ("; + } + else { + result_msg = "cannot found test id ("; + } + result_msg += anna::functions::asString(id); + result_msg += ")"; + } + else if(param1 == "look") { + if (numParams > 2) + throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION); + + int id = ((param2 != "") ? atoi(param2.c_str()) : -1); + TestCase *testCase = testManager.findTestCase(id); + + if (testCase) { + result_msg = "\n\n"; + result_msg += testCase->asXMLString(); + } + else { + if (id == -1) { + result_msg = "no current test case detected (testing started ?)"; + } + else { + result_msg = "cannot found test id ("; + result_msg += anna::functions::asString(id); + result_msg += ")"; + } + } + } + else if(param1 == "reset") { + if (numParams > 3) + throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION); + + if (param2 != "soft" && param2 != "hard") + throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION); + + int id = ((param3 != "") ? atoi(param3.c_str()) : -1); + TestCase *testCase = ((id != -1) ? testManager.findTestCase(id) : NULL); + + if (testCase) { + bool done = testCase->reset((param2 == "hard") ? true:false); + result_msg = "test "; + result_msg += param2; + result_msg += " reset for id "; + result_msg += anna::functions::asString(id); + result_msg += done ? ": done": ": not done"; + } + else { + if (id == -1) { + bool anyReset = testManager.resetPool((param2 == "hard") ? true:false); + result_msg = "reset have been sent to all programmed tests: "; result_msg += anyReset ? "some/all was actually reset" : "nothing was reset"; + } + else { + result_msg = "cannot found test id ("; + result_msg += anna::functions::asString(id); + result_msg += ")"; + } + } + } + else if(param1 == "clear") { + if (numParams > 1) + throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION); + + if (testManager.clearPool()) { + result_msg = "all the programmed test cases have been dropped"; + } + else { + result_msg = "there are not programmed test cases to be removed"; + } + } + else { + int id = atoi(param1.c_str()); + if(id < 0) + throw anna::RuntimeException("Invalid test case identifier: must be a non-negative number", ANNA_FILE_LOCATION); + + // PARAM: 1 2 3 4 5 6 7 8 9 10 + // test|| + // timeout| + // sendxml2e| [|] + // sendxml2c| [|] + // delay| [msecs] + // wait|[code]|[bitR]|[ResultCode]|[sessionId]|[hopByHop]|[msisdn]|[imsi]|[serviceContextId] + // wait-answer| + // wait-regexp| + if(param2 == "") throw anna::RuntimeException("Missing command for test id operation", ANNA_FILE_LOCATION); + + // Commands: + if (param2 == "timeout") { + if (numParams > 3) + throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION); + if(param3 == "") throw anna::RuntimeException("Missing milliseconds for 'timeout' command in test id operation", ANNA_FILE_LOCATION); + anna::Millisecond timeout = checkTimeMeasure("Test case timeout", param3); + testManager.getTestCase(id)->addTimeout(timeout); // creates / reuses + } + else if ((param2 == "sendxml2e")||(param2 == "sendxml2c")) { + if (numParams > 4) + throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION); + if(param3 == "") throw anna::RuntimeException(anna::functions::asString("Missing xml file for '%s' command in test id operation", param2.c_str()), ANNA_FILE_LOCATION); + codecMsg.loadXML(param3); + if (codecMsg.isRequest()) { + if (param4 != "") + throw anna::RuntimeException("Step number is provided with answers (to resolve the corresponding 'wait for request' step), but NOT with requests", ANNA_FILE_LOCATION); + } + else { + if (param4 == "") LOGWARNING(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)); + } + int stepNumber = ((param4 != "") ? atoi(param4.c_str()):-1); + std::string originRealm = codecMsg.getAvp(anna::diameter::helpers::base::AVPID__Origin_Realm)->getDiameterIdentity()->getValue(); + RealmNode *realm = getRealmNode(originRealm); + if (!realm) + throw anna::RuntimeException("Cannot identify the realm node for the manager message. Check the Origin-Realm avp value (use the realm node name)", ANNA_FILE_LOCATION); + + if (param2 == "sendxml2e") + testManager.getTestCase(id)->addSendxml2e(codecMsg.code(), realm, stepNumber); // creates / reuses + else + testManager.getTestCase(id)->addSendxml2c(codecMsg.code(), realm, stepNumber); // creates / reuses + } + else if (param2 == "delay") { + if (numParams > 3) + throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION); + if(param3 == "") throw anna::RuntimeException("Missing milliseconds for 'delay' command in test id operation", ANNA_FILE_LOCATION); + anna::Millisecond delay = checkTimeMeasure("Test case delay step", param3); + testManager.getTestCase(id)->addDelay(delay); // creates / reuses + } + else if ((param2 == "waitfe")||(param2 == "waitfc")) { + if (numParams > 10) + throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION); + if (param3 != "" || param4 != "" || param5 != "" || param6 != "" || param7 != "" || param8 != "" || param9 != "" || param10 != "") { + bool fromEntity = (param2.substr(4,2) == "fe"); + testManager.getTestCase(id)->addWait(fromEntity, param3, param4, param5, param6, param7, param8, param9, param10); + } + else { + throw anna::RuntimeException(anna::functions::asString("Missing condition for '%s' command in test id operation", param2.c_str()), ANNA_FILE_LOCATION); + } + } + else if ((param2 == "waitfe-regexp")||(param2 == "waitfc-regexp")) { + if (numParams > 3) + throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION); + if (param3 != "") { + bool fromEntity = (param2.substr(4,2) == "fe"); + testManager.getTestCase(id)->addWaitRegexp(fromEntity, param3); + } + else { + throw anna::RuntimeException(anna::functions::asString("Missing condition for '%s' command in test id operation", param2.c_str()), ANNA_FILE_LOCATION); + } + } + else { + throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION); + } + + result_msg = "new step added to test id "; + result_msg += anna::functions::asString(id); + } + } else if((opType == "sendxml2c") || (opType == "sendhex2c")) { if(!localServer) throw anna::RuntimeException("No local server configured to send the message", ANNA_FILE_LOCATION); anna::diameter::comm::Message *msg = getWorkingNode()->createCommMessage(); @@ -1412,75 +1892,12 @@ void Launcher::eventOperation(const std::string &operation, std::string &respons entity->getReactingAnswers()->addMessage(code, message); } } else { - LOGWARNING(anna::Logger::warning(help(), ANNA_FILE_LOCATION)); - throw anna::RuntimeException("Wrong body content format on HTTP Request. Unsupported/unrecognized operation type", ANNA_FILE_LOCATION); + throw anna::RuntimeException("Wrong body content format on HTTP Request. Use 'help' management command to see more information.", ANNA_FILE_LOCATION); } // HTTP response - response_content = "Operation processed; "; - - if((opType == "decode") || (opType == "code")) { - response_content += "File '"; - response_content += param2; - response_content += "' created."; - response_content += "\n"; - } else if((opType == "hide") || (opType == "show")) { - response_content += "Resource '"; - response_content += ((param1 != "") ? param1 : "Entity"); - - if(param2 != "") { - response_content += "|"; - response_content += param2; - } - - response_content += "' "; - - if(opType == "hide") response_content += "has been hidden."; - - if(opType == "show") response_content += "has been shown."; - - response_content += "\n"; - } else if((opType == "hidden") || (opType == "shown")) { - response_content += "Result: "; - response_content += result; - response_content += "\n"; - } else if((opType == "sendxml") || (opType == "sendxml2e") || (opType == "sendhex") || (opType == "sendhex2e")) { - response_content += "Message '"; - response_content += param1; - response_content += "' sent to entity."; - response_content += "\n"; - } else if(opType == "burst") { - response_content += "Burst '"; - response_content += param1; - response_content += "' executed. "; - response_content += result; - response_content += "\n"; - } else if((opType == "sendxml2c") || (opType == "sendhex2c")) { - response_content += "Message '"; - response_content += param1; - response_content += "' sent to client."; - response_content += "\n"; - } else if(opType == "loadxml") { - response_content += "Message '"; - response_content += param1; - response_content += "' loaded."; - response_content += "\n"; - } else if((opType == "answerxml") || (opType == "answerxml2c")) { - response_content += "'"; - response_content += param1; - response_content += "' applied on server FIFO queue"; - response_content += "\n"; - } else if(opType == "answerxml2e") { - response_content += "'"; - response_content += param1; - response_content += "' applied on client FIFO queue"; - response_content += "\n"; - } else if(opType == "diameterServerSessions") { - response_content += "Maximum server socket connections updated to '"; - response_content += param1; - response_content += "'."; - response_content += "\n"; - } + response_content = "Operation correctly processed: "; response_content += operation; response_content += " => "; + response_content += result_msg; } anna::xml::Node* Launcher::asXML(anna::xml::Node* parent) const @@ -1502,5 +1919,9 @@ throw() { anna::diameter::codec::OamModule::instantiate().asXML(result); // Statistics: anna::statistics::Engine::instantiate().asXML(result); + + // Testing: could be heavy if test case reports are enabled + TestManager::instantiate().asXML(result); + return result; }