.. 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 4.0 (hamming) и выше (инструкция по установке)
* установить Elasticsearch и Kibana (инструкция по установке)
* в подсистеме администрирования обновить БД и процессы, завести Системного пользователя (код пользователя - ``itsm_service_user``) с ролями “Администратор” и “Методолог” (“Разработчик Synergy”)
* в разделе конфигуратора “Формы завершения” создать новую форму завершения: тип - “Без результата”, код - ``no_result``, название - “Без подтверждения”, галочка “Требовать подтверждения результата” выключена

Система Synergy ITSM устанавливается отдельным пакетом. Возможные варианты установки:

* Install/Upgrade Configuration - установка приложения и загрузка его конфигурации (соответственно, без БД, хранилища, индексов и дашбордов)
* Manual - установка только приложения без автоматической загрузки конфигурации, дашбордов и всего остального

Подключение репозиториев
----------------------------------------------------------------------

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

::

    deb http://deb.arta.kz/tengri unstable main contrib non-free*

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

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

:: 

     # apt-get update*
     # apt-get install arta-synergy-apps-itsm*

В ходе установки необходимо выполнить следующее:
   
* Выбрать тип установки из предложенного списка
* Указать URL до Synergy, на котором производится работа (*например: http://192.168.1.172:8080/Synergy*)
* Ввести последовательно логин и пароль Системного пользователя

.. note::

Для предотвращения дальнейшей нечаянной установки нестабильных версий пакетов из репозитория *unstable*, 
после установки *arta-synergy-apps-itsm* рекомендуется его закомментировать в том же файле */etc/apt/sources.list*.

Для работоспособности личного кабинета необходимо
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

1. В файле */etc/nginx/sites-enabled/synergy-base* добавить следующее:

:: 

    location /itsm {

    allow			all;

    proxy_pass		http://127.0.0.1:8080/itsm;

    proxy_set_header	Host       $host;

    proxy_set_header	X-Real-IP  $remote_addr;
    
    }


2. Проверить наличие очередей и их слушателей для ITSM в двух файлах:


**/opt/synergy/jboss/standalone/configuration/standalone-onesynergy.xml**

:: 

    <jms-queue name="ItsmFormChangeQueue">
        <entry name="java:jboss/queues/Integration/ItsmFormChangeQueue"/>
        
        <durable>true</durable>
    </jms-queue>
    
    <jms-queue name="ItsmBlockingQueue">
        <entry name="java:jboss/queues/Integration/ItsmBlockingQueue"/>
        
        <durable>true</durable>
    </jms-queue>
    
    <jms-queue name="ItsmCallback_1">
        <entry name="java:jboss/queues/Integration/ItsmCallback_1"/>
        
        <durable>true</durable>
    </jms-queue>

**/opt/synergy/jboss/standalone/configuration/arta/api-observation-configuration.xml**

:: 

    <listener>
        <queue>java:jboss/queues/Integration/ItsmBlockingQueue</queue>
        
        <event>event.blocking.itsm.*</event>
    </listener>
    
    <listener>
        <queue>java:jboss/queues/Integration/ItsmBlockingQueue</queue>
        
        <event>event.blocking.incident.*</event>
    </listener>
    
    <listener>
        <queue>java:jboss/queues/Integration/ItsmBlockingQueue</queue>
        
        <event>event.blocking.problem.*</event>
    </listener>

3. Кроме того, удостоверьтесь, что конфигурационный файл */opt/synergy/jboss/standalone/configuration/itsm.properties* содержит следующие строки (только с Вашими данными):

:: 

    login=1

    password=1

    address=http://127.0.0.1:8080/Synergy

    public_address=http://192.168.1.172:8080/Synergy


В случае установки в режиме Manual
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

1.Импортировать приложение /opt/synergy/apps/itsm/itsm_application.7zip
