<chapter id="troubleshooting">

<chapterinfo>
<authorgroup>
<author>
<personname
><firstname
>Ce chapitre a été extrait de la page KDE UserBase <ulink url="http://userbase.kde.org/KMail/FAQs_Hints_and_Tips/fr"
>KMail/FAQ Aides et Conseils</ulink
>.</firstname
> <surname
></surname
> </personname>
      </author>
&traducteurAlviseCavallari; 
      </authorgroup>
<date
>28/07/2012</date>
      <releaseinfo
>&kde; SC 4.9</releaseinfo>
</chapterinfo>

<title
>Dépanner &kmail;</title>

<sect1 id="kmail2-doesnt-send-mail"
><title
>KMail n'envoie pas les messages</title>
<para
>Certains utilisateurs qui n'arrivent pas à envoyer de messages s'aperçoivent que &SMTP; est manquant, alors que la page de <guilabel
>Configuration</guilabel
> semble correcte. Ceci peut parfois être résolu en ouvrant <application
>akonadiconsole</application
> et en y ajoutant un <guilabel
>agent de distribution des messages</guilabel
>. </para>
<para
>Si l'ordinateur a été arrêté de manière soudaine (&pex; par une coupure de courant), les messages sortants restent parfois confinés dans la boîte d'envoi sans qu'un message d'erreur ne soit généré. Ceci peut être dû au fait que, lors de l'arrêt, l'agent de distribution des messages a été mis <quote
>hors ligne</quote
> dans son fichier de configuration et qu'il reste ainsi suite au crash. Modifiez le fichier suivant : </para>
<para
><filename
>~/.config/akonadi/agent_config_akonadi_maildispatcher_agent</filename>
</para>
<para
>et transformez </para>
<para
><screen
>[Agent]
Online=false</screen>
</para>
<para
>en </para>
<para
><screen
>[Agent]
Online=true</screen>
</para>
</sect1>
<sect1 id="clean-start-after-a-failed-migration"
><title
>Démarrage propre après un échec de migration</title>
<para
>Au cas où la migration de &kmail; 1 vers &kmail; 2 a échoué ou si ensuite vous avez des anomalies de fonctionnement, vous pouvez essayer d'effectuer une importation propre de vos données plutôt que de migrer la configuration existante. Veuillez noter que cette procédure nécessite plus de paramétrage manuel ; il vous convient donc de ne l'effectuer que si vous êtes suffisamment à l'aise pour reconfigurer vos comptes &kmail;. Veuillez aussi noter que cela peut engendrer une grande quantité de trafic pour les ressources &imap;. </para>
<orderedlist>
<listitem
><para
>Arrêtez Akonadi et les applications qui lui sont corrélées</para>
<para
>quittez &kmail;/&kontact;/&korganizer;, et saisissez cette commande : </para>
<para
><userinput
><command
>akonadictl stop</command
></userinput>
</para>
<para
>Assurez-vous qu'aucun processus <application
>Akonadi</application
> ou <application
>MySQL</application
> ne soit en cours d'exécution : </para>
<para
><userinput
><command
>ps ux | grep mysql</command
></userinput>
</para>
<para
><userinput
><command
>ps ux | grep akonadi</command
></userinput>
</para>
<para
>Ces commandes ne devraient rien afficher en plus du processus <application
>grep</application
>. </para>
</listitem>
<listitem
><para
>Supprimez l'ancienne base de données Akonadi et sa configuration</para>
<para
>Supprimez les dossiers suivants </para>
<itemizedlist>
  <listitem>
    <para>
      <filename role="directory"
>~/.local/share/akonadi</filename>
    </para>
  </listitem>
  <listitem>
    <para>
      <filename role="directory"
>~/.config/akonadi</filename>
    </para>
  </listitem>
