Bugs/de
From OpenSimulator
Contents |
Wie melde ich einen Fehler?
Fehler melden
OpenSimulator ist Alpha-Software. Das bedeutet, dass es häufige Fehler im Code gibt und viele Funktionen noch implementiert werden müssen. Sie können uns helfen, diese Probleme zu finden und zu beheben, indem Sie uns Fehler melden oder Patches einreichen.
Das Mantis-Tool ist einer der Hauptkommunikationskanäle zwischen Benutzern und Entwicklern von OpenSimulator zum Melden von Fehlern. Es ist KEIN Kundensupport-Tool, da es innerhalb des OpenSim-Projekts keinen offiziellen Kundensupport gibt, außer dem von Freiwilligen im OpenSim IRC und der Mailingliste bereitgestellten Support. Es ist auch kein Feedback-Tool wie ein Forum. Verwenden Sie dafür bitte verschiedene Foren. Wenn Sie das Mantis-Tool verwenden möchten, müssen Sie bereit sein, zu lernen, wie Mantis im OpenSimulator-Projekt korrekt verwendet wird, was sich sehr von den Meldesystemen anderer Organisationen unterscheidet.
Dies erklärt, wie Sie einen Mantis-Bug-Report generieren und einreichen können, was die kontinuierliche Entwicklung von OpenSimulator wirklich unterstützt.
Wenn Ihr Hauptinteresse darin besteht, Ihr Problem zu lösen oder informelles Feedback zu senden, anstatt die Entwicklung von OpenSim zu unterstützen, ist Mantis das falsche Werkzeug für Sie. Versuchen Sie stattdessen, sich für Hilfe im #opensim IRC anzumelden, wo Sie mit anderen OpenSimulator-Benutzern sprechen, Erfahrungen austauschen und persönliche freiwillige Hilfe erhalten können.
Wenn Sie jedoch bereit sind, Zeit zu investieren, um das Problem, das Sie erleben, zu untersuchen, wird Ihr Einsatz sehr geschätzt. Sie sollten Mantis als eine Art Mittelweg zwischen Ihrem Bemühen, das Problem zu lösen und dem Bemühen der Entwickler, dasselbe zu tun (und das Problem zu beheben), betrachten. Für alles andere gibt es mehrere IRC-Kanäle, Mailinglisten und verschiedene grid-spezifische Foren.
Wenn Sie auf ein Problem stoßen, stellen Sie sich vor dem Einreichen eines Mantis-Berichts die folgenden Fragen:
- Erleben Sie dieses Problem allein oder gibt es andere Personen, die es auch erleben? Der schnellste Weg, diese Frage zu beantworten, besteht darin, sich im #opensim IRC-Kanal anzumelden und ein paar Worte mit anderen OpenSimulator-Benutzern auszutauschen. Eine andere Möglichkeit besteht darin, dieses Mantis-Tool nach aktuellen bekannten Fehlern/Fehlern zu durchsuchen. Wenn Sie nicht der Einzige sind, besteht die Wahrscheinlichkeit, dass es ein echtes Problem ist. Wenn Sie der Einzige sind, besteht die Wahrscheinlichkeit, dass Sie etwas falsch machen. Das Mantis-Tool ist nicht der richtige Ort, um Konfigurations- oder technische Supportprobleme zu melden. Verwenden Sie besser den IRC und melden Sie sich im #opensim an. In jedem Fall:
- Gibt es etwas in Ihrer Einrichtung, das kaputt ist?
- Haben Sie etwas falsch konfiguriert?
- Schauen Sie sich die OpenSim.log-Datei an. Gibt es etwas Informatives darin, das Ihnen hilft zu verstehen, was mit Ihrer Einrichtung los ist? Vielleicht eine Ausnahme?
- Können Sie das Problem systematisch reproduzieren? Nehmen Sie sich Zeit, um die Schritte zu verstehen, die zum Problem führen. Je reproduzierbarer und besser verstanden das Problem ist, desto höher ist die Wahrscheinlichkeit, dass es behoben wird. Wenn Sie es nicht reproduzieren können, besteht sehr wenig Chance, dass das Problem behoben wird. Aber Reproduzierbarkeit für Sie allein reicht nicht aus. Lesen Sie weiter.
- Können Sie das Problem den Entwicklern so beschreiben, dass sie es reproduzieren können, ohne Sie zu sein?
- Der beste Weg, dies zu tun, besteht darin, zu versuchen, das Problem in einer eigenständigen Einrichtung zu reproduzieren. Dies eliminiert all den zusätzlichen Lärm, der zu Unschärfe führt. Versuchen Sie es also zuerst eigenständig. Wenn Sie es so reproduzieren können, steigen die Chancen, dass das Problem bald behoben wird, dramatisch an. Wenn das Problem mit dem Hypergrid und verteilten Einrichtungen zusammenhängt, versuchen Sie, das Problem in nur einer Maschine mit 2 OpenSim-Instanzen zu reproduzieren. Aus der Sicht eines Entwicklers wird es einfach sein, Ihre gute Beschreibung zu nehmen, sie auf ihren eigenen eigenständigen Einrichtungen zu reproduzieren und sie dann zu beheben.
- Wenn Sie es nicht in eigenständigem Modus reproduzieren können, versuchen Sie, es im Grid-Modus mit dem einfachstmöglichen Grid zu reproduzieren - etwas, das ein Entwickler auch auf einer Maschine ohne viel Aufwand einrichten kann.
- Wenn Sie es auf diese Weise nicht reproduzieren können und das Problem nur in Ihrer speziellen Grid-Umgebung auftritt, besteht die Wahrscheinlichkeit, dass etwas mit Ihrer Konfiguration oder Ihrer speziellen Einrichtung nicht stimmt. Darüber hinaus nimmt die Wahrscheinlichkeit ab, dass ein Entwickler das Problem bald beheben kann. Wahrscheinlich müssen Sie ehrenamtliche technische Unterstützung finden oder versuchen, jemanden gegen Gebühr einzustellen, damit er/sie sich die Zeit nimmt, das Problem mit Ihrem Grid zu untersuchen.
Fehlerbeschreibung
Sobald Sie verstehen, wie Sie das Problem reproduzieren können, beschreiben Sie es auf Mantis zusammen mit einem Schritt-für-Schritt-Rezept für einen Entwickler, es zu reproduzieren. In einem idealen Fehlerbericht sollte die Beschreibung etwas wie folgt sein:
Einrichtung (eigenständig/Grid/...), so detailliert wie möglich
1) Führe A aus
2) Führe B aus
3) Führe C aus
...
==> Knall! Problem
In jedem Schritt sollten Sie so genau wie möglich sein, um keine Interpretationsspielräume zu lassen. Zum Beispiel ist es viel besser zu sagen
"x) hat den Client zum Absturz gebracht, indem er die Taskleiste hochgezogen und den SecondLife-Prozess beendet hat" als
"x) hat den Client zum Absturz gebracht";
und
"y) erstelle eine neue Region, indem du einen Befehl wie diesen in der Konsole verwendest: create region ..." ist viel besser als
"y) erstelle eine Region".
Denken Sie daran, dass der Zweck Ihrer Beschreibung darin besteht, einem Entwickler zu helfen, die Schritte zu erleben, die zum Problem führen, damit er/sie es dann beheben kann.
Wann keinen Fehlerbericht einreichen
Einfach ein Problem zu melden, das Sie erleben, ist in Ordnung, aber es ist völlig unwirksam für das Troubleshooting oder die Problembehebung. Mantis sollte nicht dafür verwendet werden. Melden Sie generische und/oder nicht reproduzierbare und/oder spezielle Einrichtungsprobleme informell in #opensim und/oder #opensim-dev. Hier sind zwei Beispiele:
- "TPs scheinen in OSGrid mit r1234 kaputt zu sein": Melden Sie das in osgrid-bezogenen Foren und #opensim
- "TPs scheinen insgesamt mit r1234 kaputt zu sein, und viele Leute sehen das auch": Lassen Sie die Entwickler dies in #opensim-dev wissen, vielleicht. Sie wissen es wahrscheinlich bereits.
Wenn alles, was Sie zu einem Problem sagen können, dessen kurze Beschreibung oder "Das passiert mir, bitte hilf" oder "Hier ist mein informelles Feedback" ist, ist Mantis das falsche Werkzeug dafür. Reichen Sie keinen Fehlerbericht ein, er wird sofort geschlossen.
Bitte überprüfen Sie die Mantis-Verfahren/Zustände usw. auf Bugs
Außerdem sollten Sie keine Funktionen in Mantis vorschlagen, es sei denn, Sie haben auch begleitenden Code, um die besagte Funktion zu implementieren. Der richtige Ort, um Funktionen vorzuschlagen, ist zunächst die opensim-dev-Mailingliste und dann die Feature Proposals-Wiki-Seite.
Schritte zum Melden eines Fehlers
- Besuchen Sie opensimulator.org/mantis und suchen Sie, ob Ihr Fehler bereits im System existiert. Wenn ja, fügen Sie eine Notiz mit zusätzlichen Kommentaren oder technischer Unterstützung wie Wiederholungsschritten, Symptomen usw. hinzu.
- Ein guter Fehlerbericht hat folgende Eigenschaften:
- Klar und prägnant, z.B.: "Das Duplizieren eines Primitivs beim darauf Sitzen lässt die Region abstürzen.".
- Enthält so viele Debug-Informationen wie möglich. Wenn OpenSimulator einen Fehler geworfen hat, bevor er abgestürzt ist, ist eine Kopie dieses Fehlers hilfreich. Wenn nicht, ist es auch potenziell hilfreich, die letzten 50 Zeilen aus Ihrer opensim.log einzufügen, wenn es angebracht ist.
- Wenn Sie den Fehler reproduzieren können, sind Schritte zur Reproduktion ein Muss.
- Bitte melden Sie keine Fehler wie "OpenSimulator verbraucht viel CPU-Zeit", ohne Informationen zu Ihrer Einrichtung und allem, was Sie oder wir getan haben, um dies auszulösen. Leider sind wir nicht hellseherisch und können nicht erraten, was passiert sein könnte.
- Erstellen Sie ein Konto auf der Mantis-Website von opensim und klicken Sie auf 'Neuen Fehler melden'. Bitte beachten Sie, dass einige kostenlose E-Mail-Anbieter möglicherweise eine Weile benötigen, bis die Bestätigungs-E-Mail erscheint.
Fehlerzustände in Mantis
Eines der Ziele ist es, so viele Probleme wie möglich aus dem neuen Zustand herauszubekommen und in gute Bugs zu verwandeln, die bearbeitet werden können. Unten ist ein leichtgewichtiges Zustandsdiagramm, das bei der Entscheidung helfen sollte, welcher Zustand für Bugs in Mantis angemessen ist.
Einige Kommentare zu den Zuständen:
- Bugs müssen nicht durch alle Zustände fließen, um irgendwo anzukommen. Wenn ein Fehler mit einer gut geschriebenen Beschreibung beginnt und die Person, die den Fehler triagiert, das gleiche Problem gesehen hat, kann er direkt zu bestätigt verschoben werden. Wie bei allem sind dies grobe Richtlinien, verwenden Sie Ihr Urteilsvermögen.
- Ein Fehler wird als Gelöst markiert, wenn die Person, die den Fehler bearbeitet, glaubt, dass er behoben ist, auch wenn es keine endgültige Bestätigung vom Melder gibt. Wenn der Melder feststellt, dass es nicht behoben ist, öffnen Sie den Fehler einfach wieder und fügen Sie entsprechende Kommentare hinzu.
- Bitte überlassen Sie das Schließen von Fehlern dem Kern-Team. Ein geschlossener Fehler bedeutet, dass wir glauben, er ist für immer weg oder der Fehlerbericht ist ungültig.
- Ein Fehler im Zustand "Gelöst" oder "Geschlossen" kann auch wieder geöffnet werden, wenn der Fehler immer noch besteht. Lesen Sie bitte den Fehlerbericht und die angehängten Hinweise sorgfältig durch, bevor Sie dies tun.
Tipps für Fehlerbeschreibungen
Wenn das von Ihnen gemeldete Problem einen Absturz oder Ausnahmen verursacht, kann es hilfreich sein, den Stacktrace oder das in der Konsole angezeigte Protokoll an Ihren Bericht anzuhängen. Wenn der Fehler reproduzierbar ist und Sie die OpenSimulator-Quellverteilung auf Mono verwenden, führen Sie Mono mit der Debug-Option aus:
mono --debug OpenSim.exe
Es fügt Ihren Stacktrace Quelldateinamen und Zeilennummern hinzu, was Entwicklern ermöglicht, die fehlerhaften Schritte leicht zu finden.
