IBM® Support Assistant Lite



Conteúdo

Introdução
Passo a Passo
Instalação da Ferramenta
    Instalando a Ferramenta
Uso da Ferramenta
    Configurando a Variável de Ambiente JAVA_HOME
    Iniciando a Ferramenta no Modo GUI Swing
    Iniciando a Ferramenta no Modo de Console da Linha de Comandos
    Local de Arquivos Criados durante a Execução
    Interagindo com a Ferramenta no Modo GUI Swing
    Validação do Nome do Arquivo Zip da Coleta
    Interagindo com a Ferramenta no Modo de Console da Linha de Comandos
    Determinando Informações de Versão
    Suporte de Proxy para Uploads HTTPS
Marcas Registradas

Introdução

A ferramenta IBM® Support Assistant Lite é fornecida como um auxílio para resolução de problemas com produtos de software IBM. Seu foco é a coleta automática de dados de problemas. Ela também fornece suporte à análise de sintoma para as várias categorias de problemas encontrados por produtos de software IBM. As informações relacionadas a um tipo de problema são coletadas e analisadas para ajudar a identificar a origem do problema sob investigação. A ferramenta ajuda os clientes reduzindo o tempo de reprodução de um problema com os níveis de rastreio adequados configurados, assim como reduzindo o esforço necessário para enviar as informações de log apropriadas para o Suporte IBM. Neste guia de ajuda, há informações sobre como instalar e executar a ferramenta IBM Support Assistant Lite.


Passo a Passo

Na maioria dos casos, a sequência de etapas a seguir o ajudará a instalar e executar a ferramenta. Se encontrar problemas, ou se quiser mais informações sobre alguma das etapas, consulte as seções subsequentes a esta.

  1. Instale a ferramenta extraindo os arquivos do archive transferido por download.
  2. Execute a ferramenta no modo GUI ou no modo de console da linha de comandos.

Instalação da Ferramenta

Instalando a Ferramenta

Em todos os casos, a instalação da ferramenta IBM Support Assistant Lite é simplesmente uma questão de extrair os arquivos do archive transferido por download. Os arquivos podem ser extraídos em qualquer local do sistema de arquivos escolhido no sistema em que a ferramenta será executada. Isso criará um subdiretório \ISALite neste diretório de destino.


Uso da Ferramenta

Configurando a Variável de Ambiente JAVA_HOME

Independentemente de você usar a ferramenta IBM Support Assistant Lite no modo GUI ou no modo de console da linha de comandos, o mesmo procedimento será usado para iniciá-la: você chamará o script de ativação apropriado a partir da linha de comandos. No caso de sistemas Windows, esses scripts de ativação serão arquivos em lote. Para outros ambientes, eles serão shell scripts.

Como a ferramenta é implementada como um aplicativo Java, é necessário configurar a variável de ambiente JAVA_HOME para que ela possa ser iniciada. Se Java não estiver disponível no PATH, a variável de ambiente JAVA_HOME precisará ser configurada manualmente. A ferramenta IBM Support Assistant Lite requer um JRE no nível 1.4.2 ou superior (1.5 ou superior no Windows 7 de 64 bits), portanto, é necessário certificar-se, antes, de que haja um JRE adequado instalado no sistema em que a ferramenta será executada. Se houver, será necessário emitir um comando específico do sistema operacional para configurar a variável JAVA_HOME para que aponte para esse JRE. O Microsoft JVM/JDK e gij (GNU libgcj) não são suportados. Por exemplo, se jdk1.4.2 estiver instalado em c:\jre1.4.2 em uma plataforma Windows, JAVA_HOME será configurada usando o seguinte comando:

SET JAVA_HOME=c:\jre1.4.2

Em uma plataforma Linux, AIX, HP-UX ou Solaris, a sintaxe de comando exata para configurar JAVA_HOME varia, dependendo do shell que está sendo usado. Por exemplo, se você estiver usando shell bash e o JDK estiver instalado em /opt/jre142, JAVA_HOME será configurada usando o seguinte comando:

export JAVA_HOME=/opt/jre142

Depois de instalar a ferramenta em um dos locais padrão, é possível que ela falhe ao ser iniciada com a mensagem de erro "ERRO: Esta ferramenta requer o JRE 1.4.2 ou superior para ser executada." Esta mensagem indica que o JRE está em um nível inferior a 1.4.2. Neste caso, será necessário configurar a variável JAVA_HOME manualmente para que aponte para um JRE de nível adequado.

Iniciando a Ferramenta no Modo GUI

Será necessário emitir o seguinte script de ativação:

Iniciando a Ferramenta no Modo de Console da Linha de Comandos

Se não houver uma GUI disponível, a ferramenta deverá ser iniciada no modo de linha de comandos automaticamente. Se o modo de console for desejado mesmo que haja uma GUI disponível, especifique "-console" na linha de comandos. Em algumas instâncias, não será possível determinar que não há uma GUI disponível e a ferramenta não será iniciada. Nessas instâncias, a ferramenta precisará ser reiniciada usando "-console".

