Problemfall dokumentieren

Inhalt → Rocview

• Problemfall dokumentieren

Menü-Ort	Rocview → Hilfe → Problemfall…
Werkzeugleisten-Symbol	oder

Wenn ein Problem im Rocrail Forum gemeldet wird, müssen einige wesentliche Dateien mitgeliefert werden, die mit dieser Funktion einfach in ein paar Schritten zusammengestellt werden können:

1. Deinstallieren aller zusätzlichen Virus- und anderer Scanner; Neustart.
2. A K T U A L I S I E R E N der Rocrail-Installation. Das ist wichtig Rocrail Update
3. Alte *.trc-Dateien löschen.
4. Den betroffenen Arbeitsbereich öffnen.
5. Aktionen deaktivieren.
6. Die erforderlichen Trace-Optionen aktivieren: (Datei -> Rocrail Trace)
   1. Wenn unbekannt ist, was benötigt wird: Informationen
   2. Automatik-Betrieb: Informationen + Automatik
   3. Zentralen-Problem: Informationen + Monitor
7. Rocrail betreiben, bis das Problem auftritt.
8. Das Hilfe-Menü in Rocview öffnen.
9. Problemfall… auswählen.
10. Einen Text in das Thema-Feld schreiben; Zum Beispiel: "Weiche funktioniert nicht". (Keine Sonderzeichen/Umlaute verwenden )
11. Optional detailliertere Informationen zum Problemfall in den Text-Bereich Beschreibung schreiben.
12. OK anklicken.
13. Es öffnet sich ein Datei-Explorer-Fenster mit einer issue.zip genannten Datei, die dem Beitrag im Forum beigefügt werden sollte. Die Datei "issue.zip" wird im Arbeitsbereich im Ordner "issue" gespeichert.
14. Wurde die issue.zip-Datei nicht automatisch erzeugt, muss das Unterverzeichnis "issue" mit einem ZIP-Programm gezippt werden.

Hinweise:

• Die Problemfalldateien (Issue-Dateien) befinden sich auf dem Servercomputer, wenn Rocview auf einem anderen Computer ausgeführt wird.
• Modulpläne können diese Funktion nicht verwenden und müssen manuell zusammengestellt werden. Unbedingt alle Moduldateien hinzufügen, die sich ggf. auch in anderen Ordnern befinden können.
• Wenn Rocrail beendet wird, bevor die Problemfalldateien erstellt werden können, sollte der Ordner des Arbeitsbereichs in eine Zip-Datei gepackt und dem Forumbeitrag als Dateianhang beigefügt werden.

Das Erstellen eines Problemfalls bei Modul-Anlagen verpackt diese in eine einzige Plandatei.
Deshalb ist bei diesem Anlagentyp das Zippen des kompletten Ordners der besser Weg.

• Hinweis: Unbedingt auch Modul-Dateien berücksichtigen, die ggf. in anderen Arbeitsbereichen gespeichert sind und in diesen Modulplan nur verlinkt wurden.

Nur die die wirklich notwendige Trace-Intensität für den Server aktivieren.

• Traces mit Ebene "Automatik" sind nur bei Problemen im Automatik-Modus sinnvoll.
• Traces mit Ebene "Byte" sind nur bei Kommunikations-Problemen sinnvoll.
• Und so weiter …

1. Alle unnötigen Trace-Ebenen abschalten.
2. Die Umgebung vorbereiten, die für die Reproduktion des Problems erforderlich ist.
3. Neustarten, falls nötig.
4. Aktionen deaktivieren.
5. Die Reproduktion des Problems so kurz halten wie möglich.
6. In den Problemfall-Dialog eine Schritt für Schritt-Liste schreiben, wie das Problem reproduziert werden kann.

