import xmlrpclib
try:
- from PLC.Parameter import Parameter
+ from PLC.Parameter import Parameter, Mixed
except:
- pass
+ def Parameter(a = None, b = None): pass
+ def Mixed(a = None, b = None, c = None): pass
+
import accounts
import logger
import ticket as ticket_module
import tools
+deliver_ticket = None # set in sm.py:start()
api_method_dict = {}
nargs_dict = {}
# returns
@export_to_docbook(roles=['self'],
- accepts=[],
- returns=Parameter([], 'A list of supported functions'))
+ accepts=[],
+ returns=Parameter([], 'A list of supported functions'))
@export_to_api(0)
def Help():
"""Get a list of functions currently supported by the Node Manager API"""
return ''.join([method.__doc__ + '\n' for method in api_method_dict.itervalues()])
@export_to_docbook(roles=['self'],
- accepts=[Parameter(str, 'A ticket returned from GetSliceTicket()')],
- returns=Parameter(int, '1 if successful'))
+ accepts=[Parameter(str, 'A ticket returned from GetSliceTicket()')],
+ returns=Parameter(int, '1 if successful'))
@export_to_api(1)
def Ticket(ticket):
"""The Node Manager periodically polls the PLC API for a list of all
except Exception, err:
raise xmlrpclib.Fault(102, 'Ticket error: ' + str(err))
+@export_to_docbook(roles=['self'],
+ accepts=[Parameter(str, 'A ticket returned from GetSlivers()')],
+ returns=Parameter(int, '1 if successful'))
+@export_to_api(1)
+def AdminTicket(ticket):
+ """Admin interface to create slivers based on ticket returned by GetSlivers().
+ """
+ try:
+ data, = xmlrpclib.loads(ticket)[0]
+ name = data['slivers'][0]['name']
+ if data != None:
+ deliver_ticket(data)
+ logger.log('Admin Ticket delivered for %s' % name)
+ Create(database.db.get(name))
+ except Exception, err:
+ raise xmlrpclib.Fault(102, 'Ticket error: ' + str(err))
+
+
@export_to_docbook(roles=['self'],
- accepts=[],
- returns={'sliver_name' : Parameter(int, 'the associated xid')})
+ accepts=[],
+ returns={'sliver_name' : Parameter(int, 'the associated xid')})
@export_to_api(0)
def GetXIDs():
"""Return an dictionary mapping Slice names to XIDs"""
@export_to_docbook(roles=['self'],
accepts=[],
- returns={ 'sliver_name' : Parameter(str, 'the associated SSHKey')})
+ returns={ 'sliver_name' : Parameter(str, 'the associated SSHKey')})
@export_to_api(0)
def GetSSHKeys():
"""Return an dictionary mapping slice names to SSH keys"""
keydict[rec['name']] = rec['keys']
return keydict
+
@export_to_docbook(roles=['nm-controller', 'self'],
- accepts=[Parameter(str, 'A sliver/slice name.')],
- returns=Parameter(int, '1 if successful'))
+ accepts=[Parameter(str, 'A sliver/slice name.')],
+ returns=Parameter(int, '1 if successful'))
@export_to_api(1)
def Create(sliver_name):
"""Create a non-PLC-instantiated sliver"""
rec = sliver_name
if rec['instantiation'] == 'delegated': accounts.get(rec['name']).ensure_created(rec)
+ else: raise Exception, "Only PLC can create non delegated slivers."
+
@export_to_docbook(roles=['nm-controller', 'self'],
- accepts=[Parameter(str, 'A sliver/slice name.')],
- returns=Parameter(int, '1 if successful'))
+ accepts=[Parameter(str, 'A sliver/slice name.')],
+ returns=Parameter(int, '1 if successful'))
@export_to_api(1)
def Destroy(sliver_name):
"""Destroy a non-PLC-instantiated sliver"""
rec = sliver_name
if rec['instantiation'] == 'delegated': accounts.get(rec['name']).ensure_destroyed()
+ else: raise Exception, "Only PLC can destroy non delegated slivers."
+
@export_to_docbook(roles=['nm-controller', 'self'],
- accepts=[Parameter(str, 'A sliver/slice name.')],
- returns=Parameter(int, '1 if successful'))
+ accepts=[Parameter(str, 'A sliver/slice name.')],
+ returns=Parameter(int, '1 if successful'))
@export_to_api(1)
def Start(sliver_name):
- """Run start scripts belonging to the specified sliver"""
+ """Configure and start sliver."""
rec = sliver_name
- accounts.get(rec['name']).start()
+ accounts.get(rec['name']).start(rec)
+
@export_to_docbook(roles=['nm-controller', 'self'],
- accepts=[Parameter(str, 'A sliver/slice name.')],
- returns=Parameter(int, '1 if successful'))
+ accepts=[Parameter(str, 'A sliver/slice name.')],
+ returns=Parameter(int, '1 if successful'))
@export_to_api(1)
def Stop(sliver_name):
"""Kill all processes belonging to the specified sliver"""
rec = sliver_name
accounts.get(rec['name']).stop()
+
+@export_to_docbook(roles=['nm-controller', 'self'],
+ accepts=[Parameter(str, 'A sliver/slice name.')],
+ returns=Parameter(int, '1 if successful'))
+@export_to_api(1)
+def ReCreate(sliver_name):
+ """Stop, Destroy, Create, Start sliver in order to reinstall it."""
+ rec = sliver_name
+ accounts.get(rec['name']).stop()
+ accounts.get(rec['name']).ensure_created(rec)
+ accounts.get(rec['name']).start(rec)
+
+
@export_to_docbook(roles=['nm-controller', 'self'],
- accepts=[Parameter(str, 'A sliver/slice name.')],
- returns=Parameter(dict, "A resource specification"))
+ accepts=[Parameter(str, 'A sliver/slice name.')],
+ returns=Parameter(dict, "A resource specification"))
@export_to_api(1)
def GetEffectiveRSpec(sliver_name):
"""Return the RSpec allocated to the specified sliver, including loans"""
rec = sliver_name
return rec.get('_rspec', {}).copy()
+
@export_to_docbook(roles=['nm-controller', 'self'],
- accepts=[Parameter(str, 'A sliver/slice name.')],
- returns={
- "resource name" : Parameter(int, "amount")
- }
- )
+ accepts=[Parameter(str, 'A sliver/slice name.')],
+ returns={"resource name" : Parameter(int, "amount")})
@export_to_api(1)
def GetRSpec(sliver_name):
"""Return the RSpec allocated to the specified sliver, excluding loans"""
rec = sliver_name
return rec.get('rspec', {}).copy()
+
@export_to_docbook(roles=['nm-controller', 'self'],
- accepts=[Parameter(str, 'A sliver/slice name.')],
- returns=(Parameter(str, 'recipient'),
- Parameter(str, 'resource'),
- Parameter(int, 'amount'))
- )
+ accepts=[Parameter(str, 'A sliver/slice name.')],
+ returns=[Mixed(Parameter(str, 'recipient slice name'),
+ Parameter(str, 'resource name'),
+ Parameter(int, 'resource amount'))])
+
@export_to_api(1)
def GetLoans(sliver_name):
"""Return the list of loans made by the specified sliver"""
return type(obj)==list and False not in map(validate_loan, obj)
@export_to_docbook(roles=['nm-controller', 'self'],
- accepts=[ Parameter(str, 'A sliver/slice name.'),
- (Parameter(str, 'recipient'),
- Parameter(str, 'resource'),
- Parameter(int, 'amount')) ],
- returns=Parameter(int, '1 if successful'))
+ accepts=[ Parameter(str, 'A sliver/slice name.'),
+ [Mixed(Parameter(str, 'recipient slice name'),
+ Parameter(str, 'resource name'),
+ Parameter(int, 'resource amount'))] ],
+ returns=Parameter(int, '1 if successful'))
@export_to_api(2)
def SetLoans(sliver_name, loans):
"""Overwrite the list of loans made by the specified sliver.
- Also, note that SetLoans will not throw an error if more capacity than the
- RSpec is handed out, but it will silently discard those loans that would
- put it over capacity. This behavior may be replaced with error semantics
- in the future. As well, there is currently no asynchronous notification
- of loss of resources.
- """
+ Also, note that SetLoans will not throw an error if more capacity than the
+ RSpec is handed out, but it will silently discard those loans that would
+ put it over capacity. This behavior may be replaced with error semantics
+ in the future. As well, there is currently no asynchronous notification
+ of loss of resources.
+ """
rec = sliver_name
if not validate_loans(loans): raise xmlrpclib.Fault(102, 'Invalid argument: the second argument must be a well-formed loan specification')
rec['_loans'] = loans
database.db.sync()
+
+@export_to_docbook(roles=['nm-controller', 'self'],
+ returns=Parameter(dict, 'Record dictionary'))
+@export_to_api(0)
+def GetRecord(sliver_name):
+ """Return sliver record"""
+ rec = sliver_name
+ return rec