ECS: OBS: xDoctor: RAP025: Symptomcode: 2026: Eine gebundene Schnittstelle ist inaktiv oder fehlt. Netzwerkschnittstelle(n) inaktiv auf dem/den folgenden Node(s)

Summary: Die gebundene Netzwerkschnittstelle oder eine oder mehrere ihrer Slave-Schnittstellen auf einem ECS-Node ist ausgefallen oder fehlt. Wenn eine gebundene Schnittstelle offline ist, wird die Netzwerkredundanz für ObjectScale und ECS reduziert oder geht verloren. Dieser Zustand wird von xDoctor oder über eine Dial Home-Warnmeldung erkannt und gemeldet. ...

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.
Check out other resources

Symptoms

Ab ECS xDoctor v4.8-109.0 und ObjectScale xDoctor v5.1-109.0 wird RAP025 (eine oder mehrere Netzwerkschnittstellen sind ausgefallen oder fehlen) als Auto-Healer implementiert. Wenn Probleme mit der Switch-Konnektivität den konfigurierten Schweregrad Fehler oder Kritisch überschreiten, löst xDoctor eine RAP025-Warnmeldung aus und initiiert automatisch den integrierten Reparaturorchestrierungsworkflow. Dieser Workflow führt die erforderlichen Korrekturmaßnahmen durch, wenn die automatische Fehlerkorrektur in xDoctor aktiviert ist.

Hinweis: Wenn in Ihrer Umgebung eine xDoctor-Version vor ECS xDoctor v4.8-109.0 oder ObjectScale xDoctor v5.1-109.0 ausgeführt wird, ist die RAP025-Auto-Healer-Funktion nicht verfügbar. In diesen Versionen muss die Korrektur mithilfe des unten beschriebenen AutoPilot-Prozesses oder durch Befolgen der im Abschnitt "Lösung" beschriebenen manuellen Korrekturschritte durchgeführt werden.

 

Warnmeldung, die die automatische Reparatur von RAP025 auslöst

Der RAP025-Workflow für die automatische Fehlerkorrektur wird ausgelöst, wenn ein Node-Schnittstellenfehler erkannt wird, der den konfigurierten Schweregrad "Fehler" oder "Kritisch " überschreitet. Sobald dieser Schwellenwert überschritten wird, generiert xDoctor eine RAP025-Warnmeldung, die als Auslöser für den automatisierten Reparaturprozess dient.
 

Beispiel für Ausgabe einer Warnmeldung

Hinweis: In xDoctor-Versionen vor ECS xDoctor v4.8-109.0 und ObjectScale xDoctor v5.1-109.0 führt diese Bedingung nur zu einer Warnmeldung. Es wird keine automatische Korrektur durchgeführt. 

----------------------------------------------
INFO - Auto Healer for interface_down disabled
----------------------------------------------
Extra     = Auto Healer for interface_down disabled
Timestamp = 2026-03-24_205634
PSNT      = CKM00190800120 @ 4.8-109.0

-------------------------------------------------------------------------------------
ERROR - (Cached) One or more network interfaces are down or missing
-------------------------------------------------------------------------------------
Node      = Nodes
Extra     = {"Nodes": {"169.254.1.4": ["pslave-1"]}}
RAP       = RAP025
Solution  = KB 503814
Timestamp = 2026-04-01_190513
PSNT      = CKMXXXXXXXXXXX @ 4.8-109.0

 

Korrektur durch automatische Reparatur (Beispiel)

Wenn die automatische Reparatur aktiviert ist, leitet xDoctor automatisch Korrekturmaßnahmen für erkannte Node-Schnittstellenfehler ein, indem allgemeine Korrekturmaßnahmen angewendet werden, die in dieser Wissensdatenbank beschrieben sind. 

----------------------------------------
FIXED - Auto Healer fixed interface_down
----------------------------------------
Node      = Nodes
Extra     = {"Nodes": {"169.254.1.1": ["pslave-0"]}}
Timestamp = 2026-04-01_190513
PSNT      = CKMXXXXXXXXXXX @ 4.8-109.0

 

Anforderung an Auto-Heiler

