Debuggen / Geräteprotokolldateien sammeln und an den IGEL Support senden

Um die Protokolldateien von IGEL UMS Server, UMS Konsole usw. zu sammeln, können Sie den Support-Assistenten verwenden: UMS Console > Menu bar > Help > Save support information. Weitere Informationen finden Sie unter Support-Assistent - So senden Sie Logdateien in der IGEL UMS. Weitere Informationen zu UMS Protokolldateien finden Sie unter Wo kann ich die IGEL UMS Logdateien finden?.

Um die Logdateien des Geräts zu sammeln, lesen Sie bitte die nachstehenden Anweisungen.

Mit IGEL OS 12 wurden zusätzliche Logging-Funktionen eingeführt, die die Fehlersuche erleichtern. Um den Debug-Modus zu aktivieren, gehen Sie wie folgt vor:

1. Im IGEL Setup gehen Sie zu System > Registry und aktivieren Sie die folgenden Registry-Schlüssel:

4. Speichern Sie die Einstellung.
   

Optional können Sie auch die Ausgabe von Protokolldumps über debug.remotemanager.protocol_dump aktivieren. Dies aktiviert die Debug-Protokollierung für alle Befehle, die von der UMS zum Gerät oder umgekehrt gesendet werden:
/var/log/rmagent-ws-in.log
/var/log/rmagent-ws-out.log

Aktivieren Sie diesen Registry-Schlüssel nur bei Bedarf.

Geräteprotokolldateien über die IGEL UMS sammeln

Nachdem Sie die oben genannten Registrierungsschlüssel aktiviert haben, können Sie die UMS Web App oder die UMS Konsole verwenden, um die Geräteprotokolldateien zu sammeln.

Geräteprotokolldateien über die IGEL UMS Web App sammeln

Um Geräteprotokolldateien über die IGEL UMS Web App zu sammeln, folgen Sie den Anweisungen in Supportinformationen und Logdateien in der IGEL UMS Web App speichern.

Geräteprotokolldateien über die IGEL UMS Konsole sammeln

So sammeln Sie die Protokolldateien:

1. In der UMS Konsole gehen Sie zu Help > Save device files for support.

   

   Es öffnet sich der Dialog Save device files for support.

2. Wählen Sie das/die gewünschte(n) Gerät(e) aus und klicken Sie auf Next.

   

3. Wählen Sie ein Verzeichnis aus, das zum Speichern der gezippten Protokolldateien geeignet ist und klicken Sie auf Next.

   

   Ein Bestätigungsdialog öffnet sich und zeigt den Pfad und Dateinamen an, unter dem die Protokolldateien gespeichert werden.

   

4. Wenn die Protokollsammlung abgeschlossen ist, schließen Sie den Bestätigungsdialog, indem Sie auf Finish klicken.

5. Suchen Sie die ZIP-Datei "tc_files_for_support_..." in dem von Ihnen gewählten Verzeichnis und senden Sie diese über das IGEL Customer Portal an den IGEL Support.

Geräteprotokolldateien ohne die UMS sammeln

Wenn die UMS nicht erreichbar ist oder es ein Problem mit der Netzwerkverbindung gibt, können Sie trotzdem Protokolle von einem Gerät extrahieren.

Option 1: Über das lokale Terminal

1. Gehen Sie im IGEL Setup zu Accessories > Terminals und starten Sie eine Terminalsitzung.

   

2. Gehen Sie zu Devices > Storage Devices > Storage Hotplug und aktivieren Sie Enable dynamic client drive mapping.

   

3. Stellen Sie sicher, dass System > Registry > debug > igel_desktop > Enable debug logging for IGEL desktop aktiviert ist.

4. Speichern Sie die Einstellungen.

5. Stecken Sie den USB-Stick in das Endgerät und starten Sie die Terminalsitzung.

6. Melden Sie sich als root an (standardmäßig, ohne Passwort).

7. Um die Log-Dateien zu erstellen, führen Sie den Befehl /config/bin/create_support_information aus.
   Dies erzeugt /tmp/tclogs.zip (Sie können es wie folgt aufrufen: cd /tmp).

   

Um den Namen des USB-Sticks herauszufinden, können Sie die folgenden Befehle verwenden:

cd /userhome/media
ls -l

Wenn der Gerätename Leerzeichen enthält, müssen Sie ihn später in Anführungszeichen setzen. Beispiel: "NEW VOLUME".
Wenn der Gerätename keine Leerzeichen enthält, sind keine Anführungszeichen erforderlich.

8. Um die Protokolldateien von Ihrem Endpunktgerät auf den USB-Stick zu kopieren, führen Sie den Befehl cp /tmp/tclogs.zip /media/[Name des USB-Sticks]/aus und drücken Sie [Return].

Nach /media/ können Sie die Tabulatortaste zur automatischen Vervollständigung drücken.

10. Tippen Sie sync und drücken Sie die [Return]-Taste.

    

11. Warten Sie einige Sekunden, bevor Sie den USB-Stick sicher aus dem Endgerät auswerfen.

12. Senden Sie die Protokolldateien an den IGEL Support über das IGEL Customer Portal.

Option 2: Über CLI

Sie können Protokolldateien auch über die Kommandozeilenschnittstelle (CLI) sammeln. Diese Methode kann z.B. nützlich sein, wenn während des Onboardings des Geräts Probleme auftreten.

1. Drücken Sie jederzeit [STRG+ALT+F12], um die CLI aufzurufen und drücken Sie dann [Return].

2. Stecken Sie einen FAT32-formatierten USB-Stick ein.

3. Führen Sie den folgenden Befehl aus: dmesg
   Dieser Befehl wird verwendet, um herauszufinden, ob der USB-Stick korrekt erkannt wurde und welcher Gerätename zugewiesen wurde (sda, sdb, sdc, etc.).

4. Tippen Sie cat /proc/partitions
   Suchen Sie nach sda, sdb, sdc, usw. und suchen Sie nach der nächsten Zeile mit den Partitionen (Beispiel: sda1, sdb1, usw.).

5. Erstellen Sie das Mountpoint-Verzeichnis: mkdir /mnt

6. Der Gerätename zum Mounten des USB-Sticks für den folgenden Befehl in Schritt 7 benötigt eine zusätzliche Partitionsnummer. Beispiel: sda1, sdb1, sdc1, usw.

7. Mounten Sie Ihren USB-Stick: mount /dev/sda1 /mnt

   

8. Prüfen Sie Ihre Daten auf dem gemounteten USB-Stick:
   cd /mnt
ls -l
   Jetzt sollten Sie Ihre Daten auf dem USB-Stick sehen.

9. Erzeugen Sie Log-Dateien: /config/bin/create_support_information
   Es kann einige Zeit dauern, bis die Generierung der Logdateien abgeschlossen ist.

10. Geben Sie Folgendes ein:
    cd /tmp
ls -l
    Nun sollte die Logdatei tclogs.zip aufgelistet.

    

11. Um tclogs.zip von Ihrem Endgerät auf den USB-Stick zu kopieren, geben Sie cp /tmp/tclogs.zip /mnt ein und drücken Sie die [Return-Taste].

12. Um Ihren USB-Stick zu trennen, verwenden Sie den Befehl umount /mnt.

13. Jetzt können Sie Ihren USB-Stick sicher entfernen.

14. Um CLI zu schließen, drücken Sie [STRG+ALT+F1].

15. Senden Sie tclogs.zip über das IGEL Customer Portal an den IGEL Support.