root / docs / quick-install-admin-guide.rst @ 70f13b0f
History | View | Annotate | Download (2.4 kB)
| 1 |
.. _quick-install-admin-guide: |
|---|---|
| 2 |
|
| 3 |
Administrator's Quick Installation Guide |
| 4 |
======================================== |
| 5 |
|
| 6 |
This the Administrator's quick installation guide. |
| 7 |
|
| 8 |
It describes how to install Synnefo on a single physical node, |
| 9 |
with minimum configuration. It installs Synnefo from Debian packages, and |
| 10 |
assumes the node runs Debian Squeeze. |
| 11 |
|
| 12 |
Prerequisites |
| 13 |
------------- |
| 14 |
|
| 15 |
Please make sure you already have the following: |
| 16 |
* A working installation of Ganeti on this node |
| 17 |
* A working installation of snf-image, with installed images. See |
| 18 |
https://code.grnet.gr/projects/snf-image/wiki for detailed info. |
| 19 |
* A DB server running PostgreSQL |
| 20 |
* A working deployment of RabbitMQ |
| 21 |
|
| 22 |
|
| 23 |
Installation |
| 24 |
------------ |
| 25 |
|
| 26 |
Install the following components from Debian packages. |
| 27 |
Grab them from http://docs.dev.grnet.gr/debs/. |
| 28 |
|
| 29 |
.. todo:: |
| 30 |
|
| 31 |
Setup a source file for APT. |
| 32 |
The commands below install the needed dependencies manually, |
| 33 |
APT would take care of that. |
| 34 |
|
| 35 |
.. todo:: |
| 36 |
|
| 37 |
Document networking installation and configuration using |
| 38 |
``grnet-vnode-tools``, ``nfdhcpd`` |
| 39 |
|
| 40 |
.. code-block:: console |
| 41 |
|
| 42 |
# apt-get install python python-setuptools |
| 43 |
# dpkg -i snf-common_0.7.4-1_all.deb |
| 44 |
# apt-get install python-django python-django-south |
| 45 |
# dpkg -i snf-webproject_0.7.4-1_all.deb |
| 46 |
# dpkg -i snf-pithos-lib_0.8.2-1_all.deb |
| 47 |
# dpkg -i snf-pithos-tools_0.8.2-1_all.deb |
| 48 |
# apt-get install python-sqlalchemy |
| 49 |
# dpkg -i snf-pithos-backend_0.8.2-1_all.deb |
| 50 |
# apt-get install python-daemon python-gevent |
| 51 |
# dpkg -i snf-vncauthproxy_1.1-1_all.deb |
| 52 |
# apt-get install python-simplejson python-pycurl python-dateutil |
| 53 |
# python-ipy python-crypto python-amqplib |
| 54 |
# dpkg -i snf-cyclades-app_0.7.4-1_all.deb |
| 55 |
# apt-get install python-pyinotify python-prctl nfdhcpd arptables |
| 56 |
# dpkg -i snf-cyclades-gtools_7.4-1_all.deb |
| 57 |
# dpkg -i snf-okeanos-site_7.4-1_all.deb |
| 58 |
|
| 59 |
|
| 60 |
Configuration |
| 61 |
-------------- |
| 62 |
|
| 63 |
Edit files under :file:`/etc/synnefo`, based on the location |
| 64 |
of your Ganeti master, Postgres DB and RabbitMQ deployment. |
| 65 |
At the very least you need to set sensible values for |
| 66 |
|
| 67 |
* ``BYPASS_AUTHENTICATION`` (set to True, for a test install) |
| 68 |
* ``GANETI_LINK_PREFIX`` |
| 69 |
* ``GANETI_MASTER_IP`` |
| 70 |
* ``GANETI_CLUSTER_INFO`` |
| 71 |
* ``RABBIT_HOST`` |
| 72 |
* ``RABBIT_USERNAME`` |
| 73 |
* ``RABBIT_PASSWORD`` |
| 74 |
* ``BYPASS_AUTHENTICATION_SECRET_TOKEN`` |
| 75 |
* ``BACKEND_DB_MODULE`` |
| 76 |
* ``BACKEND_DB_CONNECTION`` |
| 77 |
* ``BACKEND_BLOCK_MODULE`` |
| 78 |
* ``BACKEND_BLOCK_PATH`` |
| 79 |
|
| 80 |
.. todo:: |
| 81 |
|
| 82 |
Document quick installation of Pithos, upload of Images. |