Configuration des notifications de courrier électronique pour les clients Windows à l'aide de BLAT et de nbmail.cmd dans Veritas NetBackup (TM)

Problème

Configuration des notifications de courrier électronique pour les clients Windows à l'aide de BLAT et de nbmail.cmd dans Veritas NetBackup (TM)  

Solution

Ce document est destiné à fournir une liste complète des étapes nécessaires pour configurer la notification de courrier électronique Windows dans NetBackup. Pour installer correctement les notifications par courrier électronique, vous devez disposer des informations suivantes :

Notez au préalable que ce document est essentiellement destiné aux plates-formes basées sur Windows. Les plates-formes UNIX disposent d'une méthode de transfert SMTP (Simple Mail Transport Protocol) intégrée, dont Windows est dépourvu. Windows requiert une application MAPI ou autre, capable de transférer des messages par SMTP. NetBackup comprend différents fichiers  .cmd, qui supposent la présence d'un utilitaire SMTP nommé BLAT. Les fichiers  .cmd traités dans ce document supposent l'utilisation de BLAT comme utilitaire SMTP. 

BLAT est un utilitaire à code libre, dont la version la plus récente peut être téléchargée sur le site suivant :   https://sourceforge.net/projects/blat/  
Remarque :    BLAT est un produit tiers.  Il n'est ni écrit, ni approuvé ou pris en charge par Veritas.  Tous les problèmes liés à BLAT sont à signaler directement à ses auteurs.  Veritas ne pourra fournir aucune assistance concernant les problèmes rencontrés lors de l'installation ou de l'utilisation de BLAT.

I. Installation et configuration de l'exécutable de BLAT 1. Téléchargez le fichier .zip à partir de la page de téléchargement spécifiée ci-dessus.
2. Extrayez les fichiers vers leur propre dossier. Remarque : la plupart des fichiers figurant dans ce fichier .zip sont de nature informationnelle et correspondent au code source destiné au développement. 3. Copiez le fichier  blat.exe dans le répertoire  \WINNT\System32 de Windows.
4. A partir d'une invite de commande, exécutez la commande suivante ( remarque : il s'agira du compte principal d'envoi des messages électroniques à partir du serveur spécifié) : % blat -install  5. Testez l'installation de BLAT en créant un fichier texte  C:\testfile.txt avec un message et en l'envoyant par courrier électronique à l'administrateur de NetBackup. % blat C:\testfile.txt -s test_subject -to useraccount@company.com
Si BLAT fonctionne correctement, l'administrateur de NetBackup doit recevoir le contenu du fichier C:\testfile.txt.
II. Configuration du script nbmail.cmd 1. Ouvrez  nbmail.cmd à l'aide de  notepad.exe ou d'un autre éditeur de texte. Le fichier figure dans une installation serveur/client de NetBackup pour Windows sous  \VERITAS\NetBackup\bin.  Effectuez une copie de sauvegarde de ce script avant de le modifier.
Remarque : lors de l'utilisation du bloc-notes pour la modification d'un script, n'utilisez pas l'option de retour automatique à la ligne.  Si cette option est activée, elle doit être désélectionnée.  Son utilisation peut avoir pour conséquence des retours à la ligne supplémentaire ajoutés au script, qui le rendent non fonctionnel.
2. La plupart des lignes du fichier nbmail.cmd sont de nature informationnelle. Les lignes suivantes doivent être ajustées :
Pour les systèmes NetBackup 4.5 et 5.x, recherchez la ligne suivante : @rem @blat %3 -s %2 -t %1 -i NetBackup -server WARTHOG -q Pour les systèmes NetBackup 6.0, recherchez la section suivante : @REM @IF "%~4"=="" (
@REM blat %3 -s %2 -t %1 -i NetBackup -server WARTHOG -q
@REM ) ELSE (
@REM blat %3 -s %2 -t %1 -i NetBackup -server WARTHOG -q -attach %4
@REM ) 3. Supprimez "@rem" au début de chaque ligne.  Ceci active les sections requises pour l'exécution de BLAT.
4. Remplacez "WARTHOG" par le nom du serveur de messagerie électronique. Voici un exemple de l'aspect modifié de cette ligne :
Exemple pour les systèmes NetBackup 4.5 et 5.x : @blat %3 -s %2 -t %1 -i NetBackup -server  emailserver.company.com -q Exemple pour les systèmes NetBackup 6.0 : @IF "%~4"=="" (
blat %3 -s %2 -t %1 -i NetBackup -server  emailserver.company.com -q
) ELSE (
blat %3 -s %2 -t %1 -i NetBackup -server  emailserver.company.com -q -attach %4
)
Par ailleurs, une bonne pratique consiste à remplacer toutes les instances de "NetBackup" par une adresse de courrier électronique valide pour les versions 4.x, 5.x ou 6.x, par exemple : blat %3 -s %2 -t %1 -i admin@acme.com -server  emailserver.company.com -q Cette adresse électronique apparaîtra dans le champ "De :" du courrier électronique.  Ceci est lié au fait que certains serveurs de messagerie électronique ne peuvent pas traiter le courrier s'il provient de "NetBackup", contrairement à une adresse électronique valide.

