sfa/rspecs/elements/versions/iotlabv1Node.py

   1 """
   2 This file describes what the propreties of an iotlab nodes are, if an iotlab
   3 rspec is asked. If additionnal node properties have to be defined and exposed
   4 to the user, it should be done here.
   5 """
   6 from sfa.util.xrn import Xrn
   7 from sfa.util.xml import XpathFilter
   8 from sfa.rspecs.elements.node import Node
   9 from sfa.rspecs.elements.sliver import Sliver
  10 from sfa.rspecs.elements.location import Location
  11 from sfa.rspecs.elements.hardware_type import HardwareType
  12 from sfa.rspecs.elements.element import Element
  13 from sfa.rspecs.elements.interface import Interface
  14 from sfa.rspecs.elements.versions.iotlabv1Sliver import Iotlabv1Sliver
  15 from sfa.util.sfalogging import logger
  16
  17
  18 class IotlabNode(Node):
  19     """ Defines what kind of information is displayed on the first line of
  20     the Rspec describing a node.
  21     """
  22     #First get the fields already defined in the class Node
  23     fields = list(Node.fields)
  24     #Extend it with iotlab's specific fields
  25     fields.extend(['archi', 'radio', 'mobile', 'position'])
  26
  27
  28 class IotlabPosition(Element):
  29     """ Defines the fields needed to diplay node's coordinates in the RSpec. """
  30     fields = ['posx', 'posy', 'posz']
  31
  32
  33 class IotlabLocation(Location):
  34     """ Needed to display the localisation (Country and city) of a node."""
  35     fields = list(Location.fields)
  36     fields.extend(['site'])
  37
  38
  39 class IotlabMobility(Element):
  40     """ Class to give information of a node's mobility, and what kind of
  41     mobility it is (train, roomba robot ...) """
  42     fields = ['mobile', 'mobility-type']
  43
  44
  45
  46 class Iotlabv1Node:
  47
  48     @staticmethod
  49     def add_connection_information(xml, ldap_username, sites_set):
  50         """ Adds login and ssh connection info in the network item in
  51         the xml. Does not create the network element, therefore
  52         should be used after add_nodes, which creates the network item.
  53
  54         """
  55         logger.debug(" add_connection_information ")
  56         #Get network item in the xml
  57         network_elems = xml.xpath('//network')
  58         if len(network_elems) > 0:
  59             network_elem = network_elems[0]
  60
  61         iotlab_network_dict = {}
  62         iotlab_network_dict['login'] = ldap_username
  63
  64         iotlab_network_dict['ssh'] = \
  65             ['ssh ' + ldap_username + '@'+site+'.iotlab.info'
  66              for site in sites_set]
  67         network_elem.set('ssh',
  68                          unicode(iotlab_network_dict['ssh']))
  69         network_elem.set('login', unicode(iotlab_network_dict['login']))
  70
  71     @staticmethod
  72     def add_nodes(xml, nodes, rspec_content_type=None):
  73         """Adds the nodes to the xml.
  74
  75         Adds the nodes as well as dedicated iotlab fields to the node xml
  76         element.
  77
  78         :param xml: the xml being constructed.
  79         :type xml: xml
  80         :param nodes: list of node dict
  81         :type nodes: list
  82         :returns: a list of node elements.
  83         :rtype: list
  84
  85         """
  86         #Add network item in the xml
  87         network_elems = xml.xpath('//network')
  88         if len(network_elems) > 0:
  89             network_elem = network_elems[0]
  90         elif len(nodes) > 0 and nodes[0].get('component_manager_id'):
  91             network_urn = nodes[0]['component_manager_id']
  92             network_elem = xml.add_element('network',
  93                                            name=Xrn(network_urn).get_hrn())
  94         else:
  95             network_elem = xml
  96
  97         logger.debug("iotlabv1Node \t add_nodes  nodes %s \r\n " % (nodes[0]))
  98         node_elems = []
  99         #Then add nodes items to the network item in the xml
 100         for node in nodes:
 101             #Attach this node to the network element
 102             node_fields = ['component_manager_id', 'component_id', 'exclusive',
 103                            'boot_state', 'mobile']
 104             node_elem = network_elem.add_instance('node', node, node_fields)
 105             node_elems.append(node_elem)
 106
 107             #Set the attibutes of this node element
 108             for attribute in node:
 109             # set component name
 110                 if attribute is 'component_name':
 111                     component_name = node['component_name']
 112                     node_elem.set('component_name', component_name)
 113
 114             # set hardware types, extend fields to add Iotlab's architecture
 115             #and radio type
 116
 117                 if attribute is 'hardware_types':
 118                     for hardware_type in node.get('hardware_types', []):
 119                         fields = HardwareType.fields
 120                         fields.extend(['archi', 'radio'])
 121                         node_elem.add_instance('hardware_types', node, fields)
 122
 123             # set mobility
 124                 if attribute is 'mobility':
 125                     node_elem.add_instance('mobility', node['mobility'],
 126                                            IotlabMobility.fields)
 127             # set location
 128                 if attribute is 'location':
 129                     node_elem.add_instance('location', node['location'],
 130                                             IotlabLocation.fields)
 131
 132              # add granularity of the reservation system
 133              #TODO put the granularity in network instead SA 18/07/12
 134                 if attribute is 'granularity':
 135                     granularity = node['granularity']
 136                     if granularity:
 137                         node_elem.add_instance('granularity',
 138                                                granularity, granularity.fields)
 139
 140             # set available element
 141                 if attribute is 'boot_state':
 142                     if node.get('boot_state').lower() == 'alive':
 143                         available_elem = node_elem.add_element('available',
 144                                                                now='true')
 145                     else:
 146                         available_elem = node_elem.add_element('available',
 147                                                                now='false')
 148
 149             #set position
 150                 logger.debug("Iotlabv1Node position node_elem %s" % (node_elem))
 151                 if attribute is 'position':
 152                     node_elem.add_instance('position', node['position'],
 153                                            IotlabPosition.fields)
 154                 logger.debug("Iotlabv1Node position node[position] %s "
 155                             % (node['position']))
 156             ## add services
 157             #PGv2Services.add_services(node_elem, node.get('services', []))
 158             # add slivers
 159                 if attribute is 'slivers':
 160                     slivers = node.get('slivers', [])
 161                     if not slivers:
 162                     # we must still advertise the available sliver types
 163                         slivers = Sliver({'type': 'iotlab-node'})
 164                     # we must also advertise the available initscripts
 165                     #slivers['tags'] = []
 166                     #if node.get('pl_initscripts'):
 167                         #for initscript in node.get('pl_initscripts', []):
 168                             #slivers['tags'].append({'name': 'initscript', \
 169                                                     #'value': initscript['name']})
 170
 171                     Iotlabv1Sliver.add_slivers(node_elem, slivers)
 172
 173             # add sliver tag in Request Rspec
 174             if rspec_content_type == "request":
 175                 node_elem.add_instance('sliver', '', [])
 176
 177         return node_elems
 178
 179     @staticmethod
 180     def get_nodes(xml, filter={}):
 181         """
 182         Parsing method called upon receiving a Rspec request in the iotlab
 183         format. (Format is given in the XML header, where 'request' is
 184         specified).
 185
 186         :returns: call to get_node_objs .a list of nodes with their properties
 187         :rtype: list of dict
 188
 189         .. note:: doesn't seem to be used outside sfiListNodes if the iotlab
 190             format is specified.
 191
 192         .. seealso:: get_node_objs
 193         """
 194         xpath = '//node%s | //default:node%s' % (XpathFilter.xpath(filter),
 195                                                  XpathFilter.xpath(filter))
 196         node_elems = xml.xpath(xpath)
 197         return Iotlabv1Node.get_node_objs(node_elems)
 198
 199     @staticmethod
 200     def get_nodes_with_slivers(xml, sliver_filter={}):
 201         """
 202         With the nodes found in the Rspec, find the nodes which the user wants
 203         to use, based on the definition of a sliver on a node. Search for those
 204         nodes.
 205
 206         :param sliver_filter: unused
 207         :returns: call to get_node_objs. A list of nodes where a sliver is
 208             defined with their properties;
 209         :rtype: list of dict
 210
 211         .. note:: used by CreateSliver.
 212         .. seealso:: get_node_objs
 213         """
 214
 215         xpath = '//node[count(sliver)>0] | \
 216                                 //default:node[count(default:sliver) > 0]'
 217         node_elems = xml.xpath(xpath)
 218         logger.debug("SLABV1NODE \tget_nodes_with_slivers  \
 219                                 node_elems %s" % (node_elems))
 220         return Iotlabv1Node.get_node_objs(node_elems)
 221
 222     @staticmethod
 223     def get_node_objs(node_elems):
 224         """
 225         Get information on the nodes on the xml. Gets the attributes in the
 226         Rspec.
 227
 228         :param node_elems: xml node elements
 229         :type node_elems: xml xpath return type
 230
 231         :returns: a list of nodes where a sliver is defined with their
 232             properties
 233         :rtype: list of dict
 234
 235         .. seealso:: get_nodes_with_slivers, get_nodes
 236
 237         """
 238         nodes = []
 239         for node_elem in node_elems:
 240             node = Node(node_elem.attrib, node_elem)
 241             nodes.append(node)
 242             if 'component_id' in node_elem.attrib:
 243                 node['authority_id'] = \
 244                     Xrn(node_elem.attrib['component_id']).get_authority_urn()
 245
 246             # get hardware types
 247             hardware_type_elems = node_elem.xpath('./default:hardware_type | \
 248                                                             ./hardware_type')
 249             node['hardware_types'] = [hw_type.get_instance(HardwareType)
 250                                       for hw_type in hardware_type_elems]
 251
 252             # get location
 253             location_elems = node_elem.xpath('./default:location | ./location')
 254             locations = [location_elem.get_instance(Location)
 255                          for location_elem in location_elems]
 256             if len(locations) > 0:
 257                 node['location'] = locations[0]
 258
 259
 260             # get interfaces
 261             iface_elems = node_elem.xpath('./default:interface | ./interface')
 262             node['interfaces'] = [iface_elem.get_instance(Interface)
 263                                   for iface_elem in iface_elems]
 264
 265             # get position
 266             position_elems = node_elem.xpath('./default:position | ./position')
 267             if position_elems:
 268                 position_elem = position_elems[0]
 269                 node['position'] = position_elem.get_instance(IotlabPosition)
 270
 271             # get services
 272             #node['services'] = PGv2Services.get_services(node_elem)
 273
 274             # get slivers
 275             node['slivers'] = Iotlabv1Sliver.get_slivers(node_elem)
 276             available_elems = node_elem.xpath('./default:available | \
 277                                                                 ./available')
 278             if len(available_elems) > 0 and 'name' in available_elems[0].attrib:
 279                 if available_elems[0].attrib.get('now', '').lower() == 'true':
 280                     node['boot_state'] = 'boot'
 281                 else:
 282                     node['boot_state'] = 'disabled'
 283
 284         logger.debug("SLABV1NODE \tget_nodes_objs  \
 285                                 #nodes %s" % (nodes))
 286         return nodes
 287
 288     @staticmethod
 289     def add_slivers(xml, slivers):
 290         """Add the slivers in parameter to the nodes, by modifying the
 291         xml and adding the sliver element in the RSpec.
 292
 293         :param slivers: list of slivers, which can be either strings or  dict.
 294         :type: list
 295
 296         :returns: None
 297         :rtype: None
 298
 299         .. seealso:: Iotlabv1Sliver : add_slivers
 300         .. note:: used by sfiAddSliver and add_nodes (in the file)
 301
 302         """
 303         logger.debug("Iotlabv1NODE \tadd_slivers ")
 304         component_ids = []
 305         for sliver in slivers:
 306             filter_sliver = {}
 307             if isinstance(sliver, str):
 308                 filter_sliver['component_id'] = '*%s*' % sliver
 309                 sliver = {}
 310             elif 'component_id' in sliver and sliver['component_id']:
 311                 filter_sliver['component_id'] = '*%s*' % sliver['component_id']
 312             if not filter_sliver:
 313                 continue
 314             nodes = Iotlabv1Node.get_nodes(xml, filter_sliver)
 315             if not nodes:
 316                 continue
 317             node = nodes[0]
 318             Iotlabv1Sliver.add_slivers(node, sliver)
 319
 320     @staticmethod
 321     def remove_slivers(xml, hostnames):
 322         """
 323         Removes the slivers for the nodes whose hostnames are on the list.
 324
 325         :param hostnames: list of nodes' hostnames whose sliver have to be
 326             removed.
 327         :type hostnames: list
 328         """
 329         for hostname in hostnames:
 330             nodes = Iotlabv1Node.get_nodes(xml, {'component_id': '*%s*'
 331                                            % hostname})
 332             for node in nodes:
 333                 slivers = Iotlabv1Sliver.get_slivers(node.element)
 334                 for sliver in slivers:
 335                     node.element.remove(sliver.element)