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 existentes 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.
- Pare seu servidor antigo do Tomcat.
- 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,
você terá a opção de instalar o aplicativo Configuration Management
- esta opção é útil se quiser instalar o aplicativo em um servidor diferente do 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
- Inicie o servidor Apache Tomcat.
- 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 seu servidor do Tomcat.
- 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).