Naprawa uszkodzenia indeksu wyszukiwania Zimbra: Jak ponownie zaindeksować skrzynkę pocztową

Zweryfikowano 6 października 2026 r. Jeśli wyszukiwanie Zimbra zwraca niekompletne wyniki dla jednej skrzynki pocztowej, a dziennik skrzynki wskazuje na błąd indeksatora lub Lucene, standardowym sposobem naprawy jest odbudowanie indeksu wyszukiwania tej skrzynki pocztowej za pomocą zmprov rim account@example.com start. Polecenie odtwarza wyszukiwalne dane indeksu z zawartości skrzynki pocztowej; nie jest to naprawa brakujących plików wiadomości, uszkodzenia bazy danych, pełnego woluminu pamięci masowej ani błędów wyszukiwania na całym serwerze.

Oceniaj sukces na podstawie rzeczywistego rezultatu: zadanie ponownego indeksowania kończy się, wyszukiwania docelowe zwracają wiadomości, których wcześniej brakowało, a nowe wiadomości nadal pojawiają się w wynikach wyszukiwania. Uruchomienie polecenia nie jest dowodem na to, że indeks został odbudowany. Zaplanuj pracę w spokojniejszym okresie, najpierw sprawdź wolumin indeksu i uruchom go dla jednego konta, którego dotyczy problem, przed rozszerzeniem zakresu.

Kiedy ponowne indeksowanie skrzynki pocztowej jest właściwym rozwiązaniem?

Uszkodzony lub niekompletny indeks jest uzasadnionym podejrzeniem, gdy standardowy dostęp do skrzynki pocztowej działa, ale wyszukiwanie pomija znane wiadomości, użytkownik widzi niespójne wyniki wyszukiwania lub /opt/zimbra/log/mailbox.logzgłasza komunikaty takie jak „Nie udało się otworzyć indeksatora” lub wyjątek Lucene dla tego konta. Materiały do ​​rozwiązywania problemów Zimbra dokumentują zmprov verifyIndexdiagnostykę brakującego lub niedostępnego indeksu i służą zmprov rim ... startdo jego ponownego utworzenia.

Najpierw określ zakres. Jeśli problem dotyczy tylko jednego użytkownika, zbadaj tę skrzynkę pocztową. Jeśli wielu użytkowników w tym samym magazynie poczty ma ten sam objaw, sprawdź stan serwera, pojemność pamięci masowej, ostatnie aktualizacje i logi przed uruchomieniem wielu reindeksacji. Duża partia reindeksacji może zużywać znaczną ilość danych wejściowych/wyjściowych na dysku i procesorze, a także może nasilać powolne wyszukiwanie u innych użytkowników.

Ponowna indeksacja nie jest właściwym pierwszym krokiem, gdy użytkownicy nie mogą się zalogować, brakuje folderów, treści wiadomości lub załączników nie otwierają się, baza danych magazynu poczty zgłasza błędy lub usługa wyszukiwania jest niedostępna dla wielu kont. Takie objawy mogą wskazywać na problemy z bazą danych, magazynem obiektów blob, usługą lub infrastrukturą. Zachowaj logi i skorzystaj z odpowiedniej procedury odzyskiwania Zimbra lub kanału wsparcia zamiast traktować każdą skargę dotyczącą „wyszukiwania” jako uszkodzenie indeksu.

Przed uruchomieniem polecenia

• Potwierdź docelową skrzynkę pocztową: Skopiuj adres konta głównego, a nie alias. W przypadku wdrożenia z wieloma magazynami poczty sprawdź, który serwer skrzynki pocztowej jest właścicielem konta i uruchom polecenie zgodnie z topologią i zainstalowaną wersją Zimbry.
• Sprawdź dostępne miejsce: Sprawdź wolne miejsce i inody na rzeczywistym woluminie indeksowym. Instalacje mogą umieszczać dane indeksowe w oddzielnym miejscu; nie zakładaj, że ścieżka domyślna jest lokalizacją aktywną. Pełny wolumin indeksowy może sam w sobie powodować błędy indeksowania.
• Sprawdź obciążenie systemu: zwróć uwagę na aktualne opóźnienie w magazynie poczty, aktywność procesora i dysku. Ponowne indeksowanie jest zasobochłonne, szczególnie w przypadku dużych skrzynek pocztowych, dlatego zaplanuj je poza szczytem ruchu.
• Chroń odzyskiwalność: Przed konserwacją upewnij się, że standardowy proces tworzenia kopii zapasowej jest sprawny i aktualny. Ponowne indeksowanie ma na celu odtworzenie uzyskanych danych wyszukiwania, ale kopia zapasowa pozostaje ważna przed wszelkimi naprawami poczty produkcyjnej.
• Sprawdź obsługę poleceń: składnia wiersza poleceń Zimbra i dostępne opcje mogą się różnić w zależności od wersji. Zapoznaj się z pomocą i dokumentacją poleceń, aby dowiedzieć się, jaka dokładnie wersja została zainstalowana, zwłaszcza jeśli używasz starszej wersji lub niestandardowego wdrożenia.

