Configurando variáveis de ambiente para o perfil de um servidor

A criação de perfil de um servidor permite que você analise o desempenho, a passagem e o uso de memória ao executar um aplicativo da web. Em alguns casos, você deve configurar as variáveis de ambiente no computador host de destino antes de iniciar o servidor no modo de perfil. As variáveis de ambiente devem ser configuradas antes de iniciar o servidor para criação de perfil. Em computadores que executam z/OS, você também precisará configurar as permissões nos diretórios usados pelo Rational Agent Controller.

Determinando se você deve configurar manualmente as variáveis de ambiente para criação de perfil

Em alguns casos, você não precisa configurar manualmente as variáveis de ambiente no computador de destino ao criar o perfil; elas são configuradas automaticamente para você pelo ambiente de trabalho. Entretanto, em alguns casos, você deve configurar as variáveis de ambiente manualmente. Os fatores a seguir determinam se é necessário configurar manualmente as variáveis de ambiente, bem como quais variáveis de ambiente configurar:
  • Se o computador de destino para o servidor for o mesmo computador no qual o ambiente de trabalho está instalado (servidor local) ou se o servidor estiver em um computador diferente (servidor remoto).
  • Se o ID do usuário tiver acesso de gravação no diretório /java/jre/bin/ para o WebSphere Application Server (servidor local).
  • A versão do Rational Agent Controller instalada (servidor remoto).
A tabela a seguir mostra as condições quando as variáveis de ambiente são configuradas automaticamente ou devem ser configuradas manualmente.
Tabela 1. Cenários para configurar variáveis de ambiente automaticamente ou manualmente ao criar o perfil. As variáveis de ambiente são configuradas para servidores locais e remotos.
Variável de Ambiente Servidor local Servidor remoto
  • Para Windows
    PATH
  • Para Linux
    Para Solairis
    LD_LIBRARY_PATH
  • Para AIX
    Para z/OS
    LIBPATH
Configurar automaticamente pelo ambiente de trabalho. Configure automaticamente se o servidor remoto estiver usando o Rational Agent Controller V8.3 ou posterior. Caso contrário, configure manualmente.
Nota:
Para z/OS
Você deve assegurar que a variável de ambiente LIBPATH inclua o caminho <XML Toolkit installation directory>/xml4c-5_7/lib.

Por exemplo, se você instalou o kit de ferramentas de XML em /usr/lpp/ixm/IBM/xml4c-5_7, a variável de ambiente LIBPATH deverá conter o caminho: LIBPATH=/usr/lpp/ixm/IBM/xml4c-5_7/lib.

Nota:
Para z/OS
Você também deve ter permissões de leitura e execução no <XML Toolkit installation directory>/xml4c-5_7/lib e em outros diretórios. Consulte Configurando as Permissões de Arquivo para Criação de Perfil no z/OS.
TPTP_AC_HOME Configurar automaticamente pelo ambiente de trabalho. Configure automaticamente se o servidor remoto estiver usando o Rational Agent Controller V8.3 ou posterior. Caso contrário, configure manualmente.
PROBEKIT_HOME (Necessário somente Se você estiver usando a opção de monitor Inserção de Análise.) Configurar automaticamente pelo ambiente de trabalho. Preenchida manualmente.
JAVA_PROFILER_HOME Configurar automaticamente pelo ambiente de trabalho Configure automaticamente se o servidor remoto estiver no sistema operacional Windows ou Linux usando o Rational Agent Controller V8.3 ou mais recente. Caso contrário, configure manualmente.

Configurando variáveis de ambiente de criação de perfil manualmente para um servidor local

