Use este guia para fazer upgrade de uma versão anterior do IBM® Rational Asset Manager no IBM WebSphere Application Server.
Antes de Iniciar
Importante: Como o Rational Asset Manager Versão
7.5.2 e posterior não suporta o WebSphere Application Server integrado e não suporta versões do WebSphere Application Server anteriores
a 7.0, se você estiver executando o Rational Asset Manager no
WebSphere Application Server integrado ou em uma versão do WebSphere Application Server anterior
a 7.0, você deverá primeiro reinstalar a versão existente do Rational Asset Manager sobre
uma versão suportada do WebSphere Application Server 7.0
ou posterior. Em seguida, siga as etapas deste tópico para fazer upgrade para o Rational Asset Manager
Versão 7.5.2 ou posterior.
Você deve fazer upgrade do seu servidor de licença e arquivar
uma solicitação para chaves de licença atualizadas. Para obter mais informações sobre
a versão necessária do Rational License
Server, consulte Instalando o Rational License Key Server.
Também será
necessário parar e reiniciar seu servidor de aplicativos várias
vezes.
Você também pode configurar um servidor
Rational Team Concert existente para trabalhar com o
Rational Asset Manager.
O aplicativo de configuração do servidor manipula a configuração. Você deve saber o nome de usuário e a senha para o administrador do
servidor
Rational Team Concert.
Se você tiver acesso à Internet, é possível usar o IBM Installation Manager para localizar e instalar as atualizações diretamente a partir do repositório de atualização
da IBM para o
Rational Asset Manager.
Importante: Quando o Rational Asset Manager é instalado,
o local de seu repositório de atualização é integrado automaticamente ao
Installation Manager. Para que o Installation Manager procure no repositório de
atualização padrão, a preferência Procurar nos repositórios vinculados durante
a instalação e as atualizações na página de preferências
Repositórios deve ser selecionada; essa preferência é selecionada por
padrão.
Para instalar o fix pack a partir de um local de repositório
diferente (por exemplo, se a atualização estiver em uma unidade compartilhada ou no
servidor HTTP ou HTTPS), inclua o local do repositório no Installation Manager.
Para incluir um local de repositório, consulte Configurando as Preferências do Repositório de Instalação no Installation Manager.
Para
trabalhar com o Installation Manager, você deve usar uma interface gráfica com o usuário
(GUI). Se você não tiver acesso a uma GUI, deverá instalar silenciosamente
na linha de comandos com arquivos de resposta. Para obter informações adicionais, consulte a Ajuda on-line do IBM Installation Manager e o Instalando Silenciosamente com o Installation Manager.
Sobre Esta Tarefa
Este resumo mostra o que você deve fazer para atualizar para a versão
mais recente do Rational Asset Manager:
- Preparar upgrade fazendo backups e configurando o servidor de aplicativos: etapas 1-5.
- Se estiver utilizando Oracle, copiar arquivos .jar JDBC adicionais: etapas
6-7.
- Fazer upgrade do servidor de licença para o
Rational Common Licensing
V8.1.2:
etapa
8.
- Recuperar os arquivos do aplicativo para a versão mais recente do
Rational Asset Manager e implemente o aplicativo de configuração do servidor: etapas 9–10.
- Usar o aplicativo de configuração do servidor para atualizar os outros aplicativos
do Rational Asset Manager: etapas 11–14.
- Reiniciar o servidor de aplicativos: etapa 17.
- Efetuar login no Web client do Rational Asset
Manager e migre o repositório: etapas 19–20.
- Opcionalmente, atualize o aplicativo Rational Asset
Manager Eclipse: etapa 21.
Procedimento
- Antes de fazer upgrade, crie um backup completo do repositório, dos bancos de dados, dos arquivos de ativos e das configurações de servidor de aplicativos através das instruções no Criando um Backup de um Repositório do Rational Asset Manager.


