FAQ

Часто задаваемые вопросы по IBM Rational Jazz RTC

• Как можно связать обсуждение (поток комментариев) с конкретной версией артефакта, находящегося под версионным контролем, а не с заданием?
• В настройках RTC нет нужной мне опции для кастомизации процесса, но я читал, что это можно реализовать за счет модулей расширения. Как создать такой модуль?
• При изменении состояния задания нам нужно выбрать конкретного пользователя в качестве ответственного за данное задание. Сейчас соответствующее поле показывает весь список пользователей в системе, которых может быть очень много. Как можно ограничить показываемый список, чтобы в нём были только те пользователи, у которых есть права на изменение данного задания в его текущем состоянии?
• Как доставить наборы изменений с компонентами, изменения в которых не были возвращены (checked in) в RTC? Проблема в том, что не возвращённые в систему версионного контроля компоненты не включаются в наборы изменений.
• Как изменить сообщение на форме логина в Jazz Team Server 2.x?
• Как переместить изменения из одного набора изменений в RTC в другой набор изменений?
• В RTC некорректно отображаются данные в отчётах по заданиям (дефектам, задачам и т.п.) и не работает «проваливание» на исходные данные при нажатии на элементы диаграмм. Что делать?
• Для того чтобы корректно обрабатывался SSL-сертификат в Rational Team Concert, необходимо указывать адрес сервера в «соединении к хранилищу» в виде «jazzserver.company.com»(FQDN-имя). Но если просто поменять строку в свойствах соединения, то вернется короткое имя — jazzserver:9443. Это связано с тем, что Team Concert хранит алиасы этого имени и при их вводе сбрасывает на «главный» адрес. Как с этим бороться?
• Как настроить Single Sign On (SSO) для среды, в которой используются и web-клиент, и Eclipse-клиент RTC?
• Как можно управлять сборкой из RTC 3.0.1?
• Поддерживает ли Jazz Team Build только Ant?
• Можно ли запускать Jazz Build Engine (JBE) как сервис в Windows?
• Можно ли запускать JBE как сервис в Linux?
• Как выглядит модель версионного контроля в RTC?
• Я привык к CVS/SVN, так что мне понятно, что такое checkout и update, а что означают load, unload, accept, и deliver?
• Я загрузил/принял изменения и потерял свои собственные изменения, которые не успел пропустить через операцию Check-In. Как мне теперь их вернуть?
• Как откатить компонент в рабочей области или потоке к известному прошлому состоянию?
• Как передавать изменения между двумя серверами, например, при распределенной работе?
• Неполная локализация в тонком клиенте для RTC. Названия типов ссылок отображаются на английском, вместо русских названий.

Как можно связать обсуждение (поток комментариев) с конкретной версией артефакта, находящегося под версионным контролем, а не с заданием?

Ответ 1: Напрямую — никак. Обсуждения ведутся в контексте заданий. Разумеется, наборы изменений, как и артефакты, могут быть привязаны к заданию, и тогда обсуждение будет опосредованно относиться и к ним тоже.

В настройках RTC нет нужной мне опции для кастомизации процесса, но я читал, что это можно реализовать за счет модулей расширения. Как создать такой модуль?

Ответ 2: Об этом можно почитать и посмотреть примеры здесь: https://jazz.net/library/article/634

При изменении состояния задания нам нужно выбрать конкретного пользователя в качестве ответственного за данное задание. Сейчас соответствующее поле показывает весь список пользователей в системе, которых может быть очень много. Как можно ограничить показываемый список, чтобы в нём были только те пользователи, у которых есть права на изменение данного задания в его текущем состоянии?

Ответ 3: Для этого можно воспользоваться настраиваемыми ролевыми группами, как описано здесь: https://jazz.net/wiki/bin/view/Main/AttributeValueProviders#Role_Based_User_Provider

Как доставить наборы изменений с компонентами, изменения в которых не были возвращены (checked in) в RTC? Проблема в том, что не возвращённые в систему версионного контроля компоненты не включаются в наборы изменений.

Ответ 4: Чтобы обойти это ограничение, нужно проделать следующее:

• Открыть раздел «Изменения» в настройках:
  • Выбрать Window > Preferences в Eclipse-клиенте
    
  • Перейти к Team > Jazz Source Control > Changes.
  • Убедиться, что выбрана опция Prompt for confirmation when delivering with un-checked in changes.
    
• Доставить изменения
  • Выбрать набор изменений для доставки
  • После выбора набора изменений появится диалоговое окно с запросом подтверждения возврата изменений:
    
  • Нажать No.

