Если используется Rational Engineering
Lifecycle Manager, то требуется произвести настройку
продуктов в качестве поставщиков TRS и предоставить Lifecycle Query Engine
доступ к их данным.
После установки и настройки приложений и после создания дружественных
отношений между приложениями на удаленных серверах настройте каждое
приложение как поставщик набора отслеживаемых ресурсов (TRS), чтобы
механизм запросов жизненного цикла (LQE) получил доступ к их данным для создания индекса.
Предварительные требования: - Запустите сервер для каждого приложения, которое требуется настроить
Важное замечание: Если приложение находится не на том же Jazz Team Server, где располагается LQE, то ключи,
созданные во время выполнения этой задачи, повторно используются позже, когда добавляются
источники данных в механизм запросов жизненного цикла в соответствии с разделом
Создать индекс LQE. Запомните имя и пароль для каждого ключа.
Присвоение внутренней лицензии приемника TRS
Присвойте внутренние лицензии приемника TRS функциональным пользователямlqe_user и jts_user.
- Откройте административную консоль JTS по адресу https://имя-хоста:порт/jts/admin
- Выберите Пользователи > Активные пользователи.
- Щелкните на ссылке lqe_user. На странице lqe_user
перейдите к области Лицензия на доступ клиента, выберите Приемник
TRS-внутренняя и нажмите кнопку Сохранить.
- Вернитесь на страницу Активные пользователи. Щелкните на ссылке jts_user. На странице jts_user
перейдите к области Лицензия на доступ клиента и выберите Приемник
TRS-внутренняя.
- Нажмите кнопку Сохранить.
Настройка TRS для приложений CLM
Если эти приложения развернуты на том же Jazz Team
Server, что и LQE, создавать входящие приемники нет необходимости. Выполните
эти действия только если приложения CCM, QM и RM расположены на разных серверах Jazz Team Server.
- Создайте ключ входящего приемника LQE для CCM. Откройте страницу администрирования CCM: https://имя-хоста:порт/ccm/admin
- На странице Приложение выберите Связь
>Приемники (Входящие) и создайте ключ приемника OAuth для LQE:
- Имя: LQE
- Пароль: xyz
- Доверенный: yes
Нажмите кнопку Зарегистрировать.
- Откройте список Назначенные ключи и щелкните на значке карандаша для изменения записи LQE.
- В окне Изменить свойства ключа клиента
щелкните на ссылке Выбрать пользователя....
- Введите в поле фильтра lqe и выберите в списке совпавших пользователей lqe_user. Нажмите кнопку Добавить и закрыть, затем кнопку Готово.
- Создайте ключ входящего приемника LQE для QM. Откройте страницу администрирования QM: https://имя-хоста:порт/qm/admin и еще раз выполните шаги с 7 по 10.
- Создайте ключ входящего приемника LQE для DOORS Next Generation, если это приложение RM.
Откройте страницу администрирования RM https://имя-хоста:порт/rm/admin и выполните повторно шаги с 7 по 10.
- Зарегистрируйте приложения в качестве поставщиков TRS и создайте их индекс. Откройте страницу администрирования Lifecycle Query Engine https://имя-хоста:порт/lqe/web.
- Выберите Администрирование > Источники данных > Добавить источник данных.
- В окне Добавить источник данных выберите https://имя-хоста:порт/ccm/oslc/workitem/trs и добавьте метку RTC. Примите остальные значения по умолчанию
(если требуется проиндексировать большое количество данных, увеличьте
число нитей для начальной индексации до 4) и нажмите кнопку Готово.
- Зарегистрируйте QM в качестве поставщика TRS и создайте его индекс. На странице Источники
данных нажмите кнопку Добавить источник данных.
- В окне Добавить источник данных выберите https://имя-хоста:порт/qm/trs и добавьте метку RQM. Оставьте без изменения остальные параметры по умолчанию и нажмите кнопку Готово.
- Зарегистрируйте RM в качестве поставщика TRS и создайте его индекс. На странице Источники
данных нажмите кнопку Добавить источник данных.
- В окне Добавить источник данных выберите 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.
- Откройте файл [путь-к-DWA]\server\festival\config\festival.xml.
- Найдите раздел настраиваемых системных свойств Configurable system properties.
- Добавьте свойства, указанные в следующей таблице.
Формат
свойств:
<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" />
- Необязательно: откройте файл derby.properties
в редакторе. Этот файл находится в каталоге dwa_install/derby.
- Необязательно: замените пароли в параметрах, указанных в
следующей таблице.
Табл. 2. Параметры TRS в файле свойств Derby| Значение |
Описание |
| derby.user.trs |
Пароль пользователя trs.db.user, указанный в файле
festival.xml. Значение по умолчанию: dwaTrsPa11word. |
| derby.user.admin |
Пароль администратора базы данных Derby.
В настоящее время этот пользователь не требуется для
Rational DOORS
Web Access и базы данных Derby. Значение по умолчанию: dwaTrsPa11word. |
- Инициализируйте базу данных TRS. Запустите следующие сценарии:
- Войдите в клиент Rational DOORS как пользователь с правами доступа администратора базы данных
или администратора приложения.
- Откройте меню . В окне Локальные
ключи нажмите кнопку Добавить. Укажите
значения из файла festival.xml.
- Имя приемника: любое имя. Рекомендуется
указать LQE.
- Ключ приемника: значение, указанное для свойства functional.user.consumer.key.
- Пароль приемника: значение свойства functional.user.consumer.secret.
Нажмите кнопку Зарегистрировать, затем OK.
- Откройте меню . В окне Выбрать проект выберите свойства, папки и модули, которые требуется сделать доступными
для LQE.
- Выберите все требуемые модули в панели Выбрать модули.
Нажмите кнопку Применить.
Настройка LQE для использования DOORS Web
Access в качестве источника данных
- Откройте https://хост:порт/lqe/web
- Выберите Администрирование в меню панели инструментов.
- На странице Источники данных выберите Добавить источник данных.
- В окне Добавить источник данных выберите опцию
URL-адрес документа корневых служб. Введите URL-адрес корневых служб DOORS. Выберите URL-адрес TRS.
Введите метку и выберите Указать идентификационные данные.
- URL корневых служб: https://сервер-doors:порт/dwa/public/rootservices
- Выберите https://сервер-doors:порт/dwa/rm/trs
- Метка: DOORS
- Введите ключ приемника и пароль.
Прим.: Ключ приемника
и его пароль должны совпадать со значениями из файла DOORS Web
Access
festival.XML. Ниже приведен пример
с использованием значения
xyz.
<f:property name="functional.user.consumer.key" value="xyz"/>
<f:property name="functional.user.consumer.secret" value="xyz"/>
- Укажите число потоков 1 для первоначальной и инкрементальной индексации и нажмите кнопку Готово. Если для индексации
используется несколько нитей, то могут происходить ошибки.
Настройка TRS для приложения Rhapsody Design Manager
- Перейдите в каталог https://хост:порт/jts/admin
Прим.: Входящие приемники Design
Manager определяются в административной консоли Jazz Team Server, а не в консоли Design Manager.
- Выберите Сервер > Приемники (Входящие) и введите следующие данные, после чего нажмите кнопку Зарегистрировать:
- Имя: LQE
- Пароль: xyz
- Доверенный: yes
- Перейдите к списку Ключи с правами доступа и отредактируйте
запись LQE, щелкнув на значке с карандашом.
- В окне Изменить свойства ключа клиента
щелкните на ссылке Выбрать пользователя....
- Введите в поле фильтра lqe и выберите в списке совпавших пользователей lqe_user. Нажмите кнопку Добавить и закрыть, затем кнопку Готово.
- Откройте https://хост:порт/dm/web
- Войдите в систему от имени пользователя-администратора.
- Выберите область проекта и выберите Управление
свойствами проекта в выпадающем меню Администрирование
(значок с шестерней). Выберите Стандартный контекст OSLC
и нажмите кнопку Выбрать. Щелкните на имени проекта,
нажмите кнопку OK, а затем - кнопку Сохранить.
- Зарегистрируйте Rhapsody DM
в качестве поставщика TRS и создайте его индекс. Откройте страницу администрирования Lifecycle Query
Engine https://имя-хоста-lqe:порт/lqe/web.
- Выберите Администрирование > Источники данных > Добавить источник данных.
- В окне Добавить источник данных выберите http://имя-хоста-rdm:9443/dm/trs и добавьте метку RDM. Примите остальные значения по умолчанию
(если требуется проиндексировать большое количество данных, увеличьте
число нитей для начальной индексации до 4) и нажмите кнопку Готово.
Настройка TRS для приложения Rational Engineering Lifecycle Manager
В случае
новой установки нет данных для индексирования. Можно создать
пример проекта и продукта, чтобы убедиться в успешном
создании индекса.
- Откройте страницу администрирования Lifecycle Query
Engine https://имя-хоста-lqe:порт/lqe/web.
- Выберите Администрирование > Источники данных > Добавить источник данных.
- В окне Добавить источник данных выберите http://имя-хоста-relm:порт/productdef/resource/tracked_resource_set и добавьте метку RELM. Примите остальные значения по умолчанию
(если требуется проиндексировать большое количество данных, увеличьте
число нитей для начальной индексации до 4) и нажмите кнопку Готово.
- Для тестирования индекса откройте Rational Engineering
Lifecycle Manager: https://имя-хоста-relm:порт/relm/web
- Выберите пример проекта. В меню Запросы выберите Общие запросы.
- Разверните узел Пример и выберите Все артефакты.
Вам может быть выдан запрос на предоставление прав всем приложениям, для которых
выполняется запрос. На странице Идентификация пользователя https://relm_host_name:port/lqe/web/auth
нажмите кнопку Идентифицировать напротив каждого приложения,
которое требуется опросить.
- В результате запроса будет указан созданный пример продукта.
Настройка TRS для пользователей Jazz Team Server
- Откройте страницу администрирования Lifecycle Query
Engine https://имя-хоста-lqe:порт/lqe/web.
- Выберите Администрирование > Источники данных > Добавить источник данных.
- В окне Добавить источник данных выберите http://имя-хоста:порт/jts/trsUsers и добавьте метку Пользователи. Оставьте без изменения остальные параметры по умолчанию и нажмите кнопку Готово.
Дальнейшие действия
После настройки приложений как поставщиков TRS
выполните действия, указанные в Запрос на тестирование или отладку,
чтобы проверить конфигурацию.