Die xDoctor-Funktion zur automatischen Reparatur muss aktiviert sein, damit diese Korrektur durchgeführt werden kann. Auto-Healer können entweder während oder nach der Installation aktiviert werden, indem Sie die Schritte befolgen, die beschrieben sind unter:

Wissensdatenbank: ECS: xDoctor: So aktivieren Sie xDoctor Auto Healer nach der Installation

des ToolsDial-Home-Beispiel für dieselbe Warnmeldung:

Connect Home

Clarify Id: APM00000000000
Vendor: DellEMC
DeviceType: ElasticCloudStorageApp
Model: ECS
SerialNumber: APM00000000000
WWN: ELMECS00000000
EmbedLevel: 1
InternalMaxSize: 0
IP_Address: Not Available
AppName: xDoctor Portal

SymptomCode: 2026
Category: Hardware
Severity: ERROR
Status: Warning
Component: Node
SubComponent: Interface
CallHome: true
LastTime: 2019-08-26 12:08:34
CDATA: <![CDATA[{'169.254.1.1': ['slave-1']}]]>

Description: <![CDATA[Network interface(s) down on the following node(s):]]>

Cause

Mögliche Ursachen

Dieses Problem kann aufgrund einer oder mehrerer der folgenden Bedingungen auftreten:

  • Falsch eingesetztes SFP
    Das SFP-Modul (Small Form-Factor Pluggable) wurde während der Installation möglicherweise nicht vollständig eingesetzt.

  • Änderungen an
    nutzerverwalteten Switches Änderungen, die an vom Kunden verwalteten Switches außerhalb der Kontrolle von Dell vorgenommen werden, z. B. Firmwareupgrades, Konfigurationsänderungen oder Wartungsaktivitäten, können dazu führen, dass Netzwerkverbindungen ausfallen und eine Neuverhandlung beendet wird.

  • Fehlerhafte ECS-Netzwerkhardware, einschließlich:

    • Netzwerkschnittstellenkarte (NIC)
    • Netzwerkkabel
    • SFP-Modul (Small Form-Factor Pluggable)
    • Netzwerk-Switch oder Switch-Port

Resolution

xDoctor Auto-Healer:  ObjectScale xDoctor v5.1-109.0/ECS xDoctor v4.8-109.0 oder höher

 

  1. Um die automatische Reparatur mit aktivierter Option manuell auszulösen, führen Sie den folgenden Befehl auf dem master.rack Knoten. Dadurch werden die Rack-Analysatoren initiiert, die die Nodes einzeln validieren und automatisch korrigieren.
Befehl: 
# sudo xdoctor --rap=RAP025

Beispiel:

