Регистрация приложений для работы в качестве провайдеров TRS для службы Lifecycle Query Engine

Если используется Rational Engineering Lifecycle Manager, то требуется произвести настройку продуктов в качестве поставщиков TRS и предоставить Lifecycle Query Engine доступ к их данным.

После установки и настройки приложений и после создания дружественных отношений между приложениями на удаленных серверах настройте каждое приложение как поставщик набора отслеживаемых ресурсов (TRS), чтобы механизм запросов жизненного цикла (LQE) получил доступ к их данным для создания индекса.

Предварительные требования:
Важное замечание: Если приложение находится не на том же Jazz Team Server, где располагается LQE, то ключи, созданные во время выполнения этой задачи, повторно используются позже, когда добавляются источники данных в механизм запросов жизненного цикла в соответствии с разделом Создать индекс LQE. Запомните имя и пароль для каждого ключа.

Присвоение внутренней лицензии приемника TRS

Присвойте внутренние лицензии приемника TRS функциональным пользователямlqe_user и jts_user.

  1. Откройте административную консоль JTS по адресу https://имя-хоста:порт/jts/admin
  2. Выберите Пользователи > Активные пользователи.
  3. Щелкните на ссылке lqe_user. На странице lqe_user перейдите к области Лицензия на доступ клиента, выберите Приемник TRS-внутренняя и нажмите кнопку Сохранить.
    Выбор внутренней лицензии приемника TRS для основного пользователя LQE
  4. Вернитесь на страницу Активные пользователи. Щелкните на ссылке jts_user. На странице jts_user перейдите к области Лицензия на доступ клиента и выберите Приемник TRS-внутренняя.
  5. Нажмите кнопку Сохранить.

Настройка TRS для приложений CLM

Если эти приложения развернуты на том же Jazz Team Server, что и LQE, создавать входящие приемники нет необходимости. Выполните эти действия только если приложения CCM, QM и RM расположены на разных серверах Jazz Team Server.

  1. Создайте ключ входящего приемника LQE для CCM. Откройте страницу администрирования CCM: https://имя-хоста:порт/ccm/admin
  2. На странице Приложение выберите Связь >Приемники (Входящие) и создайте ключ приемника OAuth для LQE:
    • Имя: LQE
    • Пароль: xyz
    • Доверенный: yes
    Нажмите кнопку Зарегистрировать.
  3. Откройте список Назначенные ключи и щелкните на значке карандаша для изменения записи LQE.
  4. В окне Изменить свойства ключа клиента щелкните на ссылке Выбрать пользователя....
  5. Введите в поле фильтра lqe и выберите в списке совпавших пользователей lqe_user. Нажмите кнопку Добавить и закрыть, затем кнопку Готово.
  6. Создайте ключ входящего приемника LQE для QM. Откройте страницу администрирования QM: https://имя-хоста:порт/qm/admin и еще раз выполните шаги с 7 по 10.
  7. Создайте ключ входящего приемника LQE для DOORS Next Generation, если это приложение RM. Откройте страницу администрирования RM https://имя-хоста:порт/rm/admin и выполните повторно шаги с 7 по 10.
  8. Зарегистрируйте приложения в качестве поставщиков TRS и создайте их индекс. Откройте страницу администрирования Lifecycle Query Engine https://имя-хоста:порт/lqe/web.
  9. Выберите Администрирование > Источники данных > Добавить источник данных.
  10. В окне Добавить источник данных выберите https://имя-хоста:порт/ccm/oslc/workitem/trs и добавьте метку RTC. Примите остальные значения по умолчанию (если требуется проиндексировать большое количество данных, увеличьте число нитей для начальной индексации до 4) и нажмите кнопку Готово.
  11. Зарегистрируйте QM в качестве поставщика TRS и создайте его индекс. На странице Источники данных нажмите кнопку Добавить источник данных.
  12. В окне Добавить источник данных выберите https://имя-хоста:порт/qm/trs и добавьте метку RQM. Оставьте без изменения остальные параметры по умолчанию и нажмите кнопку Готово.
  13. Зарегистрируйте RM в качестве поставщика TRS и создайте его индекс. На странице Источники данных нажмите кнопку Добавить источник данных.
  14. В окне Добавить источник данных выберите https://имя-хоста:порт/rm/trs и добавьте метку DNG. Оставьте без изменения остальные параметры по умолчанию и нажмите кнопку Готово.

Теперь приложения Rational Team Concert, Rational Quality Manager и Rational DOORS Next Generation проиндексированы и доступны для Rational Engineering Lifecycle Manager. Дополнительные сведения о параметрах текущей индексации приведены в разделе Индексация данных с помощью механизма запросов жизненного цикла

Настройка DOORS и DOORS Web Access в качестве поставщиков TRS

