Update_manual.rst 8.11 KB
Newer Older
1
Инструкция по обновлению с itsm-1.12 до itsm-1.13
2
===================================================
3

4
Обновлять пакет ITSM желательнго с версии itsm-1.12(minsky) до версии itsm-1.13(minsky), так как обновление с данной версии протестировано и проверено. Для обновления необходимо:
5

6
**Шаг1** При необходимости обновить Arta Synergy до версии ``trunk.4.1-r1~201009.164055 (minsky)`` , а также проверить установлены ли  Elasticsearch и Kibana
7 8

**Шаг2** Проверить наличие Системного пользователя: 
9

10
    * код пользователя - ``itsm_service_user``
11
    * роли  ``Администратор`` , ``Разработчик Synergy``,``Конструктор web-клиента``
12 13
    * доступ в систему - разрешен
    * задать логин/пароль
14

15
*Примечание:* По умолчанию эти пункты уже реализованы, так как у вас был настроен пакет itsm-1.12.    
16

17
**Шаг3** Подключение репозиториев
18 19 20 21 22 23 24 25 26 27 28

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

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

::

29
   deb [allow-insecure=yes] http://deb.arta.kz/tengri          itsm-1.13       main contrib non-free
30
   deb [allow-insecure=yes] http://deb.arta.kz/tengri constructor-2.1 main contrib non-free
31 32 33 34 35 36

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

::
    
    apt-get update
37
    
38
**Шаг4** Установка приложения
39 40 41 42 43 44 45 46 47 48


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

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

2. В ходе установки необходимо выполнить следующее:
   
49
* Выбрать тип установки из предложенного списка
50

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

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

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


59

60 61 62 63 64
**Шаг5**  В случае установки в режиме Manual:  

1. Импортировать приложение /opt/synergy/apps/itsm/itsm_application.7zip    
2. Установить Constructor версией 2.1~r1~200421.174404 и выше.    
3. Импортировать приложение в конструктор и задеплоить его /opt/synergy/apps/itsm/itsm_arm.json    
65 66 67 68 69 70 71 72 73 74 75


.. warning::

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

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

76
1. В файле ``/etc/nginx/sites-enabled/synergy-base`` проверить наличие следующих строк:
77 78 79 80 81 82 83 84 85 86 87 88 89 90

:: 

    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;
    
    }
91

92 93
::  

94 95 96 97 98 99
    location /itsm-arm {
        allow                   all;
        proxy_pass              http://127.0.0.1:8080/itsm-arm;
        proxy_set_header        Host       $host;
        proxy_set_header        X-Real-IP  $remote_addr;
    }
100 101 102 103 104 105 106 107

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


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

:: 

108 109 110
    <jms-queue name="ItsmFormChangeQueue" entries="queue/ItsmFormChangeQueue java:jboss/queues/Integration/ItsmFormChangeQueue" durable="true"/>
    <jms-queue name="ItsmBlockingQueue" entries="queue/ItsmBlockingQueue java:jboss/queues/Integration/ItsmBlockingQueue" durable="true"/>
    <jms-queue name="ItsmCallback_1" entries="queue/ItsmCallback_1 java:jboss/queues/Integration/ItsmCallback_1" durable="true"/>
111
    <jms-queue name="DocflowDocument" entries="queue/DocflowDocument java:jboss/queues/Synergy/DocflowDocument" durable="true"/>
112

113
                
114 115 116 117 118 119


а также наличие подключения к базе для интеграции с почтой в этом же файле

::

120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146
    <xa-datasource jndi-name="java:/SynergyItsm" pool-name="synergy_itsm_ds" enabled="true" use-ccm="false">
        <xa-datasource-property name="URL">
                 jdbc:mysql://127.0.0.1:3306/synergy?useUnicode=true&amp;characterEncoding=utf8
        </xa-datasource-property>
        <driver>com.mysql</driver>
        <xa-pool>
            <min-pool-size>20</min-pool-size>
            <max-pool-size>100</max-pool-size>
            <is-same-rm-override>false</is-same-rm-override>
            <interleaving>false</interleaving>
            <pad-xid>false</pad-xid>
            <wrap-xa-resource>false</wrap-xa-resource>
        </xa-pool>
        <security>
            <user-name>root</user-name>
            <password>root</password>
            </security>
        <validation>
            <valid-connection-checker class-name="org.jboss.jca.adapters.jdbc.extensions.mysql.MySQLValidConnectionChecker"/>
            <check-valid-connection-sql>select 1</check-valid-connection-sql>
            <validate-on-match>false</validate-on-match>
            <background-validation>true</background-validation>
            <exception-sorter class-name="org.jboss.jca.adapters.jdbc.extensions.mysql.MySQLExceptionSorter"/>
        </validation>
        <statement>
            <share-prepared-statements>false</share-prepared-statements>
        </statement>
147 148 149 150 151 152
    </xa-datasource>

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

:: 

153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169
   <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>
  <listener>
    <queue>java:jboss/queues/Synergy/DocflowDocument</queue>
    <event>event.docflow.document.*</event>
  </listener>

170 171 172 173 174 175 176 177 178 179 180 181 182 183 184

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



185
4. Проверить осуществлен ли деплой приложения itsm.war. Если нет, то задеплоить его.
186

187
5. Пройти по всем пунктам раздела `Первичные настройки`_ и проверить, что все настройки выполнены. Если какие-либо не выполнены, сделать данные настройки.
188

189

190
.. _Первичные настройки: http://rtd.lan.arta.kz/docs/synergy-itsm-custom-manual/ru/itsm-1.13/First_configuration.html 
191

192