admin@ecsnode1:~> admin@ecsnode1:~> sudo xdoctor --rap=RAP025
2026-04-01 19:05:13,590: xDoctor_4.8-109.0 - INFO    : Initializing xDoctor v4.8-109.0 ...
2026-04-01 19:05:14,143: xDoctor_4.8-109.0 - INFO    : Removing orphaned session - session_1775070174.306
2026-04-01 19:05:14,146: xDoctor_4.8-109.0 - INFO    : Starting xDoctor session_1775070313.036 ... (SYSTEM)
2026-04-01 19:05:14,146: xDoctor_4.8-109.0 - INFO    : Primary Node Control Check ...
2026-04-01 19:05:14,336: xDoctor_4.8-109.0 - INFO    : xDoctor Composition - Analyzer(s):ac_interface_check
2026-04-01 19:05:14,352: xDoctor_4.8-109.0 - INFO    : Session limited to 0:40:00
2026-04-01 19:05:15,410: xDoctor_4.8-109.0 - INFO    : --------------------
2026-04-01 19:05:15,410: xDoctor_4.8-109.0 - INFO    : ECS Version: 3.8.1.4
2026-04-01 19:05:15,410: xDoctor_4.8-109.0 - INFO    : --------------------
2026-04-01 19:05:15,525: xDoctor_4.8-109.0 - INFO    : xDoctor Pre Features
2026-04-01 19:05:15,526: xDoctor_4.8-109.0 - INFO    : Cron Activation
2026-04-01 19:05:15,526: xDoctor_4.8-109.0 - INFO    : xDoctor already active ...
[... Truncated Output ...]
2026-04-01 19:05:21,987: xDoctor_4.8-109.0 - INFO    : ------------------------------
2026-04-01 19:05:21,992: xDoctor_4.8-109.0 - INFO    : Analyzing collected data ...
2026-04-01 19:05:21,992: xDoctor_4.8-109.0 - INFO    : Analysis Limit: 0:13:00
2026-04-01 19:05:21,993: xDoctor_4.8-109.0 - INFO    : ANALYZER [ac_interface_check]
2026-04-01 19:05:22,291: xDoctor_4.8-109.0 - INFO    : Autohealing interface_down on node 169.254.1.4 ...
2026-04-01 19:08:39,599: xDoctor_4.8-109.0 - INFO    : Autohealing interface_down on node 169.254.1.1 ...
2026-04-01 19:11:19,874: xDoctor_4.8-109.0 - INFO    : All data analyzed in 0:05:57
2026-04-01 19:11:20,709: xDoctor_4.8-109.0 - INFO    : --------------------
2026-04-01 19:11:20,709: xDoctor_4.8-109.0 - INFO    : Diagnosis Summary
2026-04-01 19:11:20,709: xDoctor_4.8-109.0 - INFO    : --------------------
2026-04-01 19:11:20,709: xDoctor_4.8-109.0 - INFO    : PSNT: CKM00190800120
2026-04-01 19:11:20,709: xDoctor_4.8-109.0 - INFO    : --------------------
2026-04-01 19:11:20,710: xDoctor_4.8-109.0 - INFO    : FIXED             =  1
2026-04-01 19:11:20,710: xDoctor_4.8-109.0 - INFO    : CRITICAL          =  0
2026-04-01 19:11:20,710: xDoctor_4.8-109.0 - INFO    : CRITICAL (CACHED) =  0
2026-04-01 19:11:20,710: xDoctor_4.8-109.0 - INFO    : ERROR             =  0
2026-04-01 19:11:20,710: xDoctor_4.8-109.0 - INFO    : ERROR (CACHED)    =  1
2026-04-01 19:11:20,710: xDoctor_4.8-109.0 - INFO    : WARNING           =  0
2026-04-01 19:11:20,710: xDoctor_4.8-109.0 - INFO    : INFO              =  0
2026-04-01 19:11:20,710: xDoctor_4.8-109.0 - INFO    : VERBOSE           =  0
2026-04-01 19:11:20,710: xDoctor_4.8-109.0 - INFO    : REPORT            =  0
2026-04-01 19:11:20,826: xDoctor_4.8-109.0 - INFO    : ---------------------
2026-04-01 19:11:20,826: xDoctor_4.8-109.0 - INFO    : xDoctor Post Features
2026-04-01 19:11:20,826: xDoctor_4.8-109.0 - INFO    : ----------------
2026-04-01 19:11:20,826: xDoctor_4.8-109.0 - INFO    : Data Combiner
2026-04-01 19:11:20,826: xDoctor_4.8-109.0 - INFO    : -------------
2026-04-01 19:11:20,827: xDoctor_4.8-109.0 - INFO    : Created a Data Collection Report (data.xml)
2026-04-01 19:11:20,827: xDoctor_4.8-109.0 - INFO    : ------
2026-04-01 19:11:20,827: xDoctor_4.8-109.0 - INFO    : SysLog
2026-04-01 19:11:20,827: xDoctor_4.8-109.0 - INFO    : ------
2026-04-01 19:11:20,828: xDoctor_4.8-109.0 - INFO    : Using Fabric as Syslog Server
2026-04-01 19:11:20,828: xDoctor_4.8-109.0 - INFO    : Syslog triggered on Warning
2026-04-01 19:11:20,828: xDoctor_4.8-109.0 - INFO    : Forwarded 1 event(s) to syslog
2026-04-01 19:11:20,828: xDoctor_4.8-109.0 - INFO    : ----
2026-04-01 19:11:20,828: xDoctor_4.8-109.0 - INFO    : SNMP
2026-04-01 19:11:20,828: xDoctor_4.8-109.0 - INFO    : ----
2026-04-01 19:11:20,829: xDoctor_4.8-109.0 - INFO    : Using 10.118.165.48:162 as SNMP server
2026-04-01 19:11:20,829: xDoctor_4.8-109.0 - INFO    : SNMP triggered on Warning
2026-04-01 19:11:26,905: xDoctor_4.8-109.0 - INFO    : Triggered 1 SNMPv2c event(s) and the SNMP server acknowledged 0 event(s)
2026-04-01 19:11:26,905: xDoctor_4.8-109.0 - INFO    : ------------
2026-04-01 19:11:26,905: xDoctor_4.8-109.0 - INFO    : ProcComplete
2026-04-01 19:11:26,905: xDoctor_4.8-109.0 - INFO    : ------------
2026-04-01 19:11:26,905: xDoctor_4.8-109.0 - WARNING : ProcComplete is disabled, please re-enable it (xdoctor --config)
2026-04-01 19:11:27,023: xDoctor_4.8-109.0 - INFO    : ----------------
2026-04-01 19:11:27,023: xDoctor_4.8-109.0 - INFO    : Session Archiver
2026-04-01 19:11:27,023: xDoctor_4.8-109.0 - INFO    : ----------------
2026-04-01 19:11:27,033: xDoctor_4.8-109.0 - INFO    : Session Stored in folder      - /usr/local/xdoctor/archive/other/2026-04-01_190513
2026-04-01 19:11:27,033: xDoctor_4.8-109.0 - INFO    : Session Archived as tar       - /usr/local/xdoctor/archive/other/xDoctor-CKM00190800120-2026-04-01_190513.tgz
2026-04-01 19:11:27,034: xDoctor_4.8-109.0 - INFO    : --------------------------
2026-04-01 19:11:27,034: xDoctor_4.8-109.0 - INFO    : Session Report                - sudo xdoctor --report --archive=2026-04-01_190513
2026-04-01 19:11:27,034: xDoctor_4.8-109.0 - INFO    : ---------------
2026-04-01 19:11:27,034: xDoctor_4.8-109.0 - INFO    : Session Cleaner
2026-04-01 19:11:27,034: xDoctor_4.8-109.0 - INFO    : ---------------
2026-04-01 19:11:27,046: xDoctor_4.8-109.0 - INFO    : Removing folder  (count limit) - /usr/local/xdoctor/archive/other/2026-04-01_180540
2026-04-01 19:11:27,047: xDoctor_4.8-109.0 - INFO    : Removing archive (count limit) - /usr/local/xdoctor/archive/other/xDoctor-CKM00190800120-2026-04-01_180540.tgz
2026-04-01 19:11:27,051: xDoctor_4.8-109.0 - INFO    : Cleaned 2 archived session(s)
2026-04-01 19:11:27,051: xDoctor_4.8-109.0 - INFO    : -------
2026-04-01 19:11:27,051: xDoctor_4.8-109.0 - INFO    : Emailer
2026-04-01 19:11:27,051: xDoctor_4.8-109.0 - INFO    : -------
2026-04-01 19:11:27,052: xDoctor_4.8-109.0 - INFO    : Using Dedicated Server (25:25) as SMTP Server ...
2026-04-01 19:11:27,052: xDoctor_4.8-109.0 - INFO    : Email Type = Individual Events
2026-04-01 19:11:27,052: xDoctor_4.8-109.0 - INFO    : ------------------------------
2026-04-01 19:11:27,053: xDoctor_4.8-109.0 - INFO    : xDoctor session_1775070313.036 finished in 0:06:14
2026-04-01 19:11:27,075: xDoctor_4.8-109.0 - INFO    : Successful Job:1775070313 Exit Code:200

 

  1. Führen Sie den Sitzungsbericht aus, um die Ergebnisse der manuellen automatischen Reparatur zu überprüfen.
