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