В результате набор изменений с невозвращёнными компонентами будет доставлен.

Как изменить сообщение на форме логина в Jazz Team Server 2.x?

Ответ 5: Пусть нам необходимо вставить информационное сообщение «Внимание! В качестве логина пароля используйте стандартную доменную учетную запись». Для этого нужно:

• Найти файл приложения jazz.war, который был развернут на сервере приложений.
• Подходящим архиватором извлечь из этого файла и открыть в utf8-редакторе файл jazz.warWEB-INFeclipsepluginsnet.jazz.web.app.nl2_1.0.2.v201006021315. jarresourcesinternalnlsruLoginWidgetMessages.js.
• Изменить в нем строку: 'serverInfoWithRealm': "Для работы с сервером ${0} в ${1} необходимо указать ИД пользователя и пароль:", на нужную: 'serverInfoWithRealm': " Внимание! В качестве логина пароля используйте стандартную доменную учетную запись".
• Снова запаковать файл LoginWidgetMessages.js в jazz.war.
• Заново развернуть обновлённый jazz.war на сервере приложений.

Как переместить изменения из одного набора изменений в RTC в другой набор изменений?

Ответ 6: Это возможно до того момента, когда произошла доставка набора изменений в хранилище. Для этого:

• В окне «Отложенные изменения» выберите папку «Исходящие», содержащую файлы или папку, которые необходимо переместить.
• Щёлкните правой кнопкой мыши на файл или папку и выберите Переместить > Новый набор изменений.

В RTC некорректно отображаются данные в отчётах по заданиям (дефектам, задачам и т.п.) и не работает «проваливание» на исходные данные при нажатии на элементы диаграмм. Что делать?

Ответ 7: Вероятно, в идентификаторах атрибутов заданий используются русские или другие, но не латинские буквы. Попробуйте для всех идентификаторов использовать только латиницу.

Для того чтобы корректно обрабатывался SSL-сертификат в Rational Team Concert, необходимо указывать адрес сервера в «соединении к хранилищу» в виде «jazzserver.company.com»(FQDN-имя). Но если просто поменять строку в свойствах соединения, то вернется короткое имя — jazzserver:9443. Это связано с тем, что Team Concert хранит алиасы этого имени и при их вводе сбрасывает на «главный» адрес. Как с этим бороться?

Ответ 8: Необходимо поменять «главный» адрес. Чтобы сделать это, не пересоздавая workspace в Eclipse, нужно:

• Закрыть клиент и найти в workspace Eclipse (тот путь, который клиент показывает при запуске) файл: <Путь к workspace Eclipse>.metadata.pluginsorg.eclipse.core.runtime.settingscom.ibm.team.process.rcp.ui.prefs
• Найти в нем строчку вида repositories/X/uri=https://jazzserver:9443/jazz/, где X - целое число (порядковый номер соединения), обычно 0 или 1
• Заменить ее на repositories/X/uri=https://jazzserver.company.com:9443/jazz/
• Запустить клиент Team Concert. Необходимо будет один раз ввести пароль, но сертификат теперь будет приниматься корректно.

Как настроить Single Sign On (SSO) для среды, в которой используются и web-клиент, и Eclipse-клиент RTC?

Ответ 9: К сожалению, пока не реализована поддержка протокола SPNEGO в Eclipse-клиенте, включение SSO для web-клиента приводит к невозможности работы через Eclipse-клиент.

Как можно управлять сборкой из RTC 3.0.1?

Ответ 10: Существуют два основных способа управления сборкой: использование Jazz Team Build (для относительно простых сборочных стендов) или Build Forge (для сложных гетерогенных сборочных сред). Хорошее обзорное описание работы с Jazz Team Build для пользователей можно найти в Jazz Tutorial в разделе «Using Jazz Build». О настройке сборок можно прочитать в статье «Getting Started with setting up Jazz Builds». Дополнительную информацию см. в разделе справки (в Eclipse-клиенте): «Managing Change and Releases / Building with Jazz Team Build». Если вы используете Ant, изучите задания Ant, включённые в Ant build toolkit, как описано в подразделе «Jazz build Ant task reference». Также справочные материалы доступны в режиме online по следующим адресам:

• Online help documentation (Rational Team Concert 3.0.1)
• Online help documentation (Rational Team Concert 3.0)
• Online help documentation (Rational Team Concert 2.0.0.2)
• Online help documentation (Rational Team Concert 1.0.1)

