Innovative Model Railroad Control System

User Tools

Site Tools

Trace:
issue-de

Differences

This shows you the differences between two versions of the page.


Previous revision
—issue-de [2024/04/25 13:57] (current) – [Markieren eines Forum-Themas als gelöst] cds
Line 1: Line 1:
 +====== Problemfall dokumentieren  ======
 +[[:german#rocview|{{  :viewer.png}}]][[:english|{{  :rocrail-logo-35.png}}]]
 +[[:german|Inhalt]] -> [[:german#rocview|Rocview ]]
 +  * **Problemfall dokumentieren**
 + \\
 +^  Menü-Ort |  //Rocview -> Hilfe -> Problemfall...//  | 
 +^  Werkzeugleisten-Symbol |  {{:issue:issue.png}} oder {{:issue:issue_c.png}}  |
 + \\
 +===== Schnellstart =====
 +//Wenn ein Problem im __**[[http://forum.rocrail.net|Rocrail Forum]]**__ gemeldet wird, müssen einige wesentliche Dateien mitgeliefert werden, die mit dieser Funktion einfach in ein paar Schritten zusammengestellt werden können: //
 +  - Deinstallieren aller __zusätzlichen__ Virus- und anderer Scanner; Neustart.
 +  - __**A K T U A L I S I E R E N**__ der Rocrail-Installation. __**Das ist wichtig**__ :!:  __**[[https://wiki.rocrail.net/rocrail-snapshot/|Rocrail Update]]**__ 
 +  - Alte ** *.trc**-Dateien löschen.
 +  - Den betroffenen Arbeitsbereich öffnen.
 +  - __**[[:rocgui-menu-de#aktionen_aktivieren|Aktionen deaktivieren]]**__.
 +  - Die erforderlichen Trace-Optionen aktivieren: ([[rocgui-menu-de#rocrail_trace|Datei -> Rocrail-Trace -> Problemfall]])
 +    - Wenn unbekannt ist, was benötigt wird: **Informationen**
 +    - Automatik-Betrieb: **Informationen + Automatik**
 +    - Zentralen-Problem: **Informationen + Monitor** 
 +  - Rocrail betreiben, bis das Problem auftritt.
 +  - Das **Hilfe**-Menü in Rocview öffnen.
 +  - **Problemfall...** auswählen.
 +  - Einen Text in das **Thema**-Feld schreiben; Zum Beispiel: "Weiche funktioniert nicht". (Keine Sonderzeichen/Umlaute verwenden :!: ) 
 +  - Optional detailliertere Informationen zum Problemfall in den Text-Bereich **Beschreibung** schreiben.
 +  - **OK** anklicken.
 +  - 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. 
 +  - Wurde die **issue.zip**-Datei nicht automatisch erzeugt, muss das Unterverzeichnis "issue" mit einem ZIP-Programm gezippt werden.
 +
 +**Hinweis:** Wenn Rocrail beendet wird, bevor das Problem erstellt werden konnte, den Arbeitsbereich in eine ZIP-Datei komprimieren und im Forum veröffentlichen.
 + \\
 +
 +=====Modul-Anlagen=====
 +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.
 +
 + \\
 +
 +
 +
 +===== Trace-Intensität (Trace levels) =====
 +Nur die die wirklich notwendige __**[[rocrailini-trace-de|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 ...
 +
 + \\
 +
 +===== Vorbereitung =====
 +  - Alle unnötigen Trace-Ebenen abschalten.
 +  - Die Umgebung vorbereiten, die für die Reproduktion des Problems erforderlich ist.
 +  - Neustarten, falls nötig.
 +  - __**[[:rocgui-menu-de#aktionen_aktivieren|Aktionen deaktivieren]]**__.
 +  - Die Reproduktion des Problems so kurz halten wie möglich.
 +  - In den __**[[#beschreibung|Problemfall-Dialog]]**__ eine Schritt für Schritt-Liste schreiben, wie das Problem reproduziert werden kann.
 +
 + \\
 +
 +===== Speicherort des Problemfalls =====
 +{{ :issue:issue-explorer-en.png}}
 +Der Problem-Ordner (normal **issues**) ist standardmäßig in der Arbeitsbereichs-Umgebung, kann aber in der Registerkarte __**[[:rocrailini-gen-de#problemfallpfad|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.\\
 +
 + \\
 +
 +\\
 +\\
 +\\
 +\\
 +\\
 +\\
 +===== Problem als Forums-Beitrag=====
 +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:\\
 +\\ 
 +{{:attach-file-forum-de.jpg?600}}\\
 + \\
 +
 +===== Hilfe-Menü =====
 +{{:issue:issue-menu-de.png}}
 + \\
 +
 +===== Beispiel =====
 +==== Dialog ====
 +{{:issue:issuedlg-de.png}}\\
 +===Thema===
 +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** |
 +===Pfad===
 +Optionaler Pfad für das Speichern der Problemfall-Dateien, falls der Server auf dem gleichen Computer läuft, wie Rocview.\\
 +===Beschreibung===
 +Kurze Beschreibung des Problems, ggf. Schritt für Schritt, wie das Auftreten des Problems reproduziert werden kann. Dies ist optional, aber sehr zu empfehlen.\\
 +
 +==== Verzeichnis-Inhalte ====
 +^ issues/Der_Zug_faehrt_nicht ^^
 +| issue.txt | Inhalt des Problemfall-Dialogs und Server-Statistik. |
 +| plan.xml | Speicherabbild von //model//, dass alle separaten XML-Dateien wie Module und Loks enthält. (Der Dateiname ähnelt der ''rocrail.ini'', könnte aber anders sein und der vorhergehende Pfad wird entfernt). |
 +| occ.xml | Speicherabbild der Belegung und Logischen Richtung. |
 +| rocrail.ini | Speicherabbild der Server-Einstellungen. (Der vorhergehende Pfad wird entfernt). |
 +| rocrail.trc | Kopie der aktuellen Trace-Datei. | \\
 +
 + \\
 +
 +==== Bericht ====
 +issue.txt:
 +<code>
 +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"
 +
 +</code>
 +\\
 +===== Markieren eines Forum-Themas als gelöst =====
 +
 +  * 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 [[https://www.rocrail.info/t28629f1564-Thema-erledigt-geloest-wie-handhaben-erledigt.html#msg319391|hier]] nachgelesen werden.