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

Важно! Для работы данного приложения требуется:
    * установить Arta Synergy 3.15 wilkes и выше (инструкция по установке)
    * установить Elasticsearch и Kibana (инструкция по установке)
    * в подсистеме администрирования обновить БД и процессы, завести Системного пользователя (код пользователя - itsm_service_user) с ролями “Администратор” и “Методолог” (“Разработчик Synergy”)
    * в разделе конфигуратора “Специальные справочники” в wilkes / “Формы завершения” в hamming создать новую форму завершения: тип - “Без результата”, код - “no_result”, название - “Без подтверждения”, галочка “Требовать подтверждения результата” выключена

Arta Synergy SM устанавливается отдельным пакетом. Возможные варианты установки:
    * Clean - полная установка приложения без демо-данных (“чистая” установка с загрузкой конфигурации и преднастроенных БД, хранилища, индексов Elasticsearch и Kibana, дашбордов)
    * 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)
    * Ввести последовательно логин и пароль Системного пользователя

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

Для работоспособности личного кабинета в файле */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;

}


1. Проверить наличие очередей и их слушателей для 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>

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

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

В случае, если событие event.blocking.* уже используется на стенде, необходимо разбить вышеуказанную itsm’ную очередь на следующие 3:

<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>
Кроме того, удостоверьтесь, что конфигурационный файл /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
