.. 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. Инструкция по установке приложения Synergy Experience ========================================================== Общие сведения ------------------- Synergy Experience устанавливается отдельным пакетом. Возможны следующие варианты установки. #. ``Install/Upgrade Configuration`` - установка приложения, загрузка его конфигурации, индексов и дашбордов (соответственно, без БД и хранилища). .. hint:: Данный вариант установки отличается от других тем, что загружается конфигурация через Synergy API, не удаляя при этом информацию пользователя. #. ``Manual`` - установка только приложения без автоматической загрузки конфигурации, дашбордов и всего остального. Предварительные требования ------------------------------- Важно! Для работы данного приложения требуется: * установить Arta Synergy 4.0 hamming (`инструкция Synergy`_); * установить и запустить Elasticsearch и Kibana (`инструкция Kibana`_); * в подсистеме администрирования обновить базу данных и процессы; * для варианта установки ``Install/Upgrade Configuration`` предварительно: * завести Системного пользователя (с произвольными логином/паролем, с доступом в систему, с ролью "Разработчик Synergy" и "Администратор", а также назначенного на произвольную должность); .. _`инструкция Synergy`: http://tdd.lan.arta.kz/docs/synergy/tags/hamming/admin-manual/html/install-and-setup.html#install-and-setup.install .. _`инструкция Kibana`: http://tdd.lan.arta.kz/docs/synergy/tags/hamming/admin-manual/html/appendix.dashboards.html Установка приложения ------------------------ Установочный пакет находится в репозитории *experience-1.1*. В файле ``/etc/apt/sources.list`` необходимо добавить либо раскомментировать следующую строку: ``deb http://deb.arta.kz/tengri experience-1.1 main contrib non-free`` Для установки приложения необходимо выполнить команду: .. code-block:: html # apt-get update # apt-get install arta-synergy-apps-experience Особенности установки Install/Upgrade Configuration и Manual ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ В ходе установки необходимо выполнить следующее: * Выбрать тип установки из предложенного списка .. figure:: resources/img/experience_step1_install.png Рис. Тип установки * Указать URL до Synergy, на котором производится работа (например: http://192.168.3.143:8080/Synergy) .. figure:: resources/img/experience_step2.png Рис. Ввод synergy URL * Ввести последовательно логин и пароль Системного пользователя .. figure:: resources/img/experience_step3_install_login.png Рис. Ввод логина .. figure:: resources/img/experience_step3_install_password.png Рис. Ввод пароля * Ввести пароль mysql .. figure:: resources/img/experience_step4.png Рис. Ввод пароля mysql После установки -------------------------- Во-первых, необходимо вручную запустить сервисы Elasticsearch и Kibana: .. code-block:: html # service elasticsearch start # service kibana start Если фактическое поведение отличается от ожидаемого, то необходимо: * в подсистеме администрирования проверить актуальность базы данных и процессов и, при необходимости, их обновить; * проверить конфигурационный файл ``/etc/nginx/sites-enabled/synergy-base`` на наличие следующих настроек: .. code-block:: xml location /constructor { allow all; proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } location /feedback_form { allow all; proxy_pass http://127.0.0.1:8080/feedback_form; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; access_log /var/log/nginx/constructor.access.log; } location /kibana { proxy_pass http://localhost:5601; rewrite /kibana/(.*)$ /$1 break; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection 'upgrade'; proxy_cache_bypass $http_upgrade; } * открыть Конструктор приложений по адресу ``http://адрес_сервера:порт/constructor`` (например: http://192.168.4.80:8080/constructor), авторизоваться под Системным пользователем; * открыть приложение с кодом ``feedback_form`` и задеплоить его через меню "Клиент" -> "Деплой". * в свойствах приложения прописать Пользователя по умолчанию и пароль (аналогично данным системного пользователя Synergy). Во-вторых, обязательно выполните пункты `инструкции по внедрению`_. .. _`инструкции по внедрению`: http://rtd.lan.arta.kz/docs/experience-introduction-guide/ru/v1.0/