Rational DOORS Web Access поставляется с различными стандартными пользователями и паролями для работы TRS. Параметры конфигурации, связанные с этими пользователями, необходимо отредактировать, как описано в следующей процедуре. Для интеграции применяются следующие пользователи:
  • Функциональный пользователь LQE. Он обрабатывает запросы LQE, которые интегрированное приложение приемника TRS передает Rational DOORS Web Access. Пользователь должен существовать в базе данных Rational DOORS. Параметры этого пользователя указываются в файле festival.xml.
  • trs.db.user. Это пользователь базы данных Derby, обладающий доступом к базе данных TRS. Он применяется Rational DOORS Web Access для извлечения данных из базы данных.
  • derby.user.admin. Администратор базы данных Derby. В настоящее время этот пользователь не требуется для Rational DOORS Web Access и базы данных Derby. Пароль этого пользователя можно указать в файле свойств Derby.
  1. Откройте файл [путь-к-DWA]\server\festival\config\festival.xml.
    1. Найдите раздел настраиваемых системных свойств Configurable system properties.
    2. Добавьте свойства, указанные в следующей таблице.
      Формат свойств:
      <f:property name="свойство-из-таблицы" value="допустимое-значение-или-стандартное-значение-из-таблицы" />
    Табл. 1. Свойства файла Festival.xml для TRS и LQE
    Свойство Описание/значение
    functional.user.consumer.key Ключ приемника, связанный с функциональным пользователем LQE. С его помощью служба Lifecycle Query Engine обращается к DOORS Tracked Resource Set (TRS). Ключ должен быть указан в конфигурации Rational DOORS на вкладке Локальные ключи.
    functional.user.consumer.secret Пароль приемника, связанный с функциональным пользователем LQE. С его помощью служба Lifecycle Query Engine обращается к DOORS Tracked Resource Set (TRS). Пароль должен быть указан в конфигурации Rational DOORS на вкладке Локальные ключи.
    functional.user.name Имя функционального пользователя LQE. Требуется имя допустимого пользователя Rational DOORS. ИД пользователя DOORS, указанный в файле festival.xml, должен существовать и иметь полные права доступа к проектам и артефактам, предоставленным в рабочем наборе.
    functional.user.password Пароль функционального пользователя LQE.
    trs.db.user Имя пользователя TRS. Для простоты можно использовать имя пользователя по умолчанию trs.db.user. Если это свойство не указано, система использует значения по умолчанию.
    trs.db.password Пароль trs.db.user. Этот параметр также должен быть указан в файле свойств Derby. Значение по умолчанию: dwaTrsPa11word. Если это свойство не указано, система использует значения по умолчанию.
    trs.page.size Число ресурсов TRS для добавления на страницу. Значение по умолчанию: 250. Если это свойство не указано, система использует значения по умолчанию.
    trs.enable Укажите значение true.
    Следующий фрагмент файла festival.xml содержит пример свойств, имеющих отношение к TRS:
    <f:property name="functional.user.consumer.key" value="xyz"/> 
    <f:property name="functional.user.consumer.secret" value="xyz" />
    <f:property name="functional.user.name" value="Administrator" /> 
    <f:property name="functional.user.password" value="qwert6" /> 
    <f:property name="trs.enable" value="true" />
  2. Необязательно: откройте файл derby.properties в редакторе. Этот файл находится в каталоге dwa_install/derby.
  3. Необязательно: замените пароли в параметрах, указанных в следующей таблице.
    Табл. 2. Параметры TRS в файле свойств Derby
    Значение Описание
    derby.user.trs Пароль пользователя trs.db.user, указанный в файле festival.xml. Значение по умолчанию: dwaTrsPa11word.
    derby.user.admin Пароль администратора базы данных Derby. В настоящее время этот пользователь не требуется для Rational DOORS Web Access и базы данных Derby. Значение по умолчанию: dwaTrsPa11word.
  4. Инициализируйте базу данных TRS. Запустите следующие сценарии:
    • Для Windows.:
      dwa_install/derby.start.bat
      dwa_install/derby/scripts/init_trs.bat
    • Для Linux.:
      dwa_install/derby.start.sh
      dwa_install/derby/scripts/init_trs.sh
  5. Войдите в клиент Rational DOORS как пользователь с правами доступа администратора базы данных или администратора приложения.
  6. Откройте меню Файл > OSLC > Локальные ключи. В окне Локальные ключи нажмите кнопку Добавить. Укажите значения из файла festival.xml.
    • Имя приемника: любое имя. Рекомендуется указать LQE.
    • Ключ приемника: значение, указанное для свойства functional.user.consumer.key.
    • Пароль приемника: значение свойства functional.user.consumer.secret.
    Нажмите кнопку Зарегистрировать, затем OK.
  7. Откройте меню Файл > OSLC > Рабочие наборы. В окне Выбрать проект выберите свойства, папки и модули, которые требуется сделать доступными для LQE.
  8. Выберите все требуемые модули в панели Выбрать модули. Нажмите кнопку Применить.

