Configurando um WebSphere Application Server

Este tópico descreve como configurar o IBM® Rational Quality Manager para trabalhar com o WebSphere® Application Server. Essa configuração supõe que você esteja instalando o Servidor Jazz na mesma máquina que o Websphere Application Server.

Planejando a Configuração

Antes de iniciar essas etapas, você deve ter o seguinte concluído:

Configurando o WebSphere Application Server

Para configurar o WebSphere Application Server:

  1. Se ele ainda não estiver em execução, inicie o serviço do WebSphere Application Server.
  2. Navegue para o console administrativo do WebSphere Application Server.
  3. Autentique o servidor como o recurso administrativo.
    Nota: A pessoa que instalou o software do WebSphere teria especificado o ID do usuário e senha do recurso do administrador no momento da instalação.
  4. Depois da autenticação, clique em Servidores > Servidores de Aplicativos > server1.
  5. Localize a seção Infraestrutura do Servidor da página de configuração server1, expanda Java e Gerenciamento de Processo e clique em Definição de Processo.
  6. Na página Definição de Processo, vá para a seção Propriedades Adicionais e clique em Java Virtual Machine.
  7. Aumente o Tamanho de Heap Máximo para 1000 e clique em Aplicar.
  8. Na seção Argumentos da JVM Genéricos na página Java Virtual Machine, inclua os seguintes argumentos da JVM. Certifique-se de incluir os argumentos da JVM em uma linha.

    Exemplo do Windows®:

    -Dcom.ibm.team.server.configURL=file:///D:/RQM20/server/conf/jazz/teamserver.properties -Dlog4j.configuration=file:///D:/RQM20/server/log4j.properties -Djava.awt.headless=true -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true -Xmx1000M -Dcom.ibm.team.repository.provision.profile=///D:/RQM20/server/conf/jazz/provision_profiles -Dcom.ibm.team.repository.discovery.document.location=file:///D:/RQM20/server/conf/jazz/services.xml -Dcom.ibm.team.repository.friends.config.location=file:///D:/RQM20/server/conf/jazz/friendsconfig.rdf -Dcom.ibm.rqm.create.samples=false -Xss768k

    Exemplo do Linux®:

    -Dcom.ibm.team.server.configURL=file:///opt/IBM/RQM20/server/conf/jazz/teamserver.properties -Dlog4j.configuration=file:///opt/IBM/RQM20/server/log4j.properties -Djava.awt.headless=true -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true -Xmx1000M -Dcom.ibm.team.repository.provision.profile=///opt/IBM/RQM20/server/conf/jazz/provision_profiles -Dcom.ibm.team.repository.discovery.document.location=file:///opt/IBM/RQM20/server/conf/jazz/services.xml -Dcom.ibm.team.repository.friends.config.location=file:///opt/IBM/RQM20/server/conf/jazz/friendsconfig.rdf -Dcom.ibm.rqm.create.samples=false -Xss768k

    em que D:/RQM20 é o diretório de instalação no Windows e opt/IBM/RQM20 é o diretório de instalação no Linux.

    Esses valores devem codificados, o que requer que quaisquer espaços nos caminhos de arquivo sejam substituídos por %20. Por exemplo, C:\Arquivos de Programas ficariam C:\Arquivosde%20Programas. Se os valores de argumentos da JVM forem inseridos incorretamente, o WebSphere Application Server não será iniciado. Se isso acontecer, você não pode utilizar a interface com o usuário da Web do WebSphere Application Server para corrigir isso; é necessário localizar o arquivo server.xml, editar o arquivo e, em seguida, iniciar o WebSphere Application Server. O arquivo normalmente está localizado aqui:
    c:\Arquivos de Programas\IBM\WebSphere\AppServer\profiles\AppSrv01\config\cells\qwin268Node01Cell\nodes\qwin268Node01\servers\server1\server.xml
    Nota: Os argumentos da JVM mencionados na ajuda do Rational Team Concert não contêm todos os argumentos da JVM necessários para a implementação do Rational Quality Manager.
  9. Em Propriedades Adicionais, clique em Propriedades Customizadas.
  10. Clique em Novo e inclua estes valores:
    • Name: JAZZ_HOME Value: file:///RQM_install_dir/server/conf/
    • Nome: log4j.configuration Valor: file:///RQM_install_dir/server/log4j.properties
    • Nome: java.awt.headless Valor: true
    • Nome: org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin Valor: true

      Por exemplo, inclua os valores especificados desta forma: RQM_install_dir = C:/IBM/RQM20

  11. Salve as alterações no arquivo de Configuração Principal.
  12. Encerre e reinicie o WebSphere Application Server.
    Nota: Se o servidor não reiniciar, verifique os argumentos da JVM Genéricos manualmente. Esses argumentos são mantidos no arquivo server.xml, que em uma instalação típica pode ser encontrado no seguinte local:
    C:\Arquivos de Programas\ibm\WebSphere\AppServer\profiles\AppSrv01\config\cells\enable01
    Node01Cell\nodes\enable01Node01\servers\server1\server.xml

