Use este guia para fazer upgrade de uma versão anterior do IBM® Rational Asset Manager no
Apache Tomcat.
Antes de Iniciar
Importante: Além disso, você
deverá instalar o IBM Rational Team Concert,
que requer um banco de dados adicional e um certificado seguro para seu servidor
Tomcat.
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.
É 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 você deve 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: etapa 1.
- Recuperar arquivos de aplicativo para a versão mais recente do Rational Asset Manager: etapa 4.
- Se estiver fazendo upgrade da V7.1.1.1 ou anterior, criar um banco de dados adicional: etapa
5.
- Encerrar o servidor Tomcat: etapa 6.
- Fazer upgrade do servidor de licença para o Rational Common
Licensing
8.1.2:
etapa
7.
- 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
8–10.
- Configurar o servidor Tomcat para conexão única: etapa 11.
- Recuperar arquivos de aplicativo atuais para o Rational Team Concert incluído: etapas 12-13.
- 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 16-23.
- Se estiver fazendo upgrade da V7.1.1.1 ou anterior, configurar Rational
Team Concert: etapas 24-30.
- Se estiver fazendo upgrade da V7.2 ou anterior, fazer upgrade do Rational Team Concert incluído: etapa 32.
- Remover arquivos de aplicativo existentes para o Rational Asset Manager
e instalar as novas versões dos aplicativos: etapas 33-38.
- Efetuar login no Rational Asset Manager e migrar para o repositório: etapa 39.
- Se estiver fazendo upgrade da V7.1.1.1 ou anterior, configurar Rational
Asset Manager para se conectar ao Rational Team Concert: etapa 40.
- Fazer upgrade de quaisquer clientes Eclipse: etapa 41.
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.
- 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 do ativo:
- 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 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 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\lib.

Extraia os arquivos de biblioteca para o
Rational Licensing
Key Server V8.1.2 para a
pasta tomcat_install_directory\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 o
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.
Para o Tomcat 6 ou 7, copie todo o conteúdo do arquivo rlsibmratl812.zip extraído
para o diretório tomcat_install_directory\lib.


Modifique o script de inicialização para o servidor
Tomcat para 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" />
- Se você não estiver executando o Tomcat como um serviço, em um editor de
texto, abra o arquivo startup.bat (no Microsoft Windows) ou o arquivo startup.sh
(no Linux). Inclua a seguinte linha no arquivo. Para Microsoft Windows:
SET JAVA_OPTS=" -Dorg.apache.catalina.authenticator.Constants.SSO_SESSION_COOKIE_NAME=JSSOSESSIONID"
No Linux:
export JAVA_OPTS=" -Dorg.apache.catalina.authenticator.Constants.SSO_SESSION_COOKIE_NAME=JSSOSESSIONID"
- Se você estiver executando o Tomcat como um serviço, inclua as seguintes
opções no comando de instalação do serviço usado para instalar o Tomcat
como um serviço: --JvmOptions "-Xrs; -Dorg.apache.catalina.authenticator.Constants.SSO_SESSION_COOKIE_NAME=JSSOSESSIONID"
- 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 15.
- Se você estiver fazendo upgrade da V7.2 ou posterior:
Atualize o Rational Team Concert incluído.
Prossiga para a etapa 32.
- 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 16.
- Se você tiver um aplicativo Rational Team Concert existente
e desejar configurá-lo para trabalhar com o Rational Asset Manager:
Vá para a etapa 24.
- 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 mais informações sobre como configurar o SSL para Tomcat, consulte Configuração do SSL do Apache Tomcat 7 - 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 for 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 usando o 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 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 33.
- 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 32.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.
- 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/ramccm.
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.
- 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.