Posting-frequency: 4 weeks
Last-modified: 2008-08-22
URL: http://soscha.de/hamster/checklist-faq.txt (Who's computer is this?)
Changed: 9 eingefügt, A2 Hilfe-Link erneuert


Checkliste zur Fehlersuche
============================

Ihr habt ein Problem mit dem Hamster, insbesondere mit dem Betrieb oder
dem Zugriff auf Daten? Das ist für viele der Grund, in der Gruppe
hamster.de.newuser (hdn) vorbeizuschauen.
Hier konnte noch fast jedem geholfen worden, also nur zu: Fragt! Damit
aber "wir Experten" auch wirklich etwas über Euer System wissen,
brauchen wir schon einige Informationen. Hier mal eine kleine Liste mit
den wichtigsten Punkten:


1. Das Problem so genau wie möglich beschreiben. Im Zweifel etwas
ausführlicher.

2. Die Versionsnummer des Hamsters benennen, insbesondere die letzten
beiden Zahlen. Die aktuelle Version ist 2.1.0.11; Bugfixes und
Modifikationen geben sich nur in der letzten Stelle zu erkennen.

3. Bei Verbindungsproblemen die Windows-Version mitliefern. User von
Windows 95 sollten auch die Datei-Informationen aus dem Hamster-
Menü "Hilfe / System-Information" liefern. Diese lassen sich mit
Strg+C in die Zwischenablage und von dort in das Posting bringen.

4. Nach Möglichkeit ein Protokoll mit eingeschalteten INFOS und DETAIL
(im Menü "Einstellungen / Grundeinstellungen") mitliefern, welches
das Problem dokumentiert. Ein Doppelklick auf die Fehlermeldung
(rot, im "x Fenster Fehler und y Warnungen") öffnet ein Protokoll nur
für diesen einen Thread. Nicht abtippen (Schreibfehler), sondern mit
Kopieren+Einfügen in das Posting bringen; die Daten lassen sich
mittels rechter Maustaste erfassen.
Bitte keine 500 Zeilen, aber mehr als 10 sollten es schon sein.
Auf jeden Fall rund um die eigentliche Fehlermeldung. Weitere Tips
unten im Anhang. Protokolle werden auch Logfiles oder Logs genannt.
Es kann auch nützlich sein, das Logfile direkt zu sichern. Nach dem
Fehler den Hamster beenden (alle Aktionen abwarten), im Verzeichnis
%Hamster%\Logs die Datei 0.log an einen sicheren Platz kopieren und
aufbewahren. Bitte auf keinen Fall posten, und nur _auf_Anfrage_
gezippt per Mail schicken.
Alternativ kann die gezippte Datei auch im Web zum Download
bereitgestellt und nur der Link gepostet werden.
ACHTUNG: im Level DEBUG könnten Passworte in den Logs auftauchen.
Diese sind bitte vor dem Posten unkenntlich machen.
Ausserdem können im Level Debug private Mails vollständig lesbar sein,
wenn zwischenzeitlich mit lokalen Clients Mail vom Hamster abgerufen
wurde. Diese müssen - besonders wenn das Log öffentlich zur Verfügung
steht - unbedingt vorher entfernt werden, es handelt sich um Zeilen
mit TSrvPOP3Cli.SendT.

5. Die betreffenden Server immer benennen, denn oftmals sind die
damit zusammenhängenden Probleme bereits bekannt. Durch Angabe der
Servernamen erhalten wir zudem die Möglichkeit, auch mal direkt
dort nachzuschauen, um Dein Problem zu klären.

6. Bitte alle Angaben immer "wahrheitsgetreu". Wenn beispielsweise
niemand wissen soll, welche Newsgruppen Dich interessieren, dann
kannst Du das in den geposteten Protokoll-Auszügen gerne unkenntlich
machen (etwa den Gruppennamen durch XXX ersetzen), ABER schreib
das dann auch bitte gleich dazu, damit wir nicht lange herum-
rätseln müssen. PASSWÖRTER *selbstverständlich* ebenfalls unkenntlich
machen, vor allem in Scripten.

7. Vor dem Posten auf jeden Fall zuerst in die Hilfe sehen, besonders
in den Abschnitt FAQ, sowie in die kommentierten Beschreibungen der
"Dateien im Hauptverzeichnis". Einige häufige Fragen sind dort
schon abgehandelt; auch eine Suche nach Begriffen kann lohnen.

8. Auch, wenn der Hamster nicht mit Fehlermeldungen um sich wirft, und
etwas "nur" nicht so funktioniert, wie es soll, dann sind diese
Angaben wertvoll.

9. Wenn Artikel oder Mails verfälscht übertragen werden, so können dafür
auch zusätzliche Tools und Scripte verantwortlich sein. Selbstverständlich
müssen diese vor weiterer Untersuchung des Problems deaktiviert werden.
Selbst dann, wenn sie "gar nichts mit dem Problem zu tun" haben können.
Häufig haben sie es nämlich doch.

10. Inzwischen hat sich herauskristallisiert, dass diverse Probleme durch
die Installation einer "Personal Firewall" verursacht werden. Daher ist
es angeraten, diese zunächst einmal zu deinstallieren (ja, _ganz_, nicht
nur deaktivieren). Tritt der Fehler immer noch auf, entsprechend darauf
hinweisen. Tritt er nicht mehr auf, ist auch das eine wichtige Information.
Es kann jedoch sein, daß die Lösung des Problems nicht in den Hamster-
gruppen zu finden ist. Eine freundliche Frage schadet aber bekanntermaßen
nie.


