4 # Helper functions that minipulate the PLC api.
6 # Faiyaz Ahmed <faiyaza@cs.princeton.edu
8 # $Id: plc.py,v 1.18 2007/08/29 17:26:50 soltesz Exp $
18 self.auth = {'AuthMethod': "anonymous"}
23 from config import config
29 XMLRPC_SERVER="https://boot.planet-lab.org/PLCAPI/"
31 logger = logging.getLogger("monitor")
33 api = xmlrpclib.Server(XMLRPC_SERVER, verbose=False, allow_none=True)
36 api = xmlrpclib.Server(url, verbose=False, allow_none=True)
40 def __init__(self, auth, url):
43 self.api = xmlrpclib.Server(self.url, verbose=False, allow_none=True)
45 def __getattr__(self, name):
46 method = getattr(self.api, name)
48 raise AssertionError("method does not exist")
50 return lambda *params : method(self.auth, *params)
53 return self.api.__repr__()
57 return PLC(auth.auth, auth.plc)
60 Returns list of nodes in dbg as reported by PLC
64 api = xmlrpclib.Server(XMLRPC_SERVER, verbose=False)
65 anon = {'AuthMethod': "anonymous"}
66 for node in api.GetNodes(anon, {"boot_state":"dbg"},["hostname"]):
67 dbgNodes.append(node['hostname'])
68 logger.info("%s nodes in debug according to PLC." %len(dbgNodes))
73 Returns loginbase for given nodename
76 api = xmlrpclib.Server(XMLRPC_SERVER, verbose=False)
77 anon = {'AuthMethod': "anonymous"}
78 site_id = api.GetNodes (anon, {"hostname": nodename}, ['site_id'])
80 loginbase = api.GetSites (anon, site_id[0], ["login_base"])
81 return loginbase[0]['login_base']
84 Returns list of slices for a site.
86 def slices(loginbase):
88 api = xmlrpclib.Server(XMLRPC_SERVER, verbose=False)
89 sliceids = api.GetSites (auth.auth, {"login_base" : loginbase}, ["slice_ids"])[0]['slice_ids']
90 for slice in api.GetSlices(auth.auth, {"slice_id" : sliceids}, ["name"]):
91 siteslices.append(slice['name'])
95 Returns dict of PCU info of a given node.
98 api = xmlrpclib.Server(XMLRPC_SERVER, verbose=False)
99 anon = {'AuthMethod': "anonymous"}
100 nodeinfo = api.GetNodes(auth.auth, {"hostname": nodename}, ["pcu_ids", "ports"])[0]
101 if nodeinfo['pcu_ids']:
102 sitepcu = api.GetPCUs(auth.auth, nodeinfo['pcu_ids'])[0]
103 sitepcu[nodename] = nodeinfo["ports"][0]
106 logger.info("%s doesn't have PCU" % nodename)
109 def GetPCUs(filter=None, fields=None):
110 api = xmlrpclib.Server(XMLRPC_SERVER, verbose=False, allow_none=True)
111 pcu_list = api.GetPCUs(auth.auth, filter, fields)
115 Returns all site nodes for site id (loginbase).
117 def getSiteNodes(loginbase, fields=None):
118 api = xmlrpclib.Server(XMLRPC_SERVER, verbose=False)
120 anon = {'AuthMethod': "anonymous"}
122 nodeids = api.GetSites(anon, {"login_base": loginbase}, fields)[0]['node_ids']
123 for node in api.GetNodes(anon, {"node_id": nodeids}, ['hostname']):
124 nodelist.append(node['hostname'])
125 except Exception, exc:
126 logger.info("getSiteNodes: %s" % exc)
127 print "getSiteNodes: %s" % exc
130 def getPersons(filter=None, fields=None):
131 api = xmlrpclib.Server(XMLRPC_SERVER, verbose=False, allow_none=True)
134 persons = api.GetPersons(auth.auth, filter, fields)
135 except Exception, exc:
136 print "getPersons: %s" % exc
137 logger.info("getPersons: %s" % exc)
140 def getSites(filter=None, fields=None):
141 api = xmlrpclib.Server(XMLRPC_SERVER, verbose=False, allow_none=True)
143 anon = {'AuthMethod': "anonymous"}
145 #sites = api.GetSites(anon, filter, fields)
146 sites = api.GetSites(auth.auth, filter, fields)
147 except Exception, exc:
149 traceback.print_exc()
150 print "getSites: %s" % exc
151 logger.info("getSites: %s" % exc)
154 def getSiteNodes2(loginbase):
155 api = xmlrpclib.Server(XMLRPC_SERVER, verbose=False)
157 anon = {'AuthMethod': "anonymous"}
159 nodeids = api.GetSites(anon, {"login_base": loginbase})[0]['node_ids']
160 nodelist += getNodes({'node_id':nodeids})
161 except Exception, exc:
162 logger.info("getSiteNodes2: %s" % exc)
165 def getNodeNetworks(filter=None):
166 api = xmlrpclib.Server(XMLRPC_SERVER, verbose=False, allow_none=True)
167 nodenetworks = api.GetNodeNetworks(auth.auth, filter, None)
170 def getNodes(filter=None, fields=None):
171 api = xmlrpclib.Server(XMLRPC_SERVER, verbose=False, allow_none=True)
172 nodes = api.GetNodes(auth.auth, filter, fields)
173 #['boot_state', 'hostname',
174 #'site_id', 'date_created', 'node_id', 'version', 'nodenetwork_ids',
175 #'last_updated', 'peer_node_id', 'ssh_rsa_key' ])
179 Sets boot state of a node.
181 def nodeBootState(nodename, state):
182 api = xmlrpclib.Server(XMLRPC_SERVER, verbose=False)
184 return api.UpdateNode(auth.auth, nodename, {'boot_state': state})
185 except Exception, exc:
186 logger.info("nodeBootState: %s" % exc)
188 def updateNodeKey(nodename, key):
189 api = xmlrpclib.Server(XMLRPC_SERVER, verbose=False)
191 return api.UpdateNode(auth.auth, nodename, {'key': key})
192 except Exception, exc:
193 logger.info("updateNodeKey: %s" % exc)
196 Sends Ping Of Death to node.
198 def nodePOD(nodename):
199 api = xmlrpclib.Server(XMLRPC_SERVER, verbose=False)
200 logger.info("Sending POD to %s" % nodename)
203 return api.RebootNode(auth.auth, nodename)
204 except Exception, exc:
205 logger.info("nodePOD: %s" % exc)
208 Freeze all site slices.
210 def suspendSlices(nodename):
211 api = xmlrpclib.Server(XMLRPC_SERVER, verbose=False)
212 for slice in slices(siteId(nodename)):
213 logger.info("Suspending slice %s" % slice)
216 api.AddSliceAttribute(auth.auth, slice, "enabled", "0")
217 except Exception, exc:
218 logger.info("suspendSlices: %s" % exc)
220 def enableSlices(nodename):
221 api = xmlrpclib.Server(XMLRPC_SERVER, verbose=False, allow_none=True)
222 for slice in slices(siteId(nodename)):
223 logger.info("Enabling slices %s" % slice)
226 slice_list = api.GetSlices(auth.auth, {'name': slice}, None)
227 if len(slice_list) == 0:
229 slice_id = slice_list[0]['slice_id']
230 l_attr = api.GetSliceAttributes(auth.auth, {'slice_id': slice_id}, None)
232 if "enabled" == attr['name'] and attr['value'] == "0":
233 logger.info("Deleted enable=0 attribute from slice %s" % slice)
234 api.DeleteSliceAttribute(auth.auth, attr['slice_attribute_id'])
235 except Exception, exc:
236 logger.info("enableSlices: %s" % exc)
237 print "exception: %s" % exc
239 #I'm commenting this because this really should be a manual process.
241 #Enable suspended site slices.
243 #def enableSlices(nodename, slicelist):
244 # api = xmlrpclib.Server(XMLRPC_SERVER, verbose=False)
245 # for slice in slices(siteId(nodename)):
246 # logger.info("Suspending slice %s" % slice)
247 # api.SliceAttributeAdd(auth.auth, slice, "plc_slice_state", {"state" : "suspended"})
249 def enableSliceCreation(nodename):
250 api = xmlrpclib.Server(XMLRPC_SERVER, verbose=False, allow_none=True)
252 loginbase = siteId(nodename)
253 logger.info("Enabling slice creation for site %s" % loginbase)
255 logger.info("\tcalling UpdateSite(%s, enabled=True)" % loginbase)
256 api.UpdateSite(auth.auth, loginbase, {'enabled': True})
257 except Exception, exc:
258 print "ERROR: enableSliceCreation: %s" % exc
259 logger.info("ERROR: enableSliceCreation: %s" % exc)
262 Removes ability to create slices. Returns previous max_slices
264 def removeSliceCreation(nodename):
265 print "removeSliceCreation(%s)" % nodename
266 api = xmlrpclib.Server(XMLRPC_SERVER, verbose=False)
268 loginbase = siteId(nodename)
269 #numslices = api.GetSites(auth.auth, {"login_base": loginbase},
270 # ["max_slices"])[0]['max_slices']
271 logger.info("Removing slice creation for site %s" % loginbase)
273 #api.UpdateSite(auth.auth, loginbase, {'max_slices': 0})
274 api.UpdateSite(auth.auth, loginbase, {'enabled': False})
275 except Exception, exc:
276 logger.info("removeSliceCreation: %s" % exc)
281 #def enableSliceCreation(nodename, maxslices):
282 # api = xmlrpclib.Server(XMLRPC_SERVER, verbose=False)
283 # anon = {'AuthMethod': "anonymous"}
284 # siteid = api.AnonAdmQuerySite (anon, {"node_hostname": nodename})
285 # if len(siteid) == 1:
286 # logger.info("Enabling slice creation for site %s" % siteId(nodename))
289 # api.AdmUpdateSite(auth.auth, siteid[0], {"max_slices" : maxslices})
290 # except Exception, exc:
291 # logger.info("API: %s" % exc)
293 # logger.debug("Cant find site for %s. Cannot enable creation." % nodename)
296 logger.setLevel(logging.DEBUG)
297 ch = logging.StreamHandler()
298 ch.setLevel(logging.DEBUG)
299 formatter = logging.Formatter('logger - %(message)s')
300 ch.setFormatter(formatter)
301 logger.addHandler(ch)
302 #print getpcu("kupl2.ittc.ku.edu")
303 #print getpcu("planetlab1.cse.msu.edu")
304 #print getpcu("alice.cs.princeton.edu")
306 #nodeBootState("alice.cs.princeton.edu", "boot")
307 #freezeSite("alice.cs.princeton.edu")
308 print removeSliceCreation("alice.cs.princeton.edu")
309 #enableSliceCreation("alice.cs.princeton.edu", 1024)
310 #print getSiteNodes("princeton")
311 #print siteId("alice.cs.princeton.edu")
312 #print nodePOD("alice.cs.princeton.edu")
313 #print slices("princeton")
315 if __name__=="__main__":