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:
- O Jazz Team Server exige WebSphere Application Server
Versão 6.1 com Correção Cumulativa do IBM Java™ SDK 1.5 SR5 ou posterior aplicada ou WebSphere Application
Server Versão 7.0 com pelo menos a 7.0.0.3 instalada.
A atualização do IBM Java SDK
1.5 SR6 SDK está disponível em http://www-1.ibm.com/support/docview.wss?rs=180&uid=swg24017492.
Com o WebSphere 6.1 e o GA IBM Java SDK, Sem essa correção, o Jazz começa a relatar "erros de proxy" depois de um determinado número de operações.
Você deve obter os i-fixes do WebSphere Application Server
para correções para o IBM Java SDK 1.5 SR9 ou IBM Java SDK
1.6 SR4 necessários para o IBM Rational Team Concert 2.0
operar corretamente. Caso contrário, alguns serviços no servidor podem não ser iniciados corretamente. Os i-fixes estão disponíveis em seus APARs do WebSphere Application Server
correspondentes. Para o IBM Java SDK 1.5/WebSphere Application Server 6.1,
o APAR é PK85942 e é possível fazer download dos arquivos a partir de ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK85942/.
Instale no mínimo o WebSphere Application
Server 6.1 fixpack 19 antes de instalar o i-fix do JRE. Para o IBM Java SDK 1.6/WebSphere Application Server 7.0,
o APAR é PK 86771 e é possível fazer download dos arquivos a partir de ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK86771/.
- O arquivo teamserver.properties é atualizado com suas configurações do banco de dados.
- Consulte a sua documentação do WebSphere para configuração de
segurança e desligue a propriedade sem distinção entre maiúsculas e minúsculas.
- A opção de Segurança do Java 2 deve ser desligada. Se essa opção
estiver ligada no WebSphere Application Server, ela fará o
jazz.war falhar ao iniciar.
- Assegure-se de que a configuração de segurança do WAS "Utilizar Dados de Autenticação Disponíveis Quando
um URI Desprotegido For Acessado" esteja marcada. Para fazer isso no WAS Integrated Solutions Console:
- Na Versão 6.1, vá para Segurança -> Administração Segura, aplicativos e infraestrutura -> Segurança
da Web - Configurações Gerais. Na versão 7, vá para Segurança ->Segurança Global ->Segurança da Web e
do SIP ->Configurações Gerais.
- Selecione a caixa de opção para "Utilizar Dados de Autenticação Disponíveis Quando um URI Desprotegido
For Acessado".
Configurando o WebSphere Application Server
Para configurar o WebSphere Application
Server:
- Se ele ainda não estiver em execução, inicie o serviço do
WebSphere Application Server.
- Navegue para o console administrativo do WebSphere Application Server.
- 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.
- Depois da autenticação, clique em .
- 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.
- Na página Definição de Processo, vá para a seção Propriedades Adicionais e
clique em Java Virtual Machine.
- Aumente o Tamanho de Heap Máximo para 1000 e clique em Aplicar.
- 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.
- Em Propriedades Adicionais, clique em Propriedades Customizadas.
- Clique em Novo e inclua estes valores:
- Salve as alterações no arquivo de Configuração Principal.
- 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:
- Utilizando o Console de Soluções de Integração do WAS, navegue até .
- Verifique se Utilizar dados de autenticação disponíveis quando
um URI desprotegido for acessado estiver selecionado.
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:
- Inicie a interface do console do Administrador do WebSphere e
autentique o servidor utilizando o ID do usuário Admin do
WebSphere Application Server.
- Expanda Aplicativos e clique em Instalar Novo Aplicativo.
- Em Caminho para Novo Aplicativo, navegue para o
local do arquivo jazz.war no Sistema de Arquivos Local e
selecione o arquivo.
- 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.
- Continue clicando em Avançar até ver a tela
Sumário e, em seguida, clique em Concluir para instalar o novo aplicativo.
- Verifique se o aplicativo jazz_war foi instalado e clique em Salvar para
salvar as alterações no arquivo de Configuração Principal.
- Retorne para a página Instalar Novo Aplicativo.
- 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.
- Continue clicando em Avançar até ver a tela
Sumário, em seguida, clique em Concluir para instalar o novo aplicativo.
- Verifique se o aplicativo help_war foi instalado e clique em Salvar para
salvar as alterações no arquivo de Configuração Principal.
- Expanda a seção Aplicativo Corporativo na opção
Aplicativos.
- Selecione jazz_war e clique em Iniciar.
- Selecione help_ war e clique em Iniciar.
Configurando o LDAP no WebSphere Application Server para o Rational Quality Manager
Para configurar
o LDAP:
- No console Administrativo do WebSphere, clique em .
- 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
- Clique em Aplicar e salve as alterações.
- Na seção Configuração, clique em Testar Conexão.
- Na seção Propriedades Adicionais, clique em Lightweight
Directory Access Protocol (LDAP) Avançado.
- 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
- Clique em Aplicar quando tiver concluído e salve as alterações.
- 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.
- Pare e reinicie o WebSphere Application Server.
- Depois do WebSphere Application
Server ser reiniciado, valide as alterações efetuando login no Console Administrativo.
- Para mapear grupos de usuários para aplicativos específicos, clique em .
- Na lista de Aplicativos Corporativos, selecione o aplicativo jazz_war
e clique em Parar.
- Quando o aplicativo estiver parado, clique no aplicativo jazz_war para abri-lo para
edição.
- Na seção Detalhar Propriedades, clique em Função de Segurança para Mapeamento de Usuário/Grupo.
- 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.
- Insira uma cadeia de procura para que retorne seus nomes de grupo do servidor LDAP. Clique em Procurar para executar a consulta.
- Na lista de grupos disponíveis retornados, selecione o grupo específico e
mova-o para a coluna Selecionado.
- Clique em OK para mapear os grupos do LDAP para os grupos do
Jazz.
- 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? .
- Salve as alterações e reinicie o aplicativo jazz_war.
- 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:
- 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.
- Clique em 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.
- Na Etapa 1 do Assistente de Configuração de Segurança, selecione Ativar
Segurança de Aplicativo.
- Na Etapa 2, selecione Registro Customizado Independente.
- 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):
- Na Etapa 4, revise o sumário e clique em Concluir.
- Salve as alterações clicando em Salvar Diretamente na Configuração Principal. Em , selecione jazz.war e,
em seguida, clique em Parar (a menos que já tenha parado conforme indicado
com um x vermelho).
- Selecione o link jazz.war e, em seguida, selecione Função de
Segurança para Mapeamento de Usuário/Grupo.
- Selecione JazzAdmins e, em seguida, clique em Procurar
Grupos:
- Clique em Procurar Grupos e, em seguida, selecione admins na
lista disponível.
- Inclua na lista selecionada. Repita as etapas 9 e 10 para JazzDWAdmins,
selecionando novamente admins.
- Para JazzUsers e JazzGuests siga as etapas 9 e 10, mas selecione users para as
funções.
- Salve as alterações clicando em Salvar Diretamente na Configuração Principal.
- 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.