Treten bei Ihnen beim Arbeiten mit PLANTA project Fehler auf, gehen Sie bitte folgendermaßen vor:
Prüfen Sie im PLANTA-Wiki unter Bekannten Problemen, ob der bei Ihnen auftretende Fehler auf der Seite aufgeführt ist.
Ist der Fehler noch nicht aufgeführt, schicken Sie uns eine Reproduktionsbeschreibung des Fehlers. Wir erfassen für Sie einen SRQ, mit dem Sie den Bearbeitungsstand nachverfolgen können.
Beim Melden des Fehlers beachten Sie die benötigten Informationen.
Ist der Fehler aufgeführt, schicken Sie uns eine kurze E-Mail mit dem Hinweis auf den Fehler (ohne Reproduktionsbeschreibung), so dass wir ebenfalls einen SRQ erfassen können.
Ist in Bekannten Problemen eine Umgehenslösung für den Fehler beschrieben, führen Sie diese aus.
Benötigte Informationen
Seit wann tritt der Fehler auf?
Gab es davor Änderungen (z.B. am Customizing, an der Technik, wurde ein Hotfix eingespielt etc.)?
Welche Konfiguration wird verwendet, u.a.: welche Iteration (Hotfix), welcher Datenbanktyp (MSSQL oder Oracle)?
Am einfachsten schicken Sie uns einen Screenshot des Moduls Systeminformation (STRG+B), welches alle benötigten Informationen beinhaltet.
Wird Windows oder Linux verwendet?
Ist der Fehler reproduzierbar oder tritt er nur sporadisch auf?
Ist der Fehler reproduzierbar, schicken Sie bitte die Reproduktionsbeschreibung. Diese muss folgendes beinhalten:
Benutzer (z,B. R41)
Pfad, Name sowie Nummer des Moduls, in dem das Problem auftritt (z.B. Multiprojektmanagement Multiprojektmanagement Ressourcenübersichten)
Über STRG+F2 wird das Modul Modulinformation aufgerufen, in diesem finden Sie die Modul-ID des entsprechenden Moduls
Welche Schritte führen zu dem Fehler? (z.B. Wechsel in das Untermodul Budget und Kosten nach Gruppen: Connection to server lost)
Hinweise
Bei der Beschreibung der Schritte bitte genau angeben, wie eine bestimmte Aktion durchgeführt wurde. Z.B. wurde über rechte Maus, über das Menü Einfügen, über F4 oder über Klick auf das grüne Plus in der Überschrift ein neuer Datensatz eingefügt.
Bei Fehlermeldungen einen Screenshot der Fehlermeldung oder den kopierten Inhalt der Fehlermeldung einfügen.
Bei Screenshots ist es wichtig, dass der komplette Text der Fehlermeldung zu sehen ist.
Ist der Fehler nicht reproduzierbar, schildern Sie möglichst genau, welche Schritte durchgeführt wurden, bevor der Fehler aufgetreten ist.
Hinweis
Werden seitens der PLANTA-Hotline Server- oder Client-Logfiles angefordert, finden Sie nachfolgend die Beschreibung der entsprechenden Schritte.
XML-Protokoll/Client-Logfile aktivieren
Vorgehensweise
In der Datei planta.ini oder
in den Eigenschaften der Client-Verknüpfung
den Parameter log mit den gewünschten Werten eintragen (z.B. log = protocol)
Beispiel für Client-Verknüpfung
Rechte Maustaste auf der Client-Verknüpfung und Eigenschaften auswählen.
Im Feld Ziel am Ende des angegebenen Pfades folgendes eintragen: log = protocol.
z.B. G:\kst\Earth\client\client_41333\Release\planta.exe server=plantaX:21699 log=protocol
Übernehmen oder OK betätigen.
PLANTA project neu starten. Dabei wird im Client-Ordner (im oben angeführten Beispiel ist der Client-Ordner im Feld Ausführen in angegeben) das Verzeichnis log angelegt, in dem die Client-Logfiles abgelegt werden.
Den Fehler reproduzieren.
Um die Größe des Logfiles so gering wie möglich zu halten und damit die Analyse des Logfiles zu vereinfachen, führen Sie bitte ausschließlich die Schritte aus, die für die Reproduktion dieses Fehlers benötigt werden.
Die Logfiles der betreffenden Session an PLANTA schicken.
Anschließend die Logfunktion wieder deaktivieren.
Details
Es gibt 3 verschiedene Arten von Client-Logfiles:
planta_programmer: Dieses Logfile wird einmal erzeugt und enthält technische Informationen, die für Entwickler relevant sind.
planta_support_yyyy_m_d_hh_mm_ss: Enthält verschieden Fehler- und Statusmeldungen des Clients
protocol_dump_yyyy_m_d_hh_mm_ss: Enthält die XML-Nachrichten, die zwischen Client und Server hin- und hergeschickt werden
Bei dem Datum bzw. der Uhrzeit in den Namen der Logfiles handelt es sich um die Startzeit der entsprechenden Session.
Server-Logfile aktivieren
Vorgehensweise
Im Verzeichnis des PLANTA-Servers in der ppms.conf oder planta.conf (je nach dem welche PLANTA-Version bei Ihnen im Einsatz ist) die folgenden Parameter setzen:
Läuft PLANTA project auf Windows, muss an der Stelle der Server neu gestartet werden.
PLANTA project neu starten. Dabei wird im Server-Verzeichnis ein Ordner log angelegt. In diesem werden Logfiles abgelegt.
Den Fehler reproduzieren.
Um die Größe des Logfiles so gering wie möglich zu halten und damit die Analyse des Logfiles zu vereinfachen, führen Sie bitte ausschließlich die Schritte aus, die für die Reproduktion dieses Fehlers benötigt werden.
Die Logfiles der betreffenden Session an PLANTA schicken.
Anschließend die Logfunktion wieder deaktivieren und den Server neu starten.
Details
Es gibt 3 Arten von Server-Logfiles:
ppms.PID.yyyy-mm-dd_hh-mm-ss.debug.log
ppms.PID.yyyy-mm-dd_hh-mm-ss.log
ppms.PID.stderr.log
Das Debug-Logfile beinhaltet alle Informationen, während die anderen Logfiles nur bestimmte Informationen ausgeben.
Sind mehrere Sessions gleichzeitig offen, können die entsprechenden Logfiles über die PID identifiziert werden. Dieses finden Sie im Modul Systeminformation (STRG+B) im Datenfeld PID.
Bei dem Datum bzw. der Uhrzeit in den Namen der Logfiles handelt es sich um die Startzeit der entsprechenden Session.