Jak zweryfikować i odbudować jedną skrzynkę pocztową

1. Uruchom kontrolę diagnostyczną, jeśli jest dostępna

Będąc kontem systemu operacyjnego Zimbra, przetestuj podejrzaną skrzynkę pocztową, korzystając z diagnostyki przedstawionej w poradniku rozwiązywania problemów Zimbra:

zmprov verifyIndex user@example.com

Odpowiedź wskazująca, że ​​indeks nie istnieje lub że nie można znaleźć pliku segmentu, potwierdza diagnozę uszkodzenia indeksu. Jeśli zainstalowana wersja nie rozpoznaje verifyIndex, nie instaluj skryptów ani nie kopiuj plików indeksu z innego serwera, aby obejść ten problem. Skorzystaj z dokumentacji Zimbra dla danej wersji i porównaj dziennik skrzynki pocztowej z kontem, którego dotyczy problem.

2. Rozpocznij ponowne indeksowanie skrzynki pocztowej

Na odpowiednim serwerze Zimbra przełącz się na konto systemu operacyjnego Zimbra i rozpocznij odbudowę pojedynczej skrzynki pocztowej, której dotyczy problem:

su - zimbra
zmprov rim user@example.com start

Polecenie zazwyczaj informuje o rozpoczęciu zadania. To potwierdza wysłanie, a nie jego ukończenie. Nie uruchamiaj powtarzanych zadań tylko dlatego, że wyszukiwanie pozostaje nieukończone zaraz po nim; najpierw sprawdź stan zadania i logi magazynu poczty.

3. Sprawdź postęp

Wykonaj zapytanie o zadanie ponownego indeksowania, używając tego samego konta i kontekstu serwera:

zmprov rim user@example.com status

Powtarzaj w rozsądnych odstępach czasu, zamiast sondować w sposób ciągły. Przeczytaj odpowiedź zgodnie z wersją Zimbry: interfejs wiersza poleceń raportuje stan zadania, a także mailbox.logmoże wyświetlać postęp lub błędy specyficzne dla konta. Jeśli polecenie zgłosi błąd, zadanie nigdy się nie zakończy lub logi wskażą awarie miejsca na dysku lub awarie zapisu indeksu, wstrzymaj się i rozwiąż ten problem przed ponowną próbą.

Lista poleceń Zimbry reIndexMailboxzawiera znaki start, status, i cancelakcje. Jeśli Twoja wersja obsługuje anulowanie, a zadanie szkodzi usłudze, przed jego użyciem sprawdź składnię lokalną. Nie zamykaj procesów Java ani nie usuwaj plików indeksów zamiast obsługiwanej procedury anulowania.

Jak sprawdzić, czy naprawa zadziałała

Po zakończeniu zadania przetestuj działanie w kliencie internetowym użytkownika, którego dotyczy problem, za pomocą kilku znanych wiadomości. Wyszukaj charakterystycznego nadawcę, frazę tematu i zakres dat; zweryfikuj zarówno stare wiadomości, jak i najnowsze wiadomości. Sprawdź foldery, w których powinny się pojawić wiadomości, i porównaj wynik ze znaną wiadomością, którą użytkownik może otworzyć bezpośrednio. Następnie wyślij lub odbierz wiadomość testową i upewnij się, że po normalnym opóźnieniu indeksowania stanie się ona możliwa do wyszukania.

Szukaj trwałej poprawy, a nie pojedynczego udanego zapytania. Praktyczne kryteria sukcesu to:

