Обновление до уровня Rational Team Concert 2.0.0.2

В общем случае, обновить клиенты и серверы Rational Team Concert можно путем установки с помощью zip-файла или IBM® Installation Manager.
Прим.: Если вы решили воспользоваться IBM Installation Manager для установки Rational Team Concert 2.0.0.2 на компьютере, на котором Rational Team Concert в данный момент отсутствует, то Installation Manager предложит вам выбрать языки для установки. Однако, если вы обновляете предыдущую версию до уровня 2.0.0.2, то IBM Installation Manager предполагает, что вы хотите использовать текущие языки, и не предлагает вам выбрать языки. Для выбора дополнительных языков, после обновления до версии 2.0.0.2, выберите Изменить в главном меню IBM Installation Manager, затем выберите предложение. В следующем меню будет показан список поддерживаемых языков. Выберите необходимые значения.
Если вы запустите Jazz Team Server после обновления до версии 2.0.0.2 и до выбора опции Изменить для добавления или удаления языков, то вы должны сбросить сервер следующим образом:
  1. В веб-браузере откройте
    https://<хост_сервера>:<порт_jazz>/jazz/admin?internal#action=com.ibm.team.repository.admin.serverReset 
  2. Нажмите Запросить сброс сервера.
  3. Завершите работу сервера.

Затем вы можете выбрать Изменить в IBM Installation Manager, чтобы добавить или удалить языки.

Совместимость клиентов и серверов Rational Team Concert

В следующей таблице указана информация о совместимости версий клиентов Rational Team Concert с версиями Jazz Team Server.
Табл. 1. Совместимость клиентов и серверов
Версия Rational Team Concert Client Совместимая версия Jazz Team Server
1.0.x для Eclipse 0.6.x
2.0.x для Eclipse 1.0.x
2.0.0.0 для Microsoft® Visual Studio 1.0.0.0
2.0.x для Microsoft Visual Studio 1.0.x

Обновление Rational Team Concert Client для Eclipse IDE

Если в системе установлены версии 1.0, 1.0.1 или 1.0.1.1 Client для Eclipse IDE, то необходимо получить клиент версии 2.0.x для подключения к новому серверу версии 2.0.x. Его можно установить с помощью zip-файла, либо обновить предыдущие установки IBM Installation Manager.

Установка Rational Team Concert Client для Microsoft Visual Studio IDE

Если в системе установлена версия 1.0.1.1 Client для Microsoft Visual Studio IDE, то необходимо получить клиент версии 2.0.x для подключения к новому серверу версии 2.0.x.
Напоминание: Файл .zip не предоставляется для Client для Microsoft Visual Studio. Для установки или обновления версии 2.0.x необходимо воспользоваться IBM Installation Manager.

Обновление сервера с пробного или предварительного выпуска до постоянного выпуска

Если в системе установлен предварительный выпуск Rational Team Concert, то сначала необходимо обновить до пробного выпуска 2.0.0.2.

От пробного выпуска 2.0.0.2 вы можете перейти к постоянному выпуску сервера, приобретя и установив Комплект активации сервера для вашего издания, который доступен на веб-сайте http://www.ibm.com/software/awdtools/rtc/. Комплект активации состоит из файла JAR, содержащего ключ постоянного сервера. Он устанавливается с помощью страницы Управление ключом лицензии административного веб-интерфейса сервера.

Обновление сервера с версии 1.0, 1.0.1, 1.0.1.1 или 2.0

Вы можете обновить напрямую до выпуска 2.0.0.2 Rational Team Concert с предыдущих выпусков. Для обновления версии 1.x до версии 2.x необходимо выполнить миграцию базы данных. Инструкции по выполнению миграции базы данных приведены в разделах Миграция хранилища Jazz после обновления Jazz Team Server.

Прим.: Прежде чем приступить к миграции WebSphere Application Server, сбросьте сервер, перейдя к https://{имя_сервера}:9443/jazz/admin#action=com.ibm.team.repository.admin.serverReset и нажав Запросить сброс сервера.

Если вы установили предыдущий выпуск из zip-файла, то новая установка не пересекается с предыдущей. Вы можете установить выпуск 2.0.0.2 из zip-файла в новом расположении или воспользоваться IBM Installation Manager для установки экземпляра 2.0.0.2.

Если вы использовали IBM Installation Manager для установки предыдущего выпуска, то вы можете либо установить 2.0.0.2 в качестве отдельного экземпляра, либо обновить предыдущий экземпляр до уровня 2.0.0.2. Если вы установили отдельный экземпляр сервера для выпуска 2.0.0.2, то выберите Создать новую группу пакетов на странице Установить пакеты мастера установки.

