Configurando um servidor Tomcat para o Rational Engineering Lifecycle Manager

A implementação e a inicialização do Jazz Team Server começa com a seleção do sevidor de aplicativos, que hospeda oJazz Team Server e seus aplicativos.

Sobre Esta Tarefa

A implementação e a inicialização do Jazz Team Server começa com a seleção do sevidor de aplicativos, que hospeda oJazz Team Server e seus aplicativos.

Se você planeja utilizar o servidor de aplicativos Apache Tomcat incluído como seu ambiente de hosting do Jazz Team Server, clique no link Implementando e Iniciando o Servidor Apache Tomcat.

Se você planeja usar o IBM® WebSphere Application Service como seu ambiente de hosting, clique no link Implementando e Iniciando o WebSphere Application Server.

Resolvendo um erro que ocorre ao iniciar o servidor RM no modo sem interface com o usuário no Linux. O aplicativo RM inclui um conversor que fornece renderização visual de artefatos gráficos, como diagramas do processo de negócios, diagramas de casos de uso, peças, rascunhos, esboços sequenciais e fluxos de tela. O conversor é executado no servidor. Ao iniciar o servidor RM no modo sem interface com o usuário (console) no Linux, a ação falha silenciosamente e um erro CRRRW8010E ocorre. Se isso acontecer, você deverá finalizar o processo Java™ e tomar a ação reparatória para que possa ativar o servidor com sucesso. Para obter informações adicionais, consulte a página de wiki a seguir: https://jazz.net/wiki/bin/view/Main/RRCConverterTroubleshooting.

Executando no Apache Tomcat como um Serviço do Windows (64 bits)

Para executar o Jazz Team Server como um serviço em um computador de 64 bits, você deve configurar a versão de 64 bits do Tomcat que é enviada com o Jazz Team Server.

Antes de Iniciar

Dica: Para evitar problemas, não use espaços nos caminhos de arquivo. Por exemplo, para o diretório Program Files, é possível usar PROGRA~1.
Se estiver usando o Derby como o banco de dados para seu Jazz Repository, edite o arquivo teamserver.properties para cada aplicativo para tornar os locais do BD um caminho absoluto. Substitua a variável app name pelo nome de diretório do aplicativo apropriado, por exemplo, jts, ccm, qm. Nos exemplos a seguir, Dir_de_Instalação_do_Jazz refere-se ao local onde o Jazz Team Server está instalado.
  1. Abra o arquivo Dir_de_Instalação_do_Jazz\server\conf\app name\teamserver.properties.
  2. Altere a entrada com.ibm.team.repository.db.jdbc.location=conf/nome do aplicativo/derby/repositoryDB para com.ibm.team.repository.db.jdbc.location=C:/Dir_de_Instalação_do_Jazz/server/conf/nome do aplicativo/derby/repositoryDB. Observe a barra (/) no caminho.
  3. Altere também a entrada com.ibm.team.datawarehouse.db.jdbc.location=//localhost\:1527/conf/jts/derby/warehouseDB para com.ibm.team.datawarehouse.db.jdbc.location=//localhost\:1527/C:/Dir_de_Instalação_do_Jazz/server/conf/jts/derby/warehouseDB dos aplicativos. Também, a entrada com.ibm.team.datawarehouse.db.jdbc.location=conf/jts/derby/warehouseDB para com.ibm.team.datawarehouse.db.jdbc.location=C:/Dir_de_Instalação_do_Jazz/server/conf/jts/derby/warehouseDB do JTS. Observe a barra (/) no caminho.
Além de editar teamserver.properties, você também deve editar o arquivo log4j.properties para tornar o nome do caminho de arquivo de log absoluto. Substitua a variável nome do aplicativo pelos nomes de diretório do aplicativo apropriados, por exemplo, jts, ccm, qm, rm, admin. Substitua as variáveis app name.log e app name-etl.log pelo nome de cada arquivo de log do aplicativo apropriado, por exemplo jts.log, ccm.log, qm.log, rm.log, admin.log e jts-etl.log, ccm-etl.log, qm-etl.log (não há nenhum *-etl.log para admin e rm):
  1. Abra o arquivo Dir_de_Instalação_do_Jazz\server\conf\nome do aplicativo\log4j.properties.
  2. Altere a entrada log4j.appender.file.File=logs/appName.log para log4j.appender.file.File=C:/Dir_de_Instalação_do_Jazz/server/logs/appName.log. Observe a barra (/) no caminho.
  3. Altere a entrada log4j.appender.etl.File=logs/appName-etl.log para log4j.appender.etl.File=C:/Dir_de_Instalação_do_Jazz/server/logs/appName-etl.log. Observe a barra (/) no caminho.
