Warning this a draft !

Aditam Agent/Server Protocol

We are using NetstringReceiver to implement that protocol. The parameters must be uri encoded like this : http://www.w3schools.com/jsref/jsref_encodeURI.asp For example in Python 2.x:

import urllib

my_encoded_string = urllib.quote(u"a simple test", ",/?:@&=+$#.")

New agent

• Agent send :

  string_length:newagent agent_name os_name,\r\n
  

New command

• Server send

  string_length:cmd job_id cmd_id :the command,\r\n
  

Command is over

• Agent send

  string_length:cmdover job_id cmd_id state return_value stdout stderr,\r\n
  

Ping

• Server send :

  string_length:ping,\r\n
  

• Agent reply :

  string-length:pong,\r\n
  

Errors

• Bad command

  string_length:1,\r\n
  

• Bad parameter

  string_length:2,\r\n
  

• Command queue is full

  string_length:3,\r\n