#
# NEPI, a framework to manage network experiments
# Copyright (C) 2013 INRIA
#
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program. If not, see .
#
# Author: Alina Quereilhac
# Julien Tribino
from nepi.execution.resource import ResourceManager, clsinit, ResourceState
from nepi.execution.attribute import Attribute, Flags
from nepi.resources.omf.omf_api import OMFAPIFactory
import time
reschedule_delay = "0.5s"
@clsinit
class OMFNode(ResourceManager):
"""
.. class:: Class Args :
:param ec: The Experiment controller
:type ec: ExperimentController
:param guid: guid of the RM
:type guid: int
:param creds: Credentials to communicate with the rm (XmppClient for OMF)
:type creds: dict
.. note::
This class is used only by the Experiment Controller through the Resource Factory
"""
_rtype = "OMFNode"
_authorized_connections = ["OMFApplication" , "OMFWifiInterface"]
@classmethod
def _register_attributes(cls):
"""Register the attributes of an OMF Node
"""
hostname = Attribute("hostname", "Hostname of the machine")
cpu = Attribute("cpu", "CPU of the node")
ram = Attribute("ram", "RAM of the node")
xmppSlice = Attribute("xmppSlice","Name of the slice",
flags = Flags.Credential)
xmppHost = Attribute("xmppHost", "Xmpp Server",
flags = Flags.Credential)
xmppPort = Attribute("xmppPort", "Xmpp Port",
flags = Flags.Credential)
xmppPassword = Attribute("xmppPassword", "Xmpp Port",
flags = Flags.Credential)
host = Attribute("host", "Hostname of the machine",
flags = Flags.Filter)
gateway = Attribute("gateway", "Gateway",
flags = Flags.Filter)
granularity = Attribute("granularity", "Granularity of the reservation time",
flags = Flags.Filter)
hardware_type = Attribute("hardware_type", "Hardware type of the machine",
flags = Flags.Filter)
cls._register_attribute(hostname)
cls._register_attribute(ram)
cls._register_attribute(cpu)
cls._register_attribute(xmppSlice)
cls._register_attribute(xmppHost)
cls._register_attribute(xmppPort)
cls._register_attribute(xmppPassword)
cls._register_attribute(host)
cls._register_attribute(gateway)
cls._register_attribute(granularity)
cls._register_attribute(hardware_type)
# XXX: We don't necessary need to have the credentials at the
# moment we create the RM
def __init__(self, ec, guid):
"""
:param ec: The Experiment controller
:type ec: ExperimentController
:param guid: guid of the RM
:type guid: int
:param creds: Credentials to communicate with the rm (XmppClient for OMF)
:type creds: dict
"""
super(OMFNode, self).__init__(ec, guid)
self._omf_api = None
# XXX: TO DISCUSS
def _validate_connection(self, guid):
"""Check if the connection is available.
:param guid: Guid of the current RM
:type guid: int
:rtype: Boolean
"""
rm = self.ec.get_resource(guid)
if rm.rtype() in self._authorized_connections:
msg = "Connection between %s %s and %s %s accepted" % (self.rtype(), self._guid, rm.rtype(), guid)
self.debug(msg)
return True
msg = "Connection between %s %s and %s %s refused" % (self.rtype(), self._guid, rm.rtype(), guid)
self.debug(msg)
return False
def deploy(self):
"""Deploy the RM
"""
if not self._omf_api :
self._omf_api = OMFAPIFactory.get_api(self.get('xmppSlice'),
self.get('xmppHost'), self.get('xmppPort'), self.get('xmppPassword'))
self._omf_api.enroll_host(self.get('hostname'))
super(OMFNode, self).deploy()
def discover(self):
""" Discover the availables nodes
"""
pass
def provision(self):
""" Provision some availables nodes
"""
pass
def start(self):
"""Send Xmpp Message Using OMF protocol to enroll the node into the experiment
"""
super(OMFNode, self).start()
def stop(self):
"""Send Xmpp Message Using OMF protocol to disconnect the node
"""
super(OMFNode, self).stop()
def release(self):
"""Clean the RM at the end of the experiment
"""
self._omf_api.release(self.get('hostname'))
OMFAPIFactory.release_api(self.get('xmppSlice'),
self.get('xmppHost'), self.get('xmppPort'), self.get('xmppPassword'))
def configure(self):
#routes = self.tc._add_route.get(self.guid, [])
#iface_guids = self.tc.get_connected(self.guid, "devs", "node")
for route in routes:
(destination, netprefix, nexthop, metric, device) = route
netmask = ipaddr2.ipv4_mask2dot(netprefix)
# Validate that the interface is associated to the node
for iface_guid in iface_guids:
iface = self.tc.elements.get(iface_guid)
if iface.devname == device:
self._omf_api.execute(self.get('hostname'),
"Id#%s" % str(random.getrandbits(128)),
"add -net %s netmask %s dev %s" % (destination, netmask, iface.devname),
"/sbin/route", # path
None, # env
)
break