reguire gnupg1 on f>=31; sense the system to use gpg1 when installed
[nodemanager.git] / nodemanager.py
index 11be5f9..0fefeae 100755 (executable)
@@ -1,7 +1,4 @@
-#!/usr/bin/python
-#
-# $Id$
-# $URL$
+#!/usr/bin/python3
 #
 # Useful information can be found at https://svn.planet-lab.org/wiki/NodeManager
 #
 # Copyright (C) 2008 The Trustees of Princeton University
 
 
-"""Node Manager"""
+"""
+Node Manager
+"""
 
-import optparse
 import time
-import xmlrpclib
-import socket
 import os
 import sys
-import resource
 import glob
 import pickle
+import random
+from argparse import ArgumentParser
 
 import logger
 import tools
 
 from config import Config
-from plcapi import PLCAPI 
-import random
+from plcapi import PLCAPI
 
 
 class NodeManager:
@@ -38,101 +34,132 @@ class NodeManager:
 
     # the modules in this directory that need to be run
     # NOTE: modules listed here will also be loaded in this order
-    # once loaded, they get re-ordered after their priority (lower comes first) 
+    # once loaded, they get re-ordered after their priority (lower comes first)
     # for determining the runtime order
-    core_modules=['net', 'conf_files', 'slivermanager', 'bwmon']
+    core_modules = ['net', 'conf_files', 'slivermanager', 'bwmon']
 
-    default_period=600
-    default_random=301
-    default_priority=100
+    default_period = 600
+    default_random = 301
+    default_priority = 100
 
     def __init__ (self):
 
-        parser = optparse.OptionParser()
-        parser.add_option('-d', '--daemon', action='store_true', dest='daemon', default=False, help='run daemonized')
-        parser.add_option('-s', '--startup', action='store_true', dest='startup', default=False, help='run all sliver startup scripts')
-        parser.add_option('-f', '--config', action='store', dest='config', default='/etc/planetlab/plc_config', help='PLC configuration file')
-        parser.add_option('-k', '--session', action='store', dest='session', default='/etc/planetlab/session', help='API session key (or file)')
-        parser.add_option('-p', '--period', action='store', dest='period', default=NodeManager.default_period, 
-                          help='Polling interval (sec) - default %d'%NodeManager.default_period)
-        parser.add_option('-r', '--random', action='store', dest='random', default=NodeManager.default_random, 
-                          help='Range for additional random polling interval (sec) -- default %d'%NodeManager.default_random)
-        parser.add_option('-v', '--verbose', action='store_true', dest='verbose', default=False, help='more verbose log')
-        parser.add_option('-P', '--path', action='store', dest='path', default=NodeManager.PLUGIN_PATH, help='Path to plugins directory')
-
-        # NOTE: BUG the 'help' for this parser.add_option() wont list plugins from the --path argument
-        parser.add_option('-m', '--module', action='store', dest='user_module', default='', help='run a single module')
-        (self.options, args) = parser.parse_args()
-
-        if len(args) != 0:
-            parser.print_help()
-            sys.exit(1)
+        parser = ArgumentParser()
+        parser.add_argument(
+            '-d', '--daemon', action='store_true', dest='daemon',
+            default=False,
+            help='run daemonized')
+        parser.add_argument(
+            '-f', '--config', action='store', dest='config',
+            default='/etc/planetlab/plc_config',
+            help='PLC configuration file')
+        parser.add_argument(
+            '-k', '--session', action='store', dest='session',
+            default='/etc/planetlab/session',
+            help='API session key (or file)')
+        parser.add_argument(
+            '-p', '--period', action='store', dest='period',
+            default=NodeManager.default_period,
+            help='Polling interval (sec) - default {}'
+                 .format(NodeManager.default_period))
+        parser.add_argument(
+            '-r', '--random', action='store', dest='random',
+            default=NodeManager.default_random,
+            help='Range for additional random polling interval (sec) -- default {}'
+                 .format(NodeManager.default_random))
+        parser.add_argument(
+            '-v', '--verbose', action='store_true', dest='verbose',
+            default=False,
+            help='more verbose log')
+        parser.add_argument(
+            '-P', '--path', action='store', dest='path',
+            default=NodeManager.PLUGIN_PATH,
+            help='Path to plugins directory')
+
+        parser.add_argument(
+            '-m', '--module', action='store', dest='user_module',
+            default='',
+            help='run a single module')
+        self.options = parser.parse_args()
 
         # determine the modules to be run
         self.modules = NodeManager.core_modules
         # Deal with plugins directory
         if os.path.exists(self.options.path):
             sys.path.append(self.options.path)
