From ce159be07be092c1b89d202f64db10f30f7143f0 Mon Sep 17 00:00:00 2001 From: Elizaveta Kakhovskaya <e.pankovskaya@arta.pro> Date: Tue, 12 Mar 2019 19:11:39 +0600 Subject: [PATCH] Update Install_manual.rst --- custom_manual/Install_manual.rst | 183 +++++++++++++++++++++++++++++++ 1 file changed, 183 insertions(+) diff --git a/custom_manual/Install_manual.rst b/custom_manual/Install_manual.rst index e69de29..a736d9b 100644 --- a/custom_manual/Install_manual.rst +++ b/custom_manual/Install_manual.rst @@ -0,0 +1,183 @@ +.. 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 SM +=================================================== + +Важно! Ð”Ð»Ñ Ñ€Ð°Ð±Ð¾Ñ‚Ñ‹ данного Ð¿Ñ€Ð¸Ð»Ð¾Ð¶ÐµÐ½Ð¸Ñ Ñ‚Ñ€ÐµÐ±ÑƒÐµÑ‚ÑÑ: + +* уÑтановить Arta Synergy 3.15 wilkes и выше (инÑÑ‚Ñ€ÑƒÐºÑ†Ð¸Ñ Ð¿Ð¾ уÑтановке) +* уÑтановить Elasticsearch и Kibana (инÑÑ‚Ñ€ÑƒÐºÑ†Ð¸Ñ Ð¿Ð¾ уÑтановке) +* в подÑиÑтеме админиÑÑ‚Ñ€Ð¸Ñ€Ð¾Ð²Ð°Ð½Ð¸Ñ Ð¾Ð±Ð½Ð¾Ð²Ð¸Ñ‚ÑŒ БД и процеÑÑÑ‹, завеÑти СиÑтемного Ð¿Ð¾Ð»ÑŒÐ·Ð¾Ð²Ð°Ñ‚ÐµÐ»Ñ (код Ð¿Ð¾Ð»ÑŒÐ·Ð¾Ð²Ð°Ñ‚ÐµÐ»Ñ - itsm_service_user) Ñ Ñ€Ð¾Ð»Ñми “ÐдминиÑтратор†и “Методолог†(“Разработчик Synergyâ€) +* в разделе конфигуратора “Специальные Ñправочники†в wilkes / “Формы завершеницв hamming Ñоздать новую форму завершениÑ: тип - “Без результатаâ€, код - “no_resultâ€, название - “Без подтверждениÑâ€, галочка “Требовать Ð¿Ð¾Ð´Ñ‚Ð²ÐµÑ€Ð¶Ð´ÐµÐ½Ð¸Ñ Ñ€ÐµÐ·ÑƒÐ»ÑŒÑ‚Ð°Ñ‚Ð°â€ Ð²Ñ‹ÐºÐ»ÑŽÑ‡ÐµÐ½Ð° + +Arta Synergy SM уÑтанавливаетÑÑ Ð¾Ñ‚Ð´ÐµÐ»ÑŒÐ½Ñ‹Ð¼ пакетом. Возможные варианты уÑтановки: + +* Clean - Ð¿Ð¾Ð»Ð½Ð°Ñ ÑƒÑтановка Ð¿Ñ€Ð¸Ð»Ð¾Ð¶ÐµÐ½Ð¸Ñ Ð±ÐµÐ· демо-данных (“чиÑтацуÑтановка Ñ Ð·Ð°Ð³Ñ€ÑƒÐ·ÐºÐ¾Ð¹ конфигурации и преднаÑтроенных БД, хранилища, индекÑов Elasticsearch и Kibana, дашбордов) +* Install/Upgrade Configuration - уÑтановка Ð¿Ñ€Ð¸Ð»Ð¾Ð¶ÐµÐ½Ð¸Ñ Ð¸ загрузка его конфигурации (ÑоответÑтвенно, без БД, хранилища, индекÑов и дашбордов) +* Manual - уÑтановка только Ð¿Ñ€Ð¸Ð»Ð¾Ð¶ÐµÐ½Ð¸Ñ Ð±ÐµÐ· автоматичеÑкой загрузки конфигурации, дашбордов и вÑего оÑтального + +Подключение репозиториев +---------------------------------------------------------------------- + +УÑтановочный пакет находитÑÑ Ð² репозитории *unstable*. Ð’ файле */etc/apt/sources.list* необходимо добавить либо раÑкомментировать Ñледующую Ñтроку: + +* *deb http://deb.arta.kz/tengri unstable main contrib non-free* + +УÑтановка Ð¿Ñ€Ð¸Ð»Ð¾Ð¶ÐµÐ½Ð¸Ñ +---------------------------------------------------------------------- + +Ð”Ð»Ñ ÑƒÑтановки Ð¿Ñ€Ð¸Ð»Ð¾Ð¶ÐµÐ½Ð¸Ñ Ð½ÐµÐ¾Ð±Ñ…Ð¾Ð´Ð¸Ð¼Ð¾ выполнить команду: +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +* *# apt-get update* +* *# apt-get install arta-synergy-apps-itsm* + +Ð’ ходе уÑтановки необходимо выполнить Ñледующее: + +* Выбрать тип уÑтановки из предложенного ÑпиÑка +* Указать URL до Synergy, на котором производитÑÑ Ñ€Ð°Ð±Ð¾Ñ‚Ð° (*например: http://192.168.1.172:8080/Synergy*) +* ВвеÑти поÑледовательно логин и пароль СиÑтемного Ð¿Ð¾Ð»ÑŒÐ·Ð¾Ð²Ð°Ñ‚ÐµÐ»Ñ + +.. note:: + +Ð”Ð»Ñ Ð¿Ñ€ÐµÐ´Ð¾Ñ‚Ð²Ñ€Ð°Ñ‰ÐµÐ½Ð¸Ñ Ð´Ð°Ð»ÑŒÐ½ÐµÐ¹ÑˆÐµÐ¹ нечаÑнной уÑтановки неÑтабильных верÑий пакетов из Ñ€ÐµÐ¿Ð¾Ð·Ð¸Ñ‚Ð¾Ñ€Ð¸Ñ *unstable*, +поÑле уÑтановки *arta-synergy-apps-itsm* рекомендуетÑÑ ÐµÐ³Ð¾ закомментировать в том же файле */etc/apt/sources.list*. + +Ð”Ð»Ñ Ñ€Ð°Ð±Ð¾Ñ‚Ð¾ÑпоÑобноÑти личного кабинета необходимо +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +1. Ð’ файле */etc/nginx/sites-enabled/synergy-base* добавить Ñледующее: + +:: + + 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; + + } + + +2. Проверить наличие очередей и их Ñлушателей Ð´Ð»Ñ ITSM в двух файлах: + + +**/opt/synergy/jboss/standalone/configuration/standalone-onesynergy.xml** + +:: + + <jms-queue name="ItsmFormChangeQueue"> + <entry name="java:jboss/queues/Integration/ItsmFormChangeQueue"/> + + <durable>true</durable> + </jms-queue> + + <jms-queue name="ItsmBlockingQueue"> + <entry name="java:jboss/queues/Integration/ItsmBlockingQueue"/> + + <durable>true</durable> + </jms-queue> + + <jms-queue name="ItsmCallback_1"> + <entry name="java:jboss/queues/Integration/ItsmCallback_1"/> + + <durable>true</durable> + </jms-queue> + +**/opt/synergy/jboss/standalone/configuration/arta/api-observation-configuration.xml** + +:: + + <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> + +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 + + +ПоÑле уÑтановки вариантом “Clean†+---------------------------------------------------------------------- + +Ð’ Kibana: + * проверить, что вÑÑ‘ загрузилоÑÑŒ, в дашбордах отÑутÑтвуют визуализации, помеченные «!» + +Ð’ Конфигураторе: + * проверить во внешних модулÑÑ… “Ðналитика по инцидентам†и “Ðналитика по Ð¿Ñ€Ð¾Ð±Ð»ÐµÐ¼Ð°Ð¼â€ Ð°Ð´Ñ€ÐµÑ Ð¿Ñ€Ð¸Ð»Ð¾Ð¶ÐµÐ½Ð¸Ñ: должна быть Ð°ÐºÑ‚ÑƒÐ°Ð»ÑŒÐ½Ð°Ñ ÑÑылка на дашборды Kibana (в результате уÑтановки она может быть не полноÑтью корректнаÑ) + +Ð’ клиентÑкой чаÑти: + * проверить работоÑпоÑобноÑÑ‚ÑŒ обоих дашбордов + * Ð´Ð»Ñ Ñ€Ð°Ð±Ð¾Ñ‚Ð¾ÑпоÑобноÑти уведомлений на почту клиентам при их Ñоздании в рееÑтре “Контакты†необходимо заполнить и поле e-mail + * Ð´Ð»Ñ Ñ€Ð°Ð±Ð¾Ñ‚Ð¾ÑпоÑобноÑти уведомлений о проÑрочке времени SLA необходимо заполнить поле e-mail в наÑтройках каждого ÑпециалиÑта ÑервиÑа + +ПоÑле уÑтановки вариантом “Install/Upgrade Configuration†+---------------------------------------------------------------------- + +ЕÑли верÑÐ¸Ñ Synergy 4.0 hamming и выше, то предварительно импортировать приложение /opt/synergy/apps/itsm/itsm_application.7zip + +Ð’ подÑиÑтеме админиÑтрированиÑ: + * обновить БД и процеÑÑÑ‹ + * завеÑти пользователей и орг.Ñтруктуру, в которой будут: + * клиенты (которые будут инициировать Ñоздание заÑвок) + * ÑпециалиÑÑ‚Ñ‹ ÑервиÑа (оператор и иÑполнитель Ð´Ð»Ñ Ð¸Ð½Ñ†Ð¸Ð´ÐµÐ½Ñ‚Ð¾Ð², оператор/руководитель и иÑполнитель Ð´Ð»Ñ Ð¿Ñ€Ð¾Ð±Ð»ÐµÐ¼, иÑполнитель Ð´Ð»Ñ Ð¸Ð·Ð¼ÐµÐ½ÐµÐ½Ð¸Ð¹, ÑервиÑные команды) + * СиÑтемный пользователь (упоминалÑÑ Ð²Ñ‹ÑˆÐµ, обÑзательно должен быть назначен на должноÑÑ‚ÑŒ) + * раздать права на внешние модули (в проÑтом Ñлучае - вÑем ÑпециалиÑтам ÑервиÑа, не клиентам) + + + +Ð’ Конфигураторе: + * в форме “Инцидент†вÑтавить Ð·Ð½Ð°Ñ‡ÐµÐ½Ð¸Ñ Ð¾Ð¿ÐµÑ€Ð°Ñ‚Ð¾Ñ€Ð°, иÑполнителÑ, ÑиÑтемного Ð¿Ð¾Ð»ÑŒÐ·Ð¾Ð²Ð°Ñ‚ÐµÐ»Ñ Ð¿Ð¾ умолчанию + * в форме “Проблема†вÑтавить Ð·Ð½Ð°Ñ‡ÐµÐ½Ð¸Ñ Ð¾Ñ‚Ð²ÐµÑ‚Ñтвенного менеджера, руководителÑ, ÑиÑтемного Ð¿Ð¾Ð»ÑŒÐ·Ð¾Ð²Ð°Ñ‚ÐµÐ»Ñ Ð¿Ð¾ умолчанию + * в форме “Изменение†вÑтавить значение ответÑтвенного менеджера по умолчанию + * раздать права на рееÑтры (в проÑтом Ñлучае - вÑем права на вÑÑ‘, кроме удалениÑ, а группе «Admin» - полные права) + * раздать права на пункт меню ÑÐ¾Ð·Ð´Ð°Ð½Ð¸Ñ â€œ2. Создать инцидент†(в проÑтом Ñлучае - вÑей организации и группе «Admin») + * заменить во внешних модулÑÑ… “Ðналитика по инцидентам†и “Ðналитика по Ð¿Ñ€Ð¾Ð±Ð»ÐµÐ¼Ð°Ð¼â€ Ð°Ð´Ñ€ÐµÑ Ð¿Ñ€Ð¸Ð»Ð¾Ð¶ÐµÐ½Ð¸Ñ Ð°ÐºÑ‚ÑƒÐ°Ð»ÑŒÐ½Ð¾Ð¹ ÑÑылкой на дашборды Kibana (доÑтаточно изменить только IP-Ð°Ð´Ñ€ÐµÑ Ð¸ при необходимоÑти порт) + * ÑброÑить Ð·Ð½Ð°Ñ‡ÐµÐ½Ð¸Ñ Ñчетчиков, либо при необходимоÑти Ñоздать Ñвои шаблоны номеров Ð´Ð»Ñ Ð¸Ð´ÐµÐ½Ñ‚Ð¸Ñ„Ð¸ÐºÐ°Ñ‚Ð¾Ñ€Ð¾Ð² и применить их в ÑоответÑтвующих формах + * проверить, что во вÑех маршрутах рееÑтра и шаблонах маршрута выбрана форма Ð·Ð°Ð²ÐµÑ€ÑˆÐµÐ½Ð¸Ñ â€œÐ‘ÐµÐ· подтверждениц(упоминалаÑÑŒ в начале инÑтрукции) + +Ð’ клиентÑкой чаÑти: + * Ñоздать и заполнить одну запиÑÑŒ в рееÑтре “ÐаÑтройки уведомлений†и поÑле Ñтого Ð´Ð»Ñ Ð²Ñех групп закрыть доÑтуп на Ñоздание и удаление в Ñтом рееÑтре (необходимо Ð´Ð»Ñ ÐºÐ¾Ñ€Ñ€ÐµÐºÑ‚Ð½Ð¾Ð¹ отправки уведомлений на почту) + * Ñоздать Ñ…Ð¾Ñ‚Ñ Ð±Ñ‹ по одной теÑтовой запиÑи в рееÑтрах “Инциденты†и “Проблемы†(необходимо Ð´Ð»Ñ ÑÐ¾Ð·Ð´Ð°Ð½Ð¸Ñ ÑˆÐ°Ð±Ð»Ð¾Ð½Ð¾Ð² индекÑа в Kibana) + +Ð’ подÑиÑтеме админиÑтрированиÑ: + * проиндекÑировать данные форм + +Ð’ Kibana: + * Ñоздать 2 шаблона индекÑа: «r-itsm_registry_incidents» и «r-itsm_registry_problems» + * импортировать в Kibana (Management -> Saved Objects -> Import) конфигурацию их 2-Ñ… дашбордов из файла .../configuration/arta/apps/sm_dashboards.json + * импортировать в Kibana (Management -> Saved Objects -> Import) конфигурацию из 27-и визуализаций из файла .../configuration/arta/apps/sm_visualizations.json + * проверить, что вÑÑ‘ загрузилоÑÑŒ, в дашбордах отÑутÑтвуют визуализации, помеченные «!» (при Ñтом возможно наличие визуализаций Ñо значениÑми “0â€, “?â€, “No results foundâ€, и Ñто вÑÑ‘ не ÑвлÑетÑÑ Ð¾ÑˆÐ¸Ð±ÐºÐ¾Ð¹) + +Ð’ клиентÑкой чаÑти: + * проверить работоÑпоÑобноÑÑ‚ÑŒ обоих дашбордов + * Ð´Ð»Ñ Ñ€Ð°Ð±Ð¾Ñ‚Ð¾ÑпоÑобноÑти уведомлений на почту клиентам при их Ñоздании в рееÑтре “Контакты†необходимо заполнить и поле e-mail + * Ð´Ð»Ñ Ñ€Ð°Ð±Ð¾Ñ‚Ð¾ÑпоÑобноÑти уведомлений о проÑрочке времени SLA необходимо заполнить поле e-mail в наÑтройках каждого ÑпециалиÑта ÑервиÑа + -- 2.26.2