С общим видом архитектуры Jazz Team Build можно ознакомиться в этой статье. Подробности о запросе сборок (вручную или по расписанию) см. эту статью. У Rational Build Forge есть механизм интеграции с RTC, позволяющий запрашивать сборки в Build Forge из RTC и видеть из результаты в RTC в точности так же, как обычные сборки Jazz Team Build. Детальный обзор интеграции (для RTC 3.0) см. в статье «Enterprise Build Solutions with Build Forge and Rational Team Concert 3.0», краткий обзор — в статье «Rational Team Concert 3.0 and Build Forge: An integration scenario». Другие ресурсы по Build Forge можно найти в разделе Rational Build Forge.

Поддерживает ли Jazz Team Build только Ant?

Ответ 11: Нет, не только. Сборочный компонент весьма открыт и поддерживает множество технологий сборки. В стандартной комплектации Jazz Team Build включает поддержку Ant, Maven и сборки с командной строки. Ant build toolkit включает дополнительную поддержку Ant. Другие скриптовые технологии могут использовать Ant как инструмент командной строки, чтобы воспользоваться этой поддержкой. Пример запуска сборки на основе makefile, но с применением заданий Ant для сообщения хода и результатов сборки в RTC см. в разделе CppBuild, а прочие примеры — в BuildExamples.

Можно ли запускать Jazz Build Engine (JBE) как сервис в Windows?

Ответ 12: Да, см. JbeAsAWindowsService.

Можно ли запускать JBE как сервис в Linux?

Ответ 13: Да, см. JbeAsALinuxService.

Как выглядит модель версионного контроля в RTC?

Ответ 14: Общая картина выглядит так:

Здесь и далее мы будем использовать англоязычные термины, как наиболее устоявшиеся и понятные IT-сообществу.

Представленная диаграмма показывает ,как связаны артефакты версионного контроля между собой. Пунктирные линии обозначают Repository Workspace и Stream. Ресурсы, представленные этими двумя объектами, обычно со временем меняются. С другой стороны, Snapshot в некотором смысле похож на замороженное состояние Repository Workspace или Stream. Как таковой он обозначен жирной линией.

• Объекты Component, Baseline и Change Set могут перетекать между Repository Workspace и Stream через операции Accept, Deliver, Replace with, Replace in
• Repository Workspace обычно загружается в Sandbox. По умолчанию в качестве Sandbox выступает Eclipse Workspace.
• Ресурсы в sandbox могут создаваться, меняться или переделываться через клиентское IDE или другие совместимые редакторы.
• Добавленные, изменённые или переименованные ресурсы затем могут быть сохранены (или удалены) в Repository Workspace при помощи операции check-in в Change Set, принадлежащий конкретному Component в Repository Workspace. Проекты Eclipse или другие папки верхнего уровня, к которым не применена операция share, не отслеживаются версионным контролем. После применения к ним операции share последующие изменения внутри этих папок могут также пройти через check-in.
• Change Set описывает один или несколько ресурсов, которые были добавлены, изменены, переименованы, перемещены или удалены. Обычно Change Set ассоциирован с Work Item, который описывает, зачем эти изменения сделаны.
• И Repository Workspace, и Stream, и Snapshot представляют список компонентов в определённом состоянии (конфигурацию). Во всех трёх случаях можно перемещаться между файлами и папками, которые они представляют, при помощи команды Show Repository Files.
  • Snapshot представляет замороженное состояние, поэтому операции вроде Suspend, Discard, Resume, Accept, Deliver, Show History к нему не применимы. Зато можно создать Repository Workspace или Stream из Snapshot.
  • Repository Workspace представляет ресурсы из нескольких компонент, которые обычно загружены на машину разработчика. При помощи операций Suspend, Discard, Resume, Accept, Deliver можно настроить Repository Workspace на желаемую конфигурацию, откатившись назад во времени или накатив Change Set в или из другого Stream.
  • Stream подобен Repository Workspace. В то время как Repository Workspace принадлежит и используется одним разработчиком, несколько разработчиков будут вносить (при помощи операций accept, deliver) изменения в один и тот же Stream в ходе совместной работы. Stream нельзя загрузить напрямую, вместо этого необходимо создать новую Repository Workspace из этого Stream.
  • Repository Workspace, Stream, Snapshot могут быть сопоставлены друг другу в любом сочетании.
