| Seiteneigenschaften |
|---|
Description:In
diesem Artikel wird beschrieben, welche Informationen nach einem unvermittelten Neustart bzw. einem Prozess-Absturz eines XS- oder GS-45xx Switches benötigt werden und wie diese ausgelesen werden könnenThis article describes what information is required after an abrupt restart or crash of an XS or GS-45xx switch and how this information can be read out.
Requirements:
- LCOS SX ab Version as of version 5.20 (download aktuelle Versionlatest version)
- SSH -Client für den Zugriff per Konsole (z.Bclient for command-line access (e.g. PuTTY)
- TFTP-, FTP-, SCP - oder SFTP-Server im Netzwerk (nur für den Upload eines Crash Dumps)
- Beliebiger Web-Browser für den Zugriff per Webinterface
Procedure:
Auslesen des "Technical Support Logs":
Das Technical Support Log enthält diverse Geräte-Informationen (u.A. zur Prozessor-Auslastung und den laufenden Prozessen) und wird immer benötigt.
Auslesen des "Technical Support Logs" per Webinterface:
1. Verbinden Sie sich per Webinterface mit dem Switch, wechseln in das Menü System → Utilities → Transfer und klicken unter Upload bei dem Protokoll HTTP auf den "Upload-Button".
| Info |
|---|
Das Menü Transfer ist aus Sicht des Switches gestaltet. Somit handelt es sich bei einem Download vom Gerät für dieses um einen Upload. |
2. Passen Sie die folgenden Parameter an und klicken auf Begin Transfer:
- File Type: Wählen Sie im Dropdownmenü die Option Technical Support Log aus.
- File Name: Vergeben Sie einen aussagekräftigen Namen für die Log-Datei.
| Info |
|---|
Der Switch muss die Informationen erst zusammenstellen. Daher kann es einige Sekunden dauern, bis sich der Datei-Explorer öffnet und Sie die Datei speichern können. |
Auslesen des "Technical Support Logs" per Konsole:
1. Verbinden Sie sich per Konsole mit dem Switch und geben den Befehl enable ein, um erweiterte Rechte zu erlangen.
2. Geben Sie anschließend den Befehl terminal length 0 ein, damit die folgende Ausgabe ohne Unterbrechungen angezeigt wird.
3. Geben Sie den Befehl show tech-support ein.
| Hinweis |
|---|
Die Ausgabe des Befehls show tech-support ist sehr umfangreich. Stellen Sie daher in den Einstellungen des verwendeten SSH-Clients sicher, dass ausreichend Scrollback-Lines nachgehalten werden (hier sind mindestens 15000 Zeilen empfehlenswert). In PuTTY kann dies im Konfigurationsmenü unter Window → Lines of scrollback konfiguriert werden. |
4. Speichern Sie die Ausgabe in einer Text-Datei ab.
Auslesen des "Crash Logs" nach einem unvermittelten Neustart des Switches:
Kommt es zu einem unvermittelten Neustart des Switches, wird zur weiteren Analyse das Crash Log benötigt. Dieses wird automatisch erstellt und muss daher nicht extra aktiviert werden.
Auslesen des "Crash Logs" per Webinterface:
1. Verbinden Sie sich per Webinterface mit dem Switch, wechseln in das Menü System → Utilities → Transfer und klicken unter Upload bei dem Protokoll HTTP auf den "Upload-Button".
| Info |
|---|
Das Menü Transfer ist aus Sicht des Switches gestaltet. Somit handelt es sich bei einem Download vom Gerät für dieses um einen Upload. |
2. Passen Sie die folgenden Parameter an und klicken auf Begin Transfer:
- File Type: Wählen Sie im Dropdownmenü die Option Crash Log aus. Dadurch kann das Crash Log des letzten aufgetretenen Absturzes heruntergeladen werden.
- File Name: Vergeben Sie einen aussagekräftigen Namen für die Log-Datei.
Auslesen des "Crash Logs" per Konsole:
1. Verbinden Sie sich per Konsole mit dem Switch und geben den Befehl enable ein, um erweiterte Rechte zu erlangen.
2. Geben Sie anschließend den Befehl terminal length 0 ein, damit die folgende Ausgabe ohne Unterbrechungen angezeigt wird.
3. Geben Sie den Befehl im Format debug crashlog x ein. Dadurch wird der Absturzbericht ausgegeben. Es werden maximal 5 Berichte nachgehalten, welche über die Ziffern 0 bis 4 referenziert werden.
In diesem Beispiel wird der Befehl debug crashlog 0 verwendet, um den ersten Absturzbericht auszugeben.
| Hinweis |
|---|
Die Ausgabe des Befehls debug crashlog ist sehr umfangreich. Stellen Sie daher in den Einstellungen des verwendeten SSH-Clients sicher, dass ausreichend Scrollback-Lines nachgehalten werden (hier sind mindestens 10000 Zeilen empfehlenswert). In PuTTY kann dies im Konfigurationsmenü unter Window → Lines of scrollback konfiguriert werden. |
4. Kopieren Sie die Ausgabe in eine Textdatei.
Sammeln von Absturz-Informationen eines Prozesses (Core Dump):
Wenn ein Prozess auf dem Switch unerwartet beendet wird, werden die Absturz-Informationen in einem Core Dump festgehalten. Da diese Funktion nicht ab Werk aktiv ist, muss diese erst aktiviert werden.
| Hinweis |
|---|
Das Feature Core Dump sollte nur bei Bedarf aktiviert werden und ist daher nur für reproduzierbare bzw. wiederkehrende Prozess-Abstürze geeignet. Eine dauerhafte Aktivierung ist nicht sinnvoll und auch nicht empfehlenswert. |
1. Aktivieren des Core Dumps:
1.1 Aktivieren des Core Dumps per Webinterface:
- or SFTP server in the network (for uploading a crash dump only)
- Any browser for access via the web interface
Procedure:
Read out the technical support logs:
The technical support log contains various device information (including processor load and running processes) and is an essential requirement.
Reading out the technical support log via web interface:
1) Connect to the switch via the web interface and go to the menu System → Utilities → Transfer. For the protocol HTTP under the heading Upload, click the “Upload” button.
| Info |
|---|
The Transfer menu is designed from the point of view of the switch. Consequently, an upload from this device is therefore a download to the other the device. |
2) Modify the following parameters and then click Begin Transfer:
- File Type: From the drop-down menu, select the option Technical Support Log.
- File Name: Give the log file a descriptive name.
| Info |
|---|
The switch must first compile the information. It may take a few seconds before the dialog opens and you can save the file. |
Reading out the technical support log from the command line:
1) Connect to the switch from the command line and enter the command enable to gain extended privileges.
2) Then enter the command terminal length 0 so that the subsequent output is displayed without interruptions.
3) Enter the command show tech-support.
| Hinweis |
|---|
The output of the command show tech-support is rather exhaustive. Make sure that the settings for the SSH client have a sufficient scrollback buffer (at least 15,000 lines are recommended here). In PuTTY, this is configured in the menu under Window → Lines of scrollback. |
4) Then save the output as a text file.
Reading out the “crash log” after an abrupt restart of the switch:
If an abrupt restart of the switch occurs, the crash log helps with further analysis. This is created automatically and does not have to be activated separately.
Reading out the “crash log” via web interface:
1) Connect to the switch via the web interface and go to the menu System → Utilities → Transfer. For the protocol HTTP under the heading Upload, click the “Upload” button.
| Info |
|---|
The Transfer menu is designed from the point of view of the switch. Consequently, an upload from this device is therefore a download to the other the device. |
2) Modify the following parameters and then click Begin Transfer:
- File Type: From the drop-down menu, select the option Crash Log. This allows the crash log for the last crash that occurred to be downloaded.
- File Name: Give the log file a descriptive name.
Reading out the “crash log” from the command line:
1) Connect to the switch from the command line and enter the command enable to gain extended privileges.
2) Then enter the command terminal length 0 so that the subsequent output is displayed without interruptions.
3) Enter the command in the format debug crashlog x. This will output the crash report. A maximum of 5 reports are retained, which are referenced by the numbers 0 to 4.
In this example, the command debug crashlog 0 outputs the first crash report.
| Hinweis |
|---|
The output of the command debug crashlog is rather exhaustive. Make sure that the settings for the SSH client have a sufficient scrollback buffer (at least 10000 lines are recommended here). In PuTTY, this is configured in the menu under Window → Lines of scrollback. |
4) Copy the output to a text file.
Collecting crash information for a process (core dump):
When a process on the switch exits unexpectedly, the crash information is stored to a core dump. Since this function is not enabled in the factory settings, it has to be activated first.
| Hinweis |
|---|
The Core Dump feature should only be activated when required and is therefore only suitable for reproducible or recurring crashes. It makes no sense to enable this feature permanently, and this is not recommended. |
1) Enabling the Core Dump:
1.1) Enabling the core dump via web interface:
1.1.1) Connect to the web interface of the switch and navigate to the menu 1.1.1 Verbinden Sie sich per Webinterface mit dem Switch und wechseln in das Menü System → Utilities → Core Dump.
1.1.2 Wählen Sie im Dropdownmenü bei Protocol die Option Local aus. Dadurch werden die Core Dumps im lokalen Speicher des Gerätes abgelegt. Klicken Sie anschließend auf ) In the drop-down menu Protocol select the option Local. This stores the core dump to the local memory in the device. Then click on Submit.
| Info |
|---|
Alternativ können Core Dumps auch auf einem angeschlossenen USB-Stick gespeichert werden, indem bei Protocol die Option USB ausgewählt und der File Path spezifiziert wird. In diesem Fall entfällt der manuelle Upload auf einen Server im Netzwerk (siehe Schritt 2.). |
Core dumps can also be saved to a USB stick using the menu under Protocol by selecting the option USB and specifying the file path. In this case, there is no need for a manual upload to a server on the network (see step 2). |
| Hinweis |
|---|
After the core dump has been saved, the function must be deactivated again. To do this, go to Protocol, select the option None and save the configuration |
| Hinweis |
Nachdem der Core Dump gespeichert wurde, muss die Funktion wieder deaktiviert werden. Wählen Sie dazu bei Protocol die Option None aus und speichern die Konfiguration. |
1.2 Aktivieren des Core Dumps per Konsole) Enabling the core dump from the command line:
1.2.1 Verbinden Sie sich per Konsole mit dem Switch und geben den Befehl enable ein, um erweiterte Rechte zu erlangen) Connect to the switch from the command line and enter the command enable to gain extended privileges.
1.2.2 Geben Sie den Befehl configure ein, um in das Konfigurationsmenü zu gelangen) Enter the command configure to enter the configuration menu.
1.2.3 Geben Sie den Befehl ) Enter the command exception protocol local ein. Damit wird ein Core-Dump im lokalen Speicher des Gerätes abgelegt. This stores a core dump to the local memory in the device.
1.2.4 Geben Sie den Befehl exit ein. um das Konfigurationsmenü zu verlassen.) Enter the command exit to quit the configuration menu.
1.2.5 Geben Sie abschließend den Befehl write memory confirm ein, um die Konfiguration bootpersistent zu speichern. Der Parameter confirm bewirkt dabei, dass der Speichervorgang nicht zusätzlich bestätigt werden muss.) Finally, enter the command write memory confirm to save a boot-persistent copy of the configuration. The parameter confirm means there is no need to additionally confirm the saving of the file.
| Hinweis |
|---|
After the core dump has been saved, the function must be deactivated again. To do this, use the CLI command |
| Hinweis |
Nachdem der Core Dump gespeichert wurde, muss die Funktion wieder deaktiviert werden. Verwenden Sie dazu den Konsolen-Befehl exception protocol none. |
2. Hochladen eines "Core Dump" vom lokalen Geräte-Speicher auf einen Server im Netzwerk) Uploading a core dump from the local device memory to a server on the network:
| Info |
|---|
Im lokalen Geräte-Speicher befindliche Core Dumps können nicht per Webinterface heruntergeladen, sondern nur per Konsole vom Switch an einen TFTP-, FTP-, SCP- oder SFTP-Server im Netzwerk geschickt werden. |
Core dumps located in the local device memory cannot be downloaded via web interface, but can only be sent using the command line on the switch to a TFTP, FTP, SCP or SFTP server on the network. |
2.1) Connect to the switch from the command line and enter the command enable to gain extended privileges2.1 Verbinden Sie sich per Konsole mit dem Switch und geben den Befehl enable ein, um erweiterte Rechte zu erlangen.
2.2 Geben Sie anschließend den Befehl ) Then enter the command show exception core-dump-file ein, um eine Liste der im lokalen Speicher abgelegten Core Dumps auszugeben. to output a list of core dumps stored in local memory.
Copy the file name of the required core dump for the purpose of uploading the file (see step Kopieren Sie sich den Dateinamen des benötigten Core Dumps für den Upload der Datei (siehe Schritt 2.1). Sollte unklar sein, welches Core Dump benötigt wird, wenden Sie sich bitte an den If it is unclear which core dump is required, please contact LANCOM Support.
2.1 Geben Sie den Befehl zum Upload des Core Dump im Format ) Enter the command to upload the core dump in the format copy nvram:core-dump <Name of the Core Dump.bz2> <Protocol>://<User name on the server>@<IP address of the server>/<File path><New file name> an.
In diesem Beispiel mit einem FTP-Server lautet der Befehl also wie folgtthis example of an FTP server, the command is as follows:
copy nvram:core-dump lighttpd_core_3168.0.bz2 ftp://admin@192.168.45.178/home/coredump.bz2
Geben Sie anschließend als Remote Password das Passwort des Benutzers auf dem Server ein, bestätigen die Abfrage mit der Taste <y> und drücken abschließend die <Enter> Taste.
Auslesen des "Event-Logs":
Then enter the remote password, which is the password of the user on the server, confirm the query with the <y> key and finally press the <Enter> button.
Reading out the “event log”:
| Info |
|---|
The event log can be viewed via the web interface using the menu |
| Info |
Das Event Log kann zwar per Webinterface in dem Menü System → Logs → Event Log eingesehen, dort aber nicht gespeichert oder kopiert werden. Daher kann das Event Log nur per Konsole abgespeichert werden. |
1. Verbinden Sie sich per Konsole mit dem Switch und geben den Befehl enable ein, um erweiterte Rechte zu erlangen.
2. Geben Sie anschließend den Befehl terminal length 0 ein, damit die folgende Ausgabe ohne Zeilenumbrüche angezeigt wird.
3. Geben Sie den Befehl show eventlog ein. Damit wird das Eventlog auf der Konsole ausgegeben.
4. Kopieren Sie die Ausgabe in eine Textdatei.
Senden der Informationen an den LANCOM Support:
Sofern noch kein Supportfall besteht, wenden Sie sich bitte mit den folgenden Informationen an den LANCOM Support.
, but it cannot be saved or copied there. For this reason, the event log can only be saved from the command line. |
1) Connect to the switch from the command line and enter the command enable to gain extended privileges.
2) Then enter the command terminal length 0 so that the subsequent output is displayed without line breaks.
3) Enter the command show eventlog. This will output the event log via the command line.
4) Copy the output to a text file.
Sending the information to LANCOM Support:
If no support case has been opened yet, please contact LANCOM Support with the following information.
- Precise description of the error
- The switch model and firmware version
- Genaue Fehler-Beschreibung
- Verwendetes Switch-Modell sowie aktuell eingesetzte Firmware-Version
- Technical Support Log
- Crash Log (nur nach einem unvermittelten Neustartonly after an abrupt restart)
- Core Dump (nur bei wiederkehrenden/reproduzierbaren Prozess-Abstürzenfor recurring/reproducible crashes only)
- Event Log