Guia de Resolução de Problemas

Índice

Lista de Verificação de Rastreio do Host On-Demand

O Host On-Demand oferece os seguintes tipos de opções de rastreio:

Rastreios Básicos
Rastreios Avançados
Service Manager
Redirecionador
Compactador de Informações

Rastreios Básicos

Os rastreios básicos reúnem informações sobre problemas quando o cliente não faz download conforme esperado. Eles também capturam as informações de configuração do Host On-Demand.

Siga as seguintes etapas para ativar o rastreio Básico:

  1. Abra o Assistente de Implementação do Host On-Demand para editar um arquivo HTML existente ou para criar um novo.
  2. Clique nas janelas até alcançar a janela Opções Adicionais.
  3. Clique no botão Opções Avançadas.
  4. Clique em Determinação de Problemas na visualização em árvore à esquerda.
  5. Selecione Básico. Verifique opcionalmente a caixa 'Incluir conponentes de determinação de problemas' . A caixa 'Incluir Componentes de Determinação de Problema' já estará selecionada por padrão se você estiver editando um arquivo HTML existente que foi criado com a determinação de problema configurada.
  6. Clique em OK.
  7. Conclua a criação do arquivo HTML.

Quando ocorrer um problema, abra o Java Console do navegador e copie o conteúdo para um arquivo de texto (*.txt). Certifique-se de que obter todas as entradas do Java Console. O Java Console pode ter várias janelas de comprimento. Para obter informações adicionais, consulte Exibindo o Java Console.

Rastreios Avançados

Os rastreios avançados capturam o tráfego telnet entre o Host On-Demand e o servidor telnet do host. O Host On-Demand oferece os seguintes tipos de rastreio Avançado:

Transporte
IPMON
Service Manager
Redirecionador

Transporte

Você pode ativar o rastreio de Transporte incluindo o parâmetro TraceOptions para a tag APPLET em seu arquivo HTML. A maneira mais fácil de incluir esse parâmetro é utilizando o Assistente de Implementação. No entanto, você pode também incluir esse parâmetro manualmente editando diretamente o código HTML. Consulte Configurando manualmente a depuração Avançada para obter informações adicionais.

Siga as seguintes etapas para ativar o rastreio de Transporte utilizando o Assistente de Implementação:

  1. Abra o Assistente de Implementação do Host On-Demand para editar um arquivo HTML existente ou para criar um novo.
  2. Clique nas janelas até alcançar a janela Opções Adicionais.
  3. Clique no botão Opções Avançadas.
  4. Clique em Determinação de Problemas na visualização em árvore à esquerda.
  5. Selecione Avançado.
  6. Digite o nome do arquivo de log no campo 'Nome do arquivo de log' . O Assistente de Implementação fornece o nome de arquivo padrão hodtrace.txt, mas você pode alterá-lo se desejar. Para plataformas de clientes com base no Unix, inclua o caminho absoluto para o local em que deseja salvar o arquivo. Para plataformas de clientes Windows, se você não especificar um caminho absoluto, o arquivo de log será salvo no desktop do cliente.
  7. Selecione 'Ativar o rastreio de transporte'.
  8. Clique em OK.
  9. Conclua a criação do arquivo HTML.

Quando ocorrer um problema e você tiver ativado o rastreio de Transporte, siga as seguintes etapas:

  1. Inicie o cliente Host On-Demand. Quando o desktop aparecer, a janela Rastreio de Componente Automático do Host On-Demand aparecerá observando que o rastreio foi iniciado.
    Nota: Pode ser necessário mover outras janelas para localizar essa janela.
  2. Clique no ícone de sessão, se a sessão não for auto-inicializada.
  3. Alterne para a janela do emulador e recrie o problema. Não feche a janela de rastreio.
  4. Quando ocorrer um problema novamente, selecione a janela Rastreio de Componente Automático do Host On-Demand. A janela pode agora estar escondida atrás de outras janelas. Selecione a opção de rastreio 'END' e clique em OK.
  5. Abra o Java Console do navegador e copie o conteúdo para um arquivo de texto (*.txt). Certifique-se de que obter todas as entradas do Java Console. O Java Console pode ter várias janelas de comprimento. Para obter informações adicionais, consulte Exibindo o Java Console.

IPMON