Befehl: 
Hinweis: Verwenden Sie den im obigen xDoctor-Beispiel bereitgestellten Befehl Sitzungsbericht, um die Ergebnisse der manuellen automatischen Reparatur zu überprüfen. 
# sudo xdoctor --report --archive=<session report>

Beispiel:

admin@ecsnode1:~> sudo xdoctor --report --archive=2026-04-01_180344

xDoctor 4.8-109.0
CKMXXXXXXXXXXX - ECS 3.8.1.4

Displaying xDoctor Report (2026-04-01_180344) Filter:[] ...

----------------------------------------
FIXED - Auto Healer fixed interface_down
----------------------------------------
Node      = Nodes
Extra     = {"Nodes": {"169.254.1.1": ["pslave-0"]}}
Timestamp = 2026-04-01_190513
PSNT      = CKM00190800120 @ 4.8-109.0

 

  1. Für den Fall, dass ein Fehler auftritt, öffnen Sie einen SR zur Untersuchung.
    Beispiel für einen Fehler: 
    -------------------------------------------------------------------------------------
ERROR - (Cached) Auto fix failed - One or more network interfaces are down or missing
-------------------------------------------------------------------------------------
Node      = Nodes
Extra     = {"Nodes": {"169.254.1.4": ["pslave-1"]}}
RAP       = RAP025
Solution  = KB 503814
Timestamp = 2026-04-01_190513
PSNT      = CKM00190800120 @ 4.8-109.0

