Instalando o Software Opcional

O seguinte software opcional está incluído na imagem de instalação do Rational Tester para SOA Quality:

Instalando o Agent Controller

O Agent Controller é um daemon que permite que os aplicativos clientes sejam ativados e gerenciem aplicativos local ou remoto e fornece informações sobre como executar aplicativos para outros aplicativos. Você deve instalá-lo separadamente antes de poder utilizar as seguintes ferramentas:

Nota:

Pré-requisitos de Hardware

Nota:
Para o Rational Performance Tester, o Agent Controller deve ser instalado em sistemas Windows e Linux utilizando-se o Installation Manager.

Plataformas Suportadas

O Agent Controller v7.0.1 é suportado nas seguintes plataformas:

JVMs Suportados

IBM Java SDK v5:

Localizando os Arquivos de Instalação

Os arquivos de instalação estão localizados no disco do Agent Controller nos seguintes diretórios:

Instalando o Agent Controller em uma Estação de Trabalho AIX

Nota:
Para o Rational Performance Tester, o Agent Controller deve ser instalado em sistemas Windows e Linux utilizando-se o Installation Manager.

Desinstalando Versões Anteriores do Agent Controller

Nota:
Antes de instalar o Agent Controller versão 7.0.1, você deve desinstalar a versão anterior do Agent Controller:

Ao desinstalar o Agent Controller V6.x ou V7.x em plataformas AIX , você precisará remover manualmente quaisquer arquivos residuais. Para isso, pare o Agent Controller, desinstala-o e limpe quaisquer dos arquivos a seguir, que podem ser deixados para trás após a desinstalação:

AIX:

