Como configurar a sincronização automática do Zimbra GAL e verificar se está funcionando.

O que a sincronização automática do GAL realmente faz no Zimbra

Se os usuários conseguem pesquisar na Lista Global de Endereços (GAL), mas os contatos recém-criados ou alterados não aparecem imediatamente, o problema geralmente não é "GAL desativada". Na maioria das vezes, a conta de sincronização da GAL existe, mas o intervalo de verificação da fonte de dados é muito longo, a fonte de dados está desativada ou a última sincronização agendada falhou.

O Guia do Administrador do Zimbra Daffodil (v10) descreve a GAL como um recurso por domínio com três modos: Interno, Externo e Ambos. Uma conta de sincronização da GAL armazena os contatos sincronizados da GAL em um catálogo de endereços, permitindo que os clientes tenham um preenchimento automático e uma navegação mais rápidos. O Zimbra também observa que, se uma conta de sincronização da GAL estiver indisponível, o sistema pode recorrer à pesquisa tradicional baseada em LDAP. Essa distinção é importante: uma pesquisa bem-sucedida não comprova que a sincronização agendada da GAL esteja funcionando corretamente.

Referência: Guia do Administrador do Zimbra Daffodil v10 .

Antes de alterar qualquer coisa, identifique o modo GAL atual e a conta de sincronização.

Execute comandos administrativos como o zimbrausuário do sistema operacional:

su - zimbra
zmprov gd example.com | egrep 'zimbraGalMode|zimbraGalMaxResults|zimbraGalAccountId'

Substitua example.compelo domínio Zimbra real. O primeiro resultado útil é o modo GAL:

• Interno : Os dados da GAL provêm do diretório LDAP do Zimbra.
• Externo : A pesquisa e sincronização da GAL utilizam um diretório LDAP externo, como o Active Directory.
• Ambos : Zimbra combina fontes GAL internas e externas.

Equívoco comum: o modo GAL e a sincronização GAL não são a mesma configuração. O modo GAL informa ao Zimbra de onde vêm as informações do diretório. A sincronização automática é controlada pela fonte de dados GAL e seu intervalo de consulta. Ação: primeiro confirme o modo de domínio e, em seguida, inspecione a fonte de dados, em vez de alterar configurações de preenchimento automático que não têm relação com o problema.

Inspecione a fonte de dados de sincronização GAL antes de editar o cronograma.

Se o domínio já possui uma conta de sincronização GAL, liste suas fontes de dados:

zmprov gds galsync@example.com

Procure por valores como:

zimbraDataSourceName: InternalGAL
zimbraDataSourceEnabled: TRUE
zimbraDataSourcePollingInterval: 1d
zimbraGalLastSuccessfulSyncTimestamp: ...
zimbraGalLastFailedSyncTimestamp: ...
zimbraGalStatus: enabled

O nome exato da fonte de dados pode variar. `internal` InternalGALé um nome comum para uma fonte de dados interna; uma fonte de dados externa pode ser nomeada como `external` ExternalGAL, ADGAL`external` ou com algum nome escolhido pelo administrador.

A documentação do Centro Técnico do Zimbra mostra que o intervalo de consulta da fonte de dados determina a frequência com que as importações automatizadas ocorrem. O Guia do Administrador da versão 10 também afirma que o intervalo pode ser expresso em dias, horas, minutos ou segundos e é definido por fonte de dados.

Referência: Centro Técnico Zimbra: Sincronização da conta GAL .

Defina um intervalo de sondagem GAL prático.

Para alterar uma fonte de dados existente para sincronizar uma vez por hora:

zmprov mds galsync@example.com InternalGAL   zimbraDataSourcePollingInterval 1h

Outros exemplos incluem 30m, 12h, ou 1d. A documentação de esquema publicada pelo Zimbra usa unidades de duração como h, m, s, e d.

Um intervalo menor não é automaticamente melhor. Para um diretório interno pequeno, uma hora pode ser razoável. Para um diretório LDAP externo grande ou um Active Directory conectado à WAN, a consulta frequente pode criar uma carga desnecessária no diretório e no servidor de caixas de correio. Ação: escolha um intervalo com base na rapidez com que as alterações no diretório devem ser refletidas e no custo de uma sincronização completa ou incremental em seu ambiente.