xDoctor Autopilot: 

WICHTIG:  Eine neue Funktion wurde in xDoctor 4-8.104.0 und höher veröffentlicht. Diese Wissensdatenbank (KB) ist jetzt mit xDoctor automatisiert, um schnell zu versuchen, eine Node-Schnittstelle wiederherzustellen, indem sowohl die Node- als auch die Switch-Details überprüft werden. Wenn das Skript die Schnittstelle nicht wiederherstellen kann, bietet es eine detaillierte Zusammenfassung der Ergebnisse. 

Befolgen Sie ECS, um das Automation Repository mit xDoctor 4-8.104.0 und höher einzurichten: ObjectScale: Ausführen von KB-Automatisierungsskripten (Autopilot)

  1. Führen Sie den Automatisierungsbefehl von einem Node mit xDoctor 4-8.104.0 und höher aus. 

     

    Hinweis:--target-node wird für diese Aktion unterstützt. Dieses Skript ist in der Version xDoctor 4-8.104.0 enthalten, die Version 3.0 der Ansible-Automatisierungsskripte enthält.  

     

Befehl:  
# sudo xdoctor autopilot --kb 50341 --target-node <Node NAN IP>
Beispiel: 
admin@ecsnode1:~> sudo xdoctor autopilot --kb 50341 --target-node 169.254.1.1
Checking for existing screen sessions...
Starting screen session 'autopilot_kb_50341_20250627_124206'...
Screen session 'autopilot_kb_50341_20250627_124206' started successfully.
Attaching to screen session 'autopilot_kb_50341_20250627_124206'...
  1. Zusammenfassung der Überprüfung:

Beispiel:

