Landing MultiNode.

pending merges:
  Neil Williams 2013-08-28 [merge] Fu Wei 2013-08-27 multinode review:Fix a bug about using 'printf'
    Fu Wei 2013-08-27 multinode review:Fix a bug about using 'printf'
    Fu Wei 2013-08-26 multinode review: make 'waiting message ack' be supported, only if the shell script is running in bash
    Fu Wei 2013-08-26 multinode review: delete some bash-specific syntax for multinode API shell scripts
    Neil Williams 2013-08-27 [merge] Neil Williams 2013-08-27 Fix LNG result bundle aggregation error with
    Neil Williams 2013-08-27 Fix LNG result bundle aggregation error with measurements.
    Neil Williams 2013-08-27 Merge from tip 657:
    Neil Williams 2013-08-24 [merge] Neil Williams 2013-08-23 Add debugging help page.
    Neil Williams 2013-08-23 Add debugging help page.
    Neil Williams 2013-08-23 Add details of how to use the API in the use case.
    Neil Williams 2013-08-23 Add hrefs and a section on installing packages.
    Neil Williams 2013-08-23 Add debugging page and section on balancing timeouts.
    Neil Williams 2013-08-23 Add internal hrefs to make it easier to link from examples.
    Neil Williams 2013-08-24 [merge] Neil Williams 2013-08-23 Add the stream parameter to the pending call so
    Neil Williams 2013-08-23 Add the stream parameter to the pending call so that it can be passed down to put_pending over xmlrpc.
    Neil Williams 2013-08-23 Add the stream parameter to the pending call so that it can be passed down to put_pending over xmlrpc.
    Neil Williams 2013-08-24 [merge] Neil Williams 2013-08-23 Drop PyCharm inspection comment.
    Neil Williams 2013-08-23 Drop PyCharm inspection comment.
    Neil Williams 2013-08-23 Set the context once in __init__ instead of each time in the handler.
    Neil Williams 2013-08-23 Set the context once in __init__ instead of each time in the handler.
    Neil Williams 2013-08-23 Drop PyCharm inspection comment.
    Neil Williams 2013-08-23 Move delay into a local function variable.
    Neil Williams 2013-08-23 [merge] Fu Wei 2013-08-23 Fix the bug of disabling debug info in multi-node API
    Fu Wei 2013-08-23 Fix the bug of disabling debug info in multi-node API shell scritps
    Neil Williams 2013-08-21 Apply missing changes from tip
    Neil Williams 2013-08-21 Apply missing change from tip
    Neil Williams 2013-08-21 remove files removed in tip
    Neil Williams 2013-08-21 Apply missing change from tip - retaining the update to allow iMX53 to work with updated dispatcher code.
    Neil Williams 2013-08-21 Apply missing change from tip
    Neil Williams 2013-08-20 [merge] Neil Williams 2013-08-19 Bump version in preparation for merge into tip.
    Neil Williams 2013-08-19 Bump version in preparation for merge into tip.
    Neil Williams 2013-08-19 Add two use cases covering steps from requirements to LAVA filtering of results.
    Neil Williams 2013-08-20 Output an error message if the bundle could not be parsed.
    Neil Williams 2013-08-16 [merge] Fu Wei 2013-08-16 Fix the disappearance of the result bundle link in the
    Fu Wei 2013-08-16 Fix the disappearance of the result bundle link in the log_file page problem for multinode
    Neil Williams 2013-08-15 [merge] Neil Williams 2013-08-12 Update multinode branch from tip
    Neil Williams 2013-08-12 Update multinode branch from tip
    Neil Williams 2013-08-12 [merge] Neil Williams 2013-08-09 Trim the debug output.
    Neil Williams 2013-08-12 [merge] Neil Williams 2013-08-08 Expand the notes to cover the persistence of me...
    Neil Williams 2013-08-12 [merge] Neil Williams 2013-08-06 Fix wait-all - needs lava-coordiantor 0.1.3
    Neil Williams 2013-08-12 [merge] Neil Williams 2013-08-05 Trim debug messages and reduce the size limit to
    Neil Williams 2013-08-15 [merge] Neil Williams 2013-08-09 Trim the debug output.
    Neil Williams 2013-08-09 Trim the debug output.
    Neil Williams 2013-08-09 Trim the debug output and make the formats consistent.
    Neil Williams 2013-08-09 [merge] Neil Williams 2013-08-06 Fix wait-all - needs lava-coordiantor 0.1.3
    Neil Williams 2013-08-09 [merge] Neil Williams 2013-08-05 Trim debug messages and reduce the size limit to
    Neil Williams 2013-08-15 [merge] Neil Williams 2013-08-08 Expand the notes to cover the persistence of
    Neil Williams 2013-08-08 Expand the notes to cover the persistence of message data.
    Neil Williams 2013-08-15 [merge] Neil Williams 2013-08-06 Fix wait-all - needs lava-coordiantor 0.1.3
    Neil Williams 2013-08-06 Fix wait-all - needs lava-coordiantor 0.1.3
    Neil Williams 2013-08-06 [merge] Neil Williams 2013-08-05 Trim debug messages and reduce the size limit to
    Neil Williams 2013-08-15 [merge] Neil Williams 2013-08-05 Trim debug messages and reduce the size limit to
    Neil Williams 2013-08-05 Trim debug messages and reduce the size limit to
    Neil Williams 2013-08-05 Result bundle aggregation support.
    Neil Williams 2013-08-05 Result bundle aggregation support via XMLRPC to avoid
    Neil Williams 2013-08-05 Drop debug message.
    Neil Williams 2013-08-01 [merge] Neil Williams 2013-08-01 Retrieve the individual bundles, let the coordinator
    Neil Williams 2013-08-01 Retrieve the individual bundles, let the coordinator 
    Neil Williams 2013-08-01 Split up the run subroutine to allow the bundles to be collated
    Neil Williams 2013-08-01 Support bundle aggregation and trim the debug output to
    Neil Williams 2013-08-01 [merge] Fu Wei 2013-08-01 Fix the bugs of the error code(nack) processing in lava
    Fu Wei 2013-08-01 Fix the bugs of the error code(nack) processing in  lava multi-node API
    Neil Williams 2013-08-01 [merge] Neil Williams 2013-07-30 Add a note to the docs that the API is not intended
    Neil Williams 2013-07-30 Add a note to the docs that the API is not intended for large messages or file transfers.
    Neil Williams 2013-08-01 [merge] Fu Wei 2013-07-31 fix lava-sync bug for message delivery
    Fu Wei 2013-07-31 fix lava-sync bug for message delivery
    Neil Williams 2013-07-31 [merge] Fu Wei 2013-07-31 Add basic error code(nack) processing support into lava multi-node API
    Fu Wei 2013-07-31 Add basic error code(nack) processing support into lava multi-node API
    Neil Williams 2013-07-29 [merge] Fu Wei 2013-07-29 Add lava-network support for multi-node test
    Fu Wei 2013-07-29 Add lava-network support for multi-node test
    Neil Williams 2013-07-29 [merge] Neil Williams 2013-07-26 Implement a length-prefix for the communication
    Neil Williams 2013-07-26 Implement a length-prefix for the communication protocol
    Neil Williams 2013-07-26 [merge] Neil Williams 2013-07-24 Pass the return value back to signals for processing.
    Neil Williams 2013-07-26 [merge] Neil Williams 2013-07-23 Drop the old groupdispatcher setup, now external in lava-coordinator.
    Neil Williams 2013-07-29 [merge] Neil Williams 2013-07-24 Pass the return value back to signals for processing
    Neil Williams 2013-07-24 Pass the return value back to signals for processing.
    Neil Williams 2013-07-24 Return a value on a "nack" message so that the job can be failed on certain MultiNode calls.
    Neil Williams 2013-07-24 Implement timeout support inside the NodeDispatcher
    Neil Williams 2013-07-24 Add notes on multinode timeout behaviour.
    Neil Williams 2013-07-24 [merge] Neil Williams 2013-07-23 Drop the old groupdispatcher setup, now external in lava-coordinator.
    Neil Williams 2013-07-29 [merge] Neil Williams 2013-07-23 Drop the old groupdispatcher setup, now external
    Neil Williams 2013-07-23 Drop the old groupdispatcher setup, now external in lava-coordinator.
    Neil Williams 2013-07-23 Adapt to an external LAVA coordinator, read the
    Neil Williams 2013-07-23 Move the group dispatcher runtime into a separate daemon process.
    Neil Williams 2013-07-23 Introduce LAVA coordinator and document some requirements.
    Neil Williams 2013-07-22 [merge] Neil Williams 2013-07-18 Fix blocksize issue which was truncating long
    Neil Williams 2013-07-18 Fix blocksize issue which was truncating long messages.
    Neil Williams 2013-07-18 Fix blocksize issue which was truncating long messages.
    Neil Williams 2013-07-18 Fix the iMX53 config to update to tip behaviour.
    Neil Williams 2013-07-18 Fix calculation of the number of key=value pairs in the debug output.
    Neil Williams 2013-07-22 [merge] Neil Williams 2013-07-18 Add documentation and advice on the hardware
    Neil Williams 2013-07-18 Add documentation and advice on the hardware requirements of a MultiNode instance.
    Neil Williams 2013-07-18 Add nice calls to external processes which cause a lot of load to reduce the implications of MultiNode on simultaneous I/O.
    Neil Williams 2013-07-18 [merge] Bring shared multinode branch into line with tip.
    Neil Williams 2013-07-18 [merge] Neil Williams 2013-07-17 Remaining PEP8 changes to match tip
    Neil Williams 2013-07-17 Remaining PEP8 changes to match tip
    Neil Williams 2013-07-18 Add change described in the merge proposal comments - make the equivalent change in wait as was made in wait_all
    Neil Williams 2013-07-18 [merge] Neil Williams 2013-07-14 Relocate the work to handle key value pair information into the send function instead of wait_all
    Neil Williams 2013-07-14 Relocate the work to handle key value pair information into the send function instead of wait_all so that the work can be done in a simpler way without n...
    Neil Williams 2013-07-14 [merge] Fu Wei 2013-07-10 Fix return message format problem of lava-wait-all
    Fu Wei 2013-07-10 Fix return message format problem of lava-wait-all
    Neil Williams 2013-07-10 [merge] Neil Williams 2013-07-05 fix wait_all behaviour for the fixed message structure.
    Neil Williams 2013-07-05 fix wait_all behaviour for the fixed message structure.
    Neil Williams 2013-07-05 Collate all of the data for all devices in this role and
    Neil Williams 2013-07-03 Debug tweaks
    Neil Williams 2013-07-03 Deepcopy the message for each client with the same role
    Neil Williams 2013-07-03 [merge] Fu Wei 2013-07-03 Fix return message format problem of lava-wait and do some prepare for lava-wait-all
    Fu Wei 2013-07-03 Fix return message format problem of lava-wait and do some prepare for lava-wait-all
    Neil Williams 2013-07-03 [merge] There are no changes in the device-types files, it's just an artefact
    Neil Williams 2013-07-03 [merge] Neil Williams 2013-07-03 fix wait_all to send wait_all instead of wait when using a role.
    Neil Williams 2013-07-03 Adjust debug messages
    Neil Williams 2013-07-03 Move debug message out of info log
    Neil Williams 2013-07-03 Drop twisted from requirements, no longer used.
    Neil Williams 2013-07-03 Bring branch into line with multinode and tip
    Neil Williams 2013-07-03 fix wait_all to send wait_all instead of wait when using a role.
    Neil Williams 2013-07-03 Adopt Fu Wei's change, already merged
    Neil Williams 2013-07-03 fix false notification of a MultiNode test due to broken insertion of the logging check inside an existing conditional block.
    Neil Williams 2013-07-02 bring my personal branch into line with shared branch - including the multi-node shell lib.
    Neil Williams 2013-07-02 bring my personal branch into line with shared branch.
    Neil Williams 2013-07-03 [merge] Neil Williams 2013-07-03 fix wait_all to send wait_all instead of wait when using a role.
    Neil Williams 2013-07-03 fix wait_all to send wait_all instead of wait when using a role.
    Neil Williams 2013-07-02 Reduce the timeout to a sane level for the task of starting the bootloader.
    Neil Williams 2013-07-02 Ensure lava_wait sends a useful messageID
    Neil Williams 2013-07-02 Add note about making lava_wait_all and lava_send calls consistent.
    Neil Williams 2013-07-03 [merge] Senthil Kumaran 2013-07-03 [merge] Bring up-to-date with trunk.
    Senthil Kumaran 2013-07-03 [merge] Bring up-to-date with trunk.
    Neil Williams 2013-07-03 [merge] Fu Wei 2013-07-03 Fix a bug in getting info from job_data(job type detection)
    Fu Wei 2013-07-03 Fix a bug in getting info from job_data(job type detection)
    Neil Williams 2013-07-02 [merge] Fu Wei 2013-07-02 Do some modification in Multi-Node API specification for lava-wait*
    Fu Wei 2013-07-02 Do some modification in Multi-Node API specification for lava-wait*
    Fu Wei 2013-07-02 Fix the lava-wait* API Shell script problem
    Fu Wei 2013-07-02 Improve LAVA Multi-Node API shell script debug output
    Neil Williams 2013-07-02 [merge] Neil Williams 2013-07-01 Write out the return value into the output of the request.
    Neil Williams 2013-07-01 Write out the return value into the output of the request.
    Neil Williams 2013-07-01 Pass the return value of each request up the chain 
    Neil Williams 2013-07-01 Expand the code to make the debug clearer.
    Neil Williams 2013-07-01 Ensure GroupDispatcher continues running if 
    Neil Williams 2013-06-28 Fix the group_data handling to write out data on all members of the group.
    Neil Williams 2013-06-28 Pass the group data to the test shell using the context.
    Neil Williams 2013-06-28 Allow the context to carry arbitrary group data for MultiNode.
    Neil Williams 2013-06-28 Handle the group_data response and pass it down to the Job.
    Neil Williams 2013-06-28 Send the group_data back instead of an Ack
    Neil Williams 2013-07-01 [merge] Neil Williams 2013-06-28 Add docs on the changes to the JSON for Multi-Node submissions
    Neil Williams 2013-06-28 Add docs on the changes to the JSON for Multi-Node submissions
    Neil Williams 2013-06-28 [merge] Neil Williams 2013-06-28 Add docs on the changes to the JSON for Multi-Node submissions
    Neil Williams 2013-06-28 Add docs on the changes to the JSON for Multi-Node submissions
    Neil Williams 2013-06-27 allow the message to be passed unchanged as it can be more than a simple string.
    Neil Williams 2013-06-27 Fix typo in type used with append.
    Neil Williams 2013-06-27 Add handling for the key=value pairs used by lavaSend
    Neil Williams 2013-06-27 [merge] Neil Williams 2013-06-27 Make the handlers compliant with the MultiNode API, on_WAIT does not take a message and on_WAIT_ALL takes an optional ro...
    Neil Williams 2013-06-27 Make the handlers compliant with the MultiNode API, on_WAIT does not take a message and on_WAIT_ALL takes an optional role parameter.
    Neil Williams 2013-06-27 simplify the node polling delay step
    Neil Williams 2013-06-27 [merge] Neil Williams 2013-06-27 Cache the current connection inside the GeneratorContextManager instead of trying to start another one.
    Neil Williams 2013-06-27 Cache the current connection inside the GeneratorContextManager instead of trying to start another one. Fixes problem with calling power_on inside the _o...
    Neil Williams 2013-06-27 make the debug more helpful
    Neil Williams 2013-06-27 [merge] Senthil Kumaran 2013-06-27 [merge] Bring up-to-date with trunk.
    Senthil Kumaran 2013-06-27 [merge] Bring up-to-date with trunk.
    Neil Williams 2013-06-26 [merge] Merge the debug change branch
    Neil Williams 2013-06-26 Fix missing handdown of the context to the test shell.
    Neil Williams 2013-06-26 Add echo statements to follow the sequence within
    Neil Williams 2013-06-26 Add echo statements to follow the sequence within
    Neil Williams 2013-06-26 Add debug for the number of bytes written.
    Neil Williams 2013-06-26 Add logging for the test shell results
    Neil Williams 2013-06-26 Finalise the debug statements at usable levels.
    Neil Williams 2013-06-26 Clean up the debug statements
    Neil Williams 2013-06-26 [merge] merge the node-board comms branch.
    Neil Williams 2013-06-25 Add the rest of the primitives for Node-board comms by extending LavaContext to carry to callable transport object
    Neil Williams 2013-06-25 fix the lavaSync code to clear sync data when all clients have had their sync message.
    Neil Williams 2013-06-26 [merge] Apply Fu Wei's branch merge
    Fu Wei 2013-06-26 improve Multi-Node API Shell script
    Neil Williams 2013-06-25 [merge] merge branch to fix signal handler error.
    Fu Wei 2013-06-25 fix a bug for handle multi-node signals
    Neil Williams 2013-06-25 [merge] merge branch to add role to actions
    Senthil Kumaran 2013-06-25 Add role to each action parameter schema.
    Neil Williams 2013-06-25 [merge] merge branch
    Fu Wei 2013-06-25 improve LAVA Multi-Node API message patterns, add message handle framework in dispatcher side
    Neil Williams 2013-06-25 [merge] merge the bug fix branch.
    Neil Williams 2013-06-24 target_group no longer contains sub-fields, target and role are discrete values and hostname is actually target.hostname in the incoming data.
    Neil Williams 2013-06-24 group_size is an integer in the schema but must be a string inside the attributes, so convert it.
    Neil Williams 2013-06-24 clarify the JSON structure for messages
    Neil Williams 2013-06-24 [merge] merge bug fixes for lava_test_shell.py
    Neil Williams 2013-06-24 Fix syntax errors in lava_test_shell.py and make the sample transport message valid for the receiver.
    Neil Williams 2013-06-24 [merge] Fu Wei 2013-06-21 add multi-node API shell script file and API file injection support
    Fu Wei 2013-06-21 add multi-node API shell script file and API file injection support
    Neil Williams 2013-06-24 [merge] merge codehelp branch to migrate from twisted
    Neil Williams 2013-06-21 Migrate from twisted to re-usable sockets via polling. Ensure all socket calls are locally scoped and refreshed every time through the loop to allow reco...
    Neil Williams 2013-06-21 fix typo in the job schema for group_size
    Neil Williams 2013-06-20 [merge] Apply the merge
    Neil Williams 2013-06-20 Add the LavaTestJob run code into NodeDispatcher so that the job runs inside the client reactor. Pass the necessary data down and allow the LavaContext t...
    Neil Williams 2013-06-20 Handle exceptions due to empty or non-JSON data being received by the GroupDispatcher.
    Neil Williams 2013-06-20 Update requirements due to MultiNode comms.
    Neil Williams 2013-06-20 Add twisted to setup.py for installation requirements due to MultiNode comms.
    Neil Williams 2013-06-20 [merge] Merge stylesen's branch for the job schema in multinode
    Senthil Kumaran 2013-06-20 Add device_group to job schema.
    Neil Williams 2013-06-18 [merge] Apply changes from trunk by Antonio Terceiro
    Neil Williams 2013-06-18 allow group_dispatcher and target_group to setup a MultiNode dispatcher
    Neil Williams 2013-06-18 Allow nodes to self-register with the GroupDispatcher
    Neil Williams 2013-06-18 Add group_size support
    Neil Williams 2013-06-12 Add support for the current MultiNode API
    Neil Williams 2013-06-12 fix typo
    Neil Williams 2013-06-12 Add Antonio's Multinode API to the docs.
    Neil Williams 2013-06-12 Add hostname to the group_data and add a lava_sync primitive
    Neil Williams 2013-06-11 Add MultiNode support classes: GroupDispatcher and NodeDispatcher. Define added fields in the job schema.