issue-en
Differences
This shows you the differences between two versions of the page.
— | issue-en [2025/01/06 11:56] (current) – created - external edit 127.0.0.1 | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | [[: | ||
+ | ====== Create an issue ====== | ||
+ | [[: | ||
+ | [[: | ||
+ | * **Issue** | ||
+ | | ||
+ | | Menu location | //Rocview -> Help -> Issue// | | ||
+ | | Toolbar icon | {{: | ||
+ | |||
+ | \\ | ||
+ | |||
+ | ===== Quick start ===== | ||
+ | //If you report a problem in the __**[[http:// | ||
+ | - Deinstall all __extra__ Virus and other scanners; Reboot. | ||
+ | - __**U P D A T E**__ the Rocrail installation. __**This is very essential**__ :!: __**[[https:// | ||
+ | - Delete old ** *.trc** files. | ||
+ | - Open your workspace. | ||
+ | - __**[[: | ||
+ | - Activate the required trace options: | ||
+ | - Don't know what to select: **Information** | ||
+ | - Drive automatically: | ||
+ | - Controller problem: **Information + Monitor** | ||
+ | - Operate Rocrail until the problem occurs. | ||
+ | - Open the **Help** menu in Rocview. | ||
+ | - Select **Issue**. | ||
+ | - Write some text in the **Subject** field (do not use special characters); | ||
+ | - Optionally write some detailed information about your issue in the **Description** text area. | ||
+ | - Click on **OK**. | ||
+ | - A file explorer window will open with a file named **issue.zip** which can be attached in the Forum. \\ At the bottom of the Forum entry is a " | ||
+ | - If the zip file is not created automatically, | ||
+ | |||
+ | **Notes: | ||
+ | * The issue files will be found on the server computer if Rocview runs on another computer. | ||
+ | * Modular plans cannot use this function and must be assembled manually, including all modules. | ||
+ | * If Rocrail terminates before you can create the issue, then zip your workspace together and post it in the forum. | ||
+ | |||
+ | \\ | ||
+ | At the bottom of the forum contribution there is a function " | ||
+ | \\ | ||
+ | |||
+ | =====Modular layouts===== | ||
+ | Creating an issue in case of a modular layout will flatten it into one plan file.\\ | ||
+ | Zipping the complete directory will be the better way for this type of layouts.\\ | ||
+ | |||
+ | \\ | ||
+ | |||
+ | ===== Trace levels ===== | ||
+ | Activate only __**[[rocrailini-trace-en|server trace levels]]**__ which are really necessary.\\ | ||
+ | * Byte trace level makes only sense in case of communication issues. | ||
+ | * Automatic mode trace level makes only sense in case of automatic mode issues. | ||
+ | * And so on... | ||
+ | |||
+ | \\ | ||
+ | |||
+ | ===== Preparation ===== | ||
+ | - Switch off all unnecessary trace levels. | ||
+ | - Prepare the environment as needed for reproduction of the issue. | ||
+ | - Restart if needed. | ||
+ | - __**[[: | ||
+ | - Make the reproduction of the issue as short as possible. | ||
+ | - Write in the Issue Dialog a step by step list on how to reproduce it. | ||
+ | |||
+ | |||
+ | \\ | ||
+ | ===== Location of the Issue ===== | ||
+ | {{ : | ||
+ | This issues folder is by default in the workspace environment but can be modified in the __**[[: | ||
+ | In the server trace window the fully qualified path will be shown.\\ | ||
+ | If the server runs on the same computer a file explorer window will be opened which contains all files which can be compressed into one file for uploading in to the forum. With newer revisions an **issue.zip** file is created automatically.\\ | ||
+ | Optional another path can be selected if the server runs on the same computer.\\ | ||
+ | |||
+ | \\ | ||
+ | |||
+ | ===== Posting the Issue ===== | ||
+ | Compress the Issue directory into a ' | ||
+ | Attach this ' | ||
+ | {{: | ||
+ | \\ | ||
+ | |||
+ | ===== Help Menu ===== | ||
+ | {{: | ||
+ | |||
+ | |||
+ | \\ | ||
+ | ===== Example ===== | ||
+ | ==== Dialog ==== | ||
+ | {{: | ||
+ | ===Subject=== | ||
+ | The subject of the issue. (Mandatory)\\ | ||
+ | //Do not use special characters in the subject because it is used for building a filename, which can be platform dependent.// | ||
+ | ===Path=== | ||
+ | Optional path for storing the issue files in case the server runs on the same computer as Rocview.\\ | ||
+ | ===Description=== | ||
+ | Short description of the issue. This is optional but highly recommended.\\ | ||
+ | |||
+ | \\ | ||
+ | |||
+ | ==== Directory contents ==== | ||
+ | ^ issues/ | ||
+ | | issue.txt | Content of issue dialog and statistics of server. | | ||
+ | | plan.xml | Memory dump of model which includes all separate input XML files like modules and locos. (The file name will resemble the rocrail.ini and could be different, and the preceding path will be removed.) | | ||
+ | | occ.xml | Memory dump of occupancy and placing. | | ||
+ | | rocrail.ini | Memory dump of server settings. (The preceding plan file path will be removed.) | | ||
+ | | rocrail.trc | Copy of current trace file(s). | \\ | ||
+ | |||
+ | These files are contained in an " | ||
+ | |||
+ | ==== Adding a file to the forum ==== | ||
+ | |||
+ | {{: | ||
+ | |||
+ | At the bottom of the forum there is an option " | ||
+ | Select the file you want to place in the forum with the "Add files" option and then press " | ||
+ | |||
+ | \\ | ||
+ | |||
+ | ==== Report ==== | ||
+ | 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 = / | ||
+ | allocation count = 17555 | ||
+ | allocated memory | ||
+ | clients | ||
+ | connections | ||
+ | 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) | ||
+ | ---------------------------------------- | ||
+ | | ||
+ | Error open file [netroutes.xml] [rb] | ||
+ | Error open file [netroutes.xml] [rb] | ||
+ | block [03] not found | ||
+ | block [02] not found | ||
+ | block [01] not found | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | |||
+ | 13 threads: | ||
+ | ---------------------------------------- | ||
+ | timedoff " | ||
+ | clockticker " | ||
+ | r2rreader " | ||
+ | V200 " | ||
+ | infw035C98E0 " | ||
+ | broadcast " | ||
+ | tick06F00E00 " | ||
+ | checker " | ||
+ | cconmngr " | ||
+ | r2rwriter " | ||
+ | vcs-1 " | ||
+ | E03 " | ||
+ | cmdr035C98E0 " | ||
+ | |||
+ | </ | ||
+ | \\ | ||
+ | ===== Setting an Entry in the Forum as solved ===== | ||
+ | |||
+ | * Navigate to the first posting in your thread | ||
+ | * Choose button " | ||
+ | * Got to the very end of the subject line | ||
+ | * For Windows: press key " | ||
+ | * For Apple: press [FN], a table with icons appears. If it does not appear, set the function "Show Emoji & Symbols" | ||
+ | * Choose tickmark | ||
+ | * Press button "Save changes" |