$RASERVER_HOME/* (diretório onde o Agent Controller é instalado)
/usr/lib/libLogAgent.so
/usr/lib/libhcbnd.so
/usr/lib/libhcclco.so
/usr/lib/libhccldt.so
/usr/lib/libhccls.so
/usr/lib/libhcclserc.so
/usr/lib/libhcclsert.so
/usr/lib/libhcclsm.so
/usr/lib/libhcjbnd.so
/usr/lib/libhclaunch.so
/usr/lib/libhcthread.so

Configurando o Ambiente do Sistema Operacional

Execute os seguintes comandos para configurar as variáveis de ambiente necessárias:

PATH={caminho para instalação do java}/jre/bin:$PATH
export PATH
LIBPATH={caminho para instalação do java}/jre/bin: {caminho para instalação do java}/jre/bin/
    classic:$LIBPATH
export LIBPATH
Nota:
Após configurar as variáveis de ambiente, o comando "java -fullversion" poderá ser utilizado para verificar a versão do Java.

Instalando o Agent Controller

  1. Efetue login como Administrador (ou root).
  2. Vá para o diretório onde descompactou o arquivo ZIP da instalação para a plataforma apropriada.
  3. Feche todas as plataformas Eclipse antes de continuar com a instalação.
  4. Execute setup.bin.
  5. Clique em Avançar na tela de Boas-vindas para continuar.
  6. Leia o acordo de licença.
  7. Selecione Aceito os termos do contrato de licença e clique em Avançar para prosseguir.
  8. Especifique o caminho no qual o Agent Controller deve ser instalado e clique em Avançar para continuar.
  9. Especifique o caminho do programa executável java.exe ou java do JRE (Java Runtime Environment) que o Agent Controller deverá utilizar. O JRE digitado aqui será utilizado pelo Agent Controller para ativar aplicativos Java. Portanto, você pode desejar alterar o caminho JRE previamente preenchido pelo programa instalador.
    Nota:
    O JRE fornecido nesse momento será utilizado para executar o Agent Controller e para que o Agent Controller ative aplicativos Java. No entanto, você pode configurar o Agent Controller posteriormente para utilizar um JRE separado para cada uma dessas funções. Para obter detalhes, consulte o tópico de ajuda do Agent Controller Configurando Aplicativos a Serem Ativados pelo Agent Controller.

    Clique em Avançar para continuar.

  10. Opcional: Especifique a versão do IBM WebSphere Application Server se "Suporte Remoto para WebSphere Application Server" foi selecionado na etapa 9 acima. Clique em Avançar para continuar.
  11. Opcional: Especifique os caminhos do IBM WebSphere Application Server versão 5.0 (apenas Windows) e 5.1 se "Suporte Remoto para WebSphere Application Server" foi selecionado na etapa 9 acima. Clique em Avançar para continuar.
  12. Especifique quais hosts podem acessar o Agent Controller. Para o Rational Performance Tester, você deve selecionar Computadores específicos. Clique em Avançar para prosseguir.
  13. Aceite o valor padrão (Desativar) para a configuração de segurança. Clique em Avançar para continuar.
  14. Clique em Avançar na tela de resumo para instalar o Agent Controller.
  15. Clique em Concluir após a instalação ser concluída.

Instalando o Agent Controller de Forma Silenciosa

Você pode executar o processo de instalação silenciosamente utilizando os seguintes parâmetros com o comando de configuração:

Parâmetro Descrição

-silent

Esta variável é obrigatória se silent for utilizado:

-V licenseAccepted=true
Opcional: informa ao instalador a ser executado silenciosamente, caso contrário você obterá um assistente de instalação com entradas transmitidas.

-P installLocation
Opcional: especifica o caminho da instalação. O caminho de instalação padrão é "$D(install)/IBM/AgentController".

Exemplos:

para Windows: C:\Program Files\IBM\AgentController

para UNIX/Linux: /opt/IBM/AgentController

-V VJavaPath
Obrigatório: especifica o caminho completo do executável java 

-V VAccessLocal

-V VAccessCustom

-V VAccessAll

Opcional: especifica como os clientes podem se conectar ao Agent Controller (ALL, LOCAL, CUSTOM). Configure apenas uma das variáveis como "true" e todas as demais como false. Por padrão, VAccessAll="true"

  • Qualquer computador:           VAccessAll="true"           : permite qualquer cliente
  • Apenas este computador:   VAccessLocal="true"       : permitir apenas localhost (padrão)
  • Computadores específicos:   VAccessCustom="true"    : permitir uma lista de clientes (também requer o parâmetro -V VHosts)

-V VHosts
Obrigatório se VAccessCustom="true

especifica os nomes de host do cliente, separados por vírgula

As duas variáveis a seguir devem ser especificadas e devem ser configuradas como opostas:

-V VSecurity="true" ou "false"
-V VSecurityDisable="false"
 ou "true"
Opcional: (true, false)

padrão

VSecurity=true 
VSecurityDisable=false

-V VUsers
Obrigatório: se VSecurity="true"

especifica quais usuários podem se conectar ao Agent Controller

-V VWAS6

-V VWAS5
Opcional:

-V VWAS6="true" (padrão) : Se WAS V6 for utilizado

-V VWAS5="true" : Se WAS V5.x for utilizado

-V VWAS_HOME_V50

-V VWAS_HOME_V51
Opcional: se -V VWAS5="true"

especifica o local onde o IBM WebSphere Application Server 5.1 e 5.0 foi instalado

Exemplos:

Instalando a partir da linha de comandos:

-P installLocation="D:\IBM\AgentController"

-V VJavaPath=" D:\jdk1.4.2\jre\bin\java.exe "

-V VAccessLocal="false"

-V VAccessCustom="true"

-V VAccessAll="false"

-V VHosts="host1,host2"

-V VSecurity="true"

-V VSecurityDisable="false"

-V VUsers="user1,user2"

-V VWAS5="true"

-V VWAS_HOME_V51="D:\WebSphere5.1\AppServer"

-V VWAS_HOME_V50="D:\WebSphere5.0\AppServer"

Instalando utilizando um arquivo de resposta:

É possível criar um arquivo de resposta, por exemplo setup.rsp, para armazenar todos os parâmetros, em vez de especificá-los na linha de comandos. A seguir é apresentado um exemplo do Windows; as plataformas Linux/UNIX devem ser semelhantes:

setup.exe -silent -options setup.rsp

Conteúdo do arquivo de resposta:

      # Start of response file

-P installLocation="D:\IBM\AgentController"

-V licenseAccepted="true"

-V VJavaPath=" D:\jdk1.4.2\jre\bin\java.exe "

-V VAccessLocal="false"

-V VAccessCustom="true"

-V VAccessAll="false"

-V VHosts="host1,host2"

-V VSecurity="true"

-V VSecurityDisable="false"

-V VUsers="user1,user2"

-V VWAS5="true"

-V VWAS_HOME_V51="D:\WebSphere5.1\AppServer"

-V VWAS_HOME_V50="D:\WebSphere5.0\AppServer"

 
      # End of response file

Iniciando e Parando o Agent Controller

Desinstalando o Agent Controller

  1. Execute o programa uninstall.bin a partir do diretório _uninst do local da instalação (por exemplo, /opt/IBM/AgentController/_uninst).
  2. Siga a instrução na tela para concluir a desinstalação.
  3. Para executar uma desinstalação silenciosa, utilize o comando uninstall.bin -silent.

Desinstalando um Agent Controller que Tem Várias Referências em uma Estação de Trabalho

O Agent Controller versão 7.0.1 impede que várias instâncias do produto sejam instaladas em uma única estação de trabalho. Quando instalações adicionais são desempenhadas, por instalação independente ou como uma instalação integrada dentro de um produto, o Agent Controller grava uma referência ao nome do produto que está iniciando a nova instalação.

Se o Agent Controller foi instalado várias vezes - em outras palavras, existem várias contagens de referência - por instalação independente ou como uma instalação integrada dentro de um produto, ele poderá ser desinstalado apenas quando o último produto que faz referência for desinstalado; o último produto que faz referência ainda precisa do Agent Controller.

Se você tentar desinstalar o Agent Controller enquanto ele ainda for necessário por outro produto, a desinstalação não prosseguirá e você receberá uma mensagem "Este produto não pode ser desinstalado pois ele é necessário por outro produto".

Instalando o Agent Controller no z/OS (OS/390)

Desinstalando Versões Anteriores do Agent Controller

Se você tiver uma versão anterior do Agent Controller, pare-o e desinstale-o antes de instalar esta versão.

Configurando o Ambiente do Sistema Operacional

  1. Crie o diretório de instalação para o RAC. Por exemplo: mkdir /u/rpt/IBM/RAC.
  2. Set ASSIZEMAX=2147483647. Isso pode requerer suporte do programador de sistemas.
  3. Inclua os seguintes comandos de exportação no .profile do ID do usuário que será utilizado para iniciar o RAC:
    export RASERVER_HOME={local de instalação}
    export LIBPATH=$LIBPATH:{local de instalação}/lib:{caminho para instalação do java}/bin:
        {caminho para instalação do java}/bin/classic
    export PATH=$PATH:{local de instalação}/bin:{caminho para instalação do java}/bin
    export _BPX_SHAREAS="NO"
Nota:
Após configurar as variáveis de ambiente, o comando "java -fullversion" poderá ser utilizado para verificar a versão do Java.

Instalando o Agent Controller

  1. Em um shell do UNIX System Services, vá para o diretório no qual deseja instalar o Agent Controller. É recomendável instalá-lo no diretório /usr/lpp/.
  2. Transfira as imagens de instalação ibmrac.os390.pax e tptpdc.os390.pax para o diretório de instalação.
  3. Emita o seguinte comando para extrair os arquivos do Agent Controller:

    pax -ppx -rvf ibmrac.os390.pax
  4. Emita o seguinte comando para extrair os arquivos do Agente Controller do TPTP (Ferramentas de teste e desempenho):

    pax -ppx -rvf tptpdc.os390.pax
  5. Faça com que o programa de arquivos de objetos compartilhados do Agent Controller seja controlado, emitindo os seguintes comandos em um shell do UNIX System Services:

    extattr +p /usr/lpp/IBM/AgentController/lib/*.so

    Se você deseja instalar os pacotes de Idioma Nacional, conclua as etapas 7 e 8 a seguir. Caso contrário, prossiga para a etapa 9.

  6. Transfira as imagens de instalação NL tptpdc.nl1.os390.pax, tptpdc.nl2.os390.pax, ibmrac.os390.nl1.pax, ibmrac.os390.nl2.pax para o diretório de instalação.
  7. Emita o seguinte comando para extrair os arquivos do Agent Controller:

    	pax -ppx -rf tptpdc.nl1.os390.pax
    	pax -ppx -rf tptpdc.nl2.os390.pax
    	pax -ppx -rf ibmrac.os390.nl1.pax
    	pax -ppx -rf ibmrac.os390.nl2.pax
  8. Depois de ter instalado o Agent Controller, vá para o diretório bin do local da instalação /usr/lpp/IBM/AgentController/bin e execute o script de configuração digitando:

    ./SetConfig.sh
  9. Siga o prompt na tela para configurar o Agent Controller.

Iniciando e Parando o Agent Controller no z/OS (OS/390)

Nota: O RAServer requer que os diretórios do JRE que contêm bibliotecas executáveis como libjvm.so sejam incluídos na variável de ambiente LIBPATH. Por exemplo, se você estiver utilizando o IBM JRE 1.4.1, a variável LIBPATH será definida conforme a seguir:

export LIBPATH=/usr/lpp/java/IBM/J1.4/bin/classic:
/usr/lpp/java/IBM/J1.4/bin:$LIBPATH

Desinstalando o Agent Controller do z/OS (OS/390)

Utilizando o Recurso de Segurança do Agent Controller

A lista a seguir contém dicas e sugestões para uso do recurso de segurança do Agent Controller em todas as plataformas:

Resumo de Compatibilidade do Ambiente de Trabalho/Agent Controller

Retrocompatibilidade (utilização de um ambiente de trabalho mais antigo com um Agent Controller versão 6.0.1): Sim, eles são compatíveis, pois o novo Agent Controller suporta todos os recursos nas versões anteriores (por exemplo, Segurança no canal de controle). Entretanto, não será possível utilizar novos recursos, incluindo multiplexação (retornar dados utilizando o canal de controle de forma que eles possam ser protegidos).

Compatibilidade avançada (utilização de um ambiente de trabalho 6.0.1 com um Agent Controller mais antigo): Não, em geral não é suportado.

Compatibilidade de versão cruzada entre Agent Controllers: Alguns produtos ou ferramentas (como o IBM Performance Optimization Toolkit) requerem que Agent Controllers em vários hosts (sem levar em conta o ambiente de trabalho) "descobrem" e se comunicam entre si. As alterações feitas de uma versão para a próxima em relação a essa função significam que se você precisar utilizar essa função, deverá utilizar o Agent Controller versão 6.0.0.1 ou o Agent Controller versão 6.0.1 em todos os hosts envolvidos. Sendo assim, não é possível misturar e corresponder versões ao utilizar descoberta dinâmica entre instâncias do Agent Controller.

Problemas e Limitações Conhecidos

Esta seção aborda problemas e limitações conhecidos relacionados à instalação e desinstalação do Agent Controller. Exceto onde indicado de outra forma, as seguintes informações se aplicam a todos os sistemas operacionais que são suportados pelo Agent Controller.

O Agent Controller Pode Não Iniciar em Plataformas Não-Windows

O Agent Controller pode não iniciar em plataformas não-Windows com a seguinte mensagem:

RAServer failed to start.

Este defeito geralmente é causado quando a porta 10002 do TCP/IP não está livre. Por padrão, o Agent Controller atende nessa porta. Outro processo em execução no sistema poderia estar utilizando essa porta quando o Agent Controller foi iniciado ou, talvez, o Agent Controller tenha sido parado e reiniciado antes da porta poder ser liberada.

Se o Agent Controller falhar na inicialização, você poderá iniciá-lo da seguinte maneira:

Outros Erros durante a Instalação e a Desinstalação

Se encontrar erros durante a instalação ou desinstalação, isto pode ter ocorrido porque os arquivos objeto do Agent Controller foram carregados por processos em execução. Para assegurar-se de que os arquivos objeto possam ser modificados, proceda da seguinte forma:

  1. Encerre o ambiente de trabalho do Eclipse.
  2. Encerre todos os processos java.exe que contenham o Java Profiling Agent ou o J2EE Request Profiler.

Instalando o ClearCase LT

O Rational ClearCase LT é uma ferramenta de gerenciamento de configuração para equipes de projeto pequenas. O ClearCase LT faz parte da família de produtos IBM Rational ClearCase, utilizada tanto para equipes de trabalho de projetos de pequeno porte como para empresas distribuídas e globais.

A mídia de instalação inclui o Rational ClearCase LT Versão 7.0.1. Ele é instalado separadamente a partir do Rational Tester para SOA Quality.

Se você já tiver o ClearCase LT instalado em sua estação de trabalho, poderá conseguir fazer upgrade dele para a versão atual. Consulte a documentação de instalação do ClearCase LT, para obter informações sobre upgrade de versões anteriores.

Para ativar o Rational Tester para SOA Quality para funcionar com o ClearCase LT, é necessário instalar o recurso Rational ClearCase SCM Adapter. Por padrão, esse recurso é selecionado quando você instala o Rational Tester para SOA Quality. No entanto, se você não o incluiu, poderá instalá-lo posteriormente utilizando o assistente para Modificar Pacotes no IBM Installation Manager. Para obter detalhes, consulte Modificando Instalações.

É necessário ativar o adaptador Rational ClearCase SCM antes de trabalhar com ele. Consulte a ajuda on-line para obter detalhes sobre como ativar e trabalhar com o adaptador.

Localizando Instruções de Instalação e Notas sobre o Release do ClearCase LT

Para obter as instruções completas sobre a instalação do Rational ClearCase LT, consulte a documentação da instalação fornecida com a mídia de instalação do ClearCase LT. Também é muito recomendada a leitura das notas sobre o release do ClearCase LT antes da instalação do produto.

Alguma documentação está nos arquivos Acrobat PDF. Para abrir os arquivos, é necessário o software Adobe Reader, que você pode transferir por download de http://www.adobe.com/products/acrobat/readstep2.html.

Para Windows. As instruções de instalação e as notas sobre o release podem ser visualizadas a partir da Barra de Ativação de instalação do ClearCase LT. Consulte Iniciando uma Instalação do Rational ClearCase LT.

Para abrir as instruções de instalação:

Obtendo a Documentação do IBM Publications Center

Também é possível fazer download das instruções de instalação e das notas sobre o release do Rational ClearCase LT a partir do IBM Publications Center.

  1. Vá para o endereço http: http://www.ibm.com/shop/publications/order.
  2. Selecione seu país/região na página de boas-vindas do Publications Center.
  3. Clique em Procurar Publicações.
  4. Digite o título do documento ou o número da publicação no campo de procura apropriado.
    Tabela 2. Números da Publicação do ClearCase
    Documento Número da Publicação
    IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT Installation and Upgrade Guide (Windows) GI11-6365-00
    IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT Installation and Upgrade Guide (UNIX) GI11-6366-00
    IBM Rational ClearCase LT Release Notes GI11-6369-01

Iniciando uma Instalação do Rational ClearCase LT

As instruções de instalação nesta seção servem para ajudá-lo a iniciar o processo de instalação do Rational ClearCase LT. Você deve consultar as instruções de instalação completas encontradas no Rational ClearCase LT: Guia de Instalação, durante a instalação do produto. Antes de instalar, recomenda-se fortemente que você leia as notas sobre release.

Iniciando uma Instalação do Rational ClearCase LT no Windows

  1. Inicie o programa de Barra de Ativação do Rational ClearCase LT utilizando um dos seguintes métodos:
  2. Leia as informações sobre o release, caso ainda não tenha feito isso.
  3. Clique em Instalar o IBM Rational ClearCase LT. O Assistente de Configuração Rational ClearCase LT é aberto.

Siga as instruções no Assistente de Configuração para concluir a instalação.

Instalando o Rational ClearCase LT no Linux

As instruções completas sobre como instalar o Rational ClearCase LT versão 7.0 em uma estação de trabalho Linux estão disponíveis no documento IBM Rational ClearCase, ClearCase MultiSite e ClearCase LT Installation Guide, 7.0, Linux e UNIX, que você pode fazer download em 600.

Configurando a Licença do Rational ClearCase LT

Quando o Rational Tester para SOA Quality estiver instalado no mesmo computador que o Rational ClearCase LT, não será necessário configurar a licença do Rational ClearCase LT. No entanto, se você instalar o Rational ClearCase LT sem o Rational Tester para SOA Quality, precisará configurar a Licença do ClearCase LT.

Consulte o Installation Guide do ClearCase LT para obter detalhes sobre a configuração de licenças.