Risolvere i problemi di corruzione dell'indice di ricerca di Zimbra: come reindicizzare una casella di posta

Revisionato il 6 ottobre 2026. Se la ricerca Zimbra restituisce risultati incompleti per una casella di posta e il log della casella di posta indica un errore dell'indicizzatore o di Lucene, la soluzione usuale è ricostruire l'indice di ricerca di quella casella di posta con zmprov rim account@example.com startil comando . Il comando ricrea i dati di indice ricercabili dal contenuto della casella di posta; non è una soluzione per file di messaggi mancanti, danneggiamento del database, volume di archiviazione pieno o errori di ricerca a livello di server.

Il successo va valutato in base al risultato effettivo: il processo di reindicizzazione deve terminare, le ricerche mirate devono restituire i messaggi precedentemente mancanti e la nuova posta deve continuare ad apparire nei risultati di ricerca. L'avvio del comando non garantisce la ricostruzione dell'indice. Pianificate l'intervento in un periodo di minore attività, verificate prima il volume dell'indice ed eseguite il comando su un singolo account interessato prima di estendere l'operazione.

Quando la reindicizzazione della casella di posta è la soluzione giusta?

Un indice danneggiato o incompleto è un sospetto plausibile quando l'accesso alla casella di posta funziona normalmente ma le ricerche non trovano messaggi noti, un utente interessato visualizza risultati di ricerca incoerenti o /opt/zimbra/log/mailbox.logsegnala messaggi come "Impossibile aprire l'indicizzatore" o un'eccezione Lucene per quell'account. La documentazione di Zimbra per la risoluzione dei problemi zmprov verifyIndexdescrive come diagnosticare un indice mancante o non apribile e come zmprov rim ... startricrearlo.

Innanzitutto, stabilite l'entità del problema. Se è interessato un solo utente, esaminate quella casella di posta. Se molti utenti dello stesso archivio di posta presentano lo stesso sintomo, verificate lo stato del server, la capacità di archiviazione, gli aggiornamenti recenti e i log prima di avviare numerose reindicizzazioni. Un gran numero di reindicizzazioni può consumare una notevole quantità di I/O del disco e CPU e potrebbe peggiorare la lentezza della ricerca per altri utenti.

La reindicizzazione non è la prima mossa giusta quando gli utenti non riescono ad accedere, mancano delle cartelle, il corpo dei messaggi o gli allegati non si aprono, il database del mailstore segnala errori o il servizio di ricerca non è disponibile per più account. Questi segnali possono indicare problemi al database, al blob store, al servizio o all'infrastruttura. Conserva i log e utilizza la procedura di ripristino Zimbra o il canale di supporto appropriato, invece di considerare ogni segnalazione di "ricerca" come un danneggiamento dell'indice.

Prima di eseguire il comando

  • Conferma la casella di posta di destinazione: copia l'indirizzo dell'account principale, non un alias. In una distribuzione con più server di posta, verifica quale server di posta è proprietario dell'account ed esegui il comando in base alla topologia e alla versione di Zimbra installata.
  • Verifica lo spazio disponibile: controlla lo spazio libero e gli inode sul volume di indice effettivo. Le installazioni potrebbero posizionare i dati di indice su un mount separato; non dare per scontato che il percorso predefinito sia la posizione attiva. Un volume di indice pieno può di per sé causare errori di indicizzazione.
  • Verifica il carico di sistema: prendi nota della latenza corrente dell'archivio di posta, dell'utilizzo della CPU e dell'attività del disco. La reindicizzazione è un'operazione che richiede molte risorse, soprattutto per le caselle di posta di grandi dimensioni, quindi pianificala al di fuori dei picchi di traffico.
  • Proteggere la recuperabilità: prima di eseguire interventi di manutenzione, verificare che il normale processo di backup sia integro e recente. La reindicizzazione ha lo scopo di ricostruire i dati di ricerca derivati, ma è comunque fondamentale eseguire un backup prima di qualsiasi intervento di riparazione sulla posta in produzione.
  • Verifica la compatibilità dei comandi: la sintassi della CLI di Zimbra e le opzioni disponibili possono variare a seconda della versione. Consulta la guida e la documentazione dei comandi per la versione installata, soprattutto se utilizzi una versione precedente o un'implementazione personalizzata.

Come verificare e ricostruire una casella di posta

1. Eseguire un controllo diagnostico, se disponibile

Utilizzando l'account del sistema operativo Zimbra, testa la casella di posta sospetta con lo strumento di diagnostica descritto nella guida alla risoluzione dei problemi di Zimbra:

