How to report a problem/fr

From SME Server
Revision as of 19:24, 1 January 2024 by Gieres (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search


Contenus

Auteur

John Crisp

Comment déboguer

J'ai écrit ceci il y a plusieurs lunes. Ce texte contient de nombreux liens qui valent la peine d'être lus.

https://gist.github.com/reetp/a66149d5f060f260643a353ca7067a98

Le problème XY

http://xyproblem.info/

Parlez-nous du problème que vous essayiez initialement de résoudre, et non du problème que vous rencontrez actuellement.

Souvent, celui que vous rencontrez actuellement est le résultat d’une incapacité à comprendre ou à résoudre le problème d’origine.

Pour signaler le problème, assurez-vous d'être prêt. Fournissez les informations de base requises ci-dessous dans le paragraphe « Historique ». Cela permet d'économiser beaucoup de temps et d'efforts.

Rappelez-vous, si vous appeliez le garage au sujet d'un problème avec votre voiture et que vous disiez simplement « ça marche bizarrement parfois », que vous demanderaient-ils ? Marque, modèle, âge... etc.

Ici, c’est pareil.

Soyez honnête à propos de l’historique, même si vous êtes gêné(e). Deux raisons :

1. il sera beaucoup plus rapide et plus facile de vous proposer une solution ; 2. les personnes à qui vous posez la question finiront probablement par comprendre ce que vous avez fait.

N'oubliez pas que les personnes susceptibles de vous aider sont toutes des bénévoles. Ils ne posent pas de questions uniquement pour s’amuser ou pour vous mettre en colère.

N'oubliez pas que c'est vous qui avez le problème, pas eux. Vous leur posez la question parce que vous ne savez pas ou ne comprenez pas ce qu'ils font. N'abusez pas de cette position. Vous constaterez peut-être que vous êtes soudainement à court d’aide.

Ils pourraient également vous dire quelque chose que vous ne voulez pas entendre. Cela ne veut pas dire qu'ils ont tort.

Plus de lecture :

Comment signaler efficacement les bogues https://www.chiark.greenend.org.uk/~sgtatham/bugs.html

Poser des questions intelligentes http://www.catb.org/esr/faqs/smart-questions.html

Un bon exemple de rapport de bogue https://github.com/RocketChat/Rocket.Chat/issues/13069


Historique

Parlez-nous de l'historique de votre serveur - mises à niveau / mises à jour et de ce que vous avez installé, puis de quelques résultats de débogage.

Debug output

Lancez ces commandes dans un terminal :

/sbin/e-smith/audittools/newrpms
/sbin/e-smith/audittools/repositories
/sbin/e-smith/audittools/templates
db configuration show

Ou allez sur le gestionnaire du serveur, Divers, Rapporter un bogue et appuyer sur le bouton « Créer un rapport de configuration ».


  Attention :
retirer tout ce qui est sensible comme les mots de passe et les IPs publiques !!


Vous voudrez peut-être le mettre quelque part dans un « pastebin » car ce sera probablement long.

Recherche des erreurs dans les journaux

Vous pouvez également rechercher les erreurs dans vos journaux :

https://wiki.koozali.org/Log_Files

Vous pouvez regarder ici comment chercher :

Useful_Commands#Parse_Log_files_to_search_for_errors

Si vous voulez tester le Produit SME, il peut être utilile de voir ce qu'il se passe. Cette ligne de commande peut vous aider, mais vous devriez parcourir l'entièreté du journal.

grep -iE "uninitialized|WARNING|ERROR" /var/log/messages

Ou, si vous souhaitez analyser tous les journaux :

grep -iE "uninitialized|WARNING|ERROR" /var/log/*

Ouverture de bogues

Règles générales pour les bogues.

N'ouvrez pas simplement un bogue parce que vous avez un problème.

L'outil de suivi des bogues sert à corriger les erreurs dans le code, et n'est pas un forum d'aide général. C'est à ça que servent les forums !

Si vous posez la question sur les forums, un développeur ou un utilisateur plus expérimenté vous conseillera généralement d'ouvrir ou non un bogue.

Le problème peut-il se répéter ou non ?

Si vous pouvez le répéter, les développeurs le peuvent aussi, et s'ils peuvent le répéter, ils peuvent le trouver et essayer de le réparer.

Lisez bien les interwebs d’abord. Koozali SME ne fournit pas tous les paquets - beaucoup viennent de l'amont et nous ne pouvons pas les réparer spécifiquement. Un bogue doit être déposé au bon endroit.

Assurez-vous d'abord d'avoir effectué vos tâches et préparé toutes les données du débogage. Cela rend beaucoup plus facile la répétition et la correction.

Soyez prêt à aider le développeur avec un correctif et à le tester.

Soyez patient.


Référence :

https://forums.koozali.org/index.php/topic,54724.0.html