Para obter uma visão geral do IPMON, consulte IPMON neste Guia de Resolução de Problemas.

Siga as seguintes etapas para ativar o rastreio IPMON:

  1. Abra o Assistente de Implementação do Host On-Demand para editar um arquivo HTML existente ou para criar um novo.
  2. Clique nas janelas até alcançar a janela Opções Adicionais.
  3. Clique no botão Opções Avançadas.
  4. Clique em Determinação de Problemas na visualização em árvore à esquerda.
  5. Selecione Avançado.
  6. Digite o nome do arquivo de log no campo 'Nome do arquivo de log' . O Assistente de Implementação fornece o nome de arquivo padrão hodtrace.txt, mas você pode alterá-lo se desejar. Para plataformas de clientes com base no Unix, inclua o caminho absoluto para o local em que deseja salvar o arquivo. Para plataformas de clientes Windows, se você não especificar um caminho absoluto, o arquivo de log será salvo no desktop do cliente.
  7. Selecione 'Ativar o rastreio do IPMonitor'. Se você estiver utilizando o modelo com base no HTML, o campo 'Nome da Sessão' será pré-preenchido com o nome das sessões atuais que você está configurando. Se você estiver utilizando a Configuração baseada no servidor ou os modelos Combinados, deverá digitar manualmente o nome da sessão que deseja rastrear.
  8. Clique em OK.
  9. Conclua a criação do arquivo HTML.

Quando ocorrer um problema e você tiver ativado o rastreio de IPMonitor, siga as seguintes etapas:

  1. Inicie o cliente Host On-Demand.
  2. Quando o desktop do Host On-Demand aparecer, clique com o botão direito do mouse no ícone da sessão e selecione Iniciar Sessão com IPMONITOR.
  3. No IPMonitor V1.0 para Java, a janela modo automático aparece observando que o rastreio foi iniciado.
    Nota: Pode ser necessário mover outras janelas para localizar essa janela.
  4. Alterne para a janela do emulador e recrie o problema. Não feche a janela de rastreio.
  5. Quando o problema ocorrer novamente, selecione o IPMonitor V1.0 para Java, janela modo automático. A janela pode agora estar escondida atrás de outras janelas. Clique em Parar e, em seguida, em Salvar e em Sair. Confirme o local em que o arquivo de rastreio é salvo e o nome do arquivo.
  6. Abra o Java Console do navegador e copie o conteúdo para um arquivo de texto (*.txt). Certifique-se de que obter todas as entradas do Java Console. O Java Console pode ter várias janelas de comprimento. Para obter informações adicionais, consulte Exibindo o Java Console.

Service Manager

O recursos de rastreio do Service Manager está disponível através da página Serviços da janela Administração.  Utilize esse recurso para reunir informações sobre resolução de problemas do Service Manager. Na página Serviços, clique em Rastreio do Service Manager para iniciar e parar o rastreio e definir o nível de rastreio.  Consulte Serviços do Host On-Demand para obter informações adicionais.

Redirecionador

O recurso de rastreio e mensagens do servidor sempre é instalado e está disponível por meio da página Serviços da janela Administração. Em Serviços, é possível iniciar e parar o rastreio do Redirecionador e visualizar o Console de Rastreio/Mensagens do servidor, que permite visualizar as informações de rastreio e de mensagens na tela. As informações também são salvas no NCoDServices.RAS.txt no diretório private. Esse arquivo pode ser exibido com qualquer editor de texto ASCII. Consulte Serviços do Host On-Demand para obter informações adicionais.

Para obter informações mais detalhadas sobre como rastrear o servidor, consulte Rastreando no Servidor.

Compactador de Informações

Utilize o Empacotador de Informações para coletar informações de diagnóstico de um servidor Host On-Demand. O Empacotador de Informações armazena cópias em um arquivo ZIP dos seguintes:

Os arquivos de fontes definidos pelo usuário não serão apresentados no servidor Host On-Demand, a menos que sejam criados pelo usuário.

O arquivo ZIP poderá, então, ser enviado ao Centro de Suporte IBM para auxiliar no diagnóstico dos problemas.

É possível executar o Compactador de Informações através de uma GUI (Interface Gráfica do Usuário) em todas as plataformas suportadas, exceto Novell, i5/OS, OS/400 e z/OS, ou através da linha de comandos.

Executando o Empacotador de Informações

