Mis à jour le 6 octobre 2026. Si la recherche Zimbra renvoie des résultats incomplets pour une boîte aux lettres et que le journal de cette boîte aux lettres signale une erreur d'indexation ou de Lucene, la solution habituelle consiste à reconstruire l'index de recherche de cette boîte aux lettres zmprov rim account@example.com start. Cette commande recrée les données d'index consultables à partir du contenu de la boîte aux lettres ; elle ne résout pas les problèmes liés à des fichiers de messages manquants, une corruption de la base de données, un volume de stockage saturé ou des pannes de recherche affectant l'ensemble du serveur.
Pour évaluer la réussite de l'opération, il faut observer les résultats concrets : la réindexation doit être terminée, les recherches ciblées doivent afficher les messages précédemment manquants et les nouveaux courriels doivent continuer à apparaître dans les résultats de recherche. Le lancement de la commande ne garantit pas la reconstruction de l'index. Planifiez cette opération pendant une période plus calme, vérifiez d'abord le volume de données de l'index et effectuez-la sur un seul compte concerné avant d'étendre la procédure.
Quand une réindexation de boîte aux lettres est-elle la solution appropriée ?
Un index endommagé ou incomplet est une cause probable du problème lorsque l'accès normal à la boîte aux lettres fonctionne mais que les recherches ne trouvent pas certains messages, qu'un utilisateur concerné constate des résultats de recherche incohérents ou /opt/zimbra/log/mailbox.logqu'il reçoit des messages tels que « Échec de l'ouverture de l'indexeur » ou une exception Lucene pour ce compte. La documentation de dépannage de Zimbra zmprov verifyIndexfournit des informations sur le diagnostic d'un index manquant ou inaccessible et explique zmprov rim ... startcomment le recréer.
Commencez par définir le périmètre du problème. Si un seul utilisateur est concerné, examinez sa boîte aux lettres. Si plusieurs utilisateurs du même serveur de messagerie présentent le même symptôme, vérifiez l'état du serveur, sa capacité de stockage, les mises à jour récentes et les journaux avant de lancer plusieurs réindexations. Un grand nombre de réindexations peut consommer une quantité importante de ressources disque et de processeur, et aggraver les ralentissements de recherche pour les autres utilisateurs.
Une réindexation n'est pas la première solution appropriée lorsque les utilisateurs ne peuvent pas se connecter, que des dossiers sont manquants, que les messages ou les pièces jointes ne s'ouvrent pas, que la base de données de messagerie signale des erreurs ou que le service de recherche est indisponible pour plusieurs comptes. Ces signes peuvent indiquer des problèmes de base de données, de stockage d'objets blob, de service ou d'infrastructure. Il est recommandé de conserver les journaux et d'utiliser la procédure de récupération Zimbra correspondante ou le canal d'assistance approprié plutôt que de considérer systématiquement toute réclamation relative à la recherche comme une corruption d'index.
Avant d'exécuter la commande
- Vérifiez l'adresse de la boîte aux lettres cible : copiez l'adresse du compte principal, et non un alias. Dans un déploiement multi-serveurs de messagerie, identifiez le serveur de messagerie propriétaire du compte et exécutez la commande en fonction de votre topologie et de la version de Zimbra installée.
- Vérifiez l'espace disponible : examinez l'espace libre et les inodes sur le volume d'index. Les installations peuvent placer les données d'index sur un point de montage distinct ; ne considérez pas le chemin par défaut comme l'emplacement actif. Un volume d'index plein peut entraîner des échecs d'indexation.
- Vérifiez la charge du système : notez la latence actuelle de la boîte aux lettres, l’activité du processeur et du disque. La réindexation est gourmande en ressources, surtout pour les boîtes aux lettres volumineuses ; planifiez-la donc en dehors des heures de pointe.
- Préserver la capacité de récupération : avant toute maintenance, assurez-vous que le processus de sauvegarde habituel est fonctionnel et récent. La réindexation vise à reconstituer les données de recherche dérivées, mais une sauvegarde reste indispensable avant toute intervention sur la messagerie en production.
- Vérifiez la compatibilité des commandes : la syntaxe et les options disponibles de l’interface de ligne de commande (CLI) de Zimbra peuvent varier selon la version. Consultez l’aide et la documentation des commandes correspondant à la version installée, notamment si vous utilisez une version antérieure ou un déploiement personnalisé.
Comment vérifier et reconstruire une boîte aux lettres
1. Effectuez un diagnostic, si disponible.
En tant que compte du système d'exploitation Zimbra, testez la boîte aux lettres suspecte avec le diagnostic présenté dans le guide de dépannage de Zimbra :
zmprov verifyIndex user@example.com
Une réponse indiquant que l'index n'existe pas ou qu'un fichier de segment est introuvable confirme le diagnostic de corruption d'index. Si votre version installée ne reconnaît pas ce type de problème verifyIndex, n'installez pas de scripts et ne copiez pas de fichiers d'index depuis un autre serveur pour contourner le problème. Consultez la documentation Zimbra spécifique à votre version et comparez le journal de la boîte aux lettres avec le compte concerné.
2. Lancez la réindexation de la boîte aux lettres
Sur le serveur Zimbra approprié, basculez vers le compte du système d'exploitation Zimbra et lancez la reconstruction de la boîte aux lettres concernée :
su - zimbra
zmprov rim user@example.com start
La commande indique généralement que la tâche a démarré. Cela confirme la soumission, et non la fin de la tâche. Ne relancez pas de tâches répétées simplement parce que la recherche reste incomplète immédiatement après ; vérifiez d’abord l’état de la tâche et les journaux de messagerie.
3. Vérifier les progrès
Interrogez la tâche de réindexation en utilisant le même compte et le même contexte de serveur :
zmprov rim user@example.com status
Répétez l'opération à un intervalle raisonnable plutôt que d'interroger en continu. Consultez la réponse en fonction de votre version de Zimbra : l'interface de ligne de commande (CLI) indique l'état de la tâche, tandis que l'interface mailbox.logpeut fournir des informations sur la progression ou les erreurs spécifiques à votre compte. Si la commande signale une erreur, que la tâche ne se termine jamais ou que les journaux indiquent des échecs d'espace disque ou d'écriture d'index, suspendez l'exécution et résolvez le problème sous-jacent avant de réessayer.
La documentation de référence des commandes Zimbra reIndexMailboxcontient des listes d'actions, notamment `--cancel` start, status`--cancel` et ` cancel--cancel`. Si votre version prend en charge l'annulation et que la tâche perturbe le service, vérifiez la syntaxe locale avant de l'utiliser. N'interrompez pas les processus Java et ne supprimez pas les fichiers d'index au lieu d'utiliser une procédure d'annulation standard.
Comment vérifier que la réparation a fonctionné
Une fois la tâche terminée, effectuez un test depuis le client web de l'utilisateur concerné avec quelques messages connus. Recherchez un expéditeur, un objet et une période spécifiques ; vérifiez les messages anciens et récents. Vérifiez les dossiers où les messages devraient apparaître et comparez le résultat avec un message connu que l'utilisateur peut ouvrir directement. Envoyez ou recevez ensuite un message de test et confirmez qu'il devient indexable après le délai d'indexation normal.
Visez une amélioration durable plutôt qu'une requête unique réussie. Les critères de réussite pratiques sont les suivants :
- L'état de réindexation de la boîte aux lettres atteint son état final sans erreurs récurrentes.
- Des messages connus, précédemment absents, apparaissent dans les résultats de recherche attendus.
- De nouveaux courriels continuent d'être ajoutés à l'index de recherche.
- Le volume d'index conserve une capacité libre suffisante et les autres boîtes aux lettres restent réactives.
Si la commande indique avoir terminé mais que certains messages sont toujours manquants, vérifiez que ces messages existent et peuvent être ouverts. Vérifiez si les termes de recherche de l'utilisateur, les filtres de date, la portée du dossier ou le cache côté client expliquent cette différence. Un index reconstruit ne peut pas restaurer les messages supprimés, jamais distribués ou perdus dans le système de stockage sous-jacent.
Quand modifier le chemin de dépannage
Si la reconstruction échoue systématiquement, commencez par résoudre l'erreur mentionnée dans les journaux. Vérifiez l'espace disque et le nombre d'inodes disponibles, recherchez des erreurs plus générales au niveau de la base de données ou du serveur de messagerie, et assurez-vous que la boîte aux lettres est gérée sur le serveur approprié. Si le compte ne peut accéder au contenu des messages ou si d'autres boîtes aux lettres présentent le même problème, interrompez la réindexation et recherchez la cause du problème au niveau de la base de données, du serveur ou du serveur de messagerie.
Évitez de supprimer manuellement /opt/zimbra/indexdes données de façon systématique. Le wiki public de Zimbra propose une procédure de suppression manuelle des fichiers d'index, mais cette page est en cours de rédaction et concerne des versions antérieures. La suppression manuelle est plus sujette aux erreurs que la commande de réindexation au niveau du compte et ne devrait être envisagée que conformément aux instructions spécifiques à la version concernée, en indiquant le chemin d'accès exact de la boîte aux lettres, en vérifiant les sauvegardes et en respectant un plan de maintenance.
Limites de la réindexation des boîtes aux lettres
La réindexation reconstruit les métadonnées de recherche ; elle ne répare pas les tables MySQL ou MariaDB, ne restaure pas les objets blob manquants, ne corrige pas un système de fichiers endommagé, ne libère pas d'espace disque et ne résout pas les pannes de recherche affectant l'ensemble du serveur. Sa durée augmente avec la taille des boîtes aux lettres et la charge du serveur. La recherche peut être temporairement incomplète pendant l'indexation, et les performances globales peuvent être affectées.
Utilisez d'abord la réindexation intégrée au niveau de la boîte aux lettres si les indices pointent vers l'index de recherche d'un compte. Évaluez le résultat à l'aide des messages connus et des courriels de suivi. Si la réindexation échoue ou si les données sont endommagées, privilégiez la procédure de récupération du stockage ou de la base de données plutôt que de supprimer l'index global.
Références officielles