Для обновления Rational Engineering
Lifecycle Manager
установите новую версию продукта, обновите файлы конфигурации,
добавьте или обновите таблицы в существующих хранилищах базы данных и
выполните миграцию данных в версию
5.0.1.
Прежде чем начать
- При обновлении продуктов, интегрированных в
Rational Engineering
Lifecycle Manager,
следуйте инструкциям из раздела Контрольная таблица для обновления стека продуктов Rational Engineering Lifecycle Manager.
- В случае обновления версии 4.x необходимо получить новые лицензии
для приложений версии 5.x. Приложения версии 5.x не работают
с лицензиями версии 4.x. Однако приложения версии 4.x могут работать
с лицензиями версии 5.x.
- Удалите источник данных
Rational Engineering
Lifecycle Manager
из
Lifecycle
Query Engine.
- Открыть страницу администрирования
Lifecycle
Query Engine: https://хост-lqe:порт/lqe/web.
- Выберите . Выберите источник данных
Rational Engineering
Lifecycle Manager.
- На панели Источники данных нажмите кнопку
Удалить и сохраните изменения.
Процедура
- Установите 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 в поле Значения
корневого контекста приложения.
- Настройте сервер приложений.
- Убедитесь, что старый сервер запущен.
- Создайте резервную копию профайла
WebSphere Application
Server.
- Откройте командную строку и перейдите в папку
bin каталога установки
WebSphere Application
Server.
- Выполните эту команду. При включенной защите
WebSphere Application
Server укажите имя пользователя и пароль.
Совет: Каталог сжатого
файла необходимо создать перед запуском процесса
резервного копирования.
backupConfig.sh <
путь-к-новому-сжатому-файлу-для-создания-резервной-копии-профайла> -username <
основной-администратор-WAS> -password <пароль-администратора-WAS>
Пример: backupConfig.sh /root/WAS_backup/relm_50_profile.zip -username <
администратор-WAS> -password <пароль-администратора-WAS>
backupConfig.bat <путь-к-новому-сжатому-файлу-для-создания-резервной-копии-профайла> -username <основной-администратор-WAS> -password <пароль-администратора-WAS>
Пример: backupConfig.bat C:\WAS_backup\relm_50_profile.zip -username <администратор-WAS> -password <пароль-администратора-WAS>
Эта команда завершает работу сервера перед запуском процесса
резервного копирования.
- Удалите существующие приложения из WebSphere Application Server.
- Запустите сервер.
- Войдите в WebSphere
Application Server Integrated Solutions Console по адресу
https://имя-хоста:9043/ibm/console/logon.jsp
- Выберите
.
- Остановите и удалите следующие приложения: relm.war, relmhelp.war, vvc.war,
lqe.war, SPARQL_Gateway.war.
- После приглашения сохраните изменения в основной конфигурации.
- Обновите пользовательские свойства
JAZZ_HOME и
log4j.configuration.
- Войдите в WebSphere Application
Server Integrated Solutions Console по адресу https://имя-хоста:9043/ibm/console/logon.jsp.
- Выберите .
- Щелкните на имени сервера для его открытия. Имя сервера по умолчанию - server1.
- В разделе Инфраструктура сервера выберите
.
- Под заголовком Дополнительные свойства
выберите Виртуальная машина Java.
- Измените пути
Lifecycle
Query Engine
и Jazz
Reporting Service для указания новых расположений.
- Найдите текстовое поле Стандартные аргументы
JVM и добавьте следующую переменную среды в процедуру
запуска JVM:
-Dlqe.config.location=file://drive:/установочный-каталог-lqe/server/conf/lqe
- В разделе Дополнительные свойства
выберите Пользовательские свойства.
- Выберите JAZZ_HOME и укажите значение file:///<установочный-каталог-новой-версии>/server/conf.
Пример: file:///C:/PROGRA~2/IBM/JazzTeamServer_5.0.1/server/conf.
- Выберите log4j.configuration и укажите
значение file:///<установочный-каталог-новой-версии>/server/conf/startup_log4j.properties.
Пример: file:///C:/PROGRA~2/IBM/JazzTeamServer_5.0.1/server/conf/startup.log4j.properties.
- При подключении к базе данных Oracle убедитесь, что ORACLE_JDBC_DRIVER_FILE указывает на правильный файл драйвера JDBC.
- После приглашения сохраните изменения в основной конфигурации.
- Укажите общую библиотеку Jazz
Reporting Service.
- В административной консоли выберите .
- В списке выберите Общая библиотека JRS.
- Вместо пути к классам существующего
экземпляра Jazz
Reporting Service
укажите новое расположение.
Пример: установочный-каталог-5.0.1/server/conf/SPARQL_Gateway/SharedLibrary
- В разделе Загрузка классов включите
переключатель Использование загрузчика изолированных
классов для общей библиотеки.
Нажмите Применить и
Сохранить.
- Остановите WebSphere
Application Server.
Выполните команду
stopServer.sh.
Выполните команду
stopServer.bat.
- Очистите каталоги temp
WebSphere Application
Server.
Удалите связанное содержимое
Rational Engineering Lifecycle
Manager
из каталогов wscache и temp
в профайле. В зависимости от установленных ранее приложений в
профайле существуют следующие каталоги, которые можно удалить:
relm_war, lqe_war,
sparql и связанные данные приложения
Configuration Management.

