Revision 138253bc docs/quick-install-admin-guide.rst

b/docs/quick-install-admin-guide.rst
588 588
Installation of Pithos+ on node2
589 589
================================
590 590

  
591
To install pithos+, grab the package from our repository (make sure  you made
591
To install pithos+, grab the packages from our repository (make sure  you made
592 592
the additions needed in your ``/etc/apt/sources.list`` file, as described
593 593
previously), by running:
594 594

  
......
599 599
After successful installation of snf-pithos-app, make sure that also
600 600
snf-webproject has been installed (marked as "Recommended" package). Refer to
601 601
the "Installation of Astakos on node1" section, if you don't remember why this
602
should happen. 
602
should happen. Now, install the pithos web interface:
603 603

  
604
.. code-block:: console
605

  
606
   # apt-get install snf-pithos-webclient
607

  
608
This package provides the standalone pithos web client. The web client is the
609
web UI for pithos+ and will be accessible by clicking "pithos+" on the Astakos
610
interface's cloudbar, at the top of the Astakos homepage.
604 611

  
605 612
Configuration of Pithos+
606 613
========================
......
612 619
``/etc/synnefo`` and some configuration files inside it, as you did in node1
613 620
after installation of astakos. Here, you will not have to change anything that
614 621
has to do with snf-common or snf-webproject. Everything is set at node1. You
615
only need to change settings that have to do with pithos. Specifically:
622
only need to change settings that have to do with pithos+. Specifically:
616 623

  
617 624
Edit ``/etc/synnefo/20-snf-pithos-app-settings.conf``. There you need to set
618 625
only the two options:
......
633 640
``/srv/pithos/data``, which is visible by both nodes. We have already setup this
634 641
directory at node1's "Pithos+ data directory setup" section.
635 642

  
643
Then we need to setup the web UI and connect it to astakos. To do so, edit
644
``/etc/synnefo/20-snf-pithos-webclient-settings.conf``:
645

  
646
.. code-block:: console
647

  
648
   PITHOS_UI_LOGIN_URL = "https://node1.example.com/im/login?next="
649
   PITHOS_UI_FEEDBACK_URL = "https://node1.example.com/im/feedback"
650

  
651
The ``PITHOS_UI_LOGIN_URL`` option tells the client where to redirect you, if
652
you are not logged in. The ``PITHOS_UI_FEEDBACK_URL`` option points at the
653
pithos+ feedback form. Astakos already provides a generic feedback form for all
654
services, so we use this one.
655

  
656
Then edit ``/etc/synnefo/20-snf-pithos-webclient-cloudbar.conf``, to connect the
657
pithos+ web UI with the astakos web UI (through the top cloudbar):
658

  
659
.. code-block:: console
660

  
661
   CLOUDBAR_LOCATION = 'https://node1.example.com/static/im/cloudbar/'
662
   CLOUDBAR_ACTIVE_SERVICE = 'pithos'
663
   CLOUDBAR_SERVICES_URL = 'https://node1.example.com/im/get_services'
664
   CLOUDBAR_MENU_URL = 'https://node1.example.com/im/get_menu'
665

  
666
The ``CLOUDBAR_LOCATION`` tells the client where to find the astakos common
667
cloudbar.
668

  
669
The ``CLOUDBAR_ACTIVE_SERVICE`` registers the client as a new service served by
670
astakos. It's name should be identical with the ``id`` name given at the
671
astakos' ``ASTAKOS_CLOUD_SERVICES`` variable. Note that at the Astakos "Conf
672
Files" section, we actually set the third item of the ``ASTAKOS_CLOUD_SERVICES``
673
list, to the dictionary:
674
``{ 'url':'https://nod...', 'name':'pithos+', 'id':'pithos }``. This item
675
represents the pithos+ service. The ``id`` we set there, is the ``id`` we want
676
here.
677

  
678
The ``CLOUDBAR_SERVICES_URL`` and ``CLOUDBAR_MENU_URL`` options are used by the
679
pithos+ web client to get from astakos all the information needed to fill its
680
own cloudbar.  So we put our astakos deployment urls there.
681

  
636 682
Servers Initialization
637 683
----------------------
638 684

  
......
643 689
   root@node2:~ # /etc/init.d/gunicorn restart
644 690
   root@node2:~ # /etc/init.d/apache2 restart
645 691

  
646

  
647 692
You have now finished the Pithos+ setup. Let's test it now.
648 693

  
649 694

  

Also available in: Unified diff