Use este guia para fazer upgrade de uma versão anterior do IBM® Rational Asset Manager no
Apache Tomcat.
Antes de Iniciar
Importante: Se você estiver fazendo
upgrade do Rational Asset Manager,
Versão 7.1.1.1 ou anterior, será necessário instalar o IBM Rational Team Concert,
que requer um banco de dados adicional e um certificado seguro para seu servidor
Tomcat.
É necessário 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.
É possível melhorar o desempenho e a estabilidade do Rational Asset Manager instalando
seus aplicativos da Web e os arquivos de aplicativos para o
IBM Rational Team Concert incluído em
servidores Tomcat separados. Em todo este documento, o diretório de instalação para o servidor Tomcat para o Rational Asset Manager é
referido como tomcat_install_directory.
O diretório de instalação para o servidor Tomcat para o Rational Team Concert é tomcat_for_rtc_install_directory.
Se você estiver instalando todos os aplicativos da Web no mesmo servidor Tomcat,
os diretórios serão os mesmos.
Sobre Esta Tarefa
Este esboço mostra o que é necessário para você fazer o upgrade para a versão mais recente do Rational Asset Manager:
- Preparar o upgrade e o backup de arquivos e bancos de dados importantes: etapas 1-4.
- Recuperar arquivos de aplicativo para a versão mais recente do Rational Asset Manager: etapa 5.
- Se estiver fazendo upgrade da V7.1.1.1 ou anterior, criar um banco de dados adicional: etapa
6.
- Encerrar o servidor Tomcat: etapa 7.
- Fazer upgrade do servidor de licença para o Rational Common
Licensing
8.1.2:
etapa
8.
- Copiar novos arquivos de biblioteca compartilhada para o Rational
Asset Manager e para o Rational Common Licensing
8.1.2 e
modificar os arquivos de inicialização do servidor Tomcat de forma
correspondente: etapas
9–11.
- Configurar o servidor Tomcat para conexão única: etapa 12.
- Recuperar arquivos de aplicativo atuais para o Rational Team Concert incluído: etapas 13-14.
- Se estiver fazendo upgrade da V7.1.1.1 ou anterior e precisar do Rational
Team Concert, instale Rational Team Concert no servidor de aplicativos: etapas 17-24.
- Se estiver fazendo upgrade da V7.1.1.1 ou anterior, configurar Rational
Team Concert: etapas 25-31.
- Se estiver fazendo upgrade da V7.2 ou anterior, fazer upgrade do Rational Team Concert incluído: etapa 33.
- Remover arquivos de aplicativo existentes para o Rational Asset Manager
e instalar as novas versões dos aplicativos: etapas 34-39.
- Efetuar login no Rational Asset Manager e migrar para o repositório: etapa 40.
- Se estiver fazendo upgrade da V7.1.1.1 ou anterior, configurar Rational
Asset Manager para se conectar ao Rational Team Concert: etapa 42.
- Modificar suas configurações para se conectar ao novo servidor Rational Common Licensing: etapa
43.
- Fazer upgrade de quaisquer clientes Eclipse: etapa 44.
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.
- 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.
- Verifique se todos os servidores do repositório
estão configurados para a mesma data, hora e fuso horário atuais.
- Se estiver usando o Rational Asset Manager
versão 7.0.0.2 ou anterior, verifique se o servidor de tarefas está ativado.
Para ativar o servidor de tarefas:
- Efetue login no Web client do Rational Asset Manager
como um administrador de repositório.
- Clique em Administração.
- Na barra lateral de Administração do Repositório,
clique em Ferramentas.
- Na
barra de endereço do navegador, substitua tools.faces por advancedConfiguration.faces e
vá para esse endereço. Por exemplo, http://example.com:9080/com.ibm.ram.repository.web/admin/repository/advancedConfiguration.faces
- Na página Configurações Avançadas, na seção Opções
da Tarefa,
selecione Ativar servidor de tarefas.
- Clique em Salvar.
- Reinicie o servidor de aplicativos.
- Recupere os arquivos de aplicativos no archive apropriado
para o Tomcat e para o seu sistema operacional. Os arquivos de aplicativos estão na pasta
archive_extract_location/apps/tomcat/.
- Se você estiver fazendo upgrade da V7.1.1.1 ou anterior: Crie o
banco de dados para ciclos de vida de ativos:
- Pare o servidor ou servidores Tomcat. Seu repositório e qualquer outro aplicativo
em seu servidor agora estarão off-line.