каталог-профайла-WAS/wscache (например,
opt/IBM/WebSphere/AppServer/profiles/AppSrv01/temp/wscache)
каталог-профайла-WAS/temp (например,
opt/IBM/WebSphere/AppServer/profiles/AppSrv01/temp)

каталог-профайла-WAS\wscache (например,
C:\IBM\WebSphere\AppServer\profiles\AppSrv01\wscache)
каталог-профайла-WAS\temp (например,
C:\IBM\WebSphere\AppServer\profiles\AppSrv01\temp)
- Очистите каталог протоколов
WebSphere Application
Server.
Перейдите к каждому серверу приложений и удалите связанные
протоколы
Rational Engineering Lifecycle
Manager
из каталога протоколов в профайле. Стандартный каталог
протоколов:
opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs
C:\IBM\WebSphere\AppServer\profiles\AppSrv01\logs
- Запустите WebSphere
Application Server.
Выполните команду
startServer.sh.
Выполните команду
startServer.bat.
- Выполните миграцию базы данных.
| Опция |
Описание |
 |
Удалите базы данных 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, который можно использовать в качестве рекомендации. - Убедитесь, что старый
Jazz Team Server
остановлен.
- В DB2 найдите базы данных,
используемые в предыдущем экземпляре приложений
Jazz Team Server.
- Создайте резервную копию каждой базы данных, используемой
приложением Jazz Team Server.
- Сохраните изменения.
Дополнительная информация по резервному копированию и
восстановлению базы данных приведена в документации по
Rational solution for Collaborative Lifecycle Management. |
 |
