source: wiki/pages/en/Troubleshooting @ 37351

Last change on this file since 37351 was 28652, checked in by aafsvn, 10 years ago

[titan] autoupdate wiki files

File size: 7.2 KB
Line 
1----
2'''12  Troubleshooting ''' [=#point12] ([wiki:Wiki#point0 Contents]) ([WikiStart#point0 Main page])
3----
4
5== Troubleshooting Contents ==
6 
7This section 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.
8
9* Only a __registered__ Users__ can create __Tickets__. If you are not yet registered, you can register here __[http://sbnc.dyndns.tv/trac/register Register]__
10* The __User__ must be logged in, You can __[http://sbnc.dyndns.tv/trac/login Login]__ here
11* 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]]
12* First, check the existing __ Tickets__ if the error has already been reported. This is done as follows. [[Br]]
13  * 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]]
14  * Click on __[http://sbnc.dyndns.tv/trac/search Search]__ and tick the __Tickets__ and begin the search.
15  * Here you can see the current __active Tickets__, if the same error is listed, you can attach your error message to the __Ticket__.[[Br]]
16
17
18 please select an item below for more information.
19
20 * ([#point12.1 12.1 Bug Reporting])
21 * ([#point12.2 12.2 Bug Update])
22 * ([#point12.3 12.3 Bug Resolve])
23 * ([#point12.4 12.4 Debuglevel])
24 * ([#point12.5 12.5 Debug logging])
25[[br]]
26
27----
28'''12.1 Report a new Error''' [=#point12.1] ([wiki:Wiki#point0 Contents]) ([WikiStart#point0 Main page])
29----
30
31* You have discovered a new bug and it has not been reported so you want to create a new ticket[[br]]
32* Click the button __[http://sbnc.dyndns.tv/trac/newticket New Ticket]__[[br]]
33  * The following fields __need__ to be filled in.[[Br]]
34    * __Summary:__
35      - This is the __displayed name__ of the reported error[[br]]
36    * __Description:__
37      - Copy the link from the __[http://www.aaf-digital.info/forum/forum.php AAF Board (Community)]__ where the posting was made.
38      - If no posting excists in the __Community__ you can describe the error here.[[br]]
39    * __Component:__
40      - Set the critaria suiting the error so the appropriate __Developer__ is informed.[[br]]
41    * __Responsible:__
42      - Here the ticket can explicitly be assigned to a specific __Developer__.
43  * The following fields can be __filled in__. [[Br]]
44    * __Priority:__
45      - Blocker - __very urgent__ the __ticket__ requires urgent attention.
46      - Critical - __urgent__ other tickets or processes depend upon this error.
47      - Major - __standard__ urgency (__default__).
48      - Minor - __minor__ has a lot of time and __is not so important__.
49      - trivial - __of no importance__ has even more time and __is least__ important.
50    * __Milestone:__
51      - Default is __standard__ if a more appropriate urgency is required it can be used.
52    * __Tags__
53      - This information is used by the __[http://sbnc.dyndns.tv/trac/search Search]__ - is usually not specified/required.
54    * __Version:__
55      - Is only applicable from version __2.0__
56    * __Observer:__
57      - 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] __
58
59  * To complete the ticket you click on the field __create Ticket__
60[[br]]
61[#point12 Top of Page]
62----
63'''12.2 Bug Update''' [=#point12.2] ([wiki:Wiki#point0 Contents]) ([WikiStart#point0 Main page])
64----
65
66* 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]]
67* 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]]
68  * The following fields __must__ be filled in.[[Br]]
69    * __Add comment__:
70      - Here you can add more details to the error description.[[br]]
71  * To complete the ticket you click on __Submit changes__
72[[br]]
73[#point12 Top of Page]
74----
75'''12.3 Bug Resolve (Report error as completed)''' [=#point12.3] ([wiki:Wiki#point0 Contents]) ([WikiStart#point0 Main page])
76----
77
78
79* 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]]
80* 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]]
81  * Scroll down to Action and set the field __resolve as__ to __fixed__
82  * Click on the field _Submit changes__
83[[br]]
84[#point12 Top of Page]
85----
86'''12.4 DebugLevel''' [=#point12.4] ([wiki:Wiki#point0 Contents]) ([WikiStart#point0 Main page])
87----
88
89
90* In the Configuration file /mnt/config/titan.cfg you can set following debug levels
91  * Minimal: 10
92  * TopfieldVFD: 40
93  * Media Center: 50
94  * MenuList: 60
95  * Network Browser: 70
96  * Hard Disk: 80
97  * Screensaver: 90
98  * Tithek: 99
99  * Global: 100
100  * Ipkg: 130
101  * Imdb/imdbapi/TMDB: 133
102  * Eplayer: 150
103  * Tuning: 200
104  * Stream/Record/Softcam: 250
105  * Radio text: 270
106  * Subtitle: 300
107  * EPG: 400
108  * MediaDB: 777
109  * Mutexes: 900
110  * Function (in/out): 1000
111
112* The default debug level = 10
113[[br]]
114[#point12 Top of Page]
115----
116'''12.5 Debug Logging''' [=#point12.5] ([wiki:Wiki#point0 Contents]) ([WikiStart#point0 Main page])
117----
118
119Logging 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.
120
121
122* You have several options for logging
123 * via Telnet:
124  * A Network connection is assential
125  * Client ([http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html Putty]) configure the PC for Telnet session
126  * Open the Telnet session to the receiver
127  * killall -9 rcS titan
128  * Set: ([#point112.4 DebugLevel=])
129  * titan /mnt/config/titan.cfg > /tmp/titan.error.log 2>&1
130  * To terminate logging press (ctrl+z)
131  * Copy the log file (/tmp/titan.error.log) to your PC via ftp and send it as a ticket to the respective Developer
132 * Via RS232 (serial connection)
133  * A Serial connection must consist
134  * Configure ([http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html Putty]) on the PC for Serial
135  * Open serial session to the receiver
136  * Then send it as a ticket to the respective Developer
137
138* Using debug Images you can also query the kernel messages via a telnet session
139  * Network connection must exist
140  * Configure ([http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html Putty]) on the PC for Serial
141  * Open serial session to the receiver
142  * cat/proc/kmsg > /tmp/titan.kernel.log 2>&1
143  * To terminate logging press (ctrl+z)
144  * Copy the log file (/tmp/titan.kernel.log) to your PC via ftp and send it as a ticket to the respective Developer
145[[br]]
146[#point12 Top of Page]
Note: See TracBrowser for help on using the repository browser.