system/TestMain.py

   1 #!/usr/bin/python -u
   2 # $Id$
   3
   4 import sys, os, os.path
   5 from optparse import OptionParser
   6 import traceback
   7 from time import strftime
   8 import readline
   9
  10 import utils
  11 from TestPlc import TestPlc
  12 from TestSite import TestSite
  13 from TestNode import TestNode
  14
  15 # add $HOME in PYTHONPATH so we can import LocalTestResources.py
  16 sys.path.append(os.environ['HOME'])
  17 import LocalTestResources
  18
  19 class TestMain:
  20
  21     subversion_id = "$Id$"
  22
  23     default_config = [ 'default' ]
  24
  25     default_build_url = "http://svn.planet-lab.org/svn/build/trunk"
  26
  27     def __init__ (self):
  28         self.path=os.path.dirname(sys.argv[0]) or "."
  29         os.chdir(self.path)
  30
  31     def show_env (self,options, message):
  32         if self.options.verbose:
  33             utils.header (message)
  34             utils.show_options("main options",options)
  35
  36     def init_steps(self):
  37         self.steps_message=20*'x'+" Defaut steps are\n"+TestPlc.printable_steps(TestPlc.default_steps)
  38         self.steps_message += "\n"+20*'x'+" Other useful steps are\n"+TestPlc.printable_steps(TestPlc.other_steps)
  39
  40     def list_steps(self):
  41         if not self.options.verbose:
  42             print self.steps_message
  43         else:
  44             testplc_method_dict = __import__("TestPlc").__dict__['TestPlc'].__dict__
  45             scopes = [("Default steps",TestPlc.default_steps)]
  46             if self.options.all_steps:
  47                 scopes.append ( ("Other steps",TestPlc.other_steps) )
  48             for (scope,steps) in scopes:
  49                 print '--------------------',scope
  50                 for step in [step for step in steps if TestPlc.valid_step(step)]:
  51                     stepname=step
  52                     if step.find("force_") == 0:
  53                         stepname=step.replace("force_","")
  54                         force=True
  55                     print '*',step,"\r",4*"\t",
  56                     try:
  57                         print testplc_method_dict[stepname].__doc__
  58                     except:
  59                         print "*** no doc found"
  60
  61     @staticmethod
  62     def optparse_list (option, opt, value, parser):
  63         try:
  64             setattr(parser.values,option.dest,getattr(parser.values,option.dest)+value.split())
  65         except:
  66             setattr(parser.values,option.dest,value.split())
  67
  68     def run (self):
  69         self.init_steps()
  70         usage = """usage: %%prog [options] steps
  71 arch-rpms-url defaults to the last value used, as stored in arg-arch-rpms-url,
  72    no default
  73 build-url defaults to the last value used, as stored in arg-build-url,
  74    or %s
  75 config defaults to the last value used, as stored in arg-config,
  76    or %r
  77 ips_node, ips_plc and ips_qemu defaults to the last value used, as stored in arg-ips-{node,plc,qemu},
  78    default is to use IP scanning
  79 steps refer to a method in TestPlc or to a step_* module
  80 ===
  81 """%(TestMain.default_build_url,TestMain.default_config)
  82         usage += self.steps_message
  83         parser=OptionParser(usage=usage,version=self.subversion_id)
  84         parser.add_option("-u","--url",action="store", dest="arch_rpms_url",
  85                           help="URL of the arch-dependent RPMS area - for locating what to test")
  86         parser.add_option("-b","--build",action="store", dest="build_url",
  87                           help="Build URL - for locating vtest-init-vserver.sh")
  88         parser.add_option("-c","--config",action="callback", callback=TestMain.optparse_list, dest="config",
  89                           nargs=1,type="string",
  90                           help="Config module - can be set multiple times, or use quotes")
  91         parser.add_option("-p","--personality",action="store", dest="personality",
  92                           help="personality - as in vbuild-nightly")
  93         parser.add_option("-d","--pldistro",action="store", dest="pldistro",
  94                           help="pldistro - as in vbuild-nightly")
  95         parser.add_option("-f","--fcdistro",action="store", dest="fcdistro",
  96                           help="fcdistro - as in vbuild-nightly")
  97         parser.add_option("-x","--exclude",action="callback", callback=TestMain.optparse_list, dest="exclude",
  98                           nargs=1,type="string",default=[],
  99                           help="steps to exclude - can be set multiple times, or use quotes")
 100         parser.add_option("-a","--all",action="store_true",dest="all_steps", default=False,
 101                           help="Run all default steps")
 102         parser.add_option("-l","--list",action="store_true",dest="list_steps", default=False,
 103                           help="List known steps")
 104         parser.add_option("-N","--nodes",action="callback", callback=TestMain.optparse_list, dest="ips_node",
 105                           nargs=1,type="string",
 106                           help="Specify the set of hostname/IP's to use for nodes")
 107         parser.add_option("-P","--plcs",action="callback", callback=TestMain.optparse_list, dest="ips_plc",
 108                           nargs=1,type="string",
 109                           help="Specify the set of hostname/IP's to use for plcs")
 110         parser.add_option("-Q","--qemus",action="callback", callback=TestMain.optparse_list, dest="ips_qemu",
 111                           nargs=1,type="string",
 112                           help="Specify the set of hostname/IP's to use for qemu boxes")
 113         parser.add_option("-s","--size",action="store",type="int",dest="size",default=1,
 114                           help="sets test size in # of plcs - default is 1")
 115         parser.add_option("-D","--dbname",action="store",dest="dbname",default=None,
 116                            help="Used by db_dump and db_restore")
 117         parser.add_option("-v","--verbose", action="store_true", dest="verbose", default=False,
 118                           help="Run in verbose mode")
 119         parser.add_option("-i","--interactive",action="store_true",dest="interactive",default=False,
 120                           help="prompts before each step")
 121         parser.add_option("-n","--dry-run", action="store_true", dest="dry_run", default=False,
 122                           help="Show environment and exits")
 123         parser.add_option("-r","--restart-nm", action="store_true", dest="forcenm", default=False,
 124                           help="Force the NM to restart in check_slices step")
 125         parser.add_option("-t","--trace", action="store", dest="trace_file", default=None,
 126                           #default="logs/trace-@TIME@.txt",
 127                           help="Trace file location")
 128         (self.options, self.args) = parser.parse_args()
 129
 130         # no step specified
 131         if len(self.args) == 0:
 132             self.options.steps=TestPlc.default_steps
 133         else:
 134             self.options.steps = self.args
 135
 136         if self.options.list_steps:
 137             self.list_steps()
 138             sys.exit(1)
 139
 140         # handle defaults and option persistence
 141         for (recname,filename,default) in (
 142             ('build_url','arg-build-url',TestMain.default_build_url) ,
 143             ('ips_node','arg-ips-node',[]) ,
 144             ('ips_plc','arg-ips-plc',[]) ,
 145             ('ips_qemu','arg-ips-qemu',[]) ,
 146             ('config','arg-config',TestMain.default_config) ,
 147             ('arch_rpms_url','arg-arch-rpms-url',"") ,
 148             ('personality','arg-personality',"linux32"),
 149             ('pldistro','arg-pldistro',"planetlab"),
 150             ('fcdistro','arg-fcdistro','centos5'),
 151             ) :
 152 #            print 'handling',recname
 153             path=filename
 154             is_list = isinstance(default,list)
 155             if not getattr(self.options,recname):
 156                 try:
 157                     parsed=file(path).readlines()
 158                     if not is_list:    # strings
 159                         if len(parsed) != 1:
 160                             print "%s - error when parsing %s"%(sys.argv[1],path)
 161                             sys.exit(1)
 162                         parsed=parsed[0].strip()
 163                     else:              # lists
 164                         parsed=[x.strip() for x in parsed]
 165                     setattr(self.options,recname,parsed)
 166                 except:
 167                     if default != "":
 168                         setattr(self.options,recname,default)
 169                     else:
 170                         print "Cannot determine",recname
 171                         print "Run %s --help for help"%sys.argv[0]
 172                         sys.exit(1)
 173
 174             # save for next run
 175             fsave=open(path,"w")
 176             if not is_list:
 177                 fsave.write(getattr(self.options,recname) + "\n")
 178             else:
 179                 for value in getattr(self.options,recname):
 180                     fsave.write(value + "\n")
 181             fsave.close()
 182 #            utils.header('Saved %s into %s'%(recname,filename))
 183
 184             # lists need be reversed
 185             if isinstance(getattr(self.options,recname),list):
 186                 getattr(self.options,recname).reverse()
 187
 188             if self.options.verbose:
 189                 utils.header('* Using %s = %s'%(recname,getattr(self.options,recname)))
 190
 191
 192         # steps
 193         if not self.options.steps:
 194             #default (all) steps
 195             #self.options.steps=['dump','clean','install','populate']
 196             self.options.steps=TestPlc.default_steps
 197
 198         # rewrite '-' into '_' in step names
 199         self.options.steps = [ step.replace('-','_') for step in self.options.steps ]
 200
 201         # exclude
 202         selected=[]
 203         for step in self.options.steps:
 204             keep=True
 205             for exclude in self.options.exclude:
 206                 if utils.match(step,exclude):
 207                     keep=False
 208                     break
 209             if keep: selected.append(step)
 210         self.options.steps=selected
 211
 212         # this is useful when propagating on host boxes, to avoid conflicts
 213         self.options.buildname = os.path.basename (os.path.abspath (self.path))
 214
 215         if self.options.verbose:
 216             self.show_env(self.options,"Verbose")
 217
 218         # load configs
 219         all_plc_specs = []
 220         for config in self.options.config:
 221             modulename='config_'+config
 222             try:
 223                 m = __import__(modulename)
 224                 all_plc_specs = m.config(all_plc_specs,self.options)
 225             except :
 226                 traceback.print_exc()
 227                 print 'Cannot load config %s -- ignored'%modulename
 228                 raise
 229
 230         # run localize as defined by local_resources
 231         all_plc_specs = LocalTestResources.local_resources.localize(all_plc_specs,self.options)
 232
 233         # remember plc IP address(es) if not specified
 234         ips_plc_file=open('arg-ips-plc','w')
 235         for plc_spec in all_plc_specs:
 236             ips_plc_file.write("%s\n"%plc_spec['PLC_API_HOST'])
 237         ips_plc_file.close()
 238         # ditto for nodes
 239         ips_node_file=open('arg-ips-node','w')
 240         for plc_spec in all_plc_specs:
 241             for site_spec in plc_spec['sites']:
 242                 for node_spec in site_spec['nodes']:
 243                     ips_node_file.write("%s\n"%node_spec['node_fields']['hostname'])
 244         ips_node_file.close()
 245         # ditto for qemu boxes
 246         ips_qemu_file=open('arg-ips-qemu','w')
 247         for plc_spec in all_plc_specs:
 248             for site_spec in plc_spec['sites']:
 249                 for node_spec in site_spec['nodes']:
 250                     ips_qemu_file.write("%s\n"%node_spec['host_box'])
 251         ips_qemu_file.close()
 252         # build a TestPlc object from the result, passing options
 253         for spec in all_plc_specs:
 254             spec['disabled'] = False
 255         all_plcs = [ (x, TestPlc(x,self.options)) for x in all_plc_specs]
 256
 257         # pass options to utils as well
 258         utils.init_options(self.options)
 259
 260         overall_result = True
 261         testplc_method_dict = __import__("TestPlc").__dict__['TestPlc'].__dict__
 262         all_step_infos=[]
 263         for step in self.options.steps:
 264             if not TestPlc.valid_step(step):
 265                 continue
 266             force=False
 267             # is it a forced step
 268             if step.find("force_") == 0:
 269                 step=step.replace("force_","")
 270                 force=True
 271             # try and locate a method in TestPlc
 272             if testplc_method_dict.has_key(step):
 273                 all_step_infos += [ (step, testplc_method_dict[step] , force)]
 274             # otherwise search for the 'run' method in the step_<x> module
 275             else:
 276                 modulename='step_'+step
 277                 try:
 278                     # locate all methods named run* in the module
 279                     module_dict = __import__(modulename).__dict__
 280                     names = [ key for key in module_dict.keys() if key.find("run")==0 ]
 281                     if not names:
 282                         raise Exception,"No run* method in module %s"%modulename
 283                     names.sort()
 284                     all_step_infos += [ ("%s.%s"%(step,name),module_dict[name],force) for name in names ]
 285                 except :
 286                     print '********** step %s NOT FOUND -- ignored'%(step)
 287                     traceback.print_exc()
 288                     overall_result = False
 289
 290         if self.options.dry_run:
 291             self.show_env(self.options,"Dry run")
 292
 293         # init & open trace file if provided
 294         if self.options.trace_file and not self.options.dry_run:
 295             time=strftime("%H-%M")
 296             date=strftime("%Y-%m-%d")
 297             trace_file=self.options.trace_file
 298             trace_file=trace_file.replace("@TIME@",time)
 299             trace_file=trace_file.replace("@DATE@",date)
 300             self.options.trace_file=trace_file
 301             # create dir if needed
 302             trace_dir=os.path.dirname(trace_file)
 303             if trace_dir and not os.path.isdir(trace_dir):
 304                 os.makedirs(trace_dir)
 305             trace=open(trace_file,"w")
 306
 307         # do all steps on all plcs
 308         TRACE_FORMAT="TRACE: time=%(time)s status=%(status)s step=%(stepname)s plc=%(plcname)s force=%(force)s\n"
 309         for (stepname,method,force) in all_step_infos:
 310             for (spec,obj) in all_plcs:
 311                 plcname=spec['name']
 312
 313                 # run the step
 314                 time=strftime("%Y-%m-%d-%H-%M")
 315                 if not spec['disabled'] or force or self.options.interactive:
 316                     skip_step=False
 317                     if self.options.interactive:
 318                         prompting=True
 319                         while prompting:
 320                             msg="Run step %s on %s [r](un)/d(ry_run)/s(kip)/q(uit) ? "%(stepname,plcname)
 321                             answer=raw_input(msg).strip().lower() or "r"
 322                             answer=answer[0]
 323                             if answer in ['s','n']:     # skip/no/next
 324                                 print '%s on %s skipped'%(stepname,plcname)
 325                                 prompting=False
 326                                 skip_step=True
 327                             elif answer in ['q','b']:   # quit/bye
 328                                 print 'Exiting'
 329                                 return
 330                             elif answer in ['d']:       # dry_run
 331                                 dry_run=self.options.dry_run
 332                                 self.options.dry_run=True
 333                                 obj.options.dry_run=True
 334                                 obj.apiserver.set_dry_run(True)
 335                                 step_result=method(obj)
 336                                 print 'dry_run step ->',step_result
 337                                 self.options.dry_run=dry_run
 338                                 obj.options.dry_run=dry_run
 339                                 obj.apiserver.set_dry_run(dry_run)
 340                             elif answer in ['r','y']:   # run/yes
 341                                 prompting=False
 342                     if skip_step:
 343                         continue
 344                     try:
 345                         force_msg=""
 346                         if force: force_msg=" (forced)"
 347                         utils.header("********** RUNNING step %s%s on plc %s"%(stepname,force_msg,plcname))
 348                         step_result = method(obj)
 349                         if step_result:
 350                             utils.header('********** SUCCESSFUL step %s on %s'%(stepname,plcname))
 351                             status="OK"
 352                         else:
 353                             overall_result = False
 354                             spec['disabled'] = True
 355                             utils.header('********** FAILED Step %s on %s - discarding that plc from further steps'%(stepname,plcname))
 356                             status="KO"
 357                     except:
 358                         overall_result=False
 359                         spec['disabled'] = True
 360                         traceback.print_exc()
 361                         utils.header ('********** FAILED (exception) Step %s on plc %s - discarding this plc from further steps'%(stepname,plcname))
 362                         status="KO"
 363
 364                 # do not run, just display it's skipped
 365                 else:
 366                     utils.header("********** IGNORED Plc %s is disabled - skipping step %s"%(plcname,stepname))
 367                     status="UNDEF"
 368                 if not self.options.dry_run:
 369                     # alwas do this on stdout
 370                     print TRACE_FORMAT%locals()
 371                     # duplicate on trace_file if provided
 372                     if self.options.trace_file:
 373                         trace.write(TRACE_FORMAT%locals())
 374                         trace.flush()
 375
 376         if self.options.trace_file and not self.options.dry_run:
 377             trace.close()
 378
 379         return overall_result
 380
 381     # wrapper to run, returns a shell-compatible result
 382     def main(self):
 383         try:
 384             success=self.run()
 385             if success:
 386                 return 0
 387             else:
 388                 return 1
 389         except SystemExit:
 390             raise
 391         except:
 392             traceback.print_exc()
 393             return 2
 394
 395 if __name__ == "__main__":
 396     sys.exit(TestMain().main())