-            plugins = [ os.path.split(os.path.splitext(x)[0])[1] for x in glob.glob( os.path.join(self.options.path,'*.py') ) ]
+            plugins = [
+                os.path.split(os.path.splitext(x)[0])[1]
+                for x in glob.glob( os.path.join(self.options.path, '*.py') )
+                if not x.endswith("/__init__.py")
+                ]
             self.modules += plugins
         if self.options.user_module:
             assert self.options.user_module in self.modules
-            self.modules=[self.options.user_module]
-            logger.verbose('nodemanager: Running single module %s'%self.options.user_module)
+            self.modules = [self.options.user_module]
+            logger.verbose('nodemanager: Running single module {}'.format(self.options.user_module))
 
 
     def GetSlivers(self, config, plc):
-        """Retrieves GetSlivers at PLC and triggers callbacks defined in modules/plugins"""
-        try: 
+        """
+        Retrieve GetSlivers at PLC and trigger callbacks defined in modules/plugins
+        """
+        try:
             logger.log("nodemanager: Syncing w/ PLC")
             # retrieve GetSlivers from PLC
             data = plc.GetSlivers()
             # use the magic 'default' slice to retrieve system-wide defaults
             self.getPLCDefaults(data, config)
             # tweak the 'vref' attribute from GetSliceFamily
-            self.setSliversVref (data)
+            self.setSliversVref(data)
             # dump it too, so it can be retrieved later in case of comm. failure
             self.dumpSlivers(data)
             # log it for debug purposes, no matter what verbose is
             logger.log_slivers(data)
             logger.verbose("nodemanager: Sync w/ PLC done")
-            last_data=data
-        except: 
+            last_data = data
+        except:
             logger.log_exc("nodemanager: failed in GetSlivers")
-            #  XXX So some modules can at least boostrap.
+            # XXX So some modules can at least boostrap.
             logger.log("nodemanager:  Can't contact PLC to GetSlivers().  Continuing.")
             data = {}
             # for modules that request it though the 'persistent_data' property
-            last_data=self.loadSlivers()
+            last_data = self.loadSlivers()
+
         #  Invoke GetSlivers() functions from the callback modules
         for module in self.loaded_modules:
-            logger.verbose('nodemanager: triggering %s.GetSlivers'%module.__name__)
-            try:        
+            logger.verbose('nodemanager: triggering {}.GetSlivers'.format(module.__name__))
+            try:
                 callback = getattr(module, 'GetSlivers')
-                module_data=data
-                if getattr(module,'persistent_data',False):
-                    module_data=last_data
+                module_data = data
+                if getattr(module, 'persistent_data', False):
+                    module_data = last_data
                 callback(data, config, plc)
-            except: 
-                logger.log_exc("nodemanager: GetSlivers failed to run callback for module %r"%module)
+            except SystemExit as e:
+                sys.exit(e)
+            except:
+                logger.log_exc("nodemanager: GetSlivers failed to run callback for module {}"
+                               .format(module))
 
 
     def getPLCDefaults(self, data, config):
         """
         Get PLC wide defaults from _default system slice.  Adds them to config class.
         """
-        for slice in data.get('slivers'): 
-            if slice['name'] == config.PLC_SLICE_PREFIX+"_default":
+        for slice in data.get('slivers'):
+            if slice['name'] == config.PLC_SLICE_PREFIX + "_default":
                 attr_dict = {}
-                for attr in slice.get('attributes'): attr_dict[attr['tagname']] = attr['value'] 
-                if len(attr_dict):
-                    logger.verbose("nodemanager: Found default slice overrides.\n %s" % attr_dict)
+                for attr in slice.get('attributes'):
+                    attr_dict[attr['tagname']] = attr['value']
+                if attr_dict:
+                    logger.verbose("nodemanager: Found default slice overrides.\n {}"
+                                   .format(attr_dict))
                     config.OVERRIDES = attr_dict
                     return
         # NOTE: if an _default slice existed, it would have been found above and