Migre seu Rational
Licensing Server para o
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 do Rational.
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.
- Extraia os arquivos de biblioteca compartilhada para a pasta \shared\lib
para seus servidores Tomcat:
- Localize e extraia o arquivo archive_extract_location\apps\tomcat\sharedLib.zip.
- Copie todo o conteúdo do arquivo
sharedLib.zip extraído para o diretório tomcat_install_directory\shared\lib.

Extraia os arquivos de biblioteca do Rational Licensing Key Server
V8.1.2
para a pasta
tomcat_install_directory\shared\lib:
Importante: Se você estiver instalando no Linux para zSeries, não conclua esta etapa
- Localize e extraia o arquivo
archive_extract_location\sharedLibs\rlsclients_rlsibmratl_812.zip.
- No arquivo .zip extraído, localize o arquivo
rlsibmratl812.zip
para o sistema operacional e a arquitetura. Por exemplo, o arquivo para Windows de 32 bits está no diretório win32.
- Extraia o conteúdo do arquivo
rlsibmratl812.zip
apropriado.
- Copie todo o conteúdo do arquivo
rlsibmratl812.zip extraído para o
diretório
tomcat_install_directory\shared\lib.


Modifique o script de inicialização para o
servidor Tomcat para o Rational Asset Manager- Localize o arquivo de inicialização do Tomcat
e abra-o em um editor de texto. No Windows, este arquivo é tomcat_install_directory\bin\startup.bat.
No Linux, AIX ou Linux para zSeries, ele é tomcat_install_directory/bin/startup.sh.
- Procure uma linha que inclua JAVA_OPTS=.
- Se a variável de ambiente JAVA_OPTS já estiver configurada,
inclua a opção e o valor a seguir:
- Se a variável de ambiente JAVA_OPTS não estiver configurada, digite
o texto a seguir:
- Configure o servidor Tomcat para conexão única
para todos os aplicativos:
- Em um editor de texto, abra o arquivo tomcat_install_directory\conf\server.xml.
- Procure o seguinte texto:
<!--
<Valve className="org.apache.catalina.authenticator.SingleSignOn" />
-->
- Remova o comentário do elemento <Valve>:
<Valve className="org.apache.catalina.authenticator.SingleSignOn" />
- Na mídia de instalação, localize o arquivo archive_extract_location/apps/tomcat/RTC-server.zip.
- Extraia RTC-server.zip para um local
na sua unidade de disco rígido, que é referida nessas instruções
como rtc_install_dir.
- Dependendo da sua situação, instale e configure ou atualize o
Rational Team Concert:
- Se você estiver fazendo upgrade da V7.1.1.1 ou
anterior: Instale e configure o Rational Team Concert incluído.
Prossiga para a etapa 16.
- Se você estiver fazendo upgrade da V7.2 ou posterior:
Atualize o Rational Team Concert incluído.
Prossiga para a etapa 33.
- Dependendo da sua situação, instale e configure ou apenas configure o Rational Team Concert:
- Se for necessário instalar e configurar o Rational Team Concert:
Vá para a etapa 17.
- Se você tiver um aplicativo Rational Team Concert existente
e desejar configurá-lo para trabalhar com o Rational Asset Manager:
Vá para a etapa 25.
- Localize o arquivo rtc_install_dir/jazz/server/ramjazz_war.ear e o extraia. Para extrair arquivos .ear, você pode usar um
utilitário grátis, como 7-Zip. No pacote ramjazz_war.ear extraído,
copie o arquivo ramjazz.war no diretório tomcat_for_rtc_install_directory/webapps/.
- Configure uma porta segura no seu servidor Tomcat para o Rational Team Concert:
- Crie um certificado de segurança que identifique seu servidor Tomcat para o
Rational Team Concert para
conexões SSL. Você pode usar o comando Java JDK keytool
para criar um certificado autoassinado. De forma alternativa, você pode solicitar um
certificado que seja assinado por uma autoridade de certificação confiável.
Para obter mais informações sobre como criar certificados autoassinados com o comando
keytool, consulte a
documentação
do Oracle Java.
Você pode criar um certificado autoassinado com o seguinte comando
keytool de exemplo:
keytool -genkey -alias tomcat -keystore tomcat_for_rtc_install_directory/.keystore
Ao executar este comando, será solicitada a você uma senha
para o arquivo keystore. A senha padrão é changeit,
mas você deve especificar uma diferente. Será necessário lembrar essa
senha para inseri-la no arquivo server.xml mais
tarde.
Se estiver utilizando um IBM JRE,
muitas versões incluem a ferramenta da IBM
ikeyman no diretório IBM_Java_JRE_install_location/jre/bin/.
Essa ferramenta pode ser usada para criar e gerenciar certificados de segurança no
servidor. Para obter informações adicionais sobre como usar a ferramenta iKeyman, consulte o iKeyman User's Guide.
Também incluímos um certificado simples na pasta rtc_install_dir/jazz/server/;
o arquivo de certificado é ibm-team-ssl.keystore
- No arquivo tomcat_for_rtc_install_directory\conf\server.xml, localize a tag <Connector> com o atributo scheme="https".
O arquivo padrão inclui uma tag <Connector> de exemplo
para a porta 8443 que está comentada.
- Copie e cole o seguinte texto:
<Connector port="8443"
maxHttpHeaderSize="8192"
maxThreads="150"
minSpareThreads="25"
maxSpareThreads="75"
enableLookups="false"
disableUploadTimeout="true"
connectionTimeout="20000"
acceptCount="100"
scheme="https"
secure="true"
clientAuth="false"
keystoreFile="keystore_file"
keystorePass="keystore_password"
sslProtocol="keystore_protocol"
algorithm="keystore_algorithm"
URIEncoding="UTF-8" />
Em que:
- keystore_file é o
nome do arquivo do seu arquivo keystore. Ele pode ser um caminho absoluto ou
relativo a partir do diretório-raiz do seu servidor Tomcat(tomcat_for_rtc_install_directory).
Se você usou o comando simples acima, este será .keystore.
Se você utilizar o certificado incluído, ele será rtc_install_dir/jazz/server/ibm-team-ssl.keystore .
- keystore_password é a senha
para o arquivo keystore. Se você utilizar o arquivo keystore incluído,
ele será ibm-team .
- keystore_protocol é o
protocolo para o keystore. Mais provavelmente, é TLS ou SSL_TLS.
Se você utilizar o arquivo keystore incluído, ele será SSL_TLS .
- keystore_algorithm é o
algoritmo X509 para o keystore. Mais provavelmente, é SunX509 ou IbmX509,
dependendo da origem do certificado. Se você utilizar o arquivo keystore incluído,
ele será IbmX509 .
- Você pode alterar o valor de porta para usar uma porta
além de 8443 para o conector não SSL (por
padrão, porta 8080). Se alterar o valor de porta,
altere o valor do atributo redirectPort para que
corresponda ao número da porta para o conector SSL.
Para obter informações adicionais sobre como configurar o SSL para Tomcat, consulte Configuração do SSL do Apache Tomcat 5.5 - INSTRUÇÕES e Configuração do Apache Tomcat - Referência.