Прим.: Для обновления развертывания WebSphere Application Server продукта Jazz Team Server удалите предыдущий файл jazz.war и разверните файл 2.0.0.2.

Для завершения обновления обратитесь к разделам Копирование необходимых файлов конфигурации из предыдущей установки сервера и Установка ключей активации 2.0.0.2.

Обновление сервера с одного издания Rational Team Concert до другого

Обновление можно выполнять и между изданиями Rational Team Concert. Типичное обновление заключается в переходе от Express-C к Express, или от Express к Standard. С помощью той же процедуры можно также перейти к предыдущей версии в обратном направлении.

Так как все издания Rational Team Concert 2.0.0.2 поддерживают базы данных Derby, то переходить от Derby к DB2 или Oracle не нужно, если вы переходите от Express-C к Express или Standard. В этом случае рекомендуется сначала обновить издание сервера, убедиться, что он совместим с существующей базой данных, а затем обновить базу данных, если это необходимо. Учтите, что база данных Derby поддерживает лишь 10 пользователей. Инструкции по выполнению миграции базы данных приведены в разделах Миграция хранилища Jazz после обновления Jazz Team Server .

Если вы установили издание Rational Team Concert 2.0.0.2 и хотите перейти к другому изданию, загрузите и установите новое издание, вместе с существующим изданием, а затем скопируйте файлы конфигурации, необходимые для нового издания. В приведенном ниже разделе описаны необходимые файлы конфигурации.

Если вы установили предыдущее издание из zip-файла, то пересечения с предыдущей установкой нет. Новое издание можно установить из файла zip в новом расположении, либо выполнить установку с помощью IBM Installation Manager. Для рабочих серверов рекомендуется воспользоваться IBM Installation Manager, чтобы сделать возможным применение будущих обновлений.

Если вы выполняли предыдущую установку сервера с помощью IBM Installation Manager и хотите установить новое издание также с помощью IBM Installation Manager, то во время новой установки Installation Manager не перекрывайте предыдущее издание. На странице Установить пакеты мастера установки выберите Создать новую группу пакетов.

Это приведет к установке нового издания в другом каталоге и созданию ярлыков программ с использованием имени новой группы пакетов.

Если вы не выполните эту задачу, то установка выполнена не будет из-за конфликта файлов. На это укажет окно сообщения об ошибке, озаглавленное Установка не выполнена; оно будет содержать следующий текст:
Установка не выполнена.
  Ошибка на этапе "установки":
    Распаковать стандартный zip-файл 1.0.1.I20081018-1820 не удалось. Файл
    D:\JazzTeamServer\server\license-update-site\site.xml уже существует.

Этой сбой не фатален; установку можно начать заново, правильно создав новую группу пакетов.

Обновления конфигурации WebSphere Application Server

Для правильной настройки WebSphere Application Server в Rational Team Concert 2.0.0.2 необходимо выполнить следующие действия.
  1. Убедитесь, что установлены последние версии пакетов исправлений для WAS и WASDK. В случае развертывания в WAS 7.0 важно, чтобы был установлен по крайней мере WebSphere Application Server 7.0.0.3.
  2. Удалите старые настраиваемые свойства JVM:
    1. com.ibm.team.repository.provision.profile
    2. com.ibm.team.server.configURL
    3. log4j.configuration
  3. Добавьте новое настраиваемое свойство JVM JAZZ_HOME и задайте для него следующее значение:
    file:///<установочный_каталог_Jazz>/server/conf 
  4. Параметр защиты WAS "Использовать доступные данные идентификации при доступе к незащищенному URI" должен быть выбран. Если используется WAS Integrated Solutions Console, это можно сделать следующим образом:
    1. Перейдите в Защита -> Защита администрирования, приложений и инфраструктуры -> Защита Веб - Общие параметры.
    2. Включите переключатель для "Использовать доступные данные идентификации при доступе к незащищенному URI".

Копирование необходимых файлов конфигурации из предыдущей установки сервера

Скопируйте следующие файлы из исходного сервера в целевой. Прежде всего, переименуйте исходные файлы в установке обновленного сервера, чтобы создать резервные копии. Если вы применяли IBM Installation Manager для обновления 1.0, 1.0.1, 1.0.1.1 или 2.0 до уровня 2.0.0.2, то в подкаталоге сервера в установочном каталоге был создан резервный каталог, содержащий файлы конфигурации 1.0.x или 2.0, с именем в формате backup-config-системное_время.