No Linux, AIX ou Linux for zSeries, aumente para pelo menos 65535 o número de descritores de arquivos que podem ser abertos de uma vez para um processo: - Para visualizar o número atual de descritores que podem ser abertos
de uma vez, na linha de comandos, digite: ulimit -n
- Se o limite não for de pelo menos 65535,
aumente-o com o seguinte comando: ulimit -n 65535
- Se você tiver modificado seu tema ou suas mensagens de e-mail, antes de atualizar o
servidor Rational Asset Manager,
faça download dos arquivos de tema e mensagem de correio atuais (na página
)
e, em seguida, depois de ter atualizado o servidor, reaplique o tema e suas mensagens. Para obter mais informações, consulte
Migrando
o Tema.
Configure as definições de segurança
do aplicativo e de autenticação do WebSphere Application Server: - Em um navegador da web, efetue login no console administrativo
doWebSphere Application Server. Por padrão, ele está localizado
em:
- No WebSphere Application Server: http://localhost:9060/ibm/console
- Clique em Segurança.
- Clique em Segurança Global.
- Na seção Segurança Administrativa, se a caixa de seleção Ativar Segurança Administrativa estiver
marcada, marque a caixa de seleção Ativar Segurança do Aplicativo.
- Clique em Aplicar.
- Na janela Mensagens, clique em Salvar
diretamente
na configuração principal.
- Pare
e, em seguida, reinicie o servidor.
- Verifique se todos os servidores do repositório
estão configurados para a mesma data, hora e fuso horário atuais.
Se você estiver usando o Oracle, copie o arquivo ojdbc6.jar
para o diretório WebSphere_install_directory/profiles/profile_name/config/cells/cell_name/ram_jdbc
de seu servidor de aplicativos. É possível fazer download dos
arquivos .jar
apropriadosa
partir do Oracle. Se estiver usando Oracle 10g, faça o download de um pacote para Oracle 11 para obter os arquivos
.jar apropriados.
- Se você estiver usando o Oracle e estiver usando o AIX,
Linux ouLinux para zSeries, configure as permissões apropriadas para o novo arquivo .jar JDBC, conforme descrito em Ativando a Conectividade do Banco de Dados para Usuários Não-Root (Linux e AIX). O usuário que acessa o banco de dados Oracle a partir do
Rational Asset Manager
deve receber o privilégio apropriado para concluir a migração.
- Se você estiver usando o usuário RAMSCHEMA,
conceda o privilégio CREATE VIEW para o usuário
RAMSCHEMA.
Exemplo: GRANT CREATE VIEW TO RAMSCHEMA
- Se estiver usando um usuário diferente, conceda o privilégio
CREATE ANY VIEW para tal usuário. Exemplo: GRANT CREATE
ANY VIEW TO User


