Para atualizar o Rational Engineering
Lifecycle Manager,
instale a nova versão do produto, atualize os arquivos de configuração, inclua ou atualize as tabelas nos repositórios do banco de dados existente e migre seus dados para a versão 5.0.1.
Antes de Iniciar
- Se estiver atualizando produtos que são integrados com Rational Engineering
Lifecycle Manager,
siga a sequência no Lista de verificação para upgrade da pilha de produtos Rational Engineering Lifecycle Manager.
- Se você fizer upgrade da versão 4.x, deverá obter novas licenças para aplicativos versão 5.x. Os aplicativos versão 5.x não funcionam com licenças versão 4.x. No entanto, aplicativos versão 4.x funcionam com licenças versão 5.x. Para obter mais informações sobre
licenças, acesse Gerenciando
licenças.
- Se fizer upgrade da versão 4.x, remova a origem de dados do Rational Engineering
Lifecycle Manager do Lifecycle
Query Engine.
- Abra a página administrativa do Lifecycle
Query Engine: https://lqe_host_name:port/lqe/web.
- Clique em . Selecione a origem de dados do Rational Engineering
Lifecycle Manager.
- Na área de janela Origens de Dados, clique em Remover,
e salve.
Procedimento
- Instale o Rational Engineering Lifecycle
Manager.
Esta etapa instala:
- Rational Engineering
Lifecycle Manager 5.0.1
- Jazz Team Server 5.0.1
- 5.0.1 do aplicativo Configuration Management
Importante: - Selecione um grupo de pacotes e um diretório diferentes da instalação
original.
- Selecione a mesma raiz de contexto da instalação anterior.
Se você fizer upgrade do
Rational Engineering
Lifecycle Manager versão 5.0 ou de versões mais antigas, o
Jazz
Reporting Service existente ou a raiz de contexto do SPARQL Gateway será SPARQL_Gateway e o nome do arquivo do aplicativo será SPARQL_Gateway.war.
Ao instalar o Rational Engineering
Lifecycle Manager 5.0.1, selecione uma opção de raiz de contexto customizada e insira SPARQL_Gateway no campo Valores de Raiz de Contexto do Aplicativo.
- Configure seu servidor de aplicativos.
- Assegure-se de que o servidor antigo esteja em execução.
- Faça backup do perfil do WebSphere Application Server.
- Abra um prompt de comandos e altere para o diretório bin do diretório de instalação do WebSphere Application Server.
- Execute este comando. Se
a segurança do WebSphere Application
Server estiver ativada, especifique o nome de usuário e a senha.
Dica: O caminho do diretório para o arquivo compactado deve existir antes de iniciar o processo de backup.
backupConfig.sh <caminho para um novo arquivo compactado para criação de backup de perfil> -username <nome de usuário admin principal do WAS> -password <senha admin do WAS>
Por exemplo: backupConfig.sh /root/WAS_backup/relm_50_profile.zip -username <WAS_admin> -password <WAS_admin_password>
backupConfig.bat <Path_to_a_new_compressed_file_to_create_backup_of_profile> -username <WAS_primary_administrative_user_name> -password <WAS_administrative_password>
Por exemplo: backupConfig.bat C:\WAS_backup\relm_50_profile.zip -username <WAS_admin> -password <WAS_admin_password>
O comando encerra o servidor antes de iniciar o processo de backup.
- Desinstale os aplicativos existentes do WebSphere Application Server.
- Inicie o servidor.
- Efetue logon no WebSphere Application
Server Integrated Solutions Console em https://host_name:9043/ibm/console/logon.jsp
- Clique em .
- Pare e desinstale os aplicativos a seguir: relm.war, relmhelp.war, vvc.war, lqe.war, SPARQL_Gateway.war.
- Quando solicitado, salve as mudanças na configuração principal.
- Atualize as propriedades customizadas JAZZ_HOME e log4j.configuration.
- Efetue logon no WebSphere Application
Server Integrated Solutions Console em https://host_name:9043/ibm/console/logon.jsp.
- Clique em .
- Clique no nome do servidor para abri-lo. O nome do servidor padrão é server1.
- Na seção Infraestrutura do servidor, clique em .
- Em Propriedades adicionais, clique em Java Virtual Machine.
- Altere o caminho para o Lifecycle
Query Engine e Jazz
Reporting Service para o novo local.
- Localize o campo de texto Argumentos Genéricos do JVM, e inclua
essa variável de ambiente para o processo de inicialização da JVM:
-Dlqe.config.location=file://drive:/lqe_installation_dir/server/conf/lqe
- Em Propriedades adicionais, clique em Propriedades customizadas.
- Clique em JAZZ_HOME e atualize seu valor para file:///<new_version_install_dir>/server/conf.
Por exemplo, file:///C:/PROGRA~2/IBM/JazzTeamServer_5.0.1/server/conf.
- Clique em log4j.configuration e atualize seu valor para file:///<new_version_install_dir>/server/conf/startup_log4j.properties.
Por exemplo, file:///C:/PROGRA~2/IBM/JazzTeamServer_5.0.1/server/conf/startup.log4j.properties.
- Se você estiver se conectando a um banco de dados Oracle, assegure-se de que ORACLE_JDBC_DRIVER_FILE esteja apontando para o arquivo do driver JDBC correto.
- Quando solicitado, salve as mudanças na configuração principal.
- Configure a biblioteca compartilhada do Jazz
Reporting Service.
- No console administrativo, acesse .
- Na lista, clique em Biblioteca Compartilhada do JRS.
- Altere o caminho da classe do local de instalação do Jazz
Reporting Service existente para o novo local.
Por exemplo: 5.0.1_install_dir/server/conf/SPARQL_Gateway/SharedLibrary
- Em Carregamento de Classe, assegure-se de que Usar um Carregador de Classes Isolado para a Biblioteca Compartilhada seja selecionado.
Clique em Aplicar e Salvar.
- Pare o WebSphere Application Server.
Execute o comando stopServer.sh.
Execute o comando stopServer.bat.
- Limpe os diretórios temp do WebSphere Application Server.
Remova o Rational Engineering Lifecycle
Manager relacionado ao conteúdo dos diretórios wscache e temp no perfil. Dependendo de quais aplicativos foram instalados, esses diretórios podem estar no perfil e podem ser removidos: relm_war, lqe_war, sparql e os dados relacionados ao aplicativo Configuration Management.

