Handle slice table update upon creation of a job.
[sfa.git] / sfa / senslab / slabdriver.py
1 import sys
2
3 from sfa.util.faults import MissingSfaInfo
4 from sfa.util.sfalogging import logger
5 from sfa.util.table import SfaTable
6 from sfa.util.defaultdict import defaultdict
7
8 from sfa.util.xrn import hrn_to_urn
9 from sfa.util.plxrn import slicename_to_hrn, hostname_to_hrn, hrn_to_pl_slicename, hrn_to_pl_login_base
10
11 ## thierry: everything that is API-related (i.e. handling incoming requests) 
12 # is taken care of 
13 # SlabDriver should be really only about talking to the senslab testbed
14
15 ## thierry : please avoid wildcard imports :)
16 from sfa.senslab.OARrestapi import OARapi, OARrestapi
17 from sfa.senslab.LDAPapi import LDAPapi
18 from sfa.senslab.SenslabImportUsers import SenslabImportUsers
19 from sfa.senslab.parsing import parse_filter
20 from sfa.senslab.slabpostgres import SlabDB
21
22 def list_to_dict(recs, key):
23     """
24     convert a list of dictionaries into a dictionary keyed on the 
25     specified dictionary key 
26     """
27    # print>>sys.stderr, " \r\n \t\t 1list_to_dict : rec %s  \r\n \t\t list_to_dict key %s" %(recs,key)   
28     keys = [rec[key] for rec in recs]
29     #print>>sys.stderr, " \r\n \t\t list_to_dict : rec %s  \r\n \t\t list_to_dict keys %s" %(recs,keys)   
30     return dict(zip(keys, recs))
31
32 # thierry : note
33 # this inheritance scheme is so that the driver object can receive
34 # GetNodes or GetSites sorts of calls directly
35 # and thus minimize the differences in the managers with the pl version
36 class SlabDriver ():
37
38     def __init__(self, config):
39        
40         self.config=config
41         self.hrn = config.SFA_INTERFACE_HRN
42     
43         self.root_auth = config.SFA_REGISTRY_ROOT_AUTH
44
45         
46         print >>sys.stderr, "\r\n_____________ SFA SENSLAB DRIVER \r\n" 
47         # thierry - just to not break the rest of this code
48         #self.oar = OARapi()
49         #self.users = SenslabImportUsers()
50         self.oar = OARapi()
51         self.ldap = LDAPapi()
52         self.users = SenslabImportUsers()
53         self.time_format = "%Y-%m-%d %H:%M:%S"
54         self.db = SlabDB()
55         #self.logger=sfa_logger()
56       
57         
58     def GetPersons(self, person_filter=None, return_fields=None):
59         
60         person_list = self.ldap.ldapFind({'authority': self.root_auth })
61         
62         #check = False
63         #if person_filter and isinstance(person_filter, dict):
64             #for k in  person_filter.keys():
65                 #if k in person_list[0].keys():
66                     #check = True
67                     
68         return_person_list = parse_filter(person_list,person_filter ,'persons', return_fields)
69         if return_person_list:
70             print>>sys.stderr, " \r\n GetPersons person_filter %s return_fields %s return_person_list %s " %(person_filter,return_fields,return_person_list)
71             return return_person_list
72     
73     def GetNodes(self,node_filter= None, return_fields=None):
74                 
75         self.oar.parser.SendRequest("GET_resources_full")
76         node_dict = self.oar.parser.GetNodesFromOARParse()
77         return_node_list = []
78
79         if not (node_filter or return_fields):
80                 return_node_list = node_dict.values()
81                 return return_node_list
82     
83         return_node_list= parse_filter(node_dict.values(),node_filter ,'node', return_fields)
84         return return_node_list
85     
86     def GetSites(self, auth, site_filter = None, return_fields=None):
87         self.oar.parser.SendRequest("GET_resources_full")
88         site_dict = self.oar.parser.GetSitesFromOARParse()
89         return_site_list = []
90         site = site_dict.values()[0]
91         if not (site_filter or return_fields):
92                 return_site_list = site_dict.values()
93                 return return_site_list
94         
95         return_site_list = parse_filter(site_dict.values(),site_filter ,'site', return_fields)
96         return return_site_list
97     
98     def GetSlices(self,slice_filter = None, return_fields=None):
99         
100         return_slice_list =[]
101         sliceslist = self.db.find('slice',columns = ['slice_hrn', 'record_id_slice','record_id_user'])
102         print >>sys.stderr, " \r\n \r\n SLABDRIVER.PY  GetSlices  slices %s" %(sliceslist)
103         #slicesdict = sliceslist[0]
104         if not (slice_filter or return_fields):
105                 return_slice_list = sliceslist
106                 return  return_slice_list
107         
108         return_slice_list  = parse_filter(sliceslist, slice_filter,'slice', return_fields)
109         print >>sys.stderr, " \r\n \r\n SLABDRIVER.PY  GetSlices  return_slice_list %s" %(return_slice_list)
110         return return_slice_list
111        
112     ##
113     # Convert SFA fields to PLC fields for use when registering up updating
114     # registry record in the PLC database
115     #
116     # @param type type of record (user, slice, ...)
117     # @param hrn human readable name
118     # @param sfa_fields dictionary of SFA fields
119     # @param pl_fields dictionary of PLC fields (output)
120
121     def sfa_fields_to_pl_fields(self, type, hrn, record):
122
123         def convert_ints(tmpdict, int_fields):
124             for field in int_fields:
125                 if field in tmpdict:
126                     tmpdict[field] = int(tmpdict[field])
127
128         pl_record = {}
129         #for field in record:
130         #    pl_record[field] = record[field]
131  
132         if type == "slice":
133             if not "instantiation" in pl_record:
134                 pl_record["instantiation"] = "plc-instantiated"
135             pl_record["name"] = hrn_to_pl_slicename(hrn)
136             if "url" in record:
137                pl_record["url"] = record["url"]
138             if "description" in record:
139                 pl_record["description"] = record["description"]
140             if "expires" in record:
141                 pl_record["expires"] = int(record["expires"])
142
143         elif type == "node":
144             if not "hostname" in pl_record:
145                 if not "hostname" in record:
146                     raise MissingSfaInfo("hostname")
147                 pl_record["hostname"] = record["hostname"]
148             if not "model" in pl_record:
149                 pl_record["model"] = "geni"
150
151         elif type == "authority":
152             pl_record["login_base"] = hrn_to_pl_login_base(hrn)
153
154             if not "name" in pl_record:
155                 pl_record["name"] = hrn
156
157             if not "abbreviated_name" in pl_record:
158                 pl_record["abbreviated_name"] = hrn
159
160             if not "enabled" in pl_record:
161                 pl_record["enabled"] = True
162
163             if not "is_public" in pl_record:
164                 pl_record["is_public"] = True
165
166         return pl_record
167
168     def fill_record_pl_info(self, records):
169         """
170         Fill in the planetlab specific fields of a SFA record. This
171         involves calling the appropriate PLC method to retrieve the 
172         database record for the object.
173         
174         PLC data is filled into the pl_info field of the record.
175     
176         @param record: record to fill in field (in/out param)     
177         """
178         # get ids by type
179         #print>>sys.stderr, "\r\n \r\rn \t\t >>>>>>>>>>fill_record_pl_info  records %s : "%(records)
180         node_ids, site_ids, slice_ids = [], [], [] 
181         person_ids, key_ids = [], []
182         type_map = {'node': node_ids, 'authority': site_ids,
183                     'slice': slice_ids, 'user': person_ids}
184                   
185         for record in records:
186             for type in type_map:
187                 #print>>sys.stderr, "\r\n \t\t \t fill_record_pl_info : type %s. record['pointer'] %s "%(type,record['pointer'])   
188                 if type == record['type']:
189                     type_map[type].append(record['pointer'])
190         #print>>sys.stderr, "\r\n \t\t \t fill_record_pl_info : records %s... \r\n \t\t \t fill_record_pl_info : type_map   %s"%(records,type_map)
191         # get pl records
192         nodes, sites, slices, persons, keys = {}, {}, {}, {}, {}
193         if node_ids:
194             node_list = self.GetNodes( node_ids)
195             #print>>sys.stderr, " \r\n \t\t\t BEFORE LIST_TO_DICT_NODES node_ids : %s" %(node_ids)
196             nodes = list_to_dict(node_list, 'node_id')
197         if site_ids:
198             site_list = self.oar.GetSites( site_ids)
199             sites = list_to_dict(site_list, 'site_id')
200             #print>>sys.stderr, " \r\n \t\t\t  site_ids %s sites  : %s" %(site_ids,sites)           
201         if slice_ids:
202             slice_list = self.users.GetSlices( slice_ids)
203             slices = list_to_dict(slice_list, 'slice_id')
204         if person_ids:
205             #print>>sys.stderr, " \r\n \t\t \t fill_record_pl_info BEFORE GetPersons  person_ids: %s" %(person_ids)
206             person_list = self.GetPersons( person_ids)
207             persons = list_to_dict(person_list, 'person_id')
208             #print>>sys.stderr, "\r\n  fill_record_pl_info persons %s \r\n \t\t person_ids %s " %(persons, person_ids) 
209             for person in persons:
210                 key_ids.extend(persons[person]['key_ids'])
211                 #print>>sys.stderr, "\r\n key_ids %s " %(key_ids)
212
213         pl_records = {'node': nodes, 'authority': sites,
214                       'slice': slices, 'user': persons}
215
216         if key_ids:
217             key_list = self.users.GetKeys( key_ids)
218             keys = list_to_dict(key_list, 'key_id')
219            # print>>sys.stderr, "\r\n  fill_record_pl_info persons %s \r\n \t\t keys %s " %(keys) 
220         # fill record info
221         for record in records:
222             # records with pointer==-1 do not have plc info.
223             # for example, the top level authority records which are
224             # authorities, but not PL "sites"
225             if record['pointer'] == -1:
226                 continue
227            
228             for type in pl_records:
229                 if record['type'] == type:
230                     if record['pointer'] in pl_records[type]:
231                         record.update(pl_records[type][record['pointer']])
232                         break
233             # fill in key info 
234             if record['type'] == 'user':
235                  if 'key_ids' not in record:
236                         #print>>sys.stderr, " NO_KEY_IDS fill_record_pl_info key_ids record: %s" %(record)
237                         logger.info("user record has no 'key_ids' - need to import  ?")
238                  else:
239                         pubkeys = [keys[key_id]['key'] for key_id in record['key_ids'] if key_id in keys] 
240                         record['keys'] = pubkeys
241                         
242         #print>>sys.stderr, "\r\n \r\rn \t\t <<<<<<<<<<<<<<<<<< fill_record_pl_info  records %s : "%(records)
243         # fill in record hrns
244         records = self.fill_record_hrns(records)   
245
246         return records
247                  
248                  
249                  
250     def AddSliceToNodes(self,  slice_name, added_nodes, slice_user=None):
251         print>>sys.stderr, "\r\n \r\n AddSliceToNodes  slice_name %s added_nodes %s username %s" %(slice_name,added_nodes,slice_user )
252         site_list = []
253         nodeid_list =[]
254         resource = ""
255         reqdict = {}
256         reqdict['property'] ="network_address in ("
257         for node in added_nodes:
258             #Get the ID of the node : remove the root auth and put the site in a separate list
259             tmp = node.strip(self.root_auth+".")
260             l = tmp.split("_")
261              
262             nodeid= (l[len(l)-1]) 
263             reqdict['property'] += "'"+ nodeid +"', "
264             nodeid_list.append(nodeid)
265             site_list.append( l[0] )
266             
267         reqdict['property'] =  reqdict['property'][0: len( reqdict['property'])-2] +")"
268         reqdict['resource'] ="network_address="+ str(len(nodeid_list))
269         reqdict['resource']+= ",walltime=" + str(00) + ":" + str(05) + ":" + str(00)
270         reqdict['script_path'] = "/bin/sleep "
271
272         print>>sys.stderr, "\r\n \r\n AddSliceToNodes reqdict   %s \r\n site_list   %s"  %(reqdict,site_list)   
273         OAR = OARrestapi()
274         answer = OAR.POSTRequestToOARRestAPI('POST_job',reqdict,slice_user)
275         print>>sys.stderr, "\r\n \r\n AddSliceToNodes jobid   %s "  %(answer)
276         self.db.update('slice',['oar_job_id'], [answer['id']], 'slice_hrn', slice_name)
277         return 
278     
279
280         
281         
282     def DeleteSliceFromNodes(self, slice_name, deleted_nodes):
283         return   
284     
285     def fill_record_hrns(self, records):
286         """
287         convert pl ids to hrns
288         """
289         #print>>sys.stderr, "\r\n \r\rn \t\t \t >>>>>>>>>>>>>>>>>>>>>> fill_record_hrns records %s : "%(records)  
290         # get ids
291         slice_ids, person_ids, site_ids, node_ids = [], [], [], []
292         for record in records:
293             #print>>sys.stderr, "\r\n \r\rn \t\t \t record %s : "%(record)
294             if 'site_id' in record:
295                 site_ids.append(record['site_id'])
296             if 'site_ids' in records:
297                 site_ids.extend(record['site_ids'])
298             if 'person_ids' in record:
299                 person_ids.extend(record['person_ids'])
300             if 'slice_ids' in record:
301                 slice_ids.extend(record['slice_ids'])
302             if 'node_ids' in record:
303                 node_ids.extend(record['node_ids'])
304
305         # get pl records
306         slices, persons, sites, nodes = {}, {}, {}, {}
307         if site_ids:
308             site_list = self.oar.GetSites( site_ids, ['site_id', 'login_base'])
309             sites = list_to_dict(site_list, 'site_id')
310             #print>>sys.stderr, " \r\n \r\n \t\t ____ site_list %s \r\n \t\t____ sites %s " % (site_list,sites)
311         if person_ids:
312             person_list = self.GetPersons( person_ids, ['person_id', 'email'])
313             #print>>sys.stderr, " \r\n \r\n   \t\t____ person_lists %s " %(person_list) 
314             persons = list_to_dict(person_list, 'person_id')
315         if slice_ids:
316             slice_list = self.users.GetSlices( slice_ids, ['slice_id', 'name'])
317             slices = list_to_dict(slice_list, 'slice_id')       
318         if node_ids:
319             node_list = self.GetNodes( node_ids, ['node_id', 'hostname'])
320             nodes = list_to_dict(node_list, 'node_id')
321        
322         # convert ids to hrns
323         for record in records:
324              
325             # get all relevant data
326             type = record['type']
327             pointer = record['pointer']
328             auth_hrn = self.hrn
329             login_base = ''
330             if pointer == -1:
331                 continue
332
333             #print>>sys.stderr, " \r\n \r\n \t\t fill_record_hrns : sites %s \r\n \t\t record %s " %(sites, record)
334             if 'site_id' in record:
335                 site = sites[record['site_id']]
336                 #print>>sys.stderr, " \r\n \r\n \t\t \t fill_record_hrns : sites %s \r\n \t\t\t site sites[record['site_id']] %s " %(sites,site)        
337                 login_base = site['login_base']
338                 record['site'] = ".".join([auth_hrn, login_base])
339             if 'person_ids' in record:
340                 emails = [persons[person_id]['email'] for person_id in record['person_ids'] \
341                           if person_id in  persons]
342                 usernames = [email.split('@')[0] for email in emails]
343                 person_hrns = [".".join([auth_hrn, login_base, username]) for username in usernames]
344                 #print>>sys.stderr, " \r\n \r\n \t\t ____ person_hrns : %s " %(person_hrns)
345                 record['persons'] = person_hrns 
346             if 'slice_ids' in record:
347                 slicenames = [slices[slice_id]['name'] for slice_id in record['slice_ids'] \
348                               if slice_id in slices]
349                 slice_hrns = [slicename_to_hrn(auth_hrn, slicename) for slicename in slicenames]
350                 record['slices'] = slice_hrns
351             if 'node_ids' in record:
352                 hostnames = [nodes[node_id]['hostname'] for node_id in record['node_ids'] \
353                              if node_id in nodes]
354                 node_hrns = [hostname_to_hrn(auth_hrn, login_base, hostname) for hostname in hostnames]
355                 record['nodes'] = node_hrns
356             if 'site_ids' in record:
357                 login_bases = [sites[site_id]['login_base'] for site_id in record['site_ids'] \
358                                if site_id in sites]
359                 site_hrns = [".".join([auth_hrn, lbase]) for lbase in login_bases]
360                 record['sites'] = site_hrns
361         #print>>sys.stderr, "\r\n \r\rn \t\t \t <<<<<<<<<<<<<<<<<<<<<<<<  fill_record_hrns records %s : "%(records)  
362         return records   
363
364     def fill_record_sfa_info(self, records):
365
366         def startswith(prefix, values):
367             return [value for value in values if value.startswith(prefix)]
368
369         # get person ids
370         person_ids = []
371         site_ids = []
372         for record in records:
373             person_ids.extend(record.get("person_ids", []))
374             site_ids.extend(record.get("site_ids", [])) 
375             if 'site_id' in record:
376                 site_ids.append(record['site_id']) 
377                 
378         #print>>sys.stderr, "\r\n \r\n _fill_record_sfa_info ___person_ids %s \r\n \t\t site_ids %s " %(person_ids, site_ids)
379         
380         # get all pis from the sites we've encountered
381         # and store them in a dictionary keyed on site_id 
382         site_pis = {}
383         if site_ids:
384             pi_filter = {'|roles': ['pi'], '|site_ids': site_ids} 
385             pi_list = self.GetPersons( pi_filter, ['person_id', 'site_ids'])
386             #print>>sys.stderr, "\r\n \r\n _fill_record_sfa_info ___ GetPersons ['person_id', 'site_ids'] pi_ilist %s" %(pi_list)
387
388             for pi in pi_list:
389                 # we will need the pi's hrns also
390                 person_ids.append(pi['person_id'])
391                 
392                 # we also need to keep track of the sites these pis
393                 # belong to
394                 for site_id in pi['site_ids']:
395                     if site_id in site_pis:
396                         site_pis[site_id].append(pi)
397                     else:
398                         site_pis[site_id] = [pi]
399                  
400         # get sfa records for all records associated with these records.   
401         # we'll replace pl ids (person_ids) with hrns from the sfa records
402         # we obtain
403         
404         # get the sfa records
405         table = SfaTable()
406         person_list, persons = [], {}
407         person_list = table.find({'type': 'user', 'pointer': person_ids})
408         # create a hrns keyed on the sfa record's pointer.
409         # Its possible for  multiple records to have the same pointer so
410         # the dict's value will be a list of hrns.
411         persons = defaultdict(list)
412         for person in person_list:
413             persons[person['pointer']].append(person)
414
415         # get the pl records
416         pl_person_list, pl_persons = [], {}
417         pl_person_list = self.GetPersons(person_ids, ['person_id', 'roles'])
418         pl_persons = list_to_dict(pl_person_list, 'person_id')
419         #print>>sys.stderr, "\r\n \r\n _fill_record_sfa_info ___  _list %s \r\n \t\t SenslabUsers.GetPersons ['person_id', 'roles'] pl_persons %s \r\n records %s" %(pl_person_list, pl_persons,records) 
420         # fill sfa info
421         
422         for record in records:
423             # skip records with no pl info (top level authorities)
424             #Sandrine 24 oct 11 2 lines
425             #if record['pointer'] == -1:
426                 #continue 
427             sfa_info = {}
428             type = record['type']
429             if (type == "slice"):
430                 # all slice users are researchers
431                 #record['geni_urn'] = hrn_to_urn(record['hrn'], 'slice')  ? besoin ou pas ?
432                 record['PI'] = []
433                 record['researcher'] = []
434                 for person_id in record.get('person_ids', []):
435                          #Sandrine 24 oct 11 line
436                 #for person_id in record['person_ids']:
437                     hrns = [person['hrn'] for person in persons[person_id]]
438                     record['researcher'].extend(hrns)                
439
440                 # pis at the slice's site
441                 pl_pis = site_pis[record['site_id']]
442                 pi_ids = [pi['person_id'] for pi in pl_pis]
443                 for person_id in pi_ids:
444                     hrns = [person['hrn'] for person in persons[person_id]]
445                     record['PI'].extend(hrns)
446                 record['geni_urn'] = hrn_to_urn(record['hrn'], 'slice')
447                 record['geni_creator'] = record['PI'] 
448                 
449             elif (type == "authority"):
450                 record['PI'] = []
451                 record['operator'] = []
452                 record['owner'] = []
453                 for pointer in record['person_ids']:
454                     if pointer not in persons or pointer not in pl_persons:
455                         # this means there is not sfa or pl record for this user
456                         continue   
457                     hrns = [person['hrn'] for person in persons[pointer]] 
458                     roles = pl_persons[pointer]['roles']   
459                     if 'pi' in roles:
460                         record['PI'].extend(hrns)
461                     if 'tech' in roles:
462                         record['operator'].extend(hrns)
463                     if 'admin' in roles:
464                         record['owner'].extend(hrns)
465                     # xxx TODO: OrganizationName
466             elif (type == "node"):
467                 sfa_info['dns'] = record.get("hostname", "")
468                 # xxx TODO: URI, LatLong, IP, DNS
469     
470             elif (type == "user"):
471                  sfa_info['email'] = record.get("email", "")
472                  sfa_info['geni_urn'] = hrn_to_urn(record['hrn'], 'user')
473                  sfa_info['geni_certificate'] = record['gid'] 
474                 # xxx TODO: PostalAddress, Phone
475                 
476             #print>>sys.stderr, "\r\n \r\rn \t\t \t <<<<<<<<<<<<<<<<<<<<<<<<  fill_record_sfa_info sfa_info %s  \r\n record %s : "%(sfa_info,record)  
477             record.update(sfa_info)
478
479     def fill_record_info(self, records):
480         """
481         Given a SFA record, fill in the senslab specific and SFA specific
482         fields in the record. 
483         """
484         print >>sys.stderr, "\r\n \t\t BEFORE fill_record_pl_info %s" %(records)        
485         if isinstance(records, list):
486             records = records[0]
487         #print >>sys.stderr, "\r\n \t\t BEFORE fill_record_pl_info %s" %(records)       
488         
489        
490         if records['type'] == 'slice':
491
492             sfatable = SfaTable()
493             recslice = self.db.find('slice',str(records['hrn']))
494             if isinstance(recslice,list) and len(recslice) == 1:
495                 recslice = recslice[0]
496             recuser = sfatable.find(  recslice['record_id_user'], ['hrn'])
497             
498             print >>sys.stderr, "\r\n \t\t  SLABDRIVER.PY fill_record_info %s" %(recuser)
499             records['type']
500             if isinstance(recuser,list) and len(recuser) == 1:
501                 recuser = recuser[0]              
502             records.update({'PI':[recuser['hrn']],
503             'researcher': [recuser['hrn']],
504             'name':records['hrn'], 'oar_job_id':recslice['oar_job_id'],
505             
506             'node_ids': [],
507             'person_ids':[recslice['record_id_user']]})
508
509         #self.fill_record_pl_info(records)
510         ##print >>sys.stderr, "\r\n \t\t after fill_record_pl_info %s" %(records)       
511         #self.fill_record_sfa_info(records)
512         #print >>sys.stderr, "\r\n \t\t after fill_record_sfa_info"
513         
514     def update_membership_list(self, oldRecord, record, listName, addFunc, delFunc):
515         # get a list of the HRNs tht are members of the old and new records
516         if oldRecord:
517             oldList = oldRecord.get(listName, [])
518         else:
519             oldList = []     
520         newList = record.get(listName, [])
521
522         # if the lists are the same, then we don't have to update anything
523         if (oldList == newList):
524             return
525
526         # build a list of the new person ids, by looking up each person to get
527         # their pointer
528         newIdList = []
529         table = SfaTable()
530         records = table.find({'type': 'user', 'hrn': newList})
531         for rec in records:
532             newIdList.append(rec['pointer'])
533
534         # build a list of the old person ids from the person_ids field 
535         if oldRecord:
536             oldIdList = oldRecord.get("person_ids", [])
537             containerId = oldRecord.get_pointer()
538         else:
539             # if oldRecord==None, then we are doing a Register, instead of an
540             # update.
541             oldIdList = []
542             containerId = record.get_pointer()
543
544     # add people who are in the new list, but not the oldList
545         for personId in newIdList:
546             if not (personId in oldIdList):
547                 addFunc(self.plauth, personId, containerId)
548
549         # remove people who are in the old list, but not the new list
550         for personId in oldIdList:
551             if not (personId in newIdList):
552                 delFunc(self.plauth, personId, containerId)
553
554     def update_membership(self, oldRecord, record):
555         print >>sys.stderr, " \r\n \r\n ***SLABDRIVER.PY update_membership record ", record
556         if record.type == "slice":
557             self.update_membership_list(oldRecord, record, 'researcher',
558                                         self.users.AddPersonToSlice,
559                                         self.users.DeletePersonFromSlice)
560         elif record.type == "authority":
561             # xxx TODO
562             pass
563
564 ### thierry
565 # I don't think you plan on running a component manager at this point
566 # let me clean up the mess of ComponentAPI that is deprecated anyways