Risoluzione dei problemi della coda di lavoro con il comando Repairqueue su ESA

Introduzione

In questo documento viene descritto l'uso del comando repairqueue della CLI nascosto su Cisco Email Security Appliance (ESA) e come convalidare il recupero della coda.

Problema

Motivi per eseguire il comando repairqueue:

• Errore durante l'avvio del montaggio della coda di lavoro. In genere ciò è dovuto al danneggiamento della coda dopo un ciclo di alimentazione o un riavvio improprio dell'accessorio.
• Per risolvere un problema noto, è possibile che sia necessario usare questo comando come soluzione alternativa (ad esempio, ID bug Cisco CSCuw2284 - La coda e-mail si danneggia in seguito a un arresto anomalo o anomalo del servizio di elaborazione della posta).
• Errori dell'applicazione, ad esempio quelli che fanno riferimento a gcq.py o al sottosistema di gestione delle code.
• Dettaglio stato o coda di lavoro > numeri negativi del rapporto tasso.

• Nel rapporto Dettagli stato o Dettaglio stato viene riportato un valore Meno recente del messaggio che supera la soglia del profilo di mancato recapito configurata.

  • Soglia predefinita: 259200 secondi (3 giorni).
  • Per controllare la soglia, immettere bounceconfig > edit, quindi selezionare il profilo predefinito. Individuare la linea. Immettere il numero massimo di secondi durante i quali un messaggio può rimanere nella coda prima di essere bloccato.

Motivi per non eseguire il comando repairqueue:

• La lentezza dell'elaborazione della coda di lavoro non è un motivo valido per eseguire un ripristino della coda. Gli amministratori spesso confondono l'elaborazione lenta delle code di lavoro con il danneggiamento delle code. Una coda di lavoro lenta è in genere dovuta all'elaborazione ripetuta dello stesso messaggio o di più messaggi, in quanto un servizio utilizza eccessivamente le risorse di sistema. Questi scenari di elaborazione ripetuta spesso non vengono ripristinati eseguendo semplicemente repairqueue. È necessaria un'ulteriore risoluzione dei problemi del servizio o dei servizi interessati.

Ambiente

Le informazioni fornite in questo documento si basano sulle seguenti versioni software e hardware:

• ESA, tutti i dispositivi hardware e virtuali con AsyncOS 11.0.0-264 o versioni successive

Le informazioni discusse in questo documento fanno riferimento a dispositivi usati in uno specifico ambiente di emulazione. Su tutti i dispositivi menzionati nel documento la configurazione è stata ripristinata ai valori predefiniti. Nelle reti attive, verificare l'impatto potenziale di ciascun comando prima di procedere.

Cisco raccomanda la conoscenza dei seguenti argomenti:

• Capacità del sistema, monitoraggio del sistema, stato del sistema ed elaborazione complessiva dei messaggi attraverso la coda di lavoro ESA.
• Amministrazione generale dell'ESA.

Nota: Per ulteriori informazioni, consultare la Guida per l'utente ESA o la Guida in linea dell'interfaccia grafica ESA.

Risoluzione

Il comando CLI repairqueue non ripristina tutti i problemi o il danneggiamento della coda di lavoro. L'utilità tenta di riparare la coda di lavoro nel modo più efficiente possibile.

1. Eseguire i dettagli sullo stato e verificare se la coda di lavoro mostra sintomi già descritti in Problema, ad esempio valori negativi o un problema di montaggio della coda.
2. Eseguire workqueue e scegliere l'opzione Rate. Confermare se le tariffe riportate supportano la condizione di attivazione.
3. Confrontare il valore del messaggio meno recente nei dettagli dello stato o dello stato con la soglia del profilo di mancato recapito configurata. Se il valore supera la soglia, continuare con la procedura di riparazione.

Avviso: L'esecuzione di repairqueue può causare la perdita di messaggi attivi nella coda di lavoro.

4. Eseguire repairqueue. Il primo processo richiede l'autorizzazione una volta per procedere ed eseguire il ripristino:

   esa.example.com> repairqueue
   
   Do you want to repair or clean the queue?
   1. Repair.
   2. Clean.
   [1]> 1
   
   The mail flow will be stopped throughout the repair/cleanup process
   WARNING:
   This utility does a best effort to repair the queue.
   Not all queues corruptions can be repaired.
   Are you sure you want to proceed? [N]> y
   Checking generation checksum files
   ...
   <<<SNIP FOR BREVITY>>>
   ...
   done
   Repair succeeded
   Starting Hermes
   Hermes Started
   
   Log into the system and verify the status of the system.

   Nota: Su un'ESA virtuale, ignorare l'output, "In attesa del montaggio della coda: Impossibile aprire il dispositivo in /dev/ipmi0 o /dev/ipmi/0 o /dev/ipmidev/0: No this file or directory" (Nessun file o directory di questo tipo) documentato con l'ID bug Cisco noto CSCuz28415.

