Solucionar erros do Utilitário ADSync

Este artigo resolve alguns dos problemas comuns que ocorrem ao se trabalhar com o utilitário ADSync.

Erros encontrados no processo de sincronização geram entradas de log no log do utilitário ADSync. Esses arquivos de log são armazenados em <Install_Directory>/sync/logs. Os arquivos de log são nomeados com a seguinte estrutura:

• sync_data.log.0
• sync_data.log.1
• sync_data.log.2
• sync_data.log.3
• sync_data.log.4

Aqui, sync_data.log.0 é o arquivo de log para a tentativa de sincronização mais recente.

Veja a seguir cenários de erro possíveis:

Antes de tentar qualquer um dos seguintes métodos de resolução de problemas, veja o arquivo sync.properties para assegurar-se de que:

• O atributo action.key não foi modificado.
• O atributo xml.response.dtd não foi modificado.

Se o problema persistir mesmo após a solução de problemas, entre em contato com a equipe de suporte da ServiceAide para obter assistência.

Erros do cliente (LDAP)

Os erros gerados no lado do cliente são registrados no arquivo sync_error.log.0. Para obter mais informações sobre esse arquivo, consulte o arquivo logger.properties.

Erro ao carregar o arquivo de lista de mapeamento de atributo

Revise o arquivo attribute_map.list e verifique se ele contém informações corretas.

Siga estas etapas:

• Verifique se o arquivo está disponível no caminho definido no atributo ldap.attribute.map no arquivo sync.properties.
• Verifique se o atributo org_name está definido corretamente, se você o estiver usado. Os valores de parâmetro não devem conter caracteres nem espaços desnecessários. Para obter mais informações sobre o atributo org_name, consulte Configurar o atributo org_name em Configurar o utilitário ADSync.

Erro ao carregar o arquivo de lista de Base de pesquisa

Revise o arquivo searchBase.list e verifique se ele contém informações corretas.

Verifique se o arquivo está disponível no caminho definido no atributo search.base.list no arquivo sync.properties.

Erro ao carregar o arquivo de mapear de ID de backup

Verifique se o arquivo backupIDMapper.properties está disponível no caminho correto. Esse arquivo deve estar presente em <:Install_Directory>/sync/backup/idMapper. Certifique-se de que este arquivo não esteja modificado de nenhuma forma.

Se você tiver quaisquer problemas no backup, exclua os arquivos de backup e execute uma sincronização completa. No entanto, não modifique nenhum arquivo manualmente.

Para obter mais informações sobre os arquivos de backup, consulte Backup em Introdução ao Utilitário ADSync.

Erro ao conectar ao servidor LDAP

Revise o arquivo sync.properties e verifique se os atributos ldap.gc e ldap.dc estão definidos corretamente.

Em seguida, verifique se os atributos ldap.bind.user e ldap.bind.user.pwd estão definidos corretamente.

Para obter mais informações sobre esses atributos, consulte sync.properties em Configurar o utilitário ADSync.

Erro ao recuperar registros

Verifique se as informações fornecidas no arquivo searchBase.list e no arquivo attribute_map.list estão corretas. Remover caracteres ou espaços desnecessários no atributo org_name.

Verifique se a estrutura da unidade organizacional fornecida no arquivo searchBase.list está correta. Se você vir quaisquer erros nos arquivos, corrija-os e execute a sincronização novamente.

Da mesma forma, verifique se o atributo ldap.searchFilter está definido corretamente no arquivo sync.properties.

Erro ao encontrar o caminho de certificação válida

Durante a conexão com o servidor do ServiceAide Cloud Service Management, você pode encontrar os seguintes erros:

• sun.security.validator.ValidatorException
• sun.security.provider.certpath.SunCertPathBuilderException

Esse erro é encontrado se as configurações de SSL não estiverem configuradas corretamente. Para definir as configurações de SSL, siga o procedimento explicado em Ativar um ambiente SSL para o utilitário ADSync em Configurar o utilitário ADSync.

Erros do servidor

Se houver um erro no servidor do ServiceAide Cloud Service Management, uma resposta é registrada no arquivo sync_data.log.0. A resposta pode ajudá-lo a solucionar o erro. Alguns erros contêm apenas um código de resposta. Quando um código de resposta estiver presente, a resposta XML do servidor não é incluída no arquivo sync_data.log.0.

Erro de conexão - Código de resposta: 4xx

Esses tipos de erros são relatados no arquivo de sync_data.log.0 como código de resposta SEVERE: 4xx. Aqui, 4xx denota o código de resposta (exemplo: 404, 403, 402).

Verifique se o atributo action.url está definido corretamente no arquivo sync.properties.

Se você estiver usando um servidor proxy, verifique se os atributos proxy.host e proxy.port estão definidos corretamente.

