Fazendo Upgrade de uma Versão Anterior no Tomcat

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:
  1. Preparar o upgrade e o backup de arquivos e bancos de dados importantes: etapas 1-4.
  2. Recuperar arquivos de aplicativo para a versão mais recente do Rational Asset Manager: etapa 5.
  3. Se estiver fazendo upgrade da V7.1.1.1 ou anterior, criar um banco de dados adicional: etapa 6.
  4. Encerrar o servidor Tomcat: etapa 7.
  5. Fazer upgrade do servidor de licença para o Rational Common Licensing 8.1.2: etapa 8.
  6. 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 911.
  7. Configurar o servidor Tomcat para conexão única: etapa 12.
  8. Recuperar arquivos de aplicativo atuais para o Rational Team Concert incluído: etapas 13-14.
  9. 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.
  10. Se estiver fazendo upgrade da V7.1.1.1 ou anterior, configurar Rational Team Concert: etapas 25-31.
  11. Se estiver fazendo upgrade da V7.2 ou anterior, fazer upgrade do Rational Team Concert incluído: etapa 33.
  12. Remover arquivos de aplicativo existentes para o Rational Asset Manager e instalar as novas versões dos aplicativos: etapas 34-39.
  13. Efetuar login no Rational Asset Manager e migrar para o repositório: etapa 40.
  14. Se estiver fazendo upgrade da V7.1.1.1 ou anterior, configurar Rational Asset Manager para se conectar ao Rational Team Concert: etapa 42.
  15. Modificar suas configurações para se conectar ao novo servidor Rational Common Licensing: etapa 43.
  16. Fazer upgrade de quaisquer clientes Eclipse: etapa 44.