Wenn Du diese Punkte beherzigst, vermeidet das unnötige Rückfragen und
Fehlinterpretationen - und Dir verhilft es zu einer schnellen und
passenden Antwort.


A. Zusätzliche Anregungen

A.1. Protokolle (Logfiles) posten

Da einige Log-Zeilen sehr lang sind, kann auch ausnahmsweise (für dieses
_eine_ Posting) eine extreme Zeilenlänge eingestellt werden. Hier bitte
die Möglichkeiten des eigenen Readers beachten. Den eigentlichen Text
dann bitte von Hand umbrechen.
Weitere Hinweise zu diesem Thema sind in einer eigenen FAQ zu finden.
| Newsgroups: hamster.de.newuser
| Subject: Anleitung zum Posten eines Hamster Logs
Diese wird im Wechsel von zwei Wochen mit dieser FAQ gepostet. MID und URL
findet sich dann im wöchentlichen Pointer auf beide FAQ.


A.2. Nützliche FAQs zu Newsreadern.

Einige Probleme sind einfach durch die eigene Software verursacht, und
nicht durch Hamster selber. Daher hier erst mal ein paar Adressen auf
weitere FAQs (und eine Newsgroup).

Outlook Express: http://oe-faq.de (Who's computer is this?)
Netscape Messenger: http://Peter.Dobler.bei.T-online.de/netscape.htm (Who's computer is this?)
Forté (Free) Agent: http://www.vibe.at/begriffe/ags-kurs.html (Who's computer is this?) und
http://www.netandmore.de/faq/forte/ (Who's computer is this?)
Gravity: http://members.home.net/gravitypages (Who's computer is this?) (englisch)
XNews: http://www.x501.de/xnews/faq.htm (Who's computer is this?)
http://www.hreimers.de/Xnews (Who's computer is this?)
Hamster Hilfe: http://zielgra.de/hamster/HAMSTER_HLP_DE.ZIP (Who's computer is this?)
Alle Newsreader: http://www.thomas-huehn.de/usenet/newsreaderFAQ.txt (Who's computer is this?)
news:de.comm.software.newsreader


B. Beta-Versionen

B.1. Was sind Beta-Versionen?
Historisch wird jede einzelne bereits erschienene Version als Beta
bezeichnet. Das soll ausdrücken, daß der Hamster noch nicht fertig
entwickelt ist. Trotzdem sind bis jetzt alle Versionen bemerkenswert
stabil und benutzbar gewesen.
Daher wird inzwischen unterschieden zwischen den "Stable" Versionen und
den richtigen "Beta". Die sog. Stable erkennt man an der dritten Stelle
der Versionsnummer, diese ist immer 0. Im Gegensatz dazu tragen die
richtigen Beta an dieser Stelle die Stufe der Entwicklung. In beiden
Linien dient die letzte (vierte) Stelle zur Kennzeichnung von Bugfixes.
Nach einer reiflichen Entwicklungs- und Testphase münden diese Betas
dann in eine neue Stable Version. Zum Zeitpunkt der Erstellung dieser
Bemerkungen ist 2.1.0.11 die aktuelle Stable, eine Beta-Phase gibt es im
Moment nicht.

B.2. Für wen sind diese Beta-Versionen gedacht?
Der Zweck dieser Software ist es, im realen Einsatz noch Fehler zu finden,
die die Programmierer noch nicht bemerkt hatten. Daher ist bei diesen
Versionen mit verstärktem Auftauchen von Problemen zu rechnen.
Deshalb sind diese Versionen für Hamster-Newuser normalerweise nicht
geeignet. Zum Finden und Einkreisen von Fehlern bedarf es naturgemäß einer
grundsätzlichen Erfahrung mit dem Programm. Dazu kommt, daß die
Hamstergemeinde insgesamt mit den neuen Features noch nicht vertraut ist.
Daher ist es schwierig, Hilfe bei der Konfiguration zu leisten. Es wäre
auch unsinnig, da diese Hilfe mit der nächsten Version schon wieder
unrichtig sein kann.
Aus diesen Gründen sollte sich ein Hamster-Newuser an die aktuelle Stable
halten. Es sei denn, er/sie ist sich des Risikos voll bewußt *und*
benötigt eines der neuen Features ganz dringend (also bevor es in der
nächsten Stable existiert).

B.3. Wo denn über diese Beta diskutieren?
Aus B.2. folgt ganz klar, daß die Diskussionen über eine aktuelle
Beta-Version und ihre Bugs in hamster.de.newuser nichts zu suchen haben.
Die richtige Gruppe ist hamster.de.misc, wegen des breitgestreuten Themas.
Einige Teilaspekte passen sicher auch nach hamster.de.config, oder zu den
Tools.

B.4. Wie werden denn Bugs gemeldet?
Die neueste Beta-Version wird erfahrungsgemäß von vielen Usern getestet.
Da bleibt es nicht aus, daß auch viele die gleichen Fehler entdecken. Es
ist daher zwingend notwendig, vor dem Report zu einem Bug erst einmal
nachzulesen, ob dieser Fehler nicht schon gemeldet wurde.
"Erst Lesen, dann Posten" gilt hier in verstärktem Maße. Nachdem ein
solcher Fehler gemeldet wurde, ist es nur noch interessant, daß Auftauchen
genauer einzukreisen. Danach wird der Bug uninteressant, bis zur nächsten
Beta, die ihn hoffentlich behoben hat.


Grundsätzlich ist jeder eingeladen, eine Beta zu installieren und damit neue
Möglichkeiten zu testen. Mehr als ein paar Monate Erfahrung mit dem Hamster sind
dazu nicht notwendig. Aber bitte kühlen Kopf bewahren, und das Risiko für die
eigenen Daten bedenken.