Copiar o arquivo .jar apropriado
do provedor de banco de dados:
- Configure as definições de
propriedade de inicialização de Tomcat:
- Localize o arquivo de inicialização do Tomcat
e abra-o em um editor de texto. No Windows, este arquivo é tomcat_for_rtc_install_directory\bin\startup.bat.
No Linux, AIX ou Linux para zSeries, o arquivo é tomcat_for_rtc_install_directory/bin/startup.sh.
- No arquivo de inicialização, digite o seguinte texto:
Substitua cada caractere de espaço no rtc_install_dir por %20:set ORACLE_JDBC=oracle_jar_dir
set SQLSERVER_JDBC=sqlServer_jar_dir
set JAZZ_INSTALL_DIR=rtc_install_dir
set JAVA_OPTS=-Djava.awt.headless=true -Djava.library.path="tomcat_for_rtc_install_directory\shared\lib" -DSQLSERVER_JDBC="%SQLSERVER_JDBC%" -DORACLE_JDBC="%ORACLE_JDBC%" -DDB2I_JDBC="%DB2I_JDBC%" -DDB2Z_JDBC="%DB2Z_JDBC%" -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true -DJAZZ_HOME=file:///%JAZZ_INSTALL_DIR%\jazz\server\conf -Dcom.ibm.team.repository.tempDir=%TEMP% -Xmx700M