Para executar o Empacotador de Informações, execute as seguintes ações:

Nesses comandos, install_dir é o diretório de instalação do software Host On-Demand.

Para exibir uma lista das opções da linha de comandos, chame o Empacotador de Informações sem nenhum parâmetro ou com o parâmetro -?. Para obter informações adicionais, consulte Opções da linha de comandos do Empacotador de Informações.

GUI do Empacotador de Informações

A GUI do Compactador de Informações está disponível em todas as plataformas suportadas, exceto Novell, i5/OS, OS/400 e z/OS. Para acessar a GUI, chame o Empacotador de Informações com o parâmetro -gui.

A janela do Empacotador de Informações do Host On-Demand é aberta.

  1. Especifique o diretório de publicação do Host On-Demand desejado, se não for o diretório de publicação padrão.
  2. Especifique o diretório de publicação do Host On-Demand alternativo para arquivos do Assistente para Implementação. Este campo deve ser definido para o mesmo caminho como o campo Diretório no painel Resumo do Assistente para Implementação. O caminho padrão é o diretório de publicação do Host On-Demand.
  3. Selecione os tipos de informações a serem reunidos. Se você estiver reunindo informações de rastreio do IPMonitor, especifique o nome do arquivo de rastreio. Para isso, selecione o botão Arquivos de Rastreio do IPMonitor, que abrirá um diálogo separado. Em seguida, procure um arquivo .TLG particular ou procure um diretório para os arquivos .TLG.
  4. Especifique o arquivo de saída.

    O arquivo de saída padrão é install_dir\private\hodpd.zip.

    Qualquer arquivo de saída existente será sobreposto. Você não receberá nenhuma tela de confirmação.

    Se você selecionar a renomeação do arquivo de saída, o Empacotador de Informações não incluirá automaticamente uma extensão .zip ao arquivo.

  5. Clique sobre OK. Os arquivos selecionados são adicionados no arquivo ZIP de saída.

Opções da Linha de Comandos do Empacotador de Informações

O Empacotador de Informações pode ser acessado através da linha de comandos em todas as plataformas suportadas do Host On-Demand.

Para exibir as opções da linha de comandos, execute o Empacotador de Informações a partir da linha de comandos com o parâmetro -? ou sem qualquer parâmetro.

Para obter informações sobre a execução do Empacotador de Informações em todas as plataformas do Host On-Demand, consulte Executando o Empacotador de Informações.

Para especificar todos os parâmetros da linha de comandos que deseja especificar, pode ser necessário editar a linha do script de comandos para chamar o Empacotador de Informações. Originalmente, esta linha especifica um número limitado de parâmetros simbólicos (como, por exemplo, %1 %2 e assim por diante ou $1 $2 e assim por diante) em vez dos parâmetros atuais.

Em plataformas que suportam a GUI, se desejar executar o Empacotador de Informações com as opções da linha de comandos em vez de executá-lo com a GUI, edite a linha do script de comando que chama o Empacotador de Informações para remover o parâmetro -gui. Caso contrário, o parâmetro -gui substituirá as opções da linha de comandos.

Incluindo uma Extensão Personalizada ao Empacotador de Informações

Você pode incluir extensões personalizadas no arquivo de configuração padrão do Empacotador de Informações, infbnd.properties. Também é possível especificar um arquivo de configuração diferente. O arquivo de configuração indica quais tipos de informações podem ser selecionados para inclusão no arquivo ZIP. Você também pode adicionar novos tipos de informações e especificar quais arquivos serão reunidos quando este novo tipo for selecionado.

Para especificar um arquivo de configuração diferente, utilize o parâmetro -cfg seguido pelo nome do arquivo de configuração que você deseja utilizar. Um nome de caminho não absoluto será pesquisado, com início no diretório de instalação do Host On-Demand. Para obter informações adicionais sobre as opções da linha de comandos, consulte Opções da linha de comandos do Empacotador de Informações.