Procedimento

  1. 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.
  2. 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 Administração > Ferramentas) e, em seguida, depois de ter atualizado o servidor, reaplique o tema e suas mensagens. Para obter mais informações, consulte Migrando o Tema.
  3. Verifique se todos os servidores do repositório estão configurados para a mesma data, hora e fuso horário atuais.
  4. 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:
    1. Efetue login no Web client do Rational Asset Manager como um administrador de repositório.
    2. Clique em Administração.
    3. Na barra lateral de Administração do Repositório, clique em Ferramentas.
    4. 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
    5. Na página Configurações Avançadas, na seção Opções da Tarefa, selecione Ativar servidor de tarefas.
    6. Clique em Salvar.
    7. Reinicie o servidor de aplicativos.
  5. 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/.
  6. Se você estiver fazendo upgrade da V7.1.1.1 ou anterior: Crie o banco de dados para ciclos de vida de ativos:
  7. Pare o servidor ou servidores Tomcat. Seu repositório e qualquer outro aplicativo em seu servidor agora estarão off-line.
  8. Para Windows:Para Linux:Para AIX: 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.
  9. Extraia os arquivos de biblioteca compartilhada para a pasta \shared\lib para seus servidores Tomcat:
    1. Localize e extraia o arquivo archive_extract_location\apps\tomcat\sharedLib.zip.
    2. Copie todo o conteúdo do arquivo sharedLib.zip extraído para o diretório tomcat_install_directory\shared\lib.
  10. Para Windows: Para Linux:Para AIX: 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
    1. Localize e extraia o arquivo archive_extract_location\sharedLibs\rlsclients_rlsibmratl_812.zip.
    2. 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.
    3. Extraia o conteúdo do arquivo rlsibmratl812.zip apropriado.
    4. Copie todo o conteúdo do arquivo rlsibmratl812.zip extraído para o diretório tomcat_install_directory\shared\lib.
  11. Para Windows:Para Linux:Para AIX: Modifique o script de inicialização para o servidor Tomcat para o Rational Asset Manager
    1. 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.
    2. 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:
        • Para Windows:
          -Djava.library.path="tomcat_install_directory\shared\lib"
        • Para Linux:Para AIX:
          -Djava.library.path=tomcat_install_directory/shared/lib
      • Se a variável de ambiente JAVA_OPTS não estiver configurada, digite o texto a seguir:
        • Para Windows:
          set JAVA_OPTS=-Djava.library.path="tomcat_install_directory\shared\lib"
        • Para Linux:Para AIX:
          export JAVA_OPTS="-Djava.library.path=tomcat_install_directory/shared/lib"
  12. Configure o servidor Tomcat para conexão única para todos os aplicativos:
    1. Em um editor de texto, abra o arquivo tomcat_install_directory\conf\server.xml.
    2. Procure o seguinte texto:
      <!--
      <Valve className="org.apache.catalina.authenticator.SingleSignOn" />
      -->
    3. Remova o comentário do elemento <Valve>:
      <Valve className="org.apache.catalina.authenticator.SingleSignOn" />
  13. Na mídia de instalação, localize o arquivo archive_extract_location/apps/tomcat/RTC-server.zip.
  14. Extraia RTC-server.zip para um local na sua unidade de disco rígido, que é referida nessas instruções como rtc_install_dir.
  15. 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.
  16. 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.
  17. 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/.
  18. Configure uma porta segura no seu servidor Tomcat para o Rational Team Concert:
    1. 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

    2. 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.
    3. 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 .
    4. 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.

  19. Para Oracle:Para Microsoft SQL Server: Copiar o arquivo .jar apropriado do provedor de banco de dados:
    • Para Oracle: Copie o arquivo ojdbc14.jar na pasta rtc_install_dir/jazz/server/oracle (talvez seja necessário criar a pasta oracle).

      É possível fazer o download do arquivo a partir do Oracle. Se estiver utilizando Oracle 11, faça o download do pacote para Oracle 10g para localizar o arquivo ojdbc14.jar.

    • Para Microsoft SQL Server: Copie o seguinte arquivo para a pasta rtc_install_dir/jazz/server/sqlserver (talvez seja necessário criar a pasta sqlserver):
  20. Configure as definições de propriedade de inicialização de Tomcat:
    1. 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.
    2. No arquivo de inicialização, digite o seguinte texto:
      • Para Windows: 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
      • Para Linux:Para AIX:Para Linux zSeries:
        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"
      Em que:
      • rtc_install_dir é o diretório extraído do arquivo RTC-server.zip. No Windows, substitua cada caractere de espaço no rtc_install_dir por %20
      • Para Oracle: oracle_jar_dir é o diretório para o arquivo ojdbc14.jar (rtc_install_dir/jazz/server/oracle)
      • Para Microsoft SQL Server: sqlServer_jar_dir é o diretório do arquivo sqljdbc.jar (rtc_install_dir/jazz/server/sqlserver)
      • tomcat_for_rtc_install_directory é o diretório de instalação para o servidor Tomcat
      • Para Windows: Para Linux:Para AIX: Se estiver instalando o Rational Asset Manager e o Rational Team Concert no mesmo servidor de aplicativos, use esta variável do sistema JAVA_OPTS para substituir aquela criada quando você configurou o script de inicialização para o servidor Tomcat para o Rational Asset Manager; esta declaração ainda inclui a opção -Djava.library.path.
  21. Localize e renomeie o arquivo de propriedades do servidor Jazz apropriado:
    1. No diretóriortc_install_dir/jazz/server/conf/ramjazz/, localize o arquivo teamserver.properties e renomeie-o como teamserver.derby.properties.
    2. Localize o arquivo apropriado para seu servidor de banco de dados:
      • Para DB2:Para Windows:Para DB2 no Windows: teamserver.db2.win32.properties
      • Para DB2:Para Linux:Para AIX:Para Linux zSeries:Para DB2 no Linux, AIX ou Linux para zSeries: teamserver.db2.linux.properties
      • Para Oracle: teamserver.oracle.properties
      • Para Servidor SQL: teamserver.sqlserver.properties
    3. Renomeie o arquivo para teamserver.properties.
  22. Em um editor de texto, abra o arquivo teamserver.properties e modifique-o da seguinte maneira (para o provedor de banco de dados):
    • Para DB2:
      1. 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
      2. 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:
        1. 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.
        2. Substitua JAZZ pelo nome do banco de dados para ciclos de vida.
        3. 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.
      3. 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.
      4. 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
    • Para Oracle:
      1. 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
      2. 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:
        1. Substitua jazzDBUser pelo nome de usuário para o banco de dados do Oracle (por exemplo, RAMSCHEMA.
        2. 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.
        3. Substitua ORCL pelo nome do banco de dados do ciclo de vida; por exemplo, rtcdb.
      3. 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.
      4. 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
      5. Se estiver utilizando Oracle 11: No arquivo teamserver.properties, inclua a seguinte propriedade:
        com.ibm.team.repository.db.override.versioncheck=true
    • Para Microsoft SQL Server:
      1. 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
      2. 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:
        1. Substitua @localhost:1433 pelo local e porta para o banco de dados SQL Server.
        2. Substitua jazz pelo nome do banco de dados do ciclo de vida; por exemplo, RTCDB.
        3. Substitua jazzDBUser pelo nome de usuário para o banco de dados SQL Server.
      3. 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.
      4. 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
  23. Crie as tabelas para o Rational Team Concert:
    1. Abra uma janela de linha de comandos e navegue para o diretório rtc_install_dir/jazz/server/.
    2. Insira o seguinte comando:
      • Para Windows:
        repotools.bat -createTables teamserver.properties=conf\jazz\teamserver.properties
      • Para Linux:Para AIX:Para Linux zSeries:
        ./repotools.sh -createTables teamserver.properties=conf/jazz/teamserver.properties
  24. Configure a autorização do usuário para o Rational Team Concert incluído.
    • Para segurança baseada em arquivo:
      1. Em um editor de texto, abra o arquivo tomcat_for_rtc_install_directory\conf\tomcat-users.xml.
      2. Entre as tags <tomcat-users>, cole o seguinte texto:
        <role rolename="JazzUsers"/>
        <role rolename="JazzAdmins"/>
        <role rolename="JazzDWAdmins"/>
        <role rolename="JazzGuests"/>
      3. 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 23 na seção Configurando o Rational Team Concert no Tomcat para Usar LDAP do tópico.
  25. Inicie o servidor Tomcat para Rational Team Concert.
    Para iniciar o Tomcat, execute o seguinte arquivo:
    • Para Windows:tomcat_for_rtc_install_directory\bin\startup.bat
    • Para Linux:Para AIX:Para Linux zSeries:tomcat_for_rtc_install_directory/bin/startup.sh
  26. 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.
  27. 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.
  28. Se você estiver trabalhando com uma nova instalação do Rational Team Concert: Configure o usuário administrativo para o Rational Team Concert:
    1. 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.
    2. 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.
    3. Clique em Criar Usuário.
    4. Insira os seguintes detalhes:
      1. Nome de Usuário: O ID do usuário do administrador do servidor de aplicativos
      2. ID do Usuário: O ID do usuário do administrador do servidor de aplicativos
      3. Endereço de E-mail: Um endereço de e-mail válido para o administrador do servidor de aplicativos
    5. 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.
    6. Clique em Salvar.
    7. Efetue logout e, em seguida, efetue login novamente na Interface administrativa da Web como o administrador do servidor de aplicativos.
  29. Importe o modelo de processo de ciclos de vida para o Rational Team Concert:
    1. 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.
    2. 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.
  30. Crie uma área do projeto no Rational Team Concert:
    1. 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.
    2. Clique em Criar Área do Projeto.
    3. 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
    4. Clique em Salvar.
  31. Designe as associações e funções do processo apropriadas para a área do projeto:
    1. Na página Gerenciamento da Área do Projeto, clique na área do projeto Ciclo de Vida do RAM.
    2. 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.
    3. 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.
    4. Depois de incluir o administrador, clique no ícone Funções do Processo junto ao nome do administrador.
    5. Na janela Editar Funções do Processo, na lista Funções Disponíveis, selecione Administração e clique em Incluir.
    6. Clique em Concluir.
    7. Clique em Salvar.
  32. Se você estiver fazendo upgrade da V7.1.1.1 ou anterior: Vá para a etapa 34.
  33. Se você estiver fazendo upgrade da V7.2 ou posterior, faça upgrade do Rational Team Concert incluído:
    1. 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.
    2. 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.

    3. 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.
    4. 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:
      • Para Windows: (substitua os caracteres de espaço em new_rtc_install_dir por %20):
        set JAZZ_INSTALL_DIR=new_rtc_install_dir
      • Para Linux:Para AIX:Para Linux zSeries::
        JAZZ_INSTALL_DIR=new_rtc_install_dir
    5. Inicie o servidor Tomcat.
    6. 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.
    7. Efetue logon como um administrador do servidor de aplicativos.
    8. Na barra lateral, em Ferramentas Internas, clique em Reconfiguração do servidor.
    9. Clique em Solicitar reconfiguração do servidor.
    10. Pare e, em seguida, reinicie o servidor Tomcat. O aplicativo Rational Team Concert incluído é atualizado.
  34. Pare o servidor Tomcat para Rational Asset Manager.
  35. Remova os arquivos de aplicativo da Web .war antigos do Rational Asset Manager instalados no Tomcat:
    1. Navegue para o diretório tomcat_install_directory/webapps/.
    2. 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/
    3. 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.
    4. Exclua as pastas associadas para esses aplicativos.
  36. 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
  37. 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
  38. Limpe o cache para o servidor Tomcat. Exclua o diretório tomcat_install_directory/work/.
  39. Reinicie o servidor Tomcat para Rational Asset Manager.
  40. Migre o repositório do Rational Asset Manager para a versão mais recente:
    1. 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.
    2. 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.
    3. 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.
    4. Após a conclusão do processo de migração, clique em Início.
  41. Após migrar o repositório, pare e, em seguida, reinicie o servidor de aplicativos.
  42. 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:
    1. No Web client do Rational Asset Manager, clique em Administração.
    2. Clique em Configuração.
    3. Na seção Caminho Interno do Rational Team Concert, digite as seguintes informações:
      1. 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.
      2. 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".
      3. Senha: A senha para o usuário que é o administrador para a área do projeto "RAM Lifecycles".
      4. 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.
  43. 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:
    1. Clique em Administração
    2. Na página Administração, clique em Configuração.
    3. 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.
    4. Na parte inferior da página, clique em Salvar.
    5. O erro do License Server pode ser exibido novamente. Clique em Tentar novamente a conexão com o servidor de licença.
  44. 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 Ajuda > Atualizações de Software > Gerenciar Configuração.


Feedback