---- '''12 Troubleshooting ''' [=#point12] ([wiki:Wiki-en#point0 Contents]) ([WikiStart#point0 Main page]) ---- In this section it explains how to formally submit a bug and provide debug logs so that this imformation is provided to the developers to action, it will explain how to use the trac ticket system to check and submit bugs for futher analisis. [[br]] * Only a __registered__ Users__ can create __Tickets__. If you are not yet registered, you can register here __[http://sbnc.dyndns.tv/trac/register Register]__ * The __User__ must be logged in, You can __[http://sbnc.dyndns.tv/trac/login Login]__ here * To achieve a faster and easier __trouble shooting__, we now offer the __Ticketsytem__. That way you can directly pinpoint your __error__ to the competent __Developer__. In the next steps we will explain the new __Ticketsystem__.[[Br]] * First, check the existing __ Tickets__ if the error has already been reported. This is done as follows. [[Br]] * Click the button __[http://sbnc.dyndns.tv/trac/report View Tickets]__ or go directly to __[http://sbnc.dyndns.tv/trac/report/1 Active Tickets]__.[[br]] * Click on __[http://sbnc.dyndns.tv/trac/search Search]__ and tick the __Tickets__ and begin the search. * Here you can see the current __active Tickets__, if the same error is listed, you can attach your error message to the __Ticket__.[[Br]] ---- '''12.1 Report a new Error''' [=#point12.1] ([wiki:Wiki-en#point0 Contents]) ([WikiStart#point0 Main page]) ---- * You have discovered a new bug and it has not been reported so you want to create a new ticket[[br]] * Click the button __[http://sbnc.dyndns.tv/trac/newticket New Ticket]__[[br]] * The following fields __need__ to be filled in.[[Br]] * __Summary:__ - This is the __displayed name__ of the reported error[[br]] * __Description:__ - Copy the link from the __[http://www.aaf-digital.info/forum/forum.php AAF Board (Community)]__ where the posting was made. - If no posting excists in the __Community__ you can describe the error here.[[br]] * __Component:__ - Set the critaria suiting the error so the appropriate __Developer__ is informed.[[br]] * __Responsible:__ - Here the ticket can explicitly be assigned to a specific __Developer__. * The following fields can be __filled in__. [[Br]] * __Priority:__ - Blocker - __very urgent__ the __ticket__ requires urgent attention. - Critical - __urgent__ other tickets or processes depend upon this error. - Major - __standard__ urgency (__default__). - Minor - __minor__ has a lot of time and __is not so important__. - trivial - __of no importance__ has even more time and __is least__ important. * __Milestone:__ - Default is __standard__ if a more appropriate urgency is required it can be used. * __Tags__ - This information is used by the __[http://sbnc.dyndns.tv/trac/search Search]__ - is usually not specified/required. * __Version:__ - Is only applicable from version __2.0__ * __Observer:__ - Only a __Developer__ need to fill in this field if he wants to assign this ticket to a __User__, the user then sees it in __[http://sbnc.dyndns.tv/trac/report/7 My Tickets] __ * To complete the ticket you click on the field __create Ticket__ [[br]] [#point12 Top of Page] ---- '''12.2 Bug Update''' [=#point12.2] ([wiki:Wiki-en#point0 Contents]) ([WikiStart#point0 Main page]) ---- * You have discovered a bug and it has been reported but you have aditional information that may be helpfull to the developers to repair the problem or have aditional comments on the problem[[br]] * Click the __[http://sbnc.dyndns.tv/trac/report Show Tickets]__ > __[http://sbnc.dyndns.tv/trac/report/1 Active Tickets]__ or __ [http://sbnc.dyndns.tv/trac/search Search]__ Button and __open__ the existing.[[br]] * The following fields __must__ be filled in.[[Br]] * __Add comment__: - Here you can add more details to the error description.[[br]] * To complete the ticket you click on __Submit changes__ [[br]] [#point12 Top of Page] ---- '''12.3 Bug Resolve (Report error as completed)''' [=#point12.3] ([wiki:Wiki-en#point0 Contents]) ([WikiStart#point0 Main page]) ---- * You have discovered a previously reported bug is now fixed and want to close the ticket to inform the dev the bug is now fixed.[[br]] * Click on __[http://sbnc.dyndns.tv/trac/report View Tickets]__ > __[http://sbnc.dyndns.tv/trac/report/1 Active Tickets]__ and open the respective ticket[[br]] * Scroll down to Action and set the field __resolve as__ to __fixed__ * Click on the field _Submit changes__ [[br]] [#point12 Top of Page] ---- '''12.4 DebugLevel''' [=#point12.4] ([wiki:Wiki-en#point0 Contents]) ([WikiStart#point0 Main page]) ---- * In the Configuration file /mnt/config/titan.cfg you can set following debug levels * Minimal: 10 * TopfieldVFD: 40 * Media Center: 50 * MenuList: 60 * Network Browser: 70 * Hard Disk: 80 * Screensaver: 90 * Tithek: 99 * Global: 100 * Ipkg: 130 * Imdb/imdbapi/TMDB: 133 * Eplayer: 150 * Tuning: 200 * Stream/Record/Softcam: 250 * Radio text: 270 * Subtitle: 300 * EPG: 400 * MediaDB: 777 * Mutexes: 900 * Function (in/out): 1000 * The default debug level = 10 [[br]] [#point12 Top of Page] ---- '''12.5 Debug Logging''' [=#point12.5] ([wiki:Wiki-en#point0 Contents]) ([WikiStart#point0 Main page]) ---- Logging is a means of getting debug messages from the reciever for development and bug tracking purposes, this can be used to attach to a bug report or track ticked to assist the developer to find where a problem or bug may be traced from. * You have several options for logging * via Telnet: * A Network connection is assential * Client ([http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html Putty]) configure the PC for Telnet session * Open the Telnet session to the receiver * Killall -9 rcS titan * Set: ([#point112.4 DebugLevel=]) * Titan /mnt/config/titan.cfg > /tmp/titan.error.log 2> & 1 * To terminate logging press (ctrl+z) * Copy the log file (/tmp/titan.error.log) to your PC via ftp and send it as a ticket to the respective Developer * Via RS232 (serial connection) * A Serial connection must consist * Configure ([http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html Putty]) on the PC for Serial * Open serial session to the receiver * Then send it as a ticket to the respective Developer * Using debug Images you can also query the kernel messages via a telnet session * Network connection must exist * Configure ([http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html Putty]) on the PC for Serial * Open serial session to the receiver * cat/proc/kmsg > /tmp/titan.kernel.log 2>&1 * To terminate logging press (ctrl+z) * Copy the log file (/tmp/titan.kernel.log) to your PC via ftp and send it as a ticket to the respective Developer [[br]] [#point12 Top of Page]