sfa/senslab/OARrestapi.py

   1 #import sys
   2 from httplib import HTTPConnection, HTTPException
   3 import json
   4 #import datetime
   5 #from time import gmtime, strftime
   6
   7 #import urllib
   8 #import urllib2
   9 from sfa.util.config import Config
  10 from sfa.planetlab.plxrn import PlXrn
  11 #from sfa.util.xrn import hrn_to_urn, get_authority, Xrn, get_leaf
  12
  13 from sfa.util.sfalogging import logger
  14
  15
  16 OARIP = '194.199.16.161'
  17
  18 OAR_REQUEST_POST_URI_DICT = {'POST_job':{'uri': '/oarapi/jobs.json'},
  19                             'DELETE_jobs_id':{'uri':'/oarapi/jobs/id.json'},
  20                             }
  21
  22 POST_FORMAT = {'json' : {'content':"application/json", 'object':json},}
  23
  24 #OARpostdatareqfields = {'resource' :"/nodes=", 'command':"sleep", \
  25                         #'workdir':"/home/", 'walltime':""}
  26
  27
  28
  29
  30
  31 class OARrestapi:
  32     def __init__(self):
  33         self.oarserver = {}
  34         self.oarserver['ip'] = OARIP
  35         self.oarserver['port'] = 8800
  36         self.oarserver['uri'] = None
  37         self.oarserver['postformat'] = 'json'
  38         #logger.setLevelDebug()
  39
  40         self.jobstates  = ['Terminated', 'Hold', 'Waiting', 'toLaunch', \
  41                             'toError', 'toAckReservation', 'Launching', \
  42                             'Finishing', 'Running', 'Suspended', 'Resuming',\
  43                             'Error']
  44
  45         self.parser = OARGETParser(self)
  46
  47
  48     def GETRequestToOARRestAPI(self, request, strval=None , username = None ):
  49         self.oarserver['uri'] = \
  50                             OARGETParser.OARrequests_uri_dict[request]['uri']
  51         headers = {}
  52         data = json.dumps({})
  53         logger.debug("OARrestapi \tGETRequestToOARRestAPI %s" %(request))
  54         if strval:
  55             self.oarserver['uri'] = self.oarserver['uri'].\
  56                                             replace("id",str(strval))
  57             logger.debug("OARrestapi: \t  GETRequestToOARRestAPI  \
  58                             self.oarserver['uri'] %s strval %s" \
  59                             %(self.oarserver['uri'], strval))
  60         if username:
  61             headers['X-REMOTE_IDENT'] = username
  62         try :
  63             #seems that it does not work if we don't add this
  64             headers['content-length'] = '0'
  65
  66             conn = HTTPConnection(self.oarserver['ip'], \
  67                                                 self.oarserver['port'])
  68             conn.request("GET", self.oarserver['uri'], data, headers)
  69             resp = ( conn.getresponse()).read()
  70             conn.close()
  71         except HTTPException, error :
  72             logger.log_exc("GET_OAR_SRVR : Problem with OAR server : %s " \
  73                                                                     %(error))
  74             #raise ServerError("GET_OAR_SRVR : Could not reach OARserver")
  75         try:
  76             js_dict = json.loads(resp)
  77             return js_dict
  78
  79         except ValueError, error:
  80             logger.log_exc("Failed to parse Server Response: %s ERROR %s"\
  81                                                             %(js_dict, error))
  82             #raise ServerError("Failed to parse Server Response:" + js)
  83
  84
  85     def POSTRequestToOARRestAPI(self, request, datadict, username=None):
  86         """ Used to post a job on OAR , along with data associated
  87         with the job.
  88
  89         """
  90
  91         #first check that all params for are OK
  92         try:
  93             self.oarserver['uri'] = OAR_REQUEST_POST_URI_DICT[request]['uri']
  94
  95         except KeyError:
  96             logger.log_exc("OARrestapi \tPOSTRequestToOARRestAPI request not \
  97                              valid")
  98             return
  99         #try:
 100         if datadict and 'strval' in datadict:
 101             self.oarserver['uri'] = self.oarserver['uri'].replace("id", \
 102                                                 str(datadict['strval']))
 103             del datadict['strval']
 104         #except:
 105             #logger.log_exc("OARrestapi.py POSTRequestToOARRestAPI Error")
 106             return
 107
 108         data = json.dumps(datadict)
 109         headers = {'X-REMOTE_IDENT':username, \
 110                 'content-type': POST_FORMAT['json']['content'], \
 111                 'content-length':str(len(data))}
 112         try :
 113
 114             conn = HTTPConnection(self.oarserver['ip'], \
 115                                         self.oarserver['port'])
 116             conn.request("POST", self.oarserver['uri'], data, headers)
 117             resp = (conn.getresponse()).read()
 118             conn.close()
 119         except NotConnected:
 120             logger.log_exc("POSTRequestToOARRestAPI NotConnected ERROR: \
 121                             data %s \r\n \t\n \t\t headers %s uri %s" \
 122                             %(data,headers,self.oarserver['uri']))
 123
 124             #raise ServerError("POST_OAR_SRVR : error")
 125
 126         try:
 127             answer = json.loads(resp)
 128             logger.debug("POSTRequestToOARRestAPI : answer %s" %(answer))
 129             return answer
 130
 131         except ValueError, error:
 132             logger.log_exc("Failed to parse Server Response: error %s answer \
 133                             %s" %(error, answer))
 134             #raise ServerError("Failed to parse Server Response:" + answer)
 135
 136
 137
 138 def AddOarNodeId(tuplelist, value):
 139     """ Adds Oar internal node id to the nodes attributes """
 140
 141     tuplelist.append(('oar_id', int(value)))
 142
 143
 144 def AddNodeNetworkAddr(dictnode, value):
 145     #Inserts new key. The value associated is a tuple list
 146     node_id = value
 147
 148     dictnode[node_id] = [('node_id', node_id),('hostname', node_id) ]
 149
 150     return node_id
 151
 152 def AddNodeSite(tuplelist, value):
 153     tuplelist.append(('site', str(value)))
 154
 155 def AddNodeRadio(tuplelist, value):
 156     tuplelist.append(('radio', str(value)))
 157
 158
 159 def AddMobility(tuplelist, value):
 160     if value :
 161         tuplelist.append(('mobile', int(value)))
 162
 163 def AddPosX(tuplelist, value):
 164     tuplelist.append(('posx', value))
 165
 166 def AddPosY(tuplelist, value):
 167     tuplelist.append(('posy', value))
 168
 169 def AddPosZ(tuplelist, value):
 170     tuplelist.append(('posz', value))
 171
 172 def AddBootState(tuplelist, value):
 173     tuplelist.append(('boot_state', str(value)))
 174
 175 #Insert a new node into the dictnode dictionary
 176 def AddNodeId(dictnode, value):
 177     #Inserts new key. The value associated is a tuple list
 178     node_id = int(value)
 179
 180     dictnode[node_id] = [('node_id', node_id)]
 181     return node_id
 182
 183 def AddHardwareType(tuplelist, value):
 184     value_list = value.split(':')
 185     tuplelist.append(('archi', value_list[0]))
 186     tuplelist.append(('radio', value_list[1]))
 187
 188
 189 class OARGETParser:
 190     resources_fulljson_dict = {
 191         'network_address' : AddNodeNetworkAddr,
 192         'site': AddNodeSite,
 193         'radio': AddNodeRadio,
 194         'mobile': AddMobility,
 195         'x': AddPosX,
 196         'y': AddPosY,
 197         'z':AddPosZ,
 198         'archi':AddHardwareType,
 199         'state':AddBootState,
 200         'id' : AddOarNodeId,
 201         }
 202
 203
 204     def __init__(self, srv) :
 205         self.version_json_dict = {
 206             'api_version' : None , 'apilib_version' :None,\
 207             'api_timezone': None, 'api_timestamp': None, 'oar_version': None ,}
 208         self.config = Config()
 209         self.interface_hrn = self.config.SFA_INTERFACE_HRN
 210         self.timezone_json_dict = {
 211             'timezone': None, 'api_timestamp': None, }
 212         self.jobs_json_dict = {
 213             'total' : None, 'links' : [],\
 214             'offset':None , 'items' : [], }
 215         self.jobs_table_json_dict = self.jobs_json_dict
 216         self.jobs_details_json_dict = self.jobs_json_dict
 217         self.server = srv
 218         self.node_dictlist = {}
 219         self.raw_json = None
 220         self.site_dict = {}
 221         self.SendRequest("GET_version")
 222
 223
 224
 225
 226
 227     def ParseVersion(self) :
 228         #print self.raw_json
 229         #print >>sys.stderr, self.raw_json
 230         if 'oar_version' in self.raw_json :
 231             self.version_json_dict.update(api_version = \
 232                                                 self.raw_json['api_version'],
 233                             apilib_version = self.raw_json['apilib_version'],
 234                             api_timezone = self.raw_json['api_timezone'],
 235                             api_timestamp = self.raw_json['api_timestamp'],
 236                             oar_version = self.raw_json['oar_version'] )
 237         else :
 238             self.version_json_dict.update(api_version = self.raw_json['api'] ,
 239                             apilib_version = self.raw_json['apilib'],
 240                             api_timezone = self.raw_json['api_timezone'],
 241                             api_timestamp = self.raw_json['api_timestamp'],
 242                             oar_version = self.raw_json['oar'] )
 243
 244         print self.version_json_dict['apilib_version']
 245
 246
 247     def ParseTimezone(self) :
 248         api_timestamp = self.raw_json['api_timestamp']
 249         api_tz = self.raw_json['timezone']
 250         return api_timestamp, api_tz
 251
 252     def ParseJobs(self) :
 253         self.jobs_list = []
 254         print " ParseJobs "
 255         return self.raw_json
 256
 257     def ParseJobsTable(self) :
 258         print "ParseJobsTable"
 259
 260     def ParseJobsDetails (self):
 261         # currently, this function is not used a lot,
 262         #so i have no idea what be usefull to parse,
 263         #returning the full json. NT
 264         logger.debug("ParseJobsDetails %s " %(self.raw_json))
 265         return self.raw_json
 266
 267
 268     def ParseJobsIds(self):
 269
 270         job_resources = ['wanted_resources', 'name', 'id', 'start_time', \
 271                         'state','owner','walltime','message']
 272
 273
 274         job_resources_full = ['launching_directory', 'links', \
 275             'resubmit_job_id', 'owner', 'events', 'message', \
 276             'scheduled_start', 'id', 'array_id',  'exit_code', \
 277             'properties', 'state','array_index', 'walltime', \
 278             'type', 'initial_request', 'stop_time', 'project',\
 279             'start_time',  'dependencies','api_timestamp','submission_time', \
 280             'reservation', 'stdout_file', 'types', 'cpuset_name', \
 281             'name',  'wanted_resources','queue','stderr_file','command']
 282
 283
 284         job_info = self.raw_json
 285         logger.debug("OARESTAPI ParseJobsIds %s" %(self.raw_json))
 286         values = []
 287         try:
 288             for k in job_resources:
 289                 values.append(job_info[k])
 290             return dict(zip(job_resources, values))
 291
 292         except KeyError:
 293             logger.log_exc("ParseJobsIds KeyError ")
 294
 295
 296     def ParseJobsIdResources(self):
 297         """ Parses the json produced by the request
 298         /oarapi/jobs/id/resources.json.
 299         Returns a list of oar node ids that are scheduled for the
 300         given job id.
 301
 302         """
 303         job_resources = []
 304         for resource in self.raw_json['items']:
 305             job_resources.append(resource['id'])
 306
 307         logger.debug("OARESTAPI \tParseJobsIdResources %s" %(self.raw_json))
 308         return job_resources
 309
 310     def ParseResources(self) :
 311         """ Parses the json produced by a get_resources request on oar."""
 312
 313         logger.debug("OARESTAPI \tParseResources " )
 314         #resources are listed inside the 'items' list from the json
 315         self.raw_json = self.raw_json['items']
 316         self.ParseNodes()
 317
 318     def ParseReservedNodes(self):
 319         """  Returns an array containing the list of the reserved nodes """
 320
 321         #resources are listed inside the 'items' list from the json
 322         reservation_list = []
 323         print "ParseReservedNodes_%s" %(self.raw_json['items'])
 324         job = {}
 325         #Parse resources info
 326         for json_element in  self.raw_json['items']:
 327             job['t_from'] = json_element['scheduled_start']
 328             #Get resources id list for the job
 329             job['resource_ids'] = \
 330                 [ node_dict['id'] for node_dict in json_element['resources'] ]
 331
 332             job['state'] = json_element['state']
 333             job['lease_id'] = json_element['id']
 334             job['t_until'] = json_element['scheduled_start'] + \
 335                                                     json_element['walltime']
 336             job['user'] = json_element['owner']
 337             logger.debug("OARRestapi \tParseReservedNodes job %s" %(job))
 338             reservation_list.append(job)
 339             #reset dict
 340             job = {}
 341         return reservation_list
 342
 343     def ParseRunningJobs(self):
 344         """ Gets the list of nodes currently in use from the attributes of the
 345         running jobs.
 346
 347         """
 348         logger.debug("OARESTAPI \tParseRunningJobs__________________________ ")
 349         #resources are listed inside the 'items' list from the json
 350         nodes = []
 351         for job in  self.raw_json['items']:
 352             for node in job['nodes']:
 353                 nodes.append(node['network_address'])
 354         return nodes
 355
 356
 357
 358     def ParseDeleteJobs(self):
 359         """ No need to parse anything in this function.A POST
 360         is done to delete the job.
 361
 362         """
 363         return
 364
 365     def ParseResourcesFull(self) :
 366         """ This method is responsible for parsing all the attributes
 367         of all the nodes returned by OAR when issuing a get resources full.
 368         The information from the nodes and the sites are separated.
 369         Updates the node_dictlist so that the dictionnary of the platform's
 370         nodes is available afterwards.
 371
 372         """
 373         logger.debug("OARRESTAPI ParseResourcesFull________________________ ")
 374         #print self.raw_json[1]
 375         #resources are listed inside the 'items' list from the json
 376         if self.version_json_dict['apilib_version'] != "0.2.10" :
 377             self.raw_json = self.raw_json['items']
 378         self.ParseNodes()
 379         self.ParseSites()
 380         return self.node_dictlist
 381
 382     def ParseResourcesFullSites(self) :
 383         """ UNUSED. Originally used to get information from the sites.
 384         ParseResourcesFull is used instead.
 385
 386         """
 387         if self.version_json_dict['apilib_version'] != "0.2.10" :
 388             self.raw_json = self.raw_json['items']
 389         self.ParseNodes()
 390         self.ParseSites()
 391         return self.site_dict
 392
 393
 394
 395     def ParseNodes(self):
 396         """ Parse nodes properties from OAR
 397         Put them into a dictionary with key = node id and value is a dictionary
 398         of the node properties and properties'values.
 399
 400         """
 401         node_id = None
 402         keys = self.resources_fulljson_dict.keys()
 403         keys.sort()
 404
 405         for dictline in self.raw_json:
 406             node_id = None
 407             # dictionary is empty and/or a new node has to be inserted
 408             node_id = self.resources_fulljson_dict['network_address'](\
 409                                 self.node_dictlist, dictline['network_address'])
 410             for k in keys:
 411                 if k in dictline:
 412                     if k == 'network_address':
 413                         continue
 414
 415                     self.resources_fulljson_dict[k](\
 416                                     self.node_dictlist[node_id], dictline[k])
 417
 418             #The last property has been inserted in the property tuple list,
 419             #reset node_id
 420             #Turn the property tuple list (=dict value) into a dictionary
 421             self.node_dictlist[node_id] = dict(self.node_dictlist[node_id])
 422             node_id = None
 423
 424
 425     def hostname_to_hrn(self, root_auth, login_base, hostname):
 426         return PlXrn(auth = root_auth, \
 427                              hostname = login_base + '_' + hostname).get_hrn()
 428
 429
 430     def ParseSites(self):
 431         """ Returns a list of dictionnaries containing the sites' attributes."""
 432
 433         nodes_per_site = {}
 434         config = Config()
 435         logger.debug(" OARrestapi.py \tParseSites  self.node_dictlist %s"\
 436                                                         %(self.node_dictlist))
 437         # Create a list of nodes per site_id
 438         for node_id in self.node_dictlist.keys():
 439             node  = self.node_dictlist[node_id]
 440
 441             if node['site'] not in nodes_per_site:
 442                 nodes_per_site[node['site']] = []
 443                 nodes_per_site[node['site']].append(node['node_id'])
 444             else:
 445                 if node['node_id'] not in nodes_per_site[node['site']]:
 446                     nodes_per_site[node['site']].append(node['node_id'])
 447
 448         #Create a site dictionary with key is site_login_base (name of the site)
 449         # and value is a dictionary of properties, including the list
 450         #of the node_ids
 451         for node_id in self.node_dictlist.keys():
 452             node  = self.node_dictlist[node_id]
 453             node.update({'hrn':self.hostname_to_hrn(self.interface_hrn, \
 454                                             node['site'],node['hostname'])})
 455
 456             self.node_dictlist.update({node_id:node})
 457
 458             if node['site'] not in self.site_dict:
 459                 self.site_dict[node['site']] = {
 460                     'site':node['site'],
 461                     'node_ids':nodes_per_site[node['site']],
 462                     'latitude':"48.83726",
 463                     'longitude':"- 2.10336",'name':config.SFA_REGISTRY_ROOT_AUTH,
 464                     'pcu_ids':[], 'max_slices':None, 'ext_consortium_id':None,
 465                     'max_slivers':None, 'is_public':True, 'peer_site_id': None,
 466                     'abbreviated_name':"senslab", 'address_ids': [],
 467                     'url':"http,//www.senslab.info", 'person_ids':[],
 468                     'site_tag_ids':[], 'enabled': True,  'slice_ids':[],
 469                     'date_created': None, 'peer_id': None }
 470             #if node['site_login_base'] not in self.site_dict.keys():
 471                 #self.site_dict[node['site_login_base']] = {'login_base':node['site_login_base'],
 472                                                         #'node_ids':nodes_per_site[node['site_login_base']],
 473                                                         #'latitude':"48.83726",
 474                                                         #'longitude':"- 2.10336",'name':"senslab",
 475                                                         #'pcu_ids':[], 'max_slices':None, 'ext_consortium_id':None,
 476                                                         #'max_slivers':None, 'is_public':True, 'peer_site_id': None,
 477                                                         #'abbreviated_name':"senslab", 'address_ids': [],
 478                                                         #'url':"http,//www.senslab.info", 'person_ids':[],
 479                                                         #'site_tag_ids':[], 'enabled': True,  'slice_ids':[],
 480                                                         #'date_created': None, 'peer_id': None }
 481
 482
 483
 484
 485     OARrequests_uri_dict = {
 486         'GET_version':
 487                 {'uri':'/oarapi/version.json', 'parse_func': ParseVersion},
 488         'GET_timezone':
 489                 {'uri':'/oarapi/timezone.json' ,'parse_func': ParseTimezone },
 490         'GET_jobs':
 491                 {'uri':'/oarapi/jobs.json','parse_func': ParseJobs},
 492         'GET_jobs_id':
 493                 {'uri':'/oarapi/jobs/id.json','parse_func': ParseJobsIds},
 494         'GET_jobs_id_resources':
 495                 {'uri':'/oarapi/jobs/id/resources.json',\
 496                 'parse_func': ParseJobsIdResources},
 497         'GET_jobs_table':
 498                 {'uri':'/oarapi/jobs/table.json','parse_func': ParseJobsTable},
 499         'GET_jobs_details':
 500                 {'uri':'/oarapi/jobs/details.json',\
 501                 'parse_func': ParseJobsDetails},
 502         'GET_reserved_nodes':
 503                 {'uri':
 504                 '/oarapi/jobs/details.json?state=Running,Waiting,Launching',\
 505                 'parse_func':ParseReservedNodes},
 506         'GET_running_jobs':
 507                 {'uri':'/oarapi/jobs/details.json?state=Running',\
 508                 'parse_func':ParseRunningJobs},
 509         'GET_resources_full':
 510                 {'uri':'/oarapi/resources/full.json',\
 511                 'parse_func': ParseResourcesFull},
 512         'GET_sites':
 513                 {'uri':'/oarapi/resources/full.json',\
 514                 'parse_func': ParseResourcesFullSites},
 515         'GET_resources':
 516                 {'uri':'/oarapi/resources.json' ,'parse_func': ParseResources},
 517         'DELETE_jobs_id':
 518                 {'uri':'/oarapi/jobs/id.json' ,'parse_func': ParseDeleteJobs}
 519         }
 520
 521
 522
 523     def SendRequest(self, request, strval = None , username = None):
 524         """ Connects to OAR , sends the valid GET requests and uses
 525         the appropriate json parsing functions.
 526
 527         """
 528         if request in self.OARrequests_uri_dict :
 529             self.raw_json = self.server.GETRequestToOARRestAPI(request, \
 530                                                                 strval, \
 531                                                                 username)
 532             return self.OARrequests_uri_dict[request]['parse_func'](self)
 533         else:
 534             logger.error("OARRESTAPI OARGetParse __init__ : ERROR_REQUEST " \
 535                                                                  %(request))
 536