Configurações de Segurança para o WebSphere Application Server

Para melhorar o suporte para OAuth, instalações que utilizam o WebSphere Application Server, você deve utilizar a seguinte configuração de segurança da Web:

Configurando o Produto Rational Quality Manager e a Ajuda no WebSphere Application Server

Para configurar o produto IBM Rational Quality Manager e a ajuda em um ambiente do WebSphere Application Server:

  1. Inicie a interface do console do Administrador do WebSphere e autentique o servidor utilizando o ID do usuário Admin do WebSphere Application Server.
  2. Expanda Aplicativos e clique em Instalar Novo Aplicativo.
  3. Em Caminho para Novo Aplicativo, navegue para o local do arquivo jazz.war no Sistema de Arquivos Local e selecione o arquivo.
  4. Digite a raiz de contexto como /jazz e, em seguida, clique em Avançar.
    Nota: É possível localizar o arquivo jazz.war em RQM_install_dir\server\tomcat\webapps\jazz.war.
  5. Continue clicando em Avançar até ver a tela Sumário e, em seguida, clique em Concluir para instalar o novo aplicativo.
  6. Verifique se o aplicativo jazz_war foi instalado e clique em Salvar para salvar as alterações no arquivo de Configuração Principal.
  7. Retorne para a página Instalar Novo Aplicativo.
  8. Navegue para o local do arquivo help.war no sistema de arquivos local e selecione o arquivo. Digite a raiz de contexto como /help e clique em Avançar.
    Nota: É possível localizar o arquivo help.war em RQM_install_dir\server\tomcat\webapps\help.war.
  9. Continue clicando em Avançar até ver a tela Sumário, em seguida, clique em Concluir para instalar o novo aplicativo.
  10. Verifique se o aplicativo help_war foi instalado e clique em Salvar para salvar as alterações no arquivo de Configuração Principal.
  11. Expanda a seção Aplicativo Corporativo na opção Aplicativos.
  12. Selecione jazz_war e clique em Iniciar.
  13. Selecione help_ war e clique em Iniciar.

Configurando o LDAP no WebSphere Application Server para o Rational Quality Manager

Para configurar o LDAP:

  1. No console Administrativo do WebSphere, clique em Segurança > Administração de Segurança, Aplicativos e Infraestrutura.
  2. Atualize as definições de segurança, como segue:
    • Ative a segurança administrativa: ativar
    • Ative a segurança do aplicativo: ativar
    • Repositório da conta do usuário/Definições de região disponíveis: registro LDAP independente
    • Na seção Repositório da Conta do Usuário, clique em Configurar e forneça as Propriedades Gerais.
      • Nome de usuário administrativo principal - Seu ID de usuário
      • Identidade do usuário do servidor - Identidade do servidor gerada automaticamente
      • Tipo de servidor LDAP - Customizar
      • Tempo limite - 120 segundos
  3. Clique em Aplicar e salve as alterações.
  4. Na seção Configuração, clique em Testar Conexão.
  5. Na seção Propriedades Adicionais, clique em Lightweight Directory Access Protocol (LDAP) Avançado.
  6. Especifique os campos Propriedades Gerais como segue:
    • Filtro de usuário:
      (&(emailaddress=%v)(objectclass=ePerson)) 
    • Filtro de grupo:
      (&(cn=%v)(|(objectclass=groupOfNames)(objectclass=groupOfUniqueNames))) 
    • Mapa do ID do usuário:
       *:emailaddress 
    • Mapa do ID do membro do grupo: (substitua ibm pelo seu próprio ID)
      ibm-allGroups:member;ibm-allGroups:uniqueMember 
    • Modo do mapa de certificado:
      EXACT_DN
  7. Clique em Aplicar quando tiver concluído e salve as alterações.
  8. Clique em Aplicar e em Salvar para cada uma das telas para confirmar cada configuração.
    Nota: Na última página, certifique-se de que Definição de Região Atual esteja configurado para Registro LDAP Independente.
  9. Pare e reinicie o WebSphere Application Server.
  10. Depois do WebSphere Application Server ser reiniciado, valide as alterações efetuando login no Console Administrativo.
  11. Para mapear grupos de usuários para aplicativos específicos, clique em Aplicativos > Aplicativos Corporativos.
  12. Na lista de Aplicativos Corporativos, selecione o aplicativo jazz_war e clique em Parar.
  13. Quando o aplicativo estiver parado, clique no aplicativo jazz_war para abri-lo para edição.
  14. Na seção Detalhar Propriedades, clique em Função de Segurança para Mapeamento de Usuário/Grupo.
  15. Selecione um grupo específico, como JazzAdmins e JazzUsers e clique em Procurar Grupos.

    Esses grupos estão associados a cada implementação do Jazz e devem ser mapeados para um grupo do LDAP específico que contém os usuários autorizados. Esses grupos precisam ser configurados no servidor LDAP antes da execução desse mapeamento.

  16. Insira uma cadeia de procura para que retorne seus nomes de grupo do servidor LDAP. Clique em Procurar para executar a consulta.
  17. Na lista de grupos disponíveis retornados, selecione o grupo específico e mova-o para a coluna Selecionado.
  18. Clique em OK para mapear os grupos do LDAP para os grupos do Jazz.
  19. Mapeie o grupo do LDAP apropriado para todos os grupos do Jazz:
    • JazzAdmins
    • JazzDWAdmins
    • JazzUsers
    • JazzGuests
    Nota: Não ative a opção Todos Autenticados? .
  20. Salve as alterações e reinicie o aplicativo jazz_war.
  21. Efetue logout do Console Administrativo e encerre a janela do navegador.

