Add new file

install_guide/index.rst

+Конструктор приложений
+========================================================================
+
+
+Введение
+--------------------------
+
+Конструктор приложений - это отдельный модуль Synergy, позволяющий разработчику Synergy создавать и настраивать произвольные приложения на основе компонентов Synergy.
+Использование основных возможностей Конструктора не требует от разработчика Synergy навыков написания кода на JavaScript, Java и так далее. При этом в случае необходимости кастомизации приложения - использования дополнительного скриптинга или настройки стилей приложения - она не потребует больших усилий разработчика. 
+
+Установка пакета
+--------------------------
+
+Пакет Конструктора ``arta-synergy-apps-constructor`` устанавливается из репозитория 
+``deb http://deb.arta.kz/tengri constructor-2.1 main contrib non-free``. При этом необходимо, чтобы на сервере уже был установлен пакет ``arta-synergy-synergy`` из репозитория ``minsky``. 
+Процедура установки
+Для установки пакета необходимо выполнить команды (в консоли сервера): 
+установить или обновить пакет ``arta-synergy-synergy`` (см. инструкцию);
+открыть список репозиториев: 
+``# nano /etc/apt/sources.list``
+добавить в список строку ``deb http://deb.arta.kz/tengri constructor-2.1 main contrib non-free``:
+
+обновить репозитории: 
+``# aptitude update``
+установить пакет ``arta-synergy-apps-constructor``: 
+``# aptitude install arta-synergy-apps-constructor``
+
+После установки
+--------------------------
+
+После установки необходимо в Административном приложении ``/SynergyAdmin`` выполнить: 
+Обновление БД (см. инструкцию)
+Добавить пользователю, который будет использовать Конструктор, роль “Разработчик web-клиента”: 
+
+Приложение Конструктора доступно по адресу: ``http[s]://<host>:<port>/constructor``. Это приложение требует авторизации от имени пользователя с ролью “Разработчик web-клиента”. 
+Обновление пакета
+Для обновления уже установленного Конструктора приложений до актуальной версии 2.0 необходимо: 
+обновить репозитории: 
+``# aptitude update``
+установить пакет ``arta-synergy-apps-constructor``: 
+``# aptitude install arta-synergy-apps-constructor``
+в Административном приложении ``/SynergyAdmin`` выполнить обновление БД. 
+
+Настройка nginx при использовании DNS-имени на стенде
+Конструктор приложений версии 2.1 работает с web-сокетами. Если к стенду с Конструктором обращаться по IP, то, как правило, проблем при работе с приложениями не возникает. Однако если дать стенду DNS-имя (например, ``demostand.arta.pro``), то страницы приложения могут не открываться. 
+Для исправления этой проблемы необходимо на стенде, где настроено DNS-имя для стенда (как правило, это ``192.168.1.1``), прописать в конфигурационные файлы настройки для работы сокетов. 
+
+В ``nginx.conf`` в ``http`` прописать: 
+
+```
+map $http_upgrade $connection_upgrade {
+    default upgrade;
+    ''      close;
+}
+
+upstream websocket {
+  server 127.0.0.1:8080;
+}
+```
+
+В ``synergy.base``: 
+
+```
+location /constructor/websocket {
+    proxy_pass http://websocket;
+    proxy_http_version 1.1;
+    proxy_set_header Upgrade $http_upgrade;
+    proxy_set_header Connection "Upgrade";
+    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+}
+```
+
+В случае добавления ``ws`` для нескольких серверов на ``DNS``-сервере запись ``upstream`` в ``nginx.conf`` может выглядеть так:
+
+```
+upstream websocket {
+  server 192.168.3.1:8080;
+  server 192.168.3.2:8080;
+}
+```