Migre seu Rational Licensing Server para um Rational Common Licensing V8.1.2 ou posterior.
Para obter mais informações, consulte Migrando do Rational Licensing
Server v7.1.x ou anterior para o Rational Common
Licensing. Rational License Key Server está incluído com a mídia de instalação do Rational Asset Manager. Você também pode recuperar a versão mais recente do Rational License Server através da conta do
Passport Advantage ou através do
Centro de
Download da IBM.
Este processo requer que você encerre todos os aplicativos que usam o Rational Licensing Server,
desinstale seu Rational Licensing
Server existente, atualize seus arquivos de licença e instale o servidor Rational Common Licensing. Para Windows, consulte Configurando um servidor de licença para Windows; para AIX ou Linux,
consulte Configurando um servidor de licença para UNIX.
Para Linux para zSeries, continue a usar o Rational License Server para UNIX e Linux 7.0.0.1.
- Recupere os aplicativos apropriados do Rational Asset Manager:
- Se você usar o WebSphere Application Server e usou o Installation Manager para implementar o Rational Asset Manager em seu servidor,
use o Installation Manager para o processo de upgrade. Consulte as instruções de Instalando o Servidor Rational Asset Manager Usando o Installation Manager e
observe estas diferenças:
- Inicie o Gerenciador de Instalação. No Windows Vista,
execute o Installation Manager como um administrador (Clique com o botão direito do mouse no atalho do programa e selecione Executar como Administrador.
- Talvez seja necessário atualizar o Installation Manager
para uma versão mais recente.
Para configurar o Installation Manager para que ele procure atualizações: na
página Iniciar, clique em e, em seguida, clique em Atualizações. Na página Atualizações, selecione Procurar por Atualizações do Gerenciador de Instalação.
- Na página Iniciar do Gerenciador de Instalação, clique em Atualizar.
- Se houver uma versão mais recente do Installation Manager disponível,
aparecerá uma janela solicitando atualização. Clique em Sim.
Depois que o processo de atualização estiver concluído, clique em OK para
reiniciar o Installation Manager e, em seguida, clique em Atualizar novamente.
- Na página Pacotes de Atualização, selecione IBM Rational Asset
Manager e, em seguida, clique em Avançar. Expanda e selecione a versão mais recente do servidor do
Rational Asset Manager
e clique em Avançar.
- Siga as instruções no Assistente de Atualização.
- Na página Raiz de Contexto, o Installation
Manager detecta as raízes de contexto para seus atuais aplicativos da Web do Rational Asset Manager. Anote a raiz de contexto do Servidor de Configuração do
Rational Asset Manager; a raiz de contexto é necessária para acessar
o aplicativo de configuração do servidor. Em seguida,
clique em Avançar.
- Se a segurança do servidor de aplicativos estiver ativada (ela provavelmente está)
ou se as configurações de segurança para o WebSphere Application Server foram alteradas desde a instalação do produto, na página Segurança Administrativa da seção Recursos, selecione Sim e digite o nome de
usuário e a senha para o administrador do servidor de aplicativos.
Em seguida,
clique em Avançar.
- Depois da conclusão do processo de atualização:
- Se você usar um WebSphere Application Server existente, o arquivo .ear do aplicativo de configuração do servidor foi atualizado. Vá para a etapa 11.
- Se você usar um WebSphere Application Server ND Cluster existente, acesse a etapa 11. Se você estiver fazendo upgrade da versão 7.5 ou posterior e que foi a primeira versão do produto instalado, o aplicativo de configuração do servidor foi atualizado no servidor de aplicativos especificado quando o produto foi instalado originalmente.
Se você instalou qualquer versão anterior à 7.5, o aplicativo da configuração do servidor será atualizado no servidor Deployment Manager para sua célula.
- Se você implementou os arquivos Rational Asset Manager .ear e .war em seu servidor de aplicativos, recupere a versão mais recente dos arquivos de aplicativos do
Rational Asset Manager. Para obter informações adicionais, consulte Recuperando os Arquivos de Aplicativo do Servidor Diretamente da Mídia de Instalação.
Depois que tiver os arquivos de aplicativo, continue com a etapa 10.
- Implemente o aplicativo de configuração do servidor do Rational Asset Manager
em seu servidor de aplicativos:
- Se você estiver usando um cluster do WebSphere Application Server e implementou o aplicativo de configuração do servidor no servidor
Deployment Manager (isto descreve a maioria dos ambientes em um cluster antes da
V7.5), você deve usar um script para desinstalar o aplicativo de configuração do
servidor existente e, em seguida, instale o aplicativo de configuração do servidor mais
recente.
Para obter mais informações sobre o uso dos scripts deployClusterSetup.py e UninstallSetup.py, consulte Implementando o Aplicativo de Configuração do Servidor no Deployment Manager em um Cluster do WebSphere Application Server. Alternativamente, é possível implementar
o aplicativo de configuração do servidor no cluster ao invés de diretamente no Deployment
Manager; não será necessário executar um script Jython se você implementar o aplicativo desta
maneira. Após implementar o aplicativo de configuração do servidor no Deployment Manager, vá para a etapa
11.
- Se você implementou o aplicativo de
configuração do servidor do Rational Asset Manager
diretamente em um servidor de aplicativos, atualize com.ibm.ram.repository.setup.web.ear
para a versão mais recente que recuperou:
- Ative o console administrativo do WebSphere Application Server e efetue login como um administrador.
- Atualize o aplicativo de configuração do servidor do Rational Asset Manager:
- Clique em .
- Clique em Aplicativos corporativos do WebSphere.
- Selecione com.ibm.ram.repository.setup.web.ear e,
em seguida, clique em Atualizar.
- Digite ou navegue até o
caminho e o nome do arquivo archive corporativo de configuração do servidor Rational Asset Manager
(com.ibm.ram.repository.setup.web.ear).
- Nas próximas três páginas, clique em Avançar.
- Na página Resumo, clique em Concluir.
- Quando
o arquivo com.ibm.ram.repository.setup.web.ear for
instalado, clique em Salvar na Configuração Principal.
O aplicativo de configuração do servidor está agora atualizado e implementado. Você usa o aplicativo de configuração do servidor
para atualizar todos os outros aplicativos. Vá para a etapa 11.
- Se você usar o WebSphere Application Server e não tiver o aplicativo de configuração do servidor (com.ibm.ram.repository.setup.web.ear)
implementado, implemente o aplicativo com.ibm.ram.repository.setup.web.ear ao concluir as instruções em Implementando o Aplicativo de Configuração do Servidor no WebSphere Application Server.
Se estiver implementando em um cluster, consulte Implementando o Aplicativo de Configuração do Servidor em um Cluster do Websphere Application Server. Você usa o aplicativo de configuração do servidor
para atualizar todos os outros aplicativos. Depois
de implementar o aplicativo de configuração do servidor, vá para a etapa 11.
- Depois de ter implementado a versão mais recente
do aplicativo de configuração do servidor, em um navegador da Web,
abra o aplicativo de configuração do servidor usando a URL:http://host:port/setup-server-context-root.
A raiz de contexto padrão para o aplicativo da configuração do servidor é ram.setup.
Se a segurança estiver ativada no servidor de aplicativos, digite o ID de usuário
e a senha de um administrador do servidor de aplicativos.
- Na Etapa 1: Localize a seção Arquivos
de Instalação, clique em Fornecer o diretório que contém
os seguintes arquivos no servidor e
digite o diretório no sistema de arquivos no servidor que está executando
o aplicativo de configuração do servidor no qual os novos arquivos de aplicativo da web estão
localizados. Se você usou o assistente de atualização no Installation Manager, os arquivos
estão no diretório package_group_location/ram/apps/was.
Estes arquivos devem estar em tal diretório:
- com.ibm.ram.repository.web_runtime.ear
- RTC-Server_401.zip
- RTC-Server_3013.zip
- ramhelp_war.ear
- rmcabdgovernprocess_war.ear
Observe que o arquivo rlsclients_rlsibmratl_812.zip
está no diretório package_group_location/ram/SharedLibs.
Se você implementou o aplicativo de configuração do
servidor em um servidor de aplicativos que faz parte de um cluster e estiver acessando tal servidor de aplicativos, para fazer upload dos arquivos no
servidor que está executando o aplicativo de configuração do servidor, clique
em Fazer upload dos arquivos no servidor; em seguida,
clique em Procurar e selecione cada um dos arquivos
necessários.
- Para verificar se todos os arquivos de aplicativos necessários
estão no diretório, ou para fazer upload deles para o servidor, clique em Verificar
Arquivos de Instalação. Se você fez upload dos arquivos de aplicativos, o aplicativo de configuração do
servidor os salva em um diretório temporário.
Uma mensagem verifica se todos os arquivos necessários estão presentes.
- Clique em Atualizar. O aplicativo de configuração do servidor atualiza todos os outros arquivos
de aplicativos do Rational Asset Manager
com as versões mais recentes e mantém suas raízes de contexto, um processo que pode
levar vários minutos. O aplicativo de configuração do servidor
também remove o Rational Team Concert V2.0.0.2. A página de Introdução
é aberta. Se você estiver implementando em um
cluster e escolher a opção para usar o Rational Team Concert interno
que é empacotado com o RAM, o Rational Team Concert deverá ser
instalado em um cluster separado que possua apenas um servidor de aplicativos. Crie esse cluster
se ainda não tiver feito isso. Em seguida, efetue logout e login no aplicativo
de configuração do servidor para poder selecionar o cluster na lista para
implementação do Rational Team Concert.
Clique em Avançar para abrir a página Implementação.
Clique em Implementar Aplicativos para implementar os aplicativos Rational Team Concert CCM
e JTS, que são os componentes do servidor Rational Team Concert.
Esse processo também pode demorar vários minutos porque ele extrai o Rational Team Concert 3.0.1.3
e o Rational Team Concert 4.0.1.
Observe que o Rational Team Concert 3.0.1.3 é necessário para migrar o banco de dados do Rational Team Concert 2.0.0.2
para o Rational Team Concert 4.0.1.
O banco de dados é primeiro migrado para o Rational Team Concert 3.0.1.3 e,
em seguida, para o Rational Team Concert 4.0.1.
Essa migração ocorre posteriormente no processo de configuração do servidor.
- Configure o banco de dados do Rational Team Concert.
Na primeira página da seção Configurar Banco de Dados,
selecione o banco de dados que você precisa para criar ou modificar. Três bancos de dados
são necessários: um para gerenciar Ativos e dois bancos de dados adicionais
que são usados para gerenciar os ciclos de vida. Geralmente, quando fizer upgrade de uma versão
anterior a 7.5.1.2, selecione É necessário criar o banco de dados JTS do RTC. O banco de dados Jazz Team Server (JTS) é necessário para o
Rational Team Concert 4.
Siga as instruções no aplicativo de configuração do servidor para criar o
banco de dados para seu software do servidor de banco de dados específico. Para aprender mais sobre
como criar o banco de dados JTS, consulte os tópicos em Criando Bancos de Dados para Ciclos de Vida de Ativos. Após o banco de dados ter sido criado, migre o banco de dados do Rational Team Concert
do Rational Team Concert 2.0.0.2
para o Rational Team Concert 4.0.1.
Após especificar as informações corretas, clique em Migrar.
Isso poderá levar um tempo significativo, até várias horas, para executar,
dependendo do número de ativos, ciclos de vida e políticas. Uma janela de progresso
indica as etapas que estão sendo executadas conforme o aplicativo
de configuração do servidor executa os comandos.
- Continue com o aplicativo de configuração do servidor para configurar ou ajustar as definições do seu banco de dados
e do servidor de aplicativos até chegar à Parte 4: Definir as Configurações de Heap
do Java Virtual Memory. Selecione Médio ou Grande.
- Clique em Reiniciar o Servidor.
- Na página Configurar as definições de gerenciamento do ciclo de vida,
digite o caminho e as informações de login para o aplicativo Rational Team Concert:
- Na Etapa 1, no campo Servidor Rational Team Concert, digite o caminho para o local do
Rational Team Concert.
No campo Jazz Team Server, digite o caminho para o local do Jazz Team Server. Você deverá usar uma conexão segura (https://).
Por padrão, esses valores são:
- Para um WebSphere Application Server existente: https://server_host:9443/ramccm e https://server_host:9443/ramjts para
o Jazz Team Server.
- Para um servidor Rational Team Concert externo: https://url:port/ccm e https://url:port/jts para
o Jazz Team Server.
- Na Etapa 2, no campo ID do Administrador Jazz, digite o ID do usuário do administrador para o
servidor Rational Team Concert
(o padrão é admin); em seguida, no campo Senha, digite a senha
para esse usuário (por padrão, é admin). Se o
Rational Team Concert
tiver acabado de ser instalado com o aplicativo de configuração do
servidor, digite o nome de usuário e senha para o administrador do
servidor de aplicativos.
- Na Etapa 3, no campo Nome da Área do Projeto,
digite um nome descritivo para a área do projeto que será criada para os
ciclos de vida (por exemplo, Ciclos de Vida do Rational Asset Manager).
Em seguida, no campo D de Administrador da Área do Projeto, digite
o ID do usuário que deverá ser o administrador da área do projeto. Em seguida, digite a Senha para
esse usuário. Se você estiver usando um servidor Rational Team Concert externo, o administrador
da Área do Projeto provavelmente será um usuário diferente do administrador do servidor
Jazz. Se você estiver instalando um novo Rational Team Concert, o aplicativo de
configuração do servidor sugerirá o uso do ID de Administrador do Jazz como o
ID de Administrador da Área do Projeto.
- Clique em Configurar servidor. Este processo
pode levar alguns minutos. Após a configuração, a página Resumo aparece.
- Na
página Resumo, clique em Iniciar
o uso de Rational Asset Manager.
ou clique em Concluir. O Web client é aberto.
- Migre o repositório do Rational Asset Manager
para a versão mais recente:
- Em um navegador da Web, abra o Web client do Rational Asset Manager. Na primeira vez que você abre o Web client após o upgrade, uma mensagem será exibida indicando que você deve migrar o repositório.
- Se necessário, efetue login com um ID do usuário que tenha autoridade do administrador
de repositório.
Nota: Para o SQL Server, se um banco de dados Rational Asset Manager
existente não tiver o conjunto de ordenação para uma sequência que termina
com _BIN2 (por exemplo, Latin1_General_BIN2), então a página Configuração
Manual Necessária aparece com uma mensagem. É possível recriar o banco de dados
e configurar a opção de ordenação com distinção entre maiúsculas e minúsculas
para funcionar corretamente com o Rational Asset Manager
ou é possível aceitar que pode haver conflitos de distinção entre maiúsculas
e minúsculas inesperados.
- Clique em Migrar. Em grandes repositórios, a migração pode levar vários minutos;
até que a migração seja concluída, algumas informações sobre o repositório
podem não estar disponíveis.
- Após a conclusão do processo de migração, clique em Início.
- Opcional: Atualize o aplicativo Eclipse do Rational Asset Manager
usando o mesmo método usado para sua instalação.
Para obter mais informações sobre a instalação do cliente Eclipse, consulte Instalando o Cliente Eclipse do Rational Asset Manager.
Nota: Antes de
instalar a versão mais recente do cliente Eclipse do
Rational Asset Manager,
desinstale o plug-in do cliente Eclipse do
Rational Asset Manager.
Se você instalou os plug-ins do cliente Eclipse do
Rational Asset Manager
usando o Gerenciador de Atualização Eclipse, antes de instalar a
versão mais recente do
Rational Asset Manager,
use o Gerenciador de Configuração Eclipse para remover todos os
recursos com o nome
Rational Asset Manager.
Para usar o Gerenciador de Configuração Eclipse, no Eclipse, clique em .
O que Fazer Depois
Para o
Rational Asset Manager versão 7.5.1 e
posterior, a URL para o servidor
Rational Team Concert interno foi alterada de
https://host:port/jazz para
https://host:port/ramjazz.
Se estiver fazendo upgrade de um release do
Rational Asset Manager anterior à 7.5.1,
revise as referências de URL e informe aos seus usuários sobre quais mudanças eles devem fazer.
Atualize as URLs nesses locais:
- As conexões do repositório
Rational Team Concert Eclipse IDE que usam a
URL anterior. Para atualizar uma conexão de repositório:
- Abra a visualização Artefatos da Equipe.
- Expanda Conexões do Repositório.
- Clique com o botão direito do mouse na conexão do
Rational Asset Manager e selecione
Propriedades.
- Selecione Conexão do Repositório Jazz.
- No local do URI, altere a URL para http://host_name/ramjazz.
- Clique em OK.
- As propriedades avançadas no servidor
Rational Team Concert que usam a URL
anterior. Para atualizar as propriedades avançadas:
- Abra o Rational Asset Manager em um
navegador da web ao usar a URL revisada: http://host_name/ramjazz/admin
- Efetue logon como o administrador.
- Clique em .
- Atualize as propriedades que incluem a URL anterior. Por exemplo:
com.ibm.ram.repository.service.internal.RepositoryRemoteService
- Os links do Rational Asset Manager que
estão armazenados nos marcadores nos navegadores da web.