linux_usr/gui/README

   1 This directory contains an implementation of a graphical user
   2 interface for Palacios VMs, analogous to the "server console" tool in
   3 VMware or VirtualBox, etc.  The GUI builds directly on top of the
   4 Palacios command-line utilities.
   5
   6 The GUI was initially implemented by Abhinav Kannan and is:
   7
   8 (c) 2012 Abhinav Kannan
   9 (c) 2012 V3VEE Project
  10
  11 As with other Linux interface components of Palacios, it is released
  12 under GPL.  Palacios itself is released under a BSD license.
  13
  14
  15 PREREQUISITES
  16 =============
  17
  18 To build the GUI, you will need to install various libraries and
  19 components.  Specifically, you need:
  20
  21 - QT4
  22 - QT4 development support and tools (qmake)
  23 - LibVNCServer
  24 - GNUTLS and GNUTLS development support
  25
  26
  27 The easiest way to do this is to become root and then use
  28 your package manager.
  29
  30 For example, on a Red Hat or Fedora system:
  31
  32 su - (become root)
  33 yum install qt4
  34 yum install qt4-devel
  35 yum install libvncsever
  36 yum install libvncserver-devel
  37 yum install gnutls
  38 yum install gnutls-devel
  39 exit (return to normal user)
  40
  41 If you need to set up as a none-root user, please see the file
  42 report.pdf.
  43
  44
  45 BUILDING
  46 ========
  47
  48 1. Use qmake to build a Makefile for your machine:
  49
  50 qmake Palacos.Pro
  51
  52 2. make it
  53
  54 make
  55
  56 3. you should now have an executable file "Palacios"
  57    this will become palacios/linux_usr/v3_x0gui
  58    and will be wrapped by the script palacios/linux_usr/v3_gui
  59
  60 If you would like to change things, please read report.pdf.
  61 The "Palacios.pro" file mentioned in the report is
  62 included here as "Palacios.pro.locallibs"
  63
  64 RUNNING
  65 =======
  66
  67 To run the GUI, the Palacios command-line utilities and xterm need to
  68 be on your path, and v3vee.ko kernel module must be inserted into
  69 the running kernel.    For example:
  70
  71 export PATH=$PATH:/home/foo/palacios/linxu_usr:/path/to/xterm
  72 insmod /home/foo/palacios/v3vee.ko
  73 Palacios &
  74
  75