IBM Rational Agent Controller, Versão 6.0.1: Guia de Instalação


Para Rational Application Developer, Versão 6.0.1 / Rational Web Developer, Versão 6.0.1 / Rational Software Architect, Versão 6.0.1 / Rational Performance Tester, Versão 6.1.1

(C) Copyright IBM Corporation 2000, 2005. Todos os Direitos Reservados.

Índice

Instalando o Agent Controller

  • Pré-requisitos de Hardware
  • Plataformas Suportadas
  • JVMs Suportados
  • Localizando os Arquivos de Instalação
  • Instalando o Agent Controller em uma Estação de Trabalho (AIX, HP-UX, Linux, Windows, Solaris)
  • Desinstalando Versões Anteriores do Agent Controller
  • Instalando o Agent Controller
  • Instalando o Agent Controller de Forma Silenciosa
  • Iniciando e Parando o Agent Controller em uma Estação de Trabalho do Windows
  • Iniciando e Parando o Agent Controller em uma Estação de Trabalho Não- Windows
  • Desinstalando o Agent Controller em uma Estação de Trabalho do Windows
  • Desinstalando o Agent Controller de uma Estação de Trabalho Não- Windows
  • Desinstalando o Agent Controller com Várias Referências em uma Estação de Trabalho
  • Instalando o Agent Controller no OS/400 (iSeries)
  • Desinstalando Versões Anteriores do Agent Controller
  • Instalando o Agent Controller
  • Iniciando e Parando o Agent Controller no OS/400 (iSeries)
  • Desinstalando o Agent Controller no OS/400 (iSeries)
  • Instalando o Agent Controller no z/OS (OS/390)
  • Desinstalando Versões Anteriores do Agent Controller
  • Instalando o Agent Controller
  • Iniciando e Parando o Agent Controller no z/OS (OS/390)
  • Desinstalando o Agent Controller no OS/390 (z/OS)
  • Utilizando o Recurso de Segurança do Agent Controller
  • Problemas e Limitações Conhecidos
  • O Agent Controller Pode Não Iniciar em Plataformas Não-Windows
  • Outros Erros Durante a Instalação e a Desinstalação
  • Suporte ao Cliente

    • Avisos e Marcas Registradas

  • Avisos
  • Informações sobre a Interface de Programação
  • Marcas Registradas e Marcas de Serviço

    • 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:

    Notas:

    Pré-requisitos de Hardware

    Plataformas Suportadas

    Nota para Linux: O recurso Hyades Data Collection Engine do Agent Controller é compilado utilizando a biblioteca compartilhada libstdc++-libc6.2-2.so.3. Certifique-se de que essa biblioteca compartilhada exista no diretório /usr/lib. Se não existir, você terá que instalar o RPM package compat-libstdc++ fornecido com a mídia de instalação do sistema operacional.

    Nota para OS/400: O Agent Controller para OS/400 (iSeries) requer que você instale o IBM XML Toolkit para iSeries (5733-XT1). Entre em contato com o fornecedor do iSeries para obter uma cópia do IBM XML Toolkit para iSeries.

    Nota para z/OS: O Agent Controller para z/OS (zSeries) requer que você instale o XML C++ Parser 1.4 para z/OS, disponível em www.ibm.com/servers/eserver/zseries/software/xml/download/cparser_download.html.

    O Agent Controller foi testado nas seguintes plataformas:

    O Agent Controller não foi testado nas seguintes plataformas, mas espera-se que seja executado nestas:

    JVMs Suportados

    Em geral, o Agent Controller funciona com a JVM versão 1.4 e superior. Seguem as versões de JVM (Java -fullversion) nas quais o Agent Controller foi testado:

    Localizando os Arquivos de Instalação

    Os arquivos de instalação do Agent Controller extraídos em um diretório temporário estão localizados nos diretórios listados a seguir:

    Instalando o Agent Controller em uma Estação de Trabalho (AIX, HP-UX, Linux, Windows, Solaris)

    Desinstalando Versões Anteriores do Agent Controller

    Nota:
    Apenas para estações de trabalho Windows e Linux (Intel IA32):

    Se você instalou o Agent Controller fornecido com seu produto de desenvolvimento de software Rational versão 6.0 ou o Agent Controller versão 6.0.0.1, ele será desinstalado automaticamente quando o Agent Controller versão 6.0.1 for desinstalado. Em todos os outros casos, você deve desinstalar a versão anterior do Agent Controller ou de qualquer software derivado do Hyades Data Collection Engine, antes de instalar o Agent Controller versão 6.0.1.

    Você pode instalar silenciosamente o Agent Controller versão 6.0.1 e sem primeiro desinstalar o Agent Controller versão 6.0 ou 6.0.0.1, utilizando o parâmetro -P hyadesdc_product.patch=True. Utilizando esse método, a configuração de sua instalação anterior é migrada; todos os parâmetros de instalação anteriores são preservados. Use os comandos a seguir:

    Consulte as instruções a seguir para obter informações adicionais sobre como instalar silenciosamente o Agent Controller.

    Se você tiver uma versão anterior do Agent Controller ou de qualquer outro software derivado do Hyades Data Collection Engine, pare-o, desinstale-o e limpe os arquivos remanescentes antes de instalar esta versão do Agent Controller. Os seguintes arquivos podem ser deixados após a desinstalação:

    Windows: 

    %RASERVER_HOME%\*.* (diretório onde o Agent Controller é instalado)