Configurando o Registro Customizado do WebSphere Application Server

Nota: Você pode utilizar as instruções nesta seção enquanto está avaliando o Rational Quality Manager. Estas instruções não serão úteis em um ambiente de produção real, se você estiver utilizando o LDAP.

Para configurar credenciais do usuário utilizando o registro customizado do WebSphere Application Server:

  1. Crie um diretório denominado WAS_Security em um local de sua escolha e inclua os arquivos users.props e groups.props no diretório.

    Para obter informações sobre o formato desse arquivos, consulte user.props e groups.props.

  2. Clique em Segurança > Administração Segura, Aplicativos e Infraestrutura e selecione Registro Customizado Independente na seção Repositório da Conta do Usuário; em seguida, clique no botão Assistente de Configuração de Segurança.
  3. Na Etapa 1 do Assistente de Configuração de Segurança, selecione Ativar Segurança de Aplicativo.
  4. Na Etapa 2, selecione Registro Customizado Independente.
  5. Na Etapa 3, Configurar Repositório do Usuário, inclua Nome de Usuário Administrativo Principal e um nome e um valor para usersFile (users.props) e groupsFile (groups.props):
    Etapa 3 de Configurar Assistente de Segurança mostrando campos concluídos para nome do usuário administrativo e o local para usersFile e groupsFile
  6. Na Etapa 4, revise o sumário e clique em Concluir.
  7. Salve as alterações clicando em Salvar Diretamente na Configuração Principal. Em Aplicativos > Aplicativos Corporativos, selecione jazz.war e, em seguida, clique em Parar (a menos que já tenha parado conforme indicado com um x vermelho).
  8. Selecione o link jazz.war e, em seguida, selecione Função de Segurança para Mapeamento de Usuário/Grupo.
  9. Selecione JazzAdmins e, em seguida, clique em Procurar Grupos:
    Função de Segurança para Mapeamento de Usuário/Grupo
  10. Clique em Procurar Grupos e, em seguida, selecione admins na lista disponível.
  11. Inclua na lista selecionada. Repita as etapas 9 e 10 para JazzDWAdmins, selecionando novamente admins.
  12. Para JazzUsers e JazzGuests siga as etapas 9 e 10, mas selecione users para as funções.
  13. Salve as alterações clicando em Salvar Diretamente na Configuração Principal.
  14. Para completar a configuração do WebSphere Application Server, reinicie o WebSphere Application Server.

Iniciando o WebSphere Application Server como um Serviço do Windows

Com o Rational Quality Manager, você pode criar scripts de teste que referem-se a testes automatizados que foram criados com outras ferramentas de teste. Esses testes automatizados podem ser salvos em máquinas de teste locais ou em locais de rede compartilhados. Testes que são salvos em locais de rede compartilhados são acessados através de compartilhamentos da Convenção Universal de Nomenclatura (UNC).

Por padrão, quando o WebSphere Application Server é executado como um serviço do Windows, ele efetua login como uma conta do sistema local. Nesse caso, é possível que o Rational Quality Manager não possa acessar compartilhamentos da UNC devido à conta do sistema local não ter credenciais de segurança. Portanto, certifique-se de configurar o serviço do Windows do WebSphere Application Server para que efetue login como um conta de usuário específica com credenciais de segurança. Isso permite que o serviço conecte-se a quaisquer compartilhamentos da UNC que correspondam às credenciais de segurança daquela conta de usuário.


Feedback