No edit summary |
No edit summary |
||
| (13 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
{{Maintitle | |||
| logo = Im-aim.png | | logo = Im-aim.png | ||
| | | maintitle = First Steps: {{PAGENAME}} | ||
}} | }} | ||
{{NavigationTop-Tut3 | {{NavigationTop-Tut3 | ||
| LinkBackwards = Appendix_1_Tut3 | | LinkBackwards = Appendix_1_Tut3 | ||
| TextBackwards = Appendix_1 | | TextBackwards = Appendix_1 | ||
}} | }} | ||
==Hints for testing and error handling== | |||
In this article you will find out what you should do in case of a fault in order to support developers | In this article you will find out what you should do in case of a fault in order to support developers with debugging. You will receive information on how you can check for errors and how and where you can report a bug. But first, you learn something about the targeted search for errors. | ||
==An error occurs== | ==An error occurs== | ||
You are doing something in DMXControl 3. Then suddenly: | You are doing something in DMXControl 3. Then suddenly: | ||
{{ | {{Picture_with_subtitle |DMXC3_Tutorial_Appendix_Error.png|1|Error in DMXControl 3 Beta|center|700px}} | ||
The error occurs in the beta is not serious and can happen. | The error occurs in the beta. It is not serious and can happen. But, it would be bad if this error is undocumented, because it can not be resolved. Therefore, you should proceed as follows: | ||
Have a look into the '''Logs panel''' ('''Help''' => '''Logs'''). | Have a look into the '''Logs panel''' ('''Help''' => '''Logs'''). | ||
There DMXControl writes information about the latest events. At the bottom now one or more entries as | There DMXControl writes information about the latest events. At the bottom now one or more entries, as can be seen in Figure 2, are probably present. | ||
{{ | {{Picture_with_subtitle |DMXC3_Tutorial_Appendix_Logs.png|2|Logs-Panel in DMXControl 3|center|700px}} | ||
Furthermore, these log messages are stored in files. This you should definitely export ('''Help =>'''Export log files'''), because they are needed | Furthermore, these log messages are stored in files. This you should definitely export ('''Help =>'''Export log files'''), because they are needed later. | ||
{{ | {{Picture_with_subtitle |DMXC3_Tutorial_Appendix_ExportLogs.png|3|Export function for log files|center}} | ||
If you can reproduce this fault, please report it via '''bug tracker''' on DMXControl home page. | If you can reproduce this fault, please report it via '''bug tracker''' on DMXControl home page. | ||
| Line 32: | Line 30: | ||
There all errors are collected so that the developers | There all errors are collected so that the developers can easily see the error and fix it. You can report a fault completely anonymously, but it's better to register if there are any further questions. There is no further obligation. | ||
Before you report a bug, please search | Before you report a bug, please, first search if this bug is already listed in the bug tracker. If the fault a new one, you can report it via '''Create new task'''. | ||
{{ | {{Picture_with_subtitle |DMXC3_Tutorial_Appendix_Bugtracker.png|4|View of our Bugtracker|center|700px}} | ||
Please describe as accurately as possible | Please describe as accurately as possible how you came to this error. Please also attach your project and the exported log files to the new task in the bugtracker. Then, hopefully, the developers can fix this soon. | ||
Thanks for your support! | Thanks for your support! | ||
==Known Issues== | ==Known Issues== | ||
===Issue: GUI Elements display glitches=== | ===Issue: GUI Elements display glitches=== | ||
Symptoms: | Symptoms: | ||
* This could look like shown below: | |||
* Also if you move windows it happens that thay are not displayed correct. | |||
Dmxc_3_menu_errors.jpg | |||
* This can occur if you have a NVidia graphics card and use an old driver version. | |||
Prerequisites: | Prerequisites: | ||
* I experienced this issue with a GeForce G 103M Driver Version 258.96 + PhysX 09.10.0513 on Windows XP x86_64. | |||
Cause: | Cause: | ||
* unknown | |||
Resolution: | Resolution: | ||
* Consider updating the driver to the latest version. Version 266.58 + PhysX 09.10.0514 is known to work. | |||
===Issue: Kernel not starting=== | ===Issue: Kernel not starting=== | ||
Symptoms: | Symptoms: | ||
* Kernel does not start. | |||
sourcecode | |||
1 2013-01-07 12:50:38,692 [Main] ERROR org.dmxc.lumos.Kernel.Resource.Xml2ManagedTreeConverter - Error in Reading KeyValue Pair: Attribute | |||
2 System.InvalidOperationException: Temporäre Klasse kann nicht generiert werden (result=1). | |||
3 error CS0016: In die Ausgabedatei c:\Users\Jens\AppData\Local\Temp\tugsyzgs.dll konnte nicht geschrieben werden -- Zugriff verweigert. | |||
Prerequisites: | Prerequisites: | ||
* Comodo Personal Firewall / Internet security installed | |||
Cause: | Cause: | ||
* Comodo runs Lumos in a sandbox. This sandbox prohibits access to some files or locations. | |||
* Lumos uses XmlSerializer to (de)serialize objects that it doesn't know. To instantiate a XmlSerializer object the CLR creates temporary assemblies and loads them afterwards. These assemblies are stored in AppData\Local\Temp\ however the sandbox doesn't allow (write) access to this directory (wtf?) | |||
Resolution: | Resolution: | ||
* Put Lumos.exe on the list of trusted applications | |||
* Should we contact Comodo and try to get on their shipped whitelist? | |||
* There is the possibility to generate this XmlSerializer assemblies at compile time and then ship them, but plugin authors would need to do the same. Then we get a huge chaos because there are different versions for the same types out. Also this stuff needs to be in the Kernel root dir... Stuff from third parties belongs in the plugin dir. | |||
===Issue: Grouping of icons ins stage view does not work.=== | |||
===Issue: Grouping of icons ins stage view does not work.=== | |||
Symptoms: | Symptoms: | ||
* If you hold down a button (e.g. m for matrix grouping) and move the mouse, the icons are not getting moved. Btw. this is not an issue in regards to Lumos, this symptom also occurs if you try this on your desktop | |||
Prerequisites: | Prerequisites: | ||
* Synaptics Touchpad | |||
Cause: | Cause: | ||
* Synaptics implemented an option called PalmCheck which should reduce cursormovement while typing. Whenever a button is pressed the mouse input gets disabled... | |||
Resolution: | Resolution: | ||
* This option can be disabled unter Control Panel->Mice->Device Settings->Settings->(Point)->Sensitivity->PalmCheck | |||
{{NavigationTop-Tut3 | {{NavigationTop-Tut3 | ||
| LinkBackwards = Appendix_1_Tut3 | | LinkBackwards = Appendix_1_Tut3 | ||
| TextBackwards = Appendix_1 | | TextBackwards = Appendix_1 | ||
}} | }} | ||
[[ | [[de: Anhang_2_Tut3]] | ||
[[Category: Tutorials DMXControl 3]] | |||
Latest revision as of 11:02, 16 May 2013
| [[File:{{{Logo}}}|48px|link=]] | {{{Pagetitle}}} |
Hints for testing and error handling
In this article you will find out what you should do in case of a fault in order to support developers with debugging. You will receive information on how you can check for errors and how and where you can report a bug. But first, you learn something about the targeted search for errors.
An error occurs
You are doing something in DMXControl 3. Then suddenly:
Error creating thumbnail: File missing
|
| Picture 1: Error in DMXControl 3 Beta |
The error occurs in the beta. It is not serious and can happen. But, it would be bad if this error is undocumented, because it can not be resolved. Therefore, you should proceed as follows:
Have a look into the Logs panel (Help => Logs). There DMXControl writes information about the latest events. At the bottom now one or more entries, as can be seen in Figure 2, are probably present.
Error creating thumbnail: File missing
|
| Picture 2: Logs-Panel in DMXControl 3 |
Furthermore, these log messages are stored in files. This you should definitely export (Help =>Export log files), because they are needed later.
|
| Picture 3: Export function for log files |
If you can reproduce this fault, please report it via bug tracker on DMXControl home page.
The bugtracker for DMXControl 3 you can also find directly under www.dmxcontrol.de/flyspray/index.php?project=3&do=index&switch=1.
There all errors are collected so that the developers can easily see the error and fix it. You can report a fault completely anonymously, but it's better to register if there are any further questions. There is no further obligation.
Before you report a bug, please, first search if this bug is already listed in the bug tracker. If the fault a new one, you can report it via Create new task.
Error creating thumbnail: File missing
|
| Picture 4: View of our Bugtracker |
Please describe as accurately as possible how you came to this error. Please also attach your project and the exported log files to the new task in the bugtracker. Then, hopefully, the developers can fix this soon. Thanks for your support!
Known Issues
Issue: GUI Elements display glitches
Symptoms:
- This could look like shown below:
- Also if you move windows it happens that thay are not displayed correct.
Dmxc_3_menu_errors.jpg
- This can occur if you have a NVidia graphics card and use an old driver version.
Prerequisites:
- I experienced this issue with a GeForce G 103M Driver Version 258.96 + PhysX 09.10.0513 on Windows XP x86_64.
Cause:
- unknown
Resolution:
- Consider updating the driver to the latest version. Version 266.58 + PhysX 09.10.0514 is known to work.
Issue: Kernel not starting
Symptoms:
- Kernel does not start.
sourcecode
1 2013-01-07 12:50:38,692 [Main] ERROR org.dmxc.lumos.Kernel.Resource.Xml2ManagedTreeConverter - Error in Reading KeyValue Pair: Attribute 2 System.InvalidOperationException: Temporäre Klasse kann nicht generiert werden (result=1). 3 error CS0016: In die Ausgabedatei c:\Users\Jens\AppData\Local\Temp\tugsyzgs.dll konnte nicht geschrieben werden -- Zugriff verweigert.
Prerequisites:
- Comodo Personal Firewall / Internet security installed
Cause:
- Comodo runs Lumos in a sandbox. This sandbox prohibits access to some files or locations.
- Lumos uses XmlSerializer to (de)serialize objects that it doesn't know. To instantiate a XmlSerializer object the CLR creates temporary assemblies and loads them afterwards. These assemblies are stored in AppData\Local\Temp\ however the sandbox doesn't allow (write) access to this directory (wtf?)
Resolution:
- Put Lumos.exe on the list of trusted applications
- Should we contact Comodo and try to get on their shipped whitelist?
- There is the possibility to generate this XmlSerializer assemblies at compile time and then ship them, but plugin authors would need to do the same. Then we get a huge chaos because there are different versions for the same types out. Also this stuff needs to be in the Kernel root dir... Stuff from third parties belongs in the plugin dir.
Issue: Grouping of icons ins stage view does not work.
Symptoms:
- If you hold down a button (e.g. m for matrix grouping) and move the mouse, the icons are not getting moved. Btw. this is not an issue in regards to Lumos, this symptom also occurs if you try this on your desktop
Prerequisites:
- Synaptics Touchpad
Cause:
- Synaptics implemented an option called PalmCheck which should reduce cursormovement while typing. Whenever a button is pressed the mouse input gets disabled...
Resolution:
- This option can be disabled unter Control Panel->Mice->Device Settings->Settings->(Point)->Sensitivity->PalmCheck
| |||||||||||