Revision 0d87ef78 docs/quick-install-admin-guide.rst

b/docs/quick-install-admin-guide.rst
567 567
    ASTAKOS_BASE_URL = 'https://node1.example.com/astakos'
568 568

  
569 569
The ``ASTAKOS_COOKIE_DOMAIN`` should be the base url of our domain (for all
570
services). ``ASTAKOS_BASE_URL`` is the astakos top-level URL.
570
services). ``ASTAKOS_BASE_URL`` is the astakos top-level URL. Appending an
571
extra path (``/astakos`` here) is recommended in order to distinguish
572
components, if more than one are installed on the same machine.
571 573

  
572 574
``ASTAKOS_DEFAULT_ADMIN_EMAIL`` refers to the administrator's email.
573 575
Every time a new account is created a notification is sent to this email.
......
700 702
command will ask you to register the standard Synnefo components (astakos,
701 703
cyclades, and pithos) along with the services they provide. Note that you
702 704
have to register at least astakos in order to have a usable authentication
703
system. For each component, you will be asked to provide its base
704
installation URL as well as the UI URL (to appear in the Cloudbar).
705
Moreover, the command will automatically register the resource definitions
705
system. For each component, you will be asked to provide two URLs: its base
706
URL and its UI URL.
707

  
708
The former is the location where the component resides; it should equal
709
the ``<component_name>_BASE_URL`` as specified in the respective component
710
settings. For example, the base URL for astakos would be
711
``https://node1.example.com/astakos``.
712

  
713
The latter is the URL that appears in the Cloudbar and leads to the
714
component UI. If you want to follow the default setup, set
715
the UI URL to ``<base_url>/ui/`` where ``base_url`` the component's base
716
URL as explained before. (You can later change the UI URL with
717
``snf-manage component-modify <component_name> --url new_ui_url``.)
718

  
719
The command will also register automatically the resource definitions
706 720
offered by the services.
707 721

  
708 722
.. code-block:: console
......
1679 1693
they should all have identical ``ASTAKOS_BASE_URL`` setting
1680 1694
(see also, :ref:`previously <conf-pithos>`).
1681 1695

  
1696
The ``CYCLADES_BASE_URL`` setting must point to the top-level Cyclades URL.
1697
Appending an extra path (``/cyclades`` here) is recommended in order to
1698
distinguish components, if more than one are installed on the same machine.
1699

  
1682 1700
The ``CYCLADES_SERVICE_TOKEN`` is the token used for authentication with astakos.
1683 1701
It can be retrieved by running on the Astakos node (node1 in our case):
1684 1702

  

Also available in: Unified diff