Para incluir uma extensão personalizada no arquivo de configuração padrão, siga as seguintes etapas:

  1. Faça um backup do arquivo infbnd.properties, localizado no diretório de publicação do Host On-Demand.
  2. Escolha uma das 32 categorias de informações de extensão (Extension01 - Extension32) e inclua a categoria em InfoCategoryList. O exemplo a seguir mostra o InfoCategoryList padrão com Extension01 incluída no final: InfoCategoryList: \ HODRegKeys ; \ PrivateDir ; \ SecurityFiles ; \ HTMLFiles1 ; \ PropFiles1 ; \ JavaScriptFiles ; \ NSMPropFiles ; \ DepWizFiles ; \ PrtDefFiles ; \ DirUtilFilesWin32 ; \ DirUtilFilesNonWin32 ; \ UdfFiles ; \ Extension01
    No exemplo abaixo, certifique-se de colocar um caractere '\' no final da linha depois de UdfFiles.
  3. Modifique Extension01 InfoCategory de amostra no final do arquivo infbnd.properties.
  4. Modifique os elementos WorkItem de amostra para Extension01 no final do arquivo infbnd.properties.
  5. Copie o arquivo de configuração atualizado para o diretório de publicação do Host On-Demand.
  6. Execute o Empacotador de Informações com o arquivo de configuração atualizado.
  7. Execute o Empacotador de Informações a partir do console ao invés de utilizar um ícone, para verificar se existe um erro no novo arquivo de configuração. Se houver um erro, o Empacotador de Informações gravará uma mensagem de erro geral no console e gravará uma descrição do erro específico no arquivo de log. O arquivo de log é denominado infbnd.log e está localizado no diretório de instalação.

A seguir, definições de elementos utilizados no arquivo de configuração:

