Implementando os Aplicativos do Servidor Rational Asset Manager no Tomcat 5.5

É possível instalar manualmente o IBM® Rational Asset Manager em uma instalação do Apache Tomcat.

Antes de Iniciar

É necessário ter acesso administrativo e de arquivo a um servidor Tomcat que esteja instalado e em execução.

Você deve saber o local dos seguintes arquivos .jar do JDBC para seu servidor de banco de dados:
  • Para o IBM DB2:db2jcc_license_cu.jar e db2jcc.jar
  • Para Oracle:ojdbc5.jar. Se estiver utilizando Oracle 10, utilize ainda o arquivo ojdbc5.jar para Oracle 11. É possível fazer o download dos arquivos a partir do Oracle.
  • Para Microsoft SQL Server:sqljdbc.jar. É possível fazer o download dos arquivos a partir da Microsoft.

Sobre Esta Tarefa

É 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.

Nota: Se você pretende implementar o Rational Asset Manager e o Rational Team Concert incluído em aplicativos do servidor Tomcat diferentes na mesma máquina, certifique-se de ter configurado os diferentes servidores Tomcat para usarem diferentes portas seguras e não seguras para evitar colisões. Para obter informações adicionais sobre portas no Tomcat 5.5, consulte a documentação do Apache Tomcat.

Procedimento

  1. Verifique se todos os servidores do repositório estão configurados para a mesma data, hora e fuso horário atuais.
  2. 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/.
  3. Extraia os arquivos de biblioteca compartilhada para a pasta tomcat_install_directory\shared\lib:
    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.
    3. Se você estiver instalando o Rational Team Concert em um servidor Tomcat diferente, copie o conteúdo extraído do arquivo sharedLib.zip para o diretório tomcat_for_rtc_install_directory\shared\lib para o outro servidor Tomcat.
  4. 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.
  5. Para Windows: Para Linux:Para AIX: Modifique o script de inicialização para o servidor Tomcat para o Rational Asset Manager:
    Importante: Se você estiver instalando no Linux para zSeries, não conclua esta etapa
    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. No arquivo de inicialização, digite o seguinte texto:
      • 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"
  6. 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
  7. Para alterar o caminho de contexto dos aplicativos, renomeie os arquivos de aplicativos WAR. Use os nomes a seguir.
    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
  8. Configure o servidor Tomcat para o Rational Asset Manager para acessar seu banco de dados:
    1. Em um editor de texto, abra o arquivo tomcat_install_directory\conf\server.xml.
    2. Localize quaisquer linhas em server.xml que comecem com <Connector e contenham port="8080" ou port="8009". Altere o início destas linhas para <Connector URIEncoding="UTF-8".
    3. Entre as tags de abertura e de fechamento para recursos do JNDI Global, <GlobalNamingResources> e </GlobalNamingResources>, insira o texto a seguir para sua versão do Tomcat.
      Nota: Para os valores your_username e your_password, use um ID do usuário e uma senha que tenham acesso administrativo total ao banco de dados. Por exemplo, o atributo "url" pode ser semelhante a jdbc:db2://localhost:50000/RAMDB
    Insira este texto para seu servidor de banco de dados, substituindo as seguintes variáveis:
    • Nos atributos username e password, substitua your_username e your_password por um ID do usuário e uma senha que tenham acesso administrativo total ao servidor de banco de dados.
    • No atributo url, substitua fully_qualified_database_server_name e database_port_number pelo endereço do servidor e o número da porta para seu banco de dados e substitua Rational_Asset_Manager_database_name pelo nome do banco de dados para ativos. Por exemplo, para DB2, o atributo url pode ser semelhante a jdbc:db2://localhost:50000/RAMDB.
    • Os valores mostrados para os atributos maxWait, maxActive e maxIdle são valores de amostra e podem ser ajustados de acordo com suas necessidades de desempenho.
    • Para o IBM DB2:
      <Resource name="jdbc/RAM_Con"
      type="javax.sql.DataSource"
      driverClassName="com.ibm.db2.jcc.DB2Driver"
      username="your_username"
      password="your_password"
      url="jdbc:db2://fully_qualified_database_server_name:database_port_number/Rational_Asset_Manager_database_name"
      poolPreparedStatements="true"
      maxWait="5000"
      maxActive="4"
      maxIdle="2"/>
    • Para Oracle:
      <Resource name="jdbc/RAM_Con"
      type="javax.sql.DataSource"
      driverClassName="oracle.jdbc.driver.OracleDriver"
      username="your_username"
      password="your_password"
      url="jdbc:oracle:thin:@fully_qualified_database_server_name:database_port_number:Rational_Asset_Manager_database_name"
      poolPreparedStatements="true"
      maxWait="5000"
      maxActive="4"
      maxIdle="2"/>
    • Para Microsoft SQL Server:
      <Resource name="jdbc/RAM_Con"
      type="javax.sql.DataSource"
      driverClassName="com.microsoft.jdbc.sqlserver.SQLServerDriver"
      username="your_username"
      password="your_password"
      url="jdbc:microsoft:sqlserver://fully_qualified_database_server_name:database_port_number:Rational_Asset_Manager_database_name"
      poolPreparedStatements="true"
      maxWait="5000"
      maxActive="4"
      maxIdle="2"/>
  9. 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" />
  10. Copie os seguintes arquivos JAR para a pasta tomcat_install_directory\common\lib:
    • Para o IBM DB2:
      • db2jcc_license_cu.jar
      • db2jcc.jar
    • Para Oracle:
      • ojdbc5.jar (É possível fazer o download deste arquivo a partir do Oracle. Se estiver utilizando Oracle 10, faça o download de um pacote para Oracle 11 para localizar o arquivo ojdbc5.jar.)
    • Para Microsoft SQL Server:
    Estes arquivos estão disponíveis a partir do seu provedor de banco de dados, mais provavelmente na pasta /java/ da sua instalação de banco de dados.
  11. Configure o servidor Tomcat para segurança do usuário. Se você pretende usar a segurança LDAP, primeiro use a segurança baseada em arquivo para configurar os aplicativos e, depois de configurá-los, alterne para autenticação LDAP. Para obter mais informações, consulte Configurando a Autenticação LDAP para Tomcat.
    1. Em um editor de texto, abra o arquivo tomcat_install_directory\conf\tomcat-users.xml.
    2. Inclua um usuário denominado admin e designe a esse usuário as funções admin e manager. 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" />

      Este usuário deve ser denominado admin.

  12. Dependendo da sua configuração, implemente ou configure o Rational Team Concert.

Feedback