• Status ponownego indeksowania skrzynki pocztowej osiągnął stan ukończenia bez powtarzających się błędów.
• Wcześniej brakujące, znane wiadomości pojawiają się w oczekiwanych wynikach wyszukiwania.
• Nowa wiadomość nadal trafia do indeksu wyszukiwania.
• Objętość indeksu zachowuje wystarczającą wolną pojemność, a inne skrzynki pocztowe pozostają responsywne.

Jeśli polecenie zgłasza ukończenie, ale określone wiadomości nadal nie są dostępne, sprawdź, czy nadal istnieją i można je otworzyć. Sprawdź, czy wyszukiwane przez użytkownika hasła, filtry dat, zakres folderów lub pamięć podręczna po stronie klienta wyjaśniają różnicę. Odbudowany indeks nie może przywrócić wiadomości, które zostały usunięte, nigdy niedostarczone lub utracone z bazowego magazynu.

Kiedy zmienić ścieżkę rozwiązywania problemów

Jeśli odbudowa wielokrotnie się nie powiedzie, najpierw rozwiąż problem wskazany w logach. Sprawdź dostępne miejsce na dysku i i-węzły, sprawdź, czy nie występują ogólne błędy w magazynie poczty lub bazie danych i upewnij się, że skrzynka pocztowa jest obsługiwana na właściwym serwerze. Jeśli konto nie może uzyskać dostępu do treści wiadomości lub inne skrzynki pocztowe wykazują ten sam problem, przerwij ponowną indeksację i zbadaj przyczynę na poziomie magazynu, bazy danych lub serwera.

Unikaj ręcznego usuwania /opt/zimbra/indexdanych jako rutynowej czynności. Publiczna wiki Zimbry zawiera procedurę ręcznego usuwania pliku indeksu, ale ta strona jest oznaczona jako praca w toku i jest powiązana ze starszymi wersjami. Ręczne usuwanie jest bardziej podatne na błędy niż obsługiwane polecenie reindeksowania na poziomie konta i powinno być rozważane wyłącznie zgodnie z aktualnymi wytycznymi dostawcy dla danej wersji, z dokładną ścieżką do skrzynki pocztowej, zweryfikowanymi kopiami zapasowymi i planem konserwacji.

Ograniczenia ponownego indeksowania skrzynek pocztowych

Ponowne indeksowanie odbudowuje metadane wyszukiwania; nie naprawia tabel MySQL ani MariaDB, nie przywraca brakujących obiektów blob, nie naprawia uszkodzonego systemu plików, nie zwalnia całego dysku ani nie naprawia awarii wyszukiwania na całym serwerze. Proces ten trwa dłużej, ponieważ zwiększa się rozmiar skrzynki pocztowej i obciążenie serwera. Wyszukiwanie może być tymczasowo niekompletne podczas indeksowania, a ogólna wydajność może spaść w trakcie zadania.

Użyj wbudowanej funkcji reindeksowania na poziomie skrzynki pocztowej, gdy dowody wskazują na indeks wyszukiwania jednego konta. Zmierz wynik, korzystając ze znanych komunikatów i wiadomości e-mail. Jeśli reindeksowanie nie może się zakończyć lub same dane są uszkodzone, przejdź do odpowiedniej procedury odzyskiwania danych z magazynu lub bazy danych, zamiast eskalować do całkowitego usunięcia indeksu.

Oficjalne referencje

• Dokumentacja polecenia Zimbra zmprov — zawiera listę reIndexMailboxpoleceń i składnię ich działania. Strona odsyła również czytelników do Podręcznika administratora w celu uzyskania szczegółowych informacji dotyczących poszczególnych wydań.
• Przykład rozwiązywania problemów z Zimbrą w przypadku uszkodzonego indeksu skrzynki pocztowej — pokazuje verifyIndexpolecenie reindeksowania na poziomie konta. Strona jest oznaczona jako „w trakcie realizacji”, więc sprawdź, czy ma zastosowanie do zainstalowanej wersji.
• Procedura wiki Zimbra omawiająca usuwanie danych indeksowych i sprawdzanie statusu — starsza, robocza wersja; używaj jej jako kontekstu, a nie jako powodu do usuwania plików w bieżącym systemie produkcyjnym.