TURNKEYGNU / LINUX
Deutsch

Dokumentation

"Selbsthilfe", Probleme melden und Unterstützung bekommen

TurnKey Linux ist bestrebt, großartig zu sein. Und wir denken gerne, dass es meistens so ist. Aber manchmal treten Probleme auf. Manchmal ist es ein Missverständnis; manchmal ist es verwirrend (oder Mangel an) Dokumentation oder manchmal ist es ein Bug. Vielleicht ist es ein Fehler in unserer Software oder Vorkonfiguration, oder ein Fehler in der von Debian oder vielleicht sogar vom ursprünglichen Softwareentwickler (d. H. "Upstream") verpackten Software?

Diese Seite soll Ihnen einige Hinweise geben, um Ihre Fehlersuche schneller und einfacher zu machen und / oder es für jemanden einfacher zu machen, der versucht, Ihnen zu helfen.

Überprüfen Sie die Logs!

Software protokolliert Fehler oft detaillierter als auf dem Bildschirm. Der Standardspeicherort für Protokolle in TurnKey (und Linux im Allgemeinen) ist /var/log. Suchen Sie nach einer Datei oder einem Verzeichnis mit dem Namen der gesuchten Anwendung. Manchmal kann es eine Datei sein, die genau dort ist, manchmal wird es in einem Unterverzeichnis sein. Im Allgemeinen haben die meisten Software, die von Debian installiert wird, dort ihre Protokolle.

In der Regel versuchen wir, Anwendungen, die sich nicht direkt bei /var/log, anmelden, Komfort-Symlinks von /var/log zu den echten Log-Dateien bereitzustellen (um sie leichter zu finden), aber Leider gilt das (noch) nicht für alle Appliances. So kann Software, die von anderen Quellen installiert wurde, es woanders haben. Andere Orte, die Sie suchen sollten, befinden sich im Softwareinstallationsverzeichnis. z. B. /var/www/<Software-name>/log oder /opt/<Software-name>/log - je nach Appliance. Überprüfen Sie die einzelne Appliance-Seite, um zu sehen, ob sie einen Installationsort angibt.

Bitte melden Sie (entweder über die) Foren und/oder auf unserer Issue Tracker) alle nicht-standardmäßigen Log-Standorte oder Probleme, die Sie haben, um bestimmte Logs zu finden.

Google dein Problem.

Dieser ist ziemlich offensichtlich, aber es lohnt sich immer, als ersten Schritt zur Fehlersuche zu googeln.

TurnKey basiert auf Debian (v14.x = Debian 8/Jessie; v15.x = Debian 9/Stretch) und bleibt binär kompatibel. Im Allgemeinen sollte es online Informationen für viele häufige Probleme geben, denen Benutzer begegnen könnten, insbesondere in Bezug auf Software, die aus dem Standard-Debian-Repos installiert wurde. Ubuntu basiert auch auf Debian, kann also manchmal auch nützlich sein, aber seien Sie vorsichtig, weil Ubuntu nicht binär kompatibel mit Debian ist.

Wenn irgendwo Fehlermeldungen angezeigt werden und/oder Fehler in Ihren Protokollen gefunden werden, versuchen Sie, die spezifische, wörtliche Fehlermeldung zu googeln. Explizite Pfade können auch nicht übereinstimmen (ich empfehle, sie zunächst aufzunehmen, aber entfernen, wenn nichts Nützliches auftaucht). Wenn das immer noch keine hilfreichen Ergebnisse liefert, versuchen Sie es allgemeiner zu gestalten (z. B. wenn Zeilennummern in der Fehlermeldung angegeben werden, diese aus Ihrer Suche gelöscht werden, Pfade entfernt werden usw.).

Wenn Sie eine Lösung für Ihr Problem an einem anderen Ort als TurnKey finden, sollten Sie darüber nachdenken, dies auf unserer Website zu veröffentlichen. Foren Wie auch immer. Die Chancen stehen gut, dass wenn man das Problem hätte und nicht wüsste, was man tun soll, dass andere in der gleichen Position sind oder sein werden!

Starten Sie Ihren eigenen Thread!

