Обновление Rational Engineering Lifecycle Manager, взаимодействующего с сервером Apache Tomcat

Для обновления Rational Engineering Lifecycle Manager установите новую версию продукта, обновите файлы конфигурации, добавьте или обновите таблицы в существующих хранилищах базы данных и выполните миграцию данных в версию 5.0.1.

Прежде чем начать

Процедура

  1. Установите Rational Engineering Lifecycle Manager.
    На этом шаге устанавливаются:
    • Rational Engineering Lifecycle Manager 5.0.1
    • Jazz Team Server 5.0.1
    • Приложение Configuration Management 5.0.1
    Важное замечание:
    • Выберите группу пакетов и каталог, отличные от исходной установки.
    • Выберите корневой контекст, совпадающий с корневым контекстом в предыдущем экземпляре.

      В случае обновления Rational Engineering Lifecycle Manager версии 5.0 и ниже применяется корневой контекст Jazz Reporting Service или SPARQL Gateway SPARQL_Gateway, а также имя файла приложения SPARQL_Gateway.war. В ходе установки Rational Engineering Lifecycle Manager 5.0.1 выберите пользовательский корневой контекст и введите SPARQL_Gateway в поле Значения корневого контекста приложения.

  2. Остановите старый сервер Tomcat.
  3. Выполните миграцию базы данных.
    Опция Описание
    Derby Удалите базы данных Derby, установленные при обновлении, и замените их файлами Derby из исходной установки.
    rm -rf $newRELMHome/server/conf/jts/derby/repositoryDB
    rm -rf $newRELMHome/server/conf/jts/indices
    rm -rf $newRELMHome/server/conf/relm/derby/repositoryDB
    rm -rf $newRELMHome/server/conf/vvc/derby/repositoryDB
    cp -R $oldRELMHome/server/conf/jts/derby/repositoryDB $newRELMHome/server/conf/jts/derby
    cp -R $oldRELMHome/server/conf/jts/indices $newRELMHome/server/conf/jts
    cp -R $oldRELMHome/server/conf/relm/derby/repositoryDB $newRELMHome/server/conf/relm/derby
    cp -R $oldRELMHome/server/conf/relm/indices $newRELMHome/server/conf/relm
    cp -R $oldRELMHome/server/conf/vvc/derby/repositoryDB $newRELMHome/server/conf/vvc/derby
    cp -R $oldRELMHome/server/conf/vvc/indices $newRELMHome/server/conf/vvc
    DB2 или Oracle Подробные инструкции приведены в документации, поставляемой производителем базы данных.
    Далее приведен пример процесса DB2, который можно использовать в качестве рекомендации.
    1. Убедитесь, что старый Jazz Team Server остановлен.
    2. В DB2 найдите базы данных, используемые в предыдущем экземпляре приложений Jazz Team Server.
    3. Создайте резервную копию каждой базы данных, используемой приложением Jazz Team Server.
    4. Сохраните изменения.
    Дополнительная информация по резервному копированию и восстановлению базы данных приведена в документации по Rational solution for Collaborative Lifecycle Management.
    SQL Server
    • Убедитесь, что заданы правильные имя пользователя и пароль.
    • Убедитесь, что перед началом процесса обновления была создана резервная копия базы данных.
    • Убедитесь, что применяется драйвер Java Database Connectivity (JDBC) sqljdbc4.jar. В версии 5.0.1 не поддерживается JRE версии 5.0. Поддерживаются только JRE 6.0 и 7.0.
    • Убедитесь, что служба SQL запущена.
    Подробные инструкции приведены в документации, поставляемой производителем базы данных.
    Oracle Убедитесь, что драйвер JDBC Oracle ojdbc.jar доступен в каталоге $newRELMHome/JazzTeamServer/server/oracle.
  4. Обновите приложение Configuration Management.
    Выполните сценарий vvc_upgrade для обновления файлов конфигурации и баз данных и перекомпоновки текстовых индексов. Пример параметров:
    cd $newRELMHome/server/
    upgrade/vvc/vvc_upgrade.sh -oldApplicationHome старый-каталог-RELM/server/conf
    • При обновлении распределенной топологии установки (несколько серверов) укажите в сценарий vvc_upgrade следующий параметр:
      -oldApplicationHome oldRELMHome/server/conf -ignoreJTSVersionCheck
    Совет: Приложение Configuration Management можно также установить с помощью Rhapsody Design Manager. Вместе с Rational Engineering Lifecycle Manager можно установить приложение Configuration Management - это удобно, если требуется установить приложение на сервере без Rhapsody Design Manager. Интегрируйте с Rational Engineering Lifecycle Manager только приложение Configuration Management. При выборе установки компонента на нескольких серверах убедитесь, что для установки и обновления выбран правильный компонент.
  5. Обновите Rational Engineering Lifecycle Manager.
    Выполните команду relm_upgrade.sh для обновления файлов конфигурации и баз данных и перекомпоновки текстовых индексов.
    $newRELMHome/server/upgrade/relm/relm_upgrade.sh -oldApplicationHome старый-каталог-RELM/server/conf
  6. Перенесите информацию о конфигурации Lifecycle Query Engine и существующего экземпляра Jazz Reporting Service или SPARQL Gateway в новую версию продукта.
    rm -rf $newRELMHome/server/conf/lqe
    cp -R $oldRELMHome/server/conf/lqe $newRELMHome/server/conf
    rm $newRELMHome/server/conf/SPARQL_Gateway/log4j.properties
    rm $newRELMHome/server/conf/SPARQL_Gateway/SPARQL_Gateway.properties
    rm -rf $newRELMHome/server/conf/SPARQL_Gateway/db
    cp -R $oldRELMHome/server/conf/SPARQL_Gateway $newRELMHome/server/conf/SPARQL_Gateway
    Убедитесь, что каталог $newRELMHome/server/conf/SPARQL_Gateway содержит подкаталоги db и WAS_SharedLibrary, а также файлы log4j.properties, app.properties и app_runtime.properties.
  7. Запустите сервер Apache Tomcat.
  8. Удалите свойство DBLocation из конфигурации Jazz Reporting Service.

    Если файл $newRELMHome/server/conf/SPARQL_Gateway/app.properties содержит строку DBLocation, удалите ее.

  9. Удалите существующий экземпляр Jazz Reporting Service или SPARQL Gateway из приложений, зарегистрированных на сервере Jazz Team Server.
    1. В браузере откройте страницу администрирования Jazz Team Server https://полное-имя-хоста-RELM:9443/jts/admin и нажмите кнопку Сервер. Затем выберите Зарегистрированные приложения.
    2. В списке приложений нажмите кнопку Удалить приложение Кнопка Удалить, чтобы удалить существующее приложение Jazz Reporting Service или SPARQL Gateway.
  10. Зарегистрируйте новую версию приложения Jazz Reporting Service на сервере Jazz Team Server.
    1. На странице администрирования Зарегистрированные приложения Jazz Team Server нажмите кнопку Добавить.
    2. Введите информацию о продукте Jazz Reporting Service и нажмите кнопку Готово.
      • Имя приложения: Jazz Reporting Service
      • URL обнаружения: https://полное-имя-хоста-RELM:9443/SPARQL_Gateway/scr
      • Пароль приемника: введите любое значение
      • Функциональный ИД пользователя: по умолчанию применяется значение jrs_user. Значение по умолчанию можно изменить.
  11. Настройте дружественные отношения между Jazz Reporting Service и Rational Engineering Lifecycle Manager.
    1. Удалите Jazz Reporting Service или SPARQL Gateway из списка исходящих дружественных серверов Rational Engineering Lifecycle Manager.
      1. Откройте консоль Rational Engineering Lifecycle Manager: https://хост-relm:порт/relm/admin
      2. В области Администрирование сервера выберите Связь > Друзья (исходящие).
      3. В списке друзей нажмите кнопку Удалить друга Кнопка Удалить.
    2. Настройте для Jazz Reporting Service дружественную исходящую связь с Rational(r) Engineering Lifecycle Manager.
  12. Настройте источник данных Jazz Reporting Service.
    1. Удалите источник данных Lifecycle Query Engine из Jazz Reporting Service.
      1. В браузере откройте страницу Настройка по следующему адресу: https://хост-relm:порт/SPARQL_Gateway/setup
      2. Выберите Источники данных в информационной строке продукта.
      3. В столбце Действия рядом с источником данных Lifecycle Query Engine щелкните на значке Действия, затем выберите Удалить источник данных.
    2. Добавьте Lifecycle Query Engine в качестве источника данных для Jazz Reporting Service.
  13. В случае обновления версии 4.x обновите Lifecycle Query Engine.

    Откройте страницу администрирования Lifecycle Query Engine: https://хост-relm:порт/lqe/web/admin. Будет выдано сообщение о том, что выполняется обновление Lifecycle Query Engine и приложение недоступно. Выберите Запустить обновление. После завершения процесса обновления открывается доступ к источникам данных.

  14. Обновите приложение Configuration Management.
    1. Убедитесь в существовании файла credentials.txt со следующим содержимым: adminUserId, adminPassword, repositoryURL, smartCard, certificateFile.

      Если файл не существует, создайте его. Пример файла идентификационных данных:

      adminUserId=yourAdminUserId
      adminPassword=yourAdminPassword 
      repositoryURL=https://yourserver.com:9443/vvc 
      smartCard=<none>
      certificateFile=<none>
    2. Выполните команду repotools-vvc из каталога установочный-каталог-приложения-настройки/server.
      • Linux./repotools-vvc.sh -vvc_online_migrationCommand credentialsFile=credentials.txt fromVersion=<previous_version> logPort=52000 logLevel=DEBUG
      • Windowsrepotools-vvc.bat -vvc_online_migrationCommand credentialsFile=credentials.txt fromVersion=<previous_version> logPort=52000 logLevel=DEBUG
    3. Перезапустите Jazz Team Server.
    Команда repotools приложения Configuration Management отправляет запрос активному приложению Configuration Management и ожидает ответ. Если команда repotools-vvc останавливается сразу с ошибкой авторизации, убедитесь, что сервер запущен и проверьте правильность ИД пользователя и пароля в файле идентификационных данных.
  15. Перезапустите сервер Tomcat.
  16. Установите лицензии версии 5.0.1.

    Дополнительная информация о лицензиях приведена в разделе Управление лицензиями.

  17. Перезапустите сервер Rational Engineering Lifecycle Manager для автоматического обновления перенесенных данных в формат новой версии приложения. Этот процесс называется интерактивным обновлением. Для того чтобы открыть страницу состояния обновления, войдите в систему.

Результаты

После успешного завершения интерактивного обновления веб-браузер обновляется и отображает начальную страницу Rational Engineering Lifecycle Manager. В случае сбоя шага обновления обратитесь к файлу relm.log для определения причины сбоя. Если в Rational Engineering Lifecycle Manager настроено большое число продуктов, то интерактивное обновление может занять до нескольких часов.

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


Комментарии