Para um servidor em execução na mesma máquina que o ambiente de trabalho, conclua as etapas a seguir:
  1. Localize as pastas de plugin a seguir sob o diretório de instalação do IBM® Rational Software Delivery Platform
    Nota: Sempre selecione o plug-in com o número da versão e registro de data e hora mais recentes quando várias versões do mesmo plug-in existirem.
    Tabela 2. Caminhos para os plug-ins usados para definir variáveis de ambiente para criação de perfil em um servidor local. Use o caminho de plug-in para determinar a variável de ambiente.
    Descrição Caminho do plug-in
    <Agent Controller Home>
    • Para Windows
      <install_dir>\IBMIMShared\plugins\org.eclipse.tptp.platform.ac.win_<XXXX>\agent_controller
    • Para Linux
      <install_dir>/IBMIMShared/plugins/org.eclipse.tptp.platform.ac.linux_<XXXX>/agent_controller
    em que <install_dir> é o diretório de instalação do IBM Rational Software Delivery Platform e <XXXX> depende do arquiteto do sistema operacional. Substitua <XXXX> por seu processador apropriado selecionando ia32 para um processador de 32 bits, em64 para um processador de 64 bits ou ipf para um processador da Família de Processadores Itanium, por exemplo org.eclipse.tptp.platform.ac.win_ia32_<n.n.n>.v<yyyymmddtttt>, em que <n.n.n> é um número de versão e <yyyymmddtttt> é um registro de data e hora do plug-in.
    <Probekit Home>
    • Para Windows
      <install_dir>\IBMIMShared\plugins\org.eclipse.hyades.probekit<n.n.n>.v<yyyymmddtttt>\os\win32\x86
    • Para Linux
      <install_dir>/IBMIMShared/plugins/org.eclipse.hyades.probekit<n.n.n>.v<yyyymmddtttt>/os/linux/x86
    em que <install_dir> é o diretório de instalação do IBM Rational Software Delivery Platform e <XXXX> depende do arquiteto do sistema operacional. Substitua <XXXX> por seu processador apropriado selecionando ia32 para um processador de 32 bits, em64 para um processador de 64 bits ou ipf para um processador da Família de Processadores Itanium, por exemplo org.eclipse.tptp.platform.ac.win_ia32_<n.n.n>.v<yyyymmddtttt>, em que <n.n.n> é um número de versão e <yyyymmddtttt> é um registro de data e hora do plug-in.
  2. Configure as variáveis de ambiente a seguir antes de iniciar o ambiente de trabalho e o servidor de aplicativos. Abra um prompt de comandos e digite os comandos a seguir, substituindo <Agent Controller Home> e o <Probekit Home> opcional pelos caminhos de plug-in determinados na etapa anterior:
    Para Windows
    set TPTP_AC_HOME=<Agent Controller Home> set PROBEKIT_HOME=<Probekit Home> set PATH=%TPTP_AC_HOME%\bin;%TPTP_AC_HOME%\lib;%PROBEKIT_HOME%;%PATH%
    Para Linux
    export TPTP_AC_HOME=<Agent Controller Home> export PROBEKIT_HOME=<Probekit Home> export LD_LIBRARY_PATH=$TPTP_AC_HOME/bin:$TPTP_AC_HOME/lib:$PROBEKIT_HOME:$LD_LIBRARY_PATH

Configurando manualmente as variáveis de ambiente para criação de perfil em um servidor remoto

