Behebung von Zimbra-Suchindexbeschädigungen: So indizieren Sie ein Postfach neu

Geprüft am 6. Oktober 2026. Falls die Zimbra-Suche für ein Postfach unvollständige Ergebnisse liefert und das Postfachprotokoll auf einen Indexierungs- oder Lucene-Fehler hinweist, besteht die übliche Lösung darin, den Suchindex dieses Postfachs mit dem Befehl `zimbra search index` neu zu erstellen zmprov rim account@example.com start. Dieser Befehl generiert die durchsuchbaren Indexdaten aus dem Postfachinhalt neu; er behebt jedoch keine fehlenden Nachrichtendateien, Datenbankbeschädigungen, einen vollen Speicherplatz oder serverweite Suchfehler.

Beurteilen Sie den Erfolg anhand des tatsächlichen Ergebnisses: Der Neuindexierungsvorgang wird abgeschlossen, gezielte Suchanfragen liefern zuvor fehlende Nachrichten, und neue E-Mails werden weiterhin in der Suche angezeigt. Der Start des Befehls ist kein Beweis dafür, dass der Index neu erstellt wurde. Planen Sie die Arbeiten in einer ruhigeren Zeit, überprüfen Sie vorher das Indexvolumen und führen Sie den Vorgang zunächst für ein betroffenes Konto aus, bevor Sie den Umfang erweitern.

Wann ist eine Neuindizierung des Postfachs die richtige Lösung?

Ein beschädigter oder unvollständiger Index ist wahrscheinlich die Ursache, wenn der normale Zugriff auf das Postfach funktioniert, aber bekannte Nachrichten bei der Suche nicht gefunden werden, betroffene Benutzer inkonsistente Suchergebnisse erhalten oder /opt/zimbra/log/mailbox.logMeldungen wie „Indexer konnte nicht geöffnet werden“ oder eine Lucene-Ausnahme für das betreffende Konto gemeldet werden. Die Fehlerbehebungsunterlagen von Zimbra zmprov verifyIndexdienen der Diagnose eines fehlenden oder nicht zu öffnenden Index und werden zmprov rim ... startzur Wiederherstellung verwendet.

Zunächst muss der Umfang ermittelt werden. Ist nur ein Benutzer betroffen, sollte dessen Postfach untersucht werden. Weisen mehrere Benutzer desselben Mailstores dasselbe Problem auf, sollten Serverzustand, Speicherkapazität, kürzlich durchgeführte Aktualisierungen und Protokolle überprüft werden, bevor zahlreiche Neuindizierungen durchgeführt werden. Eine große Anzahl von Neuindizierungen kann erhebliche Festplatten-E/A und CPU-Leistung beanspruchen und die Suchgeschwindigkeit für andere Benutzer verschlechtern.

Eine Neuindizierung ist nicht der richtige erste Schritt, wenn sich Benutzer nicht anmelden können, Ordner fehlen, Nachrichtentexte oder Anhänge nicht geöffnet werden können, die Mailstore-Datenbank Fehler meldet oder der Suchdienst für mehrere Konten nicht verfügbar ist. Diese Anzeichen können auf Probleme mit der Datenbank, dem Blob-Speicher, dem Dienst oder der Infrastruktur hinweisen. Bewahren Sie Protokolle auf und verwenden Sie die entsprechende Zimbra-Wiederherstellungsprozedur oder den Supportkanal, anstatt jede „Such“-Meldung als Indexbeschädigung zu behandeln.

Bevor Sie den Befehl ausführen

• Bestätigen Sie das Zielpostfach: Kopieren Sie die primäre Kontoadresse, nicht einen Alias. Bei einer Bereitstellung mit mehreren Postfachspeichern überprüfen Sie, welcher Postfachserver das Konto besitzt, und führen Sie den Befehl entsprechend Ihrer Topologie und der installierten Zimbra-Version aus.
• Verfügbaren Speicherplatz prüfen: Untersuchen Sie den freien Speicherplatz und die Inodes auf dem Index-Volume. Installationen können Indexdaten auf einem separaten Mountpunkt ablegen; gehen Sie nicht davon aus, dass der Standardpfad der aktive Speicherort ist. Ein volles Index-Volume kann selbst zu Indexierungsfehlern führen.
• Systemauslastung prüfen: Aktuelle Mailstore-Latenz, CPU- und Festplattenaktivität beachten. Die Neuindizierung ist ressourcenintensiv, insbesondere bei großen Postfächern. Planen Sie sie daher außerhalb der Spitzenzeiten.
• Wiederherstellbarkeit sicherstellen: Vor Wartungsarbeiten muss sichergestellt werden, dass der reguläre Backup-Prozess einwandfrei funktioniert und aktuell ist. Die Neuindizierung dient zwar der Wiederherstellung abgeleiteter Suchdaten, dennoch ist ein Backup vor jeglichen Reparaturarbeiten an produktiven E-Mails unerlässlich.
• Prüfen Sie die Befehlsunterstützung: Die Syntax der Zimbra-Befehlszeilenschnittstelle (CLI) und die verfügbaren Optionen können je nach Version variieren. Lesen Sie die Befehlshilfe und die Dokumentation für die exakt installierte Version, insbesondere wenn Sie eine ältere Version oder eine angepasste Bereitstellung verwenden.