-        #          the routine would return.  Thus, if we've gotten here, then no default
-        #          slice is bound to this node.
-        if 'OVERRIDES' in dir(config): del config.OVERRIDES
+        #           the routine would return.  Thus, if we've gotten here, then no default
+        #           slice is bound to this node.
+        if 'OVERRIDES' in dir(config):
+            del config.OVERRIDES
 
 
     def setSliversVref (self, data):
@@ -141,114 +168,148 @@ class NodeManager:
         """
         # GetSlivers exposes the result of GetSliceFamily() as an separate key in data
         # It is safe to override the attributes with this, as this method has the right logic
-        for sliver in data.get('slivers'): 
+        for sliver in data.get('slivers'):
             try:
-                slicefamily=sliver.get('GetSliceFamily')
+                slicefamily = sliver.get('GetSliceFamily')
                 for att in sliver['attributes']:
-                    if att['tagname']=='vref': 
-                        att['value']=slicefamily
+                    if att['tagname'] == 'vref':
+                        att['value'] = slicefamily
                         continue
-                sliver['attributes'].append({ 'tagname':'vref','value':slicefamily})
-            except:
-                logger.log_exc("nodemanager: Could not overwrite 'vref' attribute from 'GetSliceFamily'",name=sliver['name'])
-    
+                sliver['attributes'].append(
+                    {'tagname': 'vref', 'value': slicefamily})
+            except Exception:
+                logger.log_exc(
+                    "nodemanager: Could not overwrite 'vref' attribute from 'GetSliceFamily'",
+                    name=sliver['name'])
+
+
     def dumpSlivers (self, slivers):
-        f = open(NodeManager.DB_FILE, "w")
-        logger.log ("nodemanager: saving successfully fetched GetSlivers in %s" % NodeManager.DB_FILE)
-        pickle.dump(slivers, f)
-        f.close()
-    
+        with open(NodeManager.DB_FILE, "wb") as feed:
+            logger.log ("nodemanager: saving successfully fetched GetSlivers in {}"
+                        .format(NodeManager.DB_FILE))
+            pickle.dump(slivers, feed)
+
+
     def loadSlivers (self):
         try:
-            f = open(NodeManager.DB_FILE, "r+")
-            logger.log("nodemanager: restoring latest known GetSlivers from %s" % NodeManager.DB_FILE)
-            slivers = pickle.load(f)
-            f.close()
+            with open(NodeManager.DB_FILE, "rb+") as feed:
+                logger.log("nodemanager: restoring latest known GetSlivers from {}"
+                           .format(NodeManager.DB_FILE))
+                slivers = pickle.load(feed)
             return slivers
         except:
-            logger.log("Could not restore GetSlivers from %s" % NodeManager.DB_FILE)
+            logger.log("Could not restore GetSlivers from {}"
+                       .format(NodeManager.DB_FILE))
             return {}
-    
+
     def run(self):
+        # make sure to create /etc/planetlab/virt so others can read that
+        # used e.g. in vsys-scripts's sliceip
+        tools.get_node_virt()
         try:
-            if self.options.daemon: tools.daemon()
-    
+            if self.options.daemon:
+                tools.daemon()
+
             # set log level
-            if (self.options.verbose):
+            if self.options.verbose:
                 logger.set_level(logger.LOG_VERBOSE)
-    
+            tools.init_signals()
+
             # Load /etc/planetlab/plc_config
             config = Config(self.options.config)
-    
+
             try:
                 other_pid = tools.pid_file()
-                if other_pid != None:
-                    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)
+                if other_pid is not None:
+                    print("""There might be another instance of the node manager running as pid {}.
+If this is not the case, please remove the pid file {}. -- exiting"""
+                          .format(other_pid, tools.PID_FILE))
                     return
-            except OSError, err:
-                print "Warning while writing PID file:", err
-    
+            except OSError as err:
+                print("Warning while writing PID file:", err)
+
             # load modules
             self.loaded_modules = []
             for module in self.modules:
                 try:
                     m = __import__(module)
-                    logger.verbose("nodemanager: triggering %s.start"%m.__name__)
-                    m.start(self.options, config)
+                    logger.verbose("nodemanager: triggering {}.start".format(m.__name__))
+                    try:
+                        m.start()
+                    except Exception:
+                        logger.log("WARNING: module {} did not start".format(m.__name__))
                     self.loaded_modules.append(m)
-                except ImportError, err:
-                    print "Warning while loading module %s:" % module, err
-    
+                except Exception:
+                    if module not in NodeManager.core_modules:
+                        logger.log_exc("ERROR while loading module {} - skipped"
+                                       .format(module))
+                    else:
+                        logger.log("FATAL : failed to start core module {}".format(module))
+                        sys.exit(1)
+
             # sort on priority (lower first)
-            def sort_module_priority (m1,m2):
-                return getattr(m1,'priority',NodeManager.default_priority) - getattr(m2,'priority',NodeManager.default_priority)
-            self.loaded_modules.sort(sort_module_priority)
-    
+            def module_priority(module):
+                return getattr(module, 'priority', NodeManager.default_priority)
+            self.loaded_modules.sort(key=module_priority)
+
             logger.log('ordered modules:')
-            for module in self.loaded_modules: 
-                logger.log ('%s: %s'%(getattr(module,'priority',NodeManager.default_priority),module.__name__))
-    
+            for module in self.loaded_modules:
+                logger.log('{}: {}'
+                           .format(getattr(module, 'priority',
+                                           NodeManager.default_priority),
+                                   module.__name__))
+
             # Load /etc/planetlab/session
             if os.path.exists(self.options.session):
-                session = file(self.options.session).read().strip()
+                with open(self.options.session) as feed:
+                    session = feed.read().strip()
             else:
                 session = None
-    
-    
+
+
             # get random periods
-            iperiod=int(self.options.period)
-            irandom=int(self.options.random)
-    
+            iperiod = int(self.options.period)
+            irandom = int(self.options.random)
+
             # Initialize XML-RPC client
             plc = PLCAPI(config.plc_api_uri, config.cacert, session, timeout=iperiod/2)
-    
+
             #check auth
             logger.log("nodemanager: Checking Auth.")
-            while plc.check_authentication() != True:
+            while not plc.check_authentication():
                 try:
                     plc.update_session()
                     logger.log("nodemanager: Authentication Failure. Retrying")
-                except Exception,e:
-                    logger.log("nodemanager: Retry Failed. (%r); Waiting.."%e)
+                except Exception as exc:
+                    logger.log("nodemanager: Retry Failed. ({}); Waiting.."
+                               .format(exc))
                 time.sleep(iperiod)
             logger.log("nodemanager: Authentication Succeeded!")
-    
-    
+
+
             while True:
             # Main nodemanager Loop
-                logger.log('nodemanager: mainloop - calling GetSlivers - period=%d random=%d'%(iperiod,irandom))
+                work_beg = time.time()
+                logger.log('nodemanager: mainloop - calling GetSlivers - period={} random={}'
+                           .format(iperiod, irandom))
                 self.GetSlivers(config, plc)
-                delay=iperiod + random.randrange(0,irandom)
-                logger.log('nodemanager: mainloop - sleeping for %d s'%delay)
+                delay = iperiod + random.randrange(0, irandom)
+                work_end = time.time()
+                work_duration = int(work_end-work_beg)
+                logger.log('nodemanager: mainloop has worked for {} s - sleeping for {} s'
+                           .format(work_duration, delay))
                 time.sleep(delay)
-        except: logger.log_exc("nodemanager: failed in run")
+        except SystemExit:
+            pass
+        except:
+            logger.log_exc("nodemanager: failed in run")
 
 def run():
     logger.log("======================================== Entering nodemanager.py")
     NodeManager().run()
-    
+
 if __name__ == '__main__':
     run()
 else:
-    # This is for debugging purposes.  Open a copy of Python and import nm
+    # This is for debugging purposes.  Open a copy of Python and import nodemanager
     tools.as_daemon_thread(run)