Если вы переходите к изданию Standard или Enterprise и приобрели Developer Client Activation Kit для Express, то приобретите и установите Developer Client Activation Kit для издания Standard или Enterprise, чтобы вы могли использовать соответствующие лицензии на клиент. Ваши назначения лицензий на Developer останутся в силе, но лицензии на Developer будут деактивированы до тех пор, пока не будет установлен правильный комплект активации.

Установка ключей активации 2.0.0.2

В выпуске 2.0.0.2 используются ключи активации 2.0.0.2. Если сервер обновляется с 1.0.x.x до 2.0.x, то он возвращается в режим пробной лицензии после обновления, и вам необходимо получить ключи активации 2.0 или 2.0.0.2 из IBM Rational License Key Center.

Дополнительная информация о IBM Rational License Key Center приведена на веб-сайте IBM Rational licensing support site и связанном разделе jazz.net Tech Tip.

Ниже приведены имена применимых ключей для каждого комплекта:

  • IBM Rational Team Concert Express Edition Server Activation Kit версии 2.0, 2.0.0.2
  • IBM Rational Team Concert Standard Edition Server Activation Kit версии 2.0, 2.0.0.2
  • IBM Rational Team Concert Enterprise Edition Server Activation Kit версии 2.0, 2.0.0.2
  • IBM Rational Team Concert Contributor Client Access Activation Kit версии 2.0, 2.0.0.2
  • IBMRational Team Concert Developer Client Access Activation Kit версии 2.0, 2.0.0.2
  • IBM Rational Team Concert Express Edition Developer Client Access Activation Kit версии 2.0, 2.0.0.2
  • IBM Rational Team Concert Floating Contributor Client Access Activation Kit версии 2.0, 2.0.0.2
  • IBM Rational Team Concert Floating Developer Client Access Activation Kit версии 2.0, 2.0.0.2

Настройка графика проекта

В Rational Team Concert 1.x у проектов могло быть несколько графиков (ранее называвшихся "направлениями разработки"), и все эти графики считались равнозначными.

В Rational Team Concert 2.0 у проектов, как и раньше, может быть несколько графиков, но один из них можно отметить в качестве "графика проекта". При переносе базы данных в 2.0 основной график проекта неизвестен, поэтому в ваших проектах график задан не будет. Вы можете вручную обновить проекты, чтобы задать график проекта, после обновления до уровня 2.0

Настройка моментальной копии Source Control Management

Моментальная копия Source Control Management (SCM) для Data Warehouse собирает данные в потоках, включая информацию о размере потоков и операциях (набор изменений и изменения файлов и папок) в них. В версии 1.0 эта моментальная копия автоматически собирала информацию обо всех потоках. Поскольку эта операция может оказаться весьма дорогостоящей, в версии 2.0 в моментальную копию SCM добавлены опции настраиваемости, позволяющие пользователям выбирать потоки, для которых следует собирать данные. Немедленный эффект от этого изменения заключается в том, что по умолчанию сбор данных вообще не выполняется, пока вы его не настроите.

Для настройки моментальной копии SCM выполните следующие действия:
  1. Убедитесь, что у вас есть права на запись к потоку, для которого вы хотите собрать данные.
  2. Перейдите к странице Отчеты в пользовательском веб-интерфейсе.
  3. В левой панели навигации выберите Управлять моментальной копией SCM. Появится список потоков.
  4. Отметьте переключатель для одного или нескольких потоков, а затем выберите Сохранить изменения.

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

Несовместимые изменения в отчетах BIRT

