2 # an attempt to document what a driver class should provide,
3 # and implement reasonable defaults
8 def __init__ (self, config):
9 # this is the hrn attached to the running server
10 self.hrn = config.SFA_INTERFACE_HRN
12 ########################################
13 ########## registry oriented
14 ########################################
16 # redefine this if you want to check again records
17 # when running GetCredential
18 # This is to reflect the 'enabled' user field in planetlab testbeds
19 # expected retcod boolean
20 def is_enabled (self, record) :
23 # the following is used in Resolve (registry) when run in full mode
24 # after looking up the sfa db, we wish to be able to display
25 # testbed-specific info as well
26 # this at minima should fill in the 'researcher' field for slice records
27 # as this information is then used to compute rights
28 # roadmap: there is an intention to redesign the SFA database so as to clear up
29 # this constraint, based on the principle that SFA should not rely on the
30 # testbed database to perform such a core operation (i.e. getting rights right)
31 def augment_records_with_testbed_info (self, sfa_records):
34 # incoming record, as provided by the client to the Register API call
35 # expected retcod 'pointer'
36 # 'pointer' is typically an int db id, that makes sense in the testbed environment
37 # -1 if this feature is not relevant
38 def register (self, sfa_record, hrn, pub_key) :
41 # incoming record is the existing sfa_record
42 # expected retcod boolean, error message logged if result is False
43 def remove (self, sfa_record):
46 # incoming are the sfa_record:
47 # (*) old_sfa_record is what we have in the db for that hrn
48 # (*) new_sfa_record is what was passed in the Update call
49 # expected retcod boolean, error message logged if result is False
51 # this is confusing because a user may have several ssh keys in
52 # the planetlab database, but we need to pick one to generate its cert
53 # so as much as in principle we should be able to use new_sfa_record['keys']
54 # the manager code actually picks one (the first one), and it seems safer
55 # to pass it along rather than depending on the driver code to do the same
58 # when changing the ssh key through this method the gid gets changed too
59 # should anything be passed back to the caller in this case ?
60 def update (self, old_sfa_record, new_sfa_record, hrn, new_key):
63 ########################################
64 ########## aggregate oriented
65 ########################################
67 # a name for identifying the kind of testbed
68 def testbed_name (self): return "undefined"
70 # a dictionary that gets appended to the generic answer to GetVersion
71 # 'geni_request_rspec_versions' and 'geni_ad_rspec_versions' are mandatory
72 def aggregate_version (self): return {}
74 # the answer to SliverStatus on a given slice
75 def sliver_status (self, slice_urn, slice_hrn): return {}
77 # the answer to CreateSliver on a given slice
78 # expected to return a valid rspec
79 # identical to ListResources after the slice was modified
80 def create_sliver (self, slice_urn, slice_hrn, creds, rspec_string, users, options):
81 return "dummy Driver.create_sliver needs to be redefined"
83 # the answer to RenewSliver
84 # expected to return a boolean to indicate success
85 def renew_sliver (self, slice_urn, slice_hrn, creds, expiration_time, options):