Problemen met de werkvoorraad oplossen met de opdracht Reparatiewachtrij op ESA

Downloadopties

PDF (262.3 KB)
Met Adobe Reader op diverse apparaten bekijken
ePub (87.6 KB)
Bekijken in diverse apps op iPhone, iPad, Android, Sony Reader of Windows Phone
Mobi (Kindle) (74.9 KB)
Op Kindle-apparaat of via Kindle-app op meerdere apparaten bekijken

Bijgewerkt:2 oktober 2026

Document-id:211573

Inclusief taalgebruik

De documentatie van dit product is waar mogelijk geschreven met inclusief taalgebruik. Inclusief taalgebruik wordt in deze documentatie gedefinieerd als taal die geen discriminatie op basis van leeftijd, handicap, gender, etniciteit, seksuele oriëntatie, sociaaleconomische status of combinaties hiervan weerspiegelt. In deze documentatie kunnen uitzonderingen voorkomen vanwege bewoordingen die in de gebruikersinterfaces van de productsoftware zijn gecodeerd, die op het taalgebruik in de RFP-documentatie zijn gebaseerd of die worden gebruikt in een product van een externe partij waarnaar wordt verwezen. Lees meer over hoe Cisco gebruikmaakt van inclusief taalgebruik.

Over deze vertaling

Cisco heeft dit document vertaald via een combinatie van machine- en menselijke technologie om onze gebruikers wereldwijd ondersteuningscontent te bieden in hun eigen taal. Houd er rekening mee dat zelfs de beste machinevertaling niet net zo nauwkeurig is als die van een professionele vertaler. Cisco Systems, Inc. is niet aansprakelijk voor de nauwkeurigheid van deze vertalingen en raadt aan altijd het oorspronkelijke Engelstalige document (link) te raadplegen.

Inhoud

Inleiding

Dit document beschrijft het gebruik van de verborgen CLI-reparatiewachtrij op het Cisco Email Security Appliance (ESA) en hoe u het herstel van de wachtrij kunt valideren.

uitgifte

Redenen om de opdracht RepairQueue uit te voeren:

Fout bij het aangeven dat de werkvoorraad niet is gemonteerd. Dit is meestal het gevolg van beschadiging van de wachtrij na een onjuiste energiecyclus of het opnieuw opstarten van het apparaat.
Een bekend defect kan deze opdracht als een tijdelijke oplossing vereisen (zoals Cisco-bug-ID CSCuw22284 - E-mailwachtrij corrumpeert na een crash van een e-mailverwerkingsservice of een onjuiste uitschakeling).
Toepassingsfouten, zoals fouten die verwijzen naar gcq.py of het subsysteem voor wachtrijbeheer.
Statusdetails of werkvoorraad > tarief rapport negatieve getallen.
Status- of statusdetails geven een Oudste berichtwaarde weer die de drempelwaarde voor het geconfigureerde bounceprofiel overschrijdt.
- Standaarddrempel: 259200 seconden (3 dagen).
- Als u de drempelwaarde wilt controleren, voert u bounceconfig > bewerken in en selecteert u vervolgens het standaardprofiel. Zoek de regel, Voer het maximum aantal seconden in dat een bericht in de wachtrij mag blijven staan voordat het hard wordt gekaatst.

Opmerking: bij deze controle worden virtuele wachtrijen voor leveringsdomeinen zoals de ..queue (bijvoorbeeld de.cpq.queue en de.euq.queue) en de.cpq.release.host uitgesloten.

Redenen om de opdracht RepairQueue niet uit te voeren:

Een trage werkvoorraadverwerking is geen geldige reden om een werkvoorraadherstel uit te voeren. Beheerders verwarren vaak trage werkvoorraadverwerking met wachtrijcorruptie. Een trage werkvoorraad is meestal te wijten aan herhaalde verwerking van hetzelfde bericht of van meerdere berichten, omdat een service te veel gebruik maakt van systeembronnen. Deze scenario's voor herhaalde verwerking worden vaak niet gerepareerd door eenvoudigweg een reparatiewachtrij uit te voeren. Verdere probleemoplossing van de getroffen service of services is vereist.

milieu

De informatie in dit document is gebaseerd op de volgende software- en hardware-versies:

ESA, alle hardware en virtuele apparaten met AsyncOS 11.0.0-264 of nieuwer

De informatie in dit document is gebaseerd op de apparaten in een specifieke laboratoriumomgeving. Alle apparaten die in dit document worden beschreven, hadden een opgeschoonde (standaard)configuratie. Bevestig in live netwerken de potentiële impact van elk commando voordat u doorgaat.

Cisco adviseert kennis van deze onderwerpen:

Systeemcapaciteit, systeembewaking, systeemgezondheid en algemene verwerking van berichten via de ESA-werkvoorraad.
Algemene ESA-administratie.

Opmerking: Zie de ESA-gebruikershandleiding of de online Help van de ESA GUI voor meer informatie.

resolutie

De CLI command repair queue herstelt niet alle problemen of corruptie in de werkvoorraad. Het hulpprogramma probeert de werkvoorraad zo goed mogelijk te herstellen.

Voer statusdetails uit en controleer of de werkvoorraad symptomen vertoont die al in Probleem zijn beschreven, zoals negatieve waarden of een probleem met het koppelen van de werkvoorraad.
Voer de werkvoorraad uit en kies de optie Tarief. Bevestig of de gerapporteerde tarieven de triggervoorwaarde ondersteunen.
Vergelijk de waarde voor Oudste bericht in status- of statusdetails met de drempelwaarde voor het geconfigureerde bounceprofiel. Als de waarde de drempelwaarde overschrijdt, gaat u verder met de reparatieprocedure.