</itemizedlist>
<para
>Supprimez aussi dans <filename role="directory"
>~/.kde4/share/config</filename
> les fichiers qui commencent par <emphasis
>akonadi</emphasis
> </para>
</listitem>
<listitem>
<para
>Redémarrez le serveur Akonadi </para>
<para
><userinput
><command
>akonadictl start</command
></userinput>
</para>
</listitem>
<listitem>
<para
>Recréez les comptes </para>
<para
>Maintenant vous pouvez recréer vos comptes. Vous pouvez utiliser pour cela soit &kmail; (&kontact;), soit l'outil <application
>akonadiconsole</application
>. </para>
<para
>Depuis &kmail; : <menuchoice
><guimenu
>Configuration</guimenu
><guisubmenu
>Configurer KMail</guisubmenu
><guimenuitem
>Comptes</guimenuitem
></menuchoice
> et faites <guilabel
>Ajouter</guilabel
>. </para>
<para
>Si vous utilisez &imap;, ajoutez un nouveau <guimenuitem
>serveur de courriels &imap;</guimenuitem
>. Si vous souhaitez pouvoir lire les mails lorsque vous êtes déconnectés, activez le mode déconnecté dans l'onglet <guilabel
>Avancé</guilabel
>. Assurez-vous que vous êtes enregistrés à tous les dossiers importants. </para>
<para
>Vous avez peut-être déjà une ressource <guilabel
>Dossier local</guilabel
>. Elle pointe vers un dossier maildir local existant. Vous pouvez soit modifier ce dossier pour qu'il pointe vers vos dossiers maildir existants, soit ajouter une nouvelle ressource pour vos messages enregistrés en local. </para>
<para
>Lorsque vous ajoutez une ressource maildir, vous avez le choix entre <guilabel
>Dossier de courriers &kmail;</guilabel
> et <guilabel
>Maildir</guilabel
>. Vous devriez choisir <guilabel
>Maildir</guilabel
>, à moins que vous ayez déjà un dossier mélangé contenant <emphasis
>aussi bien</emphasis
> des dossiers maildir que des fichiers mbox. Pour des fichiers mbox indépendants, tels que celui qui se trouve dans <filename role="directory"
>/var/spool/mail</filename
>, vous pouvez définir un nouveau dossier <emphasis
>MBox</emphasis
>. </para>
<para
>Ajoutez aussi les comptes POP3. Si vous avez plusieurs dossiers locaux définis, choisissez dans l'onglet <guilabel
>Avancé</guilabel
> le dossier de destination pour les messages nouvellement téléchargés.  </para>
<para
>Pour tous les comptes, configurez l'intervalle de vérification du courrier électronique. Pour les dossiers locaux, désactivez l'intervalle de vérification. Désactivez aussi <guilabel
>Inclure dans la vérification manuelle du courrier électronique</guilabel
> dans les <guilabel
>Options de réception</guilabel
>. </para>
<para
>Ajoutez les comptes d'expédition (SMTP) </para>
</listitem>
<listitem>
<para
>Corrigez les filtres, les identités et les dossiers favoris </para>
<para
>Si vous avez des filtres coté client (ce qui est courant avec les comptes POP3), allez dans <menuchoice
><guimenu
>Configuration</guimenu
><guimenuitem
>Configurer les filtres</guimenuitem
></menuchoice
> et corrigez le dossier de destination pour chaque filtre, car il est probablement faux. Autrement les messages risquent de se retrouver dans des dossiers imprévus. </para>
<para
>Le filtrage de pourriel ne fonctionne pas comme prévu (en tous cas dans la version 4.7.3 et les versions antérieures). En effet, la règle créée par l'assistant n'envoie pas les pourriels dans le dossier que vous avez défini. </para>
<para
>La solution de contournement est de modifier les balisages <quote
>spam</quote
> et <quote
>spam unsure</quote
> (si le filtre de spam que vous utilisez prend en charge cette dernière fonctionnalité). Plutôt que de regarder les champs d'état <literal
>X-Spam-Status</literal
> dans l'en-tête des messages, faites regarder <guimenuitem
>Partout dans les en-têtes</guimenuitem
> pour X-<replaceable
>votre filtre de pourriel</replaceable
>-Classification: <quote
>SPAM or unsure</quote
>. Vérifiez les filtres créés par l'assistant, et copiez la partie <quote
>contient</quote
>. Par exemple pour <application
>Spambayes</application
>  : <quote
>X-Spambayes-Classification: spam</quote
> et <quote
>X-Spambayes-Classification: unsure</quote
>. </para>
<para
>Vous devez aussi vérifier les paramètres d'identité et définir les dossiers de messages envoyés, de brouillons et de modèles afin qu'ils pointent vers les bons dossiers. Pour cela, allez sur <menuchoice
><guimenu
>Configuration</guimenu
><guisubmenu
>Configurer KMail</guisubmenu
><guimenuitem
>Identités</guimenuitem
></menuchoice
>, et modifiez les identités. Allez ensuite sur l'onglet <guilabel
>Avancées</guilabel
> et modifiez les paramètres des dossiers sus-mentionnés. </para>
<para
>Assurez-vous par la même occasion que vos <guilabel
>Dossiers favoris</guilabel
> sont ceux que vous avez choisis précédemment. </para>
</listitem>
<listitem>
<para
>Effectuez un contrôle des messages </para>
<para
>Relevez le courriel pour vos comptes. Il est conseillé d'effectuer le relevé compte par compte. </para>
<para
>Commencez par vérifier si vous avez &imap;. </para>
<para
>Ensuite, contrôlez (importez) vos messages locaux. Une solution est d'effectuer un contrôle complet en une seule fois : <menuchoice
><guimenu
>Fichier</guimenu
><guimenuitem
>Relever le courriel dans</guimenuitem
></menuchoice
> et choisir le compte local. Une autre solution est de cliquer sur les dossiers un par un, ce qui devrait initier le contrôle de chaque dossier cliqué. Vous pouvez également effectuer un clic droit sur le nom du dossier et sélectionner <guilabel
>Mettre à jour le dossier</guilabel
>. </para>
<para
>L'importation initiale peut prendre d'autant plus de temps et de mémoire que les dossiers possèdent de messages. Dans ce cas, un contrôle dossier par dossier est préférable. Si, lorsque le contrôle est terminé (que ce soit dossier par dossier ou un contrôle complet) l'utilisation de la mémoire est toujours élevée, vous pouvez redémarrer &mdash;comme vu précédemment&mdash;. Vous pouvez aussi redémarrer uniquement l'agent maildir en utilisant <varname
>akonadiconsole</varname
>. N'ayez crainte, l'utilisation de la mémoire ne sera élevée <emphasis
>que</emphasis
> lors de l'importation initiale. </para>
<para
>Effectuez un contrôle des messages pour vos ressources POP3. </para>
</listitem>
</orderedlist>
<para
>Normalement, après ces différentes étapes, &kmail; devrait bien fonctionner.  </para>
</sect1>