- Убедитесь, что заданы правильные имя пользователя и пароль.
- Убедитесь, что перед началом процесса обновления была создана
резервная копия базы данных.
- Убедитесь, что применяется драйвер Java Database Connectivity
(JDBC) sqljdbc4.jar. В версии 5.0.1 не
поддерживается
JRE версии 5.0. Поддерживаются только JRE 6.0 и 7.0.
- Убедитесь, что служба SQL запущена.
Подробные инструкции приведены в документации, поставляемой производителем базы данных. |
Убедитесь, что драйвер JDBC Oracle
ojdbc.jar доступен в каталоге
$newRELMHome/JazzTeamServer/server/oracle.
- Обновите приложение Configuration Management.
Выполните сценарий vvc_upgrade для
обновления файлов конфигурации и баз данных и перекомпоновки
текстовых индексов.
Пример параметров:
cd $newRELMHome/server/
upgrade/vvc/vvc_upgrade.sh -oldApplicationHome старый-каталог-RELM/server/conf
Совет: Приложение Configuration Management можно также установить с
помощью Rhapsody Design
Manager. При установке
Rational Engineering
Lifecycle Manager
выберите опцию Приложение Configuration
Management, если требуется установить
компонент в системе, в которой
нет Rhapsody Design
Manager. Интегрируйте с
Rational Engineering Lifecycle
Manager
только приложение Configuration Management.
При выборе установки компонента
на нескольких серверах убедитесь, что для установки и обновления
выбран правильный компонент.
- Обновите
Rational Engineering Lifecycle
Manager.
Выполните команду
relm_upgrade.sh для
обновления файлов конфигурации и баз данных и перекомпоновки
текстовых индексов.
$newRELMHome/server/upgrade/relm/relm_upgrade.sh -oldApplicationHome старый-каталог-RELM/server/conf
- Перенесите информацию о конфигурации
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.
- Разверните файлы relm.war,
relmhelp.war, vvc.war,
lqe.war и SPARQL_Gateway.war.
- В административной консоли
WebSphere Application
Server выберите
.
- На странице Приложения J2EE выберите Установить.
- В разделе Путь к новому приложению
выберите файл
$newRELMHome/server/webapps/relm.war
и нажмите кнопку Открыть.
- Выберите Быстрый путь и нажмите кнопку Далее.
- Примите значения по умолчанию и нажмите кнопку
Далее в мастере настройки. На странице Связать корневые контексты для веб-модулей укажите
корневой контекст /relm. Затем нажмите кнопку Готово.
- Будет выдано сообщение об успешной установке
relm.war. Выберите Сохранить напрямую в главной
конфигурации.
- Установите документацию по
Rational Engineering Lifecycle
Manager (relmhelp.war).
Выполните действия a-f, приведенные выше. Укажите путь
$newRELMHome/server/webapps/relmhelp.war
и корневой контекст /relmhelp.
- Установите приложение Configuration Management
(vvc.war).
Выполните действия a-f, приведенные выше. Укажите путь
$newRELMHome/server/webapps/vvc.war
и корневой контекст /vvc.
- Настройте сервер
WebSphere Application
Server для Lifecycle
Query Engine и разверните файл lqe.war.
- Установите приложение
Jazz
Reporting Service (SPARQL_Gateway.war).
Выполните действия a-f, приведенные выше. В качестве пути укажите следующее значение:
$newRELMHome/server/webapps/SPARQL_Gateway.war. Кроме того, корневой контекст
SPARQL_Gateway.
- Добавьте ссылку на библиотеку Jazz
Reporting Service.
- Выберите , затем выберите SPARQL_Gateway_war в списке приложений.
- В разделе Ссылка выберите Ссылки на общие библиотеки.
- Включите переключатель SPARQL_Gateway_war и
выберите Ссылка на общие библиотеки.
- Выберите Общая библиотека JRSи щелкните
на стрелке вправо.
- Нажмите кнопку OK. Затем снова нажмите кнопку OK для
сохранения параметров в главной конфигурации.
- Убедитесь, что порядок загрузки классов
Jazz
Reporting Service
настроен правильным образом.
- Выберите , затем выберите SPARQL_Gateway_war в списке приложений.
- В разделе Подробные свойства выберите Загрузка классов и обнаружение обновления.
- В разделе Порядок загрузчиков классов
выберите значение Вначале классы, загруженные локальным
загрузчиком классов (а родительским - потом).
- Нажмите кнопку OK и выберите
Сохранить в главной конфигурации.
- Перезапустите WebSphere Application Server.
- Удалите свойство DBLocation из конфигурации
Jazz
Reporting Service.
Если файл $newRELMHome/server/conf/SPARQL_Gateway/app.properties
содержит строку DBLocation, удалите ее.
- Удалите существующий экземпляр
Jazz
Reporting Service или
SPARQL Gateway из приложений, зарегистрированных на сервере Jazz Team Server.
- В браузере откройте страницу администрирования Jazz Team Server https://полное-имя-хоста-RELM:9443/jts/admin
и нажмите кнопку Сервер. Затем выберите Зарегистрированные приложения.
- В списке приложений нажмите кнопку Удалить приложение
, чтобы удалить существующее приложение
Jazz
Reporting Service
или SPARQL Gateway.
- Зарегистрируйте новую версию приложения
Jazz
Reporting Service
на сервере Jazz Team Server.
- На странице администрирования Зарегистрированные
приложения Jazz Team Server нажмите
кнопку Добавить.
- Введите информацию о продукте
Jazz
Reporting Service
и нажмите кнопку Готово.
- Имя приложения:
Jazz
Reporting Service
- URL обнаружения:
https://полное-имя-хоста-RELM:9443/SPARQL_Gateway/scr
- Пароль приемника: введите любое значение
- Функциональный ИД пользователя: по умолчанию применяется
значение jrs_user.
Значение по умолчанию можно изменить.
- Настройте
дружественные
отношения
между
Jazz
Reporting Service и Rational Engineering
Lifecycle Manager.
- Удалите Jazz
Reporting Service или
SPARQL Gateway из списка
исходящих дружественных
серверов Rational
Engineering
Lifecycle Manager.
- Откройте консоль Rational
Engineering Lifecycle Manager: https://хост-relm:порт/relm/admin
- В области Администрирование сервера выберите
.
- В списке друзей нажмите кнопку Удалить друга
.
- Настройте для
Jazz Reporting Service
дружественную исходящую связь с Rational(r) Engineering Lifecycle Manager.
- Настройте источник данных
Jazz
Reporting Service.
- Удалите источник данных
Lifecycle
Query Engine
из Jazz Reporting
Service.
- В браузере откройте страницу Настройка по
следующему адресу:
https://хост-relm:порт/SPARQL_Gateway/setup
- Выберите Источники данных в
информационной строке продукта.
- В столбце Действия рядом с
источником данных
Lifecycle Query Engine щелкните на значке Действия,
затем выберите Удалить источник данных.
- Добавьте
Lifecycle
Query Engine
в качестве источника данных для Jazz Reporting Service.
- В случае обновления версии 4.x обновите
Lifecycle
Query Engine.
Откройте страницу администрирования
Lifecycle
Query Engine: https://хост-relm:порт/lqe/web/admin.
Будет выдано сообщение о том, что выполняется обновление
Lifecycle
Query Engine
и приложение недоступно. Выберите Запустить обновление. После
завершения процесса обновления открывается доступ к
источникам данных.
- Обновите приложение Configuration Management.
- Убедитесь в существовании файла
credentials.txt со следующим содержимым:
adminUserId, adminPassword, repositoryURL, smartCard,
certificateFile.
Если файл не существует, создайте его. Пример файла идентификационных данных:
adminUserId=yourAdminUserId
adminPassword=yourAdminPassword
repositoryURL=https://yourserver.com:9443/vvc
smartCard=<none>
certificateFile=<none>
- Выполните команду repotools-vvc из каталога установочный-каталог-приложения-настройки/server.
./repotools-vvc.sh -vvc_online_migrationCommand credentialsFile=credentials.txt fromVersion=<previous_version> logPort=52000 logLevel=DEBUG
repotools-vvc.bat -vvc_online_migrationCommand credentialsFile=credentials.txt fromVersion=<previous_version> logPort=52000 logLevel=DEBUG
- Перезапустите Jazz Team Server.
Команда repotools приложения Configuration
Management отправляет запрос активному приложению Configuration
Management и ожидает ответ. Если команда repotools-vvc останавливается
сразу с ошибкой авторизации, убедитесь, что сервер запущен и
проверьте правильность ИД пользователя и пароля в файле
идентификационных данных.
- Перезапустите сервер приложений.
Выполните команды
stopServer.sh и startServer.sh.
Выполните команды
stopServer.bat и
startServer.bat.
- Установите лицензии версии
5.0.1.
Дополнительная информация о лицензиях приведена в разделе
Управление
лицензиями.
- Перезапустите сервер
Rational Engineering Lifecycle
Manager
для автоматического обновления перенесенных данных в формат новой
версии приложения. Этот процесс называется интерактивным
обновлением. Для того чтобы открыть страницу состояния
обновления, войдите в систему.
Результаты
После успешного завершения интерактивного обновления веб-браузер
обновляется и отображает начальную страницу
Rational Engineering
Lifecycle Manager. В случае сбоя шага обновления
обратитесь к файлу
relm.log для определения
причины сбоя. Если в
Rational Engineering
Lifecycle Manager
настроено большое число продуктов, то интерактивное обновление может
занять до нескольких часов.