Waarschuwing: het uitvoeren van een reparatiewachtrij kan leiden tot verlies van actieve berichten in de werkvoorraad.

Voer de reparatiewachtrij uit. In het eerste proces wordt eenmaal om toestemming gevraagd om door te gaan en de reparatie uit te voeren:

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.

Opmerking: op een virtuele ESA negeert u de uitvoer, "Wachten tot de wachtrij wordt gekoppeld: Kan apparaat niet openen op /dev/ipmi0 of /dev/ipmi/0 of /dev/ipmidev/0: Geen dergelijk bestand of map" gedocumenteerd onder het bekende defect Cisco bug ID CSCuz28415.

Zodra het reparatieproces is voltooid en de werkvoorraad is gerepareerd, behoudt het apparaat een oud controlepunt van de vorige werkvoorraad. Als u het schrijven van een nieuw controlepunt voor de verwerking van werkvoorraden wilt hervatten, voert u de reparatiewachtrij opnieuw uit en voert u de opdracht Schoonmaken in:

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

Voer de opdracht Statusdetails uit vanuit de CLI of kies Monitor > Systeemstatus in de GUI. Bevestig dat de systeemstatus Online is.
Controleer de maillogs om de verwerking van de e-mail te bevestigen. Voer vanuit de CLI de opdracht tail mail_logs uit.
Voer de opdracht Werkvoorraad uit en kies de optie Tarief (standaard 10 seconden). Bevestig dat de In- en Uittarieven redelijk zijn voor de huidige mailflow. Als de werkvoorraad een grote achterstand heeft, kan het tijd kosten om te leeglopen.

Oorzaak

Voorkomende oorzaken van werkvoorraadcorruptie zijn onder meer:

Onverwachte herstart of onjuiste uitschakeling (bijvoorbeeld stroomonderbrekingen). Afhankelijk van de back-endprocessen die op dat moment worden uitgevoerd, kan de wachtrij corrupt worden of niet worden gemonteerd na opnieuw opstarten. In dit geval kan de CLI fouten rapporteren zoals:
```
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
```
Overmatig gebruik van geheugen (RAM). Dit wordt vaak geassocieerd met de beleidsinstellingen voor de listener of e-mailstroom die te veel inkomende verbindingen of injecties toestaan. Controleer listenerconfig en bevestig dat de maximale waarde voor inkomende verbindingen geschikt is voor de implementatie.

VEELGESTELDE VRAGEN

Wat als mijn ESA niet 11.0.0-264 of nieuwer draait?

Gebruikers die toestellen hebben waarop oudere versies van AsyncOS draaien die niet beschikken over de optie reparatiewachtrij verborgen CLI, kunnen een supportcase openen om een Cisco Support engineer te laten assisteren bij de procedure. Er moet een ondersteuningstunnel worden geopend en beschikbaar zijn voor Cisco Support om toegang te krijgen tot het toestel en de opdracht RepairQueue uit te voeren. Neem contact op met Cisco Support om een actieve supportcase te openen.

Betekent werkvoorraadcorruptie verlies van e-mail?

In de meeste gevallen is corruptie niet gelijk aan postverlies. De wachtrij is beschadigd als gevolg van meta-gegevens met betrekking tot berichtverwerking die niet langer op het toestel staan. Dit is het bijhouden van gegevens voor verwerking tussen de wachtrij, rapportage en het volgen van berichten. Het uitvoeren van reparatiewachtrij herstelt de ESA-metagegevens en ruimt eventuele onjuiste rapportage tussen de services en verwerking op.

Zijn er gevolgen voor de corruptie in de werkvoorraad?

De ESA kan lange tijd draaien op een corrupte wachtrij, en de meeste berichten worden nog steeds verwerkt. Het toestel kan echter traag overkomen, of sommige berichten kunnen nooit worden gewist, zoals aangegeven door de Oudste berichtwaarde in de statusopdracht (aanzienlijk ouder dan de bounceconfig-drempel). Wanneer AsyncOS opnieuw wordt gestart met een beschadigde wachtrij, kan de wachtrij niet worden gekoppeld. De beschadiging kan eerder optreden en onopgemerkt blijven totdat het apparaat opnieuw wordt opgestart, waarna de wachtrij niet kan worden gemonteerd.

Hoe lang kan het reparatiescript duren om te voltooien?

Het repareren van de werkvoorraad kan 10 seconden tot enkele uren duren, afhankelijk van de status van de ESA en hoeveel berichten momenteel worden verwerkt via een actieve werkvoorraad. Een werkvoorraadreparatie op een lager apparaat met volledige wachtrijen op het moment van corruptie kan enkele uren duren.

Wat gebeurt er als de reparatiewachtrij niet kan worden uitgevoerd of niet wordt voltooid?

In bepaalde situaties (bijvoorbeeld een overvolle wachtrij op een apparaat) kan de reparatiewachtrij niet worden voltooid. Als de reparatiewachtrij na 4 uur niet is voltooid, is de wachtrij hoogstwaarschijnlijk niet te repareren en is het enige middel om een nieuwe wachtrij te bouwen. Neem voor dergelijke geavanceerde problemen contact op met Cisco Support om een actieve supportcase te openen en Cisco Support Assist in te schakelen.