Revision 77a180f6

b/INSTALL
50 50 
                    python-pyparsing python-simplejson \
51 51 
                    python-pyinotify python-pycurl socat
52 52 

  		





  
  53
  
    
If you want to also enable the `htools` components, which is recommended


  		





  
  54
  
    
on bigger deployments (they give you automatic instance placement,


  		





  
  55
  
    
cluster balancing, etc.), then you need to have a Haskell compiler


  		





  
  56
  
    
installed. More specifically:


  		





  
  57
  
    

  		





  
  58
  
    
- `GHC <http://www.haskell.org/ghc/>`_ version 6.10 or higher


  		





  
  59
  
    
- or even better, `The Haskell Platform


  		





  
  60
  
    
  <http://hackage.haskell.org/platform/>`_ which gives you a simple way


  		





  
  61
  
    
  to bootstrap Haskell


  		





  
  62
  
    
- `json <http://hackage.haskell.org/package/json>`_, a JSON library


  		





  
  63
  
    
- `network <http://hackage.haskell.org/package/network>`_, a basic


  		





  
  64
  
    
  network library


  		





  
  65
  
    
- `parallel <http://hackage.haskell.org/package/parallel>`_, version 1.x


  		





  
  66
  
    
  or 2.x, a parallel programming library (note: version 3.x is not yet


  		





  
  67
  
    
  supported)


  		





  
  68
  
    
- `curl <http://hackage.haskell.org/package/curl>`_, bindings for the


  		





  
  69
  
    
  curl library, only needed if you want these tools to connect to remote


  		





  
  70
  
    
  clusters (as opposed to the local one)


  		





  
  71
  
    

  		





  
  72
  
    
All of these are also available as package in Debian/Ubuntu::


  		





  
  73
  
    

  		





  
  74
  
    
  $ apt-get install ghc6 libghc6-json-dev libghc6-network-dev \


  		





  
  75
  
    
                    libghc6-parallel-dev libghc6-curl-dev


  		





  
  76
  
    

  		





  53
  77
  
    
If you want to build from source, please see doc/devnotes.rst for more


  		





  54
  78
  
    
dependencies.


  		





  55
  79
  
    

  		












  

    
      b/doc/devnotes.rst
    
  






  4
  4
  
    
Build dependencies


  		





  5
  5
  
    
------------------


  		





  6
  6
  
    

  		





  7
  
  
    
Most dependencies from :doc:`install-quick`, plus:


  		





  
  7
  
    
Most dependencies from :doc:`install-quick`, plus (for Python):


  		





  8
  8
  
    

  		





  9
  9
  
    
- `GNU make <http://www.gnu.org/software/make/>`_


  		





  10
  10
  
    
- `GNU tar <http://www.gnu.org/software/tar/>`_


  		





  ......




  14
  14
  
    
  (tested with version 0.6.1)


  		





  15
  15
  
    
- `graphviz <http://www.graphviz.org/>`_


  		





  16
  16
  
    
- the `en_US.UTF-8` locale must be enabled on the system


  		





  
  17
  
    
- `pylint <http://www.logilab.org/857>`_ and its associated


  		





  
  18
  
    
  dependencies


  		





  
  19
  
    

  		





  
  20
  
    
Note that for pylint, at the current moment the following versions


  		





  
  21
  
    
need to be used::


  		





  
  22
  
    

  		





  
  23
  
    
    $ pylint --version


  		





  
  24
  
    
    pylint 0.21.1,


  		





  
  25
  
    
    astng 0.20.1, common 0.50.3


  		





  17
  26
  
    

  		





  18
  27
  
    
To generate unittest coverage reports (``make coverage``), `coverage


  		





  19
  28
  
    
<http://pypi.python.org/pypi/coverage>`_ needs to be installed.


  		





  20
  29
  
    

  		





  
  30
  
    
For Haskell development, again all things from the quick install


  		





  
  31
  
    
document, plus:


  		





  
  32
  
    

  		





  
  33
  
    
- `haddock <http://www.haskell.org/haddock/>`_, documentation


  		





  
  34
  
    
  generator (equivalent to epydoc for Python)


  		





  
  35
  
    
- `HsColour <http://hackage.haskell.org/package/hscolour>`_, again


  		





  
  36
  
    
  used for documentation (it's source-code pretty-printing)


  		





  
  37
  
    
- `hlint <http://community.haskell.org/~ndm/hlint/>`_, a source code


  		





  
  38
  
    
  linter (equivalent to pylint for Python)


  		





  
  39
  
    
- the `QuickCheck <http://hackage.haskell.org/package/QuickCheck>`_


  		





  
  40
  
    
  library, version 1.x


  		





  
  41
  
    
- ``hpc``, which comes with the compiler, so you should already have it


  		





  
  42
  
    

  		





  21
  43
  
    

  		





  22
  44
  
    
Configuring for development


  		





  23
  45
  
    
---------------------------


  		





  ......




  47
  69
  
    

  		





  48
  70
  
    
This script, in the source code as ``daemons/daemon-util.in``, is used


  		





  49
  71
  
    
to start/stop Ganeti and do a few other things related to system


  		





  50
  
  
    
daemons. Is is recommended to use ``daemon-util`` also from the system's


  		





  
  72
  
    
daemons. It is recommended to use ``daemon-util`` also from the system's


  		





  51
  73
  
    
init scripts. That way the code starting and stopping daemons is shared


  		





  52
  74
  
    
and future changes have to be made in only one place.


  		





  53
  75
  
    

  		












Also available in:
  Unified diff