How to report a problem/fr
Contenus
Auteur
John Crisp
Comment déboguer
J'ai écrit ceci il y a plusieurs lunes. Ce teste contient de nombreux liens qui valent la peine d'être lus.
https://gist.github.com/reetp/a66149d5f060f260643a353ca7067a98
Le problème XY
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 juste 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.
More reading:
How to Report Bugs Effectively https://www.chiark.greenend.org.uk/~sgtatham/bugs.html
Asking smart questions http://www.catb.org/esr/faqs/smart-questions.html
A good bug reporting example https://github.com/RocketChat/Rocket.Chat/issues/13069
History
Tell us about your server history - upgrades/updates and what you have installed, and then some debugging output.
Debug output
Run these commands in a terminal:
/sbin/e-smith/audittools/newrpms /sbin/e-smith/audittools/repositories /sbin/e-smith/audittools/templates
db configuration show
Or go to server-manager, Miscellaneous, Report a bug, Create Configuration report.
Remove anything sensitive like passwords and public IPs!!
You might want to put this on somewhere like pastebin as it will likely be long.
Searching logs for errors
You can also look in your logs for errors:
https://wiki.koozali.org/Log_Files
You can see how to search here:
https://wiki.koozali.org/Useful_Commands#Parse_Log_files_to_search_for_errors
When you want to test the SME Product it can be useful to see what it occurs. This CL can help you, but you should read the entire log
grep -iE "uninitialized|WARNING|ERROR" /var/log/messages
Or if you want to parse all logs
grep -iE "uninitialized|WARNING|ERROR" /var/log/*
Opening Bugs
General rules for bugs.
Don't just open a bug because you have a problem.
The bug tracker is for fixing errors in the code, not a general help forum. That's what the forums are for!
If you ask in the forums then a developer or more experienced user will usually advise you whether to open a bug or not.
Can repeat the issue or not?
If you can repeat it then so can developers, and if they can repeat it they can find and try and fix it.
Have a good read on the interwebs first. Koozali SME does not supply every package - many come from upstream and we can't specifically fix them. A bug has to be lodged in the right place.
Make sure you have done your homework first and prepared all the debug data. It makes it far easier to repeat and fix.
Be prepared to help the developer with a fix, and test it.
Be patient.
Reference.
https://forums.koozali.org/index.php/topic,54724.0.html