ORACLE_JDBC=oracle_jar_dir
SQLSERVER_JDBC=sqlServer_jar_dir
JAZZ_INSTALL_DIR=rtc_install_dir
export JAVA_OPTS="-Djava.awt.headless=true -Djava.library.path=tomcat_for_rtc_install_directory/shared/lib -DSQLSERVER_JDBC=$SQLSERVER_JDBC -DORACLE_JDBC=$ORACLE_JDBC -DDB2I_JDBC=$DB2I_JDBC -DDB2Z_JDBC=$DB2Z_JDBC -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true -DJAZZ_HOME=file://"$JAZZ_INSTALL_DIR"/jazz/server/conf -Dcom.ibm.team.repository.tempDir=$TEMP_DIR -Xmx700M"
- Localize e renomeie o arquivo de propriedades do servidor Jazz apropriado:
- No diretóriortc_install_dir/jazz/server/conf/ramjazz/,
localize o arquivo teamserver.properties e renomeie-o como
teamserver.derby.properties.
- Localize o arquivo apropriado para seu servidor de banco de dados:

Para DB2 no Windows: teamserver.db2.win32.properties



Para DB2 no Linux, AIX ou Linux para
zSeries: teamserver.db2.linux.properties
teamserver.oracle.properties
teamserver.sqlserver.properties
- Renomeie o arquivo para teamserver.properties.
- Em um editor de texto, abra o arquivo teamserver.properties
e modifique-o da seguinte maneira (para o provedor de banco de dados):

- Localize as seguintes linhas:
com.ibm.team.repository.db.vendor = DB2
com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:user=db2admin;password={password};
com.ibm.team.repository.db.jdbc.password=db2admin
- Edite o valor de com.ibm.team.repository.db.jdbc.location
para o local do servidor DB2 e o nome
do banco de dados para ciclos de vida:
- Substitua localhost:50000 pelo local e
porta do banco de dados DB2.
Dica: Na janela de comando do DB2, digite
db2 get dbm cfg e, em seguida, localize a linha
que contém SVCENAME, que indica o nome ou número da porta do DB2. Se este comando exibir um número, use-o como o número da porta (no lugar de 50000 no exemplo
anterior). Se o comando retornar
um nome não-numérico, determine o número da porta designado para este nome
e use esse número da porta. No Linux,
o arquivo /etc/services contém o mapeamento entre
nomes e números de portas; no Windows,
o arquivo C:\windows\system32\drivers\etc\services
contém o mapeamento. Para obter informações adicionais, consulte o administrador de banco de dados
ou a documentação do banco de dados.
- Substitua JAZZ pelo nome do banco de dados para ciclos de vida.
- Substitua db2admin pelo nome de usuário para o banco de dados DB2.
Nota: O usuário do DB2 deve ter permissões para
criar tabelas, espaços de tabela e para modificar a configuração do banco de dados. Os usuários do DB2 são criados pelo
sistema operacional.
- Na propriedade com.ibm.team.repository.db.jdbc.password,
especifique a senha de usuário.
Nota: Não
altere o texto password={password} na
propriedade com.ibm.team.repository.db.jdbc.location.
- No arquivo teamserver.properties,
inclua as seguintes propriedades:
Em que:
- unsecure_port é a porta não segura para o servidor
Tomcat (por padrão, 8080)
- secure_port é o número da porta segura para o servidor
Tomcat (por padrão, 8443)
- team_temp_dir é um caminho absoluto para um diretório
para armazenar arquivos temporários
com.ibm.team.scm.tmpdir=team_temp_dir
com.ibm.team.repository.server.repourl.port.http=unsecure_port
com.ibm.team.repository.user.registry.type=UNSUPPORTED
com.ibm.team.repository.ws.allow.admin.access=false
com.ibm.team.repository.server.repourl.port.https=secure_port

