update by customers 2.0 release 2

install_guide/index.rst

@@ -6,22 +6,16 @@
 Инструкция по установке приложения Synergy Customers
 ==========================================================
 
-Общие сведения
----------------------
-
-Synergy Customers устанавливается отдельным пакетом. Единственный 
-возможный вариант установки - установка приложения, загрузка конфигураций 
-(Synergy и конструктора), без БД и хранилища. Соответственно, имеющиеся в 
-Системе данные не удаляются.
-
 Предварительные требования
 ------------------------------
 
 Важно! Для работы данного приложения требуется:
 
-* установить Arta Synergy 4.0 hamming актуальной версии 
+* обновить / установить платформу Arta Synergy 4.0 hamming до актуальной версии 
   (`инструкция по установке <http://tdd.lan.arta.kz/docs/synergy/tags/hamming/admin-manual/html/install-and-setup.html#install-and-setup.install>`_) 
-* установить Конструктор приложений 2.0 актуальной версии 
+  либо 4.1 minsky актуальной версии 
+  (`инструкция по установке <http://tdd.lan.arta.kz/docs/synergy/tags/minsky/admin-manual/html/install-and-setup.html#install-and-setup.install>`_) 
+* обновить / установить Конструктор приложений 2.0 до актуальной версии 
   (`инструкция по установке <https://docs.google.com/document/d/13XuzlP46CQ7KpnCe5_RCAk6SaO9XoiMhn9pYj1PEgvU/edit?usp=sharing>`_)
 * в подсистеме администрирования обновить базу данных и процессы
 * предварительно завести Системного пользователя (с произвольными 
@@ -29,8 +23,17 @@ Synergy Customers устанавливается отдельным пакето
   "Разработчик web-клиента" и "Администратор", а также назначенного 
   на произвольную должность)
 
-Установка приложения
---------------------------
+Обновление / установка приложения
+-------------------------------------
+
+Synergy Customers устанавливается отдельным пакетом. Возможны следующие 
+варианты установки:
+
+1. `Install/Upgrade Configuration` - установка приложений Customers и 
+  импорта, загрузка конфигураций (Synergy и конструктора), без БД и 
+  хранилища. Соответственно, имеющиеся в Системе данные не удаляются.
+
+2. `Manual` - установка только приложения для импорта. 
 
 Установочный пакет находится в репозитории *customers-2.0*. В файле 
 ``/etc/apt/sources.list`` необходимо добавить либо раскомментировать 
@@ -45,11 +48,15 @@ Synergy Customers устанавливается отдельным пакето
 	# apt-get update
 	# apt-get install arta-synergy-apps-customers
 
-Особенности установки
-~~~~~~~~~~~~~~~~~~~~~~~~
-
 В ходе установки необходимо выполнить следующее:
 
+* Выбрать тип установки `Install/Upgare Configuration` из предложенного 
+  списка
+
+    .. figure:: resources/img/customers_install.png
+
+        Рис. Тип установки
+
 * Указать URL до Synergy, на котором производится работа (например: 
   http://192.168.4.80:8080/Synergy)
 
@@ -67,15 +74,36 @@ Synergy Customers устанавливается отдельным пакето
 
         Рис. Ввод пароля
 
+В случае, если платформа Arta Synergy была обновлена с версии 4.0 
+hamming до 4.1 minsky, требуется переустановка приложения для импорта. 
+Для этого необходимо переустановить пакет Customers командой:
+
+    .. code-block:: html 
+
+	# aptitude reinstall arta-synergy-apps-customers
+
+В ходе обновления необходимо выбрать тип установки `Manual` из 
+предложенного списка
+
+    .. figure:: resources/img/customers_manual.png
+
+        Рис. Тип установки
 
 После установки
 -------------------
 
-Во-первых, необходимо добавить Системного пользователя в группу 
-"Все права" (с кодом ``customers_groups_access_all``).
+Во-первых, в подсистеме конфигурирования необходимо добавить Системного 
+пользователя в группу "Все права" (с кодом ``customers_groups_access_all``).
 
-Во-вторых, необходимо проверить доступность приложения по адресу 
-``http://адрес_сервера:порт/customers`` (например: 
+Во-вторых, там же в подсистеме конфигурирования необходимо прописать 
+логин и пароль Системного пользователя в следующих блокирующих процессах:
+
+* ``event.blocking.interpreter.changeDealStage``
+* ``event.blocking.interpreter.createActivity``
+* ``event.blocking.interpreter.getEndDealStatus``
+
+В-третьих, необходимо проверить доступность приложения Customers по 
+адресу ``http://адрес_сервера:порт/customers`` (например: 
 http://192.168.4.80:8080/customers).
 
 Ожидаемое поведение:
@@ -83,10 +111,13 @@ http://192.168.4.80:8080/customers).
 1. Откроется страница авторизации.
 2. Авторизация Системным пользователем произойдет успешно.
 3. Откроется главная страница модуля (с поиском и кнопками создания).
-4. При выполнении произвольного запроса приложение отвечает не ошибкой 
-   сервера, а отсутствием данных.
+4. При выполнении произвольного запроса в поиске приложение отвечает не 
+   ошибкой сервера, а отсутствием данных.
+
+Если фактическое поведение отличается от ожидаемого, то необходимо:
 
-Если фактическое поведение оличается от ожидаемого, то необходимо:
+* в подсистеме администрирования проверить актуальность базы данных и 
+  процессов и, при необходимости, их обновить;
 
 * проверить конфигурационный файл ``/etc/nginx/sites-enabled/synergy-base`` 
   на наличие следующих настроек:
@@ -104,11 +135,15 @@ http://192.168.4.80:8080/customers).
                proxy_pass http://127.0.0.1:8080/customers;
                }
 
+        location /import {
+               allow                   all;
+               proxy_pass              http://127.0.0.1:8080/import;
+               proxy_set_header        Host       $host;
+               proxy_set_header        X-Real-IP  $remote_addr;
+               }
+
 * открыть Конструктор приложений по адресу ``http://адрес_сервера:порт/constructor`` 
   (например: http://192.168.4.80:8080/constructor), авторизоваться под Системным 
   пользователем, открыть приложение с кодом ``customers`` и задеплоить его через 
   меню "Клиент" -> "Деплой".
 
-В-третьих, обязательно выполнить прочие пункты 
-`инструкции по внедрению <http://rtd.lan.arta.kz/docs/sales-introduction-guide/ru/v2.0/>`_.
-