Antes de começar a resolução de problemas do aplicativo IBM Telephone Directory V5.2, responda às seguintes perguntas para ajudar a resolver alguns problemas comuns durante a utilização do aplicativo:
Utilize as informações a seguir se ainda tiver problemas com seu aplicativo:
Configuração da Resolução de Problemas
Problema | Causa | Solução |
Sua instalação falhou com a seguinte mensagem: ldap_search: Acesso insuficiente | Você digitou uma senha de administrador do servidor LDAP incorreta. | Obtenha a senha correta ou reconfigure a senha. |
Seu script de configuração falhou com as seguintes mensagens: ldap_search: Objeto não existe Erro 32 ao verificar configurações de LDAP | Pode haver um problema relacionado à falta do DN base no servidor LDAP. | Pode haver um problema relacionado à configuração do servidor LDAP base. |
Resolução de Problemas de Autenticação
Problema | Causa | Solução |
Falha no login | No aplicativo, os IDs de usuário e senhas devem conter caracteres que mapeiem para o CCSID de job que é utilizado pelo servidor HTTP. Caso contrário, a autenticação falha. | Certifique-se de que seus caracteres mapeiem para o CCSID de job que é utilizado pelo servidor HTTP. Para determinar o CCSID do job do servidor HTTP, digite WRKACTJOB em uma linha de comandos do OS/400 e selecione Exibir Atributos de Definição de Job. O CCSID do servidor HTTP é determinado pela diretiva defaultFSCCSID do servidor HTTP. Para obter informações adicionais, consulte Avisos e Limitações. |
O URL falha ou o aplicativo não aparece | Se você não iniciar o aplicativo IBM Welcome Page, o URL falha (http://your.server.name:port/ibm-bizApps/welcome-home.do ou http://your.server.name:port/ibm-bizApps/welcome-admin.do). Ocorrem problemas também se você iniciar o aplicativo IBM Welcome Page mas não iniciar o aplicativo IBM Telephone Directory. Se o aplicativo IBM Telephone Directory não estiver sendo executado, não haverá links para ele no aplicativo Welcome Page. | Inicie o aplicativo IBM Welcome Page e o aplicativo IBM Telephone Directory. |
Pedidos para o aplicativo falham | Se você utilizou o servidor HTTP interno incluído com o WebSphere Application Server para fazer referência ao aplicativo IBM Telephone Directory V5.2, determinados pedidos para o aplicativo falham. | Você deve utilizar o servidor HTTP IBM associado para fazer referência ao aplicativo. Diretivas de segurança para autenticação do servidor LDAP são configuradas e requeridas pelo aplicativo IBM Telephone Directory durante a criação de uma nova instância de servidor de aplicativos. O servidor HTTP interno do WebSphere Application Server não é configurado com as diretivas de segurança necessárias, e determinados pedidos para o aplicativo falham se o servidor HTTP interno for utilizado. Consulte Interação com o Servidor HTTP IBM para obter informações adicionais. |
Resolução de Problemas de Uso
Problema | Causa | Solução |
Link ausente para o aplicativo | O URL http://your.server.name:port/ibm-bizApps/welcome/home.do o leva ao ponto inicial do IBM Business Solutions, incluindo o aplicativo IBM Telephone Directory V5.2. | Se o link para o aplicativo IBM Telephone Directory V5.2 estiver ausente, verifique se tanto o aplicativo IBM Welcome Page quanto o aplicativo IBM Telephone Directory foram iniciados. |
Confusão com o ID de usuário de administração | Pode ser confuso determinar qual ID de usuário deve ser informado para autenticação no aplicativo quando você (o administrador) precisar atualizar ou registrar um usuário em um ambiente de assinatura fechada. | O ID de usuário padrão é Administrator, e a senha é configurada durante a instalação. Não informe seu ID de usuário e senha pessoais. IDs de usuário do aplicativo podem ser visualizados por todos. Se você não souber o ID de usuário de uma entrada, utilize a página de pesquisa do aplicativo para localizar a entrada. O ID de usuário é exibido sob a figura. |
Erro do servidor interno durante pesquisa ou registro | Se você tentar pesquisar um usuário ou registrar um usuário e receber um erro HTTP 500 - Erro de Servidor Interno, seus arquivos de configuração podem estar corrompidos. O aplicativo IBM Telephone Directory V5.2 pode não ser capaz de localizar os arquivos de configuração associados para o aplicativo. | Reinstale o aplicativo IBM Telephone Directory V5.2. |
Erro do sistema durante pesquisa | Se você tentar pesquisar um usuário e receber o seguinte erro: Ocorreu um erro do sistema! Tente novamente mais tarde, geralmente significa que seu servidor LDAP não foi iniciado. | Inicie o servidor LDAP e tente pesquisar novamente. |
Erro de falha na operação durante registro | Se você tentar registrar um usuário e receber o erro ERRO: Falha na operação. Entre em contato com seu administrador do IBM Telephone Directory, geralmente significa que seu servidor LDAP não foi iniciado. | Inicie o servidor LDAP e tente registrar novamente. |
Erro de falha na operação durante atualizações ou exclusões | Se você tentar atualizar ou excluir um perfil e receber o erro ERRO: Falha na operação. Entre em contato com seu administrador do IBM Telephone Directory, você pode não ter as diretivas apropriadas configuradas no servidor HTTP. Um sintoma desse problema é a falta do diálogo de autenticação para informar seu ID de usuário e senha antes de fazer alterações. | Inclua manualmente as diretivas de configuração LDAP na configuração do servidor HTTP ou reinstale o aplicativo IBM Telephone Directory V5.2. |
Erro de objeto não localizado | Se você receber um erro 404 - Objeto não localizado no aplicativo IBM Telephone Directory, pode ser porque seu arquivo plugin-cfg.xml está corrompido. | Realize as etapas a seguir para verificar esse arquivo e corrigi-lo, se necessário:
|
Erro de máximo de perfis excedido | O IBM Telephone Directory é um programa gratuito para até 1000 entradas de usuário. O servidor de diretórios LDAP deve ser configurado para que o número de entradas de pesquisa permitidas no DN base do IBM Telephone Directory seja maior ou igual a 1000. | Para obter informações sobre o limite de 1000 entradas de usuário, consulte Avisos e Limitações. |
Alguns valores não são salvos | Se você não tiver autoridade para incluir, alterar ou remover um campo específico e tentar fazê-lo no aplicativo, receberá uma mensagem informando que alguns valores não foram salvos porque o diretório não permite que você os inclua em seu perfil, e para entrar em contato com o administrador do aplicativo para obter detalhes. | Se você receber esse erro, significa que o aplicativo IBM Telephone Directory V5.2 foi configurado para exigir autenticação. |
Caracteres especiais (como ", &, <, ou >) não são manipulados corretamente | O aplicativo IBM Telephone Directory V5.2 foi gravado para aceitar e manipular todos os caracteres corretamente, mesmo aqueles identificados como caracteres especiais (ou metacaracteres) para valores de filtros e atributos HTML, JavaScript, e LDAP. | Em alguns casos conhecidos, o aplicativo IBM Telephone Directory manipula caracteres especiais para valores de atributo LDAP corretamente, de acordo com o padrão RFC 2253. No entanto, o servidor de diretórios não suporta completamente o padrão. Nesses casos, nada mais pode ser feito além de evitar o uso de tais caracteres. O caractere aspas (") é um exemplo desse problema. O padrão RFC 2253 especifica que o caractere deve ser transformado em um caractere de escape, sendo antecedido por uma barra invertida (\), para ser aceito como um caractere literal em um valor de atributo LDAP. Como a versão atual do Directory Services (LDAP) não suporta completamente o padrão RFC 2253, o servidor salva tanto o caractere barra invertida quanto o caractere aspas. |
Log e Depuração de Erros
Logs de Erros
O servidor de aplicativos possui vários logs nos quais as mensagens são gravadas. Por exemplo, mensagens do sistema, que podem ser gravadas por qualquer componente ou aplicativo de servidor de aplicativos são gravadas em logs para propósitos gerais como logs JVM (JAVA Virtual Machine) e logs de IBM Service. Outros logs são muito específicos em natureza e têm escopo definido para um determinado componente ou atividade. Por exemplo, o plugin Servidor HTTP mantém um log de plugin específico de componente.
Os logs para propósito geral, como JVM e IBM Service, são utilizados para monitorar o funcionamento do servidor de aplicativos e auxiliar na resolução de problemas. A resolução de problemas de componentes específicos pode exigir análise de log adicional, como arquivos de log específicos para componentes ou produtos.
Declarações de Rastreio
Declarações de rastreio de aplicativos podem ser ativadas com o objetivo de depurar problemas. Se o problema persistir e for necessário entrar em contato com o IBM Service para obter ajuda, a primeira informação solicitada pode ser uma cópia da saída de rastreio do aplicativo. Declarações de rastreio são ativadas incluindo-se uma linha no arquivo de configuração do aplicativo e reiniciando o aplicativo.
O aplicativo irá ler a nova configuração quando for iniciado. A declaração de rastreio do aplicativo será ativada neste momento. Quando ativadas, declarações de rastreio são gravadas no arquivo SystemOut.log do servidor.