TVcentral V2:Fehlersuche

Aus Sceneo Wiki

Wechseln zu: Navigation, Suche

Treten bei der Verwendung von TVcentral Probleme auf, kann TVcentral im so genannten "Debug-Modus" gestartet werden.

Inhaltsverzeichnis


Der Debug-Modus

Der Debug-Modus beschreibt einen speziellen Betriebsmodus von TVcentral, in welchem sehr viel mehr Informationen rund um den Programmablauf festgehalten werden, als dies während der standardmäßigen Ausführung der Fall ist. Grundsätzlich werden die besagten Informationen in Logdateien geschrieben (die Informationen werden auch gerne als Logausgaben bezeichnet), welche im Anschluss mit einem gängigen Texteditor analysiert werden können.

Zusätzlich zu den Logdateien bietet TVcentral bereits während der Laufzeit im Debug-Modus die Möglichkeit an, ein Problem "direkt vor Ort" zu analysieren. Dazu blendet TVcentral ein zusätzliches Fenster ein, in welchem nochmals alle Logausgaben angezeigt werden.

Aktivierung des Debug-Modus

Um TVcentral in den Debug-Modus zu versetzen, wird der Anwendung beim Start der Parameter "debug" übergeben, wobei üblicherweise das Zeichen "-" vorangestellt wird, um die Anwendung auf einen folgenden Parameter hinzuweisen.

Um dies zu erreichen, wird eine neue Verknüpfung mit der Datei "Meedio.exe" erstellt, welche im TVcentral-Ordner zu finden ist. Ist dies geschehen, so wird in den Eigenschaften der neuen Verknüpfung das "Ziel" um "-debug" erweitert:

 ...\TVcentral\Meedio.exe -debug

Hierbei ist darauf zu achten, dass Dateipfad und Parameter durch ein Leerzeichen separiert werden.

Wird TVcentral nun über die neu erstellte Verknüpfung gestartet, so zeigt sich sehr schnell, dass das versprochene Logfenster nicht zu sehen ist. Der Grund liegt in der Vordergründigkeit seitens der TVcentral-Oberfläche, welche das Logfenster nun schlicht und ergreifend überdeckt. Da das Logfenster im selben Prozess läuft, wie TVcentral auch, ist ein einfaches Umschalten per ALT+TAB-Tastenkombination nicht möglich. Um das Logfenster nun doch sichtbar machen zu können, besitzt TVcentral noch weitere Startparameter, welche uns nun erlauben, die Größe, in welcher die TVcentral-Oberfläche erscheinen soll, frei zu definieren, so dass neben der Oberfläche noch genügend Platz bleibt, um das Logfenster zu betrachten.

Die Startparameter zur Größenanpassung ergeben sich zu "screen-width X" als Definition der Oberflächenfensterbreite sowie "screen-height Y" als Definition der Oberflächenfensterhöhe, wobei X und Y jeweils in Pixeln ausgedrückt werden. Die Parameter werden dabei in der Ziel-Eigenschaft der neuen Verknüpfung hinter dem debug-Parameter ergänzt.

Um TVcentral also im Debug-Modus bei einer Auflösung von 640x480 Pixeln zu starten, ergibt sich für unsere Ziel-Eigenschaft der neuen Verknüpfung der Inhalt:

 ...\TVcentral\Meedio.exe -debug -screen-width 640 -screen-height 480

Auch hier ist wiederum zu beachten, dass zwischen den Parametern jeweils ein Leerzeichen notiert werden muss.

Die Logdateien

Während des Betriebes (von TVcentral) erstellt TVcentral Logdateien, welche zur Fehlersuche herangezogen werden können. Welche Logdateien zur Laufzeit generiert werden, hängt im Wesentlichen von dem Betriebsmodus ab, in welchem TVcentral zum aktuellen Zeitpunkt ausgeführt wird:


Während die Logdateien Meedio.log und Meedio.service.log lediglich den allgemeinen Programmablauf protokollieren, enthalten die Dateien Meedio.debug.log und Meedio.service.debug.log sehr viele detailierte Informationen, welche die Lokalisierung möglicher Problemquellen konsequenter zulassen. Bei genauerer Betrachtung entspricht der Inhalt der beiden zuletzt genannten Logdateien exakt den Ausgaben, welche das TVcentral Logging System im Debug Fenster (siehe oben) ausgibt.

Die genannten Logdateien befinden sich nach ihrer Erstellung im TVcentral-Installationsverzeichnis.

Wird TVcentral im Debug-Modus ausgeführt, so ist der Zeitpunkt des Beginns der Logdateien-Erstellung mit dem TVcentral-Start gleichzusetzen. Es findet also eine Live-Erstellung der Logdateien statt, damit auch im Falle eines Absturzes von TVcentral Logdateien vorliegen, welche dann zur Analyse der Absturzursache verwendet werden können.

Neben den genannten, primären Logdateien werden noch weitere Logdateien (z.B. von einzelnen Plugins) generiert. Die wichtigsten Logdateien sind dabei:

Korrekte Vorgehensweise

Im Rahmen des Debug-Modus werden kontinuierlich Informationen zum Programmablauf gesammelt. Interessant sind die gesammelten Informationen jedoch nur dann, wenn sie auch die Informationen enthalten, welche die Problemstelle beschreiben. Um die Vorgänge rund um ein bestehendes Problem zu protokollieren, muss das Problem also mindestens einmal während der Laufzeit im Debug-Modus auftreten. Besteht bspw. das Problem, dass der Menüpunkt Fernsehen von TVcentral keinerlei Funktionalität aufweist (nach Betätigung des Menüpunktes passiert nichts), so ist folgende Vorgehensweise optimal:

  1. Starten von TVcentral im Debug-Modus
  2. Ein- oder mehrmaliges Betätigen des Menüpunktes Fernsehen
  3. Beenden von TVcentral

Wird diese Vorgehensweise strikt verfolgt, so ist sichergestellt, dass auch etwaige Fehlermeldungen protokolliert werden, die das Problem betreffen.

Persönliche Werkzeuge