Se estiver usando a autenticação de proxy, verifique se os atributos proxy.user e proxy.password estão definidos corretamente.

O Utilitário ADSync oferece suporte apenas à autenticação básica. Certifique-se de que o atributo proxy.auth.preference esteja definido como básico.

Se os atributos proxy.host e proxy.port estiverem definidos corretamente, verifique se as configurações de SSL estão ativadas.

Se as configurações de SSL não estiverem configuradas, siga o procedimento explicado em Ativar um ambiente SSL para o utilitário ADSync em Configurar o utilitário ADSync.

Erro de servidor - Código de resposta: 5xx

Esses tipos de erros são relatados no arquivo de sync_data.log.0 como Código de resposta SEVERE: 5xx. Aqui, 5xx denota o código de resposta (exemplo: 502, 503, 504).

Provavelmente, a ação foi concluída no lado do servidor. Verifique no ServiceAide Cloud Service Management se as alterações estão refletindo. A ação foi bem-sucedida, mas arquivo de backup não foi atualizado. Exclua os arquivos de backup e execute a sincronização novamente.

Se o problema persistir, entre em contato com a equipe de suporte da ServiceAide. Informe a equipe de suporte mesmo se a ação for bem-sucedida no lado do servidor.

Erro de autenticação

Verifique se os parâmetros authtoken e slicetoken estão definidos corretamente no arquivo sync.properties.

Se os parâmetros estão definidos corretamente e o problema ainda ocorrer, entre em contato com a equipe de suporte.

Erro ao criar, atualizar ou excluir um registro

Esse erro indica que as atualizações de alguns registros falharam.

Se apenas alguns registros falharam, atualize-os manualmente.

Se vários registros falharam, exclua o arquivo de backup e execute a sincronização novamente. No entanto, nenhum registro é excluído durante a próxima sincronização, na ausência de arquivos de backup. Quaisquer exclusões devem ser executadas manualmente durante a próxima sincronização. Para obter mais detalhes sobre os arquivos de backup, consulte Backup em Introdução ao Utilitário ADSync.

Erro ao atualizar o backup

Exclua os arquivos de backup e execute a sincronização novamente. No entanto, nenhum registro é excluído durante a próxima sincronização, na ausência de arquivos de backup. Quaisquer exclusões devem ser executadas manualmente durante a próxima sincronização. Para obter mais detalhes sobre os arquivos de backup, consulte Backup em Introdução ao Utilitário ADSync.

Erros de expiração e redefinição de conexão

Durante a sincronização de um grande número de registros, você poderá encontrar erros, como conexão redefinida ou expirada. O erro ocorre porque a conexão entre o utilitário ADSync e o ServiceAide Cloud Service Management expira. A limitação de tempo limite depende de vários fatores, como:

• Tamanho das transações
• Latência de rede
• Interferência do servidor proxy

Você pode resolver esses problemas usando os URLs diretos para o ServiceAide Cloud Service Management. É possível solicitar à equipe de suporte da ServiceAide o URL direto relevante ao seu local.

No entanto, em caso de transações muito grandes, é recomendável dividir os dados em lotes menores, mapeando-os para unidades separadas da organização. Por exemplo, você pode modificar a estrutura da organização de forma que cada unidade esteja limitada aos registros de 15000-20000.

Outros erros

Falha na criação do caminho ou não é possível encontrar o caminho válido

Obtendo o erro de SSL no arquivo sync_data.log do utilitário ADSync.

Mensagem de erro

DD/MM/AAAA XX:XX:XX GRAVE sun.security.validator.ValidatorException: falha na criação do caminho PKIX: sun.security.provider.certpath.SunCertPathBuilderException: não é possível encontrar o caminho de certificação válido para o destino solicitado

DD/MM/AAAA XX:XX:XX GRAVE Exceção durante a tentativa de extrair o código de resposta no bloco catch de exceção javax.net.ssl.SSLHandshakeException: sun.security.validator.ValidatorException: falha na criação do caminho PKIX: sun.security.provider.certpath.SunCertPathBuilderException: não é possível encontrar o caminho de certificação válido para o destino solicitado

Origem

sync_data.log

Resolução

O erro acima mostra que o certificado SSL disponível no arquivo “si” do utilitário ADSync está incorreto. Atualize o arquivo “si” com o certificado SSL de ambiente correto, seguindo as instruções em Ativar um ambiente SSL para o utilitário ADSync.

Código da resposta HTTP: 500

Obtendo o erro de código de resposta HTTP 500 no arquivo sync_data.log do utilitário ADSync.

Mensagem de erro

DD/MM/AAAA XX:XX:XX GRAVE O servidor retornou o código de resposta HTTP: 500 para o URL: https://sm1s.saas.ca.com/NimsoftServiceDesk/servicedesk/controller/processxmldoc?appid=1=1