Nomes de InfoCategoryList e de InfoCategory
O InfoCategoryList é o elemento de nível superior do arquivo de configuração. Este elemento consiste no termo InfoCategoryList, seguido por uma lista de nomes do InfoCategory. Exemplos de nomes do InfoCategory são: HODRegKeys, PrivateDir e SecurityFiles. Cada nome do InfoCategory refere-se a um grupo de elementos de dados denominados de maneira semelhante (constituindo um InfoCategory) contidos no arquivo de configuração. Um InfoCategory inclui: um InfoType, um DisplayName, um CmdLineOption, um elemento Platform, um ZipDir e um ou mais WorkItems.
InfoType
Este elemento identifica o tipo de informação a ser coletada. Tipos válidos são FileSet e RegKeySet. O nome deste elemento é formado como a seguir: nome do InfoCategory + _InfoType.
DisplayName
Esse elemento identifica a chave de mensagem utilizada pelo Host On-Demand para a mensagem a ser exibida para o usuário no painel GUI Java do Empacotador de Informações (por exemplo, KEY_IB_EXTENSION_01 faz com que Extension01 seja exibida). Essas mensagens são definidas da seguinte forma: KEY_IB_EXTENSION_xx, em que xx é o número da extensão (01-32). O nome deste elemento é formado como a seguir: nome do InfoCategory + _DisplayName.
CmdLineOption
Este elemento especifica a cadeia de texto que será utilizada como uma opção da linha de comandos para identificar uma categoria de informação. Exemplos disso são: sec para SecurityFiles; ext01 para Extension01. Na linha de comandos, o parâmetro da linha de comandos deve ser precedido por um '-' (por exemplo, '-ext01'). O nome deste elemento é formado como a seguir: nome do InfoCategory + _CmdLineOption.
Platform
Este elemento especifica os tipos de plataformas nas quais a categoria de informação é válida. Tipos de plataformas válidas são: AIX (incluindo Linux e Solaris), Win32, i5/OS, OS/400 e MVS. Por exemplo, a categoria HODRegKeys é válida apenas para o tipo de plataforma Win32. Quando o utilitário é executado, uma categoria inválida para a plataforma atual é ignorada. O nome desse elemento é formado como a seguir: nome do InfoCategory + _Platform.
ZipDir
Este elemento opcional especifica uma cadeia de texto que será utilizada como um diretório de entrada ZIP de nível superior para uma Categoria de Informação (por exemplo, test faria com que todos os caminhos da entrada ZIP para a categoria de informação fossem iniciados com .\test\). O nome desse elemento é formado como a seguir: nome do InfoCategory + _ZipDir. Para nenhum nome do diretório de entrada ZIP, especifique none.
Referências do WorkItemList e do WorkItem
Este elemento especifica uma lista de um ou mais conjuntos de informações que serão coletadas. O nome desse elemento é formado como a seguir: nome do InfoCategory + _WorkItemList (por exemplo, Extension01_WorkItemList). A lista deve conter uma ou mais referências do WorkItem. Uma referência do WorkItem possui o formato: WorkItem_ + numeral (por exemplo, WorkItem_1, WorkItem_2).
WorkItem
Este elemento descreve um conjunto de informações a serem coletadas. O nome desse elemento é formado como a seguir: nome do InfoCategory + _ + referência do WorkItem (por exemplo, Extension01_WorkItem_1). Quando InfoType for FileSet, o WorkItem conterá os seguintes subelementos: DirType, DirName, SubdirSearchDepth, Include e Exclude. Quando InfoType for RegKeySet, o WorkItem conterá os subelementos RegKey.
PlatformWI
Este subelemento pode ocorrer dentro de um elemento WorkItem, quando o InfoType do InfoCategory é FileSet. Esse subelemento é opcional. Para o WorkItem no qual ele ocorre, esse subelemento restringe o escopo do comando Platform, o qual, de outra forma, controla o InfoCategory. Por exemplo, SecurityFiles InfoCategory tem SecurityFiles_Platform definida para 'win32; aix; mvs; os400', indicando que esta InfoCategory aplica-se a todos os quatro tipos de plataformas. No entanto, Security_Files_WorkItem_1 tem um sub elemento PlatformWI definido para 'win32, aix, mvs', indicando que este item de trabalho específico aplica-se apenas aos três tipos de plataformas especificados.
DirType
Este subelemento ocorre dentro de um elemento WorkItem, quando o InfoType do InfoCategory é FileSet. Esse subelemento descreve a relação do diretório a ser pesquisado para a estrutura de arquivos do sistema. Tipos válidos são:
RelativeToInstall
O utilitário pesquisará no diretório de instalação do Host On-Demand o subdiretório especificado no subelemento DirName.
RelativeToPublish
O utilitário pesquisará no diretório de publicação do Host On-Demand o subdiretório especificado no subelemento DirName.
RelativeToDir
O utilitário pesquisará no subdiretório especificado no subelemento DirName.
Absolute
O utilitário ignorará o elemento DirName e pesquisará o arquivo, utilizando o caminho de arquivo especificado no subelemento Include.
DirName
Este subelemento ocorre dentro de um elemento WorkItem, quando o InfoType é FileSet e quando o DirType é RelativeToInstall, RelativeToPublish ou RelativeToDir. Esse elemento especifica o caminho do subdiretório a ser pesquisado. O valor pode ser qualquer caminho válido incluindo .. Para RelativeToInstall e RelativeToPublish, o DirName deve ser um caminho de diretório relativo. Para RelativeToDirectory, o DirName deve ser um caminho de diretório absoluto.
SubdirSearchDepth
Este subelemento ocorre dentro de um elemento WorkItem, quando InfoType é FileSet. Esse elemento especifica quantos níveis de subdiretórios a partir do diretório inicial devem ser pesquisados para os arquivos Include. Os valores válidos são: 0, 1, 2, 3, etc.. . Para procurar todos os subdiretórios, especifique todos. A profundidade de pesquisa máxima permitida é determinada pela quantidade de memória disponível na JVM.
Include
Este subelemento ocorre dentro de um elemento WorkItem, quando InfoType é FileSet. Ele especifica uma lista de um ou mais arquivos a serem coletados. O nome do arquivo seguinte ao último separador de arquivos pode conter os caracteres curinga '?' (que correspondem a qualquer caractere, exceto '.') e '*' (que corresponde a 0 ou mais caracteres, exceto '.'). Quando o utilitário for executado, ele tentará coletar todos os arquivos que correspondem ao padrão.
Exclude
Este subelemento ocorre dentro de um elemento WorkItem, quando InfoType é FileSet. Ele especifica uma lista de um ou mais arquivos a serem excluídos. O nome do arquivo seguinte ao último separador de arquivos pode conter os caracteres curinga '?' (que correspondem a qualquer caractere, exceto '.') e '*' (que corresponde a 0 ou mais caracteres, exceto '.'). Quando o utilitário for executado, ele rejeitará os arquivos que correspondem ao padrão.
RegKey
Este subelemento ocorre dentro de um elemento WorkItem, quando InfoType é RegKeySet. Ele define uma subchave de registro do Microsoft Windows a ser lida.

Topo da Página Índice