Local de Arquivos Criados durante a Execução

Por padrão, o diretório de instalação ISA Lite é usado para armazenar arquivos criados durante a execução. Em alguns sistemas, o diretório de instalação ISA Lite será somente leitura. Nessa instância, use o parâmetro -useHome. Esse parâmetro fará com que os arquivos temporários sejam gravados no diretório temporário systems e os arquivos persistentes gravados no diretório inicial do usuário.

Interagindo com a Ferramenta no Modo GUI

Depois que a ferramenta IBM Support Assistant Lite for iniciada no modo GUI, a interface gráfica mostrada abaixo será exibida.

Para que a ferramenta possa ser usada para executar coleta de dados e análise, será necessário, primeiramente, selecionar um tipo de problema na janela Tipo de Problema, conforme demonstrado abaixo.

 

 

Exceto em Tipo de Problema, o único valor de campo de entrada que deverá ser fornecido na GUI principal é um nome de arquivo para o arquivo zip da coleta de dados. Nesse ponto, o nome do arquivo pode ser qualquer coisa: você pode, por exemplo, usar o nome de arquivo Install_failed_2007_01_03. Se ele não for fornecido, a ferramenta anexará automaticamente a extensão "zip" a ele. No entanto, se houver um PMR aberto para o problema para o qual está sendo executada a coleta, e se você deixar a ferramenta enviar por FTP os resultados da coleta para o Suporte IBM automaticamente, na etapa do FTP a ferramenta aplicará uma convenção de nomenclatura de arquivo específica necessária para o Suporte IBM: o nome do arquivo deverá começar com três campos específicos: <pmrnumber>.<branchnumber>.<countrycode>.<short description>.zip. Um exemplo de nome de arquivo desse tipo seria 34143.055.000.logs.zip. Para que haja compatibilidade com um formato anterior, vírgulas também são aceitas no lugar dos três primeiros pontos (mas não no lugar do quarto, anterior à extensão "zip"). No entanto, pontos são os delimitadores preferidos.

Com esses valores preenchidos, a próxima etapa será pressionar o botão Coletar Dados. Na sequência, o script de coleta solicitará informações adicionais necessárias para concluir suas atividades de coleta. Um script também pode solicitar informações de configuração, informações sobre a sequência de eventos que levaram ao problema com o qual você está lidando ou preferências relacionadas a como ele deve concluir a coleta. Quando tiver todas as informações de que precisa, o script prosseguirá com o restante da coleta.

 Quando a ferramenta concluir a coleta de dados, os resultados poderão ser enviados para o Suporte IBM. É possível escolher entre FTP, que não é criptografado, e HTTPS, que é criptografado, para a transferência de arquivos. O nome do arquivo zip que a ferramenta enviará para o Suporte IBM será o nome de arquivo inserido na caixa Nome do Arquivo de Saída/Caminho, com o nome de host do servidor e o registro de data e hora atual anexados a ele.

 Exemplo: se o nome de arquivo de Nome do Arquivo de Saída/Caminho era 34143.055.000.logs.zip, o nome do arquivo zip enviado para a IBM será

34143.055.000.logs.zip-<hostname>-<currentTimestamp>.zip.

Validação do Nome do Arquivo Zip da Coleta

A automação no site de FTP ftp.emea.ibm.com do Suporte IBM depende inteiramente da convenção de nomenclatura de arquivo descrita na GUI principal da ferramenta IBM Support Assistant Lite. Se for recebido um arquivo cujo nome não segue essa convenção, esse arquivo nunca será visto pelo Suporte IBM. Consequentemente, antes que a ferramenta chame uma operação FTP para enviar um arquivo zip da coleta para ftp.emea.ibm.com, ele valida o nome do arquivo zip da coleta de acordo com a convenção. Se o nome do arquivo não estiver na forma correta, será apresentada uma janela pop-up para que você possa corrigi-lo. A convenção de nomenclatura de arquivo atual para o site de FTP é aquela documentada aqui, em que os campos individuais no nome de arquivo composto são separados por pontos. Anteriormente, no entanto, a convenção era usar vírgulas como separadores. Como o site de FTP ainda trata de arquivos nomeados de acordo com a convenção anterior, a lógica de validação da ferramenta IBM® Support Assistant Lite aceita tanto pontos como vírgulas como delimitadores.

Interagindo com a Ferramenta no Modo de Console da Linha de Comandos

Quando o IBM Support Assistant Lite é executado no modo de console da linha de comandos, não há listas de seleção ou campos de entrada para entrada do usuário. Em vez disso, as opções disponíveis são apresentadas como listas numeradas e você digita o número de sua seleção seguido pela tecla Enter. Os campos de entrada são transformados em prompts, nos quais você digita sua resposta e pressiona Enter.