DD/MM/AAAA XX:XX:XX GRAVE Código da resposta ao obter a exceção java.io.IOException: O servidor retornou o código de resposta HTTP: 500 para o URL: https://sm1s.saas.ca.com/NimsoftServiceDesk/servicedesk/controller/processxmldoc?appid=1=1 é :: 500

Origem

sync_data.log

Resolução

O URL que foi configurado no parâmetro action.url em sync.properties do utilitário ADSync está incorreto e precisa ser corrigido. No exemplo acima, no final do URL, uma palavra-chave adicional “=1” foi acrescentada e, portanto, o URL fica incorreto.

Token de autorização inválido

Erro no ADSync depois de alterar o slicetoken da instância de produção. O utilitário estava funcionando bem no ambiente de armazenamento temporário. Encontrando o seguinte erro no sync_data.logs.

Mensagem de erro

<error errorId="1">Falha ao autenticar o usuário devido a um token de autorização inválido.</error>

Origem

sync_data.log

Resolução

Como mencionado no cenário, você atualizou apenas o slicetoken do novo ambiente. Também é necessário atualizar o campo action.url com o URL do ambiente de produção. Se encontrar o erro acima, verifique se slicetoken, authtoken e action.url estão definidos corretamente no arquivo sync.properties.

Erro depois de atualizar slicetoken, action.url e authtoken

O ADSync está funcionando bem na instância de armazenamento temporário. No entanto, depois de atualizar slicetoken, action.url e authtoken da instância de produção, o utilitário não está criando nenhum usuário na instância de produção. Nenhum erro é exibido no arquivo de log.

Mensagem de erro

Nenhum

Origem

Nenhum

Resolução

O utilitário apontava para a instância de armazenamento temporário durante a última execução. Como ele estava funcionando bem, foi gerado um arquivo de backup dentro do utilitário. Quando alterar o URL para a instância de produção e executar o utilitário, ele valida os dados do usuário do ADSync no arquivo de backup existente. Ele não envia nenhum dado para o aplicativo, pois ele não encontra nenhuma alteração no backup.

Para resolver esse problema, arquive a pasta de backup existente salva em <Utilitário ADSync>/sync/backup em algum outro local e, em seguida, execute o utilitário ADSync novamente.

Se o problema não for resolvido, faça download do utilitário ADSync novamente. Da release Bamboo em diante, esses três valores são preenchidos automaticamente enquanto faz download do utilitário. Quando alterar o ambiente, faça download do utilitário novamente no novo ambiente.

Exceção de usuário ou de conteúdo

Encontrando as seguintes mensagens de erro no arquivo de log depois de executar o utilitário ADSync.

Mensagem de erro

Exceção LDAP ao pesquisar pelo usuário Mensagem de exceção: LDAPException ao criar o contexto do diretório Mensagem de exceção: [LDAP: código de erro 49 - 80090308: LdapErr: DSID-0C0903A9, comentário: erro AcceptSecurityContext, dados 52e, v1db1]
com.ca.saas.adsync.exception.LDAPException: LDAPException ao criar o contexto do diretório Mensagem de exceção: [LDAP: código de erro 49 - 80090308: LdapErr: DSID-0C0903A9, comentário: erro AcceptSecurityContext, dados 52e, v1db1]
em com.ca.saas.adsync.template.LDAPTemplate.initialiseContext(LDAPTemplate.java:284)
em com.ca.saas.adsync.template.LDAPTemplate.search(LDAPTemplate.java:83)
em com.ca.saas.adsync.adapter.NSDAdapter.getUserList(NSDAdapter.java:137)
em com.ca.saas.adsync.AdSyncService.main(AdSyncService.java:80)

Origem

sync_data.log

Resolução

O código de erro Ldap "Erro AcceptSecurityContext, dados 52e" indica que você está usando credenciais inválidas. Esse erro é retornado quando o nome de usuário é válido, mas a senha/credencial é inválida. Visite o seguinte URL para obter mais detalhes:

http://ldapwiki.willeke.com/wiki/Common%20Active%20Directory%20Bind%20Errors

Organização não atualizada

O ADSync apresenta falha ao atualizar as informações da organização.

Aviso

A organização principal não foi atualizada, pois um perfil de organização correspondente não foi encontrado no Nimsoft Service Desk.

Origem

sync_data.log

Causa

• A hierarquia da organização não está definida em sua instância do ServiceAide Cloud Service Management.
• Há entradas em duplicidade para as organizações no ServiceAide Cloud Service Management.

Resolução

Corrija a hierarquia da organização no ServiceAide Cloud Service Management. Vá para GERENCIAR, Ferramentas, Organizações para analisar e corrigir sua hierarquia organizacional.

Observação: sempre configure a hierarquia da organização antes de instalar o utilitário ADSync.