A ferramenta coletora reúne informações sobre sua instalação
WebSphere Application Server e empacota-as em um
arquivo Java™ archive (JAR) que você envia para o
Suporte ao Cliente IBM® para ajudar da determinação e
análise do seu problema. As informações contidas no arquivo JAR
incluem logs, arquivos de propriedade, arquivos de configuração, sistema operacional e
dados Java, e a presença e o nível de cada pré-requisito de software.
Antes de Iniciar
O tipo de informações que você reúne não é
aquele que a maioria das pessoas utilizam. Na realidade, a ferramenta coletora
compacta sua saída em um arquivo JAR. A IBM inclui
a ferramenta coletora no código do produto, junto com outras ferramentas que ajudam capturar as informações que você deve fornecer ao relatar um problema. A ferramenta coletora faz parte de uma estratégia
de tornar o relatório de problemas o mais fácil e completo possível.
Existem duas fases de utilização da ferramenta coletora.
A primeira fase executa a ferramenta coletora em seu produto WebSphere Application Server e produz
um arquivo Java archive (JAR). A equipe de Suporte da IBM executa a segunda fase que é analisar o arquivo
JAR (Java archive) que o programa coletor produz. O programa coletor é executado até a conclusão, enquanto cria o arquivo JAR, apesar dos erros que possa encontrar, como arquivos ausentes ou comandos inválidos. A ferramenta coletora coleta o máximo possível
de dados no arquivo JAR.
A ferramenta coletora é um aplicativo Java que requer um
Java SE Runtime Environment 6 (JRE6)
para execução.
Sobre Esta Tarefa
A ferramenta está dentro do diretório raiz da instalação para o WebSphere Application Server, Network Deployment. Mas você executa a ferramenta de um diretório de trabalho que
cria fora do diretório raiz da instalação. Esse procedimento descreve essas
duas etapas e todas as outras etapas para utilizar a ferramenta e relatar os
resultados da execução da ferramenta.
Existem duas maneiras de execução da ferramenta coletora. Execute a ferramenta coletora para
coletar dados de resumo ou atravessar o sistema para reunir arquivos e resultados
de comandos relevantes.
A ferramenta coletora produz um arquivo JAR (Java archive)
de informações necessárias para determinar e solucionar um problema.
A opção resumida do coletor produz
uma coleta superficial de versão e outras informações que são úteis ao relatar pela primeira vez o problema ao Suporte da IBM. Execute a ferramenta coletora a partir do usuário root
ou a partir do usuário administrador para acessar os arquivos do sistema que contenham informações sobre as
configurações de kernel, os pacotes instalados e outros dados vitais.
A ferramenta coletará informações sobre o perfil padrão, se você não
utilizar o parâmetro opcional para identificar outro perfil.
Procedimento
Execute a ferramenta coletora. - Efetue logon no sistema como root ou um membro do grupo administrador
em uma plataforma Windows.
- Verifique se Java 1.2.2 ou superior está disponível no
caminho.
O programa coletor exige a execução do código Java. Ele coleta também dados
sobre o IBM Developer
Kit, Java Technology
Edition no qual é executado.
Se houver vários Developer Kits no sistema, verifique se aquele do produto WebSphere Application Server usa é aquele no caminho para o programa coletor.
Se o Developer Kit que está sendo usado pelo WebSphere Application Server não estiver disponível, coloque um outro
Developer Kit no caminho para o programa coletor, para que você possa coletar tudo, exceto
dados sobre o Developer Kit que o WebSphere Application Server, Network Deployment
está usando.
- Verifique se todas as informações necessárias estejam no caminho sendo usado
pelo programa coletor e que você não esteja executando o programa a partir do diretório raiz
da instalação do produto WebSphere Application Server.
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
Verifique se o caminho contém os
seguintes diretórios do sistema:- /bin
- /sbin
- /usr/bin
- /usr/sbin
Inclua regedit no caminho.
- Crie um diretório de trabalho onde você poderá iniciar o programa coletor.
- Torne o diretório de trabalho o diretório atual.
- Execute o programa coletor, digitando o comando completo a partir da
linha de comandos do diretório de trabalho.
- Execute o seguinte comando a partir do Qshell:
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
app_server_root/bin/collector.sh
![[Windows]](../images/windows.gif)
app_server_root\bin\collector.bat
Utilize o comando sem parâmetro adicional para reunir uma cópia
dos dados de perfil e dados de cada servidor no nó
em um único arquivo de saída JAR.
- Utilize o seguinte comando para reunir
os dados de um perfil específico que talvez não seja o perfil padrão.
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
app_server_root/bin/collector.sh -profileName profile_name
![[Windows]](../images/windows.gif)
app_server_root\bin\collector.bat -profileName profile_name
- Opcional: É possível executar a ferramenta coletora a
partir do diretório bin do perfil em vez do diretório
app_server_root/bin/.
Você deve obter a mesma saída, se executar a ferramenta coletora a partir do
diretório bin do
profile_root
da mesma forma que faria executando-a a partir do
app_server_root.
Emitir o comando a partir do perfil também executa o arquivo
setupCmdLine.bat/sh no diretório bin do perfil. Esse
arquivo configura um parâmetro de ambiente que o coletor utiliza para
determinar os dados do perfil a serem coletados.
Execute a ferramenta coletora. - Efetue logon no sistema com um perfil de usuário que tenha autoridade especial para todos os
objetos (*ALLOBJ).
- Crie um diretório de trabalho onde você poderá iniciar o programa coletor.
- Execute o comando STRQSH a partir da linha
de comandos CL para preparar a execução do programa coletor.
- Torne o diretório de trabalho o diretório atual.
- Execute o seguinte comando a partir do Qshell:
cd workingDirectory
O programa coletor grava seu arquivo JAR de saída no diretório atual. O programa também cria e exclui vários arquivos temporários no diretório atual. Criar um diretório de trabalho para executar o programa coletor evita as colisões de nomenclatura e torna a limpeza mais fácil. Não é possível
executar a ferramenta coletora em um diretório sob o diretório raiz da instalação para o WebSphere Application Server, Network Deployment.
- Execute o programa coletor, digitando o comando completo a partir da
linha de comandos do diretório de trabalho.
- Execute o seguinte comando a partir do Qshell:
app_server_root/bin/collector
- Utilize o seguinte comando para reunir
os dados de um perfil específico que talvez não seja o perfil padrão.
- Execute o seguinte comando a partir do Qshell:
app_server_root/bin/collector -profileName profile_name
- Opcional: Também é possível executar a ferramenta
coletora a partir do diretório raiz do perfil em vez do diretório
app_server_root/bin/.
Execute o seguinte comando a partir do Qshell:
profile_root/bin/collector
Você deve obter a mesma saída, se executar a ferramenta coletora a partir do
diretório bin do
profile_root
da mesma forma que faria executando-a a partir do
app_server_root.
A
emissão do comando no perfil executa também o arquivo setupCmdLine no diretório
bin do perfil. Esse
arquivo configura um parâmetro de ambiente que o coletor utiliza para
determinar os dados do perfil a serem coletados.
Para executar esse comando para o gerenciador de
implementação, por exemplo, emita o seguinte em um prompt:
app_server_root/profiles/dmgr/bin/collector
em que
dmgr é o nome do perfil
para o gerenciador de implementação.
Resultados
O programa coletor criar um arquivo de log Collector.log e um arquivo JAR de saída no
diretório atual.
O nome do arquivo JAR é composto pelo nome do host,
nome da célula, nome do nó e nome do perfil:
host_name-cell_name-node_name-profile_name.JAR
O arquivo de log
Collector.log é um dos arquivos coletados no arquivo
host_name-cell_name-node_name-profile_name.JAR.
O que Fazer Depois
Envie o arquivo
host_name-cell_name-node_name-profile_name.JAR para o Suporte da IBM para análise.