Para parar a ferramenta coletora, digite quit no modo de console.

A ferramenta solicitará nomes de arquivos. Em plataformas Unix, usar "~" como uma designação do diretório HOME do usuário não é suportado. Se um "~" for usado, um subdiretório com o nome de "~" será referenciado no diretório ativo presente.

O modo de console também fornece um recurso de coleta silenciosa que permite a gravação das respostas de uma sessão no modo de console em um arquivo e, em seguida, o uso do arquivo para direcionar execuções subsequentes do mesmo script de coleta.

Para isso, você cria, primeiramente, um "arquivo de resposta" contendo as respostas a todas as perguntas de uma determinada execução por meio do coletor de dados. Na próxima vez que a mesma coleta de dados precisar ser executada, basta fornecer o arquivo de resposta ao iniciar a ferramenta e as respostas que foram fornecidas anteriormente serão usadas para responder a todas as perguntas. É possível ajustar e modificar os arquivos de resposta para variar as respostas e também executar diferentes coletas de dados.

Para criar um arquivo de resposta, basta chamar a ferramenta no modo de console da linha de comandos com a opção -record, seguida do nome do arquivo de resposta. Por exemplo, em um ambiente Linux, você executaria:

./runISALite.sh -console -record response.txt

Ao executar nesse modo, você será levado a uma sessão interativa ordinária, na qual fornecerá as respostas aos prompts do script. Além de influenciar a coleta atual, no entanto, suas respostas também são salvas no arquivo indicado. Após a conclusão da sessão interativa, é possível usar esse arquivo de resposta para executar o mesmo script no futuro, sem a necessidade de entrada explícita do usuário.

Por exemplo, para executar a ferramenta no modo silencioso em um ambiente UNIX usando o arquivo de resposta gravado, execute:

./runISALite.sh -console response.txt

O arquivo de resposta é um arquivo de texto simples, portanto, é possível editá-lo para alterar as respostas do usuário, conforme necessário. Por exemplo, se você quiser executar a ferramenta em um sistema diferente daquele em que o arquivo de resposta foi gravado, talvez seja necessário ajustar alguns dos valores no arquivo de resposta.

Ao usar arquivos de resposta, lembre-se de que informações sigilosas, como nomes de usuário e senhas, podem ficar armazenadas nesses arquivos, portanto, é importante gerenciar esses arquivos para evitar acesso não autorizado a essas informações. Além disso, nem todas as coletas de dados são adequadas para a opção de coleta silenciosa. Algumas coletas de dados sempre requerem alguma interação com o usuário. Por exemplo, pode ser solicitado que você reproduza o problema durante a coleta de dados para que os arquivos de log e rastreio apropriados sejam coletados. Neste caso, a coleta silenciosa não é capaz de gravar e reproduzir esta etapa.

Incluindo Pausas em um Arquivo de Resposta

Iniciando com o ISA Lite V1.3.4, o formato do arquivo de resposta foi alterado para facilitar a leitura/edição pelo usuário. O arquivo assemelha-se muito a um arquivo de propriedades Java, com comentários iniciados com '#' e vários pares de chave-valor.

Agora há uma maneira de incluir pausas nesses novos arquivos de resposta (usando seu editor favorito). A seguir está um breve resumo das duas novas chaves suportadas:

Notas

Determinando Informações de Versão

Por padrão, a versão da ferramenta (e seus vários subcomponentes) é impressa no console a partir do qual ela foi ativada. Ao executar no modo GUI, as informações de versão também podem ser localizadas usando-se a opção de menu Ajuda->Sobre. Se Java não estiver disponível, ou o aplicativo Java não puder ser iniciado, a versão da ferramenta também poderá ser obtida executando-se os scripts de ativação com a opção "-version".

Ao usar a opção "-version", os scripts de ativação imprimirão as informações de versão sem realmente chamar a ferramenta.

Suporte de Proxy para Uploads HTTPS

Por padrão, os uploads usarão um proxy definido pelo sistema quando um JRE 1.5 ou mais recente for usado. No Windows, o JRE usa a configuração de proxy do Internet Explorer. No Unix, o JRE usa a configuração de proxy GNOME 2. Para substituí-lo e informar um proxy diferente, use a opção "-promptForProxy".

Marcas Registradas 

IBM, o logotipo IBM e AIX são marcas ou marcas registradas da International Business Machines Corportation nos Estados Unidos e/ou em outros países:

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

Microsoft, Windows, Windows NT e o logotipo Windows são marcas registradas da Microsoft Corporation 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 de Linus Torvalds nos Estados Unidos e/ou em outros países.

HP-UX é uma marca registrada da Hewlett-Packard Company.

Outros nomes de empresas, produtos ou serviços podem ser marcas registradas ou marcas de serviço de terceiros.