4 # Useful information can be found at https://svn.planet-lab.org/wiki/NodeManager
7 # Faiyaz Ahmed <faiyaza at cs dot princeton dot edu>
8 # Copyright (C) 2008 The Trustees of Princeton University
24 from config import Config
25 from plcapi import PLCAPI
29 savedargv = sys.argv[:]
31 # NOTE: modules listed here should also be loaded in this order
32 known_modules=['net','conf_files', 'sm', 'bwmon']
34 plugin_path = "/usr/share/NodeManager/plugins"
36 parser = optparse.OptionParser()
37 parser.add_option('-d', '--daemon', action='store_true', dest='daemon', default=False, help='run daemonized')
38 parser.add_option('-s', '--startup', action='store_true', dest='startup', default=False, help='run all sliver startup scripts')
39 parser.add_option('-f', '--config', action='store', dest='config', default='/etc/planetlab/plc_config', help='PLC configuration file')
40 parser.add_option('-k', '--session', action='store', dest='session', default='/etc/planetlab/session', help='API session key (or file)')
41 parser.add_option('-p', '--period', action='store', dest='period', default=600, help='Polling interval (sec)')
42 parser.add_option('-r', '--random', action='store', dest='random', default=301, help='Range for additional random polling interval (sec)')
43 parser.add_option('-v', '--verbose', action='store_true', dest='verbose', default=False, help='more verbose log')
44 parser.add_option('-P', '--path', action='store', dest='path', default=plugin_path, help='Path to plugins directory')
46 # NOTE: BUG the 'help' for this parser.add_option() wont list plugins from the --path argument
47 parser.add_option('-m', '--module', action='store', dest='module', default='', help='run a single module among '+' '.join(known_modules))
48 (options, args) = parser.parse_args()
50 # Deal with plugins directory
51 if os.path.exists(options.path):
52 sys.path.append(options.path)
53 known_modules += [i[:-3] for i in os.listdir(options.path) if i.endswith(".py") and (i[:-3] not in known_modules)]
57 def GetSlivers(plc, config):
58 '''Run call backs defined in modules'''
60 logger.log("Syncing w/ PLC")
61 data = plc.GetSlivers()
62 if (options.verbose): logger.log_slivers(data)
63 getPLCDefaults(data, config)
66 # XXX So some modules can at least boostrap.
67 logger.log("nm: Can't contact PLC to GetSlivers(). Continuing.")
69 # Invoke GetSlivers() functions from the callback modules
70 for module in modules:
72 callback = getattr(module, 'GetSlivers')
73 callback(plc, data, config)
74 except: logger.log_exc()
77 def getPLCDefaults(data, config):
79 Get PLC wide defaults from _default system slice. Adds them to config class.
81 for slice in data.get('slivers'):
82 if slice['name'] == config.PLC_SLICE_PREFIX+"_default":
84 for attr in slice.get('attributes'): attr_dict[attr['tagname']] = attr['value']
86 logger.verbose("Found default slice overrides.\n %s" % attr_dict)
87 config.OVERRIDES = attr_dict
88 elif 'OVERRIDES' in dir(config): del config.OVERRIDES
93 if options.daemon: tools.daemon()
97 logger.set_level(logger.LOG_VERBOSE)
99 # Load /etc/planetlab/plc_config
100 config = Config(options.config)
103 other_pid = tools.pid_file()
104 if other_pid != None:
105 print """There might be another instance of the node manager running as pid %d. If this is not the case, please remove the pid file %s""" % (other_pid, tools.PID_FILE)
108 print "Warning while writing PID file:", err
110 # Load and start modules
112 assert options.module in known_modules
113 running_modules=[options.module]
114 logger.verbose('Running single module %s'%options.module)
116 running_modules=known_modules
117 for module in running_modules:
119 m = __import__(module)
120 m.start(options, config)
122 except ImportError, err:
123 print "Warning while loading module %s:" % module, err
125 # Load /etc/planetlab/session
126 if os.path.exists(options.session):
127 session = file(options.session).read().strip()
131 # Initialize XML-RPC client
132 iperiod=int(options.period)
133 irandom=int(options.random)
134 plc = PLCAPI(config.plc_api_uri, config.cacert, session, timeout=iperiod/2)
138 logger.verbose('mainloop - nm:getSlivers - period=%d random=%d'%(iperiod,irandom))
139 GetSlivers(plc, config)
140 delay=iperiod + random.randrange(0,irandom)
141 logger.verbose('mainloop - sleeping for %d s'%delay)
143 except: logger.log_exc()
146 if __name__ == '__main__':
147 logger.log("Entering nm.py "+id)
150 # This is for debugging purposes. Open a copy of Python and import nm
151 tools.as_daemon_thread(run)