10. Dépannage¶
Commencez par deux commandes ; la plupart des problèmes apparaissent dans l’une d’elles :
pepsi-status
journalctl -u 'pepsi-*' -p warning --since '1 hour ago'
Exploiter Pepsi explique les journaux et ce que rapporte pepsi-status. Les problèmes ci-dessous sont ceux que les premiers déploiements ont rencontrés le plus souvent.
10.1. Problèmes courants¶
10.1.1. Aucun courrier n’arrive¶
Un autre MTA occupe le port 25. Debian en installe un par défaut.
systemctl start pepsi.targetéchoue alors, etsystemctl status pepsi-ingress.socketafficheResult: resources.ss -ltnp 'sport = :25'nomme le programme ; arrêtez-le et désactivez-le (voir Installation, « Migrer depuis un serveur de messagerie existant »).Le DNS ou le pare-feu. L’enregistrement
MXdu domaine doit nommer cet hôte et le port 25 doit être ouvert depuis Internet.pepsi-setup -c /etc/pepsi/pepsi.conf runaffiche les enregistrements qu’il attend et vérifie ceux qui sont publiés.Pepsi refuse le message. Le serveur de l’expéditeur reçoit la raison, tout comme le journal de
pepsi-ingress. Les raisons habituelles sont550 5.1.1pour une adresse vers laquelle rien sur cet hôte ne remet (voirVERIFY_RECIPIENTSdans pepsi-ingress(1)) ;550pour un échec DMARC certain sousDMARC_ENFORCE;554 5.6.0pour une structure MIME qui n’admet pas une seule lecture correcte, par exemple une frontière vide, un NUL dans un en-tête MIME, des champs dupliqués contradictoires ou une frontière d’encoded-word (MIME_ANOMALIES = logaccepte alors le message et enregistre l’anomalie ; le journal nomme la catégorie) ; et452 4.3.1lorsque la file d’attente ou le disque est plein (voirMAX_QUEUE_ROWSetMIN_FREE_SPACEdans pepsi.conf(5)).Un filtre l’a mis en quarantaine. Le message a été accepté et attend à une étape de quarantaine, sans que personne en soit averti.
pepsi-queue quarantine listl’affiche avec le filtre qui l’y a envoyé et la raison ;pepsi-queue quarantine release TOKENle laisse passer (Courrier en quarantaine).
10.1.2. Le courrier sortant n’est pas remis¶
pepsi-status liste les messages en attente à chaque étape. Les messages qui restent paused à une étape de relais sont en cours de nouvelle tentative ; pepsi-queue list ID --state-only montre la dernière réponse du serveur distant. Causes courantes :
Le port 25 sortant est bloqué. De nombreux hébergeurs et fournisseurs d’accès résidentiels le bloquent. Relayez plutôt via un smarthost (
pepsi-setup --wizard).Le serveur destinataire rejette le courrier ou le classe comme spam. Vérifiez que les enregistrements SPF, DKIM et DMARC qu’affiche
pepsi-setup runsont publiés, et que l’adresse de l’hôte a un nom DNS inverse correspondant à[pepsi-ingress] HOSTNAME.Des messages attendent à l’étape de signature DKIM ou ARC. Les étapes de signature demandent chaque signature à
pepsi-dkimet réessaient tant qu’il ne répond pas ; la dernière erreur nomme la socket à laquelle elles n’ont pas pu se connecter. Vérifiezsystemctl status pepsi-dkimet son journal. Un message d’un domaine pour lequel le démon ne signe pas est au contraire refusé (l’expéditeur reçoit un rebond) : exécutezpepsi-setup run, qui transmet au démon chaque domaine de signature.DKIM échoue chez le destinataire. Le sélecteur que nomme le message (
s=dans sonDKIM-Signature) n’a pas d’enregistrement publié :pepsi-dkim statusmontre le verdict DNS de chaque clé etpepsi-dkim recordsles enregistrements à publier (Rotation des clés DKIM).L’enregistrement DANE du saut suivant ne correspond pas à son certificat.
DANE = strictest la valeur par défaut, si bien qu’un enregistrementTLSApublié qui ne correspond à rien de ce que présente le serveur diffère le message (et finit par le faire rebondir) plutôt que de l’envoyer sur un TLS non authentifié. La dernière erreur nomme l’hôte. La correction incombe au domaine destinataire ;DANE = warndans la section de l’étape de relais est la désactivation explicite (voir L’adversaire réseau).Un message chiffré attend une recherche de clé. Si la recherche DNS de la clé d’un destinataire a échoué et que le message serait sinon parti en clair, il est différé plutôt qu’envoyé en clair. L’expéditeur peut accepter le texte en clair avec
[clear-ok]dans l’objet (voir Une recherche de clé qui échoue dans le DNS).
10.1.3. Une soumission est refusée¶
Le client de messagerie affiche la raison. 550 5.7.1 signifie que l’adresse MAIL FROM ou From: n’est pas une adresse que USERNAME_MAP (ou SENDER_MAP, pour un réseau de confiance ou un certificat client) autorise ce compte à utiliser. 550 5.6.0 signifie que le message n’a pas de From: utilisable (aucun, plusieurs, uniquement un groupe, ou une boîte aux lettres sans adresse complète). Ce code peut aussi signifier que le nom affiché du From: contient une autre adresse que la sienne ; beaucoup de clients afficheraient cette adresse à la place de la vraie. Voir Fonctionnalités prises en charge (« Soumission de messages »).
Si la connexion d’un client de messagerie (SMTP AUTH) prend vingt secondes ou échoue avec 454 4.7.0, le compte a accumulé ACCOUNT_AUTH_FAILURES_PER_HOUR tentatives AUTH échouées, toutes sources confondues (le journal indique « AUTH for “…” delayed »). Les tentatives qui viennent de réseaux depuis lesquels le compte ne s’est pas encore connecté attendent alors ACCOUNT_AUTH_DELAY, une à la fois. Quelqu’un essaie de deviner le mot de passe du compte ; le titulaire entre toujours après le délai, et immédiatement depuis un réseau depuis lequel il s’est déjà connecté.
10.1.4. La console d’administration refuse un mot de passe¶
Un 429 (ou la page de connexion qui répond « trop de tentatives ») sur un compte que personne n’utilise signifie que quelqu’un a épuisé son LOGIN_DAILY_LIMIT de connexions échouées (auth.login.ceiling dans le journal d’audit) ; ce quota se reconstitue au cours de la journée. Pour un compte doté d’un second facteur, un code manquant, erroné ou verrouillé reçoit exactement la même réponse qu’un mauvais mot de passe. Il en va de même lorsque l’applicateur n’est pas installé ou ne répond pas ; le auth.login.second-factor-refused du journal d’audit indique lequel de ces cas s’est produit. La socket locale n’exige pas de mot de passe : pepsi-keys otp reset --console LOGIN efface un second facteur verrouillé ou perdu, et PATCH /api/v1/accounts/{id} définit un nouveau mot de passe.
10.1.5. Un message a rebondi avec 5.7.30 ou 5.7.10¶
Le message a été marqué REQUIRETLS par son expéditeur (RFC 8689), et ni un hôte MX du domaine destinataire ni le smarthost configuré n’a pu le prendre sous cette exigence. 5.7.30 signifie que le saut n’annonce pas REQUIRETLS après STARTTLS. 5.7.10 signifie qu’il n’y avait pas de TLS validé vers lui : pas de STARTTLS, un certificat qui échoue à DANE ou PKIX, un domaine dont ni DNSSEC ni une politique MTA-STS ne valide les hôtes MX, ou une entrée de smarthost avec MODE = plain. Rien n’est mal configuré sur cet hôte, sauf si DANE = off masque la validation d’un domaine signé par DNSSEC, ou si un smarthost qui pourrait offrir l’extension ne le fait pas. L’expéditeur a demandé une protection que le chemin ne peut pas donner, et le rebond (en-têtes seulement) le lui dit. Voir Exiger TLS pour un message (RFC 8689).
10.1.6. pepsi-ingress ne démarre pas après une modification de la configuration¶
Le journal en nomme la raison. Une entrée MYNETWORKS hors loopback que [pepsi-ingress] SENDER_MAP ne couvre pas est refusée, car chaque hôte de ce réseau pourrait envoyer au nom de n’importe quelle adresse et faire signer le message pour chaque domaine servi. Ajoutez une ligne <network> <addresses> à la table (* autorise le comportement sans restriction, par choix délibéré), ou retirez l’entrée. pepsi-setup -c /etc/pepsi/pepsi.conf validate signale le même refus sans rien redémarrer. Voir pepsi-ingress(1), Sender bindings.
10.1.7. sendmail ou le courrier de cron échoue avec « temporary failure »¶
pepsi-sendmail remet le courrier à pepsi-ingress via /run/pepsi/submission.sock et se termine avec le code 75 (échec temporaire) lorsque personne n’y répond. Vérifiez que pepsi.target tourne. Si /run/pepsi a été supprimé à la main, systemd-tmpfiles --create le recrée avec les bonnes permissions ; redémarrez ensuite pepsi-ingress.
10.1.8. Un programme se termine avec le code 78¶
Le schéma de la base de données n’est pas celui avec lequel le programme a été construit, typiquement dans les minutes qui suivent une mise à niveau, avant que pepsi-setup schema n’ait été exécuté. Le message indique le remède ; Mise à niveau contient le tableau des cas. Les services réessaient d’eux-mêmes et reviennent dès que le schéma correspond.
10.1.9. « permission denied » de la part de la base de données¶
Les droits des rôles de la base de données sont fixés par pepsi-setup. Après la restauration d’une base de données, ou après avoir modifié des rôles à la main, exécutez à nouveau pepsi-setup -c /etc/pepsi/pepsi.conf run.
10.1.10. Un destinataire S/MIME voit un message vide¶
Son client ne sait pas lire AuthEnvelopedData (AES-256-GCM). Thunderbird, par exemple, ne le sait pas, et affiche un message vide au lieu d’une erreur. Pepsi envoie ce format à chaque destinataire S/MIME pour lequel il n’a pas d’enregistrement de capacités. Le premier de ces messages porte, à côté du texte chiffré, un avis en clair. Cet avis demande au destinataire de signaler exactement ce problème et de répondre par un message signé (Ce que voit un correspondant utilisant un client non mesuré). Le premier message signé d’un correspondant enregistre automatiquement les capacités de son client ; d’ici là, configurez l’enregistrement à la main
pepsi-keys -c /etc/pepsi/pepsi.conf peer capability set alice@example.org cbc
peer capability list --address alice@example.org montre ce qui est enregistré, et le state.crypto.out du message nomme le conteneur qui est parti. Voir L’enregistrement de capacités S/MIME par pair.
10.1.11. Une clé servie est signalée comme ne correspondant pas, ou WKD comme en échec¶
pepsi-setup check, pepsi-status et pepsi-keys identity list --served récupèrent ce que le Web Key Directory et le DNS servent pour chaque identité publiée (Vérifier ce qui est réellement servi). Un MISMATCH nomme le canal et l’empreinte étrangère :
WKD (direct) – l’apex du domaine est servi par un autre serveur web (un CMS, un CDN) qui a son propre
/.well-known/openpgpkey/. Supprimez ce répertoire à cet endroit, ou faites relayer par l’apex/.well-known/openpgpkey/verspepsi-httpd.OPENPGPKEY ou SMIMEA – la zone contient encore un enregistrement pour une identité renouvelée ou révoquée, ou un enregistrement ajouté par quelqu’un d’autre. Remplacez-le par ce qu’affiche
pepsi-keys dns ADDRESS.WKD (advanced) –
openpgpkey.<domain>pointe vers un hôte qui n’est pas celui-ci.
Tant que ce n’est pas corrigé, les correspondants qui recherchent l’adresse risquent de chiffrer vers cette clé. Un canal WKD en FAILED avec « refusing to connect » nomme un hôte qui se résout en une adresse privée ou de loopback ; le client refuse une telle adresse, comme le fait toute récupération de clé. Si un canal WKD expire sur un hôte derrière un NAT, cela signifie en général que le routeur ne renvoie pas vers cet hôte sa propre adresse publique. Dans aucun des deux cas, un correspondant ne voit le même résultat : vérifiez donc depuis l’extérieur avant de changer quoi que ce soit.
10.1.12. Le résolveur « ne valide pas » DNSSEC¶
Les workers de relais et pepsi-keydisc@dane journalisent cet avertissement au démarrage, et pepsi-status l’affiche dans sa section « DNSSEC resolver ». Il signifie que le résolveur qui y est nommé (/etc/resolv.conf, [pepsi] DNS_SERVERS, ou le DNS_SERVERS d’une étape) a répondu à une requête pour le domaine signé ietf.org sans le bit AD de DNSSEC. Pepsi se fie à ce bit au lieu de valider lui-même, si bien que chaque recherche DANE ne trouve rien : le DANE sortant ne s’applique jamais et la découverte de clés DANE ne trouve aucune clé, bien que rien n’échoue. Les causes typiques sont un résolveur de FAI ou de DHCP écrit dans resolv.conf après la configuration, ou systemd-resolved sans DNSSEC=yes. Pour corriger cela, faites pointer resolv.conf (ou DNS_SERVERS) vers un résolveur validant sur cet hôte, comme unbound (Installation), ou nommez un résolveur validant de confiance sous forme d’entrée tls:// ou https:// de [pepsi] DNS_SERVERS, et confirmez avec pepsi-status. Vous pouvez aussi positionner DANE = off là où DANE n’est pas souhaité. « Could not be established » signifie que la sonde n’a reçu aucune réponse. Vérifiez que le résolveur est joignable ; pour une entrée chiffrée, vérifiez que son port est ouvert et que son certificat est valide pour le nom qui suit #.
10.1.13. Le résolveur « n’est pas sur cet hôte »¶
Les workers DANE journalisent « trusts the DNSSEC AD bit from … which is not on this host and is reached over plain DNS », et pepsi-status et pepsi-setup run nomment les mêmes résolveurs. Le bit AD que portent ces réponses voyage sans protection, si bien que n’importe qui sur le chemin peut le positionner sur un enregistrement TLSA, OPENPGPKEY ou SMIMEA falsifié. Faites soit tourner un résolveur validant sur cet hôte (unbound, systemd-resolved avec DNSSEC=yes), soit joindre un résolveur validant de confiance par un canal authentifié : [pepsi] DNS_SERVERS = tls://192.0.2.53#dns.example.net (DNS sur TLS) ou https://…#NAME (DNS sur HTTPS), avec le nom pour lequel son certificat est émis. Une liste ne peut pas mélanger entrées en clair et entrées chiffrées.
10.1.14. Les destinataires voient ... comme objet du courrier chiffré¶
[stage-encrypt] PROTECT_HEADERS = yes (la valeur par défaut est no) déplace le vrai Subject: et les autres champs RFC 5322 dans la partie chiffrée et signée, et l’objet extérieur se lit .... Un client qui affiche les en-têtes protégés (Thunderbird, par exemple) montre le vrai objet ; un client qui ne le fait pas montre le texte de substitution. Là où les clients de la plupart des destinataires sont de la seconde sorte, retirez le réglage ou positionnez PROTECT_HEADERS = no dans la section de l’étape de chiffrement (ou par expéditeur au moyen de pepsi-settings). La signature ne couvre alors plus To: et Cc: pour les clients qui ignorent l’attribut de destinataires propre à Pepsi (À qui était destiné un message signé et chiffré).
10.1.15. Un message d’un expéditeur S/MIME a disparu au lieu de rebondir¶
Avec ON_DECRYPT_FAILURE = bounce-if-unproblematic, ON_BAD_SIGNATURE = bounce ou le ON_NO_CLIENT_KEY = bounce de l’étape de rechiffrement, un message arrivé sous forme d”EnvelopedData AES-CBC est abandonné, et non renvoyé en rebond, car le rebond indiquerait à son expéditeur si un texte chiffré éventuellement modifié a pu être ouvert. Le journal le dit (dropped rather than bounced) et la télémétrie compte decrypt-dropped. passthrough, record et plaintext remettent au contraire un tel message (Les rebonds et les réponses au courrier chiffré).
10.1.16. Le certificat qu’un utilisateur attend de l’AC n’arrive pas¶
Regardez d’abord les commandes de l’utilisateur
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
L’absence de toute commande signifie que l’utilisateur ne doit pas recevoir de certificat : sous first-send, il n’a pas encore envoyé de courrier par le serveur (ou seulement depuis l’extérieur) ; sous manual, personne ne l’a sélectionné (mpki user set ADDRESS --select yes) ; ou sa sélection est no. Vérifiez aussi que le domaine est activé (mpki domain show DOMAIN). Une commande held nomme son motif :
name-unconfirmedLe nom vient du nom affiché du premier message de l’utilisateur, et le domaine attend qu’un administrateur confirme de tels noms. Vérifiez-le dans
mpki user list(marqué?), puis lancezmpki user set ADDRESS --confirm, ou corrigez-le avec--given-name/--surname. La passe suivante libère la commande.name-missingLe nom affiché ou l’entrée d’annuaire n’a donné ni prénom ni nom de famille (un mot unique, une adresse, rien). Saisissez les deux avec
mpki user set, ou importez l’utilisateur depuis l’annuaire.daily-limitLes nouveaux enrôlements du domaine au cours des dernières 24 heures ont atteint sa limite quotidienne. Vérifiez que les commandes sont bien celles que vous attendez (l’import du mauvais fichier ou un script qui envoie au nom de nombreuses adresses se voit ici), puis libérez-les une par une avec
mpki order release ID, ou relevez la limite (mpki domain set DOMAIN --daily-limit N) et libérez-les.no-licenceLe compte d’AC n’a pas de licence d’abonnement libre pour l’adresse : l’AC a répondu
insufficient_subscription. Pepsi ne peut pas en acheter. Ajoutez une licence dans le portail de l’AC (ou libérez-en une en y retirant de l’abonnement l’adresse d’un utilisateur parti), puis lancezmpki order release ID. Une révocation ne libère pas à elle seule une licence.no-credentialLe domaine n’a pas de
secrets.d/mpki-<domain>.secretlisible. Stockez la clé d’API avecmpki credential set DOMAINet lancezmpki domain check DOMAIN; la passe suivante libère la commande.
Une commande failed montre le motif sous last error. Un refus de l’AC (HTTP 4xx avec le message de l’AC) est généralement un réglage que mpki domain check DOMAIN signale aussi : une clé d’API que l’AC n’accepte pas, un produit qui manque au compte, plusieurs organisations sans --organization-id, ou un domaine qui n’est pas validé dans le compte. Un utilisateur qui doit toujours recevoir un certificat obtient une nouvelle commande un jour après la commande échouée : tant que la cause n’est pas corrigée, chacun de ces utilisateurs coûte donc une commande échouée et un avis par jour. Une fois la cause corrigée, mpki order retry ID réessaie dès la passe suivante plutôt que le lendemain. « the certificate does not name … » ou « is not over the key » signifie que l’AC a renvoyé un certificat que Pepsi refuse d’installer ; signalez-le à l’AC. Une commande qui reste submitted attend chez l’AC, et mpki order list --json montre l’état propre de l’AC (ca_status). Pepsi continue de demander, au plus une fois par heure, et installe le certificat dès qu’il est délivré ; rien ici ne peut accélérer cela. Les causes typiques sont une approbation que le compte exige dans le portail de l’AC, et un état pending de l’AC tant qu’elle n’a pas fini de valider pour S/MIME l’organisation qui parraine les certificats. Dans CertCentral, GET organization/{id}/validation liste alors une validation de type smime à l’état pending ; l’AC la mène à bien, avec ce que le portail demande à l’organisation.
10.1.17. Messages en failed ou timeout¶
La plupart des erreurs ne mettent pas du tout fin à un message, car elles sont imputables à cet hôte plutôt qu’au message :
Une connexion à la base de données perdue : le message est mis en pause et réessayé toutes les 30 secondes jusqu’au retour de la base de données, et chaque réessai est journalisé sous
pepsi-dispatch(« lost its database connection »).Toute autre erreur signalée par une étape, par exemple une clé, un modèle, une table ou un magasin de confiance qui ne peut être lu, un helper qui ne peut être démarré, une instruction de base de données refusée ou un service qui ne répond pas : le message reste
pausedà son étape avec l’erreur dansstate.last_error. Il est réessayé après une minute, puis à des intervalles qui doublent jusqu’à une heure, pendant leMAX_LIFETIMEde l’étape (120 heures sauf configuration contraire). L’étape journalise chaque réessai (« failed at stage “…” (attempt N); retrying in …s »). Corrigez la cause et la file se vide d’elle-même ;pepsi-statusmontre entre-temps les messages en attente. LorsqueMAX_LIFETIMEest écoulé, le message part vers leBOUNCE_STAGEde l’étape, dont le DSN indique à l’expéditeur qu’une erreur locale a persisté.Une étape dont la configuration ne s’analyse plus ne démarre pas du tout : le dispatcher journalise « the worker refused to start », garde les messages en file et réessaie toutes les quelques secondes. La ligne de journal propre à l’étape dit ce qui ne va pas.
Un worker qui plante ou se bloque au-delà de
MAX_RUNTIMEmet en pause le message qu’il traitait et le réessaie une minute plus tard ; ce n’est qu’à la troisième fois que le message est abandonné. Dans une étape de remise, le message d’un worker tué àMAX_RUNTIMEest au contraire réessayé jusqu’àMAX_LIFETIME.Un DSN dont l’objet est « Outcome Unknown » provient de la remise LMTP : le MDA a pris le message trois fois sans répondre à temps, il peut donc en détenir jusqu’à trois copies. Cherchez un programme Sieve lent ou un MDA surchargé, et augmentez
DATA_TIMEOUTet leMAX_RUNTIMEde cette étape s’il est seulement lent.Un milter qui continue de différer un message, ou qui ne peut être joint, le retient lui aussi pendant
MAX_LIFETIME, puis le fait rebondir (ou le laissefailed) ; il ne l’abandonne jamais via leREJECT_STAGEdu filtre. Un milter qui ne diffère que certains destinataires ne retient que leur copie, sous la forme d’un messagepauseddistinct à l’étape du milter, tandis que les autres sont remis.
Un message ne finit en failed que lorsqu’une étape a trouvé un défaut dans le message lui-même, lorsqu’une étape sans BOUNCE_STAGE a épuisé ses réessais, ou lorsque le message a fait planter son worker trois fois. Il finit en timeout lorsqu’il a bloqué son worker trois fois. state.failure_class et state.last_error disent lequel et pourquoi.
Les erreurs de remise venant du serveur suivant (un MX qui refuse ou est injoignable, une recherche DNS qui expire) sont réessayées de la même manière par les étapes de relais elles-mêmes. Un message en échec vaut encore souvent la peine d’être réessayé une fois la cause corrigée.
pepsi.target exécute pepsi-failure-bouncer --once toutes les dix minutes (pepsi-failure-bouncer.timer). Il déplace chaque message qui est failed ou timeout depuis [pepsi-failure-bouncer] MIN_AGE (une heure sauf configuration contraire) vers l’étape que nomme [pepsi-failure-bouncer] BOUNCE_STAGE (bounce dans la configuration livrée et dans celle de l’assistant), et journalise chaque message avec la raison. Cette étape envoie à l’expéditeur une notification d’état de remise selon ce que demande son NOTIFY. Un expéditeur dont le message n’a pas authentifié le domaine ne reçoit aucune notification sous BOUNCE_UNAUTHENTICATED = drop, et le message est supprimé, avec un avertissement dans le journal de l’étape de rebond. Une copie d’une contribution à une liste de diffusion est supprimée plutôt que renvoyée en rebond. Ainsi, un message en échec reste environ MIN_AGE dans la file ; pour le réessayer plutôt que de le faire rebondir, agissez dans ce délai :
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
Les options de list se placent après le mot list. systemctl list-timers pepsi-failure-bouncer.timer indique quand aura lieu le prochain balayage, et journalctl -u pepsi-failure-bouncer combien de messages chacun a déplacés.
10.1.18. Conserver les messages en échec pour le diagnostic¶
Sur une machine de développement ou de test, un message en échec est généralement précisément ce que vous voulez examiner, et un rebond une heure plus tard le détruit. Augmentez MIN_AGE, ou désactivez-y le balayage :
systemctl mask --now pepsi-failure-bouncer.timer
mask plutôt que disable : pepsi.target requiert le timer, de sorte qu’un timer simplement désactivé ou arrêté redémarre avec la cible. Les messages en échec restent alors dans la file jusqu’à ce que vous les réessayiez, les fassiez rebondir ou les supprimiez comme ci-dessus. Pour réactiver le balayage :
systemctl unmask pepsi-failure-bouncer.timer
systemctl start pepsi-failure-bouncer.timer
Le balayage suivant fait alors rebondir tout ce qui a échoué entre-temps ; supprimez d’abord ce que vous ne voulez pas voir rebondir. Ne laissez pas le timer masqué sur un serveur qui traite du vrai courrier : personne n’est informé d’un message en échec, ni l’expéditeur ni vous, à moins que vous ne surveilliez problem_total (voir Surveillance).
pepsi-failure-bouncer peut aussi s’exécuter comme un service qui fait rebondir chaque message en échec au moment où l’échec survient. Aucune unité n’est livrée pour ce mode ; masquez le timer avant de le lancer depuis votre propre unité.
10.1.19. Pas de fichier core après un plantage¶
pepsi-httpd, pepsi-keys, pepsi-config export/import et pepsi-setup apply détiennent des secrets de longue durée (la clé de chiffrement de clés et les clés privées qu’elle déballe, le poivre du lien sécurisé, les vérifications de mots de passe d’administrateur, un mot de passe d’archive). Ils se marquent eux-mêmes comme non vidables au démarrage, et leurs unités systemd positionnent LimitCORE=0 : un plantage laisse le message de panique et la trace d’appels dans le journal (RUST_BACKTRACE=1 dans un fichier drop-in ajoute les trames), mais aucun fichier core, et un autre processus du même compte ne peut pas y attacher de débogueur. Les pepsi-stage-encrypt et pepsi-stage-decrypt setuid sont non vidables pour la même raison. Il n’existe pas d’option pour désactiver cela ; pour examiner un tel plantage, reproduisez-le sur un hôte de test avec une version que vous avez construite vous-même, exécutée sous un débogueur en tant que root.
10.2. Questions fréquentes¶
- Pepsi tient-il un journal de qui a écrit à qui ?
Pas par défaut. Un message remis est supprimé de la file d’attente et seul le journal le mentionne.
[pepsi] MAIL_LOGactive un enregistrement par message ; lisez d’abord l’avertissement dans pepsi.conf(5).- Où se trouve la file d’attente ?
Dans PostgreSQL, table
pepsi.workqueue.pepsi-queueetpepsi-statussont les moyens pris en charge pour l’examiner ; un simpleSELECTfonctionne aussi.- Comment voir le pipeline que cet hôte exécute ?
pepsi-config dumpaffiche la configuration effective (--originmontre aussi quels réglages la base de données surcharge), etpepsi-setup runaffiche, pour chaque domaine, comment les destinataires sont vérifiés. L’assistant explique les pipelines que construit l’assistant.- Puis-je revenir à la version précédente ?
Pas sur place : le schéma n’est migré que vers l’avant. Restaurez la sauvegarde prise avant la mise à niveau, puis installez les paquets plus anciens ; voir Mise à niveau.
- Pepsi peut-il tourner à côté de Postfix ou d’Exim ?
Pas tous deux sur le port 25. Pepsi peut importer la configuration de l’autre serveur ; voir Installation.
- Pourquoi la console affiche-t-elle tout en lecture seule ?
Le paquet
pepsi-httpd-admin, qui exécute les modifications de la console, n’est pas installé ou sa socket ne tourne pas ; voir Paquets Debian.
10.3. Désinstallation¶
Paquets Debian. apt remove pepsi arrête les services et supprime les programmes ; la configuration, les clés, la base de données et les comptes de service restent, de sorte qu’une installation ultérieure reprend là où elle s’était arrêtée. apt purge pepsi supprime le reste de ce que le paquet a installé mais, à dessein, conserve toujours la configuration, la base de données, les clés, les portefeuilles et les comptes, et affiche les commandes qui les suppriment. Les voici, en tant que 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
Les rôles de base de données de mêmes noms peuvent ensuite être supprimés avec dropuser. Supprimez pepsi-telemetry et pepsi-httpd-admin de la même manière s’ils sont installés.
Installation depuis les sources. Arrêtez et désactivez pepsi.target, puis exécutez make uninstall avec les mêmes PREFIX/DESTDIR que lors de l’installation. Cela supprime les programmes, les données livrées et les unités systemd, mais pas la configuration, les clés ni la base de données ; supprimez-les comme ci-dessus.
Avertissement
Tout ce qui est supprimé de cette manière disparaît définitivement, y compris la clé de chiffrement de clés sans laquelle les clés privées stockées ne peuvent pas être ouvertes. Faites d’abord une sauvegarde (Sauvegarde et restauration) s’il y a la moindre chance que vous vouliez un jour retrouver les clés, les listes de diffusion ou leur archive.