<sect1 id="local-folders-is-added-over-and-over"
><title
>Les dossiers locaux sont ajoutés continuellement</title>
<para
>Dans certains cas vous pouvez avoir un compte MAILDIR qui pointe vers un endroit donné (tel que <filename
>$HOME/Mail</filename
>), mais vous avez en même temps un dossier <guilabel
>Dossiers locaux</guilabel
> dans la liste de dossiers avec les sous-dossiers Boîte de réception / Boîte d'envoi / Corbeille / Brouillons / &etc;. &kmail; continue à mettre des messages dans ces dossiers, en particulier les messages envoyés. </para>
<para
>Le problème est que certains dossiers sont des dossiers spéciaux (dossiers système), c'est-à-dire que si vous ne les avez pas &kmail; ne peut fonctionner correctement. C'est pour cela que ces dossiers sont continuellement recréés. </para>
<para
>Actuellement il n'y a pas de méthode facile pour corriger cela, dans l'interface utilisateur, pour tous les types de dossiers spéciaux. Voici ce que vous pouvez faire : </para>
<orderedlist>
<listitem
><para
>Les dossiers <emphasis
>Messages envoyés, Brouillons et Modèles</emphasis
> sont configurables pour chaque entité. Allez sur <menuchoice
><guimenu
>Configuration</guimenu
><guisubmenu
>Configurer KMail</guisubmenu
><guimenuitem
>Identités</guimenuitem
></menuchoice
>, et sélectionnez votre identité. Cliquez <guilabel
>Modifier</guilabel
>, allez sur l'onglet <guilabel
>Avancées</guilabel
> et définissez le bon endroit que ces dossiers doivent pointer.</para
></listitem>
<listitem
><para
>La <emphasis
>Boîte de réception</emphasis
>par défaut est configurable pour chaque compte POP3. Allez sur <menuchoice
><guimenu
>Configuration</guimenu
><guisubmenu
>Configurer KMail</guisubmenu
><guimenuitem
>Comptes</guimenuitem
></menuchoice
>, sélectionnez votre compte POP3, cliquez <guilabel
>Modifier</guilabel
>, allez sur l'onglet <guilabel
>Avancées</guilabel
> et définissez le <guilabel
>Dossier de destination</guilabel
>.</para
></listitem>
<listitem
><para
>Pour les comptes IMAP vous pouvez définir le dossier <emphasis
>Corbeille</emphasis
>. Faites comme ci-dessus. </para
></listitem>
<listitem
><para
>Le plus embêtant est corriger la <emphasis
>Boîte d'envoi</emphasis
>. Commencez par trouver le fichier <filename
>specialmailcollectionsrc</filename
> dans le dossier de configuration de &kde; (<filename
>$HOME/.kde4/share/config</filename
> ou semblable). Ce fichier contient quelque chose de la sorte :</para
></listitem>
</orderedlist>
<para
><userinput
>[SpecialCollections] DefaultResourceId=akonadi_maildir_resource_0</userinput>
</para>
<para
>Maintenant démarrez <application
>akonadiconsole</application
>. Dans l'onglet <guilabel
>Agents</guilabel
>, localisez le compte pour le dossier <emphasis
>Boîte d'envoi</emphasis
>, cliquez dessus, et notez l'identifiant qui apparaît dans la partie inférieure (<replaceable
>akonadi_maildir_resource_XXX</replaceable
> ou semblable). Remplacez l'identifiant dans le fichier <filename
>specialmailcollectionsrc</filename
> précédemment décrit, et inscrivez celui-ci. </para>
<para
>Redémarrez ensuite <application
>akonadi</application
> (vous pouvez le faire depuis<application
>akonadiconsole</application
>, <menuchoice
><guimenu
>Server</guimenu
><guimenuitem
>Restart Server</guimenuitem
></menuchoice
> ou depuis la ligne de commande en saisissant : </para>
<para
><userinput
>akonadictl restart</userinput>
</para>
<para
>Maintenant supprimez les <guilabel
>Dossiers locaux</guilabel
> que vous ne voulez plus. </para>
<para
>Si ce problème continue à apparaître, et l'<guilabel
>Agent de distribution des messages</guilabel
> plante toujours, vous devez encore faire une modification dans <application
>akonadiconsole</application
>. Allez sur l'onglet <guilabel
>Browser</guilabel
>, trouvez la boîte d'envoi que vous <emphasis
>voulez</emphasis
> utiliser, effectuez un clic-droit sur elle, sélectionnez <guilabel
>Folder Properties</guilabel
>, onglet <guilabel
>Attributes</guilabel
>, saisissez <userinput
>SpecialCollectionAttribute</userinput
> puis cliquez <guilabel
>Add</guilabel
>, double-cliquez la valeur <guilabel
>Value</guilabel
> à proximité de <guilabel
>SpecialCollectionAttribute</guilabel
> et saisissez <userinput
>outbox</userinput
>. Ajoutez aussi un autre attribut ; l'attribut « name » doit être <guilabel
>ENTITYDISPLAY</guilabel
> et sa valeur <userinput
>("outbox" "mail-folder-outbox" "" ())</userinput
> (effectuez simplement un copier-coller depuis ici). Redémarrez <application
>akonadi</application
>. Maintenant vous devriez pouvoir supprimer définitivement le compte de dossiers locaux. </para>
</sect1>

<sect1 id="you-get-the-error-unable-to-fetch-item-from-backend-when-entering-imap-folder"
><title
>Vous obtenez le message <foreignphrase
>Unable to fetch item from backend</foreignphrase
></title>
<para
>Il peut y avoir de nombreuses raisons possibles, et l'équipe &kmail; souhaite les adresser au plus vite. En attendant, voici quelques solutions de contournement : </para>
<variablelist>
  <varlistentry>
    <term
>Première solution de contournement</term>
    <listitem>
      <itemizedlist>
        <listitem
><para
>modifiez <filename
>~/.local/share/akonadi/mysql.conf</filename
></para
></listitem>
        <listitem
><para
>Dans la section <guilabel
>[mysql]</guilabel
>, ajoutez : <userinput
>binlog_format=row</userinput
></para
></listitem>
      </itemizedlist>
      <para
>Si cela ne fonctionne pas, essayez alors la deuxième solution ci-dessous. </para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
>Deuxième solution de contournement</term>
    <listitem>
      <para
>Dans cette solution-ci il est surtout question de redémarrer, afin que &kmail; puisse aller chercher ces satanés messages... Certaines étapes possibles:</para>
      <para
>Utiliser <keycombo
>&Alt;<keycap
>F2</keycap
></keycombo
> ou &konsole; et saisissez : <userinput
><command
>kquitapp kmail</command
></userinput
>. Attendez une minute, puis saisissez <userinput
><command
>akonadictl stop</command
></userinput
>, attendez encore une minute, et saisissez<userinput
><command
>akonadictl start</command
></userinput
>, attendez de nouveau une minute, et saisissez <userinput
><command
>kmail</command
></userinput
>. Cela arrête &kmail; (fermeture de <emphasis
>toutes</emphasis
> les fenêtres), le moteur de traitement de &kmail;, redémarre ce moteur de traitement de &kmail;, et redémarre ensuite &kmail;. Le fait d'avoir une connexion internet fonctionnelle augmente les chances de réussite. Parfois, vous pouvez juste saisir <userinput
><command
>kquitapp kmail</command
></userinput
>, attendre une minute, et redémarrer &kmail;. Mais souvent plusieurs redémarrages sont nécessaires. Les raisons de ce comportement ne sont pas encore claires, mais une mauvaise connexion internet semble être un facteur aggravant. </para>
    </listitem>
  </varlistentry>
</variablelist>
<para
>Veuillez voir aussi ci-après comment l'application <application
>akonadiconsole</application
> peut être utile. </para>
</sect1>

<sect1 id="your-mails-are-not-being-sent-without-error-messages"
><title
>Vos messages ne sont pas expédiez, et vous n'obtenez aucun message d'erreur</title>
<para
>Si &kmail; n'expédie pas les courriels sans rien communiquer, il est possible que l'<quote
>agent</quote
> responsable de l'envoi des messages se soit enlisé. Bien sûr, vous devez vous assurer que vous avez effectivement une connexion réseau pour que les messages soient expédiés ! </para>
<para
>Pour remédier à cela, il peut être utile d'interrompre l'action en cours et de la redémarrer. Tout d'abord, quittez &kmail; en utilisant &krunner; (<keycombo
>&Alt;<keycap
>F2</keycap
></keycombo
>) ou &konsole; et saisissez : <userinput
><command
>kquitapp kmail</command
></userinput
>. Veuillez noter qu'un classique <keycombo
>&Alt;<keycap
>F4</keycap
></keycombo
> ou <menuchoice
><guimenu
>Fichier</guimenu
><guimenuitem
>Quitter</guimenuitem
></menuchoice
> <emphasis
>n'est pas</emphasis
> suffisant ! Attendez une minute, puis redémarrez &kmail;. Maintenant démarrez <application
>akonadiconsole</application
> avec &krunner; (<keycombo
>&Alt;<keycap
>F2</keycap
></keycombo
>) ou &konsole;. Choisissez l'<guilabel
>Agent de distribution des messages</guilabel
>, effectuez un clic-droit et interrompez l'action en cours. Probablement, des messages d'erreur s'afficheront. retournez dans &kmail; et choisissez <menuchoice
><guimenu
>Fichier</guimenu
><guimenuitem
>Envoyer les messages en attente</guimenuitem
></menuchoice
>. Maintenant cela devrait fonctionner. Si ce n'est pas le cas, plutôt que d'interrompre l'action en cours, essayez de basculer l'état hors-ligne / en-ligne de l'<guilabel
>Agent de distribution des message</guilabel
>. Vous pouvez encore tout redémarrer comme mentionné dans la solution 2 du problème décrit précédemment. </para>
<para
><note
><para
>akonadiconsole peut être très utile pour bon nombre de situations, car il présente tous les agents, c'est-à-dire tous les composants distincts du moteur de traitement de &kmail;. Vous pouvez les arrêter et démarrer, les mettre en mode hors connexion, interrompre les actions en cours, &etc;. Ce programme peut être très utile quand les choses s'enlisent.</para
></note>
</para>
</sect1>

</chapter>