WAS_profile_root/wscache (for example: opt/IBM/WebSphere/AppServer/profiles/AppSrv01/temp/wscache)
WAS_profile_root/temp (for example: opt/IBM/WebSphere/AppServer/profiles/AppSrv01/temp)

WAS_profile_root\wscache (for example: C:\IBM\WebSphere\AppServer\profiles\AppSrv01\wscache)
WAS_profile_root\temp (for example: C:\IBM\WebSphere\AppServer\profiles\AppSrv01\temp)
- Limpe o diretório de log do WebSphere Application Server.
Acesse cada servidor de aplicativos e remova os logs relacionados ao
Rational Engineering Lifecycle
Manager do diretório de logs no perfil. Um diretório de logs típico é:
opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs
C:\IBM\WebSphere\AppServer\profiles\AppSrv01\logs
- Inicie seu servidor de aplicativos WebSphere.
Execute o comando startServer.sh.
Execute o comando startServer.bat.
- Faça backup ou migre seu banco de dados.
Assegure-se de que o driver Oracle JDBC ojdbc.jar esteja disponível no diretório $newRELMHome/JazzTeamServer/server/oracle.
- Faça o upgrade do aplicativo Configuration Management.
Execute o script vvc_upgrade para atualizar a configuração e os arquivos de banco de dados e para reconstruir os índices do texto.
Este é um exemplo de parâmetros:
cd $newRELMHome/server/
upgrade/vvc/vvc_upgrade.sh -oldApplicationHome oldRELMHome/server/conf
Dica: O aplicativo Configuration Management também pode ser instalado com o Rhapsody Design
Manager. Quando você estiver instalando o Rational Engineering
Lifecycle Manager, selecione o aplicativo Configuration Management, se desejar instalar o componente em uma máquina diferente do sistema Rhapsody Design Manager. Integre somente um aplicativo Configuration Management com o Rational Engineering Lifecycle
Manager.
Se optar por instalar o componente em diversos servidores, assegure-se de selecionar o componente correto para instalação e upgrade.
- Atualize Rational Engineering Lifecycle
Manager.
Execute o comando
relm_upgrade.sh para
os arquivos de configuração e banco de dados e reconstrua os índices de texto.
$newRELMHome/server/upgrade/relm/relm_upgrade.sh -oldApplicationHome oldRELMHome/server/conf
- Transporte as informações de configuração do Lifecycle
Query Engine e o
Jazz
Reporting Service existente ou do SPARQL Gateway para a nova versão de produto.
Copie o conteúdo do diretório
SPARQL_Gateway na instalação antiga para o novo diretório
SPARQL_Gateway.
cp -R $oldRELMHome/server/conf/SPARQL_Gateway/* $newRELMHome/server/conf/SPARQL_Gateway
Caso esteja fazendo o upgrade da versão 5.0 para 5.0.1, prossiga para a Etapa 7.
Caso esteja fazendo upgrade da versão 4.x para 5.0.1,
use um editor de texto para incluir as seguinte propriedades em
$newRELMHome/server/conf/SPARQL_Gateway/SPARQL_Gateway.properties.
- support.query.editing=false
- support.db.derby=false
- support.dwse=false
- query.results.limit=3000
- query.results.cache.timeout=300
- user.account.cache.timeout=480
Remova
app.properties de
SPARQL_Gateway rm $newRELMHome/server/conf/SPARQL_Gateway/app.properties
Renomeie
SPARQL_Gateway.properties para
app.properties.
mv $newRELMHome/server/conf/SPARQL_Gateway/SPARQL_Gateway.properties $newRELMHome/server/conf/SPARQL_Gateway/app.properties
Renomeie
SPARQL_Gateway_runtime.properties para
app_runtime.properties.
(Por padrão,
SPARQL_Gateway_runtime.properties não existe, mas você pode criar o arquivo caso precise definir a configuração de tempo limite da conexão.)
mv $newRELMHome/server/conf/SPARQL_Gateway/SPARQL_Gateway_runtime.properties $newRELMHome/server/conf/SPARQL_Gateway/app_runtime.properties
- Implemente os arquivos relm.war, relmhelp.war, vvc.war, lqe.war e SPARQL_Gateway.war.
- A partir do console administrativo do WebSphere Application
Server, selecione .
- Na página Aplicativos corporativos,
clique em Instalar.
- Em Caminho para o Novo Aplicativo,
selecione $newRELMHome/server/webapps/relm.war
e clique em Abrir.
- Selecione Fast path e, em seguida, Avançar.
- Aceite os valores padrão e clique em Avançar
no assistente de configuração. Na página Mapear raízes de contexto para módulos da web,
insira a raiz de contexto /relm. Em seguida, clique em Concluir.
- Uma mensagem indica que relm.war foi instalado
com êxito. Clique em Salvar diretamente na configuração principal.
- Instale a documentação do Rational Engineering Lifecycle
Manager, relmhelp.war.
Use as etapas de a-f mencionadas acima. Use $newRELMHome/server/webapps/relmhelp.war para
o caminho e /relmhelp como a raiz de contexto.
- Instale o aplicativo Configuration Management, vvc.war.
Use as etapas de a-f mencionadas acima. Use $newRELMHome/server/webapps/vvc.war para
o caminho e /vvc como a raiz de contexto.
- Configure seu servidor de aplicativos WebSphere para oLifecycle
Query Engine e implemente o arquivo lqe.war.
- Instale o aplicativo Jazz
Reporting Service, SPARQL_Gateway.war.
Use as etapas de a-f mencionadas acima. Use $newRELMHome/server/webapps/SPARQL_Gateway.war para o caminho. Use SPARQL_Gateway como a raiz de contexto.
- Inclua a referência de biblioteca do Jazz
Reporting Service.
- Acesse e SPARQL_Gateway_war na lista de aplicativos.
- Na seção Referência, clique em Referências
da biblioteca compartilhada.
- Selecione a caixa de seleção próxima a SPARQL_Gateway_war e clique em Referenciar bibliotecas compartilhadas.
- Selecione Biblioteca compartilhada JRS e clique na
seta para a direita.
- Clique em OK. Em seguida, clique em OK novamente
para salvar suas configurações na configuração principal.
- Assegure-se de que a ordem do carregamento de classe do Jazz
Reporting Service está configurada corretamente.
- Acesse e SPARQL_Gateway_war na lista de aplicativos.
- Na seção Propriedades de detalhes, clique em Carregamento de
classes e detecção de atualização.
- Na seção Ordem do carregador de classes, selecione Classes
carregadas com o carregador de classes local primeiro (pai por último).
- Clique em OK e em Salvar na configuração
principal.
- Reinicie o WebSphere Application Server.
- Se você fizer upgrade da versão 4.x, faça upgrade do
Lifecycle
Query Engine.
Abra a página de administração do Lifecycle
Query Engine
https://relm_host_name:port/lqe/web/admin.
Uma mensagem indica que o upgrade do Lifecycle
Query Engine está em adamento e que o aplicativo está indisponível. Clique em Iniciar
Upgrade. Quando o processo de upgrade for concluído, as origens de dados estão disponíveis.
- Faça o upgrade do aplicativo Configuration Management.
- Assegure-se de que um arquivo credentials.txt existe e contém: adminUserId, adminPassword, repositoryURL, smartCard, certificateFile.
Se o arquivo não existir, crie-o. Um exemplo de arquivo de credencial é:
adminUserId=yourAdminUserId
adminPassword=yourAdminPassword
repositoryURL=https://yourserver.com:9443/vvc
smartCard=<none>
certificateFile=<none>
- Execute o comando repotools-vvc de seu diretório do servidor Configuration_Application_install_dir/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
- Reinicie o Jazz Team Server.
O comando repotools do aplicativo Configuration Management envia uma solicitação ao aplicativo Configuration Management em execução e aguarda uma resposta. Se o comando repotools-vvc parar imediatamente com um erro de autorização, verifique se o servidor está em execução e se o ID do usuário e senha no arquivo de credenciais estão corretos.
- Reinicie o servidor de aplicativos.
Execute os comandos stopServer.sh
e startServer.sh.
Execute os comandos stopServer.bat e startServer.bat.
- Reinicie seu servidor do Rational Engineering Lifecycle
Manager para fazer upgrade automaticamente dos dados migrados para o formato requerido na nova versão do aplicativo. Este processo é chamado upgrade online. Efetue logon se quiser ver a página de status do upgrade.
Resultados
Quando o upgrade online for concluído com sucesso, o navegador da web será atualizado e exibirá a página de boas-vindas do
Rational Engineering
Lifecycle Manager. Se uma etapa de upgrade falhar, examine o arquivo
relm.log para determinar o que causou a falha. Se tiver um grande número de produtos definidos no
Rational Engineering
Lifecycle Manager, o upgrade online levará muito tempo para ser concluído (várias horas).