Der Problem-Ordner (normal issues) ist standardmäßig in der Arbeitsbereichs-Umgebung, kann aber in der Registerkarte Allgemein der Rocrail-Server-Einstellungen geändert werden.
Im Server-TraceFenster wird der voll qualifizierte Pfad angezeigt.
Wenn der Server auf dem gleichen Computer läuft, wird ein Datei-Explorer-Fenster geöffnet, dass alle Dateien enthält, die in eine Datei komprimiert (gezippt) werden können, um sie ins Forum hochzuladen. Mit neueren Revisionen wird eine issue.zip-Datei automatisch erzeugt.
Optional kann ein anderer Pfad ausgewählt werden, wenn der Server auf dem gleichen Computer läuft.

Wenn Rocrail keine issue.zip-Datei erzeugt hat, den Problem-Ordner (im Sub-Ordner issue des Arbeitsbereichs)
unter Mac oder Windows in eine problem.zip-Datei oder unter Linux als problem.tar.gz komprimieren.

Dem betreffenden Forums-Beitrag die von Rocrail erzeugte issue.zip-Datei oder das manuell angelegte problem-Archiv als Anhang beifügen:

Das Thema des Problemfalls. (Pflichtangabe)

Keine Sonderzeichen/Umlaute im Thema verwenden. Der Ordnername könnte sonst plattformabhängig so oder schlimmer aussehen: issues/Der_Zug_fährt_nicht

Optionaler Pfad für das Speichern der Problemfall-Dateien, falls der Server auf dem gleichen Computer läuft, wie Rocview.

Kurze Beschreibung des Problems, ggf. Schritt für Schritt, wie das Auftreten des Problems reproduziert werden kann. Dies ist optional, aber sehr zu empfehlen.

issue.txt:

Date: 20120930.112140.715
Rocrail 2.0.999-4021 Sunrise (linux)

started at Sun Sep 30 11:20:31 2012

process id         = 81373
working directory = /Users/rob/lp/Rocrail/unxbin/virt
allocation count  = 17555
allocated memory  = 3 MB
clients           = 1
connections       = 1
locos             = 2


De trein vertrekt niet.:
----------------------------------------
Ik heb al van alles geprobeerd maar zelfs met een zetje wilt de trein niet gaan rijden.


BackTrace: (last 10 exceptions and warnings)
----------------------------------------
 unable to open file: netroutes.xml
 Error open file [netroutes.xml] [rb]
 Error open file [netroutes.xml] [rb]
 block [03] not found
 block [02] not found
 block [01] not found
 createMap: locationlist NOT found.
 createMap: operatorlist NOT found.
 createMap: waybilllist NOT found.
 createMap: linklist NOT found.

13 threads:
----------------------------------------
timedoff "timedoff"
clockticker "clockticker"
r2rreader "r2rreader"
V200 "Elektrolokomotive E 41 der DB"
infw035C98E0 "127.0.0.1"
broadcast "ClientCon Broadcaster"
tick06F00E00 "tick06F00E00"
checker "checker"
cconmngr "ClientCon Manager"
r2rwriter "r2rwriter"
vcs-1 "vcs-1"
E03 "Elektrolokomotive BR 103 der DB"
cmdr035C98E0 "127.0.0.1"

• Ersten Beitrag des Themas anzeigen
• Button "Bearbeiten" klicken
• In der Betreffzeile ans Ende klicken
• Für Windows: Taste "Win" und "." klicken, es erscheint eine Tabelle mit Icons
• Für Apple: Taste [FN] drücken, es erscheint eine Tabelle mit Icons. Falls diese nicht erscheint, in den Keyboard-Settings bei "Press [FN] key to" die Funktion "Show Emoji & Symbols" einstellen. Oder Safari → Bearbeiten → Emoji & Symbolen.
• FireFox: Emoji AddOn installieren und mit Ctrl+Alt+A aufrufen, Häkchen auswählen und mit Ctrl+V im Betreff kopieren.
• Häkchen auswählen
• Button "Änderungen speichern" klicken

Im Forum kann dazu hier nachgelesen werden.