Для обновления
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 в поле Значения
корневого контекста приложения.
- Остановите старый сервер Tomcat.
- Выполните миграцию базы данных.
| Опция |
Описание |
 |
Удалите базы данных 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.
- Запустите сервер Apache Tomcat.
- Удалите свойство 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 останавливается
сразу с ошибкой авторизации, убедитесь, что сервер запущен и
проверьте правильность ИД пользователя и пароля в файле
идентификационных данных.
- Перезапустите сервер Tomcat.
- Установите лицензии версии
5.0.1.
Дополнительная информация о лицензиях приведена в разделе
Управление
лицензиями.
- Перезапустите сервер
Rational Engineering Lifecycle
Manager
для автоматического обновления перенесенных данных в формат новой
версии приложения. Этот процесс называется интерактивным
обновлением. Для того чтобы открыть страницу состояния
обновления, войдите в систему.
Результаты
После успешного завершения интерактивного обновления веб-браузер
обновляется и отображает начальную страницу
Rational Engineering
Lifecycle Manager. В случае сбоя шага обновления
обратитесь к файлу
relm.log для определения
причины сбоя. Если в
Rational Engineering
Lifecycle Manager
настроено большое число продуктов, то интерактивное обновление может
занять до нескольких часов.