Referência do Script relm_upgrade

O script relm_upgrade é usado ao atualizar a partir de uma versão mais antiga do Rational Engineering Lifecycle Manager.

Propósito

O processo completo de atualização do Rational Engineering Lifecycle Manager está descrito em Atualizando o Rational Engineering Lifecycle Manager. Poderá ser necessário modificar os parâmetros no script de upgrade se você estiver usando valores não padrão.

O script relm_upgrade faz upgrade do Rational Engineering Lifecycle Manager 1.0, 1.0.0.1, 4.0.3 ou 4.0.4 para 4.0.6. Embora o arquivo de script esteja localizado no diretório upgrade/relm, ele deve ser executado a partir do diretório RELM_4.0.6_install_dir/server. Além 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 da linha de comandos.

As versões em inglês e traduzidas dos arquivos relm_params estão localizadas no diretório RELM_4.0.6_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 com base 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 no 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 antigo diretório de configuração do Rational 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 da qual está sendo feito o upgrade. Não 4.0.4
newApplicationHome Caminho para o diretório de configuração do aplicativo Rational Engineering Lifecycle Manager da instalação 4.0.6. Não relm_4.0.6_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 Caminho para o diretório inicial do Tomcat do aplicativo Rational Engineering Lifecycle Manager da instalação 4.0.6. Por padrão, o valor do parâmetro newApplicationTomcatHome é derivado do valor do parâmetro newApplicationHome. Não Nenhum
newJTSHome Caminho para o diretório de configuração do Jazz Team Server da instalação 4.0.6. Por padrão, o valor de parâmetro newJTSHome é derivado do valor de parâmetro newApplicationHome. Não Nenhum
jtsContextRoot Raiz de contexto do Jazz Team Server 4.0.6. Não jts
noPrompt Não solicitar 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 avisar 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