zmprov verifyIndex user@example.com

Una risposta che indica che l'indice non esiste o che non è possibile trovare un file di segmento supporta la diagnosi di danneggiamento dell'indice. Se la versione installata non riconosce verifyIndex, non installare script né copiare file di indice da un altro server per aggirare il problema. Consultare la documentazione di Zimbra specifica per la versione e correlare il log della casella di posta con l'account interessato.

2. Avviare la reindicizzazione della casella di posta

Sul server Zimbra appropriato, passare all'account del sistema operativo Zimbra e avviare la ricostruzione per la singola casella di posta interessata:

su - zimbra
zmprov rim user@example.com start

Il comando di solito segnala l'avvio dell'attività. Ciò conferma l'invio, non il completamento. Non avviare processi ripetuti solo perché la ricerca risulta incompleta subito dopo; prima controlla lo stato del processo e i log del server di posta.

3. Verificare i progressi

Eseguire la query per l'attività di reindicizzazione utilizzando lo stesso account e lo stesso contesto del server:

zmprov rim user@example.com status

Ripeti l'operazione a intervalli ragionevoli anziché eseguire il polling in modo continuo. Leggi la risposta in base alla tua versione di Zimbra: la CLI segnala lo stato del job, mentre mailbox.logpuò fornire informazioni sull'avanzamento o sugli errori specifici dell'account. Se il comando segnala un errore, l'attività non viene mai completata o i log mostrano errori di spazio su disco o di scrittura dell'indice, metti in pausa e risolvi il problema sottostante prima di riprovare.

Il manuale di riferimento dei comandi di Zimbra elenca reIndexMailboxle azioni start, status, e cancel. Se la tua versione supporta l'annullamento e il job sta danneggiando il servizio, verifica la sintassi locale prima di utilizzarla. Non terminare i processi Java né rimuovere i file di indice come sostituto di una procedura di annullamento supportata.

Come verificare che la riparazione abbia funzionato

Una volta completata l'attività, eseguire un test dal client web dell'utente interessato con alcuni messaggi noti. Cercare un mittente, un oggetto e un intervallo di date distintivi; verificare sia i messaggi vecchi che quelli recenti. Controllare le cartelle in cui i messaggi dovrebbero apparire e confrontare il risultato con un messaggio noto che l'utente può aprire direttamente. Quindi inviare o ricevere un messaggio di prova e verificare che diventi ricercabile dopo il normale ritardo di indicizzazione.

Cercate un miglioramento costante piuttosto che una singola query andata a buon fine. I criteri pratici per il successo sono:

  • Lo stato della reindicizzazione della casella di posta è stato completato senza errori ricorrenti.
  • I messaggi noti, precedentemente mancanti, compaiono ora nei risultati di ricerca previsti.
  • Continuano ad arrivare nuovi messaggi nell'indice di ricerca.
  • Il volume dell'indice mantiene una capacità libera sufficiente e le altre caselle di posta rimangono reattive.

Se il comando segnala il completamento ma mancano alcuni messaggi specifici, verificare che questi esistano ancora e che possano essere aperti. Controllare se la differenza sia dovuta ai termini di ricerca dell'utente, ai filtri per data, all'ambito delle cartelle o alla cache lato client. Un indice ricostruito non può ripristinare i messaggi eliminati, mai recapitati o persi dall'archivio sottostante.

Quando cambiare il percorso di risoluzione dei problemi

Se la ricostruzione fallisce ripetutamente, per prima cosa affronta l'errore indicato nei log. Verifica lo spazio su disco e gli inode disponibili, controlla la presenza di errori più ampi nell'archivio di posta o nel database e assicurati che la casella di posta sia gestita sul server corretto. Se l'account non riesce ad accedere al contenuto dei messaggi o se altre caselle di posta presentano lo stesso problema, interrompi la reindicizzazione e indaga sulla causa a livello di archivio, database o server.

Evitate di eliminare manualmente /opt/zimbra/indexi dati come operazione di routine. La wiki pubblica di Zimbra include una procedura per la rimozione manuale del file di indice, ma la pagina è contrassegnata come "in fase di sviluppo" ed è collegata a versioni precedenti. L'eliminazione manuale è più soggetta a errori rispetto al comando di reindicizzazione a livello di account supportato e dovrebbe essere presa in considerazione solo seguendo le linee guida del fornitore specifiche per la versione corrente, con un percorso di casella di posta preciso, backup verificati e un piano di manutenzione.

Limiti della reindicizzazione delle caselle di posta