So überprüfen und erstellen Sie eine Mailbox

1. Führen Sie, falls verfügbar, eine Diagnoseprüfung durch.

Testen Sie als Benutzer des Zimbra-Betriebssystems das verdächtige Postfach mit dem in der Fehlerbehebungsanleitung von Zimbra beschriebenen Diagnosetool:

zmprov verifyIndex user@example.com

Eine Antwort, die darauf hinweist, dass der Index nicht existiert oder eine Segmentdatei nicht gefunden werden kann, stützt die Diagnose einer Indexbeschädigung. Falls Ihre installierte Version den Index nicht erkennt verifyIndex, installieren Sie keine Skripte und kopieren Sie keine Indexdateien von einem anderen Server, um das Problem zu umgehen. Verwenden Sie stattdessen die versionsspezifische Zimbra-Dokumentation und korrelieren Sie das Postfachprotokoll mit dem betroffenen Konto.

2. Starten Sie die Neuindizierung des Postfachs.

Wechseln Sie auf dem entsprechenden Zimbra-Server zum Zimbra-Betriebssystemkonto und starten Sie den Wiederaufbau für das einzelne betroffene Postfach:

su - zimbra
zmprov rim user@example.com start

Der Befehl meldet normalerweise, dass der Task gestartet wurde. Dies bestätigt die Übermittlung, nicht den Abschluss. Starten Sie keine wiederholten Aufträge, nur weil die Suche unmittelbar danach noch nicht abgeschlossen ist; überprüfen Sie zuerst den Auftragsstatus und die Mailstore-Protokolle.

3. Fortschritt prüfen

Führen Sie die Reindexierungsaufgabe mit demselben Konto und Serverkontext aus:

zmprov rim user@example.com status

Wiederholen Sie den Vorgang in angemessenen Abständen, anstatt ihn kontinuierlich abzufragen. Lesen Sie die Antwort entsprechend Ihrer Zimbra-Version: Die CLI meldet den Jobstatus und mailbox.logkann kontospezifische Fortschritts- oder Fehlerinformationen liefern. Wenn der Befehl einen Fehler meldet, der Task nicht abgeschlossen wird oder die Protokolle Speicherplatz- oder Indexierungsfehler anzeigen, halten Sie an und beheben Sie das zugrunde liegende Problem, bevor Sie es erneut versuchen.

Die Befehlsreferenz von Zimbra enthält Listen reIndexMailboxmit Aktionen wie `<code>` start, status`<code>` und `<code>` cancel. Wenn Ihre Version das Abbrechen von Jobs unterstützt und der Job den Dienst beeinträchtigt, überprüfen Sie die lokale Syntax, bevor Sie ihn verwenden. Beenden Sie keine Java-Prozesse und löschen Sie keine Indexdateien, sondern verwenden Sie stattdessen ein unterstütztes Abbruchverfahren.

So überprüfen Sie, ob die Reparatur funktioniert hat

Nach Abschluss des Vorgangs testen Sie die Suche mit einigen bekannten Nachrichten im Webclient des betroffenen Benutzers. Suchen Sie nach einem eindeutigen Absender, einer passenden Betreffzeile und einem bestimmten Datumsbereich. Überprüfen Sie sowohl ältere als auch neuere Nachrichten. Kontrollieren Sie die Ordner, in denen die Nachrichten erscheinen sollten, und vergleichen Sie das Ergebnis mit einer bekannten Nachricht, die der Benutzer direkt öffnen kann. Senden oder empfangen Sie anschließend eine Testnachricht und vergewissern Sie sich, dass diese nach der üblichen Indexierungsverzögerung auffindbar ist.