%SystemRoot%\system32\piAgent.dll (Windows' system32 directory)
%SystemRoot%\system32\LogAgent.dll
%SystemRoot%\system32\hcbnd.dll
%SystemRoot%\system32\hcclco.dll
%SystemRoot%\system32\hccldt.dll
%SystemRoot%\system32\hccls.dll
%SystemRoot%\system32\hcclserc.dll
%SystemRoot%\system32\hcclsert.dll
%SystemRoot%\system32\hcclsm.dll
%SystemRoot%\system32\hcjbnd.dll
%SystemRoot%\system32\hclaunch.dll
%SystemRoot%\system32\hcthread.dll
%SystemRoot%\system32\piAgent.dll
%SystemRoot%\system32\rac.dll
%SystemRoot%\system32\sysperf.dll

    Linux, AIX, HP-UX, Solaris: 

    $RASERVER_HOME/* (diretório onde o Agent Controller é instalado)
/usr/lib/libpiAgent.so (ou .sl no HP-UX)
/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

    Instalando o Agent Controller

    1. Efetue login como Administrator (ou root).
    2. Altere para o diretório no qual você descompactou o arquivos ZIP da instalação para a plataforma apropriada.
    3. Execute o programa setup.exe. Para plataformas não- Windows, execute setup.bin.
    4. Clique em Avançar na tela de Boas-vindas para continuar.
    5. Feche todas as plataformas Eclipse antes de continuar com a instalação. Clique em Avançar para continuar.
    6. Leia o acordo de licença.
    7. Selecione Aprovar e clique em Avançar para continuar.
    8. Você será informado que qualquer Agent Controller existente será removido. Clique em Avançar para continuar.
    9. Especifique o caminho no qual o Agent Controller deve ser instalado e clique em Avançar para continuar.
    10. Selecione os recursos do Agent Controller que você gostaria de instalar:

      Clique em Avançar para continuar.

    11. Especifique o caminho do programa executável java.exe ou java do JRE (Java Run-time 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.
    12. 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.
    13. Especifique quais hosts podem acessar o Agent Controller. As opções são:

      Clique em Avançar para continuar.

    14. Se a Segurança foi selecionada na etapa 9 acima, escolha a configuração de segurança.
      Nota:
      Se você selecionou Qualquer Computador, a segurança estará ativada por padrão (consulte "Ativar" a seguir). As comunicações serão criptografadas e todas as conexões serão autenticadas. Para desativar a segurança, consulte a documentação do Agent Controller.

      Clique em Avançar para continuar.

    15. Clique em Avançar na tela de resumo para continuar.
    16. Clique em Concluir após a conclusão da instalação.

    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
    Parâmetros Requeridos   
    -silent
    		informa o instalador para que execute silenciosamente 
    -P installLocation
    		especifica o caminho da instalação 
    -W javaHome_win.path
    		(Windows) especifica o caminho completo do executável java.exe 
    -W javaHome_unix.path
    		(não-Windows) especifica o caminho completo do executável java 
    -W hostList.type
    		especificar como os clientes podem se conectar ao Agent Controller (ALL, LOCAL, CUSTOM)
    • ALL: permitir qualquer cliente
    • LOCAL: permitir apenas host local
    • CUSTOM: permitir uma lista de clientes (também requer o parâmetro -W hostListCustom.hosts) 
    -W securityCustom.type
    		(Utilizar se hostList.type="CUSTOM") especifica se a segurança deve ser ativada (true, false)
    • true: ativa a segurança (também requer o parâmetro opcional "-W securityCustomList.users")
    • false: desativa a segurança 
    -W securityLocal.type
    		(Utilizar se hostList.type="LOCAL") especifica se a segurança deve ser ativada (true, false)
    • true: ativa a segurança (também requer o parâmetro opcional "-W securityLocalList.users")
    • false: desativa a segurança
       
    Parâmetros Opcionais   
    -W wasHome_win.was510path
    		(Windows) especifica o local de instalação do IBM WebSphere Application Server 5.1 
    -W wasHome_unix.was510path
    		(não-Windows) especifica o local de instalação do IBM WebSphere Application Server 5.1 
    -W wasHome_win.was500path
    		(Windows) especifica o local de instalação do IBM WebSphere Application Server 5.0 
    -W wasHome_unix.was500path
    		(não-Windows) especifica o local de instalação do IBM WebSphere Application Server 5.0 
    -W hostListCustom.hosts
    		especifica os nomes de host do cliente, separados por vírgulas (se hostList.type="CUSTOM") 
    -W securityAllList.users
    		(Utilizar se hostList.type="ALL") especifica quais usuários podem conectar-se ao Agent Controller 
    -W securityCustomList.users
    		(Utilizar se hostList.type="CUSTOM") especifica quais usuários podem conectar-se ao Agent Controller (se securityCustom.type = "true") 
    -W securityLocalList.users
    		(Utilizar se hostList.type="LOCAL") especifica quais usuários podem conectar-se ao Agent Controller (se securityLocal.type = "true") 
    -P hyadesdc_ibm_runtimeAnalysis_feature.active=false
    		especifica para não instalar o recurso de Análise de Tempo de Execução (por padrão, ele é instalado durante a instalação silenciosa)
    Nota:
    Se você estiver instalando o Agent Controller silenciosamente através de uma conexão não segura, utilize o parâmetro -W securityLocal.type="false" se hostList.type="LOCAL" ou o parâmetro -W securityCustom.type="false" se hostList.type="CUSTOM". Se você selecionou hostList.type="ALL", a segurança sempre será configurada como "true". Para desativar a segurança, consulte a documentação do Agent Controller.

    Exemplo do Windows: 

    setup.exe
  -silent
-P installLocation="D:\IBM\AgentController"
  -W javaHome_win.path="D:\jdk1.4.1\jre\bin\java.exe"
  -W wasHome_win.was510path="D:\WebSphere5.1\AppServer"
  -W wasHome_win.was500path="D:\WebSphere5.0\AppServer"
-W hostList.type="CUSTOM"
  -W hostListCustom.hosts="host1,host2"
  -W securityCustom.type="true"
  -W securityCustomList.users="user1,user2"

    Exemplo Não-Windows: 

    setup.bin
  -silent
  -P installLocation="/opt/IBM/AgentController"
  -W javaHome_unix.path="/opt/java1.4.1/jre/bin/java"
  -W wasHome_unix.was510path="/opt/WebSphere5.1/AppServer"
  -W wasHome_unix.was500path="/opt/WebSphere5.0/AppServer"
-W hostList.type="CUSTOM"
  -W hostListCustom.hosts="host1,host2"
  -W securityCustom.type="true"
  -W securityCustomList.users="user1,user2"

    Utilizando um Arquivo de Resposta

    Você pode criar um arquivo de resposta (por exemplo, setup.rsp) para armazenar todos os parâmetros acima, em vez de especificá-los na linha de comandos:

    Para instalar utilizando o arquivo de resposta:

    Windows: setup.exe -silent -options d:\temp\setup.rsp

    Não-Windows: setup.bin -silent -options /tmp/setup.rsp

    Iniciando e Parando o Agent Controller em uma Estação de Trabalho do Windows

    Iniciando e Parando o Agent Controller em uma Estação de Trabalho Não- Windows

    Desinstalando o Agent Controller em uma Estação de Trabalho do Windows

    Desinstalando o Agent Controller de uma Estação de Trabalho Não- Windows

    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 o Agent Controller com Várias Referências em uma Estação de Trabalho

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

    Se o Agent Controller tiver sido instalado várias vezes - ou seja, se houver várias contagens de referência - por instalação independente ou como uma instalação incorporada em um produto, ele poderá ser desinstalado apenas quando o último produto de referência for desinstalado; o último produto de referência ainda requer o Agent Controller.

    Se você tentar desinstalar o Agent Controller enquanto ainda ele for requerido por um outro produto, a desinstalação não continuará e uma mensagem "Este produto não pode ser desinstalado porque é requerido por outro produto" será recebida.

    Instalando o Agent Controller no OS/400 (iSeries)

    Desinstalando Versões Anteriores do Agent Controller

    Se você tiver uma versão anterior do Agent Controller ou de qualquer software derivado do Hyades Data Collection Engine, pare-o e desinstale-o antes de instalar esta versão.

    Instalando o Agent Controller

    Importante: O Agent Controller para OS/400 (iSeries) requer que você instale o IBM XML Toolkit para iSeries (5733-XT1). Entre em contato com o fornecedor do iSeries para obter uma cópia do IBM XML Toolkit para iSeries.

    1. No host iSeries, crie uma biblioteca denominada HYADESDC e uma outra biblioteca denominada IBMRAC: 
      CRTLIB HYADESDC
CRTLIB IBMRAC
    2. No host iSeries, na biblioteca HYADESDC, crie um arquivo de salvamento vazio denominado HYADESDC.SAVF: 
      CRTSAVF HYADESDC/HYADESDC
    3. No host iSeries, na biblioteca IBMRAC, crie um arquivo de salvamento vazio denominado IBMRAC.SAVF: 
      CRTSAVF IBMRAC/IBMRAC
    4. (Não para o Rational Web Developer) No host iSeries, na biblioteca IBMRAC, crie um arquivo de salvamento vazio denominado IBMRTA.SAVF: 
      CRTSAVF IBMRAC/IBMRTA
    5. Utilize o FTP para incluir o arquivo IBMRAC.SAVF do CD de instalação na biblioteca IBMRAC, localizada no host iSeries, utilizando a transferência de modo BINARY.
    6. Utilize o FTP para incluir o arquivo HYADESDC.SAVF do CD de instalação na biblioteca HYADESDC localizada no host iSeries utilizando a transferência de modo BINARY.
    7. (Não para o Rational Web Developer) Utilize o FTP para incluir o arquivo IBMRTA.SAVF do CD de instalação na biblioteca IBMRAC localizada no host iSeries, utilizando o modo de transferência BINARY.
    8. Restaure o arquivo de salvamento HYADESDC.SAVF localizado no host iSeries para a biblioteca HYADESDC, digitando: 

      RSTOBJ OBJ(*ALL) SAVLIB(HYADESDC) DEV(*SAVF) SAVF(HYADESDC/HYADESDC)
    9. Restaure o arquivo de salvamento IBMRAC.SAVF localizado no host iSeries para a biblioteca IBMRAC, digitando: 

      RSTOBJ OBJ(*ALL) SAVLIB(IBMRAC) DEV(*SAVF) SAVF(IBMRAC/IBMRAC)
    10. (Não para o Rational Web Developer) Restaure o arquivo de salvamento IBMRTA.SAVF localizado no host iSeries na biblioteca IBMRAC, digitando: 

      RSTOBJ OBJ(*ALL) SAVLIB(IBMRAC) DEV(*SAVF) SAVF(IBMRAC/IBMRTA)
    11. Inicie o QShell e crie, no IFS (Integrated File System), o diretório /opt/hyadesdc.
    12. Restaure o arquivo de salvamento HYADESIFS.SAVF em HYADESDC para o diretório IFS /opt/hyadesdc. Por exemplo: 

      RST DEV('/QSYS.LIB/HYADESDC.LIB/HYADESIFS.FILE') OBJ('/opt/hyadesdc/*')
    13. Restaure o arquivo de salvamento IBMRACIFS.SAVF no IBMRAC para o diretório /opt/hyadesdc do IFS. Por exemplo, digite o seguinte comando em uma linha: 

      RST DEV('/QSYS.LIB/IBMRAC.LIB/IBMRACIFS.FILE') OBJ('/opt/hyadesdc/*') ALWOBJDIF(*ALL)
    14. (Não para o Rational Web Developer) Restaure o arquivo de salvamento IBMRTAIFS.SAVF do IBMRAC no diretório IFS /opt/hyadesdc. Por exemplo, digite o seguinte comando em uma linha: 

      RST DEV('/QSYS.LIB/IBMRAC.LIB/IBMRTAIFS.FILE') OBJ('/opt/hyadesdc/*') ALWOBJDIF(*ALL)
    15. Depois de ter instalado o Agent Controller, vá para o diretório bin do local da instalação /opt/hyades/bin e execute o script de configuração digitando: 

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

    Iniciando e Parando o Agent Controller no OS/400 (iSeries)

    1. Para iniciar o Agent Controller, inclua o HYADESDC e as bibliotecas IBMRAC na lista de bibliotecas: 
      ADDLIBLE HYADESDC
ADDLIBLE IBMRAC
    2. Submeta o job RAStart, digitando: 

      SBMJOB CMD(CALL RASERVER) JOBD(RASTART)
    3. Para parar o Agent Controller, termine o job RAStart, digitando: 

      ENDJOB JOB(RASTART)

    Desinstalando o Agent Controller no OS/400 (iSeries)

    1. Remova a biblioteca HYADESDC e IBMRAC.
    2. Remova o diretório IFS /opt/hyadesdc (incluindo todos os subdiretórios e arquivos).

    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 ou de qualquer software derivado do Hyades Data Collection Engine, pare-o e desinstale-o antes de instalar esta versão.

    Instalando o Agent Controller

    Importante: O Agent Controller para z/OS (zSeries) requer que você instale o XML C++ Parser 1.4 para z/OS, disponível em www.ibm.com/servers/eserver/zseries/software/xml/download/cparser_download.html.

    1. Em um shell do UNIX(R) 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 ibmrac.os390.pax, tptpdc.os390.pax e (não para o Rational Web Developer) ibmrta.os390.pax para o diretório de instalação.
    3. Emita o seguinte comando para extrair os arquivos do Agent Controller: 

      pax -ppx -rf ibmrac.os390.pax
    4. Altere para o diretório de instalação /usr/lpp/IBM/AgentController e digite o seguinte comando para extrair os arquivos TPTP (Test and Performance Tools) do Agent Controller: 

      pax -ppx -rf ../../tptpdc.os390.pax
    5. (Não para o Rational Web Developer) Altere para o diretório de instalação /usr/lpp/IBM/AgentController e digite o seguinte comando para extrair as extensões de análise de tempo de execução: 

      pax -ppx -rf ../../ibmrta.os390.pax
    6. Altere para o diretório binário de instalação /usr/lpp/IBM/AgentController/bin e execute o script para criar links para as bibliotecas do Agent Controller, digitando: 

      ./createLinks.sh
    7. Faça com que o programa de arquivos de objetos compartilhados do Agent Controller seja controlado, emitindo os comandos a seguir em um shell de Serviços do Sistema UNIX (Nota: para o Rational Web Developer, emita apenas o primeiro comando): 

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

      extattr +p /usr/lpp/IBM/AgentController/plugins/com.ibm.rational.pd.probekit/lib/*.so
    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.

    Uso do Canal de Dados no z/OS:

    Para definir um grande dataChannelSize no arquivo serviceconfig.xml, poderá ser necessário aumentar a definição de tamanho máximo do segmento de memória compartilhada na máquina. Para isso, aumente o valor IPCSHMMPAGES no membro BPXPRMxx parmlib. Esse valor é o número máximo de páginas de 4 K que o canal de dados pode ter. Por exemplo, para definir dataChannelSize para 32 M, defina IPCSHMMPAGES com um valor maior que 8192.

    Para que o Agent Controller possa se comunicar com vários agentes simultaneamente, você deve definir o valor de IPCSHMNSEGS no membro BPXPRMxx parmlib para um valor apropriado. Esse valor especifica o número máximo de segmentos de memória compartilhada conectados para cada espaço de endereçamento. O valor padrão é 10, portanto, você deve aumentá-lo para 50.

    Para obter informações adicionais sobre os canais de dados utilizados pelo Agent Controller, consulte as informações da ajuda on-line do Agent Controller.

    Para obter informações adicionais sobre membros BPXPRMXX parmlib do z/OS e como atualizá-los, consulte o IBM z/OS MVS(TM) Initialization and Tuning Reference.

    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 no OS/390 (z/OS)

    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:

    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 produto da plataforma de desenvolvimento de software Rational.
    2. Encerre todos os processos java.exe que contenham o Java Profiling Agent ou o J2EE Request Profiler.

    Suporte ao Cliente

    Para obter notícias sobre produtos, eventos, suporte e outras informações, visite a home page de seu produto:

    Avisos e Marcas Registradas

    Avisos

    Direitos Restritos para Usuários do Governo dos Estados Unidos - Uso, duplicação e divulgação restritos pelo Contrato de Planejamento GSA ADP com a IBM Corporation.

    Estas informações foram desenvolvidas para os produtos e serviços oferecidos nos Estados Unidos. É possível que a IBM não ofereça os produtos, serviços ou recursos discutidos nesta documentação em outros países. Consulte o representante IBM local para obter informações sobre os produtos e serviços disponíveis atualmente em sua área. Qualquer referência a produtos, programas ou serviços IBM não significa que apenas produtos, programas ou serviços IBM possam ser utilizados. Qualquer produto, programa ou serviço funcionalmente equivalente que não infrinja nenhum direito de propriedade intelectual da IBM ou outros direitos legalmente protegidos, poderá ser utilizado em substituição a este produto, programa ou serviço. Entretanto, a avaliação e verificação da operação de qualquer produto, programa ou serviço não-IBM são de responsabilidade do Cliente.

    A IBM pode ter patentes ou solicitações de patentes pendentes relativas a assuntos tratados nesta documentação. O fornecimento desta publicação não garante ao Cliente nenhum direito sobre tais patentes. Pedidos de licença devem ser enviados, por escrito, para:

    Gerência de Relações Comerciais e Industriais da IBM Brasil
    Av. Pasteur, 138 - 146,
    Botafogo
    Rio de Janeiro, RJ
    Brasil

    Para pedidos de licença relacionados a informações de DBCS (Conjunto de Caracteres de Byte Duplo), entre em contato com o Departamento de Propriedade Intelectual da IBM em seu país ou envie pedidos de licença, por escrito, para:

    IBM World Trade Asia Corporation
    Licensing
    2-31 Roppongi 3-chome, Minato-ku
    Tokyo 106, Japan

    O parágrafo a seguir não se aplica a nenhum país em que tais disposições não estejam de acordo com a legislação local: A INTERNATIONAL BUSINESS MACHINES CORPORATION FORNECE ESTA PUBLICAÇÃO "NO ESTADO EM QUE SE ENCONTRA" SEM GARANTIA DE NENHUM TIPO, SEJA EXPRESSA OU IMPLÍCITA, INCLUINDO, MAS NÃO SE LIMITANDO ÀS GARANTIAS IMPLÍCITAS OU CONDIÇÕES DE NÃO-VIOLAÇÃO, MERCADO OU ADEQUAÇÃO A UM DETERMINADO PROPÓSITO. Alguns países não permitem a exclusão de garantias expressas ou implícitas em certas transações; portanto, essa disposição pode não se aplicar ao Cliente.

    Estas informações podem incluir imprecisões técnicas ou erros tipográficos. Periodicamente, são feitas alterações nas informações aqui contidas; tais alterações serão incorporadas em futuras edições desta publicação. A IBM pode, a qualquer momento, aperfeiçoar e/ou alterar os produtos e/ou programas descritos nesta publicação, sem aviso prévio.

    A IBM pode utilizar ou distribuir as informações fornecidas da forma que julgar apropriada sem incorrer em qualquer obrigação para com o Cliente.

    Licenciados deste programa que desejam obter informações sobre este assunto com objetivo de permitir: (i) a troca de informações entre programas criados independentemente e outros programas (incluindo este) e (ii) a utilização mútua das informações trocadas, devem entrar em contato com:

    Gerência de Relações Comerciais e Industriais da
    IBM Brasil
    Av. Pasteur, 138-146, Botafogo
    Rio de Janeiro - RJ
    CEP 22290-240

    Tais informações podem estar disponíveis, sujeitas a termos e condições apropriadas, incluindo em alguns casos o pagamento de uma taxa.

    O programa licenciado descrito nesta documentação e todo o material licenciado disponível são fornecidos pela IBM sob os termos do Contrato com o Cliente IBM, Contrato de Licença do Programa Internacional IBM, ou de qualquer contrato equivalente entre as partes.

    Todos os dados de desempenho aqui contidos foram determinados em um ambiente controlado. Portanto, os resultados obtidos em outros ambientes operacionais podem variar significativamente. Algumas medidas podem ter sido tomadas em sistemas de nível de desenvolvimento e não há garantia de que estas medidas serão iguais em sistemas geralmente disponíveis. Além disso, algumas medidas podem ter sido estimadas por extrapolação. Os resultados reais podem variar. Os usuários deste documento devem verificar os dados aplicáveis para seu ambiente específico.

    As informações sobre produtos não-IBM foram obtidas junto aos fornecedores dos respectivos produtos, de seus anúncios publicados ou de outras fontes disponíveis publicamente. A IBM não testou estes produtos e não pode confirmar a precisão de desempenho, compatibilidade ou qualquer outra reivindicação relacionada a produtos de terceiros. Dúvidas sobre os recursos de produtos não-IBM devem ser encaminhadas diretamente a seus fornecedores.

    Todas as declarações relacionadas aos objetivos e intenções futuras da IBM estão sujeitas a alterações ou cancelamento sem aviso prévio e representam apenas metas e objetivos.

    Essas informações contêm exemplos de dados e relatórios utilizados nas operações diárias de negócios. Para ilustrá-los da forma mais completa possível, os exemplos podem incluir nomes de indivíduos, empresas, marcas e produtos. Todos estes nomes são fictícios e qualquer semelhança com nomes e endereços utilizados por uma empresa real é mera coincidência.

    Informações sobre a Interface de Programação

    As informações sobre interface de programação destinam-se a facilitar a criação de software aplicativo utilizando este programa.

    As interfaces de programação de uso geral permitem que o cliente desenvolva o software aplicativo que obtém os serviços das ferramentas deste programa.

    No entanto, essas informações também podem conter informações sobre diagnósticos, modificações e ajustes. As informações sobre diagnósticos, modificações e ajustes são fornecidas para ajudá-lo a depurar o software aplicativo.

    Aviso: Não utilize estas informações sobre diagnósticos, modificações e ajustes como uma interface de programação porque estão sujeitas a alterações.

    Marcas Registradas e Marcas de Serviço

    Os termos a seguir são marcas comerciais da International Business Machines Corporation nos Estados Unidos e/ou em outros países:

    Java e todas as marcas comerciais baseadas em Java são marcas comerciais da Sun Microsystems, Inc. nos Estados Unidos e/ou em outros países.

    Windows e Windows NT são marcas registradas da Microsoft Corporation nos Estados Unidos e/ou em outros países.

    Intel e Pentium são marcas ou marcas registradas da Intel Corporation ou de suas subsidiárias nos Estados Unidos e/ou em outros países.

    UNIX é uma marca registrada do The Open Group nos Estados Unidos e em outros países.

    Linux é uma marca registrada da Linus Torvalds nos Estados Unidos e/ou em outros países.

    Outros nomes de empresa, produtos ou serviços podem ser marcas comerciais ou marcas de serviço de terceiros.