Avamar : Erreur de support NDMP due au blocage des ports par le pare-feu entre l’accélérateur et le VNX

Symptômes de l’échec de la sauvegarde NDMP

Les symptômes suivants sont observés lorsqu’une sauvegarde NDMP Avamar rencontre une erreur de support :

• La procédure de sauvegarde s’interrompt avec le message « Erreur moyenne ».
• L’opération d’écriture échoue sur le volume d’archives.
• Le flux de données NDMP est interrompu et les rapports NDMP_DATA_HALT_INTERNAL_ERROR .
• Le logiciel de transfert de données indique « Données interrompues » et attend que le thread de transfert se termine.
• Transfert de données vers avtar s’arrête sans succès.
• La commande avtar Le processus se termine avec le code 163 (annulé en externe).
• La sauvegarde du volume cible signale des erreurs et est marquée comme abandonnée.
• Le récapitulatif final affiche un code de sortie différent de zéro (tel que 157).

Exemples d’extraits de journal illustrant ces symptômes :

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

Blocage de la communication réseau entre Avamar NDMP Accelerator et VNX

La sauvegarde NDMP échoue, car le pare-feu limite le trafic entre le nœud Avamar NDMP Accelerator et le système de stockage VNX. Seul le port TCP 10000 a été ouvert, tandis que NDMP Accelerator nécessite une gamme de ports supplémentaires pour le transfert de données. Cette restriction entraîne l’apparition d’une « erreur moyenne » et d’une condition interne d’arrêt des données sur la session NDMP.

Preuves issues des journaux système

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

• L’entrée de journal affiche une erreur réseau provenant de NdmpdMover.cxx , indiquant une défaillance du Data Mover NDMP.
• L’élément suivant "NdmpdApiWrite fails" confirme que la session NDMP n’a pas pu écrire de données sur le point de terminaison distant.
• L’erreur « Medium » finale correspond à l’abandon de la sauvegarde NDMP signalé dans les logs Avamar.

Détails sur la cause première

• Règles de pare-feu insuffisantes : Seul le port 10000 a été autorisé, tandis que NDMP Accelerator nécessite une plage contiguë de ports (généralement 10 000-1 0099) pour les flux de données.
• Les ports de données bloqués empêchent le logiciel de transfert NDMP d’établir une connexion fiable, ce qui entraîne des erreurs NDMP internes telles que : NDMP_DATA_HALT_INTERNAL_ERROR.
• L’absence de ports requis déclenche l’annulation de la sauvegarde par le processus NDMP d’Avamar, ce qui génère le code de sortie 163 (« annulé en externe »). 

Ouverture des ports de pare-feu requis pour Avamar NDMP Accelerator

Procédure étape par étape

• Identifiez l’adresse IP du nœud Avamar NDMP Accelerator et du système de stockage VNX.
• Connectez-vous au pare-feu qui contrôle le trafic entre ces deux périphériques.
• Vérifiez que le port TCP 10000 est déjà autorisé. Si ce n’est pas le cas, créez une règle pour autoriser le trafic entrant et sortant sur ce port.
• Ouvrez une plage contiguë d’au moins 100 ports pour le trafic de données NDMP (par exemple, 10000‑10100). Appliquez la règle dans les deux sens entre le nœud Avamar NDMP Accelerator et le système VNX.
• Enregistrez et appliquez la configuration du pare-feu.

Validation de la configuration des ports sur le système VNX

Affichez les paramètres de port NDMP actuels :

server_param server_2 -f NDMP -l

Si la sortie n’affiche pas la plage nouvellement ajoutée, ajoutez-la à l’aide de la commande suivante (remplacez et par la plage choisie) :

Ajouter une plage de ports 

Ajoutez une nouvelle plage de ports NDMP :

server_param server_2 -f NDMP -l "-"

Exécutez une sauvegarde test.

Lancez une sauvegarde NDMP pour un volume test :

avtar -c -s  -d

Une fois la sauvegarde terminée, consultez les journaux NDMP d’Avamar pour rechercher d’éventuels messages d’erreur.

Vérification des journaux NDMP

Affichez les entrées récentes du journal NDMP :

grep -i "NDMP" /var/log/avndmp.log | tail -20

Le journal doit afficher des messages d’achèvement réussis sans entrées « Erreur moyenne » ou « Données interrompues ».