Wenn Sie Ihr Problem immer noch nicht lösen können, dann posten Sie bitte auf der ForenBeachten Sie, dass wenn Sie noch kein Benutzer sind, Sie Register Es ist auch erwähnenswert, dass unsere Spam-Filter manchmal ein wenig aggressiv sein können (und doch kommen einige Spammer irgendwie durch?!). Wenn Sie sich in dieser Situation befinden, posten Sie bitte in einem bestehenden Thread, wie z.B. Diese eine und oder senden Sie uns eine E-Mail und wir werden Ihr Benutzerkonto auf die Whitelist setzen.

Beim Posten in den Foren sollten Sie in der Regel einen neuen Thread starten. Es sei denn, es gibt einen wirklich aktuellen Thread, in dem EXACTLY Ihr Problem beschreibt, ist es besser, Ihren eigenen Thread zu starten. Wenn es andere Threads gibt, die ähnliche Probleme beschreiben (aber nicht ganz dieselben und / oder alte Threads), dann schlage ich vor, einen kurzen Beitrag (auf dem anderen Thread (n)) mit einem Link zu Ihrem (neuer) Thread. Das wird die Aufmerksamkeit früherer Poster auf diesen Thread lenken, ohne ihn komplett zu entführen.

Der Grund für diesen Vorschlag ist, weil Bugs, die ähnlich aussehen, oft unterschiedliche Ursachen haben können. Das ist vor allem bei älterer Software der Fall (neuere Softwareversionen haben oft die alten Bugs behoben - so dass ein ähnlicher Fehler eine andere Ursache hat). Ein eigener Thread macht das Leben für alle besser, besonders wenn das Problem anders wird. Wenn das Problem am Ende das gleiche ist, können wir immer Post-Links kreuzen oder sogar Threads kombinieren.

Seien Sie verblüffend!

Oft haben die Leute Angst davor, zu ausführlich zu sein, besonders online. nie Wenn Sie Fehler oder Probleme beschreiben, sollten Sie zu ausführlich sein! Auch wenn Sie vielleicht nicht das Gefühl haben, dass etwas völlig relevant ist, zögern Sie bitte nicht, alle Informationen einzufügen, die Sie haben. Es ist viel einfacher für jemanden, Informationen zu ignorieren, die irrelevant sind, aber viel schwieriger, Ihre Gedanken zu lesen! :)

Geben Sie Ihrem Thread ein kurzes, aber beschreibendes Thema.

Dies ist wahrscheinlich nicht so wichtig, wenn Sie auf TurnKey im Vergleich zu anderen Foren posten, aber es hilft immer noch.

Beispiele für nicht hilfreiche Betreffzeilen:

  • "HELP!!"
  • "Mein Server ist kaputt"
  • "Arbeitet nicht"

Beispiele für bessere Themen:

  • "WordPress wird nicht aktualisiert"
  • "Kann keine Verbindung zu HTTPS auf Redmine herstellen"
  • "Fehler 504 beim Verbinden mit Drupal Site"

Geben Sie Ihrem Thread relevante Tags.

Das Taggen von Threads ist nicht notwendig, aber es macht es für andere Benutzer viel nützlicher. Es hilft uns auch, Schmerzpunkte und Fehler von Benutzern zu sammeln.

Versuchen Sie so weit wie möglich, vorhandene Tags wiederzuverwenden, anstatt neue zu erstellen. Wenn Sie mit dem Tippen beginnen, sollte unsere Website automatische Vollständigkeitsoptionen bieten, die dort helfen sollten. Erinnern Sie sich, dass Tags Leerzeichen enthalten können, und Tags sollten mit Kommas getrennt werden.

Zumindest schlage ich vor, dass Sie Ihren Beitrag mit der TurnKey-Version (z. B. "14.0" oder "14.1" - siehe unten) und dem Appliance-Namen (z. B. "redmine" oder "lamp") versehen. Wenn es sich um eine bestimmte Software handelt, mit der Sie Probleme haben, dann markieren Sie diese auch (z. B. "Webmin" oder "TKLBAM"). Tags können immer später bearbeitet werden, also haben Sie keine Angst!

Welche Version von TurnKey ist das?

Bugs gelten fast immer für eine bestimmte Version (oder Versionen) von Software. Um also denjenigen, die Ihnen vielleicht helfen möchten, einen Vorsprung zu geben, stellen Sie die Version von TurnKey zur Verfügung, die Sie haben. Wenn Sie nicht 100% sicher sind, gibt es eine wirklich einfache Möglichkeit, von der Kommandozeile aus zu überprüfen:

