advise users to disable the framebuffer
[invirt/packages/invirt-web.git] / main.py
1 #!/usr/bin/python
2 """Main CGI script for web interface"""
3
4 import base64
5 import cPickle
6 import cgi
7 import datetime
8 import hmac
9 import os
10 import sha
11 import simplejson
12 import sys
13 import time
14 from StringIO import StringIO
15
16 def revertStandardError():
17     """Move stderr to stdout, and return the contents of the old stderr."""
18     errio = sys.stderr
19     if not isinstance(errio, StringIO):
20         return None
21     sys.stderr = sys.stdout
22     errio.seek(0)
23     return errio.read()
24
25 def printError():
26     """Revert stderr to stdout, and print the contents of stderr"""
27     if isinstance(sys.stderr, StringIO):
28         print revertStandardError()
29
30 if __name__ == '__main__':
31     import atexit
32     atexit.register(printError)
33     sys.stderr = StringIO()
34
35 sys.path.append('/home/ecprice/.local/lib/python2.5/site-packages')
36
37 import templates
38 from Cheetah.Template import Template
39 from sipb_xen_database import Machine, CDROM, ctx, connect, MachineAccess
40 import validation
41 from webcommon import InvalidInput, CodeError, g
42 import controls
43
44 class Checkpoint:
45     def __init__(self):
46         self.start_time = time.time()
47         self.checkpoints = []
48
49     def checkpoint(self, s):
50         self.checkpoints.append((s, time.time()))
51
52     def __str__(self):
53         return ('Timing info:\n%s\n' %
54                 '\n'.join(['%s: %s' % (d, t - self.start_time) for
55                            (d, t) in self.checkpoints]))
56
57 checkpoint = Checkpoint()
58
59
60 def helppopup(subj):
61     """Return HTML code for a (?) link to a specified help topic"""
62     return ('<span class="helplink"><a href="help?subject=' + subj + 
63             '&amp;simple=true" target="_blank" ' + 
64             'onclick="return helppopup(\'' + subj + '\')">(?)</a></span>')
65
66 def makeErrorPre(old, addition):
67     if addition is None:
68         return
69     if old:
70         return old[:-6]  + '\n----\n' + str(addition) + '</pre>'
71     else:
72         return '<p>STDERR:</p><pre>' + str(addition) + '</pre>'
73
74 Template.helppopup = staticmethod(helppopup)
75 Template.err = None
76
77 class JsonDict:
78     """Class to store a dictionary that will be converted to JSON"""
79     def __init__(self, **kws):
80         self.data = kws
81         if 'err' in kws:
82             err = kws['err']
83             del kws['err']
84             self.addError(err)
85
86     def __str__(self):
87         return simplejson.dumps(self.data)
88
89     def addError(self, text):
90         """Add stderr text to be displayed on the website."""
91         self.data['err'] = \
92             makeErrorPre(self.data.get('err'), text)
93
94 class Defaults:
95     """Class to store default values for fields."""
96     memory = 256
97     disk = 4.0
98     cdrom = ''
99     name = ''
100     vmtype = 'hvm'
101     def __init__(self, max_memory=None, max_disk=None, **kws):
102         if max_memory is not None:
103             self.memory = min(self.memory, max_memory)
104         if max_disk is not None:
105             self.max_disk = min(self.disk, max_disk)
106         for key in kws:
107             setattr(self, key, kws[key])
108
109
110
111 DEFAULT_HEADERS = {'Content-Type': 'text/html'}
112
113 def error(op, user, fields, err, emsg):
114     """Print an error page when a CodeError occurs"""
115     d = dict(op=op, user=user, errorMessage=str(err),
116              stderr=emsg)
117     return templates.error(searchList=[d])
118
119 def invalidInput(op, user, fields, err, emsg):
120     """Print an error page when an InvalidInput exception occurs"""
121     d = dict(op=op, user=user, err_field=err.err_field,
122              err_value=str(err.err_value), stderr=emsg,
123              errorMessage=str(err))
124     return templates.invalid(searchList=[d])
125
126 def hasVnc(status):
127     """Does the machine with a given status list support VNC?"""
128     if status is None:
129         return False
130     for l in status:
131         if l[0] == 'device' and l[1][0] == 'vfb':
132             d = dict(l[1][1:])
133             return 'location' in d
134     return False
135
136 def parseCreate(user, fields):
137     name = fields.getfirst('name')
138     if not validation.validMachineName(name):
139         raise InvalidInput('name', name, 'You must provide a machine name.')
140     name = name.lower()
141
142     if Machine.get_by(name=name):
143         raise InvalidInput('name', name,
144                            "Name already exists.")
145     
146     owner = validation.testOwner(user, fields.getfirst('owner'))
147
148     memory = fields.getfirst('memory')
149     memory = validation.validMemory(owner, memory, on=True)
150     
151     disk_size = fields.getfirst('disk')
152     disk_size = validation.validDisk(owner, disk_size)
153
154     vm_type = fields.getfirst('vmtype')
155     if vm_type not in ('hvm', 'paravm'):
156         raise CodeError("Invalid vm type '%s'"  % vm_type)    
157     is_hvm = (vm_type == 'hvm')
158
159     cdrom = fields.getfirst('cdrom')
160     if cdrom is not None and not CDROM.get(cdrom):
161         raise CodeError("Invalid cdrom type '%s'" % cdrom)
162     return dict(contact=user, name=name, memory=memory, disk_size=disk_size,
163                 owner=owner, is_hvm=is_hvm, cdrom=cdrom)
164
165 def create(user, fields):
166     """Handler for create requests."""
167     try:
168         parsed_fields = parseCreate(user, fields)
169         machine = controls.createVm(**parsed_fields)
170     except InvalidInput, err:
171         pass
172     else:
173         err = None
174     g.clear() #Changed global state
175     d = getListDict(user)
176     d['err'] = err
177     if err:
178         for field in fields.keys():
179             setattr(d['defaults'], field, fields.getfirst(field))
180     else:
181         d['new_machine'] = parsed_fields['name']
182     return templates.list(searchList=[d])
183
184
185 def getListDict(user):
186     machines = g.machines
187     checkpoint.checkpoint('Got my machines')
188     on = {}
189     has_vnc = {}
190     on = g.uptimes
191     checkpoint.checkpoint('Got uptimes')
192     for m in machines:
193         m.uptime = g.uptimes.get(m)
194         if not on[m]:
195             has_vnc[m] = 'Off'
196         elif m.type.hvm:
197             has_vnc[m] = True
198         else:
199             has_vnc[m] = "ParaVM"+helppopup("paravm_console")
200     max_memory = validation.maxMemory(user)
201     max_disk = validation.maxDisk(user)
202     checkpoint.checkpoint('Got max mem/disk')
203     defaults = Defaults(max_memory=max_memory,
204                         max_disk=max_disk,
205                         owner=user,
206                         cdrom='gutsy-i386')
207     checkpoint.checkpoint('Got defaults')
208     d = dict(user=user,
209              cant_add_vm=validation.cantAddVm(user),
210              max_memory=max_memory,
211              max_disk=max_disk,
212              defaults=defaults,
213              machines=machines,
214              has_vnc=has_vnc,
215              uptimes=g.uptimes,
216              cdroms=CDROM.select())
217     return d
218
219 def listVms(user, fields):
220     """Handler for list requests."""
221     checkpoint.checkpoint('Getting list dict')
222     d = getListDict(user)
223     checkpoint.checkpoint('Got list dict')
224     return templates.list(searchList=[d])
225             
226 def vnc(user, fields):
227     """VNC applet page.
228
229     Note that due to same-domain restrictions, the applet connects to
230     the webserver, which needs to forward those requests to the xen
231     server.  The Xen server runs another proxy that (1) authenticates
232     and (2) finds the correct port for the VM.
233
234     You might want iptables like:
235
236     -t nat -A PREROUTING -s ! 18.181.0.60 -i eth1 -p tcp -m tcp \
237       --dport 10003 -j DNAT --to-destination 18.181.0.60:10003 
238     -t nat -A POSTROUTING -d 18.181.0.60 -o eth1 -p tcp -m tcp \
239       --dport 10003 -j SNAT --to-source 18.187.7.142 
240     -A FORWARD -d 18.181.0.60 -i eth1 -o eth1 -p tcp -m tcp \
241       --dport 10003 -j ACCEPT
242
243     Remember to enable iptables!
244     echo 1 > /proc/sys/net/ipv4/ip_forward
245     """
246     machine = validation.testMachineId(user, fields.getfirst('machine_id'))
247     
248     TOKEN_KEY = "0M6W0U1IXexThi5idy8mnkqPKEq1LtEnlK/pZSn0cDrN"
249
250     data = {}
251     data["user"] = user
252     data["machine"] = machine.name
253     data["expires"] = time.time()+(5*60)
254     pickled_data = cPickle.dumps(data)
255     m = hmac.new(TOKEN_KEY, digestmod=sha)
256     m.update(pickled_data)
257     token = {'data': pickled_data, 'digest': m.digest()}
258     token = cPickle.dumps(token)
259     token = base64.urlsafe_b64encode(token)
260     
261     status = controls.statusInfo(machine)
262     has_vnc = hasVnc(status)
263     
264     d = dict(user=user,
265              on=status,
266              has_vnc=has_vnc,
267              machine=machine,
268              hostname=os.environ.get('SERVER_NAME', 'localhost'),
269              authtoken=token)
270     return templates.vnc(searchList=[d])
271
272 def getHostname(nic):
273     if nic.hostname and '.' in nic.hostname:
274         return nic.hostname
275     elif nic.machine:
276         return nic.machine.name + '.servers.csail.mit.edu'
277     else:
278         return None
279
280
281 def getNicInfo(data_dict, machine):
282     """Helper function for info, get data on nics for a machine.
283
284     Modifies data_dict to include the relevant data, and returns a list
285     of (key, name) pairs to display "name: data_dict[key]" to the user.
286     """
287     data_dict['num_nics'] = len(machine.nics)
288     nic_fields_template = [('nic%s_hostname', 'NIC %s Hostname'),
289                            ('nic%s_mac', 'NIC %s MAC Addr'),
290                            ('nic%s_ip', 'NIC %s IP'),
291                            ]
292     nic_fields = []
293     for i in range(len(machine.nics)):
294         nic_fields.extend([(x % i, y % i) for x, y in nic_fields_template])
295         if not i:
296             data_dict['nic%s_hostname' % i] = getHostname(machine.nics[i])
297         data_dict['nic%s_mac' % i] = machine.nics[i].mac_addr
298         data_dict['nic%s_ip' % i] = machine.nics[i].ip
299     if len(machine.nics) == 1:
300         nic_fields = [(x, y.replace('NIC 0 ', '')) for x, y in nic_fields]
301     return nic_fields
302
303 def getDiskInfo(data_dict, machine):
304     """Helper function for info, get data on disks for a machine.
305
306     Modifies data_dict to include the relevant data, and returns a list
307     of (key, name) pairs to display "name: data_dict[key]" to the user.
308     """
309     data_dict['num_disks'] = len(machine.disks)
310     disk_fields_template = [('%s_size', '%s size')]
311     disk_fields = []
312     for disk in machine.disks:
313         name = disk.guest_device_name
314         disk_fields.extend([(x % name, y % name) for x, y in 
315                             disk_fields_template])
316         data_dict['%s_size' % name] = "%0.1f GiB" % (disk.size / 1024.)
317     return disk_fields
318
319 def command(user, fields):
320     """Handler for running commands like boot and delete on a VM."""
321     back = fields.getfirst('back')
322     try:
323         d = controls.commandResult(user, fields)
324         if d['command'] == 'Delete VM':
325             back = 'list'
326     except InvalidInput, err:
327         if not back:
328             raise
329         #print >> sys.stderr, err
330         result = err
331     else:
332         result = 'Success!'
333         if not back:
334             return templates.command(searchList=[d])
335     if back == 'list':
336         g.clear() #Changed global state
337         d = getListDict(user)
338         d['result'] = result
339         return templates.list(searchList=[d])
340     elif back == 'info':
341         machine = validation.testMachineId(user, fields.getfirst('machine_id'))
342         d = infoDict(user, machine)
343         d['result'] = result
344         return templates.info(searchList=[d])
345     else:
346         raise InvalidInput('back', back, 'Not a known back page.')
347
348 def modifyDict(user, fields):
349     olddisk = {}
350     transaction = ctx.current.create_transaction()
351     try:
352         machine = validation.testMachineId(user, fields.getfirst('machine_id'))
353         owner = validation.testOwner(user, fields.getfirst('owner'), machine)
354         admin = validation.testAdmin(user, fields.getfirst('administrator'),
355                                      machine)
356         contact = validation.testContact(user, fields.getfirst('contact'),
357                                          machine)
358         name = validation.testName(user, fields.getfirst('name'), machine)
359         oldname = machine.name
360         command = "modify"
361
362         memory = fields.getfirst('memory')
363         if memory is not None:
364             memory = validation.validMemory(user, memory, machine, on=False)
365             machine.memory = memory
366  
367         disksize = validation.testDisk(user, fields.getfirst('disk'))
368         if disksize is not None:
369             disksize = validation.validDisk(user, disksize, machine)
370             disk = machine.disks[0]
371             if disk.size != disksize:
372                 olddisk[disk.guest_device_name] = disksize
373                 disk.size = disksize
374                 ctx.current.save(disk)
375         
376         if owner is not None:
377             machine.owner = owner
378         if name is not None:
379             machine.name = name
380         if admin is not None:
381             machine.administrator = admin
382         if contact is not None:
383             machine.contact = contact
384             
385         ctx.current.save(machine)
386         transaction.commit()
387     except:
388         transaction.rollback()
389         raise
390     for diskname in olddisk:
391         controls.resizeDisk(oldname, diskname, str(olddisk[diskname]))
392     if name is not None:
393         controls.renameMachine(machine, oldname, name)
394     return dict(user=user,
395                 command=command,
396                 machine=machine)
397     
398 def modify(user, fields):
399     """Handler for modifying attributes of a machine."""
400     try:
401         modify_dict = modifyDict(user, fields)
402     except InvalidInput, err:
403         result = None
404         machine = validation.testMachineId(user, fields.getfirst('machine_id'))
405     else:
406         machine = modify_dict['machine']
407         result = 'Success!'
408         err = None
409     info_dict = infoDict(user, machine)
410     info_dict['err'] = err
411     if err:
412         for field in fields.keys():
413             setattr(info_dict['defaults'], field, fields.getfirst(field))
414     info_dict['result'] = result
415     return templates.info(searchList=[info_dict])
416     
417
418 def helpHandler(user, fields):
419     """Handler for help messages."""
420     simple = fields.getfirst('simple')
421     subjects = fields.getlist('subject')
422     
423     help_mapping = dict(paravm_console="""
424 ParaVM machines do not support console access over VNC.  To access
425 these machines, you either need to boot with a liveCD and ssh in or
426 hope that the sipb-xen maintainers add support for serial consoles.""",
427                         hvm_paravm="""
428 HVM machines use the virtualization features of the processor, while
429 ParaVM machines use Xen's emulation of virtualization features.  You
430 want an HVM virtualized machine.""",
431                         cpu_weight="""
432 Don't ask us!  We're as mystified as you are.""",
433                         owner="""
434 The owner field is used to determine <a
435 href="help?subject=quotas">quotas</a>.  It must be the name of a
436 locker that you are an AFS administrator of.  In particular, you or an
437 AFS group you are a member of must have AFS rlidwka bits on the
438 locker.  You can check see who administers the LOCKER locker using the
439 command 'fs la /mit/LOCKER' on Athena.)  See also <a
440 href="help?subject=administrator">administrator</a>.""",
441                         administrator="""
442 The administrator field determines who can access the console and
443 power on and off the machine.  This can be either a user or a moira
444 group.""",
445                         quotas="""
446 Quotas are determined on a per-locker basis.  Each quota may have a
447 maximum of 512 megabytes of active ram, 50 gigabytes of disk, and 4
448 active machines."""
449                    )
450     
451     if not subjects:
452         subjects = sorted(help_mapping.keys())
453         
454     d = dict(user=user,
455              simple=simple,
456              subjects=subjects,
457              mapping=help_mapping)
458     
459     return templates.help(searchList=[d])
460     
461
462 def badOperation(u, e):
463     raise CodeError("Unknown operation")
464
465 def infoDict(user, machine):
466     status = controls.statusInfo(machine)
467     checkpoint.checkpoint('Getting status info')
468     has_vnc = hasVnc(status)
469     if status is None:
470         main_status = dict(name=machine.name,
471                            memory=str(machine.memory))
472         uptime = None
473         cputime = None
474     else:
475         main_status = dict(status[1:])
476         start_time = float(main_status.get('start_time', 0))
477         uptime = datetime.timedelta(seconds=int(time.time()-start_time))
478         cpu_time_float = float(main_status.get('cpu_time', 0))
479         cputime = datetime.timedelta(seconds=int(cpu_time_float))
480     checkpoint.checkpoint('Status')
481     display_fields = """name uptime memory state cpu_weight on_reboot 
482      on_poweroff on_crash on_xend_start on_xend_stop bootloader""".split()
483     display_fields = [('name', 'Name'),
484                       ('owner', 'Owner'),
485                       ('administrator', 'Administrator'),
486                       ('contact', 'Contact'),
487                       ('type', 'Type'),
488                       'NIC_INFO',
489                       ('uptime', 'uptime'),
490                       ('cputime', 'CPU usage'),
491                       ('memory', 'RAM'),
492                       'DISK_INFO',
493                       ('state', 'state (xen format)'),
494                       ('cpu_weight', 'CPU weight'+helppopup('cpu_weight')),
495                       ('on_reboot', 'Action on VM reboot'),
496                       ('on_poweroff', 'Action on VM poweroff'),
497                       ('on_crash', 'Action on VM crash'),
498                       ('on_xend_start', 'Action on Xen start'),
499                       ('on_xend_stop', 'Action on Xen stop'),
500                       ('bootloader', 'Bootloader options'),
501                       ]
502     fields = []
503     machine_info = {}
504     machine_info['name'] = machine.name
505     machine_info['type'] = machine.type.hvm and 'HVM' or 'ParaVM'
506     machine_info['owner'] = machine.owner
507     machine_info['administrator'] = machine.administrator
508     machine_info['contact'] = machine.contact
509
510     nic_fields = getNicInfo(machine_info, machine)
511     nic_point = display_fields.index('NIC_INFO')
512     display_fields = (display_fields[:nic_point] + nic_fields + 
513                       display_fields[nic_point+1:])
514
515     disk_fields = getDiskInfo(machine_info, machine)
516     disk_point = display_fields.index('DISK_INFO')
517     display_fields = (display_fields[:disk_point] + disk_fields + 
518                       display_fields[disk_point+1:])
519     
520     main_status['memory'] += ' MiB'
521     for field, disp in display_fields:
522         if field in ('uptime', 'cputime') and locals()[field] is not None:
523             fields.append((disp, locals()[field]))
524         elif field in machine_info:
525             fields.append((disp, machine_info[field]))
526         elif field in main_status:
527             fields.append((disp, main_status[field]))
528         else:
529             pass
530             #fields.append((disp, None))
531
532     checkpoint.checkpoint('Got fields')
533
534
535     max_mem = validation.maxMemory(user, machine, False)
536     checkpoint.checkpoint('Got mem')
537     max_disk = validation.maxDisk(user, machine)
538     defaults = Defaults()
539     for name in 'machine_id name administrator owner memory contact'.split():
540         setattr(defaults, name, getattr(machine, name))
541     defaults.disk = "%0.2f" % (machine.disks[0].size/1024.)
542     checkpoint.checkpoint('Got defaults')
543     d = dict(user=user,
544              cdroms=CDROM.select(),
545              on=status is not None,
546              machine=machine,
547              defaults=defaults,
548              has_vnc=has_vnc,
549              uptime=str(uptime),
550              ram=machine.memory,
551              max_mem=max_mem,
552              max_disk=max_disk,
553              owner_help=helppopup("owner"),
554              fields = fields)
555     return d
556
557 def info(user, fields):
558     """Handler for info on a single VM."""
559     machine = validation.testMachineId(user, fields.getfirst('machine_id'))
560     d = infoDict(user, machine)
561     checkpoint.checkpoint('Got infodict')
562     return templates.info(searchList=[d])
563
564 mapping = dict(list=listVms,
565                vnc=vnc,
566                command=command,
567                modify=modify,
568                info=info,
569                create=create,
570                help=helpHandler)
571
572 def printHeaders(headers):
573     for key, value in headers.iteritems():
574         print '%s: %s' % (key, value)
575     print
576
577
578 def getUser():
579     """Return the current user based on the SSL environment variables"""
580     username = os.environ['SSL_CLIENT_S_DN_Email'].split("@")[0]
581     return username
582
583 def main(operation, user, fields):    
584     start_time = time.time()
585     fun = mapping.get(operation, badOperation)
586
587     if fun not in (helpHandler, ):
588         connect('postgres://sipb-xen@sipb-xen-dev.mit.edu/sipb_xen')
589     try:
590         checkpoint.checkpoint('Before')
591         output = fun(u, fields)
592         checkpoint.checkpoint('After')
593
594         headers = dict(DEFAULT_HEADERS)
595         if isinstance(output, tuple):
596             new_headers, output = output
597             headers.update(new_headers)
598         e = revertStandardError()
599         if e:
600             output.addError(e)
601         printHeaders(headers)
602         output_string =  str(output)
603         checkpoint.checkpoint('output as a string')
604         print output_string
605         print '<pre>%s</pre>' % checkpoint
606     except Exception, err:
607         if not fields.has_key('js'):
608             if isinstance(err, CodeError):
609                 print 'Content-Type: text/html\n'
610                 e = revertStandardError()
611                 print error(operation, u, fields, err, e)
612                 sys.exit(1)
613             if isinstance(err, InvalidInput):
614                 print 'Content-Type: text/html\n'
615                 e = revertStandardError()
616                 print invalidInput(operation, u, fields, err, e)
617                 sys.exit(1)
618         print 'Content-Type: text/plain\n'
619         print 'Uh-oh!  We experienced an error.'
620         print 'Please email sipb-xen@mit.edu with the contents of this page.'
621         print '----'
622         e = revertStandardError()
623         print e
624         print '----'
625         raise
626
627 if __name__ == '__main__':
628     fields = cgi.FieldStorage()
629     u = getUser()
630     g.user = u
631     operation = os.environ.get('PATH_INFO', '')
632     if not operation:
633         print "Status: 301 Moved Permanently"
634         print 'Location: ' + os.environ['SCRIPT_NAME']+'/\n'
635         sys.exit(0)
636
637     if operation.startswith('/'):
638         operation = operation[1:]
639     if not operation:
640         operation = 'list'
641
642     if os.getenv("SIPB_XEN_PROFILE"):
643         import profile
644         profile.run('main(operation, u, fields)', 'log-'+operation)
645     else:
646         main(operation, u, fields)