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

Инструкция по установке
==========================




**Шаг1** При необходимости, установить Arta Synergy (trunk.4.0-r1~190301.195857 (hamming)) и выше `Инструкция по установке ARTA SYNERGY`_.

.. _Инструкция по установке ARTA SYNERGY: http://tdd.lan.arta.kz/docs/synergy/trunk/admin-manual/html/install-and-setup.html 

**Шаг2** Для использования Дашбордов установить Elasticsearch и Kibana  `Инструкция по установке`_.

.. _Инструкция по установке : http://tdd.lan.arta.kz/docs/synergy/trunk/admin-manual/html/appendix.dashboards.html 

**Шаг3** в подсистеме администрирования обновить БД и процессы, завести Системного пользователя 

    * код пользователя - ``itsm_service_user``
    * роли  ``Администратор`` , ``Разработчик Synergy``
    * доступ в систему - разрешен
    * задать логин/пароль
    
**Шаг4** Подключение репозиториев

1. Открыть файл на редактирование

::
    
    nano /etc/apt/sources.list`` 
    
2. Добавить либо раскомментировать строку репозитория.

::
    
    deb [allow-insecure=yes] http://deb.arta.kz/tengri          itsm-1.0         main contrib non-free

3. Обновить списки пакетов:

::
    
    apt-get update
    

**Шаг5** Установка приложения


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

::
    
    apt-get install arta-synergy-apps-itsm

2. В ходе установки необходимо выполнить следующее:
   
* Выбрать тип установки из предложенного списка
    * Install/Upgrade Configuration - установка приложения и загрузка его конфигурации (без БД, хранилища, индексов и дашбордов)
    * Manual - установка только приложения без автоматической загрузки конфигурации, дашбордов и всего остального
    
* Указать 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

.. Tip::

    Проверь себя, выполни  `Задание_2`_

    .. _`Задание_2`: http://rtd.lan.arta.kz/docs/itsm-custom-maual/ru/latest/Task_2.html



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

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


.. warning::

    Для работоспособности приложения в дальнейшем, необходимо убедиться, что elastic запущен. В противном случае может быть проблема с невозможностью создать запись реестра.
    Для предотвращения необходимо выполнить команду:
    /etc/init.d/elasticsearch start