5. Una volta completato il processo di riparazione e ripristinata la coda di lavoro, l'accessorio conserva un vecchio checkpoint della coda di lavoro precedente. Per riprendere la scrittura di un nuovo checkpoint per l'elaborazione della coda di lavoro, eseguire di nuovo repairqueue e immettere il comando Clean:

   esa.example.com> repairqueue
   
   Do you want to repair or clean the queue?
   1. Repair.
   2. Clean.
   [1]> 2
   
   The mail flow will be stopped throughout the repair/cleanup process
   WARNING:
   There is a backup found this may be the only backup.
   This will remove the old queue.
   Are you sure you want to proceed? [N]> y
   Double confirmation. Are you sure you want to proceed? [N]> y
   Removing old queue
   Cleanup finished

6. Eseguire il comando status detail dalla CLI o scegliere Monitor > System Status (Monitor > Stato sistema) nella GUI. Verificare che lo stato del sistema sia In linea.
7. Esaminare i log di posta per confermare l'elaborazione della posta. Dalla CLI, eseguire il comando tail mail_logs.
8. Eseguire il comando workqueue e scegliere l'opzione Rate (valore predefinito: 10 secondi). Confermare che le velocità in entrata e in uscita siano ragionevoli per il flusso di posta corrente. Se la coda di lavoro dispone di un backlog di grandi dimensioni, lo svuotamento può richiedere del tempo.

Causa

Le cause più comuni del danneggiamento delle code di lavoro includono:

1. Riavvii imprevisti o arresti impropri (ad esempio, interruzioni dell'alimentazione). A seconda dei processi back-end in esecuzione in quel momento, la coda può danneggiarsi o non riuscire a montarla dopo il riavvio. In questo caso, la CLI può segnalare errori quali:

   esa.example.com> status
   
   Enter "status detail" for more information.
   
   Couldn't obtain mail stats - my.esa: The daemon is not responding.

   esa.example.com> status
   
   Enter "status detail" for more information.
   
   Couldn't obtain mail stats - the queue is not mounted

2. Utilizzo eccessivo della memoria (RAM). Questo è in genere associato alle impostazioni dei criteri del listener o del flusso di posta che consentono un numero eccessivo di connessioni in entrata o di aggiunte. Esaminare listenerconfig e verificare che il valore massimo delle connessioni in entrata sia appropriato per la distribuzione.

Domande frequenti

Cosa succede se l'ESA non funziona a partire dalla versione 11.0.0-264?

Gli utenti che dispongono di appliance con versioni precedenti di AsyncOS e che non dispongono dell'opzione di comando repairqueue hidden CLI possono aprire una richiesta di assistenza per chiedere l'assistenza di un tecnico del supporto Cisco nella procedura. Affinché il supporto Cisco possa accedere all'accessorio ed eseguire il comando repairqueue, è necessario aprire e rendere disponibile un tunnel di supporto. Contatta il supporto Cisco per aprire una richiesta di assistenza attiva.

Il danneggiamento della coda di lavoro comporta la perdita della posta?

Nella maggior parte dei casi, la corruzione non equivale alla perdita di posta. La coda è danneggiata a causa dei metadati relativi all'elaborazione dei messaggi che non sono più presenti sull'accessorio. In questo modo vengono mantenuti i record per l'elaborazione tra la coda, la segnalazione e la verifica dei messaggi. L'esecuzione di repairqueue ricostruisce i metadati ESA ed elimina qualsiasi segnalazione errata tra i servizi e l'elaborazione.

Ci sono ripercussioni sul danneggiamento delle code di lavoro?

L'ESA può essere eseguita per molto tempo su una coda danneggiata e la maggior parte dei messaggi viene ancora elaborata. Tuttavia, l'accessorio può apparire lento o alcuni messaggi non possono essere cancellati, come indicato dal valore Meno recente del messaggio nel comando status (molto più vecchio della soglia bounceconfig). Quando AsyncOS viene riavviato con una coda danneggiata, è possibile che il montaggio della coda non riesca. Il danneggiamento può verificarsi in anticipo e rimanere inosservato fino al riavvio dell'accessorio, nel qual caso il montaggio della coda non riesce.

Quanto tempo può durare il completamento dello script di ripristino?

Il ripristino della coda di lavoro può richiedere da 10 secondi a diverse ore, a seconda dello stato dell'ESA e del numero di messaggi che stanno elaborando attraverso una coda di lavoro attiva. La riparazione di una coda di lavoro su un accessorio di fascia bassa con code complete al momento del danneggiamento potrebbe richiedere diverse ore.

Cosa succede se la coda di ripristino non può essere eseguita o non viene completata?

In alcune situazioni, ad esempio una coda troppo piena su un accessorio, la coda di ripristino non può essere completata. se repairqueue non viene completato dopo 4 ore, è molto probabile che la coda non possa essere riparata e l'unica possibilità è quella di creare una nuova coda. Per problemi avanzati, contattare il supporto Cisco per aprire una richiesta di assistenza attiva e chiedere assistenza al supporto Cisco.

Contenuto correlato

• Guide per l'utente finale di Cisco Email Security Appliance
• Riferimenti per i comandi di Cisco Email Security Appliance
• Qual è l'ordine di elaborazione nella coda di lavoro? Che cos'è la pipeline della coda di lavoro?
• Documentazione e supporto tecnico – Cisco Systems

Cronologia delle revisioni

Revisione	Data di pubblicazione	Commenti
2.0	02-Oct-2026	Certificazione
1.0	10-Aug-2017	Versione iniziale