project install-guide

install-guide/conf.py

@@ -43,7 +43,7 @@ source_suffix = '.rst'
 master_doc = 'index'
 
 # General information about the project.
-project = u'Инструкция по внедрению Synergy Showcase'
+project = u'Инструкция по установке Synergy Project'
 copyright = u'2018, ARTA Software'
 
 # The version info for the project you're documenting, acts as replacement for
@@ -232,7 +232,7 @@ latex_documents = [
 # One entry per manual page. List of tuples
 # (source start file, name, description, authors, manual section).
 man_pages = [
-    ('index', 'readthedocstemplate', u'Спецификация требований Synergy Showcase',
+    ('index', 'readthedocstemplate', u'Инструкция по установке Synergy Project',
      [u'Read the Docs'], 1)
 ]
 

install-guide/index.rst

@@ -13,7 +13,7 @@
 
 * установить 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>`_)
 * в подсистеме администрирования обновить БД и процессы, завести Системного пользователя (с произвольными логином/паролем, 
-  с доступом в систему, с ролью “Разработчик Synergy”)
+  с доступом в систему, назначенного на должность в оргструктуре)
 
 Подключение репозиториев
 ---------------------------
@@ -28,43 +28,49 @@
 
 Для установки приложения необходимо выполнить команду:
 
-    .. code-block:: html 
+.. code-block:: bash 
 
 	# apt-get update
 	# apt-get install arta-synergy-apps-project
 
-В ходе установки необходимо выполнить следующее:
+В ходе установки необходимо выбрать тип установки из предложенного списка: 
 
-* Выбрать тип установки из предложенного списка
+.. figure:: _static/install1.png
 
-    .. figure:: resources/img/showcase1.png
+.. note:: 
 
-        Рис. Тип установки
+    #. Вариант ``Clean`` **полностью удаляет все ранее установленные данные Synergy**, устанавливает приложение Synergy Project, автоматически загружает 
+       его конфигурацию и загружает дампы базы данных.
+    #. Вариант ``Install/Upgrade Configuration`` устанавливает приложение Synergy Project, автоматически загружает его конфигурацию и настраивает 
+       необходимые конфигурационные файлы.
+    #. Вариант ``Manual`` устанавливает приложение Synergy Project без автоматической загрузки конфигурации (т.е. только заменяет ``war``-файлы).
 
-    .. hint::
+Дальнейший ход установки зависит от выбранного типа установки: 
 
-	#. Вариант ``Install/Upgrade Configuration`` устанавливает приложение Synergy Project, автоматически загружает его конфигурацию и настраивает 
-           необходимые конфигурационные файлы.
-	#. Вариант ``Manual`` устанавливает приложение Synergy Project без автоматической загрузки конфигурации (т.е. только заменяет ``war``-файлы).
+* для варианта ``Clean``: 
 
-* Указать URL до Synergy, на котором производится работа (например: http://192.168.1.191:8080/Synergy)
+    - указать URL сервера Synergy, на котором производится работа (например: ``http://192.168.0.187:8080/Synergy``): 
+    
+      .. figure:: _static/install2_synergy_address.png
 
-    .. figure:: resources/img/showcase2.png
+    - ввести пароль пользователя, имеющего root-права mysql, от имени которого будут применены дампы базы данных: 
 
-        Рис. Ввод synergy URL
+      .. figure:: _static/install3_mysql.png
 
-* Ввести последовательно логин и пароль Системного пользователя
+* для вариантов ``Install/Upgrade Configuration`` и ``Manual``: 
 
-    .. figure:: resources/img/showcase3.png
+    - указать URL сервера Synergy, на котором производится работа (например: ``http://192.168.0.187:8080/Synergy``): 
+    
+      .. figure:: _static/install2_synergy_address.png
 
-        Рис. Ввод логина
+    - ввести последовательно логин и пароль Системного пользователя: 
 
-    .. figure:: resources/img/showcase4.png
+      .. figure:: _static/install4_user-login.png 
 
-        Рис. Ввод пароля
+      .. figure:: _static/install5_user-pass.png
 
-    .. note:: Для предотвращения дальнейшей нечаянной установки нестабильных версий пакетов из репозитория ``unstable``, после установки пакета 
-              ``arta-synergy-apps-project`` рекомендуется закомментировать этот репозиторий в файле ``/etc/apt/sources.list``.
+.. attention:: Для предотвращения дальнейшей нечаянной установки нестабильных версий пакетов из репозитория ``unstable``, после установки пакета 
+               ``arta-synergy-apps-project`` рекомендуется закомментировать этот репозиторий в файле ``/etc/apt/sources.list``.
 
 После установки приложения обязательно выполнить пункты `инструкции по внедрению <http://rtd.lan.arta.kz/docs/showcase-introduction-guide/ru/v1.0/index.html>`_.