Guide de référence de Veritas NetBackup™ WebSocket Service (NBWSS)

Notifications de NBWSS

Lorsque NetBackup est connecté à un terminal client NBWSS, le terminal client reçoit des notifications à partir de NetBackup sous la forme d'un message NOTIFICATION REQUEST. Lorsque le terminal client reçoit la notification, le terminal client doit répondre par un message NOTFICATION RESPONSE.

Tableau : Types de notification de NetBackup décrit les types de notifications que NetBackup envoie.

A. Demande de notification

NetBackup envoie des notifications à un terminal client sous la forme d'un message NOTIFICATION REQUEST. Ce message peut avoir une ou plusieurs notifications au sein de sa charge utile.

Ce qui suit est un exemple de demande de notification :

{
      "version": "1.0",
      "id": "EDD85CD7-8553-47E4-8A19-01C65092F220",
      "type": "NOTIFICATION",
      "subType": "REQUEST",
      "timeStamp": 1459811679,
      "payload": [
            {
                  "notificationType": "INFO",
                  "object": "JOB",
                  "data": [
                        {
                              "scheduleType": "ST_FULL",
                              "clientName": "mserver2.acme.com",
                              "status": 0,
                              "startTime": 1459829674,
                              "state": "ACTIVE",
                              "policyName": "vmware2",
                              "parentJobId": 144,
                              "jobId": 144,
                              "policyType": "VMWARE",
                              "jobType": "BACKUP"
                        }
                  ]
            }
      ]
}

Dans les messages de demande, le type de valeur "payload" est une baie de disques. Chaque élément de la baie contient un type d'objet de notification différent ("JOB" ou "IMAGE"). L'élément a toutes les notifications qui sont liées à ce type d'objet. Cette baie de disques permet à NetBackup de regrouper les notifications d'un même type.

Par exemple, pour début du travail et travail effectué, la charge utile dispose d'un élément : un objet de notification de type "JOB". Dans la section des données de l'objet de notification "JOB", il y a deux éléments, un pour chaque notification. Pour un exemple de notifications par lots dans un seul message, consultez « Plusieurs notifications dans un seul message » dans la rubrique suivante :

Se reporter à Autres messages de notification NetBackup.

B. Réponse de notification

Pour chaque demande de notification, un message NOTIFICATION RESPONSE est attendu. Le champ "id" de cette réponse doit être identique à la "id" de la demande et le champ "payload" doit être un tableau vide.

Par exemple :

 {
      "version": "1.0",
      "id": "EDD85CD7-8553-47E4-8A19-01C65092F220",
      "type": "NOTIFICATION",
      "subType": "RESPONSE",
      "timeStamp": 1445036999,
      "payload": []
}

Quand NetBackup reçoit la réponse, les notifications qui ont été envoyées au sein de la demande sont considérées comme reconnues et les nouvelles notifications peuvent être envoyées dans le cas où elles se produisent. Si une demande de notification n'est pas reconnue dans le délai configuré, la notification est renvoyée. Aucune nouvelle notification n'est envoyée à ce terminal client jusqu'à ce que la notification soit reconnue.

La période de temps peut être configurée dans le fichier nbwss.properties au moyen de l'option notification.scheduledRate. La valeur par défaut est de 5 secondes. La rubrique suivante contient plus d'informations sur les options dans le fichier nbwss.properties :

Se reporter à Configuration des propriétés de NetBackup WebSocket Service (NBWSS).

Pour éviter les problèmes de livraison, NetBackup garantit la livraison de notifications envoyées dans les cas suivants : la connexion entre NetBackup et le terminal client est abandonnée, le serveur du terminal client est hors ligne ou un problème se produit avec les Services Web de NetBackup. Si un serveur de terminal client est hors ligne, les notifications atteignent le serveur du terminal client suivant dans le groupe de serveurs.

Se reporter à Remarques sur les connexions de NetBackup aux applications cloud.