Avamar: NDMP-Medium-Fehler aufgrund einer Firewall, die Ports zwischen Accelerator und VNX blockiert
Summary: NDMP-Backup (Network Data Management Protocol) schlägt mit "Mittlerer Fehler" und "NDMP_DATA_HALT_INTERNAL_ERROR" fehl. Die Firewall blockiert Avamar NDMP Accelerator ↔ VNX. Öffnen Sie Port 10000 und mindestens 100 weitere Datenports (server_param–f NDMP), um das Problem zu beheben. ...
Symptoms
NDMP-Backup-Fehlersymptome
Die folgenden Symptome werden beobachtet, wenn ein Avamar-NDMP-Backup auf einen mittelschweren Fehler stößt:
- Der Backupjob wird mit der Meldung "Medium error" abgebrochen.
- Der Schreibvorgang schlägt auf dem Archiv-Volume fehl.
- Der NDMP-Datenstrom wird angehalten und meldet
NDMP_DATA_HALT_INTERNAL_ERROR. - Data Mover zeigt "Data Halted" an und wartet, bis der Übertragungsthread abgeschlossen ist.
- Datenübermittlung an
avtarwird nicht erfolgreich beendet. - Die Spalte
avtarProzess-Exits mit Code 163 (extern storniert) verarbeiten. - Das Backup für das Ziel-Volume meldet Fehler und wird als abgebrochen markiert.
- Die endgültige Zusammenfassung zeigt einen Exit-Code ungleich Null an (z. B. 157).
Beispielprotokollauszüge, die diese Symptome veranschaulichen:
2016-08-02 11:34:51 avndmp Info <0000>: [snapup-/root_vdm_1/Corp] NDMP: SnapSure file system creation succeeds 2016-08-02 11:43:54 avndmp Error <0000>: [snapup-/root_vdm_1/Corp] NDMP: Medium error 2016-08-02 11:43:54 avndmp Warning <0000>: [snapup-/root_vdm_1/Corp] NDMP: Write failed on archive volume 1 2016-08-02 11:43:54 avndmp Info <0000>: [snapup-/root_vdm_1/Corp] NDMP: server_archive: emctar vol 1, 110 files, 0 bytes read, 1179648 bytes written 2016-08-02 11:43:54 avndmp Warning <0000>: [snapup-/root_vdm_1/Corp] NDMP Data Halted, reason : NDMP_DATA_HALT_INTERNAL_ERROR 2016-08-02 11:43:54 avndmp Info <0000>: [snapup-/root_vdm_1/Corp] Data mover reports Data Halted. Waiting for transfer thread to finish feeding stream to avtar... 2016-08-02 11:43:54 avndmp Warning <0000>: [snapup-/root_vdm_1/Corp] Data halted unsuccessfully, stopping data transfer to avtar. 2016-08-02 11:43:54 avndmp Info <0000>: [snapup-/root_vdm_1/Corp] Cancelling avtar 2016-08-02 11:43:58 avndmp Info <6688>: [ctl_spawn] Process 23228 (/usr/local/avamar/bin/avtar) finished (code 163: externally cancelled) 2016-08-02 11:43:58 avndmp Warning <6690>: [ctl_spawn] CTL workorder "MOD-1470162815289#1" non-zero exit status 'code 163: externally cancelled' 2016-08-02 11:43:59 avndmp Info <0000>: [ndmp2avtar-/root_vdm_1/Corp/] NDMP stream bytes read = 2779, bytes written = 2779 2016-08-02 11:44:10 avndmp Info <0000>: [snapup-/root_vdm_1/Corp] Waiting for data transfer thread to exit 2016-08-02 11:44:10 avndmp Info <0000>: [snapup-/root_vdm_1/Corp] Waiting for volume /root_vdm_1/Corp snapshot to be removed. Will stop waiting after 300 seconds. 2016-08-02 11:44:15 avndmp Info <0000>: [snapup-/root_vdm_1/Corp] Snapshot for volume /root_vdm_1/Corp was removed after 5 seconds. 2016-08-02 11:44:15 avndmp Error <0000>: [snapup-/root_vdm_1/Corp] Backup for target /root_vdm_1/Corp had errors. 2016-08-02 11:44:15 avndmp Info <0000>: [snapup-/root_vdm_1/Corp] Backup of '/root_vdm_1/Corp' aborted. Error in NDMP session. 2016-08-02 11:44:15 avndmp Info <0000>: [avndmp_assist] Thread exited with errors: /root_vdm_1/Corp 2016-08-02 11:44:15 avndmp Info <0000>: [avndmp_assist] Active threads: 2016-08-02 11:44:15 avndmp Info <0000>: [avndmp_ctl_sup] Threads successfully completed 0, canceled/aborted 0, failed 1 2016-08-02 11:44:15 avndmp Info <7271>: [avndmp_ctl_sup] Final summary generated subwork 1, cancelled/aborted 0, snapview 0, exitcode 157
Cause
Blockieren der Netzwerkkommunikation zwischen Avamar NDMP Accelerator und VNX
Das NDMP-Backup schlägt fehl, da die Firewall den Datenverkehr zwischen dem Avamar NDMP Accelerator Node und dem VNX-Speichersystem einschränkt. Nur TCP-Port 10000 wurde geöffnet, während der NDMP Accelerator eine Reihe zusätzlicher Ports für die Datenübertragung benötigt. Diese Einschränkung führt dazu, dass in der NDMP-Sitzung ein "Mittlerer Fehler" und eine interne Datenanhaltebedingung auftritt.
Beweise aus Systemprotokollen
2016-08-02 14:12:31: 13156679683: network error (../NdmpdMover.cxx: 1226) 2016-08-02 14:12:31: 13156679680: Session 033 (thread nasw00) NdmpdSession::ndmpdApiWrite fails in local or remote wirte msg, moverAddressType=1, mp=0x01005ed840 2016-08-02 14:12:31: 13156679680: Thread bkup058 Medium error
- Protokolleintrag zeigt einen Netzwerkfehler an, der seinen Ursprung hat von
NdmpdMover.cxx, was auf einen Fehler im NDMP Data Mover hinweist. - Die anschließende
"NdmpdApiWrite fails"bestätigt, dass die NDMP-Sitzung keine Daten auf den Remoteendpunkt schreiben konnte. - Der letzte Fehler "Medium" stimmt mit dem in den Avamar-Protokollen gemeldeten NDMP-Backupabbruch überein.
Details zur Hauptursache
- Unzureichende Firewallregeln: Nur Port 10000 war zulässig, während der NDMP Accelerator einen zusammenhängenden Bereich von Ports (in der Regel 10000-10099) für Datenstreams benötigt.
- Blockierte Datenports verhindern, dass der NDMP Mover eine zuverlässige Verbindung herstellt, was zu internen NDMP-Fehlern wie den folgenden führt:
NDMP_DATA_HALT_INTERNAL_ERROR. - Das Fehlen der erforderlichen Ports löst den Avamar NDMP-Prozess aus, um das Backup abzubrechen, was zu Exitcode 163 ("externally canceled") führt.
Resolution
Öffnen der erforderlichen Firewallports für Avamar NDMP Accelerator
Schritt-für-Schritt-Anleitung
- Identifizieren Sie die IP-Adresse des Avamar NDMP Accelerator Node und des VNX-Speichersystems.
- Melden Sie sich bei der Firewall an, die den Datenverkehr zwischen diesen beiden Geräten steuert.
- Vergewissern Sie sich, dass TCP-Port 10000 bereits zugelassen ist. Ist dies nicht der Fall, erstellen Sie eine Regel, um ein- und ausgehenden Datenverkehr auf diesem Port zuzulassen.
- Öffnen Sie einen zusammenhängenden Bereich von mindestens 100 Ports für NDMP-Datenverkehr (z. B.
10000‑10100). Wenden Sie die Regel auf beide Richtungen zwischen dem Avamar NDMP Accelerator Node und dem VNX-System an. - Speichern Sie die Firewall-Konfiguration und wenden Sie sie an.
Validieren der Portkonfiguration auf dem VNX-System
Zeigen Sie die aktuellen NDMP-Porteinstellungen an:
server_param server_2 -f NDMP -l

Wenn die Ausgabe den neu hinzugefügten Bereich nicht anzeigt, fügen Sie ihn mit dem folgenden Befehl hinzu (ersetzen Sie und mit dem ausgewählten Bereich):
Hinzufügen eines Portbereichs
Fügen Sie einen neuen NDMP-Portbereich hinzu:
server_param server_2 -f NDMP -l "-"
Führen Sie ein Testbackup durch.
Initiieren eines NDMP-Backups für ein Test-Volume:
avtar -c -s -d
Überprüfen Sie nach Abschluss des Backups die Avamar-NDMP-Protokolle auf Fehlermeldungen.
Überprüfen von NDMP-Protokollen
Anzeigen der letzten NDMP-Protokolleinträge:
grep -i "NDMP" /var/log/avndmp.log | tail -20
Das Protokoll sollte Meldungen zum erfolgreichen Abschluss ohne die Einträge "Medium error" oder "Data halted" anzeigen.