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

Для обновления 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. Настройте сервер приложений.
    1. Убедитесь, что старый сервер запущен.
    2. Создайте резервную копию профайла WebSphere Application Server.
      1. Откройте командную строку и перейдите в папку bin каталога установки WebSphere Application Server.
      2. Выполните эту команду. При включенной защите WebSphere Application Server укажите имя пользователя и пароль.
        Совет: Каталог сжатого файла необходимо создать перед запуском процесса резервного копирования.
        • Linux
          backupConfig.sh <
          путь-к-новому-сжатому-файлу-для-создания-резервной-копии-профайла> -username <
          основной-администратор-WAS> -password <пароль-администратора-WAS>
          Пример:
          backupConfig.sh /root/WAS_backup/relm_50_profile.zip -username <
          администратор-WAS> -password <пароль-администратора-WAS>
        • Windows
          backupConfig.bat <путь-к-новому-сжатому-файлу-для-создания-резервной-копии-профайла> -username <основной-администратор-WAS> -password <пароль-администратора-WAS>
          Пример:
          backupConfig.bat C:\WAS_backup\relm_50_profile.zip -username <администратор-WAS> -password <пароль-администратора-WAS>
      Эта команда завершает работу сервера перед запуском процесса резервного копирования.
    3. Удалите существующие приложения из WebSphere Application Server.
      1. Запустите сервер.
      2. Войдите в WebSphere Application Server Integrated Solutions Console по адресу https://имя-хоста:9043/ibm/console/logon.jsp
      3. Выберите Приложения > Типы приложений > Приложения предприятия WebSphere.
      4. Остановите и удалите следующие приложения: relm.war, relmhelp.war, vvc.war, lqe.war, SPARQL_Gateway.war.
      5. После приглашения сохраните изменения в основной конфигурации.
    4. Обновите пользовательские свойства JAZZ_HOME и log4j.configuration.
      1. Войдите в WebSphere Application Server Integrated Solutions Console по адресу https://имя-хоста:9043/ibm/console/logon.jsp.
      2. Выберите Серверы > Типы серверов > Серверы приложений WebSphere.
      3. Щелкните на имени сервера для его открытия. Имя сервера по умолчанию - server1.
      4. В разделе Инфраструктура сервера выберите Java и управление процессами > Определение процесса.
      5. Под заголовком Дополнительные свойства выберите Виртуальная машина Java.
      6. Измените пути Lifecycle Query Engine и Jazz Reporting Service для указания новых расположений.
      7. Найдите текстовое поле Стандартные аргументы JVM и добавьте следующую переменную среды в процедуру запуска JVM:

        -Dlqe.config.location=file://drive:/установочный-каталог-lqe/server/conf/lqe

      8. В разделе Дополнительные свойства выберите Пользовательские свойства.
      9. Выберите JAZZ_HOME и укажите значение file:///<установочный-каталог-новой-версии>/server/conf.

        Пример: file:///C:/PROGRA~2/IBM/JazzTeamServer_5.0.1/server/conf.

      10. Выберите log4j.configuration и укажите значение file:///<установочный-каталог-новой-версии>/server/conf/startup_log4j.properties.

        Пример: file:///C:/PROGRA~2/IBM/JazzTeamServer_5.0.1/server/conf/startup.log4j.properties.

      11. При подключении к базе данных Oracle убедитесь, что ORACLE_JDBC_DRIVER_FILE указывает на правильный файл драйвера JDBC.
      12. После приглашения сохраните изменения в основной конфигурации.
    5. Укажите общую библиотеку Jazz Reporting Service.
      1. В административной консоли выберите Среда > Общие библиотеки.
      2. В списке выберите Общая библиотека JRS.
      3. Вместо пути к классам существующего экземпляра Jazz Reporting Service укажите новое расположение.

        Пример: установочный-каталог-5.0.1/server/conf/SPARQL_Gateway/SharedLibrary

      4. В разделе Загрузка классов включите переключатель Использование загрузчика изолированных классов для общей библиотеки. Нажмите Применить и Сохранить.
    6. Остановите WebSphere Application Server.
      • Linux Выполните команду stopServer.sh.
      • Windows Выполните команду stopServer.bat.
    7. Очистите каталоги temp WebSphere Application Server.

      Удалите связанное содержимое Rational Engineering Lifecycle Manager из каталогов wscache и temp в профайле. В зависимости от установленных ранее приложений в профайле существуют следующие каталоги, которые можно удалить: relm_war, lqe_war, sparql и связанные данные приложения Configuration Management.

      • Linux
        каталог-профайла-WAS/wscache (например,
        opt/IBM/WebSphere/AppServer/profiles/AppSrv01/temp/wscache)
        каталог-профайла-WAS/temp (например,
        opt/IBM/WebSphere/AppServer/profiles/AppSrv01/temp)
      • Windows
        каталог-профайла-WAS\wscache (например,
        C:\IBM\WebSphere\AppServer\profiles\AppSrv01\wscache)
        каталог-профайла-WAS\temp (например,
        C:\IBM\WebSphere\AppServer\profiles\AppSrv01\temp)
    8. Очистите каталог протоколов WebSphere Application Server.
      Перейдите к каждому серверу приложений и удалите связанные протоколы Rational Engineering Lifecycle Manager из каталога протоколов в профайле. Стандартный каталог протоколов:
      • Linux opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs
      • Windows C:\IBM\WebSphere\AppServer\profiles\AppSrv01\logs
    9. Запустите WebSphere Application Server.
      • Linux Выполните команду startServer.sh.
      • Windows Выполните команду startServer.bat.
  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
    • Для того чтобы пропустить обновление Tomcat, добавьте в сценарий vvc_upgrade следующий параметр:
      -oldApplicationHome oldRELMHome/server/conf -ignoreJTSVersionCheck -updateTomcatFiles=no
    Совет: Приложение 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. Разверните файлы relm.war, relmhelp.war, vvc.war, lqe.war и SPARQL_Gateway.war.
    1. В административной консоли WebSphere Application Server выберите Приложения > Типы приложений > Приложения предприятия WebSphere.
    2. На странице Приложения J2EE выберите Установить.
    3. В разделе Путь к новому приложению выберите файл $newRELMHome/server/webapps/relm.war и нажмите кнопку Открыть.
    4. Выберите Быстрый путь и нажмите кнопку Далее.
    5. Примите значения по умолчанию и нажмите кнопку Далее в мастере настройки. На странице Связать корневые контексты для веб-модулей укажите корневой контекст /relm. Затем нажмите кнопку Готово.
    6. Будет выдано сообщение об успешной установке relm.war. Выберите Сохранить напрямую в главной конфигурации.
    7. Установите документацию по Rational Engineering Lifecycle Manager (relmhelp.war). Выполните действия a-f, приведенные выше. Укажите путь $newRELMHome/server/webapps/relmhelp.war и корневой контекст /relmhelp.
    8. Установите приложение Configuration Management (vvc.war). Выполните действия a-f, приведенные выше. Укажите путь $newRELMHome/server/webapps/vvc.war и корневой контекст /vvc.
    9. Настройте сервер WebSphere Application Server для Lifecycle Query Engine и разверните файл lqe.war.
    10. Установите приложение Jazz Reporting Service (SPARQL_Gateway.war). Выполните действия a-f, приведенные выше. В качестве пути укажите следующее значение: $newRELMHome/server/webapps/SPARQL_Gateway.war. Кроме того, корневой контекст SPARQL_Gateway.
    11. Добавьте ссылку на библиотеку Jazz Reporting Service.
      1. Выберите Приложения > Типы приложений > Приложения J2EE для WebSphere, затем выберите SPARQL_Gateway_war в списке приложений.
      2. В разделе Ссылка выберите Ссылки на общие библиотеки.
      3. Включите переключатель SPARQL_Gateway_war и выберите Ссылка на общие библиотеки.
      4. Выберите Общая библиотека JRSи щелкните на стрелке вправо.
      5. Нажмите кнопку OK. Затем снова нажмите кнопку OK для сохранения параметров в главной конфигурации.
    12. Убедитесь, что порядок загрузки классов Jazz Reporting Service настроен правильным образом.
      1. Выберите Приложения > Типы приложений > Приложения J2EE для WebSphere, затем выберите SPARQL_Gateway_war в списке приложений.
      2. В разделе Подробные свойства выберите Загрузка классов и обнаружение обновления.
      3. В разделе Порядок загрузчиков классов выберите значение Вначале классы, загруженные локальным загрузчиком классов (а родительским - потом).
      4. Нажмите кнопку OK и выберите Сохранить в главной конфигурации.
    13. Перезапустите WebSphere Application Server.
  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. Перезапустите сервер приложений.
    • Linux Выполните команды stopServer.sh и startServer.sh.
    • Windows Выполните команды stopServer.bat и startServer.bat.
  16. Установите лицензии версии 5.0.1.

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

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

Результаты

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

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


Комментарии