Обновление Rational Engineering Lifecycle Manager

Для обновления текущей версии Rational Engineering Lifecycle Manager до последней требуется выполнить одновременную установку этой новой версии.

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

При обновлении продуктов, интегрированных в Rational Engineering Lifecycle Manager, следуйте указаниям в Обновление стека продукта Rational Engineering Lifecycle Manager

Процедура

  1. Установите Rational Engineering Lifecycle Manager в соответствии с инструкциями в Установка Rational Engineering Lifecycle Manager и службы Lifecycle Query Engine. Будут установлены:
    • Rational Engineering Lifecycle Manager v4.0.6
    • Jazz Team Server v 4.0.6
    • Приложение Управление конфигурациями
    Важное замечание:
    • Убедитесь, что выбраны группа пакетов и каталог, отличные от исходной установки.
    • Убедитесь, что выбран корневой контекст, совпадающий с корневым контекстом в предыдущей установке.
  2. При использовании WebSphere Application Server выполните следующее.
    1. Создайте резервную копию профайла WebSphere Application Server. Откройте командную строку и перейдите в папку bin каталога установки WebSphere Application Server. Например C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\bin. Выполните следующую команду. Обратите внимание, что при включенной защите WebSphere Application Server необходимо также указать имя пользователя и пароль:
      backupConfig.bat <Путь к новому сжатому файлу для создания резервной копии профайла> <имя основного администратора WAS> <пароль администратора WAS>
      Пример: backupConfig.bat C:\WAS_backup\clm_40_profile.zip -username WAS admin -password WAS admin password.
    2. Удалите существующие приложения из WebSphere Application Server. Для удаления файлов war приложений на каждом сервере приложений выполните следующие действия.
      1. Войдите в WebSphere Application Server Integrated Solutions Console по адресу https://имя-хоста:9043/ibm/console/logon.jsp.
      2. Выберите Приложения > Типы приложений > Приложения Java EE WebSphere.
      3. Остановите и удалите следующие приложения: relm.war, vvc.war, lqe.war, SPARQL_Gateway.war
      4. После приглашения сохраните изменения в основной конфигурации.
    3. Обновите пользовательские свойства JAZZ_HOME и log4j.configuration.
      1. Войдите в WebSphere Application Server Integrated Solutions Console по адресу https://имя-хоста:9043/ibm/console/logon.jsp.
      2. Выберите Серверы > Типы серверов > Серверы WebSphere application server.
      3. Щелкните на имени сервера для его открытия. Имя сервера по умолчанию: server1.
      4. В разделе Инфраструктура сервера выберите Java и управление процессами > Определение процесса.
      5. В разделе Дополнительные свойства выберите Виртуальная машина Java.
      6. Измените пути Lifecycle Query Engine и SPARQL Gateway для указания новых расположений.
      7. В текстовом поле общих аргументов JVM добавьте следующую переменную среды для процесса запуска JVM: -Dlqe.config.location=file://drive:\папка-установки-lqe\server\conf\lqe
      8. В разделе Дополнительные свойства выберите Пользовательские свойства.
      9. Откройте JAZZ_HOME и измените значение на file:///4.0.6_install_dir/server/conf. Пример: file:///C:/PROGRA~2/IBM/JazzTeamServer_4.0.6/server/conf.
      10. Откройте log4j.configuration и измените значение на file:///4.0.6_install_dir/server/conf/startup_log4j.properties. Пример: file:///C:/PROGRA~2/IBM/JazzTeamServer_4.0.6/server/conf/startup.log4j.properties.
      11. При подключении к базе данных Oracle убедитесь, что ORACLE_JDBC_DRIVER_FILE указывает на правильный файл драйвера JDBC.
      12. После приглашения сохраните изменения в основной конфигурации.
    4. Остановите WebSphere Application Server.
    5. Очистите временные каталоги WebSphere Application Server. Для каждого сервера приложений удалите связанное содержимое Rational Engineering Lifecycle Manager из следующих каталогов wscache и temp в профайле. В зависимости от установленных ранее приложений в профайле существуют следующие каталоги, которые можно удалить: relm_war, lqe_war, sparql и связанные данные vvc.
      корневой-каталог-WAS\wscache (например C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\wscache)
      корневой-каталог-WAS\temp (например C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\temp)
    6. Очистите каталог протоколов. Перейдите к каждому серверу приложений и удалите связанные протоколы Rational Engineering Lifecycle Manager из каталога протоколов в профайле. Обычно каталог протоколов может располагаться в следующем каталоге: C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\logs
  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 найдите базы данных, используемые в предыдущей установке приложений JTS.
    3. Создайте резервную копию каждой базы данных, используемой приложением JTS.
    4. Щелкните правой кнопкой мыши на каждой базе данных и выберите Восстановить > Восстановить в новой базе данных.
    5. Введите имя для базы данных и выберите каталог, содержащий резервные копии.
    6. Откройте файл <JazzInstallDir>/server/conf/jts/teamserver.properties.
    7. Замените имя базы данных Jazz на указанное имя, как показано в следующем примере.
      #
      # DB2 configuration
      #
      
      # Comment out above lines, uncomment the following three lines and customize example location to use DB2
      #com.ibm.team.repository.db.vendor = DB2
      #com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:fullyMaterializeLobData=false;user=db2admin;password={password};
      #com.ibm.team.repository.db.jdbc.password=db2admin
    8. Повторите этапы d-g для каждой восстанавливаемой базы данных.
    9. Сохраните изменения.
  4. Обновите приложение Configuration Management с помощью сценария vvc_upgrade.bat. Будут обновлены файлы конфигурации, файлы баз данных и перекомпонованы текстовые индексы. Подробное описание обновления приложения Configuration Management приведено в руководстве по обновлению, доступном по адресу: Руководство по интерактивному обновлению Configuration Management. Пример параметров для Linux:
    cd $newRELMHome/server/
    upgrade/vvc/vvc_upgrade.sh -oldApplicationHome oldRELMHome/server/conf
    • При обновлении распределенной топологии установки (несколько систем) потребуется добавить в сценарий vvc_upgrade следующий параметр: -oldApplicationHome oldRELMHome/server/conf -ignoreJTSVersionCheck
    • Если используется WebSphere Application Server, необходимо добавить в сценарий vvc_upgrade параметр, запрещающий обновление Tomcat:-oldApplicationHome oldRELMHome/server/conf -ignoreJTSVersionCheck -updateTomcatFiles=no
    Прим.: Приложение Configuration Management можно также установить с помощью Rhapsody Design Manager. При установке Rational Engineering Lifecycle Manager будет предложена возможность установить приложение Configuration Management - это удобно, если требуется установить приложение в системе без Rhapsody Design Manager. Только одно из них должно быть интегрировано с Jazz Team Server. При выборе установки компонента в нескольких системах убедитесь, что при установке и обновлении компонента выбрано правильное приложение.
  5. Обновите Rational Engineering Lifecycle Manager путем запуска сценария relm_upgrade.sh
    $newRELMHome/server/upgrade/relm/relm_upgrade.sh -oldApplicationHome oldRELMHome/server/conf
    Будет выполнено три обновления. Сначала будут обновлены файлы конфигурации. Затем файлы базы данных. Затем будут перекомпонованы текстовые индексы.
    Прим.: Перед выполнением сценария обновления необходимо установить параметр предыдущей версии в сценарии relm_params. Описание этого параметра, а также другие доступные параметры, можно найти в разделе Справочник по сценарию relm_upgrade.
  6. Вся информация о конфигурации Lifecycle Query Engine и компоненте SPARQL Gateway должна быть перенесена в новую установку. Старые версии необходимо вручную скопировать в новый Jazz Team Server.
    rm -rf $newRELMHome/server/conf/lqe
    cp -R $oldRELMHome/server/conf/lqe $newRELMHome/server/conf/lqe
    rm -rf $newRELMHome/server/conf/SPARQL_Gateway
    cp -R $oldRELMHome/server/conf/SPARQL_Gateway $newRELMHome/server/conf/SPARQL_Gateway
  7. Измените свойства SPARQL Gateway и удалите свойство DBLocation. Удалите в следующем файле строку DBLocation: $newRELMHome/server/conf/SPARQL_Gateway/SPARQL_Gateway.properties
  8. Если используется Oracle, убедитесь, что драйвер JDBC Oracle ojdbc.jar доступен в следующем каталоге: $newRELMHome\JazzTeamServer\server\oracle
  9. При использовании WebSphere Application Server разверните файлы relm.war, vvc.war, lqe.war и sparql_gateway.war. Перезапустите WebSphere Application Server.
  10. Запустите Jazz Team Server.
  11. Откройте страницу администрирования LQE https://сервер:порт/lqe/web/admin. Будет выведено сообщение о том, что LQE находится в режиме обновления и в данный момент недоступна. Выберите Запустить обновление. После завершения этого процесса источники данных будут доступны.
  12. Убедитесь в существовании файла credentials.txt со следующим содержимым : adminUserId, adminPassword, repositoryURL, smartCard, certificateFile Если такого файла нет, создайте его. Например, файл идентификационных данных может выглядеть следующим образом:
    adminUserId=yourAdminUserId
    adminPassword=yourAdminPassword 
    repositoryURL=https://yourserver.com:9443/vvc 
    smartCard=<none>
    certificateFile=<none>
  13. Запустите из каталога каталог-установки-Configuration_Application/server следующую команду
    • Linux: ./repotools-vvc.sh -migration_vvc_updateResourcesCommand credentialsFile=credentials.txt
    • Windows: repotools-vvc.bat -migration_vvc_updateResourcesCommand credentialsFile=credentials.txt

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