Para servidores de aplicativos em execução em um computador diferente do ambiente de trabalho, conclua as etapas a seguir:
Nota: Se você estiver criando o perfil de um servidor de aplicativos remoto, deverá instalar o Rational Agent Controller na mesma máquina em que o servidor de aplicativos está localizado. Verifique se as configurações de variável de ambiente a seguir são coletadas pelo processo de inicialização do servidor de aplicativos.
No computador no qual o servidor de aplicativos remoto está localizado, configure manualmente quaisquer variáveis de ambiente antes de iniciar o ambiente de trabalho e o servidor de aplicativos. É possível configurar manualmente as variáveis de ambiente a seguir no sistema de destino, substituindo <AC installation directory> pelo diretório de instalação do Rational Agent Controller. Além disso, se estiver utilizando a opção de monitor Inserção de análise, especifique a variável de ambiente PROBEKIT_HOME:
Para Windows
set TPTP_AC_HOME=<AC installation directory> set JAVA_PROFILER_HOME=%TPTP_AC_HOME%\plugins\org.eclipse.tptp.javaprofiler set PROBEKIT_HOME=%TPTP_AC_HOME%\plugins\org.eclipse.hyades.probekit set PATH=%JAVA_PROFILER_HOME%;%TPTP_AC_HOME%\bin;%TPTP_AC_HOME%\lib;%PROBEKIT_HOME%\lib;%PATH%
Para Linux
Para Solairis
export TPTP_AC_HOME=<AC installation directory> export JAVA_PROFILER_HOME=$TPTP_AC_HOME$/plugins/org.eclipse.tptp.javaprofiler export PROBEKIT_HOME=$TPTP_AC_HOME$/plugins/org.eclipse.hyades.probekit export LD_LIBRARY_PATH=$JAVA_PROFILER_HOME:$TPTP_AC_HOME/bin:$TPTP_AC_HOME/lib:$PROBEKIT_HOME/lib:$LD_LIBRARY_PATH
Para AIX
export TPTP_AC_HOME=<AC installation directory> export JAVA_PROFILER_HOME=$TPTP_AC_HOME$/plugins/org.eclipse.tptp.javaprofiler export PROBEKIT_HOME=$TPTP_AC_HOME$/plugins/org.eclipse.hyades.probekit export LIBPATH=$JAVA_PROFILER_HOME:$TPTP_AC_HOME/bin:$TPTP_AC_HOME/lib:$PROBEKIT_HOME/lib:$LIBPATH
Para z/OS
export TPTP_AC_HOME=<AC installation directory/RACzOS64 or 31bit> export JAVA_PROFILER_HOME=$TPTP_AC_HOME$/plugins/org.eclipse.tptp.javaprofiler export XERCESC_HOME=<XML Toolkit installation directory>/xml4c-5_7/lib export PROBEKIT_HOME=$TPTP_AC_HOME$/plugins/org.eclipse.hyades.probekit export LIBPATH=$JAVA_PROFILER_HOME:$TPTP_AC_HOME/bin:$TPTP_AC_HOME/lib:$XERCESC_HOME/lib:$PROBEKIT_HOME/lib:$LIBPATH

em que <XML Toolkit installation directory> é geralmente /usr/lpp/ixm/IBM.

Nota: Se você ativou a segurança quando instalou o Rational Agent Controller, insira os comandos a seguir:
  • extattr +ap <diretório do Rational Agent Controller >/lib/*
  • extattr +ap <diretório do Rational Agent Controller >/plugins/org.eclipse.tptp.javaprofiler/*
  • extattr +ap <diretório de instalação do XML Toolkit >/xml4c-5_7/lib/*

Iniciar o workbench

Depois de configurar as variáveis de ambiente necessárias, inicie o ambiente de trabalho do IBM Rational Software Delivery Platform a partir de um prompt de comandos, de forma que as variáveis de ambiente sejam selecionadas pelo processo do ambiente de trabalho. Por exemplo, execute o seguinte comando:
Para Windows
C:\Arquivos de Programas\IBM\SDP>eclipse
Para Linux
/opt/IBM/SDP>./eclipse
Nota: Ao criar o perfil com o WebSphere Application Server, a configuração de variáveis de ambiente pode ser incluída no arquivo setupCmdLine.bat (Windows) ou setupCmdLine.sh (Linux) localizado na pasta /bin da instalação de servidor.

Configurando as Permissões de Arquivo para Criação de Perfil no z/OS

Para z/OS
Se você estiver criando perfil no z/OS, deverá ter permissões de leitura e execução nos diretórios a seguir (e todos os diretórios em seu caminho):
  • <diretório de instalação do Rational Agent Controller>/lib/*
  • <diretório de instalação do Rational Agent Controller>/plugins/org.eclipse.tptp.javaprofiler/*
  • <diretório de instalação do XML Toolkit>/xml4c-5_7/lib*
Nota: Todos os diretórios no caminho para esses diretórios também precisam de permissão de leitura e execução. Por exemplo, se <diretório de instalação do Rational Agent Controller> for /opt/IBM/RAC, serão necessárias as permissões de leitura e execução ema cada um dos diretórios /opt, /opt/IBM, /opt/IBM/RAC e /opt/IBM/RAC/lib/.
Para conceder a permissão correta sobre esses diretórios executando o comando umask 022:
  1. Em um shell do UNIX System Services, vá para o diretório <Rational Agent Controller installation directory>/RACzOS31bit/bin.
  2. Execute os comandos a seguir: umask 022
  3. Inicie o Agent Controller: ./ACStart.sh.
Icon that indicates the type of topic Reference topic
Timestamp icon Last updated: last_date

File name: rprofilingenvvar.html