Equívoco comum: forceSync não configura a sincronização automática. Inicia uma sincronização imediata. O agendamento recorrente vem de zimbraDataSourcePollingInterval. Ação: defina o intervalo primeiro e, em seguida, use uma sincronização forçada apenas para validar a configuração imediatamente.

Forçar uma sincronização para verificar a configuração

Após definir o intervalo, inicie uma sincronização imediata:

zmgsautil forceSync -a galsync@example.com -n InternalGAL

Use o nome exato da fonte de dados retornado por zmprov gds. A documentação oficial do Centro Técnico do Zimbra usa esse comando tanto para fontes de dados GAL internas quanto externas.

Em seguida, inspecione a fonte de dados novamente:

zmprov gds galsync@example.com | egrep 'zimbraDataSourceName|zimbraDataSourceEnabled|zimbraDataSourcePollingInterval|zimbraGalLastSuccessfulSyncTimestamp|zimbraGalLastFailedSyncTimestamp|zimbraGalStatus'

Um resultado de verificação útil não é simplesmente "o comando retornou sem erros óbvios". Você precisa ver um registro de data e hora recente de sincronização bem-sucedida, uma fonte de dados habilitada, o intervalo de sondagem esperado e nenhum registro de data e hora mais recente de falha de sincronização que indique que a operação está falhando repetidamente.

Como configurar a sincronização automática da GAL a partir do Console de Administração

Para um domínio novo ou reconfigurado, o caminho gráfico suportado no Zimbra v10 é através da configuração GAL do domínio:

1. Abra o Console de Administração do Zimbra.
2. Acesse Configurar → Domínios .
3. Selecione o domínio desejado.
4. Abra a opção Configurar GAL nas ações do domínio.
5. Selecione Interno , Externo ou Ambos , conforme apropriado.
6. Confirme a conta de sincronização da GAL e os nomes das fontes de dados.
7. Defina o intervalo de sondagem da GAL.
8. Conclua o assistente e, em seguida, use-o zmgsautil forceSyncse precisar de um teste imediato.

O Guia do Administrador da versão 10 observa especificamente que, quando o modo GAL está definido como " Ambos" , um catálogo de endereços é criado para cada fonte de dados LDAP. Ele também alerta os administradores para não editarem diretamente esses catálogos de endereços sincronizados, pois a sincronização pode sobrescrever alterações manuais. Ação: faça as alterações de diretório na fonte LDAP autorizada, e não no catálogo de endereços gerado pela conta de sincronização GAL.

E se a conta de sincronização da GAL não existir?

Para novas implementações, utilize o Console de Administração sempre que possível, pois ele mantém a consistência na relação entre domínio, conta GAL e fonte de dados.

O Centro Técnico do Zimbra também documenta a criação de CLIs zmgsautil createAccount. Um exemplo documentado de GAL interna é:

zmgsautil createAccount   -a galsync@example.com   -n InternalGAL   --domain example.com   -s mailstore.example.com   -t zimbra   -f _InternalGAL

A -sopção mailbox-server está documentada para o ZCS 8 e versões posteriores no artigo do Tech Center. Como o comportamento exato da linha de comando pode variar de acordo com a versão e o pacote, consulte zmgsautila ajuda no servidor instalado antes de criar uma nova conta, em vez de copiar um comando antigo sem verificar.

Equívoco comum: excluir uma conta GAL corrompida com um comando genérico de exclusão de conta não é equivalente a removê-la com o utilitário GAL. O Centro de Tecnologia do Zimbra alerta que excluir uma conta GAL incorretamente pode fazer com que o domínio zimbraGalAccountIdaponte para uma conta inválida. Ação: se você realmente precisar remover e recriar uma conta GAL, siga o zmgsautil deleteAccountprocedimento documentado em vez de tratá-la como uma conta de caixa de correio normal.

Referência: Central Técnica do Zimbra: remover, criar e forçar a sincronização de uma conta GAL .

LDAP externo ou Active Directory: o que muda?