Nota: Se você ignorar esta etapa e não fornecer caminhos para os arquivos de log, estes serão gravados no diretório padrão do Windows. Por exemplo, no Windows 7, o diretório de log é C:\Windows\System32\LogFiles.

Verifique se o serviço não está instalado. Se o serviço estiver instalado, desinstale o serviço e, em seguida, reinicie o computador. Em seguida, instale o novo serviço.

Procedimento

  1. Configure a variável CATALINA_HOME seguindo estas etapas:
    1. No Painel de Controle do Windows, abra a janela Propriedades do Sistema.
    2. Clique na guia Avançado, em seguida, clique em Varáveis de Ambiente.
    3. Sob Variáveis do Sistema, clique em Novo.
    4. Em Nome da Variável, insira CATALINA_HOME, e em Valor da Variável, insira C:\Dir_de_Instalação_do_Jazz\server\tomcat.
  2. Reinicie seu sistema para que a variável entre em vigor.
  3. Abra um prompt de comandos e instale o novo serviço de 64 bits alterando para o diretório Dir_de_Instalação_do_Jazz\server\tomcat\bin e digitando este comando:

    service.bat install tomcat7.

    Nota: Em sistemas operacionais Windows que possuem Controle de Conta do Usuário (UAC), tal como o Windows 7, o shell de comando deve ser executado como um administrador.
  4. Execute o programa Dir_de_Instalação_do_Jazz\server\tomcat\bin\tomcat7w.exe para configurar o serviço.
  5. Clique na guia Java e limpe a caixa de seleção Usar Padrão.
  6. Inclua o caminho a seguir para a Java Virtual Machine. Também é possível clicar no ícone de reticências para navegar para o arquivo jvm.dll.
    Dir_de_Instalação_do_Jazz\server\jre\bin\j9vm\jvm.dll
  7. Inclua as linhas a seguir no final do campo de texto Opções Java
    Nota: O caminho para -DJAZZ_HOME e -Dlog4j.configuration deve ser um caminho de URL. Observe as três barras (///) após "file:" e as barras no caminho. O caminho para tempDir deve ser um caminho absoluto.
    -DJAZZ_HOME=file:///C:/Dir_de_Instalação_do_Jazz/server/conf
    -Djava.awt.headless=true 
    -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true 
    -Dcom.ibm.team.repository.tempDir=C:\Dir_de_Instalação_do_Jazz\server\tomcat\temp
    -Djazz.connector.sslProtocol=SSL_TLS
    -Djazz.connector.algorithm=IbmX509
    -Dlog4j.configuration=file:///C:/Dir_de_Instalação_do_Jazz/server/conf/startup_log4j.properties
    -Xmx4g
    -Xms4g
    -Xgcpolicy:gencon
    -Xcompressedrefs 
    Se o seu Jazz Team Server estiver instalado em uma plataforma Windows, mas você estiver usando o servidor de banco de dados do DB2 for z/OS, inclua esta linha substituindo o caminho com o local da unidade.
    Nota: O caminho para o local do driver deve ser um caminho de arquivo; observe a barra.
    -DDB2Z_JDBC=D:/Dir_de_Instalação_do_Jazz/server/db2z
    Se você estiver usando o banco de dados Oracle, inclua esta linha substituindo o caminho pelo local do driver.
    Nota: O caminho para o local do driver deve ser um caminho de arquivo.
    -DORACLE_JDBC_DRIVER_FILE=C:\OJDBCLocation\ojdbc6.jar
    Se você estiver usando o banco de dados SQL Server, inclua esta linha substituindo o caminho pelo local do driver.
    Nota: O caminho para o local do driver deve ser um caminho de arquivo.
    -DSQLSERVER_JDBC_DRIVER_FILE=C:\SQLJDBCLocation\sqljdbc4.jar
  8. Em Conjunto de Memórias Máximo, altere o tamanho do conjunto para 4000.
  9. Nas guias Inicialização e Encerramento, certifique-se que jvm esteja selecionado para a configuração de Modo.
  10. Clique na guia Geral e altere o Tipo de Inicialização para Automático para iniciar o serviço automaticamente quando o Windows for iniciado.
  11. Depois que o serviço for iniciado, verifique se o servidor está em execução efetuando login no servidor a partir do navegador.

Feedback