>TASK [Print all summaries] ***************************************************************************************************************************************************************************
ok: [169.254.1.7] => {
    "msg": [
        "Host: 169.254.1.7",
        "*******************************************************************************",
        "Node interface summary:",
        "*******************************************************************************",
        "Interface status for switch rabbit and node interface(slave-0):",
        "                           Node Interface: UP",
        "                           Node physical link detected: yes",
        "                           Node SFP Vendor: DELL",
        "                           Node SFP PN: VXFJY",
        "                           Node SFP Type: GBIC/SFP defined by 2-wire interface ID",
        "                           Node connection detected: ethernet1/1/7",
        "                           Switch Interface: ethernet1/1/7",
        "                           Switch Speed: 25G",
        "                           Switch Status: up",
        "                           Switch SFP Model: 25GBASE-CR-3.0M",
        "                           Switch SFP Qualified: true",
        "Interface status for switch hare and node interface(slave-1):",
        "                           Node Interface: UP",
        "                           Node physical link detected: yes",
        "                           Node SFP Vendor: DELL",
        "                           Node SFP PN: VXFJY",
        "                           Node SFP Type: GBIC/SFP defined by 2-wire interface ID",
        "                           Node connection detected: ethernet1/1/7",
        "                           Switch Interface: ethernet1/1/7",
        "                           Switch Speed: 25G",
        "                           Switch Status: up",
        "                           Switch SFP Model: 25GBASE-CR-3.0M",
        "                           Switch SFP Qualified: true",
        "Interface status for switch fox and node interface(pslave-0):",
        "                           Node Interface: UP",
        "                           Node physical link detected: yes",
        "                           Node SFP Vendor: DELL",
        "                           Node SFP PN: VXFJY",
        "                           Node SFP Type: GBIC/SFP defined by 2-wire interface ID",
        "                           Node connection detected: ethernet1/1/7",
        "                           Switch Interface: ethernet1/1/7",
        "                           Switch Speed: 25G",
        "                           Switch Status: up",
        "                           Switch SFP Model: 25GBASE-CR-3.0M",
        "                           Switch SFP Qualified: true",
        "Interface status for switch hound and node interface(pslave-1): ",
        "                           Node Interface:UP",
        "                           Node physical link detected:yes",
        "                           Node SFP Vendor: DELL",
        "                           Node SFP PN: VXFJY",
        "                           Node SFP Type: GBIC/SFP defined by 2-wire interface ID",
        "                           Node connection detected: ethernet1/1/7",
        "                           Switch Interface: ethernet1/1/7",
        "                           Switch Speed: 25G",
        "                           Switch Status: up",
        "                           Switch SFP Model: 25GBASE-CR-3.0M",
        "                           Switch SFP Qualified: true",
        "*******************************************************************************",
        "Actions taken and Reccomendations:",
        "*******************************************************************************",
        "Validated node(s) to switch connection are correct: PASS: Node(s) are correctly connected on all reachable Dell managed switches",
        "Validated SFP on the node(s): PASS: SFP detected on all interfaces",
        "Validated interface status on the node(s): PASS: All interfaces are up",
        "Validated SFP on the switches are qualified: PASS: All SFPs are qualified.",
        "Validated Frontend switch(es): PASS: All frontend switches appear to be Dell managed switches.",
        "Validated Backend switch(es): PASS: All backend switch(es) are reachable",
        "*******************************************************************************"
    ]
}

TASK [Fail if validation fails] **********************************************************************************************************************************************************************
skipping: [169.254.1.7] => {"changed": false, "skip_reason": "Conditional result was False", "skipped": true}

PLAY RECAP *******************************************************************************************************************************************************************************************
169.254.1.7                : ok=70   changed=6    unreachable=0    failed=0
localhost                  : ok=8    changed=1    unreachable=0    failed=0

Playbook execution successful
20241112 22:28:58.932: | PASS (2 min 44 sec)
================================================================================
Status: PASS
Time Elapsed: 3 min 1 sec
Debug log: /opt/emc/caspian/service-console/log/20241112_222531_run_KB_Fix/dbg_robot.log
HTML log: /opt/emc/caspian/service-console/log/20241112_222531_run_KB_Fix/log.html
================================================================================

[screen is terminating]

 

Hinweis: Wenn es sich bei den Switches nicht um Switches von Arista oder Dell handelt, sind es nutzerverwaltete Switches. Wir müssen die NutzerInnen benachrichtigen, dass eine ausgefallene Verbindung vorhanden ist, die korrigiert werden muss. Befolgen Sie nach der Bestätigung des Problems den Artikel ECS: So filtern Sie Switch-Warnmeldungen von xDoctor , um die Analyse der vom Nutzer verwalteten Switches zu deaktivieren.

 

Additional Information

Wenn keiner der angebotenen Workarounds für Ihren spezifischen Anwendungsfall für eines der oben genannten Symptome zutrifft, wenden Sie sich an den technischen Support und geben Sie diese Wissensdatenbank-Artikel-ID an. Hängen Sie außerdem das xDoctor-Berichtsarchiv an, wie in Artikel 14365 beschrieben.

Falls wir Unterstützung bei diesem Artikel benötigen, wenden Sie sich für eine vorläufige Untersuchung/ein Troubleshooting an den globalen technischen Support von ECS.

Hinweis: Dieser Artikel wird jedes Mal, wenn Sie, der ECS Global Technical Support, das ECS EE-Team oder das ECS Development Engineering neue Anwendungsfälle entdecken, vom ECS xDoctor-Team mit neuen Workarounds ergänzt.

Affected Products

ECS Appliance

Products

ECS Appliance, ECS Appliance Hardware Gen1 U-Series, ECS Appliance Software without Encryption, Elastic Cloud Storage
Article Properties
Article Number: 000081583
Article Type: Solution
Last Modified: 03 أبريل 2026
Version:  10
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.