Com uma GAL externa, o mecanismo de agendamento ainda é o intervalo de sondagem da fonte de dados da GAL, mas a sincronização bem-sucedida também depende da configuração LDAP externa: URL do servidor, DN de vinculação, senha de vinculação, base de pesquisa e filtro.

A documentação do Zimbra indica que a primeira fonte de dados externa pode herdar a configuração da GAL (Lista de Endereços Global) do domínio. Fontes de dados adicionais podem ser configuradas com suas próprias configurações de conexão LDAP. Se a sincronização externa falhar, reduzir o intervalo de sondagem não corrigirá problemas como senha de autenticação incorreta, host LDAP inacessível, base de pesquisa incorreta, problema de TLS ou filtro que exclui os usuários esperados.

Ação: se forceSyncfalhar, verifique a conexão com o diretório externo e filtre antes de reduzir ainda mais o intervalo.

Como saber se a sincronização automática está realmente funcionando

Utilize esta breve lista de verificação de validação após a configuração:

Não utilize o preenchimento automático como única forma de verificação de integridade. Como o Zimbra pode recorrer à pesquisa na lista de endereços global (GAL) baseada em LDAP quando a conta de sincronização estiver indisponível, os usuários ainda podem encontrar nomes mesmo que a sincronização agendada da lista de endereços esteja desatualizada.

Solução de problemas quando o cronograma parece correto, mas os dados permanecem desatualizados.

Verifique se houve falha na sincronização do carimbo de data/hora.

Se zimbraGalLastFailedSyncTimestampo registro for mais recente que o último registro de data e hora bem-sucedido, o agendador pode estar funcionando corretamente, mas a fonte de dados está apresentando falhas. Isso é diferente de "sincronização automática desativada". Ação: solucione o problema da fonte de dados em vez de alterar repetidamente o intervalo de pesquisa.

Verifique os registros da caixa de correio relacionados à tentativa de sincronização.

O Zimbra documenta /opt/zimbra/log/mailbox.logo log principal de atividades do mailboxd. Use-o para correlacionar erros em torno do momento de uma operação GAL forçada ou agendada:

tail -f /opt/zimbra/log/mailbox.log

Para um sistema de produção, evite habilitar o registro de depuração abrangente, a menos que seja necessário e você compreenda o volume adicional de logs.

Verifique se há sobreposição de fontes de dados caso encontre contatos duplicados.

O Zimbra observa que várias fontes de dados GAL com escopos de pesquisa sobrepostos podem importar entradas duplicadas; o sistema não reconcilia automaticamente essas duplicatas. Ação: restrinja a base de pesquisa LDAP ou filtre para que cada fonte de dados tenha um escopo claro e, em seguida, execute uma nova sincronização.

Não renomeie uma conta de sincronização GAL existente.

O Guia do Administrador do Zimbra v10 atual afirma que alterar o nome após a criação pode interromper a sincronização. Para alterar o nome, remova e recrie a configuração da GAL usando o processo recomendado. Ação: deixe o nome de uma conta de sincronização GAL em funcionamento inalterado, a menos que haja um motivo operacional real para recriá-la.

Padrão de configuração recomendado

Para uma implantação típica em domínio único, uma abordagem confiável é:

• Mantenha o modo GAL correto para a arquitetura de diretório.
• Utilize uma conta dedicada de sincronização GAL criada através do fluxo de trabalho de configuração GAL do Zimbra.
• Mantenha cada fonte de dados ativada.
• Defina um intervalo de sondagem que corresponda ao atraso aceitável para a mudança de diretório.
• Utilizar zmgsautil forceSyncapenas para validação imediata ou resolução de problemas.
• Confirme o sucesso com os registros de data e hora da fonte de dados, e não apenas com o recurso de preenchimento automático do usuário.
• Para LDAP externo, trate a conectividade, as credenciais de vinculação, a base de pesquisa e os filtros como dependências separadas.

Se essas verificações forem aprovadas, o Zimbra deverá atualizar sua lista de endereços de sincronização global (GAL) na programação configurada. Se os registros de data e hora pararem de avançar ou a sincronização forçada falhar, o próximo passo não é um intervalo menor; é identificar o erro na fonte de dados ou no LDAP que está impedindo a conclusão da tarefa agendada.