5. Enregistrez le fichier  nbmail.cmd
6. Exemple de courrier électronique envoyé par NetBackup à l'aide de BLAT : La sauvegarde sur le client par la racine a partiellement réussi.
Liste de fichiers
---------
C:\Documents and Settings
Options expliquées : III. Configuration de NetBackup pour utiliser la notification par courrier électronique Pour permettre à un serveur principal d'envoyer des messages électroniques pour toutes les sauvegardes client échouées qui se terminent avec un état différent de zéro, procédez comme suit : 1. Ouvrez la console d'administration NetBackup.
2. Ouvrez les  Propriétés de l'hôte pour le serveur principal et accédez à l'onglet  Attributs globaux.
3. Au bas de cette page, entrez l'adresse électronique pour l'administrateur NetBackup dans le champ nommé Adresse électronique de l'administrateur : (séparez les entrées multiples avec des virgules).
Pour permettre à un client spécifique d'envoyer des messages électroniques pour tous les travaux réussis et échoués, procédez comme suit : 1. Ouvrez la console d'administration NetBackup.
2. Ouvrez les  Propriétés de l'hôte pour le client et accédez à l'onglet  Paramètres universels.
3. Dans la section  Administrateur de cette page, entrez l'adresse électronique pour l'administrateur NetBackup dans le champ nommé  Adresse électronique de l'administrateur du client (séparez les entrées multiples avec des virgules).
Désormais, NetBackup devrait envoyer des notifications par courrier électronique. Pour envoyer plus d'informations à l'administrateur, configurez certains des fichiers  \VERITAS\NetBackup\bin\*.cmd. Des informations supplémentaires seront alors transmises à l'administrateur. 
IV. Méthodes d'utilisation supplémentaires de BLAT et de nbmail.cmd Les envois à plusieurs utilisateurs peuvent être réalisés de deux manières : en créant un compte de groupe SMTP administratif sur un serveur de messagerie électronique et en configurant NetBackup et  nbmail.cmd afin d'utiliser cette adresse SMTP, ou en configurant le fichier  nbmail.cmd pour un envoi à plusieurs utilisateurs.

La fourniture de plusieurs adresses électroniques pour BLAT peut être réalisée en ajoutant des adresses électroniques supplémentaires après %1 dans le fichier  nbmail.cmd.  Voici un exemple de la syntaxe requise :

Exemple pour les systèmes NetBackup 4.5 et 5.x : @blat %3 -s %2 -t %1 ,name1@acme.com,name2@acme.com,name3@acme.com -i NetBackup -server emailserver.company.com  -q Exemple pour les systèmes NetBackup 6.0 : @IF "%~4"=="" (
blat %3 -s %2 -t %1 ,name1@acme.com,name2@acme.com,name3@acme.com -i NetBackup -server emailserver.company.com  -q
) ELSE (
blat %3 -s %2 -t %1 ,name1@acme.com,name2@acme.com,name3@acme.com -i NetBackup -server emailserver.company.com  -q -attach %4
)
Avec cette configuration, quatre messages électroniques seront envoyés. Il est important de séparer les adresses électroniques avec des virgules (,) sans espaces dans l'intervalle. 
V. Dépannage de BLAT 1. Il peut s'avérer nécessaire d'effectuer le dépannage de BLAT. Si BLAT est exécuté à partir d'une ligne de commande directe et présente une erreur, il produit un message dans les résultats de ligne de commande. Pour constituer un fichier "journal" pour BLAT, effectuez une entrée à la fin de la ligne "@blat" de  nbmail.cmd comme ceci :
Exemple pour les systèmes NetBackup 4.5 et 5.x : @blat %3 -s %2 -t %1 -i NetBackup -server emailserver.company.com -q  >>"C:\program files\veritas\netbackup\logs\blat.out.txt" Exemple pour les systèmes NetBackup 6.0 : @IF "%~4"=="" (
blat %3 -s %2 -t %1 -i NetBackup -server emailserver.company.com -q  >>"C:\program files\veritas\netbackup\logs\blat.out.txt"
) ELSE (
blat %3 -s %2 -t %1 -i NetBackup -server emailserver.company.com -q -attach %4  >>"C:\program files\veritas\netbackup\logs\blat.out.txt"
)
Ceci créera un fichier  .txt dans le répertoire spécifié et effectuera l'ajout au bas de ce fichier. En cas de message d'erreur de BLAT, il apparaîtra dans le fichier spécifié. 

2. Dans certaines instances, la notification par courrier électronique fonctionne, mais le centre de sauvegarde n'effectue pas correctement l'envoi des rapports. Pour corriger ceci, il est nécessaire de modifier la ligne "blat" du fichier  nbmail.cmd. Le cas échéant, apportez la modification suivante au fichier  nbmail.cmd :
Exemple pour les systèmes NetBackup 4.5 et 5.x : @blat %3 -s %2 -t %1 -i NetBackup -server emailserver.company.com -q  -mime Exemple pour les systèmes NetBackup 6.0 : @IF "%~4"=="" (
blat %3 -s %2 -t %1 -i NetBackup -server emailserver.company.com  -q  -mime
) ELSE (
blat %3 -s %2 -t %1 -i NetBackup -server emailserver.company.com  -q -attach %4  -mime
)
3. Dans certaines instances, la notification par courrier électronique et BLAT sont configurés correctement, mais les courriers électroniques ne sont pas reçus. Essayez d'apporter la modification suivante au fichier  nbmail.cmd :
Exemple pour les systèmes NetBackup 4.5 et 5.x : @blat %3 -s %2 -t %1 -i NetBackup -server emailserver.company.com -q  -enriched Exemple pour les systèmes NetBackup 6.0 : @IF "%~4"=="" (
blat %3 -s %2 -t %1 -i NetBackup -server emailserver.company.com -q  -enriched
) ELSE (
blat %3 -s %2 -t %1 -i NetBackup -server emailserver.company.com -q -attach %4  -enriched
)