После обновления любого обязательного программного обеспечения в Lifecycle Query Engine может потребоваться переиндексация его содержимого. В Lifecycle Query Engine версии 4.0.3 были добавлены новые словари, поэтому, если требуется, чтобы Rational Engineering Lifecycle Manager использовал данные из этих словарей, необходимо переиндексировать приложение.
Табл. 1. Обзор требований к переиндексации по продуктам
Продукт с v1.x до v4.0.6 с v4.0.3 до v4.0.6 с v4.0.4 до v4.0.6 с v4.0.5 до v4.0.6
Rational Team Concert Требуется переиндексация Переиндексация не требуется Переиндексация не требуется Переиндексация не требуется
Rational Quality Manager Требуется переиндексация Переиндексация рекомендуется. Во все ресурсы QM добавлено новое свойство oslc:shortld. Для использования этого свойства в запросах необходимо выполнить переиндексацию. Переиндексация не требуется Переиндексация не требуется
Rhapsody Design Management Переиндексация не требуется, но она может удалить копии записей индекса и повысить производительность. Выполните переиндексацию, если требуется использовать в запросах новые данные. Переиндексация не требуется Переиндексация не требуется Переиндексация не требуется
Rational DOORS Переиндексация настоятельно рекомендуется для рабочих данных. Переиндексация рекомендуется, если создавались запросы с URI mailto. Переиндексация рекомендуется для рабочих данных. Переиндексация рекомендуется, если создавались запросы с URI mailto. Переиндексация не требуется Переиндексация не требуется
Rational DOORS Next Generation н/д н/д Переиндексация не требуется Переиндексация не требуется
Rational Engineering Lifecycle Manager Требуется переиндексация Требуется переиндексация Требуется переиндексация Требуется переиндексация
Jazz Team Server Users TRS (jts/trsUsers) Требуется переиндексация Переиндексация не требуется Переиндексация не требуется Переиндексация не требуется

Комментарии