Если вы применяли проектировщик отчетов BIRT для создания собственных шаблонов отчетов, то при попытке использовать эти отчеты в версии 2.0 могут возникнуть неполадки. Ниже перечислены некоторые изменения, о которых вам необходимо знать:
  • Изменения в порядке обработки классов Java™ и JavaScript™. Если вы внесли в отчет BIRT код JavaScript, использующий оператор importPackage() для импорта пакета java.lang, то учтите, что нераскрытые ссылки на объект в коде, которые применялись для указания на класс Java, теперь могут указывать на класс JavaScript (и, как следствие, перестанут работать). Та же неполадка возможна и для других классов, имеющих одни и те же имена в JavaScript и Java, например java.util.Date. Для устранения неполадки раскройте ссылку на класс Java и удалите оператор importPackage().
  • Изменения в обработке наборов данных. В прошлом привязка элемента (например, метки) к наборам данных сама по себе вызывала обработку всего набора данных при активации элемента. Это было удобно, поскольку позволяло определить порядок обработки наборов данных путем указания привязанных к этим наборам (скрытых) меток. Теперь такая привязка вызовет обработку лишь первой строки набора данных. Для восстановления предыдущего поведения воспользуйтесь элементом Dynamic Text и вызовите какой-нибудь код JavaScript, который принудительно обрабатывает весь набор данных. Примером может служить Total.count().
  • Неполадки проектировщика отчетов BIRT могут привести к потере данных. Эти неполадки появляются, когда вы открываете файл проектирования отчета BIRT, созданный в версии BIRT 2.2.2 (т.е. RTC 1.0), в проектировщике отчетов BIRT 2.3.2 (т.е. RTC 2.0). Известные следующие неполадки:
    • При первом редактировании набора данных в версии BIRT 2.3.2, на странице "Параметры" могут быть утеряны поля "Значение по умолчанию" и "Параметр отчета". Обойти эту неполадку можно путем повторного ввода значений или копирования и вставки значений из предыдущей версии редактора. После сохранения файла с новыми введенными значениями неполадка исчезнет.
    • При первом редактировании файла проектирования отчета в версии BIRT 2.3.2 может быть утеряно значение по умолчанию для параметров отчета. Эта неполадка может также возникнуть после предыдущей описанной неполадки. Обойти эту неполадку можно путем повторного ввода значений или копирования и вставки значений из предыдущей версии редактора. После сохранения файла с новыми введенными значениями неполадка исчезнет.

    Будучи незамеченными, эти неполадки могут оказаться очень серьезными, поскольку могут нарушать правильность сбора данных для отчета. Рекомендуется проверять каждый набор данных и каждый параметр отчета при первом редактировании отчета в проектировщике отчетов BIRT 2.3.2. В новых отчетах, создаваемых с помощью инструментов BIRT 2.3.2, эти неполадки не возникают.

    Описанные выше изменения происходят во всех готовых отчетах Rational Team Concert 2.0 - с вашей стороны никаких действий не требуется. Однако, если вы вручную создали шаблон отчетов в области проектов с помощью готовых отчетов, но не указали подходящий идентификатор (согласованный с применяемым форматом), то шаблон отчетов не будет обновлен при миграции. Это означает, что содержимое станет устаревшим и не будет работать. В этом случае вы должны загрузить новое содержимое для такого шаблона с помощью подходящего файла .rptdesign.

Импорт данных для заданий в хранилище данных

В Rational Team Concert 2.0 в таблицы заданий в хранилище данных внесены несколько изменений, относящихся к схемам. Вследствие этого, при переходе от 1.0 к 2.0 программа импорта будет игнорировать все внесенные в хранилище данные для заданий. В результате, при первом запуске сервера 2.0 отчеты для заданий могут работать неправильно. Для обхода этой неполадки дождитесь первого запуска моментальной копии заданий или вручную запустите ее после запуска сервера. При первом запуске после миграции моментальная копия заданий восстановит всю хронологическую информацию о заданиях в хранилище данных. Это также означает, что первое после миграции создание моментальной копии займет значительно больше времени, чем среднее ночное выполнение этой процедуры.

Обнаружение новых отчетов

В Rational Team Concert 2.0 добавлено несколько новых отчетов. Хотя эти отчеты присутствуют в новых шаблонах процессов, которые поставляются вместе с продуктом, они не добавляются автоматически в существующие области проектов при миграции. В последнюю версию добавлено новое действие, которое поможет обнаружить и развернуть эти новые шаблоны отчетов в существующих областях проектов после миграции. Для развертывания новых шаблонов отчетов выполните следующие действия:
  1. В расширенном клиенте откройте панель Артефакты коллектива.
  2. Разверните область проекта и выберите Отчеты.
  3. Щелкните правой кнопкой мыши на Шаблоны отчетов и выберите Развернуть новые шаблоны.

Окно диалога поможет вам обнаружить шаблоны отчетов, которые доступны, но пока не развернуты в области проекта. Вы можете выбрать один или несколько из них, и они будут созданы. Созданные отчеты можно будет взять за основу при создании новых отчетов с помощью меню.

Пользовательские значения

Изменения, которые вы внесли в типы заданий, атрибуты, роли и обработчики событий, сохраняются при переходе от 1.x к 2.0. Если вы настроили предопределенный шаблон процессов (такой как Scrum), то учтите, что при повторном развертывании предопределенного шаблона (в панели Шаблоны процессов) пользовательские значения будут заменены. Если вам необходимо заново развернуть предопределенный шаблон, то вы должны сначала изменить имя и ИД настроенного предопределенного шаблона, чтобы он не был заменен.


Комментарии