index.rst 6.19 KB
Newer Older
Danir Tlepov's avatar
Danir Tlepov committed
1 2 3 4 5 6
.. 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 Knowledge
7
========================================================================
Danir Tlepov's avatar
Danir Tlepov committed
8 9

Общие сведения
10
--------------------------
Danir Tlepov's avatar
Danir Tlepov committed
11 12 13 14 15 16 17 18 19 20 21 22 23 24

Synergy Knowledge устанавливается отдельным пакетом. Возможны следующие варианты установки.

1. ``Clean`` - полная установка приложения без демо-данных ("чистая" установка с загрузкой конфигурации и преднастроенных БД, хранилища, индексов Elasticsearch и Kibana, дашбордов).

    .. hint:: Вариант установки ``Clean`` удаляет все текущие данные в системе!

2. ``Install/Upgrade Configuration`` - установка приложения, загрузка его конфигурации, индексов и дашбордов (соответственно, без БД и хранилища).

    .. hint:: Данный вариант установки отличается от других тем, что загружается конфигурация через Synergy API, не удаляя при этом информацию пользователя.

3. ``Manual`` - установка только приложения без автоматической загрузки конфигурации, дашбордов и всего остального.

Предварительные требования
25
---------------------------------------
Danir Tlepov's avatar
Danir Tlepov committed
26 27 28 29 30 31 32 33 34

Важно! Для работы данного приложения требуется:

* установить 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>`_)
* установить и запустить Elasticsearch и Kibana (`инструкция по установке <http://tdd.lan.arta.kz/docs/synergy/tags/hamming/admin-manual/html/appendix.dashboards.html>`_)
* в подсистеме администрирования обновить базу данных и процессы
* для варианта установки ``Install/Upgrade Configuration`` предварительно завести Системного пользователя (с произвольными логином/паролем, с доступом в систему, с ролью "Разработчик Synergy" и "Администратор", а также назначенного на произвольную должность)

Установка приложения
35
--------------------------
Danir Tlepov's avatar
Danir Tlepov committed
36

37
Установочный пакет находится в репозитории *knowledge-1.0*. В файле ``/etc/apt/sources.list`` необходимо добавить либо раскомментировать следующую строку:
Danir Tlepov's avatar
Danir Tlepov committed
38

39
``deb http://deb.arta.kz/tengri knowledge-1.0 main contrib non-free``
Danir Tlepov's avatar
Danir Tlepov committed
40 41 42 43 44 45 46 47 48

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

    .. code-block:: html 

	# apt-get update
	# apt-get install arta-synergy-apps-knowledge

Особенности установки Clean
49
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Danir Tlepov's avatar
Danir Tlepov committed
50 51 52 53 54 55 56 57 58

В ходе установки необходимо выполнить следующее:

* Выбрать тип установки из предложенного списка

    .. figure:: resources/img/knowledge_step1_clean.png

        Рис. Тип установки

59
* Указать URL до Synergy, на котором производится работа (например: http://192.168.2.78:8080/Synergy)
Danir Tlepov's avatar
Danir Tlepov committed
60 61 62 63 64 65 66 67 68 69 70 71 72 73

    .. figure:: resources/img/knowledge_step2.png

        Рис. Ввод synergy URL

* Ввести пароль mysql

    .. figure:: resources/img/knowledge_step4.png

        Рис. Ввод пароля mysql

    .. attention:: В случае, если после установки приложения вариантом ``Clean`` имеются проблемы с авторизацией пользователей (ошибка ``loginservlet``), то выполните в терминале команду ``dpkg-reconfigure arta-synergy-synergy`` и следуйте `мастеру установки <http://tdd.lan.arta.kz/docs/synergy/tags/hamming/admin-manual/html/install-and-setup.html#install-and-setup.install>`_.

Особенности установки Install/Upgrade Configuration и Manual
74
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Danir Tlepov's avatar
Danir Tlepov committed
75 76 77 78 79 80 81 82 83

В ходе установки необходимо выполнить следующее:

* Выбрать тип установки из предложенного списка

    .. figure:: resources/img/knowledge_step1_install.png

        Рис. Тип установки

84
* Указать URL до Synergy, на котором производится работа (например: http://192.168.2.78:8080/Synergy)
Danir Tlepov's avatar
Danir Tlepov committed
85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106

    .. figure:: resources/img/knowledge_step2.png

        Рис. Ввод synergy URL

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

    .. figure:: resources/img/knowledge_step3_install_login.png

        Рис. Ввод логина

    .. figure:: resources/img/knowledge_step3_install_password.png

        Рис. Ввод пароля

* Ввести пароль mysql

    .. figure:: resources/img/knowledge_step4.png

        Рис. Ввод пароля mysql

После установки
107
--------------------------
Danir Tlepov's avatar
Danir Tlepov committed
108

109 110 111 112 113 114 115
Во-первых, необходимо вручную запустить сервисы Elasticsearch и Kibana:

    .. code-block:: html 

	# service elasticsearch start
	# service kibana start

Tatyana Beisekina's avatar
Tatyana Beisekina committed
116
Во-вторых, обязательно выполните пункты `инструкции по внедрению <http://rtd.lan.arta.kz/docs/khowledge-introduction-guide>`_.