Difference between revisions of "Appendix 2 Tut3"

From English DMXC-Wiki
Jump to navigation Jump to search
 
(17 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Hauptüberschrift
+
{{Maintitle
 
| logo = Im-aim.png
 
| logo = Im-aim.png
| ueberschrift = First Steps: {{PAGENAME}}
+
| maintitle = First Steps: {{PAGENAME}}
 
}}
 
}}
 +
{{NavigationTop-Tut3
 +
| LinkBackwards = Appendix_1_Tut3
 +
| 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 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:
 +
{{Picture_with_subtitle |DMXC3_Tutorial_Appendix_Error.png|1|Error in DMXControl 3 Beta|center|700px}}
 +
  
{{DMXC3_lesson/en}}
+
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:
  
__NOTOC__
+
Have a look into the '''Logs panel''' ('''Help''' => '''Logs''').
__NOTITLE__
+
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}}
{{Hauptüberschrift
 
| logo = Im-aim.png
 
| ueberschrift = First Steps: {{PAGENAME}}
 
}}
 
  
{{DMXC3_lesson/en}}
 
  
+
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.
 +
The '''bugtracker''' for DMXControl 3 you can also find directly under www.dmxcontrol.de/flyspray/index.php?project=3&do=index&switch=1.
  
===The kernel menu structure===
 
  
 +
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.
 
   
 
   
  
The kernel provides a command shell. By typing "help" you get an overview about all supported commands.
+
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}}
  
[[File:DMXC3L01 konsole.JPG|600px]]
 
  
 +
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.
  
There are some command options in the command line mode for getting detailed information on the status of the kernel:
 
  
* shutdown: Shut down the kernel.
+
===Issue: Kernel not starting===
* status: Displays information about the status
+
Symptoms:
* menu: Access to control menu
+
* Kernel does not start.
* clear: Clears the console
+
sourcecode
* notification xxx: Sends a notification text to all connected Sessions
+
1 2013-01-07 12:50:38,692 [Main] ERROR org.dmxc.lumos.Kernel.Resource.Xml2ManagedTreeConverter - Error in Reading KeyValue Pair: Attribute
* width xxx: Defines the width of the console (number of characters)
+
2 System.InvalidOperationException: Temporäre Klasse kann nicht generiert werden (result=1).
* load xxx: Loads a project from a file
+
3 error CS0016: In die Ausgabedatei c:\Users\Jens\AppData\Local\Temp\tugsyzgs.dll konnte nicht geschrieben werden -- Zugriff verweigert.
* save xxx: Saves current project to a file
 
* dmxout [channel, val]+: Sets DMX Out Values
 
* dmxin [channel, val]+: Sets DMX In Values
 
* help: Help menu (also accessible via "?")  
 
  
Additional second level menu commands exists for "menu" and "status".
+
Prerequisites:
 +
* Comodo Personal Firewall / Internet security installed
  
menu commands
+
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?)
  
* AssemblyManager
+
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.
  
  
__NOTOC__
+
===Issue: Grouping of icons ins stage view does not work.===
__NOTITLE__
+
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
  
 
+
{{NavigationTop-Tut3
[[de:Anhang 2]]
+
| LinkBackwards = Appendix_1_Tut3
[[en:Appendix 2]]
+
| 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}}}
Arrow back.png Appendix_1
table of content

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
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
Arrow back.png Appendix_1
table of content