10. Fehlersuche¶
Beginnen Sie mit zwei Befehlen; die meisten Probleme zeigen sich in einem von ihnen:
pepsi-status
journalctl -u 'pepsi-*' -p warning --since '1 hour ago'
Pepsi betreiben erklärt die Logs und was pepsi-status meldet. Die folgenden Probleme sind diejenigen, auf die frühe Installationen am häufigsten gestoßen sind.
10.1. Häufige Probleme¶
10.1.1. Es kommt keine Mail an¶
Ein anderer MTA belegt Port 25. Debian installiert standardmäßig einen.
systemctl start pepsi.targetschlägt dann fehl, undsystemctl status pepsi-ingress.socketzeigtResult: resources.ss -ltnp 'sport = :25'nennt das Programm; halten Sie es an und deaktivieren Sie es (siehe Installation, „Migration von einem vorhandenen Mailserver“).DNS oder die Firewall. Der
MX-Eintrag der Domain muss diesen Host nennen, und Port 25 muss aus dem Internet offen sein.pepsi-setup -c /etc/pepsi/pepsi.conf rungibt die erwarteten Einträge aus und prüft die veröffentlichten.Pepsi weist die Nachricht ab. Der Server des Absenders erhält den Grund, und ebenso das Journal von
pepsi-ingress. Die üblichen Gründe sind550 5.1.1für eine Adresse, an die nichts auf diesem Host zustellt (sieheVERIFY_RECIPIENTSin pepsi-ingress(1));550für ein eindeutiges DMARC-Scheitern unterDMARC_ENFORCE;554 5.6.0für eine MIME-Struktur, die sich nicht eindeutig richtig lesen lässt, etwa eine leere Boundary, ein NUL in einem MIME-Header, widersprüchliche doppelte Felder oder eine Encoded-Word-Boundary (MIME_ANOMALIES = lognimmt eine solche Nachricht stattdessen an und hält die Anomalie fest; das Journal nennt die Klasse); und452 4.3.1, wenn die Warteschlange oder die Platte voll ist (sieheMAX_QUEUE_ROWSundMIN_FREE_SPACEin pepsi.conf(5)).Ein Filter hat sie in Quarantäne gestellt. Die Nachricht wurde angenommen und wartet an einer Quarantäne-Stage, und niemand wird benachrichtigt.
pepsi-queue quarantine listzeigt sie mit dem Filter, der sie dorthin geschickt hat, und dem Grund an;pepsi-queue quarantine release TOKENlässt sie durch (Mail in Quarantäne).
10.1.2. Ausgehende Mail wird nicht zugestellt¶
pepsi-status listet die an jeder Stage wartenden Nachrichten auf. Nachrichten, die an einer Relay-Stage paused bleiben, werden erneut versucht; pepsi-queue list ID --state-only zeigt die letzte Antwort des entfernten Servers. Häufige Ursachen:
Der ausgehende Port 25 ist gesperrt. Viele Hosting- und Privatkundenanbieter sperren ihn. Leiten Sie stattdessen über einen Smarthost (
pepsi-setup --wizard).Der empfangende Server weist die Mail ab oder legt sie als Spam ab. Prüfen Sie, dass die SPF-, DKIM- und DMARC-Einträge, die
pepsi-setup runausgibt, veröffentlicht sind und dass die Adresse des Hosts einen Reverse-DNS-Namen hat, der zu[pepsi-ingress] HOSTNAMEpasst.Nachrichten warten an der DKIM-Signier- oder ARC-Stage. Die Signier-Stages fragen
pepsi-dkimnach jeder Signatur und versuchen es erneut, solange er nicht antwortet; der letzte Fehler nennt den Socket, zu dem keine Verbindung möglich war. Prüfen Siesystemctl status pepsi-dkimund sein Journal. Eine Nachricht von einer Domain, für die der Daemon nicht signiert, wird stattdessen abgewiesen (der Absender erhält einen Bounce): Führen Siepepsi-setup runaus, das dem Daemon jede Signierdomain übergibt.DKIM schlägt beim Empfänger fehl. Der Selektor, den die Nachricht nennt (
s=in ihrerDKIM-Signature), hat keinen veröffentlichten Eintrag:pepsi-dkim statuszeigt das DNS-Urteil für jeden Schlüssel undpepsi-dkim recordsdie zu veröffentlichenden Einträge (DKIM-Schlüssel rotieren).Der DANE-Eintrag des nächsten Hops passt nicht zu seinem Zertifikat.
DANE = strictist der Standard, daher stellt ein veröffentlichterTLSA-Eintrag, der zu nichts passt, was der Server vorlegt, die Nachricht zurück (und bounct sie schließlich), statt sie über unauthentifiziertes TLS zu senden. Der letzte Fehler nennt den Host. Die Behebung ist Sache der empfangenden Domain;DANE = warnim Abschnitt der Relay-Stage ist der ausdrückliche Verzicht (siehe Der Netzwerkangreifer).Eine verschlüsselte Nachricht wartet auf eine Schlüsselabfrage. Ist die DNS-Abfrage nach dem Schlüssel eines Empfängers fehlgeschlagen und würde die Nachricht sonst im Klartext hinausgehen, dann wird sie zurückgestellt statt im Klartext gesendet. Der Absender kann Klartext mit
[clear-ok]im Betreff akzeptieren (siehe Ein Schlüssel-Lookup, der im DNS scheitert).
10.1.3. Eine Einlieferung wird abgewiesen¶
Der Mail-Client zeigt den Grund. 550 5.7.1 bedeutet, dass USERNAME_MAP (oder SENDER_MAP, für ein vertrauenswürdiges Netz oder Client-Zertifikat) diesem Konto die MAIL FROM- oder From:-Adresse nicht erlaubt. 550 5.6.0 bedeutet, dass die Nachricht kein brauchbares From: hat (keines, mehr als eines, nur eine Gruppe oder ein Postfach ohne vollständige Adresse). Es kann auch bedeuten, dass der Anzeigename im From: eine andere Adresse als die eigene enthält; viele Clients würden diese anstelle der echten anzeigen. Siehe Unterstützte Funktionen („Nachrichteneinlieferung“).
Dauert die Anmeldung eines Mail-Clients (SMTP AUTH) zwanzig Sekunden oder scheitert sie mit 454 4.7.0, dann hat das Konto ACCOUNT_AUTH_FAILURES_PER_HOUR fehlgeschlagene AUTH-Versuche aus allen Quellen gesammelt (das Journal sagt „AUTH for ‚…‘ delayed“). Versuche aus Netzen, aus denen sich das Konto bisher nicht angemeldet hat, warten dann einzeln ACCOUNT_AUTH_DELAY. Jemand versucht, das Konto zu erraten; der Besitzer kommt nach der Verzögerung trotzdem hinein, und aus einem Netz, aus dem er sich schon einmal angemeldet hat, sofort.
10.1.4. Die Administrationskonsole weist ein Passwort ab¶
Ein 429 (oder die Anmeldeseite, die „zu viele“ antwortet) bei einem Konto, das niemand benutzt, bedeutet, dass jemand dessen LOGIN_DAILY_LIMIT an fehlgeschlagenen Anmeldungen verbraucht hat (auth.login.ceiling im Audit-Log); das Kontingent füllt sich im Laufe des Tages wieder auf. Bei einem Konto mit zweitem Faktor erhält ein fehlender, falscher oder gesperrter Code genau dieselbe Antwort wie ein falsches Passwort. Dasselbe gilt, wenn der Applier nicht installiert ist oder nicht antwortet; auth.login.second-factor-refused im Audit-Log sagt, welcher Fall vorliegt. Der lokale Socket braucht kein Passwort: pepsi-keys otp reset --console LOGIN löscht einen gesperrten oder verlorenen zweiten Faktor, und PATCH /api/v1/accounts/{id} setzt ein neues Passwort.
10.1.5. Eine Nachricht wurde mit 5.7.30 oder 5.7.10 gebounct¶
Die Nachricht wurde von ihrem Absender mit REQUIRETLS gekennzeichnet (RFC 8689), und weder ein MX-Host der Empfängerdomain noch der konfigurierte Smarthost konnte sie unter dieser Anforderung übernehmen. 5.7.30 bedeutet, dass der Hop REQUIRETLS nach STARTTLS nicht ankündigt. 5.7.10 bedeutet, dass es kein validiertes TLS zu ihm gab: kein STARTTLS, ein Zertifikat, das an DANE oder PKIX scheitert, eine Domain, deren MX-Hosts weder DNSSEC noch eine MTA-STS-Richtlinie validiert, oder ein Smarthost-Eintrag mit MODE = plain. Auf diesem Host ist nichts falsch konfiguriert, es sei denn, DANE = off verdeckt die Validierung einer DNSSEC-signierten Domain, oder ein Smarthost, der die Erweiterung anbieten könnte, tut es nicht. Der Absender hat einen Schutz verlangt, den der Weg nicht bieten kann, und der Bounce (nur Header) teilt ihm das mit. Siehe TLS für eine Nachricht verlangen (RFC 8689).
10.1.6. pepsi-ingress startet nach einer Konfigurationsänderung nicht¶
Das Journal nennt den Grund. Ein MYNETWORKS-Eintrag außerhalb von Loopback, den [pepsi-ingress] SENDER_MAP nicht abdeckt, wird abgewiesen. Denn jeder Host in diesem Netz könnte als beliebige Adresse senden und die Nachricht für jede bediente Domain signieren lassen. Fügen Sie der Map eine Zeile <network> <addresses> hinzu (* erlaubt das uneingeschränkte Verhalten, als bewusste Entscheidung), oder entfernen Sie den Eintrag. pepsi-setup -c /etc/pepsi/pepsi.conf validate meldet dieselbe Ablehnung, ohne etwas neu zu starten. Siehe pepsi-ingress(1), Absenderbindungen.
10.1.7. sendmail oder Cron-Mail scheitert mit „temporary failure“¶
pepsi-sendmail übergibt Mail über /run/pepsi/submission.sock an pepsi-ingress und endet mit Status 75 (vorübergehender Fehler), wenn dort niemand antwortet. Prüfen Sie, dass pepsi.target läuft. Wurde /run/pepsi von Hand gelöscht, legt systemd-tmpfiles --create es mit den richtigen Berechtigungen neu an; starten Sie danach pepsi-ingress neu.
10.1.8. Ein Programm endet mit Status 78¶
Das Datenbankschema ist nicht das, mit dem das Programm gebaut wurde, typischerweise in den Minuten nach einem Upgrade, bevor pepsi-setup schema gelaufen ist. Die Meldung nennt die Abhilfe; Upgrade enthält die Tabelle der Fälle. Die Dienste versuchen es von selbst erneut und kommen zurück, sobald das Schema passt.
10.1.9. „permission denied“ von der Datenbank¶
Die Berechtigungen der Datenbankrollen setzt pepsi-setup. Führen Sie nach dem Wiederherstellen einer Datenbank oder nach einer Änderung der Rollen von Hand erneut pepsi-setup -c /etc/pepsi/pepsi.conf run aus.
10.1.10. Ein S/MIME-Empfänger sieht eine leere Nachricht¶
Sein Client kann AuthEnvelopedData (AES-256-GCM) nicht lesen. Thunderbird zum Beispiel kann es nicht und zeigt statt eines Fehlers eine leere Nachricht. Pepsi sendet dieses Format an jeden S/MIME-Empfänger, für den es keinen Fähigkeitseintrag hat. Die erste solche Nachricht trägt neben dem Chiffrat einen Klartexthinweis. Er bittet den Empfänger, genau dieses Problem zu melden und mit einer signierten Nachricht zu antworten (Was ein Korrespondent mit einem nicht gemessenen Client sieht). Die erste signierte Nachricht eines Korrespondenten hält die Fähigkeiten seines Clients automatisch fest; bis dahin konfigurieren Sie den Eintrag von Hand:
pepsi-keys -c /etc/pepsi/pepsi.conf peer capability set alice@example.org cbc
peer capability list --address alice@example.org zeigt, was festgehalten ist, und state.crypto.out der Nachricht nennt den Container, der hinausging. Siehe Der S/MIME-Fähigkeitsdatensatz pro Gegenstelle.
10.1.11. Ein ausgelieferter Schlüssel wird als Abweichung gemeldet oder WKD als fehlgeschlagen¶
pepsi-setup check, pepsi-status und pepsi-keys identity list --served holen ab, was das Web Key Directory und das DNS für jede veröffentlichte Identität ausliefern (Prüfen, was tatsächlich ausgeliefert wird). Ein MISMATCH nennt den Kanal und den fremden Fingerabdruck:
WKD (direct) – Die Apex der Domain wird von einem anderen Webserver beantwortet (einem CMS, einem CDN), der sein eigenes
/.well-known/openpgpkey/hat. Entfernen Sie dieses Verzeichnis dort, oder lassen Sie die Apex/.well-known/openpgpkey/anpepsi-httpdweiterreichen (Proxy).OPENPGPKEY oder SMIMEA – Die Zone enthält noch einen Eintrag für eine rotierte oder widerrufene Identität oder einen, den jemand anderes hinzugefügt hat. Ersetzen Sie ihn durch das, was
pepsi-keys dns ADDRESSausgibt.WKD (advanced) –
openpgpkey.<domain>zeigt auf einen Host, der nicht dieser ist.
Bis das behoben ist, können Korrespondenten, die die Adresse nachschlagen, an diesen Schlüssel verschlüsseln. Ein WKD-Kanal, der mit „refusing to connect“ FAILED ist, nennt einen Host, der zu einer privaten oder Loopback-Adresse auflöst; eine solche Adresse lehnt der Client ab, wie es jeder Schlüsselabruf tut. Läuft ein WKD-Kanal auf einem Host hinter NAT in eine Zeitüberschreitung, bedeutet das meist, dass der Router die eigene öffentliche Adresse dieses Hosts nicht zu ihm zurückroutet. In keinem der beiden Fälle sieht ein Korrespondent dasselbe Ergebnis; prüfen Sie also von außen, bevor Sie etwas ändern.
10.1.12. Der Resolver meldet „does not validate“ für DNSSEC¶
Die Relay-Worker und pepsi-keydisc@dane protokollieren diese Warnung beim Start, und pepsi-status zeigt sie in seinem Abschnitt „DNSSEC resolver“. Sie bedeutet, dass der dort genannte Resolver (/etc/resolv.conf, [pepsi] DNS_SERVERS oder DNS_SERVERS einer Stage) eine Anfrage nach dem signierten ietf.org ohne das DNSSEC-AD-Bit beantwortet hat. Pepsi vertraut diesem Bit, statt selbst zu validieren, daher findet jede DANE-Abfrage nichts: Ausgehendes DANE greift nie, und die DANE-Schlüsselentdeckung findet keinen Schlüssel, obwohl nichts fehlschlägt. Typische Ursachen sind ein Resolver des ISP oder aus DHCP, der nach der Einrichtung in resolv.conf geschrieben wurde, oder systemd-resolved ohne DNSSEC=yes. Zur Abhilfe richten Sie resolv.conf (oder DNS_SERVERS) auf einen validierenden Resolver auf diesem Host, etwa unbound (Installation). Oder Sie nennen einen validierenden Resolver, dem Sie vertrauen, als tls://- oder https://-Eintrag von [pepsi] DNS_SERVERS. Bestätigen Sie das Ergebnis mit pepsi-status. Alternativ setzen Sie DANE = off, wo DANE nicht gewünscht ist. „Could not be established“ bedeutet, dass die Probe überhaupt keine Antwort bekam. Prüfen Sie, ob der Resolver erreichbar ist; bei einem verschlüsselten Eintrag prüfen Sie, ob sein Port offen ist und sein Zertifikat für den Namen nach # gültig ist.
10.1.13. Der Resolver „is not on this host“¶
Die DANE-Worker protokollieren „trusts the DNSSEC AD bit from … which is not on this host and is reached over plain DNS“, und pepsi-status und pepsi-setup run nennen dieselben Resolver. Das AD-Bit, das diese Antworten tragen, reist ungeschützt, sodass jeder auf dem Weg es auf einem gefälschten TLSA-, OPENPGPKEY- oder SMIMEA-Eintrag setzen kann. Betreiben Sie entweder einen validierenden Resolver auf diesem Host (unbound, systemd-resolved mit DNSSEC=yes), oder erreichen Sie einen validierenden Resolver, dem Sie vertrauen, über einen authentifizierten Kanal: [pepsi] DNS_SERVERS = tls://192.0.2.53#dns.example.net (DNS over TLS) oder https://…#NAME (DNS over HTTPS), mit dem Namen, auf den sein Zertifikat ausgestellt ist. Eine Liste darf einfache und verschlüsselte Einträge nicht mischen.
10.1.14. Empfänger sehen ... als Betreff verschlüsselter Mail¶
[stage-encrypt] PROTECT_HEADERS = yes (der Standard ist no) verschiebt den echten Subject: und die anderen RFC-5322-Felder in den verschlüsselten und signierten Teil, und der äußere Betreff lautet .... Ein Client, der geschützte Header darstellt (zum Beispiel Thunderbird), zeigt den echten Betreff; einer, der das nicht tut, zeigt den Platzhalter. Wo die Clients der meisten Empfänger von der zweiten Art sind, entfernen Sie die Einstellung oder setzen Sie PROTECT_HEADERS = no im Abschnitt der Verschlüsselungs-Stage (oder je Absender über pepsi-settings). Die Signatur deckt dann To: und Cc: für Clients, die Pepsis eigenes Empfängerattribut ignorieren, nicht mehr ab (Für wen eine signierte und verschlüsselte Nachricht bestimmt war).
10.1.15. Eine Nachricht eines S/MIME-Absenders ist verschwunden, statt gebounct zu werden¶
Mit ON_DECRYPT_FAILURE = bounce-if-unproblematic, ON_BAD_SIGNATURE = bounce oder ON_NO_CLIENT_KEY = bounce der Neuverschlüsselungs-Stage wird eine Nachricht, die als AES-CBC-EnvelopedData ankam, verworfen statt gebounct, weil der Bounce ihrem Absender verraten würde, ob sich ein möglicherweise verändertes Chiffrat öffnen ließ. Das Journal sagt es (dropped rather than bounced), und die Telemetrie zählt decrypt-dropped. passthrough, record und plaintext stellen eine solche Nachricht stattdessen zu (Bounces und Antworten auf verschlüsselte Mail).
10.1.16. Das CA-Zertifikat eines Benutzers kommt nicht an¶
Sehen Sie sich zuerst die Bestellungen des Benutzers an:
pepsi-keys -c /etc/pepsi/pepsi.conf mpki order list --address alice@example.org
pepsi-keys -c /etc/pepsi/pepsi.conf mpki user list --domain example.org
Gar keine Bestellung bedeutet, dass der Benutzer nicht vorgesehen ist: Unter first-send hat er noch keine Mail über den Server gesendet (oder nur von außerhalb), unter manual hat ihn niemand ausgewählt (mpki user set ADDRESS --select yes), oder seine Auswahl ist no. Prüfen Sie auch, ob die Domain eingeschaltet ist (mpki domain show DOMAIN). Eine Bestellung im Zustand held nennt ihren Grund:
name-unconfirmedDer Name stammt aus dem Anzeigenamen der ersten Nachricht des Benutzers, und die Domain wartet darauf, dass ein Administrator solche Namen bestätigt. Prüfen Sie ihn in
mpki user list(mit?gekennzeichnet) und geben Sie ihn dann mitmpki user set ADDRESS --confirmfrei, oder korrigieren Sie ihn mit--given-name/--surname. Der nächste Durchlauf gibt die Bestellung frei.name-missingDer Anzeigename oder der Verzeichniseintrag ergab keinen Vor- und Nachnamen (ein einzelnes Wort, eine Adresse, nichts). Geben Sie beide mit
mpki user setein, oder importieren Sie den Benutzer aus dem Verzeichnis.daily-limitDie neuen Aufnahmen der Domain in den letzten 24 Stunden haben ihr Tageslimit erreicht. Prüfen Sie, ob die Bestellungen die erwarteten sind (ein Import der falschen Datei oder ein Skript, das als viele Adressen sendet, zeigt sich hier), und geben Sie sie dann einzeln mit
mpki order release IDfrei, oder heben Sie das Limit an (mpki domain set DOMAIN --daily-limit N) und geben Sie sie frei.no-licenceDas CA-Konto hat keine freie Abonnementlizenz für die Adresse: Die CA hat mit
insufficient_subscriptiongeantwortet. Pepsi kann keine kaufen. Fügen Sie im Portal der CA eine Lizenz hinzu (oder machen Sie eine frei, indem Sie dort die Adresse eines ausgeschiedenen Benutzers aus dem Abonnement entfernen), und führen Sie dannmpki order release IDaus. Ein Widerruf allein macht keine Lizenz frei.no-credentialDie Domain hat keine lesbare
secrets.d/mpki-<domain>.secret. Speichern Sie den API-Schlüssel mitmpki credential set DOMAINund führen Siempki domain check DOMAINaus; der nächste Durchlauf gibt die Bestellung frei.
Eine Bestellung im Zustand failed zeigt den Grund unter last error. Eine Ablehnung durch die CA (HTTP 4xx mit der Meldung der CA) ist meist eine Einstellung, die auch mpki domain check DOMAIN meldet: ein API-Schlüssel, den die CA nicht annimmt, ein Produkt, das dem Konto fehlt, mehrere Organisationen und keine --organization-id, oder eine Domain, die im Konto nicht validiert ist. Ein Benutzer, der weiterhin vorgesehen ist, erhält einen Tag nach der fehlgeschlagenen Bestellung eine neue; bis die Ursache behoben ist, kostet daher jeder solche Benutzer eine fehlgeschlagene Bestellung und einen Hinweis am Tag. Ist sie behoben, versucht es mpki order retry ID schon beim nächsten Durchlauf statt erst am nächsten Tag. „the certificate does not name …“ oder „is not over the key“ bedeutet, dass die CA ein Zertifikat zurückgegeben hat, dessen Installation Pepsi verweigert; melden Sie es der CA. Eine Bestellung, die submitted bleibt, wartet bei der CA, und mpki order list --json zeigt den eigenen Status der CA (ca_status). Pepsi fragt weiter nach, höchstens einmal pro Stunde, und installiert das Zertifikat, sobald es ausgestellt ist; hier lässt sich nichts beschleunigen. Typische Ursachen sind eine Genehmigung, die das Konto im Portal der CA verlangt, und ein CA-Status pending, solange die CA die Validierung der bürgenden Organisation für S/MIME nicht abgeschlossen hat. In CertCentral listet GET organization/{id}/validation dann eine Validierung vom Typ smime mit dem Status pending; die CA schließt sie ab, mit dem, was das Portal von der Organisation verlangt.
10.1.17. Nachrichten in failed oder timeout¶
Die meisten Fehler beenden eine Nachricht überhaupt nicht, weil an ihnen dieser Host schuld ist und nicht die Nachricht:
Eine verlorene Datenbankverbindung: Die Nachricht wird pausiert und alle 30 Sekunden erneut versucht, bis die Datenbank wieder da ist, und jeder Versuch wird unter
pepsi-dispatchprotokolliert („lost its database connection“).Jeder andere Fehler, den eine Stage meldet, etwa ein Schlüssel, eine Vorlage, eine Map oder ein Vertrauensspeicher, die sich nicht lesen lassen, ein Helper, der sich nicht starten lässt, eine abgelehnte Datenbankanweisung oder ein Dienst, der nicht antwortet: Die Nachricht bleibt an ihrer Stage
paused, mit dem Fehler instate.last_error. Sie wird nach einer Minute erneut versucht, dann in sich verdoppelnden Abständen bis zu einer Stunde, und zwar für dasMAX_LIFETIMEder Stage (120 Stunden, sofern nicht anders konfiguriert). Die Stage protokolliert jede Wiederholung („failed at stage ‚…‘ (attempt N); retrying in …s“). Beheben Sie die Ursache, und die Warteschlange leert sich von selbst;pepsi-statuszeigt die wartenden Nachrichten in der Zwischenzeit an. LäuftMAX_LIFETIMEab, geht die Nachricht an dieBOUNCE_STAGEder Stage, deren DSN dem Absender mitteilt, dass ein lokaler Fehler fortbestand.Eine Stage, deren Konfiguration sich nicht mehr parsen lässt, startet gar nicht erst: Der Dispatcher protokolliert „the worker refused to start“, behält die Nachrichten in der Warteschlange und versucht es alle paar Sekunden erneut. Die eigene Log-Zeile der Stage sagt, was nicht stimmt.
Ein Worker, der abstürzt oder über
MAX_RUNTIMEhinaus hängt, pausiert die Nachricht, an der er gearbeitet hat, und versucht sie eine Minute später erneut; erst beim dritten Mal wird die Nachricht aufgegeben. In einer Zustell-Stage wird ein beiMAX_RUNTIMEbeendeter Worker stattdessen bisMAX_LIFETIMEwiederholt.Eine DSN mit dem Betreff „Outcome Unknown“ stammt von der LMTP-Zustellung: Der MDA hat die Nachricht dreimal angenommen, ohne rechtzeitig zu antworten, daher kann er bis zu drei Kopien enthalten. Suchen Sie nach einem langsamen Sieve-Programm oder einem überlasteten MDA, und erhöhen Sie
DATA_TIMEOUTund dasMAX_RUNTIMEdieser Stage, wenn er nur langsam ist.Ein Milter, der eine Nachricht immer wieder zurückstellt oder nicht erreichbar ist, hält sie ebenfalls für
MAX_LIFETIMEfest und bounct sie dann (oder belässt siefailed); er verwirft sie nie über dasREJECT_STAGEdes Filters. Ein Milter, der nur einige Empfänger zurückstellt, hält nur deren Kopie fest, als eigenepaused-Nachricht in der Milter-Stage, während die übrigen zugestellt werden.
Eine Nachricht endet nur dann in failed, wenn eine Stage einen Mangel in der Nachricht selbst gefunden hat, wenn einer Stage ohne BOUNCE_STAGE die Wiederholungen ausgegangen sind oder wenn die Nachricht ihren Worker dreimal zum Absturz gebracht hat. In timeout endet sie, wenn sie ihren Worker dreimal hat hängen lassen. state.failure_class und state.last_error sagen, welches davon und warum.
Zustellfehler vom nächsten Server (ein ablehnender oder nicht erreichbarer MX, eine DNS-Abfrage mit Zeitüberschreitung) werden von den Relay-Stages selbst auf dieselbe Weise erneut versucht. Eine fehlgeschlagene Nachricht erneut zu versuchen, lohnt sich dennoch oft, sobald die Ursache behoben ist.
pepsi.target führt alle zehn Minuten pepsi-failure-bouncer --once aus (pepsi-failure-bouncer.timer). Es verschiebt jede Nachricht, die seit [pepsi-failure-bouncer] MIN_AGE (eine Stunde, sofern nicht anders konfiguriert) in failed oder timeout ist, zu der Stage, die [pepsi-failure-bouncer] BOUNCE_STAGE benennt (bounce in der ausgelieferten Konfiguration und in der des Assistenten), und protokolliert jede Nachricht mit dem Grund. Diese Stage schickt dem Absender eine Zustellungsstatusbenachrichtigung, wie es sein NOTIFY verlangt. Ein Absender, dessen Domain die Nachricht nicht authentifiziert hat, erhält unter BOUNCE_UNAUTHENTICATED = drop keine Benachrichtigung, und die Nachricht wird gelöscht, mit einer Warnung im Log der Bounce-Stage. Die Kopie eines Mailinglisten-Beitrags wird gelöscht statt gebounct. Eine gescheiterte Nachricht bleibt also etwa MIN_AGE lang in der Warteschlange; um sie erneut zu versuchen statt sie zu bouncen, handeln Sie innerhalb dieser Zeit:
pepsi-queue list --status failed # which messages, at which stage
pepsi-queue list 1234 --state-only # why: state.last_error, state.bounce, …
pepsi-queue set-stage 1234 relay # retry it from a stage of your choice
pepsi-failure-bouncer --once # or bounce all of them now
pepsi-queue delete 1234 # or discard it
Die Optionen von list stehen nach dem Wort list. systemctl list-timers pepsi-failure-bouncer.timer zeigt, wann der nächste Durchlauf stattfindet, und journalctl -u pepsi-failure-bouncer, wie viele Nachrichten jeder Durchlauf verschoben hat.
10.1.18. Gescheiterte Nachrichten zur Diagnose aufbewahren¶
Auf einem Entwicklungs- oder Testrechner ist eine gescheiterte Nachricht meist genau das, was Sie sich ansehen möchten, und ein Bounce eine Stunde später vernichtet sie. Erhöhen Sie MIN_AGE oder schalten Sie den Durchlauf dort ab:
systemctl mask --now pepsi-failure-bouncer.timer
mask statt disable: pepsi.target verlangt den Timer, daher startet ein lediglich deaktivierter oder angehaltener Timer mit dem Target wieder. Gescheiterte Nachrichten bleiben dann in der Warteschlange, bis Sie sie wie oben erneut versuchen, bouncen oder löschen. Um den Durchlauf wieder einzuschalten:
systemctl unmask pepsi-failure-bouncer.timer
systemctl start pepsi-failure-bouncer.timer
Der nächste Durchlauf bounct dann alles, was in der Zwischenzeit gescheitert ist; löschen Sie vorher, was nicht gebounct werden soll. Lassen Sie den Timer auf einem Server, der echte Mail verarbeitet, nicht maskiert: Über eine gescheiterte Nachricht erfährt dann niemand etwas, weder der Absender noch Sie, es sei denn, Sie beobachten problem_total (siehe Überwachung).
pepsi-failure-bouncer kann stattdessen als Dienst laufen, der jede gescheiterte Nachricht sofort bounct. Für diesen Modus wird keine Unit ausgeliefert; maskieren Sie den Timer, bevor Sie ihn aus einer eigenen Unit starten.
10.1.19. Keine Core-Datei nach einem Absturz¶
pepsi-httpd, pepsi-keys, pepsi-config export/import und pepsi-setup apply halten langlebige Geheimnisse (den Schlüsselverschlüsselungsschlüssel und die privaten Schlüssel, die er entpackt, den Secure-Link-Pepper, Prüfungen von Administratorpasswörtern, ein Archivpasswort). Sie markieren sich beim Start als nicht dumpbar, und ihre systemd-Units setzen LimitCORE=0: Ein Absturz hinterlässt die Panic-Meldung und den Backtrace im Journal (RUST_BACKTRACE=1 in einem Drop-in fügt die Frames hinzu), aber keine Core-Datei, und ein anderer Prozess desselben Kontos kann keinen Debugger anhängen. Die setuid-Programme pepsi-stage-encrypt und pepsi-stage-decrypt sind aus demselben Grund nicht dumpbar. Es gibt keine Option, das abzuschalten; um einen solchen Absturz zu untersuchen, reproduzieren Sie ihn auf einem Testhost mit einem eigenen Build, der als root unter einem Debugger läuft.
10.2. Häufig gestellte Fragen¶
- Führt Pepsi ein Protokoll darüber, wer wem gemailt hat?
Standardmäßig nicht. Eine zugestellte Nachricht wird aus der Warteschlange gelöscht, und nur das Journal erwähnt sie.
[pepsi] MAIL_LOGschaltet einen Eintrag je Nachricht ein; lesen Sie zuerst die Warnung in pepsi.conf(5).- Wo ist die Warteschlange?
In PostgreSQL, Tabelle
pepsi.workqueue.pepsi-queueundpepsi-statussind die unterstützten Wege, sie anzusehen; ein einfachesSELECTfunktioniert ebenfalls.- Wie sehe ich die Pipeline, die dieser Host betreibt?
pepsi-config dumpgibt die effektive Konfiguration aus (--originzeigt zusätzlich, welche Einstellungen die Datenbank überschreibt), undpepsi-setup rungibt für jede Domain aus, wie Empfänger geprüft werden. Der Assistent erklärt die Pipelines, die der Assistent aufbaut.- Kann ich zum vorherigen Release zurückkehren?
Nicht an Ort und Stelle: Das Schema wird nur vorwärts migriert. Stellen Sie die vor dem Upgrade angelegte Sicherung wieder her und installieren Sie dann die älteren Pakete; siehe Upgrade.
- Kann Pepsi neben Postfix oder Exim laufen?
Nicht beide auf Port 25. Pepsi kann die Konfiguration des anderen Servers importieren; siehe Installation.
- Warum zeigt die Konsole alles schreibgeschützt an?
Das Paket
pepsi-httpd-admin, das die Änderungen der Konsole ausführt, ist nicht installiert, oder sein Socket läuft nicht; siehe Debian-Pakete.
10.3. Deinstallation¶
Debian-Pakete. apt remove pepsi hält die Dienste an und entfernt die Programme; Konfiguration, Schlüssel, die Datenbank und die Dienstkonten bleiben, sodass eine spätere Installation dort weitermacht, wo sie aufgehört hat. apt purge pepsi entfernt den Rest dessen, was das Paket installiert hat, behält aber absichtlich weiterhin die Konfiguration, die Datenbank, die Schlüssel, die Wallets und die Konten und gibt die Befehle aus, die sie entfernen. Diese lauten, als root:
runuser -u postgres -- dropdb pepsi
rm -rf /var/pepsi /var/lib/pepsi-wallets /etc/pepsi \
/var/lib/pepsi-dkim /var/lib/pepsi-dkim-public
for u in pepsi pepsi-ingress pepsi-httpd pepsi-owner pepsi-config \
pepsi-helper-token-refresh pepsi-keydisc pepsi-crypto \
pepsi-whitelist pepsi-wallets pepsi-dkim; do deluser "$u"; done
for g in pepsi-maildir pepsi-forward pepsi-token pepsi-admin \
pepsi-telemetry; do delgroup "$g"; done
Die gleichnamigen Datenbankrollen können danach mit dropuser entfernt werden. Entfernen Sie pepsi-telemetry und pepsi-httpd-admin auf dieselbe Weise, falls sie installiert sind.
Installation aus den Quellen. Halten Sie pepsi.target an und deaktivieren Sie es, und führen Sie dann make uninstall mit demselben PREFIX/DESTDIR aus, mit dem Sie installiert haben. Es entfernt die Programme, die mitgelieferten Daten und die systemd-Units, nicht aber Konfiguration, Schlüssel oder Datenbank; entfernen Sie diese wie oben.
Warnung
Alles, was auf diese Weise entfernt wird, ist endgültig weg, einschließlich des Schlüsselverschlüsselungsschlüssels, ohne den sich die gespeicherten privaten Schlüssel nicht öffnen lassen. Legen Sie zuerst eine Sicherung an (Sicherung und Wiederherstellung), falls Sie die Schlüssel, die Mailinglisten oder ihr Archiv möglicherweise noch einmal brauchen.