test modules for sfa
[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 = 'root_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.%(ext)s"%locals()
547             if self.test_ssh.fetch(src,dst) != 0: overall=False
548         prefix = 'debug_ssh_key'
549         for ext in [ 'pub', 'rsa' ] :
550             src="/vservers/%(vservername)s/etc/planetlab/%(prefix)s.%(ext)s"%locals()
551             dst="keys/%(vservername)s-debug.%(ext)s"%locals()
552             if self.test_ssh.fetch(src,dst) != 0: overall=False
553         return overall
554
555     def sites (self):
556         "create sites with PLCAPI"
557         return self.do_sites()
558     
559     def clean_sites (self):
560         "delete sites with PLCAPI"
561         return self.do_sites(action="delete")
562     
563     def do_sites (self,action="add"):
564         for site_spec in self.plc_spec['sites']:
565             test_site = TestSite (self,site_spec)
566             if (action != "add"):
567                 utils.header("Deleting site %s in %s"%(test_site.name(),self.name()))
568                 test_site.delete_site()
569                 # deleted with the site
570                 #test_site.delete_users()
571                 continue
572             else:
573                 utils.header("Creating site %s & users in %s"%(test_site.name(),self.name()))
574                 test_site.create_site()
575                 test_site.create_users()
576         return True
577
578     def clean_all_sites (self):
579         print 'auth_root',self.auth_root()
580         site_ids = [s['site_id'] for s in self.apiserver.GetSites(self.auth_root(), {}, ['site_id'])]
581         for site_id in site_ids:
582             print 'Deleting site_id',site_id
583             self.apiserver.DeleteSite(self.auth_root(),site_id)
584
585     def nodes (self):
586         "create nodes with PLCAPI"
587         return self.do_nodes()
588     def clean_nodes (self):
589         "delete nodes with PLCAPI"
590         return self.do_nodes(action="delete")
591
592     def do_nodes (self,action="add"):
593         for site_spec in self.plc_spec['sites']:
594             test_site = TestSite (self,site_spec)
595             if action != "add":
596                 utils.header("Deleting nodes in site %s"%test_site.name())
597                 for node_spec in site_spec['nodes']:
598                     test_node=TestNode(self,test_site,node_spec)
599                     utils.header("Deleting %s"%test_node.name())
600                     test_node.delete_node()
601             else:
602                 utils.header("Creating nodes for site %s in %s"%(test_site.name(),self.name()))
603                 for node_spec in site_spec['nodes']:
604                     utils.pprint('Creating node %s'%node_spec,node_spec)
605                     test_node = TestNode (self,test_site,node_spec)
606                     test_node.create_node ()
607         return True
608
609     def nodegroups (self):
610         "create nodegroups with PLCAPI"
611         return self.do_nodegroups("add")
612     def clean_nodegroups (self):
613         "delete nodegroups with PLCAPI"
614         return self.do_nodegroups("delete")
615
616     # create nodegroups if needed, and populate
617     def do_nodegroups (self, action="add"):
618         # 1st pass to scan contents
619         groups_dict = {}
620         for site_spec in self.plc_spec['sites']:
621             test_site = TestSite (self,site_spec)
622             for node_spec in site_spec['nodes']:
623                 test_node=TestNode (self,test_site,node_spec)
624                 if node_spec.has_key('nodegroups'):
625                     nodegroupnames=node_spec['nodegroups']
626                     if isinstance(nodegroupnames,StringTypes):
627                         nodegroupnames = [ nodegroupnames ]
628                     for nodegroupname in nodegroupnames:
629                         if not groups_dict.has_key(nodegroupname):
630                             groups_dict[nodegroupname]=[]
631                         groups_dict[nodegroupname].append(test_node.name())
632         auth=self.auth_root()
633         overall = True
634         for (nodegroupname,group_nodes) in groups_dict.iteritems():
635             if action == "add":
636                 print 'nodegroups:','dealing with nodegroup',nodegroupname,'on nodes',group_nodes
637                 # first, check if the nodetagtype is here
638                 tag_types = self.apiserver.GetTagTypes(auth,{'tagname':nodegroupname})
639                 if tag_types:
640                     tag_type_id = tag_types[0]['tag_type_id']
641                 else:
642                     tag_type_id = self.apiserver.AddTagType(auth,
643                                                             {'tagname':nodegroupname,
644                                                              'description': 'for nodegroup %s'%nodegroupname,
645                                                              'category':'test',
646                                                              'min_role_id':10})
647                 print 'located tag (type)',nodegroupname,'as',tag_type_id
648                 # create nodegroup
649                 nodegroups = self.apiserver.GetNodeGroups (auth, {'groupname':nodegroupname})
650                 if not nodegroups:
651                     self.apiserver.AddNodeGroup(auth, nodegroupname, tag_type_id, 'yes')
652                     print 'created nodegroup',nodegroupname,'from tagname',nodegroupname,'and value','yes'
653                 # set node tag on all nodes, value='yes'
654                 for nodename in group_nodes:
655                     try:
656                         self.apiserver.AddNodeTag(auth, nodename, nodegroupname, "yes")
657                     except:
658                         traceback.print_exc()
659                         print 'node',nodename,'seems to already have tag',nodegroupname
660                     # check anyway
661                     try:
662                         expect_yes = self.apiserver.GetNodeTags(auth,
663                                                                 {'hostname':nodename,
664                                                                  'tagname':nodegroupname},
665                                                                 ['value'])[0]['value']
666                         if expect_yes != "yes":
667                             print 'Mismatch node tag on node',nodename,'got',expect_yes
668                             overall=False
669                     except:
670                         if not self.options.dry_run:
671                             print 'Cannot find tag',nodegroupname,'on node',nodename
672                             overall = False
673             else:
674                 try:
675                     print 'cleaning nodegroup',nodegroupname
676                     self.apiserver.DeleteNodeGroup(auth,nodegroupname)
677                 except:
678                     traceback.print_exc()
679                     overall=False
680         return overall
681
682     def all_hostnames (self) :
683         hostnames = []
684         for site_spec in self.plc_spec['sites']:
685             hostnames += [ node_spec['node_fields']['hostname'] \
686                            for node_spec in site_spec['nodes'] ]
687         return hostnames
688
689     # silent_minutes : during the first <silent_minutes> minutes nothing gets printed
690     def nodes_check_boot_state (self, target_boot_state, timeout_minutes, silent_minutes,period=15):
691         if self.options.dry_run:
692             print 'dry_run'
693             return True
694         # compute timeout
695         timeout = datetime.datetime.now()+datetime.timedelta(minutes=timeout_minutes)
696         graceout = datetime.datetime.now()+datetime.timedelta(minutes=silent_minutes)
697         # the nodes that haven't checked yet - start with a full list and shrink over time
698         tocheck = self.all_hostnames()
699         utils.header("checking nodes %r"%tocheck)
700         # create a dict hostname -> status
701         status = dict ( [ (hostname,'undef') for hostname in tocheck ] )
702         while tocheck:
703             # get their status
704             tocheck_status=self.apiserver.GetNodes(self.auth_root(), tocheck, ['hostname','boot_state' ] )
705             # update status
706             for array in tocheck_status:
707                 hostname=array['hostname']
708                 boot_state=array['boot_state']
709                 if boot_state == target_boot_state:
710                     utils.header ("%s has reached the %s state"%(hostname,target_boot_state))
711                 else:
712                     # if it's a real node, never mind
713                     (site_spec,node_spec)=self.locate_hostname(hostname)
714                     if TestNode.is_real_model(node_spec['node_fields']['model']):
715                         utils.header("WARNING - Real node %s in %s - ignored"%(hostname,boot_state))
716                         # let's cheat
717                         boot_state = target_boot_state
718                     elif datetime.datetime.now() > graceout:
719                         utils.header ("%s still in '%s' state"%(hostname,boot_state))
720                         graceout=datetime.datetime.now()+datetime.timedelta(1)
721                 status[hostname] = boot_state
722             # refresh tocheck
723             tocheck = [ hostname for (hostname,boot_state) in status.iteritems() if boot_state != target_boot_state ]
724             if not tocheck:
725                 return True
726             if datetime.datetime.now() > timeout:
727                 for hostname in tocheck:
728                     utils.header("FAILURE due to %s in '%s' state"%(hostname,status[hostname]))
729                 return False
730             # otherwise, sleep for a while
731             time.sleep(period)
732         # only useful in empty plcs
733         return True
734
735     def nodes_booted(self):
736         return self.nodes_check_boot_state('boot',timeout_minutes=20,silent_minutes=15)
737
738     def check_nodes_ssh(self,debug,timeout_minutes,silent_minutes,period=20):
739         # compute timeout
740         timeout = datetime.datetime.now()+datetime.timedelta(minutes=timeout_minutes)
741         graceout = datetime.datetime.now()+datetime.timedelta(minutes=silent_minutes)
742         vservername=self.vservername
743         if debug: 
744             message="debug"
745             local_key = "keys/%(vservername)s-debug.rsa"%locals()
746         else: 
747             message="boot"
748             local_key = "keys/%(vservername)s.rsa"%locals()
749         tocheck = self.all_hostnames()
750         utils.header("checking ssh access (expected in %s mode) to nodes %r"%(message,tocheck))
751         utils.header("max timeout is %d minutes, silent for %d minutes (period is %s)"%\
752                          (timeout_minutes,silent_minutes,period))
753         while tocheck:
754             for hostname in tocheck:
755                 # try to run 'hostname' in the node
756                 command = TestSsh (hostname,key=local_key).actual_command("hostname;uname -a")
757                 # don't spam logs - show the command only after the grace period 
758                 if datetime.datetime.now() > graceout:
759                     success=utils.system(command)
760                 else:
761                     # truly silent, just print out a dot to show we're alive
762                     print '.',
763                     sys.stdout.flush()
764                     command += " 2>/dev/null"
765                     if self.options.dry_run:
766                         print 'dry_run',command
767                         success=0
768                     else:
769                         success=os.system(command)
770                 if success==0:
771                     utils.header('Successfully entered root@%s (%s)'%(hostname,message))
772                     # refresh tocheck
773                     tocheck.remove(hostname)
774                 else:
775                     # we will have tried real nodes once, in case they're up - but if not, just skip
776                     (site_spec,node_spec)=self.locate_hostname(hostname)
777                     if TestNode.is_real_model(node_spec['node_fields']['model']):
778                         utils.header ("WARNING : check ssh access into real node %s - skipped"%hostname)
779                         tocheck.remove(hostname)
780             if  not tocheck:
781                 return True
782             if datetime.datetime.now() > timeout:
783                 for hostname in tocheck:
784                     utils.header("FAILURE to ssh into %s"%hostname)
785                 return False
786             # otherwise, sleep for a while
787             time.sleep(period)
788         # only useful in empty plcs
789         return True
790         
791     def nodes_ssh_debug(self):
792         "Tries to ssh into nodes in debug mode with the debug ssh key"
793         return self.check_nodes_ssh(debug=True,timeout_minutes=30,silent_minutes=10)
794     
795     def nodes_ssh_boot(self):
796         "Tries to ssh into nodes in production mode with the root ssh key"
797         return self.check_nodes_ssh(debug=False,timeout_minutes=30,silent_minutes=10)
798     
799     @node_mapper
800     def init_node (self): 
801         "all nodes : init a clean local directory for holding node-dep stuff like iso image..."
802         pass
803     @node_mapper
804     def bootcd (self): 
805         "all nodes: invoke GetBootMedium and store result locally"
806         pass
807     @node_mapper
808     def configure_qemu (self): 
809         "all nodes: compute qemu config qemu.conf and store it locally"
810         pass
811     @node_mapper
812     def reinstall_node (self): 
813         "all nodes: mark PLCAPI boot_state as reinstall"
814         pass
815     @node_mapper
816     def export_qemu (self): 
817         "all nodes: push local node-dep directory on the qemu box"
818         pass
819         
820     ### check hooks : invoke scripts from hooks/{node,slice}
821     def check_hooks_node (self): 
822         return self.locate_first_node().check_hooks()
823     def check_hooks_sliver (self) : 
824         return self.locate_first_sliver().check_hooks()
825     
826     def check_hooks (self):
827         "runs unit tests in the node and slice contexts - see hooks/{node,slice}"
828         return self.check_hooks_node() and self.check_hooks_sliver()
829
830     ### initscripts
831     def do_check_initscripts(self):
832         overall = True
833         for slice_spec in self.plc_spec['slices']:
834             if not slice_spec.has_key('initscriptname'):
835                 continue
836             initscript=slice_spec['initscriptname']
837             for nodename in slice_spec['nodenames']:
838                 (site,node) = self.locate_node (nodename)
839                 # xxx - passing the wrong site - probably harmless
840                 test_site = TestSite (self,site)
841                 test_slice = TestSlice (self,test_site,slice_spec)
842                 test_node = TestNode (self,test_site,node)
843                 test_sliver = TestSliver (self, test_node, test_slice)
844                 if not test_sliver.check_initscript(initscript):
845                     overall = False
846         return overall
847             
848     def check_initscripts(self):
849         "check that the initscripts have triggered"
850         return self.do_check_initscripts()
851     
852     def initscripts (self):
853         "create initscripts with PLCAPI"
854         for initscript in self.plc_spec['initscripts']:
855             utils.pprint('Adding Initscript in plc %s'%self.plc_spec['name'],initscript)
856             self.apiserver.AddInitScript(self.auth_root(),initscript['initscript_fields'])
857         return True
858
859     def clean_initscripts (self):
860         "delete initscripts with PLCAPI"
861         for initscript in self.plc_spec['initscripts']:
862             initscript_name = initscript['initscript_fields']['name']
863             print('Attempting to delete %s in plc %s'%(initscript_name,self.plc_spec['name']))
864             try:
865                 self.apiserver.DeleteInitScript(self.auth_root(),initscript_name)
866                 print initscript_name,'deleted'
867             except:
868                 print 'deletion went wrong - probably did not exist'
869         return True
870
871     ### manage slices
872     def slices (self):
873         "create slices with PLCAPI"
874         return self.do_slices()
875
876     def clean_slices (self):
877         "delete slices with PLCAPI"
878         return self.do_slices("delete")
879
880     def do_slices (self,  action="add"):
881         for slice in self.plc_spec['slices']:
882             site_spec = self.locate_site (slice['sitename'])
883             test_site = TestSite(self,site_spec)
884             test_slice=TestSlice(self,test_site,slice)
885             if action != "add":
886                 utils.header("Deleting slices in site %s"%test_site.name())
887                 test_slice.delete_slice()
888             else:    
889                 utils.pprint("Creating slice",slice)
890                 test_slice.create_slice()
891                 utils.header('Created Slice %s'%slice['slice_fields']['name'])
892         return True
893         
894     @slice_mapper_options
895     def check_slice(self): 
896         "tries to ssh-enter the slice with the user key, to ensure slice creation"
897         pass
898
899     @node_mapper
900     def clear_known_hosts (self): 
901         "remove test nodes entries from the local known_hosts file"
902         pass
903     
904     @node_mapper
905     def start_node (self) : 
906         "all nodes: start the qemu instance (also runs qemu-bridge-init start)"
907         pass
908
909     def check_tcp (self):
910         "check TCP connectivity between 2 slices (or in loopback if only one is defined)"
911         specs = self.plc_spec['tcp_test']
912         overall=True
913         for spec in specs:
914             port = spec['port']
915             # server side
916             s_test_sliver = self.locate_sliver_obj (spec['server_node'],spec['server_slice'])
917             if not s_test_sliver.run_tcp_server(port,timeout=10):
918                 overall=False
919                 break
920
921             # idem for the client side
922             c_test_sliver = self.locate_sliver_obj(spec['server_node'],spec['server_slice'])
923             if not c_test_sliver.run_tcp_client(s_test_sliver.test_node.name(),port):
924                 overall=False
925         return overall
926
927     def plcsh_stress_test (self):
928         "runs PLCAPI stress test, that checks Add/Update/Delete on all types - preserves contents"
929         # install the stress-test in the plc image
930         location = "/usr/share/plc_api/plcsh_stress_test.py"
931         remote="/vservers/%s/%s"%(self.vservername,location)
932         self.test_ssh.copy_abs("plcsh_stress_test.py",remote)
933         command = location
934         command += " -- --check"
935         if self.options.size == 1:
936             command +=  " --tiny"
937         return ( self.run_in_guest(command) == 0)
938
939     # populate runs the same utility without slightly different options
940     # in particular runs with --preserve (dont cleanup) and without --check
941     # also it gets run twice, once with the --foreign option for creating fake foreign entries
942
943     ### install_sfa_rpm
944     def install_sfa(self):
945         "yum install sfa, sfa-plc and sfa-client"
946         if self.options.personality == "linux32":
947             arch = "i386"
948         elif self.options.personality == "linux64":
949             arch = "x86_64"
950         else:
951             raise Exception, "Unsupported personality %r"%self.options.personality
952         return \
953             self.run_in_guest("yum -y install sfa")==0 and \
954             self.run_in_guest("yum -y install sfa-client")==0 and \
955             self.run_in_guest("yum -y install sfa-plc")==0
956     ###
957     def configure_sfa(self):
958         "run sfa-config-tty"
959         tmpname='%s.sfa-config-tty'%(self.name())
960         fileconf=open(tmpname,'w')
961         fileconf.write ('u\n')
962         for var in [ 'SFA_REGISTRY_ROOT_AUTH',
963                      'SFA_REGISTRY_LEVEL1_AUTH',
964                      'SFA_PLC_USER',
965                      'SFA_PLC_PASSWORD',
966                      'SFA_PLC_DB_HOST',
967                      'SFA_PLC_DB_USER',
968                      'SFA_PLC_DB_PASSWORD']:
969             fileconf.write ('%s\n'%(self.plc_spec['sfa'][var]))
970         fileconf.write('w\n')
971         fileconf.write('q\n')
972         fileconf.close()
973         utils.system('cat %s'%tmpname)
974         self.run_in_guest_piped('cat %s'%tmpname,'sfa-config-tty')
975         utils.system('rm %s'%tmpname)
976         return True
977
978     def import_sfa(self):
979         "sfa-import-plc"
980         auth=self.plc_spec['sfa']['SFA_REGISTRY_ROOT_AUTH']
981         self.run_in_guest('sfa-import-plc.py')
982         self.run_in_guest('cp /etc/sfa/authorities/%s/%s.pkey /etc/sfa/authorities/server.key'%(auth,auth))
983         return True
984
985     def start_sfa(self):
986         "service sfa start"
987         self.run_in_guest('service sfa start')
988         return True
989
990     def setup_sfa(self):
991         "sfi client configuration"
992         dir_name=".sfi"
993         if os.path.exists(dir_name):
994            utils.system('rm -rf %s'%dir_name)
995         utils.system('mkdir %s'%dir_name)
996         file_name=dir_name + os.sep + 'fake-pi1.pkey'
997         fileconf=open(file_name,'w')
998         fileconf.write (self.plc_spec['keys'][0]['private'])
999         fileconf.close()
1000
1001         file_name=dir_name + os.sep + 'sfi_config'
1002         fileconf=open(file_name,'w')
1003         SFI_AUTH=self.plc_spec['sfa']['SFA_REGISTRY_ROOT_AUTH']+".main"
1004         fileconf.write ("SFI_AUTH='%s'"%SFI_AUTH)
1005         fileconf.write('\n')
1006         SFI_USER=SFI_AUTH+'.fake-pi1'
1007         fileconf.write ("SFI_USER='%s'"%SFI_USER)
1008         fileconf.write('\n')
1009         fileconf.write ("SFI_REGISTRY='http://localhost:12345/'")
1010         fileconf.write('\n')
1011         fileconf.write ("SFI_SM='http://localhost:12347/'")
1012         fileconf.write('\n')
1013         fileconf.close()
1014
1015         file_name=dir_name + os.sep + 'person.xml'
1016         fileconf=open(file_name,'w')
1017         for record in self.plc_spec['sfa']['sfa_person_xml']:
1018            person_record=record
1019         fileconf.write(person_record)
1020         fileconf.write('\n')
1021         fileconf.close()
1022
1023         file_name=dir_name + os.sep + 'slice.xml'
1024         fileconf=open(file_name,'w')
1025         for record in self.plc_spec['sfa']['sfa_slice_xml']:
1026             slice_record=record
1027         #slice_record=self.plc_spec['sfa']['sfa_slice_xml']
1028         fileconf.write(slice_record)
1029         fileconf.write('\n')
1030         fileconf.close()
1031
1032         file_name=dir_name + os.sep + 'slice.rspec'
1033         fileconf=open(file_name,'w')
1034         slice_rspec=''
1035         for (key, value) in self.plc_spec['sfa']['sfa_slice_rspec'].items():
1036             slice_rspec +=value 
1037         fileconf.write(slice_rspec)
1038         fileconf.write('\n')
1039         fileconf.close()
1040         location = "root/"
1041         remote="/vservers/%s/%s"%(self.vservername,location)
1042         self.test_ssh.copy_abs(dir_name, remote, recursive=True)
1043
1044         #utils.system('cat %s'%tmpname)
1045         utils.system('rm -rf %s'%dir_name)
1046         return True
1047
1048     def add_sfa(self):
1049         "run sfi.py add (on Registry) and sfi.py create (on SM) to form new objects"
1050         test_plc=self
1051         test_user_sfa=TestUserSfa(test_plc,self.plc_spec['sfa'])
1052         success=test_user_sfa.add_user()
1053
1054         for slice_spec in self.plc_spec['sfa']['slices_sfa']:
1055             site_spec = self.locate_site (slice_spec['sitename'])
1056             test_site = TestSite(self,site_spec)
1057             test_slice_sfa=TestSliceSfa(test_plc,test_site,slice_spec)
1058             success1=test_slice_sfa.add_slice()
1059             success2=test_slice_sfa.create_slice()
1060         return success and success1 and success2
1061
1062     def update_sfa(self):
1063         "run sfi.py update (on Registry) and sfi.py create (on SM) on existing objects"
1064         test_plc=self
1065         test_user_sfa=TestUserSfa(test_plc,self.plc_spec['sfa'])
1066         success1=test_user_sfa.update_user()
1067         
1068         for slice_spec in self.plc_spec['sfa']['slices_sfa']:
1069             site_spec = self.locate_site (slice_spec['sitename'])
1070             test_site = TestSite(self,site_spec)
1071             test_slice_sfa=TestSliceSfa(test_plc,test_site,slice_spec)
1072             success2=test_slice_sfa.update_slice()
1073         return success1 and success2
1074
1075     def view_sfa(self):
1076         "run sfi.py list and sfi.py show (both on Registry) and sfi.py slices and sfi.py resources (both on SM)"
1077         auth=self.plc_spec['sfa']['SFA_REGISTRY_ROOT_AUTH']
1078         return \
1079         self.run_in_guest("sfi.py -d /root/.sfi/ list %s.main"%auth)==0 and \
1080         self.run_in_guest("sfi.py -d /root/.sfi/ show %s.main"%auth)==0 and \
1081         self.run_in_guest("sfi.py -d /root/.sfi/ slices")==0 and \
1082         self.run_in_guest("sfi.py -d /root/.sfi/ resources")==0
1083
1084     @slice_mapper_options_sfa
1085     def check_slice_sfa(self): 
1086         "tries to ssh-enter the SFA slice"
1087         pass
1088
1089     def delete_sfa(self):
1090         "run sfi.py delete (on SM), sfi.py remove (on Registry)"
1091         test_plc=self
1092         test_user_sfa=TestUserSfa(test_plc,self.plc_spec['sfa'])
1093         success1=test_user_sfa.delete_user()
1094         for slice_spec in self.plc_spec['sfa']['slices_sfa']:
1095             site_spec = self.locate_site (slice_spec['sitename'])
1096             test_site = TestSite(self,site_spec)
1097             test_slice_sfa=TestSliceSfa(test_plc,test_site,slice_spec)
1098             success2=test_slice_sfa.delete_slice()
1099
1100         return success1 and success2
1101
1102     def stop_sfa(self):
1103         "service sfa stop"
1104         self.run_in_guest('service sfa stop')
1105         return True
1106
1107     def populate (self):
1108         "creates random entries in the PLCAPI"
1109         # install the stress-test in the plc image
1110         location = "/usr/share/plc_api/plcsh_stress_test.py"
1111         remote="/vservers/%s/%s"%(self.vservername,location)
1112         self.test_ssh.copy_abs("plcsh_stress_test.py",remote)
1113         command = location
1114         command += " -- --preserve --short-names"
1115         local = (self.run_in_guest(command) == 0);
1116         # second run with --foreign
1117         command += ' --foreign'
1118         remote = (self.run_in_guest(command) == 0);
1119         return ( local and remote)
1120
1121     def gather_logs (self):
1122         "gets all possible logs from plc's/qemu node's/slice's for future reference"
1123         # (1.a) get the plc's /var/log/ and store it locally in logs/myplc.var-log.<plcname>/*
1124         # (1.b) get the plc's  /var/lib/pgsql/data/pg_log/ -> logs/myplc.pgsql-log.<plcname>/*
1125         # (2) get all the nodes qemu log and store it as logs/node.qemu.<node>.log
1126         # (3) get the nodes /var/log and store is as logs/node.var-log.<node>/*
1127         # (4) as far as possible get the slice's /var/log as logs/sliver.var-log.<sliver>/*
1128         # (1.a)
1129         print "-------------------- TestPlc.gather_logs : PLC's /var/log"
1130         self.gather_var_logs ()
1131         # (1.b)
1132         print "-------------------- TestPlc.gather_logs : PLC's /var/lib/psql/data/pg_log/"
1133         self.gather_pgsql_logs ()
1134         # (2) 
1135         print "-------------------- TestPlc.gather_logs : nodes's QEMU logs"
1136         for site_spec in self.plc_spec['sites']:
1137             test_site = TestSite (self,site_spec)
1138             for node_spec in site_spec['nodes']:
1139                 test_node=TestNode(self,test_site,node_spec)
1140                 test_node.gather_qemu_logs()
1141         # (3)
1142         print "-------------------- TestPlc.gather_logs : nodes's /var/log"
1143         self.gather_nodes_var_logs()
1144         # (4)
1145         print "-------------------- TestPlc.gather_logs : sample sliver's /var/log"
1146         self.gather_slivers_var_logs()
1147         return True
1148
1149     def gather_slivers_var_logs(self):
1150         for test_sliver in self.all_sliver_objs():
1151             remote = test_sliver.tar_var_logs()
1152             utils.system("mkdir -p logs/sliver.var-log.%s"%test_sliver.name())
1153             command = remote + " | tar -C logs/sliver.var-log.%s -xf -"%test_sliver.name()
1154             utils.system(command)
1155         return True
1156
1157     def gather_var_logs (self):
1158         utils.system("mkdir -p logs/myplc.var-log.%s"%self.name())
1159         to_plc = self.actual_command_in_guest("tar -C /var/log/ -cf - .")        
1160         command = to_plc + "| tar -C logs/myplc.var-log.%s -xf -"%self.name()
1161         utils.system(command)
1162         command = "chmod a+r,a+x logs/myplc.var-log.%s/httpd"%self.name()
1163         utils.system(command)
1164
1165     def gather_pgsql_logs (self):
1166         utils.system("mkdir -p logs/myplc.pgsql-log.%s"%self.name())
1167         to_plc = self.actual_command_in_guest("tar -C /var/lib/pgsql/data/pg_log/ -cf - .")        
1168         command = to_plc + "| tar -C logs/myplc.pgsql-log.%s -xf -"%self.name()
1169         utils.system(command)
1170
1171     def gather_nodes_var_logs (self):
1172         for site_spec in self.plc_spec['sites']:
1173             test_site = TestSite (self,site_spec)
1174             for node_spec in site_spec['nodes']:
1175                 test_node=TestNode(self,test_site,node_spec)
1176                 test_ssh = TestSsh (test_node.name(),key="/etc/planetlab/root_ssh_key.rsa")
1177                 to_plc = self.actual_command_in_guest ( test_ssh.actual_command("tar -C /var/log -cf - ."))
1178                 command = to_plc + "| tar -C logs/node.var-log.%s -xf -"%test_node.name()
1179                 utils.system("mkdir -p logs/node.var-log.%s"%test_node.name())
1180                 utils.system(command)
1181
1182
1183     # returns the filename to use for sql dump/restore, using options.dbname if set
1184     def dbfile (self, database):
1185         # uses options.dbname if it is found
1186         try:
1187             name=self.options.dbname
1188             if not isinstance(name,StringTypes):
1189                 raise Exception
1190         except:
1191             t=datetime.datetime.now()
1192             d=t.date()
1193             name=str(d)
1194         return "/root/%s-%s.sql"%(database,name)
1195
1196     def db_dump(self):
1197         dump=self.dbfile("planetab4")
1198         self.run_in_guest('pg_dump -U pgsqluser planetlab4 -f '+ dump)
1199         utils.header('Dumped planetlab4 database in %s'%dump)
1200         return True
1201
1202     def db_restore(self):
1203         dump=self.dbfile("planetab4")
1204         ##stop httpd service
1205         self.run_in_guest('service httpd stop')
1206         # xxx - need another wrapper
1207         self.run_in_guest_piped('echo drop database planetlab4','psql --user=pgsqluser template1')
1208         self.run_in_guest('createdb -U postgres --encoding=UNICODE --owner=pgsqluser planetlab4')
1209         self.run_in_guest('psql -U pgsqluser planetlab4 -f '+dump)
1210         ##starting httpd service
1211         self.run_in_guest('service httpd start')
1212
1213         utils.header('Database restored from ' + dump)
1214
1215     @standby_generic 
1216     def standby_1(): pass
1217     @standby_generic 
1218     def standby_2(): pass
1219     @standby_generic 
1220     def standby_3(): pass
1221     @standby_generic 
1222     def standby_4(): pass
1223     @standby_generic 
1224     def standby_5(): pass
1225     @standby_generic 
1226     def standby_6(): pass
1227     @standby_generic 
1228     def standby_7(): pass
1229     @standby_generic 
1230     def standby_8(): pass
1231     @standby_generic 
1232     def standby_9(): pass
1233     @standby_generic 
1234     def standby_10(): pass
1235     @standby_generic 
1236     def standby_11(): pass
1237     @standby_generic 
1238     def standby_12(): pass
1239     @standby_generic 
1240     def standby_13(): pass
1241     @standby_generic 
1242     def standby_14(): pass
1243     @standby_generic 
1244     def standby_15(): pass
1245     @standby_generic 
1246     def standby_16(): pass
1247     @standby_generic 
1248     def standby_17(): pass
1249     @standby_generic 
1250     def standby_18(): pass
1251     @standby_generic 
1252     def standby_19(): pass
1253     @standby_generic 
1254     def standby_20(): pass