Trouver les logs
Côté logiciel client, les éventuels messages se trouvent directement dans l'interface d'Outlook, dans le dossier "Problèmes de synchronisation".
Côté serveur, 2 fichiers sont à consulter :
- le log général
/var/log/bm-mapi/mapi.log
- le log d'activité
/var/log/bm-mapi/activities.log
Il possible d'activer un log détaillé sur le serveur pour un utilisateur en particulier pour de l'investigation avancée, mais attention cela à des impacts sur les performances. L'activation se fait via l'outil en ligne de commande bm-cli avec le paquet supplémentaire bm-plugin-cli-mapi
installé sur le serveur :
bm-cli mapi logging --enable jdoe@bluemind.loc
Les logs se retrouvent alors dans le fichier /var/log/bm-mapi/user-jdoe@bluemind.loc.log
Le réglage est perdu au redémarrage du serveur bm-mapi
Diagnostiquer des problèmes
Un mail ne se copie ou déplace pas dans un dossier
Problèmes/Symptômes :
- un email est visible dans un dossier dans Outlook mais il n'apparait pas sur le serveur dans ce même dossier (il n'y est visible ni dans le webmail ni sur des appareils mobiles)
- dans le dossier Outlook "Problèmes de Synchronisation", il y a de nombreuses erreurs concernant cet email
- la synchronisation est bloquée mais quand on supprime l'email dans Outlook, la synchonisation reprend
Diagnostic :
Problèmes connus
Création de compte en erreur à cause d'un mauvais mot de passe enregistré
Problèmes/Symptômes : la saisie du mot de passe ne permet pas la création du compte, Outlook indique toujours que le mot de passe est erroné
Cause : l'utilisateur a enregistré un mauvais mot de passe pour ce compte lors d'une tentative de création précédente
Vérification : dans le fichier de logs du serveur /var/log/nginx/access.log
on trouve des lignes de ce type :
192.168.61.133 - - [06/May/2019:16:57:53 +0200] "POST /autodiscover/autodiscover.xml HTTP/1.1" 401 0 "-" "Microsoft Office/16.0 (Windows NT 10.0; Microsoft Outlook 16.0.11601; Pro)"
ou
192.168.61.133 - tom@bm.lan [06/May/2019:16:58:31 +0200] "POST /mapi/nspi/?MailboxId=94a5c596-90a8-4985-91fd-57629ee06561@bm.lan HTTP/1.1" 200 149 "-" "Microsoft Office/16.0(Windows NT 10.0; Microsoft Outlook 16.0.11601; Pro)"
Ces lignes indiquent qu'il y a mauvais mot de passe pour tom@bm.lan soumis par la création de compt
Solution :
Pour supprimer le mauvais mot de passe :
- s'assurer qu'Outlook et l'écran de création de compte soient fermés
- ouvrir le Gestionnaire d'identification en tapant Windows + R
- saisir "
control /name Microsoft.CredentialManager
" : - cliquer sur OK (ou touche <Entrée>)
- Supprimer les entrées de type
autodiscover.domaine.tld
etMicrosoftOffice16_SSPI:utilisateur@domaine.tld
Par exemple pour supprimer le mot de passe de tom@bm.lan :
Les dossiers sont vides
Problème/Symptôme : Les dossiers par défaut (boîte de réception, messages envoyés, corbeille, etc.) sont bien présents mais ils sont vides. Sur le webmail, ils contiennent bien des messages.
Cause : Cela est dû à un dysfonctionnement de la réplication sur le compte en question.
Solution : Il faut passer par des opérations de maintenance spécifique :
bm-cli maintenance repair --ops replication.subtree user@domain.tld bm-cli maintenance repair --ops replication.parentUid user@domain.tld
Ensuite, relancer outlook et vérifier que les messages arrivent correctement.
Le carnet d'adresse globale sur Outlook n'est pas complet
Problème/Symptôme :
- je lance outlook
- je rédige un message
- je clique sur le bouton À
- Je ne retrouve pas toutes les adresses du serveur BlueMind
Vérification :
Contrôler le fichier de logs /var/log/bm-mapi/mapi.log
. On y retrouve des erreurs de ce type :
2019-11-22 10:51:07,079 [OAB-generation-pool-2-thread-7] n.b.e.p.c.o.OABGenerator WARN - Cannot handle directory entry a25a572f-eadd-4232-a183-4c0c41e56d0b of type USER java.lang.NullPointerException: null at net.bluemind.exchange.mapi.commons.DistinguishedName.userDN(DistinguishedName.java:96) at net.bluemind.exchange.provider.core.impl.gal.UserAddressProps.getDn(UserAddressProps.java:60) at net.bluemind.exchange.provider.core.impl.gal.UserAddressProps.<init>(UserAddressProps.java:54) at net.bluemind.exchange.provider.core.oab.OABGenerator.userRecord(OABGenerator.java:221) at net.bluemind.exchange.provider.core.oab.OABGenerator.create(OABGenerator.java:119) at net.bluemind.exchange.oab.impl.OABIndexHandler.lambda$1(OABIndexHandler.java:121)
Cause : il faut regénérer la base hollow qui permet le mapping des uids BlueMind avec les "uid outlook pour mapi".
exemple :
lecture du mapping possible via
bm-cli hollow directory domain.tld Record{uid=a25a572f-eadd-4232-a183-4c0c41e56d0b, dn=/o=mapi/ou=domain.tld/cn=recipients/cn=user:a25a572f-eadd-4232-a183-4c0c41e56d0b}
Solution : Régénérer la base hollow en suivant la procédure suivante :
systemctl stop bm-mapi && systemctl stop bm-core rm -fr /var/spool/bm-hollowed/directory/domain.tld/ systemctl start bm-core
# bm-cli maintenance ops devenv.blue|grep -i hollow hollow.directory Ensure Hollow copy of the directory is in sync v
Vérifier les logs du core et attendre la fin de la régénération de la base hollow. Enfin, relancer le service mapi :
systemctl start bm-mapi
Les messages ne sont pas affichés en arborescence malgré le mode conversation activé
Cette fonctionnalité n'est pas encore implémentée dans la gestion de MAPI par BlueMind.
Cependant il peut arriver que certains messages soient triés en tant que conversations selon le client tiers dont ils proviennent (Webmail ou Thunderbird par exemple).