.. 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 Knowledge
========================================================================

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

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

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

    .. hint:: Вариант установки ``Clean`` удаляет все текущие данные в системе!

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

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

3. ``Manual`` - установка только приложения без автоматической загрузки конфигурации, дашбордов и всего остального.

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

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

* установить 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>`_)
* установить и запустить Elasticsearch и Kibana (`инструкция по установке <http://tdd.lan.arta.kz/docs/synergy/tags/hamming/admin-manual/html/appendix.dashboards.html>`_)
* в подсистеме администрирования обновить базу данных и процессы
* для варианта установки ``Install/Upgrade Configuration`` предварительно завести Системного пользователя (с произвольными логином/паролем, с доступом в систему, с ролью "Разработчик Synergy" и "Администратор", а также назначенного на произвольную должность)

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

Установочный пакет находится в репозитории *knowledge-1.0*. В файле ``/etc/apt/sources.list`` необходимо добавить либо раскомментировать следующую строку:

``deb http://deb.arta.kz/tengri knowledge-1.0 main contrib non-free``

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

    .. code-block:: html 

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

Особенности установки Clean
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

В ходе установки необходимо выполнить следующее:

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

    .. figure:: resources/img/knowledge_step1_clean.png

        Рис. Тип установки

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

    .. figure:: resources/img/knowledge_step2.png

        Рис. Ввод synergy URL

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

    .. figure:: resources/img/knowledge_step4.png

        Рис. Ввод пароля mysql

    .. attention:: В случае, если после установки приложения вариантом ``Clean`` имеются проблемы с авторизацией пользователей (ошибка ``loginservlet``), то выполните в терминале команду ``dpkg-reconfigure arta-synergy-synergy`` и следуйте `мастеру установки <http://tdd.lan.arta.kz/docs/synergy/tags/hamming/admin-manual/html/install-and-setup.html#install-and-setup.install>`_.

Особенности установки Install/Upgrade Configuration и Manual
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

В ходе установки необходимо выполнить следующее:

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

    .. figure:: resources/img/knowledge_step1_install.png

        Рис. Тип установки

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

    .. figure:: resources/img/knowledge_step2.png

        Рис. Ввод synergy URL

* Ввести последовательно логин и пароль Системного пользователя

    .. figure:: resources/img/knowledge_step3_install_login.png

        Рис. Ввод логина

    .. figure:: resources/img/knowledge_step3_install_password.png

        Рис. Ввод пароля

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

    .. figure:: resources/img/knowledge_step4.png

        Рис. Ввод пароля mysql

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

Во-первых, необходимо вручную запустить сервисы Elasticsearch и Kibana:

    .. code-block:: html 

	# service elasticsearch start
	# service kibana start

Во-вторых, обязательно выполните пункты `инструкции по внедрению <http://rtd.lan.arta.kz/docs/khowledge-introduction-guide>`_.