La reindicizzazione ricostruisce i metadati di ricerca; non ripara le tabelle MySQL o MariaDB, non ripristina i blob mancanti, non corregge un filesystem danneggiato, non libera spazio su disco e non risolve un'interruzione della ricerca a livello di server. Inoltre, richiede più tempo all'aumentare delle dimensioni delle caselle di posta e del carico del server. La ricerca potrebbe risultare temporaneamente incompleta durante l'indicizzazione e le prestazioni complessive potrebbero risentirne durante l'operazione.

Quando gli indizi puntano all'indice di ricerca di un singolo account, utilizzare innanzitutto la funzione di reindicizzazione integrata a livello di casella di posta. Verificare il risultato utilizzando messaggi noti e comunicazioni successive. Se la reindicizzazione non riesce a essere completata o i dati stessi sono danneggiati, passare alla procedura di ripristino dell'archivio o del database anziché procedere con la cancellazione generalizzata dell'indice.

Riferimenti ufficiali

Lascia un commento

6 migliori server Syslog gratuiti da provare per la registrazione centralizzata dei log

6 migliori server Syslog gratuiti da provare per la registrazione centralizzata dei log

Confronta sei server e collettori syslog gratuiti per Windows e Linux, inclusi strumenti con interfaccia grafica, opzioni open source, funzionalità di ricerca, avvisi e trasporto sicuro.

Cos'è IIS? Il server Web Windows di Microsoft e le sue alternative.

Cos'è IIS? Il server Web Windows di Microsoft e le sue alternative.

Scopri cosa fa Microsoft IIS, come funzionano la sua pipeline di richieste e i pool di applicazioni e quando Apache, NGINX o Caddy potrebbero essere più adatti alle tue esigenze di server web.

Risolvere l'elevato utilizzo della CPU in Jitsi Meet sui browser client.

Risolvere l'elevato utilizzo della CPU in Jitsi Meet sui browser client.

Diagnostica i picchi di utilizzo della CPU del browser Jitsi Meet e riduci il carico del client controllando i riquadri video, gli effetti della fotocamera, la grafica del browser e le impostazioni dell'host.

Come monitorare le metriche di Jitsi Videobridge con Prometheus e Grafana

Come monitorare le metriche di Jitsi Videobridge con Prometheus e Grafana

Monitora lo stato di salute, il carico della conferenza e il traffico di Jitsi Videobridge con il suo endpoint Prometheus integrato, quindi esplora e visualizza i dati in Grafana.

Come configurare un nome di dominio personalizzato per Jitsi Meet Docker

Come configurare un nome di dominio personalizzato per Jitsi Meet Docker

Configura un dominio personalizzato per Jitsi Meet Docker con DNS, URL pubblico, HTTPS, Let's Encrypt, porte del firewall, impostazioni NAT e verifica end-to-end.

Fix Zimbra Admin Console 404 Not Found After SSL Renewal

Fix Zimbra Admin Console 404 Not Found After SSL Renewal

Fix Zimbra Admin Console 404 errors after SSL renewal by checking the correct URL and port, proxy routing, service status, deployed certificates, and logs.

Risolvere l'avviso di Nextcloud "PHP OPcache non è configurato correttamente".

Risolvere l'avviso di Nextcloud "PHP OPcache non è configurato correttamente".

Scopri come diagnosticare e risolvere l'avviso di configurazione di PHP OPcache di Nextcloud controllando l'SAPI PHP attivo, i limiti di dimensionamento, i commenti e le impostazioni di riconvalida.

Risolvere gli errori di migrazione del database Kopano dopo un aggiornamento della versione di MySQL

Risolvere gli errori di migrazione del database Kopano dopo un aggiornamento della versione di MySQL

Risolvere i problemi di migrazione del database Kopano dopo un aggiornamento di MySQL o MariaDB verificando i backup, le versioni del server, le modalità SQL, il set di caratteri, lo stato dello schema e i log.

Come configurare l'autenticazione LDAP e Active Directory in Nextcloud

Come configurare l'autenticazione LDAP e Active Directory in Nextcloud

Collega Nextcloud a LDAP o Active Directory con trasporto sicuro, filtri per utenti e gruppi, attributi di accesso e un'implementazione collaudata.

Risolvere i problemi relativi alle notifiche di Element su Android senza i servizi Google: Guida a UnifiedPush

Risolvere i problemi relativi alle notifiche di Element su Android senza i servizi Google: Guida a UnifiedPush

Risolvi i problemi di notifiche di Element Android sui telefoni senza Google configurando UnifiedPush, le autorizzazioni Android, le impostazioni della batteria ed eseguendo test di verifica affidabili.