Achten Sie auf eine nachhaltige Verbesserung statt auf eine einzelne erfolgreiche Abfrage. Die praktischen Erfolgskriterien sind:

• Der Postfach-Neuindexierungsstatus hat ohne wiederkehrende Fehler den Status „Abgeschlossen“ erreicht.
• Zuvor fehlende, bekannte Nachrichten erscheinen in den erwarteten Suchergebnissen.
• Es werden weiterhin neue E-Mails in den Suchindex aufgenommen.
• Das Indexvolumen verfügt weiterhin über ausreichend freie Kapazität und andere Postfächer sind weiterhin erreichbar.

Wenn der Befehl zwar die Fertigstellung meldet, bestimmte Nachrichten aber weiterhin fehlen, überprüfen Sie, ob die Nachrichten noch vorhanden sind und geöffnet werden können. Prüfen Sie, ob die Suchbegriffe, Datumsfilter, der Ordnerbereich oder der clientseitige Cache des Benutzers die Ursache sind. Ein neu erstellter Index kann keine Nachrichten wiederherstellen, die gelöscht, nie zugestellt oder im zugrunde liegenden Speicher verloren gegangen sind.

Wann sollte der Fehlerbehebungspfad geändert werden?

Schlägt der Neuaufbau wiederholt fehl, beheben Sie zunächst den in den Protokollen aufgeführten Fehler. Prüfen Sie den verfügbaren Speicherplatz und die Anzahl der Inodes, suchen Sie nach umfassenderen Fehlern im Mailstore oder der Datenbank und stellen Sie sicher, dass das Postfach auf dem richtigen Server verwaltet wird. Kann das Konto nicht auf die Nachrichteninhalte zugreifen oder weisen andere Postfächer dasselbe Problem auf, beenden Sie die Neuindizierung und untersuchen Sie die Ursache im Mailstore, der Datenbank oder auf Serverebene.

Das manuelle Löschen /opt/zimbra/indexvon Daten sollte nicht routinemäßig erfolgen. Das öffentliche Wiki von Zimbra enthält zwar eine Anleitung zum manuellen Entfernen von Indexdateien, diese Seite befindet sich jedoch noch in Bearbeitung und bezieht sich auf ältere Versionen. Das manuelle Löschen ist fehleranfälliger als der unterstützte Befehl zur Neuindizierung auf Kontoebene und sollte nur gemäß den aktuellen, versionsspezifischen Herstellerrichtlinien, mit Angabe des genauen Postfachpfads, verifizierten Backups und einem Wartungsplan in Betracht gezogen werden.

Grenzen der Postfach-Neuindizierung

Die Neuindizierung erstellt Suchmetadaten neu; sie repariert jedoch keine MySQL- oder MariaDB-Tabellen, stellt keine fehlenden Blobs wieder her, behebt kein beschädigtes Dateisystem, gibt keine volle Festplatte frei und behebt keine serverweiten Suchausfälle. Zudem dauert der Vorgang länger, je größer die Mailbox und je höher die Serverlast sind. Die Suche kann während der Indizierung vorübergehend unvollständig sein, und die Gesamtleistung kann in dieser Zeit beeinträchtigt sein.

Nutzen Sie zunächst die integrierte Neuindizierung auf Postfachebene, wenn die Indizien auf den Suchindex eines Kontos hindeuten. Überprüfen Sie das Ergebnis anhand bekannter Nachrichten und Folge-E-Mails. Falls die Neuindizierung nicht abgeschlossen werden kann oder die Daten selbst beschädigt sind, greifen Sie auf das entsprechende Speicher- oder Datenbankwiederherstellungsverfahren zurück, anstatt den gesamten Index zu löschen.

Offizielle Referenzen

• Zimbra zmprov Befehlsreferenz – listet den reIndexMailboxBefehl und seine Aktionssyntax auf; die Seite verweist außerdem auf das Administratorhandbuch für versionsspezifische Details.
• Zimbra-Fehlerbehebungsbeispiel für einen beschädigten Postfachindex – zeigt verifyIndexden Befehl zur Neuindizierung auf Kontoebene. Die Seite befindet sich noch in Bearbeitung; prüfen Sie daher bitte, ob sie für Ihre installierte Version anwendbar ist.
• Zimbra-Wiki-Verfahren zur Entfernung von Indexdaten und Statusprüfungen – eine ältere, noch in Bearbeitung befindliche Referenz; verwenden Sie sie als Kontext, nicht als Grund, Dateien auf einem aktuellen Produktivsystem zu löschen.