Настройка LQE для использования DOORS Web Access в качестве источника данных

  1. Откройте https://хост:порт/lqe/web
  2. Выберите Администрирование в меню панели инструментов.
  3. На странице Источники данных выберите Добавить источник данных.
  4. В окне Добавить источник данных выберите опцию URL-адрес документа корневых служб. Введите URL-адрес корневых служб DOORS. Выберите URL-адрес TRS. Введите метку и выберите Указать идентификационные данные.
    • URL корневых служб: https://сервер-doors:порт/dwa/public/rootservices
    • Выберите https://сервер-doors:порт/dwa/rm/trs
    • Метка: DOORS
    Снимок экрана со значениями Источник данных для DOORS, добавляемыми в LQE
  5. Введите ключ приемника и пароль.
    Прим.: Ключ приемника и его пароль должны совпадать со значениями из файла DOORS Web Access festival.XML. Ниже приведен пример с использованием значения xyz.
    <f:property name="functional.user.consumer.key" value="xyz"/>
    <f:property name="functional.user.consumer.secret" value="xyz"/>
    Снимок экрана: ключ приемника и пароль
  6. Укажите число потоков 1 для первоначальной и инкрементальной индексации и нажмите кнопку Готово. Если для индексации используется несколько нитей, то могут происходить ошибки.

Настройка TRS для приложения Rhapsody Design Manager

  1. Перейдите в каталог https://хост:порт/jts/admin
    Прим.: Входящие приемники Design Manager определяются в административной консоли Jazz Team Server, а не в консоли Design Manager.
  2. Выберите Сервер > Приемники (Входящие) и введите следующие данные, после чего нажмите кнопку Зарегистрировать:
    • Имя: LQE
    • Пароль: xyz
    • Доверенный: yes
  3. Перейдите к списку Ключи с правами доступа и отредактируйте запись LQE, щелкнув на значке с карандашом.
  4. В окне Изменить свойства ключа клиента щелкните на ссылке Выбрать пользователя....
  5. Введите в поле фильтра lqe и выберите в списке совпавших пользователей lqe_user. Нажмите кнопку Добавить и закрыть, затем кнопку Готово.
  6. Откройте https://хост:порт/dm/web
  7. Войдите в систему от имени пользователя-администратора.
  8. Выберите область проекта и выберите Управление свойствами проекта в выпадающем меню Администрирование (значок с шестерней). Выберите Стандартный контекст OSLC и нажмите кнопку Выбрать. Щелкните на имени проекта, нажмите кнопку OK, а затем - кнопку Сохранить.
    Выберите область проекта и назначьте стандартный контекст OSLC.
  9. Зарегистрируйте Rhapsody DM в качестве поставщика TRS и создайте его индекс. Откройте страницу администрирования Lifecycle Query Engine https://имя-хоста-lqe:порт/lqe/web.
  10. Выберите Администрирование > Источники данных > Добавить источник данных.
  11. В окне Добавить источник данных выберите http://имя-хоста-rdm:9443/dm/trs и добавьте метку RDM. Примите остальные значения по умолчанию (если требуется проиндексировать большое количество данных, увеличьте число нитей для начальной индексации до 4) и нажмите кнопку Готово.

Настройка TRS для приложения Rational Engineering Lifecycle Manager

В случае новой установки нет данных для индексирования. Можно создать пример проекта и продукта, чтобы убедиться в успешном создании индекса.

  1. Откройте страницу администрирования Lifecycle Query Engine https://имя-хоста-lqe:порт/lqe/web.
  2. Выберите Администрирование > Источники данных > Добавить источник данных.
  3. В окне Добавить источник данных выберите http://имя-хоста-relm:порт/productdef/resource/tracked_resource_set и добавьте метку RELM. Примите остальные значения по умолчанию (если требуется проиндексировать большое количество данных, увеличьте число нитей для начальной индексации до 4) и нажмите кнопку Готово.
    Список источников данных со всеми проиндексированными компонентами.
  4. Для тестирования индекса откройте Rational Engineering Lifecycle Manager: https://имя-хоста-relm:порт/relm/web
  5. Выберите пример проекта. В меню Запросы выберите Общие запросы.
  6. Разверните узел Пример и выберите Все артефакты. Вам может быть выдан запрос на предоставление прав всем приложениям, для которых выполняется запрос. На странице Идентификация пользователя https://relm_host_name:port/lqe/web/auth нажмите кнопку Идентифицировать напротив каждого приложения, которое требуется опросить.
    Экран авторизации пользователя
  7. В результате запроса будет указан созданный пример продукта.

Настройка TRS для пользователей Jazz Team Server

  1. Откройте страницу администрирования Lifecycle Query Engine https://имя-хоста-lqe:порт/lqe/web.
  2. Выберите Администрирование > Источники данных > Добавить источник данных.
  3. В окне Добавить источник данных выберите http://имя-хоста:порт/jts/trsUsers и добавьте метку Пользователи. Оставьте без изменения остальные параметры по умолчанию и нажмите кнопку Готово.

Дальнейшие действия

После настройки приложений как поставщиков TRS выполните действия, указанные в Запрос на тестирование или отладку, чтобы проверить конфигурацию.


Комментарии