.. Read the Docs Template documentation master file, created by
   sphinx-quickstart on Tue Aug 26 14:19:49 2014.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

Инструкция по установке приложения Arta Synergy Showcase
========================================================

Общие сведения
--------------

Приложение Synergy Showcase для настройки внешнего вида и функциональности Витрины услуги использует инструмент 
**Конструктор приложений**. Конструктор приложений позволяет создавать веб-приложения в визуальном интерфейсе. 
Использование основных возможностей Конструктора не требует от разработчика Synergy навыков написания кода на 
JavaScript, Java и так далее. При этом в случае необходимости кастомизации приложения - использования 
дополнительного скриптинга или настройки стилей приложения - она не потребует больших усилий разработчика. 


Synergy Showcase устанавливается отдельным пакетом. Возможны следующие варианты установки.

1. ``Install/Upgrade Configuration`` - установка приложения и загрузка его конфигурации (без БД и хранилища).

    .. hint:: Данный вариант установки отличается от других тем, что загружается конфигурация через Synergy API, 
              не удаляя при этом информацию пользователя.

2. ``Clean`` - полная установка приложения без демо-данных («чистая» установка с загрузкой конфигурации и 
   преднастроенных БД, хранилища, конфигурации приложения).

Предварительная установка пакета Конструктора приложений не требуется - он будет установлен вместе с пакетом Synergy Showcase. 

Предварительные требования
--------------------------

Важно! Для работы данного приложения требуется:

* установить Arta Synergy 4.0 hamming (`инструкция по установке <http://tdd.lan.arta.kz/docs/synergy/tags/hamming/admin-manual/html/install-and-setup.html#install-and-setup.install>`_)
* в подсистеме администрирования обновить БД и процессы
* для варианта установки ``Install/Upgrade configuration``: завести Гостевого пользователя (с произвольными логином/паролем, 
  с доступом в систему, с ролью "Администратор")
* пользователю, ответственному за кастомизацию приложения, добавить роли ""Разработчик Synergy" и "Конструктор web-клиента"

Установка приложения
--------------------

В первую очередь необходимо подключить репозитории, в которых расположены пакеты Synergy Showcase и Конструктора приложений. 
Для этого в файле ``/etc/apt/sources.list`` необходимо добавить либо раскомментировать следующую строку:

    .. code-block:: html 

        deb [allow-insecure=yes] http://deb.arta.kz/tengri constructor-1.1 main contrib non-free
        deb [allow-insecure=yes] http://deb.arta.kz/tengri showcase-2.0 main contrib non-free

Для установки приложения необходимо выполнить команду:

    .. code-block:: html 

	# apt-get update
	# apt-get install arta-synergy-apps-showcase

В ходе установки необходимо выбрать тип установки из предложенного списка: 

    .. figure:: _static/showcase1.png

Дальнейшие шаги зависят от выбранного типа установки. 

Вариант установки Clean
~~~~~~~~~~~~~~~~~~~~~~~

Указать URL сервера Synergy, на котором производится работа (например: http://192.168.4.218:8080/Synergy)

    .. figure:: _static/showcase2.png

Ввести пароль от сервера mysql:

    .. figure:: _static/showcase2_1.png

После этого будет выполнена загрузка дампов БД, содержащих "чистую" конфигурацию Synergy Showcase. 

Вариант установки Install/Upgrade configuration
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Указать URL сервера Synergy, на котором производится работа (например: http://192.168.4.218:8080/Synergy)

    .. figure:: _static/showcase2.png

Последовательно указать логин и пароль Гостевого пользователя, который будет использоваться для просмотра данных портала: 

    .. figure:: _static/showcase3.png

    .. figure:: _static/showcase4.png

Последовательно указать логин и пароль пользователя, имеющего роль "Разработчик Synergy": 

    .. figure:: _static/showcase5.png

    .. figure:: _static/showcase6.png

После установки
---------------

После установки приложения обязательно выполнить пункты `инструкции по внедрению <http://rtd.lan.arta.kz/docs/showcase-introduction-guide/ru/v2.0/>`_.