- Localize as seguintes linhas:
com.ibm.team.repository.db.vendor = ORACLE
com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@localhost:1521/ORCL
com.ibm.team.repository.db.jdbc.password=jazzDBpswd
- Edite o valor de com.ibm.team.repository.db.jdbc.location
para o local do servidor Oracle e o nome do banco de dados para ciclos de vida:
- Substitua jazzDBUser pelo nome de usuário para
o banco de dados do Oracle (por exemplo, RAMSCHEMA.
- Substitua @localhost:1521 pelo local e porta
para o banco de dados Oracle. Se o local não for localhost,
será necessário preceder o local com duas barras (//);
por exemplo, @//oracleserver.example.com:1521.
- Substitua ORCL pelo nome do banco de dados do ciclo de vida;
por exemplo, rtcdb.
- Na propriedade com.ibm.team.repository.db.jdbc.password,
substitua JazzDBpswd pela senha para o usuário do Oracle especificada
anteriormente.
Nota: Não altere o texto {password} na
propriedade com.ibm.team.repository.db.jdbc.location.
- No arquivo teamserver.properties,
inclua as seguintes propriedades:
Em que:
- unsecure_port é a porta não segura para o servidor
Tomcat (por padrão, 8080)
- secure_port é o número da porta segura para o servidor
Tomcat (por padrão, 8443)
- team_temp_dir é um caminho absoluto para um diretório
para armazenar arquivos temporários
com.ibm.team.scm.tmpdir=team_temp_dir
com.ibm.team.repository.server.repourl.port.http=unsecure_port
com.ibm.team.repository.user.registry.type=UNSUPPORTED
com.ibm.team.repository.ws.allow.admin.access=false
com.ibm.team.repository.server.repourl.port.https=secure_port
- Se estiver utilizando Oracle 11: No arquivo teamserver.properties,
inclua a seguinte propriedade:
com.ibm.team.repository.db.override.versioncheck=true

- Localize as seguintes linhas:
com.ibm.team.repository.db.vendor = SQLSERVER
com.ibm.team.repository.db.jdbc.location=//localhost:1433;databaseName=jazz;user=jazzDBuser;password={password}
com.ibm.team.repository.db.jdbc.password=jazzDBpswd
- Edite o valor de com.ibm.team.repository.db.jdbc.location
para o local do SQL Server e o nome do banco de dados para ciclos de vida:
- Substitua @localhost:1433 pelo local e porta
para o banco de dados SQL Server.
- Substitua jazz pelo nome do banco de dados do ciclo de vida;
por exemplo, RTCDB.
- Substitua jazzDBUser pelo nome de usuário
para o banco de dados SQL Server.
- Na propriedade com.ibm.team.repository.db.jdbc.password,
substitua JazzDBpswd pela senha para o usuário do servidor SQL
especificada anteriormente.
Nota: Não altere o texto {password} na
propriedade com.ibm.team.repository.db.jdbc.location.
- No arquivo teamserver.properties,
inclua as seguintes propriedades:
Em que:
- unsecure_port é a porta não segura para o servidor
Tomcat (por padrão, 8080)
- secure_port é o número da porta segura para o servidor
Tomcat (por padrão, 8443)
- team_temp_dir é um caminho absoluto para um diretório
para armazenar arquivos temporários
com.ibm.team.scm.tmpdir=team_temp_dir
com.ibm.team.repository.server.repourl.port.http=unsecure_port
com.ibm.team.repository.user.registry.type=UNSUPPORTED
com.ibm.team.repository.ws.allow.admin.access=false
com.ibm.team.repository.server.repourl.port.https=secure_port
- Crie as tabelas para o Rational Team Concert:
- Abra uma janela de linha de comandos e navegue para o diretório
rtc_install_dir/jazz/server/.
- Insira o seguinte comando:
- Configure a autorização do usuário para o Rational Team Concert incluído.
- Para segurança baseada em arquivo:
- Em um editor de texto, abra o arquivo tomcat_for_rtc_install_directory\conf\tomcat-users.xml.
- Entre as tags <tomcat-users>,
cole o seguinte texto:
<role rolename="JazzUsers"/>
<role rolename="JazzAdmins"/>
<role rolename="JazzDWAdmins"/>
<role rolename="JazzGuests"/>
- Inclua um usuário denominado admin e
designe a esse usuário as funções admin, manager e JazzAdmins. Para incluir este usuário,
você pode copiar e colar o seguinte texto entre as tags <tomcat-users>:
<user username="admin" password="" roles="admin,manager,JazzAdmins" />
Se
você estiver instalando os aplicativos no mesmo servidor Tomcat, inclua
a função JazzAdmins no usuário admin existente.
- Para autenticação LDAP: Configure o servidor Tomcat
para autenticação LDAP e, em seguida, configure quatro grupos LDAP com
os mesmos nomes que as quatro funções mencionadas anteriormente. De forma alternativa, você pode associar grupos LDAP
existentes às funções do servidor Jazz conforme descrito na Dica de Tecnologia TN0030:
Gerenciamento de Usuários no Tomcat. Siga as etapas 2–3 na seção Configurando o Rational Team Concert no Tomcat para Usar LDAP do tópico.
- Inicie o servidor Tomcat para
Rational Team Concert.
Para iniciar o Tomcat, execute o seguinte arquivo:
tomcat_for_rtc_install_directory\bin\startup.bat


tomcat_for_rtc_install_directory/bin/startup.sh
- Ative a Interface administrativa da Web do
Rational Team Concert
em um navegador da Web em https://machine_name:secure_port/jazz/admin/. Observe o https; a conexão deve ser segura.
- Efetue login com o ID do usuário e a senha para o administrador do Rational Team Concert. Se ninguém tiver efetuado login no Rational Team Concert antes,
use o ID do usuário e a senha para o administrador do servidor de
aplicativos.
- Se você estiver trabalhando com uma nova instalação do Rational Team Concert: Configure
o usuário administrativo para o Rational Team Concert:
- Se você vir um erro sobre "como buscar informações de status do servidor",
encerre e reinicie seu servidor de banco de dados e seu servidor de aplicativos
e efetue login novamente.
- Na Interface administrativa da Web do Rational Team Concert, clique em Gerenciamento de Usuário. Ignore quaisquer erros sobre um
registro externo que não está sendo configurado.
- Clique em Criar Usuário.
- Insira os seguintes detalhes:
- Nome de Usuário: O ID do usuário do administrador do
servidor de aplicativos
- ID do Usuário: O ID do usuário do administrador do
servidor de aplicativos
- Endereço de E-mail: Um endereço de e-mail válido para o
administrador do servidor de aplicativos
- Na seção Licença de Acesso do Cliente, selecione Rational
Team Concert - Desenvolvedor para designar a licença de desenvolvedor
a esse usuário.
- Clique em Salvar.
- Efetue logout e, em seguida, efetue login novamente na Interface
administrativa da Web como o administrador do servidor de aplicativos.
- Importe o modelo de processo de
ciclos de vida para o Rational Team Concert:
- Na Interface administrativa da Web do Rational Team Concert, clique em Gerenciamento de Modelos de Processo. Se não for possível ver o link Gerenciamento de Modelos de Processo,
efetue logout e, em seguida, efetue login novamente na Interface administrativa da Web.
- Clique em Importar Modelo e navegue
para o arquivo com.ibm.ram.lifecycle.zip na pasta archive_extract_location/DatabaseScripts/.
Em seguida, clique em OK. O modelo de Ciclo de Vida RAM
é exibido.
- Crie uma área do projeto no Rational Team Concert:
- Na Na Interface administrativa da Web do Rational Team Concert, clique em Gerenciamento
da Área do Projeto. Se não for possível ver o link Gerenciamento da Área do Projeto,
efetue logout e, em seguida, efetue login novamente na Interface administrativa da Web.
- Clique em Criar Área do Projeto.
- Insira os seguintes detalhes sobre a área do projeto:
- Nome do projeto: Ciclo de Vida do RAM
- Resumo: Área do projeto de controle de Ciclo de Vida do Rational Asset Manager
- Descrição: Esta área é usada para gerenciar
os ciclos de vida do Rational Asset Manager
- Clique em Salvar.
- Designe as associações e funções do processo apropriadas
para a área do projeto:
- Na página Gerenciamento da Área do Projeto, clique na área do projeto Ciclo de Vida do RAM.
- Na seção Administradores, clique em Incluir.
Procure e selecione o usuário administrador criado. Se estiver
trabalhando com um aplicativo existente Rational Team Concert,
você também poderá selecionar um usuário diferente para ser o administrador
para esta área do projeto.
- Na seção Membros, clique em Incluir;
em seguida, procure e selecione o mesmo usuário selecionado como o
administrador para a área do projeto.
- Depois de incluir o administrador, clique no ícone Funções
do Processo junto ao nome do administrador.
- Na janela Editar Funções do Processo, na lista Funções
Disponíveis, selecione Administração
e clique em Incluir.
- Clique em Concluir.
- Clique em Salvar.
- Se você estiver fazendo upgrade da V7.1.1.1 ou
anterior: Vá para a etapa 34.
- Se você estiver fazendo upgrade da V7.2 ou posterior,
faça upgrade do Rational Team Concert incluído:
- A partir da mídia de instalação, extraia o arquivo
RTC-Server.zip para um novo local na sua
unidade de disco rígido, que, nestas instruções, é referida como new_rtc_install_dir.
- Da pasta rtc_install_dir/jazz/server/conf/jazz/ mais antiga,
copie o arquivo teamserver.properties para a nova pasta new_rtc_install_dir/jazz/server/conf/jazz/.
É possível localizar o local rtc_install_dir existente
no arquivo de inicialização de Tomcat. No arquivo de inicialização, procure a linha
que contém JAZZ_INSTALL_DIR=; o valor da variável
JAZZ_INSTALL_DIR é o local dos arquivos atuais do Rational Team Concert.
- Localize o arquivo de inicialização do Tomcat
e abra-o em um editor de texto. No Windows, este arquivo é tomcat_for_rtc_install_directory\bin\startup.bat.
No Linux, AIX ou Linux para zSeries, o arquivo é tomcat_for_rtc_install_directory/bin/startup.sh.
- No arquivo de inicialização de Tomcat, procure a linha que contém
JAZZ_INSTALL_DIR=. Edite o valor
pelo seguinte, em que new_rtc_install_dir
é o diretório extraído da etapa 33.a:
- Inicie o servidor Tomcat.
- Em um navegador da Web, insira a seguinte URL: https://host:secure_port/jazz/admin?internal,
em que host é o endereço IP ou nome do servidor e secure_port é a porta segura para o servidor Tomcat.
- Efetue logon como um administrador do servidor de aplicativos.
- Na barra lateral, em Ferramentas Internas,
clique em Reconfiguração do servidor.
- Clique em Solicitar reconfiguração do servidor.
- Pare e, em seguida, reinicie o servidor Tomcat. O aplicativo Rational Team Concert incluído
é atualizado.
- Pare o servidor Tomcat para Rational Asset Manager.
- Remova os arquivos de aplicativo da Web .war antigos do Rational Asset Manager instalados no Tomcat:
- Navegue para o diretório tomcat_install_directory/webapps/.
- Anote as pastas e os nomes de arquivos para quaisquer aplicativos da Web do Rational Asset Manager. Em versões anteriores do Rational Asset Manager,
foram sugeridos os nomes a seguir para essas pastas (em outras palavras,
os caminhos de contexto dos aplicativos):
- /com.ibm.ram.repository.web.tomcat_runtime
- /com.ibm.ram.repository.web.ws.tomcat_runtime
- /help/
- /abdprocess/
- Exclua os seguintes arquivos de aplicativos:
- com.ibm.ram.repository.web.tomcat_runtime.war
- com.ibm.ram.repository.web.ws.tomcat_runtime.war
- ramhelp.war
- rmcabdgovernprocess.war
Os nomes de arquivos podem ser diferentes dos nomes na lista,
dependendo de como você instalou os aplicativos no seu servidor.
- Exclua as pastas associadas para esses aplicativos.
- Do diretório archive_extract_location/apps/tomcat/, copie os seguintes arquivos para o diretório
tomcat_install_directory/webapps/:
- com.ibm.ram.repository.web.tomcat_runtime.war
- com.ibm.ram.repository.web.ws.tomcat_runtime.war
- ramhelp.war
- rmcabdgovernprocess.war
- Para alterar o caminho de contexto dos aplicativos,
renomeie os arquivos de aplicativos WAR. Use os mesmos caminhos de contexto de antes. Os nomes de arquivos
e os caminhos de contexto para novas instalações são os seguintes:
Tabela 1. Caminhos de Contexto para Arquivos de Aplicativos da Web do Rational Asset Manager| Nome do arquivo original |
Novo
nome do arquivo |
Caminho de contexto resultante |
O que é isso? |
| com.ibm.ram.repository.web.tomcat_runtime.war |
ram.war |
ram |
Aplicativo da Web primário do Rational Asset Manager
para Tomcat |
| com.ibm.ram.repository.web.ws.tomcat_runtime.war |
ram.ws.war |
ram.ws |
Aplicativo de serviços da Web do Rational Asset Manager
para Tomcat |
| ramhelp.war |
ram.help.war |
ram.help |
Aplicativo de assistência ao usuário e de ajuda do Rational Asset Manager |
| rmcabdgovernprocess.war |
ram.process.war |
ram.process |
Aplicativo de documentação para processos de controle e
desenvolvimento baseados em ativos |
- Limpe o cache para o servidor Tomcat. Exclua o diretório tomcat_install_directory/work/.
- Reinicie o servidor Tomcat para Rational Asset Manager.
- 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.
- Após migrar o repositório, pare e, em seguida, reinicie o servidor de aplicativos.
- Se você estiver fazendo upgrade da V7.1.1.1 ou
anterior: Configure
as definições para conectar ao Rational Team Concert a partir do Rational Asset Manager:
- No Web client do Rational Asset Manager,
clique em Administração.
- Clique em Configuração.
- Na seção Caminho Interno do Rational Team Concert,
digite as seguintes informações:
- Caminho: A URL segura para o servidor Rational Team Concert que
você configurou. Por exemplo, https://localhost:9443/ramjazz.
Anote a conexão https e o número da porta segura.
- Usuário: O nome de usuário para o usuário no Rational Team Concert que
é o administrador para a área do projeto "RAM Lifecycles".
- Senha: A senha para o usuário que é o
administrador para a área do projeto "RAM Lifecycles".
- Tempo Limite: O período de tempo, em segundos, para permitir
que o Rational Asset Manager conecte-se
ao Rational Team Concert.
O padrão é 120.
- Para fazer upgrade, é necessário arquivar uma solicitação para uma nova
chave de licença. É necessário adquirir um nova licença de servidor e novas
licenças autorizadas de usuário.
Acesse o Rational License
Key Center: http://www-01.ibm.com/software/rational/support/licensing/ Se você visualizar um erro sobre o Rational License Server, ajuste sua configuração de licença:
- Clique em Administração
- Na página Administração, clique em Configuração.
- Na seção Licença e Versão, para selecionar qual tipo de licença de servidor
este repositório usa, selecione Standard edition ou
Enterprise edition.
- Na parte inferior da página,
clique em Salvar.
- O erro do License Server pode ser exibido novamente.
Clique em Tentar novamente a
conexão com o servidor de licença.
- 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 o cliente Eclipse do Rational Asset Manager V7.0.0.2
em um aplicativo Eclipse V3.3 existente usando o
Installation Manager, use o Installation Manager para desinstalar o cliente.
Não é possível usar o Gerenciador de Configuração Eclipse para desinstalar o Rational Asset Manager a partir
do cliente Eclipse.
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 .