turnkey-version

Es sollte ein Ergebnis wie dieses (v15.1 LAMP Appliance):

turnkey-lamp-15.1-stretch-amd64

Wo läuft es?

TurnKey produziert eine Reihe von BautenSie sind alle ursprünglich aus dem ISO aufgebaut, sollten also generell Bugs über Plattformen hinweg teilen. Dies ist jedoch nicht immer der Fall, da jeder andere Build ein gewisses Maß an Anpassung hat. Auch verschiedene Plattformen haben ihre Macken und Eigenheiten, die Neulinge und / oder Entwickler möglicherweise nicht immer kennen. Um die Reibung zu reduzieren, kann es auch nützlich sein, anzugeben, wo Ihr Appliance läuft.

t2.small Server auf dem TurnKey Hub

oder

OVA in VirtualBox v6.0.4 unter Windows 10

usw. ...

Was wollen Sie erreichen?

Im Allgemeinen ist es hilfreich zu verstehen, was Sie versucht haben, als das unerwartete Verhalten auftrat. Manchmal kann es ein Missverständnis in Ihrem Namen beleuchten (vielleicht ist das Problem tatsächlich erwartetes Verhalten von dem Befehl, den Sie verwenden)? Wenn Sie es nicht sagen, ist Ihr beabsichtigtes Ziel möglicherweise nicht offensichtlich. Auch da es fast immer mehrere Möglichkeiten gibt, "eine Katze zu haut", gibt es vielleicht einen besseren / einfacheren Weg, um Ihre gewünschten Ziele zu erreichen?

Was haben Sie bisher versucht?

Wenn Sie einige Anweisungen befolgt haben, die Sie online gefunden haben (z. B. einen zufälligen Blogbeitrag oder ein StackOverflow Q & A), posten Sie einen Link dazu. Vielleicht ist es nicht kompatibel mit der aktuellen Version? z.B. gelten die Anweisungen für eine ältere Version von Debian/TurnKey, die nicht mehr gilt oder für Ihre Situation irrelevant ist.

Was war das Ergebnis?
D.h. was ist die genaue Art des Fehlers/Problems?

Wenn es eine bestimmte Fehlermeldung gab, poste sie. Wenn du einige Probleme in deinen Logs gefunden hast, poste die entsprechenden Teile. Für große lange Protokolle, erwägen Sie, sie an Ihren Beitrag anhängen, anstatt kopieren / einfügen sie. Das ist eigentlich ein weiterer Grund, einen eigenen Thread zu starten; nur der erste Beitrag kann Anhänge haben! Bitte zögern Sie nicht, Inhalte zu bearbeiten, die Sie für sensibel oder privat halten, aber beachten Sie bitte, welche Änderungen Sie an Protokollen, Fehlermeldungen usw. vorgenommen haben.

Screenshots von Problemen können auch nützlich sein (insbesondere visuelle Fehler bei Webinhalten in Ihrem Webbrowser), aber wenn Sie eine Fehlermeldung teilen, ist es viel besser, die Fehlermeldung zu posten. Es macht es einfacher, die Fehlermeldungen zu googlen und es macht es auch viel einfacher für Google, Ihren Thread in Zukunft zu finden (um anderen zu helfen).

Was haben Sie in letzter Zeit noch alles getan?

Es ist auch gut zu beachten, welche anderen Anpassungen Sie kürzlich in TurnKey vorgenommen haben (auch wenn Sie denken, dass es irrelevant ist - siehe oben Punkt über Verbosität). Manchmal haben Dinge, die du geändert hast, unbeabsichtigte Konsequenzen, und manchmal kann eine Kombination von scheinbar unzusammenhängenden Anpassungen Probleme verursachen. Oft nicht, aber je mehr Informationen Sie bereitstellen, desto einfacher ist es, Ihnen zu helfen!

Zeit, einen Bug zu posten?

Wenn Sie sicher sind, dass Sie "es richtig machen", aber das falsche Ergebnis bekommen, dann kann es ein legitimer Fehler sein. Issue TrackerGeben Sie erneut Informationen über Ihre TurnKey-Version, was Sie getan haben und was Sie erwartet haben usw. an.

Wenn Sie sich nicht sicher sind, ist es wahrscheinlich am besten, zuerst in den Support-Foren zu posten, aber es spielt keine Rolle.