Revision c3945370 snf-app/docs/src/admin-guide.rst

b/snf-app/docs/src/admin-guide.rst
1 
.. _deployment:
1 
.. _snf-compute-admin-guide:
2 2 

  		





  3
  3
  
    
Administrator Guide


  		





  4
  4
  
    
===================


  		





  5
  5
  
    

  		





  6
  
  
    
This is the snf-compute administrator's guide.


  		





  
  6
  
    
This is the snf-compute administrator guide.


  		





  7
  7
  
    

  		





  8
  8
  
    
It contains instructions on how to download, install and configure


  		





  9
  
  
    
synnefo components. It also covers maintenance issues, e.g.,


  		





  10
  
  
    
upgrades of existing synnefo deployments.


  		





  
  9
  
    
the synnefo components necessary to deploy the Compute Service. It also covers


  		





  
  10
  
    
maintenance issues, e.g., upgrades of existing deployments.


  		





  11
  11
  
    

  		





  12
  12
  
    
The guide assumes you are familiar with all aspects of downloading, installing


  		





  13
  13
  
    
and configuring packages for the Linux distribution of your choice.


  		





  ......




  16
  16
  
    
--------


  		





  17
  17
  
    

  		





  18
  18
  
    
This guide covers the following:


  		





  19
  
  
    
synnefo architecture


  		





  20
  
  
    
    The node types needed for a complete synnefo deployment, and their roles.


  		





  21
  
  
    
    Throughout this guide, `node` refers to a physical machine in the


  		





  
  19
  
    
Compute architecture


  		





  
  20
  
    
    Node types needed for a complete deployment of snf-compute,


  		





  
  21
  
    
    and their roles. Throughout this guide, `node` refers to a physical machine


  		





  
  22
  
    
    in the deployment.


  		





  
  23
  
    
Installation


  		





  
  24
  
    
    The installation of services and synnefo software components for a working


  		





  
  25
  
    
    deployment of snf-compute, either from source packages or the provided


  		





  
  26
  
    
    packages for Debian Squeeze.


  		





  
  27
  
    
Configuration


  		





  
  28
  
    
    Configuration of the various software components comprising an snf-compute


  		





  22
  29
  
    
    deployment.


  		





  23
  
  
    
synnefo packages


  		





  24
  
  
    
installation


  		





  25
  
  
    
configuration


  		





  26
  
  
    
upgrades


  		





  27
  
  
    
changelogs


  		





  
  30
  
    
Upgrades


  		





  
  31
  
    
Changelogs


  		





  28
  32
  
    

  		





  29
  33
  
    
.. todo:: describe prerequisites -- e.g., Debian


  		





  30
  34
  
    
.. todo:: describe setup of nginx, flup, synnefo packages, etc.


  		





  31
  35
  
    

  		





  32
  
  
    
synnefo architecture


  		





  33
  
  
    
--------------------


  		





  
  36
  
    
Architecture


  		





  
  37
  
    
------------


  		





  34
  38
  
    

  		





  35
  39
  
    
Nodes in a synnefo deployment belong in one of the following types.


  		





  36
  40
  
    
For every type, we list the services that execute on corresponding nodes.


  		





  ......




  39
  43
  
    

  		





  40
  44
  
    
DB


  		





  41
  45
  
    
**


  		





  
  46
  
    

  		





  42
  47
  
    
A node [or more than one nodes, if using an HA configuration], running a DB


  		





  43
  48
  
    
engine supported by the Django ORM layer. The DB is the single source of


  		





  44
  
  
    
truth for the servicing of API requests by synnefo.


  		





  
  49
  
    
truth for the servicing of API requests by snf-compute.


  		





  45
  50
  
    

  		





  46
  51
  
    
_Services:_ PostgreSQL / MySQL


  		





  47
  52
  
    

  		





  ......




  102
  107
  
    

  		





  103
  108
  
    
WEBAPP


  		





  104
  109
  
    
******


  		





  105
  
  
    
A WEBAPP node runs the :ref:`snf-app <snf-app>` web application bundled within


  		





  106
  
  
    
the synnefo package.


  		





  107
  
  
    

  		





  
  110
  
    
A WEBAPP node runs the web application provided by the synnefo component


  		





  
  111
  
    
:ref:`snf-app <snf-app>`.


  		





  108
  112
  
    

  		





  109
  113
  
    
Installation


  		





  110
  114
  
    
------------


  		












Also available in:
  Unified diff