c593e4d966e438ea2dabc51f97a5fb51e02c3270
[tests.git] / system / TestPlc.py
1 # $Id$
2 import os, os.path
3 import datetime
4 import time
5 import sys
6 import traceback
7 from types import StringTypes
8 import socket
9
10 import utils
11 from TestSite import TestSite
12 from TestNode import TestNode
13 from TestUser import TestUser
14 from TestKey import TestKey
15 from TestSlice import TestSlice
16 from TestSliver import TestSliver
17 from TestBox import TestBox
18 from TestSsh import TestSsh
19 from TestApiserver import TestApiserver
20 from TestSliceSfa import TestSliceSfa
21 from TestUserSfa import TestUserSfa
22
23 # step methods must take (self) and return a boolean (options is a member of the class)
24
25 def standby(minutes,dry_run):
26     utils.header('Entering StandBy for %d mn'%minutes)
27     if dry_run:
28         print 'dry_run'
29     else:
30         time.sleep(60*minutes)
31     return True
32
33 def standby_generic (func):
34     def actual(self):
35         minutes=int(func.__name__.split("_")[1])
36         return standby(minutes,self.options.dry_run)
37     return actual
38
39 def node_mapper (method):
40     def actual(self):
41         overall=True
42         node_method = TestNode.__dict__[method.__name__]
43         for site_spec in self.plc_spec['sites']:
44             test_site = TestSite (self,site_spec)
45             for node_spec in site_spec['nodes']:
46                 test_node = TestNode (self,test_site,node_spec)
47                 if not node_method(test_node): overall=False
48         return overall
49     # restore the doc text
50     actual.__doc__=method.__doc__
51     return actual
52
53 def slice_mapper_options (method):
54     def actual(self):
55         overall=True
56         slice_method = TestSlice.__dict__[method.__name__]
57         for slice_spec in self.plc_spec['slices']:
58             site_spec = self.locate_site (slice_spec['sitename'])
59             test_site = TestSite(self,site_spec)
60             test_slice=TestSlice(self,test_site,slice_spec)
61             if not slice_method(test_slice,self.options): overall=False
62         return overall
63     # restore the doc text
64     actual.__doc__=method.__doc__
65     return actual
66
67 def slice_mapper_options_sfa (method):
68     def actual(self):
69         test_plc=self
70         overall=True
71         slice_method = TestSliceSfa.__dict__[method.__name__]
72         for slice_spec in self.plc_spec['sfa']['slices_sfa']:
73             site_spec = self.locate_site (slice_spec['sitename'])
74             test_site = TestSite(self,site_spec)
75             test_slice=TestSliceSfa(test_plc,test_site,slice_spec)
76             if not slice_method(test_slice,self.options): overall=False
77         return overall
78     # restore the doc text
79     actual.__doc__=method.__doc__
80     return actual
81
82 SEP='<sep>'
83
84 class TestPlc:
85
86     default_steps = [
87         'display', 'local_pre', SEP,
88         'delete','create','install', 'configure', 'start', SEP,
89         'fetch_keys', 'store_keys', 'clear_known_hosts', SEP,
90         'initscripts', 'sites', 'nodes', 'slices', 'nodegroups', SEP,
91         'reinstall_node', 'init_node','bootcd', 'configure_qemu', 'export_qemu',
92         'kill_all_qemus', 'start_node', SEP,
93         # better use of time: do this now that the nodes are taking off
94         'plcsh_stress_test', SEP,
95         'nodes_ssh_debug', 'nodes_ssh_boot', 'check_slice', 'check_initscripts', SEP,
96         'install_sfa', 'configure_sfa', 'import_sfa', 'start_sfa', SEP,
97         'setup_sfa', 'add_sfa', 'update_sfa', SEP,
98         'view_sfa', 'check_slice_sfa', 'delete_sfa', 'stop_sfa', SEP,
99         'check_tcp',  'check_hooks',  SEP,
100         'force_gather_logs', 'force_local_post',
101         ]
102     other_steps = [ 
103         'fresh_install', 'stop', 'vs_start', SEP,
104         'clean_initscripts', 'clean_nodegroups','clean_all_sites', SEP,
105         'clean_sites', 'clean_nodes', 'clean_slices', 'clean_keys', SEP,
106         'populate' , SEP,
107         'show_boxes', 'list_all_qemus', 'list_qemus', 'kill_qemus', SEP,
108         'db_dump' , 'db_restore', SEP,
109         'local_list','local_cleanup',SEP,
110         'standby_1 through 20',
111         ]
112
113     @staticmethod
114     def printable_steps (list):
115         return " ".join(list).replace(" "+SEP+" "," \\\n")
116     @staticmethod
117     def valid_step (step):
118         return step != SEP
119
120     def __init__ (self,plc_spec,options):
121         self.plc_spec=plc_spec
122         self.options=options
123         self.test_ssh=TestSsh(self.plc_spec['hostname'],self.options.buildname)
124         try:
125             self.vserverip=plc_spec['vserverip']
126             self.vservername=plc_spec['vservername']
127             self.url="https://%s:443/PLCAPI/"%plc_spec['vserverip']
128             self.vserver=True
129         except:
130             raise Exception,'chroot-based myplc testing is deprecated'
131         self.apiserver=TestApiserver(self.url,options.dry_run)
132         
133     def name(self):
134         name=self.plc_spec['name']
135         return "%s.%s"%(name,self.vservername)
136
137     def hostname(self):
138         return self.plc_spec['hostname']
139
140     def is_local (self):
141         return self.test_ssh.is_local()
142
143     # define the API methods on this object through xmlrpc
144     # would help, but not strictly necessary
145     def connect (self):
146         pass
147
148     def actual_command_in_guest (self,command):
149         return self.test_ssh.actual_command(self.host_to_guest(command))
150     
151     def start_guest (self):
152       return utils.system(self.test_ssh.actual_command(self.start_guest_in_host()))
153     
154     def run_in_guest (self,command):
155         return utils.system(self.actual_command_in_guest(command))
156     
157     def run_in_host (self,command):
158         return self.test_ssh.run_in_buildname(command)
159
160     #command gets run in the vserver
161     def host_to_guest(self,command):
162         return "vserver %s exec %s"%(self.vservername,command)
163     
164     #command gets run in the vserver
165     def start_guest_in_host(self):
166         return "vserver %s start"%(self.vservername)
167     
168     # xxx quick n dirty
169     def run_in_guest_piped (self,local,remote):
170         return utils.system(local+" | "+self.test_ssh.actual_command(self.host_to_guest(remote),keep_stdin=True))
171
172     def auth_root (self):
173         return {'Username':self.plc_spec['PLC_ROOT_USER'],
174                 'AuthMethod':'password',
175                 'AuthString':self.plc_spec['PLC_ROOT_PASSWORD'],
176                 'Role' : self.plc_spec['role']
177                 }
178     def locate_site (self,sitename):
179         for site in self.plc_spec['sites']:
180             if site['site_fields']['name'] == sitename:
181                 return site
182             if site['site_fields']['login_base'] == sitename:
183                 return site
184         raise Exception,"Cannot locate site %s"%sitename
185         
186     def locate_node (self,nodename):
187         for site in self.plc_spec['sites']:
188             for node in site['nodes']:
189                 if node['name'] == nodename:
190                     return (site,node)
191         raise Exception,"Cannot locate node %s"%nodename
192         
193     def locate_hostname (self,hostname):
194         for site in self.plc_spec['sites']:
195             for node in site['nodes']:
196                 if node['node_fields']['hostname'] == hostname:
197                     return (site,node)
198         raise Exception,"Cannot locate hostname %s"%hostname
199         
200     def locate_key (self,keyname):
201         for key in self.plc_spec['keys']:
202             if key['name'] == keyname:
203                 return key
204         raise Exception,"Cannot locate key %s"%keyname
205
206     def locate_slice (self, slicename):
207         for slice in self.plc_spec['slices']:
208             if slice['slice_fields']['name'] == slicename:
209                 return slice
210         raise Exception,"Cannot locate slice %s"%slicename
211
212     def all_sliver_objs (self):
213         result=[]
214         for slice_spec in self.plc_spec['slices']:
215             slicename = slice_spec['slice_fields']['name']
216             for nodename in slice_spec['nodenames']:
217                 result.append(self.locate_sliver_obj (nodename,slicename))
218         return result
219
220     def locate_sliver_obj (self,nodename,slicename):
221         (site,node) = self.locate_node(nodename)
222         slice = self.locate_slice (slicename)
223         # build objects
224         test_site = TestSite (self, site)
225         test_node = TestNode (self, test_site,node)
226         # xxx the slice site is assumed to be the node site - mhh - probably harmless
227         test_slice = TestSlice (self, test_site, slice)
228         return TestSliver (self, test_node, test_slice)
229
230     def locate_first_node(self):
231         nodename=self.plc_spec['slices'][0]['nodenames'][0]
232         (site,node) = self.locate_node(nodename)
233         test_site = TestSite (self, site)
234         test_node = TestNode (self, test_site,node)
235         return test_node
236
237     def locate_first_sliver (self):
238         slice_spec=self.plc_spec['slices'][0]
239         slicename=slice_spec['slice_fields']['name']
240         nodename=slice_spec['nodenames'][0]
241         return self.locate_sliver_obj(nodename,slicename)
242
243     # all different hostboxes used in this plc
244     def gather_hostBoxes(self):
245         # maps on sites and nodes, return [ (host_box,test_node) ]
246         tuples=[]
247         for site_spec in self.plc_spec['sites']:
248             test_site = TestSite (self,site_spec)
249             for node_spec in site_spec['nodes']:
250                 test_node = TestNode (self, test_site, node_spec)
251                 if not test_node.is_real():
252                     tuples.append( (test_node.host_box(),test_node) )
253         # transform into a dict { 'host_box' -> [ test_node .. ] }
254         result = {}
255         for (box,node) in tuples:
256             if not result.has_key(box):
257                 result[box]=[node]
258             else:
259                 result[box].append(node)
260         return result
261                     
262     # a step for checking this stuff
263     def show_boxes (self):
264         for (box,nodes) in self.gather_hostBoxes().iteritems():
265             print box,":"," + ".join( [ node.name() for node in nodes ] )
266         return True
267
268     # make this a valid step
269     def kill_all_qemus(self):
270         "all qemu boxes: kill all running qemus (even of former runs)"
271         # this is the brute force version, kill all qemus on that host box
272         for (box,nodes) in self.gather_hostBoxes().iteritems():
273             # pass the first nodename, as we don't push template-qemu on testboxes
274             nodedir=nodes[0].nodedir()
275             TestBox(box,self.options.buildname).kill_all_qemus(nodedir)
276         return True
277
278     # make this a valid step
279     def list_all_qemus(self):
280         for (box,nodes) in self.gather_hostBoxes().iteritems():
281             # this is the brute force version, kill all qemus on that host box
282             TestBox(box,self.options.buildname).list_all_qemus()
283         return True
284
285     # kill only the right qemus
286     def list_qemus(self):
287         for (box,nodes) in self.gather_hostBoxes().iteritems():
288             # the fine-grain version
289             for node in nodes:
290                 node.list_qemu()
291         return True
292
293     # kill only the right qemus
294     def kill_qemus(self):
295         for (box,nodes) in self.gather_hostBoxes().iteritems():
296             # the fine-grain version
297             for node in nodes:
298                 node.kill_qemu()
299         return True
300
301     #################### display config
302     def display (self):
303         "show test configuration after localization"
304         self.display_pass (1)
305         self.display_pass (2)
306         return True
307
308     # entry point
309     def display_pass (self,passno):
310         for (key,val) in self.plc_spec.iteritems():
311             if passno == 2:
312                 if key == 'sites':
313                     for site in val:
314                         self.display_site_spec(site)
315                         for node in site['nodes']:
316                             self.display_node_spec(node)
317                 elif key=='initscripts':
318                     for initscript in val:
319                         self.display_initscript_spec (initscript)
320                 elif key=='slices':
321                     for slice in val:
322                         self.display_slice_spec (slice)
323                 elif key=='keys':
324                     for key in val:
325                         self.display_key_spec (key)
326             elif passno == 1:
327                 if key not in ['sites','initscripts','slices','keys']:
328                     print '+   ',key,':',val
329
330     def display_site_spec (self,site):
331         print '+ ======== site',site['site_fields']['name']
332         for (k,v) in site.iteritems():
333             if k=='nodes':
334                 if v: 
335                     print '+       ','nodes : ',
336                     for node in v:  
337                         print node['node_fields']['hostname'],'',
338                     print ''
339             elif k=='users':
340                 if v: 
341                     print '+       users : ',
342                     for user in v:  
343                         print user['name'],'',
344                     print ''
345             elif k == 'site_fields':
346                 print '+       login_base',':',v['login_base']
347             elif k == 'address_fields':
348                 pass
349             else:
350                 print '+       ',k,
351                 PrettyPrinter(indent=8,depth=2).pprint(v)
352         
353     def display_initscript_spec (self,initscript):
354         print '+ ======== initscript',initscript['initscript_fields']['name']
355
356     def display_key_spec (self,key):
357         print '+ ======== key',key['name']
358
359     def display_slice_spec (self,slice):
360         print '+ ======== slice',slice['slice_fields']['name']
361         for (k,v) in slice.iteritems():
362             if k=='nodenames':
363                 if v: 
364                     print '+       nodes : ',
365                     for nodename in v:  
366                         print nodename,'',
367                     print ''
368             elif k=='usernames':
369                 if v: 
370                     print '+       users : ',
371                     for username in v:  
372                         print username,'',
373                     print ''
374             elif k=='slice_fields':
375                 print '+       fields',':',
376                 print 'max_nodes=',v['max_nodes'],
377                 print ''
378             else:
379                 print '+       ',k,v
380
381     def display_node_spec (self,node):
382         print "+           node",node['name'],"host_box=",node['host_box'],
383         print "hostname=",node['node_fields']['hostname'],
384         print "ip=",node['interface_fields']['ip']
385     
386
387     # another entry point for just showing the boxes involved
388     def display_mapping (self):
389         TestPlc.display_mapping_plc(self.plc_spec)
390         return True
391
392     @staticmethod
393     def display_mapping_plc (plc_spec):
394         print '+ MyPLC',plc_spec['name']
395         print '+\tvserver address = root@%s:/vservers/%s'%(plc_spec['hostname'],plc_spec['vservername'])
396         print '+\tIP = %s/%s'%(plc_spec['PLC_API_HOST'],plc_spec['vserverip'])
397         for site_spec in plc_spec['sites']:
398             for node_spec in site_spec['nodes']:
399                 TestPlc.display_mapping_node(node_spec)
400
401     @staticmethod
402     def display_mapping_node (node_spec):
403         print '+   NODE %s'%(node_spec['name'])
404         print '+\tqemu box %s'%node_spec['host_box']
405         print '+\thostname=%s'%node_spec['node_fields']['hostname']
406
407     def local_pre (self):
408         "run site-dependant pre-test script as defined in LocalTestResources"
409         from LocalTestResources import local_resources
410         return local_resources.step_pre(self)
411  
412     def local_post (self):
413         "run site-dependant post-test script as defined in LocalTestResources"
414         from LocalTestResources import local_resources
415         return local_resources.step_post(self)
416  
417     def local_list (self):
418         "run site-dependant list script as defined in LocalTestResources"
419         from LocalTestResources import local_resources
420         return local_resources.step_list(self)
421  
422     def local_cleanup (self):
423         "run site-dependant cleanup script as defined in LocalTestResources"
424         from LocalTestResources import local_resources
425         return local_resources.step_cleanup(self)
426  
427     def delete(self):
428         "vserver delete the test myplc"
429         self.run_in_host("vserver --silent %s delete"%self.vservername)
430         return True
431
432     ### install
433     def create (self):
434         "vserver creation (no install done)"
435         if self.is_local():
436             # a full path for the local calls
437             build_dir=os.path.dirname(sys.argv[0])
438             # sometimes this is empty - set to "." in such a case
439             if not build_dir: build_dir="."
440             build_dir += "/build"
441         else:
442             # use a standard name - will be relative to remote buildname
443             build_dir="build"
444         # run checkout in any case - would do an update if already exists
445         build_checkout = "svn checkout %s %s"%(self.options.build_url,build_dir)
446         if self.run_in_host(build_checkout) != 0:
447             return False
448         # the repo url is taken from arch-rpms-url 
449         # with the last step (i386) removed
450         repo_url = self.options.arch_rpms_url
451         for level in [ 'arch' ]:
452             repo_url = os.path.dirname(repo_url)
453         # pass the vbuild-nightly options to vtest-init-vserver
454         test_env_options=""
455         test_env_options += " -p %s"%self.options.personality
456         test_env_options += " -d %s"%self.options.pldistro
457         test_env_options += " -f %s"%self.options.fcdistro
458         script="vtest-init-vserver.sh"
459         vserver_name = self.vservername
460         vserver_options="--netdev eth0 --interface %s"%self.vserverip
461         try:
462             vserver_hostname=socket.gethostbyaddr(self.vserverip)[0]
463             vserver_options += " --hostname %s"%vserver_hostname
464         except:
465             pass
466         create_vserver="%(build_dir)s/%(script)s %(test_env_options)s %(vserver_name)s %(repo_url)s -- %(vserver_options)s"%locals()
467         return self.run_in_host(create_vserver) == 0
468
469     ### install_rpm 
470     def install(self):
471         "yum install myplc, noderepo, and the plain bootstrapfs"
472         if self.options.personality == "linux32":
473             arch = "i386"
474         elif self.options.personality == "linux64":
475             arch = "x86_64"
476         else:
477             raise Exception, "Unsupported personality %r"%self.options.personality
478         return \
479             self.run_in_guest("yum -y install myplc")==0 and \
480             self.run_in_guest("yum -y install noderepo-%s-%s"%(self.options.pldistro,arch))==0 and \
481             self.run_in_guest("yum -y install bootstrapfs-%s-%s-plain"%(self.options.pldistro,arch))==0 
482
483     ### 
484     def configure(self):
485         "run plc-config-tty"
486         tmpname='%s.plc-config-tty'%(self.name())
487         fileconf=open(tmpname,'w')
488         for var in [ 'PLC_NAME',
489                      'PLC_ROOT_PASSWORD',
490                      'PLC_ROOT_USER',
491                      'PLC_MAIL_ENABLED',
492                      'PLC_MAIL_SUPPORT_ADDRESS',
493                      'PLC_DB_HOST',
494                      'PLC_DB_PASSWORD',
495                      # Above line was added for integrating SFA Testing
496                      'PLC_API_HOST',
497                      'PLC_WWW_HOST',
498                      'PLC_BOOT_HOST',
499                      'PLC_NET_DNS1',
500                      'PLC_NET_DNS2']:
501             fileconf.write ('e %s\n%s\n'%(var,self.plc_spec[var]))
502         fileconf.write('w\n')
503         fileconf.write('q\n')
504         fileconf.close()
505         utils.system('cat %s'%tmpname)
506         self.run_in_guest_piped('cat %s'%tmpname,'plc-config-tty')
507         utils.system('rm %s'%tmpname)
508         return True
509
510     def start(self):
511         "service plc start"
512         self.run_in_guest('service plc start')
513         return True
514
515     def stop(self):
516         "service plc stop"
517         self.run_in_guest('service plc stop')
518         return True
519         
520     def vs_start (self):
521         self.start_guest()
522         return True
523
524     # stores the keys from the config for further use
525     def store_keys(self):
526         "stores test users ssh keys in keys/"
527         for key_spec in self.plc_spec['keys']:
528                 TestKey(self,key_spec).store_key()
529         return True
530
531     def clean_keys(self):
532         utils.system("rm -rf %s/keys/"%os.path(sys.argv[0]))
533
534     # fetches the ssh keys in the plc's /etc/planetlab and stores them in keys/
535     # for later direct access to the nodes
536     def fetch_keys(self):
537         "gets ssh keys in /etc/planetlab/ and stores them locally in keys/"
538         dir="./keys"
539         if not os.path.isdir(dir):
540             os.mkdir(dir)
541         vservername=self.vservername
542         overall=True
543         prefix = 'debug_ssh_key'
544         for ext in [ 'pub', 'rsa' ] :
545             src="/vservers/%(vservername)s/etc/planetlab/%(prefix)s.%(ext)s"%locals()
546             dst="keys/%(vservername)s-debug.%(ext)s"%locals()
547             if self.test_ssh.fetch(src,dst) != 0: overall=False
548         return overall
549
550     def sites (self):
551         "create sites with PLCAPI"
552         return self.do_sites()
553     
554     def clean_sites (self):
555         "delete sites with PLCAPI"
556         return self.do_sites(action="delete")
557     
558     def do_sites (self,action="add"):
559         for site_spec in self.plc_spec['sites']:
560             test_site = TestSite (self,site_spec)
561             if (action != "add"):
562                 utils.header("Deleting site %s in %s"%(test_site.name(),self.name()))
563                 test_site.delete_site()
564                 # deleted with the site
565                 #test_site.delete_users()
566                 continue
567             else:
568                 utils.header("Creating site %s & users in %s"%(test_site.name(),self.name()))
569                 test_site.create_site()
570                 test_site.create_users()
571         return True
572
573     def clean_all_sites (self):
574         print 'auth_root',self.auth_root()
575         site_ids = [s['site_id'] for s in self.apiserver.GetSites(self.auth_root(), {}, ['site_id'])]
576         for site_id in site_ids:
577             print 'Deleting site_id',site_id
578             self.apiserver.DeleteSite(self.auth_root(),site_id)
579
580     def nodes (self):
581         "create nodes with PLCAPI"
582         return self.do_nodes()
583     def clean_nodes (self):
584         "delete nodes with PLCAPI"
585         return self.do_nodes(action="delete")
586
587     def do_nodes (self,action="add"):
588         for site_spec in self.plc_spec['sites']:
589             test_site = TestSite (self,site_spec)
590             if action != "add":
591                 utils.header("Deleting nodes in site %s"%test_site.name())
592                 for node_spec in site_spec['nodes']:
593                     test_node=TestNode(self,test_site,node_spec)
594                     utils.header("Deleting %s"%test_node.name())
595                     test_node.delete_node()
596             else:
597                 utils.header("Creating nodes for site %s in %s"%(test_site.name(),self.name()))
598                 for node_spec in site_spec['nodes']:
599                     utils.pprint('Creating node %s'%node_spec,node_spec)
600                     test_node = TestNode (self,test_site,node_spec)
601                     test_node.create_node ()
602         return True
603
604     def nodegroups (self):
605         "create nodegroups with PLCAPI"
606         return self.do_nodegroups("add")
607     def clean_nodegroups (self):
608         "delete nodegroups with PLCAPI"
609         return self.do_nodegroups("delete")
610
611     # create nodegroups if needed, and populate
612     def do_nodegroups (self, action="add"):
613         # 1st pass to scan contents
614         groups_dict = {}
615         for site_spec in self.plc_spec['sites']:
616             test_site = TestSite (self,site_spec)
617             for node_spec in site_spec['nodes']:
618                 test_node=TestNode (self,test_site,node_spec)
619                 if node_spec.has_key('nodegroups'):
620                     nodegroupnames=node_spec['nodegroups']
621                     if isinstance(nodegroupnames,StringTypes):
622                         nodegroupnames = [ nodegroupnames ]
623                     for nodegroupname in nodegroupnames:
624                         if not groups_dict.has_key(nodegroupname):
625                             groups_dict[nodegroupname]=[]
626                         groups_dict[nodegroupname].append(test_node.name())
627         auth=self.auth_root()
628         overall = True
629         for (nodegroupname,group_nodes) in groups_dict.iteritems():
630             if action == "add":
631                 print 'nodegroups:','dealing with nodegroup',nodegroupname,'on nodes',group_nodes
632                 # first, check if the nodetagtype is here
633                 tag_types = self.apiserver.GetTagTypes(auth,{'tagname':nodegroupname})
634                 if tag_types:
635                     tag_type_id = tag_types[0]['tag_type_id']
636                 else:
637                     tag_type_id = self.apiserver.AddTagType(auth,
638                                                             {'tagname':nodegroupname,
639                                                              'description': 'for nodegroup %s'%nodegroupname,
640                                                              'category':'test',
641                                                              'min_role_id':10})
642                 print 'located tag (type)',nodegroupname,'as',tag_type_id
643                 # create nodegroup
644                 nodegroups = self.apiserver.GetNodeGroups (auth, {'groupname':nodegroupname})
645                 if not nodegroups:
646                     self.apiserver.AddNodeGroup(auth, nodegroupname, tag_type_id, 'yes')
647                     print 'created nodegroup',nodegroupname,'from tagname',nodegroupname,'and value','yes'
648                 # set node tag on all nodes, value='yes'
649                 for nodename in group_nodes:
650                     try:
651                         self.apiserver.AddNodeTag(auth, nodename, nodegroupname, "yes")
652                     except:
653                         traceback.print_exc()
654                         print 'node',nodename,'seems to already have tag',nodegroupname
655                     # check anyway
656                     try:
657                         expect_yes = self.apiserver.GetNodeTags(auth,
658                                                                 {'hostname':nodename,
659                                                                  'tagname':nodegroupname},
660                                                                 ['value'])[0]['value']
661                         if expect_yes != "yes":
662                             print 'Mismatch node tag on node',nodename,'got',expect_yes
663                             overall=False
664                     except:
665                         if not self.options.dry_run:
666                             print 'Cannot find tag',nodegroupname,'on node',nodename
667                             overall = False
668             else:
669                 try:
670                     print 'cleaning nodegroup',nodegroupname
671                     self.apiserver.DeleteNodeGroup(auth,nodegroupname)
672                 except:
673                     traceback.print_exc()
674                     overall=False
675         return overall
676
677     def all_hostnames (self) :
678         hostnames = []
679         for site_spec in self.plc_spec['sites']:
680             hostnames += [ node_spec['node_fields']['hostname'] \
681                            for node_spec in site_spec['nodes'] ]
682         return hostnames
683
684     # silent_minutes : during the first <silent_minutes> minutes nothing gets printed
685     def nodes_check_boot_state (self, target_boot_state, timeout_minutes, silent_minutes,period=15):
686         if self.options.dry_run:
687             print 'dry_run'
688             return True
689         # compute timeout
690         timeout = datetime.datetime.now()+datetime.timedelta(minutes=timeout_minutes)
691         graceout = datetime.datetime.now()+datetime.timedelta(minutes=silent_minutes)
692         # the nodes that haven't checked yet - start with a full list and shrink over time
693         tocheck = self.all_hostnames()
694         utils.header("checking nodes %r"%tocheck)
695         # create a dict hostname -> status
696         status = dict ( [ (hostname,'undef') for hostname in tocheck ] )
697         while tocheck:
698             # get their status
699             tocheck_status=self.apiserver.GetNodes(self.auth_root(), tocheck, ['hostname','boot_state' ] )
700             # update status
701             for array in tocheck_status:
702                 hostname=array['hostname']
703                 boot_state=array['boot_state']
704                 if boot_state == target_boot_state:
705                     utils.header ("%s has reached the %s state"%(hostname,target_boot_state))
706                 else:
707                     # if it's a real node, never mind
708                     (site_spec,node_spec)=self.locate_hostname(hostname)
709                     if TestNode.is_real_model(node_spec['node_fields']['model']):
710                         utils.header("WARNING - Real node %s in %s - ignored"%(hostname,boot_state))
711                         # let's cheat
712                         boot_state = target_boot_state
713                     elif datetime.datetime.now() > graceout:
714                         utils.header ("%s still in '%s' state"%(hostname,boot_state))
715                         graceout=datetime.datetime.now()+datetime.timedelta(1)
716                 status[hostname] = boot_state
717             # refresh tocheck
718             tocheck = [ hostname for (hostname,boot_state) in status.iteritems() if boot_state != target_boot_state ]
719             if not tocheck:
720                 return True
721             if datetime.datetime.now() > timeout:
722                 for hostname in tocheck:
723                     utils.header("FAILURE due to %s in '%s' state"%(hostname,status[hostname]))
724                 return False
725             # otherwise, sleep for a while
726             time.sleep(period)
727         # only useful in empty plcs
728         return True
729
730     def nodes_booted(self):
731         return self.nodes_check_boot_state('boot',timeout_minutes=30,silent_minutes=20)
732
733     def check_nodes_ssh(self,debug,timeout_minutes,silent_minutes,period=15):
734         # compute timeout
735         timeout = datetime.datetime.now()+datetime.timedelta(minutes=timeout_minutes)
736         graceout = datetime.datetime.now()+datetime.timedelta(minutes=silent_minutes)
737         vservername=self.vservername
738         if debug: 
739             message="debug"
740             local_key = "keys/%(vservername)s-debug.rsa"%locals()
741         else: 
742             message="boot"
743             local_key = "keys/key1.rsa"
744         tocheck = self.all_hostnames()
745         utils.header("checking ssh access (expected in %s mode) to nodes %r"%(message,tocheck))
746         utils.header("max timeout is %d minutes, silent for %d minutes (period is %s)"%\
747                          (timeout_minutes,silent_minutes,period))
748         while tocheck:
749             for hostname in tocheck:
750                 # try to run 'hostname' in the node
751                 command = TestSsh (hostname,key=local_key).actual_command("hostname;uname -a")
752                 # don't spam logs - show the command only after the grace period 
753                 success = utils.system ( command, silent=datetime.datetime.now() < graceout)
754                 if success==0:
755                     utils.header('Successfully entered root@%s (%s)'%(hostname,message))
756                     # refresh tocheck
757                     tocheck.remove(hostname)
758                 else:
759                     # we will have tried real nodes once, in case they're up - but if not, just skip
760                     (site_spec,node_spec)=self.locate_hostname(hostname)
761                     if TestNode.is_real_model(node_spec['node_fields']['model']):
762                         utils.header ("WARNING : check ssh access into real node %s - skipped"%hostname)
763                         tocheck.remove(hostname)
764             if  not tocheck:
765                 return True
766             if datetime.datetime.now() > timeout:
767                 for hostname in tocheck:
768                     utils.header("FAILURE to ssh into %s"%hostname)
769                 return False
770             # otherwise, sleep for a while
771             time.sleep(period)
772         # only useful in empty plcs
773         return True
774         
775     def nodes_ssh_debug(self):
776         "Tries to ssh into nodes in debug mode with the debug ssh key"
777         return self.check_nodes_ssh(debug=True,timeout_minutes=30,silent_minutes=10)
778     
779     def nodes_ssh_boot(self):
780         "Tries to ssh into nodes in production mode with the root ssh key"
781         return self.check_nodes_ssh(debug=False,timeout_minutes=30,silent_minutes=10)
782     
783     @node_mapper
784     def init_node (self): 
785         "all nodes : init a clean local directory for holding node-dep stuff like iso image..."
786         pass
787     @node_mapper
788     def bootcd (self): 
789         "all nodes: invoke GetBootMedium and store result locally"
790         pass
791     @node_mapper
792     def configure_qemu (self): 
793         "all nodes: compute qemu config qemu.conf and store it locally"
794         pass
795     @node_mapper
796     def reinstall_node (self): 
797         "all nodes: mark PLCAPI boot_state as reinstall"
798         pass
799     @node_mapper
800     def export_qemu (self): 
801         "all nodes: push local node-dep directory on the qemu box"
802         pass
803         
804     ### check hooks : invoke scripts from hooks/{node,slice}
805     def check_hooks_node (self): 
806         return self.locate_first_node().check_hooks()
807     def check_hooks_sliver (self) : 
808         return self.locate_first_sliver().check_hooks()
809     
810     def check_hooks (self):
811         "runs unit tests in the node and slice contexts - see hooks/{node,slice}"
812         return self.check_hooks_node() and self.check_hooks_sliver()
813
814     ### initscripts
815     def do_check_initscripts(self):
816         overall = True
817         for slice_spec in self.plc_spec['slices']:
818             if not slice_spec.has_key('initscriptname'):
819                 continue
820             initscript=slice_spec['initscriptname']
821             for nodename in slice_spec['nodenames']:
822                 (site,node) = self.locate_node (nodename)
823                 # xxx - passing the wrong site - probably harmless
824                 test_site = TestSite (self,site)
825                 test_slice = TestSlice (self,test_site,slice_spec)
826                 test_node = TestNode (self,test_site,node)
827                 test_sliver = TestSliver (self, test_node, test_slice)
828                 if not test_sliver.check_initscript(initscript):
829                     overall = False
830         return overall
831             
832     def check_initscripts(self):
833         "check that the initscripts have triggered"
834         return self.do_check_initscripts()
835     
836     def initscripts (self):
837         "create initscripts with PLCAPI"
838         for initscript in self.plc_spec['initscripts']:
839             utils.pprint('Adding Initscript in plc %s'%self.plc_spec['name'],initscript)
840             self.apiserver.AddInitScript(self.auth_root(),initscript['initscript_fields'])
841         return True
842
843     def clean_initscripts (self):
844         "delete initscripts with PLCAPI"
845         for initscript in self.plc_spec['initscripts']:
846             initscript_name = initscript['initscript_fields']['name']
847             print('Attempting to delete %s in plc %s'%(initscript_name,self.plc_spec['name']))
848             try:
849                 self.apiserver.DeleteInitScript(self.auth_root(),initscript_name)
850                 print initscript_name,'deleted'
851             except:
852                 print 'deletion went wrong - probably did not exist'
853         return True
854
855     ### manage slices
856     def slices (self):
857         "create slices with PLCAPI"
858         return self.do_slices()
859
860     def clean_slices (self):
861         "delete slices with PLCAPI"
862         return self.do_slices("delete")
863
864     def do_slices (self,  action="add"):
865         for slice in self.plc_spec['slices']:
866             site_spec = self.locate_site (slice['sitename'])
867             test_site = TestSite(self,site_spec)
868             test_slice=TestSlice(self,test_site,slice)
869             if action != "add":
870                 utils.header("Deleting slices in site %s"%test_site.name())
871                 test_slice.delete_slice()
872             else:    
873                 utils.pprint("Creating slice",slice)
874                 test_slice.create_slice()
875                 utils.header('Created Slice %s'%slice['slice_fields']['name'])
876         return True
877         
878     @slice_mapper_options
879     def check_slice(self): 
880         "tries to ssh-enter the slice with the user key, to ensure slice creation"
881         pass
882
883     @node_mapper
884     def clear_known_hosts (self): 
885         "remove test nodes entries from the local known_hosts file"
886         pass
887     
888     @node_mapper
889     def start_node (self) : 
890         "all nodes: start the qemu instance (also runs qemu-bridge-init start)"
891         pass
892
893     def check_tcp (self):
894         "check TCP connectivity between 2 slices (or in loopback if only one is defined)"
895         specs = self.plc_spec['tcp_test']
896         overall=True
897         for spec in specs:
898             port = spec['port']
899             # server side
900             s_test_sliver = self.locate_sliver_obj (spec['server_node'],spec['server_slice'])
901             if not s_test_sliver.run_tcp_server(port,timeout=10):
902                 overall=False
903                 break
904
905             # idem for the client side
906             c_test_sliver = self.locate_sliver_obj(spec['server_node'],spec['server_slice'])
907             if not c_test_sliver.run_tcp_client(s_test_sliver.test_node.name(),port):
908                 overall=False
909         return overall
910
911     def plcsh_stress_test (self):
912         "runs PLCAPI stress test, that checks Add/Update/Delete on all types - preserves contents"
913         # install the stress-test in the plc image
914         location = "/usr/share/plc_api/plcsh_stress_test.py"
915         remote="/vservers/%s/%s"%(self.vservername,location)
916         self.test_ssh.copy_abs("plcsh_stress_test.py",remote)
917         command = location
918         command += " -- --check"
919         if self.options.size == 1:
920             command +=  " --tiny"
921         return ( self.run_in_guest(command) == 0)
922
923     # populate runs the same utility without slightly different options
924     # in particular runs with --preserve (dont cleanup) and without --check
925     # also it gets run twice, once with the --foreign option for creating fake foreign entries
926
927     ### install_sfa_rpm
928     def install_sfa(self):
929         "yum install sfa, sfa-plc and sfa-client"
930         if self.options.personality == "linux32":
931             arch = "i386"
932         elif self.options.personality == "linux64":
933             arch = "x86_64"
934         else:
935             raise Exception, "Unsupported personality %r"%self.options.personality
936         return self.run_in_guest("yum -y install sfa sfa-client sfa-plc sfa-sfatables")==0
937
938     ###
939     def configure_sfa(self):
940         "run sfa-config-tty"
941         tmpname='%s.sfa-config-tty'%(self.name())
942         fileconf=open(tmpname,'w')
943         for var in [ 'SFA_REGISTRY_ROOT_AUTH',
944                      'SFA_REGISTRY_LEVEL1_AUTH',
945                      'SFA_REGISTRY_HOST',
946                      'SFA_AGGREGATE_HOST',
947                      'SFA_SM_HOST',
948                      'SFA_PLC_USER',
949                      'SFA_PLC_PASSWORD',
950                      'SFA_PLC_DB_HOST',
951                      'SFA_PLC_DB_USER',
952                      'SFA_PLC_DB_PASSWORD',
953                      'SFA_PLC_URL']:
954             fileconf.write ('e %s\n%s\n'%(var,self.plc_spec['sfa'][var]))
955         fileconf.write('w\n')
956         fileconf.write('R\n')
957         fileconf.write('q\n')
958         fileconf.close()
959         utils.system('cat %s'%tmpname)
960         self.run_in_guest_piped('cat %s'%tmpname,'sfa-config-tty')
961         utils.system('rm %s'%tmpname)
962         return True
963
964     def import_sfa(self):
965         "sfa-import-plc"
966         auth=self.plc_spec['sfa']['SFA_REGISTRY_ROOT_AUTH']
967         self.run_in_guest('sfa-import-plc.py')
968 # not needed anymore
969 #        self.run_in_guest('cp /etc/sfa/authorities/%s/%s.pkey /etc/sfa/authorities/server.key'%(auth,auth))
970         return True
971
972     def start_sfa(self):
973         "service sfa start"
974         self.run_in_guest('service sfa start')
975         return True
976
977     def setup_sfa(self):
978         "sfi client configuration"
979         dir_name=".sfi"
980         if os.path.exists(dir_name):
981            utils.system('rm -rf %s'%dir_name)
982         utils.system('mkdir %s'%dir_name)
983         file_name=dir_name + os.sep + 'fake-pi1.pkey'
984         fileconf=open(file_name,'w')
985         fileconf.write (self.plc_spec['keys'][0]['private'])
986         fileconf.close()
987
988         file_name=dir_name + os.sep + 'sfi_config'
989         fileconf=open(file_name,'w')
990         SFI_AUTH=self.plc_spec['sfa']['SFA_REGISTRY_ROOT_AUTH']+".main"
991         fileconf.write ("SFI_AUTH='%s'"%SFI_AUTH)
992         fileconf.write('\n')
993         SFI_USER=SFI_AUTH+'.fake-pi1'
994         fileconf.write ("SFI_USER='%s'"%SFI_USER)
995         fileconf.write('\n')
996         SFI_REGISTRY='http://' + self.plc_spec['sfa']['SFA_PLC_DB_HOST'] + ':12345/'
997         fileconf.write ("SFI_REGISTRY='%s'"%SFI_REGISTRY)
998         fileconf.write('\n')
999         SFI_SM='http://' + self.plc_spec['sfa']['SFA_PLC_DB_HOST'] + ':12347/'
1000         fileconf.write ("SFI_SM='%s'"%SFI_SM)
1001         fileconf.write('\n')
1002         fileconf.close()
1003
1004         file_name=dir_name + os.sep + 'person.xml'
1005         fileconf=open(file_name,'w')
1006         for record in self.plc_spec['sfa']['sfa_person_xml']:
1007            person_record=record
1008         fileconf.write(person_record)
1009         fileconf.write('\n')
1010         fileconf.close()
1011
1012         file_name=dir_name + os.sep + 'slice.xml'
1013         fileconf=open(file_name,'w')
1014         for record in self.plc_spec['sfa']['sfa_slice_xml']:
1015             slice_record=record
1016         #slice_record=self.plc_spec['sfa']['sfa_slice_xml']
1017         fileconf.write(slice_record)
1018         fileconf.write('\n')
1019         fileconf.close()
1020
1021         file_name=dir_name + os.sep + 'slice.rspec'
1022         fileconf=open(file_name,'w')
1023         slice_rspec=''
1024         for (key, value) in self.plc_spec['sfa']['sfa_slice_rspec'].items():
1025             slice_rspec +=value 
1026         fileconf.write(slice_rspec)
1027         fileconf.write('\n')
1028         fileconf.close()
1029         location = "root/"
1030         remote="/vservers/%s/%s"%(self.vservername,location)
1031         self.test_ssh.copy_abs(dir_name, remote, recursive=True)
1032
1033         #utils.system('cat %s'%tmpname)
1034         utils.system('rm -rf %s'%dir_name)
1035         return True
1036
1037     def add_sfa(self):
1038         "run sfi.py add (on Registry) and sfi.py create (on SM) to form new objects"
1039         test_plc=self
1040         test_user_sfa=TestUserSfa(test_plc,self.plc_spec['sfa'])
1041         success=test_user_sfa.add_user()
1042
1043         for slice_spec in self.plc_spec['sfa']['slices_sfa']:
1044             site_spec = self.locate_site (slice_spec['sitename'])
1045             test_site = TestSite(self,site_spec)
1046             test_slice_sfa=TestSliceSfa(test_plc,test_site,slice_spec)
1047             success1=test_slice_sfa.add_slice()
1048             success2=test_slice_sfa.create_slice()
1049         return success and success1 and success2
1050
1051     def update_sfa(self):
1052         "run sfi.py update (on Registry) and sfi.py create (on SM) on existing objects"
1053         test_plc=self
1054         test_user_sfa=TestUserSfa(test_plc,self.plc_spec['sfa'])
1055         success1=test_user_sfa.update_user()
1056         
1057         for slice_spec in self.plc_spec['sfa']['slices_sfa']:
1058             site_spec = self.locate_site (slice_spec['sitename'])
1059             test_site = TestSite(self,site_spec)
1060             test_slice_sfa=TestSliceSfa(test_plc,test_site,slice_spec)
1061             success2=test_slice_sfa.update_slice()
1062         return success1 and success2
1063
1064     def view_sfa(self):
1065         "run sfi.py list and sfi.py show (both on Registry) and sfi.py slices and sfi.py resources (both on SM)"
1066         auth=self.plc_spec['sfa']['SFA_REGISTRY_ROOT_AUTH']
1067         return \
1068         self.run_in_guest("sfi.py -d /root/.sfi/ list %s.main"%auth)==0 and \
1069         self.run_in_guest("sfi.py -d /root/.sfi/ show %s.main"%auth)==0 and \
1070         self.run_in_guest("sfi.py -d /root/.sfi/ slices")==0 and \
1071         self.run_in_guest("sfi.py -d /root/.sfi/ resources")==0
1072
1073     @slice_mapper_options_sfa
1074     def check_slice_sfa(self): 
1075         "tries to ssh-enter the SFA slice"
1076         pass
1077
1078     def delete_sfa(self):
1079         "run sfi.py delete (on SM), sfi.py remove (on Registry)"
1080         test_plc=self
1081         test_user_sfa=TestUserSfa(test_plc,self.plc_spec['sfa'])
1082         success1=test_user_sfa.delete_user()
1083         for slice_spec in self.plc_spec['sfa']['slices_sfa']:
1084             site_spec = self.locate_site (slice_spec['sitename'])
1085             test_site = TestSite(self,site_spec)
1086             test_slice_sfa=TestSliceSfa(test_plc,test_site,slice_spec)
1087             success2=test_slice_sfa.delete_slice()
1088
1089         return success1 and success2
1090
1091     def stop_sfa(self):
1092         "service sfa stop"
1093         self.run_in_guest('service sfa stop')
1094         return True
1095
1096     def populate (self):
1097         "creates random entries in the PLCAPI"
1098         # install the stress-test in the plc image
1099         location = "/usr/share/plc_api/plcsh_stress_test.py"
1100         remote="/vservers/%s/%s"%(self.vservername,location)
1101         self.test_ssh.copy_abs("plcsh_stress_test.py",remote)
1102         command = location
1103         command += " -- --preserve --short-names"
1104         local = (self.run_in_guest(command) == 0);
1105         # second run with --foreign
1106         command += ' --foreign'
1107         remote = (self.run_in_guest(command) == 0);
1108         return ( local and remote)
1109
1110     def gather_logs (self):
1111         "gets all possible logs from plc's/qemu node's/slice's for future reference"
1112         # (1.a) get the plc's /var/log/ and store it locally in logs/myplc.var-log.<plcname>/*
1113         # (1.b) get the plc's  /var/lib/pgsql/data/pg_log/ -> logs/myplc.pgsql-log.<plcname>/*
1114         # (2) get all the nodes qemu log and store it as logs/node.qemu.<node>.log
1115         # (3) get the nodes /var/log and store is as logs/node.var-log.<node>/*
1116         # (4) as far as possible get the slice's /var/log as logs/sliver.var-log.<sliver>/*
1117         # (1.a)
1118         print "-------------------- TestPlc.gather_logs : PLC's /var/log"
1119         self.gather_var_logs ()
1120         # (1.b)
1121         print "-------------------- TestPlc.gather_logs : PLC's /var/lib/psql/data/pg_log/"
1122         self.gather_pgsql_logs ()
1123         # (2) 
1124         print "-------------------- TestPlc.gather_logs : nodes's QEMU logs"
1125         for site_spec in self.plc_spec['sites']:
1126             test_site = TestSite (self,site_spec)
1127             for node_spec in site_spec['nodes']:
1128                 test_node=TestNode(self,test_site,node_spec)
1129                 test_node.gather_qemu_logs()
1130         # (3)
1131         print "-------------------- TestPlc.gather_logs : nodes's /var/log"
1132         self.gather_nodes_var_logs()
1133         # (4)
1134         print "-------------------- TestPlc.gather_logs : sample sliver's /var/log"
1135         self.gather_slivers_var_logs()
1136         return True
1137
1138     def gather_slivers_var_logs(self):
1139         for test_sliver in self.all_sliver_objs():
1140             remote = test_sliver.tar_var_logs()
1141             utils.system("mkdir -p logs/sliver.var-log.%s"%test_sliver.name())
1142             command = remote + " | tar -C logs/sliver.var-log.%s -xf -"%test_sliver.name()
1143             utils.system(command)
1144         return True
1145
1146     def gather_var_logs (self):
1147         utils.system("mkdir -p logs/myplc.var-log.%s"%self.name())
1148         to_plc = self.actual_command_in_guest("tar -C /var/log/ -cf - .")        
1149         command = to_plc + "| tar -C logs/myplc.var-log.%s -xf -"%self.name()
1150         utils.system(command)
1151         command = "chmod a+r,a+x logs/myplc.var-log.%s/httpd"%self.name()
1152         utils.system(command)
1153
1154     def gather_pgsql_logs (self):
1155         utils.system("mkdir -p logs/myplc.pgsql-log.%s"%self.name())
1156         to_plc = self.actual_command_in_guest("tar -C /var/lib/pgsql/data/pg_log/ -cf - .")        
1157         command = to_plc + "| tar -C logs/myplc.pgsql-log.%s -xf -"%self.name()
1158         utils.system(command)
1159
1160     def gather_nodes_var_logs (self):
1161         for site_spec in self.plc_spec['sites']:
1162             test_site = TestSite (self,site_spec)
1163             for node_spec in site_spec['nodes']:
1164                 test_node=TestNode(self,test_site,node_spec)
1165                 test_ssh = TestSsh (test_node.name(),key="keys/key1.rsa")
1166                 command = test_ssh.actual_command("tar -C /var/log -cf - .")
1167                 command = command + "| tar -C logs/node.var-log.%s -xf -"%test_node.name()
1168                 utils.system("mkdir -p logs/node.var-log.%s"%test_node.name())
1169                 utils.system(command)
1170
1171
1172     # returns the filename to use for sql dump/restore, using options.dbname if set
1173     def dbfile (self, database):
1174         # uses options.dbname if it is found
1175         try:
1176             name=self.options.dbname
1177             if not isinstance(name,StringTypes):
1178                 raise Exception
1179         except:
1180             t=datetime.datetime.now()
1181             d=t.date()
1182             name=str(d)
1183         return "/root/%s-%s.sql"%(database,name)
1184
1185     def db_dump(self):
1186         dump=self.dbfile("planetab4")
1187         self.run_in_guest('pg_dump -U pgsqluser planetlab4 -f '+ dump)
1188         utils.header('Dumped planetlab4 database in %s'%dump)
1189         return True
1190
1191     def db_restore(self):
1192         dump=self.dbfile("planetab4")
1193         ##stop httpd service
1194         self.run_in_guest('service httpd stop')
1195         # xxx - need another wrapper
1196         self.run_in_guest_piped('echo drop database planetlab4','psql --user=pgsqluser template1')
1197         self.run_in_guest('createdb -U postgres --encoding=UNICODE --owner=pgsqluser planetlab4')
1198         self.run_in_guest('psql -U pgsqluser planetlab4 -f '+dump)
1199         ##starting httpd service
1200         self.run_in_guest('service httpd start')
1201
1202         utils.header('Database restored from ' + dump)
1203
1204     @standby_generic 
1205     def standby_1(): pass
1206     @standby_generic 
1207     def standby_2(): pass
1208     @standby_generic 
1209     def standby_3(): pass
1210     @standby_generic 
1211     def standby_4(): pass
1212     @standby_generic 
1213     def standby_5(): pass
1214     @standby_generic 
1215     def standby_6(): pass
1216     @standby_generic 
1217     def standby_7(): pass
1218     @standby_generic 
1219     def standby_8(): pass
1220     @standby_generic 
1221     def standby_9(): pass
1222     @standby_generic 
1223     def standby_10(): pass
1224     @standby_generic 
1225     def standby_11(): pass
1226     @standby_generic 
1227     def standby_12(): pass
1228     @standby_generic 
1229     def standby_13(): pass
1230     @standby_generic 
1231     def standby_14(): pass
1232     @standby_generic 
1233     def standby_15(): pass
1234     @standby_generic 
1235     def standby_16(): pass
1236     @standby_generic 
1237     def standby_17(): pass
1238     @standby_generic 
1239     def standby_18(): pass
1240     @standby_generic 
1241     def standby_19(): pass
1242     @standby_generic 
1243     def standby_20(): pass