Revision 2c85833e docs/quick-install-admin-guide.rst

b/docs/quick-install-admin-guide.rst
248 248

  
249 249
       # /etc/init.d/apache2 stop
250 250

  
251
.. _rabbitmq-setup:
252

  
251 253
Message Queue setup
252 254
~~~~~~~~~~~~~~~~~~~
253 255

  
......
1014 1016

  
1015 1017
.. warning::
1016 1018
    You can bypass the networking sections and go straight to
1017
    :ref:`RAPI user <rapi-user>`, if you do not want to setup the Cyclades
1018
    Network Service, but only the Cyclades Compute Service (recommended for
1019
    now).
1019
    :ref:`Cyclades Ganeti tools <cyclades-gtools>`, if you do not want to setup
1020
    the Cyclades Network Service, but only the Cyclades Compute Service
1021
    (recommended for now).
1020 1022

  
1021 1023
Network setup overview
1022 1024
----------------------
......
1330 1332
If everything works as expected, then you have finished the Network Setup at the
1331 1333
backend for both types of Networks (Public & Private).
1332 1334

  
1335
.. _cyclades-gtools:
1336

  
1337
Cyclades Ganeti tools
1338
---------------------
1339

  
1340
In order for Ganeti to be connected with Cyclades later on, we need the
1341
`Cyclades Ganeti tools` available on all Ganeti nodes (node1 & node2 in our
1342
case). You can install them by running in both nodes:
1343

  
1344
.. code-block:: console
1345

  
1346
   # apt-get install snf-cyclades-gtools
1347

  
1348
This will install the following:
1349

  
1350
 * ``snf-ganeti-eventd`` (daemon to publish Ganeti related messages on RabbitMQ)
1351
 * ``snf-ganeti-hook`` (all necessary hooks under ``/etc/ganeti/hooks``)
1352
 * ``snf-progress-monitor`` (used by ``snf-image`` to publish progress messages)
1353
 * ``kvm-vif-bridge`` (installed under ``/etc/ganeti`` to connect Ganeti with
1354
   NFDHCPD)
1355

  
1356
Configure ``snf-cyclades-gtools``
1357
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1358

  
1359
The package will install the ``/etc/synnefo/20-snf-cyclades-gtools.conf``
1360
configuration file. At least we need to set the RabbitMQ endpoint for all tools
1361
that need it:
1362

  
1363
.. code-block:: console
1364

  
1365
   RABBIT_HOST = "node1.example.com:5672"
1366
   RABBIT_USERNAME = "synnefo"
1367
   RABBIT_PASSWORD = "example_rabbitmq_passw0rd"
1368

  
1369
The above variables should reflect your :ref:`Message Queue setup
1370
<rabbitmq-setup>`. This file should be editted in all Ganeti nodes.
1371

  
1372
Connect ``snf-image`` with ``snf-progress-monitor``
1373
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1374

  
1375
Finally, we need to configure ``snf-image`` to publish progress messages during
1376
the deployment of each Image. To do this, we edit ``/etc/default/snf-image`` and
1377
set the corresponding variable to ``snf-progress-monitor``:
1378

  
1379
.. code-block:: console
1380

  
1381
   PROGRESS_MONITOR="snf-progress-monitor"
1382

  
1383
This file should be editted in all Ganeti nodes.
1384

  
1333 1385
.. _rapi-user:
1334 1386

  
1335 1387
Synnefo RAPI user
......
1337 1389

  
1338 1390
As a last step before installing Cyclades, create a new RAPI user that will
1339 1391
have ``write`` access. Cyclades will use this user to issue commands to Ganeti,
1340
so we will call the user ``cyclades``. You can do this, by editting the file
1341
``/var/lib/ganeti/rapi/users`` and adding the line:
1392
so we will call the user ``cyclades`` with password ``example_rapi_passw0rd``.
1393
You can do this, by first running:
1394

  
1395
.. code-block:: console
1396

  
1397
   # echo -n 'cyclades:Ganeti Remote API:example_rapi_passw0rd' | openssl md5
1398

  
1399
and then putting the output in ``/var/lib/ganeti/rapi/users`` as follows:
1342 1400

  
1343 1401
.. code-block:: console
1344 1402

  
1345
   cyclades {HA1}a62c-example_hash_here-6f0436ddb write
1403
   cyclades {HA1}55aec7050aa4e4b111ca43cb505a61a0 write
1346 1404

  
1347 1405
More about Ganeti's RAPI users `here.
1348 1406
<http://docs.ganeti.org/ganeti/2.5/html/rapi.html#introduction>`_

Also available in: Unified diff