• Когда Repository Workspace или Stream представляют некое полезное состояние (например, после вехи, релиза или протестированной компоновки), бывает удобно зафиксировать такое состояние созданием нового Snapshot. Это даёт возможность создать новые Repository Workspace или Stream из Snapshot, например, для возврата к старой компоновке. Операция Show Snapshots позволяет легко увидеть Snapshots, принадлежащие Repository Workspace или Stream.
• Состояние конкретного Component в Repository Workspace или Stream может быть сохранено в Baseline. Затем можно очень легко извлечь другую Baseline в Repository Workspace или Stream при помощи операций Replace with и Replace in. Snapshot как таковой заморожен и представляет неизменяемый список Baselines, которые, в свою очередь, отображают компоненты в определённом состоянии.

Подробнее см. Getting started with Jazz Source Control.

Я привык к CVS/SVN, так что мне понятно, что такое checkout и update, а что означают load, unload, accept, и deliver?

Ответ 15: И CVS, и Subversion используют термины checkout, commit и update. В CVS/SVN:

• checkout загружает содержимое ветви на локальный компьютер,
• commit загружает изменения в ветвь и делает их доступными остальным, а
• update загружает последние изменения ветви на локальный компьютер.

В Jazz операция Load эквивалентна checkout: она загружает содержимое Repository Workspace на локальный компьютер. Когда вы хотите удалить локальную рабочую область со своего компьютера, вы используете операцию Unload. Это аналогично удалению локальных папок, находящихся под версионным контролем CVS или Subversion.

Операция Check-In в Jazz загружает все изменения в вашей локальной рабочей области в ваш Repository Workspace. Изменения добавляются только в Repository Workspace, так что остальная ваша команда о них не узнает. Ни в CVS, ни в Subversion нет похожей операции.

Операция Deliver добавляет Change Set из вашего Repository Workspace к Stream. Тогда Change Set становится доступным для всей вашей команды. Если вы привычны к CVS/SVN, то можете воспринимать эту операцию как commit.

Операция Accept очень похожа на update в CVS/SVN. Она вставляет новые Change Sets из Stream в ваш Repository Workspace и обновляет вашу локальную рабочую область. Имейте в виду, что если вы примете изменения в Repository Workspace, к которой не была применена операция Load, то изменения будут добавлены только к Repository Workspace. Вам эти изменения станут доступны после операции Load.

За дальнейшими терминологическими разъяснениями обратитесь к Jazz Platform Quick Reference.

Я загрузил/принял изменения и потерял свои собственные изменения, которые не успел пропустить через операцию Check-In. Как мне теперь их вернуть?

Ответ 16: Accept, suspend, resume и другие операции, манипулирующие файлами и папками в загруженной рабочей области на диске предлагают вам доставить сделанные изменения в репозиторий. Это всегда полезно делать. Иногда вы этого не делаете или вы загружаете локально свою Repository Workspace, в результате чего недоставленные изменения удаляются. Однако, вы можете их вернуть либо из локальной истории или из backup shed версионного контроля. Подробное объяснение см. в статье «Finding Lost Content».

Как откатить компонент в рабочей области или потоке к известному прошлому состоянию?

Ответ 17: Выберите этот компонент в редакторе рабочей области или потока (или в окне «Pending Changes») и запустите на нём команду «Replace with…». Вы можете выбрать базовую линию, представляющую прошлую конфигурацию компонента как в данной рабочей области, так и в другой рабочей области или потоке.

Как передавать изменения между двумя серверами, например, при распределенной работе?

Ответ 18: См. статью «Flow changes cross repositories with Rational Team Concert».

Неполная локализация в тонком клиенте для RTC. Названия типов ссылок отображаются на английском, вместо русских названий.

Ответ 19: Данная проблема может возникать, если ОС сервера приложений является английской. Необходимо убедиться, что пользователь, под которым запускаются серверные процессы Jazz имеет следующий параметр Java в окружении: -Duser.language=ru

Это можно сделать, настроив переменную окружения JAVA_OPTS=%JAVA_OPTS% -Duser.language=ru. Рекомендуется исправить настройки на уровне сервера приложений для корректной работы под любыми учетными записями.

Для Tomcat:

Необходимо исправить это в startup.bat или настроить сервер приложений через Tomcat5w.exe:

• Открыть директорию . servertomcatbin
• Запустить Tomcat5w.exe
• В разделе Java добавить строку вида: -Duser.language=ru

Настройки вступят в силу после рестарта сервиса.

Для Websphere:

• Зайти в консоль администрирования Websphere
• Перейти в настройки JVM сервера приложений: Управление Java и процессами > определение процессов > виртуальная машина Java.
• На вкладке Конфигурация в параметре Общие аргументы JVM добавить значение -Duser.language=ru

Настройки вступят в силу после рестарта профайла Websphere Application Server.