Referência do Script relm_upgrade

Use o script relm_upgrade para atualizar sua versão do Rational Engineering Lifecycle Manager.

Propósito

O processo completo de upgrade doRational Engineering Lifecycle Manager está descrito em Fazendo upgrade do Rational Engineering Lifecycle Manager em execução com o WebSphere Application Server. É possível modificar os parâmetros no script de upgrade se você decidir não usar os valores padrão.

O script relm_upgrade faz upgrade do Rational Engineering Lifecycle Manager 4.0.3, 4.0.4, 4.0.5, 4.0.6 ou 5.0 para 5.0.1. Embora o arquivo de script esteja localizado no diretório upgrade/relm, ele deve ser executado a partir do diretório RELM_5.0.1_install_dir/server. Alem disso, se o seu caminho contiver espaços, certifique-se colocar o nome do arquivo entre aspas duplas.

Como alternativa à execução do script e de todos os seus argumentos de linha de comandos, é possível abrir o arquivo de parâmetros do script, modificar os valores padrão e executar uma forma abreviada do script.

As versões em inglês e traduzidas dos arquivos relm_params estão localizadas no diretório RELM_5.0.1_install_dir/server/upgrade/relm/params. Abra o relm_params ou a versão traduzida dele para editar e especificar valores para cada parâmetro. Um dos parâmetros que devem ser configurados é o caminho para o diretório OLD_APPLICATION_HOME. Esse deve ser um diretório existente terminado em server/conf.

O script execute as seguintes tarefas:
  • Executa o comando -migration_relm_updateConfigurationFiles que atualiza a configuração e os arquivos Tomcat (se updateTomcatFiles não estiver configurado como Não). Insira [E] para executar o comando, [S] para ignorar a etapa ou pressione [Enter] para cancelar a execução do script.
  • Atualiza os arquivos teamserver.proprties que são baseados nas informações da versão anterior. Após os arquivos de configuração serem mesclados com sucesso, insira [C] para continuar. Um editor é aberto em que é possível verificar o arquivo teamserver.properties do aplicativo Change and Configuration Management. Verifique se a raiz de URI Pública denotada pela propriedade com.ibm.team.repository.server.webapp.url está correta. Verifique também se as propriedades do banco de dados estão corretas. Ao concluir, salve suas mudanças, se houver alguma, e feche o editor para continuar a execução do script.
  • Em um ambiente Tomcat, mescla o conteúdo dos arquivos server.xml e web.xml com a nova versão e copia a versão antiga do arquivo tomcat-users.xml.
  • Inclui tabelas para o banco de dados do repositório do Rational Engineering Lifecycle Manager.

Parâmetros

Atributo Descrição Necessário Padrão
oldApplicationHome Caminho completo para o diretório de configuração antigo doRational Engineering Lifecycle Manager. O caminho não deverá conter nenhum espaço. Em uma instalação típica, esse caminho é old_relm_install_dir/server/conf. Sim Nenhum
applicationContextRoot Raiz de contexto do Rational Engineering Lifecycle Manager. Não relm
oldApplicationVersion A versão do Rational Engineering Lifecycle Manager que está sendo atualizada. Não Por padrão, a versão do Rational Engineering Lifecycle Manager a ser atualizada é detectada automaticamente.
newApplicationHome O caminho para o diretório de configuração de aplicativo do Rational Engineering Lifecycle Manager da instalação do 5.0.1. Não RELM_5.0.1_install_dir/server/conf
updateTomcatFiles Se atualizar os arquivos de configuração do Tomcat. Configure este valor como "não" se estiver usando o WebSphere Application Server. Não Sim
oldApplicationTomcatHome Caminho completo para o diretório inicial do Tomcat da instalação da versão anterior. Por padrão, o parâmetro oldTomcatHome é derivado do valor do parâmetro oldApplicationHome. Não Nenhum
newApplicationTomcatHome O caminho para o diretório inicial do Tomcat do aplicativo Rational Engineering Lifecycle Manager da instalação do5.0.1. Por padrão, o valor do parâmetro newApplicationTomcatHome é derivado do valor do parâmetro newApplicationHome. Não Nenhum
newJTSHome O caminho para o diretório de configuração do Jazz Team Server da instalação do 5.0.1. Por padrão, o valor de parâmetro newJTSHome é derivado do valor de parâmetro newApplicationHome. Não Nenhum
jtsContextRoot Raiz de contexto do 5.0.1 Jazz Team Server. Não jts
noPrompt Não execute nenhum prompt antes de criar ou modificar as tabelas. Não Nenhum
noVerify Não executar a verificação do arquivo teamserver.properties. Não Nenhum
overwrite Sobrescrever ou não um arquivo existente. Não não
noStepPrompt Não execute nenhum prompt antes de executar uma etapa. Não Nenhum
Windows:
cd C:\Program Files\IBM\JazzTeamServer\Server\
upgrade\relm\relm_upgrade.bat -oldApplicationHome old_relm_install_dir\server\conf
Linux:
cd opt/IBM/JazzTeamServer/Server/
./upgrade/relm/relm_upgrade.sh -oldApplicationHome old_relm_install_dir/server/conf

Feedback