How-to
Diese Seite bietet Ihnen Schritt-für-Schritt-Anleitungen zur Verwendung von Funktionen im Admin-Dogu.
Erstellen eines Support-Pakets
Ein Support-Paket enthält Log-Dateien und weitere relevante Informationen über das System. Im Support-Fall kann ein Support-Paket helfen, das Problem zu lokalisieren.
Wichtige Informationen
- Sie benötigen mindestens schreibenden Zugriff auf das Admin-Dogu, um ein Support-Paket erstellen zu können.
Vorgehen
- Öffnen Sie das Admin-Dogu. Sie finden das Dogu unter dem Namen Administration im Warp-Menü unter der gleichnamigen Überschrift Administration.
- Im Admin-Dogu finden Sie oben die Menüleiste des Dogus mit den Punkten "Logging", "Dogu Management" und "Wartung". Klicken Sie auf "Wartung".
- Auf der Wartungsseite sehen Sie die Abschnitte Debug-Modus und Support-Paket. Klicken Sie auf die Schaltfläche Neues Support-Paket erzeugen im Abschnitt Support-Paket.
- Laden Sie das erstellte Support-Paket mit einem Klick auf den Namen des Support-Pakets herunter. Ihr gerade erstelltes Support-Pakets hat das aktuelle Datum und die Uhrzeit im Namen. Wenn Ihnen eine Liste von Support-Paketen angezeigt wird, ist das oberste Support-Paket Ihr gerade erstelltes Paket.
- Überprüfen Sie das heruntergeladene Support-Paket: Möglicherweise befinden sich sensible Daten im Paket, die Sie vor Versenden des Pakets löschen möchten. Welche Informationen im Support-Paket enthalten sind, können Sie in der Dokumentation des Dogus nachlesen.
- Geben Sie das Support-Paket bei Bedarf als ZIP-Datei weiter.
Weitere Informationen zum Support-Paket finden Sie in der Dokumentation des Dogus.
Verwendung des Debug-Modus
Im Support-Fall kann es sinnvoll sein, mehr Informationen zu einem Problem zu sammeln. Der Debug-Modus ist eine Funktion des Admin-Dogus, der für die Reproduktion von Fehlern verwendet werden kann.
Der Debug-Modus startet alle Dogus des EcoSystems neu. Dabei wird das Log-Level der Dogus auf Log-Level = DEBUG erhöht.
Wichtige Informationen
- Während der Debug-Modus aktiviert bzw. deaktiviert wird, ist das System mehrere Minuten nicht erreichbar.
- Das Aktivieren und Deaktivieren des Debug-Modus leert die vorhandenen Log-Dateien. Anschließend haben Sie über das Admin-Dogu keinen Zugriff mehr auf die zuvor erzeugten Log-Datein.
- Sie benötigen mindestens schreibenden Zugriff auf das Admin-Dogu, um den Debug-Modus aktivieren zu können.
Vorgehen
- Erzeugen Sie vorab ein Support-Paket, wenn sie zur Dokumentation des Problems noch kein Paket erstellt haben (s. Erstellen eines Support-Pakets).
- Öffnen Sie das Admin-Dogu. Sie finden das Admin-Dogu unter dem Namen Administration im Warp-Menü unter der gleichnamigen Überschrift Administration.
- Im Admin-Dogu finden Sie oben die Menüleiste des Dogus mit den Punkten "Logging", "Dogu Management" und "Wartung". Klicken Sie auf "Wartung".
- Auf der Wartungsseite sehen Sie die Abschnitte Debug-Modus und Support-Paket. Im Abschnitt Debug-Modus ist standardmäßig eingestellt, dass der Debug-Modus für 15 Minuten aktiviert werden soll. Klicken Sie auf die Fläche 15 Minuten und wählen Sie die gewünschte Dauer aus, wenn Sie die Dauer des Debug-Modus erhöhen wollen. Eine Erhöhung des Debug-Modus ist sinnvoll, wenn Sie zur Reproduktion des Fehlers länger als die 15 Minuten benötigen sollten.
- Klicken Sie auf die Schaltfläche Aktivieren im Abschnitt Debug-Modus, um den Debug-Modus zu starten.
- Es öffnet sich ein Dialog, der Sie darauf hinweist, dass das System beim Aktivieren des Debug-Modus mehrere Minuten nicht benutzbar ist. Aktivieren Sie die Checkbox und drücken Sie die Schaltfläche Aktivieren.
- Der Debug-Modus wird nun aktiviert. Das kann mehrere Minuten dauern. In dieser Zeit wird Ihnen nach Neuladen des Browsers eine Wartungsseite angezeigt. Aktualisieren Sie das System nach wenigen Minuten solange, bis Sie die Anmeldeseite angezeigt bekommen.
- Melden Sie sich neu im System an.
- Reproduzieren Sie den Fehler.
- Erzeugen Sie ein Support-Paket (s. Erstellen eines Support-Pakets).
- Deaktivieren Sie den Debug-Modus. Wenn Sie den Debug-Modus nicht mehr benötigen, ist es sinnvoll, den Modus manuell zu deaktivieren. Dafür öffnen Sie das Admin-Dogu und klicken auf den Menüpunkt Wartung.
- Klicken Sie dann auf die Schaltfläche Debug-Modus deaktivieren.
- Es öffnet sich ein Dialog. Aktivieren Sie die Checkbox und drücken Sie Deaktivieren. Der Debug-Modus wird nun deaktiviert. Das kann mehrere Minuten dauern. In dieser Zeit wird Ihnen nach Neuladen des Browsers eine Wartungsseite angezeigt.
Weitere Informationen zum Debug-Modus finden Sie in der Dokumentation des Dogus.